@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/chart-tooltip-content.json

@@ -12,49 +12,73 @@
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Whether the pointer is on the plot. Recharts supplies this."
+      "description": "Whether the pointer is on the plot. Recharts supplies this.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "payload",
       "type": "readonly ChartTooltipEntry[]",
       "required": false,
       "defaultValue": null,
-      "description": "One entry per series at the hovered index. Recharts supplies this."
+      "description": "One entry per series at the hovered index. Recharts supplies this.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "label",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The hovered category — the x value. Recharts supplies this."
+      "description": "The hovered category — the x value. Recharts supplies this.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "hideLabel",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Drop the label line, for a chart whose x axis needs no restating."
+      "description": "Drop the label line, for a chart whose x axis needs no restating.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "hideIndicator",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Drop the per-row colour chips, for a single-series chart."
+      "description": "Drop the per-row colour chips, for a single-series chart.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "labelFormatter",
       "type": "((label: ReactNode, payload: readonly ChartTooltipEntry[]) => ReactNode)",
       "required": false,
       "defaultValue": null,
-      "description": "Format the label line."
+      "description": "Format the label line.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "formatter",
       "type": "((value: string | number | readonly (string | number)[], name: ReactNode, entry: ChartTooltipEntry, index: number) => ReactNode)",
       "required": false,
       "defaultValue": null,
-      "description": "Format one row's value. Return the unit too if you want to own it."
+      "description": "Format one row's value. Return the unit too if you want to own it.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/chart.json

@@ -12,42 +12,66 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What the series measures."
+      "description": "What the series measures.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "value",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The headline figure, pre-formatted. The chart never formats numbers itself."
+      "description": "The headline figure, pre-formatted. The chart never formats numbers itself.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "delta",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Change against the previous window. Renders green unless it starts with a minus sign."
+      "description": "Change against the previous window. Renders green unless it starts with a minus sign.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "points",
       "type": "readonly number[]",
       "required": true,
       "defaultValue": null,
-      "description": "The full series. The scale is computed from all of it, so the axis does not jump\nwhile streaming."
+      "description": "The full series. The scale is computed from all of it, so the axis does not jump\nwhile streaming.",
+      "control": {
+        "kind": "array",
+        "fixture": "chart.series"
+      }
     },
     {
       "name": "visibleCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many points have arrived."
+      "description": "How many points have arrived.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "variant",
       "type": "\"area\" | \"line\" | \"bars\"",
       "required": false,
       "defaultValue": "area",
-      "description": "Mark type. The last point stays emphasized in all three."
+      "description": "Mark type. The last point stays emphasized in all three.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "area",
+          "line",
+          "bars"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/chat-panel-composer.json

@@ -14,14 +14,21 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Resting text in the input bar."
+      "description": "Resting text in the input bar.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onSend",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the send control. Omit it and the control renders disabled."
+      "description": "Called from the send control. Omit it and the control renders disabled.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/checkbox-group.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the vertical stack defaults."
+      "description": "Extra classes, merged over the vertical stack defaults.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -28,7 +31,6 @@
     "--cue-border",
     "--cue-border-strong",
     "--cue-danger",
-    "--cue-fg",
     "--cue-fg-muted",
     "--cue-font-mono",
     "--cue-icon-md",

package/manifest/components/checkbox.json

@@ -12,21 +12,35 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Inline label rendered beside the box and wrapped with it in a `<label>`, so\nthe text is both the accessible name and part of the hit target. Omit it and\npass `aria-label`, or let a {@link Field } name the control instead."
+      "description": "Inline label rendered beside the box and wrapped with it in a `<label>`, so\nthe text is both the accessible name and part of the hit target. Omit it and\npass `aria-label`, or let a {@link Field } name the control instead.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the box defaults."
+      "description": "Extra classes, merged over the box defaults.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the density icon ladder for the box. Defaults to `\"md\"`."
+      "description": "Rung of the density icon ladder for the box. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md"
+        ]
+      }
     }
   ],
   "typeReferences": [
@@ -42,7 +56,6 @@
     "--cue-border",
     "--cue-border-strong",
     "--cue-danger",
-    "--cue-fg",
     "--cue-fg-muted",
     "--cue-font-mono",
     "--cue-icon-md",

package/manifest/components/checkpoint-history.json

@@ -14,21 +14,31 @@
       "type": "readonly Checkpoint[]",
       "required": true,
       "defaultValue": null,
-      "description": "Points in the run you can fall back to, oldest first."
+      "description": "Points in the run you can fall back to, oldest first.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "currentId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Where the run stands. Everything after it dims, since restoring would discard it."
+      "description": "Where the run stands. Everything after it dims, since restoring would discard it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onRestore",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the checkpoint to return to."
+      "description": "Called with the checkpoint to return to.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/chip.json

@@ -12,35 +12,65 @@
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Render as a `<button>` with hover feedback instead of a static `<span>`.\nUse for filter pills and other clickable tags; leave off for pure labels."
+      "description": "Render as a `<button>` with hover feedback instead of a static `<span>`.\nUse for filter pills and other clickable tags; leave off for pure labels.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Disable the interactive form. Ignored when `interactive` is not set."
+      "description": "Disable the interactive form. Ignored when `interactive` is not set.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Chip content — normally one or two words, or a short count."
+      "description": "Chip content — normally one or two words, or a short count.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "tone",
       "type": "\"danger\" | \"accent\" | \"busy\" | \"neutral\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "neutral",
-      "description": ""
+      "description": "",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "neutral",
+          "accent",
+          "ok",
+          "busy",
+          "warn",
+          "danger",
+          "info"
+        ]
+      }
     },
     {
       "name": "variant",
       "type": "\"outline\" | \"tinted\" | \"tag\"",
       "required": false,
       "defaultValue": "tinted",
-      "description": ""
+      "description": "",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "tinted",
+          "outline",
+          "tag"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/clamp.json

@@ -12,49 +12,72 @@
       "type": "string | number",
       "required": false,
       "defaultValue": "250",
-      "description": "How tall the content may be before it is cut, as a number of pixels or any\nCSS length. Defaults to `250` — the reference's own default, with `60` the\nvalue it uses for a quoted user message.\n\nPublished as `--cue-elements-clamp-height` on the root, so a console can\nretune one clamp from a stylesheet without a prop."
+      "description": "How tall the content may be before it is cut, as a number of pixels or any\nCSS length. Defaults to `250` — the reference's own default, with `60` the\nvalue it uses for a quoted user message.\n\nPublished as `--cue-elements-clamp-height` on the root, so a console can\nretune one clamp from a stylesheet without a prop.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "fade",
       "type": "number",
       "required": false,
       "defaultValue": "50",
-      "description": "How deep the dissolve at the cut is, in pixels. Defaults to `50`, the\nreference's most-used depth.\n\nFixed pixels rather than a fraction, deliberately: a percentage fade is a\ndifferent effect on a short row than on a long one. Published as\n`--cue-elements-clamp-fade`."
+      "description": "How deep the dissolve at the cut is, in pixels. Defaults to `50`, the\nreference's most-used depth.\n\nFixed pixels rather than a fraction, deliberately: a percentage fade is a\ndifferent effect on a short row than on a long one. Published as\n`--cue-elements-clamp-fade`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the content is showing in full."
+      "description": "Whether the content is showing in full.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the reveal is used. Omit it and the clamp is a hard cut with a\nfade and no promise of more — which is the reference's own tool-result row,\nwhere the full text opens somewhere else entirely."
+      "description": "Called when the reveal is used. Omit it and the clamp is a hard cut with a\nfade and no promise of more — which is the reference's own tool-result row,\nwhere the full text opens somewhere else entirely.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "overflows",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Whether the content is taller than `height`, when the caller already knows.\nLeft out, the clamp measures itself and re-measures as the content and the\nbox change.\n\nThe measurement is the right default and the override is for the cases it\ncannot serve: a virtualised row that knows its own text, a replay frame\nthat must paint the same way on every mount, a server render."
+      "description": "Whether the content is taller than `height`, when the caller already knows.\nLeft out, the clamp measures itself and re-measures as the content and the\nbox change.\n\nThe measurement is the right default and the override is for the cases it\ncannot serve: a virtualised row that knows its own text, a replay frame\nthat must paint the same way on every mount, a server render.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<ClampLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "The two words on the reveal. Defaults to {@link CLAMP_LABELS} — `Show more`\nand `Show less`, which is the reference's copy verbatim."
+      "description": "The two words on the reveal. Defaults to {@link CLAMP_LABELS} — `Show more`\nand `Show less`, which is the reference's copy verbatim.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The content being clamped."
+      "description": "The content being clamped.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/cli-tool-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "A CLI tool in the registry: a thing that runs in a terminal.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/code-block.json

@@ -0,0 +1,106 @@
+{
+  "name": "CodeBlock",
+  "slug": "code-block",
+  "group": "instruments",
+  "importPath": "@cueplusplus/ui",
+  "peerDependencies": [],
+  "clientOnly": false,
+  "description": "A block of code with a copy button and no syntax-highlighter palette.\n\nEvery colour a token-driven site paints has to come from the token layer, and\na highlighter theme is a second palette that would need porting to every\npreset before it could sit beside them — so there is none. What `language=\"jsx\"`\nadds is emphasis in three inks the theme already has: tag names in `--cue-fg`,\nattribute names in `--cue-fg-muted`, punctuation in `--cue-fg-subtle`. Mono\ntype, the sunken ground every input uses, and a copy button that works.\n\nNo directive: the copy button is the only client code, and a server page can\ndraw the rest.",
+  "props": [
+    {
+      "name": "code",
+      "type": "string",
+      "required": true,
+      "defaultValue": null,
+      "description": "The code. Printed verbatim, already dedented by whoever produced it; the copy button copies exactly this.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "label",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "What the block is, in the caption strip: a filename, an example's title. Defaults to the language.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "language",
+      "type": "string",
+      "required": false,
+      "defaultValue": "tsx",
+      "description": "The fence language, on the `<pre>` as `data-language`. Defaults to `\"tsx\"`.\n`\"jsx\"` turns on emphasis: tag names, attribute names and punctuation in\nthree inks the theme already has. Every other value prints plain.",
+      "control": {
+        "kind": "string"
+      }
+    }
+  ],
+  "typeReferences": [
+    "Omit<React.ComponentPropsWithoutRef<\"div\">, \"children\">"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-border",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-font-mono",
+    "--cue-pad-row-x",
+    "--cue-pad-row-y",
+    "--cue-space-4",
+    "--cue-sunken",
+    "--cue-text-micro",
+    "--cue-text-ui"
+  ],
+  "summary": "A block of code with a copy button and no highlighter palette; `language=\"jsx\"` adds emphasis in three inks the theme already has.",
+  "examples": [
+    {
+      "title": "An install line",
+      "code": "<CodeBlock label=\"install\" language=\"sh\" code=\"pnpm add @cueplusplus/ui\" />",
+      "language": "tsx"
+    },
+    {
+      "title": "JSX, in three inks",
+      "code": "<CodeBlock label=\"JSX\" language=\"jsx\" code={'<Button variant=\"primary\">Take cue</Button>'} />",
+      "language": "tsx"
+    },
+    {
+      "title": "Usage",
+      "code": "<CodeBlock label=\"install\" code=\"pnpm add\n<CodeBlock label=\"JSX\" language=\"jsx\" code={'<Button variant=\"primary\">Take cue</Button>'} />",
+      "language": "tsx"
+    }
+  ],
+  "status": "stable",
+  "url": "/docs/components/code-block",
+  "mdUrl": "/docs/components/code-block.md",
+  "jsonUrl": "/r/components/code-block.json",
+  "whenToUse": [
+    "Any snippet a reader will copy: an install line, an example, the source of a state on screen.",
+    "JSX a reader should scan by structure — tag names, then attributes — without a second palette to port to every theme."
+  ],
+  "whenNotToUse": [
+    "Inline code in a sentence. That is a `<code>` in prose.",
+    "A diff, or code a reader runs. Those are `CodeDiff` and `CodeRunner`."
+  ],
+  "commonMistakes": [
+    "Expecting colour for a language other than `jsx`. There is no highlighter; every other language prints plain, on purpose.",
+    "Passing code that still carries its indentation from the file it came from. The block prints verbatim — dedent it first."
+  ],
+  "specimens": [
+    {
+      "title": "CodeBlock",
+      "group": "instruments",
+      "components": [
+        "CodeBlock"
+      ],
+      "code": "<div className=\"flex w-full flex-col gap-(--cue-space-4)\">\n  <CodeBlock label=\"install\" language=\"sh\" code=\"pnpm add @cueplusplus/ui\" />\n  <CodeBlock label=\"JSX\" language=\"jsx\" code={'<Button variant=\"primary\" size=\"sm\">\\n  Take cue\\n</Button>'} />\n</div>",
+      "interaction": "the copy button is the one control; the code is plain, selectable text."
+    }
+  ]
+}

package/manifest/components/code-diff.json

@@ -12,35 +12,50 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "File path shown in the diff header."
+      "description": "File path shown in the diff header.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "additions",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Addition count rendered in green next to the filename."
+      "description": "Addition count rendered in green next to the filename.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "deletions",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Deletion count rendered in red next to the filename."
+      "description": "Deletion count rendered in red next to the filename.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "lines",
       "type": "readonly DiffLine[]",
       "required": true,
       "defaultValue": null,
-      "description": "Unified diff lines with context, added, or removed kind."
+      "description": "Unified diff lines with context, added, or removed kind.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "cycle",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Identity key that remounts the body so entrance animation can replay."
+      "description": "Identity key that remounts the body so entrance animation can replay.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [