@cosmicdrift/kumiko-types 0.237.1 → 0.238.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.237.1",
+  "version": "0.238.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

@@ -117,6 +117,17 @@ export type ListColumnSpec =
        *  label; without one it is rejected at boot as an unknown field. `field`
        *  is then just a stable column key (pick any unique slug). */
       readonly label?: string;
+      /** Marks this column as a reference lookup instead of a plain value —
+       *  for projectionList/relatedList columns, which have no
+       *  `EntityDefinition` to carry a real `reference` field type. Same
+       *  target convention as `parseRefTarget`: an entity name (same
+       *  feature) or `feature:entity` (cross-feature). Ignored on
+       *  `entityList` columns, where the field's own declared type always
+       *  wins. */
+      readonly refEntity?: string;
+      /** Row field on the referenced entity shown as the label (default
+       *  "id"). Only meaningful together with `refEntity`. */
+      readonly refLabelField?: string;
     };
 
 // Pagination-Modi für entityList:
@@ -665,6 +676,17 @@ export type EditFieldSpec =
        *  `multiline` routes to a textarea (no icon slot), and other input
        *  kinds (select, combobox, date, …) silently ignore the key. */
       readonly icon?: FieldIconKey;
+      /** Marks this field as a reference lookup instead of a plain value —
+       *  for projectionDetail fields, which have no `EntityDefinition` to
+       *  carry a real `reference` field type. Same target convention as
+       *  `parseRefTarget` (and `ListColumnSpec.refEntity`): an entity name
+       *  (same feature) or `feature:entity` (cross-feature). Ignored on
+       *  `entityEdit` fields, where the field's own declared type always
+       *  wins. */
+      readonly refEntity?: string;
+      /** Row field on the referenced entity shown as the label (default
+       *  "id"). Only meaningful together with `refEntity`. */
+      readonly refLabelField?: string;
     };
 
 // A section is a normal field-grid (default — `kind` omitted keeps every
@@ -751,8 +773,10 @@ export type FormWidth = "3xl" | "4xl" | "full";
 
 export type EditLayout = {
   readonly sections: readonly EditSectionSpec[];
-  /** Default "full" (same content width as lists). Override to "sm" /
-   *  "3xl" / "4xl" only when a screen needs a narrower centered column. */
+  /** Default "4xl" (a centered column, narrower than list chrome), unless
+   *  the app overrides it via `createKumikoApp({ screenWidth })`. Override
+   *  per-screen to "3xl" for a narrower column or "full" to match list
+   *  chrome. */
   readonly width?: FormWidth;
   /** Default "single". "wizard" renders one section per step (with
    *  progress + per-step validation) instead of all sections at once —