@cosmicdrift/kumiko-types 0.186.2 → 0.187.0

package/package.json

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

@@ -417,9 +417,10 @@ export type EmbeddedSubFieldDef =
     });
 
 /** A cell computed from other cells of the same row. `from` names the
- *  sub-fields the operation reads (order matters for `subtract`). Purely
- *  renderer metadata — the derived value is still validated like any other
- *  value of its declared sub-field type in `schema`. */
+ *  sub-fields the operation reads (order matters for `subtract`). Renderer
+ *  metadata — the derived value is rounded server- and client-side to the
+ *  precision its target sub-field in `schema` declares (money → integer,
+ *  decimal → `scale`) before it's validated. */
 export type EmbeddedDerivedCellDef = {
   readonly op: "multiply" | "sum" | "subtract";
   readonly from: readonly string[];
@@ -447,7 +448,8 @@ export type EmbeddedFieldDef = {
   /** Maximum row count for an embedded list. Only valid with `multiple: true`. */
   readonly maxItems?: number;
   /** Renderer metadata: sub-field name → how to compute its cell from other
-   *  sub-fields of the same row. Only valid with `multiple: true`. */
+   *  sub-fields of the same row, rounded to that sub-field's declared
+   *  precision. Only valid with `multiple: true`. */
   readonly derived?: Readonly<Record<string, EmbeddedDerivedCellDef>>;
   /** Renderer metadata: numeric sub-field names to sum in a totals row. Only
    *  valid with `multiple: true`. */
@@ -455,7 +457,9 @@ export type EmbeddedFieldDef = {
   /** Maps an embedded-list subfield name to a sibling top-level money field
    *  name — the sum of that subfield across all rows must equal the sibling
    *  field's amount. Validated both client- and server-side (schema-builder
-   *  superRefine). Only meaningful with `multiple: true`. */
+   *  superRefine). Only meaningful with `multiple: true`. Compares against
+   *  rounded `derived` cells, i.e. "sum-of-rounded" not "round-of-sum" —
+   *  see kumiko-framework#1866. */
   readonly totalsMatch?: Readonly<Record<string, string>>;
 } & PiiAnnotations;