@open-mercato/core 0.8.1-develop.7297.1.67605e74f9 → 0.9.0

package/dist/modules/forms/ui/public/state/useFormRunner.js

@@ -0,0 +1,394 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { usePortalAppEvent } from "@open-mercato/ui/portal/hooks/usePortalAppEvent";
+import { mergeOnConflict, useAutosave } from "./useAutosave.js";
+import { createAuthRuntimeClient } from "./runtime-client.js";
+import { collectMissingRequired, deriveLogicState } from "./logic-derivation.js";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+const DEFAULT_AUTOSAVE_MS = (() => {
+  const raw = typeof process !== "undefined" && process.env ? process.env.NEXT_PUBLIC_FORMS_AUTOSAVE_INTERVAL_MS ?? process.env.FORMS_AUTOSAVE_INTERVAL_MS : void 0;
+  if (!raw) return 1e4;
+  const parsed = Number.parseInt(raw, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 1e4;
+})();
+function useFormRunner(args) {
+  const t = useT();
+  const {
+    formKey,
+    subjectType,
+    subjectId,
+    initialSubmissionId,
+    autosaveIntervalMs = DEFAULT_AUTOSAVE_MS
+  } = args;
+  const client = useMemo(
+    () => args.client ?? createAuthRuntimeClient({ formKey, subjectType, subjectId }),
+    [args.client, formKey, subjectType, subjectId]
+  );
+  const [stage, setStage] = useState("loading");
+  const [loadError, setLoadError] = useState(null);
+  const [schemaResponse, setSchemaResponse] = useState(null);
+  const [submission, setSubmission] = useState(null);
+  const [submissionRevision, setSubmissionRevision] = useState(null);
+  const [submissionActors, setSubmissionActors] = useState([]);
+  const [decodedData, setDecodedData] = useState({});
+  const [values, setValues] = useState({});
+  const [resumeCandidates, setResumeCandidates] = useState([]);
+  const [conflictKeys, setConflictKeys] = useState([]);
+  const [currentSectionIndex, setCurrentSectionIndex] = useState(0);
+  const [locale, setLocaleState] = useState("en");
+  const [saveState, setSaveState] = useState({ status: "idle" });
+  const [dirtyKey, setDirtyKey] = useState(0);
+  const dirtyFieldsRef = useRef({});
+  const baseSnapshotRef = useRef({});
+  const flushingRef = useRef(false);
+  const schema = schemaResponse?.schema ?? null;
+  const sections = useMemo(() => {
+    if (!schema) return [];
+    const declared = Array.isArray(schema["x-om-sections"]) ? schema["x-om-sections"] : [];
+    if (declared.length > 0) return declared;
+    if (schema.properties) {
+      const allKeys = Object.keys(schema.properties);
+      return [
+        { key: "__default", title: { en: "Form" }, fieldKeys: allKeys }
+      ];
+    }
+    return [];
+  }, [schema]);
+  const fieldOrder = useMemo(() => {
+    if (!schema?.properties) return [];
+    const keys = Object.keys(schema.properties);
+    if (sections.length === 0) return keys;
+    const ordered = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const section of sections) {
+      for (const key of section.fieldKeys) {
+        if (keys.includes(key) && !seen.has(key)) {
+          ordered.push(key);
+          seen.add(key);
+        }
+      }
+    }
+    for (const key of keys) {
+      if (!seen.has(key)) ordered.push(key);
+    }
+    return ordered;
+  }, [schema, sections]);
+  const visibleFieldIndex = useMemo(() => {
+    if (!schemaResponse) return {};
+    return schemaResponse.fieldIndex;
+  }, [schemaResponse]);
+  const logicState = useMemo(
+    () => deriveLogicState({ schema, values, hidden: {}, locale }),
+    [schema, values, locale]
+  );
+  const setLocale = useCallback((next) => {
+    setLocaleState(next);
+  }, []);
+  const setCurrentSection = useCallback((next) => {
+    setCurrentSectionIndex(next);
+  }, []);
+  const captureStarted = useCallback((started) => {
+    setSubmission(started.submission);
+    setSubmissionRevision(started.revision);
+    setSubmissionActors(started.actors);
+    setDecodedData(started.decodedData);
+    setValues({ ...started.decodedData });
+    baseSnapshotRef.current = { ...started.decodedData };
+    dirtyFieldsRef.current = {};
+    setConflictKeys([]);
+    setSaveState({ status: "idle" });
+  }, []);
+  const loadActiveSchema = useCallback(async () => {
+    return client.loadActiveSchema();
+  }, [client]);
+  const loadSubmissionsBySubject = useCallback(async () => {
+    return client.loadResumeCandidates();
+  }, [client]);
+  const loadSubmissionDetail = useCallback(async (submissionId) => {
+    return client.loadSubmissionDetail(submissionId);
+  }, [client]);
+  const startNewSubmission = useCallback(async () => {
+    setSaveState({ status: "idle" });
+    const started = await client.startSubmission();
+    captureStarted(started);
+    setStage("ready");
+    setCurrentSectionIndex(0);
+  }, [client, captureStarted]);
+  const resumeExistingSubmission = useCallback(async (submissionId) => {
+    setSaveState({ status: "idle" });
+    const view = await loadSubmissionDetail(submissionId);
+    captureStarted(view);
+    setStage("ready");
+    setCurrentSectionIndex(0);
+  }, [loadSubmissionDetail, captureStarted]);
+  useEffect(() => {
+    let cancelled = false;
+    async function load() {
+      try {
+        const schemaResp = await loadActiveSchema();
+        if (cancelled) return;
+        setSchemaResponse(schemaResp);
+        setLocaleState((prev) => prev === "en" ? schemaResp.form.defaultLocale : prev);
+        if (initialSubmissionId) {
+          const view = await loadSubmissionDetail(initialSubmissionId);
+          if (cancelled) return;
+          captureStarted(view);
+          setStage("ready");
+          return;
+        }
+        const candidates = await loadSubmissionsBySubject();
+        if (cancelled) return;
+        setResumeCandidates(candidates);
+        if (candidates.length > 0) {
+          setStage("resume_gate");
+        } else {
+          setStage("ready");
+          try {
+            await startNewSubmissionInternal(schemaResp);
+          } catch (error) {
+            if (!cancelled) {
+              const err = isRunnerError(error) ? error : makeError("UNKNOWN", extractErrorMessage(error));
+              setLoadError(err);
+              setStage("error");
+            }
+          }
+        }
+      } catch (error) {
+        if (cancelled) return;
+        const err = isRunnerError(error) ? error : makeError("UNKNOWN", extractErrorMessage(error));
+        setLoadError(err);
+        setStage("error");
+      }
+    }
+    async function startNewSubmissionInternal(_schemaResp) {
+      const started = await client.startSubmission();
+      if (cancelled) return;
+      captureStarted(started);
+    }
+    load();
+    return () => {
+      cancelled = true;
+    };
+  }, [
+    client,
+    initialSubmissionId,
+    loadActiveSchema,
+    loadSubmissionDetail,
+    loadSubmissionsBySubject,
+    captureStarted
+  ]);
+  const setFieldValue = useCallback((fieldKey, value) => {
+    setValues((prev) => ({ ...prev, [fieldKey]: value }));
+    dirtyFieldsRef.current = { ...dirtyFieldsRef.current, [fieldKey]: value };
+    setConflictKeys((prev) => prev.filter((entry) => entry !== fieldKey));
+    setSaveState({ status: "dirty" });
+    setDirtyKey((prev) => prev + 1);
+  }, []);
+  const handleConflict = useCallback(async () => {
+    if (!submission) return;
+    try {
+      const view = await loadSubmissionDetail(submission.id);
+      const merged = mergeOnConflict({
+        localDirty: { ...dirtyFieldsRef.current },
+        baseSnapshot: { ...baseSnapshotRef.current },
+        serverFresh: view.decodedData
+      });
+      setSubmission(view.submission);
+      setSubmissionRevision(view.revision);
+      setSubmissionActors(view.actors);
+      setDecodedData(view.decodedData);
+      setValues(merged.merged);
+      baseSnapshotRef.current = { ...view.decodedData };
+      setConflictKeys(merged.conflictingKeys);
+      dirtyFieldsRef.current = { ...merged.merged };
+      const message = merged.conflictingKeys.length > 0 ? t("forms.runner.save_indicator.conflict") : t("forms.runner.save_indicator.refreshed");
+      setSaveState({ status: "conflict", message });
+      setDirtyKey((prev) => prev + 1);
+    } catch (error) {
+      setSaveState({ status: "error", message: extractErrorMessage(error) });
+    }
+  }, [loadSubmissionDetail, submission, t]);
+  const flushAutosave = useCallback(async () => {
+    if (flushingRef.current) return;
+    if (!submission || !submissionRevision) return;
+    if (Object.keys(dirtyFieldsRef.current).length === 0) return;
+    flushingRef.current = true;
+    setSaveState({ status: "saving" });
+    const dirtySnapshot = { ...dirtyFieldsRef.current };
+    try {
+      const response = await client.save(submission.id, {
+        base_revision_id: submissionRevision.id,
+        patch: dirtySnapshot
+      });
+      if (response.status === 409) {
+        await handleConflict();
+        return;
+      }
+      if (response.status < 200 || response.status >= 300 || !response.result) {
+        throw new Error(t("forms.runner.save.error"));
+      }
+      const nextRevision = response.result.revision;
+      submissionRevisionRef.current = nextRevision;
+      setSubmissionRevision(nextRevision);
+      const remaining = {};
+      for (const [key, value] of Object.entries(dirtyFieldsRef.current)) {
+        if (!shallowEqual(value, dirtySnapshot[key])) remaining[key] = value;
+      }
+      dirtyFieldsRef.current = remaining;
+      baseSnapshotRef.current = { ...baseSnapshotRef.current, ...dirtySnapshot };
+      const stamp = (/* @__PURE__ */ new Date()).toISOString();
+      if (Object.keys(remaining).length > 0) {
+        setSaveState({ status: "dirty" });
+      } else {
+        setSaveState({ status: "saved", savedAt: stamp });
+      }
+    } catch (error) {
+      setSaveState({ status: "error", message: extractErrorMessage(error) });
+    } finally {
+      flushingRef.current = false;
+    }
+  }, [client, handleConflict, submission, submissionRevision, t]);
+  useAutosave({
+    dirtyKey,
+    enabled: stage === "ready" && !!submission,
+    intervalMs: autosaveIntervalMs,
+    onFlush: flushAutosave
+  });
+  usePortalAppEvent(
+    "forms.submission.revision_appended",
+    (payload) => {
+      const target = payload.submissionId;
+      if (!submission || !target || target !== submission.id) return;
+      if (flushingRef.current) return;
+      void handleConflict();
+    },
+    [submission?.id]
+  );
+  usePortalAppEvent(
+    "forms.submission.submitted",
+    (payload) => {
+      const target = payload.submissionId;
+      if (!submission || !target || target !== submission.id) return;
+      setStage("completed");
+    },
+    [submission?.id]
+  );
+  const validateSection = useCallback((sectionIndex) => {
+    if (!schemaResponse || !schema) return [];
+    const section = sections[sectionIndex];
+    if (!section) return [];
+    return collectMissingRequired({
+      schema,
+      fieldIndex: schemaResponse.fieldIndex,
+      sectionFieldKeys: section.fieldKeys,
+      values,
+      visibleFieldKeys: logicState ? logicState.visibleFieldKeys : null
+    });
+  }, [schema, schemaResponse, sections, values, logicState]);
+  const enterReview = useCallback(() => {
+    setStage("review");
+  }, []);
+  const exitReview = useCallback(() => {
+    setStage("ready");
+  }, []);
+  const submit = useCallback(async () => {
+    if (!submission || !submissionRevision) return;
+    setStage("submitting");
+    try {
+      if (Object.keys(dirtyFieldsRef.current).length > 0) {
+        await flushAutosave();
+      }
+      const response = await client.submit(submission.id, {
+        base_revision_id: submissionRevisionRef.current?.id ?? submissionRevision.id,
+        submit_metadata: { locale }
+      });
+      if (response.status === 409) {
+        await handleConflict();
+        setStage("review");
+        return;
+      }
+      if (response.status < 200 || response.status >= 300 || !response.result) {
+        throw new Error(t("forms.runner.submit.error"));
+      }
+      setSubmission(response.result.submission);
+      setStage("completed");
+    } catch (error) {
+      setSaveState({ status: "error", message: extractErrorMessage(error) });
+      setStage("review");
+    }
+  }, [client, flushAutosave, handleConflict, locale, submission, submissionRevision, t]);
+  const submissionRevisionRef = useRef(submissionRevision);
+  useEffect(() => {
+    submissionRevisionRef.current = submissionRevision;
+  }, [submissionRevision]);
+  return {
+    stage,
+    loadError,
+    saveState,
+    schemaResponse,
+    schema,
+    sections,
+    fieldOrder,
+    visibleFieldIndex,
+    logicState,
+    submission,
+    submissionRevision,
+    submissionActors,
+    decodedData,
+    values,
+    conflictKeys,
+    resumeCandidates,
+    currentSectionIndex,
+    setCurrentSectionIndex: setCurrentSection,
+    setFieldValue,
+    locale,
+    setLocale,
+    startNewSubmission,
+    resumeExistingSubmission,
+    enterReview,
+    exitReview,
+    submit,
+    validateSection,
+    flushAutosave,
+    client
+  };
+}
+function makeError(code, message) {
+  return { code, message };
+}
+function isRunnerError(value) {
+  return !!value && typeof value === "object" && "code" in value && "message" in value;
+}
+function extractErrorMessage(error) {
+  if (error instanceof Error) return error.message;
+  if (typeof error === "string") return error;
+  if (isRunnerError(error)) return error.message;
+  return "Unknown error.";
+}
+function shallowEqual(a, b) {
+  if (a === b) return true;
+  if (a == null || b == null) return false;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i += 1) {
+      if (!shallowEqual(a[i], b[i])) return false;
+    }
+    return true;
+  }
+  if (typeof a === "object" && typeof b === "object") {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length) return false;
+    for (const key of aKeys) {
+      if (!shallowEqual(a[key], b[key])) {
+        return false;
+      }
+    }
+    return true;
+  }
+  return false;
+}
+export {
+  useFormRunner
+};
+//# sourceMappingURL=useFormRunner.js.map

package/dist/modules/forms/ui/public/state/useFormRunner.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/forms/ui/public/state/useFormRunner.ts"],
+  "sourcesContent": ["\"use client\"\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport { usePortalAppEvent } from '@open-mercato/ui/portal/hooks/usePortalAppEvent'\nimport type {\n  RunnerActiveFormResponse,\n  RunnerActor,\n  RunnerErrorCode,\n  RunnerFieldDescriptor,\n  RunnerLoadError,\n  RunnerRevision,\n  RunnerSaveState,\n  RunnerSchema,\n  RunnerSection,\n  RunnerSubmission,\n} from '../types'\nimport { mergeOnConflict, useAutosave } from './useAutosave'\nimport { createAuthRuntimeClient, type RuntimeClient } from './runtime-client'\nimport { collectMissingRequired, deriveLogicState } from './logic-derivation'\nimport type { LogicState } from '../../../services/form-logic-evaluator'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\n\nconst DEFAULT_AUTOSAVE_MS = (() => {\n  const raw =\n    typeof process !== 'undefined' && process.env\n      ? process.env.NEXT_PUBLIC_FORMS_AUTOSAVE_INTERVAL_MS ?? process.env.FORMS_AUTOSAVE_INTERVAL_MS\n      : undefined\n  if (!raw) return 10_000\n  const parsed = Number.parseInt(raw, 10)\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 10_000\n})()\n\nexport type RunnerStage =\n  | 'loading'\n  | 'resume_gate'\n  | 'ready'\n  | 'review'\n  | 'submitting'\n  | 'completed'\n  | 'error'\n\nexport type SubmissionListItem = RunnerSubmission\n\nexport type UseFormRunnerArgs = {\n  formKey: string\n  subjectType: string\n  subjectId: string\n  /** Pre-existing submission id, when resuming via `/submissions/:id/continue`. */\n  initialSubmissionId?: string\n  /** Override the autosave debounce (ms). Defaults to FORMS_AUTOSAVE_INTERVAL_MS or 10s. */\n  autosaveIntervalMs?: number\n  /**\n   * Transport client backing the six runtime operations. Omitted \u21D2 the default\n   * authenticated client that calls `/api/forms/form-submissions` and the\n   * by-key active-schema endpoint (the shipped portal flow, unchanged).\n   */\n  client?: RuntimeClient\n}\n\ntype StartedState = {\n  submission: RunnerSubmission\n  revision: RunnerRevision\n  decodedData: Record<string, unknown>\n  actors: RunnerActor[]\n}\n\nexport type UseFormRunnerResult = {\n  stage: RunnerStage\n  loadError: RunnerLoadError | null\n  saveState: RunnerSaveState\n  schemaResponse: RunnerActiveFormResponse | null\n  schema: RunnerSchema | null\n  sections: RunnerSection[]\n  fieldOrder: string[]\n  visibleFieldIndex: Record<string, RunnerFieldDescriptor>\n  /**\n   * Live reactive logic state derived from the current answers \u2014 conditional\n   * visibility (`x-om-visibility-if`), computed variables (`x-om-variables`),\n   * recall-token resolution, and section jumps (`x-om-jumps`). `null` until a\n   * schema is loaded. Mirrors the reactive runner's `evaluateFormLogic` so the\n   * public runner converges on the same behaviour (R-6).\n   */\n  logicState: LogicState | null\n  submission: RunnerSubmission | null\n  submissionRevision: RunnerRevision | null\n  submissionActors: RunnerActor[]\n  decodedData: Record<string, unknown>\n  values: Record<string, unknown>\n  conflictKeys: string[]\n  resumeCandidates: RunnerSubmission[]\n  currentSectionIndex: number\n  setCurrentSectionIndex: (next: number) => void\n  setFieldValue: (fieldKey: string, value: unknown) => void\n  locale: string\n  setLocale: (next: string) => void\n  startNewSubmission: () => Promise<void>\n  resumeExistingSubmission: (submissionId: string) => Promise<void>\n  enterReview: () => void\n  exitReview: () => void\n  submit: () => Promise<void>\n  validateSection: (sectionIndex: number) => string[]\n  flushAutosave: () => Promise<void>\n  /** Active transport client \u2014 exposed so file fields can build an uploader. */\n  client: RuntimeClient\n}\n\nexport function useFormRunner(args: UseFormRunnerArgs): UseFormRunnerResult {\n  const t = useT()\n  const {\n    formKey,\n    subjectType,\n    subjectId,\n    initialSubmissionId,\n    autosaveIntervalMs = DEFAULT_AUTOSAVE_MS,\n  } = args\n\n  const client = useMemo<RuntimeClient>(\n    () => args.client ?? createAuthRuntimeClient({ formKey, subjectType, subjectId }),\n    [args.client, formKey, subjectType, subjectId],\n  )\n\n  const [stage, setStage] = useState<RunnerStage>('loading')\n  const [loadError, setLoadError] = useState<RunnerLoadError | null>(null)\n  const [schemaResponse, setSchemaResponse] = useState<RunnerActiveFormResponse | null>(null)\n  const [submission, setSubmission] = useState<RunnerSubmission | null>(null)\n  const [submissionRevision, setSubmissionRevision] = useState<RunnerRevision | null>(null)\n  const [submissionActors, setSubmissionActors] = useState<RunnerActor[]>([])\n  const [decodedData, setDecodedData] = useState<Record<string, unknown>>({})\n  const [values, setValues] = useState<Record<string, unknown>>({})\n  const [resumeCandidates, setResumeCandidates] = useState<RunnerSubmission[]>([])\n  const [conflictKeys, setConflictKeys] = useState<string[]>([])\n  const [currentSectionIndex, setCurrentSectionIndex] = useState(0)\n  const [locale, setLocaleState] = useState<string>('en')\n  const [saveState, setSaveState] = useState<RunnerSaveState>({ status: 'idle' })\n  const [dirtyKey, setDirtyKey] = useState(0)\n\n  const dirtyFieldsRef = useRef<Record<string, unknown>>({})\n  const baseSnapshotRef = useRef<Record<string, unknown>>({})\n  const flushingRef = useRef(false)\n\n  const schema = schemaResponse?.schema ?? null\n  const sections: RunnerSection[] = useMemo(() => {\n    if (!schema) return []\n    const declared = Array.isArray(schema['x-om-sections']) ? schema['x-om-sections'] : []\n    if (declared.length > 0) return declared\n    if (schema.properties) {\n      const allKeys = Object.keys(schema.properties)\n      return [\n        { key: '__default', title: { en: 'Form' }, fieldKeys: allKeys },\n      ]\n    }\n    return []\n  }, [schema])\n\n  const fieldOrder = useMemo(() => {\n    if (!schema?.properties) return []\n    const keys = Object.keys(schema.properties)\n    if (sections.length === 0) return keys\n    const ordered: string[] = []\n    const seen = new Set<string>()\n    for (const section of sections) {\n      for (const key of section.fieldKeys) {\n        if (keys.includes(key) && !seen.has(key)) {\n          ordered.push(key)\n          seen.add(key)\n        }\n      }\n    }\n    for (const key of keys) {\n      if (!seen.has(key)) ordered.push(key)\n    }\n    return ordered\n  }, [schema, sections])\n\n  const visibleFieldIndex = useMemo(() => {\n    if (!schemaResponse) return {}\n    return schemaResponse.fieldIndex\n  }, [schemaResponse])\n\n  // Reactive logic state \u2014 recomputed whenever answers change so conditional\n  // visibility, variables, recall, and jumps stay live (matches the reactive\n  // runner). The public transport carries no hidden values, so we pass `{}`;\n  // `evaluateFormLogic` still applies declared hidden-field defaults.\n  const logicState = useMemo<LogicState | null>(\n    () => deriveLogicState({ schema, values, hidden: {}, locale }),\n    [schema, values, locale],\n  )\n\n  const setLocale = useCallback((next: string) => {\n    setLocaleState(next)\n  }, [])\n\n  const setCurrentSection = useCallback((next: number) => {\n    setCurrentSectionIndex(next)\n  }, [])\n\n  const captureStarted = useCallback((started: StartedState) => {\n    setSubmission(started.submission)\n    setSubmissionRevision(started.revision)\n    setSubmissionActors(started.actors)\n    setDecodedData(started.decodedData)\n    setValues({ ...started.decodedData })\n    baseSnapshotRef.current = { ...started.decodedData }\n    dirtyFieldsRef.current = {}\n    setConflictKeys([])\n    setSaveState({ status: 'idle' })\n  }, [])\n\n  const loadActiveSchema = useCallback(async () => {\n    return client.loadActiveSchema()\n  }, [client])\n\n  const loadSubmissionsBySubject = useCallback(async () => {\n    return client.loadResumeCandidates()\n  }, [client])\n\n  const loadSubmissionDetail = useCallback(async (submissionId: string): Promise<StartedState> => {\n    return client.loadSubmissionDetail(submissionId)\n  }, [client])\n\n  const startNewSubmission = useCallback(async () => {\n    setSaveState({ status: 'idle' })\n    const started = await client.startSubmission()\n    captureStarted(started)\n    setStage('ready')\n    setCurrentSectionIndex(0)\n  }, [client, captureStarted])\n\n  const resumeExistingSubmission = useCallback(async (submissionId: string) => {\n    setSaveState({ status: 'idle' })\n    const view = await loadSubmissionDetail(submissionId)\n    captureStarted(view)\n    setStage('ready')\n    setCurrentSectionIndex(0)\n  }, [loadSubmissionDetail, captureStarted])\n\n  // ---------- Initial load ----------\n  useEffect(() => {\n    let cancelled = false\n    async function load() {\n      try {\n        const schemaResp = await loadActiveSchema()\n        if (cancelled) return\n        setSchemaResponse(schemaResp)\n        setLocaleState((prev) => (prev === 'en' ? schemaResp.form.defaultLocale : prev))\n\n        if (initialSubmissionId) {\n          const view = await loadSubmissionDetail(initialSubmissionId)\n          if (cancelled) return\n          captureStarted(view)\n          setStage('ready')\n          return\n        }\n\n        const candidates = await loadSubmissionsBySubject()\n        if (cancelled) return\n        setResumeCandidates(candidates)\n        if (candidates.length > 0) {\n          setStage('resume_gate')\n        } else {\n          setStage('ready')\n          // Auto-start a new submission so the renderer can show fields immediately.\n          try {\n            await startNewSubmissionInternal(schemaResp)\n          } catch (error) {\n            if (!cancelled) {\n              const err = isRunnerError(error)\n                ? error\n                : makeError('UNKNOWN', extractErrorMessage(error))\n              setLoadError(err)\n              setStage('error')\n            }\n          }\n        }\n      } catch (error) {\n        if (cancelled) return\n        const err = isRunnerError(error)\n          ? error\n          : makeError('UNKNOWN', extractErrorMessage(error))\n        setLoadError(err)\n        setStage('error')\n      }\n    }\n\n    async function startNewSubmissionInternal(_schemaResp: RunnerActiveFormResponse) {\n      const started = await client.startSubmission()\n      if (cancelled) return\n      captureStarted(started)\n    }\n\n    load()\n    return () => {\n      cancelled = true\n    }\n  }, [\n    client,\n    initialSubmissionId,\n    loadActiveSchema,\n    loadSubmissionDetail,\n    loadSubmissionsBySubject,\n    captureStarted,\n  ])\n\n  // ---------- Field updates ----------\n  const setFieldValue = useCallback((fieldKey: string, value: unknown) => {\n    setValues((prev) => ({ ...prev, [fieldKey]: value }))\n    dirtyFieldsRef.current = { ...dirtyFieldsRef.current, [fieldKey]: value }\n    setConflictKeys((prev) => prev.filter((entry) => entry !== fieldKey))\n    setSaveState({ status: 'dirty' })\n    setDirtyKey((prev) => prev + 1)\n  }, [])\n\n  const handleConflict = useCallback(async () => {\n    if (!submission) return\n    try {\n      const view = await loadSubmissionDetail(submission.id)\n      const merged = mergeOnConflict({\n        localDirty: { ...dirtyFieldsRef.current },\n        baseSnapshot: { ...baseSnapshotRef.current },\n        serverFresh: view.decodedData,\n      })\n      setSubmission(view.submission)\n      setSubmissionRevision(view.revision)\n      setSubmissionActors(view.actors)\n      setDecodedData(view.decodedData)\n      setValues(merged.merged)\n      baseSnapshotRef.current = { ...view.decodedData }\n      setConflictKeys(merged.conflictingKeys)\n      // After merge, treat dirty fields as still dirty so the next flush retries with the new base.\n      dirtyFieldsRef.current = { ...merged.merged }\n      const message = merged.conflictingKeys.length > 0\n        ? t('forms.runner.save_indicator.conflict')\n        : t('forms.runner.save_indicator.refreshed')\n      setSaveState({ status: 'conflict', message })\n      setDirtyKey((prev) => prev + 1)\n    } catch (error) {\n      setSaveState({ status: 'error', message: extractErrorMessage(error) })\n    }\n  }, [loadSubmissionDetail, submission, t])\n\n  // ---------- Autosave flush ----------\n  const flushAutosave = useCallback(async () => {\n    if (flushingRef.current) return\n    if (!submission || !submissionRevision) return\n    if (Object.keys(dirtyFieldsRef.current).length === 0) return\n    flushingRef.current = true\n    setSaveState({ status: 'saving' })\n    const dirtySnapshot = { ...dirtyFieldsRef.current }\n    try {\n      const response = await client.save(submission.id, {\n        base_revision_id: submissionRevision.id,\n        patch: dirtySnapshot,\n      })\n      if (response.status === 409) {\n        await handleConflict()\n        return\n      }\n      if (response.status < 200 || response.status >= 300 || !response.result) {\n        throw new Error(t('forms.runner.save.error'))\n      }\n      const nextRevision = response.result.revision\n      submissionRevisionRef.current = nextRevision\n      setSubmissionRevision(nextRevision)\n      const remaining: Record<string, unknown> = {}\n      for (const [key, value] of Object.entries(dirtyFieldsRef.current)) {\n        if (!shallowEqual(value, dirtySnapshot[key])) remaining[key] = value\n      }\n      dirtyFieldsRef.current = remaining\n      baseSnapshotRef.current = { ...baseSnapshotRef.current, ...dirtySnapshot }\n      const stamp = new Date().toISOString()\n      if (Object.keys(remaining).length > 0) {\n        setSaveState({ status: 'dirty' })\n      } else {\n        setSaveState({ status: 'saved', savedAt: stamp })\n      }\n    } catch (error) {\n      setSaveState({ status: 'error', message: extractErrorMessage(error) })\n    } finally {\n      flushingRef.current = false\n    }\n  }, [client, handleConflict, submission, submissionRevision, t])\n\n  useAutosave({\n    dirtyKey,\n    enabled: stage === 'ready' && !!submission,\n    intervalMs: autosaveIntervalMs,\n    onFlush: flushAutosave,\n  })\n\n  // Cross-tab sync: another tab saved or submitted this submission.\n  usePortalAppEvent(\n    'forms.submission.revision_appended',\n    (payload) => {\n      const target = (payload as { submissionId?: string }).submissionId\n      if (!submission || !target || target !== submission.id) return\n      if (flushingRef.current) return\n      void handleConflict()\n    },\n    [submission?.id],\n  )\n\n  usePortalAppEvent(\n    'forms.submission.submitted',\n    (payload) => {\n      const target = (payload as { submissionId?: string }).submissionId\n      if (!submission || !target || target !== submission.id) return\n      setStage('completed')\n    },\n    [submission?.id],\n  )\n\n  // ---------- Validation per section ----------\n  // Required-field gating ignores fields hidden by `x-om-visibility-if`: a\n  // hidden required field must not block Next / submit (converges with the\n  // reactive runner and aligns the client with T1's server-side slicing).\n  const validateSection = useCallback((sectionIndex: number): string[] => {\n    if (!schemaResponse || !schema) return []\n    const section = sections[sectionIndex]\n    if (!section) return []\n    return collectMissingRequired({\n      schema,\n      fieldIndex: schemaResponse.fieldIndex,\n      sectionFieldKeys: section.fieldKeys,\n      values,\n      visibleFieldKeys: logicState ? logicState.visibleFieldKeys : null,\n    })\n  }, [schema, schemaResponse, sections, values, logicState])\n\n  const enterReview = useCallback(() => {\n    setStage('review')\n  }, [])\n\n  const exitReview = useCallback(() => {\n    setStage('ready')\n  }, [])\n\n  const submit = useCallback(async () => {\n    if (!submission || !submissionRevision) return\n    setStage('submitting')\n    try {\n      // Always flush local edits first so the submit metadata reflects the\n      // latest revision id.\n      if (Object.keys(dirtyFieldsRef.current).length > 0) {\n        await flushAutosave()\n      }\n      const response = await client.submit(submission.id, {\n        base_revision_id: submissionRevisionRef.current?.id ?? submissionRevision.id,\n        submit_metadata: { locale },\n      })\n      if (response.status === 409) {\n        await handleConflict()\n        setStage('review')\n        return\n      }\n      if (response.status < 200 || response.status >= 300 || !response.result) {\n        throw new Error(t('forms.runner.submit.error'))\n      }\n      setSubmission(response.result.submission)\n      setStage('completed')\n    } catch (error) {\n      setSaveState({ status: 'error', message: extractErrorMessage(error) })\n      setStage('review')\n    }\n  }, [client, flushAutosave, handleConflict, locale, submission, submissionRevision, t])\n\n  // Keep a ref to the latest submission revision so `submit` can read the\n  // post-flush id without re-binding the callback.\n  const submissionRevisionRef = useRef<RunnerRevision | null>(submissionRevision)\n  useEffect(() => {\n    submissionRevisionRef.current = submissionRevision\n  }, [submissionRevision])\n\n  return {\n    stage,\n    loadError,\n    saveState,\n    schemaResponse,\n    schema,\n    sections,\n    fieldOrder,\n    visibleFieldIndex,\n    logicState,\n    submission,\n    submissionRevision,\n    submissionActors,\n    decodedData,\n    values,\n    conflictKeys,\n    resumeCandidates,\n    currentSectionIndex,\n    setCurrentSectionIndex: setCurrentSection,\n    setFieldValue,\n    locale,\n    setLocale,\n    startNewSubmission,\n    resumeExistingSubmission,\n    enterReview,\n    exitReview,\n    submit,\n    validateSection,\n    flushAutosave,\n    client,\n  }\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction makeError(code: RunnerErrorCode, message: string): RunnerLoadError {\n  return { code, message }\n}\n\nfunction isRunnerError(value: unknown): value is RunnerLoadError {\n  return !!value && typeof value === 'object' && 'code' in (value as Record<string, unknown>) && 'message' in (value as Record<string, unknown>)\n}\n\nfunction extractErrorMessage(error: unknown): string {\n  if (error instanceof Error) return error.message\n  if (typeof error === 'string') return error\n  if (isRunnerError(error)) return error.message\n  return 'Unknown error.'\n}\n\nfunction shallowEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true\n  if (a == null || b == null) return false\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false\n    for (let i = 0; i < a.length; i += 1) {\n      if (!shallowEqual(a[i], b[i])) return false\n    }\n    return true\n  }\n  if (typeof a === 'object' && typeof b === 'object') {\n    const aKeys = Object.keys(a as Record<string, unknown>)\n    const bKeys = Object.keys(b as Record<string, unknown>)\n    if (aKeys.length !== bKeys.length) return false\n    for (const key of aKeys) {\n      if (!shallowEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key])) {\n        return false\n      }\n    }\n    return true\n  }\n  return false\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/forms/ui/public/style/LogoHeader.js

@@ -0,0 +1,33 @@
+import { jsx } from "react/jsx-runtime";
+import { cn } from "@open-mercato/shared/lib/utils";
+const SIZE_TO_CLASS = {
+  sm: "max-h-8",
+  md: "max-h-12",
+  lg: "max-h-16"
+};
+const ALIGN_TO_CLASS = {
+  start: "justify-start",
+  center: "justify-center",
+  end: "justify-end"
+};
+function buildLogoSrc(assetId) {
+  return `/api/attachments/image/${encodeURIComponent(assetId)}?width=480&cropType=contain`;
+}
+function LogoHeader({ logo }) {
+  if (!logo || typeof logo.assetId !== "string" || logo.assetId.length === 0) return null;
+  const sizeClass = SIZE_TO_CLASS[logo.size ?? "md"];
+  const alignClass = ALIGN_TO_CLASS[logo.align ?? "start"];
+  return /* @__PURE__ */ jsx("div", { className: cn("flex w-full", alignClass), children: /* @__PURE__ */ jsx(
+    "img",
+    {
+      src: buildLogoSrc(logo.assetId),
+      alt: logo.alt ?? "",
+      className: cn("w-auto object-contain", sizeClass)
+    }
+  ) });
+}
+export {
+  LogoHeader,
+  buildLogoSrc
+};
+//# sourceMappingURL=LogoHeader.js.map

package/dist/modules/forms/ui/public/style/LogoHeader.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/forms/ui/public/style/LogoHeader.tsx"],
+  "sourcesContent": ["import * as React from 'react'\nimport { cn } from '@open-mercato/shared/lib/utils'\nimport type { OmThemeLogo } from '../../../schema/style-extensions'\n\n/**\n * Renders a themed form's logo/header image. The source is ALWAYS the public\n * attachments image route addressed by the stored `assetId` \u2014 never an\n * author-supplied URL (D4 / no SSRF). Absent logo \u21D2 renders nothing, so an\n * unstyled form is byte-identical. Shared by `FormRunner` (runtime) and\n * `PreviewSurface` (studio) for parity (R-CS-7).\n */\n\nconst SIZE_TO_CLASS: Record<NonNullable<OmThemeLogo['size']>, string> = {\n  sm: 'max-h-8',\n  md: 'max-h-12',\n  lg: 'max-h-16',\n}\n\nconst ALIGN_TO_CLASS: Record<NonNullable<OmThemeLogo['align']>, string> = {\n  start: 'justify-start',\n  center: 'justify-center',\n  end: 'justify-end',\n}\n\nexport function buildLogoSrc(assetId: string): string {\n  return `/api/attachments/image/${encodeURIComponent(assetId)}?width=480&cropType=contain`\n}\n\nexport function LogoHeader({ logo }: { logo: OmThemeLogo | undefined }) {\n  if (!logo || typeof logo.assetId !== 'string' || logo.assetId.length === 0) return null\n  const sizeClass = SIZE_TO_CLASS[logo.size ?? 'md']\n  const alignClass = ALIGN_TO_CLASS[logo.align ?? 'start']\n  return (\n    <div className={cn('flex w-full', alignClass)}>\n      {/* eslint-disable-next-line @next/next/no-img-element */}\n      <img\n        src={buildLogoSrc(logo.assetId)}\n        alt={logo.alt ?? ''}\n        className={cn('w-auto object-contain', sizeClass)}\n      />\n    </div>\n  )\n}\n"],
+  "mappings": "AAmCM;AAlCN,SAAS,UAAU;AAWnB,MAAM,gBAAkE;AAAA,EACtE,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;AAEA,MAAM,iBAAoE;AAAA,EACxE,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,KAAK;AACP;AAEO,SAAS,aAAa,SAAyB;AACpD,SAAO,0BAA0B,mBAAmB,OAAO,CAAC;AAC9D;AAEO,SAAS,WAAW,EAAE,KAAK,GAAsC;AACtE,MAAI,CAAC,QAAQ,OAAO,KAAK,YAAY,YAAY,KAAK,QAAQ,WAAW,EAAG,QAAO;AACnF,QAAM,YAAY,cAAc,KAAK,QAAQ,IAAI;AACjD,QAAM,aAAa,eAAe,KAAK,SAAS,OAAO;AACvD,SACE,oBAAC,SAAI,WAAW,GAAG,eAAe,UAAU,GAE1C;AAAA,IAAC;AAAA;AAAA,MACC,KAAK,aAAa,KAAK,OAAO;AAAA,MAC9B,KAAK,KAAK,OAAO;AAAA,MACjB,WAAW,GAAG,yBAAyB,SAAS;AAAA;AAAA,EAClD,GACF;AAEJ;",
+  "names": []
+}

package/dist/modules/forms/ui/public/style/applyStyle.js

@@ -0,0 +1,12 @@
+import { cn } from "@open-mercato/shared/lib/utils";
+function styleProps(resolved, ...extraClasses) {
+  const style = resolved.cssVars;
+  return {
+    style,
+    className: cn(...resolved.classNames, ...extraClasses)
+  };
+}
+export {
+  styleProps
+};
+//# sourceMappingURL=applyStyle.js.map

package/dist/modules/forms/ui/public/style/applyStyle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/forms/ui/public/style/applyStyle.ts"],
+  "sourcesContent": ["import type * as React from 'react'\nimport { cn } from '@open-mercato/shared/lib/utils'\nimport type { ResolvedStyle } from '../../../services/style-compiler'\n\n/**\n * Turn a compiled `ResolvedStyle` into React `style` + `className` props for the\n * runtime apply seam (`.ai/specs/2026-05-22-forms-custom-styling.md` Step 5).\n *\n * `cssVars` carries both CSS custom properties (`--card`, `--om-text-color`, \u2026)\n * and a small set of safe direct CSS props (`background`, `backgroundImage`,\n * `fontFamily`, `color`, `accentColor`). Custom-property keys are not part of\n * the `React.CSSProperties` index signature, so the typed `Record<string, string>`\n * is cast once here \u2014 the single documented CSS-custom-property cast. The values\n * are already re-validated by the compiler (hex / known `var(--\u2026)` / fixed\n * template), and React escapes them as a style object (never a `<style>` string).\n */\nexport function styleProps(\n  resolved: ResolvedStyle,\n  ...extraClasses: Array<string | undefined>\n): { style: React.CSSProperties; className: string } {\n  const style = resolved.cssVars as React.CSSProperties\n  return {\n    style,\n    className: cn(...resolved.classNames, ...extraClasses),\n  }\n}\n"],
+  "mappings": "AACA,SAAS,UAAU;AAeZ,SAAS,WACd,aACG,cACgD;AACnD,QAAM,QAAQ,SAAS;AACvB,SAAO;AAAA,IACL;AAAA,IACA,WAAW,GAAG,GAAG,SAAS,YAAY,GAAG,YAAY;AAAA,EACvD;AACF;",
+  "names": []
+}

package/dist/modules/forms/ui/public/types.js

@@ -0,0 +1,18 @@
+function resolveLocaleString(map, locale, defaultLocale, fallback) {
+  if (!map) return fallback;
+  if (typeof map[locale] === "string" && map[locale].length > 0) return map[locale];
+  if (typeof map[defaultLocale] === "string" && map[defaultLocale].length > 0) return map[defaultLocale];
+  for (const key of Object.keys(map)) {
+    const value = map[key];
+    if (typeof value === "string" && value.length > 0) return value;
+  }
+  return fallback;
+}
+function resolveSectionTitle(section, locale, defaultLocale) {
+  return resolveLocaleString(section.title, locale, defaultLocale, section.key);
+}
+export {
+  resolveLocaleString,
+  resolveSectionTitle
+};
+//# sourceMappingURL=types.js.map

package/dist/modules/forms/ui/public/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/forms/ui/public/types.ts"],
+  "sourcesContent": ["/**\n * Public renderer (FormRunner) shared types.\n *\n * These types describe the runtime API responses consumed by `useFormRunner`\n * and the data passed into individual field renderers. They mirror the JSON\n * payload returned by phase 1c routes (`GET /api/forms/by-key/:key/active`,\n * `POST /api/forms/form-submissions`, `GET/PATCH /api/forms/form-submissions/:id`,\n * `POST /api/forms/form-submissions/:id/submit`).\n */\n\nexport type RunnerLocaleMap = Record<string, string>\n\nexport type RunnerOption = {\n  value: string\n  label: RunnerLocaleMap\n}\n\nexport type RunnerFieldNode = {\n  type: string | string[]\n  'x-om-type'?: string\n  'x-om-label'?: RunnerLocaleMap\n  'x-om-help'?: RunnerLocaleMap\n  'x-om-options'?: RunnerOption[]\n  'x-om-min'?: number\n  'x-om-max'?: number\n  'x-om-sensitive'?: boolean\n  'x-om-editable-by'?: string[]\n  'x-om-visible-to'?: string[]\n  'x-om-widget'?: string\n  enum?: unknown[]\n  minLength?: number\n  maxLength?: number\n  pattern?: string\n  [key: string]: unknown\n}\n\nexport type RunnerSection = {\n  key: string\n  title: RunnerLocaleMap\n  fieldKeys: string[]\n}\n\nexport type RunnerSchema = {\n  type?: string\n  'x-om-roles'?: string[]\n  'x-om-default-actor-role'?: string\n  'x-om-sections'?: RunnerSection[]\n  properties?: Record<string, RunnerFieldNode>\n  required?: string[]\n  [key: string]: unknown\n}\n\nexport type RunnerFieldDescriptor = {\n  key: string\n  type: string\n  sectionKey: string | null\n  sensitive: boolean\n  editableBy: string[]\n  visibleTo: string[]\n  required: boolean\n}\n\nexport type RunnerActiveFormResponse = {\n  form: {\n    id: string\n    key: string\n    name: string\n    defaultLocale: string\n    supportedLocales: string[]\n  }\n  formVersion: {\n    id: string\n    versionNumber: number\n    schemaHash: string\n    registryVersion: string\n    roles: string[]\n  }\n  schema: RunnerSchema\n  uiSchema: Record<string, unknown>\n  fieldIndex: Record<string, RunnerFieldDescriptor>\n  callerRoles: string[]\n}\n\nexport type RunnerSubmissionStatus = 'draft' | 'submitted' | 'reopened' | 'archived'\n\nexport type RunnerSubmission = {\n  id: string\n  organizationId: string\n  tenantId: string\n  formVersionId: string\n  subjectType: string\n  subjectId: string\n  status: RunnerSubmissionStatus\n  currentRevisionId: string | null\n  startedBy: string\n  submittedBy: string | null\n  firstSavedAt: string | null\n  submittedAt: string | null\n  submitMetadata: Record<string, unknown> | null\n  pdfSnapshotAttachmentId: string | null\n  anonymizedAt: string | null\n  createdAt: string | null\n  updatedAt: string | null\n}\n\nexport type RunnerRevision = {\n  id: string\n  submissionId: string\n  revisionNumber: number\n  encryptionKeyVersion: number | null\n  savedAt: string | null\n  savedBy: string\n  savedByRole: string | null\n  changeSource: string\n  changedFieldKeys: string[]\n  changeSummary: string | null\n  anonymizedAt: string | null\n}\n\nexport type RunnerActor = {\n  id: string\n  submissionId: string\n  userId: string\n  role: string\n  assignedAt: string | null\n  revokedAt: string | null\n}\n\nexport type RunnerSubmissionView = {\n  submission: RunnerSubmission\n  revision: RunnerRevision\n  decoded_data: Record<string, unknown>\n  actors: RunnerActor[]\n}\n\nexport type RunnerSaveResult = {\n  revision: RunnerRevision\n  coalesced: boolean\n}\n\nexport type RunnerSaveState =\n  | { status: 'idle' }\n  | { status: 'dirty' }\n  | { status: 'saving' }\n  | { status: 'saved'; savedAt: string }\n  | { status: 'conflict'; message: string }\n  | { status: 'error'; message: string }\n\nexport type RunnerErrorCode =\n  | 'NETWORK'\n  | 'NOT_FOUND'\n  | 'NO_PUBLISHED_VERSION'\n  | 'UNAUTHORIZED'\n  | 'VALIDATION'\n  | 'CONFLICT'\n  | 'UNKNOWN'\n\nexport type RunnerLoadError = {\n  code: RunnerErrorCode\n  message: string\n}\n\n/**\n * Reference persisted in a `file`-field value. Mirrors\n * `schema/file-field.ts#FileAttachmentRef`.\n */\nexport type RunnerFileAttachmentRef = {\n  id: string\n  filename: string\n  contentType: string\n  sizeBytes: number\n}\n\n/**\n * Upload transport injected into the file renderer. Hides whether the active\n * flow is authenticated (portal) or anonymous (access token) \u2014 the runtime\n * client supplies the correct endpoint + auth header. `downloadUrl` returns a\n * link the participant can open to preview their own upload.\n */\nexport type RunnerAttachmentUploader = {\n  upload(args: {\n    submissionId: string\n    fieldKey: string\n    file: File\n  }): Promise<RunnerFileAttachmentRef>\n  downloadUrl(submissionId: string, attachmentId: string): string\n}\n\nexport type RunnerFieldRendererProps = {\n  field: RunnerFieldDescriptor\n  fieldNode: RunnerFieldNode\n  value: unknown\n  onChange: (next: unknown) => void\n  onBlur?: () => void\n  locale: string\n  defaultLocale: string\n  disabled?: boolean\n  error?: string | null\n  inputId?: string\n  /** Present when the field can upload (file type); supplied by the runtime. */\n  uploader?: RunnerAttachmentUploader\n  /** The current submission id \u2014 required for upload/download URLs. */\n  submissionId?: string\n}\n\nexport function resolveLocaleString(\n  map: RunnerLocaleMap | undefined,\n  locale: string,\n  defaultLocale: string,\n  fallback: string,\n): string {\n  if (!map) return fallback\n  if (typeof map[locale] === 'string' && map[locale].length > 0) return map[locale]\n  if (typeof map[defaultLocale] === 'string' && map[defaultLocale].length > 0) return map[defaultLocale]\n  for (const key of Object.keys(map)) {\n    const value = map[key]\n    if (typeof value === 'string' && value.length > 0) return value\n  }\n  return fallback\n}\n\nexport function resolveSectionTitle(\n  section: RunnerSection,\n  locale: string,\n  defaultLocale: string,\n): string {\n  return resolveLocaleString(section.title, locale, defaultLocale, section.key)\n}\n"],
+  "mappings": "AA6MO,SAAS,oBACd,KACA,QACA,eACA,UACQ;AACR,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI,OAAO,IAAI,MAAM,MAAM,YAAY,IAAI,MAAM,EAAE,SAAS,EAAG,QAAO,IAAI,MAAM;AAChF,MAAI,OAAO,IAAI,aAAa,MAAM,YAAY,IAAI,aAAa,EAAE,SAAS,EAAG,QAAO,IAAI,aAAa;AACrG,aAAW,OAAO,OAAO,KAAK,GAAG,GAAG;AAClC,UAAM,QAAQ,IAAI,GAAG;AACrB,QAAI,OAAO,UAAU,YAAY,MAAM,SAAS,EAAG,QAAO;AAAA,EAC5D;AACA,SAAO;AACT;AAEO,SAAS,oBACd,SACA,QACA,eACQ;AACR,SAAO,oBAAoB,QAAQ,OAAO,QAAQ,eAAe,QAAQ,GAAG;AAC9E;",
+  "names": []
+}