@cosmicdrift/kumiko-types 0.245.0 → 0.247.0

package/package.json

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

@@ -130,6 +130,11 @@ export type ListColumnSpec =
       /** Row field on the referenced entity shown as the label (default
        *  "id"). Only meaningful together with `refEntity`. */
       readonly refLabelField?: string;
+      /** Marks this column as sortable via a clickable header — for
+       *  relatedList columns, which have no `EntityDefinition` field to carry
+       *  `sortable` on. Ignored on `entityList` columns, where the entity
+       *  field's own `sortable` flag wins. */
+      readonly sortable?: boolean;
     };
 
 // Pagination-Modi für entityList:
@@ -811,6 +816,11 @@ export type EditRelatedListSection = {
   readonly parentParam?: string;
   readonly columns: readonly ListColumnSpec[];
   readonly pageSize?: number;
+  /** Initial sort on mount, applied client-side over the already-loaded rows
+   *  (this section has no pager, so there is no "loaded subset" to mislead).
+   *  `field` must name a column with `sortable: true` — boot-validator pins
+   *  that, same as `entityList.defaultSort`. */
+  readonly defaultSort?: ListSortSpec;
   /** 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
@@ -928,6 +938,11 @@ export type EntityEditScreenDefinition = {
    *  reusable feature when the target feature is guaranteed to be
    *  mounted alongside it. */
   readonly redirect?: string;
+  /** Parent list screen (short id) for breadcrumb + nav highlighting when
+   *  this screen has no nav entry of its own. Same field/semantics as on
+   *  `custom`/`projectionDetail`; an explicit value here wins over the
+   *  entity-list heuristic (rowAction target / same-entity entityList). */
+  readonly listScreenId?: string;
   /** Optionaler per-Field-Label-i18n-Key (Field-Name → Key), überschreibt
    *  die Default-Konvention `<feature>:entity:<entity>:field:<name>`.
    *  Primär für configEdit: dessen Pseudo-Entity `__config-edit__` hat
@@ -1013,6 +1028,11 @@ export type ActionFormScreenDefinition = {
    *  reusable feature when the target feature is guaranteed to be
    *  mounted alongside it. */
   readonly cancelTarget?: string | false;
+  /** Parent list screen (short id) for breadcrumb + nav highlighting when
+   *  this screen has no nav entry of its own. Same field/semantics as on
+   *  `custom`/`projectionDetail`/`entityEdit`; an explicit value here wins
+   *  over the rowAction heuristic. */
+  readonly listScreenId?: string;
   readonly slots?: ScreenSlots;
   readonly access?: AccessRule;
 };