@nadicodeai/ui 0.6.0 → 0.8.0

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,113 @@
+// 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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,9 @@
+// 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/dist/lib/seam.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seam.d.ts","sourceRoot":"","sources":["../../src/lib/seam.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,KAAK,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEnC;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAItD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA;AAC3B,YAAY,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"seam.d.ts","sourceRoot":"","sources":["../../src/lib/seam.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,KAAK,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpC;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAItD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/lib/theme-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-mode.d.ts","sourceRoot":"","sources":["../../src/lib/theme-mode.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,sCAAuC,CAAA;AAE9D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,CAEzE"}
+{"version":3,"file":"theme-mode.d.ts","sourceRoot":"","sources":["../../src/lib/theme-mode.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,sCAAuC,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,CAEzE"}

package/dist/styles/globals.css

@@ -46,11 +46,11 @@
 }
 
 /*
- * Raw --nc-* dark remaps (state/selection/cross/chart) are generated at
- * :root.dark specificity inside the design-system theme import above; the
- * package-local copy that used to live here is gone so the generated theme
- * stays the single owner. tests/dark-token-cascade.test.ts guards the
- * resolved cascade across this file's import order.
+ * Raw --nc-* dark remaps (surface palette/state/selection/cross/chart) are
+ * generated at :root.dark specificity inside the design-system theme import
+ * above; the package-local copy that used to live here is gone so the
+ * generated theme stays the single owner. tests/guards/dark-token-cascade.test.ts
+ * guards the resolved cascade across this file's import order.
  */
 
 @theme inline {
@@ -224,7 +224,7 @@
   --nc-app-surface-elevated: var(--popover);
   --nc-app-surface-overlay: var(--popover);
   --nc-app-border: var(--border);
-  --nc-app-border-subtle: var(--nc-body);
+  --nc-app-border-subtle: var(--nc-dark-line);
   --nc-app-ring: var(--ring);
   --nc-app-text-primary: var(--foreground);
   --nc-app-text-secondary: var(--nc-cross);
@@ -233,7 +233,7 @@
   --nc-app-text-link: var(--nc-dark-cyan-soft);
   --nc-app-text-code: var(--nc-on-primary);
   --nc-app-text-placeholder: var(--nc-cross);
-  --nc-app-text-disabled: var(--nc-body);
+  --nc-app-text-disabled: var(--nc-dark-muted);
 
   --nc-chat-surface: var(--background);
   --nc-chat-user-surface: var(--primary);
@@ -242,7 +242,7 @@
   --nc-chat-tool-surface: var(--secondary);
   --nc-chat-reasoning-surface: var(--accent);
   --nc-chat-artifact-surface: var(--popover);
-  --nc-chat-inline-ref-surface: var(--nc-link-deep);
+  --nc-chat-inline-ref-surface: var(--nc-dark-link-bg-soft);
   --nc-chat-directive-command: var(--nc-dark-cyan);
   --nc-chat-directive-skill: var(--nc-dark-cyan-soft);
   --nc-chat-directive-theme: var(--nc-warning);
@@ -273,16 +273,16 @@
   --nc-status-offline: var(--nc-cross);
   --nc-status-online: var(--nc-dark-cyan-soft);
 
-  --nc-diff-added-line: var(--nc-link-deep);
+  --nc-diff-added-line: var(--nc-dark-link-bg-soft);
   --nc-diff-added-word: var(--nc-dark-cyan-soft);
   --nc-diff-removed-line: var(--nc-error-deep);
   --nc-diff-removed-word: var(--nc-error-soft);
   --nc-diff-hunk: var(--muted);
   --nc-diff-file-header: var(--muted-foreground);
-  /* --nc-primary is now green-700 (Italia contract §4); code/terminal chrome
-     must stay near-black in dark mode too, so repoint to --nc-ink instead of
-     letting the code surface render green. */
-  --nc-code-surface: var(--nc-ink);
+  /* Code/terminal chrome must stay near-black in dark mode. --nc-ink flips
+     light at :root.dark (generated surface-palette remap), so these ink-as-
+     surface aliases re-pin to the dark canvas tokens explicitly. */
+  --nc-code-surface: var(--nc-dark-canvas-soft);
   --nc-code-border: var(--nc-body);
   /* cyan family retired per Italia color contract §6. dark-cyan/-soft/-deep
      were kept unchanged in DESIGN.md specifically for this dark-mode "electric"
@@ -293,12 +293,12 @@
   --nc-code-token-comment: var(--nc-cross);
   --nc-code-token-function: var(--nc-dark-cyan-soft);
 
-  --nc-terminal-bg: var(--nc-ink);
+  --nc-terminal-bg: var(--nc-dark-canvas-soft);
   --nc-terminal-fg: var(--nc-on-primary);
   --nc-terminal-muted: var(--nc-cross);
   --nc-terminal-cursor: var(--nc-dark-cyan);
-  --nc-terminal-selection-bg: var(--nc-link-deep);
-  --nc-terminal-ansi-black: var(--nc-body);
+  --nc-terminal-selection-bg: var(--nc-dark-link-bg-soft);
+  --nc-terminal-ansi-black: var(--nc-dark-line);
   --nc-terminal-ansi-red: var(--nc-error-soft);
   --nc-terminal-ansi-green: var(--nc-dark-cyan-soft);
   --nc-terminal-ansi-yellow: var(--nc-warning);
@@ -309,7 +309,7 @@
   --nc-terminal-ansi-bright-black: var(--nc-cross);
   --nc-terminal-ansi-bright-red: var(--nc-error-soft);
   --nc-terminal-ansi-bright-green: var(--nc-dark-cyan-soft);
-  --nc-terminal-ansi-bright-yellow: var(--nc-warning-soft);
+  --nc-terminal-ansi-bright-yellow: var(--nc-warning);
   --nc-terminal-ansi-bright-blue: var(--nc-dark-cyan);
   --nc-terminal-ansi-bright-magenta: var(--nc-flag-red);
   --nc-terminal-ansi-bright-cyan: var(--nc-dark-cyan-soft);
@@ -330,6 +330,18 @@
   --nc-plugin-permission-foreground: var(--foreground);
 }
 
+/*
+ * The design-system CSS components (.nc-chat-thread, .nc-chat-bubble-*,
+ * .nc-artifact-preview, .nc-approval-gate, .nc-tool-call-trace,
+ * .nc-usage-meter, .nc-run-timeline, .nc-memory-item, .nc-handoff-banner, …)
+ * paint from the raw --nc-canvas/ink/body/line/canvas-soft/muted/warning
+ * palette. The generated theme remaps that surface palette (alongside the
+ * state/selection/cross/chart families) at :root.dark, so every nc-* CSS
+ * component is dark-correct with no per-component selector list here.
+ * Ink-as-surface aliases (code/terminal chrome) re-pin to explicit dark
+ * canvas tokens in the .dark block above, since --nc-ink flips light.
+ */
+
 [data-nc-code-block-body] {
   background-color: var(--shiki-code-block-light-bg, var(--background));
   color: var(--shiki-code-block-light-fg, var(--foreground));
@@ -340,10 +352,7 @@
     --shiki-code-block-dark-bg,
     var(--shiki-code-block-light-bg, var(--background))
   );
-  color: var(
-    --shiki-code-block-dark-fg,
-    var(--shiki-code-block-light-fg, var(--foreground))
-  );
+  color: var(--shiki-code-block-dark-fg, var(--shiki-code-block-light-fg, var(--foreground)));
 }
 
 [data-nc-code-token] {
@@ -355,14 +364,8 @@
 }
 
 .dark [data-nc-code-token] {
-  background-color: var(
-    --shiki-code-token-dark-bg,
-    var(--shiki-code-token-light-bg, transparent)
-  );
-  color: var(
-    --shiki-code-token-dark-color,
-    var(--shiki-code-token-light-color, var(--foreground))
-  );
+  background-color: var(--shiki-code-token-dark-bg, var(--shiki-code-token-light-bg, transparent));
+  color: var(--shiki-code-token-dark-color, var(--shiki-code-token-light-color, var(--foreground)));
   font-style: var(
     --shiki-code-token-dark-font-style,
     var(--shiki-code-token-light-font-style, normal)

package/docs/agent-work-surfaces.md

@@ -1,8 +1,27 @@
 # Agent Work Surfaces
 
-U6 adds presentational agent surfaces for Nadia-flavored chat, composer, approval,
-artifact, file, preview, diff, and terminal summary UI. These components render
-serializable state models and leave runtime behavior to the consuming app.
+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 come from `@nadicodeai/design-system/css`, which the consuming app
+imports alongside `@nadicodeai/ui/globals.css`.
+
+- `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
 
@@ -20,6 +39,20 @@ serializable state models and leave runtime behavior to the consuming app.
   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
 

package/docs/consuming-cross-repo.md

@@ -0,0 +1,72 @@
+# Consuming `@nadicodeai/ui` Cross-Repo
+
+This is the contract for an external repo — nadia-core, sibling Nadia web,
+desktop, or any consumer outside this monorepo — installing `@nadicodeai/ui`
+from published npm rather than the workspace source.
+
+## Version pinning
+
+Pin both packages to an exact version, never `latest` or a caret/tilde range:
+
+```bash
+npm view @nadicodeai/ui version
+npm view @nadicodeai/design-system version
+npm install @nadicodeai/design-system@<exact-version> @nadicodeai/ui@<exact-version> react@^19 react-dom@^19 tailwindcss@^4 @tailwindcss/postcss@^4
+```
+
+`@nadicodeai/ui` pins its `@nadicodeai/design-system` dependency exactly; the
+consumer's own `package.json` must match that same version for both packages.
+A version bump in either package requires re-pinning both together.
+
+## CSS import order
+
+Import order is load-bearing. Import both `@nadicodeai/design-system` CSS
+entrypoints before `@nadicodeai/ui/globals.css`: the fonts, so the
+`Geist`/`Geist Mono` `@font-face` declarations that the generated theme's
+`--font-*` roles reference are already registered, and `@nadicodeai/design-system/css`
+itself, which owns the kept `nc-*` geometry, type scale, chat CSS components,
+motion, and display components that `@nadicodeai/ui` components render
+against. `@nadicodeai/ui/globals.css` pulls in the generated theme and
+tokens but not this `nc-*` layer, so skipping it leaves package components
+unstyled:
+
+```ts
+import "@nadicodeai/design-system/assets/fonts/geist.css";
+import "@nadicodeai/design-system/css";
+import "@nadicodeai/ui/globals.css";
+```
+
+Both `@nadicodeai/design-system` and `@nadicodeai/ui` are required
+dependencies of every consumer, not just `@nadicodeai/ui` — see the version
+pinning section above.
+
+## Tailwind v4 source scanning
+
+Tailwind v4's automatic content detection does not scan `node_modules`. Add an
+explicit `@source` directive in the consumer's Tailwind entry CSS (wherever
+`@import "tailwindcss"` lives) pointing at the package's built `dist`:
+
+```css
+@source "../node_modules/@nadicodeai/ui/dist";
+```
+
+Adjust the relative path to match the consumer's directory depth from its
+Tailwind entry file to `node_modules`.
+
+## Base UI API breaks (migrating from Radix-era components)
+
+`@nadicodeai/ui@0.5.0+` is Base UI only; the Radix-era compatibility layer is
+gone. Full catalog and rationale: `docs/migration/base-ui-migration.md`. What
+a consumer actually hits when porting call sites:
+
+- No `asChild`. Use Base UI's `render` prop; when the rendered element isn't
+  a native `<button>`, also pass `nativeButton={false}`.
+- Menu items (`DropdownMenuItem`, `ContextMenuItem`, `MenubarItem`) use
+  `onClick`, not `onSelect`.
+- State attributes are `data-checked`/`data-unchecked` and
+  `data-open`/`data-closed`, not a single `data-state` value.
+- `Accordion` and `ToggleGroup` values are always arrays — pass `multiple`
+  for multi-select instead of `type="single" | "multiple"`.
+- `TooltipProvider` takes `delay`, not `delayDuration`.
+- Disclosure panels (`CollapsibleContent`, etc.) take `keepMounted`, not
+  `forceMount`.

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

@@ -0,0 +1,29 @@
+# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/ui",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -19,6 +19,18 @@
       "types": "./dist/ai-elements.d.ts",
       "import": "./dist/ai-elements.js"
     },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js"
+    },
+    "./lib/agent-contracts": {
+      "types": "./dist/lib/agent-contracts.d.ts",
+      "import": "./dist/lib/agent-contracts.js"
+    },
+    "./lib/agent-state": {
+      "types": "./dist/lib/agent-state.d.ts",
+      "import": "./dist/lib/agent-state.js"
+    },
     "./lib/utils": {
       "types": "./dist/lib/utils.d.ts",
       "import": "./dist/lib/utils.js"
@@ -51,7 +63,7 @@
   },
   "dependencies": {
     "@base-ui/react": "^1.6.0",
-    "@nadicodeai/design-system": "0.6.0",
+    "@nadicodeai/design-system": "0.8.0",
     "@rive-app/react-webgl2": "^4.29.1",
     "@streamdown/cjk": "^1.0.3",
     "@streamdown/code": "^1.1.1",