@cosmicdrift/kumiko-types 0.233.0 → 0.234.0

package/package.json

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

@@ -62,4 +62,32 @@ export type NavIconKey =
   | "check"
   | "arrow-left"
   | "arrow-right"
-  | "copy";
+  | "copy"
+  | "pencil"
+  | "eye"
+  | "eye-off"
+  | "filter"
+  | "refresh"
+  | "more-horizontal"
+  | "more-vertical"
+  | "external-link"
+  | "chevron-down"
+  | "chevron-right"
+  | "save"
+  | "undo"
+  | "archive"
+  | "star"
+  | "flag"
+  | "clock"
+  | "map-pin"
+  | "phone"
+  | "printer"
+  | "alert-triangle"
+  | "info"
+  | "check-circle"
+  | "x-circle"
+  | "loader";
+
+// Alias kept because the union stopped being nav-only — actions and fields
+// (added on this branch) also key their icons against it.
+export type IconKey = NavIconKey;

package/src/nav.ts

@@ -3,7 +3,7 @@ import type { NavIconKey } from "./nav-icon";
 import type { TargetRef } from "./target-ref";
 import type { TreeAction } from "./tree-node";
 
-export type { NavIconKey } from "./nav-icon";
+export type { IconKey, NavIconKey } from "./nav-icon";
 
 // Nav entry declaration. Every feature that wants to appear in the app's
 // navigation tree registers one or more entries via r.nav(). The engine

package/src/screen.ts

@@ -1,7 +1,7 @@
 import type { FieldIconKey } from "./field-icon";
 import type { FieldDefinition } from "./fields";
 import type { AccessRule } from "./handlers";
-import type { NavIconKey } from "./nav-icon";
+import type { IconKey, NavIconKey } from "./nav-icon";
 
 export type { FieldIconKey } from "./field-icon";
 
@@ -227,6 +227,10 @@ export type RowActionWriteHandler = {
   /** Visual-Style. "danger" rendert rot + erzwingt einen Confirm-
    *  Dialog (auch ohne expliziten `confirm`-Key). */
   readonly style?: "primary" | "secondary" | "danger";
+  /** Overrides the id-based default icon (see ACTION_ICON_BY_ID in
+   *  kumiko-renderer) — closed IconKey vocabulary into the ICONS registry
+   *  (renderer-web), analogous to EditFieldSpec.icon. */
+  readonly icon?: IconKey;
 };
 
 export type RowActionNavigateBase = {
@@ -252,6 +256,10 @@ export type RowActionNavigateBase = {
    *  auf navigate — ein Row-Klick darf keinen (evtl. destruktiven, unbestätigten)
    *  Write auslösen, daher nicht auf writeHandler-Actions. */
   readonly rowClick?: boolean;
+  /** Overrides the id-based default icon (see ACTION_ICON_BY_ID in
+   *  kumiko-renderer) — closed IconKey vocabulary into the ICONS registry
+   *  (renderer-web), analogous to EditFieldSpec.icon. */
+  readonly icon?: IconKey;
 };
 
 /** Exactly one of `screen` / `entity` — mutual exclusivity is type-enforced
@@ -682,6 +690,11 @@ export type EditFieldsSection = {
   readonly description?: string;
   readonly columns?: number;
   readonly fields: readonly EditFieldSpec[];
+  /** Rendered left of the section title, `text-muted-foreground` — closed
+   *  IconKey vocabulary into the ICONS registry (renderer-web), analogous
+   *  to EditFieldSpec.icon. No title → no icon, and no heuristic derives
+   *  one from the title (titles are free i18n strings). */
+  readonly icon?: IconKey;
 };
 
 export type EditExtensionSection = {
@@ -798,6 +811,13 @@ export type EntityEditScreenDefinition = {
    *  das `mask.title`-Label des Config-Keys. Fehlt ein Eintrag, gilt die
    *  Konvention. */
   readonly fieldLabels?: Readonly<Record<string, string>>;
+  /** Header action buttons. Reuses `RowAction` — analogous to
+   *  `ProjectionDetailScreenDefinition.actions` (the loaded record stands
+   *  in for the "row"). `rowClick` has no target here and is rejected by
+   *  the boot-validator, same as on projectionDetail. Not rendered in
+   *  create mode — every action targets an existing record, which the
+   *  create branch doesn't have yet. */
+  readonly actions?: readonly RowAction[];
   readonly slots?: ScreenSlots;
   readonly access?: AccessRule;
 };