@nadicodeai/design-system 12.1.14 → 12.1.16

package/AGENTS.md

@@ -1,7 +1,8 @@
 # @nadicodeai/design-system
 
-`DESIGN.md` owns tokens, CSS, and asset contracts. React components belong
-to `@nadicodeai/ui`; `examples/` contains rendered specimens.
+`DESIGN.md` is nadicode's only design authority: the tokens and the rules
+every component, website section and product screen builds on. React components
+belong to `@nadicodeai/ui`; `examples/` contains rendered specimens.
 
 - Design and CSS changes: the relevant section of `DESIGN.md`.
 - Placement: this package and `@nadicodeai/ui` hold the Foundation and what at
@@ -18,6 +19,6 @@ are outputs, not hand-edited sources. Favicon source changes use
 `package.json` owns the commands; shared validation policy is in
 `../../docs/agents/develop.md`.
 
-Visual behavior comes from the design contract, a shipped surface, or the
-user's design decision. Screenshots verify that behavior. Name primitives
+Visual behavior comes from `DESIGN.md`, a shipped surface, or the user's
+design decision. Screenshots verify that behavior. Name primitives
 for nadicode's concepts, keeping source-brand lineage in references.

package/DESIGN.md

@@ -389,6 +389,8 @@ A product page is one of five compositions, each answering one question first:
 | Configuration | What can I change? | A centred reading column of titled sections, help beside each field, a local save and recovery. |
 | Library | What reusable thing can I use? | Kind, text identity, description, source and revision; detail shows content and requirements. |
 
+Every setting is that Configuration composition, whether it belongs to the person, to the platform or to one record's Settings tab, so the column keeps its width and its field layout from one entry of a settings menu to the next, and each section saves its own fields from its own footer. A table that reaches a reading column keeps the identity and the action beside it and lets its remaining columns fall to the row's supporting detail, rather than widening the page or scrolling sideways.
+
 A section earns a card when it owns a decision, not for every label and value. A row links to its object; overflow menus hold occasional commands, and a frequent next action stays visible. A summary on an overview opens the same owner as its tab. Supporting detail collapses only behind a summary that keeps a count, state or consequence.
 
 ## Elevation & Depth
@@ -502,7 +504,7 @@ One wait gets one indicator. A request waiting for a person is not a wait: queue
 
 ### Agent orbs
 
-An Agent is its orb, in every product; there is no other Agent picture. An orb is one of seven forms, `ribbon`, `lattice`, `orbit`, `globe`, `network`, `braid` and `morph`, in one colour a person chose: cobalto, verde or arancio, or none, which draws it in the text colour. Giallo is not offered because it fails 3:1 on white; rosso is not offered because it is the error red. Nadia alone is her striped ribbon, azzurro, verde, the text colour and rosso along its whole length, the same at every size and in every state.
+An Agent is its orb, in every product; there is no other Agent picture. An orb is one of seven forms, `ribbon`, `lattice`, `orbit`, `globe`, `network`, `braid` and `morph`, in one colour a person chose: cobalto, verde or arancio, or none, which draws it in the text colour. Giallo is not offered because it fails 3:1 on white; rosso is not offered because it is the error red. Nadia alone is her striped ribbon, the form `nadia`, azzurro, verde, the text colour and rosso along its whole length, the same at every size and in every state.
 
 - **Stored look.** An Agent's form is stored as `orb:<form>` and its colour as the identity hex or nothing; a template declares its starting look the same way. The root Agent always draws as Nadia. An unknown form draws `orbit`, an unknown colour the text colour, and a stored rosso draws arancio. The look is a person's choice and is never derived from a name, id or role.
 - **Sizes** are 20, 24, 32, 40, 64, 96 and 160 px. On a photograph an orb takes the stronger `over-picture` weight; everywhere else it is `plain`.

package/GLOSSARY.md

@@ -17,11 +17,8 @@ _Avoid_: Theme, skin
 **Neutral spine**:
 The achromatic colour roles that carry grounds, chrome, hierarchy, and every control in every Register. Chromatic colour belongs to the Identity palette, the semantic feedback roles and the chart palette.
 
-**Functional tier**:
-The semantic colour roles and chart colours used for interface state and data.
-
 **Identity palette**:
-The brand's colour: five full-strength hues, cobalto, verde, arancio, giallo and rosso, with the white and ink poles type sits on. They appear flat as website section grounds, stages, accents, Agents, the logo and imagery, and never on a control.
+The brand's colour: five full-strength hues, cobalto, verde, arancio, giallo and rosso, with the white and ink poles type sits on. They appear flat as website section grounds, stages, accents on the website, Agents, the logo and imagery, and never on a control.
 _Avoid_: Swatch, theme color, Agent identity palette
 
 **Identity plane**:
@@ -33,19 +30,19 @@ The Identity palette ground behind a floating product view, which glass over it
 ### Structure and surfaces
 
 **Website column**:
-The website's one centred content column, whose edges are drawn as rails through every full-bleed section.
+The website's one centred content column, which every full-bleed section centres its content in.
 
 **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.
 
 **Material ladder**:
-The Portal and desktop Registers' structure: one continuous workspace ground with solid objects at four heights above it, resting, raised, floating and modal, and glass kept for floating chrome.
+The set of materials a product surface can be made of: the workspace ground, the four solid heights above it, and glass.
 
 **Height**:
-How far a solid surface sits above the workspace ground, chosen by its physical role: shadow shows it in light and tone shows it in dark.
+How far a solid surface sits above the workspace ground, one of resting, raised, floating and modal.
 
 **Glass**:
-A translucent, blurred and saturated material for floating chrome over colour or motion; content never takes it.
+The translucent, blurred and saturated material, so what moves or carries colour behind a surface still reads through it.
 
 **Seam**:
 A visible structural line between two parts of a layout, drawn as one hairline in the line colour.
@@ -60,7 +57,7 @@ The five colours that mark where a piece of agentic work stands: ready, running,
 A visual family outside the conversation renderer for work output and workflow state, such as memory, run progress, identity, and handoffs.
 
 **Agent orb**:
-The decorative identity of one Agent across products: one of seven forms in one chosen colour, or Nadia's striped ribbon.
+The 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
 
 **Product view**:

package/README.md

@@ -24,10 +24,9 @@ Individual font files are also exposed under `@nadicodeai/design-system/assets/f
 
 ## nadicode logo assets
 
-The wordmark names the company in full and is the form to reach for. The mark
-is the plain n cut from it, for placements where the name does not fit; the
-icon is that n white on the cobalto tile, for app icons, favicons and avatars.
-Transparent PNG fallbacks are provided for software that cannot place SVG files.
+[Brand media authority](DESIGN.md#brand-media-authority) says what the three
+forms are and where each one goes. This table is the file behind each, with
+transparent PNG fallbacks for software that cannot place SVG.
 
 | Form | On white or a soft neutral | On black or another dark ground |
 | --- | --- | --- |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/design-system",
-  "version": "12.1.14",
+  "version": "12.1.16",
   "type": "module",
   "publishConfig": {
     "access": "public"