@cosmicdrift/kumiko-headless 0.354.1 → 0.356.0

package/dist/index.d.ts

@@ -10,5 +10,5 @@ export type { NavDefinition, NavNode, NavRegistrySlice, NavTree, ResolveNavigati
 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 type { ComputeEditViewModelInput, ComputeListViewModelInput, DerivedCellRoundingTarget, EditExtensionSectionViewModel, EditFieldSpec, EditFieldsSectionViewModel, EditFieldViewModel, EditFormMode, EditRelatedListSectionViewModel, EditSectionSpec, EditSectionViewModel, EditViewModel, EditWriteFormSectionViewModel, EmbeddedDerivedOp, EmbeddedListCellViewModel, EmbeddedListIssueGroups, FieldConditionCtx, FieldRenderer, ListColumnSpec, ListColumnViewModel, ListRowViewModel, ListViewModel, RuntimeRenderer, ScreenSlots, Translate, } 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.d.ts

@@ -6,6 +6,11 @@ export type ComputeEditViewModelInput<TValues extends Readonly<Record<string, un
     readonly values: TValues;
     readonly translate: Translate;
     readonly featureName: string;
+    /** Which write the form drives. Applies the screen's `writeExcludedFields`
+     *  for that verb (create hides them, update shows them read-only); omitted
+     *  means no exclusion applies. */
+    readonly mode?: EditFormMode;
 };
+export type EditFormMode = "create" | "update";
 export declare function computeRelatedListSectionViewModel(sectionSpec: EditRelatedListSection, translate: Translate): EditRelatedListSectionViewModel;
 export declare function computeEditViewModel<TValues extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>>(input: ComputeEditViewModelInput<TValues>): EditViewModel;

package/dist/view-model/edit.js

@@ -42,6 +42,9 @@ function computeWriteFormSectionViewModel(sectionSpec, screenId, values, transla
         ...(sectionSpec.actions !== undefined && { actions: sectionSpec.actions }),
     };
 }
+function wasEmptiedByWriteExclusion(declaredFieldSpecs, remainingFields) {
+    return declaredFieldSpecs.length > 0 && remainingFields.length === 0;
+}
 // relatedList runs its own query — nothing here to resolve against
 // entity/values, the spec passes through verbatim (fw#2166).
 export function computeRelatedListSectionViewModel(sectionSpec, translate) {
@@ -304,7 +307,9 @@ function buildExtensionSectionViewModel(sectionSpec, translate) {
 // section/field tree the renderer draws. FieldConditions are evaluated here
 // so the renderer never re-runs them during React render.
 export function computeEditViewModel(input) {
-    const { screen, entity, values, translate, featureName } = input;
+    const { screen, entity, values, translate, featureName, mode } = input;
+    const excludedFields = new Set(mode === undefined ? [] : screen.writeExcludedFields?.[mode]);
+    const isHiddenByExclusion = (fieldSpec) => mode === "create" && excludedFields.has(normalizeEditField(fieldSpec).field);
     const sections = screen.layout.sections.map((sectionSpec) => {
         if (isExtensionEditSection(sectionSpec)) {
             return buildExtensionSectionViewModel(sectionSpec, translate);
@@ -317,7 +322,10 @@ export function computeEditViewModel(input) {
         }
         // `groups` flattens into the same per-field pipeline as plain `fields`;
         // the group structure below just re-groups the computed views by name.
-        const fields = sectionFieldSpecs(sectionSpec).map((fieldSpec) => {
+        const declaredFieldSpecs = sectionFieldSpecs(sectionSpec);
+        const fields = declaredFieldSpecs
+            .filter((fieldSpec) => !isHiddenByExclusion(fieldSpec))
+            .map((fieldSpec) => {
             const normalized = normalizeEditField(fieldSpec);
             const fieldDef = entity.fields[normalized.field];
             if (!fieldDef) {
@@ -343,7 +351,8 @@ export function computeEditViewModel(input) {
             // `readOnly` (camelCase) is the name on both sides: EditFieldSpec
             // in the engine, and the view-model emitted here. One convention
             // through the stack beats translating at the boundary.
-            const readOnly = evalCondition(normalized.readOnly, false, values);
+            const readOnly = (mode === "update" && excludedFields.has(normalized.field)) ||
+                evalCondition(normalized.readOnly, false, values);
             // `required` on the field-spec overrides the entity-default. A
             // field that's required at the entity-level but marked required:
             // false on the screen (e.g. a soft-onboarding wizard that
@@ -383,14 +392,17 @@ export function computeEditViewModel(input) {
             };
             return view;
         });
-        // Boot-validator rejects fields.length === 0 with no groups (screens.ts),
-        // so an empty section never reaches this code.
+        // The boot-validator rejects declared-empty sections (screens.ts), but a
+        // create-excluded field list can still empty one here: then `visible` is false.
         const visible = fields.some((field) => field.visible);
         // Tabs mode renders this section as its own panel, where two columns reads
         // better than the single-column default a stacked form keeps. Applies to
         // entityEdit tabs as well since fw#3134, not just projectionDetail.
         const defaultColumns = screen.layout.mode === "tabs" ? 2 : 1;
-        const groups = sectionSpec.groups?.map((group) => ({
+        const groups = sectionSpec.groups
+            ?.map((group) => ({ ...group, fields: group.fields.filter((f) => !isHiddenByExclusion(f)) }))
+            .filter((group) => group.fields.length > 0)
+            .map((group) => ({
             title: translate(group.title),
             columns: group.columns ?? 2,
             fields: group.fields.map((fieldSpec) => {
@@ -407,6 +419,7 @@ export function computeEditViewModel(input) {
             kind: "fields",
             ...(sectionSpec.id !== undefined && { id: sectionSpec.id }),
             visible,
+            emptiedByWriteExclusion: wasEmptiedByWriteExclusion(declaredFieldSpecs, fields),
             // Titellose Section (flache Form) → kein h3; nur übersetzen wenn gesetzt.
             ...(sectionSpec.title !== undefined && { title: translate(sectionSpec.title) }),
             ...(sectionSpec.description !== undefined && {

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

@@ -1,4 +1,4 @@
-export type { ComputeEditViewModelInput } from "./edit.js";
+export type { ComputeEditViewModelInput, EditFormMode } from "./edit.js";
 export { computeEditViewModel, computeRelatedListSectionViewModel } from "./edit.js";
 export type { DerivedCellRoundingTarget, EmbeddedDerivedOp, EmbeddedListIssueGroups, } from "./embedded-list.js";
 export { computeDerivedCellValue, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "./embedded-list.js";

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

@@ -228,6 +228,10 @@ export type EditFieldsSectionViewModel = {
      *  The renderer then draws nothing, but the section stays in the array
      *  (key stability). */
     readonly visible: boolean;
+    /** Set when every declared field was hidden by the create handler's
+     *  `excludeFields`. Unlike a declared-empty section (review step), the
+     *  renderer must not give it a tab or wizard step. */
+    readonly emptiedByWriteExclusion?: boolean;
     /** Optional — eine titellose Section rendert nur ihre Felder (flache Form). */
     readonly title?: string;
     /** Translated help text under the block heading, from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.354.1",
+  "version": "0.356.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,8 +36,8 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.354.1",
-    "@cosmicdrift/kumiko-types": "0.354.1",
+    "@cosmicdrift/kumiko-framework": "0.356.0",
+    "@cosmicdrift/kumiko-types": "0.356.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },