@cueplusplus/ui 0.9.0 → 0.10.0

package/manifest/components/elements-timeline.json

@@ -12,14 +12,20 @@
       "type": "readonly TimelineEvent[]",
       "required": true,
       "defaultValue": null,
-      "description": "Events in chronological order, past and scheduled together."
+      "description": "Events in chronological order, past and scheduled together.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many events have been resolved."
+      "description": "How many events have been resolved.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/elicitation-form.json

@@ -14,42 +14,67 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which server paused to ask."
+      "description": "Which server paused to ask.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "message",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Why the input is needed, in the server's words."
+      "description": "Why the input is needed, in the server's words.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "fields",
       "type": "readonly ElicitationField[]",
       "required": true,
       "defaultValue": null,
-      "description": "The schema the server sent, already resolved to display values."
+      "description": "The schema the server sent, already resolved to display values.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "state",
       "type": "\"request\" | \"accepted\" | \"declined\"",
       "required": true,
       "defaultValue": null,
-      "description": "Swaps the action row for the outcome once the user answers."
+      "description": "Swaps the action row for the outcome once the user answers.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "request",
+          "accepted",
+          "declined"
+        ]
+      }
     },
     {
       "name": "onAccept",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the filled form is sent back."
+      "description": "Called when the filled form is sent back.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDecline",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the request is refused."
+      "description": "Called when the request is refused.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/empty-state-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/empty-state-suggestion.json

@@ -14,7 +14,10 @@
       "type": "number",
       "required": false,
       "defaultValue": "0",
-      "description": "Position in the row. Staggers the entrance so the pills arrive in order."
+      "description": "Position in the row. Staggers the entrance so the pills arrive in order.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/empty-state.json

@@ -12,35 +12,55 @@
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "What is missing. One short line: \"No cues yet\"."
+      "description": "What is missing. One short line: \"No cues yet\".",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "hint",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "How to fix it. One sentence, muted."
+      "description": "How to fix it. One sentence, muted.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "action",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The way out — normally a single `Button`."
+      "description": "The way out — normally a single `Button`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "icon",
       "type": "ElementType<any, keyof IntrinsicElements>",
       "required": false,
       "defaultValue": null,
-      "description": "Optional glyph above the title (e.g. a lucide icon), drawn `aria-hidden`."
+      "description": "Optional glyph above the title (e.g. a lucide icon), drawn `aria-hidden`.",
+      "control": {
+        "kind": "opaque",
+        "fixture": "icon.play"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Extra content between the hint and the action — rarely needed."
+      "description": "Extra content between the hint and the action — rarely needed.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/end-of-turn-summary.json

@@ -12,28 +12,40 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many files the turn touched."
+      "description": "How many files the turn touched.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "additions",
       "type": "number",
       "required": false,
       "defaultValue": "0",
-      "description": "Lines added across them."
+      "description": "Lines added across them.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "deletions",
       "type": "number",
       "required": false,
       "defaultValue": "0",
-      "description": "Lines removed across them."
+      "description": "Lines removed across them.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The whole line, replacing the one {@link formatChangeSummary} would build —\nfor a turn whose result is not a diff at all: `2 cues written`,\n`Nothing to change`."
+      "description": "The whole line, replacing the one {@link formatChangeSummary} would build —\nfor a turn whose result is not a diff at all: `2 cues written`,\n`Nothing to change`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/env-var-input.json

@@ -12,84 +12,126 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The value — a literal, or an `env(NAME)` reference. Use with `onValueChange`."
+      "description": "The value — a literal, or an `env(NAME)` reference. Use with `onValueChange`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "defaultValue",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Initial value for an uncontrolled field."
+      "description": "Initial value for an uncontrolled field.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the new value: on every keystroke in the literal state, and with\n`\"\"` when the variable pill is cleared. One argument, because the pill's\nclear button has no DOM change event to hand on."
+      "description": "Called with the new value: on every keystroke in the literal state, and with\n`\"\"` when the variable pill is cleared. One argument, because the pill's\nclear button has no DOM change event to hand on.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Shown while the literal field is empty."
+      "description": "Shown while the literal field is empty.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "secret",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Mask the literal value. The reference is never masked — a name is not a secret."
+      "description": "Mask the literal value. The reference is never masked — a name is not a secret.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "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": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Prevent editing and grey the control out."
+      "description": "Prevent editing and grey the control out.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "name",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Name for the underlying input, when the field is part of a form."
+      "description": "Name for the underlying 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 underlying input."
+      "description": "Id forwarded to the underlying input.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the field, when no {@link FieldLabel } names it."
+      "description": "Accessible name for the field, when no {@link FieldLabel } names it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "clearLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Clear environment variable",
-      "description": "Accessible name for the pill's clear button. Defaults to `\"Clear environment variable\"`."
+      "description": "Accessible name for the pill's clear button. Defaults to `\"Clear environment variable\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the wrapper."
+      "description": "Extra classes for the wrapper.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/error-state.json

@@ -14,28 +14,41 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Primary failure headline shown in the banner."
+      "description": "Primary failure headline shown in the banner.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "detail",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Supporting detail under the title explaining what went wrong."
+      "description": "Supporting detail under the title explaining what went wrong.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "retrying",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true the banner swaps to a spinning Retrying status instead of the error."
+      "description": "When true the banner swaps to a spinning Retrying status instead of the error.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onRetry",
       "type": "() => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when the retry control is pressed."
+      "description": "Called when the retry control is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/export-dialog.json

@@ -12,35 +12,57 @@
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the dialog is showing."
+      "description": "Whether the dialog is showing.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "(open: boolean) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when it should open or close."
+      "description": "Called when it should open or close.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "overrides",
       "type": "ThemeOverrides",
       "required": true,
       "defaultValue": null,
-      "description": "The overrides to export."
+      "description": "The overrides to export.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "scope",
       "type": "ThemeScope",
       "required": true,
       "defaultValue": null,
-      "description": "The theme and mode they were made in."
+      "description": "The theme and mode they were made in.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "defaultFormat",
       "type": "\"css\" | \"dtcg\" | \"create-theme\" | \"registry\"",
       "required": false,
       "defaultValue": "css",
-      "description": "Format shown first. Defaults to `\"css\"`."
+      "description": "Format shown first. Defaults to `\"css\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "css",
+          "dtcg",
+          "create-theme",
+          "registry"
+        ]
+      }
     }
   ],
   "typeReferences": [],
@@ -49,14 +71,11 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
-    "--cue-density",
     "--cue-fg",
     "--cue-fg-muted",
     "--cue-font-mono",
     "--cue-font-sans",
-    "--cue-font-scale",
     "--cue-radius-control",
     "--cue-space-1",
     "--cue-space-3",

package/manifest/components/eyebrow.json

@@ -12,7 +12,10 @@
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Print the `//` motif ahead of the label. Defaults to `true` — the slashes\nare the brand mark of this system, and an eyebrow without them is just\nsmall uppercase text. Pass `false` for a plain kicker."
+      "description": "Print the `//` motif ahead of the label. Defaults to `true` — the slashes\nare the brand mark of this system, and an eyebrow without them is just\nsmall uppercase text. Pass `false` for a plain kicker.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/feedback-dialog.json

@@ -14,49 +14,75 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The reason chips offered. Keep them short enough to scan in one line."
+      "description": "The reason chips offered. Keep them short enough to scan in one line.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "selected",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Which reasons are currently picked. More than one is allowed."
+      "description": "Which reasons are currently picked. More than one is allowed.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "note",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Free-text detail, always optional."
+      "description": "Free-text detail, always optional.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "sent",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Replaces the whole form with an acknowledgement once the report is filed."
+      "description": "Replaces the whole form with an acknowledgement once the report is filed.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onToggleReason",
       "type": "((reason: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a reason chip is picked or unpicked."
+      "description": "Called when a reason chip is picked or unpicked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onNoteChange",
       "type": "((note: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the free-text note is typed."
+      "description": "Called as the free-text note is typed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSubmit",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the report is sent."
+      "description": "Called when the report is sent.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/field-description.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the helper-text defaults."
+      "description": "Extra classes, merged over the helper-text defaults.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/field-error.json

@@ -12,21 +12,31 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the danger-text defaults."
+      "description": "Extra classes, merged over the danger-text defaults.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Message to show when driving visibility from `match` instead of `issues`."
+      "description": "Message to show when driving visibility from `match` instead of `issues`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "issues",
       "type": "readonly FieldIssue[]",
       "required": false,
       "defaultValue": null,
-      "description": "Standard Schema issues for this field. When supplied, the component shows\nexactly these messages and stops consulting native `ValidityState`: an\nempty array renders nothing, one issue renders inline, several render as a\nlist. Leave it `undefined` to fall back to `match` + `children`."
+      "description": "Standard Schema issues for this field. When supplied, the component shows\nexactly these messages and stops consulting native `ValidityState`: an\nempty array renders nothing, one issue renders inline, several render as a\nlist. Leave it `undefined` to fall back to `match` + `children`.",
+      "control": {
+        "kind": "array"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/field-label.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the label typography."
+      "description": "Extra classes, merged over the label typography.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [