@nadicodeai/design-system 9.0.0 → 9.0.2

package/AGENTS.md

@@ -4,7 +4,9 @@
 to `@nadicodeai/ui`; `examples/` contains rendered specimens.
 
 - Design and CSS changes: the relevant section of `DESIGN.md`.
-- Terms: `CONTEXT.md`. Static consumption: `README.md`.
+- Placement: this package and `@nadicodeai/ui` hold the Foundation and what at
+  least two products use; what one product alone needs lives in that product.
+- Terms: `GLOSSARY.md`. Static consumption: `README.md`.
 - React consumption: `../ui/docs/consuming-cross-repo.md`.
 - Visual checks: `playwright.visual.config.ts` and `tests/visual/`.
 - Releases: `../../docs/agents/publish.md`.

package/{CONTEXT.md → GLOSSARY.md}

@@ -7,16 +7,13 @@ The shared vocabulary for NadicodeAI's reusable visual decisions and interface s
 ### Foundations
 
 **Foundation**:
-The visual values shared by every NadicodeAI product, including colour roles, typography, spacing, shape, material, elevation, motion, icons, and brand assets.
+The visual values available to every NadicodeAI product, whether one product renders them or three: colour roles, typography, spacing, shape, material, elevation, motion, icons, and brand assets.
 _Avoid_: Palette, base theme
 
 **Register**:
 One product's visual rules for applying the Foundation. NadicodeAI has three Registers: website, Portal, and Nadia desktop.
 _Avoid_: Theme, skin
 
-**Placement**:
-Where a component, asset or style is kept. `@nadicodeai/ui` and `@nadicodeai/design-system` hold the Foundation and what at least two products use; a component, asset or style one product alone needs lives in that product's own directory. Nadia's entry screen is the worked example: its room, presence and typed line live in the desktop, not here.
-
 **Neutral spine**:
 The achromatic colour roles that carry grounds, chrome, hierarchy, and every control in every Register. Chromatic colour is reserved for the semantic feedback roles, the verde brand accent in its scoped duties, the chart palettes, and the Agent identity palette.
 
@@ -24,16 +21,28 @@ The achromatic colour roles that carry grounds, chrome, hierarchy, and every con
 The semantic colour roles and chart colours used for interface state and data.
 
 **Agent identity palette**:
-The five full-strength hues, plus the white and ink poles, that paint Agent identity visuals, the brand book's identity planes, and generated editorial imagery. Emitted as the `identity-*` colour tokens.
+The five full-strength hues, plus the white and ink poles, that paint Agent identity visuals, the brand book's identity planes, and generated editorial imagery.
 _Avoid_: Swatch, theme color
 
+**Verde vivo**:
+Nadia's presence accent: the colour of the marks that say Nadia herself is here.
+
 **Identity plane**:
 A surface painted edge to edge in one Agent identity palette colour.
 
 ### Structure and surfaces
 
 **Page grammar**:
-The shared structural vocabulary of frames, rows, lanes, fills, seams, markers, grids, and stages.
+The website Register's structural vocabulary of frames, rows, lanes, fills, seams, markers, grids, and stages.
+
+**Page composition**:
+One of the five repeated page shapes the products build from: Overview, Collection, Object, Configuration and Library, each defined by the first question it answers.
+
+**Delivery tier**:
+One of the five homes a reusable design decision ships from: tokens, CSS components, compositions, layout grammar, or specimens. Each decision has exactly one.
+
+**Material ladder**:
+The Portal and desktop Registers' structure: one continuous workspace ground and one solid fill for every object, with glass kept for floating chrome.
 
 **Seam**:
 The visible structural line where parts of the Page grammar meet.
@@ -41,6 +50,9 @@ The visible structural line where parts of the Page grammar meet.
 **Status vocabulary**:
 The shared five-tone visual language for product status. Each product owns its status families, values, and mapping to those tones.
 
+**Workflow states**:
+The five colours that mark where a piece of agentic work stands: ready, running, in review, blocked, and complete. They are separate from the Status vocabulary.
+
 **Content surface**:
 A visual family for presenting a specific kind of content inside the Page grammar.
 
@@ -50,3 +62,6 @@ A visual family outside the conversation renderer for work output and workflow s
 **Agent orb**:
 The decorative identity of one Agent across products: one of seven forms in one chosen colour, or Nadia's striped ribbon.
 _Avoid_: Agent glyph, Agent avatar, Agent visual
+
+**System activity**:
+The shared visual family for work the system is doing now, loading, connecting or processing, drawn as the activity orb. It never stands for an Agent.

package/README.md

@@ -72,7 +72,7 @@ Two token files ship, both rooted at `nadicode`, with `nadicode.core.*` the foun
 | `@nadicodeai/design-system/tokens/dtcg` | the canonical contract: every alias and every `$extensions` entry preserved | reading which foundation value a register role derives from |
 | `@nadicodeai/design-system/tokens/dtcg-resolved` | the same groups, types, descriptions, and extensions, with every alias replaced by its value | generating a theme without an alias engine |
 
-The tarball also carries three root documents. [`DESIGN.md`](./DESIGN.md) is the contract a session reads before it styles anything, [`AGENTS.md`](./AGENTS.md) is this workspace's rulebook, and [`CONTEXT.md`](./CONTEXT.md) is the shared design vocabulary.
+The tarball also carries three root documents. [`DESIGN.md`](./DESIGN.md) is the contract a session reads before it styles anything, [`AGENTS.md`](./AGENTS.md) is this workspace's rulebook, and [`GLOSSARY.md`](./GLOSSARY.md) is the shared design vocabulary.
 
 Load the brand typeface from `@nadicodeai/design-system/assets/fonts/geist.css`, which declares the `@font-face` rules and points them at the packaged woff2 files. One loader per app: a second declaration of Geist, from Google Fonts or a hand-written `@font-face`, downloads the face twice and is a defect.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/design-system",
-  "version": "9.0.0",
+  "version": "9.0.2",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -123,7 +123,7 @@
   },
   "files": [
     "AGENTS.md",
-    "CONTEXT.md",
+    "GLOSSARY.md",
     "README.md",
     "DESIGN.md",
     "LICENSES",