@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/command-palette.json

@@ -12,91 +12,135 @@
       "type": "readonly CommandPaletteItem[]",
       "required": true,
       "defaultValue": null,
-      "description": "Every command the palette can run, in the order they should appear."
+      "description": "Every command the palette can run, in the order they should appear.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onSelect",
       "type": "(item: CommandPaletteItem) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with the command the user ran. The palette closes itself afterwards."
+      "description": "Called with the command the user ran. The palette closes itself afterwards.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Open state when controlled. Pass with `onOpenChange`."
+      "description": "Open state when controlled. Pass with `onOpenChange`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "defaultOpen",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Initial open state when uncontrolled. Defaults to `false`."
+      "description": "Initial open state when uncontrolled. Defaults to `false`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called whenever the palette wants to open or close."
+      "description": "Called whenever the palette wants to open or close.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": "Type a command",
-      "description": "Shown while the query is empty. Defaults to `\"Type a command\"`."
+      "description": "Shown while the query is empty. Defaults to `\"Type a command\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "emptyMessage",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "No commands match",
-      "description": "Shown in place of the list when nothing matches. Defaults to `\"No commands match\"`."
+      "description": "Shown in place of the list when nothing matches. Defaults to `\"No commands match\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Command palette",
-      "description": "Accessible name for the dialog and the input. Defaults to `\"Command palette\"`."
+      "description": "Accessible name for the dialog and the input. Defaults to `\"Command palette\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "footer",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "(\n  <>\n    <span>↑↓ navigate</span>\n    <span>⏎ run</span>\n    <span>esc close</span>\n  </>\n)",
-      "description": "The hint strip along the foot. Pass `null` to drop it."
+      "description": "The hint strip along the foot. Pass `null` to drop it.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "debounceMs",
       "type": "number",
       "required": false,
       "defaultValue": "200",
-      "description": "Quiet period in ms before the query is re-matched. Defaults to `200`.\n\nThe field itself never waits — only the matching does — so typing stays at\none frame per keystroke however long the command list is."
+      "description": "Quiet period in ms before the query is re-matched. Defaults to `200`.\n\nThe field itself never waits — only the matching does — so typing stays at\none frame per keystroke however long the command list is.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "filter",
       "type": "((items: readonly CommandPaletteItem[], query: string) => CommandPaletteItem[])",
       "required": false,
       "defaultValue": "defaultFilter",
-      "description": "Replace the matcher. Defaults to a case-insensitive substring match over\n`label` and `keywords`. Return the surviving commands in display order."
+      "description": "Replace the matcher. Defaults to a case-insensitive substring match over\n`label` and `keywords`. Return the surviving commands in display order.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the palette surface."
+      "description": "Extra classes for the palette surface.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "backdropClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the scrim behind it."
+      "description": "Extra classes for the scrim behind it.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/compaction-row.json

@@ -14,49 +14,77 @@
       "type": "\"failed\" | \"started\" | \"completed\" | \"cancelled\" | \"skipped\"",
       "required": true,
       "defaultValue": null,
-      "description": "Where the compaction got to. See `COMPACTION_STATES`."
+      "description": "Where the compaction got to. See `COMPACTION_STATES`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "failed",
+          "started",
+          "completed",
+          "cancelled",
+          "skipped"
+        ]
+      }
     },
     {
       "name": "tokensBefore",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Tokens in the window before it ran."
+      "description": "Tokens in the window before it ran.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "tokensAfter",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Tokens after. Omit while it is running, or when it did not finish."
+      "description": "Tokens after. Omit while it is running, or when it did not finish.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "messagesBefore",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Messages in the window before it ran."
+      "description": "Messages in the window before it ran.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "messagesAfter",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Messages after. Omit while it is running, or when it did not finish."
+      "description": "Messages after. Omit while it is running, or when it did not finish.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What the rule says, replacing the one `COMPACTION_LABELS` supplies for this\nstate."
+      "description": "What the rule says, replacing the one `COMPACTION_LABELS` supplies for this\nstate.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "reason",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Why, for the two states that owe an answer: `context window still under\n60%`, `the summariser refused`. Roo's rule — a compaction that did not\nhappen, or that lost something, should say so in words rather than leave a\nreader to infer it from a number that did not move."
+      "description": "Why, for the two states that owe an answer: `context window still under\n60%`, `the summariser refused`. Roo's rule — a compaction that did not\nhappen, or that lost something, should say so in words rather than leave a\nreader to infer it from a number that did not move.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/comparison-card.json

@@ -14,28 +14,41 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The dimensions compared, in order. Used as the fallback label when an option lacks\na trait."
+      "description": "The dimensions compared, in order. Used as the fallback label when an option lacks\na trait.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "options",
       "type": "readonly ComparisonOption[]",
       "required": true,
       "defaultValue": null,
-      "description": "Two or three options. More than that wants a table, not a comparison."
+      "description": "Two or three options. More than that wants a table, not a comparison.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "recommendedId",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Which option is the pick. It is tinted and labelled rather than merely ordered first."
+      "description": "Which option is the pick. It is tinted and labelled rather than merely ordered first.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "reason",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Why that one, in the user's terms. A comparison without a recommendation is an\nunanswered question."
+      "description": "Why that one, in the user's terms. A comparison without a recommendation is an\nunanswered question.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-attachment-chip.json

@@ -14,14 +14,21 @@
       "type": "ComposerAttachment",
       "required": true,
       "defaultValue": null,
-      "description": "The file this chip stands for."
+      "description": "The file this chip stands for.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "onRemove",
       "type": "((name: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the attachment's name. Omit it and a finished chip shows a tick\ninstead of a remove button."
+      "description": "Called with the attachment's name. Omit it and a finished chip shows a tick\ninstead of a remove button.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-bar.json

@@ -14,7 +14,10 @@
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Whether a file is being dragged over the bar."
+      "description": "Whether a file is being dragged over the bar.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-command-item.json

@@ -14,14 +14,20 @@
       "type": "ComposerCommand",
       "required": true,
       "defaultValue": null,
-      "description": "The command this row offers."
+      "description": "The command this row offers.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "active",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether this is the row Enter would run."
+      "description": "Whether this is the row Enter would run.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-context.json

@@ -14,7 +14,10 @@
       "type": "ComposerUsage",
       "required": true,
       "defaultValue": null,
-      "description": "Where the window has gone, and how big it is."
+      "description": "Where the window has gone, and how big it is.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-input.json

@@ -14,7 +14,11 @@
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called on Enter, guarded against IME composition so accepting a candidate does not\nsend."
+      "description": "Called on Enter, guarded against IME composition so accepting a candidate does not\nsend.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-menu-item.json

@@ -14,7 +14,10 @@
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Whether this is the row the keyboard is on."
+      "description": "Whether this is the row the keyboard is on.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-menu.json

@@ -14,14 +14,24 @@
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the menu is showing. Closed is animated out, not unmounted."
+      "description": "Whether the menu is showing. Closed is animated out, not unmounted.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "align",
       "type": "\"end\" | \"start\"",
       "required": false,
       "defaultValue": "start",
-      "description": "Which edge of the composer the menu hangs from."
+      "description": "Which edge of the composer the menu hangs from.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "end",
+          "start"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-model-item.json

@@ -14,14 +14,20 @@
       "type": "ComposerModel",
       "required": true,
       "defaultValue": null,
-      "description": "The model this row offers."
+      "description": "The model this row offers.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "selected",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether this is the model in use. Draws the tick."
+      "description": "Whether this is the model in use. Draws the tick.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-model-trigger.json

@@ -14,14 +14,20 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The name to show, which is the selected model."
+      "description": "The name to show, which is the selected model.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the menu it opens is showing. Announced as `aria-expanded`."
+      "description": "Whether the menu it opens is showing. Announced as `aria-expanded`.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-person-item.json

@@ -14,14 +14,20 @@
       "type": "ComposerPerson",
       "required": true,
       "defaultValue": null,
-      "description": "The person this row would mention."
+      "description": "The person this row would mention.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "active",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether this is the row Enter would pick."
+      "description": "Whether this is the row Enter would pick.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-send.json

@@ -14,14 +14,20 @@
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Swaps the arrow for a stop square."
+      "description": "Swaps the arrow for a stop square.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "idle",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the input is empty. Dims the button when there is nothing to send."
+      "description": "Whether the input is empty. Dims the button when there is nothing to send.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-voice-button.json

@@ -14,7 +14,10 @@
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the microphone is open."
+      "description": "Whether the microphone is open.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/composer-voice.json

@@ -14,14 +14,20 @@
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the microphone is open. False is the transcribing state, not the resting one."
+      "description": "Whether the microphone is open. False is the transcribing state, not the resting one.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "seconds",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How long it has been recording. Drives both the clock and the meter, so the caller\nowns the tick."
+      "description": "How long it has been recording. Drives both the clock and the meter, so the caller\nowns the tick.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [