@cueplusplus/ui 0.9.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

@@ -12,21 +12,31 @@
       "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": [

package/manifest/components/date-picker.json

@@ -15,126 +15,189 @@
       "type": "Date | null",
       "required": false,
       "defaultValue": null,
-      "description": "The chosen day. Use with `onValueChange` for a controlled field."
+      "description": "The chosen day. Use with `onValueChange` for a controlled field.",
+      "control": {
+        "kind": "opaque",
+        "nullable": true
+      }
     },
     {
       "name": "defaultValue",
       "type": "Date | null",
       "required": false,
       "defaultValue": null,
-      "description": "Initially chosen day for an uncontrolled field."
+      "description": "Initially chosen day for an uncontrolled field.",
+      "control": {
+        "kind": "opaque",
+        "nullable": true
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: Date) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the new day, or `undefined` when the day is unpicked."
+      "description": "Called with the new day, or `undefined` when the day is unpicked.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": "Pick a date",
-      "description": "Read out while nothing is chosen. Defaults to `\"Pick a date\"`."
+      "description": "Read out while nothing is chosen. Defaults to `\"Pick a date\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "dateFormat",
       "type": "string",
       "required": false,
       "defaultValue": "d MMM yyyy",
-      "description": "date-fns pattern for the readout. Defaults to `\"d MMM yyyy\"`."
+      "description": "date-fns pattern for the readout. Defaults to `\"d MMM yyyy\"`.",
+      "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": "disabled",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Prevent opening and grey the trigger out."
+      "description": "Prevent opening and grey the trigger out.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "invalid",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Paint the danger rim — pair it with a `FieldError`."
+      "description": "Paint the danger rim — pair it with a `FieldError`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "name",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Name for the hidden input, when the field is part of a form. The submitted\nvalue is the ISO date (`yyyy-MM-dd`), never the formatted readout."
+      "description": "Name for the hidden input, when the field is part of a form. The submitted\nvalue is the ISO date (`yyyy-MM-dd`), never the formatted readout.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "id",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id forwarded to the trigger."
+      "description": "Id forwarded to the trigger.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Accessible name for the trigger, when no `FieldLabel` names it."
+      "description": "Accessible name for the trigger, when no `FieldLabel` names it.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "aria-labelledby",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Id of the element naming the trigger."
+      "description": "Id of the element naming the trigger.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the trigger."
+      "description": "Extra classes for the trigger.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "popupClassName",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the popup surface."
+      "description": "Extra classes for the popup surface.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "calendarProps",
       "type": "DatePickerCalendarProps",
       "required": false,
       "defaultValue": null,
-      "description": "Everything else the calendar takes — month bounds, disabled days, locale."
+      "description": "Everything else the calendar takes — month bounds, disabled days, locale.",
+      "control": {
+        "kind": "opaque"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Open state, for a controlled popover."
+      "description": "Open state, for a controlled popover.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "defaultOpen",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Initial open state."
+      "description": "Initial open state.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the popover opens or closes."
+      "description": "Called when the popover opens or closes.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [],
@@ -143,7 +206,6 @@
   "variants": {},
   "defaultVariants": {},
   "tokensUsed": [
-    "--cue-accent",
     "--cue-border",
     "--cue-border-strong",
     "--cue-control-lg",