@cosmicdrift/kumiko-renderer 0.358.0 → 0.359.0

package/dist/app/action-form-shim.d.ts

@@ -4,6 +4,9 @@ import type { ActionFormScreenDefinition, EntityDefinition, EntityEditScreenDefi
  *  iterieren über entity.fields zur Render-Zeit; alle weiteren
  *  EntityDefinition-Felder bleiben undefined. */
 export declare function synthesizeActionFormEntity(fields: Readonly<Record<string, FieldDefinition>>): EntityDefinition;
+/** Fields the form may seed and submit. An excluded field the layout does not show
+ *  would otherwise reach the payload through its `default`, and the handler rejects it. */
+export declare function actionFormSubmittableFields(screen: ActionFormScreenDefinition): Readonly<Record<string, FieldDefinition>>;
 /** Wandelt ein ActionFormScreenDefinition oder SecretMintScreenDefinition in
  *  die EntityEditScreen-Shape die RenderEdit erwartet. type wird auf
  *  "entityEdit" gesetzt damit der Type-Constraint hält; entity wird auf den

package/dist/app/action-form-shim.js

@@ -14,6 +14,7 @@
 // RenderActionForm-Komponente, die `fields` direkt als Input nimmt.
 // Der Boot-Validator kennt actionForm bereits eigenständig (kein
 // entity-Lookup), also ist der Server-Pfad davon nicht betroffen.
+import { isFieldsEditSection, normalizeEditField, sectionFieldSpecs, } from "@cosmicdrift/kumiko-framework/ui-types";
 const ACTION_FORM_PSEUDO_ENTITY = "__action-form__";
 /** Baut eine minimale EntityDefinition aus den Inline-Fields eines
  *  ActionForm- oder SecretMint-Screens. RenderEdit + computeEditViewModel
@@ -22,6 +23,51 @@ const ACTION_FORM_PSEUDO_ENTITY = "__action-form__";
 export function synthesizeActionFormEntity(fields) {
     return { fields };
 }
+// An actionForm has no create/update mode, so the entityEdit `writeExcludedFields`
+// (which hides the field in create mode) does not fit. The values arrive via prefill
+// (row drawer, handoff, URL), so show them read-only: `submit: false` because the
+// handler does not accept the field, `required: false` so an empty one cannot block submit.
+function lockExcludedFieldSpec(spec, excluded) {
+    const normalized = normalizeEditField(spec);
+    if (!excluded.has(normalized.field))
+        return spec;
+    return { ...normalized, readOnly: true, required: false, submit: false };
+}
+function lockExcludedFieldsInSection(section, excluded) {
+    if (!isFieldsEditSection(section))
+        return section;
+    return {
+        ...section,
+        // kumiko-lint-ignore section-fields-raw rewrites both sources in place — the groups branch below does the same for groups[].fields
+        fields: section.fields.map((spec) => lockExcludedFieldSpec(spec, excluded)),
+        ...(section.groups !== undefined && {
+            groups: section.groups.map((group) => ({
+                ...group,
+                fields: group.fields.map((spec) => lockExcludedFieldSpec(spec, excluded)),
+            })),
+        }),
+    };
+}
+function layoutWithLockedExcludedFields(screen) {
+    if (screen.type !== "actionForm" || !screen.writeExcludedFields?.length)
+        return screen.layout;
+    const excluded = new Set(screen.writeExcludedFields);
+    return {
+        ...screen.layout,
+        sections: screen.layout.sections.map((section) => lockExcludedFieldsInSection(section, excluded)),
+    };
+}
+/** Fields the form may seed and submit. An excluded field the layout does not show
+ *  would otherwise reach the payload through its `default`, and the handler rejects it. */
+export function actionFormSubmittableFields(screen) {
+    const excluded = screen.writeExcludedFields;
+    if (!excluded?.length)
+        return screen.fields;
+    const inLayout = new Set(screen.layout.sections.flatMap((section) => isFieldsEditSection(section)
+        ? sectionFieldSpecs(section).map((spec) => normalizeEditField(spec).field)
+        : []));
+    return Object.fromEntries(Object.entries(screen.fields).filter(([name]) => inLayout.has(name) || !excluded.includes(name)));
+}
 /** Wandelt ein ActionFormScreenDefinition oder SecretMintScreenDefinition in
  *  die EntityEditScreen-Shape die RenderEdit erwartet. type wird auf
  *  "entityEdit" gesetzt damit der Type-Constraint hält; entity wird auf den
@@ -31,7 +77,7 @@ export function synthesizeActionFormScreen(screen) {
         id: screen.id,
         type: "entityEdit",
         entity: ACTION_FORM_PSEUDO_ENTITY,
-        layout: screen.layout,
+        layout: layoutWithLockedExcludedFields(screen),
         ...(screen.description !== undefined && { description: screen.description }),
         ...(screen.access !== undefined && { access: screen.access }),
         // Only ActionFormScreenDefinition carries slots/fieldLabels; `in` narrows

package/dist/app/kumiko-screen.js

@@ -23,7 +23,7 @@ import { InsideDrawerProvider, useInsideDrawer } from "../inside-drawer.js";
 import { PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "../page-header-slot.js";
 import { statusToneForOptionTone, statusToneForValue, usePrimitives, } from "../primitives.js";
 import { screenFillsHeight } from "../screen-fills-height.js";
-import { synthesizeActionFormEntity, synthesizeActionFormScreen } from "./action-form-shim.js";
+import { actionFormSubmittableFields, synthesizeActionFormEntity, synthesizeActionFormScreen, } from "./action-form-shim.js";
 import { useAppFeatures } from "./app-features-context.js";
 import { buildConfigEditSchema, synthesizeConfigEditEntity, synthesizeConfigEditScreen, } from "./config-edit-shim.js";
 import { useCustomScreenComponent } from "./custom-screens.js";
@@ -2356,7 +2356,8 @@ function ActionFormBody({ schema, screen, translate, initialOverrides, onSuccess
     const { Banner } = usePrimitives();
     // Unused when drawer-hosted — onSuccess/onCancelOverride win below first.
     const returnTarget = useReturnTarget(screen.id);
-    const synthEntity = useMemo(() => synthesizeActionFormEntity(screen.fields), [screen.fields]);
+    const submittableFields = useMemo(() => actionFormSubmittableFields(screen), [screen]);
+    const synthEntity = useMemo(() => synthesizeActionFormEntity(submittableFields), [submittableFields]);
     const synthScreen = useMemo(() => synthesizeActionFormScreen(screen), [screen]);
     const pendingHandoff = useInitialValuesHandoff(screen.id);
     // A drawer-hosted form is not a navigation target, so it never takes a handoff.
@@ -2368,7 +2369,7 @@ 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(screen.fields, {
+    const initial = useMemo(() => mergeSearchParamsIntoInitial(submittableFields, {
         searchParams: nav.searchParams,
         urlPrefillFields: screen.urlPrefillFields,
         renderableFields: layoutFieldNames(synthScreen),
@@ -2376,7 +2377,7 @@ function ActionFormBody({ schema, screen, translate, initialOverrides, onSuccess
         ...(initialOverrides !== undefined && { drawerOverrides: initialOverrides }),
         ...(handoffValues !== undefined && { handoffValues }),
     }), [
-        screen.fields,
+        submittableFields,
         screen.urlPrefillFields,
         nav.searchParams,
         synthScreen,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.358.0",
+  "version": "0.359.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.358.0",
-    "@cosmicdrift/kumiko-headless": "0.358.0",
-    "@cosmicdrift/kumiko-types": "0.358.0",
+    "@cosmicdrift/kumiko-framework": "0.359.0",
+    "@cosmicdrift/kumiko-headless": "0.359.0",
+    "@cosmicdrift/kumiko-types": "0.359.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.358.0"
+    "@cosmicdrift/kumiko-locale-de": "0.359.0"
   },
   "repository": {
     "type": "git",