@theokit/ui 0.13.0

package/dist/tokens.css

@@ -0,0 +1,230 @@
+/* Theo UI — Design System "Violet Forge" tokens.
+ *
+ * Tokens normativos. Não edite valores aqui sem revisão do design system.
+ * Referência: docs/design-system.md
+ *
+ * Estratégia:
+ *   - CSS custom properties para todas as cores, scales e durations.
+ *   - Default é light. Dark é ativado via [data-theme="dark"] ou .dark.
+ *   - HSL split (h s l) em vez de hex permite alpha via color-mix() ou hsl(var(--x) / .5).
+ *
+ * Roxo Theo: #7C3AED  →  hsl(262 83% 58%)
+ * Burnt sienna:  #C96442  →  hsl(15 54% 53%)
+ */
+
+/* `:root` and `[data-theme="dark"]` declarations are intentionally NOT wrapped
+ * in `@layer base` so they apply at the document level regardless of whether
+ * the consumer's CSS pipeline runs Tailwind's preflight. The texture utilities
+ * below remain in `@layer utilities` because that layer affects ordering only,
+ * not the cascade root.
+ */
+:root {
+  /* Base palette ------------------------------------------------------- *
+     * Neutrals are 100% desaturated (Vercel-style). Color comes from the
+     * primary (violet) + accent (burnt sienna) tokens below — never from
+     * surface tints.
+     */
+  --background: 0 0% 100%; /* #FFFFFF */
+  --foreground: 0 0% 4%; /* #0A0A0A */
+
+  --card: 0 0% 100%; /* #FFFFFF */
+  --card-foreground: 0 0% 4%;
+
+  --popover: 0 0% 100%;
+  --popover-foreground: 0 0% 4%;
+
+  /* Primary — Theo violet (equity) ------------------------------------- */
+  --primary: 262 83% 58%; /* #7C3AED */
+  --primary-deep: 263 70% 42%; /* #5B21B6 — pressed */
+  --primary-glow: 263 90% 76%; /* #A78BFA — hover halo */
+  --primary-foreground: 0 0% 100%;
+
+  /* Secondary — neutral muted ----------------------------------------- */
+  --secondary: 0 0% 96%; /* #F5F5F5 */
+  --secondary-foreground: 0 0% 4%;
+
+  /* Accent — burnt sienna --------------------------------------------- */
+  --accent: 15 54% 53%; /* #C96442 */
+  --accent-deep: 15 55% 40%; /* #9C4A2E */
+  --accent-foreground: 0 0% 100%;
+
+  /* Muted ------------------------------------------------------------- */
+  --muted: 0 0% 96%;
+  --muted-foreground: 0 0% 45%; /* #737373 */
+
+  /* Surfaces, borders, inputs ----------------------------------------- */
+  --border: 0 0% 91%; /* #E8E8E8 — Vercel-style hairline */
+  --input: 0 0% 91%;
+  --ring: 262 83% 58%; /* matches primary */
+
+  /* Semantics --------------------------------------------------------- */
+  --success: 142 71% 36%; /* #16A34A */
+  --success-foreground: 0 0% 100%;
+  --warning: 33 92% 44%; /* #D97706 */
+  --warning-foreground: 0 0% 100%;
+  --destructive: 0 72% 51%; /* #DC2626 */
+  --destructive-foreground: 0 0% 100%;
+  --info: 217 91% 60%; /* #3B82F6 */
+  --info-foreground: 0 0% 100%;
+
+  /* Radii ------------------------------------------------------------- */
+  --radius-none: 0px;
+  --radius-sm: 4px;
+  --radius-md: 6px;
+  --radius-lg: 10px;
+  --radius-xl: 14px;
+  --radius-2xl: 20px;
+  --radius-full: 9999px;
+  /* shadcn compat */
+  --radius: 14px;
+
+  /* Spacing scale (4px base) ------------------------------------------ */
+  --space-1: 4px;
+  --space-2: 8px;
+  --space-3: 12px;
+  --space-4: 16px;
+  --space-5: 20px;
+  --space-6: 24px;
+  --space-8: 32px;
+  --space-10: 40px;
+  --space-12: 48px;
+  --space-16: 64px;
+  --space-20: 80px;
+  --space-24: 96px;
+  --space-32: 128px;
+
+  /* Elevation — theme-aware (uses --foreground for shadow ink,
+     * --primary for the signature glow, so swapping themes recolors them).
+     */
+  --shadow-sm: 0 1px 2px 0 hsl(var(--foreground) / 0.06);
+  --shadow-md: 0 2px 8px -2px hsl(var(--foreground) / 0.08), 0 1px 3px hsl(var(--foreground) / 0.06);
+  --shadow-lg: 0 12px 32px -8px hsl(var(--foreground) / 0.12), 0 4px 12px
+    hsl(var(--foreground) / 0.08);
+  --shadow-glow: 0 0 24px hsl(var(--primary) / 0.25);
+  --shadow-glow-strong: 0 0 32px hsl(var(--primary) / 0.4);
+
+  /* Motion ------------------------------------------------------------ */
+  --ease-out-soft: cubic-bezier(0.22, 1, 0.36, 1);
+  --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
+  --ease-snap: cubic-bezier(0.85, 0, 0.15, 1);
+  --duration-fast: 120ms;
+  --duration-base: 200ms;
+  --duration-slow: 360ms;
+  --stagger: 60ms;
+
+  /* Typography (Geist family — Vercel-inspired Violet Forge) ---------- */
+  --font-display: "Geist", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  --font-body: "Geist", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  --font-mono: "Geist Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
+}
+
+/* Dark mode — dominante --------------------------------------------- *
+   * Vercel-aligned grayscale: pure neutrals (0% saturation) for every
+   * surface and text layer. Color only in primary (violet), accent (burnt
+   * sienna), and semantic tokens (success/warning/destructive/info).
+   *
+   * Activated exclusively via the `.dark` class on `<html>` (set by
+   * `ThemeProvider`, `ThemeScript`, or consumers manually). The previous
+   * `[data-theme="dark"]` companion selector was dead — `data-theme` holds
+   * the theme NAME, never the literal `"dark"`.
+   */
+.dark {
+  --background: 0 0% 4%; /* #0A0A0A */
+  --foreground: 0 0% 96%; /* #F5F5F5 */
+
+  --card: 0 0% 7%; /* #121212 */
+  --card-foreground: 0 0% 96%;
+
+  --popover: 0 0% 9%; /* #171717 */
+  --popover-foreground: 0 0% 96%;
+
+  --primary: 262 83% 58%;
+  --primary-deep: 263 70% 42%;
+  --primary-glow: 263 90% 76%;
+  --primary-foreground: 0 0% 100%;
+
+  --secondary: 0 0% 11%; /* #1C1C1C */
+  --secondary-foreground: 0 0% 96%;
+
+  --accent: 15 54% 53%;
+  --accent-deep: 15 55% 40%;
+  --accent-foreground: 0 0% 100%;
+
+  --muted: 0 0% 11%;
+  --muted-foreground: 0 0% 60%; /* #999 — Vercel gray-500 */
+
+  --border: 0 0% 16%; /* #292929 */
+  --input: 0 0% 11%;
+  --ring: 262 83% 58%;
+
+  --success: 152 79% 52%; /* #22E58C */
+  --success-foreground: 0 0% 4%;
+  --warning: 38 92% 50%; /* #F59E0B */
+  --warning-foreground: 0 0% 4%;
+  --destructive: 350 100% 65%; /* #FF4F6D */
+  --destructive-foreground: 0 0% 4%;
+  --info: 213 100% 70%; /* #5FB3FF */
+  --info-foreground: 0 0% 4%;
+
+  /* In dark mode, shadows are heavier ink (against the dark surface) and
+     * the glow brightens. Both still derive from theme tokens.
+     */
+  --shadow-sm: 0 1px 2px 0 hsl(0 0% 0% / 0.4);
+  --shadow-md: 0 2px 8px -2px hsl(0 0% 0% / 0.5), 0 1px 3px hsl(0 0% 0% / 0.4);
+  --shadow-lg: 0 12px 32px -8px hsl(0 0% 0% / 0.6), 0 4px 12px hsl(0 0% 0% / 0.4);
+  --shadow-glow: 0 0 24px hsl(var(--primary-glow) / 0.4);
+  --shadow-glow-strong: 0 0 36px hsl(var(--primary-glow) / 0.6);
+}
+
+/* Reduced motion — neutralizes durations and transitions for users who
+ * request prefers-reduced-motion: reduce. Components that use animation as
+ * semantic state (e.g. a spinner on a running step) can opt back in with
+ * Tailwind's `motion-safe:` prefix.
+ *
+ * Reference: WCAG 2.3.3 Animation from Interactions (Level AAA).
+ */
+@media (prefers-reduced-motion: reduce) {
+  :root {
+    --duration-fast: 0ms;
+    --duration-base: 0ms;
+    --duration-slow: 0ms;
+    --stagger: 0ms;
+  }
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.001ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.001ms !important;
+    scroll-behavior: auto !important;
+  }
+}
+
+/* Texture utilities (signature) ---------------------------------------- */
+@layer utilities {
+  .bg-dotted-violet {
+    background-image: radial-gradient(hsl(var(--primary) / 0.08) 1px, transparent 1px);
+    background-size: 20px 20px;
+  }
+
+  .bg-dotted-violet-strong {
+    background-image: radial-gradient(hsl(var(--primary) / 0.16) 1px, transparent 1px);
+    background-size: 20px 20px;
+  }
+
+  .bg-hero-glow {
+    background-image: radial-gradient(
+      ellipse 60% 50% at 70% 0%,
+      hsl(var(--primary) / 0.18) 0%,
+      transparent 60%
+    );
+  }
+
+  .bg-paper-grain {
+    background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 200 200' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='2'/%3E%3CfeColorMatrix values='0 0 0 0 0.06 0 0 0 0 0.04 0 0 0 0 0.08 0 0 0 0.18 0'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='0.5'/%3E%3C/svg%3E");
+  }
+
+  .text-balance {
+    text-wrap: balance;
+  }
+}

package/dist/vite-plugin.d.ts

@@ -0,0 +1,29 @@
+import { Plugin } from 'vite';
+
+/**
+ * `@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`.
+ */
+
+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 };

package/dist/vite-plugin.js

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

@@ -0,0 +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 * `@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.d.ts

@@ -0,0 +1,258 @@
+import * as react from 'react';
+import { z } from 'zod';
+
+/**
+ * Zod schema for the Whiteboard JSON v1 (`WhiteboardScene`).
+ *
+ * Design goals (see RFC 0001 §4 and ADR D4 in the plan):
+ *   - LLM-friendly: minimal fields per element.
+ *   - Discriminated union by `type` for exhaustive typing in TS.
+ *   - Defensive against LLM mistakes:
+ *     - EC-3: `.finite()` everywhere — rejects NaN / Infinity.
+ *     - EC-4: `.max()` on dimensions to cap absurd values from the model.
+ */
+
+declare const whiteboardScene: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    background: z.ZodOptional<z.ZodString>;
+    elements: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"rect">;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+        roundness: z.ZodOptional<z.ZodEnum<{
+            sharp: "sharp";
+            round: "round";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"ellipse">;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"diamond">;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"line">;
+        to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"arrow">;
+        to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        label: z.ZodOptional<z.ZodString>;
+        headStart: z.ZodOptional<z.ZodBoolean>;
+        headEnd: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        align: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            center: "center";
+            right: "right";
+        }>>;
+        fontFamily: z.ZodOptional<z.ZodEnum<{
+            sans: "sans";
+            serif: "serif";
+            mono: "mono";
+            hand: "hand";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"freedraw">;
+        points: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodOptional<z.ZodNumber>], null>>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+type WhiteboardScene = z.output<typeof whiteboardScene>;
+type WhiteboardSceneInput = z.input<typeof whiteboardScene>;
+
+/**
+ * Public validator for `WhiteboardScene` JSON. Wraps Zod and converts errors
+ * into a structured shape that an LLM can consume to self-correct.
+ *
+ * Returns `{ ok: true, scene }` on success or `{ ok: false, errors }` with
+ * each error carrying `{ path, message, code, got? }`. See RFC 0001 §4.
+ */
+
+interface ValidationError {
+    /** Dot-joined Zod path, e.g. "elements.2.type" or "width". */
+    path: string;
+    /** Human-readable explanation (passes through Zod's message). */
+    message: string;
+    /** Zod issue code: `invalid_type`, `too_small`, `invalid_literal`, ... */
+    code: string;
+    /** Actual value received at `path`. Populated for type mismatches, discriminator mismatches, and any issue where Zod's `received` is absent but the value can be recovered by walking the original input along `path`. */
+    got?: unknown;
+}
+type ValidationResult = {
+    ok: true;
+    scene: WhiteboardScene;
+} | {
+    ok: false;
+    errors: ValidationError[];
+};
+declare function validateScene(input: unknown): ValidationResult;
+
+/** Input type accepted by the component (defaults like `headEnd` are optional). */
+type WhiteboardData = WhiteboardSceneInput;
+
+interface WhiteboardProps {
+    /** The scene to render. Validated with Zod on every change. */
+    data: WhiteboardData | unknown;
+    className?: string;
+    /** Starting zoom level (clamped 0.1–8). Default 1. */
+    initialZoom?: number;
+    /** World coordinate centered in the viewport on first render. */
+    initialCenter?: [number, number];
+    /** When true, computes a bounding box of all elements and zooms to fit. */
+    fitOnLoad?: boolean;
+    /** Called once per validation failure with the list of errors (EC-6: in useEffect, not render). */
+    onValidationError?: (errors: ValidationError[]) => void;
+    /** Accessible label for the SVG (defaults to "Whiteboard diagram"). */
+    "aria-label"?: string;
+}
+declare function Whiteboard({ data, className, initialZoom, initialCenter, fitOnLoad, onValidationError, "aria-label": ariaLabel, }: WhiteboardProps): react.JSX.Element;
+
+export { type ValidationError, type ValidationResult, Whiteboard, type WhiteboardData, type WhiteboardProps, validateScene };