@cosmicdrift/kumiko-types 0.231.0 → 0.233.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.231.0",
+  "version": "0.233.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,10 @@ export type NavIconKey =
   | "upload"
   | "rocket"
   | "plus"
-  | "languages";
+  | "languages"
+  | "trash"
+  | "x"
+  | "check"
+  | "arrow-left"
+  | "arrow-right"
+  | "copy";

package/src/screen.ts

@@ -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" {

package/src/step.ts

@@ -76,6 +76,15 @@ export type PipelineCtx<
  */
 export type StepResolver<T, TPayload = unknown> = T | ((ctx: PipelineCtx<TPayload>) => T);
 
+// Branded event-type string — the only route r.step.waitForEvent's `event`
+// can reach a value. A workflow's `awaits` declaration (D4,
+// workflow-resume-loop.md) is the only source of these; buildPipelineSteps
+// mints them from that declaration's raw strings when it builds the
+// closure's `awaits` binding. A raw string literal at waitForEvent.event is
+// a compile error, so a typo in the awaited key surfaces at build time
+// instead of a run that waits forever.
+export type AwaitedEventType = string & { readonly __awaitedEvent: unique symbol };
+
 // Serializable AST for r.step.waitForEvent's `match` argument. Persisted
 // verbatim into the waiting-for-event suspension payload (jsonb), so it
 // must survive a JSON round-trip — a closure cannot.
@@ -164,9 +173,23 @@ export type StepInstance = {
  *   `stepsPipeline<{ greeting: string }, { echoed: string }>(...)`
  * Better DX is a known follow-up — see step-vocabulary.md M.1-Followups.
  */
-export type PipelineDef<TPayload = unknown, _TData = unknown> = {
+export type PipelineDef<
+  TPayload = unknown,
+  _TData = unknown,
+  TAwaits extends Record<string, AwaitedEventType> = Record<string, AwaitedEventType>,
+> = {
   readonly __kind: "pipeline";
-  readonly build: (ctx: PipelineBuildCtx<TPayload>) => readonly StepInstance[];
+  // Raw (unbranded) awaits map, set by defineWorkflow — absent for
+  // non-workflow pipelines (plain defineWriteHandler perform).
+  // buildPipelineSteps reads it and brands it into the closure's `awaits`
+  // binding, so every existing buildPipelineSteps caller keeps working
+  // unchanged. Deliberately typed as plain strings, NOT `TAwaits` — an
+  // extra covariant occurrence of TAwaits here (alongside its contravariant
+  // occurrence in `build`'s parameter) breaks TypeScript's contextual
+  // inference for a `stepsPipeline(...)` passed inline as `steps` (verified
+  // empirically; see fw#2513 Phase 3a).
+  readonly awaits?: Readonly<Record<string, string>>;
+  readonly build: (ctx: PipelineBuildCtx<TPayload, TAwaits>) => readonly StepInstance[];
 };
 
 /**
@@ -188,9 +211,16 @@ export type PipelineDef<TPayload = unknown, _TData = unknown> = {
  * skip validation. See validate-projection-allowlist.ts for the
  * boot-side mechanics.
  */
-export type PipelineBuildCtx<TPayload = unknown> = {
+export type PipelineBuildCtx<
+  TPayload = unknown,
+  TAwaits extends Record<string, AwaitedEventType> = Record<string, AwaitedEventType>,
+> = {
   readonly event: WriteEvent<TPayload>;
   readonly r: StepBuilder;
+  // Declared awaited events (D4, workflow-resume-loop.md) — the only way
+  // r.step.waitForEvent's `event` arg can reference an event type. `{}` for
+  // non-workflow pipelines and workflows without an `awaits` declaration.
+  readonly awaits: TAwaits;
 };
 
 /**
@@ -339,7 +369,7 @@ export type StepNamespace = {
   // Runtime guard: throws when used inside sync defineWriteHandler.
   readonly wait: (args: { readonly for: StepResolver<string> }) => StepInstance;
   readonly waitForEvent: (args: {
-    readonly event: string;
+    readonly event: AwaitedEventType;
     readonly match?: StepResolver<EventMatch>;
     readonly timeout: StepResolver<string>;
   }) => StepInstance;