@cosmicdrift/kumiko-headless 0.331.0 → 0.333.0

package/dist/form/form-controller.js

@@ -84,6 +84,13 @@ function stripUntouchedEmptyStrings(values, initial, forceIncludeEmpty) {
 function freezeSnapshot(snapshot) {
     return Object.freeze(snapshot);
 }
+function omitPayloadFields(payload, omitFields) {
+    if (!omitFields || omitFields.length === 0)
+        return payload;
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload))
+        return payload;
+    return Object.fromEntries(Object.entries(payload).filter(([key]) => !omitFields.includes(key)));
+}
 export function createFormController(options) {
     // Shallow copy so mutating the input after creation doesn't bleed into
     // the controller's internal state. `initial` stays fixed across the
@@ -340,6 +347,7 @@ export function createFormController(options) {
             else {
                 payload = stripUntouchedEmptyStrings(submittedValues, submittedSnapshot.initial, forceIncludeEmpty);
             }
+            payload = omitPayloadFields(payload, submitCfg.omitFields);
             // Only enforced here, right before the write actually happens — a
             // form that never reaches this point (blocked by validation, or a
             // clean payloadMode "changes" no-op) must not throw just because no

package/dist/form/types.d.ts

@@ -53,6 +53,10 @@ export type SubmitConfig<TValues extends FormValues = FormValues> = {
      *  "values" doc for why the stripping exists. Default `true` (current
      *  behavior). Set `false` to send those fields as `""` unchanged. */
     readonly stripEmptySeeds?: boolean;
+    /** Top-level payload keys removed right before dispatch, for fields that
+     *  are shown or validated but must not reach the write handler. Applied
+     *  to the built payload only when it is a plain object. */
+    readonly omitFields?: readonly string[];
     readonly buildPayload?: (snapshot: FormSnapshot<TValues>) => unknown;
     readonly serverFieldPathPrefix?: string;
     /** Restricts submit()'s internal validate() call to these field names —

package/dist/view-model/edit.js

@@ -63,6 +63,9 @@ export function computeRelatedListSectionViewModel(sectionSpec, translate) {
         ...(sectionSpec.facets !== undefined && { facets: sectionSpec.facets }),
         ...(sectionSpec.rowClick !== undefined && { rowClick: sectionSpec.rowClick }),
         ...(sectionSpec.rowActions !== undefined && { rowActions: sectionSpec.rowActions }),
+        ...(sectionSpec.rowActionMode !== undefined && { rowActionMode: sectionSpec.rowActionMode }),
+        ...(sectionSpec.groupBy !== undefined && { groupBy: sectionSpec.groupBy }),
+        ...(sectionSpec.rowTone !== undefined && { rowTone: sectionSpec.rowTone }),
         ...(sectionSpec.toolbarActions !== undefined && { toolbarActions: sectionSpec.toolbarActions }),
         ...(sectionSpec.actions !== undefined && { actions: sectionSpec.actions }),
         ...(sectionSpec.emptyState !== undefined && {
@@ -378,6 +381,7 @@ export function computeEditViewModel(input) {
             ...(sectionSpec.description !== undefined && {
                 description: translate(sectionSpec.description),
             }),
+            ...(sectionSpec.subtitle !== undefined && { subtitle: translate(sectionSpec.subtitle) }),
             columns: sectionSpec.columns ?? defaultColumns,
             fields,
             ...(groups !== undefined && { groups }),

package/dist/view-model/types.d.ts

@@ -1,4 +1,4 @@
-import type { EditFieldSpec, EditSectionSpec, FieldIconKey, FieldRenderer, IconKey, ListColumnSpec, ListFacetSpec, ListSortSpec, PlatformComponent, RelatedListToolbarAction, RowAction, ScreenSlots, SelectOptionTone } from "@cosmicdrift/kumiko-framework/ui-types";
+import type { EditFieldSpec, EditSectionSpec, FieldIconKey, FieldRenderer, IconKey, ListColumnSpec, ListFacetSpec, ListSortSpec, PlatformComponent, RelatedListGroupBy, RelatedListRowTone, RelatedListToolbarAction, RowAction, RowActionMode, ScreenSlots, SelectOptionTone } from "@cosmicdrift/kumiko-framework/ui-types";
 export type RuntimeRenderer = (value: unknown, row?: Readonly<Record<string, unknown>>) => string;
 export type ListColumnViewModel = {
     readonly field: string;
@@ -221,6 +221,8 @@ export type EditFieldsSectionViewModel = {
     /** Translated help text under the block heading, from
      *  `EditFieldsSection.description`. Renders even without `title`. */
     readonly description?: string;
+    /** Translated `EditFieldsSection.subtitle` (wizard step rail / up-next box). */
+    readonly subtitle?: string;
     readonly columns: number;
     readonly fields: readonly EditFieldViewModel[];
     /** From `EditFieldsSection.groups` — each entry's `fields` are the same
@@ -272,6 +274,9 @@ export type EditRelatedListSectionViewModel = {
         readonly idColumn?: string;
     };
     readonly rowActions?: readonly RowAction[];
+    readonly rowActionMode?: RowActionMode;
+    readonly groupBy?: RelatedListGroupBy;
+    readonly rowTone?: RelatedListRowTone;
     readonly toolbarActions?: readonly RelatedListToolbarAction[];
     /** From `EditRelatedListSection.actions` — rendered in the
      *  Section's title row, distinct from `toolbarActions` (which render

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.331.0",
+  "version": "0.333.0",
   "description": "Headless UI logic for Kumiko — Dispatcher contract, Form-Controller, View-Model, Nav-Resolver. Plattform- und React-frei; jeder Renderer (renderer, renderer-web, renderer-native, …) komponiert darauf.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -36,7 +36,7 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.331.0",
+    "@cosmicdrift/kumiko-framework": "0.333.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },