============================================================
YB-KIT PUBLISH GUIDE
============================================================

--- STEP 1: PREPARATION ---
1. Ensure all components are exported in 'src/index.js'.
2. Ensure JSDoc/PropTypes are updated for new components.
3. If new files were added, update 'src/index.d.ts' for TypeScript support.

--- STEP 2: BUILD ---
Run the following command to generate the production-ready files:
> npm run build

Check the 'dist/' folder:
- Is there an index.js?
- Is there an index.esm.js?
- Is 'use client' preserved if using MUI components?

--- STEP 3: VERSIONING ---
You cannot publish the same version twice. Choose one:
> npm version patch   (1.0.0 -> 1.0.1) - Bug fixes
> npm version minor   (1.0.0 -> 1.1.0) - New components/features
> npm version major   (1.0.0 -> 2.0.0) - Breaking changes

--- STEP 4: PUBLISH ---
1. Login (if not already logged in):
   > npm login

2. Verification (Check what files will be sent):
   > npm publish --dry-run

3. Final Push:
   > npm publish

   *Note: If using a scoped name (@user/yb-kit), use:
   > npm publish --access public

--- STEP 5: CLEANUP ---
1. Push your source code changes (including the new version number) to GitHub/Bitbucket.
   > git add .
   > git commit -m "chore: publish version X.X.X"
   > git push

============================================================
COMMON FIXES:
- "Failed to fetch": Change file extension to .jsx
- "Module level directive": Ensure 'rollup-plugin-preserve-directives' is in rollup.config.js
- "Missing script": Check package.json for "build": "rollup -c"
============================================================