@cueplusplus/ui 0.8.0 → 0.10.0

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",

package/manifest/components/date-range-picker.json

@@ -15,126 +15,189 @@
       "type": "DateRange | null",
       "required": false,
       "defaultValue": null,
-      "description": "The chosen span. Use with `onValueChange` for a controlled field."
+      "description": "The chosen span. Use with `onValueChange` for a controlled field.",
+      "control": {
+        "kind": "opaque",
+        "nullable": true
+      }
     },
     {
       "name": "defaultValue",
       "type": "DateRange | null",
       "required": false,
       "defaultValue": null,
-      "description": "Initially chosen span for an uncontrolled field."
+      "description": "Initially chosen span for an uncontrolled field.",
+      "control": {
+        "kind": "opaque",
+        "nullable": true
+      }
     },
     {
       "name": "onValueChange",
       "type": "((value: DateRange) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called after every click inside the calendar — once with `{ from }` when\nthe span opens, again with `{ from, to }` when it closes."
+      "description": "Called after every click inside the calendar — once with `{ from }` when\nthe span opens, again with `{ from, to }` when it closes.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "placeholder",
       "type": "string",
       "required": false,
       "defaultValue": "Pick a range",
-      "description": "Read out while nothing is chosen. Defaults to `\"Pick a range\"`."
+      "description": "Read out while nothing is chosen. Defaults to `\"Pick a range\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "dateFormat",
       "type": "string",
       "required": false,
       "defaultValue": "d MMM yyyy",
-      "description": "date-fns pattern for both ends of the readout. Defaults to `\"d MMM yyyy\"`."
+      "description": "date-fns pattern for both ends of 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": "Base name for the hidden inputs; they submit `<name>From` / `<name>To`."
+      "description": "Base name for the hidden inputs; they submit `<name>From` / `<name>To`.",
+      "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": "DateRangePickerCalendarProps",
       "required": false,
       "defaultValue": null,
-      "description": "Everything else the calendar takes. `numberOfMonths` defaults to `2`."
+      "description": "Everything else the calendar takes. `numberOfMonths` defaults to `2`.",
+      "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",

package/manifest/components/day-separator.json

@@ -12,7 +12,10 @@
       "type": "readonly DatedMessage[]",
       "required": true,
       "defaultValue": null,
-      "description": "Turns in order. A separator is inserted wherever day changes from the previous\nmessage, so grouping needs no pre-processing."
+      "description": "Turns in order. A separator is inserted wherever day changes from the previous\nmessage, so grouping needs no pre-processing.",
+      "control": {
+        "kind": "array"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/delegation-card.json

@@ -12,84 +12,136 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Slug of the agent on the other end of the delegation."
+      "description": "Slug of the agent on the other end of the delegation.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "rootAgent",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Slug of the orchestrator, so its lane takes the theme accent."
+      "description": "Slug of the orchestrator, so its lane takes the theme accent.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "direction",
       "type": "\"outbound\" | \"inbound\"",
       "required": false,
       "defaultValue": "outbound",
-      "description": "`outbound` (we asked them) or `inbound` (they asked us). Defaults to `\"outbound\"`."
+      "description": "`outbound` (we asked them) or `inbound` (they asked us). Defaults to `\"outbound\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "outbound",
+          "inbound"
+        ]
+      }
     },
     {
       "name": "task",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "What the delegate was asked to do — one line, already summarised."
+      "description": "What the delegate was asked to do — one line, already summarised.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "status",
       "type": "\"done\" | \"working\" | \"failed\" | \"idle\"",
       "required": false,
       "defaultValue": null,
-      "description": "Where the work has got to. Omit to draw no status line at all."
+      "description": "Where the work has got to. Omit to draw no status line at all.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "done",
+          "working",
+          "failed",
+          "idle"
+        ]
+      }
     },
     {
       "name": "activity",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "What the delegate is doing right now. Shown beside the spinner while `working`."
+      "description": "What the delegate is doing right now. Shown beside the spinner while `working`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Open state when controlled. Pass with `onOpenChange`."
+      "description": "Open state when controlled. Pass with `onOpenChange`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "defaultOpen",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Initial open state. Defaults to open for an inbound card, shut for an outbound one."
+      "description": "Initial open state. Defaults to open for an inbound card, shut for an outbound one.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called with the state the card is asking to move to."
+      "description": "Called with the state the card is asking to move to.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "doneLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Completed",
-      "description": "What a finished delegation says. Defaults to `\"Completed\"`."
+      "description": "What a finished delegation says. Defaults to `\"Completed\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "failedLabel",
       "type": "ReactNode",
       "required": false,
       "defaultValue": "Failed",
-      "description": "What a failed delegation says. Defaults to `\"Failed\"`."
+      "description": "What a failed delegation says. Defaults to `\"Failed\"`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The nested transcript."
+      "description": "The nested transcript.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/density.json

@@ -5,35 +5,55 @@
   "importPath": "@cueplusplus/ui",
   "peerDependencies": [],
   "clientOnly": true,
-  "description": "Re-scope any subtree to a different density level.\n\nRenders a plain `<div data-density=\"…\">`: the geometry custom properties are\nre-declared by the attribute selector and inherit down, so nesting is free and\nneeds no JS. The matching React context is published alongside for the rare\nJS reads (`useDensity()`, `useControlHeight()`, portal stamping) — the DOM\nattribute, not the context, is what actually restyles the tree.\n\nTheme and mode are deliberately *not* re-scoped here: density is the only axis\nan island may override (spec §6).",
+  "description": "Re-scope any subtree to a different density level.\n\nRenders a plain `<div data-density=\"…\" data-cue-theme=\"…\">`: the geometry\ncustom properties are re-declared by the attribute selector and inherit\ndown, so nesting is free and needs no JS. The matching React context is\npublished alongside for the rare JS reads (`useDensity()`,\n`useControlHeight()`, portal stamping) — the DOM attributes, not the\ncontext, are what actually restyle the tree.\n\n`data-cue-theme` carries the nearest `<ThemeProvider>`'s name, or is\nomitted where there is none. It is read by nothing this island does —\ntheme and mode are deliberately *not* re-scoped here, density is the only\naxis an island may override (spec §6) — it exists so a theme's own\ngenerated CSS can address exactly this island regardless of how many\n*other* themed providers sit between it and the one it belongs to. A CSS\nancestor selector can only ask \"does some ancestor carry theme `x`\", never\n\"is `x` the *nearest* one\"; this stamp answers that question the way\n`useContext` already does, at render time, and hands the answer to CSS as\nan attribute rather than leaving it unanswerable there.",
   "props": [
     {
       "name": "density",
       "type": "\"normal\" | \"large\" | \"compact\" | \"ultra-compact\" | \"ultra-large\"",
       "required": true,
       "defaultValue": null,
-      "description": "Level to apply to this subtree: `ultra-compact`, `compact`, `normal`,\n`large` or `ultra-large`."
+      "description": "Level to apply to this subtree: `ultra-compact`, `compact`, `normal`,\n`large` or `ultra-large`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "normal",
+          "large",
+          "compact",
+          "ultra-compact",
+          "ultra-large"
+        ]
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "Subtree that should render at `density`."
+      "description": "Subtree that should render at `density`.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "className",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "Extra classes for the island element. It is an ordinary `<div>` — style it like one."
+      "description": "Extra classes for the island element. It is an ordinary `<div>` — style it like one.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "style",
       "type": "CSSProperties",
       "required": false,
       "defaultValue": null,
-      "description": "Inline styles for the island element."
+      "description": "Inline styles for the island element.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [],

package/manifest/components/description-list.json

@@ -24,7 +24,14 @@
           "type": "\"inline\" | \"stacked\"",
           "required": false,
           "defaultValue": "inline",
-          "description": "`\"inline\"` (default) puts the detail beside its term in a two-column grid;\n`\"stacked\"` puts it underneath. Stack when the details are long enough to\nwrap, which turns the aligned column into ragged text anyway."
+          "description": "`\"inline\"` (default) puts the detail beside its term in a two-column grid;\n`\"stacked\"` puts it underneath. Stack when the details are long enough to\nwrap, which turns the aligned column into ragged text anyway.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "inline",
+              "stacked"
+            ]
+          }
         }
       ],
       "typeReferences": [