@cueplusplus/ui 0.8.0 → 0.10.0

package/manifest/components/cue-logotype.json

@@ -12,21 +12,35 @@
       "type": "number | BrandSize",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the density control ladder to draw at, or an explicit height in px.\nDefaults to `\"md\"`.\n\nHeight, always — every asset here keeps its own aspect ratio, so the width\nfollows from the artwork rather than from the caller."
+      "description": "Rung of the density control ladder to draw at, or an explicit height in px.\nDefaults to `\"md\"`.\n\nHeight, always — every asset here keeps its own aspect ratio, so the width\nfollows from the artwork rather than from the caller.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "tone",
       "type": "\"inherit\" | \"fg\" | \"accent\"",
       "required": false,
       "defaultValue": "inherit",
-      "description": "Where the ink comes from: `currentColor`, the foreground token, or the\naccent. Defaults to `\"inherit\"`."
+      "description": "Where the ink comes from: `currentColor`, the foreground token, or the\naccent. Defaults to `\"inherit\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "inherit",
+          "fg",
+          "accent"
+        ]
+      }
     },
     {
       "name": "title",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The accessible name.\n\nOmit it and the asset is decorative — `aria-hidden`, announced by nothing.\nPass one only when the mark is the *only* thing naming what it sits on: a\nbare logo link, a splash screen with no heading."
+      "description": "The accessible name.\n\nOmit it and the asset is decorative — `aria-hidden`, announced by nothing.\nPass one only when the mark is the *only* thing naming what it sits on: a\nbare logo link, a splash screen with no heading.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/cue-mark.json

@@ -12,21 +12,35 @@
       "type": "number | BrandSize",
       "required": false,
       "defaultValue": "md",
-      "description": "Rung of the density control ladder to draw at, or an explicit height in px.\nDefaults to `\"md\"`.\n\nHeight, always — every asset here keeps its own aspect ratio, so the width\nfollows from the artwork rather than from the caller."
+      "description": "Rung of the density control ladder to draw at, or an explicit height in px.\nDefaults to `\"md\"`.\n\nHeight, always — every asset here keeps its own aspect ratio, so the width\nfollows from the artwork rather than from the caller.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "tone",
       "type": "\"inherit\" | \"fg\" | \"accent\"",
       "required": false,
       "defaultValue": "inherit",
-      "description": "Where the ink comes from: `currentColor`, the foreground token, or the\naccent. Defaults to `\"inherit\"`."
+      "description": "Where the ink comes from: `currentColor`, the foreground token, or the\naccent. Defaults to `\"inherit\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "inherit",
+          "fg",
+          "accent"
+        ]
+      }
     },
     {
       "name": "title",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The accessible name.\n\nOmit it and the asset is decorative — `aria-hidden`, announced by nothing.\nPass one only when the mark is the *only* thing naming what it sits on: a\nbare logo link, a splash screen with no heading."
+      "description": "The accessible name.\n\nOmit it and the asset is decorative — `aria-hidden`, announced by nothing.\nPass one only when the mark is the *only* thing naming what it sits on: a\nbare logo link, a splash screen with no heading.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/cue-portal-frame.json

@@ -5,28 +5,38 @@
   "importPath": "@cueplusplus/ui",
   "peerDependencies": [],
   "clientOnly": true,
-  "description": "Inline version of the portal contract, for portals whose container cannot be\nchosen (a third-party overlay, or content already portaled by something else).\n\nWraps `children` in a `display: contents` element carrying the same\n`data-theme` / `data-density` / `data-font` / `data-mode` / `data-cue-skin` /\n`data-cue-fidelity` stamp and `--cue-font-scale` as {@link useCuePortalProps}. Prefer the hook — a stamped container costs one\nelement per overlay instead of one per render tree — and reach for this only\nwhen the container prop is not available.",
+  "description": "Inline version of the portal contract, for portals whose container cannot be\nchosen (a third-party overlay, or content already portaled by something else).\n\nWraps `children` in a `display: contents` element carrying the same\n`data-theme` / `data-density` / `data-font` / `data-mode` / `data-cue-skin` /\n`data-cue-fidelity` stamp, `--cue-font-scale` and `overrides` properties as\n{@link useCuePortalProps}. Prefer the hook — a stamped container costs one\nelement per overlay instead of one per render tree — and reach for this only\nwhen the container prop is not available.",
   "props": [
     {
       "name": "children",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "Portal content to stamp."
+      "description": "Portal content to stamp.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the frame element."
+      "description": "Extra classes for the frame element.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "style",
       "type": "CSSProperties",
       "required": false,
       "defaultValue": null,
-      "description": "Inline styles, merged after `display: contents`."
+      "description": "Inline styles, merged after `display: contents`.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/data-row.json

@@ -28,35 +28,51 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "The row responds to a pointer and to the keyboard: hover wash, `cursor`,\nan inset focus ring and a tab stop. Defaults to `false`."
+          "description": "The row responds to a pointer and to the keyboard: hover wash, `cursor`,\nan inset focus ring and a tab stop. Defaults to `false`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "selected",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Draw the row as picked out of the list. Defaults to `false`.\n\nSets `data-selected`, which is also what the hover-revealed action track and\nthe accent tint key off — so a `<tr data-selected>` in the table idiom gets\nexactly the same treatment without going through this component."
+          "description": "Draw the row as picked out of the list. Defaults to `false`.\n\nSets `data-selected`, which is also what the hover-revealed action track and\nthe accent tint key off — so a `<tr data-selected>` in the table idiom gets\nexactly the same treatment without going through this component.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "disabled",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Grey the row out and stop it responding to anything. Defaults to `false`."
+          "description": "Grey the row out and stop it responding to anything. Defaults to `false`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "onActivate",
           "type": "(() => void)",
           "required": false,
           "defaultValue": null,
-          "description": "What \"open this row\" means — a drawer, a detail pane, a route."
+          "description": "What \"open this row\" means — a drawer, a detail pane, a route.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         },
         {
           "name": "disclosure",
           "type": "DataRowDisclosure",
           "required": false,
           "defaultValue": null,
-          "description": "Expose the row as a disclosure: `data-expanded` always, `aria-expanded`\nwhen the row has a `role` that can carry it, and `aria-controls` when the\ndisclosed element is on the page.\n\n**`aria-expanded` is gated on the role, because on a bare `<div>` it is\nworse than nothing.** A role-less div maps to `generic`, which supports\nonly the global attributes — so the state is dropped outright by Blink,\nWebKit and Gecko alike (verified through Chromium's own accessibility\ntree), announces nothing, and adds a critical `aria-allowed-attr` finding\nto any axe run over the console that used it. `role` passes straight\nthrough as a div prop, so a row that genuinely is a disclosure says which\nkind it is — `role=\"button\"` for a row that opens a drawer, `role=\"row\"`\ninside a grid — and gets the attribute with it. Everything else gets\n`data-expanded`, which styles and tests exactly as well and promises\nnothing to a screen reader.\n\nThe row is still not given a widget role on its own account: a\n`role=\"button\"` row could not legally hold the buttons and links these rows\nexist to contain, and that judgement belongs to the caller who knows what\ntheir row does. Where the disclosure has to be bulletproof for assistive\ntechnology, reach for `DataTree` (real `treeitem` expansion) or a\n`Table.GroupRow` with a real toggle button in it."
+          "description": "Expose the row as a disclosure: `data-expanded` always, `aria-expanded`\nwhen the row has a `role` that can carry it, and `aria-controls` when the\ndisclosed element is on the page.\n\n**`aria-expanded` is gated on the role, because on a bare `<div>` it is\nworse than nothing.** A role-less div maps to `generic`, which supports\nonly the global attributes — so the state is dropped outright by Blink,\nWebKit and Gecko alike (verified through Chromium's own accessibility\ntree), announces nothing, and adds a critical `aria-allowed-attr` finding\nto any axe run over the console that used it. `role` passes straight\nthrough as a div prop, so a row that genuinely is a disclosure says which\nkind it is — `role=\"button\"` for a row that opens a drawer, `role=\"row\"`\ninside a grid — and gets the attribute with it. Everything else gets\n`data-expanded`, which styles and tests exactly as well and promises\nnothing to a screen reader.\n\nThe row is still not given a widget role on its own account: a\n`role=\"button\"` row could not legally hold the buttons and links these rows\nexist to contain, and that judgement belongs to the caller who knows what\ntheir row does. Where the disclosure has to be bulletproof for assistive\ntechnology, reach for `DataTree` (real `treeitem` expansion) or a\n`Table.GroupRow` with a real toggle button in it.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [
@@ -123,8 +139,6 @@
   "tokensUsed": [
     "--cue-accent",
     "--cue-accent-soft",
-    "--cue-chip-h",
-    "--cue-control-sm",
     "--cue-data-row-cols",
     "--cue-data-tree-indent",
     "--cue-fg",

package/manifest/components/data-table-pagination.json

@@ -14,28 +14,42 @@
       "type": "DataTablePager",
       "required": true,
       "defaultValue": null,
-      "description": "The table instance from {@link useCueTable}, or anything with the same seven members."
+      "description": "The table instance from {@link useCueTable}, or anything with the same seven members.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<DataTablePaginationLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible names for the four buttons."
+      "description": "Accessible names for the four buttons.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "formatPosition",
       "type": "((page: number, pages: number) => string)",
       "required": false,
       "defaultValue": "(page, pages) => `${page} / ${pages}`",
-      "description": "Render the position readout. Defaults to `\"2 / 7\"`."
+      "description": "Render the position readout. Defaults to `\"2 / 7\"`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "formatRowCount",
       "type": "((rows: number) => string)",
       "required": false,
       "defaultValue": "(rows) => `${rows} row${rows === 1 ? \"\" : \"s\"}`",
-      "description": "Render the row count. Defaults to `\"340 rows\"`."
+      "description": "Render the row count. Defaults to `\"340 rows\"`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/data-table-toolbar.json

@@ -14,49 +14,72 @@
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The current query. Pair it with `onValueChange` and the table's global filter."
+      "description": "The current query. Pair it with `onValueChange` and the table's global filter.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Fired on every keystroke in the search box."
+      "description": "Fired on every keystroke in the search box.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": "Filter…",
-      "description": "Placeholder for the search box. Defaults to `\"Filter…\"`."
+      "description": "Placeholder for the search box. Defaults to `\"Filter…\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "searchLabel",
       "type": "string",
       "required": false,
       "defaultValue": "Filter rows",
-      "description": "Accessible name for the search box. Defaults to `\"Filter rows\"`."
+      "description": "Accessible name for the search box. Defaults to `\"Filter rows\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "count",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Rows currently matching. Shown as `count/total` when both are given."
+      "description": "Rows currently matching. Shown as `count/total` when both are given.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "total",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Rows before filtering."
+      "description": "Rows before filtering.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Trailing controls — a column picker, an export button."
+      "description": "Trailing controls — a column picker, an export button.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/data-tree.json

@@ -12,63 +12,96 @@
       "type": "readonly DataTreeItem[]",
       "required": true,
       "defaultValue": null,
-      "description": "The roots, in display order."
+      "description": "The roots, in display order.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "expanded",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Expanded ids when controlled. Pass with `onExpandedChange`."
+      "description": "Expanded ids when controlled. Pass with `onExpandedChange`.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "defaultExpanded",
       "type": "readonly string[]",
       "required": false,
       "defaultValue": null,
-      "description": "Initially expanded ids when uncontrolled."
+      "description": "Initially expanded ids when uncontrolled.",
+      "control": {
+        "kind": "array",
+        "fixture": "agent.transcript"
+      }
     },
     {
       "name": "onExpandedChange",
       "type": "((expanded: string[]) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the whole next expanded set whenever a row is folded or unfolded."
+      "description": "Called with the whole next expanded set whenever a row is folded or unfolded.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "selected",
       "type": "string | null",
       "required": false,
       "defaultValue": null,
-      "description": "Selected id when controlled. Pass with `onSelect`."
+      "description": "Selected id when controlled. Pass with `onSelect`.",
+      "control": {
+        "kind": "string",
+        "nullable": true
+      }
     },
     {
       "name": "defaultSelected",
       "type": "string | null",
       "required": false,
       "defaultValue": "null",
-      "description": "Initially selected id when uncontrolled."
+      "description": "Initially selected id when uncontrolled.",
+      "control": {
+        "kind": "string",
+        "nullable": true
+      }
     },
     {
       "name": "onSelect",
       "type": "((id: string) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the id of the row the user selected."
+      "description": "Called with the id of the row the user selected.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "guides",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Draw the depth guides. Defaults to `true`.\n\nRoots never draw one — there is no ancestor to draw — so a flat tree draws\nnone at all whatever this is set to."
+      "description": "Draw the depth guides. Defaults to `true`.\n\nRoots never draw one — there is no ancestor to draw — so a flat tree draws\nnone at all whatever this is set to.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the tree. Required in practice — name what it lists."
+      "description": "Accessible name for the tree. Required in practice — name what it lists.",
+      "control": {
+        "kind": "string"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/date-field.json

@@ -14,14 +14,25 @@
       "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": "inputClassName",
       "type": "ClassNameOrFunction<DateInputRenderProps>",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the segment group itself."
+      "description": "Extra classes for the segment group itself.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [