@nadicodeai/ui 6.6.2 → 7.0.0

package/AGENTS.md

@@ -9,9 +9,8 @@ exports.
 - Tokens, CSS, motion, and assets: `../design-system/DESIGN.md`.
 - Agent visuals: `docs/agent-visual.md`; the Forma avatars: `docs/forma-avatar.md`.
 - System activity indicators: `docs/activity.md`.
-- First run, sign-in, and repair surfaces: `docs/threshold.md`; the
-  primitives are `@nadicodeai/ui/threshold`, with
-  `@nadicodeai/ui/threshold.css` beside them.
+- What belongs in this package and what belongs in a product: `docs/contract.md`,
+  "Placement". Nadia's entry screen is the worked example that moved out.
 - Package releases: `../../docs/agents/publish.md`.
 
 `npm run dev -w @nadicodeai/ui` watches source and refreshes `dist/`;

package/dist/components/activity-orb.d.ts

@@ -7,7 +7,7 @@ export type ActivityOrbProps = {
     style?: CSSProperties;
     /** Freeze the animation for a preview or a user-controlled motion pause. */
     paused?: boolean;
-    /** 20 inline, 64 within a region, 88 at an application threshold. */
+    /** 20 inline, 64 within a region, 88 on an application's entry screen. */
     size?: ActivityOrbSize;
 } & ({
     decorative: true;

package/dist/components/activity-orb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity-orb.d.ts","sourceRoot":"","sources":["../../src/components/activity-orb.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAoB,MAAM,yBAAyB,CAAC;AAGpG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB,GAAG,CAAC;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElF,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,SAAS,EACT,UAAkB,EAClB,KAAK,EACL,MAAc,EACd,IAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,gBAAgB,+BAmClB"}
+{"version":3,"file":"activity-orb.d.ts","sourceRoot":"","sources":["../../src/components/activity-orb.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAoB,MAAM,yBAAyB,CAAC;AAGpG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB,GAAG,CAAC;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElF,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,SAAS,EACT,UAAkB,EAClB,KAAK,EACL,MAAc,EACd,IAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,gBAAgB,+BAmClB"}

package/docs/activity.md

@@ -61,7 +61,7 @@ movement as well as its travelling particles. The implementation owns these
 values together; consumers cannot tune speed, density or particle colours.
 
 Use 20 CSS pixels inline, including buttons and rows with room for that size;
-64 for a contained region; 88 for an application threshold. The 20 preset is
+64 for a contained region; 88 on an application's entry screen. The 20 preset is
 separately tuned, and must not be obtained by shrinking the 64 preset. The 88
 extent uses the 64 preset. A 12–16 pixel badge slot keeps its existing compact
 spinner until its surrounding component explicitly accommodates this family.
@@ -103,10 +103,9 @@ the operation fails or React replaces the startup surface.
 
 Import `@nadicodeai/ui/globals.css` as described in the
 [consumer guide](consuming-cross-repo.md). The renderer inherits actual CSS
-ink and reads canonical colour tokens. The existing `Orb` threshold adapter
-keeps its public API: `working` maps to `processing`, `connecting` maps to
-`connecting`, and `absent` mounts nothing. Its fixed dark appearance stays at
-the threshold seam, outside the shared renderer.
+ink and reads canonical colour tokens. Nadia's entry screen wraps this renderer
+in its own `Orb`, which fixes a dark appearance the shared renderer knows
+nothing about; that wrapper lives in the desktop, not here.
 
 ## Accessibility and runtime
 

package/docs/contract.md

@@ -6,7 +6,7 @@ The normative invariants for the `@nadicodeai/ui` package: what may live here, h
 
 - **Token-only, no raw literals or shadow aliases.** Components style through semantic shadcn utilities (`bg-background`, `text-foreground`, `border-input`, and the rest), or a canonical generated design-system token when no standard role is precise enough. The UI package does not mint screen-, component-, or product-specific color aliases. No raw `#hex` / `rgb()` / `hsl()` may appear in `.tsx`; a new source value goes to `packages/design-system/DESIGN.md` first and flows through generated output. A narrow protocol adapter may translate third-party classes directly to canonical tokens in `globals.css`, but it must not create another token vocabulary. Enforced by the raw-colour `no-restricted-syntax` selectors in the library ESLint config, `packages/ui/tests/guards/dark-semantic-roles.test.ts`, and `packages/ui/tests/guards/token-reference-integrity.test.ts`.
 - **Dark-ready semantics, no component dark implementation.** Components use the same semantic role or canonical mode-aware token in every mode. They must not ship Tailwind `dark:` color utilities, component-local `.dark` blocks, OS dark-mode branching, or raw dark palette utilities such as `dark:bg-slate-950` and `dark:text-white`. An intentionally fixed-presentation technology surface, such as the dark terminal console, selects canonical fixed-mode tokens as one coherent component treatment rather than branching by app theme. Enforced by `packages/ui/tests/guards/no-dark.test.ts`, `packages/ui/tests/guards/dark-semantic-roles.test.ts`, and `packages/ui/tests/guards/token-reference-integrity.test.ts`. The generated mode and theme architecture lives only in [`packages/design-system/DESIGN.md`](../../design-system/DESIGN.md#css-architecture--token-pipeline).
-- **Components inherit one complete React style interface.** `@nadicodeai/ui/globals.css` composes every style dependency owned by this package, including the complete design-system CSS module. Components carry no theme of their own, and React callers do not compose design-system stylesheets or partials beside it. Installation and source-scanning setup live in the [consumer setup guide](consuming-cross-repo.md). `@nadicodeai/ui/threshold.css` is the one stylesheet outside it, because the surface that needs it most loads no Tailwind layer at all: the Nadia desktop shell takes that file and the design system's token artifact and nothing else. A React caller imports it beside globals.css, never instead of it.
+- **Components inherit one complete React style interface.** `@nadicodeai/ui/globals.css` composes every style dependency owned by this package, including the complete design-system CSS module. Components carry no theme of their own, and React callers do not compose design-system stylesheets or partials beside it. Installation and source-scanning setup live in the [consumer setup guide](consuming-cross-repo.md). `@nadicodeai/ui/globals.css` is the only stylesheet this package ships; a surface that loads no Tailwind layer takes the design system's token artifact and writes its own rules against it.
 - **Design-system geometry remains the foundation.** React components compose the kept `nc-*` page grammar and display CSS components; they do not redefine frame math, marker placement, token values, or raw CSS geometry. Use parent-paints-plus-gap for bordered cell grids and keep every visible seam single-owner (doctrine home: `packages/design-system/DESIGN.md` "## Layout").
 
 ### Persistent notices
@@ -139,8 +139,7 @@ gone, is [`packages/design-system/DESIGN.md`, "## Status Vocabulary"](../../desi
 System activity uses `ActivityOrb` for loading, connecting and processing;
 [activity.md](activity.md) owns selection, rendering and accessibility. It
 composes with status feedback and measured progress without adding outcome
-states to the orb. The existing threshold `Orb` adapts its public states to
-this same renderer.
+states to the orb.
 
 - **Source-authored, built package.** Components are authored as shadcn-style source in `src/`, then emitted to `dist/` for consumption by other apps. Package exports must point at built JS, declarations, and CSS, never raw `src/*.tsx`, and `npm pack --dry-run` must include only intentional consumer artifacts.
 - **Package surface is source-backed.** Public components stay flat under `src/components/`. Reviewed registry source under `src/internal/` is implementation, not a package namespace. Do not add top-level exports for recipes, blocks, agent, terminal, or vendor groupings unless a later package API decision adds concrete public source, built files, docs, and tests in the same change.
@@ -152,7 +151,19 @@ this same renderer.
 
 ## Admission Rules
 
-Assistant conversation and runtime APIs enter through `@nadicodeai/ui/agents`; Agent identity enters through `@nadicodeai/ui/components/agent-card`, `@nadicodeai/ui/components/agent-visual`, and the Forma avatars in `@nadicodeai/ui/components/forma-avatar` (owned by [`forma-avatar.md`](forma-avatar.md)). The consuming application still constructs the runtime and owns transport, persistence, permissions, tools, approvals, and failure policy. Shared non-Agent product components (a shell, a settings surface, a generic section, a diff, or a file preview) are admitted only with a named consuming surface landing in the same change. App-bespoke UI and behavior (window chrome, PTY/xterm embeds, queues, approvals, and persistence) stay in the consuming app; they never become package abstractions. `@nadicodeai/ui/threshold` is the plan-approved package surface for the room, Nadia's presence, the status orb and the typed line used by the Nadia desktop app. The screen, its copy and its state machine stay in the consuming app, and the entry ships no screen. Its contract is [`threshold.md`](threshold.md). A component left unconsumed after its target migration ships gets removed.
+Assistant conversation and runtime APIs enter through `@nadicodeai/ui/agents`; Agent identity enters through `@nadicodeai/ui/components/agent-card`, `@nadicodeai/ui/components/agent-visual`, and the Forma avatars in `@nadicodeai/ui/components/forma-avatar` (owned by [`forma-avatar.md`](forma-avatar.md)). The consuming application still constructs the runtime and owns transport, persistence, permissions, tools, approvals, and failure policy. Shared non-Agent product components (a shell, a settings surface, a generic section, a diff, or a file preview) are admitted only with a named consuming surface landing in the same change. App-bespoke UI and behavior (window chrome, PTY/xterm embeds, queues, approvals, and persistence) stay in the consuming app; they never become package abstractions. A component left unconsumed after its target migration ships gets removed.
+
+### Placement
+
+`@nadicodeai/ui` and `@nadicodeai/design-system` hold the Foundation and the
+components, assets and styles 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: the room, the presence, the typed line and
+their stylesheet were a package surface no other product imported, and they now
+live in the desktop at `apps/nadia/hermes/apps/desktop/src/plugins/nadia/entry/`,
+where [`apps/nadia/docs/entry-screen.md`](../../../apps/nadia/docs/entry-screen.md)
+owns their contract. `packages/ui/tests/guards/product-placement.test.ts`
+refuses a product's name in either package.
 
 ### Agent identity presentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/ui",
-  "version": "6.6.2",
+  "version": "7.0.0",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -19,11 +19,6 @@
       "types": "./dist/agents.d.ts",
       "import": "./dist/agents.js"
     },
-    "./threshold": {
-      "types": "./dist/threshold.d.ts",
-      "import": "./dist/threshold.js"
-    },
-    "./threshold.css": "./dist/components/threshold/threshold.css",
     "./activity": {
       "types": "./dist/activity.d.ts",
       "import": "./dist/activity.js"
@@ -70,7 +65,7 @@
     "@assistant-ui/react": "0.15.18",
     "@assistant-ui/react-markdown": "0.14.14",
     "@base-ui/react": "^1.8.0",
-    "@nadicodeai/design-system": "6.6.2",
+    "@nadicodeai/design-system": "7.0.0",
     "@paper-design/shaders": "0.0.80",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",

package/dist/components/threshold/canvas-budget.d.ts

@@ -1,10 +0,0 @@
-/** True while a primitive that outranks the room owns the window's canvas. */
-export declare function canvasHeld(): boolean;
-/**
- * Take the window's canvas. Returns the release, which is idempotent: a
- * teardown that runs twice releases once.
- */
-export declare function holdCanvas(): () => void;
-/** Whether the room must yield its canvas right now. Live. */
-export declare function useCanvasHeld(): boolean;
-//# sourceMappingURL=canvas-budget.d.ts.map

package/dist/components/threshold/canvas-budget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"canvas-budget.d.ts","sourceRoot":"","sources":["../../../src/components/threshold/canvas-budget.ts"],"names":[],"mappings":"AA0BA,8EAA8E;AAC9E,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,IAAI,CAWvC;AAWD,8DAA8D;AAC9D,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/components/threshold/canvas-budget.js

@@ -1,54 +0,0 @@
-"use client";
-import { useSyncExternalStore } from "react";
-/*
- * One shader canvas per window: the living-elements register's rule, held
- * here so no screen can break it by composition.
- *
- * Two threshold primitives can paint with a shader, the room and the arriving
- * presence, and a threshold mounts both. The presence's water outranks the
- * room: while Nadia is arriving her water is the window's one live canvas and
- * the room shows its still field; when she stands clear the water leaves and
- * the room's canvas is the one that paints. The presence takes a hold for as
- * long as its water is wanted, and the room yields while any hold is out.
- *
- * The budget is per window, so it is module state rather than a context: a
- * provider would let a surface forget to wrap both primitives, and the rule
- * would then hold only where someone remembered it.
- */
-let holds = 0;
-const listeners = new Set();
-const notify = () => {
-    for (const listener of listeners)
-        listener();
-};
-/** True while a primitive that outranks the room owns the window's canvas. */
-export function canvasHeld() {
-    return holds > 0;
-}
-/**
- * Take the window's canvas. Returns the release, which is idempotent: a
- * teardown that runs twice releases once.
- */
-export function holdCanvas() {
-    holds += 1;
-    notify();
-    let released = false;
-    return () => {
-        if (released)
-            return;
-        released = true;
-        holds -= 1;
-        notify();
-    };
-}
-function subscribe(listener) {
-    listeners.add(listener);
-    return () => {
-        listeners.delete(listener);
-    };
-}
-const serverSnapshot = () => false;
-/** Whether the room must yield its canvas right now. Live. */
-export function useCanvasHeld() {
-    return useSyncExternalStore(subscribe, canvasHeld, serverSnapshot);
-}

package/dist/components/threshold/index.d.ts

@@ -1,6 +0,0 @@
-export { Orb, type OrbProps, type OrbSize, type OrbState, type OrbTheme } from "./orb.js";
-export { arrivalOpacity, NadiaPresence, type NadiaPresenceProps, type PresenceState, } from "./presence.js";
-export { ThresholdRoom, type ThresholdRoomProps } from "./room.js";
-export { TypedLine, type TypedLineProps } from "./typed-line.js";
-export { useReducedMotion } from "./use-reduced-motion.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/components/threshold/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/threshold/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AACvF,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/components/threshold/index.js

@@ -1,5 +0,0 @@
-export { Orb } from "./orb.js";
-export { arrivalOpacity, NadiaPresence, } from "./presence.js";
-export { ThresholdRoom } from "./room.js";
-export { TypedLine } from "./typed-line.js";
-export { useReducedMotion } from "./use-reduced-motion.js";

package/dist/components/threshold/orb.d.ts

@@ -1,14 +0,0 @@
-import { type ActivityOrbSize } from "../activity-orb.js";
-export type OrbState = "working" | "connecting" | "absent";
-export type OrbTheme = "auto" | "dark" | "light";
-export type OrbSize = ActivityOrbSize;
-export type OrbProps = {
-    className?: string;
-    label: string;
-    size?: OrbSize;
-    state: OrbState;
-    theme?: OrbTheme;
-};
-/** Preserve the threshold API while using the one shared activity renderer. */
-export declare function Orb({ className, label, size, state, theme }: OrbProps): import("react").JSX.Element | null;
-//# sourceMappingURL=orb.d.ts.map

package/dist/components/threshold/orb.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orb.d.ts","sourceRoot":"","sources":["../../../src/components/threshold/orb.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG9E,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AAC3D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACjD,MAAM,MAAM,OAAO,GAAG,eAAe,CAAC;AAEtC,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAUF,+EAA+E;AAC/E,wBAAgB,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAS,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE,QAAQ,sCAYnF"}

package/dist/components/threshold/orb.js

@@ -1,17 +0,0 @@
-"use client";
-import { jsx as _jsx } from "react/jsx-runtime";
-import { ActivityOrb } from "../activity-orb.js";
-import { cn } from "../../lib/utils.js";
-// A threshold deliberately fixes its appearance. Normal product surfaces
-// inherit their ink; the shared renderer needs no knowledge of app themes.
-const THEME_INK = {
-    auto: "inherit",
-    dark: "var(--nc-dark-ink)",
-    light: "var(--nc-ink)",
-};
-/** Preserve the threshold API while using the one shared activity renderer. */
-export function Orb({ className, label, size = 88, state, theme = "dark" }) {
-    if (state === "absent")
-        return null;
-    return (_jsx(ActivityOrb, { activity: state === "working" ? "processing" : "connecting", className: cn("nc-threshold-orb", className), "data-state": state, label: label, size: size, style: { color: THEME_INK[theme] } }));
-}

package/dist/components/threshold/presence.d.ts

@@ -1,27 +0,0 @@
-export type PresenceState = "arriving" | "present" | "ready" | "error";
-export type NadiaPresenceProps = {
-    className?: string;
-    /** The accessible name of the arrival, read by the hidden progress bar. */
-    label: string;
-    /** 0 while she is behind the field, 1 when she stands clear. */
-    reveal: number;
-    /**
-     * The portrait master. The package imports no binary asset of its own, so
-     * the consuming surface resolves `@nadicodeai/design-system/assets/nadia-solid-surface`
-     * with its own bundler and passes the URL here.
-     */
-    src: string;
-    state: PresenceState;
-};
-/** The arrival curve: a trace at the start, not a face already half-built. */
-export declare function arrivalOpacity(reveal: number): number;
-/**
- * Nadia at a threshold.
- *
- * `reveal` drives one opacity, so nothing re-renders per frame and the value
- * a Customer sees is the value assistive technology is told. The lower edge
- * dissolves into the room instead of ending on a rectangle. At `state="ready"`
- * she takes one short verde vivo beat, her presence accent, and settles.
- */
-export declare function NadiaPresence({ className, label, reveal, src, state }: NadiaPresenceProps): import("react").JSX.Element;
-//# sourceMappingURL=presence.d.ts.map

package/dist/components/threshold/presence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../src/components/threshold/presence.tsx"],"names":[],"mappings":"AA+CA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC;AAIF,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAgBD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,kBAAkB,+BAsIzF"}

package/dist/components/threshold/presence.js

@@ -1,159 +0,0 @@
-"use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { defaultObjectSizing, ShaderFitOptions, ShaderMount, waterFragmentShader, } from "@paper-design/shaders";
-import { useEffect, useRef, useState } from "react";
-import { resolveIdentityColor } from "../../internal/agent-visual/color.js";
-import { cn } from "../../lib/utils.js";
-import { holdCanvas } from "./canvas-budget.js";
-import { useReducedMotion } from "./use-reduced-motion.js";
-/*
- * Nadia's presence: the portrait master itself, arriving through the room. No
- * medallion, no ring, no bar. How much of her you can see is the progress.
- *
- * While she is arriving the portrait carries Paper Shaders' Water at a
- * restrained intensity, so the field she is coming through moves across her
- * without taking her geometry apart. Every amplitude is scaled by how much of
- * the arrival is left, so the water is gone by the time she stands clear. At
- * reveal 1, and in every other state, this is the plain portrait.
- *
- * The water is the window's one shader canvas while it is wanted. The presence
- * holds the canvas budget from the moment the water is asked for until it is
- * torn down, and the room keeps its still field for exactly that long
- * (`canvas-budget.ts`).
- */
-const ARRIVAL_FLOOR = 0.025;
-const ARRIVAL_CURVE = 1.25;
-const WATER_CAUSTIC = 0.35;
-const WATER_EDGES = 0.4;
-const WATER_WAVES = 0.3;
-const WATER_LAYERING = 0.4;
-const WATER_HIGHLIGHTS = 0.12;
-const WATER_SIZE = 1;
-const WATER_SPEED = 1;
-const WATER_FRAME = 0;
-const WATER_MIN_PIXEL_RATIO = 1;
-const WATER_MAX_PIXEL_COUNT = 1_024_000;
-const PRESENCE_FIELD_TOKEN = "--nc-identity-verde";
-const TRANSPARENT = [0, 0, 0, 0];
-const clampUnit = (value) => Math.min(Math.max(value, 0), 1);
-/** The arrival curve: a trace at the start, not a face already half-built. */
-export function arrivalOpacity(reveal) {
-    return ARRIVAL_FLOOR + (1 - ARRIVAL_FLOOR) * clampUnit(reveal) ** ARRIVAL_CURVE;
-}
-function waterUniforms(reveal, field) {
-    const remaining = 1 - clampUnit(reveal);
-    return {
-        u_caustic: WATER_CAUSTIC * remaining,
-        u_colorBack: TRANSPARENT,
-        u_colorHighlight: field,
-        u_edges: WATER_EDGES * remaining,
-        u_highlights: WATER_HIGHLIGHTS,
-        u_layering: WATER_LAYERING,
-        u_size: WATER_SIZE,
-        u_waves: WATER_WAVES * remaining,
-    };
-}
-/**
- * Nadia at a threshold.
- *
- * `reveal` drives one opacity, so nothing re-renders per frame and the value
- * a Customer sees is the value assistive technology is told. The lower edge
- * dissolves into the room instead of ending on a rectangle. At `state="ready"`
- * she takes one short verde vivo beat, her presence accent, and settles.
- */
-export function NadiaPresence({ className, label, reveal, src, state }) {
-    const still = useReducedMotion();
-    const hostRef = useRef(null);
-    const mountRef = useRef(null);
-    const [surface, setSurface] = useState("portrait");
-    const value = clampUnit(reveal);
-    const arriving = state === "arriving";
-    const wet = arriving && value < 1 && !still;
-    useEffect(() => {
-        const host = hostRef.current;
-        if (!host || !wet)
-            return;
-        const field = resolveIdentityColor(host, PRESENCE_FIELD_TOKEN);
-        if (!field)
-            return;
-        let cancelled = false;
-        let canvas = null;
-        // Taken before the image decodes: the room stays still while her water is
-        // on its way, not only once it paints.
-        const releaseCanvas = holdCanvas();
-        const clearCanvases = () => {
-            for (const element of host.querySelectorAll("canvas"))
-                element.remove();
-            host.removeAttribute("data-paper-shader");
-        };
-        const teardown = () => {
-            canvas?.removeEventListener("webglcontextlost", handleContextLost);
-            canvas = null;
-            try {
-                mountRef.current?.dispose();
-            }
-            catch {
-                // The plain portrait is what stays; vendor cleanup failing is not
-                // allowed to remove Nadia from the screen.
-            }
-            mountRef.current = null;
-            clearCanvases();
-            // After disposal, so the room's canvas is never alive beside this one.
-            releaseCanvas();
-        };
-        function handleContextLost(event) {
-            event.preventDefault();
-            teardown();
-            setSurface("portrait");
-        }
-        const image = new Image();
-        image.decoding = "async";
-        image.src = src;
-        const mount = async () => {
-            try {
-                await image.decode();
-                if (cancelled)
-                    return;
-                mountRef.current = new ShaderMount(host, waterFragmentShader, {
-                    ...waterUniforms(value, field),
-                    u_fit: ShaderFitOptions.contain,
-                    u_image: image,
-                    u_offsetX: defaultObjectSizing.offsetX,
-                    u_offsetY: defaultObjectSizing.offsetY,
-                    u_originX: defaultObjectSizing.originX,
-                    u_originY: defaultObjectSizing.originY,
-                    u_rotation: defaultObjectSizing.rotation,
-                    u_scale: defaultObjectSizing.scale,
-                    u_worldHeight: defaultObjectSizing.worldHeight,
-                    u_worldWidth: defaultObjectSizing.worldWidth,
-                }, undefined, WATER_SPEED, WATER_FRAME, WATER_MIN_PIXEL_RATIO, WATER_MAX_PIXEL_COUNT, ["u_image"]);
-                canvas = mountRef.current.canvasElement;
-                canvas.addEventListener("webglcontextlost", handleContextLost);
-                setSurface("water");
-            }
-            catch {
-                // No WebGL, no palette, or an image that will not decode: she arrives
-                // as the plain portrait, which is the whole design at reveal 1 anyway.
-                teardown();
-                setSurface("portrait");
-            }
-        };
-        void mount();
-        return () => {
-            cancelled = true;
-            teardown();
-            setSurface("portrait");
-        };
-    }, [src, wet]);
-    useEffect(() => {
-        const host = hostRef.current;
-        const mount = mountRef.current;
-        if (!host || !mount)
-            return;
-        const field = resolveIdentityColor(host, PRESENCE_FIELD_TOKEN);
-        if (!field)
-            return;
-        mount.setUniforms(waterUniforms(value, field));
-    }, [value]);
-    return (_jsxs("div", { className: cn("nc-threshold-presence", className), "data-state": state, "data-still": still || undefined, style: { "--threshold-portrait": `url("${src}")` }, children: [_jsx("div", { "aria-hidden": "true", className: "nc-threshold-presence-figure", "data-surface": surface, ref: hostRef, style: { opacity: arriving ? arrivalOpacity(value) : 1 }, children: _jsx("img", { alt: "", className: "nc-threshold-presence-portrait", draggable: false, src: src }) }), _jsx("div", { "aria-label": label, "aria-valuemax": 100, "aria-valuemin": 0, "aria-valuenow": Math.floor(value * 100), className: "nc-threshold-sr", role: "progressbar" })] }));
-}

package/dist/components/threshold/room.d.ts

@@ -1,33 +0,0 @@
-export type ThresholdRoomProps = {
-    className?: string;
-    /** Repair and error states quiet the room instead of hiding it. */
-    dimmed?: boolean;
-    /**
-     * How much of the room's pace is running, 0 to 1. The captured recipe is
-     * energy 1; the first-run screen holds it there while Nadia is still
-     * arriving and drops it to 0 when she has, which stills the field. Sign-in,
-     * success and every repair state pass 0.
-     */
-    energy?: number;
-    /** Success: the field's colour becomes verde vivo, Nadia's presence accent. */
-    ready?: boolean;
-};
-/**
- * The threshold's background field.
- *
- * It paints absolutely inside its own relative, isolated parent and never
- * against the viewport, so a Portal panel can hold one without covering the
- * page. It takes no pointer events and carries no words.
- *
- * When WebGL is unavailable, when the design-system tokens are not in the
- * cascade above it, or when the context is lost after mounting, the element
- * keeps its still field: a token-built radial gradient that needs no GPU. The
- * room is never blank.
- *
- * The window carries one shader canvas. While Nadia's water is painting her
- * arrival, the room holds this same still field and mounts nothing; the
- * moment she stands clear the water leaves and the room's canvas is the one
- * that paints (`canvas-budget.ts`).
- */
-export declare function ThresholdRoom({ className, dimmed, energy, ready, }: ThresholdRoomProps): import("react").JSX.Element;
-//# sourceMappingURL=room.d.ts.map

package/dist/components/threshold/room.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../../../src/components/threshold/room.tsx"],"names":[],"mappings":"AAwCA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAIF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,MAAc,EACd,MAAU,EACV,KAAa,GACd,EAAE,kBAAkB,+BA+IpB"}

package/dist/components/threshold/room.js

@@ -1,168 +0,0 @@
-"use client";
-import { jsx as _jsx } from "react/jsx-runtime";
-import { defaultObjectSizing, meshGradientFragmentShader, ShaderFitOptions, ShaderMount, } from "@paper-design/shaders";
-import { useEffect, useRef, useState } from "react";
-import { resolveIdentityColor } from "../../internal/agent-visual/color.js";
-import { cn } from "../../lib/utils.js";
-import { useCanvasHeld } from "./canvas-budget.js";
-import { useReducedMotion } from "./use-reduced-motion.js";
-/*
- * The room is the place a threshold happens in: one field of verde ink on true
- * black, behind Nadia and behind the words. It is Paper Shaders' published
- * Mesh Gradient "Ink" preset, adapted to two colours and slowed, mounted
- * through the core `ShaderMount` the package already depends on. There is no
- * React wrapper and no second shader engine.
- *
- * Every number below was selected from rendered captures (the study is
- * `apps/nadia/build/design/threshold/`), so this module is the one place they
- * are written.
- */
-const ROOM_SPEED = 0.22;
-const ROOM_FRAME = 12_000;
-const ROOM_MIN_PIXEL_RATIO = 1;
-const ROOM_MAX_PIXEL_COUNT = 1_024_000;
-const ROOM_DISTORTION = 1;
-const ROOM_SWIRL = 0.2;
-const ROOM_ROTATION = 90;
-/** The field's ink, and the two colours it carries. Uniforms, never CSS. */
-const ROOM_INK_TOKEN = "--nc-identity-ink";
-const ROOM_FIELD_TOKEN = "--nc-identity-verde";
-const ROOM_READY_TOKEN = "--nc-dark-verde-vivo";
-const clampUnit = (value) => Math.min(Math.max(value, 0), 1);
-/**
- * The threshold's background field.
- *
- * It paints absolutely inside its own relative, isolated parent and never
- * against the viewport, so a Portal panel can hold one without covering the
- * page. It takes no pointer events and carries no words.
- *
- * When WebGL is unavailable, when the design-system tokens are not in the
- * cascade above it, or when the context is lost after mounting, the element
- * keeps its still field: a token-built radial gradient that needs no GPU. The
- * room is never blank.
- *
- * The window carries one shader canvas. While Nadia's water is painting her
- * arrival, the room holds this same still field and mounts nothing; the
- * moment she stands clear the water leaves and the room's canvas is the one
- * that paints (`canvas-budget.ts`).
- */
-export function ThresholdRoom({ className, dimmed = false, energy = 0, ready = false, }) {
-    const still = useReducedMotion();
-    const hostRef = useRef(null);
-    const mountRef = useRef(null);
-    const [surface, setSurface] = useState("still");
-    const held = useCanvasHeld();
-    const speed = still ? 0 : ROOM_SPEED * clampUnit(energy);
-    // The deferred mount reads the values current when it runs, not the ones of
-    // the render that scheduled it.
-    const speedRef = useRef(speed);
-    const readyRef = useRef(ready);
-    useEffect(() => {
-        speedRef.current = speed;
-        readyRef.current = ready;
-    });
-    // The window's one canvas. While Nadia's water holds it the room keeps its
-    // still field; when the hold is released the room mounts. Every other prop
-    // change is carried into the live mount by the two effects below, so a prop
-    // change never rebuilds a WebGL context.
-    //
-    // The mount is deferred by one microtask. Effects run in tree order, so a
-    // presence mounted after the room takes its hold after this effect has run;
-    // deferring lets that hold cancel a mount that has not happened yet, and
-    // the window never carries two live contexts, not even for one tick.
-    useEffect(() => {
-        const host = hostRef.current;
-        if (!host || held)
-            return;
-        let cancelled = false;
-        let canvas = null;
-        const clearCanvases = () => {
-            for (const element of host.querySelectorAll("canvas"))
-                element.remove();
-            host.removeAttribute("data-paper-shader");
-        };
-        const handleContextLost = (event) => {
-            event.preventDefault();
-            canvas?.removeEventListener("webglcontextlost", handleContextLost);
-            canvas = null;
-            try {
-                mountRef.current?.dispose();
-            }
-            catch {
-                // The still field is already behind the canvas; vendor cleanup failing
-                // must not take the room down with it.
-            }
-            mountRef.current = null;
-            clearCanvases();
-            setSurface("still");
-        };
-        const mount = () => {
-            if (cancelled)
-                return;
-            const ink = resolveIdentityColor(host, ROOM_INK_TOKEN);
-            const field = resolveIdentityColor(host, readyRef.current ? ROOM_READY_TOKEN : ROOM_FIELD_TOKEN);
-            // Without the design-system cascade there is no palette to paint with, and
-            // a guessed colour would be a second source for a token value.
-            if (!ink || !field)
-                return;
-            try {
-                mountRef.current = new ShaderMount(host, meshGradientFragmentShader, {
-                    u_colors: [field, ink],
-                    u_colorsCount: 2,
-                    u_distortion: ROOM_DISTORTION,
-                    u_fit: ShaderFitOptions.contain,
-                    u_grainMixer: 0,
-                    u_grainOverlay: 0,
-                    u_offsetX: defaultObjectSizing.offsetX,
-                    u_offsetY: defaultObjectSizing.offsetY,
-                    u_originX: defaultObjectSizing.originX,
-                    u_originY: defaultObjectSizing.originY,
-                    u_rotation: ROOM_ROTATION,
-                    u_scale: defaultObjectSizing.scale,
-                    u_swirl: ROOM_SWIRL,
-                    u_worldHeight: defaultObjectSizing.worldHeight,
-                    u_worldWidth: defaultObjectSizing.worldWidth,
-                }, undefined, speedRef.current, ROOM_FRAME, ROOM_MIN_PIXEL_RATIO, ROOM_MAX_PIXEL_COUNT);
-                canvas = mountRef.current.canvasElement;
-                canvas.addEventListener("webglcontextlost", handleContextLost);
-                setSurface("shader");
-            }
-            catch {
-                // The constructor prepends its canvas before it reaches the context, so
-                // a failed mount leaves one behind that would cover the still field.
-                mountRef.current = null;
-                clearCanvases();
-                setSurface("still");
-            }
-        };
-        queueMicrotask(mount);
-        return () => {
-            cancelled = true;
-            canvas?.removeEventListener("webglcontextlost", handleContextLost);
-            try {
-                mountRef.current?.dispose();
-            }
-            catch {
-                // Same reason as above: disposal is best effort.
-            }
-            mountRef.current = null;
-            clearCanvases();
-            setSurface("still");
-        };
-    }, [held]);
-    useEffect(() => {
-        mountRef.current?.setSpeed(speed);
-    }, [speed]);
-    useEffect(() => {
-        const host = hostRef.current;
-        const mount = mountRef.current;
-        if (!host || !mount)
-            return;
-        const ink = resolveIdentityColor(host, ROOM_INK_TOKEN);
-        const field = resolveIdentityColor(host, ready ? ROOM_READY_TOKEN : ROOM_FIELD_TOKEN);
-        if (!ink || !field)
-            return;
-        mount.setUniforms({ u_colors: [field, ink] });
-    }, [ready]);
-    return (_jsx("div", { "aria-hidden": "true", className: cn("nc-threshold-room", className), "data-dimmed": dimmed || undefined, "data-ready": ready || undefined, "data-surface": surface, ref: hostRef }));
-}

package/dist/components/threshold/threshold.css

@@ -1,228 +0,0 @@
-/*
- * @nadicodeai/ui/threshold.css
- *
- * The threshold primitives' stylesheet. It is a separate import rather than a
- * part of globals.css because the surface that needs it most, the Nadia
- * desktop app, runs inside a shell that does not load Tailwind: it takes this
- * file and the design-system token layer, and nothing else from this package.
- *
- * A threshold is a fixed dark surface. It is true black in every theme, so the
- * ladders below read the dark-mode tokens directly instead of branching on the
- * app's mode; that is the fixed-presentation escape the package contract
- * names, taken once, coherently, for the whole surface.
- *
- * The room's two colours are shader uniforms, not CSS, and live in room.tsx.
- * The only colour written here is the still field the room falls back to.
- */
-
-/* The room ---------------------------------------------------------------- */
-
-/*
- * Absolute inside its own relative, isolated parent, never fixed against the
- * viewport: a Portal panel holds a room without covering the page. Its still
- * field is a token-built radial that needs no GPU, and the canvas covers it
- * once the shader is painting.
- */
-.nc-threshold-room {
-  position: absolute;
-  inset: 0;
-  z-index: 0;
-  overflow: hidden;
-  pointer-events: none;
-  background: radial-gradient(
-    ellipse 55% 46% at 50% 36%,
-    color-mix(in oklab, var(--nc-identity-verde) 30%, var(--nc-identity-ink)),
-    transparent 90%
-  );
-  mask-image: radial-gradient(ellipse 65% 58% at 50% 35%, black 10%, transparent 95%);
-  transition: opacity var(--nc-duration-open) var(--nc-ease-emphasized);
-}
-
-.nc-threshold-room canvas {
-  opacity: 0.65;
-}
-
-/* Repair and error states quiet the room; they never remove it. */
-.nc-threshold-room[data-dimmed] {
-  opacity: 0.22;
-}
-
-/* The presence ------------------------------------------------------------ */
-
-.nc-threshold-presence {
-  position: relative;
-  flex: none;
-  width: clamp(180px, 38vh, 320px);
-  aspect-ratio: 462 / 520;
-  transition: opacity var(--nc-duration-confirm) var(--nc-ease-emphasized);
-}
-
-/* Her lower edge dissolves into the room rather than ending on a rectangle. */
-.nc-threshold-presence-figure {
-  position: relative;
-  width: 100%;
-  height: 100%;
-  mask-image: linear-gradient(black 55%, transparent 98%);
-  transition: opacity var(--nc-duration-confirm) var(--nc-ease-emphasized);
-}
-
-.nc-threshold-presence-portrait {
-  display: block;
-  width: 100%;
-  height: 100%;
-  object-fit: contain;
-}
-
-/* While the water is painting her, the plain portrait beneath it is redundant. */
-.nc-threshold-presence-figure[data-surface="water"] .nc-threshold-presence-portrait {
-  visibility: hidden;
-}
-
-/*
- * The water canvas is cut to her own silhouette. Water's highlight term is
- * added to the whole frame, not only to the sampled image, so an unmasked
- * canvas paints a faintly lit rectangle over the room: the visible tile the
- * rendered comparisons rejected. The mask matches the shader's own `contain`
- * fit and centred origin, so the two agree pixel for pixel.
- */
-.nc-threshold-presence-figure canvas {
-  position: absolute;
-  inset: 0;
-  mask-image: var(--threshold-portrait);
-  mask-position: center;
-  mask-repeat: no-repeat;
-  mask-size: contain;
-}
-
-.nc-threshold-presence[data-state="error"] {
-  opacity: 0.62;
-}
-
-/*
- * Success: one short verde vivo beat over her own silhouette, then nothing.
- * Verde vivo is Nadia's presence accent and this is the only place a threshold
- * spends it, which is why the buttons beside it stay neutral.
- */
-.nc-threshold-presence::after {
-  content: "";
-  position: absolute;
-  inset: 0;
-  background: var(--nc-dark-verde-vivo);
-  mask-image: var(--threshold-portrait);
-  mask-position: center;
-  mask-repeat: no-repeat;
-  mask-size: contain;
-  opacity: 0;
-  pointer-events: none;
-}
-
-.nc-threshold-presence[data-state="ready"]::after {
-  animation: nc-threshold-arrival 360ms var(--nc-ease-out-strong) 1;
-}
-
-@keyframes nc-threshold-arrival {
-  0% {
-    opacity: 0;
-  }
-  35% {
-    opacity: 0.22;
-  }
-  100% {
-    opacity: 0;
-  }
-}
-
-/* The orb ----------------------------------------------------------------- */
-
-.nc-threshold-orb {
-  display: block;
-  flex: none;
-}
-
-/* The line ---------------------------------------------------------------- */
-
-/*
- * A hidden copy of the whole sentence holds the width while the visible one
- * fills in, so the orb beside it does not travel with each character.
- */
-.nc-threshold-line {
-  display: grid;
-  position: relative;
-  margin: 0;
-  font-family: var(--nc-type-display-md-font-family);
-  font-size: var(--nc-type-display-md-font-size);
-  font-weight: var(--nc-type-display-md-font-weight);
-  line-height: var(--nc-type-display-md-line-height);
-  letter-spacing: -0.01em;
-  text-align: center;
-  text-wrap: balance;
-  color: var(--nc-dark-ink);
-}
-
-.nc-threshold-line-measure {
-  grid-area: 1 / 1;
-  visibility: hidden;
-}
-
-.nc-threshold-line-spoken {
-  grid-area: 1 / 1;
-}
-
-.nc-threshold-caret {
-  display: inline-block;
-  width: 2px;
-  height: 1em;
-  margin-left: 2px;
-  vertical-align: -0.15em;
-  background: currentcolor;
-  visibility: hidden;
-}
-
-.nc-threshold-line[data-typing] .nc-threshold-caret {
-  visibility: visible;
-}
-
-/* Shared ------------------------------------------------------------------ */
-
-/*
- * The threshold ships its own visually-hidden helper: the desktop shell does
- * not load this package's Tailwind layer, and a progress value nobody can read
- * is not an accessible progress value.
- */
-.nc-threshold-sr {
-  position: absolute;
-  width: 1px;
-  height: 1px;
-  overflow: hidden;
-  clip-path: inset(50%);
-  white-space: nowrap;
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .nc-threshold-room,
-  .nc-threshold-presence,
-  .nc-threshold-presence-figure {
-    transition: none;
-  }
-
-  .nc-threshold-presence[data-state="ready"]::after {
-    animation: none;
-  }
-
-  .nc-threshold-caret {
-    visibility: hidden;
-  }
-}
-
-/*
- * The components also carry the preference as `data-still`, which is what a
- * shell that toggles reduced motion without the media query (an in-app
- * setting) sets. Same result, one rule.
- */
-.nc-threshold-presence[data-still] {
-  transition: none;
-}
-
-.nc-threshold-presence[data-still][data-state="ready"]::after {
-  animation: none;
-}

package/dist/components/threshold/typed-line.d.ts

@@ -1,8 +0,0 @@
-export type TypedLineProps = {
-    /** Milliseconds per character. The threshold's cadence is 44. */
-    cadenceMs?: number;
-    className?: string;
-    text: string;
-};
-export declare function TypedLine({ cadenceMs, className, text }: TypedLineProps): import("react").JSX.Element;
-//# sourceMappingURL=typed-line.d.ts.map

package/dist/components/threshold/typed-line.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"typed-line.d.ts","sourceRoot":"","sources":["../../../src/components/threshold/typed-line.tsx"],"names":[],"mappings":"AAwBA,MAAM,MAAM,cAAc,GAAG;IAC3B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,SAAS,CAAC,EAAE,SAAsB,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,cAAc,+BAwCpF"}

package/dist/components/threshold/typed-line.js

@@ -1,43 +0,0 @@
-"use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
-import { cn } from "../../lib/utils.js";
-import { useReducedMotion } from "./use-reduced-motion.js";
-/*
- * The line Nadia says while a threshold is open. It types itself, because a
- * first run is the one moment in the product where waiting is the content.
- *
- * Three decisions the captures settled:
- *
- * - the count comes from elapsed time, not from how many callbacks arrived, so
- *   a software renderer or a busy main thread cannot stretch a one second
- *   sentence into five;
- * - a hidden copy of the whole sentence reserves its width, so nothing beside
- *   the line travels sideways with each character;
- * - the live region receives the complete sentence at once, so a screen reader
- *   is never read one letter at a time.
- */
-const CADENCE_MS = 44;
-export function TypedLine({ cadenceMs = CADENCE_MS, className, text }) {
-    const still = useReducedMotion();
-    const [shown, setShown] = useState("");
-    useEffect(() => {
-        if (still) {
-            setShown(text);
-            return;
-        }
-        setShown("");
-        const startedAt = performance.now();
-        let timer = 0;
-        const tick = () => {
-            const count = Math.min(text.length, Math.floor((performance.now() - startedAt) / cadenceMs));
-            setShown(text.slice(0, count));
-            if (count < text.length)
-                timer = window.setTimeout(tick, cadenceMs);
-        };
-        timer = window.setTimeout(tick, cadenceMs);
-        return () => window.clearTimeout(timer);
-    }, [cadenceMs, still, text]);
-    const typing = shown.length < text.length;
-    return (_jsxs("p", { className: cn("nc-threshold-line", className), "data-typing": typing || undefined, children: [_jsx("span", { "aria-hidden": "true", className: "nc-threshold-line-measure", children: text }), _jsxs("span", { "aria-hidden": "true", className: "nc-threshold-line-spoken", children: [_jsx("span", { children: shown }), _jsx("span", { className: "nc-threshold-caret" })] }), _jsx("span", { "aria-live": "polite", className: "nc-threshold-sr", children: text })] }));
-}

package/dist/components/threshold/use-reduced-motion.d.ts

@@ -1,10 +0,0 @@
-/**
- * Live `prefers-reduced-motion`, the one reader the threshold primitives share.
- *
- * The value is read from the media query on every render rather than cached in
- * state, so a preference changed while a threshold is open reaches the room,
- * the presence, the orb and the typed line in the same commit. Server renders
- * report false and the first client render corrects it.
- */
-export declare function useReducedMotion(): boolean;
-//# sourceMappingURL=use-reduced-motion.d.ts.map

package/dist/components/threshold/use-reduced-motion.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-reduced-motion.d.ts","sourceRoot":"","sources":["../../../src/components/threshold/use-reduced-motion.ts"],"names":[],"mappings":"AA2BA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}

package/dist/components/threshold/use-reduced-motion.js

@@ -1,32 +0,0 @@
-"use client";
-import { useSyncExternalStore } from "react";
-const REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
-function query() {
-    return typeof window === "undefined" || typeof window.matchMedia !== "function"
-        ? undefined
-        : window.matchMedia(REDUCED_MOTION_QUERY);
-}
-function subscribe(onChange) {
-    const list = query();
-    if (!list)
-        return () => { };
-    list.addEventListener("change", onChange);
-    return () => list.removeEventListener("change", onChange);
-}
-function getSnapshot() {
-    return query()?.matches ?? false;
-}
-function getServerSnapshot() {
-    return false;
-}
-/**
- * Live `prefers-reduced-motion`, the one reader the threshold primitives share.
- *
- * The value is read from the media query on every render rather than cached in
- * state, so a preference changed while a threshold is open reaches the room,
- * the presence, the orb and the typed line in the same commit. Server renders
- * report false and the first client render corrects it.
- */
-export function useReducedMotion() {
-    return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
-}

package/dist/threshold.d.ts

@@ -1,2 +0,0 @@
-export * from "./components/threshold/index.js";
-//# sourceMappingURL=threshold.d.ts.map

package/dist/threshold.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"threshold.d.ts","sourceRoot":"","sources":["../src/threshold.ts"],"names":[],"mappings":"AAYA,cAAc,8BAA8B,CAAC"}

package/dist/threshold.js

@@ -1,13 +0,0 @@
-/*
- * `@nadicodeai/ui/threshold`: the primitives every threshold is drawn from.
- *
- * A threshold is the moment before the product is usable: a first run, a
- * sign-in, a repair. The Nadia desktop app draws its room, presence, status
- * orb and typed line from here, so the brand logic lives in one place.
- *
- * The screens themselves, and the state machines behind them, stay in the
- * consuming app. This entry ships no screen.
- *
- * The stylesheet is a separate import: `@nadicodeai/ui/threshold.css`.
- */
-export * from "./components/threshold/index.js";

package/docs/threshold.md

@@ -1,221 +0,0 @@
-# The threshold primitives
-
-`@nadicodeai/ui/threshold` holds the four primitives a threshold is drawn from. A
-threshold is the moment before the product is usable: a first run, a sign-in, a
-repair. The Nadia desktop app draws its room, presence, status orb and typed line
-from here, so the brand logic has one home.
-
-The entry ships no screen and no state machine. Which view is on, what the
-words are, and when a threshold ends belong to the consuming app.
-
-```tsx
-import { NadiaPresence, Orb, ThresholdRoom, TypedLine } from "@nadicodeai/ui/threshold";
-import "@nadicodeai/ui/threshold.css";
-```
-
-## What each part is for
-
-| Part | Its one job | Never |
-| --- | --- | --- |
-| `ThresholdRoom` | the place: a verde field on true black | inside the working app |
-| `NadiaPresence` | the host: her arrival is the progress | a loader, a ring, a bar |
-| `Orb` | system work underway, through the shared activity renderer | reporting a failed operation or waiting on a person as ongoing work |
-| `TypedLine` | what Nadia is saying while you wait | a control or state machine |
-
-The logo is not on this list. It belongs to window chrome, the tray and the
-About row, never to a threshold.
-
-## The stylesheet
-
-`@nadicodeai/ui/threshold.css` is a separate import rather than a part of
-`globals.css`, because the surface that needs it most does not load Tailwind:
-the Nadia desktop shell takes this file and the design-system token layer and
-nothing else from this package. A Tailwind consumer imports it beside
-`@nadicodeai/ui/globals.css`.
-
-Both the stylesheet and the room need the design-system tokens above them, from
-`@nadicodeai/ui/globals.css` or `@nadicodeai/design-system/css`. Without that
-cascade there is no palette, and the room paints its still field rather than
-guessing a colour.
-
-## `ThresholdRoom`
-
-```tsx
-<div className="relative isolate overflow-hidden">
-  <ThresholdRoom energy={arriving ? 1 : 0} dimmed={repairing} ready={connected} />
-  {/* the presence and the words, above it */}
-</div>
-```
-
-| Prop | Type | Default | Meaning |
-| --- | --- | --- | --- |
-| `dimmed` | `boolean` | `false` | a repair or an error quiets the room to 22 percent |
-| `energy` | `number` | `0` | how much of the room's pace runs, 0 to 1 |
-| `ready` | `boolean` | `false` | success: the field takes verde vivo |
-| `className` | `string` | — | added to the root |
-
-The room paints absolutely inside its own relative, isolated parent and never
-against the viewport, so a bounded surface can hold one without covering the
-page. It is `aria-hidden`, takes no pointer events, and carries no words.
-
-**The recipe.** Paper Shaders 0.0.78 `meshGradientFragmentShader`, its published
-Ink preset adapted to two colours and slowed: `u_colors` are
-`--nc-identity-verde` and `--nc-identity-ink`, `u_colorsCount` 2, `u_distortion`
-1, `u_swirl` 0.2, `u_rotation` 90, `u_grainMixer` and `u_grainOverlay` 0, fit
-contain, scale 1. Mount speed is 0.22 at energy 1, starting frame 12000, minimum
-pixel ratio 1, maximum pixel count 1,024,000, canvas opacity 0.65. The room is
-masked with `radial-gradient(ellipse 65% 58% at 50% 35%, black 10%, transparent
-95%)`. The two colours are shader uniforms, never CSS.
-
-`energy` is a scalar so a screen can decide. The captured recipe is energy 1;
-Nadia's first run holds it there while she is still arriving and drops it to 0
-when she has, which stills the field. Sign-in, success and every repair state
-pass 0.
-
-**One canvas per window.** While `NadiaPresence` is painting her arrival with
-water, the room mounts nothing and shows this same still field; the moment the
-water leaves, at reveal 1 or when it cannot paint, the room's canvas mounts.
-The budget lives in the package, so a surface that composes both, as first run
-does, keeps the register's one shader canvas without doing anything.
-
-**No GPU, no tokens, or a lost context.** The room keeps its still field: a
-token-built radial gradient that needs no WebGL. It carries `data-surface`,
-`"shader"` while the canvas paints and `"still"` otherwise, and a mount that
-fails leaves no dead canvas covering the fallback. A `webglcontextlost` event
-returns it to the still field rather than to a black rectangle.
-
-**Reduced motion.** Speed 0: the shader paints frame 12000 once and stops. The
-room still has its colour and its shape; it just holds one frame.
-
-## `NadiaPresence`
-
-```tsx
-<NadiaPresence label={t("install.progress")} reveal={fraction} src={portrait} state="arriving" />
-```
-
-| Prop | Type | Meaning |
-| --- | --- | --- |
-| `label` | `string` | the accessible name of the arrival |
-| `reveal` | `number` | 0 behind the field, 1 standing clear |
-| `src` | `string` | the portrait master's URL |
-| `state` | `"arriving" \| "present" \| "ready" \| "error"` | which threshold she is in |
-
-`src` is a prop rather than an import because this package imports no binary
-asset of its own; the consuming surface resolves
-`@nadicodeai/design-system/assets/nadia-solid-surface` with its own bundler and
-passes the URL. Keeping it out of the library is what lets a Node or a
-bundler-free consumer load the module at all.
-
-**The arrival.** Opacity is `0.025 + 0.975 × reveal^1.25`, exported as
-`arrivalOpacity` so a screen can read the same curve. At the start she is a
-trace, which gives the arrival somewhere to go. Her lower edge dissolves into
-the room with `linear-gradient(black 55%, transparent 98%)` instead of ending on
-a rectangle. The `error` state multiplies her by 0.62.
-
-**The water.** While `state` is `arriving`, `reveal` is below 1 and motion is
-allowed, the portrait is painted by Paper's `waterFragmentShader` at a
-restrained intensity: `caustic`, `edges` and `waves` are `0.35`, `0.4` and `0.3`
-scaled by how much of the arrival is left, with `layering` 0.4 and `highlights`
-0.12, `colorBack` fully transparent and `colorHighlight` on
-`--nc-identity-verde`. Every amplitude reaches zero as she arrives, so her
-geometry holds and the water is gone by the time she stands clear. At reveal 1,
-and in every other state, this is the plain portrait.
-
-While the water is wanted it is the window's one shader canvas: the presence
-holds the canvas budget from the moment it asks for the water until the water
-is torn down, and the room keeps its still field for exactly that long.
-
-The water canvas is masked to her own silhouette. Water adds its highlight term
-to the whole frame rather than only to the sampled image, so an unmasked canvas
-paints a faintly lit rectangle over the room; the mask matches the shader's own
-contain fit and centred origin.
-
-**Reduced motion, no GPU, or an image that will not decode.** The plain
-portrait, at the same reveal. The figure carries `data-surface`, `"water"` or
-`"portrait"`.
-
-**Success.** `state="ready"` runs one 360 ms verde vivo beat over her silhouette
-on `--nc-ease-out-strong`, opacity 0 to 0.22 at 35 percent and back to 0, once.
-Verde vivo is Nadia's presence accent and this is the only place a threshold
-spends it, which is why the buttons beside it stay neutral. Reduced motion
-suppresses the beat.
-
-**Assistive technology.** A hidden `progressbar` carries `label` and the floored
-percentage, so it reaches 100 only when the arrival is actually finished. The
-portrait itself is decorative; the words are the typed line's.
-
-## `Orb`
-
-```tsx
-<Orb label={t("install.working")} state="working" />
-```
-
-| Prop | Type | Default | Meaning |
-| --- | --- | --- | --- |
-| `label` | `string` | — | what the orb means, in the Customer's language |
-| `size` | `88 \| 64 \| 20` | `88` | CSS pixels: threshold, region, or inline operation; see `activity.md` |
-| `state` | `"working" \| "connecting" \| "absent"` | — | see below |
-
-The threshold adapter preserves its public states: `working` selects the
-shared `processing` activity, `connecting` selects `connecting`, and `absent`
-renders nothing. The threshold defaults to fixed dark ink; `theme="auto"`
-inherits the surrounding product's ink and `theme="light"` fixes light-surface
-ink. There is one renderer, `ActivityOrb`, rather than a second threshold orb.
-
-[System activity](activity.md) owns the motion recipes, colour treatment,
-optical sizes, reduced-motion behaviour and connection-versus-person-waiting
-rule. Applications retain their operation state machines and copy.
-
-## `TypedLine`
-
-```tsx
-<TypedLine text={t("install.step.1")} />
-```
-
-| Prop | Type | Default |
-| --- | --- | --- |
-| `cadenceMs` | `number` | `44` |
-| `text` | `string` | — |
-| `className` | `string` | — |
-
-The line types itself at 44 ms per character, the cadence the rendered
-comparisons selected for a first-run pause. Three things it does that a naive
-typewriter does not:
-
-- the count comes from elapsed time, not from how many callbacks arrived, so a
-  software renderer or a busy main thread cannot stretch a one second sentence
-  into five;
-- a hidden copy of the whole sentence reserves its width, so the orb beside it
-  does not travel sideways with each character;
-- the live region receives the complete sentence at once, so a screen reader is
-  never read one letter at a time.
-
-A new `text` retypes from a cleared line. The caret is steady while typing and
-hidden afterwards.
-
-**Reduced motion.** The whole line at once, and no caret.
-
-## Tokens, and the one fixed presentation
-
-Everything visual comes from design-system tokens. A threshold is a fixed dark
-surface: it is true black in every theme, so the text ladder reads
-`--nc-dark-ink`, `--nc-dark-body` and `--nc-dark-muted` directly instead of
-branching on the app's mode. That is the fixed-presentation escape
-[`contract.md`](contract.md) names, taken once and coherently for the whole
-surface.
-
-The room's two colours are the exception that proves it: they are shader
-uniforms read off `--nc-identity-verde` and `--nc-identity-ink` at mount, not
-CSS values.
-
-## Motion budget
-
-The foundation's: `--nc-duration-open` for a room fading in or out,
-`--nc-duration-confirm` for the presence, `--nc-ease-emphasized` and
-`--nc-ease-out-strong`. The success beat is the one
-duration written here rather than taken from a token, 360 ms, because it is an
-envelope rather than a state change.
-
-Under `prefers-reduced-motion: reduce` the room holds one frame, the water is
-not mounted, the presence jumps to its value, the beat does not run, the orb
-draws once and the line appears whole.