@ikas/component-cli 0.131.0 → 0.132.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikas/component-cli",
-  "version": "0.131.0",
+  "version": "0.132.0",
   "description": "CLI for developing ikas code components",
   "type": "module",
   "main": "./dist/index.js",

package/templates/create/claude-md

@@ -8,9 +8,9 @@ Never guess function signatures or type shapes — the MCP server is the source
 
 ## CRITICAL: Auto-Generated Files
 
-**NEVER manually create or edit `ikas.config.json`, `types.ts` or `global-types.ts`** — they are auto-generated by CLI commands.
-Use `npx ikas-component config add-component --props '[...]'` or `npx ikas-component config add-prop` to manage props.
-These commands update `ikas.config.json`, `types.ts`, and `global-types.ts` automatically.
+**NEVER manually create or edit `ikas.config.json`, `types.ts`, `global-types.ts`, or `src/components/index.ts`** — they are all auto-generated by CLI commands.
+Use `npx ikas-component config add-component --props '[...]'` or `npx ikas-component config add-prop` to manage components and props.
+These commands update `ikas.config.json`, `types.ts`, `global-types.ts`, AND `src/components/index.ts` (including the component export) automatically.
 
 **The CLI does NOT edit your component source.** `remove-prop` and `remove-enum` update `ikas.config.json` and the generated `types.ts` / `global-types.ts` only — `index.tsx`, sub-components, and `styles.css` are untouched. After removing a prop or enum, grep the source for the old identifier and clean up dead references yourself before building.
 

package/templates/create-full/claude-md

@@ -10,9 +10,9 @@ Never guess function signatures or type shapes — the MCP server is the source
 
 ## CRITICAL: Auto-Generated Files
 
-**NEVER manually create or edit `types.ts`** — it is auto-generated by CLI commands.
-Use `npx ikas-component config add-component --props '[...]'` or `npx ikas-component config add-prop` to manage props.
-These commands update BOTH `ikas.config.json` AND `types.ts` automatically.
+**NEVER manually create or edit `ikas.config.json`, `types.ts`, `global-types.ts`, or `src/components/index.ts`** — they are all auto-generated by CLI commands.
+Use `npx ikas-component config add-component --props '[...]'` or `npx ikas-component config add-prop` to manage components and props.
+These commands update `ikas.config.json`, `types.ts`, `global-types.ts`, AND `src/components/index.ts` (including the component export) automatically.
 
 **The CLI does NOT edit your component source.** `remove-prop` and `remove-enum` update `ikas.config.json` and the generated `types.ts` / `global-types.ts` only — `index.tsx`, sub-components, and `styles.css` are untouched. After removing a prop or enum, grep the source for the old identifier and clean up dead references yourself before building.
 
@@ -412,6 +412,25 @@ const CartBadge = observer(function CartBadge() {
 });
 ```
 
+```tsx
+// ALSO wrap EXTRACTED HELPER COMPONENTS declared inside a component file —
+// especially list items rendered via .map() that read/write MobX state
+// (e.g., offer.isSelected, option.values). Without observer(), the helper
+// won't re-render when the observable changes.
+const OfferCard = observer(function OfferCard({ offer }) {
+  const isSelected = offer.isSelected;
+  return <div>{isSelected ? "ON" : "OFF"}</div>;
+});
+
+export function MySection({ product }: Props) {
+  return product.offers.map((offer) => (
+    <OfferCard key={offer.id} offer={offer} />
+  ));
+}
+```
+
+**Rule of thumb:** if a non-root component reads or writes MobX observables (store fields, `offer.isSelected`, `option.values`, etc.), wrap it with `observer()`. Without it, MobX mutations won't trigger re-renders.
+
 ### Null Safety
 
 ```tsx