@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/tags-input.json

@@ -12,119 +12,181 @@
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "The tags. Use with `onValueChange` for a controlled field."
+      "description": "The tags. Use with `onValueChange` for a controlled field.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "defaultValue",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Initial tags for an uncontrolled field."
+      "description": "Initial tags for an uncontrolled field.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string[]) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the full list after every add or remove."
+      "description": "Called with the full list after every add or remove.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "suggestions",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Optional known tags, offered in a popup as the user types. Free-form entry\nworks with or without them — a suggestion is a shortcut, never a constraint."
+      "description": "Optional known tags, offered in a popup as the user types. Free-form entry\nworks with or without them — a suggestion is a shortcut, never a constraint.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Shown while there are no tags."
+      "description": "Shown while there are no tags.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the control ladder. Defaults to `\"md\"`."
+      "description": "Rung of the control ladder. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     },
     {
       "name": "separators",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": "[\",\"]",
-      "description": "Extra keys that commit the pending tag, on top of Enter. Defaults to `[\",\"]`\n— the separator every \"type a list\" field in the wild accepts."
+      "description": "Extra keys that commit the pending tag, on top of Enter. Defaults to `[\",\"]`\n— the separator every \"type a list\" field in the wild accepts.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "max",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Refuse further tags past this many."
+      "description": "Refuse further tags past this many.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Prevent entry and grey the field out."
+      "description": "Prevent entry and grey the field out.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "name",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Name for the hidden input, when the field is part of a form."
+      "description": "Name for the hidden input, when the field is part of a form.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "id",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id forwarded to the text input."
+      "description": "Id forwarded to the text input.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the input, when no {@link FieldLabel } names it."
+      "description": "Accessible name for the input, when no {@link FieldLabel } names it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-labelledby",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id of the element naming the input."
+      "description": "Id of the element naming the input.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "removeLabel",
       "type": "((tag: string) => string)",
       "required": false,
       "defaultValue": "(tag) => `Remove ${tag}`",
-      "description": "Accessible name for a tag's remove button. Defaults to\n``(tag) => `Remove ${tag}` ``."
+      "description": "Accessible name for a tag's remove button. Defaults to\n``(tag) => `Remove ${tag}` ``.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the field."
+      "description": "Extra classes for the field.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "popupClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the popup surface."
+      "description": "Extra classes for the popup surface.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "sideOffset",
       "type": "number",
       "required": false,
       "defaultValue": "4",
-      "description": "Distance in px between the field and the popup. Defaults to `4`."
+      "description": "Distance in px between the field and the popup. Defaults to `4`.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/tail-status.json

@@ -14,56 +14,85 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What is happening, in two or three words: `Running commands`,\n`Searching the codebase`. `TAIL_ACTIONS` is the shipped vocabulary and this\nprop is a plain string, so a product with its own verbs is not stuck with\nthese ten."
+      "description": "What is happening, in two or three words: `Running commands`,\n`Searching the codebase`. `TAIL_ACTIONS` is the shipped vocabulary and this\nprop is a plain string, so a product with its own verbs is not stuck with\nthese ten.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "detail",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The thing the action is happening to — a path, a query, a topic. Truncates\non its own so the action never has to; a sidebar transcript is 280px wide\nand a status line that elides its verb has said nothing."
+      "description": "The thing the action is happening to — a path, a query, a topic. Truncates\non its own so the action never has to; a sidebar transcript is 280px wide\nand a status line that elides its verb has said nothing.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "active",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Whether the action is still going. `true` by default, because this row is\nthe live one; turn it off for `Idle`, `Interrupted` and `Aborted`, which\nstops the sweep and empties the spinner's slot without moving the text."
+      "description": "Whether the action is still going. `true` by default, because this row is\nthe live one; turn it off for `Idle`, `Interrupted` and `Aborted`, which\nstops the sweep and empties the spinner's slot without moving the text.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "updatesInPlace",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Whether a new `action` animates into the row that is already there, or\nsimply replaces the text.\n\nCursor's flag, and the reason it needs one: a narration line that changes\nevery few hundred milliseconds should read as one row being updated, while\na line that means something *different* should read as a new row. `true`\n(the default) keys the label on its own text so each new action fades in\nwhere the last one was; `false` leaves it unkeyed, and the words change\nwith no motion at all. A reduced-motion reader gets the second behaviour\neither way."
+      "description": "Whether a new `action` animates into the row that is already there, or\nsimply replaces the text.\n\nCursor's flag, and the reason it needs one: a narration line that changes\nevery few hundred milliseconds should read as one row being updated, while\na line that means something *different* should read as a new row. `true`\n(the default) keys the label on its own text so each new action fades in\nwhere the last one was; `false` leaves it unkeyed, and the words change\nwith no motion at all. A reduced-motion reader gets the second behaviour\neither way.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "priority",
       "type": "\"normal\" | \"attention\"",
       "required": false,
       "defaultValue": "normal",
-      "description": "How loudly this row is speaking. See {@link TailPriority}."
+      "description": "How loudly this row is speaking. See {@link TailPriority}.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "normal",
+          "attention"
+        ]
+      }
     },
     {
       "name": "onCancel",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Stop the run. The inline control exists only when this is given — Cursor's\nrule, and the right one: a Cancel that cannot cancel is worse than no\nCancel."
+      "description": "Stop the run. The inline control exists only when this is given — Cursor's\nrule, and the right one: a Cancel that cannot cancel is worse than no\nCancel.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "cancelLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Cancel",
-      "description": "What the stop control is called. `Cancel` is Cursor's word; opencode uses\n`Interrupt` and `Stop` for the same button."
+      "description": "What the stop control is called. `Cancel` is Cursor's word; opencode uses\n`Interrupt` and `Stop` for the same button.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "announce",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Whether this row is a live region — whether a screen reader is told each\ntime the action changes.\n\n**Answers itself by default, and that default is the interesting part.**\nLeft alone the row speaks when it is the only thing that can, and goes\nquiet the moment a {@link LiveRegionAnnouncer } is mounted anywhere on the\npage: the announcer's table covers the same transitions this row narrates,\nso a console with both — the ordinary composition — would otherwise have\nevery state read out twice, out of step, because the two regions update at\ndifferent moments.\n\nThe row is the one that defers because the announcer is the better speaker:\nit is a queue, spaced and depth-limited and paused while the page is hidden\nor a modal has the reader, and it is mounted empty and left mounted, which\nis the only way a live region is reliably announced. This row changes\nseveral times a second and comes and goes with the run.\n\nSet it explicitly to overrule that — `true` for a console whose announcer\nis fed something other than these actions, `false` for one that narrates\nthe foot of the transcript some other way. An explicit answer always wins."
+      "description": "Whether this row is a live region — whether a screen reader is told each\ntime the action changes.\n\n**Answers itself by default, and that default is the interesting part.**\nLeft alone the row speaks when it is the only thing that can, and goes\nquiet the moment a {@link LiveRegionAnnouncer } is mounted anywhere on the\npage: the announcer's table covers the same transitions this row narrates,\nso a console with both — the ordinary composition — would otherwise have\nevery state read out twice, out of step, because the two regions update at\ndifferent moments.\n\nThe row is the one that defers because the announcer is the better speaker:\nit is a queue, spaced and depth-limited and paused while the page is hidden\nor a modal has the reader, and it is mounted empty and left mounted, which\nis the only way a live region is reliably announced. This row changes\nseveral times a second and comes and goes with the run.\n\nSet it explicitly to overrule that — `true` for a console whose announcer\nis fed something other than these actions, `false` for one that narrates\nthe foot of the transcript some other way. An explicit answer always wins.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/terminal-block.json

@@ -14,35 +14,55 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Command string shown in the terminal header."
+      "description": "Command string shown in the terminal header.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "lines",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Output lines available to stream into the body."
+      "description": "Output lines available to stream into the body.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "visibleCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many output lines from the start are currently shown."
+      "description": "How many output lines from the start are currently shown.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "done",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the header shows exit 0; otherwise a spinner keeps spinning."
+      "description": "When true the header shows exit 0; otherwise a spinner keeps spinning.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "variant",
       "type": "\"paper\" | \"ink\"",
       "required": false,
       "defaultValue": "paper",
-      "description": "paper matches the surrounding surfaces; ink renders the classic dark terminal slab."
+      "description": "paper matches the surrounding surfaces; ink renders the classic dark terminal slab.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "paper",
+          "ink"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/terminal-frame.json

@@ -12,56 +12,82 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Name above the transcript — a log file, a host, a task."
+      "description": "Name above the transcript — a log file, a host, a task.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "lines",
       "type": "readonly TerminalFrameLine[]",
       "required": false,
       "defaultValue": null,
-      "description": "Static transcript. Rendered as a preamble when `simulate` is also set."
+      "description": "Static transcript. Rendered as a preamble when `simulate` is also set.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "prompt",
       "type": "string",
       "required": false,
       "defaultValue": "$",
-      "description": "The prompt glyph in front of a command line. Defaults to `\"$\"`."
+      "description": "The prompt glyph in front of a command line. Defaults to `\"$\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "copy",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Show a `CopyButton` in the title bar for the commands in the transcript."
+      "description": "Show a `CopyButton` in the title bar for the commands in the transcript.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "copyValue",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What the copy button puts on the clipboard. Defaults to the command lines, one per line."
+      "description": "What the copy button puts on the clipboard. Defaults to the command lines, one per line.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "simulate",
       "type": "TerminalScript",
       "required": false,
       "defaultValue": null,
-      "description": "Play the transcript out as a typed session.\n\nPass a stable reference (a module constant, or memoised) — the player\nrestarts whenever this prop changes identity. Under\n`prefers-reduced-motion` the finished transcript renders instantly and no\ntimer is ever scheduled."
+      "description": "Play the transcript out as a typed session.\n\nPass a stable reference (a module constant, or memoised) — the player\nrestarts whenever this prop changes identity. Under\n`prefers-reduced-motion` the finished transcript renders instantly and no\ntimer is ever scheduled.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Fixed body height in px at the 16px root. Leave unset to grow with the content."
+      "description": "Fixed body height in px at the 16px root. Leave unset to grow with the content.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Extra content under the transcript — an input row, a hint strip."
+      "description": "Extra content under the transcript — an input row, a hint strip.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/textarea.json

@@ -12,14 +12,40 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the chassis."
+      "description": "Extra classes, merged over the chassis.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "rows",
       "type": "number",
       "required": false,
       "defaultValue": "3",
-      "description": "Visible rows before the box starts scrolling. Defaults to `3`."
+      "description": "Visible rows before the box starts scrolling. Defaults to `3`.",
+      "control": {
+        "kind": "number"
+      }
+    },
+    {
+      "name": "aria-label",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "Accessible name for the textarea, when no `FieldLabel` names it. Declared\nhere rather than left to the inherited attribute so the props table carries\nthe row: a bare textarea outside a `Field` has no other way to be named.",
+      "control": {
+        "kind": "string"
+      }
+    },
+    {
+      "name": "placeholder",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "An example of what goes in the box, shown while it is empty. Not a name:\nit disappears on the first keystroke, so pair it with `aria-label` or a\n`FieldLabel`. Declared for the props-table row, as `aria-label` is above.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -30,7 +56,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
     "--cue-border-strong",
     "--cue-control-lg",

package/manifest/components/theme-configurator.json

@@ -14,63 +14,101 @@
       "type": "\"floating\" | \"docked-right\"",
       "required": false,
       "defaultValue": null,
-      "description": "Placement, controlled. Pair with `onPositionChange`."
+      "description": "Placement, controlled. Pair with `onPositionChange`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "floating",
+          "docked-right"
+        ]
+      }
     },
     {
       "name": "defaultPosition",
       "type": "\"floating\" | \"docked-right\"",
       "required": false,
       "defaultValue": "floating",
-      "description": "Initial placement. A stored one wins. Defaults to `\"floating\"`."
+      "description": "Initial placement. A stored one wins. Defaults to `\"floating\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "floating",
+          "docked-right"
+        ]
+      }
     },
     {
       "name": "onPositionChange",
       "type": "((position: ConfiguratorPosition) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the user docks or floats the panel."
+      "description": "Called when the user docks or floats the panel.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "defaultCollapsed",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Start furled to the title bar. A stored value wins. Defaults to `false`."
+      "description": "Start furled to the title bar. A stored value wins. Defaults to `false`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "storageKey",
       "type": "string",
       "required": false,
       "defaultValue": "cue-configurator",
-      "description": "`localStorage` key holding the overrides, the placement and the zoom.\nDefaults to `\"cue-configurator\"`."
+      "description": "`localStorage` key holding the overrides, the placement and the zoom.\nDefaults to `\"cue-configurator\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onChange",
       "type": "((tokens: Record<string, string>) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the full resolved `--cue-*` map — never a diff — whenever the\noverrides, the theme or the mode change, and once on mount."
+      "description": "Called with the full resolved `--cue-*` map — never a diff — whenever the\noverrides, the theme or the mode change, and once on mount.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "zoomShortcuts",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Bind ⌘/Ctrl with `+`, `-` and `0` to the zoom valve. Defaults to `true`."
+      "description": "Bind ⌘/Ctrl with `+`, `-` and `0` to the zoom valve. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "title",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Theme",
-      "description": "Panel heading. Defaults to `\"Theme\"`."
+      "description": "Panel heading. Defaults to `\"Theme\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the panel."
+      "description": "Extra classes for the panel.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],
@@ -79,7 +117,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-accent-soft",
     "--cue-border",
     "--cue-border-overlay",
@@ -90,7 +127,6 @@
     "--cue-fg-subtle",
     "--cue-font-mono",
     "--cue-font-sans",
-    "--cue-font-scale",
     "--cue-icon-sm",
     "--cue-radius-control",
     "--cue-radius-overlay",