@vielzeug/codex 26.10.10 → 26.10.12

package/data/catalog.json

@@ -35,7 +35,7 @@
         "rune"
       ],
       "slug": "archive",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -108,7 +108,7 @@
         "coins"
       ],
       "slug": "arsenal",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -160,7 +160,7 @@
         "refine"
       ],
       "slug": "assay",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -202,7 +202,7 @@
         "ward"
       ],
       "slug": "clockwork",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -234,7 +234,7 @@
         "refine"
       ],
       "slug": "codex",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -304,7 +304,7 @@
         "spell"
       ],
       "slug": "coins",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -345,7 +345,7 @@
         "rune"
       ],
       "slug": "conduit",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -387,7 +387,7 @@
         "postmaster"
       ],
       "slug": "courier",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -433,7 +433,7 @@
         "refine"
       ],
       "slug": "dnd",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -475,7 +475,7 @@
         "herald"
       ],
       "slug": "familiar",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -542,7 +542,7 @@
         "courier"
       ],
       "slug": "flux",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -582,7 +582,7 @@
         "ore"
       ],
       "slug": "focus",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -623,7 +623,7 @@
         "assay"
       ],
       "slug": "forge",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -661,7 +661,7 @@
         "keymap"
       ],
       "slug": "gesture",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -705,7 +705,7 @@
         "familiar"
       ],
       "slug": "herald",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -748,7 +748,7 @@
         "tempo"
       ],
       "slug": "illusionist",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -793,7 +793,7 @@
         "ore"
       ],
       "slug": "keymap",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -840,7 +840,7 @@
         "vault"
       ],
       "slug": "ledger",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -886,7 +886,7 @@
         "courier"
       ],
       "slug": "lingua",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -924,7 +924,7 @@
         "herald"
       ],
       "slug": "mesh",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -961,7 +961,7 @@
         "ore"
       ],
       "slug": "necromancer",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1001,7 +1001,7 @@
         "prism"
       ],
       "slug": "orbit",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1066,7 +1066,7 @@
         "orbit"
       ],
       "slug": "ore",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1110,7 +1110,7 @@
         "ripple"
       ],
       "slug": "postmaster",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1150,7 +1150,7 @@
         "orbit"
       ],
       "slug": "prism",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1214,7 +1214,7 @@
         "clockwork"
       ],
       "slug": "pulse",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1333,7 +1333,7 @@
         "keymap"
       ],
       "slug": "refine",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1378,7 +1378,7 @@
         "ledger"
       ],
       "slug": "ripple",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1432,7 +1432,7 @@
         "familiar"
       ],
       "slug": "rune",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1473,7 +1473,7 @@
         "refine"
       ],
       "slug": "sandbox",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1524,7 +1524,7 @@
         "ripple"
       ],
       "slug": "scout",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1577,7 +1577,7 @@
         "refine"
       ],
       "slug": "scroll",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1624,7 +1624,7 @@
         "gesture"
       ],
       "slug": "sentinel",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1664,7 +1664,7 @@
         "refine"
       ],
       "slug": "sigil",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1709,7 +1709,7 @@
         "wayfinder"
       ],
       "slug": "sourcerer",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1768,7 +1768,7 @@
         "vault"
       ],
       "slug": "spell",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1809,7 +1809,7 @@
         "ripple"
       ],
       "slug": "tandem",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1853,7 +1853,7 @@
         "herald"
       ],
       "slug": "tavern",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1921,7 +1921,7 @@
         "vault"
       ],
       "slug": "tempo",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -1972,7 +1972,7 @@
         "ripple"
       ],
       "slug": "vault",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -2018,7 +2018,7 @@
         "refine"
       ],
       "slug": "ward",
-      "version": "26.10.9"
+      "version": "26.10.11"
     },
     {
       "availableDocPages": [
@@ -2072,8 +2072,8 @@
         "herald"
       ],
       "slug": "wayfinder",
-      "version": "26.10.9"
+      "version": "26.10.11"
     }
   ],
-  "version": "26.10.9"
+  "version": "26.10.11"
 }

package/data/llms-full.txt

@@ -1,6 +1,6 @@
 # Vielzeug: Full Documentation
 
-> Complete documentation for 42 packages. Version: 26.10.9
+> Complete documentation for 42 packages. Version: 26.10.11
 
 ---
 
@@ -408,7 +408,7 @@ Every route below is mounted under `/api/v1`. Mutation guards require an exact a
 | `POST /auth/sign-out-all`                                    | Requires marker, exact origin, session and captured `ACCOUNT_HEADER`; atomically increments `session_version`, deletes outstanding links, preserves account and catalog data; 200 `{ ok: true }` with an expired cookie only on durable success |
 | `GET /auth/jwks.json`                                        | Active and configured retired public verification keys                                                                                                                                                                                          |
 | `POST /auth/sign-in`                                         | `{ email }` (trimmed and lowercased); 202 `{ ok: true }`                                                                                                                                                                                        |
-| `GET /auth/verify?token=…`                                   | Safe no-store click-confirmation HTML; with valid issuer configuration, invalid queries return 400 recovery HTML; no token consumption or session change                                                                                                                                                   |
+| `GET /auth/verify?token=…`                                   | Safe no-store click-confirmation HTML; with valid issuer configuration, invalid queries return 400 recovery HTML; no token consumption or session change                                                                                        |
 | `POST /auth/verify`                                          | JSON `{ token }`, marker and exact allowed origin or `PUBLIC_ORIGIN`; consume once; 204 with session cookie                                                                                                                                     |
 | `GET /auth/account`                                          | `{ id, email, createdAt, lastSignInAt }`; no tokens or budget data                                                                                                                                                                              |
 | `DELETE /auth/account`                                       | Requires `ACCOUNT_HEADER` with the captured issuer account UUID; catalog `/me/account` via `AUTH_ARCHIVE`, require exact 204, then issuer user and cookie clear; 204                                                                            |
@@ -9715,7 +9715,7 @@ type PanGesture = DragGesture;
 
 Options and callback details are readonly. Fixed callbacks and capture policy are snapshotted at construction. Function-valued `axis` and `disabled` options remain dynamic.
 
-Gesture tracks accepted movement with capture-phase listeners on the target's current owner document. Window blur, hidden-document transition, `pointercancel`, and `lostpointercapture` cancel active recognition.
+Gesture tracks accepted movement with capture-phase listeners on the target's current owner document. Window blur, hidden-document transition, `pointercancel`, and pointer capture loss on the gesture target cancel active recognition. A `lostpointercapture` event bubbling from a descendant does not cancel the target's gesture.
 
 ## Errors
 
@@ -9976,7 +9976,7 @@ Gesture owns pointer recognition: unrestricted two-dimensional drag and one-axis
 - **Use** `shouldStart` to exclude nested interactive controls.
 - **Disable** pointer capture when nested or newly revealed controls must keep native release targeting.
 - **Apply** completion thresholds and direction rules in `onEnd`; use `activationDistance` only for recognition slop.
-- **Treat** `reason: 'cancel'` as a reset path, never a commit path.
+- **Treat** `reason: 'cancel'` as a reset path, never a commit path. Pointer capture loss on the gesture target cancels; capture loss bubbling from a descendant does not.
 - **Keep** `onMove` rendering lightweight.
 - **Dispose** the handle when its target leaves the UI.
 
@@ -20822,7 +20822,7 @@ Save
 | ------------------ | ------------------------------------------- | ------------------------------------------ | ------------------------------------------ |
 | Bundle size        |  | ~145 kB                                    | ~200 kB                                    |
 | Built with         | Ore                                       | Lit                                        | Lit                                        |
-| Runtime dependencies | Vielzeug UI primitives + Lucide           | Lit + utilities                            | Lit + Material foundations                 |
+| Runtime dependencies | Vielzeug UI primitives; Lucide only for the opt-in full-library registrar | Lit + utilities | Lit + Material foundations |
 | Accessible         | WCAG AA                                     | WCAG AA                                    | WCAG AA                                    |
 | Framework agnostic |   |  |  |
 
@@ -20977,7 +20977,7 @@ Classification guides discovery and bundle selection. It is not a reason to remo
 
 | Import | Purpose |
 | --- | --- |
-| `@vielzeug/refine` | Export `RefineError` and the `eventFieldValue`/`eventFieldChecked` field readers without registering components |
+| `@vielzeug/refine` | Export `registerIcons`, icon definition types, `RefineError`, 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 |
@@ -20985,6 +20985,37 @@ Classification guides discovery and bundle selection. It is not a reason to remo
 | `@vielzeug/refine/styles/*` | Focused theme, animation, layer, and preflight stylesheets |
 | `@vielzeug/refine/frameworks/*` | TypeScript augmentations for DOM, React, and Vue |
 
+## Icon Registration and Adapters
+
+`registerIcons(icons: Readonly>): 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.
+
+`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.
+
+| Entry | Export | Purpose |
+| --- | --- | --- |
+| `@vielzeug/refine/icons` | `registerIcons`, `IconDefinition`, `IconElement`, `IconAttributes` | Common library-neutral registration and definition API |
+| `@vielzeug/refine/icons/lucide` | `lucideIcons`, `LucideIconData` | Pure adapter for selected structural Lucide SVG data |
+| `@vielzeug/refine/icons/lucide/all` | Side-effect registration | Explicitly register the full installed Lucide library |
+| `@vielzeug/refine/icons/heroicons` | `heroiconsIcons`, `IconifyIcon` | Convert a caller-named map of individual Heroicons Iconify data |
+| `@vielzeug/refine/icons/tabler` | `tablerIcons`, `IconifyIcon` | Convert a caller-named map of individual Tabler Iconify data |
+| `@vielzeug/refine/icons/mdi` | `mdiIcons`, `IconifyIcon` | Convert a caller-named map of individual MDI Iconify data |
+| `@vielzeug/refine/icons/iconify` | `iconifyIcon`, `iconifyIcons` | Convert individual Iconify data or selected/complete collections |
+| `@vielzeug/refine/icons/iconify` | `IconifyIcon`, `IconifyAlias`, `IconifyCollection`, `IconifyTransform` | Structural data types; no Iconify dependency required |
+
+Lucide 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.
+
+The 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.
+
+The three family adapters share this signature:
+
+```ts
+heroiconsIcons(icons: Readonly>): Record;
+tablerIcons(icons: Readonly>): Record;
+mdiIcons(icons: Readonly>): Record;
+```
+
+Each 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.
+
 ## Styles
 
 ```ts
@@ -21124,6 +21155,12 @@ Add the browser reset only when the application owns global element styling:
 import '@vielzeug/refine/styles/preflight.css';
 ```
 
+## Choose an Icon Library
+
+Refine includes only its internal component icons. Register application icons before mounting them: use `registerIcons` and neutral `IconDefinition` data from `@vielzeug/refine/icons`, the pure `@vielzeug/refine/icons/lucide` adapter for selected Lucide icons, or `@vielzeug/refine/icons/iconify` for local Heroicons, Tabler, and Material Design Icons data. Keep importing the component from `@vielzeug/refine/icon`. Lucide is an optional peer: install `lucide` yourself only when choosing its data or `@vielzeug/refine/icons/lucide/all`; core and structural adapters do not require it. The [icon reference](./components/icon.md) covers imports, licenses, and presentation behavior.
+
+For selected individual Iconify data, use `heroiconsIcons`, `tablerIcons`, or `mdiIcons` from `@vielzeug/refine/icons/heroicons`, `/tabler`, or `/mdi`. For example, `registerIcons(heroiconsIcons({ Search, Home }))` preserves your app keys. Install the matching `@iconify-icons/` data package yourself; these helpers do not accept framework components. Keep `iconifyIcons` for collection JSON and aliases.
+
 ## Set Attributes and Properties
 
 Use attributes for serializable HTML state.

package/data/llms.txt

@@ -1,6 +1,6 @@
 # Vielzeug
 
-> 42 focused TypeScript packages. Version: 26.10.9
+> 42 focused TypeScript packages. Version: 26.10.11
 
 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.9"
+  "version": "26.10.11"
 }