@cosmicdrift/kumiko-types 0.202.0 → 0.204.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.202.0",
+  "version": "0.204.0",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren. Enthaelt keine identitaets-sensitiven Runtime-Werte mehr (Error-Klassen leben seit #1629 in kumiko-framework, Brand-Symbole nutzen Symbol.for) und ist deshalb eine plain dependency, keine peerDependency.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/screen.ts

@@ -323,6 +323,16 @@ export type ProjectionListScreenDefinition = {
   readonly pageSize?: number;
   readonly defaultSort?: ListSortSpec;
   readonly searchable?: boolean;
+  /** Derived by buildAppSchema from the query handler's Zod schema (`sort`
+   *  param present). Same type serves author and wire schema (no separate
+   *  client-facing screen type exists), so this stays structurally
+   *  writable — validateProjectionListScreens rejects any hand-authored
+   *  value at boot (fw#2165). */
+  readonly sortable?: boolean;
+  /** Derived by buildAppSchema from the query handler's Zod schema (`cursor`
+   *  or `offset` param present). See `sortable` doc for why this is
+   *  boot-enforced rather than type-enforced. */
+  readonly paginated?: boolean;
   readonly slots?: ScreenSlots;
   readonly access?: AccessRule;
 };
@@ -341,7 +351,9 @@ export type ProjectionListScreenDefinition = {
 // (e.g. jobs' `detailQuery` expects `runId`) — this lets the primitive bind
 // to it without forcing a handler rename. Extension sections aren't
 // supported (no entity for them to persist against); the boot-validator
-// rejects them.
+// rejects them. `relatedList` sections ARE supported — they run their own
+// query against the displayed record's id, independent of the entity gap
+// above (fw#2166).
 export type ProjectionDetailScreenDefinition = {
   readonly id: string;
   readonly type: "projectionDetail";
@@ -358,6 +370,12 @@ export type ProjectionDetailScreenDefinition = {
   readonly listScreenId?: string;
   readonly slots?: ScreenSlots;
   readonly access?: AccessRule;
+  /** Header action buttons. Reuses `RowAction` — the screen's single
+   *  displayed record stands in for the "row", so `pick`/`map`, `visible`,
+   *  `confirm`/`confirmLabel` and `style` keep their meaning unchanged.
+   *  `rowClick` has no target here (there is no row to click) and is
+   *  rejected by the boot-validator. */
+  readonly actions?: readonly RowAction[];
 };
 
 // --- dashboard ---
@@ -526,13 +544,15 @@ export type EditFieldSpec =
       readonly icon?: string;
     };
 
-// A section is either a normal field-grid (default — `kind` omitted keeps
-// every existing screen-def working) or an extension slot that mounts a
-// feature-provided component. The extension component is resolved client-
-// side by name (same `__component` marker as custom screens / column
-// renderers) and receives the host entity name + id, so a bundled feature
-// (e.g. custom-fields) can load and persist its own data inside the form.
-export type EditSectionSpec = EditFieldsSection | EditExtensionSection;
+// A section is a normal field-grid (default — `kind` omitted keeps every
+// existing screen-def working), an extension slot that mounts a feature-
+// provided component, or a related-list of other records. The extension
+// component is resolved client-side by name (same `__component` marker as
+// custom screens / column renderers) and receives the host entity name +
+// id, so a bundled feature (e.g. custom-fields) can load and persist its
+// own data inside the form. `relatedList` runs its own query instead —
+// see `EditRelatedListSection`.
+export type EditSectionSpec = EditFieldsSection | EditExtensionSection | EditRelatedListSection;
 
 export type EditFieldsSection = {
   readonly kind?: "fields";
@@ -556,6 +576,27 @@ export type EditExtensionSection = {
   readonly component: PlatformComponent;
 };
 
+// Read-only list of related records, driven by its own query — for a
+// projectionDetail screen showing e.g. a tenant's payments below the
+// tenant's own fields. Only supported on projectionDetail (fw#2166); the
+// boot-validator rejects it on entityEdit/configEdit/actionForm.
+export type EditRelatedListSection = {
+  readonly kind: "relatedList";
+  readonly title: string;
+  /** Fully qualified query QN. Same paged envelope as projectionList.query:
+   *  `{ rows, nextCursor, total? }`. */
+  readonly query: string;
+  /** Query-payload key the parent record's id is passed under. Default "id". */
+  readonly parentParam?: string;
+  readonly columns: readonly ListColumnSpec[];
+  readonly pageSize?: number;
+  /** Row click opens the target entity's detail screen via ObjectTarget —
+   *  the `detailFor` lookup owns the entity→screen mapping, so no screenId
+   *  is named here. `idColumn` names the row key holding that id (default
+   *  "id"). Omit `rowClick` for a non-interactive list. */
+  readonly rowClick?: { readonly entity: string; readonly idColumn?: string };
+};
+
 // Max width of the form container (see FormScreenShell in renderer-web).
 export type FormWidth = "sm" | "3xl" | "4xl" | "full";