@nadicodeai/design-system 0.17.1 → 0.18.0

package/CONTEXT.md

@@ -37,6 +37,9 @@ The perceptual brightness difference that makes the edge between adjacent campi,
 **Page grammar**:
 The shared structural system of frames, rows, lanes, fills, seams, markers, grids, and stages used to compose NadicodeAI pages.
 
+**Seam**:
+A visible structural line in the page grammar: the shared edge where a frame, row, lane, or grid cell meets its neighbour. Exactly one element owns and draws each seam, so no coordinate is ever drawn twice, and seam placement is computed from grid math rather than eyeballed; the rule and the tokens that colour it live in `design-system/DESIGN.md` "Seam Ownership" and "Layout". This is the visual sense of the word only. Its architectural sense, a boundary in code a test can substitute, is general software vocabulary and not part of the design language.
+
 **CSS primitive**:
 A low-level, framework-agnostic CSS helper for geometry, type, seams, fills, or structural behavior. It carries no product-specific meaning.
 

package/DESIGN.md

@@ -743,6 +743,8 @@ The NadicodeAI logo has three approved forms:
 
 Nadia's portrait and generated imagery belong to the agent's visual identity. Neither is a NadicodeAI company logo.
 
+The four canonical Nadia material states ship as transparent PNG assets in their fixed semantic order: `assets/nadia-solid-surface`, `assets/nadia-ordered-points`, `assets/nadia-triangulated-wire`, and `assets/nadia-irregular-particles`. They are background-neutral compositing assets derived from the one approved identity and may sit on any field that keeps the selected state legible. The older editorial face and full-body references remain in the brand imagery library for generation guidance; they are not public product-portrait exports.
+
 All three forms derive from one authored, framework-neutral geometry source exported as `@nadicodeai/design-system/assets/logo-geometry`. The lockup combines the shared mark and wordmark geometry at the established proportion and spacing. No SVG, React component, favicon, document, or app re-authors, traces, typesets, or rearranges those shapes.
 
 Use the positive form on `{colors.canvas}` and the soft neutral canvases: ink letterforms and link with the primary verde link and `AI` suffix. Use the inverse form on `{colors.campo-inchiostro}`: campo-bianco letterforms and link with the dark-primary verde link and `AI` suffix. On `{colors.campo-verde}`, use the supplied on-verde form with one ink link and one white link. On photography, place the logo in a quiet area or over a scrim that keeps every part legible; when neither is available, mount it on an approved solid field. One surface uses one treatment.

package/README.md

@@ -51,6 +51,19 @@ 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 material states
+
+The package ships Nadia's four background-neutral transparent portraits in their fixed order:
+
+| State | Import |
+| --- | --- |
+| Solid surface | `@nadicodeai/design-system/assets/nadia-solid-surface` |
+| Ordered points | `@nadicodeai/design-system/assets/nadia-ordered-points` |
+| Triangulated wire | `@nadicodeai/design-system/assets/nadia-triangulated-wire` |
+| Irregular particles | `@nadicodeai/design-system/assets/nadia-irregular-particles` |
+
+Each import resolves to the canonical transparent PNG. Select the state for its product meaning; do not treat the four portraits as interchangeable decoration.
+
 ## Package surface
 
 `package.json` owns the current public export paths. [`DESIGN.md`](./DESIGN.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/design-system",
-  "version": "0.17.1",
+  "version": "0.18.0",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -116,9 +116,21 @@
       "import": "./src/assets/logo-geometry.js",
       "default": "./src/assets/logo-geometry.js"
     },
-    "./assets/nadia-canonical-face": {
-      "types": "./src/assets/nadia-canonical-face.d.ts",
-      "default": "./dist/assets/nadia-canonical-face.png"
+    "./assets/nadia-solid-surface": {
+      "types": "./src/assets/nadia-material-state.d.ts",
+      "default": "./dist/assets/nadia-01-solid-surface.png"
+    },
+    "./assets/nadia-ordered-points": {
+      "types": "./src/assets/nadia-material-state.d.ts",
+      "default": "./dist/assets/nadia-02-ordered-points.png"
+    },
+    "./assets/nadia-triangulated-wire": {
+      "types": "./src/assets/nadia-material-state.d.ts",
+      "default": "./dist/assets/nadia-03-triangulated-wire.png"
+    },
+    "./assets/nadia-irregular-particles": {
+      "types": "./src/assets/nadia-material-state.d.ts",
+      "default": "./dist/assets/nadia-04-irregular-particles.png"
     },
     "./assets/fonts/geist.css": "./src/assets/fonts/geist.css",
     "./assets/fonts/*": "./src/assets/fonts/*"