@embeddables/forms 0.0.5 → 0.2.0

package/dist/react.d.ts

@@ -1,4 +1,5 @@
-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 "./index-BB698udY.js";
+import { E as FormValues, T as FormSchema, a as FormSchemaMap, f as SetResult, i as FormInstance, l as InitFormsOptions, n as FieldErrors, s as FormsClient, w as FormFieldKey } from "./form-Br23yPDS.js";
 import { EmbeddablesReactModule } from "@embeddables/core/react";
 //#region src/react/use-form-store.d.ts
 type FormSnapshot<TSchema extends FormSchema> = Readonly<{
@@ -44,9 +45,8 @@ type RegisteredSchemas = EmbeddablesSchemaRegistry extends {
  * (`useForm<'signup', OtherSchemas>`) only to work against a map other than the
  * registered one.
  */
-declare function useForm<TFormId extends keyof TSchemas & string, TSchemas extends FormSchemaMap = RegisteredSchemas>({ formId, customValidations }: {
+declare function useForm<TFormId extends keyof TSchemas & string, TSchemas extends FormSchemaMap = RegisteredSchemas>({ formId }: {
   formId: TFormId;
-  customValidations?: CustomValidationsFor<TSchemas[TFormId]>;
 }): {
   form: FormInstance<TSchemas[TFormId]> | null;
   values: ReturnType<typeof useFormSnapshot<TSchemas[TFormId]>>['values'];
@@ -63,7 +63,8 @@ declare function useFormField<const TSchema extends FormSchema, K extends FormFi
 }): {
   value: FormValues<TSchema>[K] | undefined;
   error: readonly string[] | undefined;
-  setValue: (value: FormValues<TSchema>[K]) => void;
+  setValue: (value: FormValues<TSchema>[K] | undefined) => void;
+  commit: (value: FormValues<TSchema>[K] | undefined) => Promise<SetResult<TSchema>>;
   onBlur: () => Promise<SetResult<TSchema>>;
 };
 //#endregion
@@ -71,13 +72,26 @@ declare function useFormField<const TSchema extends FormSchema, K extends FormFi
 type FormsReactOptions<TSchemas extends FormSchemaMap = FormSchemaMap> = Omit<InitFormsOptions<TSchemas>, 'core'>;
 //#endregion
 //#region src/react/forms-module.d.ts
-declare function forms<const TSchemas extends FormSchemaMap>(options: FormsReactOptions<TSchemas>): EmbeddablesReactModule<FormsClient<TSchemas>>;
+/**
+ * What `EmbeddablesProvider` accepts under its top-level `forms` prop.
+ *
+ * `analyticsInstance` is deliberately absent: the provider injects the
+ * Analytics module client through module dependencies, so an app never wires
+ * that instance by hand.
+ */
+type FormsProviderOptions = Omit<FormsReactOptions<RegisteredSchemas>, 'analyticsInstance'>;
+declare module '@embeddables/core/react' {
+  interface EmbeddablesReactModuleParameters {
+    readonly forms: FormsProviderOptions;
+  }
+}
+declare function forms(options?: FormsReactOptions<RegisteredSchemas>): EmbeddablesReactModule<FormsClient<RegisteredSchemas>, FormsProviderOptions>;
 //#endregion
 //#region src/react/register-forms-client.d.ts
-declare function registerFormsClient<const TSchemas extends FormSchemaMap>({ core, ...options }: InitFormsOptions<TSchemas>): FormsClient<TSchemas>;
+declare function registerFormsClient(options: InitFormsOptions<RegisteredSchemas>): FormsClient<RegisteredSchemas>;
 //#endregion
 //#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 };
+export { type EmbeddablesSchemaRegistry, type FormsProviderOptions, 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","../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"}
+{"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;;;;;;;;;;;iBCjBY,QACd,sBAAsB,mBACtB,iBAAiB,gBAAgB,qBAEjC;EAEA,QAAQ;;EAER,MAAM,aAAa,SAAS;EAC5B,QAAQ,kBAAkB,gBAAgB,SAAS;EACnD,QAAQ,kBAAkB,gBAAgB,SAAS;;;;iBCnBrC,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,SAAS,OAAO,WAAW,SAAS,mBAAmB,QAAQ,UAAU;EACzE,cAAc,QAAQ,UAAU;;;;KCjBtB,kBAAkB,iBAAiB,gBAAgB,iBAAiB,KAC9E,iBAAiB;;;;;;;;;;KCaP,uBAAuB,KAAK,kBAAkB;;YAG9C;aACC,OAAO;;;iBAsBJ,MACd,UAAS,kBAAkB,qBAC1B,uBAAuB,YAAY,oBAAoB;;;iBChB1C,oBACd,SAAS,iBAAiB,qBACzB,YAAY;;;iBCxBC,yBAAyB,eAAe,YAAY"}

package/dist/react.js

@@ -1,4 +1,4 @@
-import { t as initForms } from "./form-9Tp91g6a.js";
+import { n as initForms, s as FormsError } from "./form-Bt5pwVP6.js";
 import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from "react";
 import { useEmbeddablesModule } from "@embeddables/core/react";
 //#region src/react/use-form-store.ts
@@ -65,14 +65,9 @@ function useRegisteredFormsClient() {
 * (`useForm<'signup', OtherSchemas>`) only to work against a map other than the
 * registered one.
 */
-function useForm({ formId, customValidations }) {
+function useForm({ formId }) {
 	const client = useRegisteredFormsClient();
-	const customValidationsRef = useRef(customValidations);
-	customValidationsRef.current = customValidations;
-	const form = client === null ? null : client.getForm({
-		formId,
-		customValidations: customValidationsRef.current
-	});
+	const form = client === null ? null : client.getForm({ formId });
 	const { values, errors } = useFormSnapshot(form);
 	return {
 		form,
@@ -106,6 +101,11 @@ function useFormField({ form, key }) {
 	const setValue = useCallback((value) => {
 		setDraft(value);
 	}, []);
+	const commit = useCallback((value) => {
+		if (form === null) return noopSetValue();
+		setDraft(value);
+		return form.set({ [key]: value });
+	}, [form, key]);
 	const onBlur = useCallback(async () => {
 		if (form === null) return noopSetValue();
 		if (draft === committed) return {
@@ -123,12 +123,14 @@ function useFormField({ form, key }) {
 		value: void 0,
 		error: void 0,
 		setValue: () => void 0,
+		commit: async () => noopSetValue(),
 		onBlur: async () => noopSetValue()
 	};
 	return {
 		value: draft,
 		error: errors[key],
 		setValue,
+		commit,
 		onBlur
 	};
 }
@@ -140,10 +142,11 @@ function resolveCoreAnalyticsInstance(core) {
 }
 //#endregion
 //#region src/react/register-forms-client.ts
-function registerFormsClient({ core, ...options }) {
+function register({ disableAnalyticsFallback, ...options }) {
+	const { core } = options;
 	const existing = formsByCore.get(core);
 	if (existing !== void 0) return existing;
-	const analyticsInstance = options.analyticsInstance ?? resolveCoreAnalyticsInstance(core);
+	const analyticsInstance = disableAnalyticsFallback ? void 0 : options.analyticsInstance ?? resolveCoreAnalyticsInstance(core);
 	const client = initForms({
 		...options,
 		core,
@@ -152,15 +155,39 @@ function registerFormsClient({ core, ...options }) {
 	formsByCore.set(core, client);
 	return client;
 }
+function registerFormsClient(options) {
+	return register(options);
+}
+function registerFormsModuleClient(options) {
+	return register(options);
+}
 //#endregion
 //#region src/react/forms-module.ts
-function forms(options) {
+const ANALYTICS_MODULE_KEY = "analytics";
+function resolveInjectedAnalytics(value) {
+	if (value === void 0) return void 0;
+	if (typeof value !== "object" || value === null) throw new FormsError("Forms received an invalid Analytics module dependency.");
+	const candidate = value;
+	if (typeof candidate.trackEvent !== "function" || typeof candidate.getAppUserId !== "function" || typeof candidate.getProjectId !== "function") throw new FormsError("Forms received an invalid Analytics module dependency.");
+	return candidate;
+}
+function forms(options = {}) {
 	return {
 		key: FORMS_MODULE_KEY,
-		init: (core) => registerFormsClient({
-			core,
-			...options
-		})
+		dependencies: [{
+			key: ANALYTICS_MODULE_KEY,
+			optional: true
+		}],
+		init: (core, context) => {
+			const analyticsInstance = context?.analyticsExcluded ? void 0 : options.analyticsInstance ?? resolveInjectedAnalytics(context?.dependencies.get(ANALYTICS_MODULE_KEY));
+			return registerFormsModuleClient({
+				core,
+				customValidations: context?.parameters?.customValidations ?? options.customValidations,
+				serverFormData: context?.parameters?.serverFormData ?? options.serverFormData,
+				analyticsInstance,
+				disableAnalyticsFallback: context?.analyticsExcluded
+			});
+		}
 	};
 }
 //#endregion

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\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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"}
+{"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 { useFormSnapshot } from './use-form-store.js'\nimport { useRegisteredFormsClient } from './use-forms.js'\n\nimport type { 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}: {\n  formId: 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\n  // * Safe to call on every render: the client returns one instance per form id.\n  const form = client === null ? null : client.getForm({ formId })\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] | undefined) => void\n  commit: (value: FormValues<TSchema>[K] | undefined) => Promise<SetResult<TSchema>>\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] | undefined) => {\n    setDraft(value)\n  }, [])\n\n  // * Takes the value as an argument rather than reading `draft`, so it is\n  // * correct when called in the same tick as the change that produced it.\n  // * `onBlur` cannot be: it compares the `draft`/`committed` pair captured in\n  // * the current render, which a same-tick `setValue` has not updated yet.\n  const commit = useCallback(\n    (value: FormValues<TSchema>[K] | undefined): Promise<SetResult<TSchema>> => {\n      if (form === null) return noopSetValue()\n      // * Keeps the control responsive while `set` runs, and keeps a rejected\n      // * value on screen next to its error instead of snapping back.\n      setDraft(value)\n      return form.set({ [key]: value } as Partial<FormValues<TSchema>>)\n    },\n    [form, key],\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      commit: async () => noopSetValue(),\n      onBlur: async () => noopSetValue(),\n    }\n  }\n\n  return {\n    value: draft,\n    error: errors[key],\n    setValue,\n    commit,\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 { FormsClient, InitFormsOptions } from '../core/form.js'\nimport type { RegisteredSchemas } from './schema-registry.js'\n\ninterface RegisterFormsModuleClientOptions extends InitFormsOptions<RegisteredSchemas> {\n  /**\n   * Set when `excludeAnalyticsInModules` names Forms. The exclusion is absolute:\n   * it suppresses the Core-instance fallback as well as the injected client.\n   */\n  disableAnalyticsFallback?: boolean\n}\n\nfunction register({\n  disableAnalyticsFallback,\n  ...options\n}: RegisterFormsModuleClientOptions): FormsClient<RegisteredSchemas> {\n  const { core } = options\n  const existing = formsByCore.get(core)\n  if (existing !== undefined) return existing\n\n  const analyticsInstance = disableAnalyticsFallback\n    ? undefined\n    : (options.analyticsInstance ?? resolveCoreAnalyticsInstance(core))\n\n  const client = initForms<RegisteredSchemas>({ ...options, core, analyticsInstance })\n  formsByCore.set(core, client)\n  return client\n}\n\nexport function registerFormsClient(\n  options: InitFormsOptions<RegisteredSchemas>,\n): FormsClient<RegisteredSchemas> {\n  return register(options)\n}\n\nexport function registerFormsModuleClient(\n  options: RegisterFormsModuleClientOptions,\n): FormsClient<RegisteredSchemas> {\n  return register(options)\n}\n","import type { EmbeddablesReactModule } from '@embeddables/core/react'\n\nimport { FormsError } from '../errors.js'\nimport { FORMS_MODULE_KEY } from './forms-registry.js'\nimport { registerFormsModuleClient } from './register-forms-client.js'\n\nimport type { AnalyticsInstance } from '../core/analytics.js'\nimport type { FormsClient } from '../core/form.js'\nimport type { RegisteredSchemas } from './schema-registry.js'\nimport type { FormsReactOptions } from './use-forms.js'\n\nexport type { FormsReactOptions } from './use-forms.js'\n\n/**\n * What `EmbeddablesProvider` accepts under its top-level `forms` prop.\n *\n * `analyticsInstance` is deliberately absent: the provider injects the\n * Analytics module client through module dependencies, so an app never wires\n * that instance by hand.\n */\nexport type FormsProviderOptions = Omit<FormsReactOptions<RegisteredSchemas>, 'analyticsInstance'>\n\ndeclare module '@embeddables/core/react' {\n  interface EmbeddablesReactModuleParameters {\n    readonly forms: FormsProviderOptions\n  }\n}\n\nconst ANALYTICS_MODULE_KEY = 'analytics'\n\nfunction resolveInjectedAnalytics(value: unknown): AnalyticsInstance | undefined {\n  if (value === undefined) return undefined\n  if (typeof value !== 'object' || value === null) {\n    throw new FormsError('Forms received an invalid Analytics module dependency.')\n  }\n  const candidate = value as Partial<AnalyticsInstance>\n  if (\n    typeof candidate.trackEvent !== 'function' ||\n    typeof candidate.getAppUserId !== 'function' ||\n    typeof candidate.getProjectId !== 'function'\n  ) {\n    throw new FormsError('Forms received an invalid Analytics module dependency.')\n  }\n  return candidate as AnalyticsInstance\n}\n\nexport function forms(\n  options: FormsReactOptions<RegisteredSchemas> = {},\n): EmbeddablesReactModule<FormsClient<RegisteredSchemas>, FormsProviderOptions> {\n  return {\n    key: FORMS_MODULE_KEY,\n    dependencies: [{ key: ANALYTICS_MODULE_KEY, optional: true }],\n    init: (core, context) => {\n      const analyticsInstance = context?.analyticsExcluded\n        ? undefined\n        : (options.analyticsInstance ??\n          resolveInjectedAnalytics(context?.dependencies.get(ANALYTICS_MODULE_KEY)))\n\n      return registerFormsModuleClient({\n        core,\n        customValidations: context?.parameters?.customValidations ?? options.customValidations,\n        serverFormData: context?.parameters?.serverFormData ?? options.serverFormData,\n        analyticsInstance,\n        disableAnalyticsFallback: context?.analyticsExcluded,\n      })\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/server.cjs

@@ -0,0 +1,50 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_form = require("./form-BOHdxeuO.cjs");
+//#region src/core/server.ts
+function toServerFormInstance(instance) {
+	return {
+		key: instance.key,
+		set: (patch) => instance.set(patch),
+		get: (key) => instance.get(key),
+		getAll: () => instance.getAll(),
+		getValueByProtocolFieldId: (protocolFieldId) => instance.getValueByProtocolFieldId(protocolFieldId)
+	};
+}
+function initFormsServer(options) {
+	const server = options.server;
+	if (typeof server.getProjectId !== "function" || typeof server.getAppUserId !== "function") throw new require_form.FormsError("initFormsServer requires an initialized Embeddables server instance.");
+	if (typeof server.getFormIds !== "function" || typeof server.getFormSchema !== "function") throw new require_form.FormsError("initFormsServer requires a Core instance with registered form schemas.");
+	const projectId = server.getProjectId();
+	const storage = require_form.createMemoryFormsStorage();
+	require_form.seedServerFormsStorageFromCookies({
+		storage,
+		projectId,
+		formIds: server.getFormIds(),
+		getFormSchema: (formId) => server.getFormSchema(formId),
+		getCookie: (key) => server.getCookie(key)
+	});
+	const client = require_form.createFormsClient({
+		core: server,
+		customValidations: options.customValidations,
+		analyticsInstance: options.analyticsInstance,
+		storage,
+		persistence: require_form.createNoopPersistence()
+	});
+	return {
+		getForm({ formId }) {
+			return toServerFormInstance(client.getForm({ formId }));
+		},
+		getServerFormData() {
+			const data = {};
+			for (const formId of server.getFormIds()) {
+				const key = formId;
+				data[key] = client.getForm({ formId: key }).getAll();
+			}
+			return data;
+		}
+	};
+}
+//#endregion
+exports.initFormsServer = initFormsServer;
+
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":["FormsError","createMemoryFormsStorage","createFormsClient","createNoopPersistence"],"sources":["../src/core/server.ts"],"sourcesContent":["import { FormsError } from '../errors.js'\nimport { seedServerFormsStorageFromCookies } from '../storage/cookie-form-data.js'\nimport { createNoopPersistence } from '../storage/persistence.js'\nimport { createMemoryFormsStorage } from '../storage/storage.js'\nimport { createFormsClient } from './form.js'\n\nimport type { FormSchema } from './config.js'\nimport type {\n  FormInstance,\n  FormSchemaMap,\n  FormsClientOptions,\n  FormsServerInitOptions,\n  ServerFormDataByFormId,\n  ServerFormInstance,\n} from './form.js'\n\nexport type { FormsServerInitOptions } from './form.js'\n\nexport interface FormsServerClient<TSchemas extends FormSchemaMap = FormSchemaMap> {\n  getForm<K extends keyof TSchemas & string>(params: { formId: K }): ServerFormInstance<TSchemas[K]>\n  /** Current values for every initialized form — pass to client `initForms` as `serverFormData`. */\n  getServerFormData(): ServerFormDataByFormId<TSchemas>\n}\n\nfunction toServerFormInstance<TSchema extends FormSchema = FormSchema>(\n  instance: FormInstance<TSchema>,\n): ServerFormInstance<TSchema> {\n  return {\n    key: instance.key,\n    set: (patch) => instance.set(patch),\n    get: (key) => instance.get(key),\n    getAll: () => instance.getAll(),\n    getValueByProtocolFieldId: (protocolFieldId) =>\n      instance.getValueByProtocolFieldId(protocolFieldId),\n  }\n}\n\nexport function initFormsServer<TSchemas extends FormSchemaMap = FormSchemaMap>(\n  options: FormsServerInitOptions<TSchemas>,\n): FormsServerClient<TSchemas> {\n  const server = options.server\n  if (typeof server.getProjectId !== 'function' || typeof server.getAppUserId !== 'function') {\n    throw new FormsError('initFormsServer requires an initialized Embeddables server instance.')\n  }\n\n  if (typeof server.getFormIds !== 'function' || typeof server.getFormSchema !== 'function') {\n    throw new FormsError('initFormsServer requires a Core instance with registered form schemas.')\n  }\n\n  const projectId = server.getProjectId()\n  const storage = createMemoryFormsStorage()\n  seedServerFormsStorageFromCookies({\n    storage,\n    projectId,\n    formIds: server.getFormIds(),\n    getFormSchema: (formId) => server.getFormSchema(formId),\n    getCookie: (key) => server.getCookie(key),\n  })\n\n  const client = createFormsClient<TSchemas>({\n    core: server,\n    customValidations: options.customValidations,\n    analyticsInstance: options.analyticsInstance,\n    storage,\n    persistence: createNoopPersistence(),\n  } satisfies FormsClientOptions)\n\n  const serverClient = {\n    getForm({ formId }: { formId: keyof TSchemas & string }) {\n      return toServerFormInstance(client.getForm({ formId }))\n    },\n    getServerFormData() {\n      const data: ServerFormDataByFormId<TSchemas> = {}\n      for (const formId of server.getFormIds()) {\n        const key = formId as keyof TSchemas & string\n        data[key] = client.getForm({ formId: key }).getAll()\n      }\n      return data\n    },\n  } satisfies FormsServerClient<TSchemas>\n\n  return serverClient\n}\n"],"mappings":";;;AAwBA,SAAS,qBACP,UAC6B;CAC7B,OAAO;EACL,KAAK,SAAS;EACd,MAAM,UAAU,SAAS,IAAI,KAAK;EAClC,MAAM,QAAQ,SAAS,IAAI,GAAG;EAC9B,cAAc,SAAS,OAAO;EAC9B,4BAA4B,oBAC1B,SAAS,0BAA0B,eAAe;CACtD;AACF;AAEA,SAAgB,gBACd,SAC6B;CAC7B,MAAM,SAAS,QAAQ;CACvB,IAAI,OAAO,OAAO,iBAAiB,cAAc,OAAO,OAAO,iBAAiB,YAC9E,MAAM,IAAIA,aAAAA,WAAW,sEAAsE;CAG7F,IAAI,OAAO,OAAO,eAAe,cAAc,OAAO,OAAO,kBAAkB,YAC7E,MAAM,IAAIA,aAAAA,WAAW,wEAAwE;CAG/F,MAAM,YAAY,OAAO,aAAa;CACtC,MAAM,UAAUC,aAAAA,yBAAyB;CACzC,aAAA,kCAAkC;EAChC;EACA;EACA,SAAS,OAAO,WAAW;EAC3B,gBAAgB,WAAW,OAAO,cAAc,MAAM;EACtD,YAAY,QAAQ,OAAO,UAAU,GAAG;CAC1C,CAAC;CAED,MAAM,SAASC,aAAAA,kBAA4B;EACzC,MAAM;EACN,mBAAmB,QAAQ;EAC3B,mBAAmB,QAAQ;EAC3B;EACA,aAAaC,aAAAA,sBAAsB;CACrC,CAA8B;CAgB9B,OAAO;EAbL,QAAQ,EAAE,UAA+C;GACvD,OAAO,qBAAqB,OAAO,QAAQ,EAAE,OAAO,CAAC,CAAC;EACxD;EACA,oBAAoB;GAClB,MAAM,OAAyC,CAAC;GAChD,KAAK,MAAM,UAAU,OAAO,WAAW,GAAG;IACxC,MAAM,MAAM;IACZ,KAAK,OAAO,OAAO,QAAQ,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO;GACrD;GACA,OAAO;EACT;CAGgB;AACpB"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { a as FormSchemaMap, c as FormsServerInitOptions, d as ServerFormInstance, u as ServerFormDataByFormId } from "./form-Br23yPDS.js";
+//#region src/core/server.d.ts
+interface FormsServerClient<TSchemas extends FormSchemaMap = FormSchemaMap> {
+  getForm<K extends keyof TSchemas & string>(params: {
+    formId: K;
+  }): ServerFormInstance<TSchemas[K]>;
+  /** Current values for every initialized form — pass to client `initForms` as `serverFormData`. */
+  getServerFormData(): ServerFormDataByFormId<TSchemas>;
+}
+declare function initFormsServer<TSchemas extends FormSchemaMap = FormSchemaMap>(options: FormsServerInitOptions<TSchemas>): FormsServerClient<TSchemas>;
+//#endregion
+export { type FormsServerClient, type FormsServerInitOptions, type ServerFormDataByFormId, type ServerFormInstance, initFormsServer };
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","names":[],"sources":["../src/core/server.ts"],"mappings":";;UAkBiB,kBAAkB,iBAAiB,gBAAgB;EAClE,QAAQ,gBAAgB,mBAAmB;IAAU,QAAQ;MAAM,mBAAmB,SAAS;;EAE/F,qBAAqB,uBAAuB;;iBAgB9B,gBAAgB,iBAAiB,gBAAgB,eAC/D,SAAS,uBAAuB,YAC/B,kBAAkB"}

package/dist/server.js

@@ -0,0 +1,49 @@
+import { i as seedServerFormsStorageFromCookies, o as createMemoryFormsStorage, r as createNoopPersistence, s as FormsError, t as createFormsClient } from "./form-Bt5pwVP6.js";
+//#region src/core/server.ts
+function toServerFormInstance(instance) {
+	return {
+		key: instance.key,
+		set: (patch) => instance.set(patch),
+		get: (key) => instance.get(key),
+		getAll: () => instance.getAll(),
+		getValueByProtocolFieldId: (protocolFieldId) => instance.getValueByProtocolFieldId(protocolFieldId)
+	};
+}
+function initFormsServer(options) {
+	const server = options.server;
+	if (typeof server.getProjectId !== "function" || typeof server.getAppUserId !== "function") throw new FormsError("initFormsServer requires an initialized Embeddables server instance.");
+	if (typeof server.getFormIds !== "function" || typeof server.getFormSchema !== "function") throw new FormsError("initFormsServer requires a Core instance with registered form schemas.");
+	const projectId = server.getProjectId();
+	const storage = createMemoryFormsStorage();
+	seedServerFormsStorageFromCookies({
+		storage,
+		projectId,
+		formIds: server.getFormIds(),
+		getFormSchema: (formId) => server.getFormSchema(formId),
+		getCookie: (key) => server.getCookie(key)
+	});
+	const client = createFormsClient({
+		core: server,
+		customValidations: options.customValidations,
+		analyticsInstance: options.analyticsInstance,
+		storage,
+		persistence: createNoopPersistence()
+	});
+	return {
+		getForm({ formId }) {
+			return toServerFormInstance(client.getForm({ formId }));
+		},
+		getServerFormData() {
+			const data = {};
+			for (const formId of server.getFormIds()) {
+				const key = formId;
+				data[key] = client.getForm({ formId: key }).getAll();
+			}
+			return data;
+		}
+	};
+}
+//#endregion
+export { initFormsServer };
+
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","names":[],"sources":["../src/core/server.ts"],"sourcesContent":["import { FormsError } from '../errors.js'\nimport { seedServerFormsStorageFromCookies } from '../storage/cookie-form-data.js'\nimport { createNoopPersistence } from '../storage/persistence.js'\nimport { createMemoryFormsStorage } from '../storage/storage.js'\nimport { createFormsClient } from './form.js'\n\nimport type { FormSchema } from './config.js'\nimport type {\n  FormInstance,\n  FormSchemaMap,\n  FormsClientOptions,\n  FormsServerInitOptions,\n  ServerFormDataByFormId,\n  ServerFormInstance,\n} from './form.js'\n\nexport type { FormsServerInitOptions } from './form.js'\n\nexport interface FormsServerClient<TSchemas extends FormSchemaMap = FormSchemaMap> {\n  getForm<K extends keyof TSchemas & string>(params: { formId: K }): ServerFormInstance<TSchemas[K]>\n  /** Current values for every initialized form — pass to client `initForms` as `serverFormData`. */\n  getServerFormData(): ServerFormDataByFormId<TSchemas>\n}\n\nfunction toServerFormInstance<TSchema extends FormSchema = FormSchema>(\n  instance: FormInstance<TSchema>,\n): ServerFormInstance<TSchema> {\n  return {\n    key: instance.key,\n    set: (patch) => instance.set(patch),\n    get: (key) => instance.get(key),\n    getAll: () => instance.getAll(),\n    getValueByProtocolFieldId: (protocolFieldId) =>\n      instance.getValueByProtocolFieldId(protocolFieldId),\n  }\n}\n\nexport function initFormsServer<TSchemas extends FormSchemaMap = FormSchemaMap>(\n  options: FormsServerInitOptions<TSchemas>,\n): FormsServerClient<TSchemas> {\n  const server = options.server\n  if (typeof server.getProjectId !== 'function' || typeof server.getAppUserId !== 'function') {\n    throw new FormsError('initFormsServer requires an initialized Embeddables server instance.')\n  }\n\n  if (typeof server.getFormIds !== 'function' || typeof server.getFormSchema !== 'function') {\n    throw new FormsError('initFormsServer requires a Core instance with registered form schemas.')\n  }\n\n  const projectId = server.getProjectId()\n  const storage = createMemoryFormsStorage()\n  seedServerFormsStorageFromCookies({\n    storage,\n    projectId,\n    formIds: server.getFormIds(),\n    getFormSchema: (formId) => server.getFormSchema(formId),\n    getCookie: (key) => server.getCookie(key),\n  })\n\n  const client = createFormsClient<TSchemas>({\n    core: server,\n    customValidations: options.customValidations,\n    analyticsInstance: options.analyticsInstance,\n    storage,\n    persistence: createNoopPersistence(),\n  } satisfies FormsClientOptions)\n\n  const serverClient = {\n    getForm({ formId }: { formId: keyof TSchemas & string }) {\n      return toServerFormInstance(client.getForm({ formId }))\n    },\n    getServerFormData() {\n      const data: ServerFormDataByFormId<TSchemas> = {}\n      for (const formId of server.getFormIds()) {\n        const key = formId as keyof TSchemas & string\n        data[key] = client.getForm({ formId: key }).getAll()\n      }\n      return data\n    },\n  } satisfies FormsServerClient<TSchemas>\n\n  return serverClient\n}\n"],"mappings":";;AAwBA,SAAS,qBACP,UAC6B;CAC7B,OAAO;EACL,KAAK,SAAS;EACd,MAAM,UAAU,SAAS,IAAI,KAAK;EAClC,MAAM,QAAQ,SAAS,IAAI,GAAG;EAC9B,cAAc,SAAS,OAAO;EAC9B,4BAA4B,oBAC1B,SAAS,0BAA0B,eAAe;CACtD;AACF;AAEA,SAAgB,gBACd,SAC6B;CAC7B,MAAM,SAAS,QAAQ;CACvB,IAAI,OAAO,OAAO,iBAAiB,cAAc,OAAO,OAAO,iBAAiB,YAC9E,MAAM,IAAI,WAAW,sEAAsE;CAG7F,IAAI,OAAO,OAAO,eAAe,cAAc,OAAO,OAAO,kBAAkB,YAC7E,MAAM,IAAI,WAAW,wEAAwE;CAG/F,MAAM,YAAY,OAAO,aAAa;CACtC,MAAM,UAAU,yBAAyB;CACzC,kCAAkC;EAChC;EACA;EACA,SAAS,OAAO,WAAW;EAC3B,gBAAgB,WAAW,OAAO,cAAc,MAAM;EACtD,YAAY,QAAQ,OAAO,UAAU,GAAG;CAC1C,CAAC;CAED,MAAM,SAAS,kBAA4B;EACzC,MAAM;EACN,mBAAmB,QAAQ;EAC3B,mBAAmB,QAAQ;EAC3B;EACA,aAAa,sBAAsB;CACrC,CAA8B;CAgB9B,OAAO;EAbL,QAAQ,EAAE,UAA+C;GACvD,OAAO,qBAAqB,OAAO,QAAQ,EAAE,OAAO,CAAC,CAAC;EACxD;EACA,oBAAoB;GAClB,MAAM,OAAyC,CAAC;GAChD,KAAK,MAAM,UAAU,OAAO,WAAW,GAAG;IACxC,MAAM,MAAM;IACZ,KAAK,OAAO,OAAO,QAAQ,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO;GACrD;GACA,OAAO;EACT;CAGgB;AACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embeddables/forms",
-  "version": "0.0.5",
+  "version": "0.2.0",
   "description": "Schema-driven form state, local persistence, and analytics events for Embeddables funnels.",
   "private": false,
   "type": "module",
@@ -26,6 +26,11 @@
       "types": "./dist/react.d.ts",
       "import": "./dist/react.js",
       "require": "./dist/react.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
     }
   },
   "files": [
@@ -39,7 +44,7 @@
     "hono": "^4.12.25"
   },
   "peerDependencies": {
-    "@embeddables/core": ">=0.0.3",
+    "@embeddables/core": ">=0.1.0",
     "react": ">=18"
   },
   "devDependencies": {
@@ -52,7 +57,7 @@
     "tsdown": "^0.22.14",
     "typescript": "~6.0.2",
     "vitest": "^4.1.9",
-    "@embeddables/core": "0.0.4",
+    "@embeddables/core": "0.1.0",
     "@embeddables/shared-types": "1.0.0",
     "backend-worker": "1.0.0"
   },