@cosmicdrift/kumiko-types 0.201.0 → 0.203.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.201.0",
+  "version": "0.203.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;
 };
@@ -358,6 +368,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 ---
@@ -806,6 +822,13 @@ export type ScreenNavSugar = {
   readonly order?: number;
 };
 
+// `detailFor` sits on the intersection, not on one variant, because any
+// screen kind can be the detail view for an entity — including `custom`:
+// in app repos, detail screens are overwhelmingly custom screens today
+// (projectionDetail doesn't carry entity semantics). Value is an entity
+// name in the same (unqualified, globally-unique) form as `entity` on
+// `EntityListScreenDefinition` (screen.ts:259-262) — entities are never
+// feature-prefixed, so there's no separate qualification step.
 export type ScreenDefinition = (
   | EntityListScreenDefinition
   | ProjectionListScreenDefinition
@@ -815,4 +838,4 @@ export type ScreenDefinition = (
   | ActionFormScreenDefinition
   | ConfigEditScreenDefinition
   | CustomScreenDefinition
-) & { readonly nav?: ScreenNavSugar };
+) & { readonly nav?: ScreenNavSugar; readonly detailFor?: string };