@nadicodeai/ui 0.10.2 → 0.12.0

package/AGENTS.md

@@ -1,143 +1,31 @@
 # @nadicodeai/ui - Agent Rules
 
-The `@nadicodeai/ui` npm workspace: the shared NadicodeAI React UI package on brand tokens (Tailwind v4, semantic light/dark roles), per ADR 0007. It ships shadcn primitives backed by Base UI, AI Elements, React adapters over the design-system grammar, reusable marketing/section compositions, and plan-approved product components once their source/export/tests/docs exist. It is source-authored in `src/` and published from built `dist` JavaScript, declarations, and CSS. Read this file before working in the component library. For website page assembly, also read **`../../website/AGENTS.md`**; for portal screens, read **`../../portal/AGENTS.md`**.
-
-When this file is read from an installed package, use it as the consumer agent
-contract: import `@nadicodeai/ui/globals.css` and
-`@nadicodeai/design-system/css` once at the app root, import components from
-`@nadicodeai/ui/components/*` or `@nadicodeai/ui/ai-elements`, and keep all
-new UI token-only. Dark mode is a `.dark` selector remap: the design-system
-theme owns standard shadcn roles, while `globals.css` owns UI-local product
-aliases. Components must not add `dark:` utilities, OS dark-mode branching, or
-raw palette values. The package also ships `llms.txt`,
-`docs/agents/nadicodeai-ui.md`, `docs/migration/`, and
-`skills/nadicodeai-ui/SKILL.md` for agents that index package documentation or
-skills.
-
-## Invariants
-
-- **Token-only, no raw literals.** Components style through brand tokens only — the `nadicode.theme.css` role vars bridged into Tailwind utilities (`bg-background`, `text-foreground`, `border-input`, …) plus UI-local product aliases defined in `globals.css` such as `--nc-app-surface`, `--nc-chat-tool-surface`, and `--nc-terminal-bg`. No raw `#hex` / `rgb()` / `hsl()` in any `.tsx`; a new source value goes to `design-system/DESIGN.md` first and flows through generated tokens. Enforced by `tests/guards/no-raw-literal.test.ts` and `tests/guards/token-reference-integrity.test.ts`.
-- **Dark-ready roles, no component `dark:` styling.** The generated design-system Tailwind theme owns the standard shadcn `:root` and `.dark` role maps; `globals.css` owns the Tailwind `@theme inline` bridge and UI-local product aliases. Components consume semantic utilities or product aliases such as `var(--nc-app-surface)`; they must not ship `dark:` Tailwind utilities, OS dark-mode branching, or raw dark palette utilities such as `dark:bg-slate-950` / `dark:text-white`. Enforced by `tests/guards/no-dark.test.ts`, `tests/guards/dark-semantic-roles.test.ts`, and `tests/guards/token-reference-integrity.test.ts`.
-- **Components inherit the brand theme.** Consumers import `@nadicodeai/ui/globals.css` (Tailwind + the generated brand `@theme` + semantic role/alias maps) and `@nadicodeai/design-system/css` (kept `nc-*` geometry, type scale, chat CSS components, motion, and display components). Components carry no theme of their own — they resolve every color/radius from bridged brand tokens, UI-local aliases, and design-system CSS.
-- **Source-authored, built package.** Components are authored as shadcn-style source in this workspace, then emitted to `dist/` for consumption by other apps. Package exports must point at built JS/declarations/CSS, not raw `src/*.tsx`, and `npm pack --dry-run` must include only intentional consumer artifacts.
-- **Public surface changes require a release decision.** Any change to exported components, `src/index.ts`, `src/ai-elements.ts`, package `exports`, `globals.css`, UI-local semantic aliases, theme behavior, package docs, package skills, or design-system token/CSS/theme output consumed by this package must end with an explicit npm release decision before handoff. If the change should reach external consumers, bump the relevant package version(s), run `npm pack --dry-run -w @nadicodeai/ui`, and follow `../../docs/agents/npm-publishing.md`. If it cannot affect npm consumers, include the literal `[no-publish]` marker in a commit message and explain why in that commit body; the pre-push gate requires one of these two decisions. When the UI change depends on modified `@nadicodeai/design-system` output, bump/publish `@nadicodeai/design-system` first, then update `@nadicodeai/ui`'s dependency and publish UI. Never claim a UI package change is shipped to npm until `npm view @nadicodeai/ui version` reports the intended published version.
-- **shadcn and AI Elements are package surface.** The installed shadcn source components under `src/components/` and all 48 Vercel AI Elements under `src/components/ai-elements/` are intentional ready-to-use exports. Keep `src/index.ts`, `src/ai-elements.ts`, package `exports`, README/agent docs, and `website/app/ui-check/elements` synchronized whenever this surface changes.
-- **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 should 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.
-- **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.
-- **Package surface is source-backed.** `src/components/` is intentionally flat shadcn-style source. Do not document folders or package namespaces that do not exist. Do not add top-level exports for recipes, blocks, agent, or terminal groupings unless a later package API decision adds concrete source, built files, docs, and tests in the same change.
-- **Auth routes are consumer-owned shadcn block work.** Login, signup, OTP, two-factor, magic-link, and provider-button flows start from the selected shadcn block/example in the consuming app, with app-owned Better Auth behavior. Do not ship generic auth, signup, OTP, federated-login, or provider abstractions from this package unless a later explicit boundary decision replaces the selected shadcn block.
-- **Standard components, not app-owned product features.** This package ships primitives, standard UI components, AI Elements, brand adapters, React adapters, reusable sections, and presentational product components such as settings, shells, plugin boundaries, installer states, agent chat, artifacts, files, diffs, and redacted terminal summaries. It must not ship app-specific feature/use-case screens or names such as operator-login, portal activation, customer credential control, customer management, or other product-domain use cases. Generic data tables, command palettes, and chart cards are app-owned shadcn registry adaptations, not NadicodeAI package abstractions. Those screens live in the consuming app and are built from `@nadicodeai/ui` components and first-party shadcn blocks/examples. The console chart kit (`chart-kpi-stat`, `chart-sparkline`, `chart-time-series`, `chart-bullet-bar`, `chart-breakdown-table`, `chart-delta`, `chart-entity-colors`, `chart-date-range`, `chart-date-range-control`) is plan-approved package surface per issue #166 and ADR 0010; chart *cards* — the app screens that arrange these widgets — remain app-owned. Every data-shaped chart names a data alternative (a visually hidden `<table>` twin for the time-series charts, a real `<table>` for `chart-breakdown-table`, an sr-only value list for a standalone `chart-sparkline`); `chart-bullet-bar` (data in `aria-valuetext` plus the visible value) and `chart-kpi-stat` (data in visible text) carry no separate table twin by design.
-- **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.
-- **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 should pass data and media children into existing compositions instead of rebuilding layout locally.
-- **Brand renderers live here for React consumers.** `BrandMark` is the logo mark, and `BrandWordmark` is the text-only wordmark. A full lockup is exactly one `BrandMark` followed by one `BrandWordmark`; compact mark-only usage uses `BrandMark` alone. These adapters are the only place React code imports the raw `@nadicodeai/design-system/assets/*` logo SVG exports. Website, portal, and sibling routes use these adapters instead of importing logo assets directly, drawing brand SVG inline, masking/recoloring assets, or embedding the mark inside the wordmark.
-- **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.
-- **Tier-1 accessibility is tested, browser-free.** Every `src/components/**/*.test.tsx` renders its component through `tests/support/a11y.tsx` `expectAccessible(ui, ruleOverrides?)` — a `@testing-library/react` mount checked with raw `axe-core`, the helper owning the full mount/unmount lifecycle — and `tests/guards/a11y-axe-coverage.test.ts` fails the suite if any component test file omits the call (a justified ignore list covers non-rendering tests only). Component test files opt into jsdom per file with a `/** @vitest-environment jsdom */` pragma; the workspace default stays `environment: "node"`, and jsdom is not a browser session, so the browser-free gate rule holds unchanged. This tier is structural only: `color-contrast` and `region` are globally disabled because jsdom computes neither rendered color nor landmark context, and it exercises no runtime focus or keyboard behavior. Rendered contrast, landmark/region context, and focus/keyboard interaction are tier 2 (real-browser axe via Playwright) and are explicitly out of this suite. The library ESLint config (`createLibraryEslintConfig`) additionally enforces seven `eslint-plugin-jsx-a11y` rules at `error` (alt-text, aria-props, aria-proptypes, aria-unsupported-elements, role-has-required-aria-props, role-supports-aria-props, no-noninteractive-element-interactions) as a static complement to the render tier.
-
-## Component Admission
-
-Agent work surfaces — chat, composer, tool approval, artifacts, threads,
-diffs, terminal/file preview, and the underlying agent state models — are
-NadicodeAI core domain. They belong in this package outright, not behind a
-named consumer. Any other new product composition (a shell, a settings
-surface, a generic section) is admitted only with a named consuming surface
-landing in the same change. Genuinely app-bespoke UI — window chrome,
-boot/install overlays, mascots, PTY/xterm embeds — stays in the consuming
-app; it never becomes a package abstraction. A component left unconsumed
-after its target migration ships gets removed.
-
-## Reusable Section Vocabulary
-
-The soft-launch homepage relies on this reusable vocabulary, and future reusable
-marketing/product sections should extend the same model:
-
-- `PageFrame` / `PageRow` wrappers for the kept page system.
-- `SectionIntro` for section headers.
-- `Bento` compound components for bordered marketing grids.
-- `MediaMount` for image, video, poster, and artifact mounts.
-- `DemoSurface` for chat, artifact, approval, tool-trace, image, and video demos.
-- `ShiftBand`, `UseCaseBento`, `WatchItWorkBand`, `BenefitsBento`, and
-  `ProofSlot` for homepage-level compositions.
-- Existing reusable sections/compositions such as `HeroSplit`, `ActionBand`, `Faq`, `Footer`, `NavBar`,
-  `LogoBand`, `Testimonials`, and `StatsBand` when their proof/content is real.
-
-When a page needs a variation, extend these source components with a small,
-typed prop or slot. Do not fork the same layout in `website/`.
-
-## shadcn / AI Elements Discovery
-
-Use live shadcn MCP or CLI discovery while maintaining this package. MCP/CLI is
-for browsing, searching, viewing docs, previewing diffs, and installing current
-registry source during implementation. `@nadicodeai/ui` does not maintain a
-committed upstream registry inventory, registry snapshot, or inventory update
-script.
-
-From `@nadicodeai/ui`, initialize Codex MCP only when the local runtime supports
-it:
-
-```bash
-npx shadcn@latest mcp init --client codex
-```
-
-CLI fallbacks:
-
-```bash
-npx shadcn@latest info --json
-npx shadcn@latest search @shadcn -q "select" --json
-npx shadcn@latest search @ai-elements -q "message" --json
-npx shadcn@latest docs button select dialog --json
-npx shadcn@latest view @shadcn/button
-npx shadcn@latest add @shadcn/button --dry-run
-npx shadcn@latest add @ai-elements/message --dry-run
-```
-
-Use `info --json` for project-aware aliases, Tailwind version, base primitive
-library, icon library, resolved source paths, and configured registries. Use
-`search`, `docs`, and `view` before adding source; use `add --dry-run` or
-`add --diff` before changing files. Do not use `--overwrite` unless the
-maintainer explicitly asks for an upstream refresh and the diff is reviewed.
-
-## Product Components And Consumer Readiness
-
-Use public component subpaths for product UI:
-
-- `@nadicodeai/ui/components/agent-chat`
-- `@nadicodeai/ui/components/agent-composer`
-- `@nadicodeai/ui/components/agent-message`
-- `@nadicodeai/ui/components/agent-thread`
-- `@nadicodeai/ui/components/agent-tool-approval`
-- `@nadicodeai/ui/components/artifact-panel`
-- `@nadicodeai/ui/components/automation-section`
-- `@nadicodeai/ui/components/chart-breakdown-table`
-- `@nadicodeai/ui/components/chart-bullet-bar`
-- `@nadicodeai/ui/components/chart-date-range`
-- `@nadicodeai/ui/components/chart-date-range-control`
-- `@nadicodeai/ui/components/chart-delta`
-- `@nadicodeai/ui/components/chart-entity-colors`
-- `@nadicodeai/ui/components/chart-kpi-stat`
-- `@nadicodeai/ui/components/chart-sparkline`
-- `@nadicodeai/ui/components/chart-time-series`
-- `@nadicodeai/ui/components/confirm-dialog`
-- `@nadicodeai/ui/components/dashboard-shell`
-- `@nadicodeai/ui/components/desktop-shell`
-- `@nadicodeai/ui/components/feedback-state`
-- `@nadicodeai/ui/components/files-preview`
-- `@nadicodeai/ui/components/installer-shell`
-- `@nadicodeai/ui/components/plugin-slot-boundary`
-- `@nadicodeai/ui/components/settings-section`
-
-Consumers own routing, auth, app data, server actions, runtime adapters,
-permission decisions, analytics, and app-specific copy. The package owns the
-presentational structure and state vocabulary only. Follow
-`docs/migration/nadia-consumer-readiness.md`: validate a web/admin or portal
-slice first, installer second, desktop shell third, desktop chat last, and TUI
-through `docs/terminal-tui-semantics.md`.
+The `@nadicodeai/ui` npm workspace: the shared NadicodeAI React UI package on brand tokens (Tailwind v4, semantic light/dark roles). It ships shadcn primitives backed by Base UI, AI Elements, React adapters over the design-system grammar, reusable marketing/section compositions, and plan-approved product components. Source-authored in `src/`, published from built `dist/`. The package's normative rules (styling and shape invariants, admission, accessibility tier, section vocabulary, consumer boundary) live in `docs/contract.md`; read it before changing the component library.
 
 ## Commands
 
 | Command | When |
 | --- | --- |
 | `npm run dev -w @nadicodeai/ui` | Watch `src/` and incrementally refresh `dist/` for local website or app iteration |
-| `npm run build:fast -w @nadicodeai/ui` | One-shot incremental `dist/` refresh for local development after the full package has already been built |
-| `npm run build -w @nadicodeai/ui` | Emit the consumable `dist/` package surface before packing or app builds |
-| `npm pack --dry-run -w @nadicodeai/ui` | Verify exactly what external npm consumers would receive after package surface, export, CSS, docs, or skill changes |
-| `npm run test -w @nadicodeai/ui` | Run this workspace's guards plus the per-file jsdom + axe-core tier-1 accessibility checks (browser-free; also runs inside the root `npm run test` gate) |
+| `npm run build:fast -w @nadicodeai/ui` | One-shot incremental `dist/` refresh after a prior full build |
+| `npm run build -w @nadicodeai/ui` | Emit the consumable `dist/` surface before packing or app builds |
+| `npm pack --dry-run -w @nadicodeai/ui` | Verify exactly what npm consumers receive after surface, export, CSS, docs, or skill changes |
+| `npm run lint -w @nadicodeai/ui` / `npm run typecheck -w @nadicodeai/ui` | ESLint / `tsc --noEmit` |
+| `npm run test -w @nadicodeai/ui` | Workspace guards plus the jsdom + axe-core tier-1 accessibility checks (browser-free; also inside the root gate) |
+
+## Routing
+
+| Task | Go to |
+| --- | --- |
+| Shared design-language terms | `../../design-system/CONTEXT.md` |
+| Package invariants, component admission, section vocabulary, consumer boundary | `docs/contract.md` |
+| React consumer installation and stylesheet setup | `docs/consuming-cross-repo.md` |
+| Token, mode, theme, cascade, and public stylesheet architecture | `../../design-system/DESIGN.md` (this package does not own a second token map) |
+| Which component subpaths exist | `package.json` `exports` (the `./components/*` wildcard over `src/components/` source is the whole surface; never maintain a hand-copied list) |
+| shadcn / AI Elements discovery | Live shadcn MCP or CLI (`npx shadcn@latest info\|search\|docs\|view\|add --dry-run`, see `../../skills/shadcn/SKILL.md`); no committed registry inventory or snapshot exists, and `--overwrite` needs an explicit maintainer ask plus a reviewed diff |
+| Releasing / publishing | `../../docs/internal/npm-publishing.md` (release decision enforced by the pre-push gate; detail in `docs/contract.md`) |
+| Tokens, geometry, and the CSS the package composes | `../../design-system/AGENTS.md` and `design-system/DESIGN.md` |
+| Website page assembly | `../../website/AGENTS.md` |
+| Portal screens | `../../portal/AGENTS.md` |
+| Product-component consumption order and TUI semantics | `docs/migration/nadia-consumer-readiness.md`, `docs/terminal-tui-semantics.md` |
+| Docs shipped to package consumers | `docs/contract.md` owns invariants, `docs/consuming-cross-repo.md` owns setup, and `llms.txt`, `docs/agents/nadicodeai-ui.md`, `docs/migration/`, and `skills/nadicodeai-ui/SKILL.md` map to those owners while documenting their own component or workflow surface |

package/README.md

@@ -8,21 +8,18 @@ entry stylesheet needed by consuming apps. It is intentionally coupled to
 `@nadicodeai/design-system`: the design-system package owns brand tokens,
 framework-agnostic geometry, fonts, assets, and CSS components; this package owns
 React components and reusable section compositions on those tokens. Shared
-product compositions from
-`../../docs/plans/2026-06-23-001-feat-nadia-product-ui-package-plan.md` now ship
-when their source, public subpath export, docs, and tests exist.
+product compositions ship when their source, public subpath export, contract,
+and tests exist together.
 
 The package ships:
 
 - shadcn source components under `@nadicodeai/ui/components/*`, backed by Base UI primitives where a headless primitive is needed
-- all 48 Vercel AI Elements under `@nadicodeai/ui/components/ai-elements/*`
+- Vercel AI Elements under `@nadicodeai/ui/components/ai-elements/*`
 - an AI Elements barrel at `@nadicodeai/ui/ai-elements`
 - React adapters over the design-system grammar and assets
 - reusable marketing/section compositions
-- presentational product components such as `SettingsSection`,
-  `DashboardShell`, `AgentChat`, `InstallerShell`, `PluginSlotBoundary`, and
-  `ThemeModeSwitcher`
-- package-local agent guidance: `AGENTS.md`, `llms.txt`,
+- presentational product components for shared application surfaces
+- package-local agent guidance: `AGENTS.md`, `docs/contract.md`, `llms.txt`,
   `docs/agents/nadicodeai-ui.md`, `docs/migration/`, and
   `skills/nadicodeai-ui/SKILL.md`
 
@@ -32,50 +29,26 @@ Do not add top-level exports for recipes, blocks, agent, or terminal groupings
 until a concrete package API decision adds source, built files, docs, and tests
 together. Routes, persistence, auth behavior, server state, runtime adapters,
 and app-owned product features/use cases stay in consuming apps such as
-`website/`, `portal/`, and sibling Nadia apps. Product-specific names such as
-`operator-login`, portal activation, and customer credential control stay out of
-package components.
+`website/`, `portal/`, and sibling Nadia apps. The package contract owns the
+admission boundary; this README does not maintain a second rule set.
 
 ## Install
 
-Install both NadicodeAI packages and the required peers in the consuming app:
-
-```bash
-npm install @nadicodeai/design-system @nadicodeai/ui react react-dom tailwindcss @tailwindcss/postcss
-```
-
-The package is scoped for public npm registry publishing.
+Follow [`docs/consuming-cross-repo.md`](docs/consuming-cross-repo.md). It owns the
+install command, exact-version policy, peer requirements, dependency boundary,
+and separate-asset exception. The package is scoped for public npm registry
+publishing.
 
 ## CSS
 
-Import the UI Tailwind entry and the design-system CSS once at the app root:
-
-```tsx
-import "@nadicodeai/ui/globals.css";
-import "@nadicodeai/design-system/css";
-```
+The package exposes one complete React stylesheet. Follow
+[`docs/consuming-cross-repo.md`](docs/consuming-cross-repo.md) for the complete
+consumer setup contract.
 
-`@nadicodeai/ui/globals.css` imports Tailwind v4, the generated NadicodeAI
-Tailwind theme, the shadcn role bridge, and the package-local semantic
-`:root`/`.dark` product aliases. The design-system theme owns the standard
-shadcn light and dark role maps; the UI package owns app shell/surface,
-chat/tool/composer, approval, diff/code, terminal/ANSI, trace/status,
-provider/model, and plugin permission aliases. Those aliases reference
-generated `--nc-*` tokens or semantic roles; they are not a new source-token
-group. `@nadicodeai/design-system/css` provides the kept
-`nc-*` page grammar, type scale, geometry, chat CSS components, motion, and
-brand display components that many UI components compose.
-
-Components should consume semantic utilities such as `bg-background`,
-`text-foreground`, and `border-border`, or product aliases such as
-`var(--nc-app-surface)` and `var(--nc-terminal-bg)` where a product role is
-needed. Do not add component-level Tailwind `dark:` utilities, OS dark-mode
-branching, raw color literals, or raw palette utilities.
-
-For Next.js App Router apps, place both imports in the root layout. The app still
-owns its PostCSS setup, theme provider, and persisted light/dark/system
-preference. `ThemeModeSwitcher` is controlled and app-agnostic; the app decides
-how to set `.dark` on the document. This package does not export a PostCSS config.
+Component styling rules live in [`docs/contract.md`](docs/contract.md). That
+contract owns token-only styling, canonical role use, and the ban on
+component-local dark implementations. This README does not
+restate those rules.
 
 ## Imports
 
@@ -103,64 +76,25 @@ import { DashboardShell } from "@nadicodeai/ui/components/dashboard-shell";
 import { AgentChat } from "@nadicodeai/ui/components/agent-chat";
 ```
 
+## Discover components
+
+The component inventory is generated from source instead of maintained in
+prose. In this repository, `src/components/**/*.tsx` owns the module set;
+`src/index.ts` and `src/ai-elements.ts` own the barrels. `package.json` exposes
+that source-backed surface through `./components/*`, and the build writes the
+consumer view to `dist/components/**/*.d.ts`.
+
+Use the source tree while maintaining this package. In an installed package,
+use its `package.json` exports and generated declarations for current subpaths,
+exports, and prop types.
+
 ## Product components
 
-Product components are presentational. The package owns shared layout,
-state-display, shell, plugin-boundary, installer, settings, chat, artifact,
-diff, and redacted terminal summary UI. Consuming apps own
-routes, app data, auth, server actions, persistence, permission decisions,
-runtime adapters, analytics, and product-specific copy.
-
-Generic product widgets that shadcn already ships as first-party registry
-source, such as data tables, command palettes, and chart cards, are app-owned
-shadcn block/example adaptations. Do not add a second package abstraction over
-those registry items. The console chart kit subpaths (`chart-*`) are the
-plan-approved exception (issue #166, ADR 0010): they mechanize the
-design-system dataviz grammar on the Recharts chart foundation, while chart
-cards — the app screens that arrange those widgets — stay app-owned. Every
-data-shaped chart names a data alternative (a visually hidden `<table>` twin for
-the time-series charts, a real `<table>` for `BreakdownTable`, an sr-only value
-list for a standalone `Sparkline`); `BulletBar` and `KpiStat` carry their data
-fully in `aria-valuetext`/visible text and so have no separate table twin by
-design.
-
-Current product subpaths:
-
-- `@nadicodeai/ui/components/agent-chat`
-- `@nadicodeai/ui/components/agent-composer`
-- `@nadicodeai/ui/components/agent-message`
-- `@nadicodeai/ui/components/agent-thread`
-- `@nadicodeai/ui/components/agent-tool-approval`
-- `@nadicodeai/ui/components/artifact-panel`
-- `@nadicodeai/ui/components/automation-section`
-- `@nadicodeai/ui/components/chart-breakdown-table`
-- `@nadicodeai/ui/components/chart-bullet-bar`
-- `@nadicodeai/ui/components/chart-date-range`
-- `@nadicodeai/ui/components/chart-date-range-control`
-- `@nadicodeai/ui/components/chart-delta`
-- `@nadicodeai/ui/components/chart-entity-colors`
-- `@nadicodeai/ui/components/chart-kpi-stat`
-- `@nadicodeai/ui/components/chart-sparkline`
-- `@nadicodeai/ui/components/chart-time-series`
-- `@nadicodeai/ui/components/confirm-dialog`
-- `@nadicodeai/ui/components/dashboard-shell`
-- `@nadicodeai/ui/components/desktop-shell`
-- `@nadicodeai/ui/components/feedback-state`
-- `@nadicodeai/ui/components/files-preview`
-- `@nadicodeai/ui/components/installer-shell`
-- `@nadicodeai/ui/components/plugin-slot-boundary`
-- `@nadicodeai/ui/components/settings-section`
-- `@nadicodeai/ui/components/theme-mode-switcher`
-
-`StateNotice` (`@nadicodeai/ui/components/state-notice`) is the supported
-low-level state-banner primitive behind `AgentMessageStateNotice` and
-`AgentThreadStateBanner`. It owns the shared icon, required `title`, optional
-description, and actions skeleton with `role="status"`/`role="alert"` semantics.
-
-Recommended migration order is documented in
-`docs/migration/nadia-consumer-readiness.md`: web admin or portal first,
-installer second, desktop shell third, desktop chat last, and terminal/TUI
-consumers through `docs/terminal-tui-semantics.md`.
+[`docs/contract.md`](docs/contract.md) owns the package/consumer boundary,
+admission rules, and accessibility invariants. Current modules are discovered
+from source and package exports, not from prose. Agent work-surface behavior,
+terminal semantics, and migration readiness each live in the linked package
+docs; this README does not summarize them.
 
 ## Layout primitives
 
@@ -239,7 +173,8 @@ field primitive instead of creating a parallel form-control API.
 
 The npm package includes agent-facing files on purpose. Agents should read:
 
-- `AGENTS.md` for the package contract
+- `AGENTS.md` for the package map and scoped rules
+- `docs/contract.md` for the package contract
 - `llms.txt` for a concise import/setup index
 - `docs/agents/nadicodeai-ui.md` for detailed usage and maintenance guidance
 - `docs/migration/nadia-consumer-readiness.md` for consumer migration order
@@ -255,11 +190,5 @@ exports.
 npm run build -w @nadicodeai/ui
 ```
 
-The build emits:
-
-- `dist/**/*.js`
-- `dist/**/*.d.ts`
-- `dist/styles/globals.css`
-
-`dist`, this README, package docs, and the package agent-instruction files are
-packed.
+`package.json` owns the build and packed-file surface. Use `npm pack --dry-run`
+to inspect the consumer artifact rather than maintaining an output list here.

package/dist/components/action-band.d.ts

@@ -1,10 +1,12 @@
 import * as React from "react";
-type ActionBandProps = React.ComponentProps<"div"> & {
+type ActionBandProps = React.ComponentProps<"section"> & {
+    /** Retained for consumer compatibility; the V5 band has a single fixed layout. */
     active?: "inset" | "full";
 };
-declare function ActionBand({ active, className, children, style, ...props }: ActionBandProps): React.JSX.Element;
+declare function ActionBand({ active, className, children, ...props }: ActionBandProps): React.JSX.Element;
 declare function ActionBandContent({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
 declare function ActionBandCopy({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function ActionBandHeading({ className, ...props }: React.ComponentProps<"h2">): React.JSX.Element;
 declare function ActionBandVisual({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
-export { ActionBand, ActionBandContent, ActionBandCopy, ActionBandVisual };
+export { ActionBand, ActionBandContent, ActionBandCopy, ActionBandHeading, ActionBandVisual };
 //# sourceMappingURL=action-band.d.ts.map

package/dist/components/action-band.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-band.d.ts","sourceRoot":"","sources":["../../src/components/action-band.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmC/B,KAAK,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IACnD,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B,CAAC;AAEF,iBAAS,UAAU,CAAC,EAAE,MAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,qBAsB9F;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAQ9E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW3E;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW7E;AAED,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"action-band.d.ts","sourceRoot":"","sources":["../../src/components/action-band.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA8C/B,KAAK,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG;IACvD,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B,CAAC;AAEF,iBAAS,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,qBA0B7E;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW9E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAE3E;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAW7E;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAQ7E;AAED,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/action-band.js

@@ -1,34 +1,48 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "../lib/utils.js";
-import { SeamGrid } from "./seam-grid.js";
 /**
- * action-band — full-lane conversion stage for a final CTA or page-level ask.
+ * action-band — the full-bleed on-verde conversion band (V5 · B19).
  *
- * Replaces the retired recipe-specific `action-stage` CSS with the kept stage
- * grammar: `nc-stage-frame`, `nc-stage-fill`, `nc-stage-grid`,
- * `nc-stage-active`, and connector strips. The component owns the conversion
- * band structure, while the page supplies copy, controls, and media. The outer
- * stage spans the full lane; the active band is a bounded 12-column cell grid
- * with a single internal seam owner (`bg-border` + `gap-px`). The page/frame/rail
- * geometry owns the perimeter. Token-only; no
- * raw color values and no `dark:` styling.
+ * A solid brand-verde field (`bg-primary`) carrying one statement and one action,
+ * per the founder rule "one statement, one button". The band bleeds full width; a
+ * centred rail (`max-w-[1200px]`, left/right hairlines) holds the content, and a
+ * crosshair marks the STRUCTURAL intersection of the rail's top edge and left edge
+ * — it is never decorative. A fractal-noise overlay adds grain TEXTURE only (an
+ * inline feTurbulence data-URI, carrying no colour value), layered under the copy.
+ *
+ * Every mark on the verde field — text, heading, crosshair, and rail hairlines —
+ * is the ink primary-foreground role, NOT `text-foreground`. `foreground` flips to
+ * near-white under a dark ancestor while `bg-primary` stays a bright verde field, so
+ * ink text would turn near-white-on-verde (≈1.7:1). `primary-foreground` is ink in
+ * both modes and the build gate guarantees it clears on the primary field. Token-only;
+ * no raw colour values, no gradients, and no `dark:` styling.
+ *
+ * COMPAT: the `active` prop and the `ActionBand{Content,Copy,Visual}` parts are kept
+ * so existing consumers still compile; their roles are re-cut for the V5 band
+ * (Content = padded stack, Copy = rich-content wrapper, Visual = the trailing
+ * action/media slot). `ActionBandHeading` owns the simple V5 statement treatment.
+ * The prior two-cell ink stage is retired.
  */
-function ActionBandConnector({ edge }) {
-    return (_jsx("div", { className: "nc-stage-grid nc-connector-strip", "data-edge": edge, "aria-hidden": "true", children: _jsxs("div", { className: "nc-stage-active nc-connector-track", children: [_jsx("div", { children: _jsx("svg", { width: "1", height: "100%", focusable: "false", children: _jsx("line", { x1: "0.5", y1: "0", x2: "0.5", y2: "100%" }) }) }), _jsx("svg", { width: "1", height: "100%", focusable: "false", children: _jsx("line", { x1: "0.5", y1: "0", x2: "0.5", y2: "100%" }) })] }) }));
+// Grain texture only — feTurbulence fractal noise, no colour literal (`#` encoded
+// as `%23`), so the no-raw-literal guard sees no hex/rgb/color-function.
+const GRAIN_TEXTURE = "url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='160' height='160'%3E%3Cfilter id='g'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='160' height='160' filter='url(%23g)'/%3E%3C/svg%3E\")";
+function ActionBandCrosshair() {
+    return (_jsxs("span", { "data-slot": "action-band-crosshair", "aria-hidden": "true", className: "pointer-events-none absolute left-0 top-0 z-20 size-4 -translate-x-1/2 -translate-y-1/2", children: [_jsx("span", { className: "absolute left-1/2 top-0 h-full w-px -translate-x-1/2 bg-primary-foreground" }), _jsx("span", { className: "absolute left-0 top-1/2 h-px w-full -translate-y-1/2 bg-primary-foreground" })] }));
 }
-function ActionBand({ active = "inset", className, children, style, ...props }) {
-    return (_jsxs("div", { "data-slot": "action-band", "data-frame-lines": "true", className: cn("nc-stage-frame relative", className), style: {
-            ...(active === "full" ? { "--nc-stage-active-column": "1 / -1" } : {}),
-            ...style,
-        }, ...props, children: [_jsx("div", { className: "nc-stage-fill", "aria-hidden": "true" }), _jsx(ActionBandConnector, { edge: "start" }), _jsx("div", { className: "nc-stage-grid", children: _jsx("div", { className: "nc-stage-active", children: children }) }), _jsx(ActionBandConnector, { edge: "end" })] }));
+function ActionBand({ active, className, children, ...props }) {
+    void active;
+    return (_jsxs("section", { "data-slot": "action-band", className: cn("relative isolate overflow-hidden bg-primary text-primary-foreground", className), ...props, children: [_jsx("span", { "aria-hidden": "true", className: "pointer-events-none absolute inset-0 z-0 opacity-20", style: { backgroundImage: GRAIN_TEXTURE } }), _jsxs("div", { "data-slot": "action-band-rail", className: "relative z-10 mx-auto w-full max-w-[1200px] border-x border-primary-foreground/15", children: [_jsx(ActionBandCrosshair, {}), children] })] }));
 }
 function ActionBandContent({ className, ...props }) {
-    return (_jsx(SeamGrid, { "data-slot": "action-band-content", className: cn("min-w-0 lg:h-[var(--nc-h-action-band)] lg:grid-cols-12", className), ...props }));
+    return (_jsx("div", { "data-slot": "action-band-content", className: cn("flex flex-col items-start gap-6 px-[clamp(24px,5vw,64px)] py-[clamp(64px,10vw,144px)]", className), ...props }));
 }
 function ActionBandCopy({ className, ...props }) {
-    return (_jsx("div", { "data-slot": "action-band-copy", className: cn("nc-panel-cell relative overflow-hidden !bg-[var(--nc-ink)] !text-[var(--nc-canvas)] lg:col-span-6", className), ...props }));
+    return _jsx("div", { "data-slot": "action-band-copy", className: cn("min-w-0", className), ...props });
+}
+function ActionBandHeading({ className, ...props }) {
+    return (_jsx("h2", { "data-slot": "action-band-heading", className: cn("nc-type-display-md max-w-[24ch] text-balance text-primary-foreground", className), ...props }));
 }
 function ActionBandVisual({ className, ...props }) {
-    return (_jsx("div", { "data-slot": "action-band-visual", className: cn("nc-panel-cell items-stretch !p-0 ![align-content:stretch] ![grid-template-rows:minmax(0,1fr)] lg:col-span-6", className), ...props }));
+    return (_jsx("div", { "data-slot": "action-band-visual", className: cn("flex flex-wrap items-center gap-3", className), ...props }));
 }
-export { ActionBand, ActionBandContent, ActionBandCopy, ActionBandVisual };
+export { ActionBand, ActionBandContent, ActionBandCopy, ActionBandHeading, ActionBandVisual };

package/dist/components/agent-chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-chat.d.ts","sourceRoot":"","sources":["../../src/components/agent-chat.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAe,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gCAAgC,EACrC,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAGpC,iBAAS,SAAS,CAAC,EACjB,QAAQ,EACR,KAAc,EACd,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,MAAM,EACN,SAAS,EACT,eAAe,EACf,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACnF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,oBAAoB,CAAC,EAAE,gCAAgC,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,qBAgCA;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"agent-chat.d.ts","sourceRoot":"","sources":["../../src/components/agent-chat.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAe,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gCAAgC,EACrC,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAGpC,iBAAS,SAAS,CAAC,EACjB,QAAQ,EACR,KAAc,EACd,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,MAAM,EACN,SAAS,EACT,eAAe,EACf,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACnF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,oBAAoB,CAAC,EAAE,gCAAgC,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,qBA6BA;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/components/agent-chat.js

@@ -4,7 +4,7 @@ import { AgentComposer } from "./agent-composer.js";
 import { AgentThread } from "./agent-thread.js";
 import { cn } from "../lib/utils.js";
 function AgentChat({ messages, state = "idle", stateCopy, emptyState, composer, composerProps, toolActions, retryAction, onToolApprovalChoice, maxMessages, header, className, threadClassName, ...props }) {
-    return (_jsxs("section", { "data-slot": "agent-chat", "data-agent-state": state, className: cn("flex min-h-0 flex-col gap-4 rounded-lg border bg-[var(--nc-app-surface-panel)] p-3", className), ...props, children: [header && _jsx("div", { "data-slot": "agent-chat-header", children: header }), _jsx(AgentThread, { messages: messages, state: state, stateCopy: stateCopy, emptyState: emptyState, toolActions: toolActions, retryAction: retryAction, onToolApprovalChoice: onToolApprovalChoice, maxMessages: maxMessages, className: cn("flex-1", threadClassName) }), composer ??
+    return (_jsxs("section", { "data-slot": "agent-chat", "data-agent-state": state, className: cn("flex min-h-0 flex-col gap-4 rounded-lg border bg-card p-3", className), ...props, children: [header && _jsx("div", { "data-slot": "agent-chat-header", children: header }), _jsx(AgentThread, { messages: messages, state: state, stateCopy: stateCopy, emptyState: emptyState, toolActions: toolActions, retryAction: retryAction, onToolApprovalChoice: onToolApprovalChoice, maxMessages: maxMessages, className: cn("flex-1", threadClassName) }), composer ??
                 (composerProps ? (_jsx(AgentComposer, { ...composerProps, state: state === "streaming" ? "streaming" : composerProps.state })) : null)] }));
 }
 export { AgentChat };

package/dist/components/agent-composer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-composer.d.ts","sourceRoot":"","sources":["../../src/components/agent-composer.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-composer.d.ts","sourceRoot":"","sources":["../../src/components/agent-composer.tsx"],"names":[],"mappings":"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"}

package/dist/components/agent-composer.js

@@ -47,7 +47,7 @@ function AgentQueuePanel({ queue, actions, className, }) {
 function AgentComposer({ value, defaultValue, placeholder = "Ask Nadia to work on this...", attachments = [], queue, state = "idle", disabled = false, slashMenu, mentionMenu, tools, submitLabel = "Submit", stopLabel = "Stop", onValueChange, onSubmit, onStop, onRemoveAttachment, queueActions, footer, className, ...props }) {
     const isDisabled = disabled || state === "disabled" || state === "submitting";
     const isStreaming = state === "streaming";
-    return (_jsxs("div", { "data-slot": "agent-composer-shell", "data-composer-state": state, "data-disabled": isDisabled ? true : undefined, className: "grid gap-3", children: [queue && _jsx(AgentQueuePanel, { queue: queue, actions: queueActions }), _jsxs(PromptInput, { "data-slot": "agent-composer", className: cn("rounded-lg border bg-[var(--nc-composer-surface)] text-[var(--nc-composer-foreground)]", className), onSubmit: (message, event) => onSubmit?.({
+    return (_jsxs("div", { "data-slot": "agent-composer-shell", "data-composer-state": state, "data-disabled": isDisabled ? true : undefined, className: "grid gap-3", children: [queue && _jsx(AgentQueuePanel, { queue: queue, actions: queueActions }), _jsxs(PromptInput, { "data-slot": "agent-composer", className: cn("rounded-lg border bg-popover text-popover-foreground", className), onSubmit: (message, event) => onSubmit?.({
                     attachments,
                     queue,
                     value: message.text,

package/dist/components/ai-elements/terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/components/ai-elements/terminal.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAgB5D,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEjE,eAAO,MAAM,cAAc,GAAI,mCAAmC,mBAAmB,gCAUpF,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEhE,eAAO,MAAM,aAAa,GAAI,mCAAmC,kBAAkB,gCAQlF,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEjE,eAAO,MAAM,cAAc,GAAI,mCAAmC,mBAAmB,uCAepF,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe,GAAI,mCAAmC,oBAAoB,gCAItF,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,MAAM,CAAC,GAAG;IACpE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,6DAOhC,uBAAuB,gCAyBzB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC;AAErE,eAAO,MAAM,mBAAmB,GAAI,mCAIjC,wBAAwB,uCAqB1B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe,GAAI,mCAAmC,oBAAoB,gCA0BtF,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,6EAQtB,aAAa,gCAiCf,CAAC"}
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/components/ai-elements/terminal.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAgB5D,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEjE,eAAO,MAAM,cAAc,GAAI,mCAAmC,mBAAmB,gCAUpF,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEhE,eAAO,MAAM,aAAa,GAAI,mCAAmC,kBAAkB,gCAQlF,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEjE,eAAO,MAAM,cAAc,GAAI,mCAAmC,mBAAmB,uCAepF,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe,GAAI,mCAAmC,oBAAoB,gCAItF,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,MAAM,CAAC,GAAG;IACpE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,6DAOhC,uBAAuB,gCAyBzB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC;AAErE,eAAO,MAAM,mBAAmB,GAAI,mCAIjC,wBAAwB,uCAqB1B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe,GAAI,mCAAmC,oBAAoB,gCA0BtF,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,6EAQtB,aAAa,gCAkCf,CAAC"}

package/dist/components/ai-elements/terminal.js

@@ -11,14 +11,14 @@ const TerminalContext = createContext({
     isStreaming: false,
     output: "",
 });
-export const TerminalHeader = ({ className, children, ...props }) => (_jsx("div", { className: cn("flex items-center justify-between border-primary-foreground/20 border-b px-4 py-2", className), ...props, children: children }));
-export const TerminalTitle = ({ className, children, ...props }) => (_jsxs("div", { className: cn("flex items-center gap-2 text-sm text-primary-foreground/70", className), ...props, children: [_jsx(TerminalIcon, { className: "size-4" }), children ?? "Terminal"] }));
+export const TerminalHeader = ({ className, children, ...props }) => (_jsx("div", { className: cn("flex items-center justify-between border-[var(--nc-dark-line)] border-b px-4 py-2", className), ...props, children: children }));
+export const TerminalTitle = ({ className, children, ...props }) => (_jsxs("div", { className: cn("flex items-center gap-2 text-sm text-[var(--nc-dark-muted)]", className), ...props, children: [_jsx(TerminalIcon, { className: "size-4" }), children ?? "Terminal"] }));
 export const TerminalStatus = ({ className, children, ...props }) => {
     const { isStreaming } = useContext(TerminalContext);
-    if (!isStreaming) {
+    if (!isStreaming && children == null) {
         return null;
     }
-    return (_jsx("div", { className: cn("flex items-center gap-2 text-xs text-primary-foreground/70", className), ...props, children: children }));
+    return (_jsx("div", { className: cn("flex items-center gap-2 text-xs text-[var(--nc-dark-muted)]", className), ...props, children: children }));
 };
 export const TerminalActions = ({ className, children, ...props }) => (_jsx("div", { className: cn("flex items-center gap-1", className), ...props, children: children }));
 export const TerminalCopyButton = ({ onCopy, onError, timeout = 2000, children, className, ...props }) => {
@@ -30,14 +30,14 @@ export const TerminalCopyButton = ({ onCopy, onError, timeout = 2000, children,
         timeout,
     });
     const Icon = isCopied ? CheckIcon : CopyIcon;
-    return (_jsx(Button, { className: cn("size-7 shrink-0 text-primary-foreground/70 hover:bg-primary-foreground/10 hover:text-primary-foreground", className), onClick: copyToClipboard, size: "icon", variant: "ghost", ...props, children: children ?? _jsx(Icon, { size: 14 }) }));
+    return (_jsx(Button, { className: cn("size-7 shrink-0 text-[var(--nc-dark-muted)] hover:bg-[var(--nc-dark-canvas-soft-2)] hover:text-[var(--nc-dark-ink)]", className), onClick: copyToClipboard, size: "icon", variant: "ghost", ...props, children: children ?? _jsx(Icon, { size: 14 }) }));
 };
 export const TerminalClearButton = ({ children, className, ...props }) => {
     const { onClear } = useContext(TerminalContext);
     if (!onClear) {
         return null;
     }
-    return (_jsx(Button, { className: cn("size-7 shrink-0 text-primary-foreground/70 hover:bg-primary-foreground/10 hover:text-primary-foreground", className), onClick: onClear, size: "icon", variant: "ghost", ...props, children: children ?? _jsx(Trash2Icon, { size: 14 }) }));
+    return (_jsx(Button, { className: cn("size-7 shrink-0 text-[var(--nc-dark-muted)] hover:bg-[var(--nc-dark-canvas-soft-2)] hover:text-[var(--nc-dark-ink)]", className), onClick: onClear, size: "icon", variant: "ghost", ...props, children: children ?? _jsx(Trash2Icon, { size: 14 }) }));
 };
 export const TerminalContent = ({ className, children, ...props }) => {
     const { output, isStreaming, autoScroll } = useContext(TerminalContext);
@@ -47,9 +47,9 @@ export const TerminalContent = ({ className, children, ...props }) => {
             containerRef.current.scrollTop = containerRef.current.scrollHeight;
         }
     }, [output, autoScroll]);
-    return (_jsx("div", { className: cn("max-h-96 overflow-auto p-4 font-mono text-sm leading-relaxed", className), ref: containerRef, ...props, children: children ?? (_jsxs("pre", { className: "whitespace-pre-wrap break-words", children: [_jsx(Ansi, { children: output }), isStreaming && (_jsx("span", { className: "ml-0.5 inline-block h-4 w-2 animate-pulse bg-primary-foreground" }))] })) }));
+    return (_jsx("div", { className: cn("max-h-96 overflow-auto p-4 font-mono text-sm leading-relaxed", className), ref: containerRef, ...props, children: children ?? (_jsxs("pre", { className: "whitespace-pre-wrap break-words", children: [_jsx(Ansi, { useClasses: true, children: output }), isStreaming && (_jsx("span", { className: "ml-0.5 inline-block h-4 w-2 animate-pulse bg-[var(--nc-dark-cyan)]" }))] })) }));
 };
 export const Terminal = ({ output, isStreaming = false, autoScroll = true, onClear, className, children, ...props }) => {
     const contextValue = useMemo(() => ({ autoScroll, isStreaming, onClear, output }), [autoScroll, isStreaming, onClear, output]);
-    return (_jsx(TerminalContext.Provider, { value: contextValue, children: _jsx("div", { className: cn("flex flex-col overflow-hidden rounded-lg border bg-primary text-primary-foreground", className), ...props, children: children ?? (_jsxs(_Fragment, { children: [_jsxs(TerminalHeader, { children: [_jsx(TerminalTitle, {}), _jsxs("div", { className: "flex items-center gap-1", children: [_jsx(TerminalStatus, {}), _jsxs(TerminalActions, { children: [_jsx(TerminalCopyButton, {}), onClear && _jsx(TerminalClearButton, {})] })] })] }), _jsx(TerminalContent, {})] })) }) }));
+    return (_jsx(TerminalContext.Provider, { value: contextValue, children: _jsx("div", { "data-slot": "terminal", className: cn("flex flex-col overflow-hidden rounded-lg border border-[var(--nc-dark-line)] bg-[var(--nc-dark-canvas-soft)] text-[var(--nc-dark-ink)] selection:bg-[var(--nc-dark-cyan)] selection:text-[var(--nc-dark-canvas)]", className), ...props, children: children ?? (_jsxs(_Fragment, { children: [_jsxs(TerminalHeader, { children: [_jsx(TerminalTitle, {}), _jsxs("div", { className: "flex items-center gap-1", children: [_jsx(TerminalStatus, {}), _jsxs(TerminalActions, { children: [_jsx(TerminalCopyButton, {}), onClear && _jsx(TerminalClearButton, {})] })] })] }), _jsx(TerminalContent, {})] })) }) }));
 };