@cosmicdrift/kumiko-renderer 0.333.0 → 0.335.0

package/dist/app/config-edit-shim.d.ts

@@ -1,4 +1,5 @@
 import type { ConfigEditScreenDefinition, EntityDefinition, EntityEditScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
+import * as z from "zod";
 /** Baut eine minimale EntityDefinition aus den Inline-Fields des
  *  ConfigEdit-Screens. RenderEdit + computeEditViewModel iterieren
  *  über entity.fields zur Render-Zeit; alle weiteren EntityDefinition-
@@ -9,3 +10,9 @@ export declare function synthesizeConfigEditEntity(fields: ConfigEditScreenDefin
  *  damit der Type-Constraint hält; entity wird auf den Pseudo-Namen
  *  gepinnt — RenderEdit liest das Feld nicht. */
 export declare function synthesizeConfigEditScreen(screen: ConfigEditScreenDefinition): EntityEditScreenDefinition;
+/** Client-side range check for number keys with declared bounds, so an
+ *  out-of-range value surfaces on its field instead of as the server's
+ *  form-level "Validation failed." banner. Only bounds: required/format stay
+ *  server-authoritative like in buildFormSchema. `.passthrough()` keeps every
+ *  form key visible to the superRefine. */
+export declare function buildConfigEditSchema(fields: ConfigEditScreenDefinition["fields"]): z.ZodType;

package/dist/app/config-edit-shim.js

@@ -12,6 +12,8 @@
 // zukünftiger Boot-Validator die schema.entities-Map cross-referenziert,
 // brechen die Type-Lies hier silent. Dann ist Zeit für eine echte
 // RenderConfigEdit-Komponente die direkt fields nimmt.
+import { I18N_KEY_PARAM } from "@cosmicdrift/kumiko-headless";
+import * as z from "zod";
 const CONFIG_EDIT_PSEUDO_ENTITY = "__config-edit__";
 /** Baut eine minimale EntityDefinition aus den Inline-Fields des
  *  ConfigEdit-Screens. RenderEdit + computeEditViewModel iterieren
@@ -35,3 +37,40 @@ export function synthesizeConfigEditScreen(screen) {
         ...(screen.access !== undefined && { access: screen.access }),
     };
 }
+/** Client-side range check for number keys with declared bounds, so an
+ *  out-of-range value surfaces on its field instead of as the server's
+ *  form-level "Validation failed." banner. Only bounds: required/format stay
+ *  server-authoritative like in buildFormSchema. `.passthrough()` keeps every
+ *  form key visible to the superRefine. */
+export function buildConfigEditSchema(fields) {
+    return z
+        .object({})
+        .passthrough()
+        .superRefine((values, ctx) => {
+        // @cast-boundary form-values
+        const record = values;
+        for (const [name, field] of Object.entries(fields)) {
+            if (field.type !== "number")
+                continue;
+            const value = record[name];
+            if (typeof value !== "number" || !Number.isFinite(value))
+                continue;
+            if (field.min !== undefined && value < field.min) {
+                ctx.addIssue({
+                    code: "custom",
+                    minimum: field.min,
+                    params: { [I18N_KEY_PARAM]: "kumiko.validation.number.min" },
+                    path: [name],
+                });
+            }
+            if (field.max !== undefined && value > field.max) {
+                ctx.addIssue({
+                    code: "custom",
+                    maximum: field.max,
+                    params: { [I18N_KEY_PARAM]: "kumiko.validation.number.max" },
+                    path: [name],
+                });
+            }
+        }
+    });
+}

package/dist/app/content-preview.js

@@ -1,4 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+// Read-only render of a content editor's format with the collection's
+// example variableSchema values substituted in for `{{name}}` — reuses the
+// same registered editor the collection edits with (readOnly), so "rich"
+// renders formatted HTML and "plain"/"markdown" render as text through the
+// exact same component, no separate render path per format.
+import { escapeHtmlAttr } from "@cosmicdrift/kumiko-headless";
 import { useId } from "react";
 import { useContentEditor } from "./content-editors.js";
 const VARIABLE_PATTERN = /\{\{\s*(\w+)\s*\}\}/g;
@@ -8,14 +14,6 @@ const noop = () => { };
 export function substituteVariables(content, variables) {
     return content.replace(VARIABLE_PATTERN, (match, name) => Object.hasOwn(variables, name) ? (variables[name] ?? match) : match);
 }
-function escapeHtml(value) {
-    return value
-        .replace(/&/g, "&")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;")
-        .replace(/"/g, "&quot;")
-        .replace(/'/g, "&#39;");
-}
 export function ContentPreview({ content, variables, contentFormat, }) {
     const Editor = useContentEditor(contentFormat);
     const id = useId();
@@ -24,7 +22,7 @@ export function ContentPreview({ content, variables, contentFormat, }) {
     // render as an unescaped entity (`&`). "plain"/"markdown" content is text,
     // no escaping wanted there.
     const safeVariables = contentFormat === "rich"
-        ? Object.fromEntries(Object.entries(variables).map(([name, value]) => [name, escapeHtml(value)]))
+        ? Object.fromEntries(Object.entries(variables).map(([name, value]) => [name, escapeHtmlAttr(value)]))
         : variables;
     return (_jsx(Editor, { id: id, value: substituteVariables(content, safeVariables), onChange: noop, variables: [], readOnly: true }));
 }

package/dist/app/extension-sections.d.ts

@@ -55,6 +55,12 @@ export type ExtensionSectionProps = {
         readonly index: number;
         readonly isLast: boolean;
     };
+    /** Only set for extension steps of a `layout.mode: "wizard"` entityEdit
+     *  editing an existing record (update mode); undefined everywhere else.
+     *  Call it (typically from an effect) with whether the step already holds
+     *  its data, so the step bar shows the step as done. Repeated calls with
+     *  the same value are cheap. */
+    readonly reportStepComplete?: (complete: boolean) => void;
 };
 export type ExtensionSectionComponent = ComponentType<ExtensionSectionProps>;
 export type ExtensionSectionsMap = Readonly<Record<string, ExtensionSectionComponent>>;

package/dist/app/form-schema.d.ts

@@ -1,4 +1,5 @@
 import type { EntityDefinition, EntityEditScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
 import * as z from "zod";
+export declare function isPresent(value: unknown): boolean;
 export declare const REQUIRED_FIELD_I18N_KEY = "kumiko.validation.required";
-export declare function buildFormSchema(entity: EntityDefinition, screen: EntityEditScreenDefinition): z.ZodType;
+export declare function buildFormSchema(entity: EntityDefinition, screen: EntityEditScreenDefinition, unchangedFrom?: Readonly<Record<string, unknown>>): z.ZodType;

package/dist/app/form-schema.js

@@ -4,7 +4,7 @@ import * as z from "zod";
 import { layoutEditFields } from "./layout-fields.js";
 // `required` means "has a value", not "is truthy" — `false` and `0` count
 // as present, only the actually-empty representations don't.
-function isPresent(value) {
+export function isPresent(value) {
     if (value === undefined || value === null || value === "")
         return false;
     if (Array.isArray(value) && value.length === 0)
@@ -39,7 +39,12 @@ export const REQUIRED_FIELD_I18N_KEY = "kumiko.validation.required";
 // checked here: `visible`. `runValidate` already filters issues on hidden
 // fields via `computeFieldStates(options.fields, …)` (form-controller.ts:163,181),
 // fed by `deriveFormFields(screen)` in render-edit.tsx.
-export function buildFormSchema(entity, screen) {
+//
+// `unchangedFrom` is for payloadMode "changes" (update): a field still equal to
+// its loaded value never reaches the payload, so the server never presence-
+// checks it — a legacy row with a now-required empty field must stay saveable
+// when the user edits something else.
+export function buildFormSchema(entity, screen, unchangedFrom) {
     const fields = layoutEditFields(screen);
     return z
         .object({})
@@ -73,6 +78,10 @@ export function buildFormSchema(entity, screen) {
                 continue;
             if (isPresent(record[spec.field]))
                 continue;
+            if (unchangedFrom !== undefined &&
+                JSON.stringify(record[spec.field]) === JSON.stringify(unchangedFrom[spec.field])) {
+                continue;
+            }
             ctx.addIssue({
                 code: "custom",
                 path: [spec.field],

package/dist/app/kumiko-screen.d.ts

@@ -20,7 +20,12 @@ export declare function qualifyNavId(featureName: string, navId: string): string
 export { screenAccessAllows };
 export declare function KumikoScreen({ schema, qn, translate, entityId, onRowClick, onCopyLink, }: KumikoScreenProps): ReactNode;
 export declare function buildInitialValues(fields: Readonly<Record<string, unknown>>, defaultCurrency?: string, moneyCurrencyOverrides?: Readonly<Record<string, string>>): Readonly<Record<string, unknown>>;
+export declare function tenantCurrencyMoneyFieldNames(fields: Readonly<Record<string, unknown>>): readonly string[];
 export declare function literalCurrencyOverrides(fields: Readonly<Record<string, unknown>>): Readonly<Record<string, string>>;
+export declare function useMoneyCurrencyOverrides(fields: Readonly<Record<string, unknown>>, tenantFieldNames: readonly string[], fallback: string): {
+    readonly overrides: Readonly<Record<string, string>> | undefined;
+    readonly loading: boolean;
+};
 export type InitialValueSources = {
     readonly searchParams: Readonly<Record<string, string>>;
     readonly urlPrefillFields: readonly string[] | undefined;