@cosmicdrift/kumiko-framework 0.202.0 → 0.204.0

package/src/engine/build-app-schema.ts

@@ -27,7 +27,15 @@
 // Kontext um sie zu lesen. TODO wenn das ein realer Use-Case wird:
 // `effectiveFeatures` Argument annehmen und über alle iterations filtern.
 
-import type { AppSchema, EntityDefinition, FeatureSchema, WorkspaceSchema } from "../ui-types";
+import { ZodObject, type ZodType } from "zod";
+import type {
+  AppSchema,
+  EntityDefinition,
+  FeatureSchema,
+  ProjectionListScreenDefinition,
+  ScreenDefinition,
+  WorkspaceSchema,
+} from "../ui-types";
 import {
   buildConfigFeatureSchema,
   type ConfigFeatureSchema,
@@ -63,7 +71,7 @@ export function buildAppSchema(registry: Registry, options: BuildAppSchemaOption
     const featureSchema: FeatureSchema = {
       featureName,
       entities: projectEntities(feature.entities ?? {}),
-      screens: Object.values(feature.screens),
+      screens: projectScreens(feature.screens, registry),
       ...(navs.length > 0 && { navs }),
       ...(contentCollections.length > 0 && { contentCollections }),
       // #1059: verbatim r.translations({keys}) — see FeatureSchema.translations
@@ -289,6 +297,51 @@ export function findNonJsonSafePath(value: unknown, path: string): string | null
   return path;
 }
 
+// projectionList screens don't declare searchable/sortable/paginated as
+// authoring intent — they're derived here from the bound query handler's
+// Zod schema, the source of truth for what parameters it actually accepts
+// (fw#2165). A hand-written `searchable: true` still wins over the derived
+// default (screen.searchable ?? derived); the boot-validator (3a) rejects
+// one that contradicts the schema.
+function projectScreens(
+  screens: Readonly<Record<string, ScreenDefinition>>,
+  registry: Registry,
+): ScreenDefinition[] {
+  return Object.values(screens).map((screen) =>
+    screen.type === "projectionList" ? projectProjectionListScreen(screen, registry) : screen,
+  );
+}
+
+function projectProjectionListScreen(
+  screen: ProjectionListScreenDefinition,
+  registry: Registry,
+): ProjectionListScreenDefinition {
+  const schema = registry.getQueryHandler(screen.query)?.schema;
+  const capabilities = deriveProjectionListCapabilities(schema);
+  return {
+    ...screen,
+    searchable: screen.searchable ?? capabilities.searchable,
+    sortable: capabilities.sortable,
+    paginated: capabilities.paginated,
+  };
+}
+
+// Zod v4: a ZodObject's param names live on `.shape`. A schema that isn't a
+// ZodObject (e.g. a z.union across payload shapes) yields no capability
+// instead of throwing — same as a missing/unresolved query handler.
+function deriveProjectionListCapabilities(schema: ZodType | undefined): {
+  searchable: boolean;
+  sortable: boolean;
+  paginated: boolean;
+} {
+  const shape = schema instanceof ZodObject ? schema.shape : undefined;
+  return {
+    searchable: shape !== undefined && "search" in shape,
+    sortable: shape !== undefined && "sort" in shape,
+    paginated: shape !== undefined && ("cursor" in shape || "offset" in shape),
+  };
+}
+
 function projectEntities(
   entities: Readonly<Record<string, EntityDefinition>>,
 ): Readonly<Record<string, EntityDefinition>> {

package/src/engine/index.ts

@@ -227,7 +227,12 @@ export { runsInLane } from "./run-in";
 export type { StepListOutcome } from "./run-pipeline";
 export { runPipeline, runStepList } from "./run-pipeline";
 export { buildInsertSchema, buildUpdateSchema, fieldToZod } from "./schema-builder";
-export { isExtensionEditSection, normalizeEditField, normalizeListColumn } from "./screen-helpers";
+export {
+  isExtensionEditSection,
+  isFieldsEditSection,
+  normalizeEditField,
+  normalizeListColumn,
+} from "./screen-helpers";
 export type { TransitionGraph } from "./state-machine";
 export { defineTransitions, guardTransition } from "./state-machine";
 export {

package/src/engine/screen-helpers.ts

@@ -1,6 +1,7 @@
 import type {
   EditExtensionSection,
   EditFieldSpec,
+  EditFieldsSection,
   EditSectionSpec,
   FieldCondition,
   FormatSpec,
@@ -11,6 +12,10 @@ export function isExtensionEditSection(section: EditSectionSpec): section is Edi
   return section.kind === "extension";
 }
 
+export function isFieldsEditSection(section: EditSectionSpec): section is EditFieldsSection {
+  return section.kind === undefined || section.kind === "fields";
+}
+
 // Type guard — narrows FieldRenderer to FormatSpec. Useful for renderer
 // authors who branch on the three FieldRenderer variants without manual
 // "format" in renderer checks.

package/src/i18n/required-surface-keys.ts

@@ -153,6 +153,7 @@ export function requiredKeysFromScreen(
           pushKey(out, section.title);
           continue;
         }
+        if (section.kind === "relatedList") continue; // rejected at boot, unreachable here
         pushKey(out, section.title);
         for (const f of section.fields) {
           const fieldName = editFieldName(f);
@@ -174,6 +175,7 @@ export function requiredKeysFromScreen(
           pushKey(out, section.title);
           continue;
         }
+        if (section.kind === "relatedList") continue; // rejected at boot, unreachable here
         pushKey(out, section.title);
         for (const f of section.fields) {
           const fieldName = editFieldName(f);
@@ -195,6 +197,7 @@ export function requiredKeysFromScreen(
           pushKey(out, section.title);
           continue;
         }
+        if (section.kind === "relatedList") continue; // rejected at boot, unreachable here
         pushKey(out, section.title);
         for (const f of section.fields) {
           const fieldName = editFieldName(f);
@@ -209,6 +212,14 @@ export function requiredKeysFromScreen(
       const detail = screen as ProjectionDetailScreenDefinition;
       for (const section of detail.layout.sections) {
         if (isExtensionEditSection(section)) continue; // rejected at boot, unreachable here
+        if (section.kind === "relatedList") {
+          pushKey(out, section.title);
+          for (const col of section.columns) {
+            const normalized = normalizeListColumn(col);
+            if (normalized.label !== undefined) pushKey(out, normalized.label);
+          }
+          continue;
+        }
         pushKey(out, section.title);
         for (const f of section.fields) {
           const fieldName = editFieldName(f);

package/src/testing/e2e-generator.ts

@@ -30,7 +30,7 @@ import {
   type EntityEditScreenDefinition,
   type EntityListScreenDefinition,
   type FieldDefinition,
-  isExtensionEditSection,
+  isFieldsEditSection,
   normalizeEditField,
   normalizeListColumn,
   parseQn,
@@ -243,7 +243,7 @@ function collectRequiredEditFields(
 ): string[] {
   const out: string[] = [];
   for (const section of screen.layout.sections) {
-    if (isExtensionEditSection(section)) continue;
+    if (!isFieldsEditSection(section)) continue;
     for (const rawField of section.fields) {
       const { field } = normalizeEditField(rawField);
       const def = entity.fields[field];
@@ -281,7 +281,7 @@ function buildEditFillOps(
   // form; Felder ohne Fixture-Wert (file/image/…) werden übersprungen.
   const ops: EditFillOp[] = [];
   for (const section of screen.layout.sections) {
-    if (isExtensionEditSection(section)) continue;
+    if (!isFieldsEditSection(section)) continue;
     for (const raw of section.fields) {
       const { field } = normalizeEditField(raw);
       const def = entity.fields[field];
@@ -329,7 +329,7 @@ function pickIdentifyingForEdit(
     : undefined;
 
   for (const section of editScreen.layout.sections) {
-    if (isExtensionEditSection(section)) continue;
+    if (!isFieldsEditSection(section)) continue;
     for (const rawField of section.fields) {
       const { field } = normalizeEditField(rawField);
       if (entity.fields[field]?.type !== "text") continue;

package/src/ui-types/index.ts

@@ -28,6 +28,7 @@ export { parseRefTarget } from "../engine/parse-ref-target";
 export {
   evalFieldCondition,
   isExtensionEditSection,
+  isFieldsEditSection,
   isFormatSpec,
   normalizeEditField,
   normalizeListColumn,
@@ -71,6 +72,7 @@ export type {
   EditFieldSpec,
   EditFieldsSection,
   EditLayout,
+  EditRelatedListSection,
   EditSectionSpec,
   EntityEditScreenDefinition,
   EntityListScreenDefinition,