@cosmicdrift/kumiko-types 0.246.0 → 0.248.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.246.0",
+  "version": "0.248.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/nav.ts

@@ -47,8 +47,9 @@ export type NavDefinition = {
   // Hover-Actions rechts in der Zeile (VS-Code-Pattern) — erst bei Hover
   // sichtbar. Reihenfolge wie deklariert.
   readonly actions?: readonly TreeAction[];
-  // „+"-Affordance am Knoten. Klick dispatcht createAction.target; der
-  // Provider weiß was „leer befüllen" für ihn heißt (neuer Page-Slug etc.).
+  // "+" affordance on the node. Click navigates to createAction.screen or
+  // dispatches createAction.target; the provider knows what "create empty"
+  // means for it (new page slug, etc.).
   readonly createAction?: TreeAction;
   // Children kommen zur Laufzeit aus einem registrierten nav-provider
   // (lazy beim Ausklappen, SSE-live via treeEntities), keyed auf diese

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

package/src/tree-node.ts

@@ -32,9 +32,14 @@ export type TreeAction = {
   // i18n-Translation-Key oder roher String. Vom Renderer aufgelöst, Engine
   // behandelt opak (mirrors NavDefinition.label, WorkspaceDefinition.label).
   readonly label: string;
-  // Klick-Ziel der Action. Pflicht — Action ohne target ist semantisch
-  // sinnlos (Hover-Icon das nichts tut).
-  readonly target: TargetRef;
+  // Qualified screen name ("<feature>:screen:<id>") — renders as a route
+  // link. Exactly one of `screen`/`target` must be set; an action with
+  // neither is a Hover-Icon that does nothing, the boot validator rejects
+  // it.
+  readonly screen?: string;
+  // EditorPanel dispatch target — renders as a click-dispatch button.
+  // Exactly one of `screen`/`target` must be set.
+  readonly target?: TargetRef;
 };
 
 export type TreeNode = {
@@ -59,12 +64,12 @@ export type TreeNode = {
   // erst beim Ausklappen aufgerufen (lazy); die Function-Form erlaubt
   // SSE-gefütterte Live-Updates wenn neue Entity-Rows reinkommen.
   readonly children?: readonly TreeNode[] | TreeChildrenSubscribe;
-  // Provider-deklarierte „+ create"-Action für Knoten mit `state: "empty"`.
-  // Tree-Component zeigt automatisch ein „+"-Icon und dispatcht
-  // `createAction.target` bei Klick — Provider weiß was „leer befüllen"
-  // für ihn bedeutet (z.B. „neuer Page-Slug" vs „neue Entity-Row"),
-  // Convention könnte das nicht raten. Konsistent zu `state` (auch
-  // Provider-explizit). Siehe visual-tree.md V.1.1-Decision D3.
+  // Provider-declared "+ create" action for nodes with `state: "empty"`.
+  // The tree component automatically shows a "+" icon; click navigates to
+  // `createAction.screen` or dispatches `createAction.target` — the
+  // provider knows what "create empty" means for it (e.g. "new page slug"
+  // vs. "new entity row"), convention couldn't guess that. Consistent with
+  // `state` (also provider-explicit). See visual-tree.md V.1.1 Decision D3.
   readonly createAction?: TreeAction;
 };