@cosmicdrift/kumiko-renderer 0.373.0 → 0.374.0

package/dist/app/kumiko-screen.js

@@ -9,9 +9,7 @@ import { Fragment, useCallback, useEffect, useMemo, useRef, useState } from "rea
 import { QueryOptionLabel, resolveOptionsQueryPayload, } from "../components/query-options-select.js";
 import { extractCreatedId, extractIdField } from "../components/reference-create-dialog.js";
 import { RenderEdit, resolveRecordTitle, } from "../components/render-edit.js";
-import { RenderEditActionButton } from "../components/render-edit-action-button.js";
 import { RenderList } from "../components/render-list.js";
-import { useActionMenuItems } from "../components/use-action-menu-items.js";
 import { useDispatcher, useOptionalDispatcher } from "../context/dispatcher-context.js";
 import { useIsEmbeddedScreen } from "../context/embedded-screen-context.js";
 import { useUserRoles } from "../context/user-roles-context.js";
@@ -26,7 +24,9 @@ import { PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlo
 import { statusToneForOptionTone, statusToneForValue, usePrimitives, } from "../primitives.js";
 import { screenFillsHeight } from "../screen-fills-height.js";
 import { actionFormSubmittableFields, synthesizeActionFormEntity, synthesizeActionFormScreen, } from "./action-form-shim.js";
+import { ActionFormLoadStatus, ActionFormSuccessBanner, isSecretFormField, resolveActionFormRecordId, useActionFormLoad, } from "./action-form-support.js";
 import { useAppFeatures } from "./app-features-context.js";
+import { useClientActionRuntime } from "./client-actions.js";
 import { buildConfigEditSchema, synthesizeConfigEditEntity, synthesizeConfigEditScreen, } from "./config-edit-shim.js";
 import { useCustomScreenComponent } from "./custom-screens.js";
 import { useDashboardBody } from "./dashboard-body.js";
@@ -34,7 +34,7 @@ import { applyEditPrefill } from "./edit-prefill.js";
 import { EntityListExpandedRow } from "./entity-list-expanded-row.js";
 import { FacetCountBridges } from "./facet-count-bridge.js";
 import { buildFormSchema } from "./form-schema.js";
-import { compactHeaderPrimary, orderPlainHeaderActions, primaryHeaderAction, } from "./header-actions.js";
+import { HeaderActionsBar } from "./header-actions-bar.js";
 import { hiddenRequiredFieldsFilled, layoutEditFields, layoutFieldNames } from "./layout-fields.js";
 import { isListNarrowed, useListEmptyContent } from "./list-empty-content.js";
 import { buildDateRangePayload, buildEntityFilterFacets, buildFacetCountRequests, buildFilterFacets, buildFilterPayload, clampDateRange, mergeReferenceFacetOptions, normalizeDefaultFilters, readDateRange, resolveDateRangeFacets, resolveProjectionFacetSpecs, } from "./list-facets.js";
@@ -46,7 +46,7 @@ import { featureNameFromQualifiedScreenId, qualifyScreenId } from "./qualify-scr
 import { QueryErrorBanner, QueryLoadingBanner } from "./query-state-banners.js";
 import { ReferenceFacetBridges } from "./reference-facet-bridge.js";
 import { navigateToReturn, navigateToReturnOr, navigateWithReturnTo, ReturnHostProvider, useReturnHost, useReturnTarget, } from "./return-to.js";
-import { buildDefaultEditRowAction, buildDrawerRowAction, buildProjectionRowActions, buildProjectionToolbarActions, buildRecordActions, evalRowExtractor, isWriteHandlerRowAction, navigateActionSearchParams, refetchAfterWrite, runProjectionRowNavigate, } from "./row-actions.js";
+import { buildClientActionRowAction, buildDefaultEditRowAction, buildDrawerRowAction, buildProjectionRowActions, buildProjectionToolbarActions, buildRecordActions, evalRowExtractor, findRowClickAction, navigateActionSearchParams, refetchAfterWrite, runDrawerRowAction, runProjectionRowNavigate, } from "./row-actions.js";
 import { findEditScreenFor, navigateTargetAllows, screenAccessAllows } from "./screen-access.js";
 import { SecretMintBody } from "./secret-mint-body.js";
 import { SecretsEditBody } from "./secrets-edit-body.js";
@@ -174,7 +174,7 @@ function renderScreenBody({ schema, screen, translate, entityId, onRowClick, onC
         case "dashboard":
             return (_jsx(DashboardScreenBody, { featureName: schema.featureName, screen: screen, translate: translate }));
         case "actionForm":
-            return _jsx(ActionFormBody, { schema: schema, screen: screen, translate: translate });
+            return (_jsx(ActionFormBody, { schema: schema, screen: screen, translate: translate, ...(entityId !== undefined && { entityId }) }));
         case "secretMint":
             return _jsx(SecretMintBody, { schema: schema, screen: screen, translate: translate });
         case "configEdit":
@@ -891,6 +891,7 @@ function EntityEditUpdateForm({ schema, screen, entity, entityId, record, onRelo
     const nav = useNav();
     const appFeatures = useAppFeatures();
     const dispatcher = useDispatcher();
+    const clientActions = useClientActionRuntime();
     const t = useTranslation();
     const effectiveTranslate = translate ?? t;
     const navigateToList = useNavigateToListAfter(schema, screen.entity);
@@ -954,6 +955,7 @@ function EntityEditUpdateForm({ schema, screen, entity, entityId, record, onRelo
         onWriteSuccess: onReload,
         onRecordLeft: handleRecordLeft,
         sameEntityScreenId,
+        clientActions,
         defaultWritePayloadId: entityId,
         ...(formDirty && {
             discardChanges: {
@@ -972,6 +974,7 @@ function EntityEditUpdateForm({ schema, screen, entity, entityId, record, onRelo
         onReload,
         handleRecordLeft,
         sameEntityScreenId,
+        clientActions,
         entityId,
     ]);
     const headerActions = useMemo(() => buildSectionActions((screen.actions ?? []).filter((a) => a.placement !== "menu")), [buildSectionActions, screen.actions]);
@@ -1428,6 +1431,7 @@ function EntityListBody({ schema, screen, entity, translate, onRowClick, }) {
     // (sonst rendert die Action-Spalte still nichts und der "warum sind
     // meine Buttons weg?"-Debug ist teuer).
     const dispatcher = useOptionalDispatcher();
+    const clientActions = useClientActionRuntime();
     const hasRowActions = screen.rowActions !== undefined && screen.rowActions.length > 0;
     useEffect(() => {
         if (hasRowActions && dispatcher === undefined) {
@@ -1511,10 +1515,11 @@ function EntityListBody({ schema, screen, entity, translate, onRowClick, }) {
             if (action.kind === "drawer") {
                 return buildDrawerRowAction(action, effectiveTranslate, openDrawer);
             }
+            if (action.kind === "clientAction") {
+                return buildClientActionRowAction(action, effectiveTranslate, clientActions, refreshRowsAfterWrite);
+            }
             if (dispatcher === undefined)
                 return null;
-            if (!isWriteHandlerRowAction(action))
-                return null;
             const writeAction = action;
             const writeActionVisible = writeAction.visible;
             return {
@@ -1551,6 +1556,7 @@ function EntityListBody({ schema, screen, entity, translate, onRowClick, }) {
         defaultEditScreen,
         effectiveTranslate,
         dispatcher,
+        clientActions,
         runNavigate,
         refreshRowsAfterWrite,
         openDrawer,
@@ -1625,9 +1631,11 @@ function EntityListBody({ schema, screen, entity, translate, onRowClick, }) {
     // gewinnt (deklarierte Author-Absicht "Klick auf die Zeile tut X"). Ohne Flag
     // bleibt der Pfad unverändert — create-app's entityEdit-Default bzw. ein vom
     // App-Author gesetztes onRowClick.
-    const rowClickAction = screen.rowActions?.find((a) => a.kind === "navigate" && a.rowClick === true);
+    const rowClickAction = findRowClickAction(screen.rowActions);
     const wrappedOnRowClick = rowClickAction
-        ? (row) => runNavigate(rowClickAction, row)
+        ? (row) => rowClickAction.kind === "drawer"
+            ? runDrawerRowAction(rowClickAction, openDrawer, row)
+            : runNavigate(rowClickAction, row)
         : onRowClick !== undefined
             ? (row) => onRowClick(row, screen.entity)
             : undefined;
@@ -1696,6 +1704,7 @@ function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
     const nav = useNav();
     const host = useReturnHost();
     const dispatcher = useOptionalDispatcher();
+    const clientActions = useClientActionRuntime();
     const effectiveTranslate = translate ?? t;
     const userRoles = useUserRoles();
     const appFeatures = useAppFeatures();
@@ -1808,10 +1817,12 @@ function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
         openDrawer,
         defaultEditRowAction,
         host,
+        clientActions,
     }), [
         screen.rowActions,
         effectiveTranslate,
         dispatcher,
+        clientActions,
         nav,
         rowsQuery.refetch,
         openDrawer,
@@ -1856,9 +1867,11 @@ function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
     if (rawRowsData !== null && !Array.isArray(rawRowsData.rows)) {
         return (_jsxs(Banner, { padded: true, variant: "error", testId: "kumiko-screen-projection-list-bad-shape", children: ["Screen ", _jsx(Text, { variant: "code", children: screen.id }), " query", " ", _jsx(Text, { variant: "code", children: screen.query }), " did not return a PagedRows envelope; a projectionList query must return ", _jsx(Text, { variant: "code", children: "{ rows, nextCursor }" }), "."] }));
     }
-    const rowClickAction = screen.rowActions?.find((a) => a.kind === "navigate" && a.rowClick === true);
+    const rowClickAction = findRowClickAction(screen.rowActions);
     const wrappedOnRowClick = rowClickAction
-        ? (row) => runNavigate(rowClickAction, row)
+        ? (row) => rowClickAction.kind === "drawer"
+            ? runDrawerRowAction(rowClickAction, openDrawer, row)
+            : runNavigate(rowClickAction, row)
         : onRowClick !== undefined
             ? (row) => onRowClick(row, listScreen.entity)
             : undefined;
@@ -2010,31 +2023,6 @@ function resolveSubtitleHref(header, record) {
 // natives Form-Submit (Enter-Keypress) würde ohne customSubmit gegen
 // controller.submit() ohne submit-config throwen — der No-Op macht diesen
 // Pfad harmlos statt ihn dem Zufall zu überlassen.
-// Header actions bar (A7): <=2 actions render as plain buttons; >2 with an
-// `ActionOverflowMenu` primitive collapse to the primary button plus a menu
-// for the rest — same rule as RowActionsCell for table rows. Owns confirm
-// state for menu items: RenderEditActionButton already owns a per-button
-// confirm dialog for the always-visible primary action, but a menu item has
-// no button of its own to carry one.
-function HeaderActionsBar({ actions, Button, Dialog, ActionOverflowMenu, onError, collapseAfterPrimary = false, compact = false, preferredPrimaryId, PageHeader, }) {
-    const t = useTranslation();
-    const { toMenuItem, confirmDialog: pendingActionDialog } = useActionMenuItems({
-        Dialog,
-        onError,
-    });
-    if (compact && PageHeader !== undefined) {
-        const compactPrimary = compactHeaderPrimary(actions, preferredPrimaryId);
-        const overflowActions = actions.filter((a) => a !== compactPrimary?.action);
-        return (_jsxs(_Fragment, { children: [compactPrimary !== undefined && (_jsx(RenderEditActionButton, { action: compactPrimary.action, Button: Button, Dialog: Dialog, iconOnly: compactPrimary.iconOnly, compactLabel: true, onError: onError }, compactPrimary.action.id)), overflowActions.length > 0 && (_jsx(PageHeader, { overflowItems: overflowActions.map(toMenuItem) })), pendingActionDialog] }));
-    }
-    const maxPlainButtons = collapseAfterPrimary ? 1 : 2;
-    if (actions.length <= maxPlainButtons || ActionOverflowMenu === undefined) {
-        return (_jsx(_Fragment, { children: orderPlainHeaderActions(actions, preferredPrimaryId).map((action) => (_jsx(RenderEditActionButton, { action: action, Button: Button, Dialog: Dialog, hideIcon: true, onError: onError }, action.id))) }));
-    }
-    const primary = primaryHeaderAction(actions, preferredPrimaryId);
-    const rest = actions.filter((a) => a.id !== primary?.id);
-    return (_jsxs(_Fragment, { children: [primary !== undefined && (_jsx(RenderEditActionButton, { action: primary, Button: Button, Dialog: Dialog, hideIcon: true, onError: onError }, primary.id)), _jsx(ActionOverflowMenu, { label: t("kumiko.list.row-actions.more"), testId: "kumiko-screen-projection-detail-actions-overflow", items: rest.map(toMenuItem) }), pendingActionDialog] }));
-}
 function ProjectionDetailBody({ schema, screen, translate, entityId, }) {
     const { Banner, Button, Dialog, Text, Grid, GridCell, Card, Tabs, StatusBadge, Metric, MetricBand, PageHeader, Link, ActionOverflowMenu, } = usePrimitives();
     const t = useTranslation();
@@ -2101,6 +2089,7 @@ function ProjectionDetailBody({ schema, screen, translate, entityId, }) {
     const appFeatures = useAppFeatures();
     const userRoles = useUserRoles();
     const dispatcher = useOptionalDispatcher();
+    const clientActions = useClientActionRuntime();
     const host = useReturnHost();
     const returnTargetParam = useReturnTarget(screen.id);
     // A singleton has no record route to come back to — same as entityEdit.
@@ -2194,6 +2183,7 @@ function ProjectionDetailBody({ schema, screen, translate, entityId, }) {
         onWriteSuccess: detailQuery.refetch,
         onRecordLeft: handleRecordLeft,
         sameEntityScreenId,
+        clientActions,
     }), [
         detailQuery.data,
         detailQuery.refetch,
@@ -2201,6 +2191,7 @@ function ProjectionDetailBody({ schema, screen, translate, entityId, }) {
         nav,
         host,
         dispatcher,
+        clientActions,
         openDrawer,
         handleRecordLeft,
         sameEntityScreenId,
@@ -2218,6 +2209,7 @@ function ProjectionDetailBody({ schema, screen, translate, entityId, }) {
             onWriteSuccess: detailQuery.refetch,
             onRecordLeft: handleRecordLeft,
             sameEntityScreenId,
+            clientActions,
         });
         if (defaultEditAction === undefined || declaredHasEdit)
             return resolved;
@@ -2229,6 +2221,7 @@ function ProjectionDetailBody({ schema, screen, translate, entityId, }) {
         nav,
         host,
         dispatcher,
+        clientActions,
         detailQuery.data,
         detailQuery.refetch,
         openDrawer,
@@ -2354,7 +2347,6 @@ function ProjectionDetailBody({ schema, screen, translate, entityId, }) {
                     void reloadDetail();
                 } })] }));
 }
-// ---- actionForm (Tier 2.7d) ----
 function redirectScreenTarget(redirect) {
     return typeof redirect === "string" ? redirect : redirect.screen;
 }
@@ -2414,7 +2406,7 @@ function returnToWinsOverRedirect(returnTarget, redirect, schema, appFeatures) {
 // write executor's success payload doesn't flatly expose.
 function resolveRedirectTarget(redirect, submittedData, schema, appFeatures, fallbackRecord) {
     const redirectScreen = redirectScreenTarget(redirect);
-    const idField = typeof redirect === "string" ? "id" : redirect.idFrom;
+    const idField = typeof redirect === "string" ? "id" : (redirect.idFrom ?? "id");
     const targetId = lastSegment(redirectScreen);
     const target = findRedirectTargetScreen(redirect, schema, appFeatures);
     const carriesId = target !== undefined && (target.type === "entityEdit" || target.type === "projectionDetail");
@@ -2438,6 +2430,30 @@ function navigateToRedirectTarget(nav, target) {
     else
         nav.navigate(navTarget, { searchParams: { tab: target.tab } });
 }
+// Links of the success box. Targets resolve like `redirect`; a link whose target
+// needs a record id (entityEdit, projectionDetail) but whose payload field holds
+// no string id is dropped instead of navigating to an id-less record screen.
+// A link without idFrom to a non-record screen always navigates id-less.
+function resolveSuccessLinks(links, data, schema, appFeatures, nav, translate) {
+    const resolved = [];
+    (links ?? []).forEach((link, index) => {
+        const target = resolveRedirectTarget(link, data, schema, appFeatures);
+        if (target.entityId === undefined && redirectTargetsRecord(link, schema, appFeatures))
+            return;
+        const navTarget = {
+            screenId: target.screenId,
+            ...(target.entityId !== undefined && { entityId: target.entityId }),
+        };
+        const options = target.tab === undefined ? undefined : { searchParams: { tab: target.tab } };
+        resolved.push({
+            key: String(index),
+            label: translate(link.label),
+            href: nav.hrefFor(navTarget, options),
+            onPress: () => nav.navigate(navTarget, options),
+        });
+    });
+    return resolved;
+}
 // Success navigation for a configured redirect — shared by entityEdit's
 // save and writeHandler record actions. The string form navigates without an
 // entityId; the object form resolves like actionForm's, with `record` as the
@@ -2471,7 +2487,7 @@ function overlayUpdatedProjection(record, resultData) {
 // Button) ist identisch zu entityEdit, nur der Submit-Pfad wechselt
 // vom CRUD-verb auf den Author-deklarierten handler-QN +
 // payloadMode="values" (alle Form-Werte schicken statt nur Changes).
-function ActionFormBody({ schema, screen, translate, initialOverrides, onSuccess, onCancelOverride, onDirtyChange, submitLabelFallback, }) {
+function ActionFormBody({ schema, screen, translate, entityId, initialOverrides, onSuccess, onCancelOverride, onDirtyChange, submitLabelFallback, }) {
     const nav = useNav();
     const appFeatures = useAppFeatures();
     const insideDrawer = useInsideDrawer();
@@ -2492,27 +2508,55 @@ function ActionFormBody({ schema, screen, translate, initialOverrides, onSuccess
     // submitting a guessed currency would mis-book the amount — block instead.
     const tenantCurrencyFieldNames = useMemo(() => tenantCurrencyMoneyFieldNames(screen.fields), [screen.fields]);
     const { overrides: moneyCurrencyOverrides, loading: currencyLoading, unresolved: currencyUnresolved, } = useMoneyCurrencyOverrides(screen.fields, tenantCurrencyFieldNames, undefined);
-    const initial = useMemo(() => mergeSearchParamsIntoInitial(submittableFields, {
-        searchParams: nav.searchParams,
-        urlPrefillFields: screen.urlPrefillFields,
-        renderableFields: layoutFieldNames(synthScreen),
-        ...(moneyCurrencyOverrides !== undefined && { moneyCurrencyOverrides }),
-        ...(initialOverrides !== undefined && { drawerOverrides: initialOverrides }),
-        ...(handoffValues !== undefined && { handoffValues }),
-    }), [
+    const loadableFieldNames = useMemo(() => Object.entries(submittableFields)
+        .filter(([, field]) => !isSecretFormField(field))
+        .map(([name]) => name), [submittableFields]);
+    const loadState = useActionFormLoad(screen.load, screen.load !== undefined
+        ? resolveActionFormRecordId({
+            routeEntityId: entityId,
+            drawerOverrides: initialOverrides,
+            searchParams: nav.searchParams,
+        })
+        : undefined, loadableFieldNames);
+    const loadedValues = loadState?.status === "ready" ? loadState.values : undefined;
+    const initial = useMemo(() => {
+        // With `load` the loaded record is the only source of values: a crafted link
+        // or a row's params must not seed fields the record would otherwise own.
+        const prefillSources = screen.load !== undefined
+            ? { searchParams: {}, urlPrefillFields: undefined }
+            : {
+                searchParams: nav.searchParams,
+                urlPrefillFields: screen.urlPrefillFields,
+                ...(initialOverrides !== undefined && { drawerOverrides: initialOverrides }),
+                ...(handoffValues !== undefined && { handoffValues }),
+            };
+        return {
+            ...mergeSearchParamsIntoInitial(submittableFields, {
+                ...prefillSources,
+                renderableFields: layoutFieldNames(synthScreen),
+                ...(moneyCurrencyOverrides !== undefined && { moneyCurrencyOverrides }),
+            }),
+            ...loadedValues,
+        };
+    }, [
         submittableFields,
+        screen.load,
         screen.urlPrefillFields,
         nav.searchParams,
         synthScreen,
         moneyCurrencyOverrides,
         initialOverrides,
         handoffValues,
+        loadedValues,
     ]);
     const t = useTranslation();
     const effectiveTranslate = translate ?? t;
     const summary = useMemo(() => resolveActionFormSummary(screen.summary, initialOverrides, effectiveTranslate, locale), [screen.summary, initialOverrides, effectiveTranslate, locale]);
     const dispatcher = useDispatcher();
-    const [successText, setSuccessText] = useState(undefined);
+    const [success, setSuccess] = useState(undefined);
+    // Bumped after a successful submit with resetOnSuccess: remounts RenderEdit, which
+    // re-seeds the form from `initial` (prefill kept, typed values cleared).
+    const [formEpoch, setFormEpoch] = useState(0);
     // A slow label lookup of an earlier submit must not overwrite the banner of a later one.
     const successSequence = useRef(0);
     useEffect(() => () => {
@@ -2521,23 +2565,35 @@ function ActionFormBody({ schema, screen, translate, initialOverrides, onSuccess
     const handleSubmitted = useCallback((result, values) => {
         successSequence.current += 1;
         const sequence = successSequence.current;
-        setSuccessText(undefined);
+        setSuccess(undefined);
         if (!result.isSuccess)
             return;
         if (onSuccess !== undefined) {
             onSuccess();
             return;
         }
-        if (screen.successMessage !== undefined && screen.redirect === undefined) {
-            const messageKey = screen.successMessage;
-            const show = (params) => {
-                if (successSequence.current === sequence) {
-                    setSuccessText(effectiveTranslate(messageKey, params));
-                }
+        if (screen.redirect === undefined) {
+            const hasSuccessLinks = (screen.successLinks?.length ?? 0) > 0;
+            const publish = (text) => {
+                if (successSequence.current !== sequence)
+                    return;
+                setSuccess({
+                    text,
+                    links: resolveSuccessLinks(screen.successLinks, result.data, schema, appFeatures, nav, effectiveTranslate),
+                });
             };
-            void resolveSuccessMessageParams(screen, schema.featureName, values, dispatcher, locale)
-                .then(show)
-                .catch(() => show(formatSummaryParams(values, locale)));
+            const messageKey = screen.successMessage;
+            if (messageKey !== undefined) {
+                const show = (params) => publish(effectiveTranslate(messageKey, params));
+                void resolveSuccessMessageParams(screen, schema.featureName, values, dispatcher, locale)
+                    .then(show)
+                    .catch(() => show(formatSummaryParams(values, locale)));
+            }
+            else if (hasSuccessLinks || screen.resetOnSuccess === true) {
+                publish(effectiveTranslate("kumiko.actionForm.success"));
+            }
+            if (screen.resetOnSuccess === true)
+                setFormEpoch((epoch) => epoch + 1);
         }
         // Without a redirect the form stays put; returnTo only replaces an existing
         // navigation, and never one to a record screen (see redirectTargetsRecord).
@@ -2560,6 +2616,14 @@ function ActionFormBody({ schema, screen, translate, initialOverrides, onSuccess
         locale,
         effectiveTranslate,
     ]);
+    // The success box disappears with the next edit; a submit clears it itself.
+    const handleDirtyChange = useCallback((dirty) => {
+        if (dirty) {
+            successSequence.current += 1;
+            setSuccess(undefined);
+        }
+        onDirtyChange?.(dirty);
+    }, [onDirtyChange]);
     // Cancel ist nur sinnvoll wenn ein Navigations-Ziel existiert —
     // sonst hätte der Button nirgendwo hin zu navigieren. cancelTarget
     // gewinnt über redirect; `false` schaltet den Button explizit ab
@@ -2582,6 +2646,9 @@ function ActionFormBody({ schema, screen, translate, initialOverrides, onSuccess
     if (currencyUnresolved) {
         return (_jsx(Banner, { padded: true, variant: "error", testId: "kumiko-screen-currency-unresolved", children: "The tenant currency could not be loaded, so this form cannot be submitted." }));
     }
+    if (loadState !== undefined && loadState.status !== "ready") {
+        return (_jsx(ActionFormLoadStatus, { state: loadState, screenId: screen.id, translate: effectiveTranslate }));
+    }
     return (_jsx(RenderEdit, { screen: synthScreen, entity: synthEntity, featureName: schema.featureName, initial: initial, 
         // Extension-Sections im actionForm sehen die initialen Form-Values
         // (inkl. searchParams-Prefill, z.B. ?incidentId=…) als initialValues
@@ -2589,11 +2656,11 @@ function ActionFormBody({ schema, screen, translate, initialOverrides, onSuccess
         // sie Kontext ziehen könnten.
         extensionInitialValues: initial, ...(screen.submitPrefilled === true && {
             submitWithoutChanges: hiddenRequiredFieldsFilled(synthScreen, screen.fields, initial),
-        }), ...(successText !== undefined && {
-            leadContent: (_jsx(Banner, { variant: "info", testId: "action-form-success", children: successText })),
-        }), writeCommand: screen.handler, payloadMode: "values", onSubmit: handleSubmitted, ...(handleCancel !== undefined && { onCancel: handleCancel }), ...(onDirtyChange !== undefined && { onDirtyChange }), ...((insideDrawer || screenFillsHeight(screen)) && { fillScreenHeight: true }), ...((screen.submitLabel ?? submitLabelFallback) !== undefined && {
+        }), ...(success !== undefined && {
+            leadContent: _jsx(ActionFormSuccessBanner, { success: success }),
+        }), writeCommand: screen.handler, payloadMode: "values", onSubmit: handleSubmitted, ...(handleCancel !== undefined && { onCancel: handleCancel }), onDirtyChange: handleDirtyChange, ...((insideDrawer || screenFillsHeight(screen)) && { fillScreenHeight: true }), ...((screen.submitLabel ?? submitLabelFallback) !== undefined && {
             submitLabel: screen.submitLabel ?? submitLabelFallback,
-        }), ...(screen.submitStyle !== undefined && { submitVariant: screen.submitStyle }), ...(screen.footerActions !== undefined && { footerActions: screen.footerActions }), ...(summary !== undefined && { summary }), ...(translate !== undefined && { translate }) }));
+        }), ...(screen.submitStyle !== undefined && { submitVariant: screen.submitStyle }), ...(screen.footerActions !== undefined && { footerActions: screen.footerActions }), ...(summary !== undefined && { summary }), ...(translate !== undefined && { translate }) }, formEpoch));
 }
 // A money-typed config-edit field renders through RenderField's entityEdit
 // `{amount, currency}` payload shape (render-field.tsx, #1923), but

package/dist/app/list-empty-content.d.ts

@@ -2,7 +2,7 @@ import type { ListEmptyStateSpec } from "@cosmicdrift/kumiko-framework/ui-types"
 import type { Translate } from "@cosmicdrift/kumiko-headless";
 import type { ListEmptyStateContent } from "../components/list-empty-state.tsx";
 import { buildRecordActions } from "./row-actions.ts";
-type ActionBindings = Pick<Parameters<typeof buildRecordActions>[0], "nav" | "host" | "dispatcher" | "openDrawer" | "onWriteSuccess">;
+type ActionBindings = Pick<Parameters<typeof buildRecordActions>[0], "nav" | "host" | "dispatcher" | "openDrawer" | "onWriteSuccess" | "clientActions">;
 export declare function useListEmptyContent(spec: ListEmptyStateSpec | undefined, translate: Translate, bindings: ActionBindings): ListEmptyStateContent | undefined;
 export declare function isListNarrowed(search: string, filters: Readonly<Record<string, readonly string[]>>, defaultFilters?: Readonly<Record<string, readonly string[]>>): boolean;
 export {};

package/dist/app/list-empty-content.js

@@ -3,7 +3,7 @@ import { buildRecordActions } from "./row-actions.js";
 const NO_RECORD = {};
 // An empty list has no row, so the action is resolved against an empty record.
 export function useListEmptyContent(spec, translate, bindings) {
-    const { nav, host, dispatcher, openDrawer, onWriteSuccess } = bindings;
+    const { nav, host, dispatcher, openDrawer, onWriteSuccess, clientActions } = bindings;
     return useMemo(() => {
         if (spec === undefined)
             return undefined;
@@ -18,13 +18,14 @@ export function useListEmptyContent(spec, translate, bindings) {
                 dispatcher,
                 openDrawer,
                 onWriteSuccess,
+                clientActions,
             })?.[0];
         return {
             title: translate(spec.title),
             ...(spec.description !== undefined && { description: translate(spec.description) }),
             ...(action !== undefined && { action }),
         };
-    }, [spec, translate, nav, host, dispatcher, openDrawer, onWriteSuccess]);
+    }, [spec, translate, nav, host, dispatcher, openDrawer, onWriteSuccess, clientActions]);
 }
 // Facets with a default are only "narrowed" once the user moved off that default.
 export function isListNarrowed(search, filters, defaultFilters = {}) {

package/dist/app/row-actions.d.ts

@@ -1,8 +1,9 @@
-import type { EntityEditScreenDefinition, RelatedListToolbarAction, RowAction, RowActionDrawer, RowActionNavigate, RowActionWriteHandler, RowFieldExtractor, ToolbarAction } from "@cosmicdrift/kumiko-framework/ui-types";
+import type { EntityEditScreenDefinition, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDrawer, RowActionNavigate, RowActionWriteHandler, RowFieldExtractor, ToolbarAction } from "@cosmicdrift/kumiko-framework/ui-types";
 import type { Dispatcher, ListRowViewModel, Translate } from "@cosmicdrift/kumiko-headless";
 import type { RenderEditAction } from "../components/render-edit-types.ts";
 import type { ToolbarActionButton } from "../components/render-list.tsx";
 import type { DataTableRowAction } from "../primitives.tsx";
+import { type ClientActionRuntime } from "./client-actions.tsx";
 import type { NavApi } from "./nav.tsx";
 import { type ReturnHost } from "./return-to.tsx";
 export declare function buildDefaultEditRowAction(editScreen: EntityEditScreenDefinition | undefined, idColumn?: string): RowActionNavigate | undefined;
@@ -15,7 +16,12 @@ export declare function runProjectionRowNavigate(nav: NavApi, action: RowActionN
 type OpenDrawer = (action: RowActionDrawer, initialValues: Readonly<Record<string, unknown>> | undefined) => void;
 /** @internal test-only */
 export declare function resetDrawerActionWarningsForTests(): void;
+export declare function runDrawerRowAction(action: RowActionDrawer, openDrawer: OpenDrawer, row: ListRowViewModel): void;
+/** The action that claims the row-body click (`rowClick: true`); the boot
+ *  validator allows at most one per list. */
+export declare function findRowClickAction(rowActions: readonly RowAction[] | undefined): RowActionNavigate | RowActionDrawer | undefined;
 export declare function buildDrawerRowAction(action: RowActionDrawer, translate: Translate, openDrawer: OpenDrawer): DataTableRowAction;
+export declare function buildClientActionRowAction(action: RowActionClientAction, translate: Translate, runtime: ClientActionRuntime | undefined, refetch: () => Promise<unknown>): DataTableRowAction;
 export declare function buildProjectionRowActions(options: {
     readonly rowActions: readonly RowAction[] | undefined;
     readonly translate: Translate;
@@ -30,6 +36,7 @@ export declare function buildProjectionRowActions(options: {
     /** Prepended unless a declared action already has id "edit" — declared wins. */
     readonly defaultEditRowAction?: RowActionNavigate;
     readonly host: ReturnHost | undefined;
+    readonly clientActions?: ClientActionRuntime;
 }): readonly DataTableRowAction[] | undefined;
 type OpenToolbarDrawer = (action: ToolbarAction & {
     readonly kind: "drawer";
@@ -93,5 +100,6 @@ export declare function buildRecordActions(options: {
      *  action (they reload or remount the surrounding form). Set while that
      *  form holds unsaved input so it is not lost silently. */
     readonly discardChanges?: DiscardChanges;
+    readonly clientActions?: ClientActionRuntime;
 }): readonly RenderEditAction[] | undefined;
 export {};

package/dist/app/row-actions.js

@@ -1,5 +1,6 @@
 import { evalFieldCondition } from "@cosmicdrift/kumiko-framework/ui-types";
 import { resolveActionIcon } from "@cosmicdrift/kumiko-types/action-icon";
+import { runClientAction } from "./client-actions.js";
 import { lastSegment } from "./qn.js";
 import { navigateWithReturnTo } from "./return-to.js";
 import { dispatcherErrorText, WriteFailedError } from "./write-failed-error.js";
@@ -119,8 +120,16 @@ function warnDrawerActionDropped(actionKind, actionId) {
     // biome-ignore lint/suspicious/noConsole: dev-warning for a setup error
     console.warn(`[kumiko] ${actionKind} "${actionId}" is kind:"drawer", but the host did not wire openDrawer (RelatedListSection: pass onOpenDrawer) — it will not render.`);
 }
+export function runDrawerRowAction(action, openDrawer, row) {
+    openDrawer(action, action.params !== undefined ? evalRowExtractor(action.params, row.values) : undefined);
+}
+/** The action that claims the row-body click (`rowClick: true`); the boot
+ *  validator allows at most one per list. */
+export function findRowClickAction(rowActions) {
+    return rowActions?.find((a) => (a.kind === "navigate" || a.kind === "drawer") && a.rowClick === true);
+}
 export function buildDrawerRowAction(action, translate, openDrawer) {
-    const { visible, params } = action;
+    const { visible } = action;
     const actionIcon = resolveActionIcon(action.id, action.icon);
     return {
         id: action.id,
@@ -128,10 +137,9 @@ export function buildDrawerRowAction(action, translate, openDrawer) {
         ...(action.style !== undefined && { style: action.style }),
         ...(action.display !== undefined && { display: action.display }),
         confirmRequired: false,
+        ...(action.rowClick === true && { rowClick: true }),
         ...(actionIcon !== undefined && { icon: actionIcon }),
-        onTrigger: (row) => {
-            openDrawer(action, params !== undefined ? evalRowExtractor(params, row.values) : undefined);
-        },
+        onTrigger: (row) => runDrawerRowAction(action, openDrawer, row),
         ...(visible !== undefined && {
             isVisible: (row) => evalFieldCondition(visible, row.values),
         }),
@@ -172,6 +180,36 @@ function buildWriteHandlerRowAction(action, translate, refetch, dispatcher) {
         }),
     };
 }
+function clientActionPayload(action, values, defaultId) {
+    return action.payload !== undefined
+        ? evalRowExtractor(action.payload, values)
+        : { id: defaultId };
+}
+export function buildClientActionRowAction(action, translate, runtime, refetch) {
+    const { visible } = action;
+    return {
+        id: action.id,
+        label: translate(action.label),
+        ...(action.style !== undefined && { style: action.style }),
+        ...(action.display !== undefined && { display: action.display }),
+        icon: resolveActionIcon(action.id, action.icon),
+        ...(action.confirm !== undefined && { confirm: translate(action.confirm) }),
+        ...(action.confirmLabel !== undefined && { confirmLabel: translate(action.confirmLabel) }),
+        onTrigger: async (row) => {
+            const succeeded = await runClientAction({
+                action,
+                payload: clientActionPayload(action, row.values, row.values["id"]),
+                runtime,
+                translate,
+            });
+            if (succeeded)
+                await refetchAfterWrite(refetch);
+        },
+        ...(visible !== undefined && {
+            isVisible: (row) => evalFieldCondition(visible, row.values),
+        }),
+    };
+}
 // Builds the DataTable-ready row-action set for a query-driven row source
 // (projectionList, relatedList) — navigate dispatches through
 // runProjectionRowNavigate, writeHandler dispatches through the shared
@@ -179,7 +217,7 @@ function buildWriteHandlerRowAction(action, translate, refetch, dispatcher) {
 // projectionList's rowActions and a projectionDetail relatedList section's
 // rowActions can't drift apart (fw editable-detail-screens).
 export function buildProjectionRowActions(options) {
-    const { rowActions, translate, dispatcher, nav, refetch, openDrawer, defaultEditRowAction, host, } = options;
+    const { rowActions, translate, dispatcher, nav, refetch, openDrawer, defaultEditRowAction, host, clientActions, } = options;
     const effectiveActions = mergeDefaultEditAction(rowActions, defaultEditRowAction);
     if (effectiveActions.length === 0)
         return undefined;
@@ -197,6 +235,10 @@ export function buildProjectionRowActions(options) {
             out.push(buildDrawerRowAction(action, translate, openDrawer));
             continue;
         }
+        if (action.kind === "clientAction") {
+            out.push(buildClientActionRowAction(action, translate, clientActions, refetch));
+            continue;
+        }
         // writeHandler (default-kind) — a swallowed failure result must become a
         // thrown error (fw prod-bug 2026-06-07), same as every other write path.
         if (dispatcher === undefined)
@@ -369,6 +411,31 @@ function buildDrawerRecordAction(action, options) {
         },
     };
 }
+function buildClientActionRecordAction(action, options) {
+    const { record, translate, actionIcon, runtime, onWriteSuccess, defaultWritePayloadId, discardChanges, } = options;
+    const confirm = withDiscardHint(action.confirm !== undefined ? translate(action.confirm) : undefined, discardChanges);
+    const confirmLabel = discardChanges?.confirmLabel ??
+        (action.confirmLabel !== undefined ? translate(action.confirmLabel) : undefined);
+    return {
+        id: action.id,
+        label: translate(action.label),
+        ...(action.style !== undefined && { style: action.style }),
+        ...(action.display !== undefined && { display: action.display }),
+        ...(actionIcon !== undefined && { icon: actionIcon }),
+        ...(confirm !== undefined && { confirm }),
+        ...(confirmLabel !== undefined && { confirmLabel }),
+        onPress: async () => {
+            const succeeded = await runClientAction({
+                action,
+                payload: clientActionPayload(action, record, defaultWritePayloadId ?? record["id"]),
+                runtime,
+                translate,
+            });
+            if (succeeded)
+                await onWriteSuccess();
+        },
+    };
+}
 // Entity delete handler QN: `<feature>:write:<entity>:delete` (see
 // entityWriteCommand in kumiko-screen.tsx).
 const ENTITY_DELETE_HANDLER_PATTERN = /:write:[^:]+:delete$/;
@@ -417,7 +484,7 @@ function buildWriteHandlerRecordAction(action, options) {
 // resolved against the record currently being viewed/edited, independent of
 // any table row.
 export function buildRecordActions(options) {
-    const { actions, record, translate, nav, host, dispatcher, openDrawer, onWriteSuccess, onRecordLeft, defaultScreenTargetEntityId, sameEntityScreenId, defaultWritePayloadId, discardChanges, } = options;
+    const { actions, record, translate, nav, host, dispatcher, openDrawer, onWriteSuccess, onRecordLeft, defaultScreenTargetEntityId, sameEntityScreenId, defaultWritePayloadId, discardChanges, clientActions, } = options;
     const out = [];
     for (const action of actions) {
         if (action.visible !== undefined && !evalFieldCondition(action.visible, record))
@@ -447,6 +514,18 @@ export function buildRecordActions(options) {
             }));
             continue;
         }
+        if (action.kind === "clientAction") {
+            out.push(buildClientActionRecordAction(action, {
+                record,
+                translate,
+                actionIcon,
+                runtime: clientActions,
+                onWriteSuccess,
+                defaultWritePayloadId,
+                discardChanges,
+            }));
+            continue;
+        }
         // writeHandler — skip without a dispatcher instead of crashing.
         if (dispatcher === undefined)
             continue;