@cosmicdrift/kumiko-types 0.180.0 → 0.181.0

package/package.json

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

@@ -383,19 +383,47 @@ export type DefaultCurrency =
 
 // --- Embedded Object ---
 
-export type EmbeddedSubFieldDef = {
-  readonly type: "text" | "number" | "boolean" | "date";
+type EmbeddedSubFieldBase = {
   readonly required?: boolean;
   readonly searchable?: boolean;
   readonly access?: FieldAccess;
 };
 
+/** `money` is a signed integer amount in minor units (cents); which currency
+ *  it means is defined by the owning aggregate (a head-level field or tenant
+ *  config), not per row. Unlike the top-level `money` field (BIGINT + currency
+ *  column) the value lives in jsonb, so it must stay within ±(2^53 − 1).
+ *
+ *  `decimal` bounds a JSON number to `scale` fractional digits (0–15). `scale`
+ *  is required — no silent default that could truncate — and there is no
+ *  `precision`: jsonb has no numeric column behind it whose width `precision`
+ *  could describe. */
+export type EmbeddedSubFieldDef =
+  | (EmbeddedSubFieldBase & {
+      readonly type: "text" | "number" | "boolean" | "date" | "money";
+    })
+  | (EmbeddedSubFieldBase & {
+      readonly type: "decimal";
+      readonly scale: number;
+    });
+
 export type EmbeddedFieldDef = {
   readonly type: "embedded";
   readonly required?: boolean;
   readonly sensitive?: boolean;
   readonly schema: Readonly<Record<string, EmbeddedSubFieldDef>>;
   readonly access?: FieldAccess;
+  /** A list of like-shaped objects instead of exactly one: the value is an
+   *  array and every element is validated against `schema`. Storage stays
+   *  jsonb, the column default becomes `[]` instead of `{}`. Built via
+   *  `createEmbeddedListField()`.
+   *
+   *  Only for rows that come into being with their head and stay immutable
+   *  with it (posting lines, invoice positions). A row with its own lifetime
+   *  (own from/to dates, own history) belongs in its own entity referencing
+   *  the head — an embedded array is rewritten whole on every change and has
+   *  no per-row history. */
+  readonly multiple?: boolean;
 } & PiiAnnotations;
 
 // Free-form jsonb — keys/shape NOT validated at write-time. Use for: