@usetheo/ui 0.13.0 → 0.13.1

package/dist/types/chat.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Chat message types — structurally compatible with `vercel/ai` `UIMessage`.
+ *
+ * Verbatim of the part-type shape from `packages/ai/src/ui/ui-messages.ts`
+ * (Apache-2.0, copyright Vercel Inc., see NOTICE). Re-declared standalone so
+ * `@theokit/ui` does not take `ai` as a direct dependency — the goal is
+ * interop without coupling.
+ *
+ * Consumer code using `useChat()` from `@ai-sdk/react`:
+ *
+ *   const { messages } = useChat();
+ *   return messages.map((m) => <ChatMessage message={m} />);
+ *
+ * Works because the Vercel `UIMessage` shape is structurally assignable to
+ * the types declared here.
+ */
+export type MessageRole = "system" | "user" | "assistant";
+/**
+ * Orthogonal attachment shape used by `<AttachmentChip>` and chat composer
+ * primitives. Distinct from `FileUIPart` (which is part of the message
+ * payload) — `Attachment` is the consumer's pending-upload state.
+ */
+export interface Attachment {
+    id: string;
+    name: string;
+    size?: string;
+    type?: string;
+}
+export type ProviderMetadata = Record<string, Record<string, unknown>>;
+/**
+ * A text part of a message.
+ */
+export interface TextUIPart {
+    type: "text";
+    text: string;
+    /** "streaming" while tokens arrive; "done" when complete. */
+    state?: "streaming" | "done";
+    providerMetadata?: ProviderMetadata;
+}
+/**
+ * A reasoning ("thinking") part of a message — typically rendered as a
+ * collapsible panel.
+ */
+export interface ReasoningUIPart {
+    type: "reasoning";
+    text: string;
+    state?: "streaming" | "done";
+    providerMetadata?: ProviderMetadata;
+}
+/**
+ * A file part of a message (image, document, audio, video).
+ */
+export interface FileUIPart {
+    type: "file";
+    /**
+     * IANA media type (e.g. `image/png`) or top-level segment (e.g. `image`).
+     */
+    mediaType: string;
+    filename?: string;
+    /** URL or data: URL. */
+    url: string;
+    providerMetadata?: ProviderMetadata;
+}
+/**
+ * A file emitted as part of a reasoning trace (e.g. internal scratchpad).
+ */
+export interface ReasoningFileUIPart {
+    type: "reasoning-file";
+    mediaType: string;
+    url: string;
+    providerMetadata?: ProviderMetadata;
+}
+/**
+ * A URL source citation.
+ */
+export interface SourceUrlUIPart {
+    type: "source-url";
+    sourceId: string;
+    url: string;
+    title?: string;
+    providerMetadata?: ProviderMetadata;
+}
+/**
+ * A document source citation.
+ */
+export interface SourceDocumentUIPart {
+    type: "source-document";
+    sourceId: string;
+    mediaType: string;
+    title: string;
+    filename?: string;
+    providerMetadata?: ProviderMetadata;
+}
+/**
+ * A step boundary marker — used to delimit multi-step agent responses.
+ */
+export interface StepStartUIPart {
+    type: "step-start";
+}
+/**
+ * A provider-specific custom content part.
+ */
+export interface CustomContentUIPart {
+    type: "custom";
+    /** Format: `${provider}.${providerType}`. */
+    kind: `${string}.${string}`;
+    providerMetadata?: ProviderMetadata;
+}
+export type ToolInvocationState = "input-streaming" | "input-available" | "approval-requested" | "approval-responded" | "output-available" | "output-error" | "output-denied";
+/**
+ * A tool invocation part — covers both static (typed) and dynamic tools via
+ * the `dynamic-tool` discriminator. The `type` field follows the Vercel
+ * convention: `tool-${toolName}` for static, `dynamic-tool` for runtime.
+ */
+export interface ToolUIPart {
+    /** `tool-${toolName}` (static) or `dynamic-tool` (runtime). */
+    type: `tool-${string}` | "dynamic-tool";
+    toolCallId: string;
+    toolName?: string;
+    title?: string;
+    state: ToolInvocationState;
+    input?: unknown;
+    output?: unknown;
+    errorText?: string;
+    providerExecuted?: boolean;
+    callProviderMetadata?: ProviderMetadata;
+    resultProviderMetadata?: ProviderMetadata;
+    approval?: {
+        id: string;
+        approved?: boolean;
+        reason?: string;
+        isAutomatic?: boolean;
+    };
+}
+/**
+ * A data part — typed custom application state. The `type` field follows
+ * `data-${name}` and `data` carries the payload. Consumers register a
+ * renderer per `data-${name}` via the `<ChatMessage>` `dataRenderers` prop.
+ */
+export interface DataUIPart {
+    /** `data-${name}` */
+    type: `data-${string}`;
+    id?: string;
+    data: unknown;
+}
+export type UIMessagePart = TextUIPart | ReasoningUIPart | FileUIPart | ReasoningFileUIPart | SourceUrlUIPart | SourceDocumentUIPart | StepStartUIPart | CustomContentUIPart | ToolUIPart | DataUIPart;
+export declare function isTextUIPart(part: UIMessagePart): part is TextUIPart;
+export declare function isReasoningUIPart(part: UIMessagePart): part is ReasoningUIPart;
+export declare function isFileUIPart(part: UIMessagePart): part is FileUIPart;
+export declare function isReasoningFileUIPart(part: UIMessagePart): part is ReasoningFileUIPart;
+export declare function isSourceUrlUIPart(part: UIMessagePart): part is SourceUrlUIPart;
+export declare function isSourceDocumentUIPart(part: UIMessagePart): part is SourceDocumentUIPart;
+export declare function isStepStartUIPart(part: UIMessagePart): part is StepStartUIPart;
+export declare function isCustomContentUIPart(part: UIMessagePart): part is CustomContentUIPart;
+export declare function isToolUIPart(part: UIMessagePart): part is ToolUIPart;
+export declare function isDataUIPart(part: UIMessagePart): part is DataUIPart;
+/**
+ * A chat message in UI form.
+ *
+ * Field-for-field compatible with `UIMessage` from `vercel/ai` (the AI SDK's
+ * `useChat()` return type) — a consumer's `useChat()` messages flow into
+ * `<ChatMessage message={msg} />` with zero adapter.
+ *
+ * `metadata` is opaque (`unknown`) so consumers can attach arbitrary fields
+ * (timestamps, model identifiers, request IDs, …) without our type
+ * dictating shape.
+ */
+export interface UIMessage {
+    id: string;
+    role: MessageRole;
+    parts: UIMessagePart[];
+    metadata?: unknown;
+}

package/dist/types/mode.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Mode — top-level density / domain the agent session is operating in.
+ *
+ * `chat`  — conversational Q&A, lean UI.
+ * `code`  — code agent: read/plan/edit/verify inside the repo.
+ * `infra` — operate the deployed system: metrics, deploys, logs, rollback.
+ *
+ * Used everywhere resources can be scoped per-mode (Skills, Agents, Rules,
+ * SystemPrompt overrides, Sessions, …). `modes?: Mode[]` on a resource means
+ * "only available in these modes"; omitting `modes` means "available
+ * globally".
+ */
+export type Mode = "chat" | "code" | "infra";
+export declare const ALL_MODES: ReadonlyArray<Mode>;
+/** Friendly label per mode — render in chips, headers, badges. */
+export declare const MODE_LABEL: Record<Mode, string>;

package/dist/types/permission.d.ts

@@ -0,0 +1,8 @@
+export type PermissionOperation = "read" | "write" | "delete";
+export type PermissionDecision = "denied" | "allowed_once" | "always_allowed";
+export interface PermissionRequest {
+    /** Absolute path to the resource (file or folder). */
+    path: string;
+    /** Operations the agent wants to perform on the resource. */
+    operations: PermissionOperation[];
+}

package/dist/types/rule.d.ts

@@ -0,0 +1,28 @@
+import type { Mode } from "./mode.js";
+/**
+ * Rule — a user-authored behavior instruction injected into the system prompt.
+ *
+ * Equivalent to a single markdown file under `.claude/rules/` in Claude Code:
+ * short imperative text the user writes once and the agent follows always.
+ * Rules can be scoped (`global` = applies to every session; `project` = only
+ * inside the current workspace) and toggled on/off without deletion.
+ */
+export type RuleScope = "global" | "project";
+export type RuleState = "enabled" | "disabled";
+export interface Rule {
+    id: string;
+    /** Short title shown in the list. */
+    title: string;
+    /** Markdown body — the actual instruction injected into the prompt. */
+    body: string;
+    /** Where this rule applies. */
+    scope: RuleScope;
+    /** Whether the rule is currently active. */
+    state: RuleState;
+    /** Optional tags for grouping ("testing", "style", "security"). */
+    tags?: string[];
+    /** Modes this rule applies to. Omit / empty = global (every mode). */
+    modes?: Mode[];
+    /** ISO timestamp / friendly label of last edit. */
+    updatedAt?: string;
+}

package/dist/types/task.d.ts

@@ -0,0 +1,9 @@
+export type TaskStatus = "idle" | "permission_required" | "starting" | "running" | "verifying" | "completed" | "failed";
+export type TaskStepStatus = "pending" | "running" | "done" | "skipped";
+export interface TaskStep {
+    id: string;
+    label: string;
+    status: TaskStepStatus;
+    /** 0..1 progress for in-flight steps. */
+    progress?: number;
+}

package/dist/vite-plugin.d.ts

@@ -1,29 +1,25 @@
-import { Plugin } from 'vite';
-
 /**
- * `@usetheo/ui/vite-plugin` — auto-wire Tailwind v4 for consumers.
+ * `@theokit/ui/vite-plugin` — auto-wire Tailwind v4 for consumers.
  *
  * Default export is a factory returning ONE Vite Plugin. Internally:
  *   1. chains `@tailwindcss/vite` v4 via the `config()` hook when resolvable
  *      and `opts.tailwind !== false`,
- *   2. exposes a virtual module `virtual:@usetheo/ui/library-sources.css`
+ *   2. exposes a virtual module `virtual:@theokit/ui/library-sources.css`
  *      whose contents register `@source` directives covering the library's
- *      published files, so consumer-side Tailwind scans `@usetheo/ui` JSX
+ *      published files, so consumer-side Tailwind scans `@theokit/ui` JSX
  *      and emits its utility classes,
  *   3. degrades gracefully via `console.warn` (never throws) when
  *      `@tailwindcss/vite` is not installed — the surface stays usable in
- *      CSS-only mode via the pre-built `@usetheo/ui/styles.css` subpath.
+ *      CSS-only mode via the pre-built `@theokit/ui/styles.css` subpath.
  *
  * This is the cross-repo contract TheoKit's `integrateUseTheoUI()` probes
  * for. See `docs/rfcs/0008-vite-plugin-and-preset.md`.
  */
-
-interface UseTheoUIPluginOptions {
+import type { Plugin } from "vite";
+export interface UseTheoUIPluginOptions {
     /** Disable Tailwind v4 auto-chain. Default: `true`. */
     tailwind?: boolean;
     /** Extra `@source` globs merged into the library defaults. */
     contentExtra?: string[];
 }
-declare function useTheoUIVite(opts?: UseTheoUIPluginOptions): Plugin;
-
-export { type UseTheoUIPluginOptions, useTheoUIVite as default };
+export default function useTheoUIVite(opts?: UseTheoUIPluginOptions): Plugin;

package/dist/vite-plugin.js

@@ -1,11 +1,11 @@
 // src/vite-plugin.ts
-var PLUGIN_NAME = "@usetheo/ui/vite-plugin";
-var VIRTUAL_ID = "virtual:@usetheo/ui/library-sources.css";
+var PLUGIN_NAME = "@theokit/ui/vite-plugin";
+var VIRTUAL_ID = "virtual:@theokit/ui/library-sources.css";
 var RESOLVED_VIRTUAL_ID = `\0${VIRTUAL_ID}`;
 function buildLibrarySourcesCss(extra = []) {
   if (extra.length === 0) {
     return [
-      "/* @usetheo/ui/vite-plugin \u2014 `virtual:@usetheo/ui/library-sources.css` */",
+      "/* @theokit/ui/vite-plugin \u2014 `virtual:@theokit/ui/library-sources.css` */",
       "/* The library now ships pre-compiled utility CSS via `dist/components.css` */",
       "/* (chained from `dist/styles.css`), so no `@source` glob is needed here. */",
       "/* This virtual module remains resolvable for backwards compatibility. */",
@@ -23,7 +23,7 @@ function useTheoUIVite(opts = {}) {
     if (warned) return;
     warned = true;
     console.warn(
-      `[${PLUGIN_NAME}] @tailwindcss/vite was not resolvable; falling back to CSS-only mode. Install \`@tailwindcss/vite@^4\` to get the utility-driven design tokens, or import \`@usetheo/ui/styles.css\` directly for the pre-built surface.`
+      `[${PLUGIN_NAME}] @tailwindcss/vite was not resolvable; falling back to CSS-only mode. Install \`@tailwindcss/vite@^4\` to get the utility-driven design tokens, or import \`@theokit/ui/styles.css\` directly for the pre-built surface.`
     );
   };
   return {

package/dist/vite-plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vite-plugin.ts"],"names":[],"mappings":";AA0BA,IAAM,WAAA,GAAc,yBAAA;AACpB,IAAM,UAAA,GAAa,yCAAA;AACnB,IAAM,mBAAA,GAAsB,KAAK,UAAU,CAAA,CAAA;AAE3C,SAAS,sBAAA,CAAuB,KAAA,GAAkB,EAAC,EAAW;AAuB5D,EAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AACtB,IAAA,OAAO;AAAA,MACL,gFAAA;AAAA,MACA,gFAAA;AAAA,MACA,8EAAA;AAAA,MACA,2EAAA;AAAA,MACA;AAAA,KACF,CAAE,KAAK,IAAI,CAAA;AAAA,EACb;AACA,EAAA,OAAO,CAAA,EAAG,KAAA,CAAM,GAAA,CAAI,CAAC,MAAM,CAAA,QAAA,EAAW,IAAA,CAAK,SAAA,CAAU,CAAC,CAAC,CAAA,CAAA,CAAG,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC;AAAA,CAAA;AACxE;AAEe,SAAR,aAAA,CAA+B,IAAA,GAA+B,EAAC,EAAW;AAC/E,EAAA,MAAM,aAAA,GAAgB,KAAK,QAAA,KAAa,KAAA;AACxC,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,YAAA,IAAgB,EAAC;AAEpC,EAAA,IAAI,MAAA,GAAS,KAAA;AACb,EAAA,MAAM,kBAAkB,MAAY;AAClC,IAAA,IAAI,MAAA,EAAQ;AACZ,IAAA,MAAA,GAAS,IAAA;AAET,IAAA,OAAA,CAAQ,IAAA;AAAA,MACN,IAAI,WAAW,CAAA,yNAAA;AAAA,KACjB;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,WAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAON,MAAM,MAAA,CAAO,WAAA,EAAa,IAAA,EAAwD;AAChF,MAAA,IAAI,CAAC,aAAA,EAAe;AAClB,QAAA,OAAO,MAAA;AAAA,MACT;AAEA,MAAA,IAAI;AAKF,QAAA,MAAM,SAAA,GAAY,mBAAA;AAClB,QAAA,MAAM,MAAM,MAAM;AAAA;AAAA,UAA0B;AAAA,SAAA;AAC5C,QAAA,MAAM,UAAW,GAAA,CAA8B,OAAA;AAC/C,QAAA,IAAI,OAAO,YAAY,UAAA,EAAY;AACjC,UAAA,eAAA,EAAgB;AAChB,UAAA,OAAO,KAAA,CAAA;AAAA,QACT;AACA,QAAA,MAAM,KAAM,OAAA,EAAoC;AAChD,QAAA,MAAM,kBAAkB,KAAA,CAAM,OAAA,CAAQ,EAAE,CAAA,GAAI,EAAA,GAAK,CAAC,EAAE,CAAA;AACpD,QAAA,OAAO,EAAE,SAAS,eAAA,EAAgB;AAAA,MACpC,CAAA,CAAA,MAAQ;AACN,QAAA,eAAA,EAAgB;AAChB,QAAA,OAAO,MAAA;AAAA,MACT;AAAA,IACF,CAAA;AAAA,IAEA,UAAU,EAAA,EAAI;AACZ,MAAA,IAAI,OAAO,UAAA,EAAY;AACrB,QAAA,OAAO,mBAAA;AAAA,MACT;AACA,MAAA,OAAO,MAAA;AAAA,IACT,CAAA;AAAA,IAEA,KAAK,EAAA,EAAI;AACP,MAAA,IAAI,OAAO,mBAAA,EAAqB;AAC9B,QAAA,OAAO,uBAAuB,KAAK,CAAA;AAAA,MACrC;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,GACF;AACF","file":"vite-plugin.js","sourcesContent":["/**\n * `@usetheo/ui/vite-plugin` — auto-wire Tailwind v4 for consumers.\n *\n * Default export is a factory returning ONE Vite Plugin. Internally:\n *   1. chains `@tailwindcss/vite` v4 via the `config()` hook when resolvable\n *      and `opts.tailwind !== false`,\n *   2. exposes a virtual module `virtual:@usetheo/ui/library-sources.css`\n *      whose contents register `@source` directives covering the library's\n *      published files, so consumer-side Tailwind scans `@usetheo/ui` JSX\n *      and emits its utility classes,\n *   3. degrades gracefully via `console.warn` (never throws) when\n *      `@tailwindcss/vite` is not installed — the surface stays usable in\n *      CSS-only mode via the pre-built `@usetheo/ui/styles.css` subpath.\n *\n * This is the cross-repo contract TheoKit's `integrateUseTheoUI()` probes\n * for. See `docs/rfcs/0008-vite-plugin-and-preset.md`.\n */\nimport type { Plugin, UserConfig } from \"vite\";\n\nexport interface UseTheoUIPluginOptions {\n  /** Disable Tailwind v4 auto-chain. Default: `true`. */\n  tailwind?: boolean;\n  /** Extra `@source` globs merged into the library defaults. */\n  contentExtra?: string[];\n}\n\nconst PLUGIN_NAME = \"@usetheo/ui/vite-plugin\";\nconst VIRTUAL_ID = \"virtual:@usetheo/ui/library-sources.css\";\nconst RESOLVED_VIRTUAL_ID = `\\0${VIRTUAL_ID}`;\n\nfunction buildLibrarySourcesCss(extra: string[] = []): string {\n  // RFC 0008 follow-up #2 (0.6.1-next.0):\n  // The previous implementation emitted `@source` globs pointing at\n  // `node_modules/@usetheo/ui/dist/**/*.{js,mjs,cjs}` so Tailwind v4 would\n  // scan the library's published JS for utility classes. Under pnpm,\n  // `node_modules/@usetheo/ui` is a symlink to a deep `.pnpm` directory\n  // and Tailwind v4's tinyglobby scanner does NOT follow symlinks — the\n  // glob expanded to zero matches and the consumer saw flat-rendered\n  // components (no hover/focus/active variants emitted).\n  //\n  // The fix lives entirely on the library side: `dist/styles.css` now\n  // chains `@import \"./components.css\"`, a pre-compiled CSS file built\n  // by `scripts/build-precompiled-css.ts` containing the materialized\n  // utility rules for every class the library uses. Consumers get every\n  // variant for free with a single `@import \"@usetheo/ui/styles.css\"` —\n  // no filesystem scanning, no symlink dependency.\n  //\n  // The virtual module below is retained for backwards compatibility\n  // (TheoKit's earlier integration code may still resolve it) but it\n  // now emits ONLY the optional consumer-supplied `contentExtra` globs.\n  // The library-side default globs are gone — pre-compiled CSS replaces\n  // them. Returning empty (`extra = []`) is safe; Tailwind v4 ignores\n  // empty CSS.\n  if (extra.length === 0) {\n    return [\n      \"/* @usetheo/ui/vite-plugin — `virtual:@usetheo/ui/library-sources.css` */\",\n      \"/* The library now ships pre-compiled utility CSS via `dist/components.css` */\",\n      \"/* (chained from `dist/styles.css`), so no `@source` glob is needed here. */\",\n      \"/* This virtual module remains resolvable for backwards compatibility. */\",\n      \"\",\n    ].join(\"\\n\");\n  }\n  return `${extra.map((g) => `@source ${JSON.stringify(g)};`).join(\"\\n\")}\\n`;\n}\n\nexport default function useTheoUIVite(opts: UseTheoUIPluginOptions = {}): Plugin {\n  const wantsTailwind = opts.tailwind !== false;\n  const extra = opts.contentExtra ?? [];\n\n  let warned = false;\n  const warnMissingPeer = (): void => {\n    if (warned) return;\n    warned = true;\n    // biome-ignore lint/suspicious/noConsole: TheoKit cross-repo contract requires `console.warn` (not throw) when the optional `@tailwindcss/vite` peer is missing. See RFC 0008 §3 D1.\n    console.warn(\n      `[${PLUGIN_NAME}] @tailwindcss/vite was not resolvable; falling back to CSS-only mode. Install \\`@tailwindcss/vite@^4\\` to get the utility-driven design tokens, or import \\`@usetheo/ui/styles.css\\` directly for the pre-built surface.`,\n    );\n  };\n\n  return {\n    name: PLUGIN_NAME,\n\n    // Vite's typing for `config()` since 5.x explicitly omits `plugins` from\n    // the allowed return shape to nudge authors toward `Plugin[]` factories.\n    // The runtime still honors `{ plugins }` merge, and the TheoKit contract\n    // requires ONE Plugin object (so we can't return `Plugin[]` here).\n    // The cast keeps the public surface honest and the type-checker quiet.\n    async config(_userConfig, _env): Promise<Omit<UserConfig, \"plugins\"> | undefined> {\n      if (!wantsTailwind) {\n        return undefined;\n      }\n\n      try {\n        // Dynamic import keeps `@tailwindcss/vite` as an OPTIONAL peer. The\n        // specifier is held in a variable so Vite's import-analysis pass\n        // leaves it alone — at runtime the consumer's resolver does the\n        // actual resolution. Resolution failure must not crash the build.\n        const specifier = \"@tailwindcss/vite\";\n        const mod = await import(/* @vite-ignore */ specifier);\n        const factory = (mod as { default?: unknown }).default;\n        if (typeof factory !== \"function\") {\n          warnMissingPeer();\n          return undefined;\n        }\n        const tw = (factory as () => Plugin | Plugin[])();\n        const tailwindPlugins = Array.isArray(tw) ? tw : [tw];\n        return { plugins: tailwindPlugins } as unknown as Omit<UserConfig, \"plugins\">;\n      } catch {\n        warnMissingPeer();\n        return undefined;\n      }\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_ID) {\n        return RESOLVED_VIRTUAL_ID;\n      }\n      return undefined;\n    },\n\n    load(id) {\n      if (id === RESOLVED_VIRTUAL_ID) {\n        return buildLibrarySourcesCss(extra);\n      }\n      return undefined;\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../src/vite-plugin.ts"],"names":[],"mappings":";AA0BA,IAAM,WAAA,GAAc,yBAAA;AACpB,IAAM,UAAA,GAAa,yCAAA;AACnB,IAAM,mBAAA,GAAsB,KAAK,UAAU,CAAA,CAAA;AAE3C,SAAS,sBAAA,CAAuB,KAAA,GAAkB,EAAC,EAAW;AAuB5D,EAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AACtB,IAAA,OAAO;AAAA,MACL,gFAAA;AAAA,MACA,gFAAA;AAAA,MACA,8EAAA;AAAA,MACA,2EAAA;AAAA,MACA;AAAA,KACF,CAAE,KAAK,IAAI,CAAA;AAAA,EACb;AACA,EAAA,OAAO,CAAA,EAAG,KAAA,CAAM,GAAA,CAAI,CAAC,MAAM,CAAA,QAAA,EAAW,IAAA,CAAK,SAAA,CAAU,CAAC,CAAC,CAAA,CAAA,CAAG,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC;AAAA,CAAA;AACxE;AAEe,SAAR,aAAA,CAA+B,IAAA,GAA+B,EAAC,EAAW;AAC/E,EAAA,MAAM,aAAA,GAAgB,KAAK,QAAA,KAAa,KAAA;AACxC,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,YAAA,IAAgB,EAAC;AAEpC,EAAA,IAAI,MAAA,GAAS,KAAA;AACb,EAAA,MAAM,kBAAkB,MAAY;AAClC,IAAA,IAAI,MAAA,EAAQ;AACZ,IAAA,MAAA,GAAS,IAAA;AAET,IAAA,OAAA,CAAQ,IAAA;AAAA,MACN,IAAI,WAAW,CAAA,yNAAA;AAAA,KACjB;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,WAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAON,MAAM,MAAA,CAAO,WAAA,EAAa,IAAA,EAAwD;AAChF,MAAA,IAAI,CAAC,aAAA,EAAe;AAClB,QAAA,OAAO,MAAA;AAAA,MACT;AAEA,MAAA,IAAI;AAKF,QAAA,MAAM,SAAA,GAAY,mBAAA;AAClB,QAAA,MAAM,MAAM,MAAM;AAAA;AAAA,UAA0B;AAAA,SAAA;AAC5C,QAAA,MAAM,UAAW,GAAA,CAA8B,OAAA;AAC/C,QAAA,IAAI,OAAO,YAAY,UAAA,EAAY;AACjC,UAAA,eAAA,EAAgB;AAChB,UAAA,OAAO,KAAA,CAAA;AAAA,QACT;AACA,QAAA,MAAM,KAAM,OAAA,EAAoC;AAChD,QAAA,MAAM,kBAAkB,KAAA,CAAM,OAAA,CAAQ,EAAE,CAAA,GAAI,EAAA,GAAK,CAAC,EAAE,CAAA;AACpD,QAAA,OAAO,EAAE,SAAS,eAAA,EAAgB;AAAA,MACpC,CAAA,CAAA,MAAQ;AACN,QAAA,eAAA,EAAgB;AAChB,QAAA,OAAO,MAAA;AAAA,MACT;AAAA,IACF,CAAA;AAAA,IAEA,UAAU,EAAA,EAAI;AACZ,MAAA,IAAI,OAAO,UAAA,EAAY;AACrB,QAAA,OAAO,mBAAA;AAAA,MACT;AACA,MAAA,OAAO,MAAA;AAAA,IACT,CAAA;AAAA,IAEA,KAAK,EAAA,EAAI;AACP,MAAA,IAAI,OAAO,mBAAA,EAAqB;AAC9B,QAAA,OAAO,uBAAuB,KAAK,CAAA;AAAA,MACrC;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,GACF;AACF","file":"vite-plugin.js","sourcesContent":["/**\n * `@theokit/ui/vite-plugin` — auto-wire Tailwind v4 for consumers.\n *\n * Default export is a factory returning ONE Vite Plugin. Internally:\n *   1. chains `@tailwindcss/vite` v4 via the `config()` hook when resolvable\n *      and `opts.tailwind !== false`,\n *   2. exposes a virtual module `virtual:@theokit/ui/library-sources.css`\n *      whose contents register `@source` directives covering the library's\n *      published files, so consumer-side Tailwind scans `@theokit/ui` JSX\n *      and emits its utility classes,\n *   3. degrades gracefully via `console.warn` (never throws) when\n *      `@tailwindcss/vite` is not installed — the surface stays usable in\n *      CSS-only mode via the pre-built `@theokit/ui/styles.css` subpath.\n *\n * This is the cross-repo contract TheoKit's `integrateUseTheoUI()` probes\n * for. See `docs/rfcs/0008-vite-plugin-and-preset.md`.\n */\nimport type { Plugin, UserConfig } from \"vite\";\n\nexport interface UseTheoUIPluginOptions {\n  /** Disable Tailwind v4 auto-chain. Default: `true`. */\n  tailwind?: boolean;\n  /** Extra `@source` globs merged into the library defaults. */\n  contentExtra?: string[];\n}\n\nconst PLUGIN_NAME = \"@theokit/ui/vite-plugin\";\nconst VIRTUAL_ID = \"virtual:@theokit/ui/library-sources.css\";\nconst RESOLVED_VIRTUAL_ID = `\\0${VIRTUAL_ID}`;\n\nfunction buildLibrarySourcesCss(extra: string[] = []): string {\n  // RFC 0008 follow-up #2 (0.6.1-next.0):\n  // The previous implementation emitted `@source` globs pointing at\n  // `node_modules/@theokit/ui/dist/**/*.{js,mjs,cjs}` so Tailwind v4 would\n  // scan the library's published JS for utility classes. Under pnpm,\n  // `node_modules/@theokit/ui` is a symlink to a deep `.pnpm` directory\n  // and Tailwind v4's tinyglobby scanner does NOT follow symlinks — the\n  // glob expanded to zero matches and the consumer saw flat-rendered\n  // components (no hover/focus/active variants emitted).\n  //\n  // The fix lives entirely on the library side: `dist/styles.css` now\n  // chains `@import \"./components.css\"`, a pre-compiled CSS file built\n  // by `scripts/build-precompiled-css.ts` containing the materialized\n  // utility rules for every class the library uses. Consumers get every\n  // variant for free with a single `@import \"@theokit/ui/styles.css\"` —\n  // no filesystem scanning, no symlink dependency.\n  //\n  // The virtual module below is retained for backwards compatibility\n  // (TheoKit's earlier integration code may still resolve it) but it\n  // now emits ONLY the optional consumer-supplied `contentExtra` globs.\n  // The library-side default globs are gone — pre-compiled CSS replaces\n  // them. Returning empty (`extra = []`) is safe; Tailwind v4 ignores\n  // empty CSS.\n  if (extra.length === 0) {\n    return [\n      \"/* @theokit/ui/vite-plugin — `virtual:@theokit/ui/library-sources.css` */\",\n      \"/* The library now ships pre-compiled utility CSS via `dist/components.css` */\",\n      \"/* (chained from `dist/styles.css`), so no `@source` glob is needed here. */\",\n      \"/* This virtual module remains resolvable for backwards compatibility. */\",\n      \"\",\n    ].join(\"\\n\");\n  }\n  return `${extra.map((g) => `@source ${JSON.stringify(g)};`).join(\"\\n\")}\\n`;\n}\n\nexport default function useTheoUIVite(opts: UseTheoUIPluginOptions = {}): Plugin {\n  const wantsTailwind = opts.tailwind !== false;\n  const extra = opts.contentExtra ?? [];\n\n  let warned = false;\n  const warnMissingPeer = (): void => {\n    if (warned) return;\n    warned = true;\n    // biome-ignore lint/suspicious/noConsole: TheoKit cross-repo contract requires `console.warn` (not throw) when the optional `@tailwindcss/vite` peer is missing. See RFC 0008 §3 D1.\n    console.warn(\n      `[${PLUGIN_NAME}] @tailwindcss/vite was not resolvable; falling back to CSS-only mode. Install \\`@tailwindcss/vite@^4\\` to get the utility-driven design tokens, or import \\`@theokit/ui/styles.css\\` directly for the pre-built surface.`,\n    );\n  };\n\n  return {\n    name: PLUGIN_NAME,\n\n    // Vite's typing for `config()` since 5.x explicitly omits `plugins` from\n    // the allowed return shape to nudge authors toward `Plugin[]` factories.\n    // The runtime still honors `{ plugins }` merge, and the TheoKit contract\n    // requires ONE Plugin object (so we can't return `Plugin[]` here).\n    // The cast keeps the public surface honest and the type-checker quiet.\n    async config(_userConfig, _env): Promise<Omit<UserConfig, \"plugins\"> | undefined> {\n      if (!wantsTailwind) {\n        return undefined;\n      }\n\n      try {\n        // Dynamic import keeps `@tailwindcss/vite` as an OPTIONAL peer. The\n        // specifier is held in a variable so Vite's import-analysis pass\n        // leaves it alone — at runtime the consumer's resolver does the\n        // actual resolution. Resolution failure must not crash the build.\n        const specifier = \"@tailwindcss/vite\";\n        const mod = await import(/* @vite-ignore */ specifier);\n        const factory = (mod as { default?: unknown }).default;\n        if (typeof factory !== \"function\") {\n          warnMissingPeer();\n          return undefined;\n        }\n        const tw = (factory as () => Plugin | Plugin[])();\n        const tailwindPlugins = Array.isArray(tw) ? tw : [tw];\n        return { plugins: tailwindPlugins } as unknown as Omit<UserConfig, \"plugins\">;\n      } catch {\n        warnMissingPeer();\n        return undefined;\n      }\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_ID) {\n        return RESOLVED_VIRTUAL_ID;\n      }\n      return undefined;\n    },\n\n    load(id) {\n      if (id === RESOLVED_VIRTUAL_ID) {\n        return buildLibrarySourcesCss(extra);\n      }\n      return undefined;\n    },\n  };\n}\n"]}

package/dist/whiteboard/index.js

@@ -1,3 +1,4 @@
+"use client";
 import { useMemo, useEffect, useRef, useState, useCallback } from 'react';
 import rough from 'roughjs';
 import { getStroke } from 'perfect-freehand';
@@ -220,6 +221,7 @@ function Label({ cx, cy, label, stroke }) {
   return /* @__PURE__ */ jsx(
     "text",
     {
+      "data-slot": "label",
       x: cx,
       y: cy,
       textAnchor: "middle",
@@ -703,6 +705,7 @@ function Whiteboard({
   return /* @__PURE__ */ jsxs(
     "svg",
     {
+      "data-slot": "whiteboard",
       ref: svgRef,
       viewBox: viewport.viewBox({ width: sceneWidth, height: sceneHeight }),
       width: sceneWidth,