@cosmicdrift/kumiko-renderer 0.373.0 → 0.374.0

package/dist/app/use-record-actions.d.ts

@@ -0,0 +1,12 @@
+import type { RowAction } from "@cosmicdrift/kumiko-framework/ui-types";
+import type { Translate } from "@cosmicdrift/kumiko-headless";
+import type { RenderEditAction } from "../components/render-edit-types.ts";
+/** Header actions on a record shown by a screen that has no drawer host
+ *  (dashboards): writeHandler, navigate and clientAction, `onWriteSuccess` after a success. */
+export declare function useRecordActions(options: {
+    readonly actions: readonly RowAction[] | undefined;
+    readonly record: Readonly<Record<string, unknown>>;
+    readonly recordId: string;
+    readonly translate: Translate;
+    readonly onWriteSuccess: () => void | Promise<void>;
+}): readonly RenderEditAction[] | undefined;

package/dist/app/use-record-actions.js

@@ -0,0 +1,30 @@
+import { useMemo } from "react";
+import { useOptionalDispatcher } from "../context/dispatcher-context.js";
+import { useClientActionRuntime } from "./client-actions.js";
+import { useNav } from "./nav.js";
+import { useReturnHost } from "./return-to.js";
+import { buildRecordActions } from "./row-actions.js";
+const NO_DRAWER = () => { };
+/** Header actions on a record shown by a screen that has no drawer host
+ *  (dashboards): writeHandler, navigate and clientAction, `onWriteSuccess` after a success. */
+export function useRecordActions(options) {
+    const { actions, record, recordId, translate, onWriteSuccess } = options;
+    const nav = useNav();
+    const host = useReturnHost();
+    const dispatcher = useOptionalDispatcher();
+    const clientActions = useClientActionRuntime();
+    return useMemo(() => actions === undefined
+        ? undefined
+        : buildRecordActions({
+            actions,
+            record,
+            translate,
+            nav,
+            host,
+            dispatcher,
+            openDrawer: NO_DRAWER,
+            onWriteSuccess,
+            defaultWritePayloadId: recordId,
+            clientActions,
+        }), [actions, record, recordId, translate, nav, host, dispatcher, onWriteSuccess, clientActions]);
+}

package/dist/components/grid-cell-for-field.d.ts

@@ -26,6 +26,8 @@ export type GridCellForFieldProps = {
     readonly flow?: boolean;
     readonly layout?: FieldProps["layout"];
     readonly accent?: boolean;
+    /** Passed through to RenderField — see RenderFieldProps.fillDisabled. */
+    readonly fillDisabled?: boolean;
 };
 export declare function fieldCellWidth(field: EditFieldViewModel): FieldCellWidth;
-export declare function GridCellForField({ field, columns, issues, onChange, GridCell, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, flow, layout, accent, }: GridCellForFieldProps): ReactNode;
+export declare function GridCellForField({ field, columns, issues, onChange, GridCell, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, flow, layout, accent, fillDisabled, }: GridCellForFieldProps): ReactNode;

package/dist/components/grid-cell-for-field.js

@@ -29,10 +29,10 @@ export function fieldCellWidth(field) {
         return "full";
     return FIELD_CELL_WIDTH_BY_TYPE[field.type] ?? "text";
 }
-export function GridCellForField({ field, columns, issues, onChange, GridCell, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, flow, layout, accent, }) {
+export function GridCellForField({ field, columns, issues, onChange, GridCell, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, flow, layout, accent, fillDisabled, }) {
     // RenderField renders nothing for a hidden field, but the GridCell around it still claims the row.
     if (!field.visible)
         return null;
     const effectiveSpan = field.span !== undefined ? Math.min(field.span, columns) : 1;
-    return (_jsx(GridCell, { span: effectiveSpan, ...(flow === true && { width: fieldCellWidth(field) }), children: _jsx(RenderField, { field: field, ...(issues !== undefined && { issues }), onChange: onChange, featureName: featureName, ...(labelAppendix !== undefined && { labelAppendix }), ...(fieldAppendix !== undefined && { fieldAppendix }), ...(appendixPlacement !== undefined && { appendixPlacement }), ...(description !== undefined && { description }), ...(status !== undefined && { status }), allIssues: allIssues, valueDisplay: valueDisplay, row: row, ...(changed === true && { changed }), ...(layout !== undefined && { layout }), ...(accent === true && { accent }) }) }));
+    return (_jsx(GridCell, { span: effectiveSpan, ...(flow === true && { width: fieldCellWidth(field) }), children: _jsx(RenderField, { field: field, ...(issues !== undefined && { issues }), onChange: onChange, featureName: featureName, ...(labelAppendix !== undefined && { labelAppendix }), ...(fieldAppendix !== undefined && { fieldAppendix }), ...(appendixPlacement !== undefined && { appendixPlacement }), ...(description !== undefined && { description }), ...(status !== undefined && { status }), allIssues: allIssues, valueDisplay: valueDisplay, row: row, ...(changed === true && { changed }), ...(layout !== undefined && { layout }), ...(accent === true && { accent }), ...(fillDisabled === true && { fillDisabled }) }) }));
 }

package/dist/components/related-list-section.js

@@ -2,11 +2,12 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { evalFieldCondition, normalizeListColumn, parseRefTarget, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-framework/ui-types";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useAppFeatures } from "../app/app-features-context.js";
+import { useClientActionRuntime } from "../app/client-actions.js";
 import { buildFilterFacets, buildFilterPayload, mergeReferenceFacetOptions, resolveProjectionFacetSpecs, } from "../app/list-facets.js";
 import { useNav } from "../app/nav.js";
 import { ReferenceFacetBridges, } from "../app/reference-facet-bridge.js";
 import { navigateWithReturnTo, useReturnHost } from "../app/return-to.js";
-import { buildDefaultEditRowAction, buildProjectionRowActions, buildProjectionToolbarActions, buildRecordActions, runProjectionRowNavigate, } from "../app/row-actions.js";
+import { buildDefaultEditRowAction, buildProjectionRowActions, buildProjectionToolbarActions, buildRecordActions, findRowClickAction, runDrawerRowAction, runProjectionRowNavigate, } from "../app/row-actions.js";
 import { findEditScreenFor } from "../app/screen-access.js";
 import { dispatcherErrorText } from "../app/write-failed-error.js";
 import { useOptionalDispatcher } from "../context/dispatcher-context.js";
@@ -95,6 +96,7 @@ export function RelatedListSection({ section, parentId, record, featureName, tra
     const nav = useNav();
     const host = useReturnHost();
     const dispatcher = useOptionalDispatcher();
+    const clientActions = useClientActionRuntime();
     const appFeatures = useAppFeatures();
     const userRoles = useUserRoles();
     const defaultEditScreen = useMemo(() => {
@@ -196,7 +198,7 @@ export function RelatedListSection({ section, parentId, record, featureName, tra
     // A row-body click target comes from EITHER the legacy `rowClick` field OR
     // a `rowActions` entry marked rowClick:true — the boot-validator rejects
     // both being set, so this order is just a fallback, not a precedence rule.
-    const rowClickAction = section.rowActions?.find((a) => a.kind === "navigate" && a.rowClick === true);
+    const rowClickAction = findRowClickAction(section.rowActions);
     const onRowClick = rowClick !== undefined
         ? (row) => {
             const id = String(row.values[rowClick.idColumn ?? "id"] ?? "");
@@ -205,7 +207,14 @@ export function RelatedListSection({ section, parentId, record, featureName, tra
             navigateWithReturnTo(nav, { entity: rowClick.entity, id }, host);
         }
         : rowClickAction !== undefined
-            ? (row) => runProjectionRowNavigate(nav, rowClickAction, row, host)
+            ? (row) => {
+                if (rowClickAction.kind === "navigate") {
+                    runProjectionRowNavigate(nav, rowClickAction, row, host);
+                }
+                else if (onOpenDrawer !== undefined) {
+                    runDrawerRowAction(rowClickAction, onOpenDrawer, row);
+                }
+            }
             : undefined;
     // Same execution path as projectionList's rowActions (kumiko-screen.tsx) —
     // a relatedList row has the identical "no guaranteed id field" shape a
@@ -220,10 +229,12 @@ export function RelatedListSection({ section, parentId, record, featureName, tra
         openDrawer: onOpenDrawer,
         defaultEditRowAction,
         host,
+        clientActions,
     }), [
         section.rowActions,
         effectiveTranslate,
         dispatcher,
+        clientActions,
         nav,
         refetchSelfAndHost,
         onOpenDrawer,
@@ -283,6 +294,7 @@ export function RelatedListSection({ section, parentId, record, featureName, tra
             dispatcher,
             openDrawer: onOpenDrawer ?? (() => { }),
             onWriteSuccess: refetchSelfAndHost,
+            clientActions,
         })?.[0];
     }, [
         section.emptyState,
@@ -291,6 +303,7 @@ export function RelatedListSection({ section, parentId, record, featureName, tra
         nav,
         host,
         dispatcher,
+        clientActions,
         onOpenDrawer,
         refetchSelfAndHost,
     ]);

package/dist/components/render-edit.js

@@ -1430,7 +1430,7 @@ export function RenderEdit(props) {
                                         appendixPlacement: fieldAppendixPlacement,
                                     }), ...(fieldDescription !== undefined && {
                                         description: fieldDescription(field.field),
-                                    }), allIssues: snapshot.errors, valueDisplay: valueDisplay, row: snapshot.values, ...((!isCreate || markChangedFields) &&
+                                    }), allIssues: snapshot.errors, valueDisplay: valueDisplay, row: snapshot.values, ...(disabled && { fillDisabled: true }), ...((!isCreate || markChangedFields) &&
                                         field.field in snapshot.changes && { changed: true }) }, field.field))) }, gridKey));
                             // Tabs mode: the tab panel is the surface, so field sections render
                             // as unframed padded panels; group cards inside stay framed.

package/dist/components/render-field.d.ts

@@ -39,6 +39,9 @@ export type RenderFieldProps = {
     readonly changed?: boolean;
     readonly layout?: FieldProps["layout"];
     readonly accent?: boolean;
+    /** The surrounding form is locked as a whole: the fill button stays visible
+     *  but inert, unlike a single readOnly field whose fill button keeps working. */
+    readonly fillDisabled?: boolean;
 };
 export declare const AllFieldsRequiredProvider: import("react").Provider<boolean>;
-export declare function RenderField({ field, issues, onChange, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, layout, accent, }: RenderFieldProps): ReactNode;
+export declare function RenderField({ field, issues, onChange, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, layout, accent, fillDisabled, }: RenderFieldProps): ReactNode;

package/dist/components/render-field.js

@@ -2,13 +2,15 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { isFormatSpec, SYSTEM_REFERENCE_LABELS, } from "@cosmicdrift/kumiko-framework/ui-types";
 import { applyFormatSpec, currencyDecimals, EMPTY_VALUE_PLACEHOLDER, } from "@cosmicdrift/kumiko-headless";
 import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
-import { createContext, Fragment, useCallback, useContext, useMemo, useState, } from "react";
+import { createContext, Fragment, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
 import { useAppFeatures } from "../app/app-features-context.js";
 import { useColumnRenderer } from "../app/column-renderers.js";
 import { extensionSectionName } from "../app/extension-sections.js";
 import { toKebab } from "../app/qn.js";
 import { useReferenceLinkResolver } from "../app/reference-link.js";
+import { evalRowExtractor } from "../app/row-actions.js";
 import { screenAccessAllows } from "../app/screen-access.js";
+import { useOptionalDispatcher } from "../context/dispatcher-context.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";
@@ -23,7 +25,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, appendixPlacement, description, status, allIssues, valueDisplay = "form", row, changed, layout, accent, }) {
+export function RenderField({ field, issues, onChange, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay = "form", row, changed, layout, accent, fillDisabled, }) {
     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
@@ -48,7 +50,20 @@ export function RenderField({ field, issues, onChange, featureName, labelAppendi
     // 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, row: row ?? { [field.field]: field.value }, id: id, hasError: hasError, onChange: onChange })) : field.type === "select" &&
         field.selectOptionsAvailabilityQuery !== undefined &&
-        !readOnlyText ? (_jsx(AvailabilityOptionsSelect, { field: field, query: field.selectOptionsAvailabilityQuery.query, payload: field.selectOptionsAvailabilityQuery.payload, row: row ?? { [field.field]: field.value }, id: id, hasError: hasError, onChange: onChange })) : readOnlyText && !isComplexFieldType(field.type) && !isFileFieldType(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({
+        !readOnlyText ? (_jsx(AvailabilityOptionsSelect, { field: field, query: field.selectOptionsAvailabilityQuery.query, payload: field.selectOptionsAvailabilityQuery.payload, row: row ?? { [field.field]: field.value }, id: id, hasError: hasError, onChange: onChange })) : readOnlyText && !isComplexFieldType(field.type) && !isFileFieldType(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 })) : field.fillAction !== undefined ? (_jsx(FillActionControl, { field: field, fillAction: field.fillAction, row: row ?? { [field.field]: field.value }, onChange: onChange, disabled: fillDisabled === true, Banner: Banner, renderControl: (fill) => renderInput({
+            field,
+            id,
+            hasError,
+            onChange,
+            Input,
+            appLocale,
+            Banner,
+            Text,
+            JsonView,
+            t,
+            row,
+            fill,
+        }) })) : (renderInput({
         field,
         id,
         hasError,
@@ -63,6 +78,63 @@ export function RenderField({ field, issues, onChange, featureName, labelAppendi
     }));
     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 }));
 }
+const NUMERIC_FIELD_TYPES = new Set(["number", "bigInt", "decimal"]);
+// A text field takes a number as its string form; a numeric field takes only a
+// number — a string would be sent as a wrong-typed value.
+function fillValueFor(fieldType, result) {
+    if (NUMERIC_FIELD_TYPES.has(fieldType))
+        return typeof result === "number" ? result : undefined;
+    if (typeof result === "string")
+        return result;
+    return typeof result === "number" ? String(result) : undefined;
+}
+// Owns the query state of a fill button. A separate component because RenderField
+// returns early for hidden fields and the dispatcher hook must not be conditional.
+function FillActionControl({ field, fillAction, row, onChange, disabled, Banner, renderControl, }) {
+    const dispatcher = useOptionalDispatcher();
+    const t = useTranslation();
+    const [busy, setBusy] = useState(false);
+    const [failed, setFailed] = useState(false);
+    // A newer click or an unmount cancels the in-flight query so a late answer
+    // cannot overwrite a value the user has since typed.
+    const activeRun = useRef(null);
+    useEffect(() => () => activeRun.current?.abort(), []);
+    const run = async () => {
+        if (dispatcher === undefined) {
+            setFailed(true);
+            return;
+        }
+        activeRun.current?.abort();
+        const ctrl = new AbortController();
+        activeRun.current = ctrl;
+        setBusy(true);
+        setFailed(false);
+        const payload = fillAction.params === undefined ? {} : evalRowExtractor(fillAction.params, row);
+        const result = await dispatcher.query(fillAction.query, payload, {
+            signal: ctrl.signal,
+        });
+        if (ctrl.signal.aborted)
+            return;
+        setBusy(false);
+        if (!result.isSuccess) {
+            setFailed(true);
+            return;
+        }
+        const value = fillValueFor(field.type, propertyOf(result.data, fillAction.field));
+        if (value === undefined) {
+            setFailed(true);
+            return;
+        }
+        onChange(value);
+    };
+    return (_jsxs(_Fragment, { children: [renderControl({
+                label: fillAction.label,
+                onPress: () => void run(),
+                busy,
+                disabled,
+                testId: `field-fill-${field.field}`,
+            }), failed && (_jsx(Banner, { variant: "error", testId: `field-fill-error-${field.field}`, children: t("kumiko.field.fillAction.failed") }))] }));
+}
 // 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`
@@ -330,7 +402,7 @@ function resolveFieldIcon(field) {
 // SelectFieldDef.options). Structural types without a widget (embedded,
 // jsonb, multiSelect) render read-only instead of a data-destroying text
 // fallback (#1834); truly unknown scalar types still fall back to text.
-function renderInput({ field, id, hasError, onChange, Input, appLocale, Banner, Text, JsonView, t, row, }) {
+function renderInput({ field, id, hasError, onChange, Input, appLocale, Banner, Text, JsonView, t, row, fill, }) {
     const common = {
         id,
         name: field.field,
@@ -338,6 +410,14 @@ function renderInput({ field, id, hasError, onChange, Input, appLocale, Banner,
         required: field.required,
         hasError,
     };
+    const placeholderProp = field.placeholder !== undefined ? { placeholder: field.placeholder } : {};
+    const prefix = resolveAffix(field.prefix, row);
+    const suffix = resolveAffix(field.suffix, row);
+    const affixProps = {
+        ...(prefix !== undefined && { prefix }),
+        ...(suffix !== undefined && { suffix }),
+        ...(fill !== undefined && { fill }),
+    };
     switch (field.type) {
         // decimal/bigInt are both plain numbers on the wire (fieldToZod:
         // z.number() / z.number().int().safe()) — the number input's onChange
@@ -347,11 +427,11 @@ function renderInput({ field, id, hasError, onChange, Input, appLocale, Banner,
         case "bigInt": {
             const icon = resolveFieldIcon(field);
             const unit = resolveNumberUnit(field.unit, row);
-            return (_jsx(Input, { kind: "number", ...common, value: numberValue(field.value), onChange: (v) => onChange(v), locale: appLocale, ...(field.grouping !== undefined && { grouping: field.grouping }), ...(field.type === "bigInt" && { integer: true }), ...(icon !== undefined && { icon }), ...(unit !== undefined && { unit }) }));
+            return (_jsx(Input, { kind: "number", ...common, value: numberValue(field.value), onChange: (v) => onChange(v), locale: appLocale, ...(field.grouping !== undefined && { grouping: field.grouping }), ...(field.type === "bigInt" && { integer: true }), ...placeholderProp, ...affixProps, ...(icon !== undefined && { icon }), ...(unit !== undefined && { unit }) }));
         }
         case "decimal": {
             const icon = resolveFieldIcon(field);
-            return (_jsx(Input, { kind: "number", ...common, value: numberValue(field.value), onChange: (v) => onChange(v), locale: appLocale, ...(field.grouping !== undefined && { grouping: field.grouping }), ...(icon !== undefined && { icon }) }));
+            return (_jsx(Input, { kind: "number", ...common, value: numberValue(field.value), onChange: (v) => onChange(v), locale: appLocale, ...(field.grouping !== undefined && { grouping: field.grouping }), ...placeholderProp, ...affixProps, ...(icon !== undefined && { icon }) }));
         }
         case "tz":
             return (_jsx(Input, { kind: "tz", ...common, value: stringValue(field.value), onChange: (v) => onChange(v) }));
@@ -421,10 +501,10 @@ function renderInput({ field, id, hasError, onChange, Input, appLocale, Banner,
             // only supplies an optional `{ rows }` override for it (#1925).
             if (field.type === "longText" || (field.type === "text" && field.multiline)) {
                 const rows = typeof field.multiline === "object" ? field.multiline.rows : undefined;
-                return (_jsx(Input, { kind: "textarea", ...common, value: stringValue(field.value), onChange: (v) => onChange(v), ...(rows !== undefined && { rows }) }));
+                return (_jsx(Input, { kind: "textarea", ...common, value: stringValue(field.value), onChange: (v) => onChange(v), ...(rows !== undefined && { rows }), ...placeholderProp }));
             }
             const icon = resolveFieldIcon(field);
-            return (_jsx(Input, { kind: "text", ...common, value: stringValue(field.value), onChange: (v) => onChange(v), ...(icon !== undefined && { icon }), ...(field.autoComplete !== undefined && { autoComplete: field.autoComplete }) }));
+            return (_jsx(Input, { kind: "text", ...common, value: stringValue(field.value), onChange: (v) => onChange(v), ...placeholderProp, ...affixProps, ...(icon !== undefined && { icon }), ...(field.autoComplete !== undefined && { autoComplete: field.autoComplete }) }));
         }
     }
 }
@@ -479,6 +559,17 @@ function resolveNumberUnit(unit, row) {
     const trimmed = sibling.trim();
     return trimmed.length > 0 && trimmed.length <= MAX_SIBLING_UNIT_LENGTH ? trimmed : undefined;
 }
+// String affix → used as-is (the view model already translated it). Field
+// affix → the live form value; missing, empty or non-scalar means no affix.
+function resolveAffix(affix, row) {
+    if (affix === undefined)
+        return undefined;
+    if (typeof affix === "string")
+        return affix;
+    const value = row?.[affix.field];
+    const text = typeof value === "number" ? String(value) : value;
+    return typeof text === "string" && text.trim().length > 0 ? text.trim() : undefined;
+}
 function stringArrayOf(value) {
     return Array.isArray(value)
         ? value.filter((item) => typeof item === "string")

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.actionForm.success": "Done.",
         "kumiko.actions.retry": "Try again",
         "kumiko.actions.create": "New",
         "kumiko.actions.edit": "Edit",
@@ -39,6 +40,7 @@ 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.fillAction.failed": "Could not fetch a suggestion.",
         "kumiko.field.writeOnly.remove": "Remove stored value",
         "kumiko.field.writeOnly.set": "Set",
         "kumiko.pii.erased": "Deleted",
@@ -128,6 +130,8 @@ export const kumikoDefaultTranslations = {
         "kumiko.dashboard.panel.error.isolated": "The other panels are not affected.",
         "kumiko.dashboard.panel.error.retry": "Try again",
         "kumiko.dashboard.panel.error.title": "{label} could not be loaded",
+        "kumiko.dashboard.progress.unlimited": "unlimited",
+        "kumiko.dashboard.record.missing": "Open this page from a record to see its dashboard.",
         "kumiko.dashboard.time-range": "Time range",
         "kumiko.screen.unavailable": "This page is not available right now.",
         "kumiko.dashboard.brush-end": "Window end",
@@ -192,6 +196,9 @@ export const kumikoDefaultTranslations = {
         "kumiko.aiText.style.expand": "Expand",
         "kumiko.aiText.capExceeded": "Monthly AI limit reached.",
         "kumiko.rowAction.failed": "Action failed",
+        "kumiko.clientAction.success": "Done.",
+        "kumiko.clientAction.unregistered": "This action is not available in this app.",
+        "kumiko.clientAction.failed": "The action could not be completed.",
         "kumiko.contentEditor.insertVariable": "Insert {name}",
         "kumiko.contentEditor.preview": "Preview",
         "kumiko.contentEditor.editMode": "Edit",

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { type Formality, formalLocaleTag } from "@cosmicdrift/kumiko-framework/u
 export { synthesizeActionFormEntity, synthesizeActionFormScreen } from "./app/action-form-shim.ts";
 export type { AppFeaturesProviderProps } from "./app/app-features-context.tsx";
 export { AppFeaturesProvider, useAppFeatures } from "./app/app-features-context.tsx";
+export type { ActionNotice, ActionNotifier, ClientActionHandler, ClientActionOutcome, ClientActionRuntime, ClientActionsMap, } from "./app/client-actions.tsx";
+export { ActionNoticeProvider, ClientActionsProvider, runClientAction, useClientActionHandler, useClientActionRuntime, } from "./app/client-actions.tsx";
 export type { ColumnRendererComponent, ColumnRendererProps, ColumnRenderersMap, ColumnRenderersProviderProps, } from "./app/column-renderers.tsx";
 export { ColumnRenderersProvider, useColumnRenderer } from "./app/column-renderers.tsx";
 export type { ContentEditorComponent, ContentEditorProps, ContentEditorsMap, ContentEditorsProviderProps, } from "./app/content-editors.tsx";
@@ -18,6 +20,7 @@ export type { ExtensionSectionComponent, ExtensionSectionProps, ExtensionSection
 export { ExtensionSectionsProvider, extensionSectionName, useExtensionSectionComponent, } from "./app/extension-sections.tsx";
 export type { AppSchema, FeatureSchema, QualifiedContentCollection, WorkspaceSchema, } from "./app/feature-schema.ts";
 export { isAppSchema, toAppSchema } from "./app/feature-schema.ts";
+export { HeaderActionsBar } from "./app/header-actions-bar.tsx";
 export type { KumikoScreenProps } from "./app/kumiko-screen.tsx";
 export { KumikoScreen, qualifyNavId, qualifyScreenId, ScreenMissingState, } from "./app/kumiko-screen.tsx";
 export type { DateRangeBound, DateRangeValue, ResolvedDateRangeFacet } from "./app/list-facets.ts";
@@ -29,6 +32,7 @@ export type { ReturnHost, ReturnTo } from "./app/return-to.tsx";
 export { navigateToReturn, navigateToReturnOr, navigateWithReturnTo, RETURN_TO_PARAM, ReturnHostProvider, resolveReturnTarget, splitReturnTo, useReturnHost, useReturnTarget, } from "./app/return-to.tsx";
 export type { EmbeddedScreenTarget } from "./app/use-embedded-screen.ts";
 export { useEmbeddedScreen } from "./app/use-embedded-screen.ts";
+export { useRecordActions } from "./app/use-record-actions.ts";
 export type { VariableChipsProps } from "./app/variable-chips.tsx";
 export { VariableChips } from "./app/variable-chips.tsx";
 export { evalVisibleWhen, type VisibleWhenVerdict } from "./app/visible-when.ts";
@@ -75,7 +79,7 @@ export { createStaticLocaleResolver, FormalityProvider, LocaleProvider, mergeTra
 export { kumikoDefaultTranslations } from "./i18n-defaults.ts";
 export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.ts";
 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, 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, 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";

package/dist/index.js

@@ -11,6 +11,7 @@
 export { formalLocaleTag } from "@cosmicdrift/kumiko-framework/ui-types";
 export { synthesizeActionFormEntity, synthesizeActionFormScreen } from "./app/action-form-shim.js";
 export { AppFeaturesProvider, useAppFeatures } from "./app/app-features-context.js";
+export { ActionNoticeProvider, ClientActionsProvider, runClientAction, useClientActionHandler, useClientActionRuntime, } from "./app/client-actions.js";
 export { ColumnRenderersProvider, useColumnRenderer } from "./app/column-renderers.js";
 export { CONTENT_EDITOR_ELEMENT_ID, ContentEditorsProvider, TextareaContentEditor, useContentEditor, } from "./app/content-editors.js";
 export { ContentPreview, substituteVariables } from "./app/content-preview.js";
@@ -19,12 +20,14 @@ export { DashboardBodyProvider, useDashboardBody } from "./app/dashboard-body.js
 export { ExtensionFormRegistryProvider, useExtensionFormSubmit, } from "./app/extension-form-submit.js";
 export { ExtensionSectionsProvider, extensionSectionName, useExtensionSectionComponent, } from "./app/extension-sections.js";
 export { isAppSchema, toAppSchema } from "./app/feature-schema.js";
+export { HeaderActionsBar } from "./app/header-actions-bar.js";
 export { KumikoScreen, qualifyNavId, qualifyScreenId, ScreenMissingState, } from "./app/kumiko-screen.js";
 export { buildDateRangePayload, clampDateRange, readDateRange, resolveDateRangeFacets, } from "./app/list-facets.js";
 export { formatPath, hasDetailScreen, NavProvider, parsePath, resolveTarget, useNav, useNavigateWithInitialValues, useOptionalNav, } from "./app/nav.js";
 export { lastSegment } from "./app/qn.js";
 export { navigateToReturn, navigateToReturnOr, navigateWithReturnTo, RETURN_TO_PARAM, ReturnHostProvider, resolveReturnTarget, splitReturnTo, useReturnHost, useReturnTarget, } from "./app/return-to.js";
 export { useEmbeddedScreen } from "./app/use-embedded-screen.js";
+export { useRecordActions } from "./app/use-record-actions.js";
 export { VariableChips } from "./app/variable-chips.js";
 export { evalVisibleWhen } from "./app/visible-when.js";
 export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error.js";

package/dist/primitives.d.ts

@@ -174,6 +174,17 @@ export type FieldProps = {
 /** Discriminated union — jede Input-Sorte hat ihre eigene value/onChange
  *  Signatur. Custom-Impls dispatchen intern, rendern anders (Toggle
  *  statt Checkbox), oder nur einzelne kinds unterschiedlich. */
+/** Button beside a single-line text/number input that fills it with a
+ *  suggestion. Stays usable on a `disabled` input (the readOnly+fill case). */
+export type InputFillAction = {
+    readonly label: string;
+    readonly onPress: () => void;
+    /** A suggestion is being fetched: the button shows a spinner and is inert. */
+    readonly busy?: boolean;
+    /** The surrounding form is locked as a whole. */
+    readonly disabled?: boolean;
+    readonly testId?: string;
+};
 export type TrailingInputAction = {
     readonly icon: "clear" | "undo";
     readonly label: string;
@@ -211,6 +222,10 @@ export type InputProps = {
     readonly readOnly?: boolean;
     /** Closed FieldIconKey vocabulary (FIELD_ICONS registry, renderer-web). */
     readonly icon?: FieldIconKey;
+    /** Resolved inline text before/after the input (EditFieldSpec.prefix/suffix). */
+    readonly prefix?: string;
+    readonly suffix?: string;
+    readonly fill?: InputFillAction;
     readonly dataAttributes?: DataAttributes;
     /** Raw keydown access (e.g. Enter-to-submit at the field instead of
      *  the surrounding Form). Web forwards it, native impls ignore it
@@ -276,6 +291,9 @@ export type InputProps = {
     /** Resolved display suffix (static or from a sibling field) — never
      *  part of the numeric value. */
     readonly unit?: string;
+    readonly prefix?: string;
+    readonly suffix?: string;
+    readonly fill?: InputFillAction;
 } | {
     readonly kind: "range";
     readonly id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.373.0",
+  "version": "0.374.0",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -15,9 +15,9 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.373.0",
-    "@cosmicdrift/kumiko-headless": "0.373.0",
-    "@cosmicdrift/kumiko-types": "0.373.0",
+    "@cosmicdrift/kumiko-framework": "0.374.0",
+    "@cosmicdrift/kumiko-headless": "0.374.0",
+    "@cosmicdrift/kumiko-types": "0.374.0",
     "react": "^19.2.6",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
@@ -28,7 +28,7 @@
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29.1.1",
     "react-dom": "^19.2.6",
-    "@cosmicdrift/kumiko-locale-de": "0.373.0"
+    "@cosmicdrift/kumiko-locale-de": "0.374.0"
   },
   "repository": {
     "type": "git",

package/src/changes.json

@@ -1,4 +1,28 @@
 [
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "Success box with links, form reset and field placeholder",
+    "detail": "The actionForm success box shows the default text \"Done.\" (kumiko.actionForm.success) next to successMessage links, resetOnSuccess remounts the form with its initial values, and EditFieldSpec.placeholder reaches text, number and textarea inputs."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "Client action registry for row actions",
+    "detail": "ClientActionsProvider, ActionNoticeProvider and runClientAction execute clientAction row actions on list, related list and record actions, with confirm, toast feedback and refetch."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "actionForm load states and drawer row click",
+    "detail": "An actionForm with load queries by the route, drawer or URL id and shows loading, error, not-found and missing-id states; loaded values count as prefill for submitPrefilled. A row click fires a rowClick drawer action in entityList, projectionList and relatedList."
+  },
+  {
+    "version": "0.374.0",
+    "type": "improvement",
+    "title": "Input prefix, suffix and fill button",
+    "detail": "Text and number inputs show prefix and suffix text, and a fillAction renders a button that fetches a suggestion into the field, also for a readOnly field. The Input primitive takes prefix, suffix and fill; renderer-web draws them beside the input."
+  },
   {
     "version": "0.372.0",
     "type": "fix",