@vielzeug/codex 26.10.18 → 26.10.20

package/data/catalog.json

@@ -35,7 +35,7 @@
         "rune"
       ],
       "slug": "archive",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -108,7 +108,7 @@
         "coins"
       ],
       "slug": "arsenal",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -160,7 +160,7 @@
         "refine"
       ],
       "slug": "assay",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -199,7 +199,7 @@
         "vault"
       ],
       "slug": "beacon",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -241,7 +241,7 @@
         "ward"
       ],
       "slug": "clockwork",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -273,7 +273,7 @@
         "refine"
       ],
       "slug": "codex",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -343,7 +343,7 @@
         "spell"
       ],
       "slug": "coins",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -384,7 +384,7 @@
         "rune"
       ],
       "slug": "conduit",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -426,7 +426,7 @@
         "postmaster"
       ],
       "slug": "courier",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -472,7 +472,7 @@
         "refine"
       ],
       "slug": "dnd",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -514,7 +514,7 @@
         "herald"
       ],
       "slug": "familiar",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -581,7 +581,7 @@
         "courier"
       ],
       "slug": "flux",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -621,7 +621,7 @@
         "ore"
       ],
       "slug": "focus",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -662,7 +662,7 @@
         "assay"
       ],
       "slug": "forge",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -700,7 +700,7 @@
         "keymap"
       ],
       "slug": "gesture",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -744,7 +744,7 @@
         "familiar"
       ],
       "slug": "herald",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -787,7 +787,7 @@
         "tempo"
       ],
       "slug": "illusionist",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -832,7 +832,7 @@
         "ore"
       ],
       "slug": "keymap",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -879,7 +879,7 @@
         "vault"
       ],
       "slug": "ledger",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -925,7 +925,7 @@
         "courier"
       ],
       "slug": "lingua",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -963,7 +963,7 @@
         "herald"
       ],
       "slug": "mesh",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1000,7 +1000,7 @@
         "ore"
       ],
       "slug": "necromancer",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1040,7 +1040,7 @@
         "prism"
       ],
       "slug": "orbit",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1105,7 +1105,7 @@
         "orbit"
       ],
       "slug": "ore",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1149,7 +1149,7 @@
         "ripple"
       ],
       "slug": "postmaster",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1189,7 +1189,7 @@
         "orbit"
       ],
       "slug": "prism",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1253,7 +1253,7 @@
         "clockwork"
       ],
       "slug": "pulse",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1375,7 +1375,7 @@
         "keymap"
       ],
       "slug": "refine",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1420,7 +1420,7 @@
         "ledger"
       ],
       "slug": "ripple",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1474,7 +1474,7 @@
         "familiar"
       ],
       "slug": "rune",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1515,7 +1515,7 @@
         "refine"
       ],
       "slug": "sandbox",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1566,7 +1566,7 @@
         "ripple"
       ],
       "slug": "scout",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1619,7 +1619,7 @@
         "refine"
       ],
       "slug": "scroll",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1666,7 +1666,7 @@
         "gesture"
       ],
       "slug": "sentinel",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1706,7 +1706,7 @@
         "refine"
       ],
       "slug": "sigil",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1751,7 +1751,7 @@
         "wayfinder"
       ],
       "slug": "sourcerer",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1810,7 +1810,7 @@
         "vault"
       ],
       "slug": "spell",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1851,7 +1851,7 @@
         "ripple"
       ],
       "slug": "tandem",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1895,7 +1895,7 @@
         "herald"
       ],
       "slug": "tavern",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -1963,7 +1963,7 @@
         "vault"
       ],
       "slug": "tempo",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -2014,7 +2014,7 @@
         "ripple"
       ],
       "slug": "vault",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -2060,7 +2060,7 @@
         "refine"
       ],
       "slug": "ward",
-      "version": "26.10.17"
+      "version": "26.10.19"
     },
     {
       "availableDocPages": [
@@ -2114,8 +2114,8 @@
         "herald"
       ],
       "slug": "wayfinder",
-      "version": "26.10.17"
+      "version": "26.10.19"
     }
   ],
-  "version": "26.10.17"
+  "version": "26.10.19"
 }

package/data/llms-full.txt

@@ -1,6 +1,6 @@
 # Vielzeug: Full Documentation
 
-> Complete documentation for 43 packages. Version: 26.10.17
+> Complete documentation for 43 packages. Version: 26.10.19
 
 ---
 

package/data/llms.txt

@@ -1,6 +1,6 @@
 # Vielzeug
 
-> 43 focused TypeScript packages. Version: 26.10.17
+> 43 focused TypeScript packages. Version: 26.10.19
 
 Install any package independently: `pnpm add @vielzeug/<name>`
 

package/data/manifest.json

@@ -4,5 +4,5 @@
   "refine": "refine.json",
   "schemaVersion": 1,
   "search": "search.json",
-  "version": "26.10.17"
+  "version": "26.10.19"
 }

package/data/packages/refine.json

@@ -1,5 +1,5 @@
 {
-  "apiSource": "/**\n * Refine components register through their explicit component entry points.\n *\n * Keeping the package root free of registration side effects makes dependency\n * ownership and bundle contents obvious to application code.\n */\n\nexport { RefineError } from './errors';\nexport type { IconAttributes, IconDefinition, IconElement } from './icons';\nexport { registerIcons } from './icons';\nexport { eventFieldChecked, eventFieldValue } from './inputs/shared/native-field-event';\n",
+  "apiSource": "/**\n * Refine components register through their explicit component entry points.\n *\n * Keeping the package root free of registration side effects makes dependency\n * ownership and bundle contents obvious to application code.\n */\n\nexport { RefineError } from './errors';\nexport type { IconAttributes, IconDefinition, IconElement } from './icons';\nexport { registerIcons } from './icons';\nexport { eventFieldChecked, eventFieldValue } from './inputs/shared/native-field-event';\nexport { getMotionMode, MOTION_MODES, type MotionMode, setMotionMode } from './motion';\n",
   "docs": {
     "index": "---\ntitle: 'Refine: Web component library'\ndescription: Accessible, themeable web components built with Ore for framework and vanilla DOM apps.\npackage: refine\ncategory: ui-components\nkeywords: [web-components, accessible, themeable, ui, components, design-system]\nrelated: [ore, orbit, forge, keymap]\nexports:\n  [\n    ore-accordion,\n    ore-accordion-item,\n    ore-alert,\n    ore-async,\n    ore-avatar,\n    ore-avatar-group,\n    ore-badge,\n    ore-box,\n    ore-breadcrumb,\n    ore-breadcrumb-item,\n    ore-button,\n    ore-button-group,\n    ore-calendar,\n    ore-card,\n    ore-carousel,\n    ore-carousel-slide,\n    ore-chat-message,\n    ore-checkbox,\n    ore-checkbox-group,\n    ore-chip,\n    ore-code-window,\n    ore-column,\n    ore-combobox,\n    ore-combobox-option,\n    ore-command-palette,\n    ore-command-palette-item,\n    ore-cookie-banner,\n    ore-copy-command,\n    ore-counter,\n    ore-datagrid,\n    ore-date-picker,\n    ore-dialog,\n    ore-drawer,\n    ore-file-input,\n    ore-grid,\n    ore-grid-item,\n    ore-icon,\n    ore-input,\n    ore-keyboard-key,\n    ore-keyboard-shortcut,\n    ore-list,\n    ore-list-item,\n    ore-marquee,\n    ore-menu,\n    ore-menu-item,\n    ore-menu-separator,\n    ore-message-composer,\n    ore-navbar,\n    ore-navbar-item,\n    ore-navigation-menu,\n    ore-navigation-menu-item,\n    ore-navigation-menu-panel,\n    ore-number-input,\n    ore-otp-input,\n    ore-pagination,\n    ore-password-strength,\n    ore-popover,\n    ore-progress,\n    ore-qr-code,\n    ore-qr-scanner,\n    ore-query-bar,\n    ore-radio,\n    ore-radio-group,\n    ore-rating,\n    ore-select,\n    ore-separator,\n    ore-sidebar,\n    ore-sidebar-group,\n    ore-sidebar-item,\n    ore-skeleton,\n    ore-slider,\n    ore-speech-player,\n    ore-speed-reading,\n    ore-spotlight,\n    ore-stats,\n    ore-step,\n    ore-stepper,\n    ore-switch,\n    ore-tab-item,\n    ore-tab-panel,\n    ore-table,\n    ore-tabs,\n    ore-td,\n    ore-text,\n    ore-th,\n    ore-tr,\n    ore-textarea,\n    ore-time-picker,\n    ore-toast,\n    ore-tooltip,\n    ore-tour,\n    ore-typing-indicator,\n  ]\nenvironments: [browser]\n---\n\n<!-- markdownlint-disable MD025 MD033 MD060 -->\n\n<PackageHero package=\"refine\" />\n\n## Why Refine?\n\nEvery project needs UI primitives. Refine provides accessible web components that work natively anywhere HTML is rendered, no framework required.\n\n```html\n<!-- Before: roll your own button with ARIA -->\n<button class=\"btn btn-primary\" role=\"button\" aria-pressed=\"false\" tabindex=\"0\">\n  <span class=\"btn-spinner\" aria-hidden=\"true\"></span>\n  Save\n</button>\n\n<!-- After: Refine -->\n<ore-button variant=\"solid\" color=\"primary\" loading>Save</ore-button>\n```\n\n| Feature            | Refine                                       | Shoelace                                   | Material Web                               |\n| ------------------ | ------------------------------------------- | ------------------------------------------ | ------------------------------------------ |\n| Bundle size        | <PackageInfo package=\"refine\" type=\"size\" /> | ~145 kB                                    | ~200 kB                                    |\n| Built with         | Ore                                       | Lit                                        | Lit                                        |\n| Runtime dependencies | Vielzeug UI primitives; Lucide only for the opt-in full-library registrar | Lit + utilities | Lit + Material foundations |\n| Accessible         | WCAG AA                                     | WCAG AA                                    | WCAG AA                                    |\n| Framework agnostic | <ore-icon name=\"check\" size=\"16\"></ore-icon>  | <ore-icon name=\"check\" size=\"16\"></ore-icon> | <ore-icon name=\"check\" size=\"16\"></ore-icon> |\n\n<div class=\"decision-callout\">\n\n**Use Refine when** you want accessible web components that match the Vielzeug design system without a heavy framework dependency.\n\n**Consider Shoelace or Material Web** if your team is already standardized on those ecosystems and you need their established component catalogs.\n\n</div>\n\n## Installation\n\n::: code-group\n\n```sh [pnpm]\npnpm add @vielzeug/refine\n```\n\n```sh [npm]\nnpm install @vielzeug/refine\n```\n\n```sh [yarn]\nyarn add @vielzeug/refine\n```\n\n:::\n\n## Quick Start\n\n```ts\n// 1. Import global styles once\nimport '@vielzeug/refine/fouc.css';   // Hide unupgraded custom elements until first paint\nimport '@vielzeug/refine/tokens.css'; // Tokens, animations, cascade layers\n\n// 2. Register only the elements you need\nimport '@vielzeug/refine/button';\nimport '@vielzeug/refine/input';\nimport '@vielzeug/refine/card';\n```\n\n```html\n<ore-button variant=\"solid\" color=\"primary\">Save</ore-button>\n<ore-input label=\"Email\" type=\"email\" required></ore-input>\n<ore-card padding=\"lg\">\n  <span slot=\"header\">Account</span>\n  <p>Card content goes here.</p>\n</ore-card>\n```\n\n```ts\n```\n\n### CDN / Vanilla HTML\n\nUse the self-contained IIFE bundle to load Refine directly from a CDN in any HTML page: no build step required:\n\n```html\n<!-- 1. Styles -->\n<link rel=\"stylesheet\" href=\"https://unpkg.com/@vielzeug/refine/dist/styles/fouc.css\" />\n<link rel=\"stylesheet\" href=\"https://unpkg.com/@vielzeug/refine/dist/styles/tokens.css\" />\n\n<!-- 2. All components (IIFE: registers global Refine namespace) -->\n<script src=\"https://unpkg.com/@vielzeug/refine/dist/refine.iife.js\"></script>\n```\n\nFor bundler-based projects that still want a CDN URL, use the ESM bundle via an import map:\n\n```html\n<script type=\"importmap\">\n  {\n    \"imports\": {\n      \"@vielzeug/refine\": \"https://esm.sh/@vielzeug/refine\",\n      \"@vielzeug/refine/button\": \"https://esm.sh/@vielzeug/refine/button\",\n      \"@vielzeug/refine/input\": \"https://esm.sh/@vielzeug/refine/input\"\n    }\n  }\n</script>\n\n<script type=\"module\">\n  import '@vielzeug/refine/button';\n  import '@vielzeug/refine/input';\n</script>\n```\n\n### Package Entry Points\n\n| Import                   | Purpose                                   |\n| ------------------------ | ----------------------------------------- |\n| `@vielzeug/refine/fouc.css` | FOUC suppression for unupgraded custom elements |\n| `@vielzeug/refine/tokens.css` | Global design tokens and cascade layers |\n| `@vielzeug/refine/styles/preflight.css` | Optional browser-default reset (includes FOUC suppression) |\n\nComponent registration happens through side-effect imports such as `@vielzeug/refine/button` and `@vielzeug/refine/dialog`.\n\n### Components\n\n**Content:** `ore-avatar`, `ore-avatar-group`, `ore-breadcrumb`, `ore-card`, `ore-carousel`, `ore-carousel-slide`, `ore-chat-message`, `ore-icon`, `ore-keyboard-key`, `ore-keyboard-shortcut`, `ore-list`, `ore-list-item`, `ore-marquee`, `ore-pagination`, `ore-qr-code`, `ore-separator`, `ore-speed-reading`, `ore-stats`, `ore-step`, `ore-stepper`, `ore-table`, `ore-text`\n\n**Disclosure:** `ore-accordion`, `ore-accordion-item`, `ore-tabs`, `ore-tab-item`, `ore-tab-panel`\n\n**Feedback:** `ore-alert`, `ore-async`, `ore-badge`, `ore-chip`, `ore-cookie-banner`, `ore-password-strength`, `ore-progress`, `ore-skeleton`, `ore-toast`, `ore-typing-indicator`\n\n**Inputs:** `ore-button`, `ore-button-group`, `ore-calendar`, `ore-checkbox`, `ore-checkbox-group`, `ore-column`, `ore-combobox`, `ore-counter`, `ore-datagrid`, `ore-date-picker`, `ore-file-input`, `ore-input`, `ore-message-composer`, `ore-number-input`, `ore-otp-input`, `ore-qr-scanner`, `ore-query-bar`, `ore-radio`, `ore-radio-group`, `ore-rating`, `ore-select`, `ore-slider`, `ore-switch`, `ore-textarea`, `ore-time-picker`\n\n**Layout:** `ore-box`, `ore-grid`, `ore-grid-item`, `ore-navbar`, `ore-sidebar`\n\n**Overlay:** `ore-command-palette`, `ore-command-palette-item`, `ore-dialog`, `ore-drawer`, `ore-menu`, `ore-popover`, `ore-spotlight`, `ore-tooltip`, `ore-tour`\n\n## Component portfolio\n\nRefine keeps one public package and classifies components by composition level rather than stability. All listed components remain supported and tested.\n\n- **Foundations**: buttons, inputs, selection controls, disclosure, dialogs, menus, tooltips, layout primitives, and feedback indicators. Start here when building an application-specific interface.\n- **Composed patterns**: data grids, command palettes, navigation menus, steppers, calendars, date/time pickers, file inputs, and message composers. These package recurring accessibility and interaction behavior that is costly to rebuild correctly.\n- **Presentation patterns**: cards, chat messages, code windows, stats, marquees, avatars, badges, and skeletons. Use these when their product vocabulary matches the application; prefer foundations when it does not.\n\nClassification guides discovery and bundle selection. It is not a reason to remove working components or move them into unstable packages; per-component subpath imports remain the tree-shaking boundary.\n\n## Features\n\n<div class=\"features-grid\">\n\n- **Accessible**: keyboard navigation, ARIA wiring, and focus management across interactive components\n- **Themeable**: global tokens plus component-level CSS custom properties\n- **Framework agnostic**: works anywhere HTML can be rendered\n- **Tree-shakeable**: import only the component entry points you register\n- **Comprehensive surface**: inputs, content, disclosure, feedback, layout, and overlay primitives\n- **Native form integration**: form-associated controls submit values, validate supported required constraints, and reset with their form\n- **Typed framework declarations**: DOM, React, and Vue tags derive from the component property contracts\n\n</div>\n\n### Prerequisites\n\n- Browser runtime with Custom Elements support.\n- Import `@vielzeug/refine/fouc.css` and `@vielzeug/refine/tokens.css` before rendering components.\n- For SSR, render placeholders server-side and hydrate components only on the client.\n\n## Documentation\n\n<div class=\"doc-links\">\n\n- [Usage Guide](./usage.md)\n- [API Reference](./api.md)\n- [Migration Guide](./migration.md)\n\n</div>\n\n## See Also\n\n<div class=\"see-also\">\n\n- [Ore](/ore/): Web component runtime that powers Refine\n- [Orbit](/orbit/): Floating UI positioning used in Refine's overlays\n- [Forge](/forge/): Form state management for use with Refine inputs\n- [Keymap](/keymap/): Keyboard shortcut manager that powers the command palette's global trigger\n\n</div>\n\n<!-- markdownlint-enable MD025 MD033 MD060 -->\n",
     "api": "---\ntitle: 'Refine: API Reference'\ndescription: Published component, stylesheet, framework type, and error entry points for @vielzeug/refine.\n---\n\n[[toc]]\n\n## API Overview\n\n| Symbol | Purpose | Execution mode | Common gotcha |\n| --- | --- | --- | --- |\n| `@vielzeug/refine/<component>` | Register one custom element and export its public types | Sync | Importing a type alone does not register the element |\n| `@vielzeug/refine/tokens.css` | Load required theme tokens, animations, and cascade layers | CSS | Import once before components render |\n| `@vielzeug/refine/fouc.css` | Hide unregistered `ore-*` elements until upgrade | CSS | Load before first paint |\n| `@vielzeug/refine/styles/preflight.css` | Apply the optional browser reset | CSS | The reset affects global elements |\n| `@vielzeug/refine/frameworks/elements` | Register typed DOM tag mappings | Types only | Import for side effects in TypeScript |\n| `@vielzeug/refine/frameworks/react` | Register typed React JSX elements | Types only | Does not provide runtime wrappers |\n| `@vielzeug/refine/frameworks/vue` | Register typed Vue global components | Types only | Does not install a Vue plugin |\n| `@vielzeug/refine/theme` | `createThemeController()`: light/dark/system document theme | Sync | Does not persist the preference or set an accent color |\n| `eventFieldValue()` / `eventFieldChecked()` | Read a form control's value/checked from `event.currentTarget` | Sync | Exported from the package root; guards non-field targets |\n| `RefineError` | Base class for package-defined public errors | Sync | Component configuration warnings do not throw this error |\n\n## Package Entry Point\n\n| Import | Purpose |\n| --- | --- |\n| `@vielzeug/refine` | Export `registerIcons`, icon definition types, `RefineError`, and the field readers without registering components |\n| `@vielzeug/refine/<component>` | Register one component and export its tag constant, props, events, and related types |\n| `@vielzeug/refine/theme` | `createThemeController()` and its theme types |\n| `@vielzeug/refine/tokens.css` | Required global design contract |\n| `@vielzeug/refine/fouc.css` | Optional pre-upgrade visibility rule |\n| `@vielzeug/refine/styles/*` | Focused theme, animation, layer, and preflight stylesheets |\n| `@vielzeug/refine/frameworks/*` | TypeScript augmentations for DOM, React, and Vue |\n\n## Icon Registration and Adapters\n\n`registerIcons(icons: Readonly<Record<string, IconDefinition>>): void` is available from `@vielzeug/refine/icons`, `@vielzeug/refine`, and `@vielzeug/refine/icon`. The common `icons` entry and root remain free of component registration side effects.\n\n`IconDefinition`, `IconElement`, and `IconAttributes` are exported from all three entries. Shared definition and registration modules live in `src/icons/`, alongside adapters and internal SVG helpers/defaults. Definitions contain a numeric `viewBox` tuple, optional presentation attributes, and recursive SVG children; they do not require a provider identity. Invalid registrations throw the root-exported `RefineError` atomically.\n\n| Entry | Export | Purpose |\n| --- | --- | --- |\n| `@vielzeug/refine/icons` | `registerIcons`, `IconDefinition`, `IconElement`, `IconAttributes` | Common library-neutral registration and definition API |\n| `@vielzeug/refine/icons/lucide` | `lucideIcons`, `LucideIconData` | Pure adapter for selected structural Lucide SVG data |\n| `@vielzeug/refine/icons/lucide/all` | Side-effect registration | Explicitly register the full installed Lucide library |\n| `@vielzeug/refine/icons/heroicons` | `heroiconsIcons`, `IconifyIcon` | Convert a caller-named map of individual Heroicons Iconify data |\n| `@vielzeug/refine/icons/tabler` | `tablerIcons`, `IconifyIcon` | Convert a caller-named map of individual Tabler Iconify data |\n| `@vielzeug/refine/icons/mdi` | `mdiIcons`, `IconifyIcon` | Convert a caller-named map of individual MDI Iconify data |\n| `@vielzeug/refine/icons/iconify` | `iconifyIcon`, `iconifyIcons` | Convert individual Iconify data or selected/complete collections |\n| `@vielzeug/refine/icons/iconify` | `IconifyIcon`, `IconifyAlias`, `IconifyCollection`, `IconifyTransform` | Structural data types; no Iconify dependency required |\n\nLucide is an optional peer, not a mandatory dependency. Only `icons/lucide/all` requires an installed `lucide` package; consumers selecting that entry declare it themselves. The structural `icons/lucide` adapter accepts supplied data without importing Lucide.\n\nThe standalone IIFE exposes `registerIcons`, `lucideIcons`, `heroiconsIcons`, `tablerIcons`, `mdiIcons`, `iconifyIcon`, and `iconifyIcons` under `Refine.components.content`. Neither the IIFE nor component entries import Lucide. Iconify conversion drops provider `class` metadata, validates finite numeric offsets and positive finite dimensions before transforms, and retains the strict SVG allowlist. See the [icon reference](./components/icon.md) for presentation overrides, local SVG ID rewriting, supported families, and licenses.\n\nThe three family adapters share this signature:\n\n```ts\nheroiconsIcons(icons: Readonly<Record<string, IconifyIcon>>): Record<string, IconDefinition>;\ntablerIcons(icons: Readonly<Record<string, IconifyIcon>>): Record<string, IconDefinition>;\nmdiIcons(icons: Readonly<Record<string, IconifyIcon>>): Record<string, IconDefinition>;\n```\n\nEach accepts individual Iconify SVG data, preserves input keys without adding a namespace, and returns definitions without registering them. They require `DOMParser`, preserve each icon's geometry/presentation/transforms, and throw `RefineError` for invalid Iconify data. They do not accept React/Vue components, collection JSON, or raw SVG path strings. Use `iconifyIcons(collection, names?)` for collections and alias resolution.\n\n## Styles\n\n```ts\nimport '@vielzeug/refine/fouc.css';\nimport '@vielzeug/refine/tokens.css';\nimport '@vielzeug/refine/styles/preflight.css';\n```\n\n`tokens.css` is required. It defines tokens, animations, and cascade-layer order without resetting global elements. `preflight.css` is optional and includes FOUC suppression.\n\n| Import path | Purpose |\n| --- | --- |\n| `@vielzeug/refine/fouc.css` | FOUC suppression for unupgraded custom elements |\n| `@vielzeug/refine/tokens.css` | Tokens, animation helpers, and cascade layers |\n| `@vielzeug/refine/styles/theme.css` | Theme token declarations |\n| `@vielzeug/refine/styles/animation.css` | Animation helpers |\n| `@vielzeug/refine/styles/layers.css` | Cascade layer declarations |\n| `@vielzeug/refine/styles/preflight.css` | Optional browser reset and FOUC suppression |\n\n## Components\n\nEach component uses one registration and type entry point:\n\n```ts\nimport '@vielzeug/refine/button';\nimport type { OreButtonProps } from '@vielzeug/refine/button';\n```\n\n| Area | Components |\n| --- | --- |\n| Content | `avatar`, `avatar-group`, `breadcrumb`, `card`, `carousel`, `chat-message`, `code-window`, `copy-command`, `icon`, `keyboard-key`, `list`, `list-item`, `marquee`, `pagination`, `separator`, `speech-player`, `speed-reading`, `stats`, `step`, `stepper`, `table`, `text` |\n| Disclosure | `accordion`, `accordion-item`, `tabs`, `tab-item`, `tab-panel` |\n| Feedback | `alert`, `async`, `badge`, `chip`, `cookie-banner`, `password-strength`, `progress`, `skeleton`, `toast`, `typing-indicator` |\n| Inputs | `button`, `button-group`, `calendar`, `checkbox`, `checkbox-group`, `combobox`, `counter`, `datagrid`, `date-picker`, `file-input`, `input`, `message-composer`, `number-input`, `otp-input`, `query-bar`, `radio`, `radio-group`, `rating`, `select`, `slider`, `switch`, `textarea`, `time-picker` |\n| Layout | `box`, `grid`, `grid-item`, `navbar`, `sidebar` |\n| Overlays | `command-palette`, `dialog`, `drawer`, `menu`, `navigation-menu`, `popover`, `tooltip` |\n\nEach component page lists its attributes, JavaScript properties, events, slots, parts, and CSS custom properties.\n\nThe [`query-bar`](./components/query-bar.md) entry also exports `QueryState`, `QueryTokenDef`, `QueryQuickFilter`, `QueryBarLabels`, and pure grammar helpers. Vocabulary entries default to single selection; `selection: 'multiple'` allows distinct values for the same key. `anyLabel` customizes the unrestricted single-selection choice, such as “Default order” for sorting. Options accept an optional `icon` (registered `ore-icon` name), displayed beside their labels in the drawer. `tokenValues(state, key)` reads all values, `removeToken(state, token)` removes an exact pair, and `clearTokens(state, key)` clears a group. Its unified field contains applied filters, with a compact secondary row for filter entry, quick toggles, and a `toolbar-end` slot for application content such as a result count. Drawer selection uses the same state and vocabulary as typed suggestions. Pending edits block incidental backdrop/swipe dismissal; explicit Cancel, Close, and Escape discard them. Search-hidden selections remain visible in a summary.\n\n## Framework Types\n\n```ts\nimport type {} from '@vielzeug/refine/frameworks/elements';\nimport type {} from '@vielzeug/refine/frameworks/react';\nimport type {} from '@vielzeug/refine/frameworks/vue';\n```\n\nThe declarations cover every supported tag and derive component properties from Refine's authoritative `HTMLElementTagNameMap`. They provide types only; component registration still uses component subpaths.\n\n## Events and Form Controls\n\nForm controls expose `.value` or `.checked` and dispatch standard `input` and `change` events. Read the property from `event.currentTarget`.\n\nFinite-choice properties use Ore's `prop.oneOf()` parsing: values outside a component's documented options resolve to\nthe declared default, or `undefined` when no default is declared.\n\nForm-associated controls participate in native form submission, validity checks, and reset. A named control's value\nis available through `new FormData(form)`, and supported `required` constraints affect `form.checkValidity()`,\n`form.reportValidity()`, and submit blocking. The `error` property renders and announces feedback; it does not by\nitself set native constraint validity.\n\nStateful overlays expose controlled `open`, optional `default-open`, and an `open-change` custom event with `{ open, reason }` detail. Component pages define additional detail fields and reasons.\n\n## Utilities\n\n### `createThemeController(options?)`\n\n```ts\nimport { createThemeController } from '@vielzeug/refine/theme';\n\nconst theme = createThemeController(); // starts in 'system' mode\ntheme.setPreference('dark');\ntheme.dispose();\n```\n\nOwns the light/dark/system theme for the document: a reactive `preference` signal, the effective `resolved` mode (`'dark' | 'light'` after resolving `system` against the OS), and the DOM application `styles/theme.css` expects: the `.dark` class plus the `color-scheme` property on the root element, so every `light-dark()` token resolves to the right branch. While in `system` mode the controller tracks the OS `prefers-color-scheme` via sentinel's `createMediaQuery`.\n\nThe controller does **not** persist the preference or expose an accent color: those are consumer concerns (wire `watch(controller.preference, save)` for persistence; set `--color-primary-hue` yourself). Options: `initial` (starting preference, default `'system'`), `root` (element carrying the classes, default `document.documentElement`), `target` (window whose `matchMedia` backs `system`). The handle is disposable: `dispose()`, `disposed`, `disposalSignal`, `[Symbol.dispose]`.\n\n### `eventFieldValue(event)` / `eventFieldChecked(event)`\n\n```ts\nimport { eventFieldChecked, eventFieldValue } from '@vielzeug/refine';\n\ninput.addEventListener('input', (event) => {\n  const value = eventFieldValue(event); // string | undefined: never a blind cast\n});\n```\n\nGuarded readers for the standard `input`/`change` event pattern above: they read `value`/`checked` from `event.currentTarget` only when the target actually carries it, so a handler wired to the wrong element yields `undefined`/`false` instead of a crash or a lie. Exported from the package root, which registers no components.\n\n## Types\n\nComponent props follow the `Ore<Component>Props` naming pattern. Event maps follow `Ore<Component>Events`. Import both from the component subpath that owns them.\n\n`RefineElementMap`, `RefineReactIntrinsicElements`, and `RefineVueGlobalComponents` are exported from their respective `frameworks/*` type entry points.\n\n## Errors\n\n### `RefineError`\n\n```ts\nclass RefineError extends Error {\n  constructor(message: string, opts?: ErrorOptions);\n}\n```\n\nBase class for public Refine errors. It preserves `cause` through `ErrorOptions`.\n",
@@ -13,6 +13,10 @@
     "IconElement": "export type { IconAttributes, IconDefinition, IconElement } from './icons';",
     "registerIcons": "export { registerIcons } from './icons';",
     "eventFieldChecked": "export { eventFieldChecked, eventFieldValue } from './inputs/shared/native-field-event';",
-    "eventFieldValue": "export { eventFieldChecked, eventFieldValue } from './inputs/shared/native-field-event';"
+    "eventFieldValue": "export { eventFieldChecked, eventFieldValue } from './inputs/shared/native-field-event';",
+    "getMotionMode": "export { getMotionMode, MOTION_MODES, type MotionMode, setMotionMode } from './motion';",
+    "MOTION_MODES": "export { getMotionMode, MOTION_MODES, type MotionMode, setMotionMode } from './motion';",
+    "MotionMode": "export { getMotionMode, MOTION_MODES, type MotionMode, setMotionMode } from './motion';",
+    "setMotionMode": "export { getMotionMode, MOTION_MODES, type MotionMode, setMotionMode } from './motion';"
   }
 }

package/data/refine.json

@@ -33,6 +33,43 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "MOTION_MODES",
+    "type": {
+      "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."
+  },
+  {
+    "kind": "function",
+    "name": "getMotionMode",
+    "return": {
+      "type": {
+        "text": "MotionMode"
+      }
+    },
+    "description": "Reads the current motion mode from `<html>`; `'system'` when unset."
+  },
+  {
+    "kind": "function",
+    "name": "setMotionMode",
+    "return": {
+      "type": {
+        "text": "MotionMode"
+      }
+    },
+    "parameters": [
+      {
+        "name": "mode",
+        "type": {
+          "text": "MotionMode"
+        }
+      }
+    ],
+    "description": "Sets the app-level motion mode by writing (or removing, for `'system'`)\nthe `data-motion` attribute on `<html>`. Returns the applied mode so\ncallers can round-trip a value they don't control."
+  },
   {
     "kind": "variable",
     "name": "components",
@@ -850,6 +887,49 @@
       }
     ]
   },
+  {
+    "kind": "function",
+    "name": "applyTruncationReveal",
+    "return": {
+      "type": {
+        "text": "TruncationRevealHandle"
+      }
+    },
+    "parameters": [
+      {
+        "name": "el",
+        "type": {
+          "text": "HTMLElement"
+        }
+      },
+      {
+        "name": "options",
+        "default": "{}",
+        "type": {
+          "text": "{ bothAxes?: boolean; slot?: HTMLSlotElement | null }"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "truncationRevealRef",
+    "return": {
+      "type": {
+        "text": "((el: HTMLElement | null) => void)"
+      }
+    },
+    "parameters": [
+      {
+        "name": "options",
+        "default": "{}",
+        "type": {
+          "text": "{ bothAxes?: boolean }"
+        }
+      }
+    ],
+    "description": "An ore `ref` callback that applies applyTruncationReveal when the label\nmounts and detaches it when the label unmounts. Prefer this for a label inside\na conditionally rendered template: ore re-invokes the callback with the new\nelement (and `null` for the old one) whenever that branch re-renders, so the\nreveal can never be left pointing at a detached node. The handle is tracked\nlocally rather than via `onCleanup`, because a re-render can fire the callback\noutside the setup context where `onCleanup` is unavailable.\n\nThe label's own `<slot>` child is used automatically."
+  },
   {
     "kind": "function",
     "name": "mapIconifyIcons",
@@ -1180,6 +1260,48 @@
     ],
     "description": "The container width to test against a breakpoint, falling back to the element itself."
   },
+  {
+    "kind": "function",
+    "name": "createLayoutMotion",
+    "return": {
+      "type": {
+        "text": "LayoutMotion"
+      }
+    },
+    "parameters": [
+      {
+        "name": "host",
+        "type": {
+          "text": "HTMLElement"
+        },
+        "description": "The element whose computed style carries the timing tokens\n(usually the component host; its shadow root holds the tracked elements)."
+      },
+      {
+        "name": "signal",
+        "type": {
+          "text": "AbortSignal"
+        },
+        "description": "Lifecycle signal: disposing it cancels in-flight animations."
+      },
+      {
+        "name": "options",
+        "type": {
+          "text": "LayoutMotionOptions"
+        }
+      }
+    ],
+    "description": "Builds a reflow-motion helper for one host element."
+  },
+  {
+    "kind": "function",
+    "name": "motionReduced",
+    "return": {
+      "type": {
+        "text": "boolean"
+      }
+    },
+    "description": "Point-in-time check for the two components whose JavaScript *starts* motion\n(the rating's sparkle burst, the drawer's swipe-close snap) and therefore\ncannot rely on the CSS layer alone: a spawned animation with a zeroed\nduration still runs its lifecycle (and its DOM nodes still accumulate), and\nan inline `style.transition` set from a gesture bypasses every token.\n\nEverything else reduces through CSS: `--duration-*`/`--transition-*` zero out\nand the `--_motion-*` hatches switch declarations off at `:root`, which is\nalso why components must never write their own\n`@media (prefers-reduced-motion)` block - it would ignore `data-motion='full'`.\n\nDelegates the three-state resolution to necromancer's `shouldReduceMotion`,\nthe same rule `theme.css` implements in CSS."
+  },
   {
     "kind": "variable",
     "name": "themableBundle",
@@ -3207,8 +3329,8 @@
         "type": {
           "text": "boolean"
         },
-        "description": "Pause while hovered (default: false)",
-        "default": "false"
+        "description": "Pause while hovered or focused (default: true; set false to keep scrolling)",
+        "default": "true; set false to keep scrolling"
       },
       {
         "name": "show-controls",
@@ -4893,6 +5015,27 @@
         },
         "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": {
@@ -4908,6 +5051,15 @@
         "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": "",
@@ -4939,7 +5091,7 @@
     "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```"
+        "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```"
       }
     ]
   },
@@ -6679,6 +6831,15 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "TOAST_STATUSES",
+    "type": {
+      "text": "['neutral', 'info', 'success', 'warning', 'danger']"
+    },
+    "default": "['neutral', 'info', 'success', 'warning', 'danger']",
+    "description": "Notification severity. Drives the status icon, the accent color, and the\ndefault screen-reader urgency; it never fills the surface, which stays a\nneutral light/dark card so a stack of notifications stays calm and legible."
+  },
   {
     "kind": "variable",
     "name": "id"
@@ -6743,7 +6904,23 @@
       },
       {
         "name": "--toast-bg",
-        "description": "Opaque surface for flat/bordered notifications."
+        "description": "Neutral notification surface (default the elevated contrast surface)."
+      },
+      {
+        "name": "--toast-color",
+        "description": "Notification text color."
+      },
+      {
+        "name": "--toast-border-color",
+        "description": "Notification border."
+      },
+      {
+        "name": "--toast-icon-size",
+        "description": "Status icon size (default --size-5)."
+      },
+      {
+        "name": "--toast-avatar-size",
+        "description": "Leading avatar diameter (default --size-8)."
       },
       {
         "name": "--toast-shadow",
@@ -6883,6 +7060,15 @@
     "default": "['shine', 'rainbow']",
     "description": "Animated border effect for ore-button."
   },
+  {
+    "kind": "variable",
+    "name": "BUTTON_EMPHASIS",
+    "type": {
+      "text": "['normal', 'primary', 'cancel', 'destructive']"
+    },
+    "default": "['normal', 'primary', 'cancel', 'destructive']",
+    "description": "Semantic role of a button's action, following the four-role model Apple's\nHuman Interface Guidelines use for buttons: Normal, Primary, Cancel,\nDestructive. The role picks the treatment, so prominence stops being a\nstyling accident:\n\n- `primary` — the action most people will choose: accent fill (solid).\n- `cancel` — dismiss without changing anything: neutral ghost.\n- `destructive` — deletes or is otherwise hard to undo: error ink with no\n  filled background (HIG's destructive treatment is red text, not a red\n  slab; a filled error button can be mistaken for a primary action).\n- `normal` — the default treatment, unchanged from no emphasis at all.\n\nAn explicit `color`/`variant` attribute always wins over the mapping, so\n`emphasis` is a shortcut, not a lock-in."
+  },
   {
     "kind": "variable",
     "name": "BUTTON_TAG",
@@ -6956,6 +7142,20 @@
         },
         "description": "Animated border effect: 'shine' | 'rainbow'"
       },
+      {
+        "name": "emphasis",
+        "type": {
+          "text": "'normal' | 'primary' | 'cancel' | 'destructive'"
+        },
+        "description": "Semantic role: 'normal' | 'primary' | 'cancel' | 'destructive' (explicit color/variant wins)"
+      },
+      {
+        "name": "elevation",
+        "type": {
+          "text": "number"
+        },
+        "description": "Resting shadow depth: 0-5 (flat at rest when omitted)"
+      },
       {
         "name": "icon-only",
         "type": {
@@ -7048,6 +7248,10 @@
         "name": "--button-font-size",
         "description": "Font size override"
       },
+      {
+        "name": "--button-min-height",
+        "description": "Minimum height override (defaults to the 44px touch target)"
+      },
       {
         "name": "--button-frost-active-bg",
         "description": "Background when pressed (frost variant)"
@@ -7055,12 +7259,20 @@
       {
         "name": "--button-frost-active-border-color",
         "description": "Border color when pressed (frost variant)"
+      },
+      {
+        "name": "--button-shadow",
+        "description": "Resting shadow for an elevated button (default: the color family's halo)"
+      },
+      {
+        "name": "--button-shadow-contact",
+        "description": "Neutral contact shadow layered under --button-shadow"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-button variant=\"solid\" color=\"primary\">Click me</ore-button>\n<ore-button loading color=\"success\">Processing...</ore-button>\n<ore-button effect=\"shine\" color=\"primary\">Shine</ore-button>\n<ore-button effect=\"rainbow\" variant=\"frost\">Rainbow</ore-button>\n```"
+        "description": "```html\n<ore-button variant=\"solid\" color=\"primary\">Click me</ore-button>\n<ore-button loading color=\"success\">Processing...</ore-button>\n<ore-button effect=\"shine\" color=\"primary\">Shine</ore-button>\n<ore-button effect=\"rainbow\" variant=\"frost\">Rainbow</ore-button>\n<ore-button elevation=\"1\" emphasis=\"primary\">CTA</ore-button>\n```"
       }
     ]
   },
@@ -7247,8 +7459,8 @@
         "description": "Colour of today's date number"
       },
       {
-        "name": "--calendar-day-outside-opacity",
-        "description": "Opacity of days outside visible month"
+        "name": "--calendar-day-outside-color",
+        "description": "Colour of day numbers outside the visible month"
       }
     ],
     "demos": [
@@ -8083,6 +8295,32 @@
     ],
     "description": "Feature-owned state and transform pipeline for `ore-datagrid`.\n\nRows flow through the active view, query, filters, sorting, and pagination in order. Selection\nand column visibility share the same model so every interactive grid concern\nhas one reactive owner. Source-backed grids retain their server-owned rows by\nsetting `clientSide` to false."
   },
+  {
+    "kind": "function",
+    "name": "createRowMotion",
+    "return": {
+      "type": {
+        "text": "LayoutMotion"
+      }
+    },
+    "parameters": [
+      {
+        "name": "host",
+        "type": {
+          "text": "HTMLElement"
+        },
+        "description": "The grid host element (its shadow root holds the rows)."
+      },
+      {
+        "name": "signal",
+        "type": {
+          "text": "AbortSignal"
+        },
+        "description": "Lifecycle signal: disposing it cancels in-flight animations."
+      }
+    ],
+    "description": "Builds the grid's row-motion helper."
+  },
   {
     "kind": "function",
     "name": "createGridNav",
@@ -8396,8 +8634,8 @@
         "description": "Color of today's date number"
       },
       {
-        "name": "--date-picker-day-outside-opacity",
-        "description": "Opacity of days outside visible month"
+        "name": "--date-picker-day-outside-color",
+        "description": "Color of day numbers outside the visible month"
       }
     ],
     "demos": [
@@ -11899,14 +12137,14 @@
       "text": "'ore-grid'"
     },
     "default": "'ore-grid'",
-    "description": "ore-grid: Flexible grid layout with responsive column control.\n\nColumns are computed in JS and applied as `--_cols` inline, so they respond\nto the element's own width via ResizeObserver. CSS custom properties\n`--grid-cols`, `--grid-rows`, `--grid-gap`, `--grid-row-gap`, `--grid-col-gap`\nare honoured as fallbacks when no attribute is set."
+    "description": "ore-grid: Flexible grid layout with responsive column control.\n\nThe grid is container-responsive: `cols-*` breakpoints compare against the\nelement's own width (measured with a ResizeObserver), not the viewport, so a\nnarrow grid in a sidebar gets its mobile layout even on a wide screen.\nBreakpoint thresholds come from the `--size-screen-*` tokens. Fixed counts\nresolve through the `--grid-1`–`--grid-12` tokens; the responsive floor uses\n`--grid-min-item-width`. CSS custom properties `--grid-cols`, `--grid-rows`,\n`--grid-gap`, `--grid-row-gap`, `--grid-col-gap` are honoured as fallbacks\nwhen no attribute is set."
   },
   {
     "kind": "class",
     "name": "OreGridElement",
     "tagName": "ore-grid",
     "customElement": true,
-    "description": "ore-grid: Flexible grid layout with responsive column control.\nColumns are computed in JS and applied as `--_cols` inline, so they respond\nto the element's own width via ResizeObserver. CSS custom properties\n`--grid-cols`, `--grid-rows`, `--grid-gap`, `--grid-row-gap`, `--grid-col-gap`\nare honoured as fallbacks when no attribute is set.",
+    "description": "ore-grid: Flexible grid layout with responsive column control.\nThe grid is container-responsive: `cols-*` breakpoints compare against the\nelement's own width (measured with a ResizeObserver), not the viewport, so a\nnarrow grid in a sidebar gets its mobile layout even on a wide screen.\nBreakpoint thresholds come from the `--size-screen-*` tokens. Fixed counts\nresolve through the `--grid-1`–`--grid-12` tokens; the responsive floor uses\n`--grid-min-item-width`. CSS custom properties `--grid-cols`, `--grid-rows`,\n`--grid-gap`, `--grid-row-gap`, `--grid-col-gap` are honoured as fallbacks\nwhen no attribute is set.",
     "summary": "",
     "attributes": [
       {
@@ -11998,8 +12236,8 @@
         "type": {
           "text": "string"
         },
-        "description": "Min column width for responsive mode (default: 250px)",
-        "default": "250px"
+        "description": "Min column width for responsive mode (default: var(--grid-min-item-width))",
+        "default": "var(--grid-min-item-width"
       },
       {
         "name": "fullwidth",
@@ -12062,6 +12300,10 @@
         "name": "--grid-cols",
         "description": "Fallback column template (used when no cols attr is set)"
       },
+      {
+        "name": "--grid-min-item-width",
+        "description": "Floor for auto-fit column width (default: 250px)"
+      },
       {
         "name": "--grid-rows",
         "description": "Fallback row template"
@@ -14359,7 +14601,7 @@
       },
       {
         "name": "--spotlight-transition",
-        "description": "Geometry transition (default: 240ms ease)"
+        "description": "Geometry transition (default: var(--duration-250) var(--ease-spring))"
       }
     ],
     "demos": [
@@ -14413,8 +14655,16 @@
         "type": {
           "text": "number"
         },
-        "description": "Show delay in milliseconds (default: 0)",
-        "default": "0"
+        "description": "Show delay in milliseconds (default: 300 on hover, immediate on focus/click)",
+        "default": "300 on hover, immediate on focus/click"
+      },
+      {
+        "name": "close-delay",
+        "type": {
+          "text": "number"
+        },
+        "description": "Hide delay in milliseconds (default: 100 on pointer leave, immediate on focus out)",
+        "default": "100 on pointer leave, immediate on focus out"
       },
       {
         "name": "open",

package/data/search.json

@@ -1066,7 +1066,7 @@
     "name": "@vielzeug/refine",
     "related": "ore orbit forge keymap",
     "slug": "refine",
-    "source": "/**\n * refine components register through their explicit component entry points.\n *\n * keeping the package root free of registration side effects makes dependency\n * ownership and bundle contents obvious to application code.\n */\n\nexport { refineerror } from './errors';\nexport type { iconattributes, icondefinition, iconelement } from './icons';\nexport { registericons } from './icons';\nexport { eventfieldchecked, eventfieldvalue } from './inputs/shared/native field event';\n"
+    "source": "/**\n * refine components register through their explicit component entry points.\n *\n * keeping the package root free of registration side effects makes dependency\n * ownership and bundle contents obvious to application code.\n */\n\nexport { refineerror } from './errors';\nexport type { iconattributes, icondefinition, iconelement } from './icons';\nexport { registericons } from './icons';\nexport { eventfieldchecked, eventfieldvalue } from './inputs/shared/native field event';\nexport { getmotionmode, motion_modes, type motionmode, setmotionmode } from './motion';\n"
   },
   {
     "category": "state",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vielzeug/codex",
-  "version": "26.10.18",
+  "version": "26.10.20",
   "description": "MCP server exposing all Vielzeug docs to AI clients",
   "repository": {
     "type": "git",
@@ -63,7 +63,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.6.5",
-    "@vielzeug/refine": "26.10.18",
+    "@vielzeug/refine": "26.10.20",
     "typescript": "^6.0.3",
     "vitest": "^5.0.5"
   }