@nadicodeai/ui 0.21.0 → 0.22.0

package/dist/lib/message-scroller-primitive/use-render.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-render.d.ts","sourceRoot":"","sources":["../../../src/lib/message-scroller-primitive/use-render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C,KAAK,cAAc,CAAC,MAAM,SAAS,WAAW,IAAI,CAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,MAAM,KACV,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;AAE/B,KAAK,UAAU,CAAC,MAAM,SAAS,WAAW,IAAI,KAAK,CAAC,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAE1F,KAAK,sBAAsB,CAAC,MAAM,SAAS,WAAW,IAAI,OAAO,CAAC;KAC/D,CAAC,IAAI,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS;CACjG,CAAC,CAAC;AAEH,KAAK,uBAAuB,CAC1B,QAAQ,SAAS,KAAK,CAAC,WAAW,EAClC,MAAM,SAAS,WAAW,GAAG,WAAW,IACtC,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,GAAG;IAC1C,MAAM,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;CAC7B,CAAC;AAEF,KAAK,gBAAgB,CAAC,QAAQ,SAAS,KAAK,CAAC,WAAW,EAAE,MAAM,SAAS,WAAW,IAAI;IACtF,cAAc,EAAE,QAAQ,CAAC;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACzD,CAAC;AAEF,iBAAS,SAAS,CAAC,QAAQ,SAAS,KAAK,CAAC,WAAW,EAAE,MAAM,SAAS,WAAW,GAAG,WAAW,EAAE,EAC/F,cAAc,EACd,KAAK,EACL,MAAM,EACN,KAAoB,EACpB,sBAAsB,GACvB,EAAE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,6EA6BpC;AAED,iBAAS,UAAU,CAAC,QAAQ,SAAS,KAAK,CAAC,WAAW,EACpD,GAAG,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,GA4C7E,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CACvD;AAqDD,iBAAS,WAAW,CAAC,CAAC,EACpB,GAAG,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,GACvC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAgBlC;AAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,uBAAuB,EAAE,CAAC"}

package/dist/lib/message-scroller-primitive/use-render.js

@@ -1,113 +0,0 @@
-// Vendored from @shadcn/react 0.2.1 (upstream github.com/shadcn-ui).
-// Adapted only for repo import paths and formatting; not added as an npm dependency.
-// A poor man's version of base-ui useRender.
-// see https://base-ui.com/react/utils/use-render.
-// TODO: Replace if base-ui useRender is published as a package.
-import * as React from "react";
-function useRender({ defaultTagName, props, render, state = {}, stateAttributesMapping, }) {
-    const elementProps = mergeProps(getStateAttributes(state, stateAttributesMapping), props);
-    if (!render) {
-        return React.createElement(defaultTagName, elementProps);
-    }
-    if (typeof render === "function") {
-        return render(elementProps, state);
-    }
-    if (!React.isValidElement(render)) {
-        return null;
-    }
-    const renderProps = render.props;
-    const propsWithRenderProps = mergeProps(elementProps, renderProps);
-    const propsWithRef = {
-        ...propsWithRenderProps,
-        ref: composeRefs(elementProps.ref, renderProps.ref),
-    };
-    return React.cloneElement(render, propsWithRef);
-}
-function mergeProps(...sources) {
-    const result = {};
-    for (const source of sources) {
-        if (!source) {
-            continue;
-        }
-        const sourceProps = source;
-        for (const key of Object.keys(sourceProps)) {
-            const value = sourceProps[key];
-            if (value === undefined) {
-                continue;
-            }
-            const current = result[key];
-            if (key === "className") {
-                result[key] = [current, value].filter(Boolean).join(" ");
-            }
-            else if (key === "style") {
-                result[key] = {
-                    ...current,
-                    ...value,
-                };
-            }
-            else if (key === "ref") {
-                result[key] = composeRefs(current, value);
-            }
-            else if (isEventHandler(key) &&
-                typeof current === "function" &&
-                typeof value === "function") {
-                result[key] = composeEventHandlers(value, current);
-            }
-            else {
-                result[key] = value;
-            }
-        }
-    }
-    return result;
-}
-function getStateAttributes(state, mapping) {
-    const props = {};
-    for (const key of Object.keys(state)) {
-        const value = state[key];
-        const attributes = mapping?.[key]?.(value);
-        if (attributes) {
-            Object.assign(props, attributes);
-            continue;
-        }
-        if (key === "slot") {
-            props["data-slot"] = value;
-            continue;
-        }
-        const attribute = `data-${String(key).replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
-        if (typeof value === "boolean") {
-            props[attribute] = value ? "" : undefined;
-        }
-        else if (value !== null && value !== undefined) {
-            props[attribute] = String(value);
-        }
-    }
-    return props;
-}
-function composeEventHandlers(theirs, ours) {
-    return function handleEvent(event) {
-        theirs(event);
-        if (!event.defaultPrevented) {
-            ours(event);
-        }
-    };
-}
-function isEventHandler(key) {
-    return /^on[A-Z]/.test(key);
-}
-function composeRefs(...refs) {
-    const validRefs = refs.filter(Boolean);
-    if (validRefs.length === 0) {
-        return undefined;
-    }
-    return (value) => {
-        for (const ref of validRefs) {
-            if (typeof ref === "function") {
-                ref(value);
-            }
-            else if (ref) {
-                ref.current = value;
-            }
-        }
-    };
-}
-export { composeRefs, mergeProps, useRender };

package/dist/lib/message-scroller-primitive/utils.d.ts

@@ -1,4 +0,0 @@
-import * as React from "react";
-declare function useLatest<T>(value: T): React.RefObject<T>;
-export { useLatest };
-//# sourceMappingURL=utils.d.ts.map

package/dist/lib/message-scroller-primitive/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/message-scroller-primitive/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,iBAAS,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,sBAM7B;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/lib/message-scroller-primitive/utils.js

@@ -1,9 +0,0 @@
-// Vendored from @shadcn/react 0.2.1 (upstream github.com/shadcn-ui).
-// Adapted only for repo import paths and formatting; not added as an npm dependency.
-import * as React from "react";
-function useLatest(value) {
-    const ref = React.useRef(value);
-    ref.current = value;
-    return ref;
-}
-export { useLatest };

package/docs/agent-work-surfaces.md

@@ -1,132 +0,0 @@
-# Agent Work Surfaces
-
-Presentational agent surfaces for Nadia-flavored chat, composer, approval,
-artifact, file, preview, diff, and terminal summary UI, plus the identity slots
-they compose from. These components render serializable state models and leave
-runtime behavior to the consuming app.
-
-## Design-System Family Convergence
-
-The React agent layer is the React face of the design-system Agentic Work
-Surface CSS families (`design-system/DESIGN.md`). Each component consumes its
-`nc-*` family class for identity — surface, border, chrome — and adds Tailwind
-only for layout and spacing; the CSS family owns any value it already sets. The
-families arrive through the UI package's complete React stylesheet interface.
-Consumer setup lives in [`consuming-cross-repo.md`](consuming-cross-repo.md);
-the component styling invariant lives in [`contract.md`](contract.md).
-
-- `AgentThread` -> `nc-chat-thread`.
-- `AgentMessage` text bubbles -> `nc-chat-bubble-user` / `nc-chat-bubble-agent`;
-  the tool row -> `nc-tool-call-trace`.
-- `AgentToolApproval` -> `nc-approval-gate`.
-- `ArtifactPanel` -> `nc-artifact-preview`.
-- `AgentAvatar` -> `nc-agent-avatar`, `UsageMeter` -> `nc-usage-meter`,
-  `RunTimeline` -> `nc-run-timeline`, `MemoryItem` -> `nc-memory-item`,
-  `HandoffBanner` -> `nc-handoff-banner`.
-
-## Components
-
-- `AgentChat` combines an `AgentThread` with an optional `AgentComposer`.
-- `AgentThread` renders message lists plus empty, queued, streaming, interrupted,
-  retryable, permission-denied, and fatal state banners.
-- `AgentMessage` renders user, assistant, and system messages with text,
-  reasoning summaries, tool calls, source references, artifacts, attachments,
-  and state notices.
-- `AgentComposer` renders a controlled or uncontrolled input surface with
-  attachments, queue panel, submit or stop control, and slash or mention slots.
-- `AgentToolApproval` renders the approval choices `run`, `deny`, `session`,
-  and `always` with stable action meanings.
-- `ArtifactPanel` renders text, code, diff, terminal summary, preview,
-  stack-trace, and test-result artifacts.
-- `FilesPreview` and `ProjectFileTree` render a serializable project tree and
-  file preview without desktop IPC.
-- `AgentAvatar` renders an agent identity slot with an optional accent ring; the
-  chrome is reusable and the initials, image, or generated asset are slotted.
-- `UsageMeter` renders a token, cost, latency, or run-count meta row from
-  serializable `fields` and `trailing` strings over an optional progress track
-  driven by `usage`, with a `children` slot for custom meta content.
-- `RunTimeline` renders a vertical step thread for a run, handoff, or workflow
-  from serializable steps (`title`, `label`, `detail`) with `ready`, `running`,
-  `review`, `blocked`, and `complete` step states and a per-step `detailSlot`
-  escape hatch.
-- `MemoryItem` renders a remembered-fact row from a serializable `label` and
-  `fact`, with a `children` slot that replaces the fact.
-- `HandoffBanner` renders an agent-to-agent or human-to-agent handoff surface
-  from a serializable `reason` and `destination`, with a `children` slot that
-  replaces the model.
-
-## State Models
-
-The public models are plain JSON-shaped data. React nodes are accepted only as
-explicit slots such as `composer`, `slashMenu`, `mentionMenu`, `toolActions`,
-`retryAction`, `previewActions`, or `actions`.
-
-```tsx
-import { AgentChat } from "@nadicodeai/ui/components/agent-chat"
-
-const messages = [
-  {
-    id: "assistant-1",
-    role: "assistant",
-    metadata: {
-      kind: "agent",
-      label: "Nadia",
-      model: "synthetic-model",
-    },
-    parts: [
-      {
-        type: "text",
-        text: "I reviewed the synthetic fixture.",
-      },
-      {
-        type: "reasoning",
-        reasoning: {
-          id: "reasoning-1",
-          status: "available",
-          summary: "Package primitives cover the requested surface.",
-        },
-      },
-    ],
-  },
-] as const
-
-export function FixtureChat() {
-  return <AgentChat messages={[...messages]} state="idle" />
-}
-```
-
-## Redaction
-
-Use `AgentRedactionRule` whenever a payload cannot be shown. Redaction labels
-exist for secrets, environment values, terminal transcripts, user memory, and
-private reasoning. The component should receive the redaction object instead of
-the protected value.
-
-```tsx
-const redactedTool = {
-  id: "tool-1",
-  name: "fixture_check",
-  status: "error",
-  redaction: {
-    redacted: true,
-    category: "secret",
-  },
-} as const
-```
-
-## Approval Meanings
-
-`AgentToolApproval` emits both the user-facing choice and a stable action value:
-
-- `run` -> `approve-once`
-- `deny` -> `reject`
-- `session` -> `approve-session`
-- `always` -> `approve-always`
-
-Consumers own the approval action handler and persistence.
-
-## Runtime Boundary
-
-These components do not open files, execute commands, persist messages, call
-models, stream tokens, retry tools, or talk to a desktop process. Pass callbacks
-or slots for those behaviors from the consuming app.

package/docs/migration/ai-elements-vendoring.md

@@ -1,29 +0,0 @@
-# AI Elements Vendoring
-
-`@nadicodeai/ui/src/components/ai-elements/*` is vendored source, not a
-dependency. It was pulled from
-[github.com/vercel/ai-elements](https://github.com/vercel/ai-elements) on
-2026-06-22 in monorepo commit `c2b97003` ("feat(ui): package shadcn and ai
-elements") — 48 components. The upstream ref at vendor time was not recorded;
-every re-vendor from now on records the upstream ref it checked in the log
-below. Since vendoring, the components have been adapted
-in place: the Base UI migration (`docs/migration/base-ui-migration.md`),
-`src/hooks/use-controllable-state.ts` replacing
-`@radix-ui/react-use-controllable-state`, and theming onto brand tokens.
-
-Upstream `ai-elements` is still Radix-based. Re-vendoring an item is a diff,
-not a copy:
-
-1. Fetch the upstream item's current source (`shadcn` CLI against the
-   `@ai-elements` registry, or the upstream repo directly).
-2. Diff it against our adapted file in
-   `@nadicodeai/ui/src/components/ai-elements/`.
-3. Re-apply the Base UI migration and token adaptations to whatever upstream
-   changed — do not reintroduce Radix imports or raw palette values.
-4. Record the upstream ref checked below.
-
-## Re-vendor log
-
-| Date | Upstream ref checked | Notes |
-| --- | --- | --- |
-| 2026-06-22 | not recorded | Initial vendor, 48 components (monorepo commit `c2b97003`). |

package/docs/terminal-tui-semantics.md

@@ -1,172 +0,0 @@
-# Terminal/TUI Semantics
-
-This document owns the serializable names that a terminal, React Ink, or other
-TUI consumer may use to preserve the meaning of shared agent states. It does not
-define CSS custom properties, color values, light/dark mappings, a terminal
-runtime, or a package export.
-
-The framework-free data contracts live in `src/lib/agent-contracts.ts` and
-`src/lib/agent-state.ts`. Canonical visual tokens and mode behavior live only in
-[`design-system/DESIGN.md`](../../../design-system/DESIGN.md). A real TUI
-renderer may consume `@nadicodeai/design-system/tokens/dtcg` and implement its
-own technology adapter, but it must not copy a UI-local palette or treat this
-document as a second theme source.
-
-Do not put raw terminal output, secrets, environment values, user memory, hidden
-chain-of-thought, or provider content in package examples or fixtures. Use
-synthetic summaries and explicit redaction fields.
-
-## Naming rules
-
-- Names use dot-case strings such as `terminal.foreground`, `tool.running`, and
-  `approval.session`.
-- DOM and TUI state names carry the same meaning. A renderer chooses its own
-  glyph, spacing, ANSI escape, and interaction behavior.
-- Run-state parity uses `ready`, `running`, `review`, `blocked`, and `complete`.
-- Tool and command status uses `pending`, `running`, `success`, `warning`,
-  `error`, and `muted`.
-- Adding a visual value or mode mapping is a design-system change, not a new
-  serializable state.
-
-## Terminal and ANSI roles
-
-| Serializable role | Meaning |
-| --- | --- |
-| `terminal.foreground` | Default terminal text. |
-| `terminal.background` | Default terminal canvas. |
-| `terminal.muted` | Timestamps, separators, and low-priority metadata. |
-| `terminal.cursor` | Text cursor or focused prompt caret. |
-| `terminal.selection` | Selected text treatment. |
-
-ANSI names follow the protocol vocabulary without inventing branded aliases:
-
-- `terminal.ansi.<color>` where `<color>` is `black`, `red`, `green`, `yellow`,
-  `blue`, `magenta`, `cyan`, or `white`.
-- `terminal.ansi.bright-<color>` for the corresponding bright foreground.
-
-## Code and diff roles
-
-| Serializable role | Meaning |
-| --- | --- |
-| `code.foreground` | Default code text. |
-| `code.background` | Code block or inline-preview surface. |
-| `code.border` | Code surface border or gutter divider. |
-| `code.token.keyword` | Syntax keyword. |
-| `code.token.string` | Syntax string. |
-| `code.token.comment` | Syntax comment. |
-| `code.token.function` | Syntax function. |
-| `diff.added` | Added content. |
-| `diff.added.line` | Added line. |
-| `diff.added.word` | Added inline word span. |
-| `diff.removed` | Removed content. |
-| `diff.removed.line` | Removed line. |
-| `diff.removed.word` | Removed inline word span. |
-| `diff.modified` | Modified context. |
-| `diff.modified.hunk` | Hunk marker or changed context. |
-| `diff.modified.file-header` | Modified file header. |
-
-## Trace and command status
-
-Trace severity describes technical trails and diagnostic summaries. It is not a
-license to store raw logs in package examples.
-
-| Serializable state | Meaning |
-| --- | --- |
-| `trace.info` | Informational trace row. |
-| `trace.success` | Completed trace row. |
-| `trace.warning` | Recoverable warning. |
-| `trace.error` | Failed trace row. |
-| `trace.muted` | Low-priority diagnostic metadata. |
-| `command.queued` | Queued but not started. |
-| `command.pending` | Waiting for scheduler, input, or approval. |
-| `command.running` | Currently executing. |
-| `command.success` | Finished successfully. |
-| `command.warning` | Finished with warnings or partial recovery. |
-| `command.error` | Failed. |
-| `command.paused` | Paused by a user or runtime. |
-| `command.blocked` | Blocked by a missing permission, precondition, or input. |
-| `command.complete` | Completed run. |
-
-## Provider and model status
-
-| Serializable state | Meaning |
-| --- | --- |
-| `provider.online` | Provider is available. |
-| `provider.offline` | Provider is unavailable. |
-| `provider.degraded` | Provider is available with degraded capacity. |
-| `provider.error` | Provider cannot serve requests. |
-| `model.available` | Model is available for selection. |
-| `model.selected` | Model is selected or focused. |
-| `model.context-warning` | Context window is near a configured limit. |
-| `model.cost-warning` | Model is budget-sensitive. |
-| `model.rate-limited` | Rate limiting is active or likely. |
-| `model.unavailable` | Model cannot be selected. |
-
-## Approval choices
-
-Consumers own behavior, keyboard shortcuts, and persistence.
-
-| Serializable choice | Meaning |
-| --- | --- |
-| `approval.run` | Run once. |
-| `approval.deny` | Deny this action. |
-| `approval.session` | Allow for this session. |
-| `approval.always` | Allow persistently where app policy permits. |
-
-## Message and tool states
-
-| Serializable state | Meaning |
-| --- | --- |
-| `message.user` | Human-authored message. |
-| `message.assistant` | Assistant-authored message. |
-| `message.system` | User-visible system or policy summary. |
-| `message.reasoning` | Reasoning summary disclosure, not hidden chain-of-thought. |
-| `message.tool` | Tool call or result summary. |
-| `message.artifact` | Artifact reference, preview, or generated-file summary. |
-| `message.source` | Source or citation reference. |
-| `message.queued` | Queued message. |
-| `message.streaming` | Partial assistant output is streaming. |
-| `message.interrupted` | Generation stopped before completion. |
-| `message.retryable` | Retry is available. |
-| `message.permission-denied` | Blocked by a user, policy, or permission. |
-| `message.fatal` | Non-recoverable message failure. |
-| `tool.pending` | Waiting to start or waiting for approval. |
-| `tool.running` | Active tool call. |
-| `tool.success` | Tool call completed successfully. |
-| `tool.warning` | Tool call completed with a warning or degraded result. |
-| `tool.error` | Tool call failed. |
-| `tool.muted` | Low-priority tool metadata. |
-
-## Layout hints and prompt glyphs
-
-Layout hints are serializable meanings, not CSS aliases:
-
-| Serializable role | Meaning |
-| --- | --- |
-| `message.spacing.compact` | Dense rows for active streams and tool trails. |
-| `message.spacing.default` | Standard chat or TUI rhythm. |
-| `message.spacing.loose` | Review, approval, or long-form summary rhythm. |
-| `message.indent.user` | User-message indent. |
-| `message.indent.assistant` | Assistant-message indent. |
-| `message.indent.tool` | Tool-trail indent. |
-| `promptGlyph.user` | Human prompt marker. |
-| `promptGlyph.assistant` | Assistant prompt marker. |
-| `promptGlyph.system` | System or notice marker. |
-| `promptGlyph.tool` | Tool-trail marker. |
-| `promptGlyph.approval` | Approval prompt marker. |
-| `promptGlyph.continuation` | Wrapped or continued-line marker. |
-
-## Serializable shape
-
-The package does not export a TUI-specific type. A consumer can mirror the
-framework-free state shape without importing React DOM components:
-
-```json
-{
-  "messageState": "message.streaming",
-  "toolState": "tool.running",
-  "approvalChoice": "approval.run",
-  "severity": "trace.info",
-  "redactedSummary": "Synthetic action summary"
-}
-```