@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/onboarding.json

@@ -12,28 +12,42 @@
       "type": "readonly OnboardingStep[]",
       "required": true,
       "defaultValue": null,
-      "description": "What to teach, in order. Three is usually the limit before it is skipped."
+      "description": "What to teach, in order. Three is usually the limit before it is skipped.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "index",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Which step is showing. The final step's action reads Start instead of Next."
+      "description": "Which step is showing. The final step's action reads Start instead of Next.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onNext",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to advance."
+      "description": "Called to advance.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSkip",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called to dismiss. Always offer it."
+      "description": "Called to dismiss. Always offer it.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/otp-field.json

@@ -12,63 +12,97 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the row."
+      "description": "Extra classes for the row.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "id",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id of the first slot. Generated when omitted, so the hidden label can target it."
+      "description": "Id of the first slot. Generated when omitted, so the hidden label can target it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the field. Names the group *and*, through a visually\nhidden `<label>`, the first slot — the ARIA pattern for a code field. Leave\nit off inside a {@link Field }, which supplies a real label."
+      "description": "Accessible name for the field. Names the group *and*, through a visually\nhidden `<label>`, the first slot — the ARIA pattern for a code field. Leave\nit off inside a {@link Field }, which supplies a real label.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "separator",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "–",
-      "description": "What sits between groups. Defaults to `\"–\"`. Always `aria-hidden`."
+      "description": "What sits between groups. Defaults to `\"–\"`. Always `aria-hidden`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "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": "length",
       "type": "number",
       "required": false,
       "defaultValue": "6",
-      "description": "How many characters the code has. Defaults to `6`."
+      "description": "How many characters the code has. Defaults to `6`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "groupSize",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Insert a separator after every `groupSize` slots — `groupSize={3}` renders a\nsix-character code as `123 456`, which is how people read one off a screen."
+      "description": "Insert a separator after every `groupSize` slots — `groupSize={3}` renders a\nsix-character code as `123 456`, which is how people read one off a screen.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "slotLabel",
       "type": "((index: number, length: number) => string)",
       "required": false,
       "defaultValue": "(index, total) => `Character ${index + 1} of ${total}`",
-      "description": "Accessible name for slot `index` (1-based here, since slot 0 is named by the\nfield label) of `length`. Defaults to\n``(index, length) => `Character ${index + 1} of ${length}` ``."
+      "description": "Accessible name for slot `index` (1-based here, since slot 0 is named by the\nfield label) of `length`. Defaults to\n``(index, length) => `Character ${index + 1} of ${length}` ``.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "slotClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for every slot."
+      "description": "Extra classes for every slot.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [
@@ -79,7 +113,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
     "--cue-border-strong",
     "--cue-control-lg",

package/manifest/components/page-shell.json

@@ -12,42 +12,71 @@
       "type": "\"narrow\" | \"wide\" | \"broad\" | \"full\"",
       "required": false,
       "defaultValue": "narrow",
-      "description": "Which measure the content column takes. Defaults to `\"narrow\"`."
+      "description": "Which measure the content column takes. Defaults to `\"narrow\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "narrow",
+          "wide",
+          "broad",
+          "full"
+        ]
+      }
     },
     {
       "name": "title",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The page heading. Rendered as the `<h1>`."
+      "description": "The page heading. Rendered as the `<h1>`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "subtitle",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "One supporting line under the title."
+      "description": "One supporting line under the title.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "eyebrow",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Accent kicker above the title — normally an `<Eyebrow>`."
+      "description": "Accent kicker above the title — normally an `<Eyebrow>`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "actions",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Page-level actions, aligned with the title."
+      "description": "Page-level actions, aligned with the title.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The page body."
+      "description": "The page body.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/pagination.json

@@ -12,35 +12,51 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "The current page, 1-based."
+      "description": "The current page, 1-based.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "pageCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many pages there are in total."
+      "description": "How many pages there are in total.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "onPageChange",
       "type": "(page: number) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called with the page a control asked for. Always within `1..pageCount`."
+      "description": "Called with the page a control asked for. Always within `1..pageCount`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "siblingCount",
       "type": "number",
       "required": false,
       "defaultValue": "1",
-      "description": "How many pages to show either side of the current one. Defaults to `1`."
+      "description": "How many pages to show either side of the current one. Defaults to `1`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": "Pagination",
-      "description": "The nav's accessible name. Defaults to `\"Pagination\"`."
+      "description": "The nav's accessible name. Defaults to `\"Pagination\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/panel-header.json

@@ -12,21 +12,33 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The header's label. Rendered one type rung above body text — the panel's\nown name, not a page heading."
+      "description": "The header's label. Rendered one type rung above body text — the panel's\nown name, not a page heading.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "actions",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Right-hand slot: the controls that act on the whole panel (a menu, a\nrefresh button, a count chip)."
+      "description": "Right-hand slot: the controls that act on the whole panel (a menu, a\nrefresh button, a count chip).",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Extra content in the leading cluster, after the title."
+      "description": "Extra content in the leading cluster, after the title.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/password-input.json

@@ -12,56 +12,86 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the group that wraps the input and the reveal button."
+      "description": "Extra classes for the group that wraps the input and the reveal button.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "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": "hideLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Hide password",
-      "description": "Accessible name while revealed. Defaults to `\"Hide password\"`."
+      "description": "Accessible name while revealed. Defaults to `\"Hide password\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "revealed",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Reveal the value. Use with `onRevealedChange` for a controlled toggle."
+      "description": "Reveal the value. Use with `onRevealedChange` for a controlled toggle.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "defaultRevealed",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Initially revealed, for an uncontrolled toggle. Defaults to `false`."
+      "description": "Initially revealed, for an uncontrolled toggle. Defaults to `false`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onRevealedChange",
       "type": "((revealed: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the new reveal state."
+      "description": "Called with the new reveal state.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "showReveal",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Offer the reveal affordance at all. Defaults to `true`. Switch it off for a\nvalue the product must never re-display — a stored secret the user is\nreplacing rather than reading."
+      "description": "Offer the reveal affordance at all. Defaults to `true`. Switch it off for a\nvalue the product must never re-display — a stored secret the user is\nreplacing rather than reading.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "revealLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Show password",
-      "description": "Accessible name while masked. Defaults to `\"Show password\"`."
+      "description": "Accessible name while masked. Defaults to `\"Show password\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/permission-grant.json

@@ -14,35 +14,58 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "What is being granted, named as a capability rather than an action."
+      "description": "What is being granted, named as a capability rather than an action.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "requester",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Who is asking."
+      "description": "Who is asking.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "reach",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Exactly what the grant covers, and what it does not. Write the limits in too."
+      "description": "Exactly what the grant covers, and what it does not. Write the limits in too.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "scope",
       "type": "\"pending\" | \"always\" | \"denied\" | \"session\"",
       "required": true,
       "defaultValue": null,
-      "description": "pending shows the choices; anything else shows the settled outcome."
+      "description": "pending shows the choices; anything else shows the settled outcome.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "pending",
+          "always",
+          "denied",
+          "session"
+        ]
+      }
     },
     {
       "name": "onGrant",
       "type": "((scope: GrantScope) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the scope the user chose."
+      "description": "Called with the scope the user chose.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/permission-scopes.json

@@ -12,84 +12,129 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "The question, in the words of the thing being asked for: `Run this\ncommand?`, `Edit this file?`. One step up in size, as the reference sets\nit: it is the only sentence on the card that has to be read."
+      "description": "The question, in the words of the thing being asked for: `Run this\ncommand?`, `Edit this file?`. One step up in size, as the reference sets\nit: it is the only sentence on the card that has to be read.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "subject",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The file, host or command the question is about, set in mono beside it.\nOmit for a question that names its own subject."
+      "description": "The file, host or command the question is about, set in mono beside it.\nOmit for a question that names its own subject.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "input",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The exact input the call would run with, drawn in a recessed mono box —\nthe command, the patch, the URL. Shown verbatim and never parsed."
+      "description": "The exact input the call would run with, drawn in a recessed mono box —\nthe command, the patch, the URL. Shown verbatim and never parsed.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "rules",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": "[]",
-      "description": "The rules a standing grant would write, exactly as they will be written.\nThe always-allow answer's label is built from these; when there are more\nthan the label can name, all of them are listed under it."
+      "description": "The rules a standing grant would write, exactly as they will be written.\nThe always-allow answer's label is built from these; when there are more\nthan the label can name, all of them are listed under it.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "ruleKind",
       "type": "\"directory\" | \"rule\"",
       "required": false,
       "defaultValue": "rule",
-      "description": "Whether `rules` are rules or directories, which changes the phrasing."
+      "description": "Whether `rules` are rules or directories, which changes the phrasing.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "directory",
+          "rule"
+        ]
+      }
     },
     {
       "name": "scopes",
       "type": "readonly PermissionScope[]",
       "required": false,
       "defaultValue": "[]",
-      "description": "Where a standing grant can be written, in the order they are offered.\n**No scopes means no always-allow answer**: a permanent grant that cannot\nsay where it is saved is not one this element will offer."
+      "description": "Where a standing grant can be written, in the order they are offered.\n**No scopes means no always-allow answer**: a permanent grant that cannot\nsay where it is saved is not one this element will offer.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "scope",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Which scope is chosen, by `id`. Defaults to the first. Claude Code\npersists this choice across prompts and so should a console — which is why\nit is a prop here rather than state: this element never remembers anything."
+      "description": "Which scope is chosen, by `id`. Defaults to the first. Claude Code\npersists this choice across prompts and so should a console — which is why\nit is a prop here rather than state: this element never remembers anything.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onScopeChange",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the next scope's `id` when the destination is cycled."
+      "description": "Called with the next scope's `id` when the destination is cycled.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onAllowOnce",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Yes, once. The answer exists only when this is given."
+      "description": "Yes, once. The answer exists only when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onAlwaysAllow",
       "type": "((scope: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Yes, and write the rules to the chosen scope — reported by `id`. The\nanswer exists only when this **and** at least one scope are given."
+      "description": "Yes, and write the rules to the chosen scope — reported by `id`. The\nanswer exists only when this **and** at least one scope are given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onDeny",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "No. Also what `Escape` does, while focus is inside the card. The answer\nexists only when this is given."
+      "description": "No. Also what `Escape` does, while focus is inside the card. The answer\nexists only when this is given.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<PermissionLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "The card's own six strings, merged over `PERMISSION_LABELS`."
+      "description": "The card's own six strings, merged over `PERMISSION_LABELS`.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [