@cueplusplus/ui 0.2.0 → 0.5.0

package/manifest/components/canvas-split-body.json

@@ -0,0 +1,62 @@
+{
+  "name": "CanvasSplitBody",
+  "slug": "canvas-split-body",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "The document's text, scrolling on its own, with a caret while it is still being\nwritten.",
+  "props": [
+    {
+      "name": "writing",
+      "type": "boolean",
+      "required": false,
+      "defaultValue": null,
+      "description": "Trails a caret after the last line while the document is still being written."
+    }
+  ],
+  "typeReferences": [
+    "ComponentProps<\"div\"> & {\n  /** Trails a caret after the last line while the document is still being written. */\n  writing?: boolean;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-ok",
+    "--cue-radius-overlay",
+    "--cue-text-body"
+  ],
+  "summary": "The document's text, scrolling on its own, with a caret while it is still being written.",
+  "examples": [],
+  "status": "todo-docs",
+  "url": "/docs/components/canvas-split-body",
+  "mdUrl": "/docs/components/canvas-split-body.md",
+  "jsonUrl": "/r/components/canvas-split-body.json",
+  "specimens": [
+    {
+      "title": "CanvasSplit",
+      "group": "elements-knowledge",
+      "components": [
+        "CanvasSplit",
+        "CanvasSplitThread",
+        "CanvasSplitMessage",
+        "CanvasSplitDocument",
+        "CanvasSplitHeader",
+        "CanvasSplitBody",
+        "CanvasSplitLine"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"still writing\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">\n          Write up the fixture decision for the front truss.\n        </CanvasSplitMessage>\n        <CanvasSplitMessage speaker=\"assistant\">\n          Drafting it now — spec, power and the load check.\n        </CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader title=\"Front truss — fixture spec\" version={3} saved={false} />\n        <CanvasSplitBody writing>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n          <CanvasSplitLine heading>Power</CanvasSplitLine>\n          <CanvasSplitLine>\n            1,180 W each brings the FOH leg to 29.1 A of the 32 A available.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n  <Specimen label=\"saved\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">Looks right. Keep it.</CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader\n          title=\"Front truss — fixture spec\"\n          version={3}\n          saved\n          onCopy={() => undefined}\n          onClose={() => undefined}\n        />\n        <CanvasSplitBody>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n</Specimens>",
+      "note": "The thread steps aside and the document takes the room. Seven parts: the split itself, a narrowed conversation rail, and a document half with its own header, body and lines — still being written while you read it, which is what the caret at the end of the body is for. On a narrow viewport the two halves stack instead of shrinking.",
+      "interaction": "copy and close are named buttons and disable themselves without a handler. `saved` is the only state the header animates, and it swaps a word for a check rather than moving anything."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/canvas-split-document.json

@@ -0,0 +1,54 @@
+{
+  "name": "CanvasSplitDocument",
+  "slug": "canvas-split-document",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "The document half of the split: the header, and the body under it.",
+  "props": [],
+  "typeReferences": [
+    "ComponentProps<\"div\">"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-ok",
+    "--cue-radius-overlay",
+    "--cue-text-body"
+  ],
+  "summary": "The document half of the split: the header, and the body under it.",
+  "examples": [],
+  "status": "todo-docs",
+  "url": "/docs/components/canvas-split-document",
+  "mdUrl": "/docs/components/canvas-split-document.md",
+  "jsonUrl": "/r/components/canvas-split-document.json",
+  "specimens": [
+    {
+      "title": "CanvasSplit",
+      "group": "elements-knowledge",
+      "components": [
+        "CanvasSplit",
+        "CanvasSplitThread",
+        "CanvasSplitMessage",
+        "CanvasSplitDocument",
+        "CanvasSplitHeader",
+        "CanvasSplitBody",
+        "CanvasSplitLine"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"still writing\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">\n          Write up the fixture decision for the front truss.\n        </CanvasSplitMessage>\n        <CanvasSplitMessage speaker=\"assistant\">\n          Drafting it now — spec, power and the load check.\n        </CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader title=\"Front truss — fixture spec\" version={3} saved={false} />\n        <CanvasSplitBody writing>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n          <CanvasSplitLine heading>Power</CanvasSplitLine>\n          <CanvasSplitLine>\n            1,180 W each brings the FOH leg to 29.1 A of the 32 A available.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n  <Specimen label=\"saved\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">Looks right. Keep it.</CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader\n          title=\"Front truss — fixture spec\"\n          version={3}\n          saved\n          onCopy={() => undefined}\n          onClose={() => undefined}\n        />\n        <CanvasSplitBody>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n</Specimens>",
+      "note": "The thread steps aside and the document takes the room. Seven parts: the split itself, a narrowed conversation rail, and a document half with its own header, body and lines — still being written while you read it, which is what the caret at the end of the body is for. On a narrow viewport the two halves stack instead of shrinking.",
+      "interaction": "copy and close are named buttons and disable themselves without a handler. `saved` is the only state the header animates, and it swaps a word for a check rather than moving anything."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/canvas-split-header.json

@@ -0,0 +1,83 @@
+{
+  "name": "CanvasSplitHeader",
+  "slug": "canvas-split-header",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "What the document is, which version this is, and whether it has been written down\nyet — with copy and close beside them.",
+  "props": [
+    {
+      "name": "title",
+      "type": "string",
+      "required": true,
+      "defaultValue": null,
+      "description": "Document name."
+    },
+    {
+      "name": "version",
+      "type": "number",
+      "required": true,
+      "defaultValue": null,
+      "description": "Which revision is on screen."
+    },
+    {
+      "name": "saved",
+      "type": "boolean",
+      "required": true,
+      "defaultValue": null,
+      "description": "Swaps the status between editing and saved."
+    },
+    {
+      "name": "onClose",
+      "type": "(() => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called when the canvas is dismissed."
+    }
+  ],
+  "typeReferences": [
+    "Omit<ComponentProps<\"div\">, \"children\" | \"title\"> & {\n  /** Document name. */\n  title: string;\n  /** Which revision is on screen. */\n  version: number;\n  /** Swaps the status between editing and saved. */\n  saved: boolean;\n  /** Called from the copy action. Omit it and the control renders disabled. */\n  onCopy?: () => void;\n  /** Called when the canvas is dismissed. */\n  onClose?: () => void;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-ok",
+    "--cue-radius-overlay",
+    "--cue-text-body"
+  ],
+  "summary": "What the document is, which version this is, and whether it has been written down yet — with copy and close beside them.",
+  "examples": [],
+  "status": "todo-docs",
+  "url": "/docs/components/canvas-split-header",
+  "mdUrl": "/docs/components/canvas-split-header.md",
+  "jsonUrl": "/r/components/canvas-split-header.json",
+  "specimens": [
+    {
+      "title": "CanvasSplit",
+      "group": "elements-knowledge",
+      "components": [
+        "CanvasSplit",
+        "CanvasSplitThread",
+        "CanvasSplitMessage",
+        "CanvasSplitDocument",
+        "CanvasSplitHeader",
+        "CanvasSplitBody",
+        "CanvasSplitLine"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"still writing\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">\n          Write up the fixture decision for the front truss.\n        </CanvasSplitMessage>\n        <CanvasSplitMessage speaker=\"assistant\">\n          Drafting it now — spec, power and the load check.\n        </CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader title=\"Front truss — fixture spec\" version={3} saved={false} />\n        <CanvasSplitBody writing>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n          <CanvasSplitLine heading>Power</CanvasSplitLine>\n          <CanvasSplitLine>\n            1,180 W each brings the FOH leg to 29.1 A of the 32 A available.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n  <Specimen label=\"saved\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">Looks right. Keep it.</CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader\n          title=\"Front truss — fixture spec\"\n          version={3}\n          saved\n          onCopy={() => undefined}\n          onClose={() => undefined}\n        />\n        <CanvasSplitBody>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n</Specimens>",
+      "note": "The thread steps aside and the document takes the room. Seven parts: the split itself, a narrowed conversation rail, and a document half with its own header, body and lines — still being written while you read it, which is what the caret at the end of the body is for. On a narrow viewport the two halves stack instead of shrinking.",
+      "interaction": "copy and close are named buttons and disable themselves without a handler. `saved` is the only state the header animates, and it swaps a word for a check rather than moving anything."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/canvas-split-line.json

@@ -0,0 +1,62 @@
+{
+  "name": "CanvasSplitLine",
+  "slug": "canvas-split-line",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "One line of the document, arriving as it is written. `heading` sets it apart.",
+  "props": [
+    {
+      "name": "heading",
+      "type": "boolean",
+      "required": false,
+      "defaultValue": null,
+      "description": "Renders the line as a heading rather than body text."
+    }
+  ],
+  "typeReferences": [
+    "ComponentProps<\"p\"> & {\n  /** Renders the line as a heading rather than body text. */\n  heading?: boolean;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-ok",
+    "--cue-radius-overlay",
+    "--cue-text-body"
+  ],
+  "summary": "One line of the document, arriving as it is written.",
+  "examples": [],
+  "status": "todo-docs",
+  "url": "/docs/components/canvas-split-line",
+  "mdUrl": "/docs/components/canvas-split-line.md",
+  "jsonUrl": "/r/components/canvas-split-line.json",
+  "specimens": [
+    {
+      "title": "CanvasSplit",
+      "group": "elements-knowledge",
+      "components": [
+        "CanvasSplit",
+        "CanvasSplitThread",
+        "CanvasSplitMessage",
+        "CanvasSplitDocument",
+        "CanvasSplitHeader",
+        "CanvasSplitBody",
+        "CanvasSplitLine"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"still writing\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">\n          Write up the fixture decision for the front truss.\n        </CanvasSplitMessage>\n        <CanvasSplitMessage speaker=\"assistant\">\n          Drafting it now — spec, power and the load check.\n        </CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader title=\"Front truss — fixture spec\" version={3} saved={false} />\n        <CanvasSplitBody writing>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n          <CanvasSplitLine heading>Power</CanvasSplitLine>\n          <CanvasSplitLine>\n            1,180 W each brings the FOH leg to 29.1 A of the 32 A available.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n  <Specimen label=\"saved\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">Looks right. Keep it.</CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader\n          title=\"Front truss — fixture spec\"\n          version={3}\n          saved\n          onCopy={() => undefined}\n          onClose={() => undefined}\n        />\n        <CanvasSplitBody>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n</Specimens>",
+      "note": "The thread steps aside and the document takes the room. Seven parts: the split itself, a narrowed conversation rail, and a document half with its own header, body and lines — still being written while you read it, which is what the caret at the end of the body is for. On a narrow viewport the two halves stack instead of shrinking.",
+      "interaction": "copy and close are named buttons and disable themselves without a handler. `saved` is the only state the header animates, and it swaps a word for a check rather than moving anything."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/canvas-split-message.json

@@ -0,0 +1,62 @@
+{
+  "name": "CanvasSplitMessage",
+  "slug": "canvas-split-message",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "One turn inside the rail — a filled bubble for the person, plain text for the model.",
+  "props": [
+    {
+      "name": "speaker",
+      "type": "\"user\" | \"assistant\"",
+      "required": true,
+      "defaultValue": null,
+      "description": "User turns sit right in a bubble, assistant turns run flush left. Emitted as\ndata-speaker for styling from outside; it is deliberately not called role, so the\nARIA attribute stays yours to set."
+    }
+  ],
+  "typeReferences": [
+    "ComponentProps<\"div\"> & {\n  /**\n   * User turns sit right in a bubble, assistant turns run flush left. Emitted as\n   * data-speaker for styling from outside; it is deliberately not called role, so the\n   * ARIA attribute stays yours to set.\n   */\n  speaker: \"user\" | \"assistant\";\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-ok",
+    "--cue-radius-overlay",
+    "--cue-text-body"
+  ],
+  "summary": "One turn inside the rail — a filled bubble for the person, plain text for the model.",
+  "examples": [],
+  "status": "todo-docs",
+  "url": "/docs/components/canvas-split-message",
+  "mdUrl": "/docs/components/canvas-split-message.md",
+  "jsonUrl": "/r/components/canvas-split-message.json",
+  "specimens": [
+    {
+      "title": "CanvasSplit",
+      "group": "elements-knowledge",
+      "components": [
+        "CanvasSplit",
+        "CanvasSplitThread",
+        "CanvasSplitMessage",
+        "CanvasSplitDocument",
+        "CanvasSplitHeader",
+        "CanvasSplitBody",
+        "CanvasSplitLine"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"still writing\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">\n          Write up the fixture decision for the front truss.\n        </CanvasSplitMessage>\n        <CanvasSplitMessage speaker=\"assistant\">\n          Drafting it now — spec, power and the load check.\n        </CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader title=\"Front truss — fixture spec\" version={3} saved={false} />\n        <CanvasSplitBody writing>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n          <CanvasSplitLine heading>Power</CanvasSplitLine>\n          <CanvasSplitLine>\n            1,180 W each brings the FOH leg to 29.1 A of the 32 A available.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n  <Specimen label=\"saved\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">Looks right. Keep it.</CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader\n          title=\"Front truss — fixture spec\"\n          version={3}\n          saved\n          onCopy={() => undefined}\n          onClose={() => undefined}\n        />\n        <CanvasSplitBody>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n</Specimens>",
+      "note": "The thread steps aside and the document takes the room. Seven parts: the split itself, a narrowed conversation rail, and a document half with its own header, body and lines — still being written while you read it, which is what the caret at the end of the body is for. On a narrow viewport the two halves stack instead of shrinking.",
+      "interaction": "copy and close are named buttons and disable themselves without a handler. `saved` is the only state the header animates, and it swaps a word for a check rather than moving anything."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/canvas-split-thread.json

@@ -0,0 +1,54 @@
+{
+  "name": "CanvasSplitThread",
+  "slug": "canvas-split-thread",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "The conversation, narrowed to a rail beside the document. It keeps scrolling while\nthe document is written, so the turn that asked for the artifact stays in view.",
+  "props": [],
+  "typeReferences": [
+    "ComponentProps<\"div\">"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-ok",
+    "--cue-radius-overlay",
+    "--cue-text-body"
+  ],
+  "summary": "The conversation, narrowed to a rail beside the document.",
+  "examples": [],
+  "status": "todo-docs",
+  "url": "/docs/components/canvas-split-thread",
+  "mdUrl": "/docs/components/canvas-split-thread.md",
+  "jsonUrl": "/r/components/canvas-split-thread.json",
+  "specimens": [
+    {
+      "title": "CanvasSplit",
+      "group": "elements-knowledge",
+      "components": [
+        "CanvasSplit",
+        "CanvasSplitThread",
+        "CanvasSplitMessage",
+        "CanvasSplitDocument",
+        "CanvasSplitHeader",
+        "CanvasSplitBody",
+        "CanvasSplitLine"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"still writing\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">\n          Write up the fixture decision for the front truss.\n        </CanvasSplitMessage>\n        <CanvasSplitMessage speaker=\"assistant\">\n          Drafting it now — spec, power and the load check.\n        </CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader title=\"Front truss — fixture spec\" version={3} saved={false} />\n        <CanvasSplitBody writing>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n          <CanvasSplitLine heading>Power</CanvasSplitLine>\n          <CanvasSplitLine>\n            1,180 W each brings the FOH leg to 29.1 A of the 32 A available.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n  <Specimen label=\"saved\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">Looks right. Keep it.</CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader\n          title=\"Front truss — fixture spec\"\n          version={3}\n          saved\n          onCopy={() => undefined}\n          onClose={() => undefined}\n        />\n        <CanvasSplitBody>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n</Specimens>",
+      "note": "The thread steps aside and the document takes the room. Seven parts: the split itself, a narrowed conversation rail, and a document half with its own header, body and lines — still being written while you read it, which is what the caret at the end of the body is for. On a narrow viewport the two halves stack instead of shrinking.",
+      "interaction": "copy and close are named buttons and disable themselves without a handler. `saved` is the only state the header animates, and it swaps a word for a check rather than moving anything."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/canvas-split.json

@@ -0,0 +1,60 @@
+{
+  "name": "CanvasSplit",
+  "slug": "canvas-split",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "The thread steps aside and the document takes the room, still being written as you\nread.",
+  "props": [],
+  "typeReferences": [
+    "ComponentProps<\"div\">"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-ok",
+    "--cue-radius-overlay",
+    "--cue-text-body"
+  ],
+  "summary": "The thread steps aside and the document takes the room, still being written as you read.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import {\n  CanvasSplit,\n  CanvasSplitBody,\n  CanvasSplitDocument,\n  CanvasSplitHeader,\n  CanvasSplitLine,\n  CanvasSplitMessage,\n  CanvasSplitThread,\n} from \"@cueplusplus/ui/elements\";\n\n<CanvasSplit>\n  <CanvasSplitThread>\n    <CanvasSplitMessage speaker=\"user\">Draft the note</CanvasSplitMessage>\n  </CanvasSplitThread>\n  <CanvasSplitDocument>\n    <CanvasSplitHeader title=\"note.md\" version={3} saved onCopy={copy} />\n    <CanvasSplitBody writing>\n      <CanvasSplitLine heading>Migrating to 0.14</CanvasSplitLine>\n    </CanvasSplitBody>\n  </CanvasSplitDocument>\n</CanvasSplit>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/canvas-split",
+  "mdUrl": "/docs/components/canvas-split.md",
+  "jsonUrl": "/r/components/canvas-split.json",
+  "specimens": [
+    {
+      "title": "CanvasSplit",
+      "group": "elements-knowledge",
+      "components": [
+        "CanvasSplit",
+        "CanvasSplitThread",
+        "CanvasSplitMessage",
+        "CanvasSplitDocument",
+        "CanvasSplitHeader",
+        "CanvasSplitBody",
+        "CanvasSplitLine"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"still writing\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">\n          Write up the fixture decision for the front truss.\n        </CanvasSplitMessage>\n        <CanvasSplitMessage speaker=\"assistant\">\n          Drafting it now — spec, power and the load check.\n        </CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader title=\"Front truss — fixture spec\" version={3} saved={false} />\n        <CanvasSplitBody writing>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n          <CanvasSplitLine heading>Power</CanvasSplitLine>\n          <CanvasSplitLine>\n            1,180 W each brings the FOH leg to 29.1 A of the 32 A available.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n  <Specimen label=\"saved\" wide>\n    <CanvasSplit>\n      <CanvasSplitThread>\n        <CanvasSplitMessage speaker=\"user\">Looks right. Keep it.</CanvasSplitMessage>\n      </CanvasSplitThread>\n      <CanvasSplitDocument>\n        <CanvasSplitHeader\n          title=\"Front truss — fixture spec\"\n          version={3}\n          saved\n          onCopy={() => undefined}\n          onClose={() => undefined}\n        />\n        <CanvasSplitBody>\n          <CanvasSplitLine heading>Fixture</CanvasSplitLine>\n          <CanvasSplitLine>\n            Six Robe ESPRITEs on 3.2 m centres, 8.4 m trim, mode 1 at 8 channels each.\n          </CanvasSplitLine>\n        </CanvasSplitBody>\n      </CanvasSplitDocument>\n    </CanvasSplit>\n  </Specimen>\n</Specimens>",
+      "note": "The thread steps aside and the document takes the room. Seven parts: the split itself, a narrowed conversation rail, and a document half with its own header, body and lines — still being written while you read it, which is what the caret at the end of the body is for. On a narrow viewport the two halves stack instead of shrinking.",
+      "interaction": "copy and close are named buttons and disable themselves without a handler. `saved` is the only state the header animates, and it swaps a word for a check rather than moving anything."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/card.json

@@ -0,0 +1,140 @@
+{
+  "name": "Card",
+  "slug": "card",
+  "group": "layout",
+  "importPath": "@cueplusplus/ui",
+  "peerDependencies": [],
+  "clientOnly": false,
+  "description": "A padded container for one thing: a summary, a setting group, a preview.\n\nEvery section paints its own `surface-1` ground, which is what lets the root\nswitch to the seam idiom without any of the parts knowing.",
+  "props": [],
+  "typeReferences": [],
+  "subcomponents": [
+    "Root",
+    "Header",
+    "Title",
+    "Description",
+    "Content",
+    "Footer"
+  ],
+  "parts": [
+    {
+      "name": "Root",
+      "usage": "Card.Root",
+      "description": "The card frame: one hairline rim, one raised surface, one radius.\n\nDeliberately the same shape as `Panel` — a console must not have two\ncompeting container languages. What differs is the inside: a `Panel` holds\nrows that reach its rim, a `Card` holds a padded block of prose, numbers or\ncontrols. Reach for `Panel` when the content is a list; reach for `Card` when\nthe content is a thing.\n\nStatic markup — no `\"use client\"`.",
+      "props": [
+        {
+          "name": "seam",
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Separate the card's sections with hairline seams instead of whitespace.\n\nThe card is then filled with the border colour and its sections sit `1px`\napart, each painting its own opaque ground — the same idiom as `SeamList`,\nwhere the gap *is* the rule and can never double up with a border."
+        }
+      ],
+      "typeReferences": [
+        "React.ComponentPropsWithoutRef<\"div\">"
+      ]
+    },
+    {
+      "name": "Header",
+      "usage": "Card.Header",
+      "description": "The card's title block: heading column left, actions right.\n\nCarries no bottom padding of its own, so the body's own `p-(--cue-space-5)`\nis the whole gap between the two. Under `seam` it takes its full padding\nback, because the hairline — not the whitespace — is then the separator.",
+      "props": [
+        {
+          "name": "actions",
+          "type": "ReactNode",
+          "required": false,
+          "defaultValue": null,
+          "description": "Right-hand slot: the controls that act on the whole card (a menu, a status\nchip, a count)."
+        },
+        {
+          "name": "children",
+          "type": "ReactNode",
+          "required": false,
+          "defaultValue": null,
+          "description": "The leading cluster — normally a {@link CardTitle} and a description."
+        }
+      ],
+      "typeReferences": [
+        "React.ComponentPropsWithoutRef<\"div\">"
+      ]
+    },
+    {
+      "name": "Title",
+      "usage": "Card.Title",
+      "description": "The card's name, one type rung above body text.\n\nAn `<h3>`, because a card is almost always nested under a page `<h1>` and a\nsection `<h2>`. Where that is wrong, style your own heading with these\nclasses rather than nesting the wrong level.",
+      "props": [],
+      "typeReferences": [
+        "React.ComponentPropsWithoutRef<\"h3\">"
+      ]
+    },
+    {
+      "name": "Description",
+      "usage": "Card.Description",
+      "description": "One supporting line under a {@link CardTitle}.",
+      "props": [],
+      "typeReferences": [
+        "React.ComponentPropsWithoutRef<\"p\">"
+      ]
+    },
+    {
+      "name": "Content",
+      "usage": "Card.Content",
+      "description": "The card's body, on the card padding rung.",
+      "props": [],
+      "typeReferences": [
+        "React.ComponentPropsWithoutRef<\"div\">"
+      ]
+    },
+    {
+      "name": "Footer",
+      "usage": "Card.Footer",
+      "description": "The action strip at the foot of a card. Right-aligned, like a dialog's.",
+      "props": [],
+      "typeReferences": [
+        "React.ComponentPropsWithoutRef<\"div\">"
+      ]
+    }
+  ],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-font-mono",
+    "--cue-radius-surface",
+    "--cue-space-1",
+    "--cue-space-2",
+    "--cue-space-3",
+    "--cue-space-4",
+    "--cue-space-5",
+    "--cue-surface-1",
+    "--cue-text-emphasis",
+    "--cue-text-ui"
+  ],
+  "summary": "A padded container for one thing: a summary, a setting group, a preview.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "<Card.Root seam>\n  <Card.Header><Card.Title>Failover</Card.Title></Card.Header>\n  <Card.Content>…</Card.Content>\n</Card.Root>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/card",
+  "mdUrl": "/docs/components/card.md",
+  "jsonUrl": "/r/components/card.json",
+  "specimens": [
+    {
+      "title": "Card",
+      "group": "layout",
+      "components": [
+        "Card"
+      ],
+      "code": "<div className=\"grid w-full gap-(--cue-space-5) lg:grid-cols-2\">\n  <Card.Root>\n    <Card.Header actions={<Chip tone=\"ok\">patched</Chip>}>\n      <Card.Title>Front truss</Card.Title>\n      <Card.Description>6 fixtures, universe 1.</Card.Description>\n    </Card.Header>\n    <Card.Content>\n      <DescriptionList.Root>\n        <DescriptionList.Term>Type</DescriptionList.Term>\n        <DescriptionList.Detail>Source Four 26°</DescriptionList.Detail>\n        <DescriptionList.Term>Channels</DescriptionList.Term>\n        <DescriptionList.Detail>1 to 48</DescriptionList.Detail>\n      </DescriptionList.Root>\n    </Card.Content>\n    <Card.Footer>\n      <Button size=\"sm\">Inspect</Button>\n    </Card.Footer>\n  </Card.Root>\n  <Card.Root seam>\n    <Card.Header>\n      <Card.Title>Seam card</Card.Title>\n      <Card.Description>Separated by gaps, not rules.</Card.Description>\n    </Card.Header>\n    <Card.Content>The 1px-gap idiom, at card scale.</Card.Content>\n  </Card.Root>\n</div>",
+      "note": "A panel with body padding and a title family. `seam` swaps the hairline separation for the 1px-gap idiom.",
+      "interaction": "none by default; wrap the header in a button if the card is a link."
+    }
+  ],
+  "todo": true
+}