@cosmicdrift/kumiko-renderer 0.377.0 → 0.379.0

package/dist/i18n-defaults.js

@@ -40,6 +40,9 @@ export const kumikoDefaultTranslations = {
         "kumiko.field.locatedTzHint": "Time local to the given location",
         "kumiko.field.reference-created-no-id": "Record was created but could not be selected automatically. Please select it manually.",
         "kumiko.field.unsupported": "This field type can't be edited here yet.",
+        "kumiko.field.file-list.download": "Download",
+        "kumiko.field.file-list.hidePreview": "Hide preview",
+        "kumiko.field.file-list.preview": "Preview",
         "kumiko.field.fillAction.failed": "Could not fetch a suggestion.",
         "kumiko.field.writeOnly.remove": "Remove stored value",
         "kumiko.field.writeOnly.set": "Set",
@@ -55,7 +58,6 @@ export const kumikoDefaultTranslations = {
         "kumiko.field.file-list.empty": "No files yet.",
         "kumiko.field.file-upload.attached": "File attached",
         "kumiko.field.file-upload.change": "Change",
-        "kumiko.field.file-upload.failed": "Upload failed",
         "kumiko.field.file-upload.remove": "Remove",
         "kumiko.field.file-upload.upload": "Upload",
         "kumiko.field.embedded-list.add-row": "Add row",
@@ -65,13 +67,17 @@ export const kumikoDefaultTranslations = {
         "kumiko.field.embedded-list.move-down": "Move down",
         "kumiko.field.embedded-list.empty": "No rows yet.",
         "kumiko.field.embedded-list.empty-cta": "Add first row",
-        "kumiko.field.embedded-list.paste-rows-truncated": "{count} pasted row(s) were dropped (max row count reached).",
-        "kumiko.field.embedded-list.paste-cells-unmatched": "{count} cell(s) had no matching option and were left unchanged.",
+        "kumiko.field.embedded-list.paste-rows-truncated.one": "1 pasted row was dropped (max row count reached).",
+        "kumiko.field.embedded-list.paste-rows-truncated.other": "{count} pasted rows were dropped (max row count reached).",
+        "kumiko.field.embedded-list.paste-cells-unmatched.one": "1 cell had no matching option and was left unchanged.",
+        "kumiko.field.embedded-list.paste-cells-unmatched.other": "{count} cells had no matching option and were left unchanged.",
         "kumiko.field.multiSelect.select-all": "Select all",
         "kumiko.field.multiSelect.deselect-all": "Deselect all",
         "kumiko.list.search-placeholder": "Search…",
         "kumiko.list.empty.title": "No entries yet.",
         "kumiko.list.empty.filtered": "No entries match the current search or filters.",
+        "kumiko.list.empty.defaultFiltered": "No entries match the default filter. Show all to include entries outside it.",
+        "kumiko.list.empty.showAll": "Show all",
         "kumiko.list.empty.hint": "Create the first one to get started.",
         "kumiko.list.no-entries": "No entries.",
         "kumiko.record.not-found.title": "This record was not found.",
@@ -85,6 +91,7 @@ export const kumikoDefaultTranslations = {
         "kumiko.list.related-list-truncated": "Showing the first {count} entries. More are available but not loaded — this list does not paginate.",
         "kumiko.reference.system-tenant": "System",
         "kumiko.reference.system-user": "System",
+        "kumiko.reference.unknown-user": "Unknown",
         "kumiko.pager.status": "{from}–{to} of {total}",
         "kumiko.pager.pageOf": "Page {page} of {pages}",
         "kumiko.form.all-required": "All fields are required.",
@@ -155,6 +162,16 @@ export const kumikoDefaultTranslations = {
         "kumiko.widget.upload.done": "Uploaded",
         "kumiko.widget.upload.error": "Failed",
         "kumiko.widget.upload.rejected-type": "File type not allowed",
+        "kumiko.widget.upload.too-large": "File is too large",
+        "kumiko.widget.upload.invalid-type": "File type or content not allowed",
+        "kumiko.widget.upload.max-count": "At most {count} files",
+        "kumiko.widget.upload.remove": "Remove file",
+        "kumiko.field.dropzone.title": "Drop files here or click to choose",
+        "kumiko.field.dropzone.limit-size": "up to {size} per file",
+        "kumiko.field.dropzone.limit-count": "up to {count} files",
+        "kumiko.widget.pdf-preview.loading": "Loading PDF…",
+        "kumiko.widget.pdf-preview.pageOf": "Page {page} of {pages}",
+        "kumiko.widget.pdf-preview.renderFailed": "The PDF could not be displayed.",
         "kumiko.widget.step-bar.done": "Done",
         "kumiko.widget.drawer.restore": "Restore drawer width",
         "kumiko.widget.drawer.maximize": "Maximize drawer width",
@@ -252,10 +269,17 @@ export const kumikoDefaultTranslations = {
         "kumiko.validation.out-of-range": "Value out of allowed range.",
         "errors.validation.invalid_type": "Invalid value.",
         "errors.validation.too_small": "Too small or too short (minimum: {minimum}).",
+        "errors.validation.list_min_rows.one": "At least 1 row required.",
+        "errors.validation.list_min_rows.other": "At least {minimum} rows required.",
         "errors.validation.too_big": "Too big or too long (maximum: {maximum}).",
         "kumiko.validation.number.min": "Must be at least {minimum}.",
         "kumiko.validation.number.max": "Must be {maximum} or less.",
         "errors.validation.invalid_format": "Invalid format.",
+        "errors.validation.invalid_format.email": "Invalid email address, e.g. name@example.com.",
+        "errors.validation.invalid_format.url": "Invalid web address, e.g. https://example.com.",
+        "errors.validation.invalid_format.date": "Invalid date, e.g. 2026-10-20.",
+        "errors.validation.invalid_format.datetime": "Invalid date and time, e.g. 2026-10-20T14:30.",
+        "errors.validation.invalid_format.uuid": "Invalid ID, e.g. 123e4567-e89b-12d3-a456-426614174000.",
         "errors.validation.not_multiple_of": "Must be a multiple of {divisor}.",
         "errors.validation.unrecognized_keys": "Unknown fields.",
         "errors.validation.invalid_union": "Invalid value.",
@@ -277,6 +301,7 @@ export const kumikoDefaultTranslations = {
         "errors.recordLocked": "This record is locked and can no longer be changed.",
         "errors.uniqueViolation": "This entry already exists.",
         "errors.unprocessable": "The request could not be processed.",
+        "errors.file.violatesBindTarget": "This file does not meet the requirements of the target field.",
         "errors.unconfigured": "This feature isn't configured yet.",
         "errors.internal": "Something went wrong. Please try again later.",
         "errors.rate_limited": "Too many requests. Please try again shortly.",

package/dist/index.d.ts

@@ -39,6 +39,8 @@ export { evalVisibleWhen, type VisibleWhenVerdict } from "./app/visible-when.ts"
 export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error.ts";
 export type { ErrorBoundaryFallbackProps, ErrorBoundaryProps, } from "./components/error-boundary.tsx";
 export { ErrorBoundary } from "./components/error-boundary.tsx";
+export type { FormScreenLayoutProps } from "./components/form-screen-layout.tsx";
+export { FormScreenLayout } from "./components/form-screen-layout.tsx";
 export { RelatedListSection } from "./components/related-list-section.tsx";
 export type { RenderEditAction, RenderEditChangeState, RenderEditControls, RenderEditProps, } from "./components/render-edit.tsx";
 export { RenderEdit } from "./components/render-edit.tsx";
@@ -78,14 +80,16 @@ export type { LocaleProviderProps, TranslationBundle, TranslationsByKey, Transla
 export { createStaticLocaleResolver, FormalityProvider, LocaleProvider, mergeTranslations, translationsByKeyFromLocales, translationsByLocaleFromKeys, useFormality, useLocale, useOptionalLocale, useOptionalTranslation, useTranslation, } from "./i18n.tsx";
 export { kumikoDefaultTranslations } from "./i18n-defaults.ts";
 export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.ts";
+export { hasUnsavedInput, registerUnsavedInputSource, requestLeave, setLeaveConfirmer, useUnsavedInputSource, } from "./leave-guard.ts";
+export { LeaveGuardDialog } from "./leave-guard-dialog.tsx";
 export { PageHeaderCompactProvider, PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "./page-header-slot.ts";
-export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableRowGrouping, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, FieldCellWidth, FieldProps, FillContainerProps, FooterActionMarker, FooterActionRole, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputFillAction, InputProps, JsonViewProps, LightboxImage, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PickedFile, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.tsx";
+export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableRowGrouping, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, FieldCellWidth, FieldProps, FileValueListProps, FillContainerProps, FooterActionMarker, FooterActionRole, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputFillAction, InputProps, JsonViewProps, LightboxImage, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PickedFile, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.tsx";
 export { FOOTER_ACTION_ROLE_PROP, NARROW_LABEL_PROP, PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, useOptionalPrimitives, usePrimitives, } from "./primitives.tsx";
 export type { SessionEndedSignal, SessionEndedSignalProviderProps, } from "./session/session-ended.tsx";
 export { createSessionEndedSignal, isSessionEndedError, SESSION_ENDED_ERROR_CODES, SessionEndedSignalProvider, useSessionEndedSignal, withSessionEndedDetection, } from "./session/session-ended.tsx";
 export { buildWhatsAppShareUrl } from "./share-links.ts";
 export { sortByAccessor } from "./sort-by-accessor.ts";
 export type { LiveEvent, LiveEventSubscriber, LiveEventsProviderProps, } from "./sse/live-events.tsx";
-export { LiveEventsProvider, useLiveEvents } from "./sse/live-events.tsx";
+export { LIVE_RESYNC_EVENT_TYPE, LiveEventsProvider, useLiveEvents } from "./sse/live-events.tsx";
 export type { AppTokens, ColorTokens, CoreTokens, FontTokens, RadiusTokens, ShadowTokens, SpacingTokens, ThemeMode, ThemePreference, Tokens, TokensApi, TokensProviderProps, } from "./tokens.tsx";
 export { cssVarTokens, TokensProvider, useTokenController, useTokens } from "./tokens.tsx";

package/dist/index.js

@@ -32,6 +32,7 @@ export { VariableChips } from "./app/variable-chips.js";
 export { evalVisibleWhen } from "./app/visible-when.js";
 export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error.js";
 export { ErrorBoundary } from "./components/error-boundary.js";
+export { FormScreenLayout } from "./components/form-screen-layout.js";
 export { RelatedListSection } from "./components/related-list-section.js";
 export { RenderEdit } from "./components/render-edit.js";
 export { needsActionConfirm } from "./components/render-edit-action-button.js";
@@ -56,10 +57,12 @@ export { useStreamHandler } from "./hooks/use-stream-handler.js";
 export { createStaticLocaleResolver, FormalityProvider, LocaleProvider, mergeTranslations, translationsByKeyFromLocales, translationsByLocaleFromKeys, useFormality, useLocale, useOptionalLocale, useOptionalTranslation, useTranslation, } from "./i18n.js";
 export { kumikoDefaultTranslations } from "./i18n-defaults.js";
 export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.js";
+export { hasUnsavedInput, registerUnsavedInputSource, requestLeave, setLeaveConfirmer, useUnsavedInputSource, } from "./leave-guard.js";
+export { LeaveGuardDialog } from "./leave-guard-dialog.js";
 export { PageHeaderCompactProvider, PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "./page-header-slot.js";
 export { FOOTER_ACTION_ROLE_PROP, NARROW_LABEL_PROP, PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, useOptionalPrimitives, usePrimitives, } from "./primitives.js";
 export { createSessionEndedSignal, isSessionEndedError, SESSION_ENDED_ERROR_CODES, SessionEndedSignalProvider, useSessionEndedSignal, withSessionEndedDetection, } from "./session/session-ended.js";
 export { buildWhatsAppShareUrl } from "./share-links.js";
 export { sortByAccessor } from "./sort-by-accessor.js";
-export { LiveEventsProvider, useLiveEvents } from "./sse/live-events.js";
+export { LIVE_RESYNC_EVENT_TYPE, LiveEventsProvider, useLiveEvents } from "./sse/live-events.js";
 export { cssVarTokens, TokensProvider, useTokenController, useTokens } from "./tokens.js";

package/dist/leave-guard-dialog.d.ts

@@ -0,0 +1,2 @@
+import { type ReactNode } from "react";
+export declare function LeaveGuardDialog(): ReactNode;

package/dist/leave-guard-dialog.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useTranslation } from "./i18n.js";
+import { setLeaveConfirmer } from "./leave-guard.js";
+import { usePrimitives } from "./primitives.js";
+export function LeaveGuardDialog() {
+    const { Dialog } = usePrimitives();
+    const t = useTranslation();
+    const [pending, setPending] = useState(null);
+    // Dialog fires onOpenChange(false) after onConfirm too; the ref lets that
+    // follow-up see the request is already settled instead of cancelling it.
+    const pendingRef = useRef(null);
+    useEffect(() => setLeaveConfirmer((request) => {
+        pendingRef.current = request;
+        setPending(request);
+    }), []);
+    const settle = useCallback((decide) => {
+        const request = pendingRef.current;
+        pendingRef.current = null;
+        setPending(null);
+        if (request !== null)
+            decide(request);
+    }, []);
+    return (_jsx(Dialog, { open: pending !== null, onOpenChange: (open) => {
+            if (!open)
+                settle((request) => request.cancel());
+        }, title: t("kumiko.drawer.discard.title"), description: t("kumiko.drawer.discard.body"), confirmLabel: t("kumiko.drawer.discard.confirm"), cancelLabel: t("kumiko.drawer.discard.cancel"), variant: "danger", initialFocus: "cancel", onConfirm: () => settle((request) => request.proceed()), testId: "leave-guard-dialog" }));
+}

package/dist/leave-guard.d.ts

@@ -0,0 +1,15 @@
+type UnsavedInputSource = () => boolean;
+type LeaveConfirmer = (decision: {
+    readonly proceed: () => void;
+    readonly cancel: () => void;
+}) => void;
+export declare function registerUnsavedInputSource(source: UnsavedInputSource): () => void;
+export declare function hasUnsavedInput(): boolean;
+export declare function setLeaveConfirmer(next: LeaveConfirmer): () => void;
+/** Runs `proceed` right away when nothing is dirty (or no dialog host is
+ *  mounted); otherwise asks the user first. */
+export declare function requestLeave(proceed: () => void, cancel?: () => void): void;
+/** `isDirty` is read lazily, at guard time, so a form can report "clean"
+ *  synchronously after a successful save — before React re-renders. */
+export declare function useUnsavedInputSource(isDirty: () => boolean): void;
+export {};

package/dist/leave-guard.js

@@ -0,0 +1,39 @@
+import { useEffect, useRef } from "react";
+const sources = new Set();
+let confirmer;
+export function registerUnsavedInputSource(source) {
+    sources.add(source);
+    return () => {
+        sources.delete(source);
+    };
+}
+export function hasUnsavedInput() {
+    for (const source of sources)
+        if (source())
+            return true;
+    return false;
+}
+export function setLeaveConfirmer(next) {
+    confirmer = next;
+    return () => {
+        if (confirmer === next)
+            confirmer = undefined;
+    };
+}
+/** Runs `proceed` right away when nothing is dirty (or no dialog host is
+ *  mounted); otherwise asks the user first. */
+export function requestLeave(proceed, cancel = () => { }) {
+    if (confirmer === undefined || !hasUnsavedInput()) {
+        proceed();
+        // skip: nothing to lose, no question needed
+        return;
+    }
+    confirmer({ proceed, cancel });
+}
+/** `isDirty` is read lazily, at guard time, so a form can report "clean"
+ *  synchronously after a successful save — before React re-renders. */
+export function useUnsavedInputSource(isDirty) {
+    const isDirtyRef = useRef(isDirty);
+    isDirtyRef.current = isDirty;
+    useEffect(() => registerUnsavedInputSource(() => isDirtyRef.current()), []);
+}

package/dist/live/dispatcher-live.js

@@ -1,5 +1,4 @@
-import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
-import { createStore, } from "../headless/index.js";
+import { createStore, generateRequestId, } from "../headless/index.js";
 import { CSRF_HEADER_NAME, readCsrfToken } from "./csrf.js";
 import { batchEnvelopeSchema, errorOnlyEnvelopeSchema, queryEnvelopeSchema, writeEnvelopeSchema, } from "./envelopes.js";
 import { buildAbortError, buildNetworkError, mapServerError } from "./error-mapping.js";
@@ -188,20 +187,6 @@ export function createLiveDispatcher(options = {}) {
 }
 const EMPTY_PENDING_WRITES = Object.freeze([]);
 const EMPTY_PENDING_FILES = Object.freeze([]);
-// crypto.randomUUID where available (browser, Bun, Node); Math.random
-// fallback for React-Native runtimes without the WebCrypto polyfill.
-// Uniqueness only needs to hold per user within the server's dedup window —
-// this is an idempotency key, not a security token.
-function generateRequestId() {
-    const webCrypto = propertyOf(globalThis, "crypto");
-    const randomUUID = propertyOf(webCrypto, "randomUUID");
-    if (typeof randomUUID === "function") {
-        const id = Reflect.apply(randomUUID, webCrypto, []);
-        if (typeof id === "string")
-            return id;
-    }
-    return `req-${Math.random().toString(36).slice(2)}${Math.random().toString(36).slice(2)}`;
-}
 function buildUnexpectedShapeError(status) {
     // The server did answer: keep its status so 401/5xx handling still applies.
     return { ...buildNetworkError(`unexpected response shape (${status})`), httpStatus: status };

package/dist/primitives.d.ts

@@ -341,6 +341,9 @@ export type InputProps = {
     /** Für den Upload-POST `/api/files` — der Endpoint prüft maxSize/accept
      *  gegen die Field-Def von (entityType, fieldName). */
     readonly entityType?: string;
+    /** Screen QN of the actionForm the field belongs to; sent as `actionForm` instead of
+     *  `entityType`, so the upload stays pending for that form's field. */
+    readonly uploadActionForm?: string;
     /** Must be sent as the `entityId` part of the upload so the FileRef is
      *  attached to the record (qr overlays and access guards need it). */
     readonly entityId?: string;
@@ -359,6 +362,26 @@ export type InputProps = {
     readonly pickLabel?: string;
     /** Hidden file input gets `${testId}-input`, the pick button `${testId}-pick`. */
     readonly testId?: string;
+} | {
+    /** Drop zone for a `files` / `images` field: the value is the list of uploaded FileRef ids,
+     *  the implementation offers multi-pick, drag and drop and a remove control per file. */
+    readonly kind: "files-dropzone";
+    readonly id: string;
+    readonly name: string;
+    readonly value: readonly string[];
+    readonly onChange: (fileIds: readonly string[]) => void;
+    readonly disabled?: boolean;
+    readonly required?: boolean;
+    readonly hasError?: boolean;
+    readonly accept?: readonly string[];
+    readonly maxSize?: string;
+    readonly maxCount?: number;
+    /** Upload target, same meaning as on the `file` kind. */
+    readonly entityType?: string;
+    readonly uploadActionForm?: string;
+    readonly entityId?: string;
+    readonly fieldName?: string;
+    readonly testId?: string;
 } | {
     readonly kind: "date";
     readonly id: string;
@@ -824,6 +847,9 @@ export type EmbeddedListTotal = {
     readonly field: string;
     readonly label: string;
     readonly value: number;
+    /** Set for labelled multi-column totals, which have no single column to
+     *  read the money type from. */
+    readonly money?: boolean;
 };
 /** Row-array + totals table for a `createEmbeddedListField` (invoice-
  *  positions-style) field — structurally too different from `Input`'s
@@ -890,6 +916,9 @@ export type FormSectionNavItem = {
  *  end of the card (normal document flow). */
 export type FormProps = {
     readonly onSubmit: (e?: FormEvent) => void;
+    /** Bumped by the host each time a submit fails on field errors; the form
+     *  then moves focus to its first invalid control. Native forms may ignore it. */
+    readonly focusFirstErrorKey?: number;
     readonly children: ReactNode;
     readonly title?: ReactNode;
     /** Optionaler muted Untertitel unter dem Titel (z.B. "Add a new item to
@@ -1346,6 +1375,12 @@ export type JsonViewProps = {
     readonly indent?: number;
     readonly testId?: string;
 };
+/** Read-only list of stored files (FileRef ids): name, download link and, for
+ *  PDFs, an inline preview. Used for `renderer: { format: "file" }` on a detail field. */
+export type FileValueListProps = {
+    readonly fileIds: readonly string[];
+    readonly testId?: string;
+};
 /** Band above the tabs of a record detail: optional subtitle line plus the
  *  metrics as a definition list. `children` are `Metric` tiles. */
 export type MetricBandProps = {
@@ -1528,6 +1563,10 @@ export type CorePrimitives = {
      *  CorePrimitives mocks in tests keep compiling — additive rollout of
      *  a new primitive shouldn't force every test double to grow a stub. */
     readonly JsonView?: ComponentType<JsonViewProps>;
+    /** Optional (unlike the other Core-Primitives) so existing partial
+     *  CorePrimitives mocks in tests keep compiling — additive rollout of
+     *  a new primitive shouldn't force every test double to grow a stub. */
+    readonly FileValueList?: ComponentType<FileValueListProps>;
     /** Optional (unlike the other Core-Primitives) so existing partial
      *  CorePrimitives mocks in tests keep compiling — additive rollout of
      *  a new primitive shouldn't force every test double to grow a stub. */

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

@@ -11,6 +11,9 @@ export type LiveEvent = {
         readonly createdAt: string;
     };
 };
+/** Synthetic eventType delivered to every subscribed entity after the stream
+ *  reconnected: frames during the gap are lost, so consumers must refetch. */
+export declare const LIVE_RESYNC_EVENT_TYPE = "live.resync";
 /** Abonniert Live-Events für eine Entity (aggregateType). Returnt die
  *  Unsubscribe-Funktion. Mehrere Subscriptions parallel auf dieselbe
  *  Entity sind erlaubt — jede bekommt ihr eigenes Event. */

package/dist/sse/live-events.js

@@ -11,6 +11,9 @@ import { jsx as _jsx } from "react/jsx-runtime";
 // beim Native-Renderer wo die Verbindungs-Lifecycle oft nicht dem
 // App-Lifecycle entspricht.
 import { createContext, useContext } from "react";
+/** Synthetic eventType delivered to every subscribed entity after the stream
+ *  reconnected: frames during the gap are lost, so consumers must refetch. */
+export const LIVE_RESYNC_EVENT_TYPE = "live.resync";
 // Wenn kein Provider da ist, liefern wir einen No-op-Subscriber statt
 // zu crashen. Grund: useQuery({ live: true }) kann optimistisch
 // ausgehakt werden ohne den ganzen Baum abzureißen, wenn die Plattform

package/dist/web/app/create-app.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { isOpenToAllGranted } from "@cosmicdrift/kumiko-framework/ui-types";
 import { createContext, useContext, useEffect, useMemo, useRef, useState, } from "react";
 import { createRoot } from "react-dom/client";
-import { AppFeaturesProvider, ClientActionsProvider, ColumnRenderersProvider, ContentEditorsProvider, CustomScreensProvider, createSessionEndedSignal, DashboardBodyProvider, DispatcherProvider, DraftStorageProvider, ErrorBoundary, ExtensionSectionsProvider, hasDetailScreen, KumikoScreen, kumikoDefaultTranslations, LiveEventsProvider, LocaleProvider, mergeTranslations, NavProvider, navigateWithReturnTo, PrimitivesProvider, qualifyScreenId, ScreenMissingState, SessionEndedSignalProvider, TokensProvider, toAppSchema, translationsByLocaleFromKeys, useNav, usePrimitives, useTranslation, withSessionEndedDetection, } from "../../index.js";
+import { AppFeaturesProvider, ClientActionsProvider, ColumnRenderersProvider, ContentEditorsProvider, CustomScreensProvider, createSessionEndedSignal, DashboardBodyProvider, DispatcherProvider, DraftStorageProvider, ErrorBoundary, ExtensionSectionsProvider, hasDetailScreen, KumikoScreen, kumikoDefaultTranslations, LeaveGuardDialog, LiveEventsProvider, LocaleProvider, mergeTranslations, NavProvider, navigateWithReturnTo, PrimitivesProvider, qualifyScreenId, ScreenMissingState, SessionEndedSignalProvider, TokensProvider, toAppSchema, translationsByLocaleFromKeys, useNav, usePrimitives, useTranslation, withSessionEndedDetection, } from "../../index.js";
 import { createLiveDispatcher } from "../../live/index.js";
 import { lastSegment } from "../layout/nav-tree.js";
 import { defaultPrimitives, ScreenWidthProvider } from "../primitives/index.js";
@@ -237,7 +237,7 @@ function KumikoAppRoot(props) {
             warnMissingCustomScreens(loaded, props.customScreens);
             setApp(loaded);
         }, schemaIsRoleProjected: isFetchMode, ...(isFetchMode && { onUnmountResetSchema: () => setApp(undefined) }), ...(props.translate !== undefined && { translate: props.translate }), ...(props.onRowClick !== undefined && { onRowClick: props.onRowClick }), ...(props.shell !== undefined && { shell: props.shell }) }));
-    return (_jsx(TokensBoot, { children: _jsxs(LocaleProvider, { resolver: props.localeResolver, fallbackBundles: fallbackBundles, children: [_jsx(DocumentLangSync, { resolver: props.localeResolver }), _jsx(PrimitivesProvider, { value: props.primitives, children: _jsx(ScreenWidthProvider, { width: props.screenWidth, children: _jsx(AppFeaturesProvider, { features: app?.features ?? EMPTY_FEATURES, children: _jsx(DispatcherProvider, { dispatcher: props.dispatcher, children: _jsx(DraftStorageProvider, { value: props.draftStorage, children: _jsx(LiveEventsProvider, { value: props.liveEvents, children: _jsx(DashboardBodyProvider, { value: WebDashboardBody, children: _jsx(CustomScreensProvider, { value: props.customScreens, children: _jsx(ColumnRenderersProvider, { value: props.columnRenderers, children: _jsx(ContentEditorsProvider, { value: props.contentEditors, children: _jsx(ExtensionSectionsProvider, { value: props.extensionSectionComponents, children: _jsx(ClientActionsProvider, { value: props.clientActions, children: _jsx(NavProvidersProvider, { value: navProviders, entities: navEntities, children: _jsx(ResolversProvider, { resolvers: props.resolvers, children: _jsx(ToastProvider, { children: _jsxs(ToastActionNotifier, { children: [_jsx(UpdateChecker, {}), _jsx(SessionEndedSignalProvider, { signal: props.sessionEndedSignal, children: stackWrappers(props.providers, stackWrappers(props.gates, screenNode)) })] }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) })] }) }));
+    return (_jsx(TokensBoot, { children: _jsxs(LocaleProvider, { resolver: props.localeResolver, fallbackBundles: fallbackBundles, children: [_jsx(DocumentLangSync, { resolver: props.localeResolver }), _jsx(PrimitivesProvider, { value: props.primitives, children: _jsx(ScreenWidthProvider, { width: props.screenWidth, children: _jsx(AppFeaturesProvider, { features: app?.features ?? EMPTY_FEATURES, children: _jsx(DispatcherProvider, { dispatcher: props.dispatcher, children: _jsx(DraftStorageProvider, { value: props.draftStorage, children: _jsx(LiveEventsProvider, { value: props.liveEvents, children: _jsx(DashboardBodyProvider, { value: WebDashboardBody, children: _jsx(CustomScreensProvider, { value: props.customScreens, children: _jsx(ColumnRenderersProvider, { value: props.columnRenderers, children: _jsx(ContentEditorsProvider, { value: props.contentEditors, children: _jsx(ExtensionSectionsProvider, { value: props.extensionSectionComponents, children: _jsx(ClientActionsProvider, { value: props.clientActions, children: _jsx(NavProvidersProvider, { value: navProviders, entities: navEntities, children: _jsx(ResolversProvider, { resolvers: props.resolvers, children: _jsx(ToastProvider, { children: _jsxs(ToastActionNotifier, { children: [_jsx(UpdateChecker, {}), _jsx(LeaveGuardDialog, {}), _jsx(SessionEndedSignalProvider, { signal: props.sessionEndedSignal, children: stackWrappers(props.providers, stackWrappers(props.gates, screenNode)) })] }) }) }) }) }) }) }) }) }) }) }) }) }) }) }) })] }) }));
 }
 // Sits INSIDE the clientFeature gates (e.g. an auth gate) — a gate that
 // renders a login placeholder instead of children keeps this component

package/dist/web/app/dashboard-body.js

@@ -4,7 +4,7 @@ import { DASHBOARD_STAT_TONES } from "@cosmicdrift/kumiko-types/screen";
 import { isOneOf } from "@cosmicdrift/kumiko-types/type-guards";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
 import { currencyDecimals, EMPTY_VALUE_PLACEHOLDER } from "../../headless/index.js";
-import { dispatcherErrorText, EmbeddedScreenProvider, evalVisibleWhen, extensionSectionName, HeaderActionsBar, KumikoScreen, useEmbeddedScreen, useExtensionSectionComponent, useLocale, useNav, usePageHeaderCompact, usePageHeaderSlotAvailable, usePrimitives, useQuery, useRecordActions, useTranslation, } from "../../index.js";
+import { dispatcherErrorText, EmbeddedScreenProvider, evalVisibleWhen, extensionSectionName, HeaderActionsBar, KumikoScreen, lastSegment, useEmbeddedScreen, useExtensionSectionComponent, useLocale, useNav, usePageHeaderCompact, usePageHeaderSlotAvailable, usePrimitives, useQuery, useRecordActions, useTranslation, useUserRoles, } from "../../index.js";
 import { cn } from "../lib/cn.js";
 import { EmbeddedFormProvider } from "../primitives/index.js";
 import { PageSection } from "../primitives/layout.js";
@@ -527,8 +527,20 @@ function TextBlockView({ block, translate, }) {
             return (_jsx("pre", { "data-block": "code", className: "overflow-x-auto rounded-md bg-muted p-3 text-xs", children: _jsx("code", { children: block.code }) }));
         case "hint":
             return (_jsx("p", { "data-block": "hint", className: "text-xs text-muted-foreground", children: translate(block.text) }));
+        case "link":
+            return _jsx(TextBlockLink, { block: block, translate: translate });
     }
 }
+function TextBlockLink({ block, translate, }) {
+    const { Link } = usePrimitives();
+    const nav = useNav();
+    const userRoles = useUserRoles();
+    if (block.roles !== undefined && !block.roles.some((role) => userRoles?.includes(role))) {
+        return null;
+    }
+    const target = { screenId: lastSegment(block.screen) };
+    return (_jsx(Link, { href: nav.hrefFor(target), onPress: () => nav.navigate(target), testId: `dashboard-text-link-${target.screenId}`, children: translate(block.text) }));
+}
 function textBlockKey(block) {
     switch (block.kind) {
         case "list":

package/dist/web/app/nav.js

@@ -11,7 +11,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 // Event-Bus). Hand-rolled Listener-Set ist hier idiomatisch: zwei
 // Notify-Trigger (eigenes pushPath, popstate-Event), nicht generalisierbar.
 import { useCallback, useMemo, useSyncExternalStore, } from "react";
-import { formatPath, parsePath, resolveTarget, useNav, } from "../../index.js";
+import { formatPath, hasUnsavedInput, parsePath, requestLeave, resolveTarget, useNav, } from "../../index.js";
 // basePath erlaubt es, die App unter einem URL-Prefix zu mounten
 // (z.B. `/admin`). Read-Pfad strippt den Prefix vor dem parsePath,
 // Write-Pfad prepend'd ihn vor dem pushState/replaceState/href.
@@ -54,6 +54,12 @@ function prependBasePath(path, basePath) {
 // läuft über einen window-Listener, den wir einmalig verdrahten.
 const listeners = new Set();
 let popstateWired = false;
+// URL the app currently shows; popstate has already moved the browser to the
+// target by the time we can ask, so a declined leave must restore this one.
+let committedUrl = "";
+function readUrl() {
+    return `${window.location.pathname}${window.location.search}${window.location.hash}`;
+}
 // Stable identity for the omitted-features case — `?? []` would create a
 // fresh array every render, busting the useMemo below on every render for
 // every existing useBrowserNavApi() call site (none of which pass features).
@@ -64,13 +70,35 @@ function ensurePopstateWired() {
     if (typeof window === "undefined")
         return;
     window.addEventListener("popstate", () => {
-        for (const l of listeners)
-            l();
+        if (!hasUnsavedInput()) {
+            committedUrl = readUrl();
+            for (const l of listeners)
+                l();
+            return;
+        }
+        const targetUrl = readUrl();
+        window.history.pushState(null, "", committedUrl);
+        requestLeave(() => {
+            // replaceState, not history.back(): the declined entry is already ours
+            // and a forward navigation would otherwise land on the wrong entry.
+            window.history.replaceState(null, "", targetUrl);
+            committedUrl = targetUrl;
+            for (const l of listeners)
+                l();
+        });
+    });
+    window.addEventListener("beforeunload", (event) => {
+        if (!hasUnsavedInput())
+            return;
+        event.preventDefault();
+        event.returnValue = "";
     });
     popstateWired = true;
 }
 function subscribe(listener) {
     ensurePopstateWired();
+    if (typeof window !== "undefined" && listeners.size === 0)
+        committedUrl = readUrl();
     listeners.add(listener);
     return () => {
         listeners.delete(listener);
@@ -118,6 +146,7 @@ function applySearchParamUpdates(updates) {
         return;
     const url = `${window.location.pathname}${nextSearch}${window.location.hash}`;
     window.history.replaceState(null, "", url);
+    committedUrl = readUrl();
     for (const l of listeners)
         l();
 }
@@ -137,9 +166,12 @@ function pushPath(path, search) {
         (search === undefined || window.location.search === search);
     if (unchanged)
         return;
-    window.history.pushState(null, "", `${path}${search ?? ""}`);
-    for (const l of listeners)
-        l();
+    requestLeave(() => {
+        window.history.pushState(null, "", `${path}${search ?? ""}`);
+        committedUrl = readUrl();
+        for (const l of listeners)
+            l();
+    });
 }
 function replacePath(path, search) {
     if (typeof window === "undefined")
@@ -148,9 +180,19 @@ function replacePath(path, search) {
     // to avoid creating a history entry, even when the URL is identical.
     // (pushPath skips no-op pushes; replacePath honors the call so the
     // entry-stack semantics stay predictable.)
-    window.history.replaceState(null, "", `${path}${search ?? ""}`);
-    for (const l of listeners)
-        l();
+    const nextUrl = `${path}${search ?? ""}`;
+    const leavesCurrentPage = window.location.pathname !== path ||
+        (search !== undefined && window.location.search !== search);
+    const apply = () => {
+        window.history.replaceState(null, "", nextUrl);
+        committedUrl = readUrl();
+        for (const l of listeners)
+            l();
+    };
+    if (leavesCurrentPage)
+        requestLeave(apply);
+    else
+        apply();
 }
 /** React-Hook der eine NavApi aus der Browser-History baut. Sollte
  *  einmal im App-Root aufgerufen und als value an den shared

package/dist/web/index.d.ts

@@ -74,5 +74,5 @@ export { ResizableHandle, ResizablePanel, ResizablePanelGroup } from "./ui/resiz
 export { SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarProvider } from "./ui/sidebar.tsx";
 export type { KumikoBuild } from "./version/update-checker.tsx";
 export { readLoadedBuild } from "./version/update-checker.tsx";
-export type { AiTextAreaProps, AiTextFieldProps, BooleanFieldProps, ComparisonMetric, DateFieldProps, DrawerProps, FeedRow, FileFieldProps, FloatingPanelGeometry, FloatingPanelProps, InfinityListProps, InfinityListSelection, ModeSwitchVariant, NumberFieldProps, PhotoSlotSpec, PhotoSlotsProps, PlanCardActionSlot, PlanCardLinkSlot, PlanCardPrice, PlanCardProps, PlanGridProps, ProgressListRow, PublicShellProps, PublicShellVariant, QueryTableColumn, QueryTableProps, RangeFieldProps, ResultColumn, SelectFieldProps, SideBySideTableCell, SideBySideTableColumn, SideBySideTableRow, StatDelta, StatTone, StatusBadgeTone, StatusBarEntry, StatusTone, TextareaFieldProps, TextFieldProps, TimeseriesHeight, TimeseriesPoint, TimeseriesReferenceLine, TimeseriesXAxis, TimeseriesYAxis, UploadZoneProps, } from "./widgets/index.ts";
-export { AiTextArea, AiTextField, BooleanField, CollapsibleSection, ComparisonTable, DateField, DetailList, Drawer, EmptyState, ErrorState, FeedList, FileField, FloatingPanel, InfinityList, LoadingState, MiniStat, ModeSwitch, MoneyField, NumberField, PercentField, PhotoSlots, PlanCard, PlanGrid, ProgressBar, ProgressList, PublicShell, QueryTable, RangeField, ResultPanel, ResultTable, SectionCard, SelectField, SideBySideTable, Sparkline, STATUS_TONE_TEXT, StatCard, StatusBadge, StatusBarChart, StepBar, smoothPath, TextareaField, TextField, TimeseriesChart, UploadZone, useDraft, } from "./widgets/index.ts";
+export type { AiTextAreaProps, AiTextFieldProps, BooleanFieldProps, ComparisonMetric, DateFieldProps, DrawerProps, FeedRow, FileFieldProps, FloatingPanelGeometry, FloatingPanelProps, InfinityListProps, InfinityListSelection, ModeSwitchVariant, NumberFieldProps, PdfPreviewSource, PhotoSlotSpec, PhotoSlotsProps, PlanCardActionSlot, PlanCardLinkSlot, PlanCardPrice, PlanCardProps, PlanGridProps, ProgressListRow, PublicShellProps, PublicShellVariant, QueryTableColumn, QueryTableProps, RangeFieldProps, ResultColumn, SelectFieldProps, SideBySideTableCell, SideBySideTableColumn, SideBySideTableRow, StatDelta, StatTone, StatusBadgeTone, StatusBarEntry, StatusTone, TextareaFieldProps, TextFieldProps, TimeseriesHeight, TimeseriesPoint, TimeseriesReferenceLine, TimeseriesXAxis, TimeseriesYAxis, UploadZoneProps, } from "./widgets/index.ts";
+export { AiTextArea, AiTextField, BooleanField, CollapsibleSection, ComparisonTable, DateField, DetailList, Drawer, EmptyState, ErrorState, FeedList, FileField, FloatingPanel, InfinityList, LoadingState, MiniStat, ModeSwitch, MoneyField, NumberField, PdfPreview, PercentField, PhotoSlots, PlanCard, PlanGrid, ProgressBar, ProgressList, PublicShell, QueryTable, RangeField, ResultPanel, ResultTable, SectionCard, SelectField, SideBySideTable, Sparkline, STATUS_TONE_TEXT, StatCard, StatusBadge, StatusBarChart, StepBar, smoothPath, TextareaField, TextField, TimeseriesChart, UploadZone, useDraft, } from "./widgets/index.ts";

package/dist/web/index.js

@@ -50,4 +50,4 @@ export { applyTokensToCssVars, defaultTokens, lightTokens, useBrowserTokensApi,
 export { ResizableHandle, ResizablePanel, ResizablePanelGroup } from "./ui/resizable.js";
 export { SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarProvider } from "./ui/sidebar.js";
 export { readLoadedBuild } from "./version/update-checker.js";
-export { AiTextArea, AiTextField, BooleanField, CollapsibleSection, ComparisonTable, DateField, DetailList, Drawer, EmptyState, ErrorState, FeedList, FileField, FloatingPanel, InfinityList, LoadingState, MiniStat, ModeSwitch, MoneyField, NumberField, PercentField, PhotoSlots, PlanCard, PlanGrid, ProgressBar, ProgressList, PublicShell, QueryTable, RangeField, ResultPanel, ResultTable, SectionCard, SelectField, SideBySideTable, Sparkline, STATUS_TONE_TEXT, StatCard, StatusBadge, StatusBarChart, StepBar, smoothPath, TextareaField, TextField, TimeseriesChart, UploadZone, useDraft, } from "./widgets/index.js";
+export { AiTextArea, AiTextField, BooleanField, CollapsibleSection, ComparisonTable, DateField, DetailList, Drawer, EmptyState, ErrorState, FeedList, FileField, FloatingPanel, InfinityList, LoadingState, MiniStat, ModeSwitch, MoneyField, NumberField, PdfPreview, PercentField, PhotoSlots, PlanCard, PlanGrid, ProgressBar, ProgressList, PublicShell, QueryTable, RangeField, ResultPanel, ResultTable, SectionCard, SelectField, SideBySideTable, Sparkline, STATUS_TONE_TEXT, StatCard, StatusBadge, StatusBarChart, StepBar, smoothPath, TextareaField, TextField, TimeseriesChart, UploadZone, useDraft, } from "./widgets/index.js";

package/dist/web/layout/nav-tree.js

@@ -1,7 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ChevronDown, ChevronRight, Plus, Search } from "lucide-react";
-import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
 import { resolveNavigation } from "../../headless/index.js";
+import { createLiveRefetchScheduler } from "../../hooks/live-refetch-scheduler.js";
 import { lastSegment, toAppSchema, useLiveEvents, useNav, useTranslation } from "../../index.js";
 import { KumikoLink } from "../app/nav.js";
 import { useNavEntities, useNavProviders } from "../app/nav-providers-context.js";
@@ -205,13 +206,20 @@ function useNavProviderChildren(qn, enabled) {
     const [raw, setRaw] = useState(null);
     const [error, setError] = useState(null);
     const [attempt, setAttempt] = useState(0);
+    // A live refresh keeps the current nodes on screen instead of blanking them.
+    const keepNodesOnRefire = useRef(false);
     useEffect(() => {
         if (!enabled || entities.length === 0)
             return;
-        const unsubs = entities.map((e) => subscribeLive(e, () => setAttempt((n) => n + 1)));
+        const scheduler = createLiveRefetchScheduler(() => {
+            keepNodesOnRefire.current = true;
+            setAttempt((n) => n + 1);
+        });
+        const unsubs = entities.map((e) => subscribeLive(e, scheduler.trigger));
         return () => {
             for (const u of unsubs)
                 u();
+            scheduler.dispose();
         };
     }, [enabled, entities, subscribeLive]);
     // `attempt` triggert SSE-Refresh + erneutes Subscribe — Biome sieht es
@@ -228,7 +236,9 @@ function useNavProviderChildren(qn, enabled) {
             return;
         }
         setError(null);
-        setRaw(null);
+        if (!keepNodesOnRefire.current)
+            setRaw(null);
+        keepNodesOnRefire.current = false;
         try {
             const subscribe = provider();
             try {

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

@@ -61,13 +61,13 @@ export function ShellHeader({ schema, user, headerActions, }) {
         : crumbs !== undefined && recordTitle !== undefined && crumbs.length > 0
             ? [...crumbs.slice(0, -1), { label: recordTitle }, ...crumbs.slice(-1)]
             : crumbs;
-    return (_jsxs("header", { "data-kumiko-layout": "shell-header", className: cn("flex h-14 shrink-0 items-center gap-3 border-b border-border pl-1.5 pr-3 md:pl-4 md:pr-6", compact && "relative"), children: [_jsxs("div", { className: cn("flex min-w-0 items-center gap-3", compact && "flex-1"), children: [_jsx(SidebarTrigger, { label: t("kumiko.sidebar.toggle") }), shownCrumbs !== undefined && shownCrumbs.length > 0 && (_jsx(Breadcrumb, { className: "min-w-0", "aria-label": t("kumiko.breadcrumb.label"), children: _jsx(BreadcrumbList, { className: "flex-nowrap gap-1.5 sm:gap-1.5", children: shownCrumbs.map((crumb, index) => {
+    return (_jsxs("header", { "data-kumiko-layout": "shell-header", className: cn("flex h-14 shrink-0 items-center gap-3 border-b border-border pl-1.5 pr-3 md:pl-4 md:pr-6", compact && "relative"), children: [_jsxs("div", { className: "@container flex min-w-0 flex-1 items-center gap-3", children: [_jsx(SidebarTrigger, { label: t("kumiko.sidebar.toggle") }), shownCrumbs !== undefined && shownCrumbs.length > 0 && (_jsx(Breadcrumb, { className: "min-w-0", "aria-label": t("kumiko.breadcrumb.label"), children: _jsx(BreadcrumbList, { className: "flex-nowrap gap-1.5 sm:gap-1.5", children: shownCrumbs.map((crumb, index) => {
                                 const screenId = crumb.screenId;
                                 const isLast = index === shownCrumbs.length - 1;
-                                return (_jsxs(Fragment, { children: [index > 0 && (_jsx(BreadcrumbSeparator, { className: "hidden text-muted-foreground sm:inline-flex [&>svg]:size-3.5" })), _jsx(BreadcrumbItem, { className: cn("min-w-0", !isLast && "hidden sm:inline-flex"), children: screenId !== undefined && !isLast ? (_jsx(BreadcrumbLink, { href: "#", className: "whitespace-nowrap text-foreground-secondary", onClick: (e) => {
+                                return (_jsxs(Fragment, { children: [index > 0 && (_jsx(BreadcrumbSeparator, { className: "hidden text-muted-foreground @xs:inline-flex [&>svg]:size-3.5" })), _jsx(BreadcrumbItem, { className: cn(isLast ? "min-w-0" : "hidden shrink-0 @xs:inline-flex"), children: screenId !== undefined && !isLast ? (_jsx(BreadcrumbLink, { href: "#", className: "whitespace-nowrap text-foreground-secondary", onClick: (e) => {
                                                     e.preventDefault();
                                                     nav.navigate({ screenId });
-                                                }, children: crumb.label })) : isLast ? (_jsx("h1", { "aria-current": "page", className: "truncate text-lg font-semibold text-foreground", children: titleOverride ?? crumb.label })) : (_jsx(BreadcrumbPage, { className: "whitespace-nowrap text-foreground-secondary", children: crumb.label })) })] }, screenId ?? crumb.label));
+                                                }, children: crumb.label })) : isLast ? (_jsx("h1", { "aria-current": "page", title: titleOverride ?? crumb.label, className: "truncate text-lg font-semibold text-foreground", children: titleOverride ?? crumb.label })) : (_jsx(BreadcrumbPage, { className: "whitespace-nowrap text-foreground-secondary", children: crumb.label })) })] }, screenId ?? crumb.label));
                             }) }) })), _jsx("div", { ref: setStatusElement, "data-kumiko-layout": "page-header-status", className: cn("flex items-center gap-2 empty:hidden", compact ? "min-w-0 overflow-hidden" : "shrink-0") })] }), _jsxs("div", { className: cn("ml-auto flex items-center gap-2", compact ? "min-w-0 max-w-[60%]" : "min-w-0 max-w-[50%] shrink-0 sm:max-w-none"), children: [_jsx("div", { ref: setActionsElement, "data-kumiko-layout": "page-header-actions", className: cn("flex min-w-0 items-center gap-2 empty:hidden [&_*]:min-w-0 [&_*]:max-w-full [&_button]:overflow-hidden [&_button]:whitespace-nowrap", compact && "overflow-hidden") }), !compact && headerActions !== undefined && (_jsx("div", { "data-kumiko-layout": "header-actions", className: "flex items-center gap-2", children: headerActions })), hasOverflow && _jsx(HeaderOverflow, { items: overflowItems, headerActions: headerActions })] })] }));
 }
 // A hand-rolled menu instead of Radix DropdownMenu: app headerActions are opaque