@cosmicdrift/kumiko-headless 0.332.0 → 0.334.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/index.d.ts

@@ -11,4 +11,4 @@ export { resolveNavigation } from "./nav/index.js";
 export type { Store, WritableStore } from "./store/index.js";
 export { createStore, shallowEqual } from "./store/index.js";
 export type { ComputeEditViewModelInput, ComputeListViewModelInput, DerivedCellRoundingTarget, EditExtensionSectionViewModel, EditFieldSpec, EditFieldsSectionViewModel, EditFieldViewModel, EditRelatedListSectionViewModel, EditSectionSpec, EditSectionViewModel, EditViewModel, EditWriteFormSectionViewModel, EmbeddedDerivedOp, EmbeddedListCellViewModel, EmbeddedListIssueGroups, FieldConditionCtx, FieldRenderer, ListColumnSpec, ListColumnViewModel, ListRowViewModel, ListViewModel, RuntimeRenderer, ScreenSlots, Translate, } from "./view-model/index.js";
-export { computeDerivedCellValue, computeEditViewModel, computeListViewModel, computeRelatedListSectionViewModel, embeddedCellLabelKey, embeddedCellOptionLabelKey, fieldLabelKey, fieldOptionLabelKey, fieldOptionLabelKeyPrefix, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "./view-model/index.js";
+export { buildOptionLabels, computeDerivedCellValue, computeEditViewModel, computeListViewModel, computeRelatedListSectionViewModel, embeddedCellLabelKey, embeddedCellOptionLabelKey, fieldLabelKey, fieldOptionLabelKey, fieldOptionLabelKeyPrefix, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "./view-model/index.js";

package/dist/index.js

@@ -6,4 +6,4 @@ export { createFormController, I18N_KEY_PARAM } from "./form/index.js";
 export { applyFormatSpec, currencyDecimals, escapeHtml, escapeHtmlAttr, escapeXml, html, isSafeHref, RawHtml, raw, stripControlChars, toInstant, } from "./format/index.js";
 export { resolveNavigation } from "./nav/index.js";
 export { createStore, shallowEqual } from "./store/index.js";
-export { computeDerivedCellValue, computeEditViewModel, computeListViewModel, computeRelatedListSectionViewModel, embeddedCellLabelKey, embeddedCellOptionLabelKey, fieldLabelKey, fieldOptionLabelKey, fieldOptionLabelKeyPrefix, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "./view-model/index.js";
+export { buildOptionLabels, computeDerivedCellValue, computeEditViewModel, computeListViewModel, computeRelatedListSectionViewModel, embeddedCellLabelKey, embeddedCellOptionLabelKey, fieldLabelKey, fieldOptionLabelKey, fieldOptionLabelKeyPrefix, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "./view-model/index.js";

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 && {
@@ -117,9 +120,11 @@ function deriveTextFieldHints(fieldDef) {
     const format = fieldDef.type === "text"
         ? fieldDef.format
         : undefined;
+    const writeOnly = fieldDef.type === "text" && fieldDef.writeOnly === true;
     return {
         ...(multiline !== undefined && { multiline }),
         ...(format !== undefined && { format }),
+        ...(writeOnly && { writeOnly: true }),
     };
 }
 function deriveDateFieldHints(fieldDef) {
@@ -378,6 +383,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/index.d.ts

@@ -3,5 +3,5 @@ export { computeEditViewModel, computeRelatedListSectionViewModel } from "./edit
 export type { DerivedCellRoundingTarget, EmbeddedDerivedOp, EmbeddedListIssueGroups, } from "./embedded-list.js";
 export { computeDerivedCellValue, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "./embedded-list.js";
 export type { ComputeListViewModelInput } from "./list.js";
-export { computeListViewModel, embeddedCellLabelKey, embeddedCellOptionLabelKey, fieldLabelKey, fieldOptionLabelKey, fieldOptionLabelKeyPrefix, } from "./list.js";
+export { buildOptionLabels, computeListViewModel, embeddedCellLabelKey, embeddedCellOptionLabelKey, fieldLabelKey, fieldOptionLabelKey, fieldOptionLabelKeyPrefix, } from "./list.js";
 export type { EditExtensionSectionViewModel, EditFieldSpec, EditFieldsSectionViewModel, EditFieldViewModel, EditRelatedListSectionViewModel, EditSectionSpec, EditSectionViewModel, EditViewModel, EditWriteFormSectionViewModel, EmbeddedListCellViewModel, FieldConditionCtx, FieldRenderer, ListColumnSpec, ListColumnViewModel, ListRowViewModel, ListViewModel, RuntimeRenderer, ScreenSlots, Translate, } from "./types.js";

package/dist/view-model/index.js

@@ -1,3 +1,3 @@
 export { computeEditViewModel, computeRelatedListSectionViewModel } from "./edit.js";
 export { computeDerivedCellValue, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "./embedded-list.js";
-export { computeListViewModel, embeddedCellLabelKey, embeddedCellOptionLabelKey, fieldLabelKey, fieldOptionLabelKey, fieldOptionLabelKeyPrefix, } from "./list.js";
+export { buildOptionLabels, computeListViewModel, embeddedCellLabelKey, embeddedCellOptionLabelKey, fieldLabelKey, fieldOptionLabelKey, fieldOptionLabelKeyPrefix, } from "./list.js";

package/dist/view-model/list.js

@@ -1,4 +1,5 @@
 import { LIST_ROW_META_COLUMNS, LIST_ROW_META_REFERENCES, normalizeListColumn, parseRefTarget, } from "@cosmicdrift/kumiko-framework/ui-types";
+const WRITE_ONLY_SET_LABEL_KEY = "kumiko.field.writeOnly.set";
 // Pure transform: takes the declared screen + entity + incoming rows, spits
 // out the flat shape the renderer draws. No conditions, no access-checks —
 // those are list-level decisions that the caller makes BEFORE calling
@@ -136,9 +137,24 @@ export function computeListViewModel(input) {
         };
         columns.push(column);
     }
+    const writeOnlyFieldNames = screen.columns
+        .map((spec) => normalizeListColumn(spec).field)
+        .filter((name) => {
+        const fieldDef = entity.fields[name];
+        return fieldDef?.type === "text" && fieldDef.writeOnly === true;
+    });
+    // The wire carries `true` (set) / `null` (empty) for writeOnly fields; the cell shows a word, not "true".
+    const showWriteOnlyAsWord = (row) => {
+        const shown = { ...row };
+        for (const name of writeOnlyFieldNames) {
+            if (row[name] === true)
+                shown[name] = translate(WRITE_ONLY_SET_LABEL_KEY);
+        }
+        return shown;
+    };
     const listRows = rows.map((row) => ({
         id: String(row["id"] ?? ""),
-        values: row,
+        values: showWriteOnlyAsWord(row),
     }));
     return {
         screenId: screen.id,

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, OptionsQueryPayload, 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;
@@ -85,12 +85,13 @@ export type EditFieldViewModel = {
      *  `<feature>:entity:<entity>:field:<field>:option:<value>`. */
     readonly optionLabels?: Readonly<Record<string, string>>;
     /** Set for `type: "select"` when SelectFieldDef.optionsQuery is set: the
-     *  renderer loads the options from this query (`{ rows: { value, label }[] }`,
-     *  labels verbatim) instead of `options`. `payload` is the static
-     *  optionsQueryPayload, `{}` when absent. */
+     *  renderer loads the options from this query (`{ rows: { value, label,
+     *  description?, group? }[] }`, labels verbatim) instead of `options`. `payload`
+     *  is optionsQueryPayload (`{ field }` refs are resolved by the renderer against
+     *  the live form values), `{}` when absent. */
     readonly selectOptionsQuery?: {
         readonly query: string;
-        readonly payload: Readonly<Record<string, string | number | boolean>>;
+        readonly payload: OptionsQueryPayload;
     };
     /** Set for `type: "multiSelect"` when MultiSelectFieldDef.display is
      *  "checkboxes" — the renderer shows a checkbox grid with a select-all
@@ -116,6 +117,8 @@ export type EditFieldViewModel = {
     };
     /** From TextFieldDef.format — `password` makes the renderer mask the input. */
     readonly format?: "email" | "url" | "phone" | "password";
+    /** From TextFieldDef.writeOnly — value is `true` (set) / `null` (empty), never plaintext. */
+    readonly writeOnly?: true;
     /** Nur bei `type: "timestamp"` gesetzt wenn TimestampFieldDef.locatedBy
      *  existiert — Wall-Clock-Zeit ohne Offset. Der Renderer emittiert
      *  dann lokale Zeit ohne `Z` statt eines UTC-Instants. */
@@ -221,6 +224,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 +277,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.332.0",
+  "version": "0.334.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.332.0",
+    "@cosmicdrift/kumiko-framework": "0.334.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },