@embeddables/forms 0.0.4 → 0.0.5

package/dist/{form-CbU5ezg7.d.ts → index-qfBhdk5L.d.ts}

@@ -1,4 +1,27 @@
 import { EmbeddablesInstance } from "@embeddables/core";
+//#region src/errors.d.ts
+/**
+ * Typed error hierarchy. Every failure this SDK raises on its own behalf is an
+ * instance of one of these, so consumers branch on the type
+ * (`if (e instanceof SchemaError) …`) instead of string-matching messages.
+ * Catch `FormsError` to handle them all.
+ *
+ * An error thrown by a consumer's own custom validator is never wrapped in one
+ * of these — it propagates with its original type and stack.
+ */
+/** Base class for every error the SDK throws. */
+declare class FormsError extends Error {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** The schema is malformed. */
+declare class SchemaError extends FormsError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** A custom validator returned a thenable, or a shape that is not a message. */
+declare class ValidatorError extends FormsError {
+  constructor(message: string, options?: ErrorOptions);
+}
+//#endregion
 //#region ../shared-types/dist/json.types.d.ts
 /**
  * Recursive JSON value, compatible with JSONB column values and public
@@ -61,6 +84,15 @@ type ProtocolFieldId<TSchema extends FormSchema> = [TSchema] extends [FormSchema
   protocolFieldId: string;
 }>['protocolFieldId'];
 //#endregion
+//#region src/storage/storage.d.ts
+/** Every form on the origin shares this one entry, indexed by form ID. */
+declare const FORM_DATA_KEY = "EMBEDDABLES-FORM-DATA";
+interface FormsStorage {
+  getItem(key: string): string | null;
+  setItem(key: string, value: string): void;
+  removeItem(key: string): void;
+}
+//#endregion
 //#region ../shared-types/dist/analytics-instance.types.d.ts
 /**
  * Hono-free analytics client surface other SDKs accept without depending on
@@ -95,6 +127,47 @@ interface AnalyticsInstance<TEvent = AnalyticsTrackEvent> {
   getProjectId(): string;
 }
 //#endregion
+//#region ../shared-types/dist/analytics-ingest.types.d.ts
+type FieldUpdatedType = 'text' | 'email' | 'number' | 'boolean' | 'select' | 'multiselect' | 'json';
+/**
+ * Raw `field_value` accepted by ingest. Every forms-sdk `ValueOfFieldType` is a
+ * JSON value — scalar (`text`/`email`/`select` → string, `number` → number,
+ * `boolean` → boolean), `multiselect` → `string[]`, `json` → arbitrary JSON —
+ * so the contract collapses to `JsonValue`; the runtime ingest schema is what
+ * bounds each shape.
+ */
+type FieldUpdatedValue = JsonValue;
+type FunnelStepFields = {
+  is_funnel_step?: boolean;
+  funnel_step_label?: string;
+};
+type FieldUpdatedEvent = FunnelStepFields & {
+  event_name: 'field:updated';
+  /** Schema key of the updated field. */
+  field_key: string;
+  field_type: FieldUpdatedType;
+  field_value?: FieldUpdatedValue;
+  /** Field Registry identifier when the field is registry-backed. */
+  registry_field_id?: string;
+  /** Protocol question identifier when the field is protocol-backed. */
+  protocol_field_id?: string;
+};
+type DataUpdatedEntry = {
+  value: string;
+  label: string;
+};
+type DataUpdatedEvent = FunnelStepFields & {
+  event_name: 'data:updated';
+  data: Record<string, DataUpdatedEntry>;
+};
+type FormSubmittedEvent = FunnelStepFields & {
+  event_name: 'form:submitted';
+  form_key: string;
+};
+//#endregion
+//#region src/core/analytics.d.ts
+type FormsAnalyticsEvent = DataUpdatedEvent | FieldUpdatedEvent | FormSubmittedEvent;
+//#endregion
 //#region src/core/form.d.ts
 /** Per-key validation errors. An empty object means the operation succeeded. */
 type FieldErrors<TSchema extends FormSchema> = Readonly<Partial<Record<FormFieldKey<TSchema>, readonly string[]>>>;
@@ -192,5 +265,5 @@ interface FormsClient<TSchemas extends FormSchemaMap = FormSchemaMap> {
  */
 declare function initForms<const TSchemas extends FormSchemaMap>(options: InitFormsOptions<TSchemas>): FormsClient<TSchemas>;
 //#endregion
-export { JsonValue as S, FieldValidator as _, FormsClient as a, FormValues as b, SubmitResult as c, AnalyticsInstance as d, AnalyticsTrackEvent as f, FieldValidations as g, FieldType as h, FormSchemaMap as i, ValidateResult as l, FieldConfig as m, FieldErrors as n, InitFormsOptions as o, AnalyticsTrackResult as p, FormInstance as r, SetResult as s, CustomValidationsFor as t, initForms as u, FormFieldKey as v, ProtocolFieldId as x, FormSchema as y };
-//# sourceMappingURL=form-CbU5ezg7.d.ts.map
+export { FormsError as A, FieldValidations as C, FormValues as D, FormSchema as E, ValidatorError as M, ProtocolFieldId as O, FieldType as S, FormFieldKey as T, AnalyticsTrackEvent as _, FormsClient as a, FormsStorage as b, SubmitResult as c, FormsAnalyticsEvent as d, DataUpdatedEvent as f, AnalyticsInstance as g, FormSubmittedEvent as h, FormSchemaMap as i, SchemaError as j, JsonValue as k, ValidateResult as l, FieldUpdatedType as m, FieldErrors as n, InitFormsOptions as o, FieldUpdatedEvent as p, FormInstance as r, SetResult as s, CustomValidationsFor as t, initForms as u, AnalyticsTrackResult as v, FieldValidator as w, FieldConfig as x, FORM_DATA_KEY as y };
+//# sourceMappingURL=index-qfBhdk5L.d.ts.map

package/dist/index-qfBhdk5L.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-qfBhdk5L.d.ts","names":[],"sources":["../src/errors.ts","../../shared-types/dist/json.types.d.ts","../src/core/config.ts","../src/storage/storage.ts","../../shared-types/dist/analytics-instance.types.d.ts","../../shared-types/dist/analytics-ingest.types.d.ts","../src/core/analytics.ts","../src/core/form.ts"],"mappings":";;;;;;;;;;;;cAWa,mBAAmB;EAClB,YAAA,iBAAiB,UAAU;;;cAO5B,oBAAoB;EACnB,YAAA,iBAAiB,UAAU;;;cAO5B,uBAAuB;EACtB,YAAA,iBAAiB,UAAU;;;;;;;;KCxB7B,+CAA+C;GACtD,cAAc;;;;KCHP;;UAMF;EACR;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;;KAGI,eAAe,eAAe,YAAY,cAAc;EAClE,OAAO;EACP,QAAQ,SAAS,eAAe;;UAUxB,oBAAoB,cAAc;WACjC;WACA;WACA;WACA;WACA;;WAEA;;WAEA;WACA,iBAAiB;;WAEjB,SAAS,eAAe,iBAAiB;;UAG1C,eAAe,cAAc;WAC5B;WACA;WACA,MAAM;WACN,cAAc,oBAAoB;WAGlC;WACA;;KAUC,iBAAiB,KAAK,YAAY,eAAe,MAAK;KAEtD,sBAAsB,KAAK,YAAY,oBAAoB,MAAK;UAE3D;WACN;WACA;WACA,iBAAiB;;KAGvB,SAAS,gBAAgB,cAAc;KAEhC,aAAa,gBAAgB,cAAc,SAAS;KAEpD,WAAW,gBAAgB,iBACpC,KAAK,SAAS,YAAY,WAAW,iBAAiB;;KAI7C,gBAAgB,gBAAgB,eAAe,kBAAkB,uBAEzE,QAAQ,SAAS;EAAY;;;;;cC/EpB;UAEI;EACf,QAAQ;EACR,QAAQ,aAAa;EACrB,WAAW;;;;;;;;;;;;;;;UCCI;EACb;GACC;;;UAGY;EACb;EACA;EACA;;;;;;;UAOa,kBAAkB,SAAS;EACxC,WAAW,OAAO,kBAAkB,WAAW,QAAQ;;EAEvD;EACA;;;;KCxBQ;;;;;;;;KAQA,oBAAoB;KACpB;EACR;EACA;;KAsBQ,oBAAoB;EAC5B;;EAEA;EACA,YAAY;EACZ,cAAc;;EAEd;;EAEA;;KAEQ;EACR;EACA;;KAEQ,mBAAmB;EAC3B;EACA,MAAM,eAAe;;KAMb,qBAAqB;EAC7B;EACA;;;;KCpCQ,sBAAsB,mBAAmB,oBAAoB;;;;KCE7D,YAAY,gBAAgB,cAAc,SACpD,QAAQ,OAAO,aAAa;UAGb,UAAU,gBAAgB;EACzC;EACA,QAAQ,YAAY;;EAEpB;;UAGe,aAAa,gBAAgB;EAC5C;EACA,QAAQ,YAAY;EACpB,QAAQ,QAAQ,WAAW;EAC3B;;UAGe,eAAe,gBAAgB;EAC9C;EACA,QAAQ,YAAY;EACpB,QAAQ,QAAQ,WAAW;;UAGZ,aAAa,gBAAgB;WACnC,KAAK;;;;;;;EAOd,IAAI,OAAO,QAAQ,WAAW,YAAY,QAAQ,UAAU;;EAE5D,IAAI,UAAU,aAAa,UAAU,KAAK,IAAI,WAAW,SAAS;;;;;;EAMlE,0BAA0B,UAAU,gBAAgB,UAClD,iBAAiB,IAEf,WAAW,SAAS,QAAQ;IAA6B,iBAAiB;;EAE9E,UAAU,QAAQ,WAAW;;;;;;;;;EAS7B,UAAU,QAAQ,aAAa;;;;;;;;;;EAU/B,SAAS,QAAQ,QAAQ,WAAW,YAAY,QAAQ,eAAe;EACvE,UAAU,YAAY;EACtB;;EAEA,UAAU;;;KA6CA,gBAAgB,SAAS,eAAe;KAExC,qBAAqB,gBAAgB,0BACrC,KAAK,aAAa,YAAY;UAOzB,iBAAiB,iBAAiB,gBAAgB;EACjE,MAAM;;EAEN,SAAS;EACT,oBAAoB;;UAGL,YAAY,iBAAiB,gBAAgB;;;;;;;;;;;;;EAa5D,QAAQ,gBAAgB,mBAAmB;IACzC,QAAQ;IACR,oBAAoB,qBAAqB,SAAS;MAChD,aAAa,SAAS;;;;;;iBAOZ,gBAAgB,iBAAiB,eAC/C,SAAS,iBAAiB,YACzB,YAAY"}

package/dist/index.d.ts

@@ -1,76 +1,2 @@
-import { S as JsonValue, _ as FieldValidator, a as FormsClient, b as FormValues, c as SubmitResult, d as AnalyticsInstance, f as AnalyticsTrackEvent, g as FieldValidations, h as FieldType, i as FormSchemaMap, l as ValidateResult, m as FieldConfig, n as FieldErrors, o as InitFormsOptions, p as AnalyticsTrackResult, r as FormInstance, s as SetResult, t as CustomValidationsFor, u as initForms, v as FormFieldKey, x as ProtocolFieldId, y as FormSchema } from "./form-CbU5ezg7.js";
-//#region src/errors.d.ts
-/**
- * Typed error hierarchy. Every failure this SDK raises on its own behalf is an
- * instance of one of these, so consumers branch on the type
- * (`if (e instanceof SchemaError) …`) instead of string-matching messages.
- * Catch `FormsError` to handle them all.
- *
- * An error thrown by a consumer's own custom validator is never wrapped in one
- * of these — it propagates with its original type and stack.
- */
-/** Base class for every error the SDK throws. */
-declare class FormsError extends Error {
-  constructor(message: string, options?: ErrorOptions);
-}
-/** The schema is malformed. */
-declare class SchemaError extends FormsError {
-  constructor(message: string, options?: ErrorOptions);
-}
-/** A custom validator returned a thenable, or a shape that is not a message. */
-declare class ValidatorError extends FormsError {
-  constructor(message: string, options?: ErrorOptions);
-}
-//#endregion
-//#region src/storage/storage.d.ts
-/** Every form on the origin shares this one entry, indexed by form ID. */
-declare const FORM_DATA_KEY = "EMBEDDABLES-FORM-DATA";
-interface FormsStorage {
-  getItem(key: string): string | null;
-  setItem(key: string, value: string): void;
-  removeItem(key: string): void;
-}
-//#endregion
-//#region ../shared-types/dist/analytics-ingest.types.d.ts
-type FieldUpdatedType = 'text' | 'email' | 'number' | 'boolean' | 'select' | 'multiselect' | 'json';
-/**
- * Raw `field_value` accepted by ingest. Every forms-sdk `ValueOfFieldType` is a
- * JSON value — scalar (`text`/`email`/`select` → string, `number` → number,
- * `boolean` → boolean), `multiselect` → `string[]`, `json` → arbitrary JSON —
- * so the contract collapses to `JsonValue`; the runtime ingest schema is what
- * bounds each shape.
- */
-type FieldUpdatedValue = JsonValue;
-type FunnelStepFields = {
-  is_funnel_step?: boolean;
-  funnel_step_label?: string;
-};
-type FieldUpdatedEvent = FunnelStepFields & {
-  event_name: 'field:updated';
-  /** Schema key of the updated field. */
-  field_key: string;
-  field_type: FieldUpdatedType;
-  field_value?: FieldUpdatedValue;
-  /** Field Registry identifier when the field is registry-backed. */
-  registry_field_id?: string;
-  /** Protocol question identifier when the field is protocol-backed. */
-  protocol_field_id?: string;
-};
-type DataUpdatedEntry = {
-  value: string;
-  label: string;
-};
-type DataUpdatedEvent = FunnelStepFields & {
-  event_name: 'data:updated';
-  data: Record<string, DataUpdatedEntry>;
-};
-type FormSubmittedEvent = FunnelStepFields & {
-  event_name: 'form:submitted';
-  form_key: string;
-};
-//#endregion
-//#region src/core/analytics.d.ts
-type FormsAnalyticsEvent = DataUpdatedEvent | FieldUpdatedEvent | FormSubmittedEvent;
-//#endregion
-export { type AnalyticsInstance, type AnalyticsTrackEvent, type AnalyticsTrackResult, type CustomValidationsFor, type DataUpdatedEvent, FORM_DATA_KEY, type FieldConfig, type FieldErrors, type FieldType, type FieldUpdatedEvent, type FieldUpdatedType, type FieldValidations, type FieldValidator, type FormFieldKey, type FormInstance, type FormSchema, type FormSchemaMap, type FormSubmittedEvent, type FormValues, type FormsAnalyticsEvent, type FormsClient, FormsError, type FormsStorage, type InitFormsOptions, type JsonValue, type ProtocolFieldId, SchemaError, type SetResult, type SubmitResult, type ValidateResult, ValidatorError, initForms };
-//# sourceMappingURL=index.d.ts.map
+import { A as FormsError, C as FieldValidations, D as FormValues, E as FormSchema, M as ValidatorError, O as ProtocolFieldId, S as FieldType, T as FormFieldKey, _ as AnalyticsTrackEvent, a as FormsClient, b as FormsStorage, c as SubmitResult, d as FormsAnalyticsEvent, f as DataUpdatedEvent, g as AnalyticsInstance, h as FormSubmittedEvent, i as FormSchemaMap, j as SchemaError, k as JsonValue, l as ValidateResult, m as FieldUpdatedType, n as FieldErrors, o as InitFormsOptions, p as FieldUpdatedEvent, r as FormInstance, s as SetResult, t as CustomValidationsFor, u as initForms, v as AnalyticsTrackResult, w as FieldValidator, x as FieldConfig, y as FORM_DATA_KEY } from "./index-qfBhdk5L.js";
+export { type AnalyticsInstance, type AnalyticsTrackEvent, type AnalyticsTrackResult, type CustomValidationsFor, type DataUpdatedEvent, FORM_DATA_KEY, type FieldConfig, type FieldErrors, type FieldType, type FieldUpdatedEvent, type FieldUpdatedType, type FieldValidations, type FieldValidator, type FormFieldKey, type FormInstance, type FormSchema, type FormSchemaMap, type FormSubmittedEvent, type FormValues, type FormsAnalyticsEvent, type FormsClient, FormsError, type FormsStorage, type InitFormsOptions, type JsonValue, type ProtocolFieldId, SchemaError, type SetResult, type SubmitResult, type ValidateResult, ValidatorError, initForms };

package/dist/react.cjs

@@ -47,6 +47,9 @@ const FORMS_MODULE_KEY = "forms";
 * from provider context, not from here.
 */
 const formsByCore = /* @__PURE__ */ new WeakMap();
+function getRegisteredFormsClient(core) {
+	return formsByCore.get(core);
+}
 //#endregion
 //#region src/react/use-forms.ts
 /** @internal Product hooks read the module client from provider context. */
@@ -163,6 +166,7 @@ function forms(options) {
 }
 //#endregion
 exports.forms = forms;
+exports.getRegisteredFormsClient = getRegisteredFormsClient;
 exports.registerFormsClient = registerFormsClient;
 exports.useForm = useForm;
 exports.useFormErrors = useFormErrors;

package/dist/react.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"react.cjs","names":["useRef","useCallback","useSyncExternalStore","useEmbeddablesModule","useRef","useState","useCallback","initForms"],"sources":["../src/react/use-form-store.ts","../src/react/forms-registry.ts","../src/react/use-forms.ts","../src/react/use-form.ts","../src/react/use-form-errors.ts","../src/react/use-form-field.ts","../src/react/resolve-core-analytics.ts","../src/react/register-forms-client.ts","../src/react/forms-module.ts"],"sourcesContent":["import { useCallback, useRef, useSyncExternalStore } from 'react'\n\nimport type { FormSchema, FormValues } from '../core/config.js'\nimport type { FieldErrors, FormInstance } from '../core/form.js'\n\nexport type FormSnapshot<TSchema extends FormSchema> = Readonly<{\n  values: Partial<FormValues<TSchema>>\n  errors: FieldErrors<TSchema>\n}>\n\nconst EMPTY_SNAPSHOT: FormSnapshot<FormSchema> = Object.freeze({\n  values: {},\n  errors: {},\n})\n\nfunction createSnapshot<TSchema extends FormSchema>(\n  form: FormInstance<TSchema>,\n): FormSnapshot<TSchema> {\n  return Object.freeze({\n    values: form.getAll(),\n    errors: form.errors(),\n  })\n}\n\ninterface CachedSnapshot<TSchema extends FormSchema> {\n  readonly form: FormInstance<TSchema>\n  readonly snapshot: FormSnapshot<TSchema>\n}\n\nexport function useFormSnapshot<TSchema extends FormSchema>(\n  form: FormInstance<TSchema> | null,\n): FormSnapshot<TSchema> {\n  const cachedRef = useRef<CachedSnapshot<TSchema> | null>(null)\n  const emptyRef = useRef<FormSnapshot<TSchema>>(EMPTY_SNAPSHOT as FormSnapshot<TSchema>)\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      if (form === null) return () => undefined\n      return form.subscribe(() => {\n        cachedRef.current = { form, snapshot: createSnapshot(form) }\n        listener()\n      })\n    },\n    [form],\n  )\n\n  const getSnapshot = useCallback((): FormSnapshot<TSchema> => {\n    if (form === null) {\n      // * Otherwise a later A -> null -> mutate A -> A sequence would resurrect\n      // * a snapshot cached before the detach, missing the mutation in between.\n      cachedRef.current = null\n      return emptyRef.current\n    }\n    // * A cached snapshot from a previous form instance must not survive a\n    // * form change — recompute so switching forms without a mutation still\n    // * returns the new form's values and errors.\n    if (cachedRef.current === null || cachedRef.current.form !== form) {\n      cachedRef.current = { form, snapshot: createSnapshot(form) }\n    }\n    return cachedRef.current.snapshot\n  }, [form])\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n}\n","import type { FormSchemaMap, FormsClient } from '../core/form.js'\n\nexport const FORMS_MODULE_KEY = 'forms'\n\n/**\n * Idempotence guard for `registerFormsClient` only — React reads the client\n * from provider context, not from here.\n */\nexport const formsByCore = new WeakMap<object, FormsClient<FormSchemaMap>>()\n","import { useEmbeddablesModule } from '@embeddables/core/react'\n\nimport { FORMS_MODULE_KEY } from './forms-registry.js'\n\nimport type { FormSchemaMap, FormsClient, InitFormsOptions } from '../core/form.js'\n\nexport type FormsReactOptions<TSchemas extends FormSchemaMap = FormSchemaMap> = Omit<\n  InitFormsOptions<TSchemas>,\n  'core'\n>\n\n/** @internal Product hooks read the module client from provider context. */\nexport function useRegisteredFormsClient<\n  TSchemas extends FormSchemaMap = FormSchemaMap,\n>(): FormsClient<TSchemas> | null {\n  return useEmbeddablesModule<FormsClient<TSchemas>>({ key: FORMS_MODULE_KEY })\n}\n","import { useRef } from 'react'\n\nimport { useFormSnapshot } from './use-form-store.js'\nimport { useRegisteredFormsClient } from './use-forms.js'\n\nimport type { CustomValidationsFor, FormInstance, FormSchemaMap } from '../core/form.js'\nimport type { RegisteredSchemas } from './schema-registry.js'\n\n/**\n * Reactive binding for one declared form.\n *\n * Takes no type arguments: `TFormId` is inferred from `formId`, and the schema\n * map comes from the registry `em build` augments. Pass both explicitly\n * (`useForm<'signup', OtherSchemas>`) only to work against a map other than the\n * registered one.\n */\nexport function useForm<\n  TFormId extends keyof TSchemas & string,\n  TSchemas extends FormSchemaMap = RegisteredSchemas,\n>({\n  formId,\n  customValidations,\n}: {\n  formId: TFormId\n  customValidations?: CustomValidationsFor<TSchemas[TFormId]>\n}): {\n  form: FormInstance<TSchemas[TFormId]> | null\n  values: ReturnType<typeof useFormSnapshot<TSchemas[TFormId]>>['values']\n  errors: ReturnType<typeof useFormSnapshot<TSchemas[TFormId]>>['errors']\n} {\n  const client = useRegisteredFormsClient<TSchemas>()\n  // * Held in a ref because only the first call for a form id builds the\n  // * instance; a later render passing new validators must not look like a change.\n  const customValidationsRef = useRef(customValidations)\n  customValidationsRef.current = customValidations\n\n  // * Safe to call on every render: the client returns one instance per form id.\n  const form =\n    client === null\n      ? null\n      : client.getForm({ formId, customValidations: customValidationsRef.current })\n  const { values, errors } = useFormSnapshot(form)\n\n  return { form, values, errors }\n}\n\n// prueba de la colisión\n","import { useFormSnapshot } from './use-form-store.js'\n\nimport type { FormSchema } from '../core/config.js'\nimport type { FieldErrors, FormInstance } from '../core/form.js'\n\nexport function useFormErrors<TSchema extends FormSchema>(\n  form: FormInstance<TSchema> | null,\n): FieldErrors<TSchema> {\n  const { errors } = useFormSnapshot(form)\n  return errors\n}\n","import { useCallback, useEffect, useState } from 'react'\n\nimport { useFormSnapshot } from './use-form-store.js'\n\nimport type { FormFieldKey, FormSchema, FormValues } from '../core/config.js'\nimport type { FieldErrors, FormInstance, SetResult } from '../core/form.js'\n\nconst noopSetValue = async (): Promise<SetResult<FormSchema>> => ({\n  ok: false,\n  errors: {},\n})\n\nexport function useFormField<const TSchema extends FormSchema, K extends FormFieldKey<TSchema>>({\n  form,\n  key,\n}: {\n  form: FormInstance<TSchema> | null\n  key: K\n}): {\n  value: FormValues<TSchema>[K] | undefined\n  error: readonly string[] | undefined\n  setValue: (value: FormValues<TSchema>[K]) => void\n  onBlur: () => Promise<SetResult<TSchema>>\n} {\n  const { values, errors } = useFormSnapshot(form)\n  const committed = values[key]\n  const [draft, setDraft] = useState<FormValues<TSchema>[K] | undefined>(committed)\n\n  useEffect(() => {\n    setDraft(committed)\n  }, [form, key, committed])\n\n  const setValue = useCallback((value: FormValues<TSchema>[K]) => {\n    setDraft(value)\n  }, [])\n\n  const onBlur = useCallback(async (): Promise<SetResult<TSchema>> => {\n    if (form === null) return noopSetValue()\n    if (draft === committed) {\n      return { ok: true, errors: {} as FieldErrors<TSchema> }\n    }\n    return form.set({ [key]: draft } as Partial<FormValues<TSchema>>)\n  }, [committed, draft, form, key])\n\n  if (form === null) {\n    return {\n      value: undefined,\n      error: undefined,\n      setValue: () => undefined,\n      onBlur: async () => noopSetValue(),\n    }\n  }\n\n  return {\n    value: draft,\n    error: errors[key],\n    setValue,\n    onBlur,\n  }\n}\n","import type { AnalyticsInstance } from '@embeddables/core'\nimport type { EmbeddablesInstance } from '@embeddables/core'\n\nexport function resolveCoreAnalyticsInstance(\n  core: EmbeddablesInstance,\n): AnalyticsInstance | undefined {\n  if (typeof core.getAnalyticsInstance !== 'function') return undefined\n  return core.getAnalyticsInstance() ?? undefined\n}\n","import { initForms } from '../core/form.js'\nimport { formsByCore } from './forms-registry.js'\nimport { resolveCoreAnalyticsInstance } from './resolve-core-analytics.js'\n\nimport type { FormSchemaMap, FormsClient, InitFormsOptions } from '../core/form.js'\n\nexport function registerFormsClient<const TSchemas extends FormSchemaMap>({\n  core,\n  ...options\n}: InitFormsOptions<TSchemas>): FormsClient<TSchemas> {\n  const existing = formsByCore.get(core) as FormsClient<TSchemas> | undefined\n  if (existing !== undefined) return existing\n\n  const analyticsInstance = options.analyticsInstance ?? resolveCoreAnalyticsInstance(core)\n\n  const client = initForms({ ...options, core, analyticsInstance })\n  formsByCore.set(core, client as FormsClient<FormSchemaMap>)\n  return client\n}\n","import type { EmbeddablesReactModule } from '@embeddables/core/react'\n\nimport { FORMS_MODULE_KEY } from './forms-registry.js'\nimport { registerFormsClient } from './register-forms-client.js'\n\nimport type { FormSchemaMap, FormsClient } from '../core/form.js'\nimport type { FormsReactOptions } from './use-forms.js'\n\nexport type { FormsReactOptions } from './use-forms.js'\n\nexport function forms<const TSchemas extends FormSchemaMap>(\n  options: FormsReactOptions<TSchemas>,\n): EmbeddablesReactModule<FormsClient<TSchemas>> {\n  return {\n    key: FORMS_MODULE_KEY,\n    init: (core) => registerFormsClient({ core, ...options }),\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"react.cjs","names":["useRef","useCallback","useSyncExternalStore","useEmbeddablesModule","useRef","useState","useCallback","initForms"],"sources":["../src/react/use-form-store.ts","../src/react/forms-registry.ts","../src/react/use-forms.ts","../src/react/use-form.ts","../src/react/use-form-errors.ts","../src/react/use-form-field.ts","../src/react/resolve-core-analytics.ts","../src/react/register-forms-client.ts","../src/react/forms-module.ts"],"sourcesContent":["import { useCallback, useRef, useSyncExternalStore } from 'react'\n\nimport type { FormSchema, FormValues } from '../core/config.js'\nimport type { FieldErrors, FormInstance } from '../core/form.js'\n\nexport type FormSnapshot<TSchema extends FormSchema> = Readonly<{\n  values: Partial<FormValues<TSchema>>\n  errors: FieldErrors<TSchema>\n}>\n\nconst EMPTY_SNAPSHOT: FormSnapshot<FormSchema> = Object.freeze({\n  values: {},\n  errors: {},\n})\n\nfunction createSnapshot<TSchema extends FormSchema>(\n  form: FormInstance<TSchema>,\n): FormSnapshot<TSchema> {\n  return Object.freeze({\n    values: form.getAll(),\n    errors: form.errors(),\n  })\n}\n\ninterface CachedSnapshot<TSchema extends FormSchema> {\n  readonly form: FormInstance<TSchema>\n  readonly snapshot: FormSnapshot<TSchema>\n}\n\nexport function useFormSnapshot<TSchema extends FormSchema>(\n  form: FormInstance<TSchema> | null,\n): FormSnapshot<TSchema> {\n  const cachedRef = useRef<CachedSnapshot<TSchema> | null>(null)\n  const emptyRef = useRef<FormSnapshot<TSchema>>(EMPTY_SNAPSHOT as FormSnapshot<TSchema>)\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      if (form === null) return () => undefined\n      return form.subscribe(() => {\n        cachedRef.current = { form, snapshot: createSnapshot(form) }\n        listener()\n      })\n    },\n    [form],\n  )\n\n  const getSnapshot = useCallback((): FormSnapshot<TSchema> => {\n    if (form === null) {\n      // * Otherwise a later A -> null -> mutate A -> A sequence would resurrect\n      // * a snapshot cached before the detach, missing the mutation in between.\n      cachedRef.current = null\n      return emptyRef.current\n    }\n    // * A cached snapshot from a previous form instance must not survive a\n    // * form change — recompute so switching forms without a mutation still\n    // * returns the new form's values and errors.\n    if (cachedRef.current === null || cachedRef.current.form !== form) {\n      cachedRef.current = { form, snapshot: createSnapshot(form) }\n    }\n    return cachedRef.current.snapshot\n  }, [form])\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n}\n","import type { FormSchemaMap, FormsClient } from '../core/form.js'\n\nexport const FORMS_MODULE_KEY = 'forms'\n\n/**\n * Idempotence guard for `registerFormsClient` only — React reads the client\n * from provider context, not from here.\n */\nexport const formsByCore = new WeakMap<object, FormsClient<FormSchemaMap>>()\n\nexport function getRegisteredFormsClient(core: object): FormsClient<FormSchemaMap> | undefined {\n  return formsByCore.get(core)\n}\n","import { useEmbeddablesModule } from '@embeddables/core/react'\n\nimport { FORMS_MODULE_KEY } from './forms-registry.js'\n\nimport type { FormSchemaMap, FormsClient, InitFormsOptions } from '../core/form.js'\n\nexport type FormsReactOptions<TSchemas extends FormSchemaMap = FormSchemaMap> = Omit<\n  InitFormsOptions<TSchemas>,\n  'core'\n>\n\n/** @internal Product hooks read the module client from provider context. */\nexport function useRegisteredFormsClient<\n  TSchemas extends FormSchemaMap = FormSchemaMap,\n>(): FormsClient<TSchemas> | null {\n  return useEmbeddablesModule<FormsClient<TSchemas>>({ key: FORMS_MODULE_KEY })\n}\n","import { useRef } from 'react'\n\nimport { useFormSnapshot } from './use-form-store.js'\nimport { useRegisteredFormsClient } from './use-forms.js'\n\nimport type { CustomValidationsFor, FormInstance, FormSchemaMap } from '../core/form.js'\nimport type { RegisteredSchemas } from './schema-registry.js'\n\n/**\n * Reactive binding for one declared form.\n *\n * Takes no type arguments: `TFormId` is inferred from `formId`, and the schema\n * map comes from the registry `em build` augments. Pass both explicitly\n * (`useForm<'signup', OtherSchemas>`) only to work against a map other than the\n * registered one.\n */\nexport function useForm<\n  TFormId extends keyof TSchemas & string,\n  TSchemas extends FormSchemaMap = RegisteredSchemas,\n>({\n  formId,\n  customValidations,\n}: {\n  formId: TFormId\n  customValidations?: CustomValidationsFor<TSchemas[TFormId]>\n}): {\n  form: FormInstance<TSchemas[TFormId]> | null\n  values: ReturnType<typeof useFormSnapshot<TSchemas[TFormId]>>['values']\n  errors: ReturnType<typeof useFormSnapshot<TSchemas[TFormId]>>['errors']\n} {\n  const client = useRegisteredFormsClient<TSchemas>()\n  // * Held in a ref because only the first call for a form id builds the\n  // * instance; a later render passing new validators must not look like a change.\n  const customValidationsRef = useRef(customValidations)\n  customValidationsRef.current = customValidations\n\n  // * Safe to call on every render: the client returns one instance per form id.\n  const form =\n    client === null\n      ? null\n      : client.getForm({ formId, customValidations: customValidationsRef.current })\n  const { values, errors } = useFormSnapshot(form)\n\n  return { form, values, errors }\n}\n","import { useFormSnapshot } from './use-form-store.js'\n\nimport type { FormSchema } from '../core/config.js'\nimport type { FieldErrors, FormInstance } from '../core/form.js'\n\nexport function useFormErrors<TSchema extends FormSchema>(\n  form: FormInstance<TSchema> | null,\n): FieldErrors<TSchema> {\n  const { errors } = useFormSnapshot(form)\n  return errors\n}\n","import { useCallback, useEffect, useState } from 'react'\n\nimport { useFormSnapshot } from './use-form-store.js'\n\nimport type { FormFieldKey, FormSchema, FormValues } from '../core/config.js'\nimport type { FieldErrors, FormInstance, SetResult } from '../core/form.js'\n\nconst noopSetValue = async (): Promise<SetResult<FormSchema>> => ({\n  ok: false,\n  errors: {},\n})\n\nexport function useFormField<const TSchema extends FormSchema, K extends FormFieldKey<TSchema>>({\n  form,\n  key,\n}: {\n  form: FormInstance<TSchema> | null\n  key: K\n}): {\n  value: FormValues<TSchema>[K] | undefined\n  error: readonly string[] | undefined\n  setValue: (value: FormValues<TSchema>[K]) => void\n  onBlur: () => Promise<SetResult<TSchema>>\n} {\n  const { values, errors } = useFormSnapshot(form)\n  const committed = values[key]\n  const [draft, setDraft] = useState<FormValues<TSchema>[K] | undefined>(committed)\n\n  useEffect(() => {\n    setDraft(committed)\n  }, [form, key, committed])\n\n  const setValue = useCallback((value: FormValues<TSchema>[K]) => {\n    setDraft(value)\n  }, [])\n\n  const onBlur = useCallback(async (): Promise<SetResult<TSchema>> => {\n    if (form === null) return noopSetValue()\n    if (draft === committed) {\n      return { ok: true, errors: {} as FieldErrors<TSchema> }\n    }\n    return form.set({ [key]: draft } as Partial<FormValues<TSchema>>)\n  }, [committed, draft, form, key])\n\n  if (form === null) {\n    return {\n      value: undefined,\n      error: undefined,\n      setValue: () => undefined,\n      onBlur: async () => noopSetValue(),\n    }\n  }\n\n  return {\n    value: draft,\n    error: errors[key],\n    setValue,\n    onBlur,\n  }\n}\n","import type { AnalyticsInstance } from '@embeddables/core'\nimport type { EmbeddablesInstance } from '@embeddables/core'\n\nexport function resolveCoreAnalyticsInstance(\n  core: EmbeddablesInstance,\n): AnalyticsInstance | undefined {\n  if (typeof core.getAnalyticsInstance !== 'function') return undefined\n  return core.getAnalyticsInstance() ?? undefined\n}\n","import { initForms } from '../core/form.js'\nimport { formsByCore } from './forms-registry.js'\nimport { resolveCoreAnalyticsInstance } from './resolve-core-analytics.js'\n\nimport type { FormSchemaMap, FormsClient, InitFormsOptions } from '../core/form.js'\n\nexport function registerFormsClient<const TSchemas extends FormSchemaMap>({\n  core,\n  ...options\n}: InitFormsOptions<TSchemas>): FormsClient<TSchemas> {\n  const existing = formsByCore.get(core) as FormsClient<TSchemas> | undefined\n  if (existing !== undefined) return existing\n\n  const analyticsInstance = options.analyticsInstance ?? resolveCoreAnalyticsInstance(core)\n\n  const client = initForms({ ...options, core, analyticsInstance })\n  formsByCore.set(core, client as FormsClient<FormSchemaMap>)\n  return client\n}\n","import type { EmbeddablesReactModule } from '@embeddables/core/react'\n\nimport { FORMS_MODULE_KEY } from './forms-registry.js'\nimport { registerFormsClient } from './register-forms-client.js'\n\nimport type { FormSchemaMap, FormsClient } from '../core/form.js'\nimport type { FormsReactOptions } from './use-forms.js'\n\nexport type { FormsReactOptions } from './use-forms.js'\n\nexport function forms<const TSchemas extends FormSchemaMap>(\n  options: FormsReactOptions<TSchemas>,\n): EmbeddablesReactModule<FormsClient<TSchemas>> {\n  return {\n    key: FORMS_MODULE_KEY,\n    init: (core) => registerFormsClient({ core, ...options }),\n  }\n}\n"],"mappings":"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"}

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { a as FormsClient, b as FormValues, i as FormSchemaMap, n as FieldErrors, o as InitFormsOptions, r as FormInstance, s as SetResult, t as CustomValidationsFor, v as FormFieldKey, y as FormSchema } from "./form-CbU5ezg7.js";
+import { D as FormValues, E as FormSchema, T as FormFieldKey, a as FormsClient, i as FormSchemaMap, n as FieldErrors, o as InitFormsOptions, r as FormInstance, s as SetResult, t as CustomValidationsFor } from "./index-qfBhdk5L.js";
 import { EmbeddablesReactModule } from "@embeddables/core/react";
 //#region src/react/use-form-store.d.ts
 type FormSnapshot<TSchema extends FormSchema> = Readonly<{
@@ -76,5 +76,8 @@ declare function forms<const TSchemas extends FormSchemaMap>(options: FormsReact
 //#region src/react/register-forms-client.d.ts
 declare function registerFormsClient<const TSchemas extends FormSchemaMap>({ core, ...options }: InitFormsOptions<TSchemas>): FormsClient<TSchemas>;
 //#endregion
-export { type EmbeddablesSchemaRegistry, type FormsReactOptions, type RegisteredSchemas, forms, registerFormsClient, useForm, useFormErrors, useFormField };
+//#region src/react/forms-registry.d.ts
+declare function getRegisteredFormsClient(core: object): FormsClient<FormSchemaMap> | undefined;
+//#endregion
+export { type EmbeddablesSchemaRegistry, type FormsReactOptions, type RegisteredSchemas, forms, getRegisteredFormsClient, registerFormsClient, useForm, useFormErrors, useFormField };
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","names":[],"sources":["../src/react/use-form-store.ts","../src/react/schema-registry.ts","../src/react/use-form.ts","../src/react/use-form-errors.ts","../src/react/use-form-field.ts","../src/react/use-forms.ts","../src/react/forms-module.ts","../src/react/register-forms-client.ts"],"mappings":";;;KAKY,aAAa,gBAAgB,cAAc;EACrD,QAAQ,QAAQ,WAAW;EAC3B,QAAQ,YAAY;;iBAsBN,gBAAgB,gBAAgB,YAC9C,MAAM,aAAa,kBAClB,aAAa;;;;;;;;;;;;;;;;;;;;UCXC;;;;;;KAOL,oBAAoB;EAC9B,aAAa,iBAAiB;IAE5B,WACA;;;;;;;;;;;iBCfY,QACd,sBAAsB,mBACtB,iBAAiB,gBAAgB,qBAEjC,QACA;EAEA,QAAQ;EACR,oBAAoB,qBAAqB,SAAS;;EAElD,MAAM,aAAa,SAAS;EAC5B,QAAQ,kBAAkB,gBAAgB,SAAS;EACnD,QAAQ,kBAAkB,gBAAgB,SAAS;;;;iBCvBrC,cAAc,gBAAgB,YAC5C,MAAM,aAAa,kBAClB,YAAY;;;iBCKC,mBAAmB,gBAAgB,YAAY,UAAU,aAAa,YACpF,MACA;EAEA,MAAM,aAAa;EACnB,KAAK;;EAEL,OAAO,WAAW,SAAS;EAC3B;EACA,WAAW,OAAO,WAAW,SAAS;EACtC,cAAc,QAAQ,UAAU;;;;KChBtB,kBAAkB,iBAAiB,gBAAgB,iBAAiB,KAC9E,iBAAiB;;;iBCGH,YAAY,iBAAiB,eAC3C,SAAS,kBAAkB,YAC1B,uBAAuB,YAAY;;;iBCNtB,0BAA0B,iBAAiB,iBACzD,SACG,WACF,iBAAiB,YAAY,YAAY"}
+{"version":3,"file":"react.d.ts","names":[],"sources":["../src/react/use-form-store.ts","../src/react/schema-registry.ts","../src/react/use-form.ts","../src/react/use-form-errors.ts","../src/react/use-form-field.ts","../src/react/use-forms.ts","../src/react/forms-module.ts","../src/react/register-forms-client.ts","../src/react/forms-registry.ts"],"mappings":";;;KAKY,aAAa,gBAAgB,cAAc;EACrD,QAAQ,QAAQ,WAAW;EAC3B,QAAQ,YAAY;;iBAsBN,gBAAgB,gBAAgB,YAC9C,MAAM,aAAa,kBAClB,aAAa;;;;;;;;;;;;;;;;;;;;UCXC;;;;;;KAOL,oBAAoB;EAC9B,aAAa,iBAAiB;IAE5B,WACA;;;;;;;;;;;iBCfY,QACd,sBAAsB,mBACtB,iBAAiB,gBAAgB,qBAEjC,QACA;EAEA,QAAQ;EACR,oBAAoB,qBAAqB,SAAS;;EAElD,MAAM,aAAa,SAAS;EAC5B,QAAQ,kBAAkB,gBAAgB,SAAS;EACnD,QAAQ,kBAAkB,gBAAgB,SAAS;;;;iBCvBrC,cAAc,gBAAgB,YAC5C,MAAM,aAAa,kBAClB,YAAY;;;iBCKC,mBAAmB,gBAAgB,YAAY,UAAU,aAAa,YACpF,MACA;EAEA,MAAM,aAAa;EACnB,KAAK;;EAEL,OAAO,WAAW,SAAS;EAC3B;EACA,WAAW,OAAO,WAAW,SAAS;EACtC,cAAc,QAAQ,UAAU;;;;KChBtB,kBAAkB,iBAAiB,gBAAgB,iBAAiB,KAC9E,iBAAiB;;;iBCGH,YAAY,iBAAiB,eAC3C,SAAS,kBAAkB,YAC1B,uBAAuB,YAAY;;;iBCNtB,0BAA0B,iBAAiB,iBACzD,SACG,WACF,iBAAiB,YAAY,YAAY;;;iBCC5B,yBAAyB,eAAe,YAAY"}

package/dist/react.js

@@ -46,6 +46,9 @@ const FORMS_MODULE_KEY = "forms";
 * from provider context, not from here.
 */
 const formsByCore = /* @__PURE__ */ new WeakMap();
+function getRegisteredFormsClient(core) {
+	return formsByCore.get(core);
+}
 //#endregion
 //#region src/react/use-forms.ts
 /** @internal Product hooks read the module client from provider context. */
@@ -161,6 +164,6 @@ function forms(options) {
 	};
 }
 //#endregion
-export { forms, registerFormsClient, useForm, useFormErrors, useFormField };
+export { forms, getRegisteredFormsClient, registerFormsClient, useForm, useFormErrors, useFormField };
 
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","names":[],"sources":["../src/react/use-form-store.ts","../src/react/forms-registry.ts","../src/react/use-forms.ts","../src/react/use-form.ts","../src/react/use-form-errors.ts","../src/react/use-form-field.ts","../src/react/resolve-core-analytics.ts","../src/react/register-forms-client.ts","../src/react/forms-module.ts"],"sourcesContent":["import { useCallback, useRef, useSyncExternalStore } from 'react'\n\nimport type { FormSchema, FormValues } from '../core/config.js'\nimport type { FieldErrors, FormInstance } from '../core/form.js'\n\nexport type FormSnapshot<TSchema extends FormSchema> = Readonly<{\n  values: Partial<FormValues<TSchema>>\n  errors: FieldErrors<TSchema>\n}>\n\nconst EMPTY_SNAPSHOT: FormSnapshot<FormSchema> = Object.freeze({\n  values: {},\n  errors: {},\n})\n\nfunction createSnapshot<TSchema extends FormSchema>(\n  form: FormInstance<TSchema>,\n): FormSnapshot<TSchema> {\n  return Object.freeze({\n    values: form.getAll(),\n    errors: form.errors(),\n  })\n}\n\ninterface CachedSnapshot<TSchema extends FormSchema> {\n  readonly form: FormInstance<TSchema>\n  readonly snapshot: FormSnapshot<TSchema>\n}\n\nexport function useFormSnapshot<TSchema extends FormSchema>(\n  form: FormInstance<TSchema> | null,\n): FormSnapshot<TSchema> {\n  const cachedRef = useRef<CachedSnapshot<TSchema> | null>(null)\n  const emptyRef = useRef<FormSnapshot<TSchema>>(EMPTY_SNAPSHOT as FormSnapshot<TSchema>)\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      if (form === null) return () => undefined\n      return form.subscribe(() => {\n        cachedRef.current = { form, snapshot: createSnapshot(form) }\n        listener()\n      })\n    },\n    [form],\n  )\n\n  const getSnapshot = useCallback((): FormSnapshot<TSchema> => {\n    if (form === null) {\n      // * Otherwise a later A -> null -> mutate A -> A sequence would resurrect\n      // * a snapshot cached before the detach, missing the mutation in between.\n      cachedRef.current = null\n      return emptyRef.current\n    }\n    // * A cached snapshot from a previous form instance must not survive a\n    // * form change — recompute so switching forms without a mutation still\n    // * returns the new form's values and errors.\n    if (cachedRef.current === null || cachedRef.current.form !== form) {\n      cachedRef.current = { form, snapshot: createSnapshot(form) }\n    }\n    return cachedRef.current.snapshot\n  }, [form])\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n}\n","import type { FormSchemaMap, FormsClient } from '../core/form.js'\n\nexport const FORMS_MODULE_KEY = 'forms'\n\n/**\n * Idempotence guard for `registerFormsClient` only — React reads the client\n * from provider context, not from here.\n */\nexport const formsByCore = new WeakMap<object, FormsClient<FormSchemaMap>>()\n","import { useEmbeddablesModule } from '@embeddables/core/react'\n\nimport { FORMS_MODULE_KEY } from './forms-registry.js'\n\nimport type { FormSchemaMap, FormsClient, InitFormsOptions } from '../core/form.js'\n\nexport type FormsReactOptions<TSchemas extends FormSchemaMap = FormSchemaMap> = Omit<\n  InitFormsOptions<TSchemas>,\n  'core'\n>\n\n/** @internal Product hooks read the module client from provider context. */\nexport function useRegisteredFormsClient<\n  TSchemas extends FormSchemaMap = FormSchemaMap,\n>(): FormsClient<TSchemas> | null {\n  return useEmbeddablesModule<FormsClient<TSchemas>>({ key: FORMS_MODULE_KEY })\n}\n","import { useRef } from 'react'\n\nimport { useFormSnapshot } from './use-form-store.js'\nimport { useRegisteredFormsClient } from './use-forms.js'\n\nimport type { CustomValidationsFor, FormInstance, FormSchemaMap } from '../core/form.js'\nimport type { RegisteredSchemas } from './schema-registry.js'\n\n/**\n * Reactive binding for one declared form.\n *\n * Takes no type arguments: `TFormId` is inferred from `formId`, and the schema\n * map comes from the registry `em build` augments. Pass both explicitly\n * (`useForm<'signup', OtherSchemas>`) only to work against a map other than the\n * registered one.\n */\nexport function useForm<\n  TFormId extends keyof TSchemas & string,\n  TSchemas extends FormSchemaMap = RegisteredSchemas,\n>({\n  formId,\n  customValidations,\n}: {\n  formId: TFormId\n  customValidations?: CustomValidationsFor<TSchemas[TFormId]>\n}): {\n  form: FormInstance<TSchemas[TFormId]> | null\n  values: ReturnType<typeof useFormSnapshot<TSchemas[TFormId]>>['values']\n  errors: ReturnType<typeof useFormSnapshot<TSchemas[TFormId]>>['errors']\n} {\n  const client = useRegisteredFormsClient<TSchemas>()\n  // * Held in a ref because only the first call for a form id builds the\n  // * instance; a later render passing new validators must not look like a change.\n  const customValidationsRef = useRef(customValidations)\n  customValidationsRef.current = customValidations\n\n  // * Safe to call on every render: the client returns one instance per form id.\n  const form =\n    client === null\n      ? null\n      : client.getForm({ formId, customValidations: customValidationsRef.current })\n  const { values, errors } = useFormSnapshot(form)\n\n  return { form, values, errors }\n}\n\n// prueba de la colisión\n","import { useFormSnapshot } from './use-form-store.js'\n\nimport type { FormSchema } from '../core/config.js'\nimport type { FieldErrors, FormInstance } from '../core/form.js'\n\nexport function useFormErrors<TSchema extends FormSchema>(\n  form: FormInstance<TSchema> | null,\n): FieldErrors<TSchema> {\n  const { errors } = useFormSnapshot(form)\n  return errors\n}\n","import { useCallback, useEffect, useState } from 'react'\n\nimport { useFormSnapshot } from './use-form-store.js'\n\nimport type { FormFieldKey, FormSchema, FormValues } from '../core/config.js'\nimport type { FieldErrors, FormInstance, SetResult } from '../core/form.js'\n\nconst noopSetValue = async (): Promise<SetResult<FormSchema>> => ({\n  ok: false,\n  errors: {},\n})\n\nexport function useFormField<const TSchema extends FormSchema, K extends FormFieldKey<TSchema>>({\n  form,\n  key,\n}: {\n  form: FormInstance<TSchema> | null\n  key: K\n}): {\n  value: FormValues<TSchema>[K] | undefined\n  error: readonly string[] | undefined\n  setValue: (value: FormValues<TSchema>[K]) => void\n  onBlur: () => Promise<SetResult<TSchema>>\n} {\n  const { values, errors } = useFormSnapshot(form)\n  const committed = values[key]\n  const [draft, setDraft] = useState<FormValues<TSchema>[K] | undefined>(committed)\n\n  useEffect(() => {\n    setDraft(committed)\n  }, [form, key, committed])\n\n  const setValue = useCallback((value: FormValues<TSchema>[K]) => {\n    setDraft(value)\n  }, [])\n\n  const onBlur = useCallback(async (): Promise<SetResult<TSchema>> => {\n    if (form === null) return noopSetValue()\n    if (draft === committed) {\n      return { ok: true, errors: {} as FieldErrors<TSchema> }\n    }\n    return form.set({ [key]: draft } as Partial<FormValues<TSchema>>)\n  }, [committed, draft, form, key])\n\n  if (form === null) {\n    return {\n      value: undefined,\n      error: undefined,\n      setValue: () => undefined,\n      onBlur: async () => noopSetValue(),\n    }\n  }\n\n  return {\n    value: draft,\n    error: errors[key],\n    setValue,\n    onBlur,\n  }\n}\n","import type { AnalyticsInstance } from '@embeddables/core'\nimport type { EmbeddablesInstance } from '@embeddables/core'\n\nexport function resolveCoreAnalyticsInstance(\n  core: EmbeddablesInstance,\n): AnalyticsInstance | undefined {\n  if (typeof core.getAnalyticsInstance !== 'function') return undefined\n  return core.getAnalyticsInstance() ?? undefined\n}\n","import { initForms } from '../core/form.js'\nimport { formsByCore } from './forms-registry.js'\nimport { resolveCoreAnalyticsInstance } from './resolve-core-analytics.js'\n\nimport type { FormSchemaMap, FormsClient, InitFormsOptions } from '../core/form.js'\n\nexport function registerFormsClient<const TSchemas extends FormSchemaMap>({\n  core,\n  ...options\n}: InitFormsOptions<TSchemas>): FormsClient<TSchemas> {\n  const existing = formsByCore.get(core) as FormsClient<TSchemas> | undefined\n  if (existing !== undefined) return existing\n\n  const analyticsInstance = options.analyticsInstance ?? resolveCoreAnalyticsInstance(core)\n\n  const client = initForms({ ...options, core, analyticsInstance })\n  formsByCore.set(core, client as FormsClient<FormSchemaMap>)\n  return client\n}\n","import type { EmbeddablesReactModule } from '@embeddables/core/react'\n\nimport { FORMS_MODULE_KEY } from './forms-registry.js'\nimport { registerFormsClient } from './register-forms-client.js'\n\nimport type { FormSchemaMap, FormsClient } from '../core/form.js'\nimport type { FormsReactOptions } from './use-forms.js'\n\nexport type { FormsReactOptions } from './use-forms.js'\n\nexport function forms<const TSchemas extends FormSchemaMap>(\n  options: FormsReactOptions<TSchemas>,\n): EmbeddablesReactModule<FormsClient<TSchemas>> {\n  return {\n    key: FORMS_MODULE_KEY,\n    init: (core) => registerFormsClient({ core, ...options }),\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"react.js","names":[],"sources":["../src/react/use-form-store.ts","../src/react/forms-registry.ts","../src/react/use-forms.ts","../src/react/use-form.ts","../src/react/use-form-errors.ts","../src/react/use-form-field.ts","../src/react/resolve-core-analytics.ts","../src/react/register-forms-client.ts","../src/react/forms-module.ts"],"sourcesContent":["import { useCallback, useRef, useSyncExternalStore } from 'react'\n\nimport type { FormSchema, FormValues } from '../core/config.js'\nimport type { FieldErrors, FormInstance } from '../core/form.js'\n\nexport type FormSnapshot<TSchema extends FormSchema> = Readonly<{\n  values: Partial<FormValues<TSchema>>\n  errors: FieldErrors<TSchema>\n}>\n\nconst EMPTY_SNAPSHOT: FormSnapshot<FormSchema> = Object.freeze({\n  values: {},\n  errors: {},\n})\n\nfunction createSnapshot<TSchema extends FormSchema>(\n  form: FormInstance<TSchema>,\n): FormSnapshot<TSchema> {\n  return Object.freeze({\n    values: form.getAll(),\n    errors: form.errors(),\n  })\n}\n\ninterface CachedSnapshot<TSchema extends FormSchema> {\n  readonly form: FormInstance<TSchema>\n  readonly snapshot: FormSnapshot<TSchema>\n}\n\nexport function useFormSnapshot<TSchema extends FormSchema>(\n  form: FormInstance<TSchema> | null,\n): FormSnapshot<TSchema> {\n  const cachedRef = useRef<CachedSnapshot<TSchema> | null>(null)\n  const emptyRef = useRef<FormSnapshot<TSchema>>(EMPTY_SNAPSHOT as FormSnapshot<TSchema>)\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      if (form === null) return () => undefined\n      return form.subscribe(() => {\n        cachedRef.current = { form, snapshot: createSnapshot(form) }\n        listener()\n      })\n    },\n    [form],\n  )\n\n  const getSnapshot = useCallback((): FormSnapshot<TSchema> => {\n    if (form === null) {\n      // * Otherwise a later A -> null -> mutate A -> A sequence would resurrect\n      // * a snapshot cached before the detach, missing the mutation in between.\n      cachedRef.current = null\n      return emptyRef.current\n    }\n    // * A cached snapshot from a previous form instance must not survive a\n    // * form change — recompute so switching forms without a mutation still\n    // * returns the new form's values and errors.\n    if (cachedRef.current === null || cachedRef.current.form !== form) {\n      cachedRef.current = { form, snapshot: createSnapshot(form) }\n    }\n    return cachedRef.current.snapshot\n  }, [form])\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n}\n","import type { FormSchemaMap, FormsClient } from '../core/form.js'\n\nexport const FORMS_MODULE_KEY = 'forms'\n\n/**\n * Idempotence guard for `registerFormsClient` only — React reads the client\n * from provider context, not from here.\n */\nexport const formsByCore = new WeakMap<object, FormsClient<FormSchemaMap>>()\n\nexport function getRegisteredFormsClient(core: object): FormsClient<FormSchemaMap> | undefined {\n  return formsByCore.get(core)\n}\n","import { useEmbeddablesModule } from '@embeddables/core/react'\n\nimport { FORMS_MODULE_KEY } from './forms-registry.js'\n\nimport type { FormSchemaMap, FormsClient, InitFormsOptions } from '../core/form.js'\n\nexport type FormsReactOptions<TSchemas extends FormSchemaMap = FormSchemaMap> = Omit<\n  InitFormsOptions<TSchemas>,\n  'core'\n>\n\n/** @internal Product hooks read the module client from provider context. */\nexport function useRegisteredFormsClient<\n  TSchemas extends FormSchemaMap = FormSchemaMap,\n>(): FormsClient<TSchemas> | null {\n  return useEmbeddablesModule<FormsClient<TSchemas>>({ key: FORMS_MODULE_KEY })\n}\n","import { useRef } from 'react'\n\nimport { useFormSnapshot } from './use-form-store.js'\nimport { useRegisteredFormsClient } from './use-forms.js'\n\nimport type { CustomValidationsFor, FormInstance, FormSchemaMap } from '../core/form.js'\nimport type { RegisteredSchemas } from './schema-registry.js'\n\n/**\n * Reactive binding for one declared form.\n *\n * Takes no type arguments: `TFormId` is inferred from `formId`, and the schema\n * map comes from the registry `em build` augments. Pass both explicitly\n * (`useForm<'signup', OtherSchemas>`) only to work against a map other than the\n * registered one.\n */\nexport function useForm<\n  TFormId extends keyof TSchemas & string,\n  TSchemas extends FormSchemaMap = RegisteredSchemas,\n>({\n  formId,\n  customValidations,\n}: {\n  formId: TFormId\n  customValidations?: CustomValidationsFor<TSchemas[TFormId]>\n}): {\n  form: FormInstance<TSchemas[TFormId]> | null\n  values: ReturnType<typeof useFormSnapshot<TSchemas[TFormId]>>['values']\n  errors: ReturnType<typeof useFormSnapshot<TSchemas[TFormId]>>['errors']\n} {\n  const client = useRegisteredFormsClient<TSchemas>()\n  // * Held in a ref because only the first call for a form id builds the\n  // * instance; a later render passing new validators must not look like a change.\n  const customValidationsRef = useRef(customValidations)\n  customValidationsRef.current = customValidations\n\n  // * Safe to call on every render: the client returns one instance per form id.\n  const form =\n    client === null\n      ? null\n      : client.getForm({ formId, customValidations: customValidationsRef.current })\n  const { values, errors } = useFormSnapshot(form)\n\n  return { form, values, errors }\n}\n","import { useFormSnapshot } from './use-form-store.js'\n\nimport type { FormSchema } from '../core/config.js'\nimport type { FieldErrors, FormInstance } from '../core/form.js'\n\nexport function useFormErrors<TSchema extends FormSchema>(\n  form: FormInstance<TSchema> | null,\n): FieldErrors<TSchema> {\n  const { errors } = useFormSnapshot(form)\n  return errors\n}\n","import { useCallback, useEffect, useState } from 'react'\n\nimport { useFormSnapshot } from './use-form-store.js'\n\nimport type { FormFieldKey, FormSchema, FormValues } from '../core/config.js'\nimport type { FieldErrors, FormInstance, SetResult } from '../core/form.js'\n\nconst noopSetValue = async (): Promise<SetResult<FormSchema>> => ({\n  ok: false,\n  errors: {},\n})\n\nexport function useFormField<const TSchema extends FormSchema, K extends FormFieldKey<TSchema>>({\n  form,\n  key,\n}: {\n  form: FormInstance<TSchema> | null\n  key: K\n}): {\n  value: FormValues<TSchema>[K] | undefined\n  error: readonly string[] | undefined\n  setValue: (value: FormValues<TSchema>[K]) => void\n  onBlur: () => Promise<SetResult<TSchema>>\n} {\n  const { values, errors } = useFormSnapshot(form)\n  const committed = values[key]\n  const [draft, setDraft] = useState<FormValues<TSchema>[K] | undefined>(committed)\n\n  useEffect(() => {\n    setDraft(committed)\n  }, [form, key, committed])\n\n  const setValue = useCallback((value: FormValues<TSchema>[K]) => {\n    setDraft(value)\n  }, [])\n\n  const onBlur = useCallback(async (): Promise<SetResult<TSchema>> => {\n    if (form === null) return noopSetValue()\n    if (draft === committed) {\n      return { ok: true, errors: {} as FieldErrors<TSchema> }\n    }\n    return form.set({ [key]: draft } as Partial<FormValues<TSchema>>)\n  }, [committed, draft, form, key])\n\n  if (form === null) {\n    return {\n      value: undefined,\n      error: undefined,\n      setValue: () => undefined,\n      onBlur: async () => noopSetValue(),\n    }\n  }\n\n  return {\n    value: draft,\n    error: errors[key],\n    setValue,\n    onBlur,\n  }\n}\n","import type { AnalyticsInstance } from '@embeddables/core'\nimport type { EmbeddablesInstance } from '@embeddables/core'\n\nexport function resolveCoreAnalyticsInstance(\n  core: EmbeddablesInstance,\n): AnalyticsInstance | undefined {\n  if (typeof core.getAnalyticsInstance !== 'function') return undefined\n  return core.getAnalyticsInstance() ?? undefined\n}\n","import { initForms } from '../core/form.js'\nimport { formsByCore } from './forms-registry.js'\nimport { resolveCoreAnalyticsInstance } from './resolve-core-analytics.js'\n\nimport type { FormSchemaMap, FormsClient, InitFormsOptions } from '../core/form.js'\n\nexport function registerFormsClient<const TSchemas extends FormSchemaMap>({\n  core,\n  ...options\n}: InitFormsOptions<TSchemas>): FormsClient<TSchemas> {\n  const existing = formsByCore.get(core) as FormsClient<TSchemas> | undefined\n  if (existing !== undefined) return existing\n\n  const analyticsInstance = options.analyticsInstance ?? resolveCoreAnalyticsInstance(core)\n\n  const client = initForms({ ...options, core, analyticsInstance })\n  formsByCore.set(core, client as FormsClient<FormSchemaMap>)\n  return client\n}\n","import type { EmbeddablesReactModule } from '@embeddables/core/react'\n\nimport { FORMS_MODULE_KEY } from './forms-registry.js'\nimport { registerFormsClient } from './register-forms-client.js'\n\nimport type { FormSchemaMap, FormsClient } from '../core/form.js'\nimport type { FormsReactOptions } from './use-forms.js'\n\nexport type { FormsReactOptions } from './use-forms.js'\n\nexport function forms<const TSchemas extends FormSchemaMap>(\n  options: FormsReactOptions<TSchemas>,\n): EmbeddablesReactModule<FormsClient<TSchemas>> {\n  return {\n    key: FORMS_MODULE_KEY,\n    init: (core) => registerFormsClient({ core, ...options }),\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embeddables/forms",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Schema-driven form state, local persistence, and analytics events for Embeddables funnels.",
   "private": false,
   "type": "module",
@@ -53,8 +53,8 @@
     "typescript": "~6.0.2",
     "vitest": "^4.1.9",
     "@embeddables/core": "0.0.4",
-    "backend-worker": "1.0.0",
-    "@embeddables/shared-types": "1.0.0"
+    "@embeddables/shared-types": "1.0.0",
+    "backend-worker": "1.0.0"
   },
   "scripts": {
     "build": "tsdown",

package/dist/form-CbU5ezg7.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"form-CbU5ezg7.d.ts","names":[],"sources":["../../shared-types/dist/json.types.d.ts","../src/core/config.ts","../../shared-types/dist/analytics-instance.types.d.ts","../src/core/form.ts"],"mappings":";;;;;;KAIY,+CAA+C;GACtD,cAAc;;;;KCHP;;UAMF;EACR;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;;KAGI,eAAe,eAAe,YAAY,cAAc;EAClE,OAAO;EACP,QAAQ,SAAS,eAAe;;UAUxB,oBAAoB,cAAc;WACjC;WACA;WACA;WACA;WACA;;WAEA;;WAEA;WACA,iBAAiB;;WAEjB,SAAS,eAAe,iBAAiB;;UAG1C,eAAe,cAAc;WAC5B;WACA;WACA,MAAM;WACN,cAAc,oBAAoB;WAGlC;WACA;;KAUC,iBAAiB,KAAK,YAAY,eAAe,MAAK;KAEtD,sBAAsB,KAAK,YAAY,oBAAoB,MAAK;UAE3D;WACN;WACA;WACA,iBAAiB;;KAGvB,SAAS,gBAAgB,cAAc;KAEhC,aAAa,gBAAgB,cAAc,SAAS;KAEpD,WAAW,gBAAgB,iBACpC,KAAK,SAAS,YAAY,WAAW,iBAAiB;;KAI7C,gBAAgB,gBAAgB,eAAe,kBAAkB,uBAEzE,QAAQ,SAAS;EAAY;;;;;;;;;;;;;;;UCzEhB;EACb;GACC;;;UAGY;EACb;EACA;EACA;;;;;;;UAOa,kBAAkB,SAAS;EACxC,WAAW,OAAO,kBAAkB,WAAW,QAAQ;;EAEvD;EACA;;;;;KCAQ,YAAY,gBAAgB,cAAc,SACpD,QAAQ,OAAO,aAAa;UAGb,UAAU,gBAAgB;EACzC;EACA,QAAQ,YAAY;;EAEpB;;UAGe,aAAa,gBAAgB;EAC5C;EACA,QAAQ,YAAY;EACpB,QAAQ,QAAQ,WAAW;EAC3B;;UAGe,eAAe,gBAAgB;EAC9C;EACA,QAAQ,YAAY;EACpB,QAAQ,QAAQ,WAAW;;UAGZ,aAAa,gBAAgB;WACnC,KAAK;;;;;;;EAOd,IAAI,OAAO,QAAQ,WAAW,YAAY,QAAQ,UAAU;;EAE5D,IAAI,UAAU,aAAa,UAAU,KAAK,IAAI,WAAW,SAAS;;;;;;EAMlE,0BAA0B,UAAU,gBAAgB,UAClD,iBAAiB,IAEf,WAAW,SAAS,QAAQ;IAA6B,iBAAiB;;EAE9E,UAAU,QAAQ,WAAW;;;;;;;;;EAS7B,UAAU,QAAQ,aAAa;;;;;;;;;;EAU/B,SAAS,QAAQ,QAAQ,WAAW,YAAY,QAAQ,eAAe;EACvE,UAAU,YAAY;EACtB;;EAEA,UAAU;;;KA6CA,gBAAgB,SAAS,eAAe;KAExC,qBAAqB,gBAAgB,0BACrC,KAAK,aAAa,YAAY;UAOzB,iBAAiB,iBAAiB,gBAAgB;EACjE,MAAM;;EAEN,SAAS;EACT,oBAAoB;;UAGL,YAAY,iBAAiB,gBAAgB;;;;;;;;;;;;;EAa5D,QAAQ,gBAAgB,mBAAmB;IACzC,QAAQ;IACR,oBAAoB,qBAAqB,SAAS;MAChD,aAAa,SAAS;;;;;;iBAOZ,gBAAgB,iBAAiB,eAC/C,SAAS,iBAAiB,YACzB,YAAY"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/errors.ts","../src/storage/storage.ts","../../shared-types/dist/analytics-ingest.types.d.ts","../src/core/analytics.ts"],"mappings":";;;;;;;;;;;;cAWa,mBAAmB;EAClB,YAAA,iBAAiB,UAAU;;;cAO5B,oBAAoB;EACnB,YAAA,iBAAiB,UAAU;;;cAO5B,uBAAuB;EACtB,YAAA,iBAAiB,UAAU;;;;;cCvB5B;UAEI;EACf,QAAQ;EACR,QAAQ,aAAa;EACrB,WAAW;;;;KCJD;;;;;;;;KAQA,oBAAoB;KACpB;EACR;EACA;;KAsBQ,oBAAoB;EAC5B;;EAEA;EACA,YAAY;EACZ,cAAc;;EAEd;;EAEA;;KAEQ;EACR;EACA;;KAEQ,mBAAmB;EAC3B;EACA,MAAM,eAAe;;KAMb,qBAAqB;EAC7B;EACA;;;;KCpCQ,sBAAsB,mBAAmB,oBAAoB"}