@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/approval-card.json

@@ -14,49 +14,79 @@
       "type": "\"done\" | \"running\" | \"request\" | \"denied\"",
       "required": true,
       "defaultValue": null,
-      "description": "Lifecycle of the card: request with actions, running spinner, done check, or denied."
+      "description": "Lifecycle of the card: request with actions, running spinner, done check, or denied.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "done",
+          "running",
+          "request",
+          "denied"
+        ]
+      }
     },
     {
       "name": "command",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Command shown in the mono field the agent wants to run."
+      "description": "Command shown in the mono field the agent wants to run.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "title",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Headline naming the action that needs approval."
+      "description": "Headline naming the action that needs approval.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "subtitle",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Supporting line under the title explaining the request."
+      "description": "Supporting line under the title explaining the request.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onAllowOnce",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the user clicks Allow once."
+      "description": "Called when the user clicks Allow once.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onAlwaysAllow",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the user clicks Always allow."
+      "description": "Called when the user clicks Always allow.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDeny",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the user clicks Deny."
+      "description": "Called when the user clicks Deny.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/artifact-card.json

@@ -14,28 +14,40 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Name of the generated artifact."
+      "description": "Name of the generated artifact.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "meta",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Resting meta line shown once generation finishes, for example kind, version, and\nrecency."
+      "description": "Resting meta line shown once generation finishes, for example kind, version, and\nrecency.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "generating",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "While true the icon pulses and the meta line shows a live word count with a shimmer."
+      "description": "While true the icon pulses and the meta line shows a live word count with a shimmer.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "words",
       "type": "number",
       "required": false,
       "defaultValue": "0",
-      "description": "Live word count shown while generating."
+      "description": "Live word count shown while generating.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/ask-box.json

@@ -12,147 +12,225 @@
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The question, as text or nodes. Rendered verbatim — never parsed."
+      "description": "The question, as text or nodes. Rendered verbatim — never parsed.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "kind",
       "type": "\"number\" | \"boolean\" | \"text\" | \"single\" | \"multi\"",
       "required": false,
       "defaultValue": "text",
-      "description": "Which widget to offer. Defaults to `\"text\"`."
+      "description": "Which widget to offer. Defaults to `\"text\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "number",
+          "boolean",
+          "text",
+          "single",
+          "multi"
+        ]
+      }
     },
     {
       "name": "options",
       "type": "readonly AskOption[]",
       "required": false,
       "defaultValue": null,
-      "description": "Choices for a `single` or `multi` question."
+      "description": "Choices for a `single` or `multi` question.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onAnswer",
       "type": "(value: AskAnswer) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Fired once with the answer. The host is responsible for resuming the run."
+      "description": "Fired once with the answer. The host is responsible for resuming the run.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "answer",
       "type": "AskAnswer",
       "required": false,
       "defaultValue": null,
-      "description": "The answer, once there is one. Present means answered: the box collapses to\na one-line summary and stops accepting input."
+      "description": "The answer, once there is one. Present means answered: the box collapses to\na one-line summary and stops accepting input.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "asker",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Slug of the agent asking, for the byline and the box's colour."
+      "description": "Slug of the agent asking, for the byline and the box's colour.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "rootAgent",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Slug of the orchestrator, so its questions take the theme accent."
+      "description": "Slug of the orchestrator, so its questions take the theme accent.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "tool",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Tool this question is approving, if it is an approval."
+      "description": "Tool this question is approving, if it is an approval.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "danger",
       "type": "\"low\" | \"high\" | \"critical\"",
       "required": false,
       "defaultValue": null,
-      "description": "Risk rating for the tool call. Omit for a plain question."
+      "description": "Risk rating for the tool call. Omit for a plain question.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "low",
+          "high",
+          "critical"
+        ]
+      }
     },
     {
       "name": "defaultValue",
       "type": "AskAnswer",
       "required": false,
       "defaultValue": null,
-      "description": "Initial widget value. A string for `text`/`single`, an array for `multi`, a number for `number`."
+      "description": "Initial widget value. A string for `text`/`single`, an array for `multi`, a number for `number`.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Placeholder for the `text` widget."
+      "description": "Placeholder for the `text` widget.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "min",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Lower bound for the `number` widget."
+      "description": "Lower bound for the `number` widget.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "max",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Upper bound for the `number` widget."
+      "description": "Upper bound for the `number` widget.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "step",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Increment the `number` widget's stepper moves by."
+      "description": "Increment the `number` widget's stepper moves by.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "unit",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Unit shown beside a number, and in the answered summary."
+      "description": "Unit shown beside a number, and in the answered summary.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "confirmLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Confirm",
-      "description": "Label on the affirmative half of a `boolean`. Defaults to `\"Confirm\"`."
+      "description": "Label on the affirmative half of a `boolean`. Defaults to `\"Confirm\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "rejectLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Reject",
-      "description": "Label on the negative half of a `boolean`. Defaults to `\"Reject\"`."
+      "description": "Label on the negative half of a `boolean`. Defaults to `\"Reject\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "submitLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Submit",
-      "description": "Label on the submit button. Defaults to `\"Submit\"`."
+      "description": "Label on the submit button. Defaults to `\"Submit\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "busy",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "The answer is in flight: locks the widget and says so."
+      "description": "The answer is in flight: locks the widget and says so.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "defaultOpen",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Expand the answered summary from the start. Defaults to `false`."
+      "description": "Expand the answered summary from the start. Defaults to `false`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the widget when `question` is not plain text."
+      "description": "Accessible name for the widget when `question` is not plain text.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/audience-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "An audience: a named group of people something is published to.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/autocomplete.json

@@ -12,126 +12,188 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The suggestions, filtered against what is typed."
+      "description": "The suggestions, filtered against what is typed.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "value",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Current text. Use with `onValueChange` for a controlled field."
+      "description": "Current text. Use with `onValueChange` for a controlled field.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "defaultValue",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Initial text for an uncontrolled field."
+      "description": "Initial text for an uncontrolled field.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Fired on every keystroke and when a suggestion is picked."
+      "description": "Fired on every keystroke and when a suggestion is picked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Shown while the field is empty."
+      "description": "Shown while the field is empty.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "emptyMessage",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "No matches",
-      "description": "Shown in place of the list when the query matches nothing."
+      "description": "Shown in place of the list when the query matches nothing.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": null,
-      "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": "autoHighlight",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Highlight the first match automatically so Enter accepts it."
+      "description": "Highlight the first match automatically so Enter accepts it.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Prevent opening and grey the field out."
+      "description": "Prevent opening and grey the field out.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "required",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Require text before the owning form submits."
+      "description": "Require text before the owning form submits.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "name",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Name for the input, when the field is part of a form."
+      "description": "Name for the 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 input."
+      "description": "Id forwarded to the 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": "clearLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Clear",
-      "description": "Accessible name for the clear button. Defaults to `\"Clear\"`."
+      "description": "Accessible name for the clear button. Defaults to `\"Clear\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "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/avatar-group.json

@@ -12,14 +12,25 @@
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Show at most this many avatars; the rest collapse into a `+N` chip. Omit for no limit."
+      "description": "Show at most this many avatars; the rest collapse into a `+N` chip. Omit for no limit.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
       "defaultValue": "md",
-      "description": "Size of the `+N` overflow chip. Match it to the avatars you pass in. Defaults to `\"md\"`."
+      "description": "Size of the `+N` overflow chip. Match it to the avatars you pass in. Defaults to `\"md\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      }
     }
   ],
   "typeReferences": [