@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/edit-message.json

@@ -14,49 +14,74 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The message text, read when resting and edited when open."
+      "description": "The message text, read when resting and edited when open.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "discardedReplies",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many replies sending would drop. The warning hides at zero."
+      "description": "How many replies sending would drop. The warning hides at zero.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "editing",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Swaps between the resting bubble and the edit composer."
+      "description": "Swaps between the resting bubble and the edit composer.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the message is edited."
+      "description": "Called as the message is edited.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSave",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the edited message is sent."
+      "description": "Called when the edited message is sent.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onCancel",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the edit is abandoned. Restore the original yourself."
+      "description": "Called when the edit is abandoned. Restore the original yourself.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onStartEdit",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the resting bubble is clicked."
+      "description": "Called when the resting bubble is clicked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/elements-command-palette.json

@@ -14,42 +14,63 @@
       "type": "readonly PaletteCommand[]",
       "required": true,
       "defaultValue": null,
-      "description": "Everything runnable. Groups are derived from the entries and keep first-seen order."
+      "description": "Everything runnable. Groups are derived from the entries and keep first-seen order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "query",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Current filter text."
+      "description": "Current filter text.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "activeId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which row is highlighted. Arrow keys move it and Enter runs it, both handled by\nthe element; it reports the move through onActiveChange."
+      "description": "Which row is highlighted. Arrow keys move it and Enter runs it, both handled by\nthe element; it reports the move through onActiveChange.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onQueryChange",
       "type": "((query: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the filter is typed."
+      "description": "Called as the filter is typed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onActiveChange",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the arrow keys walk the list. The element owns the key handling and\nreports where it landed, so activeId stays yours to hold."
+      "description": "Called as the arrow keys walk the list. The element owns the key handling and\nreports where it landed, so activeId stays yours to hold.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onRun",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a command is chosen."
+      "description": "Called when a command is chosen.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/elements-data-table.json

@@ -12,14 +12,21 @@
       "type": "readonly ModelUsage[]",
       "required": true,
       "defaultValue": null,
-      "description": "Table rows with model name, context window, and cost."
+      "description": "Table rows with model name, context window, and cost.",
+      "control": {
+        "kind": "array",
+        "fixture": "table.model-usage-6"
+      }
     },
     {
       "name": "cycle",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Identity key that remounts the body so row entrance can replay."
+      "description": "Identity key that remounts the body so row entrance can replay.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

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": [