@nadicodeai/ui 6.6.2 → 7.1.0

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
@@ -102,6 +102,8 @@ page, not in repeated panels surrounding identical child tables.
 `BreakdownTable` owns its responsive comparison layout: identity and value stay
 in the main row; share moves into a labeled detail row when space is tight.
 Its caption names the table. Callers supply data and labels, not column-hiding CSS.
+An entity's optional `mark` prints between its color dot and its label, so a
+ranked model row shows the maker's mark beside the name.
 
 ### Record action menus
 
@@ -139,20 +141,31 @@ 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.
 - **Agents is the client-only conversation interface.** `@nadicodeai/ui/agents` re-exports the complete `@assistant-ui/react` runtime and primitive API plus the reviewed, branded registry composition held under `src/internal/assistant-ui/`. Its built entry retains `"use client"`. Consumers receive Thread, attachments, Markdown, reasoning, tools, suggestions, providers, runtimes, hooks, and types from that one domain namespace. Agent identity components use their direct component subpaths so server compositions do not import the conversation runtime. The vendor name is not a public NadicodeAI subpath, and the package does not rename, wrap, or rebuild assistant-ui behavior.
 - **Base UI is the active primitive base.** `components.json` must resolve through a Base style, currently `base-nova`, and `npx shadcn@latest info --json` must report `base: "base"`. Do not reintroduce `radix-ui`, `@radix-ui/*`, or `vaul` to package source, dependencies, or app optimizer configuration. Registry-owned shadcn primitives stay aligned with current `shadcn@latest` Base UI output; use Base UI `render` composition instead of Radix `asChild`. `cmdk` is allowed only for the stock shadcn Command component while the current `base-nova` registry declares that dependency; do not use it elsewhere or replace it without a shadcn/compatibility decision and tests.
-- **Charts are shadcn charts.** `chart.tsx` is shadcn's `chart` component over Recharts (`ChartContainer`, `ChartTooltip`, `ChartLegend`, theme-keyed `ChartConfig`), and the chart kit (`chart-time-series`, `chart-breakdown-table`, `chart-sparkline`, `chart-bullet-bar`, `chart-kpi-stat`, `chart-delta`, `chart-date-range-control`, `chart-entity-colors`) is built on it. An app composes these and never imports `recharts` or draws SVG charts of its own; `recharts` is declared by this package alone. A chart the kit lacks is first looked up in the shadcn registry through the CLI or MCP, then added to the kit with NadicodeAI tokens and the chart accessibility contract. What a chart shows is decided by the product; how it is drawn comes from here.
+- **Charts are shadcn charts.** `chart.tsx` is shadcn's `chart` component over Recharts (`ChartContainer`, `ChartTooltip`, `ChartLegend`, theme-keyed `ChartConfig`), and the chart kit (`chart-time-series`, `chart-breakdown-table`, `chart-sparkline`, `chart-bullet-bar`, `chart-kpi-stat`, `chart-delta`, `chart-date-range-control`, `chart-entity-colors`) is built on it. An app composes these and never imports `recharts` or draws SVG charts of its own; `recharts` is declared by this package alone. A chart the kit lacks is first looked up in the shadcn registry through the CLI or MCP, then added to the kit with NadicodeAI tokens and the chart accessibility contract. What a chart shows is decided by the product; how it is drawn comes from here. `TimeSeriesComposed` is that lookup performed: the registry holds no composed item, so the bars-plus-line composition for a rate over its measures is Recharts' `ComposedChart` through this same foundation, with the second axis existing only for a series that names it.
 - **Named shadcn blocks stay named.** When a user, plan, or issue selects a shadcn block/example such as `login-02`, `signup-02`, `dashboard-01`, or `sidebar-*`, use that registry item as the source of truth through shadcn CLI/MCP. Do not replace it with a package-authored abstraction unless the plan explicitly records the substitution, the reason, and the true consumer route that proves it.
 - **A change to what the package ships bumps the version.** Any change to exported components, `src/index.ts`, package `exports`, `globals.css`, theme behavior, package docs, or design-system token, CSS, or theme output this package consumes bumps both package versions in lockstep before handoff, and `npm pack --dry-run -w @nadicodeai/ui` shows exactly what consumers receive (procedure: `../../../docs/agents/publish.md`).
 
 ## 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
 
@@ -179,8 +192,38 @@ package.
 - **Reusable sections and compositions live here after proof.** Bento grids, media mounts, demo surfaces, page frames, section intros, CTA bands, proof slots, benefits grids, generic shells, and homepage/use-case sections belong in `@nadicodeai/ui` when a second concrete consumer, a plan-approved shared component, or a named validation slice proves the package boundary. Website, portal, and sibling Nadia routes pass data and media children into existing compositions instead of rebuilding layout locally.
 - **Brand renderers live here for React consumers.** Logo geometry, asset generation, and usage semantics are owned by [`packages/design-system/DESIGN.md`, "Brand media authority"](../../design-system/DESIGN.md#brand-media-authority). `BrandLockup` supplies the approved horizontal lockup. `BrandMark` serves tight spaces and `BrandWordmark` serves placements where the name must read by itself. All three render the package's public neutral geometry seam with React-scoped SVG ids, dynamic theme paint, and accessible names. Consuming routes use these adapters; they never import raw logo assets, draw brand SVG inline, mask or recolor assets, or create another lockup rule.
 - **Third-party brand marks are generated, never hand-drawn and never hand-edited.** Other companies' marks live in `packages/ui/src/components/brand-icons/`, emitted from an explicit allow-list by `packages/ui/scripts/build-brand-icons.mjs` and exported through the `@nadicodeai/ui/components/brand-icons` subpath. They are identity images, not UI icons: a brand mark is exempt from the currentColor stroke system and from the raw-literal rule, it never stands in for a UI icon, and a UI icon never stands in for a brand. Marks drawn as one silhouette are stripped to `currentColor` by the generator; every other mark keeps its official colors verbatim. To add a brand, edit the generator's allow-list and run `npm run generate:brand-icons -w @nadicodeai/ui`; hand edits to the generated directory are lost and `packages/ui/tests/guards/brand-icons-codegen.test.ts` fails on them. Use is nominative only — naming a platform, an integration, or a provider — never adjacent to endorsement or partnership wording; that nominative posture is the licensing and trademark position, so a mark never appears where the copy implies endorsement.
+
+  The one script reads two explicit allow-lists: platform marks out of the Iconify `logos` set (CC0-1.0), and model makers' marks out of the LobeHub icon set (MIT, `@lobehub/icons-static-svg`), both as `devDependencies`. The emitted components are plain SVG, so neither icon data package belongs in the runtime dependency set or reaches a consumer bundle. The artwork itself does ship, so every upstream whose licence asks for one travels with a notice in `LICENSES/` and `NOTICE`, and `tests/guards/brand-icons-codegen.test.ts` holds the allow-list to that: a new source cannot ship unattributed.
 - **No fake proof APIs.** Components may support future testimonials, logos, stats, and proof slots, but they must render nothing public when the proof is absent. Do not ship placeholder customer names, metrics, or logos.
 
+### Model identity
+
+`ModelMark` is a model's identity: its maker's mark, plus the model's name and
+author when a caller supplies them. It takes `author` — the slug a usage read
+reports — and resolves it against the generated model-maker marks (rule
+`model-shown-with-logo`). An author off that allow-list gets the neutral tile,
+so a model never falls back to a bare colour swatch. The tile owns the box and
+scales the artwork inside it; `size` states that box, and the author slug prints
+as reported.
+
+One component has two readings: with `name`, the row a table cell or ranked
+list reads; without one, the bare mark that stands in a chart legend beside that
+legend's own text. `BreakdownTable` entities and the `chart-time-series` series
+(`TimeSeriesBars`, `TimeSeriesArea`, `TimeSeriesComposed`) take an optional
+`mark` for that second reading, placed beside the entity's or series' name. A
+chart places it on each surface itself: the legend through the explicit `marks`
+path on `ChartLegendContent`, and the tooltip row through the kit's own row
+renderer, because `rule/model-shown-with-logo` names tooltips among the places a
+model appears. A series' mark never travels through `ChartConfig`, whose label
+the legend and the default tooltip item both read, so an identity parked there
+would appear on a surface that never asked for it. No legend is forked. A mark is
+decoration beside the label that already names it; one standing alone takes
+`label` (`role="img"` with an accessible name) or stays hidden.
+
+What this package does not own: which authors exist, which mark a maker gets
+(the generator's allow-list), or what a surface shows a model for. The consuming
+app supplies the author slug, the name, and the colors it pairs with them.
+
 ## Accessibility Invariant
 
 **Tier-1 accessibility is tested, browser-free.** Rendering component tests use the package `expectAccessible` helper to check the rendered DOM. The jsdom tier is structural: rendered contrast, landmark context, focus, and keyboard behavior belong to real-browser Playwright coverage. The shared library ESLint configuration is the executable authority for static JSX accessibility rules, and the repository quality doctrine owns their policy; this contract does not copy the rule inventory.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/ui",
-  "version": "6.6.2",
+  "version": "7.1.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.1.0",
     "@paper-design/shaders": "0.0.80",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -101,6 +96,7 @@
   "devDependencies": {
     "@iconify-json/logos": "^1.2.14",
     "@iconify/utils": "^3.1.7",
+    "@lobehub/icons-static-svg": "^1.95.0",
     "@nadicodeai/eslint-plugin": "*",
     "@stryker-mutator/core": "10.0.0",
     "@stryker-mutator/vitest-runner": "10.0.0",

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"}