@cosmicdrift/kumiko-renderer 0.378.0 → 0.380.0

package/dist/headless/view-model/edit.js

@@ -254,15 +254,20 @@ function deriveImageHints(fieldDef) {
         ...(fieldDef.capture !== undefined && { capture: fieldDef.capture }),
     };
 }
-function deriveFileFieldHints(fieldDef, entityName, fieldName, entityId) {
+function deriveFileFieldHints(fieldDef, entityName, fieldName, entityId, actionFormScreenQn) {
     if (!isFileFieldType(fieldDef))
         return {};
-    const maxCount = fieldDef.type === "files" || fieldDef.type === "images" ? fieldDef.maxCount : undefined;
+    const isList = fieldDef.type === "files" || fieldDef.type === "images";
+    const maxCount = isList ? fieldDef.maxCount : undefined;
+    const fileDisplay = isList ? fieldDef.display : undefined;
     return {
+        ...(fileDisplay !== undefined && { fileDisplay }),
         ...(fieldDef.accept !== undefined && { accept: fieldDef.accept }),
         ...(fieldDef.maxSize !== undefined && { maxSize: fieldDef.maxSize }),
         ...(maxCount !== undefined && { maxCount }),
-        entityType: entityName,
+        ...(actionFormScreenQn !== undefined
+            ? { uploadActionForm: actionFormScreenQn }
+            : { entityType: entityName }),
         fieldName,
         ...(entityId !== undefined && { entityId }),
         ...deriveImageHints(fieldDef),
@@ -364,7 +369,7 @@ function isLockedByDerivation(derivation, values, field) {
     return isDerivedAndLocked || isUnusedFallbackOperand(derivation, values, field);
 }
 export function computeEditViewModel(input) {
-    const { screen, entity, values, translate, featureName, mode, entityId, derivation } = input;
+    const { screen, entity, values, translate, featureName, mode, entityId, derivation, actionFormScreenQn, } = input;
     const excludedFields = new Set(mode === undefined ? [] : screen.writeExcludedFields?.[mode]);
     const isHiddenByExclusion = (fieldSpec) => mode === "create" && excludedFields.has(normalizeEditField(fieldSpec).field);
     const sections = screen.layout.sections.map((sectionSpec) => {
@@ -428,7 +433,7 @@ export function computeEditViewModel(input) {
             const dateHints = deriveDateFieldHints(fieldDef);
             const numericHints = deriveNumericFieldHints(fieldDef, resolvedCurrency);
             const referenceHints = deriveReferenceFieldHints(fieldDef, normalized, declaredRefTarget, featureName);
-            const fileHints = deriveFileFieldHints(fieldDef, screen.entity, normalized.field, entityId);
+            const fileHints = deriveFileFieldHints(fieldDef, screen.entity, normalized.field, entityId, actionFormScreenQn);
             const embeddedListHints = deriveEmbeddedListHints(fieldDef, translate, featureName, screen.entity, normalized.field, resolvedCurrency, normalized.embeddedList);
             const view = {
                 field: normalized.field,

package/dist/headless/view-model/types.d.ts

@@ -210,7 +210,12 @@ export type EditFieldViewModel = {
      *  upload POST (`/api/files`), so the endpoint can check maxSize/accept
      *  against the right field def. */
     readonly entityType?: string;
+    /** Only for file fields of an actionForm — the screen QN the upload POST names as
+     *  `actionForm` instead of `entityType`; the server resolves the field through that screen. */
+    readonly uploadActionForm?: string;
     readonly fieldName?: string;
+    /** Only for `type: "files" | "images"` — how the field is shown. Absent = list. */
+    readonly fileDisplay?: "list" | "dropzone";
     /** Record being edited (update mode only). Sent with the upload so the
      *  FileRef is attached to the record. */
     readonly entityId?: string;
@@ -248,8 +253,11 @@ export type EditFieldViewModel = {
         readonly op: "multiply" | "sum" | "subtract" | "percent";
         readonly from: readonly string[];
     }>>;
-    /** Numeric sub-field names to sum in a totals row. From EmbeddedFieldDef.totals. */
-    readonly embeddedListTotals?: readonly string[];
+    /** Footer totals: a sub-field name, or a labelled sum of several. From EmbeddedFieldDef.totals. */
+    readonly embeddedListTotals?: readonly (string | {
+        readonly label: string;
+        readonly from: readonly string[];
+    })[];
     /** No add, remove, duplicate or move; cells stay editable. From
      *  EditFieldSpec.embeddedList.fixedRows. */
     readonly embeddedListFixedRows?: boolean;

package/dist/hooks/live-refetch-scheduler.d.ts

@@ -0,0 +1,6 @@
+export declare const LIVE_REFETCH_COALESCE_MS = 250;
+export type LiveRefetchScheduler = {
+    readonly trigger: () => void;
+    readonly dispose: () => void;
+};
+export declare function createLiveRefetchScheduler(run: () => Promise<void> | void, windowMs?: number): LiveRefetchScheduler;

package/dist/hooks/live-refetch-scheduler.js

@@ -0,0 +1,45 @@
+export const LIVE_REFETCH_COALESCE_MS = 250;
+// A burst of live events collapses into one trailing run. An event that lands
+// while a run is still in flight queues exactly one follow-up after it.
+export function createLiveRefetchScheduler(run, windowMs = LIVE_REFETCH_COALESCE_MS) {
+    let timer;
+    let inFlight = false;
+    let rerunQueued = false;
+    let disposed = false;
+    const fire = async () => {
+        timer = undefined;
+        inFlight = true;
+        try {
+            await run();
+        }
+        finally {
+            inFlight = false;
+        }
+        if (rerunQueued && !disposed) {
+            rerunQueued = false;
+            await fire();
+        }
+    };
+    return {
+        trigger: () => {
+            // skip: the subscriber is gone
+            if (disposed)
+                return;
+            if (inFlight) {
+                rerunQueued = true;
+                // skip: the queued follow-up run covers this event
+                return;
+            }
+            // skip: a trailing run is already scheduled and will cover this event
+            if (timer !== undefined)
+                return;
+            timer = setTimeout(() => void fire(), windowMs);
+        },
+        dispose: () => {
+            disposed = true;
+            if (timer !== undefined)
+                clearTimeout(timer);
+            timer = undefined;
+        },
+    };
+}

package/dist/hooks/use-query.js

@@ -1,6 +1,7 @@
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useDispatcher, useOptionalQueryPools } from "../context/dispatcher-context.js";
 import { useLiveEvents } from "../sse/live-events.js";
+import { createLiveRefetchScheduler } from "./live-refetch-scheduler.js";
 // Extract the entity-name from a standard Kumiko query type. Returns
 // undefined for non-conforming types so the live-mode silently skips
 // them instead of subscribing to a channel no event will ever match.
@@ -125,9 +126,12 @@ export function useQuery(type, payload, options = {}) {
         // skip: query type has no mapped entity, nothing to subscribe to
         if (entity === undefined)
             return;
-        return subscribeLive(entity, () => {
-            void run();
-        });
-    }, [live, enabled, type, run, subscribeLive]);
+        const scheduler = createLiveRefetchScheduler(() => runFetch(true));
+        const unsubscribe = subscribeLive(entity, scheduler.trigger);
+        return () => {
+            unsubscribe();
+            scheduler.dispose();
+        };
+    }, [live, enabled, type, runFetch, subscribeLive]);
     return { data, error, loading, refetch: run };
 }

package/dist/hooks/use-reference-lookup.d.ts

@@ -18,4 +18,5 @@ export declare function referenceOptionSource(field: {
 export declare function useReferenceLookup(featureName: string, refEntity: string, labelField: string): {
     readonly map: ReferenceLookupMap;
     readonly loading: boolean;
+    readonly failed: boolean;
 };

package/dist/hooks/use-reference-lookup.js

@@ -66,9 +66,12 @@ export function useReferenceLookup(featureName, refEntity, labelField) {
         }
         // System-scope ids (e.g. SYSTEM_TENANT_ID) never have a backing row, so
         // the bulk lookup above never covers them — inject the label directly.
-        if (systemLabel !== undefined)
-            out.set(systemLabel.id, translate(systemLabel.labelKey));
+        if (systemLabel !== undefined) {
+            for (const id of [systemLabel.id, ...(systemLabel.aliases ?? [])]) {
+                out.set(id, translate(systemLabel.labelKey));
+            }
+        }
         return out;
     }, [result.data, labelKey, systemLabel, translate]);
-    return { map, loading: result.loading };
+    return { map, loading: result.loading, failed: result.error !== null };
 }

package/dist/i18n-defaults.js

@@ -58,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",
@@ -68,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.",
@@ -88,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.",
@@ -158,6 +162,13 @@ 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.",
@@ -258,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.",
@@ -283,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

@@ -80,6 +80,8 @@ 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, 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";
@@ -88,6 +90,6 @@ export { createSessionEndedSignal, isSessionEndedError, SESSION_ENDED_ERROR_CODE
 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

@@ -57,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

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":