@vielzeug/codex 26.10.3 → 26.10.4

package/data/catalog.json

@@ -73,7 +73,7 @@
         "coins"
       ],
       "slug": "arsenal",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -123,7 +123,7 @@
         "refine"
       ],
       "slug": "assay",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -165,7 +165,7 @@
         "ward"
       ],
       "slug": "clockwork",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -197,7 +197,7 @@
         "refine"
       ],
       "slug": "codex",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -267,7 +267,7 @@
         "spell"
       ],
       "slug": "coins",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -308,7 +308,7 @@
         "rune"
       ],
       "slug": "conduit",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -353,7 +353,7 @@
         "postmaster"
       ],
       "slug": "courier",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -399,7 +399,7 @@
         "refine"
       ],
       "slug": "dnd",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -441,7 +441,7 @@
         "herald"
       ],
       "slug": "familiar",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -508,7 +508,7 @@
         "courier"
       ],
       "slug": "flux",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -548,7 +548,7 @@
         "ore"
       ],
       "slug": "focus",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -589,7 +589,7 @@
         "assay"
       ],
       "slug": "forge",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -627,7 +627,7 @@
         "keymap"
       ],
       "slug": "gesture",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -671,7 +671,7 @@
         "familiar"
       ],
       "slug": "herald",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -714,7 +714,7 @@
         "tempo"
       ],
       "slug": "illusionist",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -759,7 +759,7 @@
         "ore"
       ],
       "slug": "keymap",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -806,7 +806,7 @@
         "vault"
       ],
       "slug": "ledger",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -852,7 +852,7 @@
         "courier"
       ],
       "slug": "lingua",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -890,7 +890,7 @@
         "herald"
       ],
       "slug": "mesh",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -927,7 +927,7 @@
         "ore"
       ],
       "slug": "necromancer",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -967,7 +967,7 @@
         "prism"
       ],
       "slug": "orbit",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1031,7 +1031,7 @@
         "orbit"
       ],
       "slug": "ore",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1075,7 +1075,7 @@
         "ripple"
       ],
       "slug": "postmaster",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1118,7 +1118,7 @@
         "orbit"
       ],
       "slug": "prism",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1182,7 +1182,7 @@
         "clockwork"
       ],
       "slug": "pulse",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1300,7 +1300,7 @@
         "keymap"
       ],
       "slug": "refine",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1353,7 +1353,7 @@
         "ledger"
       ],
       "slug": "ripple",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1407,7 +1407,7 @@
         "familiar"
       ],
       "slug": "rune",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1448,7 +1448,7 @@
         "refine"
       ],
       "slug": "sandbox",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1499,7 +1499,7 @@
         "ripple"
       ],
       "slug": "scout",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1552,7 +1552,7 @@
         "refine"
       ],
       "slug": "scroll",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1599,7 +1599,7 @@
         "gesture"
       ],
       "slug": "sentinel",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1639,7 +1639,7 @@
         "refine"
       ],
       "slug": "sigil",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1703,7 +1703,7 @@
         "wayfinder"
       ],
       "slug": "sourcerer",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1762,7 +1762,7 @@
         "vault"
       ],
       "slug": "spell",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1803,7 +1803,7 @@
         "ripple"
       ],
       "slug": "tandem",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1847,7 +1847,7 @@
         "herald"
       ],
       "slug": "tavern",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1915,7 +1915,7 @@
         "vault"
       ],
       "slug": "tempo",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -1966,7 +1966,7 @@
         "ripple"
       ],
       "slug": "vault",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -2012,7 +2012,7 @@
         "refine"
       ],
       "slug": "ward",
-      "version": "26.10.2"
+      "version": "26.10.3"
     },
     {
       "availableDocPages": [
@@ -2066,8 +2066,8 @@
         "herald"
       ],
       "slug": "wayfinder",
-      "version": "26.10.2"
+      "version": "26.10.3"
     }
   ],
-  "version": "26.10.2"
+  "version": "26.10.3"
 }

package/data/llms-full.txt

@@ -1,6 +1,6 @@
 # Vielzeug: Full Documentation
 
-> Complete documentation for 41 packages. Version: 26.10.2
+> Complete documentation for 41 packages. Version: 26.10.3
 
 ---
 
@@ -16480,7 +16480,7 @@ yarn add @vielzeug/prism
 
 ```ts
 import { createLineChart } from '@vielzeug/prism';
-import '@vielzeug/prism/theme';
+import '@vielzeug/prism/theme.css';
 
 const chart = createLineChart(document.getElementById('chart')!, {
   a11y: { ariaLabel: 'Revenue by month' },
@@ -16526,7 +16526,9 @@ chart.dispose();
 - **`createSparkline(container, config)`**: minimal inline line, area, bar, or stack chart
 - **`linearScale`, `timeScale`, `bandScale`**: standalone scales with nice tick generation
 - **`ChartHandle.update(data)`**: replace chart data synchronously without coupling to a state library
-- **`setTheme(theme)` / `resetTheme()`**: apply or clear custom colors, font, and grid tokens at runtime
+- **`setTheme(theme, { scope })` / `resetTheme({ scope })`**: apply or clear colors, font, grid, axis, text, and tooltip tokens globally or on one subtree at runtime
+- **Axes on by default**: line, area, and bar charts render both axes with gridlines on the value axis; `xAxis: false` / `yAxis: false` opt out
+- **Animations on by default**: every chart animates entry and updates through one rAF loop, honors reduced motion, and opts out with `transition: false`
 - **Series comparison**: hover or keyboard focus reports every series at the active key in the tooltip, `onHover`, and screen-reader announcements
 - **Keyboard navigation**: arrow keys, `Enter`, and `Escape` on every labelled chart except sparklines
 - **CSS custom properties**: full theme control via `--prism-*` tokens, with dark mode built in
@@ -16561,8 +16563,8 @@ chart.dispose();
 | `linearScale()` | Create a numeric scale | Sync | `nice` defaults to `true` |
 | `timeScale()` | Create a date scale | Sync | Invalid dates produce an invalid domain |
 | `bandScale()` | Create a categorical scale | Sync | Unknown categories map to `0` and warn in development |
-| `setTheme()` | Set Prism CSS custom properties | Sync | Values apply to `document.documentElement` |
-| `resetTheme()` | Remove Prism theme overrides | Sync | Removes only properties managed by `setTheme()` |
+| `setTheme()` | Set Prism CSS custom properties | Sync | Writes to `document.documentElement` unless `scope` is given |
+| `resetTheme()` | Remove Prism theme overrides | Sync | Clears only properties `setTheme()` wrote, on the same target |
 | `seriesColor()` | Resolve a series palette color | Sync | Palette indexes wrap after eight colors |
 
 ## Package Entry Point
@@ -16570,7 +16572,7 @@ chart.dispose();
 | Import | Purpose |
 | --- | --- |
 | `@vielzeug/prism` | Chart factories, scales, theme helpers, errors, and public types |
-| `@vielzeug/prism/theme` | Default CSS custom properties and dark-mode values |
+| `@vielzeug/prism/theme.css` | Default CSS custom properties and dark-mode values |
 
 ## Chart Factories
 
@@ -16844,18 +16846,23 @@ const scale = bandScale({ domain: ['A', 'B'], range: [0, 200] });
 ### `setTheme()`
 
 ```ts
-function setTheme(theme: PrismTheme): void;
+function setTheme(theme: PrismTheme, options?: ThemeScope): void;
 ```
 
-Sets Prism color, font, and grid custom properties on `document.documentElement`.
+Sets Prism theme custom properties as inline styles on `options.scope` when given, otherwise on `document.documentElement`. Inline values outrank every stylesheet rule, including dark-mode selectors.
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `theme` | `PrismTheme` | Tokens to write; omitted keys are left untouched |
+| `options.scope` | `HTMLElement` | Subtree to theme instead of `:root`; charts inside it resolve their `var(--prism-*)` lookups against these values |
 
 ### `resetTheme()`
 
 ```ts
-function resetTheme(): void;
+function resetTheme(options?: ThemeScope): void;
 ```
 
-Removes every custom property managed by `setTheme()`.
+Removes every custom property `setTheme()` can set from `options.scope` (default `documentElement`). Scoped and global calls are independent targets.
 
 ### `seriesColor()`
 
@@ -16972,9 +16979,10 @@ interface BaseChartConfig {
   onClick?: (event: ChartEvent) => void;
   onHover?: (event: ChartEvent | null) => void;
   tooltip?: boolean | TooltipConfig;
-  transition?: TransitionConfig;
-  xAxis?: XAxisConfig;
-  yAxis?: YAxisConfig;
+  transition?: TransitionOption; // motion is on by default; false renders synchronously
+  // Omitted renders the axis with defaults (value axis with gridlines); false suppresses it.
+  xAxis?: XAxisConfig | false;
+  yAxis?: YAxisConfig | false;
 }
 
 interface LineChartConfig extends BaseChartConfig {
@@ -17032,7 +17040,7 @@ interface SparklineConfig {
   padPixels?: number;
   showEndPoint?: boolean; // default true: dot on the latest value (line, area)
   strokeWidth?: number;
-  transition?: TransitionConfig;
+  transition?: TransitionOption; // motion is on by default; false renders synchronously
 }
 ```
 
@@ -17159,12 +17167,18 @@ interface LegendConfig {
 type LegendPosition = 'bottom' | 'left' | 'right' | 'top';
 
 interface TransitionConfig {
-  duration?: number;
-  easing?: EasingFn | 'ease-in' | 'ease-in-out' | 'ease-out' | 'linear';
-  preference?: 'always' | 'never' | 'system';
-  stagger?: number;
+  duration?: number; // ms per lane; default 300
+  easing?: EasingName | EasingFn;
+  preference?: 'always' | 'never' | 'system'; // 'system' (default) skips reduced-motion
+  stagger?: number; // ms per bar (bar) or series (radar); ignored elsewhere
 }
 
+// Motion is on by default. `false` renders every update synchronously,
+// `true` uses the chart defaults, or pass a config to tune them.
+type TransitionOption = TransitionConfig | boolean;
+
+type EasingName = 'ease-in' | 'ease-in-out' | 'ease-out' | 'back-out' | 'expo-out' | 'linear';
+
 type EasingFn = (t: number) => number;
 ```
 
@@ -17223,10 +17237,20 @@ type PieVariant = 'donut' | 'pie' | 'semi';
 type SparklineVariant = 'area' | 'bar' | 'line' | 'stack';
 
 interface PrismTheme {
+  axisColor?: string; // --prism-axis-color
   colors?: string[];
   fontFamily?: string;
   gridColor?: string;
   gridOpacity?: number;
+  textColor?: string; // --prism-text-color
+  textColorSecondary?: string; // --prism-text-color-secondary
+  tooltipBg?: string; // --prism-tooltip-bg
+  tooltipBorder?: string; // --prism-tooltip-border
+  tooltipColor?: string; // --prism-tooltip-color
+}
+
+interface ThemeScope {
+  readonly scope?: HTMLElement;
 }
 ```
 
@@ -17248,7 +17272,7 @@ Every chart needs a container element with defined dimensions and the theme CSS:
 
 ```ts
 import { createLineChart } from '@vielzeug/prism';
-import '@vielzeug/prism/theme';
+import '@vielzeug/prism/theme.css';
 
 const container = document.querySelector('#chart')!;
 const chart = createLineChart(container, {
@@ -17751,6 +17775,8 @@ const spark = createSparkline(container, {
 
 ## Axes and Grid
 
+Both axes render by default: the value axis (y on vertical charts, x on horizontal ones) carries gridlines, the category axis does not. Set `xAxis: false` or `yAxis: false` to suppress one. An explicit config is used verbatim:
+
 ```ts
 {
   xAxis: {
@@ -17853,7 +17879,13 @@ const chart = createLineChart(container, {
 
 ## Animations
 
-Pass a `transition` config to animate enter and update transitions:
+Every chart animates by default: bars grow from the baseline, line and area
+series rise out of the plot, pie slices sweep in and then morph between values,
+radar polygons reshape, and sparklines tween. Motion runs through one
+`requestAnimationFrame` loop and is skipped when the user prefers reduced motion
+(`preference: 'system'`, the default).
+
+Tune it with `transition`, or turn it off entirely:
 
 ```ts
 {
@@ -17865,14 +17897,23 @@ Pass a `transition` config to animate enter and update transitions:
 }
 ```
 
-All chart types use `requestAnimationFrame`-based interpolation and skip animation when the user prefers reduced motion (`preference: 'system'`, the default). Bar and radar charts apply `stagger` on entry; line, area, and pie charts ignore it.
+```ts
+{ transition: false }  // every update renders synchronously
+{ transition: true }   // the defaults, stated explicitly
+```
+
+Named easings are `'linear'`, `'ease-in'`, `'ease-out'`, `'ease-in-out'`,
+`'expo-out'` (a hard decelerate), and `'back-out'` (a small overshoot); pass a
+`(t: number) => number` for anything else. `stagger` applies to bar-chart bars
+and radar-chart series and is ignored elsewhere — bar charts cap the total
+staggered delay near 400 ms so a long category axis still finishes promptly.
 
 ## Theming
 
 Import the default theme:
 
 ```ts
-import '@vielzeug/prism/theme';
+import '@vielzeug/prism/theme.css';
 ```
 
 ### Programmatic Theme with `setTheme`
@@ -17883,14 +17924,17 @@ Call `setTheme` once at app startup to apply custom tokens programmatically:
 import { setTheme } from '@vielzeug/prism';
 
 setTheme({
+  axisColor: '#94a3b8', // sets --prism-axis-color
   colors: ['#6366f1', '#22d3ee', '#f59e0b', '#10b981'], // replaces --prism-color-1 through -4
   fontFamily: 'Inter, system-ui, sans-serif', // sets --prism-font-family
   gridColor: '#e2e8f0', // sets --prism-grid-color
   gridOpacity: 0.6, // sets --prism-grid-opacity
+  textColor: '#0f172a', // sets --prism-text-color
+  tooltipBg: '#0f172a', // sets --prism-tooltip-bg
 });
 ```
 
-`setTheme` writes to `document.documentElement` style, so it takes precedence over CSS file defaults. Call `resetTheme()` to clear every custom property `setTheme` can set and restore the default theme: useful for a theme-switcher's "reset" action or test teardown:
+`setTheme` writes inline custom properties, so it takes precedence over stylesheet defaults. Call `resetTheme()` to clear every custom property `setTheme` can set and restore the default theme: useful for a theme-switcher's "reset" action or test teardown:
 
 ```ts
 import { resetTheme } from '@vielzeug/prism';
@@ -17898,6 +17942,45 @@ import { resetTheme } from '@vielzeug/prism';
 resetTheme();
 ```
 
+### Theming One Subtree (component libraries)
+
+Pass `scope` to write the tokens onto one element instead of `document.documentElement`. Charts render inside it, so their `var(--prism-*)` lookups resolve against the scoped values without touching `:root` — the hook for apps whose theme lives in a JS palette object (MUI, Chakra, Backstage):
+
+```tsx
+import { useEffect, useRef } from 'react';
+import { useTheme } from '@mui/material/styles';
+import { createBarChart, resetTheme, setTheme, type BarSeriesConfig } from '@vielzeug/prism';
+import '@vielzeug/prism/theme.css';
+
+function CostsChart({ series }: { series: BarSeriesConfig[] }) {
+  const theme = useTheme();
+  const containerRef = useRef(null);
+
+  useEffect(() => {
+    const scope = containerRef.current;
+
+    if (!scope) return;
+
+    // Scoped tokens win over :root inside this subtree and never leak out of it.
+    setTheme(
+      { axisColor: theme.palette.divider, textColor: theme.palette.text.primary },
+      { scope },
+    );
+
+    const chart = createBarChart(scope, { series });
+
+    return () => {
+      chart.dispose();
+      resetTheme({ scope });
+    };
+  }, [series, theme]);
+
+  return ;
+}
+```
+
+A scoped call and a global call are independent: `resetTheme({ scope })` clears only what `setTheme({ scope })` wrote.
+
 ### Custom Theme (CSS)
 
 ```css
@@ -17941,7 +18024,7 @@ Apply tokens to a specific container:
 | `--prism-crosshair-color` | `hsl(215deg 16% 47%)`      | Crosshair line         |
 | `--prism-crosshair-dash`  | `4 2`                      | Crosshair dash pattern |
 
-The palette follows Wong (2011) so adjacent series stay distinguishable under common color-vision deficiencies. Dark mode applies automatically through `prefers-color-scheme` or an `html.dark` class.
+The palette follows Wong (2011) so adjacent series stay distinguishable under common color-vision deficiencies. Dark mode applies through `prefers-color-scheme`, an `html.dark` class, or `data-prism-theme="dark"` on the chart container or any ancestor — the last is the hook for apps that switch theme in JS without owning ``.
 
 Radar charts add their own tokens, each defaulting to a shared one:
 

package/data/llms.txt

@@ -1,6 +1,6 @@
 # Vielzeug
 
-> 41 focused TypeScript packages. Version: 26.10.2
+> 41 focused TypeScript packages. Version: 26.10.3
 
 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.2"
+  "version": "26.10.3"
 }