@cueplusplus/ui 0.13.0

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

@@ -0,0 +1,70 @@
+{
+  "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.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "user",
+          "assistant"
+        ]
+      }
+    }
+  ],
+  "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-leading-ui",
+    "--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,55 @@
+{
+  "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-leading-ui",
+    "--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,61 @@
+{
+  "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-leading-ui",
+    "--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,152 @@
+{
+  "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.",
+          "control": {
+            "kind": "boolean"
+          }
+        }
+      ],
+      "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).",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
+        },
+        {
+          "name": "children",
+          "type": "ReactNode",
+          "required": false,
+          "defaultValue": null,
+          "description": "The leading cluster — normally a {@link CardTitle} and a description.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
+        }
+      ],
+      "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-leading-ui",
+    "--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
+}

package/manifest/components/carousel.json

@@ -0,0 +1,242 @@
+{
+  "name": "Carousel",
+  "slug": "carousel",
+  "group": "layout",
+  "importPath": "@cueplusplus/ui/layout/carousel",
+  "peerDependencies": [
+    "embla-carousel-react"
+  ],
+  "clientOnly": true,
+  "description": "A swipeable strip of slides, on embla.\n\n`embla-carousel-react` is an **optional peer**: import this from\n`@cueplusplus/ui/layout/carousel`, never from the core barrel, so an app that\nships no carousel never installs one.",
+  "props": [],
+  "typeReferences": [],
+  "subcomponents": [
+    "Root",
+    "Content",
+    "Slide",
+    "Previous",
+    "Next",
+    "Dots"
+  ],
+  "parts": [
+    {
+      "name": "Root",
+      "usage": "Carousel.Root",
+      "description": "The carousel frame: sets up embla and publishes its state to the parts.\n\nFocusable and wired to the arrow keys, because a carousel a mouse can drive\nand a keyboard cannot is not a carousel (WCAG 2.1.1).",
+      "props": [
+        {
+          "name": "options",
+          "type": "Partial<OptionsType>",
+          "required": false,
+          "defaultValue": null,
+          "description": "embla options, merged over the axis this component derives from `orientation`.",
+          "control": {
+            "kind": "opaque"
+          }
+        },
+        {
+          "name": "plugins",
+          "type": "CreatePluginType<LoosePluginType, {}>[]",
+          "required": false,
+          "defaultValue": null,
+          "description": "embla plugins (autoplay, class names, wheel gestures…).",
+          "control": {
+            "kind": "array"
+          }
+        },
+        {
+          "name": "orientation",
+          "type": "\"horizontal\" | \"vertical\"",
+          "required": false,
+          "defaultValue": "horizontal",
+          "description": "Which way the slides travel. Defaults to `\"horizontal\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "horizontal",
+              "vertical"
+            ]
+          }
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "required": false,
+          "defaultValue": "Carousel",
+          "description": "The region's accessible name. Defaults to `\"Carousel\"`.",
+          "control": {
+            "kind": "string"
+          }
+        },
+        {
+          "name": "setApi",
+          "type": "((api: EmblaCarouselType) => void)",
+          "required": false,
+          "defaultValue": null,
+          "description": "Receives the embla instance once mounted — the escape hatch to its full API.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
+        }
+      ],
+      "typeReferences": [
+        "Omit<React.ComponentPropsWithoutRef<\"div\">, \"onSelect\">"
+      ]
+    },
+    {
+      "name": "Content",
+      "usage": "Carousel.Content",
+      "description": "The clipping viewport and the track inside it.\n\nTwo elements rather than one because embla measures the viewport and\ntranslates the track; giving one element both jobs makes the transform fight\nthe overflow. Each child is wrapped so `Carousel.Slide` can name itself\n\"Slide 2 of 5\" without the call site counting.",
+      "props": [
+        {
+          "name": "trackClassName",
+          "type": "string",
+          "required": false,
+          "defaultValue": null,
+          "description": "Extra classes for the flex track inside the viewport.",
+          "control": {
+            "kind": "string"
+          }
+        }
+      ],
+      "typeReferences": [
+        "React.ComponentPropsWithoutRef<\"div\">"
+      ]
+    },
+    {
+      "name": "Slide",
+      "usage": "Carousel.Slide",
+      "description": "One slide. `basis-full` by default, so a slide fills the viewport; override\nwith `className=\"basis-1/3\"` for a multi-up carousel.",
+      "props": [
+        {
+          "name": "label",
+          "type": "string",
+          "required": false,
+          "defaultValue": null,
+          "description": "Override the spoken name. Defaults to `\"Slide <n> of <total>\"`.",
+          "control": {
+            "kind": "string"
+          }
+        }
+      ],
+      "typeReferences": [
+        "React.ComponentPropsWithoutRef<\"div\">"
+      ]
+    },
+    {
+      "name": "Previous",
+      "usage": "Carousel.Previous",
+      "description": "Step one slide back. Disabled at the start unless the carousel loops.",
+      "props": [
+        {
+          "name": "aria-label",
+          "type": "string",
+          "required": false,
+          "defaultValue": "Previous slide",
+          "description": "Override the spoken name.",
+          "control": {
+            "kind": "string"
+          }
+        },
+        {
+          "name": "render",
+          "type": "RenderProp<Record<string, unknown>>",
+          "required": false,
+          "defaultValue": null,
+          "description": "Replace the rendered element (Base UI render prop).",
+          "control": {
+            "kind": "opaque"
+          }
+        }
+      ],
+      "typeReferences": [
+        "Omit<IconButtonProps, \"aria-label\" | \"icon\">"
+      ]
+    },
+    {
+      "name": "Next",
+      "usage": "Carousel.Next",
+      "description": "Step one slide forward. Disabled at the end unless the carousel loops.",
+      "props": [
+        {
+          "name": "aria-label",
+          "type": "string",
+          "required": false,
+          "defaultValue": "Next slide",
+          "description": "Override the spoken name.",
+          "control": {
+            "kind": "string"
+          }
+        },
+        {
+          "name": "render",
+          "type": "RenderProp<Record<string, unknown>>",
+          "required": false,
+          "defaultValue": null,
+          "description": "Replace the rendered element (Base UI render prop).",
+          "control": {
+            "kind": "opaque"
+          }
+        }
+      ],
+      "typeReferences": [
+        "Omit<IconButtonProps, \"aria-label\" | \"icon\">"
+      ]
+    },
+    {
+      "name": "Dots",
+      "usage": "Carousel.Dots",
+      "description": "One dot per scroll snap: position, and a way to jump straight to it.",
+      "props": [
+        {
+          "name": "dotLabel",
+          "type": "((index: number) => string)",
+          "required": false,
+          "defaultValue": "(index) => `Go to slide ${index + 1}`",
+          "description": "Builds each dot's spoken name. Defaults to `\"Go to slide <n>\"`.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
+        }
+      ],
+      "typeReferences": [
+        "Omit<React.ComponentPropsWithoutRef<\"div\">, \"children\">"
+      ]
+    }
+  ],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-border-strong",
+    "--cue-space-2",
+    "--cue-space-4"
+  ],
+  "summary": "A swipeable strip of slides, on embla.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "<Carousel.Root label=\"Fixture gallery\" options={{ loop: true }}>\n  <Carousel.Content>\n    {shots.map((s) => <Carousel.Slide key={s.id}><img src={s.src} /></Carousel.Slide>)}\n  </Carousel.Content>\n  <Carousel.Previous />\n  <Carousel.Next />\n  <Carousel.Dots />\n</Carousel.Root>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/carousel",
+  "mdUrl": "/docs/components/carousel.md",
+  "jsonUrl": "/r/components/carousel.json",
+  "specimens": [
+    {
+      "title": "Carousel",
+      "group": "layout",
+      "components": [
+        "Carousel"
+      ],
+      "code": "<Carousel.Root label=\"Fixture profiles\" className=\"w-full max-w-[32rem]\">\n  <Carousel.Content>\n    {[\"Source Four\", \"MAC Viper\", \"Sharpy Plus\"].map((name) => (\n      <Carousel.Slide key={name} label={name} className=\"basis-1/2\">\n        <Panel className=\"flex h-[6rem] items-center justify-center p-(--cue-space-4) font-mono text-(length:--cue-text-ui) text-fg-muted\">\n          {name}\n        </Panel>\n      </Carousel.Slide>\n    ))}\n  </Carousel.Content>\n  <div className=\"mt-(--cue-space-4) flex items-center gap-(--cue-space-3)\">\n    <Carousel.Previous />\n    <Carousel.Next />\n    <Carousel.Dots />\n  </div>\n</Carousel.Root>",
+      "note": "Embla, wearing the tokens. An optional peer, so it ships from @cueplusplus/ui/layout/carousel rather than the core barrel.",
+      "interaction": "drag or use the two controls; the dots are buttons and each says which slide it goes to."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/catalogue-icon.json

@@ -0,0 +1,46 @@
+{
+  "name": "CatalogueIcon",
+  "slug": "catalogue-icon",
+  "group": "icons",
+  "importPath": "@cueplusplus/ui",
+  "peerDependencies": [],
+  "clientOnly": false,
+  "description": "The catalogue itself: everything there is, before anything has been narrowed.\n\nOne tile repeated over a 2×2 rather than a stack of rows, because the row\nthis marks is the one that *undoes* a filter — \"all of it\" is a shape, and a\nlist glyph would have promised an ordering the row does not have.",
+  "props": [],
+  "typeReferences": [
+    "React.SVGProps<SVGSVGElement>"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [],
+  "summary": "The catalogue itself: everything there is, before anything has been narrowed.",
+  "examples": [],
+  "status": "todo-docs",
+  "url": "/docs/components/catalogue-icon",
+  "mdUrl": "/docs/components/catalogue-icon.md",
+  "jsonUrl": "/r/components/catalogue-icon.json",
+  "specimens": [
+    {
+      "title": "The container icon set",
+      "group": "icons",
+      "components": [
+        "CatalogueIcon",
+        "StackIcon",
+        "StacksMatrixIcon",
+        "AudienceIcon",
+        "ChannelReleasedIcon",
+        "ChannelBetaIcon",
+        "FolderIcon",
+        "McpServerIcon",
+        "CliToolIcon",
+        "SkillIcon"
+      ],
+      "code": "<Specimens>\n  {CONTAINERS.map(([label, name, Icon]) => (\n    <Specimen key={name} label={label}>\n      <Icon className=\"size-icon-md text-fg\" />\n    </Specimen>\n  ))}\n</Specimens>\n<Specimens>\n  <Specimen label=\"icon-sm\">\n    <SkillIcon className=\"size-icon-sm text-fg\" />\n  </Specimen>\n  <Specimen label=\"icon-md\">\n    <SkillIcon className=\"size-icon-md text-fg\" />\n  </Specimen>\n  <Specimen label=\"inherited\">\n    <SkillIcon className=\"size-icon-md\" />\n  </Specimen>\n  <Specimen label=\"muted\">\n    <SkillIcon className=\"size-icon-md text-fg-muted\" />\n  </Specimen>\n  <Specimen label=\"accent\">\n    <SkillIcon className=\"size-icon-md text-accent\" />\n  </Specimen>\n  <Specimen label=\"danger\">\n    <SkillIcon className=\"size-icon-md text-danger\" />\n  </Specimen>\n</Specimens>\n<Specimens>\n  <Specimen label=\"in a row\" wide>\n    <span className=\"inline-flex items-center gap-(--cue-space-2) font-mono text-(length:--cue-text-ui) text-fg-muted\">\n      <ChannelReleasedIcon className=\"size-icon-md shrink-0\" />\n      Our skills · released\n    </span>\n  </Specimen>\n  <Specimen label=\"current row\" wide>\n    <span className=\"inline-flex items-center gap-(--cue-space-2) font-mono text-(length:--cue-text-ui) text-fg\">\n      <ChannelBetaIcon className=\"size-icon-md shrink-0\" />\n      Our skills · beta\n    </span>\n  </Specimen>\n</Specimens>",
+      "note": "One grid and one weight across all ten, at size-icon-md — the size a navigation row draws them at. Each is a plain <svg> that takes every SVG prop.",
+      "interaction": "none. They are decorative by default: aria-hidden, announced by nothing, because the row they mark already carries its name."
+    }
+  ],
+  "todo": true
+}