@cosmicdrift/kumiko-renderer 0.327.0 → 0.328.1

package/src/components/__tests__/render-field-app-locale.test.tsx

@@ -1,142 +0,0 @@
-// Regression: RenderField muss das App-Locale (useLocale) an money-/date-
-// Inputs durchreichen — auch ohne explizites field.locale. Vorher fielen
-// die Inputs auf navigator.language (Browser-Sprache) statt der per
-// LocaleProvider gewählten App-Sprache zurück → Separator-Mismatch.
-//
-// Capture-Input statt echter Primitive: hält den Test renderer-intern
-// (relativer Import von RenderField → diese Source), unabhängig davon
-// wie @cosmicdrift/* im Workspace aufgelöst wird.
-
-import { describe, expect, test } from "bun:test";
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
-import { render } from "@testing-library/react";
-import type { ComponentType, ReactNode } from "react";
-import { createStaticLocaleResolver, LocaleProvider } from "../../i18n";
-import { type CorePrimitives, type InputProps, PrimitivesProvider } from "../../primitives";
-import { RenderField } from "../render-field";
-
-let captured: InputProps | undefined;
-const captureInput: ComponentType<InputProps> = (props) => {
-  captured = props;
-  return null;
-};
-const noop = (): ReactNode => null;
-const passChildren = ({ children }: { readonly children?: ReactNode }): ReactNode => children;
-
-const testPrimitives: CorePrimitives = {
-  Button: noop,
-  Banner: noop,
-  Field: passChildren,
-  Input: captureInput,
-  DataTable: noop,
-  Form: noop,
-  Section: noop,
-  Card: noop,
-  Grid: noop,
-  GridCell: noop,
-  Text: noop,
-  Heading: noop,
-  Dialog: noop,
-  Modal: noop,
-  Lightbox: noop,
-  ConfigSourceBadge: noop,
-  ConfigCascadeView: noop,
-  Link: noop,
-};
-
-function moneyField(): EditFieldViewModel {
-  return {
-    field: "price",
-    label: "Preis",
-    type: "money",
-    value: 123456,
-    visible: true,
-    readOnly: false,
-    required: false,
-  };
-}
-
-function dateField(): EditFieldViewModel {
-  return {
-    field: "dueAt",
-    label: "Fällig",
-    type: "date",
-    value: "2026-01-15",
-    visible: true,
-    readOnly: false,
-    required: false,
-  };
-}
-
-function renderUnderLocale(locale: string, field: EditFieldViewModel = moneyField()): void {
-  captured = undefined;
-  render(
-    <LocaleProvider resolver={createStaticLocaleResolver({ locale })}>
-      <PrimitivesProvider value={testPrimitives}>
-        <RenderField field={field} onChange={() => {}} />
-      </PrimitivesProvider>
-    </LocaleProvider>,
-  );
-}
-
-describe("RenderField — App-Locale an money durchreichen", () => {
-  test("money ohne field.locale bekommt das App-Locale (de-DE)", () => {
-    renderUnderLocale("de-DE");
-    expect(captured?.kind).toBe("money");
-    if (captured?.kind === "money") expect(captured.locale).toBe("de-DE");
-  });
-
-  test("ein anderes App-Locale wird ebenso durchgereicht (en-US)", () => {
-    renderUnderLocale("en-US");
-    // Unconditional zuerst — ohne sie wäre der Test bei falschem kind leer.
-    expect(captured?.kind).toBe("money");
-    if (captured?.kind === "money") expect(captured.locale).toBe("en-US");
-  });
-});
-
-describe("RenderField — App-Locale an date durchreichen", () => {
-  test("date ohne field.locale bekommt das App-Locale (de-DE)", () => {
-    renderUnderLocale("de-DE", dateField());
-    expect(captured?.kind).toBe("date");
-    if (captured?.kind === "date") expect(captured.locale).toBe("de-DE");
-  });
-});
-
-describe("RenderField — min/max/dateLocale ans Picker-Input durchreichen (#369)", () => {
-  test("date-Feld: min/max/dateLocale landen in den InputProps", () => {
-    const field: EditFieldViewModel = {
-      ...dateField(),
-      min: "2020-01-01",
-      max: "2026-12-31",
-      dateLocale: "en-US",
-    };
-    renderUnderLocale("de-DE", field);
-    expect(captured?.kind).toBe("date");
-    if (captured?.kind === "date") {
-      expect(captured.min).toBe("2020-01-01");
-      expect(captured.max).toBe("2026-12-31");
-      // dateLocale (per-Feld) hat Vorrang vor dem App-Locale (de-DE).
-      expect(captured.locale).toBe("en-US");
-    }
-  });
-
-  test("timestamp-Feld: min/max landen in den InputProps", () => {
-    const field: EditFieldViewModel = {
-      field: "at",
-      label: "Zeitpunkt",
-      type: "timestamp",
-      value: "",
-      visible: true,
-      readOnly: false,
-      required: false,
-      min: "2026-01-01T00:00:00Z",
-      max: "2026-12-31T23:59:59Z",
-    };
-    renderUnderLocale("de-DE", field);
-    expect(captured?.kind).toBe("timestamp");
-    if (captured?.kind === "timestamp") {
-      expect(captured.min).toBe("2026-01-01T00:00:00Z");
-      expect(captured.max).toBe("2026-12-31T23:59:59Z");
-    }
-  });
-});

package/src/components/__tests__/render-field-enum-option.test.tsx

@@ -1,99 +0,0 @@
-// fw#2315: a projectionDetail field with `renderer: { format: "enumOption",
-// keyPrefix }` must resolve the raw enum value through useTranslation() —
-// the same key convention buildOptionLabels uses for entityList select
-// columns (`<feature>:entity:<entity>:field:<field>:option:<value>`), but
-// for the FieldRendererOutput (readOnly + declared FormatSpec) path.
-//
-// DoD-Test: rendering the SAME field under two locales must produce two
-// DIFFERENT labels — not just prove the format key exists.
-
-import { describe, expect, test } from "bun:test";
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
-import { render } from "@testing-library/react";
-import type { ComponentType, ReactNode } from "react";
-import { createStaticLocaleResolver, LocaleProvider, type TranslationsByLocale } from "../../i18n";
-import { type CorePrimitives, PrimitivesProvider, type TextProps } from "../../primitives";
-import { RenderField } from "../render-field";
-
-let captured: TextProps | undefined;
-const captureText: ComponentType<TextProps> = (props) => {
-  captured = props;
-  return null;
-};
-const noop = (): ReactNode => null;
-const passChildren = ({ children }: { readonly children?: ReactNode }): ReactNode => children;
-
-const testPrimitives: CorePrimitives = {
-  Button: noop,
-  Banner: noop,
-  Field: passChildren,
-  Input: noop,
-  DataTable: noop,
-  Form: noop,
-  Section: noop,
-  Card: noop,
-  Grid: noop,
-  GridCell: noop,
-  Text: captureText,
-  Heading: noop,
-  Dialog: noop,
-  Modal: noop,
-  Lightbox: noop,
-  ConfigSourceBadge: noop,
-  ConfigCascadeView: noop,
-  Link: noop,
-};
-
-const STATUS_KEY_PREFIX = "contact:entity:contact:field:status:option:";
-
-const STATUS_BUNDLES: TranslationsByLocale = {
-  de: { [`${STATUS_KEY_PREFIX}active`]: "Aktiv" },
-  en: { [`${STATUS_KEY_PREFIX}active`]: "Active" },
-};
-
-function statusField(value: unknown = "active"): EditFieldViewModel {
-  return {
-    field: "status",
-    label: "Status",
-    type: "text",
-    value,
-    visible: true,
-    readOnly: true,
-    required: false,
-    renderer: { format: "enumOption", keyPrefix: STATUS_KEY_PREFIX },
-  };
-}
-
-function renderUnderLocale(locale: string, field: EditFieldViewModel): void {
-  captured = undefined;
-  render(
-    <LocaleProvider
-      resolver={createStaticLocaleResolver({ locale })}
-      fallbackBundles={[STATUS_BUNDLES]}
-    >
-      <PrimitivesProvider value={testPrimitives}>
-        <RenderField field={field} onChange={() => {}} />
-      </PrimitivesProvider>
-    </LocaleProvider>,
-  );
-}
-
-describe("RenderField — enumOption-FormatSpec (fw#2315)", () => {
-  test("dieselbe Maske unter zwei Locales rendert zwei verschiedene Beschriftungen", () => {
-    renderUnderLocale("de", statusField());
-    expect(captured?.children).toBe("Aktiv");
-
-    renderUnderLocale("en", statusField());
-    expect(captured?.children).toBe("Active");
-  });
-
-  test("unbekannter Options-Key fällt auf den Rohwert zurück, nicht auf den i18n-Key", () => {
-    renderUnderLocale("de", statusField("archived"));
-    expect(captured?.children).toBe("archived");
-  });
-
-  test("leerer Wert rendert leer", () => {
-    renderUnderLocale("de", statusField(null));
-    expect(captured?.children).toBe("");
-  });
-});

package/src/components/__tests__/render-field-icon-derivation.test.tsx

@@ -1,119 +0,0 @@
-// Fields without a declared icon derive one from the field name — mirrors
-// ACTION_ICON_BY_ID/resolveActionIcon (kumiko-screen.tsx) for fields. Only
-// kind:"text" (single-line) and kind:"number" structurally carry an icon
-// prop, so that's what these tests assert against.
-
-import { describe, expect, test } from "bun:test";
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
-import { render } from "@testing-library/react";
-import type { ComponentType, ReactNode } from "react";
-import { createStaticLocaleResolver, LocaleProvider } from "../../i18n";
-import { type CorePrimitives, type InputProps, PrimitivesProvider } from "../../primitives";
-import { RenderField } from "../render-field";
-
-let captured: InputProps | undefined;
-const captureInput: ComponentType<InputProps> = (props) => {
-  captured = props;
-  return null;
-};
-const noop = (): ReactNode => null;
-const passChildren = ({ children }: { readonly children?: ReactNode }): ReactNode => children;
-
-const testPrimitives: CorePrimitives = {
-  Button: noop,
-  Banner: noop,
-  Field: passChildren,
-  Input: captureInput,
-  DataTable: noop,
-  Form: noop,
-  Section: noop,
-  Card: noop,
-  Grid: noop,
-  GridCell: noop,
-  Text: noop,
-  Heading: noop,
-  Dialog: noop,
-  Modal: noop,
-  Lightbox: noop,
-  ConfigSourceBadge: noop,
-  ConfigCascadeView: noop,
-  Link: noop,
-};
-
-function textField(overrides: Partial<EditFieldViewModel> = {}): EditFieldViewModel {
-  return {
-    field: "name",
-    label: "Name",
-    type: "text",
-    value: "",
-    visible: true,
-    readOnly: false,
-    required: false,
-    ...overrides,
-  };
-}
-
-function renderField(field: EditFieldViewModel): void {
-  captured = undefined;
-  render(
-    <LocaleProvider resolver={createStaticLocaleResolver({ locale: "en-US" })}>
-      <PrimitivesProvider value={testPrimitives}>
-        <RenderField field={field} onChange={() => {}} />
-      </PrimitivesProvider>
-    </LocaleProvider>,
-  );
-}
-
-describe("RenderField — icon derivation from field name/type", () => {
-  test("field named 'email' with no declared icon renders the mail icon", () => {
-    renderField(textField({ field: "email" }));
-    expect(captured?.kind).toBe("text");
-    if (captured?.kind === "text") expect(captured.icon).toBe("mail");
-  });
-
-  test("a declared field.icon overrides the derivation", () => {
-    renderField(textField({ field: "email", icon: "lock" }));
-    expect(captured?.kind).toBe("text");
-    if (captured?.kind === "text") expect(captured.icon).toBe("lock");
-  });
-
-  test("a generic text field with no recognizable name gets no icon", () => {
-    renderField(textField({ field: "foo" }));
-    expect(captured?.kind).toBe("text");
-    if (captured?.kind === "text") expect(captured.icon).toBeUndefined();
-  });
-
-  test("a boolean field gets no icon", () => {
-    renderField({
-      field: "isActive",
-      label: "Active",
-      type: "boolean",
-      value: false,
-      visible: true,
-      readOnly: false,
-      required: false,
-    });
-    expect(captured?.kind).toBe("boolean");
-    if (captured?.kind === "boolean") expect("icon" in captured).toBe(false);
-  });
-
-  test("a multiline field named 'email' gets no icon (textarea has no icon slot)", () => {
-    renderField(textField({ field: "email", multiline: true }));
-    expect(captured?.kind).toBe("textarea");
-    if (captured?.kind === "textarea") expect("icon" in captured).toBe(false);
-  });
-
-  test("a number field with no recognizable name gets no icon", () => {
-    renderField({
-      field: "quantity",
-      label: "Quantity",
-      type: "number",
-      value: 1,
-      visible: true,
-      readOnly: false,
-      required: false,
-    });
-    expect(captured?.kind).toBe("number");
-    if (captured?.kind === "number") expect(captured.icon).toBeUndefined();
-  });
-});

package/src/components/__tests__/render-field-json-format.test.tsx

@@ -1,164 +0,0 @@
-// fw#2312: readOnly fields with `field.renderer: { format: "json" }` (audit
-// payload/metadata, job logs) must hand the RAW value to a registered
-// JsonView primitive — applyFormatSpec's already-indented string is only
-// the fallback for a primitives-provider without JsonView (e.g. an app
-// predating this rollout). "children contains \n" is not a discriminating
-// assertion here (applyFormatSpec already returns a real newline string
-// today) — the test instead checks that JsonView is actually invoked and
-// receives the structured value, not a flattened string.
-//
-// Capture-primitives instead of real ones, same pattern as
-// render-field-unit-format.test.tsx.
-
-import { describe, expect, test } from "bun:test";
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
-import { render } from "@testing-library/react";
-import type { ComponentType, ReactNode } from "react";
-import { createStaticLocaleResolver, LocaleProvider } from "../../i18n";
-import {
-  type CorePrimitives,
-  type JsonViewProps,
-  PrimitivesProvider,
-  type TextProps,
-} from "../../primitives";
-import { RenderField } from "../render-field";
-
-let capturedJsonView: JsonViewProps | undefined;
-const captureJsonView: ComponentType<JsonViewProps> = (props) => {
-  capturedJsonView = props;
-  return null;
-};
-
-let capturedText: TextProps | undefined;
-const captureText: ComponentType<TextProps> = (props) => {
-  capturedText = props;
-  return null;
-};
-
-const noop = (): ReactNode => null;
-const passChildren = ({ children }: { readonly children?: ReactNode }): ReactNode => children;
-
-const basePrimitives: Omit<CorePrimitives, "Text" | "JsonView"> = {
-  Button: noop,
-  // Passes children through (not noop): the "unsupported jsonb" fallback
-  // path wraps its Text/JsonView content in <Banner>, so a Banner that
-  // swallows children would silently never mount them, making those
-  // captures a no-op regardless of which branch RenderField actually took.
-  Banner: passChildren,
-  Field: passChildren,
-  Input: noop,
-  DataTable: noop,
-  Form: noop,
-  Section: noop,
-  Card: noop,
-  Grid: noop,
-  GridCell: noop,
-  Heading: noop,
-  Dialog: noop,
-  Modal: noop,
-  Lightbox: noop,
-  ConfigSourceBadge: noop,
-  ConfigCascadeView: noop,
-  Link: noop,
-};
-
-const primitivesWithJsonView: CorePrimitives = {
-  ...basePrimitives,
-  Text: captureText,
-  JsonView: captureJsonView,
-};
-
-const primitivesWithoutJsonView: CorePrimitives = {
-  ...basePrimitives,
-  Text: captureText,
-};
-
-function payloadField(
-  value: unknown,
-  renderer: EditFieldViewModel["renderer"] = { format: "json" },
-): EditFieldViewModel {
-  return {
-    field: "payload",
-    label: "Payload",
-    type: "jsonb",
-    value,
-    visible: true,
-    readOnly: true,
-    required: false,
-    renderer,
-  };
-}
-
-// No `renderer` key at all (not even `renderer: undefined`, which a default
-// parameter would still override) — this is the "no author-declared
-// FieldRenderer" case that falls through to renderInput's jsonb/embedded/
-// files/images fallback banner instead of FieldRendererOutput.
-function unrenderedJsonbField(value: unknown): EditFieldViewModel {
-  return {
-    field: "payload",
-    label: "Payload",
-    type: "jsonb",
-    value,
-    visible: true,
-    readOnly: true,
-    required: false,
-  };
-}
-
-function renderPayload(primitives: CorePrimitives, field: EditFieldViewModel): void {
-  capturedJsonView = undefined;
-  capturedText = undefined;
-  render(
-    <LocaleProvider resolver={createStaticLocaleResolver({ locale: "en-US" })}>
-      <PrimitivesProvider value={primitives}>
-        <RenderField field={field} onChange={() => {}} />
-      </PrimitivesProvider>
-    </LocaleProvider>,
-  );
-}
-
-describe("RenderField — format: json (fw#2312)", () => {
-  test("mit registriertem JsonView bekommt es den rohen, strukturierten Wert — keinen flachen String", () => {
-    const value = { user: { id: 1, roles: ["admin", "billing"] } };
-    renderPayload(primitivesWithJsonView, payloadField(value));
-    expect(capturedJsonView?.value).toBe(value);
-    expect(typeof capturedJsonView?.value).toBe("object");
-    expect(capturedText).toBeUndefined();
-  });
-
-  test("renderer.indent wird an JsonView durchgereicht", () => {
-    renderPayload(primitivesWithJsonView, payloadField({ a: 1 }, { format: "json", indent: 4 }));
-    expect(capturedJsonView?.indent).toBe(4);
-  });
-
-  test("ohne registriertes JsonView fällt es auf Text mit dem von applyFormatSpec formatierten String zurück", () => {
-    const value = { a: 1 };
-    renderPayload(primitivesWithoutJsonView, payloadField(value));
-    expect(capturedJsonView).toBeUndefined();
-    expect(capturedText?.children).toBe(JSON.stringify(value, null, 2));
-  });
-
-  test("ein zirkulärer Wert erreicht JsonView unverändert — die Aufbereitung ist Sache der Primitive-Implementierung, nicht von RenderField", () => {
-    const circular: Record<string, unknown> = { name: "job-1" };
-    circular["self"] = circular;
-    expect(() => renderPayload(primitivesWithJsonView, payloadField(circular))).not.toThrow();
-    expect(capturedJsonView?.value).toBe(circular);
-  });
-});
-
-describe("RenderField — unsupported jsonb/embedded/files/images Fallback-Banner (fw#2312)", () => {
-  test("mit registriertem JsonView zeigt der Banner den Wert strukturiert statt als JSON.stringify-Einzeiler", () => {
-    const value = { assignee: "user-1", tags: ["a", "b"] };
-    renderPayload(primitivesWithJsonView, unrenderedJsonbField(value));
-    expect(capturedJsonView?.value).toBe(value);
-    expect(capturedText).toBeUndefined();
-  });
-
-  test("ohne registriertes JsonView fällt der Banner auf Text variant=code mit dem alten Einzeiler zurück", () => {
-    const value = { assignee: "user-1" };
-    renderPayload(primitivesWithoutJsonView, unrenderedJsonbField(value));
-    expect(capturedJsonView).toBeUndefined();
-    expect(capturedText?.children).toBe(JSON.stringify(value));
-    expect(capturedText?.variant).toBe("code");
-  });
-});