@cueplusplus/ui 0.9.0 → 0.10.0

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

package/manifest/components/generative-ui.json

@@ -12,49 +12,81 @@
       "type": "unknown",
       "required": true,
       "defaultValue": null,
-      "description": "The tree to draw, exactly as it arrived.\n\nTyped `unknown` rather than `GenerativeNode` on purpose. A caller who has\njust parsed a tool result holds a `JSON.parse` return, and a signature that\ndemanded a node would push every consumer into the same cast — which is a\nclaim about the bytes that nobody is in a position to make. The renderer\nreads what it was given and reports what it could not use."
+      "description": "The tree to draw, exactly as it arrived.\n\nTyped `unknown` rather than `GenerativeNode` on purpose. A caller who has\njust parsed a tool result holds a `JSON.parse` return, and a signature that\ndemanded a node would push every consumer into the same cast — which is a\nclaim about the bytes that nobody is in a position to make. The renderer\nreads what it was given and reports what it could not use.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "onAction",
       "type": "((action: GenerativeAction) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Where a control's press goes: a button, a form submit, a list row, a\ncheckbox, a card's confirm.\n\nCalled with the `$action` string the model put on the node, the intrinsic\nthat fired it, and — where the control has one — its own value. Omit it and\nevery control is inert, which is the right default for a transcript that is\nbeing re-read rather than used."
+      "description": "Where a control's press goes: a button, a form submit, a list row, a\ncheckbox, a card's confirm.\n\nCalled with the `$action` string the model put on the node, the intrinsic\nthat fired it, and — where the control has one — its own value. Omit it and\nevery control is inert, which is the right default for a transcript that is\nbeing re-read rather than used.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onFault",
       "type": "((fault: GenerativeFault) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Told about every node the renderer refused to guess at, after the render\nthat refused it.\n\nThe counterpart of never throwing. A fallback is legible on screen, but the\nperson who needs to know that this console is a version behind the model\ndriving it is usually not the person looking at it — so the faults are also\na stream, one call per refusal, suitable for a counter or a log line."
+      "description": "Told about every node the renderer refused to guess at, after the render\nthat refused it.\n\nThe counterpart of never throwing. A fallback is legible on screen, but the\nperson who needs to know that this console is a version behind the model\ndriving it is usually not the person looking at it — so the faults are also\na stream, one call per refusal, suitable for a counter or a log line.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "renderMarkdown",
       "type": "((value: string) => ReactNode)",
       "required": false,
       "defaultValue": null,
-      "description": "Turns a `Markdown` node's source into elements.\n\nWithout it the source renders verbatim, as characters, because this subpath\nships no parser and will not acquire one: `@cueplusplus/ui/elements/markdown`\nis the sanitized renderer this prop is shaped for, and it carries two peers\nthat a console drawing a weather card should not have to install.\n\n```tsx\nimport { MarkdownText } from \"@cueplusplus/ui/elements/markdown\";\n\n<GenerativeUI spec={spec} renderMarkdown={(md) => <MarkdownText>{md}</MarkdownText>} />\n```"
+      "description": "Turns a `Markdown` node's source into elements.\n\nWithout it the source renders verbatim, as characters, because this subpath\nships no parser and will not acquire one: `@cueplusplus/ui/elements/markdown`\nis the sanitized renderer this prop is shaped for, and it carries two peers\nthat a console drawing a weather card should not have to install.\n\n```tsx\nimport { MarkdownText } from \"@cueplusplus/ui/elements/markdown\";\n\n<GenerativeUI spec={spec} renderMarkdown={(md) => <MarkdownText>{md}</MarkdownText>} />\n```",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "maxDepth",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "How many levels to walk before drawing the depth notice. Defaults to\n{@link GENERATIVE_MAX_DEPTH}; anything below one level is read as one,\nsince a tree with no levels is not a tree."
+      "description": "How many levels to walk before drawing the depth notice. Defaults to\n{@link GENERATIVE_MAX_DEPTH}; anything below one level is read as one,\nsince a tree with no levels is not a tree.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "skin",
       "type": "\"cue\" | \"aui\"",
       "required": false,
       "defaultValue": null,
-      "description": "Which value-set paints this tree: `cue` (the default) or `aui`, which\ninstalls assistant-ui's own surface language. Leave it off inside an\n{@link AgentSurface }, which has stamped the subtree already."
+      "description": "Which value-set paints this tree: `cue` (the default) or `aui`, which\ninstalls assistant-ui's own surface language. Leave it off inside an\n{@link AgentSurface }, which has stamped the subtree already.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "cue",
+          "aui"
+        ]
+      }
     },
     {
       "name": "fidelity",
       "type": "\"upstream\" | \"cue-metrics\"",
       "required": false,
       "defaultValue": null,
-      "description": "Whether the density knobs follow cue's ladder (`cue-metrics`, the default)\nor pin assistant-ui's own numbers (`upstream`)."
+      "description": "Whether the density knobs follow cue's ladder (`cue-metrics`, the default)\nor pin assistant-ui's own numbers (`upstream`).",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "upstream",
+          "cue-metrics"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/grid.json

@@ -12,35 +12,86 @@
       "type": "4 | 1 | 2 | 3 | 5 | 6",
       "required": false,
       "defaultValue": "1",
-      "description": "How many equal columns. Defaults to `1`. Ignored when `minItemWidth` is set."
+      "description": "How many equal columns. Defaults to `1`. Ignored when `minItemWidth` is set.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          4,
+          1,
+          2,
+          3,
+          5,
+          6
+        ],
+        "min": 1,
+        "max": 6
+      }
     },
     {
       "name": "gap",
       "type": "0 | 4 | 8 | 1 | 2 | 3 | 5 | 6 | 7",
       "required": false,
       "defaultValue": "4",
-      "description": "Which rung of the density space ladder to spend between cells. Defaults to `4`."
+      "description": "Which rung of the density space ladder to spend between cells. Defaults to `4`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          0,
+          4,
+          8,
+          1,
+          2,
+          3,
+          5,
+          6,
+          7
+        ],
+        "min": 0,
+        "max": 8
+      }
     },
     {
       "name": "minItemWidth",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Fill the row with as many columns of at least this width as fit, instead of\na fixed count. Any CSS length (`\"12rem\"`, `\"200px\"`).\n\nPrefer this over a column count wherever the content has a natural minimum\nmeasure — it is responsive without a single breakpoint."
+      "description": "Fill the row with as many columns of at least this width as fit, instead of\na fixed count. Any CSS length (`\"12rem\"`, `\"200px\"`).\n\nPrefer this over a column count wherever the content has a natural minimum\nmeasure — it is responsive without a single breakpoint.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "align",
       "type": "\"center\" | \"end\" | \"baseline\" | \"start\" | \"stretch\"",
       "required": false,
       "defaultValue": null,
-      "description": "Cross-axis alignment of the cells."
+      "description": "Cross-axis alignment of the cells.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "center",
+          "end",
+          "baseline",
+          "start",
+          "stretch"
+        ]
+      }
     },
     {
       "name": "justify",
       "type": "\"center\" | \"end\" | \"start\" | \"between\"",
       "required": false,
       "defaultValue": null,
-      "description": "Main-axis distribution of the tracks."
+      "description": "Main-axis distribution of the tracks.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "center",
+          "end",
+          "start",
+          "between"
+        ]
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/group-bar.json

@@ -12,42 +12,61 @@
       "type": "readonly GroupBarItem[]",
       "required": true,
       "defaultValue": null,
-      "description": "The slices, in display order."
+      "description": "The slices, in display order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "6",
-      "description": "Strip height in px at the 16px root, emitted as `rem`. Defaults to `6`."
+      "description": "Strip height in px at the 16px root, emitted as `rem`. Defaults to `6`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What the distribution is *of*. Required in practice — it names the graphic."
+      "description": "What the distribution is *of*. Required in practice — it names the graphic.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "legend",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "List the slices with their shares underneath the strip."
+      "description": "List the slices with their shares underneath the strip.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "formatShare",
       "type": "((share: number, item: GroupBarItem) => string)",
       "required": false,
       "defaultValue": "(share) => `${share}%`",
-      "description": "Format one share for the summary and the legend. Defaults to `\"42%\"`."
+      "description": "Format one share for the summary and the legend. Defaults to `\"42%\"`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "emptyLabel",
       "type": "string",
       "required": false,
       "defaultValue": "no data",
-      "description": "What to say when every slice is empty. Defaults to `\"no data\"`."
+      "description": "What to say when every slice is empty. Defaults to `\"no data\"`.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [