@ggui-ai/ui-gen 0.28.0 → 0.29.0

package/dist/chunk-3T2HMTON.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/design-mode.ts"],"names":[],"mappings":"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","file":"chunk-3T2HMTON.js","sourcesContent":["// packages/ui-gen/src/design-mode.ts\n//\n// The ONE definition of the `designMode` option and the rendering-canvas\n// vocabulary. Every triad surface (system prompt, boilerplate, tier-0\n// gate, axis checks, evaluator criteria) AND the visual evaluator import\n// these types from here — nothing re-declares the unions.\n//\n//   - `constrained` (default) — today's triad: the component composes\n//     from the `@ggui-ai/design` primitives, prop enums and spacing\n//     scale, and tier-0 enforces the design vocabulary. Byte-identical\n//     to the pre-`designMode` behaviour (pinned by\n//     `design-mode.pin.test.ts`).\n//   - `free` — the design vocabulary is relaxed: raw HTML elements,\n//     inline styles and `<style>` blocks are allowed; the design package\n//     is importable but optional. Every HARD contract stays: the data\n//     contract via the boilerplate-typed wire hooks, the import\n//     allowlist + security bans, the host envelope, the budgets, the\n//     blueprint-reuse shape, and brand-bearing color via the closed\n//     `--ggui-color-*` token manifest (no literals, no fallbacks).\n\nimport type { CanvasClass } from \"@ggui-ai/design/rendering\";\n\nexport const DESIGN_MODES = [\"constrained\", \"free\"] as const;\n\nexport type DesignMode = (typeof DESIGN_MODES)[number];\n\nexport const DEFAULT_DESIGN_MODE: DesignMode = \"constrained\";\n\n// ─── Rendering canvas ───────────────────────────────────────────────────────\n//\n// ONE canvas vocabulary shared by the prompt input (the `free` prompt\n// TELLS the agent its canvas; the `constrained` prompt keeps its\n// shell/screen descriptors byte-for-byte) and the visual evaluator (one\n// screenshot + judge score per class at `CANVAS_VIEWPORTS[class]`).\n//\n// A class is derived from DISPLAY MODE + width, never from width alone:\n// an inline chat card is `xs-chat-card` whatever the host window\n// measures (the bubble, not the window, bounds the component); a\n// fullscreen-class surface follows its width through the three\n// breakpoints. `canvasForViewportWidth` is monotonic in width per\n// display mode (pinned by `design-mode.test.ts`).\n\n// The vocabulary itself lives in `@ggui-ai/design/rendering`, where the runtime reads it too.\nexport { CANVAS_CLASSES, type CanvasClass } from \"@ggui-ai/design/rendering\";\n\nexport interface CanvasViewport {\n  readonly width: number;\n  readonly height: number;\n}\n\n/** The viewport (CSS px) each class is rendered + judged at. */\nexport const CANVAS_VIEWPORTS: Readonly<Record<CanvasClass, CanvasViewport>> = {\n  \"xs-chat-card\": { width: 400, height: 640 },\n  \"mobile-fullscreen-small\": { width: 390, height: 844 },\n  md: { width: 768, height: 1024 },\n  lg: { width: 1024, height: 768 },\n  xl: { width: 1440, height: 900 },\n};\n\n/**\n * The two display modes the canvas derivation distinguishes. `inline`\n * is the chat card (MCP Apps `inline` display mode / the `chat` shell);\n * `fullscreen` is every surface the component owns edge to edge or as\n * a panel (`fullscreen`, `pip`, the `spatial` and `partial` shells) —\n * there the width decides the class.\n */\nexport type CanvasDisplayMode = \"inline\" | \"fullscreen\";\n\n/**\n * Map a shell name (`chat` / `fullscreen` / `spatial` / `partial`) or an\n * MCP Apps display mode (`inline` / `fullscreen` / `pip`) onto the\n * canvas display mode. Only `chat` and `inline` are the inline card;\n * everything else is width-governed.\n */\n/**\n * The display mode a JUDGE canvas stands for (ggui#1100): the inline chat\n * card is `xs-chat-card`; every other canvas is a surface the component\n * owns edge to edge, which the served runtime composes with `fit: 'fill'`\n * — so the judge must too, or it scores a picture the user never sees.\n */\nexport function displayModeForCanvas(canvas: CanvasClass): CanvasDisplayMode {\n  return canvas === \"xs-chat-card\" ? \"inline\" : \"fullscreen\";\n}\n\nexport function canvasDisplayModeForShell(shell: string | undefined): CanvasDisplayMode {\n  return shell === \"chat\" || shell === \"inline\" ? \"inline\" : \"fullscreen\";\n}\n\n/** Fullscreen-class breakpoints (inclusive lower bounds), CSS px. */\nexport const CANVAS_BREAKPOINTS = { md: 600, lg: 1024, xl: 1440 } as const;\n\n/**\n * Derive the canvas class from display mode + container width.\n *\n *   inline      → `xs-chat-card` at every width\n *   fullscreen  → width <  600  → `mobile-fullscreen-small`\n *                 600 – 1023    → `md`\n *                 1024 – 1439   → `lg`\n *                 ≥ 1440        → `xl`\n */\nexport function canvasForViewportWidth(mode: CanvasDisplayMode, width: number): CanvasClass {\n  if (mode === \"inline\") return \"xs-chat-card\";\n  if (width < CANVAS_BREAKPOINTS.md) return \"mobile-fullscreen-small\";\n  if (width < CANVAS_BREAKPOINTS.lg) return \"md\";\n  if (width < CANVAS_BREAKPOINTS.xl) return \"lg\";\n  return \"xl\";\n}\n\n/**\n * Map today's shell × screen descriptors onto a canvas class when no\n * width is known. `chat` is always the inline card; `spatial` is a\n * ~600px floating panel (`md`); `fullscreen` follows the screen. Unknown\n * values fall back to `lg` (the widest common fullscreen), matching the\n * skeleton's `fullscreen` / `universal` defaults.\n */\nexport function canvasForRendering(\n  shellType: string | undefined,\n  screen: string | undefined,\n): CanvasClass {\n  const shell = shellType ?? \"fullscreen\";\n  if (canvasDisplayModeForShell(shell) === \"inline\") return \"xs-chat-card\";\n  if (shell === \"spatial\") return \"md\";\n  switch (screen ?? \"universal\") {\n    case \"mobile\":\n      return \"mobile-fullscreen-small\";\n    case \"tablet\":\n      return \"md\";\n    default:\n      return \"lg\";\n  }\n}\n\nexport interface CanvasDescriptor {\n  /** Short human label. */\n  readonly label: string;\n  /** Inclusive width range the component must look right across, CSS px. */\n  readonly minWidthPx: number;\n  readonly maxWidthPx: number;\n  /** What the host draws around the component at this canvas. */\n  readonly host: string;\n}\n\nexport const CANVAS_DESCRIPTORS: Readonly<Record<CanvasClass, CanvasDescriptor>> = {\n  \"xs-chat-card\": {\n    label: \"extra-small chat card\",\n    minWidthPx: 320,\n    maxWidthPx: 480,\n    host: \"an inline card inside a chat message bubble — the host draws the card border, shadow and rounded corners; the component fills the bubble width and takes its natural height\",\n  },\n  \"mobile-fullscreen-small\": {\n    label: \"small mobile fullscreen\",\n    minWidthPx: 320,\n    maxWidthPx: 599,\n    host: \"a phone-sized viewport the component owns edge to edge — single column, touch targets at least 44px, the component manages its own scroll\",\n  },\n  md: {\n    label: \"medium panel\",\n    minWidthPx: 600,\n    maxWidthPx: 1023,\n    host: \"a tablet viewport or a floating panel (spatial / picture-in-picture) — one or two columns, medium density\",\n  },\n  lg: {\n    label: \"large fullscreen\",\n    minWidthPx: 1024,\n    maxWidthPx: 1439,\n    host: \"a desktop viewport the component owns edge to edge — multi-column layouts, hover states and pointer interactions are available\",\n  },\n  xl: {\n    label: \"extra-large fullscreen\",\n    minWidthPx: 1440,\n    maxWidthPx: 1920,\n    host: \"a wide desktop viewport the component owns edge to edge — cap content width or use the extra room deliberately; never stretch a single column across the whole width\",\n  },\n};\n\n/**\n * The explicit sentence the `free` prompt renders for a canvas — the\n * agent is TOLD the canvas, it never guesses it.\n */\nexport function describeCanvas(canvas: CanvasClass): string {\n  const d = CANVAS_DESCRIPTORS[canvas];\n  return (\n    `This component renders on the \\`${canvas}\\` canvas (${d.label}): ` +\n    `${d.minWidthPx}–${d.maxWidthPx}px wide, ${d.host}. ` +\n    `Design for the whole range — the host may size the iframe anywhere inside it, and the host owns the height: size to your content, never to the viewport.`\n  );\n}\n"]}

package/dist/chunk-3ZSSDV3L.js

@@ -0,0 +1,123 @@
+import { createCapture, captureMarkers, captureSourceCode, captureCompiledCode } from './chunk-YJZTUY7B.js';
+import { GeneratorAdapter, hasCredentials } from './chunk-XRBCRKA2.js';
+import { createAnthropicClient } from './chunk-QLXXPGTV.js';
+import { zodToJsonSchema } from './chunk-7QE3AHLE.js';
+
+// src/adapters/claude/raw.ts
+var ClaudeRawAdapter = class extends GeneratorAdapter {
+  provider = "claude";
+  mode = "raw";
+  displayName = "Claude (Raw API)";
+  client = null;
+  constructor(config = {}) {
+    super(config);
+  }
+  isAvailable() {
+    return hasCredentials(this.config, "ANTHROPIC_API_KEY");
+  }
+  async generate(params) {
+    const startTime = Date.now();
+    if (!this.client) {
+      if (this.config.useBedrock) {
+        this.client = createAnthropicClient(void 0);
+      } else {
+        const rawKey = this.config.apiKey || process.env.ANTHROPIC_API_KEY;
+        this.client = createAnthropicClient(rawKey);
+      }
+    }
+    const anthropicTools = params.tools.map(toAnthropicTool);
+    const capture = createCapture();
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let turnsUsed = 0;
+    const messages = [
+      { role: "user", content: params.userPrompt }
+    ];
+    for (let turn = 0; turn < params.maxTurns; turn++) {
+      turnsUsed = turn + 1;
+      const response = await this.client.messages.create({
+        model: params.model,
+        max_tokens: 16384,
+        system: params.systemPrompt,
+        messages,
+        tools: anthropicTools
+      });
+      totalInputTokens += response.usage.input_tokens;
+      totalOutputTokens += response.usage.output_tokens;
+      const toolUseBlocks = response.content.filter(
+        (block) => block.type === "tool_use"
+      );
+      for (const block of response.content) {
+        if (block.type === "text") captureMarkers(capture, block.text);
+      }
+      if (toolUseBlocks.length === 0 || response.stop_reason === "end_turn") {
+        break;
+      }
+      messages.push({
+        role: "assistant",
+        content: response.content.map((block) => {
+          if (block.type === "text") {
+            return { type: "text", text: block.text };
+          }
+          return {
+            type: "tool_use",
+            id: block.id,
+            name: block.name,
+            input: block.input
+          };
+        })
+      });
+      const toolResults = [];
+      for (const toolBlock of toolUseBlocks) {
+        const toolDef = params.tools.find((t) => t.name === toolBlock.name);
+        if (!toolDef) {
+          toolResults.push({
+            type: "tool_result",
+            tool_use_id: toolBlock.id,
+            content: `Tool '${toolBlock.name}' not found`,
+            is_error: true
+          });
+          continue;
+        }
+        const args = toolBlock.input ?? {};
+        captureSourceCode(capture, toolBlock.name, args);
+        const result = await toolDef.handler(args);
+        captureCompiledCode(capture, toolBlock.name, result);
+        toolResults.push({
+          type: "tool_result",
+          tool_use_id: toolBlock.id,
+          content: result.content.map((c) => ({ type: "text", text: c.text })),
+          is_error: result.isError
+        });
+      }
+      messages.push({ role: "user", content: toolResults });
+    }
+    if (!capture.compiledCode) {
+      throw new Error("Claude raw adapter: no compiled code produced after all turns");
+    }
+    return {
+      compiledCode: capture.compiledCode,
+      sourceCode: capture.sourceCode,
+      stream: capture.stream,
+      generatorMeta: capture.generatorMeta,
+      tokens: {
+        input: totalInputTokens,
+        output: totalOutputTokens,
+        total: totalInputTokens + totalOutputTokens
+      },
+      generationTimeMs: Date.now() - startTime,
+      turnsUsed
+    };
+  }
+};
+function toAnthropicTool(def) {
+  return {
+    name: def.name,
+    description: def.description,
+    input_schema: zodToJsonSchema(def.inputSchema)
+  };
+}
+
+export { ClaudeRawAdapter };
+//# sourceMappingURL=chunk-3ZSSDV3L.js.map
+//# sourceMappingURL=chunk-3ZSSDV3L.js.map

package/dist/chunk-3ZSSDV3L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/claude/raw.ts"],"names":[],"mappings":"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","file":"chunk-3ZSSDV3L.js","sourcesContent":["// packages/ui-gen/src/adapters/claude/raw.ts\n//\n// Claude adapter using the raw Anthropic SDK (@anthropic-ai/sdk).\n// Manual tool-use loop: messages.create() -> tool_use -> handler -> repeat.\n//\n// SDK client construction is centralized in `./client.ts`. Do NOT\n// inline `new Anthropic(...)` here.\n\nimport type Anthropic from '@anthropic-ai/sdk';\nimport { GeneratorAdapter, hasCredentials } from '../base';\nimport type { AdapterConfig, GenerateParams } from '../base';\nimport type { AdapterResult, ToolDefinition, ProviderName, AdapterMode } from '../types';\nimport { zodToJsonSchema } from '../tool-bridge';\nimport { createCapture, captureSourceCode, captureCompiledCode, captureMarkers } from '../extract-code';\nimport type { JsonObject } from '@ggui-ai/protocol';\nimport { createAnthropicClient } from './client';\n\nexport class ClaudeRawAdapter extends GeneratorAdapter {\n  readonly provider: ProviderName = 'claude';\n  readonly mode: AdapterMode = 'raw';\n  readonly displayName = 'Claude (Raw API)';\n\n  private client: Anthropic | null = null;\n\n  constructor(config: AdapterConfig = {}) {\n    super(config);\n  }\n\n  isAvailable(): boolean {\n    return hasCredentials(this.config, 'ANTHROPIC_API_KEY');\n  }\n\n  async generate(params: GenerateParams): Promise<AdapterResult> {\n    const startTime = Date.now();\n\n    if (!this.client) {\n      // Bedrock path: SDK reads AWS creds from the env / role chain;\n      // skip the `apiKey` set entirely — `createAnthropicClient(undefined)`\n      // gives us a constructed client and the SDK does the rest.\n      if (this.config.useBedrock) {\n        this.client = createAnthropicClient(undefined);\n      } else {\n        const rawKey = this.config.apiKey || process.env.ANTHROPIC_API_KEY;\n        this.client = createAnthropicClient(rawKey);\n      }\n    }\n\n    const anthropicTools = params.tools.map(toAnthropicTool);\n    const capture = createCapture();\n    let totalInputTokens = 0;\n    let totalOutputTokens = 0;\n    let turnsUsed = 0;\n\n    const messages: Anthropic.MessageParam[] = [\n      { role: 'user', content: params.userPrompt },\n    ];\n\n    for (let turn = 0; turn < params.maxTurns; turn++) {\n      turnsUsed = turn + 1;\n\n      const response = await this.client.messages.create({\n        model: params.model,\n        max_tokens: 16384,\n        system: params.systemPrompt,\n        messages,\n        tools: anthropicTools,\n      });\n\n      totalInputTokens += response.usage.input_tokens;\n      totalOutputTokens += response.usage.output_tokens;\n\n      const toolUseBlocks = response.content.filter(\n        (block): block is Anthropic.ToolUseBlock => block.type === 'tool_use',\n      );\n\n      // Scan text blocks for streamSpec/generatorMeta markers\n      for (const block of response.content) {\n        if (block.type === 'text') captureMarkers(capture, block.text);\n      }\n\n      if (toolUseBlocks.length === 0 || response.stop_reason === 'end_turn') {\n        break;\n      }\n\n      messages.push({\n        role: 'assistant',\n        content: response.content.map((block) => {\n          if (block.type === 'text') {\n            return { type: 'text' as const, text: block.text };\n          }\n          return {\n            type: 'tool_use' as const,\n            id: (block as Anthropic.ToolUseBlock).id,\n            name: (block as Anthropic.ToolUseBlock).name,\n            input: (block as Anthropic.ToolUseBlock).input,\n          };\n        }),\n      });\n\n      const toolResults: Anthropic.ToolResultBlockParam[] = [];\n\n      for (const toolBlock of toolUseBlocks) {\n        const toolDef = params.tools.find((t) => t.name === toolBlock.name);\n        if (!toolDef) {\n          toolResults.push({\n            type: 'tool_result',\n            tool_use_id: toolBlock.id,\n            content: `Tool '${toolBlock.name}' not found`,\n            is_error: true,\n          });\n          continue;\n        }\n\n        const args = (toolBlock.input as JsonObject) ?? {};\n        captureSourceCode(capture, toolBlock.name, args);\n\n        const result = await toolDef.handler(args);\n        captureCompiledCode(capture, toolBlock.name, result);\n\n        toolResults.push({\n          type: 'tool_result',\n          tool_use_id: toolBlock.id,\n          content: result.content.map((c) => ({ type: 'text' as const, text: c.text })),\n          is_error: result.isError,\n        });\n      }\n\n      messages.push({ role: 'user', content: toolResults });\n    }\n\n    if (!capture.compiledCode) {\n      throw new Error('Claude raw adapter: no compiled code produced after all turns');\n    }\n\n    return {\n      compiledCode: capture.compiledCode,\n      sourceCode: capture.sourceCode,\n      stream: capture.stream,\n      generatorMeta: capture.generatorMeta,\n      tokens: {\n        input: totalInputTokens,\n        output: totalOutputTokens,\n        total: totalInputTokens + totalOutputTokens,\n      },\n      generationTimeMs: Date.now() - startTime,\n      turnsUsed,\n    };\n  }\n}\n\nfunction toAnthropicTool(def: ToolDefinition): Anthropic.Tool {\n  return {\n    name: def.name,\n    description: def.description,\n    input_schema: zodToJsonSchema(def.inputSchema) as Anthropic.Tool.InputSchema,\n  };\n}\n"]}

package/dist/chunk-4MBR5GA3.js

@@ -0,0 +1,99 @@
+import { createHash } from 'crypto';
+
+// src/harness/hashline.ts
+function computeLineHash(line) {
+  return createHash("sha256").update(line).digest("hex").slice(0, 2);
+}
+function formatWithHashlines(content) {
+  const lines = content.split("\n");
+  return lines.map((line, i) => `${i + 1}:${computeLineHash(line)}\u2502${line}`).join("\n");
+}
+function parseHashlineRef(ref) {
+  if (typeof ref !== "string") return null;
+  const m = ref.match(/^(\d+):([0-9a-fA-F]{2})$/);
+  if (!m) return null;
+  return {
+    line: parseInt(m[1], 10),
+    expectedHash: m[2].toLowerCase()
+  };
+}
+function validateHashlineRefs(sourceBefore, changes) {
+  const sourceLines = sourceBefore.split("\n");
+  const issues = [];
+  for (let i = 0; i < changes.length; i++) {
+    const c = changes[i];
+    if (c.expectedStartHash !== void 0) {
+      const sourceLine = sourceLines[c.startLine - 1];
+      if (sourceLine === void 0) {
+        issues.push({
+          changeIndex: i,
+          field: "startLine",
+          line: c.startLine,
+          expectedHash: c.expectedStartHash,
+          actualHash: "??",
+          actualContent: `<line ${c.startLine} out of bounds; file has ${sourceLines.length} lines>`
+        });
+      } else {
+        const actual = computeLineHash(sourceLine);
+        if (actual !== c.expectedStartHash.toLowerCase()) {
+          issues.push({
+            changeIndex: i,
+            field: "startLine",
+            line: c.startLine,
+            expectedHash: c.expectedStartHash.toLowerCase(),
+            actualHash: actual,
+            actualContent: sourceLine
+          });
+        }
+      }
+    }
+    if (c.expectedEndHash !== void 0) {
+      const sourceLine = sourceLines[c.endLine - 1];
+      if (sourceLine === void 0) {
+        issues.push({
+          changeIndex: i,
+          field: "endLine",
+          line: c.endLine,
+          expectedHash: c.expectedEndHash,
+          actualHash: "??",
+          actualContent: `<line ${c.endLine} out of bounds; file has ${sourceLines.length} lines>`
+        });
+        continue;
+      }
+      const actual = computeLineHash(sourceLine);
+      if (actual !== c.expectedEndHash.toLowerCase()) {
+        issues.push({
+          changeIndex: i,
+          field: "endLine",
+          line: c.endLine,
+          expectedHash: c.expectedEndHash.toLowerCase(),
+          actualHash: actual,
+          actualContent: sourceLine
+        });
+      }
+    }
+  }
+  return issues;
+}
+function formatHashlineStaleMessage(issues) {
+  const lines = [];
+  lines.push(
+    "HASHLINE_STALE: line hash(es) don't match current file \u2014 your view is stale. Re-read the `## Current File` block and re-emit with current hashes."
+  );
+  lines.push("");
+  for (const issue of issues) {
+    lines.push(
+      `  \u2022 change[${issue.changeIndex}].${issue.field} = ${issue.line}:${issue.expectedHash} \u2014 expected hash ${issue.expectedHash}, actual hash ${issue.actualHash}`
+    );
+    lines.push(`      line ${issue.line} currently: ${issue.actualContent}`);
+  }
+  lines.push("");
+  lines.push(
+    "Workspace unchanged. Submit a new apply_changes with line refs like `${N}:${hash}` matching the current file."
+  );
+  return lines.join("\n");
+}
+
+export { computeLineHash, formatHashlineStaleMessage, formatWithHashlines, parseHashlineRef, validateHashlineRefs };
+//# sourceMappingURL=chunk-4MBR5GA3.js.map
+//# sourceMappingURL=chunk-4MBR5GA3.js.map

package/dist/chunk-4MBR5GA3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/harness/hashline.ts"],"names":[],"mappings":";;;AAwBO,SAAS,gBAAgB,IAAA,EAAsB;AACpD,EAAA,OAAO,UAAA,CAAW,QAAQ,CAAA,CAAE,MAAA,CAAO,IAAI,CAAA,CAAE,MAAA,CAAO,KAAK,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AACnE;AAMO,SAAS,oBAAoB,OAAA,EAAyB;AAC3D,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA;AAChC,EAAA,OAAO,MACJ,GAAA,CAAI,CAAC,IAAA,EAAM,CAAA,KAAM,GAAG,CAAA,GAAI,CAAC,CAAA,CAAA,EAAI,eAAA,CAAgB,IAAI,CAAC,CAAA,MAAA,EAAI,IAAI,CAAA,CAAE,CAAA,CAC5D,KAAK,IAAI,CAAA;AACd;AAUO,SAAS,iBAAiB,GAAA,EAAwC;AACvE,EAAA,IAAI,OAAO,GAAA,KAAQ,QAAA,EAAU,OAAO,IAAA;AACpC,EAAA,MAAM,CAAA,GAAI,GAAA,CAAI,KAAA,CAAM,0BAA0B,CAAA;AAC9C,EAAA,IAAI,CAAC,GAAG,OAAO,IAAA;AACf,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAA,CAAS,CAAA,CAAE,CAAC,GAAI,EAAE,CAAA;AAAA,IACxB,YAAA,EAAc,CAAA,CAAE,CAAC,CAAA,CAAG,WAAA;AAAY,GAClC;AACF;AAcO,SAAS,oBAAA,CACd,cACA,OAAA,EAM2B;AAC3B,EAAA,MAAM,WAAA,GAAc,YAAA,CAAa,KAAA,CAAM,IAAI,CAAA;AAC3C,EAAA,MAAM,SAAoC,EAAC;AAE3C,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,OAAA,CAAQ,QAAQ,CAAA,EAAA,EAAK;AACvC,IAAA,MAAM,CAAA,GAAI,QAAQ,CAAC,CAAA;AAEnB,IAAA,IAAI,CAAA,CAAE,sBAAsB,MAAA,EAAW;AACrC,MAAA,MAAM,UAAA,GAAa,WAAA,CAAY,CAAA,CAAE,SAAA,GAAY,CAAC,CAAA;AAC9C,MAAA,IAAI,eAAe,MAAA,EAAW;AAC5B,QAAA,MAAA,CAAO,IAAA,CAAK;AAAA,UACV,WAAA,EAAa,CAAA;AAAA,UACb,KAAA,EAAO,WAAA;AAAA,UACP,MAAM,CAAA,CAAE,SAAA;AAAA,UACR,cAAc,CAAA,CAAE,iBAAA;AAAA,UAChB,UAAA,EAAY,IAAA;AAAA,UACZ,eAAe,CAAA,MAAA,EAAS,CAAA,CAAE,SAAS,CAAA,yBAAA,EAA4B,YAAY,MAAM,CAAA,OAAA;AAAA,SAClF,CAAA;AAAA,MACH,CAAA,MAAO;AACL,QAAA,MAAM,MAAA,GAAS,gBAAgB,UAAU,CAAA;AACzC,QAAA,IAAI,MAAA,KAAW,CAAA,CAAE,iBAAA,CAAkB,WAAA,EAAY,EAAG;AAChD,UAAA,MAAA,CAAO,IAAA,CAAK;AAAA,YACV,WAAA,EAAa,CAAA;AAAA,YACb,KAAA,EAAO,WAAA;AAAA,YACP,MAAM,CAAA,CAAE,SAAA;AAAA,YACR,YAAA,EAAc,CAAA,CAAE,iBAAA,CAAkB,WAAA,EAAY;AAAA,YAC9C,UAAA,EAAY,MAAA;AAAA,YACZ,aAAA,EAAe;AAAA,WAChB,CAAA;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI,CAAA,CAAE,oBAAoB,MAAA,EAAW;AACnC,MAAA,MAAM,UAAA,GAAa,WAAA,CAAY,CAAA,CAAE,OAAA,GAAU,CAAC,CAAA;AAC5C,MAAA,IAAI,eAAe,MAAA,EAAW;AAC5B,QAAA,MAAA,CAAO,IAAA,CAAK;AAAA,UACV,WAAA,EAAa,CAAA;AAAA,UACb,KAAA,EAAO,SAAA;AAAA,UACP,MAAM,CAAA,CAAE,OAAA;AAAA,UACR,cAAc,CAAA,CAAE,eAAA;AAAA,UAChB,UAAA,EAAY,IAAA;AAAA,UACZ,eAAe,CAAA,MAAA,EAAS,CAAA,CAAE,OAAO,CAAA,yBAAA,EAA4B,YAAY,MAAM,CAAA,OAAA;AAAA,SAChF,CAAA;AACD,QAAA;AAAA,MACF;AACA,MAAA,MAAM,MAAA,GAAS,gBAAgB,UAAU,CAAA;AACzC,MAAA,IAAI,MAAA,KAAW,CAAA,CAAE,eAAA,CAAgB,WAAA,EAAY,EAAG;AAC9C,QAAA,MAAA,CAAO,IAAA,CAAK;AAAA,UACV,WAAA,EAAa,CAAA;AAAA,UACb,KAAA,EAAO,SAAA;AAAA,UACP,MAAM,CAAA,CAAE,OAAA;AAAA,UACR,YAAA,EAAc,CAAA,CAAE,eAAA,CAAgB,WAAA,EAAY;AAAA,UAC5C,UAAA,EAAY,MAAA;AAAA,UACZ,aAAA,EAAe;AAAA,SAChB,CAAA;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,2BACd,MAAA,EACQ;AACR,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,KAAA,CAAM,IAAA;AAAA,IACJ;AAAA,GACF;AACA,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AACb,EAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,IAAA,KAAA,CAAM,IAAA;AAAA,MACJ,mBAAc,KAAA,CAAM,WAAW,CAAA,EAAA,EAAK,KAAA,CAAM,KAAK,CAAA,GAAA,EAAM,KAAA,CAAM,IAAI,CAAA,CAAA,EAAI,MAAM,YAAY,CAAA,sBAAA,EAAoB,MAAM,YAAY,CAAA,cAAA,EAAiB,MAAM,UAAU,CAAA;AAAA,KAC9J;AACA,IAAA,KAAA,CAAM,KAAK,CAAA,WAAA,EAAc,KAAA,CAAM,IAAI,CAAA,YAAA,EAAe,KAAA,CAAM,aAAa,CAAA,CAAE,CAAA;AAAA,EACzE;AACA,EAAA,KAAA,CAAM,KAAK,EAAE,CAAA;AACb,EAAA,KAAA,CAAM,IAAA;AAAA,IACJ;AAAA,GACF;AACA,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB","file":"chunk-4MBR5GA3.js","sourcesContent":["// Hashline format. The technique injects 2-char content hashes\n// alongside line numbers in the file view and requires the LLM to echo\n// them in apply_changes references.\n//\n// The hash serves as a \"trusted anchor\" — if the file changed since the\n// LLM's last read (due to tool interleaving or the model miscounting),\n// the hash-check rejects the edit before corruption.\n//\n// Display format (in `## Current File` block):\n//   47:a3│  const x = 1;\n//   48:f2│  return x;\n//\n// LLM emits refs as `\"47:a3\"` (string) instead of `47` (number) in the\n// apply_changes.changes[].startLine / endLine fields when the hashline\n// tool is active.\n\nimport { createHash } from \"node:crypto\";\n\n/** Compute a 2-char hex hash of a line's content. Uses SHA-256 trimmed to\n *  2 hex chars (1 byte / 256-space) — enough to disambiguate within a\n *  single file (typical 100-400 line components; collision ~5-20%). The\n *  hash is computed on the RAW line content (no trim), so whitespace\n *  sensitivity is preserved — important for detecting \"file changed by\n *  whitespace-only edit.\" */\nexport function computeLineHash(line: string): string {\n  return createHash(\"sha256\").update(line).digest(\"hex\").slice(0, 2);\n}\n\n/** Format a file's content with hashlines. Each line becomes `N:hh│content`.\n *  `N` is 1-indexed; line numbering matches what apply_changes already\n *  expects. The `│` separator is the same character used by the existing\n *  workspace.cat() output for visual continuity. */\nexport function formatWithHashlines(content: string): string {\n  const lines = content.split(\"\\n\");\n  return lines\n    .map((line, i) => `${i + 1}:${computeLineHash(line)}│${line}`)\n    .join(\"\\n\");\n}\n\nexport interface ParsedHashlineRef {\n  readonly line: number;\n  readonly expectedHash: string;\n}\n\n/** Parse a hashline ref string like \"47:a3\" into {line, expectedHash}.\n *  Returns null if the input doesn't match the pattern — the handler\n *  should fall back to treating it as a legacy numeric ref or reject. */\nexport function parseHashlineRef(ref: unknown): ParsedHashlineRef | null {\n  if (typeof ref !== \"string\") return null;\n  const m = ref.match(/^(\\d+):([0-9a-fA-F]{2})$/);\n  if (!m) return null;\n  return {\n    line: parseInt(m[1]!, 10),\n    expectedHash: m[2]!.toLowerCase(),\n  };\n}\n\nexport interface HashlineValidationIssue {\n  readonly changeIndex: number;\n  readonly field: \"startLine\" | \"endLine\";\n  readonly line: number;\n  readonly expectedHash: string;\n  readonly actualHash: string;\n  /** The actual current content of the line — helps the LLM re-orient. */\n  readonly actualContent: string;\n}\n\n/** Validate that the expected hashes on a list of changes match the current\n *  file. Returns issues[] for any mismatches; empty = all good. */\nexport function validateHashlineRefs(\n  sourceBefore: string,\n  changes: ReadonlyArray<{\n    startLine: number;\n    endLine: number;\n    expectedStartHash?: string;\n    expectedEndHash?: string;\n  }>,\n): HashlineValidationIssue[] {\n  const sourceLines = sourceBefore.split(\"\\n\");\n  const issues: HashlineValidationIssue[] = [];\n\n  for (let i = 0; i < changes.length; i++) {\n    const c = changes[i]!;\n    // startLine validation\n    if (c.expectedStartHash !== undefined) {\n      const sourceLine = sourceLines[c.startLine - 1];\n      if (sourceLine === undefined) {\n        issues.push({\n          changeIndex: i,\n          field: \"startLine\",\n          line: c.startLine,\n          expectedHash: c.expectedStartHash,\n          actualHash: \"??\",\n          actualContent: `<line ${c.startLine} out of bounds; file has ${sourceLines.length} lines>`,\n        });\n      } else {\n        const actual = computeLineHash(sourceLine);\n        if (actual !== c.expectedStartHash.toLowerCase()) {\n          issues.push({\n            changeIndex: i,\n            field: \"startLine\",\n            line: c.startLine,\n            expectedHash: c.expectedStartHash.toLowerCase(),\n            actualHash: actual,\n            actualContent: sourceLine,\n          });\n        }\n      }\n    }\n    // endLine validation\n    if (c.expectedEndHash !== undefined) {\n      const sourceLine = sourceLines[c.endLine - 1];\n      if (sourceLine === undefined) {\n        issues.push({\n          changeIndex: i,\n          field: \"endLine\",\n          line: c.endLine,\n          expectedHash: c.expectedEndHash,\n          actualHash: \"??\",\n          actualContent: `<line ${c.endLine} out of bounds; file has ${sourceLines.length} lines>`,\n        });\n        continue;\n      }\n      const actual = computeLineHash(sourceLine);\n      if (actual !== c.expectedEndHash.toLowerCase()) {\n        issues.push({\n          changeIndex: i,\n          field: \"endLine\",\n          line: c.endLine,\n          expectedHash: c.expectedEndHash.toLowerCase(),\n          actualHash: actual,\n          actualContent: sourceLine,\n        });\n      }\n    }\n  }\n\n  return issues;\n}\n\n/** Format a validation result as an actionable PATCH_INVALID message. */\nexport function formatHashlineStaleMessage(\n  issues: ReadonlyArray<HashlineValidationIssue>,\n): string {\n  const lines: string[] = [];\n  lines.push(\n    \"HASHLINE_STALE: line hash(es) don't match current file — your view is stale. Re-read the `## Current File` block and re-emit with current hashes.\",\n  );\n  lines.push(\"\");\n  for (const issue of issues) {\n    lines.push(\n      `  • change[${issue.changeIndex}].${issue.field} = ${issue.line}:${issue.expectedHash} — expected hash ${issue.expectedHash}, actual hash ${issue.actualHash}`,\n    );\n    lines.push(`      line ${issue.line} currently: ${issue.actualContent}`);\n  }\n  lines.push(\"\");\n  lines.push(\n    \"Workspace unchanged. Submit a new apply_changes with line refs like `${N}:${hash}` matching the current file.\",\n  );\n  return lines.join(\"\\n\");\n}\n"]}

package/dist/chunk-56NJFD55.js

@@ -0,0 +1,337 @@
+// src/design-system-docs.ts
+var DEFAULT_DESIGN_SYSTEM_DOCS = `# Design System - Default Light Theme
+
+**IMPORTANT:** Always use CSS variables (var(--ggui-*)) for styling to ensure components respect the app theme.
+
+## Colors
+
+### Primary
+- var(--ggui-color-primary-50) - #f0f9ff
+- var(--ggui-color-primary-100) - #e0f2fe
+- var(--ggui-color-primary-200) - #bae6fd
+- var(--ggui-color-primary-300) - #7dd3fc
+- var(--ggui-color-primary-400) - #38bdf8
+- var(--ggui-color-primary-500) - #0ea5e9
+- var(--ggui-color-primary-600) - #0284c7 (main action FILL \u2014 buttons, borders, icon fills; accent TEXT takes the link role below)
+- var(--ggui-color-primary-700) - #0369a1
+- var(--ggui-color-primary-800) - #075985
+- var(--ggui-color-primary-900) - #0c4a6e
+
+### Semantic Surface & Text Colors (REQUIRED for theme compatibility)
+These tokens adapt automatically to any theme (light, dark, branded). **ALWAYS use these for surfaces and text \u2014 never use raw neutral-* scale values.**
+
+| Token | CSS Variable | Default | Role |
+|-------|-------------|---------|------|
+| ground | var(--ggui-color-ground) | The page / canvas behind everything |
+| onGround | var(--ggui-color-onGround) | Text on the canvas |
+| container | var(--ggui-color-container) | A card, a bubble, a panel \u2014 the unit of content |
+| onContainer | var(--ggui-color-onContainer) | Body text on a card |
+| elevated | var(--ggui-color-elevated) | Menus, popovers, modals, toasts \u2014 floats above a card |
+| onElevated | var(--ggui-color-onElevated) | Text on an elevated surface |
+| heroGround | var(--ggui-color-heroGround) | A hero / greeting panel's ground \u2014 brand-tinted on a light host, the ink pair on a dark one (Card surface="hero") |
+| onHeroGround | var(--ggui-color-onHeroGround) | Text on the hero ground |
+| sunken | var(--ggui-color-sunken) | Wells, inputs at rest, code blocks \u2014 recessed inside a card |
+| onSunken | var(--ggui-color-onSunken) | Muted / secondary text |
+| link | var(--ggui-color-link) | Accent TEXT \u2014 eyebrows, taglines, links, labels, inline arrows: the brand's readable ink, derived per mode to clear 4.5:1 on the container and the ground |
+| outline | var(--ggui-color-outline) | Borders, dividers |
+| outlineVariant | var(--ggui-color-outlineVariant) | Subtle borders |
+| controlOutline | var(--ggui-color-controlOutline) | A control's edge \u2014 clears 3:1 on its surface; kit controls draw it themselves |
+
+**Usage pattern:**
+- Page/section background \u2192 \`var(--ggui-color-ground)\`
+- Body text \u2192 \`var(--ggui-color-onContainer)\`
+- Card/panel background \u2192 \`var(--ggui-color-container)\`; recessed wells / inputs \u2192 \`var(--ggui-color-sunken)\`
+- Secondary/muted text \u2192 \`var(--ggui-color-onSunken)\`
+- Accent / branded text (eyebrow, tagline, link, label, inline arrow) \u2192 \`var(--ggui-color-link)\` or \`<Text tone="emphasized">\` \u2014 never a bare \`primary-<stop>\` as a text color
+- Branded section/header \u2192 \`var(--ggui-color-container)\` bg + \`var(--ggui-color-onContainer)\` text
+- Borders/dividers \u2192 \`var(--ggui-color-outline)\` or \`var(--ggui-color-outlineVariant)\`
+
+### State Colors
+Semantic families ship as SCALES; the \`500\` stop is the role color (per-mode brightness), \`50\` the tint, \`800\` the on-tint text:
+- var(--ggui-color-success-500) \u2014 success states (tint bg: success-50, text on tint: success-800)
+- var(--ggui-color-warning-500) \u2014 warning states (warning-50 / warning-800)
+- var(--ggui-color-error-500) \u2014 error states, destructive actions (error-50 / error-800)
+- var(--ggui-color-info-500) \u2014 informational (info-50 / info-800)
+Prefer the primitives' \`tone="success|warning|error|info"\` prop over hand-written vars \u2014 it resolves to the same stops.
+
+### IMPORTANT: Color Rules
+- **NEVER** use hardcoded hex colors. ONLY use var(--ggui-color-*) tokens.
+- **NEVER** use rgba(), hsl(), or other CSS color functions with hardcoded values.
+- **NEVER** use raw neutral-* or gray-* scale tokens (neutral-50, neutral-900, etc.) \u2014 these are internal to the theme and break in dark mode.
+- **ALWAYS** use semantic tokens for text and backgrounds:
+  - Text: \`var(--ggui-color-onContainer)\` or \`var(--ggui-color-onSunken)\`
+  - Backgrounds: \`var(--ggui-color-container)\` or \`var(--ggui-color-sunken)\`
+  - Borders: \`var(--ggui-color-outline)\` or \`var(--ggui-color-outlineVariant)\`
+- For branded elements use \`var(--ggui-color-primary-*)\` scale tokens \u2014 these ARE safe because primary adapts per theme.
+- For card backgrounds use \`var(--ggui-color-container)\` or \`var(--ggui-color-primary-50)\`
+
+## Spacing
+
+Use \`var(--ggui-spacing-N)\` for all padding, gap, and margin values. **Never use raw numbers** like \`padding={16}\` \u2014 always use the token: \`padding="var(--ggui-spacing-4)"\`.
+
+| Token | Value | Common use |
+|-------|-------|------------|
+| var(--ggui-spacing-1) | 4px | Icon gaps, tight spacing |
+| var(--ggui-spacing-2) | 8px | Button padding, small gaps |
+| var(--ggui-spacing-3) | 12px | List item spacing, form gaps |
+| var(--ggui-spacing-4) | 16px | Card padding, section gaps |
+| var(--ggui-spacing-5) | 20px | Medium padding |
+| var(--ggui-spacing-6) | 24px | Container padding, large gaps |
+| var(--ggui-spacing-8) | 32px | Section spacing |
+| var(--ggui-spacing-10) | 40px | Page margins |
+| var(--ggui-spacing-12) | 48px | Hero/large section spacing |
+
+**Quick lookup (px \u2192 token):** 4\u21921, 8\u21922, 12\u21923, 16\u21924, 20\u21925, 24\u21926, 28\u21927, 32\u21928, 36\u21929, 40\u219210, 48\u219212
+
+**Usage on primitives:**
+\`\`\`tsx
+<Container padding="var(--ggui-spacing-6)">
+  <Stack gap="var(--ggui-spacing-4)">
+    <Card padding="var(--ggui-spacing-4)">
+      <Row gap="var(--ggui-spacing-2)">...</Row>
+    </Card>
+  </Stack>
+</Container>
+\`\`\`
+
+## Typography
+
+### Font Sizes
+- var(--ggui-font-size-xs) - 12px
+- var(--ggui-font-size-sm) - 14px
+- var(--ggui-font-size-base) - 16px
+- var(--ggui-font-size-lg) - 18px
+- var(--ggui-font-size-xl) - 20px
+- var(--ggui-font-size-2xl) - 24px
+- var(--ggui-font-size-3xl) - 30px
+- var(--ggui-font-size-4xl) - 36px
+
+### Font Weights
+- var(--ggui-font-weight-normal) - 400
+- var(--ggui-font-weight-medium) - 500
+- var(--ggui-font-weight-semibold) - 600
+- var(--ggui-font-weight-bold) - 700
+
+## Border Radius
+- var(--ggui-shape-radius-sm) - 4px
+- var(--ggui-shape-radius-md) - 8px
+- var(--ggui-shape-radius-lg) - 12px
+- var(--ggui-shape-radius-xl) - 16px
+- var(--ggui-shape-radius-full) - 9999px
+
+## Shadows
+- var(--ggui-shape-shadow-sm) - 0 1px 2px rgba(0,0,0,0.05)
+- var(--ggui-shape-shadow-md) - 0 4px 6px -1px rgba(0,0,0,0.1)
+- var(--ggui-shape-shadow-lg) - 0 10px 15px -3px rgba(0,0,0,0.1)
+- var(--ggui-shape-shadow-xl) - 0 20px 25px -5px rgba(0,0,0,0.1)
+
+## Usage Examples (always use ggui primitives \u2014 never raw <div>, <button>, <input>)
+
+### Branded section header
+\`\`\`tsx
+<Box padding="var(--ggui-spacing-4)" surface="accent">
+  <Heading level={2} tone="emphasized">Contact Us</Heading>
+  <Text tone="emphasized">We'd love to hear from you</Text>
+</Box>
+\`\`\`
+
+### Form input
+\`\`\`tsx
+<Input label="Email" placeholder="you@example.com" />
+\`\`\`
+
+### Buttons
+\`\`\`tsx
+<Button variant="primary">Submit</Button>
+<Button variant="outline">Cancel</Button>
+<Button variant="ghost">Skip</Button>
+\`\`\`
+
+### Card with spacing tokens
+\`\`\`tsx
+<Card padding="var(--ggui-spacing-4)" shadow="md">
+  <Stack gap="var(--ggui-spacing-3)">
+    <Heading level={3}>Title</Heading>
+    <Text tone="muted">Description</Text>
+  </Stack>
+</Card>
+\`\`\`
+
+### Color usage guide
+- **Layering roles** (ground, container, elevated, sunken + their on* inks; outline): one kind of AREA each \u2014 use them for every background/text/border decision; they adapt to any theme
+- **primary-50/100**: Section backgrounds, highlight strips, card headers
+- **primary-200/300**: Dividers and section rules \u2014 never a control's border: kit controls draw their own edge (\`controlOutline\` / \`controlAccentOutline\`), so set no inline border on them
+- **primary-500/600**: Filled buttons, CTAs, badges, icon fills, active indicators \u2014 fills and borders, NOT a text color
+- **link**: Accent TEXT \u2014 eyebrows, taglines, links, labels, inline arrows; the brand's readable ink per mode (a bare \`primary-300\u2026600\` as a text color fails tier-0: \`universal.accent_text_ink\`)
+- **primary-700/800/900**: Headings and text on light primary backgrounds
+- **neutral-***: Only when you need a specific shade that semantic tokens don't cover
+
+The primary palette is the app's brand \u2014 use it throughout (headers, accents, borders, interactive elements), not just on the submit button.
+
+**Note:** Do NOT add fallback values to var() (e.g., var(--ggui-color-container, #fafafa)). Just use var(--ggui-color-container) \u2014 the theme provides all values.
+
+## Motion & Animation
+
+### Duration Scale
+- \`instant\`: 0ms
+- \`fast\`: 100ms
+- \`normal\`: 200ms
+- \`slow\`: 300ms
+- \`slower\`: 500ms
+
+### Easing Curves
+- \`linear\`: linear
+- \`easeIn\`: cubic-bezier(0.4, 0, 1, 1)
+- \`easeOut\`: cubic-bezier(0, 0, 0.2, 1)
+- \`easeInOut\`: cubic-bezier(0.4, 0, 0.2, 1)
+- \`spring\`: cubic-bezier(0.175, 0.885, 0.32, 1.275)
+
+### Transition Presets (import from '@ggui-ai/design/tokens')
+\`\`\`tsx
+import { duration, easing, transition } from '@ggui-ai/design/tokens';
+// transition.fast    \u2192 "100ms cubic-bezier(0.4, 0, 0.2, 1)"
+// transition.normal  \u2192 "200ms cubic-bezier(0.4, 0, 0.2, 1)"
+// transition.slow    \u2192 "300ms cubic-bezier(0.4, 0, 0.2, 1)"
+// transition.colors  \u2192 color + background-color + border-color (200ms each)
+// transition.opacity \u2192 opacity 200ms
+// transition.transform \u2192 transform 200ms
+\`\`\`
+
+### Animation Keyframes
+Use \`<MotionKeyframes />\` once in your component to inject all keyframes, then reference by name.
+
+**Entrance / exit** (GPU-composited, transform + opacity):
+- \`ggui-fadeIn\` / \`ggui-fadeOut\`
+- \`ggui-slideInUp\` / \`ggui-slideInDown\`
+- \`ggui-scaleIn\` / \`ggui-scaleOut\`
+
+**State feedback** (color-based, for data-change highlights):
+- \`ggui-flash\` \u2014 background-color highlight that fades out. Set \`--ggui-flash-color\` on the element (default: \`var(--ggui-color-primary-100)\`)
+- \`ggui-pulse\` \u2014 gentle opacity breathing (infinite, for "live" indicators)
+- \`ggui-bounce\` \u2014 subtle scale overshoot (one-shot, for confirmations)
+
+\`\`\`tsx
+import { MotionKeyframes, useMotion, useAnimationKey } from '@ggui-ai/design';
+import { animation } from '@ggui-ai/design/tokens';
+
+function MyComponent() {
+  const { motionEnabled } = useMotion(); // respects prefers-reduced-motion
+  return (
+    <>
+      <MotionKeyframes />
+      {/* Entrance animation */}
+      <div style={{ animation: motionEnabled ? animation.slideInUp : 'none' }}>
+        Content slides in
+      </div>
+    </>
+  );
+}
+\`\`\`
+
+### Retriggering Animations on Data Changes
+When data updates (e.g., stock price from a stream), CSS animations don't replay automatically.
+Use \`useAnimationKey(dep)\` \u2014 returns a key that increments when \`dep\` changes, causing React to remount the element and replay the animation.
+
+\`\`\`tsx
+import { MotionKeyframes, useAnimationKey } from '@ggui-ai/design';
+import { animation } from '@ggui-ai/design/tokens';
+
+// Flash a stock card green/red when the price changes
+const priceKey = useAnimationKey(stock.price);
+<div
+  key={priceKey}
+  style={{
+    animation: animation.flash,
+    '--ggui-flash-color': stock.change > 0
+      ? 'var(--ggui-color-success-100)'
+      : 'var(--ggui-color-error-100)',
+  } as React.CSSProperties}
+>
+  {stock.price}
+</div>
+\`\`\`
+
+## Chart / Data Visualization Colors
+Semantic chart tokens for data visualizations:
+- \`var(--ggui-color-primary-600)\` \u2014 primary series
+- \`var(--ggui-color-success-500)\` \u2014 positive / success
+- \`var(--ggui-color-error-500)\` \u2014 negative / error
+- \`var(--ggui-color-warning-500)\` \u2014 warning / caution
+- \`var(--ggui-color-info-500)\` \u2014 informational
+- \`var(--ggui-color-neutral-400)\` \u2014 neutral series
+- \`var(--ggui-color-neutral-200)\` \u2014 light background series
+- \`var(--ggui-color-neutral-600)\` \u2014 dark series
+
+## Accessibility Tokens
+
+### Focus Ring (for keyboard focus states)
+- Color: \`var(--ggui-color-primary-600)\`
+- Width: 2px
+- Offset: 2px
+- Style: solid
+\`\`\`tsx
+// Apply to focusable elements:
+outline: '2px solid var(--ggui-color-primary-600)',
+outlineOffset: '2px',
+\`\`\`
+
+### Reduced Motion
+Use \`useMotion()\` hook to check user preference. If disabled, set animation/transition to \`none\`.
+
+## Elevation System
+Semantic depth levels combining shadow + z-index:
+| Level | Shadow | Z-Index | Use For |
+|-------|--------|---------|---------|
+| 0 | none | 0 | Flat content |
+| 1 | sm | auto | Cards, slight lift |
+| 2 | md | 1000 | Dropdowns, popovers |
+| 3 | lg | 1200 | Banners, sticky bars |
+| 4 | xl | 1400 | Modals, dialogs |
+| 5 | 2xl | 1800 | Tooltips, toasts |
+
+\`\`\`tsx
+import { elevation } from '@ggui-ai/design/tokens';
+// elevation.level1 \u2192 { shadow: 'var(--ggui-shape-shadow-sm)', zIndex: 'auto' }
+// elevation.level2 \u2192 { shadow: 'var(--ggui-shape-shadow-md)', zIndex: 1000 }
+<div style={{ boxShadow: elevation.level1.shadow, zIndex: elevation.level1.zIndex }}>
+  Card content
+</div>
+\`\`\`
+
+## Typography Presets
+
+### Heading Styles (import { headingStyles } from '@ggui-ai/design/tokens')
+| Level | Size | Weight | Line Height | Letter Spacing |
+|-------|------|--------|-------------|----------------|
+| h1 | 36px | bold (700) | 1.25 | -0.025em |
+| h2 | 30px | bold (700) | 1.25 | -0.025em |
+| h3 | 24px | semibold (600) | 1.375 | 0 |
+| h4 | 20px | semibold (600) | 1.375 | 0 |
+| h5 | 18px | semibold (600) | 1.5 | 0 |
+| h6 | 16px | semibold (600) | 1.5 | 0 |
+
+### Text Sizing
+\`<Text>\` composes from \`size\` / \`weight\` / \`tone\` (+ \`caps\` for the
+uppercase eyebrow look) \u2014 there is no preset text-style table. Line
+height derives from \`size\` automatically (1.5 for xs-base, 1.625 at lg,
+tighter on display sizes).
+
+### Letter Spacing Scale
+- \`tighter\`: -0.05em
+- \`tight\`: -0.025em
+- \`normal\`: 0
+- \`wide\`: 0.025em
+- \`wider\`: 0.05em
+- \`widest\`: 0.1em
+
+### Line Height Scale
+- \`none\`: 1
+- \`tight\`: 1.25
+- \`snug\`: 1.375
+- \`normal\`: 1.5
+- \`relaxed\`: 1.625
+- \`loose\`: 2`;
+
+export { DEFAULT_DESIGN_SYSTEM_DOCS };
+//# sourceMappingURL=chunk-56NJFD55.js.map
+//# sourceMappingURL=chunk-56NJFD55.js.map