@trading-game/design-intelligence-layer 0.16.1 → 0.16.3

package/AGENTS.md

@@ -61,6 +61,27 @@ cp node_modules/@trading-game/design-intelligence-layer/guides/rules/design-syst
 
 ---
 
+## Step 4 — New-component release checklist (MANDATORY)
+
+Every time you add a new component (UI primitive or Block) to this package, **all** of the following must land in the same PR. Skipping any one of these has shipped broken releases before — npm consumers got a version where the component existed in the demo but couldn't be imported. Do not skip a step.
+
+1. **Source file** — `components/ui/<name>.tsx` (or `components/blocks/<name>-block.tsx`)
+2. **Public export** — add the matching `export * from "../components/<…>/<name>"` line to `src/index.ts`. **This is what gates whether npm consumers receive the component at all.** The demo at `app/page.tsx` imports via the `@/components/...` alias and will work without this — but the published package will not ship the component until this line exists.
+3. **Auto-generated registry** — run `npm run generate:registry` so `app/component-registry.generated.ts` picks the new file up.
+4. **Demo entry** — add a sidebar entry in the `componentNames` list in `app/page.tsx`, and a `case "<Name>":` block in the `SectionContent` switch that renders representative variants.
+5. **README** — add a row in the "Available components" table and a per-component section explaining variants / slots / behaviour.
+6. **Design system guide** (`guides/design-system-guide/trading-game-ds-guide.md`) — add a row in the §8 component list table and a styling-notes entry covering tokens used, edge cases, and `aria` posture.
+7. **Build verification** — run `npm run build` and confirm the component name appears in `dist/index.js` and `dist/index.d.ts` before tagging a release:
+   ```bash
+   npm run build
+   grep -c "<ComponentName>" dist/index.js dist/index.d.ts   # both > 0
+   ```
+8. **Version + publish** — only after every step above is checked in, bump `package.json`, commit, push, tag `v<version>`, and let the workflow publish.
+
+If any of these are missing at the time of release, the published package is broken — fix and re-release before moving on.
+
+---
+
 ## Reference
 
 - Full token + component reference: `node_modules/@trading-game/design-intelligence-layer/README.md`

package/README.md

@@ -308,7 +308,8 @@ Dismissible **promotional / marketing** surface — for feature launches, offers
   layout="inline"
   title={<>Spring release <b>is here.</b></>}        // wrap emphasis in <b> for brand-blue accent
   description="New features just landed — take a look at what's changed."
-  icon={<MyIcon />}                                   // omit to use the default 40px brand-blue gift badge
+  glyph={<Sparkles className="size-5" />}             // swaps the icon *inside* the default brand badge (default <Gift />)
+  icon={<MyIcon />}                                   // full override — replaces the brand badge entirely; null to omit
   action="Get started"                                // string wrapped in Button variant="primary"
   onDismiss={() => setOpen(false)}                    // when provided, close X is rendered
   dismissLabel="Dismiss"                              // aria-label for the close X
@@ -335,8 +336,8 @@ Dismissible **promotional / marketing** surface — for feature launches, offers
 
 **Visual:**
 - Surface: 135° diagonal gradient `#EBEBFF → #FFFFFF` with `border-primary/20` light-blue edge.
-- Default icon: 40px brand-blue circle with a white `Gift` glyph. Override via `icon` (pass any `ReactNode`) or `icon={null}` to omit.
-- Default action button: `Button variant="primary"` (single inline action) or `[Secondary, Primary]` pair (card actions). Pass `<Button>` elements explicitly to override variant/size.
+- Default icon: 40px brand-blue square (4px corners, matches the trading.game logo) with a white `Gift` glyph. Swap just the glyph via the `glyph` prop (e.g. `<Sparkles className="size-5" />`); replace the entire badge via the `icon` prop; or `icon={null}` to omit the column entirely.
+- Default action button: `Button variant="secondary"` size `sm` for every slot (inline `action` and both `actions[]` in card). Pass `<Button>` elements explicitly to override variant/size.
 - Title supports `<b>` children styled with `text-primary` for in-line brand-blue accent.
 - Close X (32px) hovers to `bg-secondary-hover`.