@vielzeug/codex 26.11.2 → 26.11.4

package/data/refine.json

@@ -40,7 +40,7 @@
       "text": "['full', 'reduced', 'system']"
     },
     "default": "['full', 'reduced', 'system']",
-    "description": "App-level motion mode, mirroring `@vielzeug/necromancer`'s `MotionMode`:\nthe operating-system preference is the default, and an application with its\nown \"reduce motion\" setting can force either direction.\n\nThe mode is one attribute on `<html>` (`data-motion`), which the Reduced\nMotion block in `theme.css` reads: `'reduced'` zeroes every duration and\ntransition token and switches the `--_motion-*` escape hatches to `none`,\n`'full'` opts back in despite an OS-level reduction, and `'system'` (the\ndefault) removes the attribute. Because the tokens drive every CSS\nanimation and transition in the library, one call restyles all motion."
+    "description": "App-level motion mode, built on `@vielzeug/necromancer`'s `MotionMode`:\nthe operating-system preference is the default, and an application with its\nown \"reduce motion\" setting can force either direction.\n\nThe mode is one attribute on `<html>` (`data-motion`), which the Reduced\nMotion block in `theme.css` reads: `'reduced'` zeroes every duration and\ntransition token and switches the `--_motion-*` escape hatches to `none`,\n`'full'` opts back in despite an OS-level reduction, and `'system'` (the\ndefault) removes the attribute. Because the tokens drive every CSS\nanimation and transition in the library, one call restyles all motion."
   },
   {
     "kind": "function",
@@ -129,6 +129,224 @@
     ],
     "description": "Creates a document theme controller. Call once at app startup."
   },
+  {
+    "kind": "variable",
+    "name": "UI_BLUEPRINT_VERSION",
+    "type": {
+      "text": "1"
+    },
+    "default": "1",
+    "description": "Registry contract version. Bump only together with a documented migration."
+  },
+  {
+    "kind": "variable",
+    "name": "MAX_BLUEPRINT_NODES",
+    "type": {
+      "text": "number"
+    },
+    "default": "64",
+    "description": "Maximum total nodes in one document, including the root."
+  },
+  {
+    "kind": "variable",
+    "name": "MAX_BLUEPRINT_DEPTH",
+    "type": {
+      "text": "number"
+    },
+    "default": "6",
+    "description": "Maximum nesting depth, counting the root node as depth 1."
+  },
+  {
+    "kind": "variable",
+    "name": "MAX_BLUEPRINT_CHILDREN",
+    "type": {
+      "text": "number"
+    },
+    "default": "12",
+    "description": "Maximum children on one container node. Matches the widest `ore-grid` column count."
+  },
+  {
+    "kind": "variable",
+    "name": "MAX_BLUEPRINT_TEXT_LENGTH",
+    "type": {
+      "text": "number"
+    },
+    "default": "500",
+    "description": "Maximum length of rendered body text."
+  },
+  {
+    "kind": "variable",
+    "name": "MAX_BLUEPRINT_LABEL_LENGTH",
+    "type": {
+      "text": "number"
+    },
+    "default": "120",
+    "description": "Maximum length of a short label (button, field label, helper text)."
+  },
+  {
+    "kind": "variable",
+    "name": "MAX_BLUEPRINT_NUMBER",
+    "type": {
+      "text": "number"
+    },
+    "default": "1_000_000_000",
+    "description": "Default absolute ceiling for numeric fields; individual fields tighten it where needed."
+  },
+  {
+    "kind": "variable",
+    "name": "MAX_BLUEPRINT_ID_LENGTH",
+    "type": {
+      "text": "number"
+    },
+    "default": "64",
+    "description": "Maximum length of a host-facing node identifier."
+  },
+  {
+    "kind": "variable",
+    "name": "UI_BLUEPRINT_COMPONENTS",
+    "default": "[ 'text', 'box', 'card', 'button', 'badge', 'separator', 'slider', 'switch', 'checkbox', 'number-input', 'alert', 'progress', 'icon', ] as const satisfies readonly BlueprintNode['type'][]",
+    "description": "Registry component identifiers. The only names a document may use."
+  },
+  {
+    "kind": "class",
+    "description": "Thrown for a document this contract rejects. Messages are safe to display.",
+    "name": "UiBlueprintError",
+    "members": [
+      {
+        "kind": "field",
+        "name": "issues",
+        "type": {
+          "text": "readonly string[]"
+        },
+        "readonly": true,
+        "description": "Every rejection, in document order. Each entry is a field path plus a plain reason."
+      },
+      {
+        "kind": "field",
+        "name": "name",
+        "inheritedFrom": {
+          "name": "RefineError",
+          "module": "src/errors.ts"
+        }
+      }
+    ],
+    "superclass": {
+      "name": "RefineError",
+      "module": "/src/errors"
+    }
+  },
+  {
+    "kind": "variable",
+    "name": "UI_BLUEPRINT_REGISTRY",
+    "type": {
+      "text": "Readonly<Record<BlueprintNode['type'], UiBlueprintComponentRule>>"
+    },
+    "description": "The registry as data: for each accepted component, the element it renders, whether it takes\nchildren, and the exact values each attribute accepts.\n\nPublish it to a harness alongside UI_BLUEPRINT_JSON_SCHEMA when a prompt needs prose\nrather than a schema. Runtime validation remains the trust boundary."
+  },
+  {
+    "kind": "function",
+    "name": "parseUiBlueprint",
+    "return": {
+      "type": {
+        "text": "BlueprintDocument"
+      }
+    },
+    "parameters": [
+      {
+        "name": "value",
+        "type": {
+          "text": "unknown"
+        }
+      }
+    ],
+    "description": "Validate untrusted model output. Returns the document unchanged when it satisfies the\ncontract, or a UiBlueprintError listing every rejection with a field path. Nothing is\nrepaired, defaulted, or partially accepted."
+  },
+  {
+    "kind": "function",
+    "name": "safeParseUiBlueprint",
+    "return": {
+      "type": {
+        "text": "{ document: BlueprintDocument; success: true } | { issues: readonly string[]; success: false }"
+      }
+    },
+    "parameters": [
+      {
+        "name": "value",
+        "type": {
+          "text": "unknown"
+        }
+      }
+    ],
+    "description": "Non-throwing form of parseUiBlueprint."
+  },
+  {
+    "kind": "variable",
+    "name": "UI_BLUEPRINT_JSON_SCHEMA",
+    "type": {
+      "text": "Readonly<Record<string, unknown>>"
+    },
+    "description": "JSON Schema (draft 2020-12 vocabulary) for the same contract parseUiBlueprint\nenforces. Hand it to a harness that supports structured output or tool-use schemas so the\nmodel is constrained on the way out, not only on the way in.\n\nIt cannot express the tree-wide node and depth bounds, which is why runtime validation stays\nmandatory: treat this as a generation aid, never as the trust boundary."
+  },
+  {
+    "kind": "function",
+    "name": "createUiBlueprintElement",
+    "return": {
+      "type": {
+        "text": "HTMLElement"
+      }
+    },
+    "parameters": [
+      {
+        "name": "node",
+        "type": {
+          "text": "BlueprintNode"
+        }
+      },
+      {
+        "name": "owner",
+        "default": "'root'"
+      },
+      {
+        "name": "nodes",
+        "optional": true,
+        "type": {
+          "text": "Map<string, HTMLElement>"
+        }
+      }
+    ],
+    "description": "Build one element for a validated node. The component map is this switch: adding a component\nmeans adding a case here plus a rule in `blueprint.ts`, and nothing else."
+  },
+  {
+    "kind": "function",
+    "name": "renderUiBlueprint",
+    "return": {
+      "type": {
+        "text": "UiBlueprintRenderResult"
+      }
+    },
+    "parameters": [
+      {
+        "name": "container",
+        "type": {
+          "text": "HTMLElement"
+        }
+      },
+      {
+        "name": "value",
+        "type": {
+          "text": "unknown"
+        }
+      },
+      {
+        "name": "options",
+        "default": "{}",
+        "type": {
+          "text": "UiBlueprintRenderOptions"
+        }
+      }
+    ],
+    "description": "Validate `value` and, only on success, render it into `container`.\n\nA rejected document throws before the container is touched, so an invalid or stale response can\nnever partially render or erase the preview already on screen."
+  },
   {
     "kind": "function",
     "name": "announce",
@@ -4634,152 +4852,6 @@
       }
     ]
   },
-  {
-    "kind": "variable",
-    "name": "TEXT_TAG",
-    "type": {
-      "text": "'ore-text'"
-    },
-    "default": "'ore-text'",
-    "description": "A typography component with semantic variants and responsive sizing."
-  },
-  {
-    "kind": "class",
-    "name": "OreTextElement",
-    "tagName": "ore-text",
-    "customElement": true,
-    "description": "A typography component with semantic variants and responsive sizing.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "variant",
-        "type": {
-          "text": "'body' | 'heading' | 'label' | 'caption' | 'overline' | 'code'"
-        },
-        "description": "Text variant: 'body' | 'heading' | 'label' | 'caption' | 'overline' | 'code'"
-      },
-      {
-        "name": "size",
-        "type": {
-          "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl'"
-        },
-        "description": "Font size: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl'. Maps to --text-* tokens for body variants and --heading-* tokens for the heading variant."
-      },
-      {
-        "name": "weight",
-        "type": {
-          "text": "'normal' | 'medium' | 'semibold' | 'bold'"
-        },
-        "description": "Font weight: 'normal' | 'medium' | 'semibold' | 'bold'"
-      },
-      {
-        "name": "color",
-        "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error' | 'heading' | 'body' | 'muted' | 'tertiary' | 'disabled' | 'contrast'"
-        },
-        "description": "Text color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error' | 'heading' | 'body' | 'muted' | 'tertiary' | 'disabled' | 'contrast'"
-      },
-      {
-        "name": "align",
-        "type": {
-          "text": "'left' | 'center' | 'right' | 'justify'"
-        },
-        "description": "Text alignment: 'left' | 'center' | 'right' | 'justify'"
-      },
-      {
-        "name": "truncate",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Truncate text with ellipsis when it overflows (single-line)"
-      },
-      {
-        "name": "lines",
-        "type": {
-          "text": "number"
-        },
-        "description": "Clamp to N lines with ellipsis (multi-line truncation)"
-      },
-      {
-        "name": "expandable",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Reveal clipped text on click/tap (pairs with `truncate` or `lines`)"
-      },
-      {
-        "name": "expanded",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Controlled expanded state for an `expandable` text"
-      },
-      {
-        "name": "default-expanded",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Initial uncontrolled expanded state"
-      },
-      {
-        "name": "italic",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Italic text style"
-      },
-      {
-        "name": "as",
-        "type": {
-          "text": "'span' | 'p' | 'div' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'label' | 'code'"
-        },
-        "description": "Semantic HTML element: 'span' | 'p' | 'div' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'label' | 'code'"
-      }
-    ],
-    "events": [
-      {
-        "name": "expand-change",
-        "description": "Fired when an `expandable` text is toggled. detail: { expanded: boolean }",
-        "type": {
-          "text": "CustomEvent"
-        }
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "Text content"
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--text-size",
-        "description": "Font size"
-      },
-      {
-        "name": "--text-weight",
-        "description": "Font weight"
-      },
-      {
-        "name": "--text-color",
-        "description": "Text color"
-      },
-      {
-        "name": "--text-line-height",
-        "description": "Line height"
-      },
-      {
-        "name": "--text-letter-spacing",
-        "description": "Letter spacing"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-text variant=\"heading\" size=\"2xl\" weight=\"bold\">Welcome</ore-text>\n<ore-text as=\"h2\" variant=\"heading\" size=\"xl\">Section title</ore-text>\n<ore-text color=\"primary\" weight=\"semibold\">Important notice</ore-text>\n<ore-text variant=\"code\">npm install</ore-text>\n<ore-text lines=\"2\">Long paragraph that clamps at two lines…</ore-text>\n<!-- Clamp and let the reader expand -->\n<ore-text lines=\"2\" expandable>Long paragraph, tap to read the rest…</ore-text>\n```"
-      }
-    ]
-  },
   {
     "kind": "variable",
     "name": "ALERT_TAG",
@@ -4967,6 +5039,152 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "TEXT_TAG",
+    "type": {
+      "text": "'ore-text'"
+    },
+    "default": "'ore-text'",
+    "description": "A typography component with semantic variants and responsive sizing."
+  },
+  {
+    "kind": "class",
+    "name": "OreTextElement",
+    "tagName": "ore-text",
+    "customElement": true,
+    "description": "A typography component with semantic variants and responsive sizing.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "variant",
+        "type": {
+          "text": "'body' | 'heading' | 'label' | 'caption' | 'overline' | 'code'"
+        },
+        "description": "Text variant: 'body' | 'heading' | 'label' | 'caption' | 'overline' | 'code'"
+      },
+      {
+        "name": "size",
+        "type": {
+          "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl'"
+        },
+        "description": "Font size: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl'. Maps to --text-* tokens for body variants and --heading-* tokens for the heading variant."
+      },
+      {
+        "name": "weight",
+        "type": {
+          "text": "'normal' | 'medium' | 'semibold' | 'bold'"
+        },
+        "description": "Font weight: 'normal' | 'medium' | 'semibold' | 'bold'"
+      },
+      {
+        "name": "color",
+        "type": {
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error' | 'heading' | 'body' | 'muted' | 'tertiary' | 'disabled' | 'contrast'"
+        },
+        "description": "Text color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error' | 'heading' | 'body' | 'muted' | 'tertiary' | 'disabled' | 'contrast'"
+      },
+      {
+        "name": "align",
+        "type": {
+          "text": "'left' | 'center' | 'right' | 'justify'"
+        },
+        "description": "Text alignment: 'left' | 'center' | 'right' | 'justify'"
+      },
+      {
+        "name": "truncate",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Truncate text with ellipsis when it overflows (single-line)"
+      },
+      {
+        "name": "lines",
+        "type": {
+          "text": "number"
+        },
+        "description": "Clamp to N lines with ellipsis (multi-line truncation)"
+      },
+      {
+        "name": "expandable",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Reveal clipped text on click/tap (pairs with `truncate` or `lines`)"
+      },
+      {
+        "name": "expanded",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Controlled expanded state for an `expandable` text"
+      },
+      {
+        "name": "default-expanded",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Initial uncontrolled expanded state"
+      },
+      {
+        "name": "italic",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Italic text style"
+      },
+      {
+        "name": "as",
+        "type": {
+          "text": "'span' | 'p' | 'div' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'label' | 'code'"
+        },
+        "description": "Semantic HTML element: 'span' | 'p' | 'div' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'label' | 'code'"
+      }
+    ],
+    "events": [
+      {
+        "name": "expand-change",
+        "description": "Fired when an `expandable` text is toggled. detail: { expanded: boolean }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Text content"
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--text-size",
+        "description": "Font size"
+      },
+      {
+        "name": "--text-weight",
+        "description": "Font weight"
+      },
+      {
+        "name": "--text-color",
+        "description": "Text color"
+      },
+      {
+        "name": "--text-line-height",
+        "description": "Line height"
+      },
+      {
+        "name": "--text-letter-spacing",
+        "description": "Letter spacing"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-text variant=\"heading\" size=\"2xl\" weight=\"bold\">Welcome</ore-text>\n<ore-text as=\"h2\" variant=\"heading\" size=\"xl\">Section title</ore-text>\n<ore-text color=\"primary\" weight=\"semibold\">Important notice</ore-text>\n<ore-text variant=\"code\">npm install</ore-text>\n<ore-text lines=\"2\">Long paragraph that clamps at two lines…</ore-text>\n<!-- Clamp and let the reader expand -->\n<ore-text lines=\"2\" expandable>Long paragraph, tap to read the rest…</ore-text>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "ASYNC_TAG",
@@ -9079,6 +9297,10 @@
         "name": "viewfinder",
         "description": "Decorative scan frame over the preview"
       },
+      {
+        "name": "spinner",
+        "description": "Busy ring shown over the stage while the camera starts"
+      },
       {
         "name": "state",
         "description": "Idle/error/denied/unsupported/result panel"
@@ -11229,14 +11451,14 @@
       "text": "'ore-dock'"
     },
     "default": "'ore-dock'",
-    "description": "The navbar's other twin: a bar of actions that pins to a viewport edge while its container\nscrolls, and settles into the document flow once that container ends.\n\nThree named places and a tool row. `start` and `commit` are the flanks, `center` is the one\nplace allowed to carry a non-action (a clock, a stat block), and the default slot is the row\nof tools between them. A place nothing is assigned to leaves no gap and no flex line: the bar\ncollapses to the places it actually carries.\n\nWide, the bar is a full-width strip flush to its edge, wearing a hairline only while pinned.\nFrom the desktop width (1280 px) up, a claimed `center` sits dead-center because both sides of\nthe row take an equal share. Below the phone width (640 px) the bar becomes a single tool row in\nthe iOS toolbar grammar: the flanks stretch equally so the tools rest on the row's true middle,\nthe bar detaches from the viewport's foot, and `center` lifts out of the row to hover above it.\nBy default, a phone row with one action zone hugs its content: `start` aligns to the leading\nedge, `commit` to the trailing edge, and tools to the middle. A lone `center` stays in the row.\nMultiple action zones and attached tools fill the row. `mobile-layout=\"full\"` always fills it;\n`mobile-layout=\"compact\"` always hugs and centers it. Above the phone width every bar is a\nfull-width strip.\n\nThe bar's surface rides a pseudo-element, never the host: `backdrop-filter` on the host would\nmake it a containing block for `position: fixed` descendants, trapping any panel a slotted\ncontrol opens (a menu, a tooltip) inside the bar's own box.\n\nSizing reaches slotted content through custom properties only (`--dock-tool-flex`,\n`--dock-tool-radius`): a shadow-tree `::slotted()` declaration ranks below any document-tree\nrule on the same property, so a consumer that sets `flex` or `width` on a dock child outranks\nthe bar's own layout. Where a bar must stretch its tools (`attached`), it does so by reading\n`--dock-tool-flex`, so the consumer's lever is the property, not a fight with a declaration.\nEvery such rule is scoped through the zone that owns the slot, because `::slotted()` reaches the\nchildren of every slot the bar renders. The flanks keep their own shape.\n\nThe host reflects which places are filled as `data-start-claimed`, `data-center-claimed`,\n`data-tools-claimed`, and `data-commit-claimed`, plus `data-pinned` while the bar is holding its\nedge. Those exist because no selector can derive them: `:has()` cannot see slotted content and a\n`<slot>` always matches `:empty`. The phone layout needs no reflection: it is a plain media\nquery in the bar's own stylesheet, the same way every other refine breakpoint is written."
+    "description": "The navbar's other twin: a bar of actions that pins to a viewport edge while its container\nscrolls, and settles into the document flow once that container ends.\n\nThree named places and a tool row. `start` and `commit` are the flanks, `center` is the one\nplace allowed to carry a non-action (a clock, a stat block), and the default slot is the row\nof tools between them. A place nothing is assigned to leaves no gap and no flex line: the bar\ncollapses to the places it actually carries.\n\nWide, the bar is a full-width strip flush to its edge, wearing a hairline only while pinned.\nFrom the desktop width (1280 px) up, a claimed `center` sits dead-center because both sides of\nthe row take an equal share. Below the phone width (640 px) the bar becomes a tool row in\nthe iOS toolbar grammar: the flanks stretch equally so the tools rest on the row's true middle\nwhile space permits. Flank content takes priority over centering; crowded zones wrap rather\nthan overlapping or shrinking controls.\nThe bar detaches from the viewport's foot, and `center` lifts out of the row to hover above it.\nBy default, a phone row with one action zone hugs its content: `start` aligns to the leading\nedge, `commit` to the trailing edge, and tools to the middle. A lone `center` stays in the row.\nMultiple action zones and attached tools fill the row. `mobile-layout=\"full\"` always fills it;\n`mobile-layout=\"compact\"` always hugs and centers it. Above the phone width every bar is a\nfull-width strip.\n\nThe bar's surface rides a pseudo-element, never the host: `backdrop-filter` on the host would\nmake it a containing block for `position: fixed` descendants, trapping any panel a slotted\ncontrol opens (a menu, a tooltip) inside the bar's own box.\n\nSizing reaches slotted content through custom properties only (`--dock-tool-flex`,\n`--dock-tool-radius`): a shadow-tree `::slotted()` declaration ranks below any document-tree\nrule on the same property, so a consumer that sets `flex` or `width` on a dock child outranks\nthe bar's own layout. Where a bar must stretch its tools (`attached`), it does so by reading\n`--dock-tool-flex`, so the consumer's lever is the property, not a fight with a declaration.\nEvery such rule is scoped through the zone that owns the slot, because `::slotted()` reaches the\nchildren of every slot the bar renders. The flanks keep their own shape.\n\nThe host reflects which places are filled as `data-start-claimed`, `data-center-claimed`,\n`data-tools-claimed`, and `data-commit-claimed`, plus `data-pinned` while the bar is holding its\nedge. Those exist because no selector can derive them: `:has()` cannot see slotted content and a\n`<slot>` always matches `:empty`. The phone layout needs no reflection: it is a plain media\nquery in the bar's own stylesheet, the same way every other refine breakpoint is written."
   },
   {
     "kind": "class",
     "name": "OreDockElement",
     "tagName": "ore-dock",
     "customElement": true,
-    "description": "The navbar's other twin: a bar of actions that pins to a viewport edge while its container\nscrolls, and settles into the document flow once that container ends.\nThree named places and a tool row. `start` and `commit` are the flanks, `center` is the one\nplace allowed to carry a non-action (a clock, a stat block), and the default slot is the row\nof tools between them. A place nothing is assigned to leaves no gap and no flex line: the bar\ncollapses to the places it actually carries.\nWide, the bar is a full-width strip flush to its edge, wearing a hairline only while pinned.\nFrom the desktop width (1280 px) up, a claimed `center` sits dead-center because both sides of\nthe row take an equal share. Below the phone width (640 px) the bar becomes a single tool row in\nthe iOS toolbar grammar: the flanks stretch equally so the tools rest on the row's true middle,\nthe bar detaches from the viewport's foot, and `center` lifts out of the row to hover above it.\nBy default, a phone row with one action zone hugs its content: `start` aligns to the leading\nedge, `commit` to the trailing edge, and tools to the middle. A lone `center` stays in the row.\nMultiple action zones and attached tools fill the row. `mobile-layout=\"full\"` always fills it;\n`mobile-layout=\"compact\"` always hugs and centers it. Above the phone width every bar is a\nfull-width strip.\nThe bar's surface rides a pseudo-element, never the host: `backdrop-filter` on the host would\nmake it a containing block for `position: fixed` descendants, trapping any panel a slotted\ncontrol opens (a menu, a tooltip) inside the bar's own box.\nSizing reaches slotted content through custom properties only (`--dock-tool-flex`,\n`--dock-tool-radius`): a shadow-tree `::slotted()` declaration ranks below any document-tree\nrule on the same property, so a consumer that sets `flex` or `width` on a dock child outranks\nthe bar's own layout. Where a bar must stretch its tools (`attached`), it does so by reading\n`--dock-tool-flex`, so the consumer's lever is the property, not a fight with a declaration.\nEvery such rule is scoped through the zone that owns the slot, because `::slotted()` reaches the\nchildren of every slot the bar renders. The flanks keep their own shape.\nThe host reflects which places are filled as `data-start-claimed`, `data-center-claimed`,\n`data-tools-claimed`, and `data-commit-claimed`, plus `data-pinned` while the bar is holding its\nedge. Those exist because no selector can derive them: `:has()` cannot see slotted content and a\n`<slot>` always matches `:empty`. The phone layout needs no reflection: it is a plain media\nquery in the bar's own stylesheet, the same way every other refine breakpoint is written.",
+    "description": "The navbar's other twin: a bar of actions that pins to a viewport edge while its container\nscrolls, and settles into the document flow once that container ends.\nThree named places and a tool row. `start` and `commit` are the flanks, `center` is the one\nplace allowed to carry a non-action (a clock, a stat block), and the default slot is the row\nof tools between them. A place nothing is assigned to leaves no gap and no flex line: the bar\ncollapses to the places it actually carries.\nWide, the bar is a full-width strip flush to its edge, wearing a hairline only while pinned.\nFrom the desktop width (1280 px) up, a claimed `center` sits dead-center because both sides of\nthe row take an equal share. Below the phone width (640 px) the bar becomes a tool row in\nthe iOS toolbar grammar: the flanks stretch equally so the tools rest on the row's true middle\nwhile space permits. Flank content takes priority over centering; crowded zones wrap rather\nthan overlapping or shrinking controls.\nThe bar detaches from the viewport's foot, and `center` lifts out of the row to hover above it.\nBy default, a phone row with one action zone hugs its content: `start` aligns to the leading\nedge, `commit` to the trailing edge, and tools to the middle. A lone `center` stays in the row.\nMultiple action zones and attached tools fill the row. `mobile-layout=\"full\"` always fills it;\n`mobile-layout=\"compact\"` always hugs and centers it. Above the phone width every bar is a\nfull-width strip.\nThe bar's surface rides a pseudo-element, never the host: `backdrop-filter` on the host would\nmake it a containing block for `position: fixed` descendants, trapping any panel a slotted\ncontrol opens (a menu, a tooltip) inside the bar's own box.\nSizing reaches slotted content through custom properties only (`--dock-tool-flex`,\n`--dock-tool-radius`): a shadow-tree `::slotted()` declaration ranks below any document-tree\nrule on the same property, so a consumer that sets `flex` or `width` on a dock child outranks\nthe bar's own layout. Where a bar must stretch its tools (`attached`), it does so by reading\n`--dock-tool-flex`, so the consumer's lever is the property, not a fight with a declaration.\nEvery such rule is scoped through the zone that owns the slot, because `::slotted()` reaches the\nchildren of every slot the bar renders. The flanks keep their own shape.\nThe host reflects which places are filled as `data-start-claimed`, `data-center-claimed`,\n`data-tools-claimed`, and `data-commit-claimed`, plus `data-pinned` while the bar is holding its\nedge. Those exist because no selector can derive them: `:has()` cannot see slotted content and a\n`<slot>` always matches `:empty`. The phone layout needs no reflection: it is a plain media\nquery in the bar's own stylesheet, the same way every other refine breakpoint is written.",
     "summary": "",
     "attributes": [
       {
@@ -14906,6 +15128,30 @@
     ],
     "description": "Shared dialog-control composable for `ore-dialog` and `ore-drawer`.\n\nOwns: `isOpen`, close-reason tracking, focus management, `overlay`,\n`requestClose`, background lock/unlock, and the `close` event handler.\nComponents supply only their unique behavior via callbacks and `onNativeClose`."
   },
+  {
+    "kind": "function",
+    "name": "bindFloatingClick",
+    "return": {
+      "type": {
+        "text": "() => void"
+      }
+    },
+    "parameters": [
+      {
+        "name": "trigger",
+        "type": {
+          "text": "HTMLElement"
+        }
+      },
+      {
+        "name": "handlers",
+        "type": {
+          "text": "{ close: () => void; isOpen: () => boolean; open: () => void }"
+        }
+      }
+    ],
+    "description": "A pointer press may focus and open the panel before its click arrives. Toggle from the pre-press state."
+  },
   {
     "kind": "function",
     "name": "useFloatingTrigger",