@cosmicdrift/kumiko-renderer 0.373.0 → 0.377.0

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;

package/dist/app/secret-mint-body.d.ts

@@ -1,6 +1,6 @@
 import type { SecretMintScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { Translate } from "../headless/index.ts";
 import type { FeatureSchema } from "./feature-schema.ts";
 export type SecretMintBodyProps = {
     readonly schema: FeatureSchema;

package/dist/app/secrets-edit-body.d.ts

@@ -1,6 +1,6 @@
 import type { SecretsEditScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { Translate } from "../headless/index.ts";
 export type SecretsEditBodyProps = {
     readonly screen: SecretsEditScreenDefinition;
     readonly translate?: Translate;

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

@@ -0,0 +1,12 @@
+import type { RowAction } from "@cosmicdrift/kumiko-framework/ui-types";
+import type { RenderEditAction } from "../components/render-edit-types.ts";
+import type { Translate } from "../headless/index.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/app/write-failed-error.d.ts

@@ -1,4 +1,4 @@
-import type { DispatcherError } from "@cosmicdrift/kumiko-headless";
+import type { DispatcherError } from "../headless/index.ts";
 export declare class WriteFailedError extends Error {
     readonly dispatcherError: DispatcherError;
     constructor(error: DispatcherError, message: string);

package/dist/components/availability-options-select.d.ts

@@ -1,6 +1,6 @@
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
 import type { OptionsQueryPayload } from "@cosmicdrift/kumiko-types/fields";
 import { type ReactNode } from "react";
+import type { EditFieldViewModel } from "../headless/index.ts";
 export type SelectOptionEntry = {
     readonly value: string;
     readonly label: string;

package/dist/components/embedded-list-field.d.ts

@@ -1,5 +1,5 @@
-import type { EditFieldViewModel, FieldIssue } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { EditFieldViewModel, FieldIssue } from "../headless/index.ts";
 export type EmbeddedListFieldProps = {
     readonly field: EditFieldViewModel;
     readonly id: string;

package/dist/components/embedded-list-field.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { computeDerivedCellValue, currencyDecimals, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "@cosmicdrift/kumiko-headless";
 import { useState } from "react";
+import { computeDerivedCellValue, currencyDecimals, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "../headless/index.js";
 import { REFERENCE_COMBOBOX_LIMIT } from "../hooks/reference-limits.js";
 import { useQuery } from "../hooks/use-query.js";
 import { referenceOptionSource } from "../hooks/use-reference-lookup.js";

package/dist/components/file-list-field.d.ts

@@ -1,5 +1,5 @@
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
 import type { ReactNode } from "react";
+import type { EditFieldViewModel } from "../headless/index.ts";
 export type FileListFieldProps = {
     readonly field: EditFieldViewModel;
     readonly id: string;

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

@@ -1,5 +1,5 @@
-import type { EditFieldViewModel, FieldIssue } from "@cosmicdrift/kumiko-headless";
 import type { ReactNode } from "react";
+import type { EditFieldViewModel, FieldIssue } from "../headless/index.ts";
 import type { FieldCellWidth, FieldProps, usePrimitives } from "../primitives.tsx";
 export type GridCellForFieldProps = {
     readonly field: EditFieldViewModel;
@@ -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/multi-select-checkboxes.d.ts

@@ -1,5 +1,5 @@
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
 import type { ReactNode } from "react";
+import type { EditFieldViewModel } from "../headless/index.ts";
 export type MultiSelectCheckboxOption = {
     readonly value: string;
     readonly label: string;

package/dist/components/multi-select-checkboxes.js

@@ -5,7 +5,7 @@ import { usePrimitives } from "../primitives.js";
 // as a visible checkbox plus a select-all toggle, built purely from the
 // platform-neutral Primitives contract (Grid/GridCell/Field/Input kind
 // "boolean", the same primitive `case "boolean"` uses in render-field.tsx).
-// No renderer-web import here — this file must stay usable from Expo too.
+// No renderer/web import here — this file must stay usable from Expo too.
 export function MultiSelectCheckboxes({ field, id, options, value, onChange, }) {
     const { Grid, GridCell, Field, Input, Button } = usePrimitives();
     const t = useTranslation();

package/dist/components/query-options-select.d.ts

@@ -1,6 +1,6 @@
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
 import { type OptionsQueryPayload } from "@cosmicdrift/kumiko-types/fields";
 import { type ReactNode } from "react";
+import type { EditFieldViewModel } from "../headless/index.ts";
 type ResolvedOptionsQueryPayload = Readonly<Record<string, string | number | boolean>>;
 export declare function resolveOptionsQueryPayload(payload: OptionsQueryPayload, row: Readonly<Record<string, unknown>>): ResolvedOptionsQueryPayload;
 type QueryOptionsSelectProps = {

package/dist/components/related-list-section.d.ts

@@ -1,6 +1,6 @@
 import type { RowActionDrawer } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { EditRelatedListSectionViewModel, Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { EditRelatedListSectionViewModel, Translate } from "../headless/index.ts";
 export declare function RelatedListSection({ section, parentId, record, featureName, translate, hideTitle, grow, onOpenDrawer, actions, embedded, onAfterWrite, refreshToken, }: {
     readonly section: EditRelatedListSectionViewModel;
     readonly parentId: string;

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-logic.d.ts

@@ -1,4 +1,4 @@
-import type { DispatcherError, EditFieldViewModel, EditSectionViewModel, SubmitResult } from "@cosmicdrift/kumiko-headless";
+import type { DispatcherError, EditFieldViewModel, EditSectionViewModel, SubmitResult } from "../headless/index.ts";
 export declare function hasEditableSection(sections: readonly EditSectionViewModel[]): boolean;
 export declare function resolveExtensionEntityId(entityIdProp: string | null | undefined, vmId: string | null): string | null;
 export declare function shouldNotifyCaller(result: SubmitResult<unknown>, extensionsPersisted: boolean): boolean;

package/dist/components/render-edit-types.d.ts

@@ -1,7 +1,7 @@
 import type { ActionFormFooterAction, EntityDefinition, EntityEditScreenDefinition, IconKey, RowAction, RowActionDrawer } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { DispatcherError, FormSnapshot, FormValues, SubmitResult, Translate } from "@cosmicdrift/kumiko-headless";
 import type { ReactNode } from "react";
 import type * as z from "zod";
+import type { DispatcherError, FormSnapshot, FormValues, SubmitResult, Translate } from "../headless/index.ts";
 export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
     readonly screen: EntityEditScreenDefinition;
     /** Screen id used for the `screen:<id>.title`/`.subtitle` lookups and as the
@@ -59,7 +59,7 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
     /** Copy-link action (issue #912) — only set in update mode (create mode
      *  has no entity id yet, hence no permalink). The callback is already fully
      *  bound (URL building + clipboard happen outside, in
-     *  `@cosmicdrift/kumiko-renderer-web`'s RoutedScreen — this platform-neutral
+     *  `@cosmicdrift/kumiko-renderer/web`'s RoutedScreen — this platform-neutral
      *  package must not touch `navigator`/`window`, see
      *  guard-renderer-boundaries). undefined = no button. */
     readonly onCopyLink?: () => Promise<void> | void;

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

@@ -1,4 +1,4 @@
-import type { FormValues } from "@cosmicdrift/kumiko-headless";
+import type { FormValues } from "../headless/index.ts";
 import type { RenderEditProps } from "./render-edit-types.ts";
 export type { RenderEditAction, RenderEditChangeState, RenderEditControls, RenderEditProps, } from "./render-edit-types.ts";
 import { type ReactNode } from "react";

package/dist/components/render-edit.js

@@ -1,7 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { evalFieldCondition, isFieldsEditSection, normalizeEditField, PROJECTION_DETAIL_ENTITY, sectionFieldSpecs, } from "@cosmicdrift/kumiko-framework/ui-types";
-import { computeEditViewModel, groupIssuesByPath, relevantFieldIssues, zodErrorToFieldIssues, } from "@cosmicdrift/kumiko-headless";
 import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
+import { computeEditViewModel, groupIssuesByPath, relevantFieldIssues, zodErrorToFieldIssues, } from "../headless/index.js";
 import { RenderEditActionButton } from "./render-edit-action-button.js";
 import { AllFieldsRequiredProvider } from "./render-field.js";
 import { useActionMenuItems } from "./use-action-menu-items.js";
@@ -1075,6 +1075,7 @@ export function RenderEdit(props) {
     wizardBackRef.current = isWizard ? handleWizardBack : () => { };
     // Screen forms (entityEdit/actionForm filling the shell height) drop the card;
     // the title then lives in the shell header when the shell offers a slot.
+    const rootIssues = snapshot.errors[ROOT_ISSUE_PATH] ?? [];
     const isScreenForm = fillScreenHeight === true && hideSectionTitles !== true && !insideDrawer;
     const titleInShell = PageHeader !== undefined &&
         pageHeaderSlotAvailable &&
@@ -1430,7 +1431,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.
@@ -1480,7 +1481,8 @@ export function RenderEdit(props) {
                                     onReload();
                                     setFormError(null);
                                     setExtraDeleteIssues([]);
-                                }, testId: "render-edit-form-error-reload", children: translate("kumiko.actions.reload") })) : undefined, children: [_jsx(Text, { testId: "render-edit-form-error-key", children: translate(formError.i18nKey, formError.i18nParams) }), extraDeleteIssues.map((issue) => (_jsx(Text, { testId: "render-edit-form-error-extra", children: translate(issue.i18nKey, issue.params) }, `${issue.path}:${issue.i18nKey}`)))] })), (snapshot.errors[ROOT_ISSUE_PATH] ?? []).map((issue) => (_jsx(Banner, { variant: "error", testId: "render-edit-root-issue", children: _jsx(Text, { children: translate(issue.i18nKey, issue.params) }) }, issue.i18nKey))), extensionErrorKey !== null && (_jsx(Banner, { variant: "error", testId: "render-edit-extension-error", children: _jsx(Text, { testId: "render-edit-extension-error-key", children: translate(extensionErrorKey) }) })), actionError !== null && (_jsx(Banner, { variant: "error", testId: "render-edit-action-error", children: actionError })), onDelete !== undefined && (_jsx(Dialog, { open: confirmDeleteOpen, onOpenChange: setConfirmDeleteOpen, title: translate("kumiko.actions.delete-confirm"), confirmLabel: translate("kumiko.actions.delete"), variant: "danger", onConfirm: async () => {
+                                }, testId: "render-edit-form-error-reload", children: translate("kumiko.actions.reload") })) : undefined, children: [_jsx(Text, { testId: "render-edit-form-error-key", children: translate(formError.i18nKey, formError.i18nParams) }), rootIssues.map((issue) => (_jsx(Text, { testId: "render-edit-form-error-root", children: translate(issue.i18nKey, issue.params) }, `${issue.path}:${issue.i18nKey}`))), extraDeleteIssues.map((issue) => (_jsx(Text, { testId: "render-edit-form-error-extra", children: translate(issue.i18nKey, issue.params) }, `${issue.path}:${issue.i18nKey}`)))] })), formError === null &&
+                            rootIssues.map((issue) => (_jsx(Banner, { variant: "error", testId: "render-edit-root-issue", children: _jsx(Text, { children: translate(issue.i18nKey, issue.params) }) }, issue.i18nKey))), extensionErrorKey !== null && (_jsx(Banner, { variant: "error", testId: "render-edit-extension-error", children: _jsx(Text, { testId: "render-edit-extension-error-key", children: translate(extensionErrorKey) }) })), actionError !== null && (_jsx(Banner, { variant: "error", testId: "render-edit-action-error", children: actionError })), onDelete !== undefined && (_jsx(Dialog, { open: confirmDeleteOpen, onOpenChange: setConfirmDeleteOpen, title: translate("kumiko.actions.delete-confirm"), confirmLabel: translate("kumiko.actions.delete"), variant: "danger", onConfirm: async () => {
                                 const rejection = await onDelete();
                                 // A rejected delete (e.g. a preDelete hook) carries its reason in
                                 // the field issues; the top-level key is only "validation failed".

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

@@ -1,5 +1,5 @@
-import { type EditFieldViewModel, type FieldIssue } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import { type EditFieldViewModel, type FieldIssue } from "../headless/index.ts";
 import { type FieldProps } from "../primitives.tsx";
 export type RenderFieldProps = {
     readonly field: EditFieldViewModel;
@@ -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;