@nadicodeai/design-system 12.1.2 → 12.1.4

package/DESIGN.md

@@ -330,6 +330,24 @@ Geist and Geist Mono are the two families. The twelve tokens are named by role,
 
 A token has one size at every width; nothing is sized in `vw` or `vh`. Only the three display tokens carry negative tracking. Card, panel and section titles are sentence-case Geist. The website and the CSS components name the tokens through the `nc-type-*` classes; product UI in `@nadicodeai/ui`, the Portal and Nadia sizes text with Tailwind's `text-xs`, `text-sm` and `text-base`, which match `caption`, `body-sm` and `body-md` in size.
 
+### Entry screens
+
+Installation, startup, sign-in and recovery use `{typography.body-md}` for their
+instructions, greetings and status messages, at its regular weight. A genuine
+screen title may use `{typography.heading-sm}`; a changing status or an
+instruction never becomes a heading merely because the screen has little copy.
+Actions and stage lists use `{typography.body-sm}`, and progress counts use
+`{typography.label-mono}`. These roles retain their token sizes at every width.
+
+A single-task entry screen centres the visible identity, message and actions as
+one group in the usable window, horizontally and vertically. Hidden content and
+reserved empty rows do not contribute to that group's height. A progress screen
+may reserve the lines its status needs to prevent movement between stages.
+Artwork stays clear of the task and retains complete architectural and figure
+boundaries when placed inside the window; an image edge must not masquerade as a
+finished object edge. Compact layouts preserve readable controls and scroll when
+content cannot fit.
+
 ## Layout
 
 Every gap, pad and stack step a page, section or composition sets is a rung of the spacing ladder, `{spacing.xxs}` 4 px through `{spacing.6xl}` 128 px; a layout picks the rungs it needs and never interpolates between them. Inside a component, the stock shadcn registry's own spacing stands. Every visible line has one owner: a seam is `{spacing.guide}` in `{colors.line}`, a control edge is `{colors.input}`, and focus is the focus outline.
@@ -411,6 +429,8 @@ Every surface and control takes `{rounded.md}` (6 px): cards, tables, menus, pop
 
 ## Motion
 
+UI text stays static: no shimmer, typing, scrambling, pulsing or animated dots. Status labels use sentence case without trailing ellipses; complete instructional sentences keep their punctuation.
+
 Only Agents move on their own. The interface answers a person's action, briefly, and stops: motion follows the action, grows from the element that was pressed, and settles, within 300 ms; sheets and drawers that follow the pointer take their own durations. Keyboard actions and anything used a hundred times a day are instant. While a person waits for something they asked for, one waiting line moves and nothing else ("System activity"). Nothing on the website moves but Agents and the product at work: no parallax, scroll reveal, marquee or shimmer.
 
 The default transition in every product is `confirm`, 180 ms, `out-strong`. Under reduced motion, movement stops and paint continues: transforms and keyframed movement go to their end state, and opacity and colour transitions stay, because a fade or a colour change is the state change itself. A component never answers reduced motion by turning every transition off.

package/package.json

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