@cosmicdrift/kumiko-renderer 0.386.0 → 0.388.0

package/dist/web/layout/target-url.js

@@ -1,30 +1,30 @@
 // @runtime client
-// URL-Bridge für Visual-Tree-Targets. Serialisiert TargetRef in
-// Search-Params + parsed zurück.
+// URL bridge for visual-tree targets. Serializes TargetRef into
+// search params and parses it back.
 //
-// **URL-Shape**:
+// **URL shape**:
 //   ?t=<featureId>:<action>&a_<argKey1>=<value1>&a_<argKey2>=<value2>...
 //
-// Beispiel: text-content edit "imprint/de"
+// Example: text-content edit "imprint/de"
 //   ?t=text-content:edit&a_slug=imprint&a_lang=de
 //
-// **Warum prefix `a_`**: vermeidet Naming-Konflikt mit anderen Query-
-// Params (Pagination, Sort, Filter). Plus klare Trennung target-meta
-// (`t`) vs. action-args (`a_*`).
+// **Why the `a_` prefix**: avoids naming conflicts with other query
+// params (pagination, sorting, filtering) and clearly separates target
+// metadata (`t`) from action arguments (`a_*`).
 //
-// **Warum nicht JSON-encoded**: URL bleibt lesbar + bookmark-fähig.
-// JSON-base64 wäre robust für arbitrary Shapes aber unleserlich. arg-
-// values sind heute nur primitive strings (text-content: slug, lang) —
-// V.1.5 kann auf JSON wechseln wenn nested-args echten Bedarf zeigen.
+// **Why not JSON-encoded**: keeps the URL readable and bookmarkable.
+// JSON-base64 would be robust for arbitrary shapes but unreadable. Argument
+// values are currently only primitive strings (text-content: slug, lang) —
+// nested arguments could switch to JSON if they create a real need.
 const TARGET_PARAM = "t";
 const ARG_PREFIX = "a_";
-/** Build a search-params update for `setSearchParams`. Clears all
- *  existing `a_*` keys plus `t` (so wechsel target nicht alte args
- *  liegen lässt). Returns null-value entries to clear, plus the new
+/** Builds a search-params update for `setSearchParams`. Clears all
+ *  existing `a_*` keys plus `t` so switching targets cannot leave stale
+ *  arguments behind. Returns null-valued entries to clear, plus the new
  *  target entries. */
 export function serializeTarget(target, currentParams) {
     const updates = {};
-    // Clear all previous arg-keys (vermeidet stale args bei target-switch).
+    // Clear previous argument keys so switching targets cannot leave stale arguments.
     for (const key of Object.keys(currentParams)) {
         if (key.startsWith(ARG_PREFIX))
             updates[key] = null;
@@ -32,9 +32,9 @@ export function serializeTarget(target, currentParams) {
     updates[TARGET_PARAM] = `${target.featureId}:${target.action}`;
     if (target.args !== undefined) {
         for (const [k, v] of Object.entries(target.args)) {
-            // V.1.4b: nur string-args. Numbers/booleans werden via String()
-            // koerziert; nested objects/arrays werden NICHT supported (würde
-            // JSON-encoded URL brauchen, siehe Header-Comment).
+            // Only string arguments are supported. Numbers and booleans are coerced via String();
+            // nested objects and arrays are unsupported because they would require a
+            // JSON-encoded URL.
             if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
                 updates[`${ARG_PREFIX}${k}`] = String(v);
             }
@@ -42,8 +42,8 @@ export function serializeTarget(target, currentParams) {
     }
     return updates;
 }
-/** Inverse — parse the current search-params back into a TargetRef.
- *  Returns undefined wenn der `t`-Key fehlt (kein active target). */
+/** Parses the current search parameters back into a TargetRef.
+ *  Returns undefined when the `t` key is missing, indicating no active target. */
 export function parseTargetFromSearchParams(params) {
     const t = params[TARGET_PARAM];
     if (t === undefined || t === "")
@@ -65,8 +65,8 @@ export function parseTargetFromSearchParams(params) {
     }
     return hasArgs ? { featureId, action, args } : { featureId, action };
 }
-/** Returns null-valued updates that clear target + all args. Used vom
- *  Close-Button + onUnmount. */
+/** Returns null-valued updates that clear the target and all arguments. Used by
+ *  the close button and on unmount. */
 export function clearTargetSearchParams(currentParams) {
     const updates = { [TARGET_PARAM]: null };
     for (const key of Object.keys(currentParams)) {

package/dist/web/layout/theme-toggle.js

@@ -1,9 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// ThemeToggle — Button der die Theme-Wahl weiterschaltet (hell → dunkel → auto).
-// Icon-Slots als Props, damit renderer/web keine Icon-Lib als Hard-
-// Dependency zieht. Default: Unicode-Glyphs (☀ / ☾) — funktionieren in
-// jedem Browser, jede App kann lucide/heroicons/eigene SVG via Props
-// reinreichen.
+// ThemeToggle — Button that cycles through the theme choices (light → dark → auto).
+// Icon slots are props so renderer/web does not pull in an icon library as a hard
+// dependency. Defaults: Unicode glyphs (☀ / ☾) — they work in every browser, and
+// each app can pass lucide/heroicons/custom SVGs through the props.
 import { useContext } from "react";
 import { HeaderOverflowMenuContext, headerOverflowMenuItemClass } from "./header-overflow-menu.js";
 import { useThemeToggleLabel } from "./theme-label.js";

package/dist/web/layout/uniform-bar-controls.d.ts

@@ -0,0 +1 @@
+export declare const UNIFORM_BAR_CONTROLS_CLASSES = "[&_[data-slot=button]:not([data-size^=icon])]:h-9 [&_[data-slot=input]]:h-9";

package/dist/web/layout/uniform-bar-controls.js

@@ -0,0 +1,4 @@
+// Header and toolbar controls share one height whatever size a screen, app or
+// primitive asked for: the descendant selector outranks the button's own
+// size utilities. Icon-only buttons keep their square size.
+export const UNIFORM_BAR_CONTROLS_CLASSES = "[&_[data-slot=button]:not([data-size^=icon])]:h-9 [&_[data-slot=input]]:h-9";

package/dist/web/layout/workspace-shell.d.ts

@@ -7,11 +7,11 @@ export type WorkspaceShellUser = {
 export type WorkspaceShellProps = {
     /** Branding / logo on the left side of the topbar. */
     readonly brand: ReactNode;
-    /** Schema mit `workspaces` populated — die engine baut das aus
-     *  registry.getAllWorkspaces() + getWorkspaceNavs(). Akzeptiert
-     *  AppSchema (multi-feature) oder die legacy FeatureSchema (single-
-     *  feature, workspaces inline). Ohne Workspaces fällt der Shell auf
-     *  plain NavTree ohne Switcher zurück. */
+    /** Schema with `workspaces` populated — the engine builds this from
+     *  registry.getAllWorkspaces() + getWorkspaceNavs(). Accepts
+     *  AppSchema (multi-feature) or the legacy FeatureSchema (single-
+     *  feature, workspaces inline). Without workspaces, the shell falls
+     *  back to a plain NavTree without a switcher. */
     readonly schema: AppSchema | FeatureSchema;
     /** Optional topbar end-slot — TenantSwitcher / ThemeToggle / UserMenu. */
     readonly topbarActions?: ReactNode;
@@ -21,9 +21,9 @@ export type WorkspaceShellProps = {
      *  workspace from schema, otherwise first accessible. Useful for SSR
      *  and tests to pre-seed without hitting the URL. */
     readonly initialWorkspaceId?: string;
-    /** Footer-Slot unten in der Sidebar — Profile-Row, Help-Link, Build-
-     *  Info. Klebt am unteren Rand via `mt-auto` (siehe Sidebar.footer).
-     *  Symmetrisch zu DefaultAppShell.sidebarFooter. */
+    /** Footer slot at the bottom of the sidebar — profile row, help link,
+     *  build information. It stays at the bottom via `mt-auto` (see
+     *  Sidebar.footer). Symmetric with DefaultAppShell.sidebarFooter. */
     readonly sidebarFooter?: ReactNode;
     /** Runtime badge slot per nav leaf (bare nav id), same as DefaultAppShell. */
     readonly navBadges?: ReadonlyMap<string, ReactNode>;
@@ -37,27 +37,27 @@ export type WorkspaceShellProps = {
 export declare function WorkspaceShell({ brand, schema, topbarActions, user, initialWorkspaceId, sidebarFooter, navBadges, fill, children, }: WorkspaceShellProps): ReactNode;
 export declare function filterByAccess(workspaces: readonly WorkspaceSchema[], userRoles: readonly string[] | undefined): readonly WorkspaceSchema[];
 /** Returns the short screen-id of the first nav-member that points at
- *  a screen. Walks the workspace's nav-list in order and skips section-
- *  headers (NavDefinitions ohne `screen`) so ein workspace dessen erstes
- *  Member ein Header ist trotzdem auf einen renderbaren Screen auflöst.
+ *  a screen. Walks the workspace's nav-list in order and skips section
+ *  headers (NavDefinitions without `screen`) so a workspace whose first
+ *  member is a header still resolves to a renderable screen.
  *
  *  Returns "" when:
  *    - navMembers is undefined or empty
- *    - all members are section-headers (no `screen` property)
- *    - all members are unknown to the schema (drift zwischen
- *      r.workspace.nav und den registrierten navs — boot-validator fängt
- *      das server-side, hier nur graceful fallback)
+ *    - all members are section headers (no `screen` property)
+ *    - all members are unknown to the schema (drift between
+ *      r.workspace.nav and the registered navs — the boot validator catches
+ *      this server-side; this is only a graceful fallback)
  *
- *  The caller MUST loop-guard on "": rendering with screenId="" macht
- *  KumikoScreen den not-found-banner zeigen — und ein nav.replace mit
- *  leerem screenId würde den useLayoutEffect in WorkspaceShell bei
- *  jedem Re-Render erneut feuern (siehe matching guard dort).
+ *  The caller MUST loop-guard on "": rendering with screenId="" makes
+ *  KumikoScreen show the not-found banner — and nav.replace with an empty
+ *  screenId would fire the useLayoutEffect in WorkspaceShell on every
+ *  re-render (see the matching guard there).
  *
- *  Earlier code used `lastSegment(navQn)` which only worked when the
+ *  Earlier code used `lastSegment(navQn)`, which only worked when the
  *  feature followed the convention nav.id === screen.id (samples/apps/
  *  workspaces does this). Apps with distinct ids (publicstatus: nav
  *  "components" → screen "component-list") got "Screen not found".
  *
- *  Exported für Edge-Case-Tests. */
+ *  Exported for edge-case tests. */
 export declare function firstNavScreenId(app: AppSchema, navMembers: readonly string[] | undefined): string;
 export declare function resolveDefaultId(visible: readonly WorkspaceSchema[], preferredShortId: string | undefined): string | undefined;

package/dist/web/layout/workspace-shell.js

@@ -63,7 +63,7 @@ export function WorkspaceShell({ brand, schema, topbarActions, user, initialWork
     const handleSelect = useCallback((id) => {
         // Pick the first nav-member that actually points at a screen so
         // the URL lands on something renderable instead of `/<workspace>`.
-        // Section-headers (nav-Einträge ohne `screen`) werden übersprungen.
+        // Section headers (nav entries without `screen`) are skipped.
         const target = visible.find((ws) => ws.definition.id === id);
         const screenId = firstNavScreenId(app, target?.navMembers);
         nav.navigate({ workspaceId: id, screenId });
@@ -104,12 +104,11 @@ export function WorkspaceShell({ brand, schema, topbarActions, user, initialWork
             return;
         }
         const screenId = firstNavScreenId(app, navMembers);
-        // Loop-guard: wenn keiner der nav-members eine screen-property hat
-        // (alle section-headers oder unbekannte QNs), würde nav.replace mit
-        // screenId="" den Effect bei jedem Re-Render erneut feuern und den
-        // User auf "/<workspace>/" pinnen. Lieber gar nicht replacen — der
-        // Workspace-Selector kann den User dann manuell auf einen leaf-nav
-        // schicken.
+        // Loop guard: if none of the nav-members has a screen property
+        // (all are section headers or unknown QNs), nav.replace with
+        // screenId="" would fire the effect again on every re-render and pin
+        // the user to "/<workspace>/". Do not replace in that case — the
+        // workspace selector can then send the user to a leaf nav manually.
         if (screenId === "")
             return;
         nav.replace({ workspaceId: activeId, screenId });
@@ -132,13 +131,13 @@ export function WorkspaceShell({ brand, schema, topbarActions, user, initialWork
         return new Set(activeWorkspace.navMembers);
     }, [app.workspaces, activeWorkspace]);
     const switcher = activeId !== undefined && (_jsx(WorkspaceSwitcher, { workspaces: visible, activeId: activeId, onSelect: handleSelect }));
-    // EINE Nav: immer NavTree. Dynamische Knoten (r.nav({ provider: true }))
-    // ziehen ihre Children client-seitig aus den registrierten navProviders —
-    // der frühere navigation:"tree"/VisualTree-Zweig ist hier eingefaltet.
-    // Content-Bereich: ein aktives target (aus den nav.searchParams, gesetzt
-    // beim Klick auf einen target-Knoten) rendert den EditorPanel statt des
-    // RoutedScreen — sonst die normalen screen-children.
-    // (WorkspaceDefinition.navigation ist seitdem ein No-op; deferred removal.)
+    // One Nav: always NavTree. Dynamic nodes (r.nav({ provider: true }))
+    // load their children client-side from the registered navProviders —
+    // the former navigation:"tree"/VisualTree branch is folded in here.
+    // In the content area, an active target (from nav.searchParams, set
+    // when a target node is clicked) renders EditorPanel instead of
+    // RoutedScreen; otherwise it renders the regular screen children.
+    // (WorkspaceDefinition.navigation has been a no-op since then; removal deferred.)
     const resolvers = useResolvers();
     const activeTarget = parseTargetFromSearchParams(nav.searchParams);
     const sidebarContent = (_jsx(NavTree, { schema: app, ...(user !== undefined && { user }), ...(allowedNavQns !== undefined && { allowedNavQns }), ...(navBadges !== undefined && { navBadges }) }));
@@ -148,8 +147,8 @@ export function WorkspaceShell({ brand, schema, topbarActions, user, initialWork
     // above the content. topbarActions render right inside the header row
     // instead of a separate topbar — one header line, not two.
     const fillCls = fillClasses(fill);
-    // Zweite Spalte nur wenn ein Screen sie fuellt (sidebar-09-Muster) — sonst
-    // stuende auf jedem anderen Screen ein leerer Streifen neben der Navigation.
+    // The second column appears only when a screen fills it (sidebar-09 pattern);
+    // otherwise every other screen would have an empty strip beside the navigation.
     const panel = useSidebarPanelHost();
     return (_jsx(SidebarProvider, { ...fillCls.provider, children: _jsxs(SidebarPanelProvider, { value: panel.value, children: [_jsxs(Sidebar, { collapsible: "icon", mobileTitle: t("kumiko.sidebar.title"), mobileDescription: t("kumiko.sidebar.description"), children: [_jsxs(SidebarHeader, { "data-kumiko-layout": "sidebar-header", children: [brand, switcher] }), _jsx(SidebarContent, { "data-kumiko-layout": "sidebar-nav", children: sidebarContent }), sidebarFooter !== undefined && (_jsx(SidebarFooter, { "data-kumiko-layout": "sidebar-footer", className: "border-t border-sidebar-border", children: sidebarFooter })), _jsx(SidebarRail, { "aria-label": t("kumiko.sidebar.toggle"), title: t("kumiko.sidebar.toggle") })] }), _jsx("div", { ref: panel.ref, "data-kumiko-layout": "sidebar-panel", className: panel.occupied ? "flex h-svh shrink-0 flex-col" : "hidden" }), _jsx(SidebarInset, { className: fillCls.inset, children: _jsxs(PageHeaderSlotProvider, { children: [_jsx(ShellHeader, { schema: app, ...(user !== undefined && { user }), ...(topbarActions !== undefined && { headerActions: topbarActions }) }), _jsx("main", { className: fillCls.main, children: activeTarget !== undefined ? (_jsx(EditorPanel, { resolvers: resolvers })) : (_jsx(UserRolesProvider, { roles: user?.roles, children: children })) })] }) })] }) }));
 }
@@ -166,28 +165,28 @@ function byOrderThenInsertion(a, b) {
     return ao - bo;
 }
 /** Returns the short screen-id of the first nav-member that points at
- *  a screen. Walks the workspace's nav-list in order and skips section-
- *  headers (NavDefinitions ohne `screen`) so ein workspace dessen erstes
- *  Member ein Header ist trotzdem auf einen renderbaren Screen auflöst.
+ *  a screen. Walks the workspace's nav-list in order and skips section
+ *  headers (NavDefinitions without `screen`) so a workspace whose first
+ *  member is a header still resolves to a renderable screen.
  *
  *  Returns "" when:
  *    - navMembers is undefined or empty
- *    - all members are section-headers (no `screen` property)
- *    - all members are unknown to the schema (drift zwischen
- *      r.workspace.nav und den registrierten navs — boot-validator fängt
- *      das server-side, hier nur graceful fallback)
+ *    - all members are section headers (no `screen` property)
+ *    - all members are unknown to the schema (drift between
+ *      r.workspace.nav and the registered navs — the boot validator catches
+ *      this server-side; this is only a graceful fallback)
  *
- *  The caller MUST loop-guard on "": rendering with screenId="" macht
- *  KumikoScreen den not-found-banner zeigen — und ein nav.replace mit
- *  leerem screenId würde den useLayoutEffect in WorkspaceShell bei
- *  jedem Re-Render erneut feuern (siehe matching guard dort).
+ *  The caller MUST loop-guard on "": rendering with screenId="" makes
+ *  KumikoScreen show the not-found banner — and nav.replace with an empty
+ *  screenId would fire the useLayoutEffect in WorkspaceShell on every
+ *  re-render (see the matching guard there).
  *
- *  Earlier code used `lastSegment(navQn)` which only worked when the
+ *  Earlier code used `lastSegment(navQn)`, which only worked when the
  *  feature followed the convention nav.id === screen.id (samples/apps/
  *  workspaces does this). Apps with distinct ids (publicstatus: nav
  *  "components" → screen "component-list") got "Screen not found".
  *
- *  Exported für Edge-Case-Tests. */
+ *  Exported for edge-case tests. */
 export function firstNavScreenId(app, navMembers) {
     if (navMembers === undefined || navMembers.length === 0)
         return "";
@@ -197,7 +196,7 @@ export function firstNavScreenId(app, navMembers) {
                 if (qualifyNavId(feature.featureName, nav.id) !== navQn)
                     continue;
                 if (nav.screen === undefined)
-                    break; // section-header → nächstes member
+                    break; // section-header → next member
                 return lastSegment(nav.screen);
             }
         }

package/dist/web/lib/cn.d.ts

@@ -1,6 +1,6 @@
 import { type ClassValue } from "clsx";
-/** shadcn-Standard-Helper: clsx für konditionales Zusammenstecken,
- *  tailwind-merge für Konfliktauflösung (z.B. `px-2 px-4` → `px-4`).
- *  Jedes Primitive nutzt das um Consumer-Klassen mit Default-Klassen
- *  zu mergen ohne Duplikate. */
+/** Standard shadcn helper: `clsx` combines conditional classes,
+ * while `tailwind-merge` resolves conflicts (for example,
+ * `px-2 px-4` → `px-4`). Primitives use this to merge consumer
+ * classes with default classes without duplicates. */
 export declare function cn(...inputs: ClassValue[]): string;

package/dist/web/lib/cn.js

@@ -1,9 +1,9 @@
 import { clsx } from "clsx";
 import { twMerge } from "tailwind-merge";
-/** shadcn-Standard-Helper: clsx für konditionales Zusammenstecken,
- *  tailwind-merge für Konfliktauflösung (z.B. `px-2 px-4` → `px-4`).
- *  Jedes Primitive nutzt das um Consumer-Klassen mit Default-Klassen
- *  zu mergen ohne Duplikate. */
+/** Standard shadcn helper: `clsx` combines conditional classes,
+ * while `tailwind-merge` resolves conflicts (for example,
+ * `px-2 px-4` → `px-4`). Primitives use this to merge consumer
+ * classes with default classes without duplicates. */
 export function cn(...inputs) {
     return twMerge(clsx(inputs));
 }

package/dist/web/lib/file-ref-download.js

@@ -37,6 +37,9 @@ export async function fetchFileRefBlob(fileRefId) {
         fileName: fileNameFromContentDisposition(res.headers.get("content-disposition")),
     };
 }
+// The browser starts the download after click() returns; Safari and some
+// Firefox versions fail it when the blob URL is already revoked.
+const OBJECT_URL_REVOKE_DELAY_MS = 40_000;
 export function saveBlobAsFile(fileName, blob, options) {
     const payload = options?.bom === true ? new Blob([UTF8_BOM, blob], { type: blob.type }) : blob;
     const url = URL.createObjectURL(payload);
@@ -53,7 +56,7 @@ export function saveBlobAsFile(fileName, blob, options) {
         }
     }
     finally {
-        URL.revokeObjectURL(url);
+        setTimeout(() => URL.revokeObjectURL(url), OBJECT_URL_REVOKE_DELAY_MS);
     }
 }
 export async function downloadFileRef(fileRefId, options) {

package/dist/web/primitives/action-menu.d.ts

@@ -3,15 +3,15 @@ export type MenuItemDef = {
     readonly kind: "item";
     readonly id: string;
     readonly label: string;
-    /** Optional Icon links vor dem Label (16px). */
+    /** Optional icon displayed before the label (16px). */
     readonly icon?: ReactNode;
-    /** Pure-display Shortcut-Hint rechts (monospace, gedimmt).
-     *  Caller registriert den Shortcut separat — Linear-Style
-     *  Strings wie "O then M", "Alt + Q", "⌘K". */
+    /** Display-only shortcut hint on the right (monospace, muted).
+     * The caller registers the shortcut separately; Linear-style
+     * strings include "O then M", "Alt + Q", and "⌘K". */
     readonly shortcut?: string;
     readonly onSelect: () => void;
     readonly disabled?: boolean;
-    /** "danger" rendert Label rot — typisch Sign-out, Delete. */
+    /** "danger" renders the label in red, typically for sign-out or delete actions. */
     readonly variant?: "default" | "danger";
 } | {
     readonly kind: "separator";
@@ -22,12 +22,12 @@ export type MenuItemDef = {
 export type ActionMenuProps = {
     /** Free-form Trigger-Component — Avatar, IconButton, Pill, Custom. */
     readonly trigger: ReactNode;
-    /** aria-label für den Trigger-Wrapper. */
+    /** aria-label for the trigger wrapper. */
     readonly triggerLabel?: string;
     readonly items: readonly MenuItemDef[];
-    /** Wo das Popup relativ zum Trigger anchorn soll. Default: end. */
+    /** Where to anchor the popup relative to the trigger. Default: end. */
     readonly align?: "start" | "center" | "end";
-    /** Min-width für den Content. Default: 14rem. */
+    /** Minimum width for the content. Default: 14rem. */
     readonly minWidth?: string;
     readonly testId?: string;
 };

package/dist/web/primitives/action-menu.js

@@ -1,28 +1,29 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// Generic Action-Menu — Trigger + Items, auf @radix-ui/react-dropdown-
-// menu basiert. Wird benutzt für ProfileMenu (Topbar-Avatar), Edit-
-// Header-Menu (Three-Dots), List-Row-Kebab — die Mechanik ist überall
-// dieselbe, nur der Trigger unterscheidet sich.
+// Generic action menu built on @radix-ui/react-dropdown-
+// menu. Used for ProfileMenu (topbar avatar), Edit-
+// Header-Menu (three dots), and list-row kebab menus; only the
+// trigger differs between uses.
 //
-// Nicht zu verwechseln mit RowActionsCell (siehe primitives/index.tsx),
-// die hat die rowActions-Schema-API + per-row Visibility-Logik. Hier
-// ist der Layer drunter: stable, schema-frei, callable von App-Code
-// und vom Schema-Renderer (KumikoApp).
+// Unlike RowActionsCell (see primitives/index.tsx), this is a
+// stable, schema-free layer callable from app code and the schema
+// renderer (KumikoApp), without the rowActions schema or per-row
+// visibility logic.
 //
-// Items sind Discriminated Union (item / separator / label), Item kann
-// optional einen Keyboard-Shortcut-Hint rechts tragen (Linear-Pattern
-// "O then M") + Icon links + variant für danger-styling.
+// Items form a discriminated union (item / separator / label). Items
+// can optionally display a keyboard-shortcut hint on the right
+// (Linear-style strings such as "O then M"), an icon on the left,
+// and a variant for danger styling.
 import { useState } from "react";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, } from "./dropdown-menu.js";
 export function ActionMenu({ trigger, triggerLabel, items, align = "end", minWidth = "14rem", testId, }) {
     const [open, setOpen] = useState(false);
     return (_jsxs(DropdownMenu, { open: open, onOpenChange: setOpen, children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx("button", { type: "button", "data-testid": testId ?? "action-menu-trigger", ...(triggerLabel !== undefined && { "aria-label": triggerLabel }), className: "rounded outline-none focus-visible:ring-1 focus-visible:ring-ring", children: trigger }) }), _jsx(DropdownMenuContent, { align: align, style: { minWidth }, children: items.map((item, idx) => {
                     if (item.kind === "separator") {
-                        // biome-ignore lint/suspicious/noArrayIndexKey: Separators haben keine ID — Reihenfolge ist Identität
+                        // biome-ignore lint/suspicious/noArrayIndexKey: Separators have no ID, so their position provides identity
                         return _jsx(DropdownMenuSeparator, {}, `sep-${idx}`);
                     }
                     if (item.kind === "label") {
-                        // biome-ignore lint/suspicious/noArrayIndexKey: gleicher Grund wie separator
+                        // biome-ignore lint/suspicious/noArrayIndexKey: labels have no ID either, so their position provides identity
                         return _jsx(DropdownMenuLabel, { children: item.label }, `label-${idx}`);
                     }
                     return (_jsxs(DropdownMenuItem, { onSelect: item.onSelect, disabled: item.disabled === true, "data-testid": `action-menu-item-${item.id}`, className: item.variant === "danger" ? "text-destructive focus:text-destructive" : undefined, children: [item.icon !== undefined && _jsx("span", { className: "size-4 shrink-0", children: item.icon }), _jsx("span", { className: "flex-1", children: item.label }), item.shortcut !== undefined && (_jsx("span", { className: "ml-auto text-xs text-muted-foreground tracking-wider font-mono", children: item.shortcut }))] }, item.id));

package/dist/web/primitives/calendar-popover.d.ts

@@ -6,7 +6,7 @@ export type CalendarPopoverProps = {
     readonly max?: Date;
     readonly disabled?: boolean;
     readonly hasError?: boolean;
-    /** a11y-Label für den Icon-Button (kein sichtbarer Text). */
+    /** a11y label for the icon button (no visible text). */
     readonly triggerLabel: string;
 };
 export declare const inFieldIconButtonClass: string;

package/dist/web/primitives/calendar-popover.js

@@ -1,14 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// CalendarPopover — gemeinsamer Kalender-Trigger für DateInput und
-// TimestampInput. Ein Icon-Button öffnet ein Radix-Popover mit
+// CalendarPopover — shared calendar trigger for DateInput and
+// TimestampInput. An icon button opens a Radix popover with
 // react-day-picker (v9). captionLayout="dropdown" + startMonth/endMonth
-// geben Monats- UND Jahres-Dropdown statt nur Monats-Vor/Zurück — der
-// Grund für #369 (10 Jahre zurück war ~120 Klicks). min/max grauen
-// Tage außerhalb des erlaubten Bereichs aus.
+// provide month AND year dropdowns instead of only month navigation —
+// going back 10 years would otherwise take ~120 clicks. min/max gray out
+// days outside the allowed range.
 //
-// Der Text-Input (Tippen) lebt bewusst NICHT hier, sondern im jeweiligen
-// Primitive — date hat ein Feld, timestamp zwei (Datum + Uhrzeit). So
-// teilen beide dieselbe Kalender-Mechanik ohne ihre Eingabe-Form zu teilen.
+// The text input (typing) intentionally lives in each Primitive, not here:
+// date has one field, while timestamp has two (date + time). This lets both
+// share the calendar mechanics without sharing their input layout.
 import * as PopoverPrimitive from "@radix-ui/react-popover";
 import { Calendar as CalendarIcon } from "lucide-react";
 import { lazy, Suspense } from "react";
@@ -24,8 +24,8 @@ const popoverClass = "z-50 rounded-md border bg-popover p-3 text-popover-foregro
     "data-[state=open]:animate-in data-[state=closed]:animate-out " +
     "data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 " +
     "data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95";
-// Default-Range wenn das Feld kein min/max setzt — sonst wäre das
-// Jahres-Dropdown leer/unbrauchbar. Zur Render-Zeit berechnet.
+// Default range when the field does not set min/max; otherwise the year
+// dropdown would be empty or unusable. Computed at render time.
 function defaultRange() {
     const thisYear = new Date().getFullYear();
     return { start: new Date(1900, 0, 1), end: new Date(thisYear + 10, 11, 31) };

package/dist/web/primitives/card-styles.js

@@ -9,7 +9,7 @@ export const cardSurface = cva("flex flex-col border bg-card text-card-foregroun
     variants: { radius: { xl: "rounded-[var(--card-radius)]", lg: "rounded-lg" } },
     defaultVariants: { radius: "xl" },
 });
-// Wraps instead of running off-screen when the row outgrows its container (fw#2528).
+// Wraps instead of running off-screen when the row outgrows its container.
 export const cardFooter = "flex flex-wrap items-center justify-end gap-2 py-4";
 export const cardFooterInset = "px-[var(--card-padding)]";
 // /30 read as nearly invisible against the light-theme card (white card,

package/dist/web/primitives/card.js

@@ -26,8 +26,8 @@ export function DefaultCard({ slots, options, className, testId, dataAttributes,
         // An unframed card has no radius to clip; overflow-hidden would also
         // zero its flex-item min-height and cut off content inside a scroller.
         (framed || fillHeight) && "overflow-hidden", 
-        // Same "no flex-1" reasoning as DefaultForm's own fillHeight card
-        // (fw#2722/#2778): sizes to content and only shrinks (min-h-0) once
+        // Same "no flex-1" reasoning as DefaultForm's own fillHeight card:
+        // sizes to content and only shrinks (min-h-0) once
         // an ancestor is itself height-constrained.
         fillHeight && "min-h-0 flex flex-col", className), children: [header, children != null && (_jsx("div", { className: cn("grow", screenBody && "flex flex-col gap-6", padded &&
                     (hasHeader

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

@@ -0,0 +1,6 @@
+import { type ReactNode } from "react";
+import type { InputProps } from "../../index.ts";
+export type CodeInputProps = Extract<InputProps, {
+    readonly kind: "code";
+}>;
+export declare function CodeInput(props: CodeInputProps): ReactNode;

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

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useContext } from "react";
+import { cn } from "../lib/cn.js";
+import { FieldDescriptionContext } from "./contexts.js";
+import { useFocusOnMount } from "./use-focus-on-mount.js";
+const MIN_LENGTH_FOR_SEPARATOR = 6;
+export function CodeInput(props) {
+    const { length, value, hasError, disabled } = props;
+    const describedBy = useContext(FieldDescriptionContext);
+    const inputRef = useFocusOnMount(props.autoFocus);
+    const activeIndex = Math.min(value.length, length - 1);
+    const hasSeparator = length >= MIN_LENGTH_FOR_SEPARATOR && length % 2 === 0;
+    const handleChange = (e) => {
+        const next = e.target.value.replace(/\D/g, "").slice(0, length);
+        props.onChange(next);
+        if (next.length === length && next !== value)
+            props.onComplete?.(next);
+    };
+    const cells = [];
+    for (let index = 0; index < length; index++) {
+        const isActive = index === activeIndex;
+        const char = value[index];
+        if (hasSeparator && index === length / 2) {
+            cells.push(_jsx("span", { "aria-hidden": "true", className: "shrink-0 text-muted-foreground", children: "\u2013" }, "separator"));
+        }
+        cells.push(_jsxs("div", { "data-active": isActive, "aria-hidden": "true", className: cn("flex h-12 min-w-0 flex-1 items-center justify-center rounded-md border border-input bg-transparent text-xl font-semibold tabular-nums shadow-xs transition-[color,box-shadow] dark:bg-input/30", hasError === true && "border-destructive", "data-[active=true]:group-focus-within:ring-[3px]", hasError === true
+                ? "data-[active=true]:group-focus-within:border-destructive data-[active=true]:group-focus-within:ring-destructive/20 dark:data-[active=true]:group-focus-within:ring-destructive/40"
+                : "data-[active=true]:group-focus-within:border-ring data-[active=true]:group-focus-within:ring-ring/50"), children: [char, isActive && char === undefined ? (_jsx("span", { className: "hidden h-6 w-px animate-pulse bg-foreground group-focus-within:block" })) : null] }, index));
+    }
+    return (_jsxs("div", { className: cn("group relative flex w-full items-center gap-2", disabled === true && "cursor-not-allowed opacity-50"), children: [cells, _jsx("input", { ref: inputRef, type: "text", id: props.id, name: props.name, value: value, onChange: handleChange, disabled: disabled, inputMode: "numeric", autoComplete: props.autoComplete ?? "one-time-code", spellCheck: false, "data-testid": props.testId, "aria-describedby": describedBy, "aria-required": props.required, "aria-invalid": hasError === true ? true : undefined, className: "absolute inset-0 h-full w-full bg-transparent text-transparent caret-transparent outline-none selection:bg-transparent" })] }));
+}

package/dist/web/primitives/combobox.d.ts

@@ -20,27 +20,27 @@ type ComboboxBaseProps = {
     readonly placeholder?: string;
     readonly searchPlaceholder?: string;
     readonly emptyText?: string;
-    /** Tier 2.7e Remote-Search: wenn gesetzt, wechselt der Combobox in
-     *  Remote-Mode. cmdk's client-side Filter wird deaktiviert (Server
-     *  hat schon gefiltert), und der Search-Input ruft onSearchChange
-     *  debounced (300ms). Ohne diesen Callback bleibt die Local-Filter-
-     *  Variante (cmdk fuzzy-match auf den geladenen options). */
+    /** When set, enables remote search. cmdk's client-side filter is disabled
+     * because the server has already filtered the results, and the search input
+     * invokes onSearchChange with a 300ms debounce. Without this callback,
+     * filtering remains local using cmdk's fuzzy matching on the loaded options.
+     */
     readonly onSearchChange?: (q: string) => void;
-    /** Spinner im Trigger + Popover-Footer wenn remote search läuft. */
+    /** Shows a spinner in the trigger and popover footer while remote search is
+     * in progress. */
     readonly loading?: boolean;
     /** Fixed footer row below the option list ("+ createLabel"). Rendered
      *  unfiltered — stays visible even when the search matches nothing,
      *  which is the most common case for reference-lookups on a freshly
-     *  seeded system (kumiko-framework#1681). Omit for the plain
+     *  seeded system. Omit for the plain
      *  select-existing combobox. */
     readonly onCreate?: () => void;
     /** Label for the create-footer row. Default: i18n `kumiko.actions.create`. */
     readonly createLabel?: string;
-    /** Test-Hook: forciert den initial open-state des Popovers. In
-     *  jsdom + Radix-Popover triggert userEvent.click auf den Trigger
-     *  nicht zuverlässig PointerEvents — Tests setzen defaultOpen=true,
-     *  damit der Popover sofort gerendert ist. Production-Code lässt
-     *  den Default (false). */
+    /** Test hook that controls the popover's initial open state. In jsdom with
+     * Radix Popover, userEvent.click does not reliably trigger PointerEvents;
+     * tests set defaultOpen=true so the popover is rendered immediately.
+     * Production code leaves the default as false. */
     readonly defaultOpen?: boolean;
 };
 export type ComboboxInputProps = ComboboxBaseProps & ({