@cosmicdrift/kumiko-renderer 0.333.0 → 0.335.0

package/dist/components/render-field.js

@@ -10,7 +10,7 @@ import { screenAccessAllows } from "../app/screen-access.js";
 import { useUserRoles } from "../context/user-roles-context.js";
 import { REFERENCE_COMBOBOX_LIMIT } from "../hooks/reference-limits.js";
 import { useQuery } from "../hooks/use-query.js";
-import { referenceLookupSource } from "../hooks/use-reference-lookup.js";
+import { referenceOptionSource } from "../hooks/use-reference-lookup.js";
 import { useLocale, useTranslation } from "../i18n.js";
 import { usePrimitives } from "../primitives.js";
 import { EmbeddedListField } from "./embedded-list-field.js";
@@ -19,7 +19,7 @@ import { QueryOptionsSelect } from "./query-options-select.js";
 import { ReferenceCreateDialog } from "./reference-create-dialog.js";
 const AllFieldsRequiredContext = createContext(false);
 export const AllFieldsRequiredProvider = AllFieldsRequiredContext.Provider;
-export function RenderField({ field, issues, onChange, featureName, labelAppendix, fieldAppendix, allIssues, valueDisplay = "form", row, changed, }) {
+export function RenderField({ field, issues, onChange, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay = "form", row, changed, layout, accent, }) {
     const { Field, Input, Banner, Text, JsonView } = usePrimitives();
     // App-Locale (i18n) für money/date-Inputs — sonst fielen sie auf
     // navigator.language (Browser-Sprache) zurück statt der gewählten
@@ -42,7 +42,7 @@ export function RenderField({ field, issues, onChange, featureName, labelAppendi
     // Reference-Field rendert eine eigene Component — sie nutzt
     // useQuery() für den Live-Lookup, also muss sie als React-
     // Komponente gemountet werden (nicht als pure render-Call).
-    const control = field.readOnly && field.renderer !== undefined ? (_jsx(FieldRendererOutput, { field: field, renderer: field.renderer, appLocale: appLocale, ...(row !== undefined && { row }) })) : field.type === "embedded" && field.embeddedListCells !== undefined ? (_jsx(EmbeddedListField, { field: field, id: id, onChange: onChange, allIssues: allIssues ?? {}, featureName: featureName ?? "" })) : field.type === "reference" ? (readOnlyText ? (_jsx(ReadOnlyReferenceValue, { field: field, featureName: featureName ?? "" })) : (_jsx(ReferenceInput, { field: field, id: id, hasError: hasError, onChange: onChange, Input: Input, featureName: featureName ?? "" }))) : field.type === "select" && field.selectOptionsQuery !== undefined && !readOnlyText ? (_jsx(QueryOptionsSelect, { field: field, query: field.selectOptionsQuery.query, payload: field.selectOptionsQuery.payload, id: id, hasError: hasError, onChange: onChange })) : readOnlyText && !isComplexFieldType(field.type) ? (_jsx(Text, { testId: `field-value-${field.field}`, children: readOnlyDisplayText(field, appLocale) })) : (renderInput({
+    const control = field.readOnly && field.renderer !== undefined ? (_jsx(FieldRendererOutput, { field: field, renderer: field.renderer, appLocale: appLocale, ...(row !== undefined && { row }) })) : field.type === "embedded" && field.embeddedListCells !== undefined ? (_jsx(EmbeddedListField, { field: field, id: id, onChange: onChange, allIssues: allIssues ?? {}, featureName: featureName ?? "" })) : field.type === "reference" ? (readOnlyText ? (_jsx(ReadOnlyReferenceValue, { field: field, featureName: featureName ?? "" })) : (_jsx(ReferenceInput, { field: field, id: id, hasError: hasError, onChange: onChange, Input: Input, featureName: featureName ?? "" }))) : field.type === "select" && field.selectOptionsQuery !== undefined && !readOnlyText ? (_jsx(QueryOptionsSelect, { field: field, query: field.selectOptionsQuery.query, payload: field.selectOptionsQuery.payload, row: row ?? { [field.field]: field.value }, id: id, hasError: hasError, onChange: onChange })) : readOnlyText && !isComplexFieldType(field.type) ? (_jsx(Text, { testId: `field-value-${field.field}`, children: readOnlyDisplayText(field, appLocale, t) })) : field.type === "text" && field.writeOnly === true && !readOnlyText ? (_jsx(WriteOnlyTextInput, { field: field, id: id, hasError: hasError, onChange: onChange, changed: changed === true })) : (renderInput({
         field,
         id,
         hasError,
@@ -55,17 +55,33 @@ export function RenderField({ field, issues, onChange, featureName, labelAppendi
         t,
         row,
     }));
-    return (_jsx(Field, { id: id, label: field.label, required: field.required && field.type !== "boolean" && !allFieldsRequired, ...(issues !== undefined && { issues }), ...(labelAppendix !== undefined && { labelAppendix }), ...(fieldAppendix !== undefined && { fieldAppendix }), ...(changed === true && { changed }), testId: `field-${field.field}`, children: control }));
+    return (_jsx(Field, { id: id, label: field.label, required: field.required && field.type !== "boolean" && !allFieldsRequired, ...(issues !== undefined && { issues }), ...(labelAppendix !== undefined && { labelAppendix }), ...(fieldAppendix !== undefined && { fieldAppendix }), ...(appendixPlacement !== undefined && { appendixPlacement }), ...(description !== undefined && { description }), ...(status !== undefined && { status }), ...(changed === true && { changed }), ...(layout !== undefined && { layout }), ...(accent === true && { accent }), testId: `field-${field.field}`, children: control }));
 }
-// Where a reference field's option rows come from, and which of their keys
-// holds the display text — the entity's own list handler plus `refLabelField`
-// by default, or an author-supplied handler whose rows carry `label`
-// (fw#2780), for targets with no readable column of their own.
-function referenceOptionSource(field, refFeature, refEntity) {
-    if (field.refOptionsQuery !== undefined) {
-        return { queryQn: field.refOptionsQuery, labelKey: "label" };
+// Wire value of a writeOnly field is `true` (set) / `null` (empty), never the
+// secret. Typing sets a new value; an untouched or emptied input submits
+// nothing / "" which the server reads as "keep". `null` after a loaded `true`
+// (changed) means "remove on save".
+function WriteOnlyTextInput({ field, id, hasError, onChange, changed, }) {
+    const { Input } = usePrimitives();
+    const t = useTranslation();
+    const isSet = field.value === true;
+    const isMarkedForRemoval = field.value === null && changed;
+    if (isMarkedForRemoval) {
+        return (_jsx(Input, { kind: "password", id: id, name: field.field, disabled: true, hasError: hasError, value: "", onChange: () => { }, autoComplete: "new-password", placeholder: t("kumiko.field.writeOnly.willRemove"), testId: `field-write-only-removal-${field.field}`, trailingAction: {
+                icon: "undo",
+                label: t("kumiko.field.writeOnly.undo"),
+                onPress: () => onChange(true),
+            } }));
     }
-    return referenceLookupSource(refFeature, refEntity, field.refLabelField ?? "id");
+    return (_jsx(Input, { kind: "password", id: id, name: field.field, disabled: field.readOnly, required: field.required && !isSet, hasError: hasError, value: typeof field.value === "string" ? field.value : "", onChange: (v) => onChange(v), autoComplete: "new-password", ...(isSet && { placeholder: t("kumiko.field.writeOnly.setPlaceholder") }), ...(isSet &&
+            !field.required &&
+            !field.readOnly && {
+            trailingAction: {
+                icon: "clear",
+                label: t("kumiko.field.writeOnly.remove"),
+                onPress: () => onChange(null),
+            },
+        }) }));
 }
 // Tier 2.7e-3 + 2.1c: Reference-Input rendert eine Searchable Combobox
 // gefüllt aus einer Live-Query auf die referenced Entity. Default-
@@ -438,15 +454,22 @@ function resolveMoneyCurrency(value, fieldCurrency) {
     }
     return fieldCurrency ?? "EUR";
 }
+// The suffix span is absolutely positioned inside a fixed right padding sized
+// for short symbols; a free-text sibling value longer than any real unit
+// symbol would overflow the number.
+const MAX_SIBLING_UNIT_LENGTH = 8;
 // Static unit → used as-is. Sibling-field reference → read the live row
-// value; missing/empty/non-string sibling means no suffix, never a guess.
+// value; missing/empty/non-string/overlong sibling means no suffix, never a guess.
 function resolveNumberUnit(unit, row) {
     if (unit === undefined)
         return undefined;
     if (typeof unit === "string")
         return unit;
     const sibling = row?.[unit.field];
-    return typeof sibling === "string" && sibling.length > 0 ? sibling : undefined;
+    if (typeof sibling !== "string")
+        return undefined;
+    const trimmed = sibling.trim();
+    return trimmed.length > 0 && trimmed.length <= MAX_SIBLING_UNIT_LENGTH ? trimmed : undefined;
 }
 function moneyMinorValue(v, currency) {
     if (v === undefined || v === null || v === "")
@@ -488,10 +511,12 @@ function locatedValue(v) {
 // covered here — it needs a live label lookup, see ReadOnlyReferenceValue.
 // `isComplexFieldType` types aren't covered either — callers keep those on
 // `renderInput`'s existing Banner fallback.
-function readOnlyDisplayText(field, appLocale) {
+function readOnlyDisplayText(field, appLocale, t) {
     const { type, value } = field;
     if (value === undefined || value === null || value === "")
         return "—";
+    if (type === "text" && field.writeOnly === true)
+        return t("kumiko.field.writeOnly.set");
     if (type === "text" && field.format === "password")
         return "••••••••";
     switch (type) {

package/dist/components/render-list.js

@@ -6,11 +6,11 @@ import { useReferenceLookup } from "../hooks/use-reference-lookup.js";
 import { useTranslation } from "../i18n.js";
 import { usePageHeaderCompact, usePageHeaderSlotAvailable } from "../page-header-slot.js";
 import { shouldRenderActionsIconOnly, usePrimitives, } from "../primitives.js";
+import { needsActionConfirm } from "./render-edit-action-button.js";
 const SEARCH_DEBOUNCE_MS = 300;
-// Fire-and-forget actions (schema navigate/drawer) can leave the toolbar for the
-// page header without losing the confirm dialog or busy/error surfacing.
+// Icon-less actions are promoted too (with a "plus" fallback at the call site).
 function isHeaderPromotableToolbarAction(action) {
-    return (action.style === "primary" && action.confirm === undefined && action.confirmRequired === false);
+    return action.style === "primary" && !needsActionConfirm(action);
 }
 export function RenderList(props) {
     const { screen, entity, rows, featureName, translate: translateProp, onRowClick, emptyState, onCreate, createLabel, searchable = false, searchPlaceholder, description, itemNounKey, searchValue, onSearchChange, sort, onSortChange, pager, onReachEnd, loadingMore, hasMore, rowActions, rowActionMode, rowGrouping, rowTone, toolbarActions, filterFacets, filterValues, onFilterChange, onFilterReset, dateRangeFacets, onDateRangeChange, chromeless, scrollBody, screenPadding, expandedRowIds, onToggleRowExpanded, renderExpandedRow, } = props;
@@ -147,7 +147,7 @@ export function RenderList(props) {
         pageHeaderCompact
         ? toolbarActions?.find(isHeaderPromotableToolbarAction)
         : undefined;
-    const promotedActionButton = promotedToolbarAction !== undefined ? (_jsx(Button, { variant: "primary", icon: promotedToolbarAction.icon ?? "plus", size: "icon", ariaLabel: promotedToolbarAction.label, title: promotedToolbarAction.label, onClick: () => void promotedToolbarAction.onTrigger(), testId: `render-list-toolbar-action-${promotedToolbarAction.id}` })) : undefined;
+    const promotedActionButton = promotedToolbarAction !== undefined ? (_jsx(ToolbarActionView, { action: { ...promotedToolbarAction, icon: promotedToolbarAction.icon ?? "plus" }, iconOnly: true, Button: Button, Dialog: Dialog, Banner: Banner })) : undefined;
     const toolbarActionsInToolbar = toolbarActions?.filter((a) => a !== promotedToolbarAction) ?? [];
     const hasToolbarActionsInToolbar = toolbarActionsInToolbar.length > 0;
     const toolbarEnd = hasHeaderSlot ||
@@ -239,9 +239,9 @@ function ToolbarActionView({ action, iconOnly = false, Button, Dialog, Banner, }
         }
     };
     const variant = action.style ?? "secondary";
-    const needsConfirm = action.confirm !== undefined || (action.confirmRequired ?? action.style === "danger");
+    const needsConfirm = needsActionConfirm(action);
     const showIconOnly = iconOnly && action.icon !== undefined;
-    return (_jsxs(_Fragment, { children: [_jsx(Button, { variant: variant, loading: busy, ...(action.icon !== undefined && { icon: action.icon }), size: showIconOnly ? "icon" : "sm", ...(showIconOnly && { ariaLabel: action.label }), onClick: () => {
+    return (_jsxs(_Fragment, { children: [_jsx(Button, { variant: variant, loading: busy, ...(action.icon !== undefined && { icon: action.icon }), size: showIconOnly ? "icon" : "sm", ...(showIconOnly && { ariaLabel: action.label, title: action.label }), onClick: () => {
                     if (needsConfirm) {
                         setConfirmOpen(true);
                     }

package/dist/components/write-form-section.d.ts

@@ -13,5 +13,9 @@ export type WriteFormSectionProps = {
      *  rendered alongside (before) the section's own submit button in the
      *  title-row actions slot. */
     readonly actions?: ReactNode;
+    /** Set when this section is a whole tab: the submit button is handed to
+     *  the host form's footer (pinned like every other screen's save) instead
+     *  of the section's title row. Called with undefined on unmount. */
+    readonly onFooterAction?: (action: ReactNode | undefined) => void;
 };
-export declare function WriteFormSection({ section, featureName, translate, hideTitle, onSubmitted, actions, }: WriteFormSectionProps): ReactNode;
+export declare function WriteFormSection({ section, featureName, translate, hideTitle, onSubmitted, actions, onFooterAction, }: WriteFormSectionProps): ReactNode;

package/dist/components/write-form-section.js

@@ -1,25 +1,14 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { I18N_KEY_PARAM } from "@cosmicdrift/kumiko-headless";
-import { useMemo, useState } from "react";
+import { useEffect, useMemo, useRef, useState } from "react";
 import * as z from "zod";
-import { REQUIRED_FIELD_I18N_KEY } from "../app/form-schema.js";
+import { isPresent, REQUIRED_FIELD_I18N_KEY } from "../app/form-schema.js";
 import { dispatcherErrorText } from "../app/write-failed-error.js";
 import { useForm } from "../hooks/use-form.js";
 import { useTranslation } from "../i18n.js";
-import { usePrimitives } from "../primitives.js";
+import { STICKY_PRIMARY_ACTION_PROP, usePrimitives } from "../primitives.js";
 import { GridCellForField } from "./grid-cell-for-field.js";
-// Same "has a value" rule as buildFormSchema's isPresent (app/form-schema.ts)
-// — duplicated because that helper walks raw EditFieldSpec + EntityDefinition,
-// unavailable here: this section only ever sees computeEditViewModel's
-// already-resolved EditFieldViewModel[] (required/readOnly/visible are plain
-// booleans by the time render-edit.tsx hands the section to this component).
-function isPresent(value) {
-    if (value === undefined || value === null || value === "")
-        return false;
-    if (Array.isArray(value) && value.length === 0)
-        return false;
-    return true;
-}
+import { hasIssueWithoutVisibleField } from "./render-edit-logic.js";
 function buildWriteFormSchema(fields) {
     return z
         .object({})
@@ -45,7 +34,7 @@ function buildWriteFormSchema(fields) {
 // would render a second, invalid nested <form> inside the host's own form
 // element — so this mounts its own independent useForm() controller and
 // submits via a plain button click instead of native form submission.
-export function WriteFormSection({ section, featureName, translate, hideTitle, onSubmitted, actions, }) {
+export function WriteFormSection({ section, featureName, translate, hideTitle, onSubmitted, actions, onFooterAction, }) {
     const { Section, Card, Grid, GridCell, Button, Banner } = usePrimitives();
     const t = useTranslation();
     const effectiveTranslate = translate ?? t;
@@ -71,11 +60,14 @@ export function WriteFormSection({ section, featureName, translate, hideTitle, o
             }
             if (result.validationBlocked)
                 return;
-            // Field-level issues already surface inline via snapshot.errors (same
-            // GridCellForField/RenderField path RenderEdit uses) — the banner is
-            // only for form-level errors nothing else would show (fw#1901 pattern).
-            const fieldIssues = result.error.details?.fields ?? [];
-            setError(fieldIssues.length === 0 ? dispatcherErrorText(result.error, effectiveTranslate) : null);
+            // Field-level issues surface inline via snapshot.errors (same
+            // GridCellForField/RenderField path RenderEdit uses) — the banner stays
+            // for anything no rendered field can show (`version`, `id`, a root
+            // refine, a hidden field).
+            const issuePaths = (result.error.details?.fields ?? []).map((i) => i.path);
+            setError(hasIssueWithoutVisibleField(issuePaths, section.fields)
+                ? dispatcherErrorText(result.error, effectiveTranslate)
+                : null);
         }
         finally {
             setIsSubmitting(false);
@@ -85,8 +77,20 @@ export function WriteFormSection({ section, featureName, translate, hideTitle, o
     // type="button" (not "submit") is load-bearing: this section is deliberately
     // NOT a nested <form> (see the component doc above), so a "submit" type
     // would instead trigger the host RenderEdit's own form submit.
-    const submitButton = (_jsx(Button, { type: "button", variant: "primary", disabled: isSubmitting, loading: isSubmitting, onClick: () => void handleSubmit(), testId: "write-form-section-submit", children: section.submitLabel ?? effectiveTranslate("kumiko.actions.save") }));
-    const titleRowActions = actions !== undefined ? (_jsxs(_Fragment, { children: [actions, submitButton] })) : (submitButton);
+    // The footer copy of the button outlives this render, so it calls the
+    // latest handleSubmit through a ref instead of capturing a stale closure.
+    const handleSubmitRef = useRef(handleSubmit);
+    handleSubmitRef.current = handleSubmit;
+    const submitLabel = section.submitLabel ?? effectiveTranslate("kumiko.actions.save");
+    const submitButton = (_jsx(Button, { type: "button", variant: "primary", disabled: isSubmitting, loading: isSubmitting, onClick: () => void handleSubmitRef.current(), testId: "write-form-section-submit", [STICKY_PRIMARY_ACTION_PROP]: true, children: submitLabel }));
+    // biome-ignore lint/correctness/useExhaustiveDependencies: submitButton is rebuilt every render; isSubmitting and submitLabel are everything it shows.
+    useEffect(() => {
+        if (onFooterAction === undefined)
+            return;
+        onFooterAction(submitButton);
+        return () => onFooterAction(undefined);
+    }, [onFooterAction, isSubmitting, submitLabel]);
+    const titleRowActions = onFooterAction !== undefined ? (actions) : actions !== undefined ? (_jsxs(_Fragment, { children: [actions, submitButton] })) : (submitButton);
     // Section always flattens to a borderless divider when rendered inside
     // RenderEdit's own <Form> in tabs mode (hideTitle) — an unframed Card panel
     // stands in, like render-edit.tsx's tabs-mode fields/extension branches.
@@ -94,10 +98,10 @@ export function WriteFormSection({ section, featureName, translate, hideTitle, o
         return (_jsx(Card, { options: { framed: false }, slots: {
                 ...(section.description !== undefined && { subtitle: section.description }),
                 headerActions: titleRowActions,
-            }, testId: `write-form-${section.title ?? "section"}`, children: content }));
+            }, testId: `write-form-${section.title ?? section.handler}`, children: content }));
     }
     // Routed through Section's `actions` slot (same mechanism render-edit.tsx
     // uses via Form's `actions`) so the button gets the established right-
     // aligned footer treatment instead of stretching full-width inline.
-    return (_jsx(Section, { ...(section.title !== undefined && { title: section.title }), ...(section.description !== undefined && { subtitle: section.description }), ...(section.icon !== undefined && { icon: section.icon }), actions: titleRowActions, testId: `write-form-${section.title ?? "section"}`, children: content }));
+    return (_jsx(Section, { ...(section.title !== undefined && { title: section.title }), ...(section.description !== undefined && { subtitle: section.description }), ...(section.icon !== undefined && { icon: section.icon }), actions: titleRowActions, testId: `write-form-${section.title ?? section.handler}`, children: content }));
 }

package/dist/context/embedded-screen-context.d.ts

@@ -0,0 +1,5 @@
+import { type ReactNode } from "react";
+export declare function EmbeddedScreenProvider({ children }: {
+    readonly children: ReactNode;
+}): ReactNode;
+export declare function useIsEmbeddedScreen(): boolean;

package/dist/context/embedded-screen-context.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+// A host that already frames and pads the embedded screen (dashboard panel
+// with `chromeless`) marks the subtree, so list screens drop their own
+// screen padding and card frame instead of stacking it on the host's.
+const EmbeddedScreenContext = createContext(false);
+export function EmbeddedScreenProvider({ children }) {
+    return _jsx(EmbeddedScreenContext, { value: true, children: children });
+}
+export function useIsEmbeddedScreen() {
+    return useContext(EmbeddedScreenContext);
+}

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

@@ -6,6 +6,13 @@ export declare function referenceLookupSource(refFeature: string, refEntity: str
     readonly queryQn: string;
     readonly labelKey: string;
 };
+export declare function referenceOptionSource(field: {
+    readonly refLabelField?: string;
+    readonly refOptionsQuery?: string;
+}, refFeature: string, refEntity: string): {
+    readonly queryQn: string;
+    readonly labelKey: string;
+};
 /** Empty while the query loads (or fails), so callers fall back to the raw id.
  *  `featureName` is the reference's target feature, not the screen's. */
 export declare function useReferenceLookup(featureName: string, refEntity: string, labelField: string): {

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

@@ -34,6 +34,16 @@ export function referenceLookupSource(refFeature, refEntity, labelField) {
         labelKey: labelField,
     };
 }
+// Where a reference field's option rows come from, and which of their keys
+// holds the display text — the entity's own list handler plus `refLabelField`
+// by default, or an author-supplied handler whose rows carry `label`
+// (fw#2780), for targets with no readable column of their own.
+export function referenceOptionSource(field, refFeature, refEntity) {
+    if (field.refOptionsQuery !== undefined) {
+        return { queryQn: field.refOptionsQuery, labelKey: "label" };
+    }
+    return referenceLookupSource(refFeature, refEntity, field.refLabelField ?? "id");
+}
 /** Empty while the query loads (or fails), so callers fall back to the raw id.
  *  `featureName` is the reference's target feature, not the screen's. */
 export function useReferenceLookup(featureName, refEntity, labelField) {

package/dist/i18n-defaults.js

@@ -14,6 +14,7 @@ export const kumikoDefaultTranslations = {
         "kumiko.actions.delete": "Delete",
         "kumiko.actions.delete-confirm": "Confirm delete?",
         "kumiko.actions.reload": "Reload",
+        "kumiko.actions.retry": "Try again",
         "kumiko.actions.create": "New",
         "kumiko.actions.edit": "Edit",
         "kumiko.actions.view": "View",
@@ -36,6 +37,11 @@ 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.writeOnly.remove": "Remove stored value",
+        "kumiko.field.writeOnly.set": "Set",
+        "kumiko.field.writeOnly.setPlaceholder": "Set — leave empty to keep it",
+        "kumiko.field.writeOnly.undo": "Undo",
+        "kumiko.field.writeOnly.willRemove": "Removed on save",
         "kumiko.field.embedded-list.add-row": "Add row",
         "kumiko.field.embedded-list.remove-row": "Remove row",
         "kumiko.field.embedded-list.duplicate-row": "Duplicate row",
@@ -77,6 +83,9 @@ export const kumikoDefaultTranslations = {
         "kumiko.list.sort.by": "Sorted by {column}",
         "kumiko.form.changed": "changed",
         "kumiko.form.on-this-page": "On this page",
+        "kumiko.form.noUnsavedChanges": "No unsaved changes",
+        "kumiko.form.discard": "Discard",
+        "kumiko.form.saveChanges": "Save changes",
         "kumiko.form.unsaved.one": "1 unsaved change",
         "kumiko.form.unsaved.other": "{count} unsaved changes",
         "kumiko.wizard.next-with-title": "Next: {title}",
@@ -153,16 +162,30 @@ export const kumikoDefaultTranslations = {
         "kumiko.contentEditor.heading2": "Heading 2",
         "kumiko.contentEditor.bulletList": "Bullet list",
         "kumiko.contentEditor.orderedList": "Numbered list",
-        "kumiko.config.source.user": "My value",
+        "kumiko.config.source.user": "Your value",
         "kumiko.config.source.tenant": "Tenant",
-        "kumiko.config.source.system": "System",
+        "kumiko.config.source.system": "Platform",
         "kumiko.config.source.appOverride": "App override",
         "kumiko.config.source.computed": "Computed",
         "kumiko.config.source.default": "Default",
         "kumiko.config.source.missing": "Missing",
-        "kumiko.config.cascade.noValue": "No value set",
-        "kumiko.config.cascade.activeMarker": "active",
-        "kumiko.config.cascade.resetTo": "Reset override ({scope})",
+        "kumiko.config.cascade.noValue": "Not set",
+        "kumiko.config.cascade.noDefault": "not set",
+        "kumiko.config.cascade.notSetRequired": "Not set. Required.",
+        "kumiko.config.cascade.activeMarker": "in use",
+        "kumiko.config.cascade.resetTo": "Reset to default",
+        "kumiko.config.cascade.resetToApp": "Reset to app value",
+        "kumiko.config.cascade.showLevels": "Show all levels",
+        "kumiko.config.cascade.hideLevels": "Hide levels",
+        "kumiko.config.cascade.on": "On",
+        "kumiko.config.cascade.off": "Off",
+        "kumiko.config.cascade.origin.tenant": "Set for this tenant. Default is {value}.",
+        "kumiko.config.cascade.origin.user": "Set by you. Default is {value}.",
+        "kumiko.config.cascade.originNoDefault.tenant": "Set for this tenant.",
+        "kumiko.config.cascade.originNoDefault.user": "Set by you.",
+        "kumiko.config.cascade.originNoDefault.system": "Set for the platform.",
+        "kumiko.config.cascade.origin.system": "Set for the platform. App default is {value}.",
+        "kumiko.config.cascade.origin.default": "Uses the default",
         "kumiko.form.error.generic": "Something went wrong.",
         "kumiko.form.error.version-conflict": "Record was modified in the meantime. Reload and try again.",
         "kumiko.form.extension.save-failed": "A custom field could not be saved.",
@@ -183,6 +206,8 @@ export const kumikoDefaultTranslations = {
         "errors.validation.invalid_type": "Invalid value.",
         "errors.validation.too_small": "Too small or too short (minimum: {minimum}).",
         "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.not_multiple_of": "Must be a multiple of {divisor}.",
         "errors.validation.unrecognized_keys": "Unknown fields.",

package/dist/i18n.js

@@ -65,7 +65,8 @@ export function useLocale() {
     }
     // Subscribe + current locale-snapshot. Wir brauchen den Rückgabewert
     // selbst nicht — wichtig ist nur der re-render-trigger.
-    useSyncExternalStore(ctx.resolver.subscribe, () => ctx.resolver.locale(), () => ctx.resolver.locale());
+    const getLocaleSnapshot = () => ctx.resolver.locale();
+    useSyncExternalStore(ctx.resolver.subscribe, getLocaleSnapshot, getLocaleSnapshot);
     return ctx.resolver;
 }
 /** `t("key", params)` resolves in this order:
@@ -83,7 +84,8 @@ export function useTranslation() {
     // Re-Render bei Sprach-Wechsel. `ctx.resolver.subscribe` ist bereits
     // eine stable-reference aus dem Resolver, daher hier keine eigene
     // Memoization der Subscribe-Callback nötig.
-    const locale = useSyncExternalStore(ctx.resolver.subscribe, () => ctx.resolver.locale(), () => ctx.resolver.locale());
+    const getLocaleSnapshot = () => ctx.resolver.locale();
+    const locale = useSyncExternalStore(ctx.resolver.subscribe, getLocaleSnapshot, getLocaleSnapshot);
     // `t` MUSS referenz-stabil sein solange sich Resolver/Bundles/Locale
     // nicht ändern — Consumer nutzen `t` regelmäßig in useEffect-Deps
     // (z.B. um Queries neu zu laden wenn sich die Sprache ändert). Ein neu
@@ -132,7 +134,8 @@ function bundleLocaleTiers(locale, fallbackLocale, formality) {
  *  Used by DataTable FormatCell so plain tables without a provider do not crash. */
 export function useOptionalLocale() {
     const ctx = useContext(LocaleContext);
-    useSyncExternalStore((onStoreChange) => (ctx ? ctx.resolver.subscribe(onStoreChange) : () => { }), () => (ctx ? ctx.resolver.locale() : "en"), () => (ctx ? ctx.resolver.locale() : "en"));
+    const getLocaleSnapshot = () => (ctx ? ctx.resolver.locale() : "en");
+    useSyncExternalStore((onStoreChange) => (ctx ? ctx.resolver.subscribe(onStoreChange) : () => { }), getLocaleSnapshot, getLocaleSnapshot);
     return ctx === undefined ? undefined : ctx.resolver.locale();
 }
 /** Non-throwing time-zone read — "UTC" outside LocaleProvider, matching
@@ -144,7 +147,8 @@ export function useOptionalTimeZone() {
 /** Non-throwing translate — undefined outside LocaleProvider. */
 export function useOptionalTranslation() {
     const ctx = useContext(LocaleContext);
-    const locale = useSyncExternalStore((onStoreChange) => (ctx ? ctx.resolver.subscribe(onStoreChange) : () => { }), () => (ctx ? ctx.resolver.locale() : "en"), () => (ctx ? ctx.resolver.locale() : "en"));
+    const getLocaleSnapshot = () => (ctx ? ctx.resolver.locale() : "en");
+    const locale = useSyncExternalStore((onStoreChange) => (ctx ? ctx.resolver.subscribe(onStoreChange) : () => { }), getLocaleSnapshot, getLocaleSnapshot);
     const formality = useContext(FormalityContext);
     const t = useCallback((key, params) => ctx === undefined ? key : translateWithFallbacks(ctx, locale, formality, key, params), [ctx, locale, formality]);
     return ctx === undefined ? undefined : t;

package/dist/index.d.ts

@@ -35,6 +35,7 @@ export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error.
 export { RelatedListSection } from "./components/related-list-section.js";
 export type { RenderEditAction, RenderEditChangeState, RenderEditControls, RenderEditProps, } from "./components/render-edit.js";
 export { RenderEdit } from "./components/render-edit.js";
+export { needsActionConfirm } from "./components/render-edit-action-button.js";
 export type { RenderFieldProps } from "./components/render-field.js";
 export { RenderField } from "./components/render-field.js";
 export type { RenderListProps } from "./components/render-list.js";
@@ -43,6 +44,7 @@ export type { DispatcherProviderProps } from "./context/dispatcher-context.js";
 export { DispatcherProvider, useDispatcher, useDispatcherStatus, useOptionalDispatcher, } from "./context/dispatcher-context.js";
 export type { DraftStorage, DraftStorageProviderProps } from "./context/draft-storage-context.js";
 export { DraftStorageProvider, useDraftStorage } from "./context/draft-storage-context.js";
+export { EmbeddedScreenProvider, useIsEmbeddedScreen } from "./context/embedded-screen-context.js";
 export type { UserRolesProviderProps } from "./context/user-roles-context.js";
 export { UserRolesProvider, useUserRoles } from "./context/user-roles-context.js";
 export { formatWhen } from "./format-when.js";
@@ -67,8 +69,10 @@ export { createStaticLocaleResolver, FormalityProvider, LocaleProvider, mergeTra
 export { kumikoDefaultTranslations } from "./i18n-defaults.js";
 export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.js";
 export { PageHeaderCompactProvider, PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "./page-header-slot.js";
-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, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputProps, JsonViewProps, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, WizardStepGroupProps, } from "./primitives.js";
+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, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputProps, JsonViewProps, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.js";
 export { PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, usePrimitives, } from "./primitives.js";
+export type { SessionEndedSignal, SessionEndedSignalProviderProps, } from "./session/session-ended.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 type { LiveEvent, LiveEventSubscriber, LiveEventsProviderProps } from "./sse/live-events.js";

package/dist/index.js

@@ -29,10 +29,12 @@ export { VariableChips } from "./app/variable-chips.js";
 export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error.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";
 export { RenderField } from "./components/render-field.js";
 export { RenderList } from "./components/render-list.js";
 export { DispatcherProvider, useDispatcher, useDispatcherStatus, useOptionalDispatcher, } from "./context/dispatcher-context.js";
 export { DraftStorageProvider, useDraftStorage } from "./context/draft-storage-context.js";
+export { EmbeddedScreenProvider, useIsEmbeddedScreen } from "./context/embedded-screen-context.js";
 export { UserRolesProvider, useUserRoles } from "./context/user-roles-context.js";
 export { formatWhen } from "./format-when.js";
 export { REFERENCE_COMBOBOX_LIMIT, REFERENCE_LIST_LOOKUP_LIMIT, REFERENCE_SEARCH_DEBOUNCE_MS, } from "./hooks/reference-limits.js";
@@ -49,6 +51,7 @@ export { kumikoDefaultTranslations } from "./i18n-defaults.js";
 export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.js";
 export { PageHeaderCompactProvider, PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "./page-header-slot.js";
 export { PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, 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";