@lostgradient/cinder 0.4.1 → 0.6.0

package/src/components/card/card.css

@@ -19,6 +19,16 @@
     box-shadow: none;
   }
 
+  .cinder-card[data-cinder-tone='danger'] {
+    background: var(--cinder-color-danger-bg);
+    border-color: var(--cinder-color-danger-border);
+    box-shadow: none;
+  }
+
+  .cinder-card[data-cinder-tone='danger'][data-cinder-variant='well'] {
+    background: var(--cinder-color-danger-bg);
+  }
+
   /* ----------------------------------------
  * Header
  * ---------------------------------------- */
@@ -31,10 +41,27 @@
     border-bottom: 1px solid var(--cinder-border-muted);
   }
 
+  .cinder-card[data-cinder-tone='danger'] > .cinder-card__header {
+    border-bottom-color: var(--cinder-color-danger-border);
+  }
+
   /* ----------------------------------------
  * Title & description (title arm)
  * ---------------------------------------- */
 
+  .cinder-card__title-row {
+    display: flex;
+    align-items: center;
+    gap: var(--cinder-space-2);
+    min-inline-size: 0;
+  }
+
+  .cinder-card__risk-icon {
+    display: inline-flex;
+    flex: 0 0 auto;
+    color: var(--cinder-danger);
+  }
+
   .cinder-card__title {
     font-size: var(--cinder-text-sm);
     font-weight: var(--cinder-font-medium);
@@ -42,6 +69,10 @@
     margin: 0;
   }
 
+  .cinder-card[data-cinder-tone='danger'] > .cinder-card__header .cinder-card__title {
+    color: var(--cinder-color-danger-fg);
+  }
+
   .cinder-card__description {
     font-size: var(--cinder-text-sm);
     color: var(--cinder-text-subtle);
@@ -64,7 +95,7 @@
     padding: 0;
   }
 
-  .cinder-card[data-cinder-variant='well'] .cinder-card__body {
+  .cinder-card[data-cinder-variant='well'] > .cinder-card__body {
     background: var(--cinder-surface-inset);
   }
 
@@ -81,10 +112,31 @@
     border-top: 1px solid var(--cinder-border-muted);
   }
 
+  .cinder-card[data-cinder-tone='danger'] > .cinder-card__footer {
+    border-top-color: var(--cinder-color-danger-border);
+  }
+
   .cinder-card__footer[data-cinder-tone='muted'] {
     background: var(--cinder-surface-inset);
   }
 
+  @media (forced-colors: active) {
+    .cinder-card[data-cinder-tone='danger'] {
+      background: Canvas;
+      border-color: CanvasText;
+    }
+
+    .cinder-card[data-cinder-tone='danger'] .cinder-card__header,
+    .cinder-card[data-cinder-tone='danger'] .cinder-card__footer {
+      border-color: CanvasText;
+    }
+
+    .cinder-card[data-cinder-tone='danger'] .cinder-card__title,
+    .cinder-card__risk-icon {
+      color: CanvasText;
+    }
+  }
+
   @media (width < 640px) {
     .cinder-card[data-cinder-edge-to-edge-mobile] {
       --cinder-card-mobile-bleed: var(--cinder-space-4);

package/src/components/card/card.examples.json

@@ -9,6 +9,18 @@
       "description": "A plain bordered card with a single body region.",
       "code": "<script lang=\"ts\">\n  import { Card } from '@lostgradient/cinder/card';\n</script>\n\n<Card>\n  <div\n    style=\"min-block-size: 8rem; border: 1px dashed var(--cinder-border-muted); border-radius: var(--cinder-radius-sm); background: repeating-linear-gradient(-45deg, transparent, transparent 0.5rem, color-mix(in oklch, var(--cinder-border-muted), transparent 70%) 0.5rem, color-mix(in oklch, var(--cinder-border-muted), transparent 70%) 0.5625rem);\"\n  ></div>\n</Card>\n"
     },
+    {
+      "id": "danger-zone-action",
+      "title": "Danger zone action",
+      "description": "A destructive action inside a danger-tone Card with the confirmation flow delegated to ConfirmDialog.",
+      "code": "<script lang=\"ts\">\n  import { Button } from '@lostgradient/cinder/button';\n  import { Card } from '@lostgradient/cinder/card';\n  import { ConfirmDialog } from '@lostgradient/cinder/confirm-dialog';\n\n  let open = $state(false);\n  let triggerRef: HTMLElement | null = $state(null);\n  let deleted = $state(false);\n</script>\n\n<Card\n  tone=\"danger\"\n  title=\"Delete project\"\n  description=\"Permanently removes project settings, review history, and saved automation rules.\"\n>\n  <p style=\"margin: 0; color: var(--cinder-text-subtle); font-size: var(--cinder-text-sm);\">\n    {deleted\n      ? 'The deletion flow completed.'\n      : 'Export any data you need before deleting this project.'}\n  </p>\n\n  {#snippet footer()}\n    <Button\n      variant=\"danger\"\n      label=\"Delete project\"\n      disabled={deleted}\n      onclick={(event) => {\n        triggerRef = event.currentTarget as HTMLElement;\n        open = true;\n      }}\n    />\n  {/snippet}\n</Card>\n\n<ConfirmDialog\n  bind:open\n  {triggerRef}\n  title=\"Delete this project?\"\n  description=\"This action is permanent. Project settings, review history, and automation rules cannot be restored.\"\n  destructive\n  confirmLabel=\"Delete project\"\n  onconfirm={() => (deleted = true)}\n  oncancel={() => (open = false)}\n/>\n"
+    },
+    {
+      "id": "danger-zone-toggle",
+      "title": "Danger zone setting",
+      "description": "A high-risk settings card with container-level danger treatment, a switch, and a confirmation dialog before the risky state is applied.",
+      "code": "<script lang=\"ts\">\n  import { Button } from '@lostgradient/cinder/button';\n  import { Card } from '@lostgradient/cinder/card';\n  import { ConfirmDialog } from '@lostgradient/cinder/confirm-dialog';\n  import { Toggle } from '@lostgradient/cinder/toggle';\n\n  let paused = $state(false);\n  let confirmOpen = $state(false);\n\n  function requestPause(next: boolean): boolean {\n    if (!next) return false;\n    confirmOpen = true;\n    return paused;\n  }\n</script>\n\n<Card\n  tone=\"danger\"\n  title=\"Pause reviews\"\n  description=\"Stops new review dispatch globally. Existing in-flight reviews can finish, but no new work will be assigned until reviews are resumed.\"\n>\n  <div style=\"display: grid; gap: var(--cinder-space-3);\">\n    <Toggle\n      id=\"pause-reviews\"\n      bind:checked={paused}\n      label=\"Reviews paused\"\n      onValueChange={requestPause}\n    />\n    <p style=\"margin: 0; color: var(--cinder-text-subtle); font-size: var(--cinder-text-sm);\">\n      Current state: <strong>{paused ? 'Paused' : 'Dispatching reviews'}</strong>\n    </p>\n  </div>\n\n  {#snippet footer()}\n    {#if paused}\n      <Button variant=\"secondary\" label=\"Resume reviews\" onclick={() => (paused = false)} />\n    {/if}\n  {/snippet}\n</Card>\n\n<ConfirmDialog\n  bind:open={confirmOpen}\n  title=\"Pause review dispatch?\"\n  description=\"This affects every repository connected to the workspace. New reviews will stop until an administrator resumes dispatch.\"\n  destructive\n  confirmLabel=\"Pause reviews\"\n  onconfirm={() => (paused = true)}\n  oncancel={() => (confirmOpen = false)}\n/>\n"
+    },
     {
       "id": "edge-to-edge-mobile",
       "title": "Card, edge-to-edge on mobile",

package/src/components/card/card.schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Primary heading text rendered inside the card's header region."
+    },
+    "variant": {
+      "enum": ["card", "well"],
+      "description": "Visual container style. `card` is raised; `well` is flatter and inset."
+    },
+    "tone": {
+      "enum": ["default", "danger"],
+      "description": "Container risk treatment. `danger` renders a danger-zone surface for high-risk settings or destructive actions."
+    },
+    "bodyTone": {
+      "enum": ["default", "muted"],
+      "description": "Body surface treatment. `muted` renders a grey/inset body region."
+    },
+    "footerTone": {
+      "enum": ["default", "muted"],
+      "description": "Footer surface treatment. `muted` renders a grey/inset footer region."
+    },
+    "edgeToEdgeOnMobile": {
+      "type": "boolean",
+      "description": "Remove side borders/radius and bleed to the viewport edge on narrow screens."
+    },
+    "padding": {
+      "enum": ["none", "default"],
+      "description": "Body padding. `none` removes all padding for flush or full-bleed content (e.g. an image)."
+    },
+    "headingLevel": {
+      "enum": [2, 3, 4, 5, 6],
+      "description": "Heading level for the generated title. Defaults to `3`. Set this so the\ncard title nests correctly within the surrounding document outline."
+    },
+    "description": {
+      "type": "string",
+      "description": "Optional subheading rendered as a paragraph below the title inside the header."
+    }
+  },
+  "additionalProperties": false,
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "children",
+        "reason": "function-or-snippet",
+        "required": true
+      },
+      {
+        "name": "class",
+        "reason": "unknown-shape"
+      },
+      {
+        "name": "footer",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "header",
+        "reason": "function-or-snippet"
+      }
+    ]
+  }
+}

package/src/components/card/card.variables.json

@@ -0,0 +1 @@
+["--cinder-card-mobile-bleed"]

package/src/components/carousel/carousel.css

@@ -0,0 +1,129 @@
+@layer cinder.tokens, cinder.foundation, cinder.components, cinder.utilities;
+@layer cinder.components {
+  .cinder-carousel {
+    display: grid;
+    gap: var(--cinder-space-3);
+  }
+
+  .cinder-carousel__viewport {
+    position: relative;
+    overflow: hidden;
+    border: 1px solid var(--cinder-border-muted);
+    border-radius: var(--cinder-radius-lg);
+    background: var(--cinder-surface-raised);
+  }
+
+  .cinder-carousel__slide {
+    display: grid;
+    gap: var(--cinder-space-3);
+    padding: var(--cinder-space-4);
+  }
+
+  .cinder-carousel__link {
+    display: grid;
+    gap: var(--cinder-space-3);
+    color: inherit;
+    text-decoration: none;
+  }
+
+  .cinder-carousel__image {
+    width: 100%;
+    border-radius: var(--cinder-radius-md);
+    object-fit: cover;
+    aspect-ratio: 16 / 9;
+    background: var(--cinder-surface-inset);
+  }
+
+  .cinder-carousel__title {
+    margin: 0;
+    font: var(--cinder-font-semibold) var(--cinder-text-lg) / 1.3 var(--cinder-font-sans);
+  }
+
+  .cinder-carousel__description {
+    margin: 0;
+    color: var(--cinder-text-muted);
+    line-height: 1.5;
+  }
+
+  .cinder-carousel__controls {
+    display: flex;
+    gap: var(--cinder-space-2);
+    justify-content: space-between;
+    align-items: center;
+    flex-wrap: wrap;
+  }
+
+  .cinder-carousel__nav {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--cinder-space-2);
+  }
+
+  .cinder-carousel__control,
+  .cinder-carousel__dot {
+    appearance: none;
+    border: 1px solid var(--cinder-border-muted);
+    background: var(--cinder-surface);
+    color: inherit;
+    border-radius: var(--cinder-radius-full);
+    cursor: pointer;
+  }
+
+  .cinder-carousel__control {
+    padding: var(--cinder-space-2) var(--cinder-space-3);
+    border-radius: var(--cinder-radius-md);
+    font: inherit;
+  }
+
+  .cinder-carousel__dots {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--cinder-space-2);
+  }
+
+  .cinder-carousel__dot {
+    width: 0.625rem;
+    height: 0.625rem;
+    padding: 0;
+  }
+
+  .cinder-carousel__dot[aria-current='true'] {
+    background: var(--cinder-accent);
+    border-color: var(--cinder-accent);
+  }
+
+  @media (hover: hover) {
+    .cinder-carousel__control:hover,
+    .cinder-carousel__dot:hover {
+      background: var(--cinder-surface-hover);
+    }
+  }
+
+  .cinder-carousel__control:focus-visible,
+  .cinder-carousel__dot:focus-visible {
+    /* cinder-focus-ring-owner: parent */
+    outline: none;
+    box-shadow: 0 0 0 var(--cinder-ring-width) var(--cinder-ring-color);
+  }
+
+  @media (forced-colors: active) {
+    .cinder-carousel__control:focus-visible,
+    .cinder-carousel__dot:focus-visible {
+      outline: var(--cinder-ring-width) solid ButtonText;
+      outline-offset: var(--cinder-ring-width);
+      box-shadow: none;
+    }
+  }
+
+  .cinder-carousel__sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    margin: -1px;
+    padding: 0;
+    border: 0;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+  }
+}

package/src/components/carousel/carousel.examples.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "../../schemas/examples.schema.json",
+  "component": "carousel",
+  "import": "@lostgradient/cinder/carousel",
+  "examples": [
+    {
+      "id": "basic",
+      "title": "Basic carousel",
+      "description": "Prev/next navigation with indicator dots and autoplay support.",
+      "code": "<script lang=\"ts\">\n  import { Carousel } from '@lostgradient/cinder/carousel';\n\n  const autoplayEnabled =\n    typeof window === 'undefined'\n      ? true\n      : new URLSearchParams(window.location.search).get('snapshot') !== '1';\n\n  // Use inline SVG data URIs for deterministic snapshots — no third-party network dependency.\n  const placeholder = (hue: number) =>\n    `data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='1200' height='600'%3E%3Crect width='1200' height='600' fill='hsl(${hue}%2C 40%25%2C 60%25)'/%3E%3C/svg%3E`;\n\n  const slides = [\n    {\n      id: 'intro',\n      label: 'Introduction',\n      title: 'Welcome to cinder',\n      description: 'Start with the core primitives, then compose richer experiences.',\n      imageSrc: placeholder(220),\n      imageAlt: 'Blue placeholder',\n    },\n    {\n      id: 'patterns',\n      label: 'Patterns',\n      title: 'Reusable patterns',\n      description: 'Build consistent navigation, forms, and data views across your product.',\n      imageSrc: placeholder(160),\n      imageAlt: 'Green placeholder',\n    },\n    {\n      id: 'shipping',\n      label: 'Shipping',\n      title: 'Ship faster',\n      description: 'Use robust defaults and only customize what your product needs.',\n      imageSrc: placeholder(290),\n      imageAlt: 'Purple placeholder',\n    },\n  ];\n</script>\n\n<Carousel {slides} autoplay={autoplayEnabled} autoplayInterval={4500} />\n"
+    }
+  ]
+}

package/src/components/carousel/carousel.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "activeIndex": {
+      "type": "number",
+      "description": "Zero-based active index (bindable)."
+    },
+    "autoplay": {
+      "type": "boolean",
+      "description": "Enables interval-based auto-advance."
+    },
+    "autoplayInterval": {
+      "type": "number",
+      "description": "Milliseconds between auto-advance ticks."
+    },
+    "label": {
+      "type": "string",
+      "description": "Accessible name for the carousel region."
+    },
+    "description": {
+      "type": "string",
+      "description": "Optional accessible description linked to the region."
+    },
+    "class": {
+      "type": "string",
+      "description": "Additional classes merged onto the root element."
+    }
+  },
+  "additionalProperties": false,
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "controlLabels",
+        "reason": "unknown-shape",
+        "description": "Override labels for controls and picker."
+      },
+      {
+        "name": "slides",
+        "reason": "unknown-shape",
+        "required": true,
+        "description": "Ordered list of slides."
+      }
+    ]
+  }
+}

package/src/components/carousel/carousel.variables.json

@@ -0,0 +1 @@
+[]

package/src/components/chat/chat.css

@@ -0,0 +1,16 @@
+@layer cinder.tokens, cinder.foundation, cinder.components, cinder.utilities;
+@layer cinder.components {
+  .cinder-chat.chat-container {
+    container-type: inline-size;
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    min-height: 0;
+  }
+
+  .cinder-chat .chat-timeline {
+    flex: 1;
+    min-height: 0;
+    overflow-y: auto;
+  }
+}

package/src/components/chat/chat.examples.json

@@ -13,13 +13,13 @@
       "id": "density-and-variant",
       "title": "Density and variant",
       "description": "Compare comfortable vs compact density and bubble vs flat visual variant on the same conversationalist-shaped transcript.",
-      "code": "<script lang=\"ts\">\n  import {\n    Chat,\n    appendAssistantMessage,\n    appendUserMessage,\n    createConversation,\n  } from '@lostgradient/cinder/chat';\n  import { Select } from '@lostgradient/cinder/select';\n\n  // Build a shared conversationalist-shaped transcript (no Cinder-only fields).\n  const baseConversation = appendAssistantMessage(\n    appendUserMessage(\n      appendAssistantMessage(\n        appendUserMessage(\n          createConversation({ id: 'density-variant-chat' }),\n          'What are the density and variant props for?',\n        ),\n        'The `density` prop controls spacing — `comfortable` uses standard padding and gap, `compact` tightens them for data-dense contexts like embedded side panels.\\n\\nThe `variant` prop controls visual treatment — `bubble` uses colored backgrounds to differentiate roles; `flat` removes backgrounds and relies on alignment and the role label instead.',\n      ),\n      'Does compact affect the action buttons?',\n    ),\n    'No — action buttons keep `min-height: var(--cinder-touch-target-min)` regardless of density. Only padding and gap change.',\n  );\n\n  type Density = 'comfortable' | 'compact';\n  type Variant = 'bubble' | 'flat';\n\n  const densityOptions = [\n    { value: 'comfortable', label: 'comfortable' },\n    { value: 'compact', label: 'compact' },\n  ] satisfies { value: Density; label: string }[];\n\n  const variantOptions = [\n    { value: 'bubble', label: 'bubble' },\n    { value: 'flat', label: 'flat' },\n  ] satisfies { value: Variant; label: string }[];\n\n  let density = $state<Density>('comfortable');\n  let variant = $state<Variant>('bubble');\n</script>\n\n<div style=\"display: grid; gap: 1rem;\">\n  <div style=\"display: flex; gap: 1rem; align-items: flex-end; flex-wrap: wrap;\">\n    <Select id=\"density-select\" bind:value={density} options={densityOptions} label=\"Density\" />\n    <Select id=\"variant-select\" bind:value={variant} options={variantOptions} label=\"Variant\" />\n  </div>\n\n  <div style=\"height: 28rem;\">\n    <Chat\n      id=\"density-variant\"\n      conversation={baseConversation}\n      {density}\n      {variant}\n      capabilities={{ attachments: false }}\n    />\n  </div>\n</div>\n"
+      "code": "<script lang=\"ts\">\n  import {\n    Chat,\n    appendAssistantMessage,\n    appendUserMessage,\n    createConversation,\n  } from '@lostgradient/cinder/chat';\n  import { Select } from '@lostgradient/cinder/select';\n\n  // Build a shared Conversationalist transcript.\n  const baseConversation = appendAssistantMessage(\n    appendUserMessage(\n      appendAssistantMessage(\n        appendUserMessage(\n          createConversation({ id: 'density-variant-chat' }),\n          'What are the density and variant props for?',\n        ),\n        'The `density` prop controls spacing — `comfortable` uses standard padding and gap, `compact` tightens them for data-dense contexts like embedded side panels.\\n\\nThe `variant` prop controls visual treatment — `bubble` uses colored backgrounds to differentiate roles; `flat` removes backgrounds and relies on alignment and the role label instead.',\n      ),\n      'Does compact affect the action buttons?',\n    ),\n    'No — action buttons keep `min-height: var(--cinder-touch-target-min)` regardless of density. Only padding and gap change.',\n  );\n\n  type Density = 'comfortable' | 'compact';\n  type Variant = 'bubble' | 'flat';\n\n  const densityOptions = [\n    { value: 'comfortable', label: 'comfortable' },\n    { value: 'compact', label: 'compact' },\n  ] satisfies { value: Density; label: string }[];\n\n  const variantOptions = [\n    { value: 'bubble', label: 'bubble' },\n    { value: 'flat', label: 'flat' },\n  ] satisfies { value: Variant; label: string }[];\n\n  let density = $state<Density>('comfortable');\n  let variant = $state<Variant>('bubble');\n</script>\n\n<div style=\"display: grid; gap: 1rem;\">\n  <div style=\"display: flex; gap: 1rem; align-items: flex-end; flex-wrap: wrap;\">\n    <Select id=\"density-select\" bind:value={density} options={densityOptions} label=\"Density\" />\n    <Select id=\"variant-select\" bind:value={variant} options={variantOptions} label=\"Variant\" />\n  </div>\n\n  <div style=\"height: 28rem;\">\n    <Chat\n      id=\"density-variant\"\n      conversation={baseConversation}\n      {density}\n      {variant}\n      capabilities={{ attachments: false }}\n    />\n  </div>\n</div>\n"
     },
     {
       "id": "interactive-harness",
       "title": "Interactive harness",
       "description": "Drive Chat from a control panel: reply as the other side (instant / typing / streaming), inject tool calls, toggle features, and watch every callback fire.",
-      "code": "<script lang=\"ts\" module>\n  export const title = 'Interactive harness';\n  export const description =\n    'Drive Chat from a control panel: reply as the other side (instant / typing / streaming), inject tool calls, toggle features, and watch every callback fire.';\n\n  export function createHistoryMessageTimestamp(page: number, index: number): string {\n    return new Date(Date.UTC(2026, 4, 30 - page, 12, index)).toISOString();\n  }\n</script>\n\n<script lang=\"ts\">\n  import {\n    Chat,\n    appendAssistantMessage,\n    appendMessages,\n    appendUserMessage,\n    createConversation,\n    type ChatSubmitEvent,\n    type ConversationHistory,\n    type JSONValue,\n    type Message,\n    type ToolErrorCategory,\n  } from '@lostgradient/cinder/chat';\n  import { Button } from '@lostgradient/cinder/button';\n  import { Input } from '@lostgradient/cinder/input';\n  import { Segment } from '@lostgradient/cinder/segment';\n  import { SegmentedControl } from '@lostgradient/cinder/segmented-control';\n  import { Select } from '@lostgradient/cinder/select';\n  import { Textarea } from '@lostgradient/cinder/textarea';\n  import { Toggle } from '@lostgradient/cinder/toggle';\n  import { onDestroy } from 'svelte';\n\n  // Out of scope for this harness (documented, not silently dropped):\n  // bottomThreshold / jumpThreshold (kept at defaults so overflow + jump are\n  // testable without tuning), viewportAttachment (advanced escape hatch), and\n  // the atBottom / unreadCount / newMessageIndicatorVisible bindables (read-only\n  // mirrors of behavior the wired callbacks already surface).\n\n  // --- Chat instance (for the imperative streaming + scroll API) ---\n  // Plain `let`: only read via `chat?.method()` calls, never reactively.\n  let chat: ReturnType<typeof Chat> | undefined;\n\n  // --- Conversation state (immutable snapshots via the cinder/chat builders) ---\n  let conversation = $state<ConversationHistory>(createConversation({ id: 'harness' }));\n\n  // --- Feature toggles wired straight onto <Chat> ---\n  let attachments = $state(true);\n  let search = $state(true);\n  let copy = $state(true);\n  let editing = $state(true);\n  let retry = $state(true);\n  let transparentSurface = $state(false);\n  let withEmptyPrompts = $state(true);\n  let autoReply = $state(true);\n  let virtualized = $state(false);\n  let historyEnabled = $state(false);\n  let historyPage = 0;\n\n  // --- Reply controls ---\n  let replyText = $state('Here is the answer, delivered in a few deliberate chunks.');\n  let replyMode = $state<'instant' | 'typing' | 'streaming'>('typing');\n  let streamMechanism = $state<'imperative' | 'content-mutation'>('imperative');\n  let streaming = $state(false);\n  let streamingStatus = $state('');\n\n  // --- Tool-call controls ---\n  let toolName = $state('exports_check');\n  let toolArguments = $state('{ \"package\": \"@lostgradient/cinder\" }');\n  let toolOutcome = $state<'success' | 'error' | 'action_required'>('success');\n  const parsedToolArguments = $derived.by<{ ok: boolean; value: JSONValue }>(() => {\n    try {\n      return { ok: true, value: JSON.parse(toolArguments) as JSONValue };\n    } catch {\n      return { ok: false, value: null };\n    }\n  });\n\n  // --- Event log (queryable: data-event + data-payload per entry) ---\n  // Chat emits a burst of identical onunreadindicatorchange events while its\n  // empty state settles on mount (all `{unreadCount:0, newMessageIndicatorVisible:\n  // false}`). We de-duplicate: a callback whose (event, payload) is identical to\n  // the most recent entry for that event is dropped. That kills the mount noise\n  // deterministically (no timing dependency) while still recording every real,\n  // distinct callback so tests can assert \"this fired because of my action\".\n  type LogEntry = { id: number; event: string; payload: string };\n  let log = $state<LogEntry[]>([]);\n  let logCounter = 0;\n  const lastPayloadByEvent = new Map<string, string>();\n  function record(event: string, payload: unknown = ''): void {\n    const text = typeof payload === 'string' ? payload : JSON.stringify(payload);\n    if (lastPayloadByEvent.get(event) === text) return;\n    lastPayloadByEvent.set(event, text);\n    logCounter += 1;\n    log = [{ id: logCounter, event, payload: text }, ...log].slice(0, 50);\n  }\n\n  // --- Pending-operation discipline (instance-local; NEVER module scope) ---\n  // A single in-flight typing/streaming op at a time. Timers are tracked so we\n  // can cancel deterministically; streamingPartial holds the accumulated text so\n  // Stop can preserve it.\n  let pendingTimers = new Set<ReturnType<typeof setTimeout>>();\n  // Plain `let`: read only inside the streaming functions, never in the\n  // template (the assistant message content comes from `conversation`).\n  let streamingPartial = '';\n  let streamingMessageId: string | null = null;\n  // Monotonic token identifying the current stream/typing op. Each scheduled\n  // chunk captures the token active when it was queued and bails if a newer op\n  // has started — so an already-dequeued timer can't write into a fresh stream.\n  let activeOperation = 0;\n\n  function later(callback: () => void, delay: number): void {\n    const handle = setTimeout(() => {\n      pendingTimers.delete(handle);\n      callback();\n    }, delay);\n    pendingTimers.add(handle);\n  }\n\n  function clearTimers(): void {\n    for (const handle of pendingTimers) clearTimeout(handle);\n    pendingTimers.clear();\n  }\n\n  /**\n   * Cancel the in-flight op. Modes differ in how they treat partial content:\n   * - preservePartial (Stop): keep what streamed so far, commit it to the message.\n   * - discard (Clear / Seed / mode switch / new reply): drop the in-flight\n   *   (possibly empty) assistant message so no blank bubble is left behind.\n   * - destroy (onDestroy): just clear timers.\n   */\n  function cancelPending(mode: 'preservePartial' | 'discard' | 'destroy'): void {\n    clearTimers();\n    // Invalidate the current op so any timer callback already dequeued (past\n    // clearTimers) bails instead of mutating freshly-reset state.\n    activeOperation += 1;\n    if (mode === 'destroy') return;\n\n    if (streamingMessageId) {\n      if (mode === 'preservePartial') {\n        conversation = replaceMessageContent(conversation, streamingMessageId, streamingPartial);\n      } else {\n        conversation = removeMessage(conversation, streamingMessageId);\n      }\n      chat?.endStreaming();\n    }\n    streamingMessageId = null;\n    streamingPartial = '';\n    streaming = false;\n    streamingStatus = '';\n  }\n\n  // --- Immutable message helpers (replace/remove by id) ---\n  function replaceMessageContent(\n    current: ConversationHistory,\n    id: string,\n    content: string,\n  ): ConversationHistory {\n    const existing = current.messages[id];\n    if (!existing) return current;\n    return {\n      ...current,\n      messages: { ...current.messages, [id]: { ...existing, content } },\n      updatedAt: new Date().toISOString(),\n    };\n  }\n\n  function removeMessage(current: ConversationHistory, id: string): ConversationHistory {\n    if (!current.messages[id]) return current;\n    const messages = { ...current.messages };\n    delete messages[id];\n    return {\n      ...current,\n      ids: current.ids.filter((existing) => existing !== id),\n      messages,\n      updatedAt: new Date().toISOString(),\n    };\n  }\n\n  function lastMessageId(current: ConversationHistory): string {\n    return current.ids[current.ids.length - 1] ?? '';\n  }\n\n  function prependHistoryMessages(current: ConversationHistory): ConversationHistory {\n    historyPage += 1;\n    const olderMessages: Message[] = Array.from({ length: 6 }, (_, index) => {\n      const id = `older-${historyPage}-${index}`;\n      return {\n        id,\n        role: index % 2 === 0 ? 'user' : 'assistant',\n        content: `Earlier context ${historyPage}.${index + 1}`,\n        position: index,\n        createdAt: createHistoryMessageTimestamp(historyPage, index),\n        metadata: {},\n        hidden: false,\n      };\n    });\n    const messages = Object.fromEntries(olderMessages.map((message) => [message.id, message]));\n    for (const [index, id] of current.ids.entries()) {\n      const message = current.messages[id];\n      if (message) {\n        messages[id] = { ...message, position: olderMessages.length + index };\n      }\n    }\n    return {\n      ...current,\n      ids: [...olderMessages.map((message) => message.id), ...current.ids],\n      messages,\n      updatedAt: new Date().toISOString(),\n    };\n  }\n\n  // --- Reply as the other side ---\n  function sendReply(text: string): void {\n    const trimmed = text.trim();\n    if (!trimmed) return;\n    cancelPending('discard');\n    // Start a new operation; stale timers from a prior op will no longer match.\n    const operation = ++activeOperation;\n\n    if (replyMode === 'instant') {\n      conversation = appendAssistantMessage(conversation, trimmed);\n      return;\n    }\n\n    if (replyMode === 'typing') {\n      streaming = true;\n      streamingStatus = 'Assistant is typing…';\n      // A deliberately long-ish window so the \"typing\" state is comfortably\n      // observable (by a person and by a test) before the reply lands.\n      later(() => {\n        if (operation !== activeOperation) return;\n        streaming = false;\n        streamingStatus = '';\n        conversation = appendAssistantMessage(conversation, trimmed);\n      }, 1200);\n      return;\n    }\n\n    // streaming: append one empty assistant message, then grow ITS content.\n    conversation = appendAssistantMessage(conversation, '');\n    const messageId = lastMessageId(conversation);\n    streamingMessageId = messageId;\n    streamingPartial = '';\n    // `streaming` drives the composer's Stop affordance for BOTH mechanisms;\n    // only `beginStreaming()` (the rAF-buffered token path) is imperative-only.\n    streaming = true;\n    streamingStatus = 'Streaming…';\n    if (streamMechanism === 'imperative') {\n      chat?.beginStreaming(messageId);\n    }\n    // Deterministic cadence: a fixed number of chunks at a fixed delay so an\n    // intermediate partial state is reliably observable before completion.\n    const chunks = splitIntoChunks(trimmed, 5);\n    streamChunk(chunks, 0, activeOperation);\n  }\n\n  function streamChunk(chunks: string[], index: number, operation: number): void {\n    // A newer reply/clear/seed started — this is a stale continuation, bail.\n    if (operation !== activeOperation) return;\n\n    if (index >= chunks.length) {\n      // Commit the final content into the message, then end the stream.\n      conversation = replaceMessageContent(\n        conversation,\n        streamingMessageId ?? '',\n        streamingPartial,\n      );\n      if (streamMechanism === 'imperative') chat?.endStreaming();\n      streamingMessageId = null;\n      streaming = false;\n      streamingStatus = '';\n      return;\n    }\n    const chunk = chunks[index] ?? '';\n    streamingPartial += chunk;\n    if (streamMechanism === 'imperative') {\n      chat?.pushToken(chunk);\n    } else {\n      conversation = replaceMessageContent(\n        conversation,\n        streamingMessageId ?? '',\n        streamingPartial,\n      );\n    }\n    later(() => streamChunk(chunks, index + 1, operation), 120);\n  }\n\n  function splitIntoChunks(text: string, count: number): string[] {\n    const words = text.split(' ');\n    const perChunk = Math.max(1, Math.ceil(words.length / count));\n    const chunks: string[] = [];\n    for (let index = 0; index < words.length; index += perChunk) {\n      const slice = words.slice(index, index + perChunk).join(' ');\n      chunks.push(index === 0 ? slice : ` ${slice}`);\n    }\n    return chunks;\n  }\n\n  // --- Inject a tool call + paired result (all outcomes) ---\n  function injectToolCall(): void {\n    if (!parsedToolArguments.ok) return;\n    // Unique per injection — deriving from logCounter would reuse the same id\n    // for repeated injections that don't add a log entry, breaking pairing.\n    const callId = `call-${crypto.randomUUID()}`;\n    const result =\n      toolOutcome === 'error'\n        ? {\n            callId,\n            outcome: 'error' as const,\n            content: null,\n            error: {\n              code: 'tool_failed',\n              category: 'transient' as ToolErrorCategory,\n              retryable: true,\n              message: 'The tool failed: upstream returned a transient error.',\n            },\n          }\n        : toolOutcome === 'action_required'\n          ? {\n              callId,\n              outcome: 'action_required' as const,\n              content: null,\n              action: {\n                type: 'approval' as const,\n                message: 'Approve running this tool before it executes?',\n              },\n            }\n          : { callId, outcome: 'success' as const, content: { status: 'ok' } };\n\n    conversation = appendMessages(\n      conversation,\n      {\n        role: 'tool-call',\n        content: '',\n        toolCall: { id: callId, name: toolName, arguments: parsedToolArguments.value },\n      },\n      { role: 'tool-result', content: '', toolResult: result },\n    );\n  }\n\n  // --- Seed / clear ---\n  function seedThread(): void {\n    cancelPending('discard');\n    let next = createConversation({ id: 'harness-seeded' });\n    // Repeated token \"alpha\" for deterministic search assertions, plus enough\n    // messages to overflow the fixed-height viewport.\n    next = appendUserMessage(next, 'Tell me about alpha.');\n    next = appendAssistantMessage(next, 'alpha is the first item we track.');\n    for (let index = 0; index < 12; index += 1) {\n      next = appendUserMessage(next, `Follow-up question number ${index + 1}.`);\n      next = appendAssistantMessage(\n        next,\n        `Detailed answer number ${index + 1}, with alpha context.`,\n      );\n    }\n    conversation = next;\n  }\n\n  function seedFailedMessage(): void {\n    conversation = appendMessages(conversation, {\n      role: 'user',\n      content: 'This message failed to send.',\n      metadata: { _deliveryStatus: 'failed' },\n    });\n  }\n\n  function clearConversation(): void {\n    cancelPending('discard');\n    conversation = createConversation({ id: 'harness-cleared' });\n    historyPage = 0;\n  }\n\n  // --- Chat callbacks ---\n  function handleSubmit(event: ChatSubmitEvent): void {\n    const content = typeof event.message.content === 'string' ? event.message.content : '';\n    record('onsubmit', content);\n    conversation = appendMessages(conversation, {\n      role: 'user',\n      content: event.message.content,\n    });\n    if (autoReply) sendReply(replyText);\n  }\n\n  function handleEdit(event: { messageId: string; content: string }): void {\n    record('onedit', event);\n    conversation = replaceMessageContent(conversation, event.messageId, event.content);\n  }\n\n  async function handleLoadHistory(): Promise<void> {\n    conversation = prependHistoryMessages(conversation);\n    record('onloadhistory', historyPage);\n  }\n\n  onDestroy(() => cancelPending('destroy'));\n\n  const surfaceMode = $derived<'default' | 'transparent'>(\n    transparentSurface ? 'transparent' : 'default',\n  );\n  // `emptyPrompts` is included only when ON. Under exactOptionalPropertyTypes an\n  // optional prop must be omitted, not passed as `undefined`, so spread it\n  // conditionally rather than passing `emptyPrompts={undefined}`.\n  const emptyPromptsProp = $derived(\n    withEmptyPrompts ? { emptyPrompts: ['Tell me about alpha', 'Summarize the thread'] } : {},\n  );\n  const historyProps = $derived(\n    historyEnabled ? { moreHistoryAvailable: true, onloadhistory: handleLoadHistory } : {},\n  );\n</script>\n\n<div style=\"display: grid; grid-template-columns: 22rem 1fr; gap: 1rem; align-items: start;\">\n  <!-- Control panel -->\n  <div\n    data-testid=\"harness-controls\"\n    style=\"display: grid; gap: 1rem; padding: 1rem; border: 1px solid var(--cinder-border-muted); border-radius: var(--cinder-radius-md); background: var(--cinder-surface-inset);\"\n  >\n    <section style=\"display: grid; gap: 0.5rem;\">\n      <strong>Reply as the other side</strong>\n      <Textarea\n        id=\"harness-reply-text\"\n        data-testid=\"reply-text\"\n        label=\"Reply text\"\n        bind:value={replyText}\n        rows={2}\n      />\n      <SegmentedControl\n        id=\"harness-reply-mode\"\n        selectionMode=\"single\"\n        bind:value={replyMode}\n        label=\"Reply mode\"\n      >\n        <Segment value=\"instant\">Instant</Segment>\n        <Segment value=\"typing\">Typing</Segment>\n        <Segment value=\"streaming\">Streaming</Segment>\n      </SegmentedControl>\n      {#if replyMode === 'streaming'}\n        <SegmentedControl\n          id=\"harness-stream-mechanism\"\n          selectionMode=\"single\"\n          bind:value={streamMechanism}\n          label=\"Streaming mechanism\"\n        >\n          <Segment value=\"imperative\">Imperative</Segment>\n          <Segment value=\"content-mutation\">Content</Segment>\n        </SegmentedControl>\n      {/if}\n      <Button data-testid=\"send-reply\" onclick={() => sendReply(replyText)}>Send reply</Button>\n    </section>\n\n    <section style=\"display: grid; gap: 0.5rem;\">\n      <strong>Inject tool call</strong>\n      <Input\n        id=\"harness-tool-name\"\n        data-testid=\"tool-name\"\n        label=\"Tool name\"\n        bind:value={toolName}\n      />\n      <Textarea\n        id=\"harness-tool-arguments\"\n        data-testid=\"tool-arguments\"\n        label=\"Tool arguments (JSON)\"\n        bind:value={toolArguments}\n        rows={2}\n      />\n      {#if !parsedToolArguments.ok}\n        <span\n          data-testid=\"tool-arguments-error\"\n          style=\"color: var(--cinder-danger); font-size: var(--cinder-text-xs);\"\n        >\n          Arguments must be valid JSON.\n        </span>\n      {/if}\n      <Select\n        id=\"harness-tool-outcome\"\n        label=\"Outcome\"\n        bind:value={toolOutcome}\n        options={[\n          { value: 'success', label: 'success' },\n          { value: 'error', label: 'error' },\n          { value: 'action_required', label: 'action_required' },\n        ]}\n      />\n      <Button data-testid=\"inject-tool\" disabled={!parsedToolArguments.ok} onclick={injectToolCall}>\n        Inject tool call\n      </Button>\n    </section>\n\n    <section style=\"display: grid; gap: 0.4rem;\">\n      <strong>Features</strong>\n      <Toggle id=\"t-attachments\" label=\"attachments\" bind:checked={attachments} />\n      <Toggle id=\"t-search\" label=\"search\" bind:checked={search} />\n      <Toggle id=\"t-copy\" label=\"copy\" bind:checked={copy} />\n      <Toggle id=\"t-editing\" label=\"editing\" bind:checked={editing} />\n      <Toggle id=\"t-retry\" label=\"retry\" bind:checked={retry} />\n      <Toggle id=\"t-surface\" label=\"transparent surface\" bind:checked={transparentSurface} />\n      <Toggle id=\"t-prompts\" label=\"emptyPrompts\" bind:checked={withEmptyPrompts} />\n      <Toggle id=\"t-autoreply\" label=\"auto-reply on submit\" bind:checked={autoReply} />\n      <Toggle id=\"t-virtualized\" label=\"virtualized transcript\" bind:checked={virtualized} />\n      <Toggle id=\"t-history\" label=\"history pagination\" bind:checked={historyEnabled} />\n    </section>\n\n    <section style=\"display: grid; gap: 0.4rem;\">\n      <strong>State</strong>\n      <Button data-testid=\"seed-thread\" variant=\"secondary\" onclick={seedThread}\n        >Seed sample thread</Button\n      >\n      <Button data-testid=\"seed-failed\" variant=\"secondary\" onclick={seedFailedMessage}\n        >Seed failed message</Button\n      >\n      <Button data-testid=\"clear\" variant=\"secondary\" onclick={clearConversation}>Clear</Button>\n      <Button data-testid=\"scroll-top\" variant=\"ghost\" onclick={() => chat?.scrollToTop()}\n        >Scroll to top</Button\n      >\n      <Button data-testid=\"scroll-bottom\" variant=\"ghost\" onclick={() => chat?.scrollToBottom()}\n        >Scroll to bottom</Button\n      >\n      <Button data-testid=\"focus-input\" variant=\"ghost\" onclick={() => chat?.focusInput()}\n        >Focus composer</Button\n      >\n    </section>\n\n    <section style=\"display: grid; gap: 0.25rem;\">\n      <strong>Event log</strong>\n      <!-- tabindex=0 gives the scrollable region keyboard access (axe\n           scrollable-region-focusable). A group label names it without a `log`\n           role, which would collide with the chat timeline's own role=\"log\".\n           svelte:element keeps the rendered DOM as a div while avoiding the\n           static a11y warning for this focusable scroll-region pattern. -->\n      <svelte:element\n        this={'div'}\n        data-testid=\"event-log\"\n        role=\"group\"\n        aria-label=\"Event log\"\n        tabindex={0}\n        style=\"display: grid; gap: 0.15rem; max-height: 10rem; overflow: auto; font-size: var(--cinder-text-xs); font-family: var(--cinder-font-mono);\"\n      >\n        {#each log as entry (entry.id)}\n          <div data-testid=\"event-log-entry\" data-event={entry.event} data-payload={entry.payload}>\n            {entry.event}: {entry.payload}\n          </div>\n        {/each}\n      </svelte:element>\n    </section>\n  </div>\n\n  <!-- The Chat under test, in a fixed-height box so the thread overflows. -->\n  <div style=\"height: 34rem;\">\n    <Chat\n      bind:this={chat}\n      id=\"harness-chat\"\n      {conversation}\n      {streaming}\n      {streamingStatus}\n      capabilities={{ attachments, search, copy, editing, retry }}\n      {surfaceMode}\n      {virtualized}\n      virtualizationEstimatedRowHeight={72}\n      virtualizationInitialHeight={480}\n      virtualizationOverscan={2}\n      {...emptyPromptsProp}\n      {...historyProps}\n      onsubmit={handleSubmit}\n      onedit={handleEdit}\n      onretry={(messageId: string) => record('onretry', messageId)}\n      onstopgenerating={(event: { messageId: string }) => {\n        cancelPending('preservePartial');\n        record('onstopgenerating', event.messageId);\n      }}\n      onjumptolatest={() => record('onjumptolatest')}\n      onscrollstatechange={(event: { atBottom: boolean }) =>\n        record('onscrollstatechange', { atBottom: event.atBottom })}\n      onunreadindicatorchange={(event: {\n        unreadCount: number;\n        newMessageIndicatorVisible: boolean;\n      }) => record('onunreadindicatorchange', event)}\n      onexpandedchange={(expanded: boolean) => record('onexpandedchange', { expanded })}\n      onattachmentadd={(attachment: { id: string }) => record('onattachmentadd', attachment.id)}\n      onattachmentremove={(attachment: { id: string }) =>\n        record('onattachmentremove', attachment.id)}\n      onattachmentfailure={(_file: File, error: string) => record('onattachmentfailure', error)}\n    >\n      {#snippet header()}\n        <div\n          data-testid=\"harness-header\"\n          style=\"padding: 0.5rem 0.75rem; font-weight: var(--cinder-font-semibold);\"\n        >\n          Harness conversation\n        </div>\n      {/snippet}\n      {#snippet messageActions(message: Message)}\n        <Button\n          iconOnly={true}\n          label=\"Message action\"\n          size=\"xs\"\n          variant=\"ghost\"\n          data-testid=\"harness-message-action\"\n          data-message-id={message.id}\n        >\n          ★\n        </Button>\n      {/snippet}\n      {#snippet messageStatus(message: Message)}\n        <span data-testid=\"harness-message-status\" data-message-id={message.id}>·</span>\n      {/snippet}\n    </Chat>\n  </div>\n</div>\n"
+      "code": "<script lang=\"ts\" module>\n  export const title = 'Interactive harness';\n  export const description =\n    'Drive Chat from a control panel: reply as the other side (instant / typing / streaming), inject tool calls, toggle features, and watch every callback fire.';\n\n  export function createHistoryMessageTimestamp(page: number, index: number): string {\n    return new Date(Date.UTC(2026, 4, 30 - page, 12, index)).toISOString();\n  }\n</script>\n\n<script lang=\"ts\">\n  import {\n    Chat,\n    appendAssistantMessage,\n    appendMessages,\n    appendUserMessage,\n    createConversation,\n    type ChatSubmitEvent,\n    type ConversationHistory,\n    type JSONValue,\n    type Message,\n    type ToolErrorCategory,\n  } from '@lostgradient/cinder/chat';\n  import { Button } from '@lostgradient/cinder/button';\n  import { Input } from '@lostgradient/cinder/input';\n  import { Segment } from '@lostgradient/cinder/segment';\n  import { SegmentedControl } from '@lostgradient/cinder/segmented-control';\n  import { Select } from '@lostgradient/cinder/select';\n  import { Textarea } from '@lostgradient/cinder/textarea';\n  import { Toggle } from '@lostgradient/cinder/toggle';\n  import { onDestroy } from 'svelte';\n\n  // Out of scope for this harness (documented, not silently dropped):\n  // bottomThreshold / jumpThreshold (kept at defaults so overflow + jump are\n  // testable without tuning), viewportAttachment (advanced escape hatch), and\n  // the atBottom / unreadCount / newMessageIndicatorVisible bindables (read-only\n  // mirrors of behavior the wired callbacks already surface).\n\n  // --- Chat instance (for the imperative streaming + scroll API) ---\n  // Plain `let`: only read via `chat?.method()` calls, never reactively.\n  let chat: ReturnType<typeof Chat> | undefined;\n\n  // --- Conversation state (immutable snapshots via the cinder/chat builders) ---\n  let conversation = $state<ConversationHistory>(createConversation({ id: 'harness' }));\n\n  // --- Feature toggles wired straight onto <Chat> ---\n  let attachments = $state(true);\n  let search = $state(true);\n  let copy = $state(true);\n  let editing = $state(true);\n  let retry = $state(true);\n  let transparentSurface = $state(false);\n  let withEmptyPrompts = $state(true);\n  let autoReply = $state(true);\n  let virtualized = $state(false);\n  let historyEnabled = $state(false);\n  let historyPage = 0;\n\n  // --- Reply controls ---\n  let replyText = $state('Here is the answer, delivered in a few deliberate chunks.');\n  let replyMode = $state<'instant' | 'typing' | 'streaming'>('typing');\n  let streamMechanism = $state<'imperative' | 'content-mutation'>('imperative');\n  let streaming = $state(false);\n  let streamingStatus = $state('');\n\n  // --- Tool-call controls ---\n  let toolName = $state('exports_check');\n  let toolArguments = $state('{ \"package\": \"@lostgradient/cinder\" }');\n  let toolOutcome = $state<'success' | 'error' | 'action_required'>('success');\n  const parsedToolArguments = $derived.by<{ ok: boolean; value: JSONValue }>(() => {\n    try {\n      return { ok: true, value: JSON.parse(toolArguments) as JSONValue };\n    } catch {\n      return { ok: false, value: null };\n    }\n  });\n\n  // --- Event log (queryable: data-event + data-payload per entry) ---\n  // Chat emits a burst of identical onunreadindicatorchange events while its\n  // empty state settles on mount (all `{unreadCount:0, newMessageIndicatorVisible:\n  // false}`). We de-duplicate: a callback whose (event, payload) is identical to\n  // the most recent entry for that event is dropped. That kills the mount noise\n  // deterministically (no timing dependency) while still recording every real,\n  // distinct callback so tests can assert \"this fired because of my action\".\n  type LogEntry = { id: number; event: string; payload: string };\n  let log = $state<LogEntry[]>([]);\n  let logCounter = 0;\n  const lastPayloadByEvent = new Map<string, string>();\n  function record(event: string, payload: unknown = ''): void {\n    const text = typeof payload === 'string' ? payload : JSON.stringify(payload);\n    if (lastPayloadByEvent.get(event) === text) return;\n    lastPayloadByEvent.set(event, text);\n    logCounter += 1;\n    log = [{ id: logCounter, event, payload: text }, ...log].slice(0, 50);\n  }\n\n  // --- Pending-operation discipline (instance-local; NEVER module scope) ---\n  // A single in-flight typing/streaming op at a time. Timers are tracked so we\n  // can cancel deterministically; streamingPartial holds the accumulated text so\n  // Stop can preserve it.\n  let pendingTimers = new Set<ReturnType<typeof setTimeout>>();\n  // Plain `let`: read only inside the streaming functions, never in the\n  // template (the assistant message content comes from `conversation`).\n  let streamingPartial = '';\n  let streamingMessageId: string | null = null;\n  // Monotonic token identifying the current stream/typing op. Each scheduled\n  // chunk captures the token active when it was queued and bails if a newer op\n  // has started — so an already-dequeued timer can't write into a fresh stream.\n  let activeOperation = 0;\n\n  function later(callback: () => void, delay: number): void {\n    const handle = setTimeout(() => {\n      pendingTimers.delete(handle);\n      callback();\n    }, delay);\n    pendingTimers.add(handle);\n  }\n\n  function clearTimers(): void {\n    for (const handle of pendingTimers) clearTimeout(handle);\n    pendingTimers.clear();\n  }\n\n  /**\n   * Cancel the in-flight op. Modes differ in how they treat partial content:\n   * - preservePartial (Stop): keep what streamed so far, commit it to the message.\n   * - discard (Clear / Seed / mode switch / new reply): drop the in-flight\n   *   (possibly empty) assistant message so no blank bubble is left behind.\n   * - destroy (onDestroy): just clear timers.\n   */\n  function cancelPending(mode: 'preservePartial' | 'discard' | 'destroy'): void {\n    clearTimers();\n    // Invalidate the current op so any timer callback already dequeued (past\n    // clearTimers) bails instead of mutating freshly-reset state.\n    activeOperation += 1;\n    if (mode === 'destroy') return;\n\n    if (streamingMessageId) {\n      if (mode === 'preservePartial') {\n        conversation = replaceMessageContent(conversation, streamingMessageId, streamingPartial);\n      } else {\n        conversation = removeMessage(conversation, streamingMessageId);\n      }\n      chat?.endStreaming();\n    }\n    streamingMessageId = null;\n    streamingPartial = '';\n    streaming = false;\n    streamingStatus = '';\n  }\n\n  // --- Immutable message helpers (replace/remove by id) ---\n  function replaceMessageContent(\n    current: ConversationHistory,\n    id: string,\n    content: string,\n  ): ConversationHistory {\n    const existing = current.messages[id];\n    if (!existing) return current;\n    return {\n      ...current,\n      messages: { ...current.messages, [id]: { ...existing, content } },\n      updatedAt: new Date().toISOString(),\n    };\n  }\n\n  function removeMessage(current: ConversationHistory, id: string): ConversationHistory {\n    if (!current.messages[id]) return current;\n    const messages = { ...current.messages };\n    delete messages[id];\n    return {\n      ...current,\n      ids: current.ids.filter((existing) => existing !== id),\n      messages,\n      updatedAt: new Date().toISOString(),\n    };\n  }\n\n  function lastMessageId(current: ConversationHistory): string {\n    return current.ids[current.ids.length - 1] ?? '';\n  }\n\n  function prependHistoryMessages(current: ConversationHistory): ConversationHistory {\n    historyPage += 1;\n    const olderMessages: Message[] = Array.from({ length: 6 }, (_, index) => {\n      const id = `older-${historyPage}-${index}`;\n      return {\n        id,\n        role: index % 2 === 0 ? 'user' : 'assistant',\n        content: `Earlier context ${historyPage}.${index + 1}`,\n        position: index,\n        createdAt: createHistoryMessageTimestamp(historyPage, index),\n        metadata: {},\n        hidden: false,\n      };\n    });\n    const messages = Object.fromEntries(olderMessages.map((message) => [message.id, message]));\n    for (const [index, id] of current.ids.entries()) {\n      const message = current.messages[id];\n      if (message) {\n        messages[id] = { ...message, position: olderMessages.length + index };\n      }\n    }\n    return {\n      ...current,\n      ids: [...olderMessages.map((message) => message.id), ...current.ids],\n      messages,\n      updatedAt: new Date().toISOString(),\n    };\n  }\n\n  // --- Reply as the other side ---\n  function sendReply(text: string): void {\n    const trimmed = text.trim();\n    if (!trimmed) return;\n    cancelPending('discard');\n    // Start a new operation; stale timers from a prior op will no longer match.\n    const operation = ++activeOperation;\n\n    if (replyMode === 'instant') {\n      conversation = appendAssistantMessage(conversation, trimmed);\n      return;\n    }\n\n    if (replyMode === 'typing') {\n      streaming = true;\n      streamingStatus = 'Assistant is typing…';\n      // A deliberately long-ish window so the \"typing\" state is comfortably\n      // observable (by a person and by a test) before the reply lands.\n      later(() => {\n        if (operation !== activeOperation) return;\n        streaming = false;\n        streamingStatus = '';\n        conversation = appendAssistantMessage(conversation, trimmed);\n      }, 1200);\n      return;\n    }\n\n    // streaming: append one empty assistant message, then grow ITS content.\n    conversation = appendAssistantMessage(conversation, '');\n    const messageId = lastMessageId(conversation);\n    streamingMessageId = messageId;\n    streamingPartial = '';\n    // `streaming` drives the composer's Stop affordance for BOTH mechanisms;\n    // only `beginStreaming()` (the rAF-buffered token path) is imperative-only.\n    streaming = true;\n    streamingStatus = 'Streaming…';\n    if (streamMechanism === 'imperative') {\n      chat?.beginStreaming(messageId);\n    }\n    // Deterministic cadence: a fixed number of chunks at a fixed delay so an\n    // intermediate partial state is reliably observable before completion.\n    const chunks = splitIntoChunks(trimmed, 5);\n    streamChunk(chunks, 0, activeOperation);\n  }\n\n  function streamChunk(chunks: string[], index: number, operation: number): void {\n    // A newer reply/clear/seed started — this is a stale continuation, bail.\n    if (operation !== activeOperation) return;\n\n    if (index >= chunks.length) {\n      // Commit the final content into the message, then end the stream.\n      conversation = replaceMessageContent(\n        conversation,\n        streamingMessageId ?? '',\n        streamingPartial,\n      );\n      if (streamMechanism === 'imperative') chat?.endStreaming();\n      streamingMessageId = null;\n      streaming = false;\n      streamingStatus = '';\n      return;\n    }\n    const chunk = chunks[index] ?? '';\n    streamingPartial += chunk;\n    if (streamMechanism === 'imperative') {\n      chat?.pushToken(chunk);\n    } else {\n      conversation = replaceMessageContent(\n        conversation,\n        streamingMessageId ?? '',\n        streamingPartial,\n      );\n    }\n    later(() => streamChunk(chunks, index + 1, operation), 120);\n  }\n\n  function splitIntoChunks(text: string, count: number): string[] {\n    const words = text.split(' ');\n    const perChunk = Math.max(1, Math.ceil(words.length / count));\n    const chunks: string[] = [];\n    for (let index = 0; index < words.length; index += perChunk) {\n      const slice = words.slice(index, index + perChunk).join(' ');\n      chunks.push(index === 0 ? slice : ` ${slice}`);\n    }\n    return chunks;\n  }\n\n  // --- Inject a tool call + paired result (all outcomes) ---\n  function injectToolCall(): void {\n    if (!parsedToolArguments.ok) return;\n    // Unique per injection — deriving from logCounter would reuse the same id\n    // for repeated injections that don't add a log entry, breaking pairing.\n    const callId = `call-${crypto.randomUUID()}`;\n    const result =\n      toolOutcome === 'error'\n        ? {\n            callId,\n            outcome: 'error' as const,\n            content: null,\n            error: {\n              code: 'tool_failed',\n              category: 'transient' as ToolErrorCategory,\n              retryable: true,\n              message: 'The tool failed: upstream returned a transient error.',\n            },\n          }\n        : toolOutcome === 'action_required'\n          ? {\n              callId,\n              outcome: 'action_required' as const,\n              content: null,\n              action: {\n                type: 'approval' as const,\n                message: 'Approve running this tool before it executes?',\n              },\n            }\n          : { callId, outcome: 'success' as const, content: { status: 'ok' } };\n\n    conversation = appendMessages(\n      conversation,\n      {\n        role: 'tool-call',\n        content: '',\n        toolCall: { id: callId, name: toolName, arguments: parsedToolArguments.value },\n      },\n      { role: 'tool-result', content: '', toolResult: result },\n    );\n  }\n\n  // --- Seed / clear ---\n  function seedThread(): void {\n    cancelPending('discard');\n    let next = createConversation({ id: 'harness-seeded' });\n    // Repeated token \"alpha\" for deterministic search assertions, plus enough\n    // messages to overflow the fixed-height viewport.\n    next = appendUserMessage(next, 'Tell me about alpha.');\n    next = appendAssistantMessage(next, 'alpha is the first item we track.');\n    for (let index = 0; index < 12; index += 1) {\n      next = appendUserMessage(next, `Follow-up question number ${index + 1}.`);\n      next = appendAssistantMessage(\n        next,\n        `Detailed answer number ${index + 1}, with alpha context.`,\n      );\n    }\n    conversation = next;\n  }\n\n  function seedFailedMessage(): void {\n    conversation = appendMessages(conversation, {\n      role: 'user',\n      content: 'This message failed to send.',\n      metadata: { _deliveryStatus: 'failed' },\n    });\n  }\n\n  function clearConversation(): void {\n    cancelPending('discard');\n    conversation = createConversation({ id: 'harness-cleared' });\n    historyPage = 0;\n  }\n\n  // --- Chat callbacks ---\n  function handleSubmit(event: ChatSubmitEvent): void {\n    const content = typeof event.message.content === 'string' ? event.message.content : '';\n    record('onsubmit', content);\n    conversation = appendMessages(conversation, {\n      role: 'user',\n      content: event.message.content,\n    });\n    if (autoReply) sendReply(replyText);\n  }\n\n  function handleEdit(event: { messageId: string; content: string }): void {\n    record('onedit', event);\n    conversation = replaceMessageContent(conversation, event.messageId, event.content);\n  }\n\n  async function handleLoadHistory(): Promise<void> {\n    conversation = prependHistoryMessages(conversation);\n    record('onloadhistory', historyPage);\n  }\n\n  onDestroy(() => cancelPending('destroy'));\n\n  const surfaceMode = $derived<'default' | 'transparent'>(\n    transparentSurface ? 'transparent' : 'default',\n  );\n  // `emptyPrompts` is included only when ON. Under exactOptionalPropertyTypes an\n  // optional prop must be omitted, not passed as `undefined`, so spread it\n  // conditionally rather than passing `emptyPrompts={undefined}`.\n  const emptyPromptsProp = $derived(\n    withEmptyPrompts ? { emptyPrompts: ['Tell me about alpha', 'Summarize the thread'] } : {},\n  );\n  const historyProps = $derived(\n    historyEnabled ? { moreHistoryAvailable: true, onloadhistory: handleLoadHistory } : {},\n  );\n</script>\n\n<!--\n  flex-wrap (not a media-query grid) so this collapses to a single stacked\n  column on narrow viewports without a breakpoint: controls and chat both\n  carry a flex-basis, and once their combined basis exceeds the container\n  width the chat pane wraps below the controls instead of squeezing into a\n  sliver next to a fixed-width column.\n-->\n<div style=\"display: flex; flex-wrap: wrap; gap: 1rem; align-items: flex-start;\">\n  <!-- Control panel. tabindex=0 gives the scrollable region keyboard access\n       (axe scrollable-region-focusable) in addition to its normal focusable\n       descendants (inputs, buttons) — mirrors the Event log pattern below.\n       svelte:element keeps the rendered DOM as a div while avoiding the\n       static a11y warning for this focusable scroll-region pattern. -->\n  <svelte:element\n    this={'div'}\n    data-testid=\"harness-controls\"\n    role=\"group\"\n    aria-label=\"Harness controls\"\n    tabindex={0}\n    style=\"flex: 1 1 20rem; min-width: 0; max-height: min(80vh, 44rem); overflow-y: auto; display: grid; gap: 1rem; padding: 1rem; border: 1px solid var(--cinder-border-muted); border-radius: var(--cinder-radius-md); background: var(--cinder-surface-inset);\"\n  >\n    <section style=\"display: grid; gap: 0.5rem;\">\n      <strong>Reply as the other side</strong>\n      <Textarea\n        id=\"harness-reply-text\"\n        data-testid=\"reply-text\"\n        label=\"Reply text\"\n        bind:value={replyText}\n        rows={2}\n      />\n      <SegmentedControl\n        id=\"harness-reply-mode\"\n        selectionMode=\"single\"\n        bind:value={replyMode}\n        label=\"Reply mode\"\n      >\n        <Segment value=\"instant\">Instant</Segment>\n        <Segment value=\"typing\">Typing</Segment>\n        <Segment value=\"streaming\">Streaming</Segment>\n      </SegmentedControl>\n      {#if replyMode === 'streaming'}\n        <SegmentedControl\n          id=\"harness-stream-mechanism\"\n          selectionMode=\"single\"\n          bind:value={streamMechanism}\n          label=\"Streaming mechanism\"\n        >\n          <Segment value=\"imperative\">Imperative</Segment>\n          <Segment value=\"content-mutation\">Content</Segment>\n        </SegmentedControl>\n      {/if}\n      <Button data-testid=\"send-reply\" onclick={() => sendReply(replyText)}>Send reply</Button>\n    </section>\n\n    <section\n      style=\"display: grid; gap: 0.5rem; border-block-start: 1px solid var(--cinder-border-muted); padding-block-start: 1rem;\"\n    >\n      <strong>Inject tool call</strong>\n      <Input\n        id=\"harness-tool-name\"\n        data-testid=\"tool-name\"\n        label=\"Tool name\"\n        bind:value={toolName}\n      />\n      <Textarea\n        id=\"harness-tool-arguments\"\n        data-testid=\"tool-arguments\"\n        label=\"Tool arguments (JSON)\"\n        bind:value={toolArguments}\n        rows={2}\n      />\n      {#if !parsedToolArguments.ok}\n        <span\n          data-testid=\"tool-arguments-error\"\n          style=\"color: var(--cinder-danger); font-size: var(--cinder-text-xs);\"\n        >\n          Arguments must be valid JSON.\n        </span>\n      {/if}\n      <Select\n        id=\"harness-tool-outcome\"\n        label=\"Outcome\"\n        bind:value={toolOutcome}\n        options={[\n          { value: 'success', label: 'success' },\n          { value: 'error', label: 'error' },\n          { value: 'action_required', label: 'action_required' },\n        ]}\n      />\n      <Button data-testid=\"inject-tool\" disabled={!parsedToolArguments.ok} onclick={injectToolCall}>\n        Inject tool call\n      </Button>\n    </section>\n\n    <section\n      style=\"display: grid; gap: 0.5rem; border-block-start: 1px solid var(--cinder-border-muted); padding-block-start: 1rem;\"\n    >\n      <strong>Features</strong>\n      <div\n        style=\"display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 0.4rem 0.75rem;\"\n      >\n        <Toggle id=\"t-attachments\" label=\"Attachments\" bind:checked={attachments} />\n        <Toggle id=\"t-search\" label=\"Search\" bind:checked={search} />\n        <Toggle id=\"t-copy\" label=\"Copy\" bind:checked={copy} />\n        <Toggle id=\"t-editing\" label=\"Editing\" bind:checked={editing} />\n        <Toggle id=\"t-retry\" label=\"Retry\" bind:checked={retry} />\n        <Toggle id=\"t-surface\" label=\"Transparent surface\" bind:checked={transparentSurface} />\n        <Toggle id=\"t-prompts\" label=\"Empty prompts\" bind:checked={withEmptyPrompts} />\n        <Toggle id=\"t-autoreply\" label=\"Auto-reply on submit\" bind:checked={autoReply} />\n        <Toggle id=\"t-virtualized\" label=\"Virtualized transcript\" bind:checked={virtualized} />\n        <Toggle id=\"t-history\" label=\"History pagination\" bind:checked={historyEnabled} />\n      </div>\n    </section>\n\n    <section\n      style=\"display: grid; gap: 0.5rem; border-block-start: 1px solid var(--cinder-border-muted); padding-block-start: 1rem;\"\n    >\n      <strong>State</strong>\n      <div style=\"display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 0.4rem;\">\n        <Button data-testid=\"seed-thread\" variant=\"secondary\" onclick={seedThread}\n          >Seed sample thread</Button\n        >\n        <Button data-testid=\"seed-failed\" variant=\"secondary\" onclick={seedFailedMessage}\n          >Seed failed message</Button\n        >\n        <Button data-testid=\"clear\" variant=\"secondary\" onclick={clearConversation}>Clear</Button>\n        <Button data-testid=\"scroll-top\" variant=\"ghost\" onclick={() => chat?.scrollToTop()}\n          >Scroll to top</Button\n        >\n        <Button data-testid=\"scroll-bottom\" variant=\"ghost\" onclick={() => chat?.scrollToBottom()}\n          >Scroll to bottom</Button\n        >\n        <Button data-testid=\"focus-input\" variant=\"ghost\" onclick={() => chat?.focusInput()}\n          >Focus composer</Button\n        >\n      </div>\n    </section>\n\n    <section\n      style=\"display: grid; gap: 0.5rem; border-block-start: 1px solid var(--cinder-border-muted); padding-block-start: 1rem;\"\n    >\n      <strong>Event log</strong>\n      <!-- tabindex=0 gives the scrollable region keyboard access (axe\n           scrollable-region-focusable). A group label names it without a `log`\n           role, which would collide with the chat timeline's own role=\"log\".\n           svelte:element keeps the rendered DOM as a div while avoiding the\n           static a11y warning for this focusable scroll-region pattern. -->\n      <svelte:element\n        this={'div'}\n        data-testid=\"event-log\"\n        role=\"group\"\n        aria-label=\"Event log\"\n        tabindex={0}\n        style=\"display: grid; gap: 0.15rem; max-height: 10rem; overflow: auto; font-size: var(--cinder-text-xs); font-family: var(--cinder-font-mono);\"\n      >\n        {#each log as entry (entry.id)}\n          <div data-testid=\"event-log-entry\" data-event={entry.event} data-payload={entry.payload}>\n            {entry.event}: {entry.payload}\n          </div>\n        {/each}\n      </svelte:element>\n    </section>\n  </svelte:element>\n\n  <!-- The Chat under test. flex-grow 3 (vs the controls' 1) means it claims\n       most of any extra width once both fit on one line; the basis + generous\n       viewport-relative height keep it usable even when wrapped below the\n       controls on a narrow viewport. -->\n  <div style=\"flex: 3 1 24rem; min-width: 0; height: min(70vh, 42rem); min-height: 26rem;\">\n    <Chat\n      bind:this={chat}\n      id=\"harness-chat\"\n      {conversation}\n      {streaming}\n      {streamingStatus}\n      capabilities={{ attachments, search, copy, editing, retry }}\n      {surfaceMode}\n      {virtualized}\n      virtualizationEstimatedRowHeight={72}\n      virtualizationInitialHeight={480}\n      virtualizationOverscan={2}\n      {...emptyPromptsProp}\n      {...historyProps}\n      onsubmit={handleSubmit}\n      onedit={handleEdit}\n      onretry={(messageId: string) => record('onretry', messageId)}\n      onstopgenerating={(event: { messageId: string }) => {\n        cancelPending('preservePartial');\n        record('onstopgenerating', event.messageId);\n      }}\n      onjumptolatest={() => record('onjumptolatest')}\n      onscrollstatechange={(event: { atBottom: boolean }) =>\n        record('onscrollstatechange', { atBottom: event.atBottom })}\n      onunreadindicatorchange={(event: {\n        unreadCount: number;\n        newMessageIndicatorVisible: boolean;\n      }) => record('onunreadindicatorchange', event)}\n      onexpandedchange={(expanded: boolean) => record('onexpandedchange', { expanded })}\n      onattachmentadd={(attachment: { id: string }) => record('onattachmentadd', attachment.id)}\n      onattachmentremove={(attachment: { id: string }) =>\n        record('onattachmentremove', attachment.id)}\n      onattachmentfailure={(_file: File, error: string) => record('onattachmentfailure', error)}\n    >\n      {#snippet header()}\n        <div\n          data-testid=\"harness-header\"\n          style=\"padding: 0.5rem 0.75rem; font-weight: var(--cinder-font-semibold);\"\n        >\n          Harness conversation\n        </div>\n      {/snippet}\n      {#snippet messageActions(message: Message)}\n        <Button\n          iconOnly={true}\n          label=\"Message action\"\n          size=\"xs\"\n          variant=\"ghost\"\n          data-testid=\"harness-message-action\"\n          data-message-id={message.id}\n        >\n          ★\n        </Button>\n      {/snippet}\n      {#snippet messageStatus(message: Message)}\n        <span data-testid=\"harness-message-status\" data-message-id={message.id}>·</span>\n      {/snippet}\n    </Chat>\n  </div>\n</div>\n"
     },
     {
       "id": "streaming",