@cosmicdrift/kumiko-types 0.232.0 → 0.234.0

package/package.json

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

@@ -371,6 +371,9 @@ export type NumberFieldDef = {
   /** `true` → `integer` column + `.int()` Zod validation. Omitted/`false` →
    *  `double precision` column, fractional values allowed. */
   readonly integer?: boolean;
+  /** Display-only suffix: a static string, or a sibling field name whose
+   *  value supplies it. Never converts the stored number. */
+  readonly unit?: string | { readonly field: string };
 } & ResolvedPiiFlags;
 
 /**

package/src/nav-icon.ts

@@ -1,12 +1,13 @@
-// Closed vocabulary of nav icon keys. NavDefinition.icon, ScreenNavSugar.icon
-// and ConfigMask.icon are all typed against this union, so an unregistered
-// key is a compile error at the r.nav()/r.screen()/config-mask call site
-// instead of a silent missing-icon at runtime.
+// Closed vocabulary of nav and button icon keys. NavDefinition.icon,
+// ScreenNavSugar.icon, ConfigMask.icon and ButtonProps.icon/iconEnd are all
+// typed against this union, so an unregistered key is a compile error at the
+// r.nav()/r.screen()/config-mask/button call site instead of a silent
+// missing-icon at runtime.
 //
-// The renderer-web NAV_ICONS map (packages/renderer-web/src/layout/
-// nav-tree.tsx) is checked against this same union via `satisfies`, so the
-// two can't drift — add a key here only together with its lucide-react entry
-// there, and vice versa.
+// The renderer-web NAV_ICONS map (packages/renderer-web/src/icons.tsx) is
+// checked against this same union via `satisfies`, so the two can't drift —
+// add a key here only together with its lucide-react entry there, and vice
+// versa.
 export type NavIconKey =
   | "dashboard"
   | "layout-grid"
@@ -55,4 +56,38 @@ export type NavIconKey =
   | "upload"
   | "rocket"
   | "plus"
-  | "languages";
+  | "languages"
+  | "trash"
+  | "x"
+  | "check"
+  | "arrow-left"
+  | "arrow-right"
+  | "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";
 
@@ -34,7 +34,7 @@ export type PlatformComponent = {
 // formats it as a locale-formatted number with a literal "m²" suffix. The
 // rest map to a CLDR-sanctioned Intl.NumberFormat unit id and get
 // locale-correct pluralization/spacing straight from Intl.
-export type UnitKey = "m2" | "km" | "m" | "kg" | "percent";
+export type UnitKey = "m2" | "km" | "m" | "kg" | "percent" | "mi";
 
 // Built-in value formatters. Apps extend via module augmentation:
 //   declare module "@cosmicdrift/kumiko-framework/engine/types" {
@@ -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;
 };