@cosmicdrift/kumiko-renderer 0.386.0 → 0.387.0

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];
 }
@@ -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/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/charts.d.ts

@@ -4,10 +4,10 @@ import { type StatusTone } from "./status-badge.tsx";
 export type StatusBarEntry = {
     /** Stable key (z.B. ISO-Datum). */
     readonly key: string;
-    /** Balkenhöhe 0..1 (z.B. operational=1, degraded=0.75, outage=0.25). */
+    /** Bar height from 0 to 1 (e.g. operational=1, degraded=0.75, outage=0.25). */
     readonly level: number;
     readonly tone: StatusTone;
-    /** Tooltip-Text (<title>) — translated vom Caller. */
+    /** Tooltip text (<title>), supplied translated by the caller. */
     readonly label?: string;
 };
 /** Status bar strip (e.g. 90-day uptime): variable-height bars with
@@ -17,7 +17,7 @@ export type StatusBarEntry = {
 export declare function StatusBarChart({ entries, ariaLabel, startLabel, endLabel, highlightLast, dense, testId, }: {
     readonly entries: readonly StatusBarEntry[];
     readonly ariaLabel: string;
-    /** Achsen-Beschriftung links/rechts unter dem Chart — translated. */
+    /** Left and right axis labels below the chart, supplied translated. */
     readonly startLabel?: string;
     readonly endLabel?: string;
     readonly highlightLast?: boolean;
@@ -25,15 +25,15 @@ export declare function StatusBarChart({ entries, ariaLabel, startLabel, endLabe
     readonly dense?: boolean;
     readonly testId?: string;
 }): ReactNode;
-/** Quadratic-durch-Mittelpunkte-Trick: glättet die Zick-Zack-Linie ohne
- *  Overshoot (~5 Zeilen statt Catmull-Rom/Bezier-Fit). */
+/** Quadratic midpoint technique: smooths the zigzag line without overshoot
+ *  (~5 lines instead of a Catmull-Rom/Bezier fit). */
 export declare function smoothPath(pts: ReadonlyArray<{
     readonly x: number;
     readonly y: number;
 }>): string;
 export type TimeseriesPoint = {
     readonly atMs: number;
-    /** null = Ausfall/kein Wert → fällt auf die Grundlinie (sichtbarer Einbruch). */
+    /** null = outage/no value → falls to the baseline for a visible drop. */
     readonly value: number | null;
 };
 export type TimeseriesYAxis = {
@@ -65,16 +65,16 @@ export type TimeseriesReferenceLine = {
     readonly label: string;
     readonly tone?: StatusTone;
 };
-/** Zeitreihen-Linien-Chart (geglättete Linie + Flächen-Verlauf). x-Achse =
- *  ZEIT im Fenster windowStartMs..windowEndMs, nicht Index — 5 Min Daten in
- *  einem 30-Tage-Fenster ergeben ehrlich einen schmalen Streifen rechts. */
+/** Time-series line chart (smoothed line with area fill). The x-axis uses
+ *  TIME within windowStartMs..windowEndMs rather than the index, so 5-minute
+ *  data in a 30-day window correctly appears as a narrow strip on the right. */
 export declare function TimeseriesChart({ points, windowStartMs, windowEndMs, tone, ariaLabel, axisLabels, xAxis, yAxis, height, markers, formatMarkerTime, referenceLines, emptyContent, testId, }: {
     readonly points: readonly TimeseriesPoint[];
     readonly windowStartMs: number;
     readonly windowEndMs: number;
     readonly tone?: StatusTone;
     readonly ariaLabel: string;
-    /** Achsen-Zeile unter dem Chart (translated/formatiert vom Caller). */
+    /** Axis row below the chart, formatted and translated by the caller. */
     readonly axisLabels?: {
         readonly start: string;
         readonly mid?: string;

package/dist/web/widgets/charts.js

@@ -5,9 +5,9 @@ import { NARROW_VIEWPORT_BREAKPOINT_PX, useIsViewportBelow, } from "../primitive
 import { bucketIndexAtFraction, initialWindowSelection, nearestIndex, pointsWithin, resolveStackedAreaWindow, snapBrushWindow, snapMovedBrushWindow, stackedAreaAxisTicks, stackedAreaDateFormatFor, } from "./chart-window.js";
 import { ModeSwitch } from "./mode-switch.js";
 import { STATUS_TONE_TEXT } from "./status-badge.js";
-// Inline-SVG-Charts — kein Chart-Dep. Farben ausschließlich über die
-// --color-status-* / --color-foreground Theme-Tokens; Achsen-Labels
-// kommen translated vom Caller (keine Locale-Annahmen im Widget).
+// Inline SVG charts without a chart dependency. Colors come exclusively from the
+// --color-status-* / --color-foreground theme tokens; axis labels are supplied
+// translated by the caller, so the widget makes no locale assumptions.
 const HOUR_MS = 3_600_000;
 const DAY_MS = 24 * HOUR_MS;
 const TONE_VAR = {
@@ -47,8 +47,8 @@ const SINGLE_POINT_RADIUS = 3;
 function clampDotY(y, height) {
     return Math.max(SINGLE_POINT_RADIUS, Math.min(height - SINGLE_POINT_RADIUS, y));
 }
-/** Quadratic-durch-Mittelpunkte-Trick: glättet die Zick-Zack-Linie ohne
- *  Overshoot (~5 Zeilen statt Catmull-Rom/Bezier-Fit). */
+/** Quadratic midpoint technique: smooths the zigzag line without overshoot
+ *  (~5 lines instead of a Catmull-Rom/Bezier fit). */
 export function smoothPath(pts) {
     const first = pts[0];
     if (!first)
@@ -85,9 +85,9 @@ function yTickPosition(index, count) {
         return "";
     return "-translate-y-1/2";
 }
-/** Zeitreihen-Linien-Chart (geglättete Linie + Flächen-Verlauf). x-Achse =
- *  ZEIT im Fenster windowStartMs..windowEndMs, nicht Index — 5 Min Daten in
- *  einem 30-Tage-Fenster ergeben ehrlich einen schmalen Streifen rechts. */
+/** Time-series line chart (smoothed line with area fill). The x-axis uses
+ *  TIME within windowStartMs..windowEndMs rather than the index, so 5-minute
+ *  data in a 30-day window correctly appears as a narrow strip on the right. */
 export function TimeseriesChart({ points, windowStartMs, windowEndMs, tone = "ok", ariaLabel, axisLabels, xAxis, yAxis, height, markers, formatMarkerTime, referenceLines, emptyContent, testId, }) {
     const gradientId = useId();
     const descId = useId();

package/dist/web/widgets/collapsible-section.d.ts

@@ -1,7 +1,7 @@
 import { type ReactNode } from "react";
-/** Aufklappbare Sektion (native <details>, aber React-kontrolliert: sonst
- *  springt das open-Attribut bei jedem Parent-Re-Render auf den Initialwert
- *  zurück). Eine Optik für alle „Erweitert"/„Mehr"-Abschnitte. */
+/** Collapsible section using native <details> with React-controlled state; otherwise
+ *  the open attribute resets to its initial value on every parent re-render.
+ *  Provides consistent styling for all “Erweitert”/“Mehr” sections. */
 export declare function CollapsibleSection({ title, defaultOpen, children, testId, }: {
     readonly title: string;
     readonly defaultOpen?: boolean;

package/dist/web/widgets/collapsible-section.js

@@ -1,14 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ChevronRight } from "lucide-react";
 import { useEffect, useState } from "react";
-/** Aufklappbare Sektion (native <details>, aber React-kontrolliert: sonst
- *  springt das open-Attribut bei jedem Parent-Re-Render auf den Initialwert
- *  zurück). Eine Optik für alle „Erweitert"/„Mehr"-Abschnitte. */
+/** Collapsible section using native <details> with React-controlled state; otherwise
+ *  the open attribute resets to its initial value on every parent re-render.
+ *  Provides consistent styling for all “Erweitert”/“Mehr” sections. */
 export function CollapsibleSection({ title, defaultOpen = false, children, testId, }) {
     const [open, setOpen] = useState(defaultOpen);
-    // useState(defaultOpen) liest nur den Mount-Wert — ein async hydrierter
-    // Draft flippt `defaultOpen` zu spät für den Lazy-Initializer. Open-only
-    // Effect: kämpft nie gegen ein manuelles Zuklappen des Users.
+    // useState(defaultOpen) reads only the mount-time value; an asynchronously hydrated
+    // draft flips `defaultOpen` too late for the lazy initializer. An open-only
+    // effect never overrides the user's manual collapse.
     useEffect(() => {
         if (defaultOpen)
             setOpen(true);

package/dist/web/widgets/detail-list.d.ts

@@ -1,7 +1,5 @@
 import type { ReactNode } from "react";
-/** Read-only Schlüssel-Wert-Liste für Detail-Masken (Label links gedimmt,
- *  Wert rechts). Wert ist ReactNode → Badges/Chips möglich. `emphasize` hebt
- *  eine Zeile hervor (z.B. das Endergebnis in einem Rechner). */
+/** Read-only key-value list for detail views (dimmed label on the left, value on the right). The value is a ReactNode, so badges and chips are supported. `emphasize` highlights a row, such as the final result in a calculator. */
 export declare function DetailList({ rows, testId, }: {
     readonly rows: readonly {
         /** Optional stable key -- falls back to the label when omitted (fine as

package/dist/web/widgets/detail-list.js

@@ -1,8 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "../lib/cn.js";
-/** Read-only Schlüssel-Wert-Liste für Detail-Masken (Label links gedimmt,
- *  Wert rechts). Wert ist ReactNode → Badges/Chips möglich. `emphasize` hebt
- *  eine Zeile hervor (z.B. das Endergebnis in einem Rechner). */
+/** Read-only key-value list for detail views (dimmed label on the left, value on the right). The value is a ReactNode, so badges and chips are supported. `emphasize` highlights a row, such as the final result in a calculator. */
 export function DetailList({ rows, testId, }) {
     return (_jsx("dl", { "data-testid": testId, className: "@container flex flex-col divide-y", children: rows.map((row) => (_jsxs("div", { className: "grid grid-cols-1 gap-0.5 py-2.5 @md:grid-cols-[200px_1fr] @md:gap-4", children: [_jsx("dt", { className: cn("text-sm text-muted-foreground", row.emphasize === true && "font-semibold text-foreground"), children: row.label }), _jsx("dd", { className: cn("text-sm font-medium", row.emphasize === true && "font-semibold"), children: row.value })] }, row.id ?? row.label))) }));
 }