@cosmicdrift/kumiko-headless 0.186.2 → 0.187.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.186.2",
+  "version": "0.187.0",
   "description": "Headless UI logic for Kumiko — Dispatcher contract, Form-Controller, View-Model, Nav-Resolver. Plattform- und React-frei; jeder Renderer (renderer, renderer-web, renderer-native, …) komponiert darauf.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -36,7 +36,7 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.186.2",
+    "@cosmicdrift/kumiko-framework": "0.187.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },

package/src/index.ts

@@ -79,6 +79,7 @@ export { createStore, shallowEqual } from "./store";
 export type {
   ComputeEditViewModelInput,
   ComputeListViewModelInput,
+  DerivedCellRoundingTarget,
   EditExtensionSectionViewModel,
   EditFieldSpec,
   EditFieldsSectionViewModel,
@@ -107,5 +108,6 @@ export {
   embeddedCellOptionLabelKey,
   fieldLabelKey,
   groupEmbeddedListIssues,
+  roundDerivedCellValue,
   sumEmbeddedListColumn,
 } from "./view-model";

package/src/view-model/__tests__/embedded-list.test.ts

@@ -3,6 +3,7 @@ import type { FieldIssue } from "../../dispatcher";
 import {
   computeDerivedCellValue,
   groupEmbeddedListIssues,
+  roundDerivedCellValue,
   sumEmbeddedListColumn,
 } from "../embedded-list";
 
@@ -40,6 +41,17 @@ describe("computeDerivedCellValue", () => {
   });
 });
 
+describe("roundDerivedCellValue", () => {
+  test("rounds a money target to whole minor units, kaufmännisch", () => {
+    expect(roundDerivedCellValue(2307.58, { type: "money" })).toBe(2308);
+    expect(roundDerivedCellValue(-2307.5, { type: "money" })).toBe(-2308);
+  });
+
+  test("leaves a number target unrounded", () => {
+    expect(roundDerivedCellValue(1.5, { type: "number" })).toBe(1.5);
+  });
+});
+
 describe("sumEmbeddedListColumn", () => {
   test("sums a numeric column across rows", () => {
     const rows = [{ amount: 100 }, { amount: 250 }, { amount: 50 }];

package/src/view-model/edit.ts

@@ -44,6 +44,7 @@ type EmbeddedSubFieldShape = {
   readonly options?: readonly string[];
   readonly entity?: string;
   readonly labelField?: string;
+  readonly scale?: number;
 };
 
 export type ComputeEditViewModelInput<
@@ -224,6 +225,8 @@ export function computeEditViewModel<
                 ...(cellRefTarget !== undefined && { refFeature: cellRefTarget.featureName }),
                 ...(subField.type === "reference" &&
                   subField.labelField !== undefined && { refLabelField: subField.labelField }),
+                ...(subField.type === "decimal" &&
+                  subField.scale !== undefined && { scale: subField.scale }),
               };
               return cell;
             })

package/src/view-model/embedded-list.ts

@@ -2,9 +2,13 @@ import type { FieldIssue } from "../dispatcher";
 
 export type EmbeddedDerivedOp = "multiply" | "sum" | "subtract";
 
+export type { DerivedCellRoundingTarget } from "@cosmicdrift/kumiko-framework/ui-types";
 // Canonical implementation moved to packages/framework/src/engine/embedded-derived.ts
 // (the write-schema preprocess needs it server-side too).
-export { computeDerivedCellValue } from "@cosmicdrift/kumiko-framework/ui-types";
+export {
+  computeDerivedCellValue,
+  roundDerivedCellValue,
+} from "@cosmicdrift/kumiko-framework/ui-types";
 
 /** Sums a numeric/money/decimal column across all rows. Non-numeric or
  *  missing values count as 0. Money columns are minor-unit integers —

package/src/view-model/index.ts

@@ -1,9 +1,14 @@
 export type { ComputeEditViewModelInput } from "./edit";
 export { computeEditViewModel } from "./edit";
-export type { EmbeddedDerivedOp, EmbeddedListIssueGroups } from "./embedded-list";
+export type {
+  DerivedCellRoundingTarget,
+  EmbeddedDerivedOp,
+  EmbeddedListIssueGroups,
+} from "./embedded-list";
 export {
   computeDerivedCellValue,
   groupEmbeddedListIssues,
+  roundDerivedCellValue,
   sumEmbeddedListColumn,
 } from "./embedded-list";
 export type { ComputeListViewModelInput } from "./list";

package/src/view-model/types.ts

@@ -56,6 +56,11 @@ export type ListColumnViewModel = {
   /** Nur bei `type: "reference"` — Welches Feld der referenced Entity
    *  als Display-Wert in der Cell erscheint (Default "id"). */
   readonly refLabelField?: string;
+  /** Set by the caller at runtime (not schema-derived) to emphasize one
+   *  column — e.g. the currently selected base-year column in a
+   *  multi-year statement grid. DataTable renders it with a distinct
+   *  header/cell background. */
+  readonly highlighted?: boolean;
 };
 
 export type ListRowViewModel = {
@@ -100,6 +105,8 @@ export type EmbeddedListCellViewModel = {
   readonly refEntity?: string;
   readonly refFeature?: string;
   readonly refLabelField?: string;
+  /** Only for `type: "decimal"`. */
+  readonly scale?: number;
 };
 
 // Resolved field — all predicates evaluated, labels translated. The