@dynatrace/strato-components 3.9.0 → 3.10.0

package/esm/forms/form/hooks/useFormRuntimeRegistration.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/forms/form/hooks/useFormRuntimeRegistration.ts"],
+  "sourcesContent": ["import {\n  useCallback,\n  useContext,\n  useEffect,\n  useRef,\n  useSyncExternalStore,\n} from 'react';\n\nimport type { ValidationState } from '../../validation/types.js';\nimport { FormContext } from '../context/FormContext.js';\nimport type {\n  ControlRegistrationHandle,\n  ValidateFieldOptions,\n} from '../form.types.js';\nimport type { FormRuntime } from '../runtime/createFormRuntime.js';\nimport { getFormById, subscribeToFormById } from '../runtime/formRegistry.js';\n\nconst noopSubscribe = () => () => undefined;\n\n/**\n * The control-provided contract, with callbacks read live so registration\n * stays stable across renders.\n * @internal\n */\nexport interface FormRuntimeRegistrationOptions {\n  /** Logical form-control id. */\n  id: string;\n  /** Submit key; snapshot values are keyed by `name ?? id`. */\n  name?: string;\n  /** Associates with a `<Form>` by id when rendered outside its subtree. */\n  form?: string;\n  /** Reads the control's current value. */\n  getValue: () => unknown;\n  /** Focuses the control (focus-first-invalid). */\n  focus: () => void;\n  /** Runs the control's own validation and resolves with its state. */\n  validateField: (options: ValidateFieldOptions) => Promise<ValidationState>;\n  /** Clears form-managed visual validation state while keeping the value. */\n  resetValidation?: () => void;\n}\n\n/**\n * The shared registration primitive behind `useFormRegistration`\n * (public, custom controls) and `useInternalFormRegistration` (internal, Strato\n * controls). Resolves the enclosing runtime \u2014 from context, or by `form` id for\n * out-of-subtree controls \u2014 registers once, and keeps the descriptor callbacks\n * live via refs so a re-render never re-registers.\n *\n * Returns a `reportValidity` that pushes live validity between submits, or\n * `undefined` when there is no form to register with (standalone control).\n * @internal\n */\nexport function useFormRuntimeRegistration(\n  options: FormRuntimeRegistrationOptions,\n): ((state: ValidationState) => void) | undefined {\n  const context = useContext(FormContext);\n  const formId = options.form;\n\n  // Out-of-subtree association: the control may resolve its form by id before\n  // the <Form> registers (no effect ordering guarantee across sibling trees),\n  // so subscribe and re-resolve once a form registers under this id.\n  const byIdRuntime = useSyncExternalStore(\n    useCallback(\n      (onStoreChange) =>\n        formId ? subscribeToFormById(formId, onStoreChange) : noopSubscribe(),\n      [formId],\n    ),\n    () => (formId ? getFormById(formId) : undefined),\n  );\n\n  const runtime: FormRuntime | undefined = context?.runtime ?? byIdRuntime;\n\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n\n  const handleRef = useRef<ControlRegistrationHandle | undefined>(undefined);\n\n  const { id } = options;\n\n  useEffect(() => {\n    if (!runtime || id === '') {\n      return;\n    }\n    const handle = runtime.register({\n      id,\n      get name() {\n        return optionsRef.current.name;\n      },\n      getValue: () => optionsRef.current.getValue(),\n      focus: () => optionsRef.current.focus(),\n      validateField: (validateOptions) =>\n        optionsRef.current.validateField(validateOptions),\n      resetValidation: () => optionsRef.current.resetValidation?.(),\n    });\n    handleRef.current = handle;\n    return () => {\n      handle.unregister();\n      handleRef.current = undefined;\n    };\n  }, [runtime, id]);\n\n  if (!runtime) {\n    return undefined;\n  }\n\n  return (state) => handleRef.current?.reportValidity(state);\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,mBAAmB;AAM5B,SAAS,aAAa,2BAA2B;AAEjD,MAAM,gBAAgB,MAAM,MAAM;AAmC3B,SAAS,2BACd,SACgD;AAChD,QAAM,UAAU,WAAW,WAAW;AACtC,QAAM,SAAS,QAAQ;AAKvB,QAAM,cAAc;AAAA,IAClB;AAAA,MACE,CAAC,kBACC,SAAS,oBAAoB,QAAQ,aAAa,IAAI,cAAc;AAAA,MACtE,CAAC,MAAM;AAAA,IACT;AAAA,IACA,MAAO,SAAS,YAAY,MAAM,IAAI;AAAA,EACxC;AAEA,QAAM,UAAmC,SAAS,WAAW;AAE7D,QAAM,aAAa,OAAO,OAAO;AACjC,aAAW,UAAU;AAErB,QAAM,YAAY,OAA8C,MAAS;AAEzE,QAAM,EAAE,GAAG,IAAI;AAEf,YAAU,MAAM;AACd,QAAI,CAAC,WAAW,OAAO,IAAI;AACzB;AAAA,IACF;AACA,UAAM,SAAS,QAAQ,SAAS;AAAA,MAC9B;AAAA,MACA,IAAI,OAAO;AACT,eAAO,WAAW,QAAQ;AAAA,MAC5B;AAAA,MACA,UAAU,MAAM,WAAW,QAAQ,SAAS;AAAA,MAC5C,OAAO,MAAM,WAAW,QAAQ,MAAM;AAAA,MACtC,eAAe,CAAC,oBACd,WAAW,QAAQ,cAAc,eAAe;AAAA,MAClD,iBAAiB,MAAM,WAAW,QAAQ,kBAAkB;AAAA,IAC9D,CAAC;AACD,cAAU,UAAU;AACpB,WAAO,MAAM;AACX,aAAO,WAAW;AAClB,gBAAU,UAAU;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,SAAS,EAAE,CAAC;AAEhB,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,SAAO,CAAC,UAAU,UAAU,SAAS,eAAe,KAAK;AAC3D;",
+  "names": []
+}

package/esm/forms/form/hooks/useInternalFormRegistration.js

@@ -0,0 +1,103 @@
+import { useCallback, useEffect, useRef } from "react";
+import { useIntl } from "react-intl";
+import { useFormRuntimeRegistration } from "./useFormRuntimeRegistration.js";
+import { useCallbackRef } from "../../../core/hooks/useCallbackRef.js";
+import { useId } from "../../../core/hooks/useId.js";
+import { useFormFieldContext } from "../../forms-core/hooks/useFormFieldContext.js";
+import { useFormFieldMessagesContext } from "../../forms-core/hooks/useFormFieldMessagesContext.js";
+import { getI18nValidationState } from "../../forms-core/hooks/useFormFieldValidation.js";
+import { FormFieldMessagesAction } from "../../forms-core/state/formfield-messages-state-reducer.js";
+import {
+  normalizeMessageTarget
+} from "../../validation/message-routing.js";
+import { useCustomMessageEmitter } from "../../validation/useCustomMessageEmitter.js";
+function useInternalFormRegistration(options) {
+  const {
+    id,
+    name,
+    form,
+    messageTarget,
+    value,
+    controlRef,
+    onValidityChange,
+    getValue,
+    focus,
+    validateField,
+    resetValidation
+  } = options;
+  const intl = useIntl();
+  const generatedId = useId();
+  const formFieldContext = useFormFieldContext();
+  const { dispatch } = useFormFieldMessagesContext();
+  const normalizedTarget = messageTarget === void 0 ? void 0 : normalizeMessageTarget(messageTarget);
+  const messageTargetKey = normalizedTarget?.join(",") ?? "";
+  const normalizedTargetRef = useRef(normalizedTarget);
+  normalizedTargetRef.current = normalizedTarget;
+  useEffect(() => {
+    dispatch?.({
+      type: FormFieldMessagesAction.SETMESSAGETARGET,
+      payload: { messageTarget: normalizedTargetRef.current }
+    });
+  }, [dispatch, messageTargetKey]);
+  const suppressLiveValidityReportRef = useRef(false);
+  const reportValidityRef = useRef(void 0);
+  const onValidityChangeStable = useCallbackRef(onValidityChange);
+  const handleValidityChange = useCallback(
+    (state) => {
+      onValidityChangeStable(state);
+      if (!suppressLiveValidityReportRef.current) {
+        reportValidityRef.current?.(state);
+      }
+    },
+    [onValidityChangeStable]
+  );
+  const emitWithCustomMessages = useCustomMessageEmitter(
+    handleValidityChange,
+    () => getI18nValidationState(intl, controlRef?.current?.inputRef, "manual")
+  );
+  const defaultValidateField = ({ reveal, trigger }) => {
+    controlRef?.current?.inputRef?.checkValidity();
+    if (reveal) {
+      dispatch?.({
+        type: FormFieldMessagesAction.SETISTOUCHED,
+        payload: { isTouched: true }
+      });
+    }
+    return emitWithCustomMessages(
+      getI18nValidationState(intl, controlRef?.current?.inputRef, trigger)
+    );
+  };
+  const resolvedId = id ?? formFieldContext.formFieldId ?? formFieldContext.controlId ?? generatedId;
+  const wrappedValidateField = useCallback(
+    async (validateOptions) => {
+      suppressLiveValidityReportRef.current = true;
+      try {
+        return await (validateField ?? defaultValidateField)(validateOptions);
+      } finally {
+        suppressLiveValidityReportRef.current = false;
+      }
+    },
+    [defaultValidateField, validateField]
+  );
+  const reportValidity = useFormRuntimeRegistration({
+    id: resolvedId,
+    name,
+    form,
+    getValue: getValue ?? (() => value),
+    focus: focus ?? (() => controlRef?.current?.focus?.()),
+    validateField: wrappedValidateField,
+    resetValidation: resetValidation ?? (() => {
+      controlRef?.current?.inputRef?.setCustomValidity("");
+      dispatch?.({
+        type: FormFieldMessagesAction.SETISTOUCHED,
+        payload: { isTouched: false, resetShowError: true }
+      });
+    })
+  });
+  reportValidityRef.current = reportValidity;
+  return { id: resolvedId, onValidityChange: handleValidityChange };
+}
+export {
+  useInternalFormRegistration
+};
+//# sourceMappingURL=useInternalFormRegistration.js.map

package/esm/forms/form/hooks/useInternalFormRegistration.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/forms/form/hooks/useInternalFormRegistration.ts"],
+  "sourcesContent": ["import { useCallback, useEffect, useRef, type RefObject } from 'react';\nimport { useIntl } from 'react-intl';\n\nimport { useFormRuntimeRegistration } from './useFormRuntimeRegistration.js';\nimport { useCallbackRef } from '../../../core/hooks/useCallbackRef.js';\nimport { useId } from '../../../core/hooks/useId.js';\nimport { useFormFieldContext } from '../../forms-core/hooks/useFormFieldContext.js';\nimport { useFormFieldMessagesContext } from '../../forms-core/hooks/useFormFieldMessagesContext.js';\nimport { getI18nValidationState } from '../../forms-core/hooks/useFormFieldValidation.js';\nimport { FormFieldMessagesAction } from '../../forms-core/state/formfield-messages-state-reducer.js';\nimport type { FormControlRef } from '../../shared-types.js';\nimport {\n  type MessageTarget,\n  normalizeMessageTarget,\n} from '../../validation/message-routing.js';\nimport type { ValidationState } from '../../validation/types.js';\nimport { useCustomMessageEmitter } from '../../validation/useCustomMessageEmitter.js';\nimport type { ValidateFieldOptions } from '../form.types.js';\n\nexport interface InternalFormRegistrationOptions<TValue = unknown> {\n  id?: string;\n  name?: string;\n  form?: string;\n  /**\n   * Where this control's native/Strato messages render, from the control's\n   * `_messageTarget` prop. Defaults to the field outlet.\n   */\n  messageTarget?: MessageTarget | MessageTarget[];\n  value?: TValue;\n  controlRef?: RefObject<FormControlRef<HTMLElement> | null>;\n  onValidityChange?: (state: ValidationState) => void;\n  getValue?: () => unknown;\n  focus?: () => void;\n  validateField?: (options: ValidateFieldOptions) => Promise<ValidationState>;\n  resetValidation?: () => void;\n}\n\n/**\n * Internal registration hook for Strato-owned controls. Strato controls compute their\n * own `ValidationState` (native + Strato + custom messages) through the\n * `FormField` message pipeline; this hook hands that pipeline's\n * `validateField` and value/focus accessors to the enclosing `<Form>` so the\n * control participates in submit, aggregation, snapshot, and focus-first-invalid\n * with no per-control runtime of its own.\n *\n * It is the counterpart to the public `useFormRegistration`: same\n * registration primitive, but fed by the Strato validity pipeline instead of a\n * consumer-supplied validator. Returns a `reportValidity` the control tees its\n * live emissions into, or a no-op when there is no enclosing form.\n * @internal\n */\nexport function useInternalFormRegistration<TValue = unknown>(\n  options: InternalFormRegistrationOptions<TValue>,\n): { id: string; onValidityChange: (state: ValidationState) => void } {\n  const {\n    id,\n    name,\n    form,\n    messageTarget,\n    value,\n    controlRef,\n    onValidityChange,\n    getValue,\n    focus,\n    validateField,\n    resetValidation,\n  } = options;\n  const intl = useIntl();\n  const generatedId = useId();\n  const formFieldContext = useFormFieldContext();\n  const { dispatch } = useFormFieldMessagesContext();\n\n  // Publish the control's routing choice into the field context so the two\n  // read-points (the `FormFieldMessages` render filter and the\n  // `useCustomMessageEmitter` emit path) resolve it without per-control logic.\n  const normalizedTarget =\n    messageTarget === undefined\n      ? undefined\n      : normalizeMessageTarget(messageTarget);\n  const messageTargetKey = normalizedTarget?.join(',') ?? '';\n  const normalizedTargetRef = useRef(normalizedTarget);\n  normalizedTargetRef.current = normalizedTarget;\n  useEffect(() => {\n    dispatch?.({\n      type: FormFieldMessagesAction.SETMESSAGETARGET,\n      payload: { messageTarget: normalizedTargetRef.current },\n    });\n  }, [dispatch, messageTargetKey]);\n  const suppressLiveValidityReportRef = useRef(false);\n  const reportValidityRef = useRef<\n    ((state: ValidationState) => void) | undefined\n  >(undefined);\n\n  // Consumers routinely pass a fresh `onValidityChange` on every render (e.g. an\n  // inline arrow). Read it through a stable ref so `handleValidityChange` \u2014 and\n  // the `useCustomMessageEmitter` re-emit effects that depend on it \u2014 keep a\n  // stable identity; otherwise every emitted state re-triggers those effects,\n  // and when the consumer's handler also sets state it becomes an infinite loop.\n  const onValidityChangeStable = useCallbackRef(onValidityChange);\n  const handleValidityChange = useCallback(\n    (state: ValidationState) => {\n      onValidityChangeStable(state);\n      if (!suppressLiveValidityReportRef.current) {\n        reportValidityRef.current?.(state);\n      }\n    },\n    [onValidityChangeStable],\n  );\n  const emitWithCustomMessages = useCustomMessageEmitter(\n    handleValidityChange,\n    () => getI18nValidationState(intl, controlRef?.current?.inputRef, 'manual'),\n  );\n\n  const defaultValidateField = ({ reveal, trigger }: ValidateFieldOptions) => {\n    controlRef?.current?.inputRef?.checkValidity();\n    if (reveal) {\n      dispatch?.({\n        type: FormFieldMessagesAction.SETISTOUCHED,\n        payload: { isTouched: true },\n      });\n    }\n    return emitWithCustomMessages(\n      getI18nValidationState(intl, controlRef?.current?.inputRef, trigger),\n    );\n  };\n\n  const resolvedId =\n    id ??\n    formFieldContext.formFieldId ??\n    formFieldContext.controlId ??\n    generatedId;\n\n  const wrappedValidateField = useCallback(\n    async (validateOptions: ValidateFieldOptions) => {\n      suppressLiveValidityReportRef.current = true;\n      try {\n        return await (validateField ?? defaultValidateField)(validateOptions);\n      } finally {\n        suppressLiveValidityReportRef.current = false;\n      }\n    },\n    [defaultValidateField, validateField],\n  );\n\n  const reportValidity = useFormRuntimeRegistration({\n    id: resolvedId,\n    name,\n    form,\n    getValue: getValue ?? (() => value),\n    focus: focus ?? (() => controlRef?.current?.focus?.()),\n    validateField: wrappedValidateField,\n    resetValidation:\n      resetValidation ??\n      (() => {\n        controlRef?.current?.inputRef?.setCustomValidity('');\n        dispatch?.({\n          type: FormFieldMessagesAction.SETISTOUCHED,\n          payload: { isTouched: false, resetShowError: true },\n        });\n      }),\n  });\n\n  reportValidityRef.current = reportValidity;\n\n  return { id: resolvedId, onValidityChange: handleValidityChange };\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa,WAAW,cAA8B;AAC/D,SAAS,eAAe;AAExB,SAAS,kCAAkC;AAC3C,SAAS,sBAAsB;AAC/B,SAAS,aAAa;AACtB,SAAS,2BAA2B;AACpC,SAAS,mCAAmC;AAC5C,SAAS,8BAA8B;AACvC,SAAS,+BAA+B;AAExC;AAAA,EAEE;AAAA,OACK;AAEP,SAAS,+BAA+B;AAmCjC,SAAS,4BACd,SACoE;AACpE,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AACJ,QAAM,OAAO,QAAQ;AACrB,QAAM,cAAc,MAAM;AAC1B,QAAM,mBAAmB,oBAAoB;AAC7C,QAAM,EAAE,SAAS,IAAI,4BAA4B;AAKjD,QAAM,mBACJ,kBAAkB,SACd,SACA,uBAAuB,aAAa;AAC1C,QAAM,mBAAmB,kBAAkB,KAAK,GAAG,KAAK;AACxD,QAAM,sBAAsB,OAAO,gBAAgB;AACnD,sBAAoB,UAAU;AAC9B,YAAU,MAAM;AACd,eAAW;AAAA,MACT,MAAM,wBAAwB;AAAA,MAC9B,SAAS,EAAE,eAAe,oBAAoB,QAAQ;AAAA,IACxD,CAAC;AAAA,EACH,GAAG,CAAC,UAAU,gBAAgB,CAAC;AAC/B,QAAM,gCAAgC,OAAO,KAAK;AAClD,QAAM,oBAAoB,OAExB,MAAS;AAOX,QAAM,yBAAyB,eAAe,gBAAgB;AAC9D,QAAM,uBAAuB;AAAA,IAC3B,CAAC,UAA2B;AAC1B,6BAAuB,KAAK;AAC5B,UAAI,CAAC,8BAA8B,SAAS;AAC1C,0BAAkB,UAAU,KAAK;AAAA,MACnC;AAAA,IACF;AAAA,IACA,CAAC,sBAAsB;AAAA,EACzB;AACA,QAAM,yBAAyB;AAAA,IAC7B;AAAA,IACA,MAAM,uBAAuB,MAAM,YAAY,SAAS,UAAU,QAAQ;AAAA,EAC5E;AAEA,QAAM,uBAAuB,CAAC,EAAE,QAAQ,QAAQ,MAA4B;AAC1E,gBAAY,SAAS,UAAU,cAAc;AAC7C,QAAI,QAAQ;AACV,iBAAW;AAAA,QACT,MAAM,wBAAwB;AAAA,QAC9B,SAAS,EAAE,WAAW,KAAK;AAAA,MAC7B,CAAC;AAAA,IACH;AACA,WAAO;AAAA,MACL,uBAAuB,MAAM,YAAY,SAAS,UAAU,OAAO;AAAA,IACrE;AAAA,EACF;AAEA,QAAM,aACJ,MACA,iBAAiB,eACjB,iBAAiB,aACjB;AAEF,QAAM,uBAAuB;AAAA,IAC3B,OAAO,oBAA0C;AAC/C,oCAA8B,UAAU;AACxC,UAAI;AACF,eAAO,OAAO,iBAAiB,sBAAsB,eAAe;AAAA,MACtE,UAAE;AACA,sCAA8B,UAAU;AAAA,MAC1C;AAAA,IACF;AAAA,IACA,CAAC,sBAAsB,aAAa;AAAA,EACtC;AAEA,QAAM,iBAAiB,2BAA2B;AAAA,IAChD,IAAI;AAAA,IACJ;AAAA,IACA;AAAA,IACA,UAAU,aAAa,MAAM;AAAA,IAC7B,OAAO,UAAU,MAAM,YAAY,SAAS,QAAQ;AAAA,IACpD,eAAe;AAAA,IACf,iBACE,oBACC,MAAM;AACL,kBAAY,SAAS,UAAU,kBAAkB,EAAE;AACnD,iBAAW;AAAA,QACT,MAAM,wBAAwB;AAAA,QAC9B,SAAS,EAAE,WAAW,OAAO,gBAAgB,KAAK;AAAA,MACpD,CAAC;AAAA,IACH;AAAA,EACJ,CAAC;AAED,oBAAkB,UAAU;AAE5B,SAAO,EAAE,IAAI,YAAY,kBAAkB,qBAAqB;AAClE;",
+  "names": []
+}

package/esm/forms/form/runtime/createFormRuntime.js

@@ -0,0 +1,332 @@
+import { getStratoLogger } from "../../../core/sdk/sdk-logger.js";
+import { routesTo } from "../../validation/message-routing.js";
+import {
+  ValidationError
+} from "../../validation/types.js";
+import { FormValidationError } from "../form-error-classes.js";
+function compareOrdinal(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+function errorIdentity(error) {
+  const target = Array.isArray(error.formControlId) ? [...error.formControlId].sort(compareOrdinal).join(",") : error.formControlId ?? "";
+  const formId = error instanceof FormValidationError ? error.formId : "";
+  return `${error.validityStateKey.toString()}|${target}|${formId}`;
+}
+function errorSignature(error) {
+  return `${errorIdentity(error)}|${error.message}`;
+}
+function errorSetSignature(errors) {
+  return errors.map(errorSignature).sort(compareOrdinal).join("\0");
+}
+function stateIsPending(state) {
+  return state.status === "pending";
+}
+const SOURCE_PRIORITY = {
+  custom: 0,
+  strato: 1,
+  native: 2
+};
+function createFormRuntime(getConfig) {
+  const config = { validators: [] };
+  const controls = /* @__PURE__ */ new Map();
+  const fieldStates = /* @__PURE__ */ new Map();
+  let manualErrors = [];
+  let formValidatorErrors = [];
+  let isSubmitted = false;
+  let activeValidationRuns = 0;
+  let validationRunId = 0;
+  let readConfig = getConfig ?? (() => config);
+  const listeners = /* @__PURE__ */ new Set();
+  const warnedDuplicateNames = /* @__PURE__ */ new Set();
+  let formMessagesCache = [];
+  let formMessagesSignature = "";
+  const fieldMessagesCache = /* @__PURE__ */ new Map();
+  let lastValiditySignature;
+  function notify() {
+    for (const listener of listeners) {
+      listener();
+    }
+  }
+  function hasPendingFields() {
+    return [...fieldStates.values()].some(stateIsPending);
+  }
+  function isPending() {
+    return activeValidationRuns > 0 || hasPendingFields();
+  }
+  function aggregateErrors() {
+    const seen = /* @__PURE__ */ new Set();
+    const result = [];
+    const push = (error) => {
+      const signature = errorSignature(error);
+      if (!seen.has(signature)) {
+        seen.add(signature);
+        result.push(error);
+      }
+    };
+    for (const state of fieldStates.values()) {
+      state.errors.forEach(push);
+    }
+    formValidatorErrors.forEach(push);
+    manualErrors.forEach(push);
+    return result;
+  }
+  function errorsForField(controlId) {
+    const matched = aggregateErrors().filter(
+      (error) => matchesTarget(error, controlId) && routesTo(error, "field")
+    );
+    return [...matched].sort(
+      (a, b) => SOURCE_PRIORITY[a.source] - SOURCE_PRIORITY[b.source]
+    );
+  }
+  function buildStatus() {
+    const errors = aggregateErrors();
+    return {
+      isValid: errors.length === 0,
+      isPending: isPending(),
+      isSubmitted,
+      errors
+    };
+  }
+  function buildSnapshot() {
+    const values = {};
+    const fields = {};
+    for (const { control } of controls.values()) {
+      const key = control.name ?? control.id;
+      if (Object.hasOwn(values, key) && !warnedDuplicateNames.has(key)) {
+        warnedDuplicateNames.add(key);
+        getStratoLogger("Form").warn(
+          `Multiple form controls share the name "${key}"; only the last value is kept in the form snapshot.`
+        );
+      }
+      values[key] = control.getValue();
+      const fieldErrors = errorsForField(control.id);
+      fields[control.id] = {
+        isValid: fieldErrors.length === 0,
+        isTouched: fieldStates.has(control.id),
+        errors: fieldErrors
+      };
+    }
+    return {
+      values,
+      fields
+    };
+  }
+  function emitValidityChange(trigger) {
+    const errors = aggregateErrors();
+    const signature = `${errors.length === 0 ? "valid" : "invalid"}|${isPending() ? "pending" : "done"}|${errorSetSignature(errors)}`;
+    if (signature === lastValiditySignature) {
+      return;
+    }
+    lastValiditySignature = signature;
+    readConfig().onValidityChange?.({
+      status: isPending() ? "pending" : "done",
+      trigger,
+      errors
+    });
+  }
+  async function runValidation(trigger, reveal) {
+    const runId = ++validationRunId;
+    const runControls = [...controls.values()];
+    activeValidationRuns += 1;
+    emitValidityChange(trigger);
+    notify();
+    try {
+      const results = await Promise.all(
+        runControls.map(async ({ control, token }) => {
+          const state = await control.validateField({ reveal, trigger });
+          return { id: control.id, token, state };
+        })
+      );
+      if (runId === validationRunId) {
+        for (const { id, token, state } of results) {
+          if (controls.get(id)?.token === token) {
+            fieldStates.set(id, state);
+          }
+        }
+      }
+      const snapshot = buildSnapshot();
+      const validatorResults = await Promise.all(
+        readConfig().validators.map(
+          (validator) => runFormValidator(validator, snapshot.values, readConfig().formId)
+        )
+      );
+      if (runId === validationRunId) {
+        formValidatorErrors = validatorResults.flat().map(
+          (error) => error.source === "custom" ? error : cloneWithCustomSource(error)
+        );
+      }
+    } finally {
+      activeValidationRuns -= 1;
+      emitValidityChange(trigger);
+      notify();
+    }
+    return buildStatus();
+  }
+  const api = {
+    getStatus: buildStatus,
+    getSnapshot: buildSnapshot,
+    validate: () => runValidation("manual", true),
+    submit: async () => {
+      isSubmitted = true;
+      const status = await runValidation("submit", true);
+      if (!status.isValid) {
+        focusFirstInvalid(controls, status.errors);
+        readConfig().onInvalid?.({
+          snapshot: buildSnapshot(),
+          status,
+          form: api
+        });
+      } else {
+        readConfig().onSubmit?.({ snapshot: buildSnapshot(), form: api });
+      }
+      notify();
+      return buildStatus();
+    },
+    resetValidation: () => {
+      validationRunId += 1;
+      activeValidationRuns = 0;
+      manualErrors = [];
+      formValidatorErrors = [];
+      isSubmitted = false;
+      fieldStates.clear();
+      for (const { control } of controls.values()) {
+        control.resetValidation?.();
+      }
+      lastValiditySignature = void 0;
+      emitValidityChange("manual");
+      notify();
+    },
+    setError: (error) => {
+      const identity = errorIdentity(error);
+      manualErrors = [
+        ...manualErrors.filter(
+          (existing) => errorIdentity(existing) !== identity
+        ),
+        error
+      ];
+      emitValidityChange("manual");
+      notify();
+    },
+    clearError: (target, validityStateKey) => {
+      manualErrors = manualErrors.filter(
+        (error) => !matchesTarget(error, target, validityStateKey)
+      );
+      emitValidityChange("manual");
+      notify();
+    },
+    register: (control) => {
+      const token = Symbol(control.id);
+      controls.set(control.id, { control, token });
+      notify();
+      return {
+        reportValidity: (state) => {
+          if (controls.get(control.id)?.token !== token) {
+            return;
+          }
+          fieldStates.set(control.id, state);
+          emitValidityChange(state.trigger);
+          notify();
+        },
+        unregister: () => {
+          if (controls.get(control.id)?.token !== token) {
+            return;
+          }
+          controls.delete(control.id);
+          fieldStates.delete(control.id);
+          emitValidityChange("manual");
+          notify();
+        }
+      };
+    },
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    // `FormMessages`/`FormFieldMessages` read these via `useSyncExternalStore`, which
+    // compares snapshots by reference. Return the cached array unless the error set's
+    // signature actually changed — a fresh array on every read forces a re-render and
+    // can loop.
+    getFormMessages: () => {
+      const current = aggregateErrors().filter(
+        (error) => error instanceof FormValidationError || routesTo(error, "form")
+      );
+      const signature = errorSetSignature(current);
+      if (signature !== formMessagesSignature) {
+        formMessagesSignature = signature;
+        formMessagesCache = current;
+      }
+      return formMessagesCache;
+    },
+    getFieldMessages: (controlId) => {
+      const current = errorsForField(controlId);
+      const signature = errorSetSignature(current);
+      const cached = fieldMessagesCache.get(controlId);
+      if (cached?.signature === signature) {
+        return cached.messages;
+      }
+      fieldMessagesCache.set(controlId, { signature, messages: current });
+      return current;
+    },
+    _bindConfig: (fn) => {
+      readConfig = fn ?? (() => config);
+    }
+  };
+  return api;
+}
+async function runFormValidator(validator, values, formId) {
+  try {
+    return await validator({ values });
+  } catch (cause) {
+    if (formId !== void 0) {
+      return [
+        new FormValidationError("Validation failed.", {
+          formId,
+          cause
+        })
+      ];
+    }
+    return [
+      new ValidationError("Validation failed.", { source: "custom", cause })
+    ];
+  }
+}
+function cloneWithCustomSource(error) {
+  if (error instanceof FormValidationError) {
+    return new FormValidationError(error.message, {
+      formId: error.formId,
+      validityStateKey: error.validityStateKey,
+      formControlId: error.formControlId,
+      cause: error.cause
+    });
+  }
+  return new ValidationError(error.message, {
+    source: "custom",
+    validityStateKey: error.validityStateKey,
+    formControlId: error.formControlId,
+    cause: error.cause
+  });
+}
+function matchesTarget(error, target, validityStateKey) {
+  const routedTo = error instanceof FormValidationError ? error.formId === target : Array.isArray(error.formControlId) ? error.formControlId.includes(target) : error.formControlId === target;
+  if (!routedTo) {
+    return false;
+  }
+  return validityStateKey === void 0 || error.validityStateKey.equals(validityStateKey);
+}
+function focusFirstInvalid(controls, errors) {
+  const invalidIds = new Set(
+    errors.flatMap(
+      (error) => error.formControlId === void 0 ? [] : Array.isArray(error.formControlId) ? error.formControlId : [error.formControlId]
+    )
+  );
+  for (const { control } of controls.values()) {
+    if (invalidIds.has(control.id)) {
+      control.focus();
+      return;
+    }
+  }
+}
+export {
+  createFormRuntime
+};
+//# sourceMappingURL=createFormRuntime.js.map

package/esm/forms/form/runtime/createFormRuntime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/forms/form/runtime/createFormRuntime.ts"],
+  "sourcesContent": ["import { getStratoLogger } from '../../../core/sdk/sdk-logger.js';\nimport { routesTo } from '../../validation/message-routing.js';\nimport {\n  ValidationError,\n  type ValidationErrorSource,\n  type ValidationState,\n  type ValidationTrigger,\n  type ValidityStateKey,\n} from '../../validation/types.js';\nimport { FormValidationError } from '../form-error-classes.js';\nimport type {\n  ControlRegistrationHandle,\n  FormApi,\n  FormSnapshot,\n  FormStatus,\n  FormValidator,\n  RegisteredControl,\n} from '../form.types.js';\n\n/**\n * Mutable config the `<Form>` component feeds into the runtime on every render.\n * @internal\n */\nexport interface FormRuntimeConfig<TValues = Record<string, unknown>> {\n  formId?: string;\n  validators: FormValidator<TValues>[];\n  onSubmit?: (context: {\n    snapshot: FormSnapshot<TValues>;\n    form: FormApi<TValues>;\n  }) => void;\n  onInvalid?: (context: {\n    snapshot: FormSnapshot<TValues>;\n    status: FormStatus;\n    form: FormApi<TValues>;\n  }) => void;\n  onValidityChange?: (state: ValidationState) => void;\n}\n\n/**\n * The full runtime surface: the public {@link FormApi} plus the internal hooks\n * the `<Form>` component and registered controls use.\n * @internal\n */\nexport interface FormRuntime<TValues = Record<string, unknown>>\n  extends FormApi<TValues> {\n  /** Registers a control and returns its imperative handle. */\n  register: (control: RegisteredControl) => ControlRegistrationHandle;\n  /** Subscribes to any runtime change (for `useSyncExternalStore`). */\n  subscribe: (listener: () => void) => () => void;\n  /** The form-wide errors currently rendered by `<FormMessages>`. */\n  getFormMessages: () => ValidationError[];\n  /** Runtime-owned field errors rendered by `FormFieldMessages`. */\n  getFieldMessages: (controlId: string) => ValidationError[];\n  /**\n   * Replaces the config getter that the runtime calls on each submit/validate.\n   * Called by `<Form>` when an external runtime is supplied via the `form` prop.\n   * Pass `undefined` to revert to the no-op default (e.g. on unmount).\n   * @internal\n   */\n  _bindConfig?: (fn: (() => FormRuntimeConfig<TValues>) | undefined) => void;\n}\n\ntype RegisteredEntry = {\n  control: RegisteredControl;\n  token: symbol;\n};\n\n// Ordinal comparator for building canonical, environment-independent dedup and\n// signature keys. `localeCompare` is locale/ICU-dependent, so it could order\n// non-ASCII ids differently across machines \u2014 these keys must be deterministic.\nfunction compareOrdinal(a: string, b: string): number {\n  return a < b ? -1 : a > b ? 1 : 0;\n}\n\nfunction errorIdentity(error: ValidationError): string {\n  const target = Array.isArray(error.formControlId)\n    ? [...error.formControlId].sort(compareOrdinal).join(',')\n    : error.formControlId ?? '';\n  const formId = error instanceof FormValidationError ? error.formId : '';\n  return `${error.validityStateKey.toString()}|${target}|${formId}`;\n}\n\nfunction errorSignature(error: ValidationError): string {\n  return `${errorIdentity(error)}|${error.message}`;\n}\n\nfunction errorSetSignature(errors: ValidationError[]): string {\n  return errors.map(errorSignature).sort(compareOrdinal).join('\\u0000');\n}\n\nfunction stateIsPending(state: ValidationState): boolean {\n  return state.status === 'pending';\n}\n\nconst SOURCE_PRIORITY: Record<ValidationErrorSource, number> = {\n  custom: 0,\n  strato: 1,\n  native: 2,\n};\n\nexport function createFormRuntime<TValues = Record<string, unknown>>(\n  getConfig?: () => FormRuntimeConfig<TValues>,\n): FormRuntime<TValues> {\n  const config: FormRuntimeConfig<TValues> = { validators: [] };\n  const controls = new Map<string, RegisteredEntry>();\n  const fieldStates = new Map<string, ValidationState>();\n  let manualErrors: ValidationError[] = [];\n  let formValidatorErrors: ValidationError[] = [];\n  let isSubmitted = false;\n  let activeValidationRuns = 0;\n  let validationRunId = 0;\n\n  let readConfig = getConfig ?? (() => config);\n  const listeners = new Set<() => void>();\n  const warnedDuplicateNames = new Set<string>();\n\n  let formMessagesCache: ValidationError[] = [];\n  let formMessagesSignature = '';\n  const fieldMessagesCache = new Map<\n    string,\n    { signature: string; messages: ValidationError[] }\n  >();\n  let lastValiditySignature: string | undefined;\n\n  function notify() {\n    for (const listener of listeners) {\n      listener();\n    }\n  }\n\n  function hasPendingFields(): boolean {\n    return [...fieldStates.values()].some(stateIsPending);\n  }\n\n  function isPending(): boolean {\n    return activeValidationRuns > 0 || hasPendingFields();\n  }\n\n  function aggregateErrors(): ValidationError[] {\n    const seen = new Set<string>();\n    const result: ValidationError[] = [];\n    const push = (error: ValidationError) => {\n      const signature = errorSignature(error);\n      if (!seen.has(signature)) {\n        seen.add(signature);\n        result.push(error);\n      }\n    };\n    for (const state of fieldStates.values()) {\n      state.errors.forEach(push);\n    }\n    formValidatorErrors.forEach(push);\n    manualErrors.forEach(push);\n    return result;\n  }\n\n  function errorsForField(controlId: string): ValidationError[] {\n    const matched = aggregateErrors().filter(\n      (error) => matchesTarget(error, controlId) && routesTo(error, 'field'),\n    );\n    // So a consumer that renders only errors[0] gets a deterministic result.\n    // Sort is stable, so two errors of the same source keep their relative order.\n    return [...matched].sort(\n      (a, b) => SOURCE_PRIORITY[a.source] - SOURCE_PRIORITY[b.source],\n    );\n  }\n\n  function buildStatus(): FormStatus {\n    const errors = aggregateErrors();\n    return {\n      isValid: errors.length === 0,\n      isPending: isPending(),\n      isSubmitted,\n      errors,\n    };\n  }\n\n  function buildSnapshot(): FormSnapshot<TValues> {\n    const values: Record<string, unknown> = {};\n    const fields: FormSnapshot['fields'] = {};\n    for (const { control } of controls.values()) {\n      const key = control.name ?? control.id;\n      if (Object.hasOwn(values, key) && !warnedDuplicateNames.has(key)) {\n        warnedDuplicateNames.add(key);\n        getStratoLogger('Form').warn(\n          `Multiple form controls share the name \"${key}\"; only the last value is kept in the form snapshot.`,\n        );\n      }\n      values[key] = control.getValue();\n      const fieldErrors = errorsForField(control.id);\n      fields[control.id] = {\n        isValid: fieldErrors.length === 0,\n        isTouched: fieldStates.has(control.id),\n        errors: fieldErrors,\n      };\n    }\n    return {\n      values: values as TValues,\n      fields,\n    };\n  }\n\n  function emitValidityChange(trigger: ValidationTrigger) {\n    const errors = aggregateErrors();\n    const signature = `${errors.length === 0 ? 'valid' : 'invalid'}|${\n      isPending() ? 'pending' : 'done'\n    }|${errorSetSignature(errors)}`;\n    // The runtime notifies liberally \u2014 it emits on the way into and out of every\n    // validation run and on every mutation. Collapse to a signature so\n    // `onValidityChange` fires only on real transitions, not identical recomputations.\n    if (signature === lastValiditySignature) {\n      return;\n    }\n    lastValiditySignature = signature;\n    readConfig().onValidityChange?.({\n      status: isPending() ? 'pending' : 'done',\n      trigger,\n      errors,\n    });\n  }\n\n  async function runValidation(\n    trigger: ValidationTrigger,\n    reveal: boolean,\n  ): Promise<FormStatus> {\n    const runId = ++validationRunId;\n    const runControls = [...controls.values()];\n    activeValidationRuns += 1;\n    emitValidityChange(trigger);\n    notify();\n\n    try {\n      const results = await Promise.all(\n        runControls.map(async ({ control, token }) => {\n          const state = await control.validateField({ reveal, trigger });\n          return { id: control.id, token, state };\n        }),\n      );\n\n      if (runId === validationRunId) {\n        for (const { id, token, state } of results) {\n          if (controls.get(id)?.token === token) {\n            fieldStates.set(id, state);\n          }\n        }\n      }\n\n      const snapshot = buildSnapshot();\n      const validatorResults = await Promise.all(\n        readConfig().validators.map((validator) =>\n          runFormValidator(validator, snapshot.values, readConfig().formId),\n        ),\n      );\n\n      if (runId === validationRunId) {\n        formValidatorErrors = validatorResults\n          .flat()\n          .map((error) =>\n            error.source === 'custom' ? error : cloneWithCustomSource(error),\n          );\n      }\n    } finally {\n      activeValidationRuns -= 1;\n      emitValidityChange(trigger);\n      notify();\n    }\n\n    return buildStatus();\n  }\n\n  const api: FormRuntime<TValues> = {\n    getStatus: buildStatus,\n    getSnapshot: buildSnapshot,\n\n    validate: () => runValidation('manual', true),\n\n    submit: async () => {\n      isSubmitted = true;\n      // Consumer-set errors (`setError`) persist across submits; only the\n      // consumer clears them via `clearError` / `resetValidation`. This keeps a\n      // server-side error visible on retry until the consumer removes it.\n      const status = await runValidation('submit', true);\n\n      if (!status.isValid) {\n        focusFirstInvalid(controls, status.errors);\n        readConfig().onInvalid?.({\n          snapshot: buildSnapshot(),\n          status,\n          form: api,\n        });\n      } else {\n        readConfig().onSubmit?.({ snapshot: buildSnapshot(), form: api });\n      }\n      notify();\n      return buildStatus();\n    },\n\n    resetValidation: () => {\n      validationRunId += 1;\n      activeValidationRuns = 0;\n      manualErrors = [];\n      formValidatorErrors = [];\n      isSubmitted = false;\n      fieldStates.clear();\n      for (const { control } of controls.values()) {\n        control.resetValidation?.();\n      }\n      lastValiditySignature = undefined;\n      emitValidityChange('manual');\n      notify();\n    },\n\n    setError: (error) => {\n      const identity = errorIdentity(error);\n      manualErrors = [\n        ...manualErrors.filter(\n          (existing) => errorIdentity(existing) !== identity,\n        ),\n        error,\n      ];\n      emitValidityChange('manual');\n      notify();\n    },\n\n    clearError: (target, validityStateKey) => {\n      manualErrors = manualErrors.filter(\n        (error) => !matchesTarget(error, target, validityStateKey),\n      );\n      emitValidityChange('manual');\n      notify();\n    },\n\n    register: (control) => {\n      // Per-registration token. A control id can be re-registered (remount, or a\n      // duplicate id). Every handle captures its token and no-ops if the live entry's\n      // token differs, so a stale handle's async report/unregister can't clobber the\n      // current registration.\n      const token = Symbol(control.id);\n      controls.set(control.id, { control, token });\n      notify();\n      return {\n        reportValidity: (state) => {\n          if (controls.get(control.id)?.token !== token) {\n            return;\n          }\n          fieldStates.set(control.id, state);\n          emitValidityChange(state.trigger);\n          notify();\n        },\n        unregister: () => {\n          if (controls.get(control.id)?.token !== token) {\n            return;\n          }\n          controls.delete(control.id);\n          fieldStates.delete(control.id);\n          emitValidityChange('manual');\n          notify();\n        },\n      };\n    },\n\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n\n    // `FormMessages`/`FormFieldMessages` read these via `useSyncExternalStore`, which\n    // compares snapshots by reference. Return the cached array unless the error set's\n    // signature actually changed \u2014 a fresh array on every read forces a re-render and\n    // can loop.\n    getFormMessages: () => {\n      // Form-wide errors: the routing subclass, plus any control's native/Strato\n      // error explicitly routed to the form outlet via `_messageTarget`.\n      const current = aggregateErrors().filter(\n        (error) =>\n          error instanceof FormValidationError || routesTo(error, 'form'),\n      );\n      const signature = errorSetSignature(current);\n      if (signature !== formMessagesSignature) {\n        formMessagesSignature = signature;\n        formMessagesCache = current;\n      }\n      return formMessagesCache;\n    },\n\n    getFieldMessages: (controlId) => {\n      const current = errorsForField(controlId);\n      const signature = errorSetSignature(current);\n      const cached = fieldMessagesCache.get(controlId);\n      if (cached?.signature === signature) {\n        return cached.messages;\n      }\n      fieldMessagesCache.set(controlId, { signature, messages: current });\n      return current;\n    },\n\n    _bindConfig: (fn) => {\n      readConfig = fn ?? (() => config);\n    },\n  };\n\n  return api;\n}\n\nasync function runFormValidator<TValues>(\n  validator: FormValidator<TValues>,\n  values: TValues,\n  formId: string | undefined,\n): Promise<ValidationError[]> {\n  try {\n    return await validator({ values });\n  } catch (cause) {\n    if (formId !== undefined) {\n      return [\n        new FormValidationError('Validation failed.', {\n          formId,\n          cause,\n        }),\n      ];\n    }\n    return [\n      new ValidationError('Validation failed.', { source: 'custom', cause }),\n    ];\n  }\n}\n\nfunction cloneWithCustomSource(error: ValidationError): ValidationError {\n  if (error instanceof FormValidationError) {\n    return new FormValidationError(error.message, {\n      formId: error.formId,\n      validityStateKey: error.validityStateKey,\n      formControlId: error.formControlId,\n      cause: error.cause,\n    });\n  }\n  return new ValidationError(error.message, {\n    source: 'custom',\n    validityStateKey: error.validityStateKey,\n    formControlId: error.formControlId,\n    cause: error.cause,\n  });\n}\n\nfunction matchesTarget(\n  error: ValidationError,\n  target: string,\n  validityStateKey?: ValidityStateKey,\n): boolean {\n  const routedTo =\n    error instanceof FormValidationError\n      ? error.formId === target\n      : Array.isArray(error.formControlId)\n      ? error.formControlId.includes(target)\n      : error.formControlId === target;\n  if (!routedTo) {\n    return false;\n  }\n  return (\n    validityStateKey === undefined ||\n    error.validityStateKey.equals(validityStateKey)\n  );\n}\n\nfunction focusFirstInvalid(\n  controls: Map<string, RegisteredEntry>,\n  errors: ValidationError[],\n) {\n  const invalidIds = new Set(\n    errors.flatMap((error) =>\n      error.formControlId === undefined\n        ? []\n        : Array.isArray(error.formControlId)\n        ? error.formControlId\n        : [error.formControlId],\n    ),\n  );\n  for (const { control } of controls.values()) {\n    if (invalidIds.has(control.id)) {\n      control.focus();\n      return;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/esm/forms/form/runtime/formRegistry.js

@@ -0,0 +1,47 @@
+import { getStratoLogger } from "../../../core/sdk/sdk-logger.js";
+const formsById = /* @__PURE__ */ new Map();
+const listenersById = /* @__PURE__ */ new Map();
+function notify(id) {
+  for (const listener of listenersById.get(id) ?? []) {
+    listener();
+  }
+}
+function registerFormById(id, runtime) {
+  const existing = formsById.get(id);
+  if (existing !== void 0 && existing !== runtime) {
+    getStratoLogger("Form").warn(
+      `Duplicate <Form id="${id}">. Form ids must be unique \u2014 controls and messages associated by id, and form-wide error routing, resolve to a single form. The previously registered form is being overwritten.`
+    );
+  }
+  formsById.set(id, runtime);
+  notify(id);
+  return () => {
+    if (formsById.get(id) === runtime) {
+      formsById.delete(id);
+      notify(id);
+    }
+  };
+}
+function getFormById(id) {
+  return formsById.get(id);
+}
+function subscribeToFormById(id, listener) {
+  let listeners = listenersById.get(id);
+  if (listeners === void 0) {
+    listeners = /* @__PURE__ */ new Set();
+    listenersById.set(id, listeners);
+  }
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+    if (listeners.size === 0) {
+      listenersById.delete(id);
+    }
+  };
+}
+export {
+  getFormById,
+  registerFormById,
+  subscribeToFormById
+};
+//# sourceMappingURL=formRegistry.js.map

package/esm/forms/form/runtime/formRegistry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/forms/form/runtime/formRegistry.ts"],
+  "sourcesContent": ["import type { FormRuntime } from './createFormRuntime.js';\nimport { getStratoLogger } from '../../../core/sdk/sdk-logger.js';\n\n/**\n * Module-level registry of `<Form>` runtimes keyed by their `id`. It lets a\n * control rendered OUTSIDE a `<Form>` subtree associate with it via the native\n * `form=\"formId\"` attribute \u2014 the same association the DOM offers, mirrored for\n * the runtime.\n *\n * The registry is observable: a control may render and look up its form before\n * the `<Form>` has registered (effect ordering across separate subtrees gives\n * no guarantee), so it subscribes and re-resolves once the form appears.\n * @internal\n */\nconst formsById = new Map<string, FormRuntime>();\nconst listenersById = new Map<string, Set<() => void>>();\n\nfunction notify(id: string) {\n  for (const listener of listenersById.get(id) ?? []) {\n    listener();\n  }\n}\n\n/** Registers a runtime under `id`; returns an unregister callback. @internal */\nexport function registerFormById(id: string, runtime: FormRuntime): () => void {\n  const existing = formsById.get(id);\n  if (existing !== undefined && existing !== runtime) {\n    getStratoLogger('Form').warn(\n      `Duplicate <Form id=\"${id}\">. Form ids must be unique \u2014 controls and messages associated by id, and form-wide error routing, resolve to a single form. The previously registered form is being overwritten.`,\n    );\n  }\n  formsById.set(id, runtime);\n  notify(id);\n  return () => {\n    if (formsById.get(id) === runtime) {\n      formsById.delete(id);\n      notify(id);\n    }\n  };\n}\n\n/** Looks up a runtime registered under `id`. @internal */\nexport function getFormById(id: string): FormRuntime | undefined {\n  return formsById.get(id);\n}\n\n/**\n * Subscribes to registration changes for `id`; the listener fires whenever a\n * form registers or unregisters under it. @internal\n */\nexport function subscribeToFormById(\n  id: string,\n  listener: () => void,\n): () => void {\n  let listeners = listenersById.get(id);\n  if (listeners === undefined) {\n    listeners = new Set();\n    listenersById.set(id, listeners);\n  }\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n    // Drop the per-id bucket once its last listener leaves, so ids churned by\n    // forms/controls mounting and unmounting don't leak empty Sets in the module map.\n    if (listeners.size === 0) {\n      listenersById.delete(id);\n    }\n  };\n}\n"],
+  "mappings": "AACA,SAAS,uBAAuB;AAahC,MAAM,YAAY,oBAAI,IAAyB;AAC/C,MAAM,gBAAgB,oBAAI,IAA6B;AAEvD,SAAS,OAAO,IAAY;AAC1B,aAAW,YAAY,cAAc,IAAI,EAAE,KAAK,CAAC,GAAG;AAClD,aAAS;AAAA,EACX;AACF;AAGO,SAAS,iBAAiB,IAAY,SAAkC;AAC7E,QAAM,WAAW,UAAU,IAAI,EAAE;AACjC,MAAI,aAAa,UAAa,aAAa,SAAS;AAClD,oBAAgB,MAAM,EAAE;AAAA,MACtB,uBAAuB,EAAE;AAAA,IAC3B;AAAA,EACF;AACA,YAAU,IAAI,IAAI,OAAO;AACzB,SAAO,EAAE;AACT,SAAO,MAAM;AACX,QAAI,UAAU,IAAI,EAAE,MAAM,SAAS;AACjC,gBAAU,OAAO,EAAE;AACnB,aAAO,EAAE;AAAA,IACX;AAAA,EACF;AACF;AAGO,SAAS,YAAY,IAAqC;AAC/D,SAAO,UAAU,IAAI,EAAE;AACzB;AAMO,SAAS,oBACd,IACA,UACY;AACZ,MAAI,YAAY,cAAc,IAAI,EAAE;AACpC,MAAI,cAAc,QAAW;AAC3B,gBAAY,oBAAI,IAAI;AACpB,kBAAc,IAAI,IAAI,SAAS;AAAA,EACjC;AACA,YAAU,IAAI,QAAQ;AACtB,SAAO,MAAM;AACX,cAAU,OAAO,QAAQ;AAGzB,QAAI,UAAU,SAAS,GAAG;AACxB,oBAAc,OAAO,EAAE;AAAA,IACzB;AAAA,EACF;AACF;",
+  "names": []
+}

package/esm/forms/forms-core/components/field-set/FieldSet.css

@@ -1,4 +1,4 @@
-._1dphm0f0-3-9-0 {
+._1dphm0f0-3-10-0 {
   appearance: none;
   margin: 0;
   border: none;
@@ -6,7 +6,7 @@
   min-width: 0;
   min-height: 0;
 }
-._1dphm0f1-3-9-0 {
+._1dphm0f1-3-10-0 {
   padding: 0;
   appearance: none;
   margin-bottom: var(--dt-spacings-size-12, 12px);

package/esm/forms/forms-core/components/field-set/FieldSet.sty.js

@@ -1,6 +1,6 @@
 import "./FieldSet.css";
-var fieldset = "_1dphm0f0-3-9-0";
-var legend = "_1dphm0f1-3-9-0";
+var fieldset = "_1dphm0f0-3-10-0";
+var legend = "_1dphm0f1-3-10-0";
 export {
   fieldset,
   legend

package/esm/forms/forms-core/components/field-set/FieldSet.sty.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/forms/forms-core/components/field-set/FieldSet.css.ts"],
-  "sourcesContent": ["import './FieldSet.css';\nexport var fieldset = '_1dphm0f0-3-9-0';\nexport var legend = '_1dphm0f1-3-9-0';"],
+  "sourcesContent": ["import './FieldSet.css';\nexport var fieldset = '_1dphm0f0-3-10-0';\nexport var legend = '_1dphm0f1-3-10-0';"],
   "mappings": "AAAA,OAAO;AACA,IAAI,WAAW;AACf,IAAI,SAAS;",
   "names": []
 }

package/esm/forms/forms-core/components/form-field/FormField.sty.js

@@ -1,5 +1,5 @@
 import "./FormField.css";
-var formField = "_mvcxum0-3-9-0";
+var formField = "_mvcxum0-3-10-0";
 export {
   formField
 };

package/esm/forms/forms-core/components/form-field/FormField.sty.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/forms/forms-core/components/form-field/FormField.css.ts"],
-  "sourcesContent": ["import './FormField.css';\nexport var formField = '_mvcxum0-3-9-0';"],
+  "sourcesContent": ["import './FormField.css';\nexport var formField = '_mvcxum0-3-10-0';"],
   "mappings": "AAAA,OAAO;AACA,IAAI,YAAY;",
   "names": []
 }