@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/export-dialog.json

@@ -12,35 +12,57 @@
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the dialog is showing."
+      "description": "Whether the dialog is showing.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "(open: boolean) => void",
       "required": true,
       "defaultValue": null,
-      "description": "Called when it should open or close."
+      "description": "Called when it should open or close.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "overrides",
       "type": "ThemeOverrides",
       "required": true,
       "defaultValue": null,
-      "description": "The overrides to export."
+      "description": "The overrides to export.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "scope",
       "type": "ThemeScope",
       "required": true,
       "defaultValue": null,
-      "description": "The theme and mode they were made in."
+      "description": "The theme and mode they were made in.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "defaultFormat",
       "type": "\"css\" | \"dtcg\" | \"create-theme\" | \"registry\"",
       "required": false,
       "defaultValue": "css",
-      "description": "Format shown first. Defaults to `\"css\"`."
+      "description": "Format shown first. Defaults to `\"css\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "css",
+          "dtcg",
+          "create-theme",
+          "registry"
+        ]
+      }
     }
   ],
   "typeReferences": [],
@@ -49,18 +71,12 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
-    "--cue-density",
     "--cue-fg",
     "--cue-fg-muted",
     "--cue-font-mono",
-    "--cue-font-pairing-mono",
     "--cue-font-sans",
-    "--cue-font-scale",
-    "--cue-font-theme-mono",
     "--cue-radius-control",
-    "--cue-radius-scale",
     "--cue-space-1",
     "--cue-space-3",
     "--cue-space-4",

package/manifest/components/eyebrow.json

@@ -12,7 +12,10 @@
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Print the `//` motif ahead of the label. Defaults to `true` — the slashes\nare the brand mark of this system, and an eyebrow without them is just\nsmall uppercase text. Pass `false` for a plain kicker."
+      "description": "Print the `//` motif ahead of the label. Defaults to `true` — the slashes\nare the brand mark of this system, and an eyebrow without them is just\nsmall uppercase text. Pass `false` for a plain kicker.",
+      "control": {
+        "kind": "boolean"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/feedback-dialog.json

@@ -14,49 +14,75 @@
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "The reason chips offered. Keep them short enough to scan in one line."
+      "description": "The reason chips offered. Keep them short enough to scan in one line.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "selected",
       "type": "readonly string[]",
       "required": true,
       "defaultValue": null,
-      "description": "Which reasons are currently picked. More than one is allowed."
+      "description": "Which reasons are currently picked. More than one is allowed.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "note",
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Free-text detail, always optional."
+      "description": "Free-text detail, always optional.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "sent",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Replaces the whole form with an acknowledgement once the report is filed."
+      "description": "Replaces the whole form with an acknowledgement once the report is filed.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onToggleReason",
       "type": "((reason: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when a reason chip is picked or unpicked."
+      "description": "Called when a reason chip is picked or unpicked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onNoteChange",
       "type": "((note: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called as the free-text note is typed."
+      "description": "Called as the free-text note is typed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onSubmit",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the report is sent."
+      "description": "Called when the report is sent.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/field-description.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the helper-text defaults."
+      "description": "Extra classes, merged over the helper-text defaults.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/field-error.json

@@ -12,21 +12,31 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the danger-text defaults."
+      "description": "Extra classes, merged over the danger-text defaults.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Message to show when driving visibility from `match` instead of `issues`."
+      "description": "Message to show when driving visibility from `match` instead of `issues`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "issues",
       "type": "readonly FieldIssue[]",
       "required": false,
       "defaultValue": null,
-      "description": "Standard Schema issues for this field. When supplied, the component shows\nexactly these messages and stops consulting native `ValidityState`: an\nempty array renders nothing, one issue renders inline, several render as a\nlist. Leave it `undefined` to fall back to `match` + `children`."
+      "description": "Standard Schema issues for this field. When supplied, the component shows\nexactly these messages and stops consulting native `ValidityState`: an\nempty array renders nothing, one issue renders inline, several render as a\nlist. Leave it `undefined` to fall back to `match` + `children`.",
+      "control": {
+        "kind": "array"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/field-label.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the label typography."
+      "description": "Extra classes, merged over the label typography.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/field.json

@@ -12,7 +12,10 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes, merged over the vertical stack defaults."
+      "description": "Extra classes, merged over the vertical stack defaults.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/file-tree.json

@@ -14,28 +14,40 @@
       "type": "readonly FileTreeNode[]",
       "required": true,
       "defaultValue": null,
-      "description": "Flat list in display order. Nesting comes from each node's depth, not from\nchildren arrays."
+      "description": "Flat list in display order. Nesting comes from each node's depth, not from\nchildren arrays.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many nodes have landed. Raise it as the run touches more files."
+      "description": "How many nodes have landed. Raise it as the run touches more files.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "totalAdditions",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Added lines across the whole change."
+      "description": "Added lines across the whole change.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "totalDeletions",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Removed lines across the whole change."
+      "description": "Removed lines across the whole change.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/file-upload.json

@@ -12,91 +12,136 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Drop files",
-      "description": "The zone's own copy, and its accessible name. Defaults to `\"Drop files\"`."
+      "description": "The zone's own copy, and its accessible name. Defaults to `\"Drop files\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "hint",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "A second line under the label — the rules, in plain words."
+      "description": "A second line under the label — the rules, in plain words.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "accept",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "`accept` string forwarded to the input and used for rejection."
+      "description": "`accept` string forwarded to the input and used for rejection.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "multiple",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Allow more than one file per drop."
+      "description": "Allow more than one file per drop.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "maxSize",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Largest accepted file, in bytes."
+      "description": "Largest accepted file, in bytes.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "maxFiles",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "How many files may be accepted per drop."
+      "description": "How many files may be accepted per drop.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Refuse drops and grey the zone out."
+      "description": "Refuse drops and grey the zone out.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "files",
       "type": "readonly UploadFile[]",
       "required": false,
       "defaultValue": null,
-      "description": "Rows to render under the zone. The caller owns upload state."
+      "description": "Rows to render under the zone. The caller owns upload state.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "onFilesAccepted",
       "type": "((files: File[]) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the files that passed the rules."
+      "description": "Called with the files that passed the rules.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onFilesRejected",
       "type": "((rejections: FileRejection[]) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the files that did not, each with its reason."
+      "description": "Called with the files that did not, each with its reason.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onRemove",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with a row's `id` when its remove control is pressed."
+      "description": "Called with a row's `id` when its remove control is pressed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "removeLabel",
       "type": "((file: UploadFile) => string)",
       "required": false,
       "defaultValue": "(file) => `Remove ${file.name}`",
-      "description": "Spoken name of a row's remove control. Defaults to `Remove <name>`."
+      "description": "Spoken name of a row's remove control. Defaults to `Remove <name>`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "zoneClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the drop zone."
+      "description": "Extra classes for the drop zone.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/flow-graph.json

@@ -12,21 +12,30 @@
       "type": "readonly FlowNode[]",
       "required": true,
       "defaultValue": null,
-      "description": "Every node with its grid position. Layout is explicit; the element runs no solver."
+      "description": "Every node with its grid position. Layout is explicit; the element runs no solver.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "edges",
       "type": "readonly FlowEdge[]",
       "required": true,
       "defaultValue": null,
-      "description": "Connections by node id. An edge dims until both of its ends are visible."
+      "description": "Connections by node id. An edge dims until both of its ends are visible.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleCount",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many nodes have been reached so far."
+      "description": "How many nodes have been reached so far.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/folder-icon.json

@@ -14,13 +14,7 @@
   "parts": [],
   "variants": {},
   "defaultVariants": {},
-  "tokensUsed": [
-    "--cue-danger",
-    "--cue-fg",
-    "--cue-icon-",
-    "--cue-icon-md",
-    "--cue-icon-sm"
-  ],
+  "tokensUsed": [],
   "summary": "A folder somebody made: a shelf of bookmarks, filed by hand.",
   "examples": [],
   "status": "todo-docs",

package/manifest/components/footer.json

@@ -12,28 +12,48 @@
       "type": "\"narrow\" | \"wide\" | \"broad\" | \"full\"",
       "required": false,
       "defaultValue": "broad",
-      "description": "Which measure the footer's column takes. Defaults to `\"broad\"`.\n\nThe same four rungs `Container` and `PageShell` offer, so a footer lines up\nwith the page above it by naming the same width — `broad` rather than\n`narrow` by default because a footer is usually the widest thing on a page,\nand a row of columns inside a 42rem reading measure is four squeezed lists."
+      "description": "Which measure the footer's column takes. Defaults to `\"broad\"`.\n\nThe same four rungs `Container` and `PageShell` offer, so a footer lines up\nwith the page above it by naming the same width — `broad` rather than\n`narrow` by default because a footer is usually the widest thing on a page,\nand a row of columns inside a 42rem reading measure is four squeezed lists.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "narrow",
+          "wide",
+          "broad",
+          "full"
+        ]
+      }
     },
     {
       "name": "meta",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The fine print, under a hairline of its own: copyright, a licence, a build\nnumber.\n\nA slot rather than a component, because that row is a sentence and a couple\nof links — but it is a *separated* sentence, and hand-rolling the rule and\nthe space above it in every app is exactly the kind of repetition this\ncomponent exists to end."
+      "description": "The fine print, under a hairline of its own: copyright, a licence, a build\nnumber.\n\nA slot rather than a component, because that row is a sentence and a couple\nof links — but it is a *separated* sentence, and hand-rolling the rule and\nthe space above it in every app is exactly the kind of repetition this\ncomponent exists to end.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "columnClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the centred column inside the landmark."
+      "description": "Extra classes for the centred column inside the landmark.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The footer's body — normally a `Grid` of `Stack`s of `Link`s."
+      "description": "The footer's body — normally a `Grid` of `Stack`s of `Link`s.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/frac.json

@@ -12,14 +12,22 @@
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "Numerator."
+      "description": "Numerator.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "under",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "Denominator."
+      "description": "Denominator.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/generation-loader.json

@@ -12,21 +12,35 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Status copy shown under the pixel grid while the model has nothing else to show."
+      "description": "Status copy shown under the pixel grid while the model has nothing else to show.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "tick",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Animation clock that advances the pixel pattern and the elapsed seconds counter."
+      "description": "Animation clock that advances the pixel pattern and the elapsed seconds counter.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "variant",
       "type": "\"dots\" | \"squares\" | \"rounded\"",
       "required": false,
       "defaultValue": "dots",
-      "description": "Cell shape of the pixel matrix."
+      "description": "Cell shape of the pixel matrix.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "dots",
+          "squares",
+          "rounded"
+        ]
+      }
     }
   ],
   "typeReferences": [