@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/app-bar.json

@@ -27,7 +27,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Keep the bar at the top of the viewport as the page scrolls. Defaults to\n`true`.\n\nSet it `false` inside `AppShell`, where nothing scrolls the document and a\nsticky bar would be solving a problem the shell has already solved."
+          "description": "Keep the bar at the top of the viewport as the page scrolls. Defaults to\n`true`.\n\nSet it `false` inside `AppShell`, where nothing scrolls the document and a\nsticky bar would be solving a problem the shell has already solved.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -44,7 +47,10 @@
           "type": "RenderProp<Record<string, unknown>>",
           "required": false,
           "defaultValue": null,
-          "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<NextLink href=\"/x\" />}` — or a function returning one. This is\nhow the design system composes with a router without depending on one."
+          "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<NextLink href=\"/x\" />}` — or a function returning one. This is\nhow the design system composes with a router without depending on one.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [
@@ -61,42 +67,70 @@
           "type": "\"center\" | \"end\" | \"start\"",
           "required": false,
           "defaultValue": "end",
-          "description": "Where the links sit when they are narrower than the space. Defaults to `\"end\"`."
+          "description": "Where the links sit when they are narrower than the space. Defaults to `\"end\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "center",
+              "end",
+              "start"
+            ]
+          }
         },
         {
           "name": "overflow",
           "type": "\"clip\" | \"scroll\"",
           "required": false,
           "defaultValue": "scroll",
-          "description": "What the navigation does when the links do not fit. Defaults to `\"scroll\"`.\n\nThe same behaviour `Toolbar` and `SegmentedControl` have, from the same\nmodule: the links scroll inside the bar, the overflowing edge is faded and\na pager chevron appears there. This is what lets the bar survive a phone\nwithout a viewport breakpoint."
+          "description": "What the navigation does when the links do not fit. Defaults to `\"scroll\"`.\n\nThe same behaviour `Toolbar` and `SegmentedControl` have, from the same\nmodule: the links scroll inside the bar, the overflowing edge is faded and\na pager chevron appears there. This is what lets the bar survive a phone\nwithout a viewport breakpoint.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "clip",
+              "scroll"
+            ]
+          }
         },
         {
           "name": "previousLabel",
           "type": "string",
           "required": false,
           "defaultValue": "Show earlier links",
-          "description": "Accessible name for the chevron that reveals links off the leading edge."
+          "description": "Accessible name for the chevron that reveals links off the leading edge.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "nextLabel",
           "type": "string",
           "required": false,
           "defaultValue": "Show later links",
-          "description": "Accessible name for the chevron that reveals links off the trailing edge."
+          "description": "Accessible name for the chevron that reveals links off the trailing edge.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "frameClassName",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the frame around the `<nav>`, which is what takes the remaining width."
+          "description": "Extra classes for the frame around the `<nav>`, which is what takes the remaining width.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "children",
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "The links, and any separators between clusters of them."
+          "description": "The links, and any separators between clusters of them.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         }
       ],
       "typeReferences": [
@@ -113,28 +147,44 @@
           "type": "\"strong\" | \"muted\"",
           "required": false,
           "defaultValue": "muted",
-          "description": "Which register the link is set in. Defaults to `\"muted\"`."
+          "description": "Which register the link is set in. Defaults to `\"muted\"`.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "strong",
+              "muted"
+            ]
+          }
         },
         {
           "name": "active",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "This is the page the reader is on.\n\nInks the link with the accent and sets `aria-current=\"page\"` — the same\nbargain `Sidebar.Item` makes, so the current destination is announced and\nnot merely coloured. Overrides `register`: a current page is never\nfurniture."
+          "description": "This is the page the reader is on.\n\nInks the link with the accent and sets `aria-current=\"page\"` — the same\nbargain `Sidebar.Item` makes, so the current destination is announced and\nnot merely coloured. Overrides `register`: a current page is never\nfurniture.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "external",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Open in a new tab, mark the anchor `rel=\"noreferrer noopener\"` and append a\n`↗`. The glyph is not decoration: a link that replaces the user's context\nwithout warning is a WCAG 3.2.5 failure, and the arrow is the warning."
+          "description": "Open in a new tab, mark the anchor `rel=\"noreferrer noopener\"` and append a\n`↗`. The glyph is not decoration: a link that replaces the user's context\nwithout warning is a WCAG 3.2.5 failure, and the arrow is the warning.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "render",
           "type": "RenderProp<Record<string, unknown>>",
           "required": false,
           "defaultValue": null,
-          "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<NextLink href=\"/x\" />}` — or a function returning one. This is\nhow the design system composes with a router without depending on one."
+          "description": "Replace the rendered element (Base UI render prop). Accepts an element —\n`render={<NextLink href=\"/x\" />}` — or a function returning one. This is\nhow the design system composes with a router without depending on one.",
+          "control": {
+            "kind": "opaque"
+          }
         }
       ],
       "typeReferences": [
@@ -151,7 +201,10 @@
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes, merged over the hairline defaults."
+          "description": "Extra classes, merged over the hairline defaults.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [

package/manifest/components/app-shell.json

@@ -29,56 +29,82 @@
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Whether the mobile navigation drawer is open, when controlled. Pass with `onNavOpenChange`."
+          "description": "Whether the mobile navigation drawer is open, when controlled. Pass with `onNavOpenChange`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "defaultNavOpen",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Initial open state of the mobile navigation drawer when uncontrolled. Defaults to `false`."
+          "description": "Initial open state of the mobile navigation drawer when uncontrolled. Defaults to `false`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "onNavOpenChange",
           "type": "((open: boolean) => void)",
           "required": false,
           "defaultValue": null,
-          "description": "Called with the next open state whenever the drawer is opened or dismissed."
+          "description": "Called with the next open state whenever the drawer is opened or dismissed.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         },
         {
           "name": "rail",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Whether the navigation column is collapsed to an icon rail, when\ncontrolled. Pass with `onRailChange`. Defaults to expanded.\n\nIt is the column's own collapse, owned one level up. Collapsing is a\nproperty of the column, but the header cell over it is a child of the bar\n— a different branch of the tree — and a length only one of them knows is\na length they will eventually disagree about. So the frame holds the\nstate, stamps `data-rail` on itself for anything that has to answer to it,\nand hands it down to `Sidebar.Root` as its controlled `collapsed`.\n\n**Persistence is the caller's.** A rail is set once and expected to be\nremembered, and where it is remembered — `localStorage`, a cookie the\nserver can read before first paint, a user record — is a decision about\nhydration and privacy that a layout component has no business making."
+          "description": "Whether the navigation column is collapsed to an icon rail, when\ncontrolled. Pass with `onRailChange`. Defaults to expanded.\n\nIt is the column's own collapse, owned one level up. Collapsing is a\nproperty of the column, but the header cell over it is a child of the bar\n— a different branch of the tree — and a length only one of them knows is\na length they will eventually disagree about. So the frame holds the\nstate, stamps `data-rail` on itself for anything that has to answer to it,\nand hands it down to `Sidebar.Root` as its controlled `collapsed`.\n\n**Persistence is the caller's.** A rail is set once and expected to be\nremembered, and where it is remembered — `localStorage`, a cookie the\nserver can read before first paint, a user record — is a decision about\nhydration and privacy that a layout component has no business making.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "defaultRail",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Initial rail state when uncontrolled. Defaults to `false`."
+          "description": "Initial rail state when uncontrolled. Defaults to `false`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "onRailChange",
           "type": "((rail: boolean) => void)",
           "required": false,
           "defaultValue": null,
-          "description": "Called with the next rail state whenever the column is collapsed or expanded."
+          "description": "Called with the next rail state whenever the column is collapsed or expanded.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         },
         {
           "name": "navWidth",
           "type": "string",
           "required": false,
           "defaultValue": "14rem",
-          "description": "Width of the navigation column while expanded. Any CSS length. Defaults to `\"14rem\"`."
+          "description": "Width of the navigation column while expanded. Any CSS length. Defaults to `\"14rem\"`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "railWidth",
           "type": "string",
           "required": false,
           "defaultValue": "3.5rem",
-          "description": "Width of the navigation column while railed. Any CSS length. Defaults to\n`\"3.5rem\"` — a `--cue-icon-md` glyph centred in a `--cue-control-md` row,\nwith a gutter either side that still reads as a column rather than a strip."
+          "description": "Width of the navigation column while railed. Any CSS length. Defaults to\n`\"3.5rem\"` — a `--cue-icon-md` glyph centred in a `--cue-control-md` row,\nwith a gutter either side that still reads as a column rather than a strip.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -95,35 +121,53 @@
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "The header cell over the navigation column: the app mark, and whatever\ncontrol rails it.\n\nOmit it and the bar is one undivided strip — no empty bordered cell, which\nis worse than no cell."
+          "description": "The header cell over the navigation column: the app mark, and whatever\ncontrol rails it.\n\nOmit it and the bar is one undivided strip — no empty bordered cell, which\nis worse than no cell.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "brandClassName",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the header cell — the bordered box that spans the\nnavigation column, not the row of brand content inside it. Anything about\nthe cell's width, rim or gutter belongs here; anything about how the mark\nand its controls sit belongs on the nodes passed as `brand`."
+          "description": "Extra classes for the header cell — the bordered box that spans the\nnavigation column, not the row of brand content inside it. Anything about\nthe cell's width, rim or gutter belongs here; anything about how the mark\nand its controls sit belongs on the nodes passed as `brand`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "platformDrag",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Make the bar's dead space a window drag handle. Defaults to `false`.\n\nThis is the same contract {@link TitleBar } has always offered, on the bar\na console with a navigation column actually uses — a desktop app should\nnot need a `TitleBar` *and* an `AppShell.Bar` stacked on top of each other\nto get one draggable row, which is two chrome rungs of a small window\nspent on furniture.\n\nEvery structural surface is attributed and every interactive cluster is\ncarved back out, because the two shells this ships into fail in opposite\ndirections. Tauri matches the *exact* element under the cursor, so the\nbrand cell and the rest cell carry the attribute themselves — a click on\nthe cell's own dead space targets the cell, never the root beneath it, and\na bar that only attributed its root would be draggable nowhere. Electron\nbuilds a geometric mask from painted boxes instead and excludes nothing on\nits own, so the brand content, the leading children and `actions` each sit\nin a cluster marked `app-region: no-drag` — without it a button that merely\noverlaps the bar stops receiving clicks at all. See `./_drag.ts`.\n\n**It changes how the clusters are sized, and that is a trade.** Off, each\ncluster grows into its cell, so a caller's own `ms-auto` reaches the cell's\ntrailing rim. On, the clusters take their content's width and `actions` is\npushed over with `ms-auto` instead, because a cluster that fills its cell\nis a `no-drag` rectangle painted over every dead pixel the cell just\nattributed — the bar would be draggable nowhere but its paddings and its\none gap. The dead area belongs to the window in drag mode, and a caller who\nneeds content to reach the rim there should say so on a box of their own\ninside the cluster.\n\n`select-none` comes with it: dragging a window and selecting the text you\nstarted the drag on are the same gesture, and the shell wins.\n\nNot wired here: double-click-to-maximise. Tauri's injected script already\ndoes it for any drag region, macOS's cancel-by-dragging-away included.\nElectron does not, and an Electron app has to listen for `dblclick` and\ntoggle the window itself. Which of those an app is, is not something a\nlayout component can know."
+          "description": "Make the bar's dead space a window drag handle. Defaults to `false`.\n\nThis is the same contract {@link TitleBar } has always offered, on the bar\na console with a navigation column actually uses — a desktop app should\nnot need a `TitleBar` *and* an `AppShell.Bar` stacked on top of each other\nto get one draggable row, which is two chrome rungs of a small window\nspent on furniture.\n\nEvery structural surface is attributed and every interactive cluster is\ncarved back out, because the two shells this ships into fail in opposite\ndirections. Tauri matches the *exact* element under the cursor, so the\nbrand cell and the rest cell carry the attribute themselves — a click on\nthe cell's own dead space targets the cell, never the root beneath it, and\na bar that only attributed its root would be draggable nowhere. Electron\nbuilds a geometric mask from painted boxes instead and excludes nothing on\nits own, so the brand content, the leading children and `actions` each sit\nin a cluster marked `app-region: no-drag` — without it a button that merely\noverlaps the bar stops receiving clicks at all. See `./_drag.ts`.\n\n**It changes how the clusters are sized, and that is a trade.** Off, each\ncluster grows into its cell, so a caller's own `ms-auto` reaches the cell's\ntrailing rim. On, the clusters take their content's width and `actions` is\npushed over with `ms-auto` instead, because a cluster that fills its cell\nis a `no-drag` rectangle painted over every dead pixel the cell just\nattributed — the bar would be draggable nowhere but its paddings and its\none gap. The dead area belongs to the window in drag mode, and a caller who\nneeds content to reach the rim there should say so on a box of their own\ninside the cluster.\n\n`select-none` comes with it: dragging a window and selecting the text you\nstarted the drag on are the same gesture, and the shell wins.\n\nNot wired here: double-click-to-maximise. Tauri's injected script already\ndoes it for any drag region, macOS's cancel-by-dragging-away included.\nElectron does not, and an Electron app has to listen for `dblclick` and\ntoggle the window itself. Which of those an app is, is not something a\nlayout component can know.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "center",
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "A title centred on the **bar**, not between the cells beside it.\n\nAbsolutely positioned against the bar's own box, so it stays put when a\nbutton appears in `actions` or the column rails — the whole reason a\ndocument name in desktop chrome is not just another flex child.\n`pointer-events-none` so the dead space around a short title still drags,\nwhich is also what makes it click through to the drag surface underneath\nin Tauri, whose hit-testing is the browser's own.\n\nInert by construction. Anything the reader has to click belongs in\n`actions` or in `children`, where it can be carved out of the drag region."
+          "description": "A title centred on the **bar**, not between the cells beside it.\n\nAbsolutely positioned against the bar's own box, so it stays put when a\nbutton appears in `actions` or the column rails — the whole reason a\ndocument name in desktop chrome is not just another flex child.\n`pointer-events-none` so the dead space around a short title still drags,\nwhich is also what makes it click through to the drag surface underneath\nin Tauri, whose hit-testing is the browser's own.\n\nInert by construction. Anything the reader has to click belongs in\n`actions` or in `children`, where it can be carved out of the drag region.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "actions",
           "type": "ReactNode",
           "required": false,
           "defaultValue": null,
-          "description": "The trailing cluster: connection state, a run indicator, an overflow menu.\n\nPinned to the bar's trailing edge and never squeezed, so it reads as window\nfurniture rather than the end of a sentence. `children` keeps flowing into\nthe same cell ahead of it, which is what lets an existing web-shell caller\npass free-form content and gain a cluster without rearranging anything."
+          "description": "The trailing cluster: connection state, a run indicator, an overflow menu.\n\nPinned to the bar's trailing edge and never squeezed, so it reads as window\nfurniture rather than the end of a sentence. `children` keeps flowing into\nthe same cell ahead of it, which is what lets an existing web-shell caller\npass free-form content and gain a cluster without rearranging anything.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         }
       ],
       "typeReferences": [
@@ -149,70 +193,106 @@
           "type": "ReactNode",
           "required": false,
           "defaultValue": "Navigation",
-          "description": "The drawer's heading, and its accessible name. Defaults to `\"Navigation\"`."
+          "description": "The drawer's heading, and its accessible name. Defaults to `\"Navigation\"`.",
+          "control": {
+            "kind": "node",
+            "fixture": "children.text"
+          }
         },
         {
           "name": "closeLabel",
           "type": "string",
           "required": false,
           "defaultValue": "Close navigation",
-          "description": "Accessible name for the drawer's close affordance. Defaults to `\"Close navigation\"`."
+          "description": "Accessible name for the drawer's close affordance. Defaults to `\"Close navigation\"`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "drawerClassName",
           "type": "string",
           "required": false,
           "defaultValue": null,
-          "description": "Extra classes for the drawer's popup surface."
+          "description": "Extra classes for the drawer's popup surface.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "collapsible",
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Draw the column's collapse rail. Defaults to `true`.\n\nThe shell renders the `Sidebar.Rail` itself rather than taking one in\n`children`, because collapsing is a property of the *column* and the same\nchildren are also the drawer's: a rail passed as a child would be laid out\ninside the overlay, where there is nothing to collapse."
+          "description": "Draw the column's collapse rail. Defaults to `true`.\n\nThe shell renders the `Sidebar.Rail` itself rather than taking one in\n`children`, because collapsing is a property of the *column* and the same\nchildren are also the drawer's: a rail passed as a child would be laid out\ninside the overlay, where there is nothing to collapse.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "landmark",
           "type": "\"complementary\" | \"navigation\"",
           "required": false,
           "defaultValue": "navigation",
-          "description": "Which landmark **both** shapes announce as. Defaults to `\"navigation\"`.\n\nOne prop rather than two, because the column and the drawer are one\nnavigation wearing two shapes: the answer cannot differ by viewport."
+          "description": "Which landmark **both** shapes announce as. Defaults to `\"navigation\"`.\n\nOne prop rather than two, because the column and the drawer are one\nnavigation wearing two shapes: the answer cannot differ by viewport.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "complementary",
+              "navigation"
+            ]
+          }
         },
         {
           "name": "collapsed",
           "type": "boolean",
           "required": false,
           "defaultValue": null,
-          "description": "Collapsed state when controlled. Pass with `onCollapsedChange`."
+          "description": "Collapsed state when controlled. Pass with `onCollapsedChange`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "defaultCollapsed",
           "type": "boolean",
           "required": false,
           "defaultValue": "false",
-          "description": "Initial collapsed state when uncontrolled. Defaults to `false`."
+          "description": "Initial collapsed state when uncontrolled. Defaults to `false`.",
+          "control": {
+            "kind": "boolean"
+          }
         },
         {
           "name": "onCollapsedChange",
           "type": "((collapsed: boolean) => void)",
           "required": false,
           "defaultValue": null,
-          "description": "Called with the new collapsed state whenever the rail is pressed."
+          "description": "Called with the new collapsed state whenever the rail is pressed.",
+          "control": {
+            "kind": "callback",
+            "fixture": "callback.log"
+          }
         },
         {
           "name": "width",
           "type": "string",
           "required": false,
           "defaultValue": "14rem",
-          "description": "Width while expanded. Any CSS length. Defaults to `\"14rem\"`."
+          "description": "Width while expanded. Any CSS length. Defaults to `\"14rem\"`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "collapsedWidth",
           "type": "string",
           "required": false,
           "defaultValue": "3rem",
-          "description": "Width while collapsed. Any CSS length. Defaults to `\"3rem\"`."
+          "description": "Width while collapsed. Any CSS length. Defaults to `\"3rem\"`.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -229,21 +309,36 @@
           "type": "string",
           "required": false,
           "defaultValue": "Open navigation",
-          "description": "Accessible name for the control. Defaults to `\"Open navigation\"`."
+          "description": "Accessible name for the control. Defaults to `\"Open navigation\"`.",
+          "control": {
+            "kind": "string"
+          }
         },
         {
           "name": "icon",
           "type": "ElementType<any, keyof IntrinsicElements>",
           "required": false,
           "defaultValue": "MenuGlyph",
-          "description": "The icon it draws. Defaults to the shell's own three-stroke glyph."
+          "description": "The icon it draws. Defaults to the shell's own three-stroke glyph.",
+          "control": {
+            "kind": "opaque",
+            "fixture": "icon.play"
+          }
         },
         {
           "name": "size",
           "type": "\"sm\" | \"md\" | \"lg\"",
           "required": false,
           "defaultValue": "md",
-          "description": "Which rung of the control ladder the button takes. Defaults to `\"md\"`.\n\nThe rest of the window furniture in this library is built at `\"sm\"`, and\nthat is right for a mouse — but this control renders *only* below the `md`\nbreakpoint, which is to say only on a touch screen, where `sm` (20px at\nnormal density) is under the 24×24 CSS-pixel floor WCAG 2.2 SC 2.5.8 sets.\n`\"md\"` is 24px at normal and large, and the token layer's\n`@media (pointer: coarse)` rule lifts ultra-compact to the same 24px, so\nthe default clears the floor at every density a finger can reach it at."
+          "description": "Which rung of the control ladder the button takes. Defaults to `\"md\"`.\n\nThe rest of the window furniture in this library is built at `\"sm\"`, and\nthat is right for a mouse — but this control renders *only* below the `md`\nbreakpoint, which is to say only on a touch screen, where `sm` (20px at\nnormal density) is under the 24×24 CSS-pixel floor WCAG 2.2 SC 2.5.8 sets.\n`\"md\"` is 24px at normal and large, and the token layer's\n`@media (pointer: coarse)` rule lifts ultra-compact to the same 24px, so\nthe default clears the floor at every density a finger can reach it at.",
+          "control": {
+            "kind": "enum",
+            "members": [
+              "sm",
+              "md",
+              "lg"
+            ]
+          }
         }
       ],
       "typeReferences": [
@@ -260,7 +355,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Render the `<main>` landmark. Defaults to `true`.\n\nSet it `false` when the shell is embedded in a document that already has a\n`<main>` — a specimen, a screenshot, a shell shown inside a device frame on\na page of prose. A document may have only one, and a nested one is a defect\nrather than a nicety."
+          "description": "Render the `<main>` landmark. Defaults to `true`.\n\nSet it `false` when the shell is embedded in a document that already has a\n`<main>` — a specimen, a screenshot, a shell shown inside a device frame on\na page of prose. A document may have only one, and a nested one is a defect\nrather than a nicety.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -277,7 +375,10 @@
           "type": "boolean",
           "required": false,
           "defaultValue": "true",
-          "description": "Draw the standard work-area gutters. Defaults to `true`."
+          "description": "Draw the standard work-area gutters. Defaults to `true`.",
+          "control": {
+            "kind": "boolean"
+          }
         }
       ],
       "typeReferences": [
@@ -294,7 +395,10 @@
           "type": "string",
           "required": false,
           "defaultValue": "18rem",
-          "description": "Width of the column. Any CSS length. Defaults to `\"18rem\"`."
+          "description": "Width of the column. Any CSS length. Defaults to `\"18rem\"`.",
+          "control": {
+            "kind": "string"
+          }
         }
       ],
       "typeReferences": [
@@ -308,11 +412,9 @@
     "--cue-bg",
     "--cue-border",
     "--cue-chrome-titlebar",
-    "--cue-control-md",
     "--cue-fg",
     "--cue-fg-muted",
     "--cue-font-mono",
-    "--cue-icon-md",
     "--cue-nav-width",
     "--cue-pad-row-x",
     "--cue-space-3",

package/manifest/components/app-window-frame.json

@@ -12,42 +12,64 @@
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The document name, centred in the title bar."
+      "description": "The document name, centred in the title bar.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "traffic",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Draw the three window lights. Defaults to `true`."
+      "description": "Draw the three window lights. Defaults to `true`.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "toolbar",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Contents of the toolbar row under the title bar. Omit for no toolbar."
+      "description": "Contents of the toolbar row under the title bar. Omit for no toolbar.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "statusBar",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "Contents of the status bar along the bottom. Omit for no status bar."
+      "description": "Contents of the status bar along the bottom. Omit for no status bar.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "elevated",
       "type": "boolean",
       "required": false,
       "defaultValue": "true",
-      "description": "Float the frame off the page with a drop shadow. Defaults to `true`.\n\nThis is the one flat-design exception in the kit, and it is not really an\nexception: the component *depicts a floating window*, which is exactly the\ncase the overlay shadow rule already carves out. Set it `false` when the\nframe is inlined into a page that is already a window."
+      "description": "Float the frame off the page with a drop shadow. Defaults to `true`.\n\nThis is the one flat-design exception in the kit, and it is not really an\nexception: the component *depicts a floating window*, which is exactly the\ncase the overlay shadow rule already carves out. Set it `false` when the\nframe is inlined into a page that is already a window.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "What is inside the window."
+      "description": "What is inside the window.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [