@usetheo/ui 0.13.2 → 0.15.0

package/dist/types/chat.d.ts

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

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

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

@@ -1,28 +0,0 @@
-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/vite-plugin.d.ts

@@ -1,25 +0,0 @@
-/**
- * `@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:@theokit/ui/library-sources.css`
- *      whose contents register `@source` directives covering the library's
- *      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 `@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`.
- */
-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[];
-}
-export default function useTheoUIVite(opts?: UseTheoUIPluginOptions): Plugin;

package/dist/vite-plugin.js

@@ -1,76 +0,0 @@
-// src/vite-plugin.ts
-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 [
-      "/* @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. */",
-      ""
-    ].join("\n");
-  }
-  return `${extra.map((g) => `@source ${JSON.stringify(g)};`).join("\n")}
-`;
-}
-function useTheoUIVite(opts = {}) {
-  const wantsTailwind = opts.tailwind !== false;
-  const extra = opts.contentExtra ?? [];
-  let warned = false;
-  const warnMissingPeer = () => {
-    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 \`@theokit/ui/styles.css\` directly for the pre-built surface.`
-    );
-  };
-  return {
-    name: PLUGIN_NAME,
-    // Vite's typing for `config()` since 5.x explicitly omits `plugins` from
-    // the allowed return shape to nudge authors toward `Plugin[]` factories.
-    // The runtime still honors `{ plugins }` merge, and the TheoKit contract
-    // requires ONE Plugin object (so we can't return `Plugin[]` here).
-    // The cast keeps the public surface honest and the type-checker quiet.
-    async config(_userConfig, _env) {
-      if (!wantsTailwind) {
-        return void 0;
-      }
-      try {
-        const specifier = "@tailwindcss/vite";
-        const mod = await import(
-          /* @vite-ignore */
-          specifier
-        );
-        const factory = mod.default;
-        if (typeof factory !== "function") {
-          warnMissingPeer();
-          return void 0;
-        }
-        const tw = factory();
-        const tailwindPlugins = Array.isArray(tw) ? tw : [tw];
-        return { plugins: tailwindPlugins };
-      } catch {
-        warnMissingPeer();
-        return void 0;
-      }
-    },
-    resolveId(id) {
-      if (id === VIRTUAL_ID) {
-        return RESOLVED_VIRTUAL_ID;
-      }
-      return void 0;
-    },
-    load(id) {
-      if (id === RESOLVED_VIRTUAL_ID) {
-        return buildLibrarySourcesCss(extra);
-      }
-      return void 0;
-    }
-  };
-}
-
-export { useTheoUIVite as default };
-//# sourceMappingURL=vite-plugin.js.map
-//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

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