@cosmicdrift/kumiko-headless 0.328.0 → 0.329.0

package/src/format/__tests__/html-template.test.ts

@@ -1,47 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { html, RawHtml, raw } from "../html-template";
-
-const XSS = `<script>alert("1")</script>`;
-
-describe("html tagged template", () => {
-  test("escapes string interpolations", () => {
-    expect(html`<p>${XSS}</p>`.toString()).toBe(
-      "<p>&lt;script&gt;alert(&quot;1&quot;)&lt;/script&gt;</p>",
-    );
-  });
-
-  test("escapes attribute breakouts (double quotes)", () => {
-    const href = `"><img src=x onerror=alert(1)>`;
-    const out = html`<a href="${href}">x</a>`.toString();
-    expect(out).not.toContain('"><img');
-    expect(out).toContain("&quot;&gt;&lt;img");
-  });
-
-  test("raw() passes prerendered markup through unchanged", () => {
-    expect(html`<div>${raw("<b>ok</b>")}</div>`.toString()).toBe("<div><b>ok</b></div>");
-  });
-
-  test("nested html`...` fragments are not double-escaped", () => {
-    const item = html`<li>${"a & b"}</li>`;
-    expect(html`<ul>${item}</ul>`.toString()).toBe("<ul><li>a &amp; b</li></ul>");
-  });
-
-  test("arrays are joined with each element escaped", () => {
-    const items = ["<x>", "y"].map((v) => html`<li>${v}</li>`);
-    expect(html`<ul>${items}</ul>`.toString()).toBe("<ul><li>&lt;x&gt;</li><li>y</li></ul>");
-  });
-
-  test("null and undefined render as empty string", () => {
-    expect(html`<p>${null}${undefined}</p>`.toString()).toBe("<p></p>");
-  });
-
-  test("numbers and booleans render via String()", () => {
-    expect(html`<td>${42}${false}</td>`.toString()).toBe("<td>42false</td>");
-  });
-
-  test("toString() makes fragments usable in plain string contexts", () => {
-    const fragment = html`<p>${"<i>"}</p>`;
-    expect(`${fragment}`).toBe("<p>&lt;i&gt;</p>");
-    expect(fragment).toBeInstanceOf(RawHtml);
-  });
-});

package/src/format/html-template.ts

@@ -1,49 +0,0 @@
-// html`...` — Tagged-Template, das jede Interpolation automatisch HTML-escaped.
-// Macht Escaping strukturell statt per-Callsite-Konvention: vergessen ist
-// unmöglich, bewusst rohes HTML braucht ein explizites raw(). Der
-// HTML-Escape-Guard (kumiko-guards) akzeptiert html`...` als safe.
-
-import { escapeHtml } from "./escape";
-
-export class RawHtml {
-  readonly html: string;
-  constructor(html: string) {
-    this.html = html;
-  }
-  toString(): string {
-    return this.html;
-  }
-}
-
-/** Markiert bereits escaptes/vertrauenswürdiges Markup für html`...`. */
-export function raw(html: string): RawHtml {
-  return new RawHtml(html);
-}
-
-export type HtmlValue =
-  | string
-  | number
-  | boolean
-  | null
-  | undefined
-  | RawHtml
-  | ReadonlyArray<HtmlValue>;
-
-function renderValue(value: HtmlValue): string {
-  if (value === null || value === undefined) return "";
-  if (value instanceof RawHtml) return value.html;
-  if (Array.isArray(value)) return value.map(renderValue).join("");
-  if (typeof value === "string") return escapeHtml(value);
-  return String(value);
-}
-
-// Rückgabe ist RawHtml, damit Fragmente verschachtelbar sind ohne doppelt zu
-// escapen: `html`<div>${item}</div>`` innerhalb eines äußeren html`...`
-// passiert unverändert durch. toString() liefert das fertige Markup.
-export function html(strings: TemplateStringsArray, ...values: ReadonlyArray<HtmlValue>): RawHtml {
-  let out = strings[0] ?? "";
-  values.forEach((value, i) => {
-    out += renderValue(value) + (strings[i + 1] ?? "");
-  });
-  return new RawHtml(out);
-}

package/src/format/index.ts

@@ -1,223 +0,0 @@
-// Pure format utilities — no web or platform dependencies.
-// Shared between renderer-web, renderer-native, and server-side tests.
-
-import { Temporal } from "temporal-polyfill";
-
-function toPlainDate(raw: string): Temporal.PlainDate {
-  try {
-    return Temporal.PlainDate.from(raw);
-  } catch {
-    // "date"-typed field stored as a full instant (day-boundary timestamp) —
-    // take the calendar date in the local zone rather than fail.
-    return toInstant(raw).toZonedDateTimeISO(Temporal.Now.timeZoneId()).toPlainDate();
-  }
-}
-
-// Temporal.Instant.from is stricter than the `new Date(raw)` this replaced:
-// it requires a UTC designator/offset (Z/+hh:mm). Timestamps without one
-// (e.g. "2026-07-18T12:00:00", still valid input to `new Date`) throw here
-// instead of parsing — fall back to reading them as a local wall-clock time,
-// same posture as toPlainDate's own fallback above.
-export function toInstant(raw: string): Temporal.Instant {
-  try {
-    return Temporal.Instant.from(raw);
-  } catch {
-    return Temporal.PlainDateTime.from(raw).toZonedDateTime(Temporal.Now.timeZoneId()).toInstant();
-  }
-}
-
-function formatDateCell(
-  value: unknown,
-  type: string,
-  opts?: {
-    locale?: string;
-    dateStyle?: Intl.DateTimeFormatOptions["dateStyle"];
-    timeStyle?: Intl.DateTimeFormatOptions["timeStyle"];
-  },
-): string {
-  try {
-    const raw = typeof value === "string" ? value : String(value);
-    const locale = opts?.locale;
-    if (opts?.dateStyle || opts?.timeStyle) {
-      if (type === "date") {
-        // ponytail: timeStyle is ignored here on purpose — a PlainDate has no
-        // time component to format, so a timeStyle-only "date" field falls
-        // back to PlainDate's default dateStyle instead of rendering a time.
-        return toPlainDate(raw).toLocaleString(locale, {
-          dateStyle: opts.dateStyle,
-        });
-      }
-      return toInstant(raw).toLocaleString(locale, {
-        dateStyle: opts.dateStyle,
-        timeStyle: opts.timeStyle,
-      });
-    }
-    if (type === "date") {
-      return toPlainDate(raw).toLocaleString(locale, {
-        year: "numeric",
-        month: "2-digit",
-        day: "2-digit",
-      });
-    }
-    return toInstant(raw).toLocaleString(locale, {
-      year: "numeric",
-      month: "short",
-      day: "numeric",
-      hour: "2-digit",
-      minute: "2-digit",
-    });
-  } catch {
-    return String(value);
-  }
-}
-
-// No `locale` fallback to a browser API here (headless has none) — passing
-// `undefined` to Intl.NumberFormat resolves the runtime's default locale,
-// the same value a browser's navigator.language-based guess would produce.
-function formatNumberCell(value: unknown, locale?: string, grouping = true): string {
-  if (typeof value !== "number" || !Number.isFinite(value)) return String(value);
-  try {
-    return new Intl.NumberFormat(locale, { useGrouping: grouping }).format(value);
-  } catch {
-    // Malformed BCP-47 locale tag — mirrors formatDateCell's fallback above.
-    return String(value);
-  }
-}
-
-// Two-tier unit table for `{ format: "unit" }`. Keys mirror
-// @cosmicdrift/kumiko-types' UnitKey (kept as a local literal union instead
-// of an import — headless has no build-time dependency on kumiko-types
-// today, and applyFormatSpec's spec param is already an untyped
-// Record<string, unknown>, cast per-case like every other format below).
-const UNIT_INTL_IDS = {
-  km: "kilometer",
-  m: "meter",
-  kg: "kilogram",
-  percent: "percent",
-  mi: "mile",
-} as const;
-
-// "m2" (square meter) has no ECMA-402 sanctioned unit — Intl.NumberFormat
-// throws RangeError for "square-meter". Locale-format the number and append
-// the literal suffix instead of going through `style: "unit"`.
-const UNIT_SUFFIXES = { m2: "m²" } as const;
-
-function isIntlUnit(unit: string): unit is keyof typeof UNIT_INTL_IDS {
-  return Object.hasOwn(UNIT_INTL_IDS, unit);
-}
-
-function isSuffixUnit(unit: string): unit is keyof typeof UNIT_SUFFIXES {
-  return Object.hasOwn(UNIT_SUFFIXES, unit);
-}
-
-function formatUnitCell(
-  value: unknown,
-  unit: string | undefined,
-  locale: string | undefined,
-  unitDisplay: Intl.NumberFormatOptions["unitDisplay"],
-): string {
-  const n = typeof value === "number" ? value : Number(value);
-  if (unit === undefined || !Number.isFinite(n)) return String(value);
-  if (isIntlUnit(unit)) {
-    try {
-      return new Intl.NumberFormat(locale, {
-        style: "unit",
-        unit: UNIT_INTL_IDS[unit],
-        unitDisplay,
-      }).format(n);
-    } catch {
-      // Malformed BCP-47 locale tag — mirrors formatNumberCell's fallback below.
-      return formatNumberCell(n, locale);
-    }
-  }
-  if (isSuffixUnit(unit)) {
-    return `${formatNumberCell(n, locale)} ${UNIT_SUFFIXES[unit]}`;
-  }
-  return String(value);
-}
-
-/** Exported for UnitKey parity tests against @cosmicdrift/kumiko-types/screen. */
-export const UNIT_FORMAT_KEYS = [
-  ...Object.keys(UNIT_INTL_IDS),
-  ...Object.keys(UNIT_SUFFIXES),
-] as const;
-
-export { escapeHtml, escapeHtmlAttr, escapeXml, isSafeHref, stripControlChars } from "./escape";
-export { type HtmlValue, html, RawHtml, raw } from "./html-template";
-export { currencyDecimals } from "./money";
-export function applyFormatSpec(
-  spec: { format: string } & Record<string, unknown>,
-  value: unknown,
-  translate?: (key: string) => string,
-): string {
-  const isEmpty = value === null || value === undefined || value === "";
-  // priority renders its emptyLabel for empty values — every other format
-  // collapses empty to "".
-  if (isEmpty && spec.format !== "priority") return "";
-  switch (spec.format) {
-    case "timestamp":
-    case "date":
-      return formatDateCell(value, spec.format, {
-        locale: spec["locale"] as string | undefined,
-        dateStyle: spec["dateStyle"] as Intl.DateTimeFormatOptions["dateStyle"],
-        timeStyle:
-          spec.format === "timestamp"
-            ? (spec["timeStyle"] as Intl.DateTimeFormatOptions["timeStyle"])
-            : undefined,
-      });
-    case "boolean": {
-      if (value === true) {
-        const trueLabel = spec["trueLabel"] as string | undefined;
-        return trueLabel === undefined ? "✓" : (translate?.(trueLabel) ?? trueLabel);
-      }
-      if (value === false) {
-        const falseLabel = spec["falseLabel"] as string | undefined;
-        return falseLabel === undefined ? "" : (translate?.(falseLabel) ?? falseLabel);
-      }
-      return "";
-    }
-    case "currency": {
-      const sym = (spec["symbol"] as string | undefined) ?? "";
-      return sym.length > 0 ? `${value} ${sym}` : String(value);
-    }
-    case "number":
-    case "decimal":
-    case "bigInt":
-      return formatNumberCell(
-        value,
-        spec["locale"] as string | undefined,
-        (spec["grouping"] as boolean | undefined) ?? true,
-      );
-    case "unit":
-      return formatUnitCell(
-        value,
-        spec["unit"] as string | undefined,
-        spec["locale"] as string | undefined,
-        (spec["unitDisplay"] as Intl.NumberFormatOptions["unitDisplay"]) ?? "short",
-      );
-    case "priority": {
-      const emptyLabel = (spec["emptyLabel"] as string | undefined) ?? "—";
-      const prefix = (spec["prefix"] as string | undefined) ?? "";
-      if (isEmpty || value === 0) return emptyLabel;
-      return `${prefix}${value}`;
-    }
-    case "enumOption": {
-      const raw = typeof value === "string" ? value : String(value);
-      const keyPrefix = spec["keyPrefix"] as string | undefined;
-      if (keyPrefix === undefined || translate === undefined) return raw;
-      const key = `${keyPrefix}${raw}`;
-      const translated = translate(key);
-      return translated === key ? raw : translated;
-    }
-    case "json":
-      return JSON.stringify(value, null, (spec["indent"] as number | undefined) ?? 2);
-    default:
-      if (typeof process !== "undefined" && process.env.NODE_ENV !== "production") {
-        // biome-ignore lint/suspicious/noConsole: dev-only warning
-        console.warn(
-          `[kumiko] applyFormatSpec: unknown format key "${spec.format}" — registered via FieldFormatRegistry module augmentation?`,
-        );
-      }
-      return typeof value === "string" ? value : String(value);
-  }
-}

package/src/index.ts

@@ -1,118 +0,0 @@
-export type { ParsedRefTarget } from "@cosmicdrift/kumiko-framework/ui-types";
-// Re-Export aus framework/ui-types damit Renderer-Code denselben
-// Parser nutzt wie der Server-Boot-Validator (Cross-Feature-Refs).
-export { parseRefTarget } from "@cosmicdrift/kumiko-framework/ui-types";
-export type {
-  AssetResolution,
-  AssetResolveContext,
-  AssetResolver,
-  BadgeProps,
-  ButtonProps,
-  CardProps,
-  DatePickerProps,
-  IconProps,
-  LocaleResolver,
-  ModalProps,
-  NumberInputProps,
-  PrimitiveCommonProps,
-  PrimitivesContract,
-  SelectOption,
-  SelectProps,
-  TextInputProps,
-  ToastIntent,
-  ToastProps,
-  ToggleProps,
-} from "./contracts";
-export type {
-  BatchResult,
-  Command,
-  Dispatcher,
-  DispatcherError,
-  DispatcherStatus,
-  FieldIssue,
-  PendingFile,
-  PendingWrite,
-  QueryOpts,
-  QueryResult,
-  StreamOpts,
-  WriteOpts,
-  WriteResult,
-} from "./dispatcher";
-export { StreamFrame, type StreamFrameEvent } from "./dispatcher";
-export type {
-  FieldConditionPredicate,
-  FieldConditions,
-  FieldConditionValue,
-  FieldState,
-  FormController,
-  FormControllerOptions,
-  FormSnapshot,
-  FormValues,
-  SubmitConfig,
-  SubmitPayloadMode,
-  SubmitResult,
-} from "./form";
-export { createFormController, I18N_KEY_PARAM } from "./form";
-export {
-  applyFormatSpec,
-  currencyDecimals,
-  escapeHtml,
-  escapeHtmlAttr,
-  escapeXml,
-  type HtmlValue,
-  html,
-  isSafeHref,
-  RawHtml,
-  raw,
-  stripControlChars,
-  toInstant,
-} from "./format";
-export type {
-  NavDefinition,
-  NavNode,
-  NavRegistrySlice,
-  NavTree,
-  ResolveNavigationOptions,
-} from "./nav";
-export { resolveNavigation } from "./nav";
-export type { Store, WritableStore } from "./store";
-export { createStore, shallowEqual } from "./store";
-export type {
-  ComputeEditViewModelInput,
-  ComputeListViewModelInput,
-  DerivedCellRoundingTarget,
-  EditExtensionSectionViewModel,
-  EditFieldSpec,
-  EditFieldsSectionViewModel,
-  EditFieldViewModel,
-  EditRelatedListSectionViewModel,
-  EditSectionSpec,
-  EditSectionViewModel,
-  EditViewModel,
-  EditWriteFormSectionViewModel,
-  EmbeddedDerivedOp,
-  EmbeddedListCellViewModel,
-  EmbeddedListIssueGroups,
-  FieldConditionCtx,
-  FieldRenderer,
-  ListColumnSpec,
-  ListColumnViewModel,
-  ListRowViewModel,
-  ListViewModel,
-  RuntimeRenderer,
-  ScreenSlots,
-  Translate,
-} from "./view-model";
-export {
-  computeDerivedCellValue,
-  computeEditViewModel,
-  computeListViewModel,
-  embeddedCellLabelKey,
-  embeddedCellOptionLabelKey,
-  fieldLabelKey,
-  fieldOptionLabelKey,
-  fieldOptionLabelKeyPrefix,
-  groupEmbeddedListIssues,
-  roundDerivedCellValue,
-  sumEmbeddedListColumn,
-} from "./view-model";