@nadicodeai/design-system 3.2.0 → 4.0.1

package/AGENTS.md

@@ -1,50 +1,35 @@
 # @nadicodeai/design-system
 
-The `@nadicodeai/design-system` npm workspace. `DESIGN.md` is the normative contract for reusable design tokens and package output. The package ships tokens, the CSS kit (structural geometry plus framework-agnostic brand display components), and assets. Repo-only `examples/` specimens prove that public surface. Standard, interactive, and section UI ships as React components from `@nadicodeai/ui`, not from here. Paths here are relative to `packages/design-system/`. Run commands from this directory, or with `-w @nadicodeai/design-system` from the repo root.
+The `@nadicodeai/design-system` npm workspace: `DESIGN.md` is the contract, the package ships tokens, CSS and assets, and `examples/` specimens prove them. React components ship from `@nadicodeai/ui`.
 
 ## Commands
 
-Proof follows [the repository pipeline](../../docs/agents/develop.md#the-pipeline):
-`npm run check -w @nadicodeai/design-system` and
-`npm run test -w @nadicodeai/design-system` before pushing. `check` carries the
-`DESIGN.md` contract lint, so a contract edit needs no separate command. This
-workspace has no app to boot: it ships a package, and `examples/` specimens are
-static HTML pages served from the repo root by
-`../../scripts/lib/static-design-server.ts`, which `npm run test:visual` starts.
-
 | Command | When |
 | --- | --- |
-| `npm run build -w @nadicodeai/design-system` | After any `DESIGN.md` edit. Regenerates every `dist/` artifact except `dist/favicon/` (tokens, Tailwind data, icons, complete CSS bundle) |
-| `npm run generate:icons -w @nadicodeai/design-system` | After bumping `lucide-static`. Rebakes `dist/icons/` (also runs inside `build`) |
-| `npm run generate:favicons -w @nadicodeai/design-system` | After a favicon source change. The output is git-tracked and the build does not regenerate it |
-| `npm run test:visual -w @nadicodeai/design-system` | Rendered CSS checks (`playwright.visual.config.ts`, `tests/visual/`), outside the browser-free default suite |
+| `npm run check -w @nadicodeai/design-system` then `npm run test -w @nadicodeai/design-system` | Before pushing; `check` includes the `DESIGN.md` lint |
+| `npm run build -w @nadicodeai/design-system` | After a `DESIGN.md` edit; regenerates `dist/` except `dist/favicon/` |
+| `npm run generate:icons -w @nadicodeai/design-system` | After bumping `lucide-static` |
+| `npm run generate:favicons -w @nadicodeai/design-system` | After a favicon source change |
+| `npm run test:visual -w @nadicodeai/design-system` | Rendered CSS checks |
 
 ## Routing
 
-| Task | Go to |
+| Topic | Path |
 | --- | --- |
-| Shared design-language terms | `CONTEXT.md` |
-| Colors, tokens, typography, layout doctrine, seam ownership, component semantics | `DESIGN.md` (read it before stating any of these) |
-| CSS layers, token pipeline, dark remaps, generated outputs, their guards | `DESIGN.md` "CSS Architecture & Token Pipeline". Decision history in `../../docs/adr/` |
-| Where a token is authored, and what the build publishes | The YAML front matter for the four schema groups, the one `json design-tokens` fence for everything the schema has no group for (`DESIGN.md` "Authored token extension"). `scripts/sd/design-tokens-fence.ts` reads the fence and `scripts/sd/compose-token-graph.ts` merges it with the CLI export into `dist/tokens/nadicode.dtcg.json` (aliases preserved) and `dist/tokens/nadicode.dtcg-resolved.json` (aliases replaced by values) |
-| Motion direction and runtime | `DESIGN.md` "Motion" for the direction and `core.motion` of the fence for the durations and easings, `src/css/motion.css` for the keyframes, the classes, and reduced motion, then the `product-design` skill for agent procedure |
-| Package exports | `package.json` (guard: `../../scripts/check-export-targets.mjs`, run by the root `build` script, so root `npm run check` and the post-merge suite, never the workspace `check` or the required gate) |
-| Static or non-React consumption | `README.md` |
-| React consumption | `../ui/docs/consuming-cross-repo.md` |
-| Logo hierarchy, usage, geometry, and asset delivery | `DESIGN.md` "Brand media authority". Static package routes in `README.md`. Implementation routes through `src/assets/`. `dist/` is generated, never hand-edited |
-| `examples/` specimen work | `examples/` plus the `write-clearly` skill for specimen copy (guard: `tests/guards/examples-package-coherence.test.ts`) |
-| Releasing a change to package-consumed output | `../../docs/agents/publish.md` |
-| Visual test implementation | `playwright.visual.config.ts` and `tests/visual/` |
-
-## Boundaries
-
-- Never edit `dist/**` or `src/css/*.generated.css` by hand. The build-covered files regenerate from `DESIGN.md` via `npm run build`. No test guard catches a hand-edit. The fence is the cleanliness step in `.github/workflows/ci.yml`'s `design-system` job (why the guards cannot hold it, and the `dist/favicon/**` carve-out: `DESIGN.md` "Enforcement").
-- Token-only CSS: no raw color or radius literal in hand-authored `src/css/` or `examples/`, fallback-encoded or not. A new value enters `DESIGN.md` first (colors and the examples scan: `tests/guards/consumer-css-discipline.test.ts`; kit radius: `tests/guards/kernel-css-architecture.test.ts`).
-- Emitted-but-unreferenced contract tokens are intentional. Runtime aliases and compatibility variables are different: each must have a live caller or be removed (`DESIGN.md` "CSS Architecture & Token Pipeline").
-- `DESIGN.md` `## Components` is the semantic component catalog. CSS is its implementation, and `tests/guards/component-contract-matches-css.test.ts` derives the two-way fence without a copied inventory.
-- `DESIGN.md` stays contract-only and spec-shaped: check `npm exec --package=@google/design.md -- design.md spec` before changing YAML fields. Exact reusable values go in the YAML front matter where the schema has a group for them and in the one `json design-tokens` fence where it does not, application guidance in prose. Add a non-spec YAML field only when repo code or a test reads it (spec-shape don'ts: `DESIGN.md` "Do's and Don'ts").
-- Seams and grids are computed, single-owner, never eyeballed (doctrine home: `DESIGN.md` "## Layout" and "Seam Ownership").
-- Authoring is contract-first: a visual behavior comes from `DESIGN.md`, from our own shipped surfaces, or from an explicit user approval, never from another product's rendered output. Screenshots verify, they never author. Ask when the contract leaves a decision open, and stop and re-read `DESIGN.md` before a second visual patch to the same component.
-- Name everything as NadicodeAI-owned primitives. A source brand never appears in a name, a comment, a contract, or any living design document.
-- Any change to package-consumed output ends with an explicit release decision, a version bump or a `[no-publish]` commit marker (enforced by the pre-push release gate, procedure: `../../docs/agents/publish.md`).
-- The deleted `design-canvas/` prototypes and static chat/autoplay surface live only in git history. `src/css/motion.css` owns shared runtime motion primitives. Never reconstruct the prototypes or add a runtime JS surface.
+| Design-language terms | `CONTEXT.md` |
+| Colors, tokens, typography, layout, seams, components | `DESIGN.md` |
+| CSS layers, token pipeline, dark remaps, generated outputs | [CSS Architecture & Token Pipeline](DESIGN.md#css-architecture--token-pipeline); decisions in `../../docs/adr/` |
+| Where a token is authored | the `DESIGN.md` front matter and its `json design-tokens` fence, built by `scripts/sd/design-tokens-fence.ts` and `scripts/sd/compose-token-graph.ts` |
+| Motion | [Motion](DESIGN.md#motion), `src/css/motion.css`, then `product-design` |
+| Package exports | `package.json`; guard `../../scripts/check-export-targets.mjs` |
+| Static consumption | `README.md`. React: `../ui/docs/consuming-cross-repo.md` |
+| Logo forms and asset delivery | [Brand media authority](DESIGN.md#brand-media-authority); sources in `src/assets/` |
+| `examples/` specimens | `examples/`; copy through `write-clearly` |
+| Visual tests | `playwright.visual.config.ts`, `tests/visual/` |
+| Releasing | `../../docs/agents/publish.md` |
+
+## Rules
+
+- Never edit `dist/**` or `src/css/*.generated.css` by hand; `npm run build` regenerates them from `DESIGN.md`.
+- Authoring is contract-first: a visual behavior comes from `DESIGN.md`, a shipped surface, or an explicit approval; screenshots verify, never author.
+- Name everything as a NadicodeAI-owned primitive; no source brand in a name, comment, or contract.

package/README.md

@@ -51,25 +51,15 @@ For direct HTML or CDN delivery, use a version-pinned file URL such as
 The clear-space, minimum-size, accessibility, background, and prohibited-use rules live only in
 [`DESIGN.md`, "Brand media authority"](./DESIGN.md#brand-media-authority).
 
-### Nadia assets
+### Nadia asset
 
-The approved Nadia images are available through:
+The approved background-neutral transparent Nadia master is available through:
 
 | Asset | Import |
 | --- | --- |
 | Canonical Nadia | `@nadicodeai/design-system/assets/nadia-solid-surface` |
-| Square, full silhouette | `@nadicodeai/design-system/assets/nadia-square-full` |
-| Square, head | `@nadicodeai/design-system/assets/nadia-square-head` |
-| Detail, gaze | `@nadicodeai/design-system/assets/nadia-detail-gaze` |
-| Detail, earring | `@nadicodeai/design-system/assets/nadia-detail-earring` |
-| Daylight (light grounds) | `@nadicodeai/design-system/assets/nadia-daylight` |
-| Daylight tonal lift (full resolution) | `@nadicodeai/design-system/assets/nadia-daylight-lift` |
-| Portrait (lit set) | `@nadicodeai/design-system/assets/nadia-portrait` |
-| Frontal (lit set) | `@nadicodeai/design-system/assets/nadia-frontal` |
-| Mirror (lit set) | `@nadicodeai/design-system/assets/nadia-mirror` |
-| Profile (lit set) | `@nadicodeai/design-system/assets/nadia-profile` |
-
-Each import resolves to the approved PNG. Identity and composition are owned by [`brand/AGENTS.md`](../../brand/AGENTS.md); this package README documents only the import surface.
+
+The import resolves to the approved transparent PNG. Identity and composition are owned by [`brand/AGENTS.md`](../../brand/AGENTS.md); this package README documents only the import surface.
 
 ## Data-only consumption
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/design-system",
-  "version": "3.2.0",
+  "version": "4.0.1",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -132,46 +132,6 @@
       "types": "./src/assets/nadia-asset.d.ts",
       "default": "./dist/assets/nadia-04-irregular-particles.png"
     },
-    "./assets/nadia-square-full": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-square-full.png"
-    },
-    "./assets/nadia-square-head": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-square-head.png"
-    },
-    "./assets/nadia-detail-gaze": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-detail-gaze.png"
-    },
-    "./assets/nadia-detail-earring": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-detail-earring.png"
-    },
-    "./assets/nadia-daylight": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-daylight.png"
-    },
-    "./assets/nadia-daylight-lift": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-daylight-lift.png"
-    },
-    "./assets/nadia-portrait": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-portrait.png"
-    },
-    "./assets/nadia-frontal": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-frontal.png"
-    },
-    "./assets/nadia-mirror": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-mirror.png"
-    },
-    "./assets/nadia-profile": {
-      "types": "./src/assets/nadia-asset.d.ts",
-      "default": "./dist/assets/nadia-profile.png"
-    },
     "./assets/fonts/geist.css": "./src/assets/fonts/geist.css",
     "./assets/fonts/*": "./src/assets/fonts/*"
   },