@vielzeug/codex 26.10.21 → 26.11.0

package/data/catalog.json

@@ -35,7 +35,7 @@
         "rune"
       ],
       "slug": "archive",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -108,7 +108,7 @@
         "coins"
       ],
       "slug": "arsenal",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -160,7 +160,7 @@
         "refine"
       ],
       "slug": "assay",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -199,7 +199,7 @@
         "vault"
       ],
       "slug": "beacon",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -241,7 +241,7 @@
         "ward"
       ],
       "slug": "clockwork",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -273,7 +273,7 @@
         "refine"
       ],
       "slug": "codex",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -343,7 +343,7 @@
         "spell"
       ],
       "slug": "coins",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -384,7 +384,7 @@
         "rune"
       ],
       "slug": "conduit",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -426,7 +426,7 @@
         "postmaster"
       ],
       "slug": "courier",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -472,7 +472,7 @@
         "refine"
       ],
       "slug": "dnd",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -514,7 +514,7 @@
         "herald"
       ],
       "slug": "familiar",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -581,7 +581,7 @@
         "courier"
       ],
       "slug": "flux",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -621,7 +621,7 @@
         "ore"
       ],
       "slug": "focus",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -662,7 +662,7 @@
         "assay"
       ],
       "slug": "forge",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -700,7 +700,7 @@
         "keymap"
       ],
       "slug": "gesture",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -744,7 +744,7 @@
         "familiar"
       ],
       "slug": "herald",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -787,7 +787,7 @@
         "tempo"
       ],
       "slug": "illusionist",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -832,7 +832,7 @@
         "ore"
       ],
       "slug": "keymap",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -879,7 +879,7 @@
         "vault"
       ],
       "slug": "ledger",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -925,7 +925,7 @@
         "courier"
       ],
       "slug": "lingua",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -963,7 +963,7 @@
         "herald"
       ],
       "slug": "mesh",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1000,7 +1000,7 @@
         "ore"
       ],
       "slug": "necromancer",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1040,7 +1040,7 @@
         "prism"
       ],
       "slug": "orbit",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1105,7 +1105,7 @@
         "orbit"
       ],
       "slug": "ore",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1149,7 +1149,7 @@
         "ripple"
       ],
       "slug": "postmaster",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1190,7 +1190,7 @@
         "orbit"
       ],
       "slug": "prism",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1254,7 +1254,7 @@
         "clockwork"
       ],
       "slug": "pulse",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1376,7 +1376,7 @@
         "keymap"
       ],
       "slug": "refine",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1421,7 +1421,7 @@
         "ledger"
       ],
       "slug": "ripple",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1475,7 +1475,7 @@
         "familiar"
       ],
       "slug": "rune",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1516,7 +1516,7 @@
         "refine"
       ],
       "slug": "sandbox",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1567,7 +1567,7 @@
         "ripple"
       ],
       "slug": "scout",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1620,7 +1620,7 @@
         "refine"
       ],
       "slug": "scroll",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1667,7 +1667,7 @@
         "gesture"
       ],
       "slug": "sentinel",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1707,7 +1707,7 @@
         "refine"
       ],
       "slug": "sigil",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1752,7 +1752,7 @@
         "wayfinder"
       ],
       "slug": "sourcerer",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1811,7 +1811,7 @@
         "vault"
       ],
       "slug": "spell",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1852,7 +1852,7 @@
         "ripple"
       ],
       "slug": "tandem",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1896,7 +1896,7 @@
         "herald"
       ],
       "slug": "tavern",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -1964,7 +1964,7 @@
         "vault"
       ],
       "slug": "tempo",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -2015,7 +2015,7 @@
         "ripple"
       ],
       "slug": "vault",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -2061,7 +2061,7 @@
         "refine"
       ],
       "slug": "ward",
-      "version": "26.10.20"
+      "version": "26.10.22"
     },
     {
       "availableDocPages": [
@@ -2115,8 +2115,8 @@
         "herald"
       ],
       "slug": "wayfinder",
-      "version": "26.10.20"
+      "version": "26.10.22"
     }
   ],
-  "version": "26.10.20"
+  "version": "26.10.22"
 }

package/data/llms-full.txt

@@ -1,6 +1,6 @@
 # Vielzeug: Full Documentation
 
-> Complete documentation for 43 packages. Version: 26.10.20
+> Complete documentation for 43 packages. Version: 26.10.22
 
 ---
 
@@ -21791,23 +21791,25 @@ Component registration happens through side-effect imports such as `@vielzeug/re
 
 ### Components
 
-**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`
+Each entry below is a component with its own documentation page and registration subpath. Sub-element tags (`ore-accordion-item`, `ore-tab-item`, `ore-avatar-group`, and the rest) are documented on their parent's page and registered with it.
 
-**Disclosure:** `ore-accordion`, `ore-accordion-item`, `ore-tabs`, `ore-tab-item`, `ore-tab-panel`
+**Content:** `ore-accordion`, `ore-avatar`, `ore-card`, `ore-carousel`, `ore-chat-message`, `ore-chat-panel`, `ore-code-window`, `ore-copy-command`, `ore-icon`, `ore-keyboard-key`, `ore-list`, `ore-marquee`, `ore-qr-code`, `ore-rank-list`, `ore-speech-player`, `ore-speed-reading`, `ore-stats`, `ore-table`, `ore-text`
 
 **Feedback:** `ore-alert`, `ore-async`, `ore-badge`, `ore-chip`, `ore-cookie-banner`, `ore-password-strength`, `ore-progress`, `ore-skeleton`, `ore-toast`, `ore-typing-indicator`
 
-**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`
+**Inputs:** `ore-button`, `ore-calendar`, `ore-checkbox`, `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-rating`, `ore-select`, `ore-slider`, `ore-switch`, `ore-textarea`, `ore-time-picker`
 
-**Layout:** `ore-box`, `ore-grid`, `ore-grid-item`, `ore-navbar`, `ore-sidebar`
+**Layout:** `ore-box`, `ore-grid`, `ore-navbar`, `ore-separator`, `ore-sidebar`
 
-**Overlay:** `ore-command-palette`, `ore-command-palette-item`, `ore-dialog`, `ore-drawer`, `ore-menu`, `ore-popover`, `ore-spotlight`, `ore-tooltip`, `ore-tour`
+**Navigation:** `ore-breadcrumb`, `ore-navigation-menu`, `ore-pagination`, `ore-stepper`, `ore-tabs`
+
+**Overlay:** `ore-command-palette`, `ore-dialog`, `ore-drawer`, `ore-menu`, `ore-popover`, `ore-spotlight`, `ore-tooltip`, `ore-tour`
 
 ## Component portfolio
 
 Refine keeps one public package and classifies components by composition level rather than stability. All listed components remain supported and tested.
 
-- **Foundations**: buttons, inputs, selection controls, disclosure, dialogs, menus, tooltips, layout primitives, and feedback indicators. Start here when building an application-specific interface.
+- **Foundations**: buttons, inputs, selection controls, accordions, dialogs, menus, tooltips, layout primitives, and feedback indicators. Start here when building an application-specific interface.
 - **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.
 - **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.
 
@@ -21817,9 +21819,10 @@ Classification guides discovery and bundle selection. It is not a reason to remo
 
 - **Accessible**: keyboard navigation, ARIA wiring, and focus management across interactive components
 - **Themeable**: global tokens plus component-level CSS custom properties
+- **Motion-safe**: every animation routes through duration tokens and honors Motion Mode (`setMotionMode`) with a reduced-motion floor
 - **Framework agnostic**: works anywhere HTML can be rendered
 - **Tree-shakeable**: import only the component entry points you register
-- **Comprehensive surface**: inputs, content, disclosure, feedback, layout, and overlay primitives
+- **Comprehensive surface**: inputs, content, navigation, feedback, layout, and overlay primitives
 - **Native form integration**: form-associated controls submit values, validate supported required constraints, and reset with their form
 - **Typed framework declarations**: DOM, React, and Vue tags derive from the component property contracts
 
@@ -21833,6 +21836,7 @@ Classification guides discovery and bundle selection. It is not a reason to remo
 
 - [Usage Guide](./usage.md)
 - [API Reference](./api.md)
+- [Animation & Motion](./animation.md)
 - [Migration Guide](./migration.md)
 
 ## See Also
@@ -21857,13 +21861,15 @@ Classification guides discovery and bundle selection. It is not a reason to remo
 | `@vielzeug/refine/frameworks/vue` | Register typed Vue global components | Types only | Does not install a Vue plugin |
 | `@vielzeug/refine/theme` | `createThemeController()`: light/dark/system document theme | Sync | Does not persist the preference or set an accent color |
 | `eventFieldValue()` / `eventFieldChecked()` | Read a form control's value/checked from `event.currentTarget` | Sync | Exported from the package root; guards non-field targets |
+| `animateReflow()` | Token-driven FLIP reflow for keyed lists | Async (next frame) | Exported from the package root; elements need stable keys or it correctly does nothing |
+| `setMotionMode()` / `getMotionMode()` | Read/write the `data-motion` attribute on `` | Sync | Exported from the package root; an unknown mode throws `RangeError` |
 | `RefineError` | Base class for package-defined public errors | Sync | Component configuration warnings do not throw this error |
 
 ## Package Entry Point
 
 | Import | Purpose |
 | --- | --- |
-| `@vielzeug/refine` | Export `registerIcons`, icon definition types, `RefineError`, and the field readers without registering components |
+| `@vielzeug/refine` | Export `registerIcons`, icon definition types, `RefineError`, `animateReflow`, the motion-mode functions, and the field readers without registering components |
 | `@vielzeug/refine/` | Register one component and export its tag constant, props, events, and related types |
 | `@vielzeug/refine/theme` | `createThemeController()` and its theme types |
 | `@vielzeug/refine/tokens.css` | Required global design contract |
@@ -21932,12 +21938,14 @@ import type { OreButtonProps } from '@vielzeug/refine/button';
 
 | Area | Components |
 | --- | --- |
-| 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` |
-| Disclosure | `accordion`, `accordion-item`, `tabs`, `tab-item`, `tab-panel` |
+| Content | `accordion`, `avatar`, `card`, `carousel`, `chat-message`, `chat-panel`, `code-window`, `copy-command`, `icon`, `keyboard-key`, `list`, `marquee`, `qr-code`, `rank-list`, `speech-player`, `speed-reading`, `stats`, `table`, `text` |
 | Feedback | `alert`, `async`, `badge`, `chip`, `cookie-banner`, `password-strength`, `progress`, `skeleton`, `toast`, `typing-indicator` |
-| 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` |
-| Layout | `box`, `grid`, `grid-item`, `navbar`, `sidebar` |
-| Overlays | `command-palette`, `dialog`, `drawer`, `menu`, `navigation-menu`, `popover`, `tooltip` |
+| Inputs | `button`, `calendar`, `checkbox`, `combobox`, `counter`, `datagrid`, `date-picker`, `file-input`, `input`, `message-composer`, `number-input`, `otp-input`, `qr-scanner`, `query-bar`, `radio`, `rating`, `select`, `slider`, `switch`, `textarea`, `time-picker` |
+| Layout | `box`, `grid`, `navbar`, `separator`, `sidebar` |
+| Navigation | `breadcrumb`, `navigation-menu`, `pagination`, `stepper`, `tabs` |
+| Overlay | `command-palette`, `dialog`, `drawer`, `menu`, `popover`, `spotlight`, `tooltip`, `tour` |
+
+Each row lists the entry points that own a documentation page. Sub-element entries (`accordion-item`, `tab-item`, `avatar-group`, `list-item`, `step`, and the rest) are documented on their parent's page and share its category.
 
 Each component page lists its attributes, JavaScript properties, events, slots, parts, and CSS custom properties.
 
@@ -21995,12 +22003,54 @@ input.addEventListener('input', (event) => {
 
 Guarded 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.
 
+---
+
+### `animateReflow(host, signal, options)`
+
+```ts
+import { animateReflow } from '@vielzeug/refine';
+
+const reflow = animateReflow(list, abortController.signal, {
+  elements: () => [...list.querySelectorAll('li')],
+  getKey: (item) => item.dataset.id,
+});
+reflow.run(() => renderItems(nextItems));
+```
+
+Token-driven FLIP reflow for keyed lists: captures the current layout, runs `mutate`, then animates the tracked elements into their new positions on the next frame. The same helper the DataGrid, command palette, and toast stack use.
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `host` | `HTMLElement` | Element whose computed style carries the timing tokens |
+| `signal` | `AbortSignal` | Aborting cancels in-flight animations |
+| `options.elements` | `() => HTMLElement[]` | Tracked elements, read live on both sides of the mutation |
+| `options.getKey` | `(el) => string \| undefined` | Stable identity per element; all-or-nothing |
+| `options.durationToken` | `string?` | Duration token, default `'--duration-200'` |
+| `options.easingToken` | `string?` | Easing token, default `'--ease-move'` |
+| `options.stagger` | `number?` | Per-element delay in ms, default `0` |
+
+**Returns** a `Reflow` handle with one method: `run(mutate)` (sync; the animation is fire-and-forget). Timing is read from the tokens at animation time, so Motion Mode reduction skips the reflow instead of playing it instantly. Every path that cannot animate (no elements, missing keys, zeroed tokens, aborted signal, no Web Animations API) still runs `mutate` exactly once and never throws. See [Animation & Motion → List Reflow](./animation#list-reflow-animatereflow) for behavior details.
+
+---
+
+### `setMotionMode(mode)` / `getMotionMode()`
+
+```ts
+import { getMotionMode, setMotionMode } from '@vielzeug/refine';
+
+setMotionMode('reduced'); // returns the applied mode
+```
+
+Read/write the `data-motion` attribute on `` (`'full' | 'reduced' | 'system'`; `'system'` removes the attribute). An unknown mode throws `RangeError`. The attribute drives the token layer: see [Animation & Motion → Motion Mode](./animation#motion-mode).
+
 ## Types
 
 Component props follow the `OreProps` naming pattern. Event maps follow `OreEvents`. Import both from the component subpath that owns them.
 
 `RefineElementMap`, `RefineReactIntrinsicElements`, and `RefineVueGlobalComponents` are exported from their respective `frameworks/*` type entry points.
 
+The package root also exports `Reflow` (the `run()` handle), `ReflowOptions` (its options object), and `MotionMode` (`'full' | 'reduced' | 'system'`).
+
 ## Errors
 
 ### `RefineError`
@@ -22242,6 +22292,10 @@ const loadingEffect = effect(() => {
 loadingEffect.dispose();
 ```
 
+### Necromancer
+
+Use Necromancer directly when you need animation handles, groups, or explicit keyframes. Refine's [`animateReflow`](./animation#list-reflow-animatereflow) is the token-driven wrapper over its FLIP primitive and is enough for keyed lists that reflow.
+
 ## Best Practices
 
 - **Import** `tokens.css` once before rendering components.

package/data/llms.txt

@@ -1,6 +1,6 @@
 # Vielzeug
 
-> 43 focused TypeScript packages. Version: 26.10.20
+> 43 focused TypeScript packages. Version: 26.10.22
 
 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.20"
+  "version": "26.10.22"
 }