@cueplusplus/ui 0.9.0 → 0.10.0

package/manifest/components/node-card.json

@@ -12,49 +12,84 @@
       "type": "\"input\" | \"output\" | \"processing\"",
       "required": false,
       "defaultValue": null,
-      "description": "Where the node sits in the signal path. Inks the frame at rest."
+      "description": "Where the node sits in the signal path. Inks the frame at rest.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "input",
+          "output",
+          "processing"
+        ]
+      }
     },
     {
       "name": "state",
       "type": "\"disabled\" | \"idle\" | \"selected\" | \"live\"",
       "required": false,
       "defaultValue": null,
-      "description": "What the node is doing right now. Outranks `tone`.\n\nPass React Flow's own `selected` through:\n`state={selected ? \"selected\" : \"idle\"}`."
+      "description": "What the node is doing right now. Outranks `tone`.\n\nPass React Flow's own `selected` through:\n`state={selected ? \"selected\" : \"idle\"}`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "disabled",
+          "idle",
+          "selected",
+          "live"
+        ]
+      }
     },
     {
       "name": "header",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The summary band: a label, a toggle, a badge. Also the drag handle."
+      "description": "The summary band: a label, a toggle, a badge. Also the drag handle.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "expanded",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Whether the body is shown. Defaults to `true`; `false` renders the band alone."
+      "description": "Whether the body is shown. Defaults to `true`; `false` renders the band alone.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onExpandedChange",
       "type": "((expanded: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the requested state when the caret is clicked. Supplying it is\nwhat makes the caret appear — a card nobody can collapse should not offer to."
+      "description": "Called with the requested state when the caret is clicked. Supplying it is\nwhat makes the caret appear — a card nobody can collapse should not offer to.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "toggleLabel",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the caret. Defaults to `\"Collapse\"` / `\"Expand\"`."
+      "description": "Accessible name for the caret. Defaults to `\"Collapse\"` / `\"Expand\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The body: rows, bars, fields. Full-bleed — rows own their own padding."
+      "description": "The body: rows, bars, fields. Full-bleed — rows own their own padding.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/node-handle.json

@@ -14,14 +14,29 @@
       "type": "\"danger\" | \"accent\" | \"busy\" | \"muted\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "accent",
-      "description": "What the connection carries. Defaults to `\"accent\"`."
+      "description": "What the connection carries. Defaults to `\"accent\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "accent",
+          "busy",
+          "muted",
+          "ok",
+          "warn",
+          "info"
+        ]
+      }
     },
     {
       "name": "size",
       "type": "number",
       "required": false,
       "defaultValue": "9",
-      "description": "Diameter in px at the 16px root, emitted as `rem`. Defaults to `9`."
+      "description": "Diameter in px at the 16px root, emitted as `rem`. Defaults to `9`.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/number-field.json

@@ -12,42 +12,64 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the group chassis."
+      "description": "Extra classes, merged over the group chassis.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the text control, when no {@link FieldLabel } names it."
+      "description": "Accessible name for the text control, when no {@link FieldLabel } names it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "size",
       "type": "\"sm\" | \"md\"",
       "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"
+        ]
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Placeholder shown while the field is empty."
+      "description": "Placeholder shown while the field is empty.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "decrementLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Decrease",
-      "description": "Accessible name for the decrement button. Defaults to `\"Decrease\"`."
+      "description": "Accessible name for the decrement button. Defaults to `\"Decrease\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "incrementLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Increase",
-      "description": "Accessible name for the increment button. Defaults to `\"Increase\"`."
+      "description": "Accessible name for the increment button. Defaults to `\"Increase\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/number-ticker.json

@@ -12,14 +12,20 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Numeric value whose digits roll into place as it changes."
+      "description": "Numeric value whose digits roll into place as it changes.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Mono caption rendered under the rolling number."
+      "description": "Mono caption rendered under the rolling number.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

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