@cosmicdrift/kumiko-renderer 0.386.0 → 0.388.0

package/dist/web/primitives/money-input.js

@@ -1,21 +1,18 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// MoneyInput — type=text mit focus-aware Locale-Format. Canonical-Wert
-// bleiben Minor-Units (Cents) wie auf der Wire; während Focus zeigt das
-// Input einen rohen, editierbaren Decimal-String. Bei Blur formatiert
-// Intl.NumberFormat mit `style: "currency"` — das liefert Currency-
-// Symbol (€/$/¥) UND Tausender-Trenner UND korrekte Decimals in einem
-// Aufruf.
+// MoneyInput uses locale-aware formatting while preserving minor units (cents) as the canonical value.
+// On focus, it shows a raw editable decimal string; on blur, Intl.NumberFormat with
+// `style: "currency"` supplies the currency symbol (€/$/¥), grouping separators, and
+// correct decimal places in one call.
 //
-// Warum nicht type=number: number-Inputs lehnen formatierte Strings
-// ("1.234,56 €") ab — kein Browser akzeptiert Locale-Decimals (Komma)
-// in number-Inputs. inputMode="decimal" gibt mobiles Numpad-Keyboard
-// trotzdem.
+// `type=number` cannot accept formatted strings such as ("1.234,56 €") or locale-specific
+// decimal separators such as commas. `inputMode="decimal"` still provides a mobile numeric
+// keypad.
 import { useLayoutEffect, useMemo, useRef, useState } from "react";
 import { currencyDecimals, formatMoney as formatMoneyForLocale } from "../../headless/index.js";
 import { cn } from "../lib/cn.js";
 import { parseLocaleNumber, resolveSafeLocale } from "./locale-number.js";
 // Re-exported for backward compat — callers used to import this from here
-// before it moved to headless (shared with RenderField, kumiko-framework#1923).
+// before it moved to headless (shared with RenderField).
 export { currencyDecimals, parseLocaleNumber };
 // The border and focus ring live on the wrapper so the currency symbol can be
 // a flex sibling of the input: a symbol of any width ("€", "CHF", "R$") takes
@@ -24,22 +21,21 @@ const wrapperClass = "flex h-9 w-full items-center rounded-md border border-inpu
     "transition-colors focus-within:ring-1 focus-within:ring-ring";
 const inputClass = "h-full min-w-0 flex-1 bg-transparent px-3 placeholder:text-muted-foreground " +
     "focus-visible:outline-none disabled:cursor-not-allowed " +
-    // Numerische Inputs rechtsbündig — wie native type=number — damit
-    // Beträge unter Listen-Spalten an den Tausender-Stellen alignen.
+    // Right-aligns the value like a native type=number input so amounts align at the thousands
+    // separators in list columns.
     "text-right tabular-nums";
 export function MoneyInput({ id, name, value, onChange, currency, locale, disabled, required, hasError, ariaLabel, }) {
     const decimals = currencyDecimals(currency);
     const factor = 10 ** decimals;
     const resolvedLocale = resolveSafeLocale(locale);
     const [focused, setFocused] = useState(false);
-    // Raw-Edit-Buffer während Focus. Sonst würde jeder Tipp-Step durch
-    // Math.round → format-Roundtrip jagen und der Cursor würde springen.
+    // Keeps edits raw while focused; otherwise each keystroke would round-trip through
+    // Math.round and formatting, causing the cursor to jump.
     const [draft, setDraft] = useState("");
     const inputRef = useRef(null);
     const major = value === "" ? null : value / factor;
     const { symbol, symbolPosition, formatNumber } = useMemo(() => moneyFormatParts(currency, resolvedLocale), [currency, resolvedLocale]);
     const formatted = value === "" ? "" : formatNumber(value / factor);
-    // Edit-Mode: Decimal-String ohne Tausender-Trenner.
     const toEditable = (m) => m === null
         ? ""
         : m.toLocaleString(resolvedLocale, {
@@ -58,7 +54,7 @@ export function MoneyInput({ id, name, value, onChange, currency, locale, disabl
     // to the *end* of the new value rather than preserving position — so
     // without an explicit re-select, typing right after focus appends
     // instead of replacing. That's what silently corrupted values set via
-    // Playwright's `.fill()` (framework#1856). It also matches standard
+    // Playwright's `.fill()`. It also matches standard
     // money-input UX (immediate overtype on click), and sidesteps mapping a
     // click position from the formatted view to the editable one, which has
     // no well-defined equivalent once separators and the currency symbol

package/dist/web/primitives/page-header.js

@@ -2,6 +2,8 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { useEffect } from "react";
 import { createPortal } from "react-dom";
 import { usePageHeaderSlot } from "../layout/page-header-slot.js";
+import { UNIFORM_BAR_CONTROLS_CLASSES } from "../layout/uniform-bar-controls.js";
+import { cn } from "../lib/cn.js";
 export function DefaultPageHeader({ title, recordTitle, status, actions, overflowItems, hideBreadcrumb, breadcrumbScreenId, }) {
     const slot = usePageHeaderSlot();
     const setOverflowItems = slot?.setOverflowItems;
@@ -42,7 +44,7 @@ export function DefaultPageHeader({ title, recordTitle, status, actions, overflo
         return () => setOverflowItems(undefined);
     }, [setOverflowItems, overflowItems]);
     if (slot === null) {
-        return (_jsxs("div", { "data-kumiko-layout": "page-header-inline", className: "flex items-center gap-2 px-4 py-2", children: [status, _jsx("div", { className: "ml-auto flex items-center gap-2", children: actions })] }));
+        return (_jsxs("div", { "data-kumiko-layout": "page-header-inline", className: "flex items-center gap-2 px-4 py-2", children: [status, _jsx("div", { className: cn("ml-auto flex items-center gap-2", UNIFORM_BAR_CONTROLS_CLASSES), children: actions })] }));
     }
     return (_jsxs(_Fragment, { children: [status !== undefined &&
                 slot.statusElement !== null &&

package/dist/web/primitives/pager.js

@@ -20,7 +20,7 @@ export const TABLE_FOOTER_BAR_CLASS = cn("flex h-15 shrink-0 items-center gap-4
 // `screen.pageSize ?? 50`) rather than the real per-screen pageSize, which isn't
 // threaded down to this component. A screen with a custom pageSize can still
 // under- or over-show the marker; thread pageSize through KumikoScreen →
-// RenderList → DataTable → InfiniteSentinel if that's needed (fw#1713).
+// RenderList → DataTable → InfiniteSentinel if that's needed.
 export const END_LABEL_MIN_ROWS = 50;
 export function InfiniteSentinel({ onReachEnd, loadingMore, hasMore, rowsCount, testId, }) {
     const t = useTranslation();

package/dist/web/primitives/row-actions.js

@@ -10,9 +10,8 @@ import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigge
 import { useToast } from "./toast.js";
 import "../react-css-custom-properties.js";
 import { actionIconFor, SECONDARY_BUTTON_EXTRA_CLASSES } from "./button.js";
-// The primary row action is the one that always stays a visible text
-// button — `edit` if declared, else the first visible action (fw
-// bedienkonzept L3: "Bearbeiten steht in jeder Zeile, immer, als Text").
+// The primary row action always remains a visible text button: `edit` when declared,
+// otherwise the first visible action ("Edit appears in every row, always, as text").
 function primaryRowAction(actions) {
     return actions.find((a) => a.id === "edit") ?? actions[0];
 }
@@ -38,19 +37,19 @@ export function RowActionsCell({ row, actions, mode = "adaptive", rowIsLink = fa
         // otherwise "inline" is exactly the wall-to-wall text-button problem
         // this feature exists to fix. An author-set `display` takes that choice over.
         const iconOnly = !hasExplicitDisplay && shouldRenderActionsIconOnly(visible);
-        return (_jsx("div", { className: "flex w-full items-center gap-1 justify-start", children: visible.map((a) => (_jsx(RowActionButton, { row: row, action: a, iconOnly: iconOnly, compact: compact }, a.id))) }));
+        return (_jsx("div", { className: "flex w-full flex-nowrap items-center gap-1 justify-start whitespace-nowrap", children: visible.map((a) => (_jsx(RowActionButton, { row: row, action: a, iconOnly: iconOnly, compact: compact }, a.id))) }));
     }
     if (hasExplicitDisplay) {
         const inline = visible.filter((a) => a.display !== undefined);
         const rest = visible.filter((a) => a.display === undefined);
-        return (_jsxs("div", { className: "inline-flex flex-wrap items-center gap-1 justify-end", children: [inline.map((a) => (_jsx(RowActionButton, { row: row, action: a, compact: compact }, a.id))), rest.length > 0 && _jsx(RowActionsKebab, { row: row, actions: rest })] }));
+        return (_jsxs("div", { className: "inline-flex flex-nowrap items-center gap-1 justify-end whitespace-nowrap", children: [inline.map((a) => (_jsx(RowActionButton, { row: row, action: a, compact: compact }, a.id))), rest.length > 0 && _jsx(RowActionsKebab, { row: row, actions: rest })] }));
     }
     if (rowIsLink) {
         return (_jsx("div", { className: "inline-flex items-center justify-end", children: _jsx(RowActionsKebab, { row: row, actions: visible }) }));
     }
     const primary = primaryRowAction(visible);
     const rest = visible.filter((a) => a.id !== primary?.id);
-    return (_jsxs("div", { className: "inline-flex flex-wrap items-center gap-1 justify-end", children: [primary !== undefined && _jsx(RowActionButton, { row: row, action: primary, asLink: true }), rest.length > 0 && _jsx(RowActionsKebab, { row: row, actions: rest })] }));
+    return (_jsxs("div", { className: "inline-flex flex-nowrap items-center gap-1 justify-end whitespace-nowrap", children: [primary !== undefined && _jsx(RowActionButton, { row: row, action: primary, asLink: true }), rest.length > 0 && _jsx(RowActionsKebab, { row: row, actions: rest })] }));
 }
 // Shared trigger state between inline button + kebab item: busy flag
 // (while the async onTrigger runs) + confirm-pending action. Both
@@ -161,7 +160,7 @@ function RowActionsKebab({ row, actions, }) {
                     await triggerNow(action);
                 }, testId: `row-${row.id}-action-${pendingConfirm.id}-dialog` }))] }));
 }
-// Header/row-actions overflow menu (A7): the trigger carries the classes of a
+// Header/row-actions overflow menu: the trigger carries the classes of a
 // secondary icon Button so it matches neighbouring icon buttons, including
 // the 44 px touch size on phones. Generic ActionMenuItemSpec items instead of
 // the DataTableRowAction schema (callers own confirm/danger handling per item).

package/dist/web/primitives/secret-reveal.js

@@ -42,7 +42,7 @@ function QrSecretValue({ value }) {
         // biome-ignore lint/security/noDangerouslySetInnerHtml: qrcode-generated SVG, no user input
         dangerouslySetInnerHTML: { __html: svg } }));
 }
-// One-time secret reveal (fw#2548, secretMint confirm phase) — monospaced
+// One-time secret reveal (secretMint confirm phase) — monospaced
 // per-value display with a copy button that flips to `copiedLabel` on
 // success. Silent-catch on clipboard error mirrors the copy-link pattern in
 // create-app.tsx.

package/dist/web/primitives/timestamp-input.d.ts

@@ -1,11 +1,11 @@
 import { type ReactNode } from "react";
-/** Form-State → datetime-local-Format (`yyyy-MM-ddTHH:mm`).
- *  UTC-Instants (mit `Z`/Offset) werden in lokale Wall-Clock
- *  umgerechnet; offset-lose Werte nur auf Minuten gekürzt. */
+/** Form state → datetime-local format (`yyyy-MM-ddTHH:mm`).
+ *  UTC instants (with `Z`/offset) are converted to the local wall clock;
+ *  offset-free values are only truncated to minutes. */
 export declare function timestampToInputValue(value: string): string;
-/** datetime-local-Wert → Wire-Format. wallClock=true reicht die
- *  Wall-Clock unverändert durch; sonst wird die lokale Zeit als
- *  UTC-Instant mit `Z`-Suffix emittiert. */
+/** datetime-local value → wire format. wallClock=true passes the wall clock
+ *  through unchanged; otherwise the local time is emitted as a UTC instant
+ *  with a `Z` suffix. */
 export declare function inputValueToTimestamp(raw: string, wallClock: boolean): string | undefined;
 export type TimestampInputProps = {
     readonly id: string;
@@ -18,9 +18,9 @@ export type TimestampInputProps = {
     readonly hasError?: boolean;
     readonly ariaLabel?: string;
     readonly locale?: string;
-    /** Untere/obere Grenze als ISO-Datetime. Begrenzt den Kalender auf
-     *  Tages-Granularität; die exakte Uhrzeit-Grenze setzt die Zod-Validierung
-     *  durch. */
+    /** Lower and upper bounds as ISO datetimes. The calendar is constrained to
+     *  day-level granularity; Zod validation enforces the exact time bounds.
+     */
     readonly min?: string;
     readonly max?: string;
 };

package/dist/web/primitives/timestamp-input.js

@@ -1,15 +1,15 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// TimestampInput (kind:"timestamp") — gemeinsame Datums-Eingabe (DateField,
-// Tippen + Jahres-Kalender) plus ein Uhrzeit-Input. Bis #369 war dies ein
-// natives <input type="datetime-local"> — tippbar, aber mit nicht-stylebarem
-// Browser-Picker ohne Jahres-Navigation und divergent zu DateInput.
+// TimestampInput (kind:"timestamp") — shared date input (DateField,
+// typing + year calendar) plus a time input. This replaced the native
+// <input type="datetime-local">: it was typeable, but had an unstyleable
+// browser picker without year navigation and diverged from DateInput.
 //
-// Die Wire-Konvertierung bleibt unverändert: der Server validiert timestamp
-// als ISO-UTC mit `Z` (z.iso.datetime()) bzw. als Wall-Clock ohne Offset bei
-// locatedTimestamps (z.iso.datetime({ local: true })). Intern rechnen wir
-// über die datetime-local-Form `yyyy-MM-ddTHH:mm`; timestampToInputValue /
-// inputValueToTimestamp kapseln die UTC↔Wall-Clock-Umrechnung (Bug-Bash-2,
-// 2026-06-08) und sind separat getestet.
+// Wire conversion remains unchanged: the server validates timestamp values
+// as ISO UTC with `Z` (z.iso.datetime()) or as an offset-free wall clock for
+// locatedTimestamps (z.iso.datetime({ local: true })). Internally, the
+// datetime-local form `yyyy-MM-ddTHH:mm` is used; timestampToInputValue /
+// inputValueToTimestamp encapsulate the UTC↔wall-clock conversion and are
+// tested separately.
 import { useState } from "react";
 import { useTranslation } from "../../index.js";
 import { cn } from "../lib/cn.js";
@@ -19,9 +19,9 @@ const HAS_OFFSET = /(?:Z|[+-]\d{2}:\d{2})$/;
 function pad(n) {
     return String(n).padStart(2, "0");
 }
-/** Form-State → datetime-local-Format (`yyyy-MM-ddTHH:mm`).
- *  UTC-Instants (mit `Z`/Offset) werden in lokale Wall-Clock
- *  umgerechnet; offset-lose Werte nur auf Minuten gekürzt. */
+/** Form state → datetime-local format (`yyyy-MM-ddTHH:mm`).
+ *  UTC instants (with `Z`/offset) are converted to the local wall clock;
+ *  offset-free values are only truncated to minutes. */
 export function timestampToInputValue(value) {
     if (value === "")
         return "";
@@ -34,16 +34,16 @@ export function timestampToInputValue(value) {
     const m = LOCAL_MINUTES.exec(value);
     return m !== null ? m[0] : "";
 }
-/** datetime-local-Wert → Wire-Format. wallClock=true reicht die
- *  Wall-Clock unverändert durch; sonst wird die lokale Zeit als
- *  UTC-Instant mit `Z`-Suffix emittiert. */
+/** datetime-local value → wire format. wallClock=true passes the wall clock
+ *  through unchanged; otherwise the local time is emitted as a UTC instant
+ *  with a `Z` suffix. */
 export function inputValueToTimestamp(raw, wallClock) {
     if (raw === "")
         return undefined;
     if (wallClock)
         return raw;
-    // Offset-loser Datetime-String wird von Date als LOKALE Zeit geparst
-    // (ES2020+) — genau die Semantik die datetime-local liefert.
+    // An offset-free datetime string is parsed by Date as LOCAL time
+    // (ES2020+), matching the semantics provided by datetime-local.
     const d = new Date(raw);
     if (Number.isNaN(d.getTime()))
         return undefined;
@@ -64,9 +64,9 @@ export function TimestampInput({ id, name, value, onChange, wallClock, disabled,
     const t = useTranslation();
     const local = timestampToInputValue(value);
     const isoDate = local !== "" ? local.slice(0, 10) : "";
-    // Uhrzeit ohne gesetztes Datum würde im Wire-Wert verschwinden — lokal
-    // halten, bis ein Datum gewählt ist. Sobald `value` ein Datum trägt, ist
-    // dessen Uhrzeit maßgeblich.
+    // A time without a selected date would be lost from the wire value, so keep
+    // it locally until a date is selected. Once `value` contains a date, its
+    // time takes precedence.
     const [timeText, setTimeText] = useState("");
     const effectiveTime = local !== "" ? local.slice(11, 16) : timeText;
     function emit(nextIsoDate, nextTime) {

package/dist/web/primitives/toast.js

@@ -1,12 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// Toast-Primitive auf @radix-ui/react-toast. Ein globaler Provider
-// + ein useToast()-Hook der von überall in der App aus Toasts auslösen
-// kann. Kein Context-Boilerplate für Konsumenten — der Hook returned
-// einen `toast()`-Trigger, mehr Public-API gibt's nicht.
+// Toast primitive built on @radix-ui/react-toast: a global provider and
+// a useToast() hook for triggering toasts throughout the app. Consumers
+// get only the `toast()` trigger, without Context boilerplate.
 //
-// Variant = StatusTone (dieselbe Farb-Familie wie StatusBadge), Default
-// "muted" (neutral). Auto-dismiss nach 5s, manuell schließbar via X-Button.
-// Der ARIA-Live-Region-Setup kommt komplett aus Radix.
+// Variant is StatusTone, using the same color family as StatusBadge;
+// the default is "muted" (neutral). Toasts auto-dismiss after 5s and can
+// be closed manually with the X button. Radix provides the ARIA live region.
 import * as Primitive from "@radix-ui/react-toast";
 import { X } from "lucide-react";
 import { createContext, useCallback, useContext, useId, useMemo, useRef, useState, } from "react";
@@ -17,18 +16,18 @@ const ToastContext = createContext(null);
 export function useToast() {
     const ctx = useContext(ToastContext);
     if (ctx === null) {
-        // Nicht throwen — Tests die einen Component ohne Provider rendern
-        // sollen nicht crashen. No-op statt fehlerhaftes Mount.
+        // Do not throw: tests rendering a component without a provider must not
+        // crash. Use a no-op instead of failing the mount.
         return { toast: () => undefined };
     }
     return ctx;
 }
 export function ToastProvider({ children }) {
     const [entries, setEntries] = useState([]);
-    // Monoton wachsender Counter via useRef — useState hätte einen
-    // closure-Bug: zwei toast()-Calls im selben Tick lesen denselben
-    // alten Wert aus dem Closure und kollidieren bei der ID. Ref ist
-    // synchron-mutabel, jeder Aufruf bekommt eine garantiert neue ID.
+    // A monotonically increasing useRef counter avoids a closure bug: two
+    // toast() calls in the same tick would read the same stale useState value
+    // and collide on the ID. The ref is synchronously mutable, so each call
+    // receives a guaranteed-unique ID.
     const idPrefix = useId();
     const counterRef = useRef(0);
     const toast = useCallback((opts) => {

package/dist/web/primitives/use-focus-on-mount.d.ts

@@ -0,0 +1,2 @@
+import { type RefObject } from "react";
+export declare function useFocusOnMount(enabled: boolean | undefined): RefObject<HTMLInputElement | null>;

package/dist/web/primitives/use-focus-on-mount.js

@@ -0,0 +1,9 @@
+import { useEffect, useRef } from "react";
+export function useFocusOnMount(enabled) {
+    const ref = useRef(null);
+    useEffect(() => {
+        if (enabled === true)
+            ref.current?.focus();
+    }, [enabled]);
+    return ref;
+}

package/dist/web/sse/live-events.d.ts

@@ -1,8 +1,8 @@
 import { type LiveEventSubscriber } from "../../index.ts";
 export type CreateEventSourceLiveEventsOptions = {
-    /** URL des SSE-Endpoints. Default: /api/sse (das ist wo
-     *  createSseRoute im Kumiko-Server mountet). Override wenn der
-     *  Mountpath divergiert. */
+    /** URL of the SSE endpoint. Defaults to /api/sse, where
+     * createSseRoute mounts it on the Kumiko server. Override this when
+     * the mount path differs. */
     readonly url?: string;
     /** Fires once per connection when the session ended: the server refused the SSE
      *  handshake, or opened the stream with a `session-ended` frame (stale auth
@@ -22,7 +22,7 @@ export type LiveEventTimers = {
 export declare const RECONNECT_BASE_DELAY_MS = 1000;
 export declare const RECONNECT_MAX_DELAY_MS = 30000;
 export declare function reconnectDelayMs(attempt: number, random: number): number;
-/** Liefert einen `LiveEventSubscriber` der EventSource-backed ist.
- *  Normalerweise einmal im App-Bootstrap gerufen und als value an
- *  `<LiveEventsProvider>` durchgereicht — createKumikoApp tut das. */
+/** Returns an EventSource-backed `LiveEventSubscriber`.
+ *  Typically called once during app bootstrap and passed as a value to
+ *  `<LiveEventsProvider>`; `createKumikoApp` does this. */
 export declare function createEventSourceLiveEvents(options?: CreateEventSourceLiveEventsOptions): LiveEventSubscriber;

package/dist/web/sse/live-events.js

@@ -61,9 +61,9 @@ async function isSessionEndedRejection(url) {
         controller.abort();
     }
 }
-/** Liefert einen `LiveEventSubscriber` der EventSource-backed ist.
- *  Normalerweise einmal im App-Bootstrap gerufen und als value an
- *  `<LiveEventsProvider>` durchgereicht — createKumikoApp tut das. */
+/** Returns an EventSource-backed `LiveEventSubscriber`.
+ *  Typically called once during app bootstrap and passed as a value to
+ *  `<LiveEventsProvider>`; `createKumikoApp` does this. */
 export function createEventSourceLiveEvents(options = {}) {
     const url = options.url ?? "/api/sse";
     const timers = options.timers ?? defaultTimers;

package/dist/web/tokens.d.ts

@@ -5,20 +5,19 @@ export declare const THEME_STORAGE_KEY = "kumiko:theme";
  *  the host HTML (see header comment) does the same synchronously before the
  *  first paint. */
 export declare function applyStoredThemeMode(): void;
-/** Nur für Tests: der once-per-page-load-Guard ist ein Module-Singleton —
- *  ohne Reset wäre der Mount-Restore-Pfad nach der ersten Render im
- *  Testfile strukturell unerreichbar. */
+/** Tests only: the once-per-page-load guard is a module singleton; without a reset,
+ *  the mount-restore path would be structurally unreachable after the first render
+ *  in the test file. */
 export declare function __resetStoredModeAppliedForTests(): void;
-/** Hook der eine TokensApi für den Browser baut. Wird von
- *  createKumikoApp genutzt; App-Code der einen eigenen Token-State
- *  braucht (z.B. User-Präferenz aus localStorage) kann selber
- *  `<TokensProvider value={...}>` mounten. */
+/** Builds a TokensApi for the browser. Used by createKumikoApp; app code that needs
+ *  its own token state (for example, a user preference from localStorage) can mount
+ *  its own `<TokensProvider value={...}>`. */
 export declare function useBrowserTokensApi(): TokensApi;
-/** Default-Tokens — identisch zu `cssVarTokens` (var-string-refs).
- *  Light- und Dark-Werte switchen via `.dark`-class auf <html>. */
+/** Default tokens—identical to `cssVarTokens` (variable-string references).
+ *  Light and dark values switch via the `.dark` class on <html>. */
 export declare const defaultTokens: Tokens;
 export declare const lightTokens: Tokens;
-/** Historisch: schrieb Tokens auf :root als CSS-vars. Jetzt no-op —
- *  die CSS-vars leben in styles.css, nicht in JS. Bleibt als Export
- *  damit alter App-Code nicht bricht. */
+/** Historically wrote tokens to :root as CSS variables. Now a no-op—the CSS
+ *  variables live in styles.css, not JS. Retained as an export so existing app code
+ *  does not break. */
 export declare function applyTokensToCssVars(_tokens: Tokens): void;

package/dist/web/tokens.js

@@ -2,26 +2,25 @@ import { useEffect, useState, useSyncExternalStore } from "react";
 import { createStore } from "../headless/index.js";
 import { cssVarTokens, } from "../index.js";
 import { DEFAULT_COLOR_SCHEME_VARIABLE } from "./default-color-scheme.js";
-// Web-spezifische TokensApi-Impl. Theme-Toggle via `.dark`-Class auf
-// <html>. Die echten Farben leben in styles.css; hier ist nur die
-// JS-Seite die den class-switch triggert und React-Consumer mit
-// useSyncExternalStore darüber informiert.
+// Web-specific TokensApi implementation. The theme toggle uses the `.dark` class on
+// <html>. The actual colors live in styles.css; this is only the JS side that triggers
+// the class switch and informs React consumers through useSyncExternalStore.
 //
-// Source-of-truth ist der DOM (`<html class="dark">`); der Store ist
-// reiner Notification-Bus (Tick-Counter), den setMode/toggleMode bei
-// jedem Class-Wechsel hochzählen. So bleibt die DOM-Klasse die einzige
-// Wahrheit — readCurrentMode liest sie frisch bei jedem getSnapshot.
+// The DOM (`<html class="dark">`) is the source of truth; the store is only a
+// notification bus (a tick counter) incremented by setMode/toggleMode on every class
+// change. This keeps the DOM class as the sole authority—readCurrentMode reads it
+// freshly on every getSnapshot.
 //
-// Persistence: the choice is stored in localStorage (THEME_STORAGE_KEY) and
-// restored on the first hook mount; without it the toggle was lost on every
-// reload (prod bug 2026-06-07).
-// Preference: "auto" follows prefers-color-scheme live (matchMedia listener),
-// "light"/"dark" are explicit choices and win. Without a stored choice,
-// AppTheme.defaultColorScheme (CSS variable) applies, otherwise the HTML state.
+// Persistence: the choice is stored in localStorage (THEME_STORAGE_KEY) and restored
+// on the first hook mount; without it, the toggle would be lost on every reload.
+// Preference: "auto" follows prefers-color-scheme live (matchMedia listener), while
+// "light"/"dark" are explicit choices and take precedence. Without a stored choice,
+// AppTheme.defaultColorScheme (CSS variable) applies; otherwise, the HTML state.
 //
-// Against FOUC the host HTML also needs a synchronous inline script BEFORE
-// the stylesheet link. Under a strict CSP its hash is the sha256 in the build's
-// csp-hashes.json, which runProdApp also hands to hostDispatch as deps.cspScriptHashes:
+// To prevent FOUC, the host HTML also needs a synchronous inline script BEFORE the
+// stylesheet link. Under a strict CSP, its hash is the sha256 in the build's
+// csp-hashes.json, which runProdApp also passes to hostDispatch as
+// deps.cspScriptHashes:
 //
 //   <script>try{var s=localStorage.getItem("kumiko:theme");
 //     if(s==="dark"||(s==="auto"&&matchMedia("(prefers-color-scheme: dark)").matches))
@@ -94,8 +93,8 @@ function persistPreference(preference) {
         window.localStorage.setItem(THEME_STORAGE_KEY, preference);
     }
     catch {
-        // skip: localStorage kann werfen (Private-Mode/Quota) — Theme bleibt
-        // dann sessionbasiert, der Class-Toggle hat trotzdem funktioniert.
+        // skip: localStorage can throw (private mode/quota); the theme then remains
+        // session-based, but the class toggle still works.
     }
 }
 function applyPreference(preference) {
@@ -123,23 +122,22 @@ export function applyStoredThemeMode() {
         applyPreference(declared);
 }
 let storedModeApplied = false;
-/** Nur für Tests: der once-per-page-load-Guard ist ein Module-Singleton —
- *  ohne Reset wäre der Mount-Restore-Pfad nach der ersten Render im
- *  Testfile strukturell unerreichbar. */
+/** Tests only: the once-per-page-load guard is a module singleton; without a reset,
+ *  the mount-restore path would be structurally unreachable after the first render
+ *  in the test file. */
 export function __resetStoredModeAppliedForTests() {
     storedModeApplied = false;
     currentPreference = null;
 }
-/** Hook der eine TokensApi für den Browser baut. Wird von
- *  createKumikoApp genutzt; App-Code der einen eigenen Token-State
- *  braucht (z.B. User-Präferenz aus localStorage) kann selber
- *  `<TokensProvider value={...}>` mounten. */
+/** Builds a TokensApi for the browser. Used by createKumikoApp; app code that needs
+ *  its own token state (for example, a user preference from localStorage) can mount
+ *  its own `<TokensProvider value={...}>`. */
 export function useBrowserTokensApi() {
-    // Einmal pro Page-Load: gespeicherte Wahl anwenden. Lazy statt
-    // Modul-Side-Effect, damit Import ohne DOM (SSR/Tests) safe bleibt.
-    // Als useState-Lazy-Initializer statt nackt im Render-Body: der
-    // DOM-Side-Effect lief sonst potenziell in einem verworfenen
-    // Concurrent-Render (React darf Render-Bodies wiederholen/abbrechen).
+    // Apply the stored choice once per page load. This is lazy rather than a module
+    // side effect so importing without a DOM (SSR/tests) remains safe.
+    // A useState lazy initializer is used instead of placing this directly in the
+    // render body because the DOM side effect could otherwise run during a discarded
+    // concurrent render (React may repeat or abandon render bodies).
     useState(() => {
         if (!storedModeApplied && typeof document !== "undefined") {
             storedModeApplied = true;
@@ -192,13 +190,13 @@ export function useBrowserTokensApi() {
         },
     };
 }
-/** Default-Tokens — identisch zu `cssVarTokens` (var-string-refs).
- *  Light- und Dark-Werte switchen via `.dark`-class auf <html>. */
+/** Default tokens—identical to `cssVarTokens` (variable-string references).
+ *  Light and dark values switch via the `.dark` class on <html>. */
 export const defaultTokens = cssVarTokens;
 export const lightTokens = cssVarTokens;
-/** Historisch: schrieb Tokens auf :root als CSS-vars. Jetzt no-op —
- *  die CSS-vars leben in styles.css, nicht in JS. Bleibt als Export
- *  damit alter App-Code nicht bricht. */
+/** Historically wrote tokens to :root as CSS variables. Now a no-op—the CSS
+ *  variables live in styles.css, not JS. Retained as an export so existing app code
+ *  does not break. */
 export function applyTokensToCssVars(_tokens) {
-    // Absichtlich leer — siehe Kommentar oben.
+    // Intentionally empty—see the comment above.
 }

package/dist/web/version/update-checker.js

@@ -1,13 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// Update-Awareness — default an, kein Flag. Ein offener Tab erfährt sonst
-// nie von einem neuen Deploy (SPA bleibt geladen, index.html wird nicht neu
-// geholt → "muss hart reloaden"). Statt Service-Worker (der ist die *Ursache*
-// von "hängt auf alter Version") pollt diese Komponente die statische
-// build-info.json beim Tab-Fokus und zeigt ein Reload-Banner bei Drift.
+// Update awareness is enabled by default, without a flag. Otherwise, an open tab
+// never learns about a new deploy because the SPA stays loaded and does not fetch
+// index.html again, so it requires a hard reload. Instead of a service worker—which
+// causes the “stuck on old version” problem—this component polls the static
+// build-info.json when the tab gains focus and shows a reload banner on drift.
 //
-// Versionsquelle ist build-info.json (Hash über die Asset-URLs, vom Prod-Build
-// geschrieben) — NICHT /api/version (live leer/404, Env-/Dockerfile-Falle).
-// Banner-Strings über kumikoDefaultTranslations (kumiko.version.*, de/en).
+// The version source is build-info.json (a hash of the asset URLs written by the
+// production build), not /api/version (which may be empty or 404 at runtime because
+// of environment or Dockerfile configuration). Banner strings come from
+// kumikoDefaultTranslations (kumiko.version.*, de/en).
 import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
 import { useEffect, useState } from "react";
 import { useTranslation } from "../../index.js";
@@ -21,9 +22,9 @@ export function readLoadedBuild() {
         return undefined;
     return { id, builtAt: meta?.getAttribute("data-built-at") ?? "" };
 }
-// Korrektheitsgrenze der Update-Erkennung: ein Banner NUR bei echtem
-// ID-Drift. Kein geladener Stand (Dev/altes Bundle) oder kein Server-Stand
-// (Fetch-Fehler/kaputtes JSON → null) → nie ein Fake-Banner.
+// Update detection is only valid for a real ID drift: a banner is shown only then.
+// No loaded build (development or an old bundle), or no server build (fetch failure
+// or invalid JSON → null), must never produce a false update banner.
 export function shouldShowUpdate(loadedId, server) {
     if (!loadedId || !server)
         return false;
@@ -44,7 +45,7 @@ async function fetchServerBuild() {
         return { id: raw.id, builtAt: typeof builtAt === "string" ? builtAt : "" };
     }
     catch {
-        // Netzwerkfehler / kaputtes JSON → kein Banner. Nie ein Fake-Update zeigen.
+        // Network failure or invalid JSON → no banner; never show a false update.
         return null;
     }
 }
@@ -55,7 +56,7 @@ export function UpdateChecker() {
     useEffect(() => {
         const loadedId = loaded?.id;
         if (!loadedId)
-            return; // Dev / altes Bundle → keine Awareness.
+            return; // Development or an old bundle → no update awareness.
         let cancelled = false;
         const checking = { current: false };
         const check = async () => {

package/dist/web/widgets/ai-text-field.js

@@ -1,6 +1,6 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // AiTextField / AiTextArea — Drop-in replacement for TextField/TextareaField
-// with AI-augmented actions (ai-text-primitive plan doc, Phase 3).
+// with AI-augmented actions (from the ai-text-primitive plan).
 //
 // Built on raw <input>/<textarea> (not the generic Input primitive) because
 // ghost-text needs a keydown handler (Tab/Esc) and an overlay that the

package/dist/web/widgets/bounded-load-cache.d.ts

@@ -1 +1 @@
-export declare function createBoundedLoadCache<T>(max: number, dispose: (value: T) => void): (key: string, load: () => Promise<T>) => Promise<T>;
+export declare function createBoundedLoadCache<T>(max: number, dispose: (value: T) => void, shouldKeep?: (value: T) => boolean): (key: string, load: () => Promise<T>) => Promise<T>;