@cosmicdrift/kumiko-renderer 0.186.3 → 0.188.0

package/src/components/render-field.tsx

@@ -1,5 +1,9 @@
 import type { EntityEditScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { EditFieldViewModel, FieldIssue } from "@cosmicdrift/kumiko-headless";
+import {
+  currencyDecimals,
+  type EditFieldViewModel,
+  type FieldIssue,
+} from "@cosmicdrift/kumiko-headless";
 import { type ReactNode, useCallback, useMemo, useState } from "react";
 import { useAppFeatures } from "../app/app-features-context";
 import { toKebab } from "../app/qn";
@@ -330,15 +334,15 @@ function renderInput({
         />
       );
     case "money": {
-      const moneyDef = field as unknown as { currency?: string; locale?: string };
+      const currency = field.currency ?? "EUR";
       return (
         <Input
           kind="money"
           {...common}
-          value={numberValue(field.value)}
-          onChange={(v) => onChange(v)}
-          {...(moneyDef.currency !== undefined && { currency: moneyDef.currency })}
-          locale={moneyDef.locale ?? appLocale}
+          value={moneyMinorValue(field.value, currency)}
+          onChange={(v) => onChange(moneyPayload(v, currency))}
+          currency={currency}
+          locale={appLocale}
         />
       );
     }
@@ -479,6 +483,32 @@ function numberValue(v: unknown): number | "" {
   return typeof v === "number" ? v : Number(v);
 }
 
+// Read/initial value → MoneyInput's minor-units contract. The server's
+// read shape is `{amount, currency, amountMinor}` in MAJOR units — deliberately
+// NOT reading `amountMinor` here: the server derives it via a flat
+// MINOR_UNIT_SCALE=100 (money.ts), which disagrees with currencyDecimals for
+// zero-decimal currencies like JPY, so it would double-scale JPY amounts.
+// Deriving from `amount * 10**currencyDecimals(currency)` keeps this the
+// exact inverse of moneyPayload below. A bare number is passed through
+// unchanged — legacy/malformed data, already in minor units.
+function moneyMinorValue(v: unknown, currency: string): number | "" {
+  if (v === undefined || v === null || v === "") return "";
+  if (typeof v === "number") return v;
+  if (typeof v === "object") {
+    const amount = (v as { amount?: unknown }).amount;
+    if (typeof amount === "number") return Math.round(amount * 10 ** currencyDecimals(currency));
+  }
+  return "";
+}
+
+// MoneyInput's minor-units onChange → the server payload shape
+// (`z.object({amount, currency})`, schema-builder.ts) — MAJOR units, no
+// `amountMinor` (the server derives that itself on write).
+function moneyPayload(minorUnits: number | undefined, currency: string): unknown {
+  if (minorUnits === undefined) return undefined;
+  return { amount: minorUnits / 10 ** currencyDecimals(currency), currency };
+}
+
 // locatedTimestamp-Feldwert: das Read-Wrapper liefert `{ at, tz, utc }`; leer
 // (noch nicht gesetzt) → "" als Empty-Sentinel, analog money/timestamp.
 function locatedValue(v: unknown): { at: string; tz: string; utc?: string } | "" {

package/src/context/draft-storage-context.tsx

@@ -0,0 +1,39 @@
+import { createContext, type ReactNode, useContext } from "react";
+
+// Client-side draftId storage for RenderEdit's create-mode draftKey (issue
+// #1913) — `${screen.id}:new:${draftId}` needs the same `draftId` across a
+// same-tab reload so the wizard resumes the right row instead of the leader
+// on the last-write-wins upsert. Contract only, platform-neutral — the
+// concrete impl (window.sessionStorage on web) is injected by the platform
+// package, same pattern as NavApi/window.history in app/nav.tsx. This
+// package touches no browser storage itself.
+export type DraftStorage = {
+  readonly getDraftId: (screenId: string) => string | null;
+  readonly setDraftId: (screenId: string, draftId: string) => void;
+  readonly clearDraftId: (screenId: string) => void;
+};
+
+// No-op default: without a mounted provider (unwired platform, or a test
+// that doesn't care about drafts) same-tab reload just loses draftId
+// persistence — RenderEdit falls back to its `form-draft:query:list`
+// resume path, the same one a cleared sessionStorage takes on the web.
+const noopDraftStorage: DraftStorage = {
+  getDraftId: () => null,
+  setDraftId: () => {},
+  clearDraftId: () => {},
+};
+
+const DraftStorageContext = createContext<DraftStorage>(noopDraftStorage);
+
+export type DraftStorageProviderProps = {
+  readonly value: DraftStorage;
+  readonly children: ReactNode;
+};
+
+export function DraftStorageProvider({ value, children }: DraftStorageProviderProps): ReactNode {
+  return <DraftStorageContext value={value}>{children}</DraftStorageContext>;
+}
+
+export function useDraftStorage(): DraftStorage {
+  return useContext(DraftStorageContext);
+}

package/src/i18n-defaults.ts

@@ -22,6 +22,12 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "kumiko.actions.edit": "Bearbeiten",
     "kumiko.actions.copyLink": "Link kopieren",
     "kumiko.actions.copyLinkCopied": "Kopiert!",
+    "kumiko.actions.next": "Weiter",
+    "kumiko.actions.back": "Zurück",
+    "kumiko.actions.finish": "Abschließen",
+
+    // Wizard step chrome (RenderEdit layout.mode="wizard").
+    "kumiko.wizard.step": "Schritt {current} von {total}",
 
     // Version — Update-Awareness-Banner (UpdateChecker).
     "kumiko.version.update-available": "Eine neue Version ist verfügbar.",
@@ -31,6 +37,9 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
 
     // Field — aria-Labels der Date/Timestamp-Primitives.
     "kumiko.field.open-calendar": "Kalender öffnen",
+    "kumiko.field.dateField.placeholderYear": "J",
+    "kumiko.field.dateField.placeholderMonth": "M",
+    "kumiko.field.dateField.placeholderDay": "T",
     "kumiko.field.time": "Uhrzeit",
     "kumiko.field.timezone": "Zeitzone",
     "kumiko.field.locatedTzHint": "Zeit lokal am angegebenen Ort",
@@ -127,6 +136,8 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "kumiko.form.error.version-conflict":
       "Datensatz wurde zwischenzeitlich geändert. Lade neu und versuche es erneut.",
     "kumiko.form.extension.save-failed": "Ein Zusatzfeld konnte nicht gespeichert werden.",
+    "kumiko.form.draft.resume-multiple":
+      "Mehrere offene Entwürfe für dieses Formular gefunden. Welchen möchtest du fortsetzen?",
 
     // Validation — Default-Reason-Codes aus dem Framework. App-Code
     // kann eigene Codes via Validation-Hooks reinwerfen; die hier sind
@@ -189,12 +200,20 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "kumiko.actions.edit": "Edit",
     "kumiko.actions.copyLink": "Copy link",
     "kumiko.actions.copyLinkCopied": "Copied!",
+    "kumiko.actions.next": "Next",
+    "kumiko.actions.back": "Back",
+    "kumiko.actions.finish": "Finish",
+
+    "kumiko.wizard.step": "Step {current} of {total}",
 
     "kumiko.version.update-available": "A new version is available.",
 
     "kumiko.toast.learn-more": "Learn more",
 
     "kumiko.field.open-calendar": "Open calendar",
+    "kumiko.field.dateField.placeholderYear": "Y",
+    "kumiko.field.dateField.placeholderMonth": "M",
+    "kumiko.field.dateField.placeholderDay": "D",
     "kumiko.field.time": "Time",
     "kumiko.field.timezone": "Time zone",
     "kumiko.field.locatedTzHint": "Time local to the given location",
@@ -277,6 +296,8 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "kumiko.form.error.version-conflict":
       "Record was modified in the meantime. Reload and try again.",
     "kumiko.form.extension.save-failed": "A custom field could not be saved.",
+    "kumiko.form.draft.resume-multiple":
+      "Found multiple open drafts for this form. Which one do you want to resume?",
 
     "kumiko.validation.required": "Required.",
     "kumiko.validation.invalid": "Invalid value.",

package/src/index.ts

@@ -69,7 +69,11 @@ export { lastSegment } from "./app/qn";
 export type { VariableChipsProps } from "./app/variable-chips";
 export { VariableChips } from "./app/variable-chips";
 export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error";
-export type { RenderEditProps } from "./components/render-edit";
+export type {
+  RenderEditChangeState,
+  RenderEditControls,
+  RenderEditProps,
+} from "./components/render-edit";
 export { RenderEdit } from "./components/render-edit";
 export type { RenderFieldProps } from "./components/render-field";
 export { RenderField } from "./components/render-field";
@@ -82,6 +86,8 @@ export {
   useDispatcherStatus,
   useOptionalDispatcher,
 } from "./context/dispatcher-context";
+export type { DraftStorage, DraftStorageProviderProps } from "./context/draft-storage-context";
+export { DraftStorageProvider, useDraftStorage } from "./context/draft-storage-context";
 export type { UserRolesProviderProps } from "./context/user-roles-context";
 export { UserRolesProvider, useUserRoles } from "./context/user-roles-context";
 export { formatWhen } from "./format-when";
@@ -169,6 +175,7 @@ export type {
   ModalProps,
   PrimitivesProviderProps,
   PrimitivesRegistry,
+  ProgressProps,
   RuntimeRenderer,
   SectionProps,
   TextProps,

package/src/primitives.tsx

@@ -548,6 +548,18 @@ export type DataTableProps = {
    *  "Ende der Liste"-Hinweis statt des Sentinels. Default true. */
   readonly hasMore?: boolean;
   readonly testId?: string;
+  /** Wires an edit path into a component column-renderer: `DataTableCell`
+   *  passes this down as `ColumnRendererProps.onChange` for that cell,
+   *  bound to `(rowId, column.field)`. Renderers without a component
+   *  renderer (format-spec, type-default) ignore it — read-only stays
+   *  read-only unless the column has a custom renderer that reads
+   *  `onChange`. */
+  readonly onCellChange?: (rowId: string, field: string, value: unknown) => void;
+  /** Overrides the row `data-testid` (default `row-${row.id}`) — for a
+   *  screen that already has its own DOM-test/e2e naming scheme. */
+  readonly getRowTestId?: (row: ListRowViewModel) => string;
+  /** Overrides the cell `data-testid` (default `cell-${row.id}-${field}`). */
+  readonly getCellTestId?: (row: ListRowViewModel, field: string) => string;
 };
 
 // ---- EmbeddedListInput (createEmbeddedListField widget) ----
@@ -851,6 +863,13 @@ export type CardProps = {
   readonly testId?: string;
 };
 
+/** Determinate progress bar (e.g. wizard step progress). `value` is a
+ *  0..1 fraction, not a percentage — implementations scale for display. */
+export type ProgressProps = {
+  readonly value: number;
+  readonly testId?: string;
+};
+
 // ---- Core-Registry (Kumiko-eigene Primitives) ----
 
 export type CorePrimitives = {
@@ -876,6 +895,10 @@ export type CorePrimitives = {
   readonly ConfigSourceBadge: ComponentType<ConfigSourceBadgeProps>;
   readonly ConfigCascadeView: ComponentType<ConfigCascadeViewProps>;
   readonly Link: ComponentType<LinkProps>;
+  /** Optional (unlike the other Core-Primitives) so existing partial
+   *  CorePrimitives mocks in tests keep compiling — additive rollout of
+   *  a new primitive shouldn't force every test double to grow a stub. */
+  readonly Progress?: ComponentType<ProgressProps>;
 };
 
 /** Offene Extension-Zone für App-eigene Primitives. Devs erweitern