@10x-media/form-builder 0.1.0-beta.0 → 0.1.0-beta.10

package/dist/react/captcha/RecaptchaCaptcha.js

@@ -0,0 +1,93 @@
+"use client";
+import { useCaptchaScript } from "./useCaptchaScript.js";
+import { getGrecaptcha } from "./vendors.js";
+import { jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useImperativeHandle, useRef } from "react";
+//#region src/react/captcha/RecaptchaCaptcha.tsx
+const RECAPTCHA_SCRIPT_URL = "https://www.google.com/recaptcha/api.js";
+/**
+* Headless Google reCAPTCHA widget for v2 (checkbox) and v3 (invisible, score-based). v2 reports
+* tokens as the user solves the challenge; v3 fetches an initial token on mount and exposes
+* `execute` on the ref for on-demand refresh. Pass the latest token to `<Form captchaToken>`.
+*/
+const RecaptchaCaptcha = ({ siteKey, version, action, onToken, options, className, scriptSrc, ref }) => {
+	const src = scriptSrc ?? `https://www.google.com/recaptcha/api.js?render=${version === "v3" ? siteKey : "explicit"}`;
+	const containerRef = useRef(null);
+	const widgetIdRef = useRef(null);
+	const onTokenRef = useRef(onToken);
+	onTokenRef.current = onToken;
+	const optionsRef = useRef(options);
+	optionsRef.current = options;
+	const actionRef = useRef(action);
+	actionRef.current = action;
+	const ready = useCaptchaScript(src);
+	const execute = useCallback(async (overrideAction) => {
+		const api = getGrecaptcha();
+		if (!api || version !== "v3") return null;
+		try {
+			const token = await api.execute(siteKey, { action: overrideAction ?? actionRef.current ?? "submit" });
+			onTokenRef.current(token);
+			return token;
+		} catch {
+			onTokenRef.current(null);
+			return null;
+		}
+	}, [siteKey, version]);
+	useImperativeHandle(ref, () => ({
+		reset: () => {
+			const api = getGrecaptcha();
+			if (api && version === "v2" && widgetIdRef.current !== null) api.reset(widgetIdRef.current);
+			onTokenRef.current(null);
+		},
+		execute
+	}), [execute, version]);
+	useEffect(() => {
+		if (!ready) return;
+		const api = getGrecaptcha();
+		if (!api) return;
+		let active = true;
+		if (version === "v3") {
+			api.ready(() => {
+				if (active) execute();
+			});
+			return () => {
+				active = false;
+			};
+		}
+		const container = containerRef.current;
+		if (!container) return;
+		api.ready(() => {
+			if (!active || widgetIdRef.current !== null) return;
+			widgetIdRef.current = api.render(container, {
+				...optionsRef.current,
+				sitekey: siteKey,
+				callback: (token) => onTokenRef.current(token),
+				"expired-callback": () => onTokenRef.current(null),
+				"error-callback": () => onTokenRef.current(null)
+			});
+		});
+		return () => {
+			active = false;
+			if (widgetIdRef.current !== null) {
+				try {
+					api.reset(widgetIdRef.current);
+				} catch {}
+				widgetIdRef.current = null;
+			}
+			container.replaceChildren();
+		};
+	}, [
+		ready,
+		siteKey,
+		version,
+		execute
+	]);
+	return /* @__PURE__ */ jsx("div", {
+		ref: containerRef,
+		className
+	});
+};
+//#endregion
+export { RECAPTCHA_SCRIPT_URL, RecaptchaCaptcha };
+
+//# sourceMappingURL=RecaptchaCaptcha.js.map

package/dist/react/captcha/RecaptchaCaptcha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecaptchaCaptcha.js","names":[],"sources":["../../../src/react/captcha/RecaptchaCaptcha.tsx"],"sourcesContent":["'use client'\n\nimport { type Ref, useCallback, useEffect, useImperativeHandle, useRef } from 'react'\nimport type { CaptchaWidgetHandle } from './types'\nimport { useCaptchaScript } from './useCaptchaScript'\nimport { getGrecaptcha } from './vendors'\n\nexport const RECAPTCHA_SCRIPT_URL = 'https://www.google.com/recaptcha/api.js'\n\nexport type RecaptchaCaptchaHandle = CaptchaWidgetHandle & {\n\t/**\n\t * v3 only: fetch a fresh token on demand and report it through `onToken`. v3 tokens expire\n\t * after about two minutes, so call this right before submit for a long-lived form. Resolves\n\t * null for v2 or when execution fails.\n\t */\n\texecute: (action?: string) => Promise<string | null>\n}\n\nexport type RecaptchaCaptchaProps = {\n\t/** reCAPTCHA site key (public). */\n\tsiteKey: string\n\t/** 'v2' renders the checkbox widget; 'v3' runs invisibly and produces score-based tokens. */\n\tversion: 'v2' | 'v3'\n\t/** v3 action name reported to reCAPTCHA. Default 'submit'. */\n\taction?: string\n\t/** Receives each fresh token, and null when the token expires, errors, or is reset. */\n\tonToken: (token: string | null) => void\n\t/** Extra vendor render params for v2 (theme, size, ...). */\n\toptions?: Record<string, unknown>\n\tclassName?: string\n\t/** Override the vendor script URL (the version-specific `render` query is not appended). */\n\tscriptSrc?: string\n\tref?: Ref<RecaptchaCaptchaHandle>\n}\n\n/**\n * Headless Google reCAPTCHA widget for v2 (checkbox) and v3 (invisible, score-based). v2 reports\n * tokens as the user solves the challenge; v3 fetches an initial token on mount and exposes\n * `execute` on the ref for on-demand refresh. Pass the latest token to `<Form captchaToken>`.\n */\nexport const RecaptchaCaptcha = ({\n\tsiteKey,\n\tversion,\n\taction,\n\tonToken,\n\toptions,\n\tclassName,\n\tscriptSrc,\n\tref,\n}: RecaptchaCaptchaProps) => {\n\tconst src =\n\t\tscriptSrc ?? `${RECAPTCHA_SCRIPT_URL}?render=${version === 'v3' ? siteKey : 'explicit'}`\n\tconst containerRef = useRef<HTMLDivElement>(null)\n\tconst widgetIdRef = useRef<number | null>(null)\n\tconst onTokenRef = useRef(onToken)\n\tonTokenRef.current = onToken\n\tconst optionsRef = useRef(options)\n\toptionsRef.current = options\n\tconst actionRef = useRef(action)\n\tactionRef.current = action\n\tconst ready = useCaptchaScript(src)\n\n\tconst execute = useCallback(\n\t\tasync (overrideAction?: string): Promise<string | null> => {\n\t\t\tconst api = getGrecaptcha()\n\t\t\tif (!api || version !== 'v3') {\n\t\t\t\treturn null\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst token = await api.execute(siteKey, {\n\t\t\t\t\taction: overrideAction ?? actionRef.current ?? 'submit',\n\t\t\t\t})\n\t\t\t\tonTokenRef.current(token)\n\t\t\t\treturn token\n\t\t\t} catch {\n\t\t\t\tonTokenRef.current(null)\n\t\t\t\treturn null\n\t\t\t}\n\t\t},\n\t\t[siteKey, version]\n\t)\n\n\tuseImperativeHandle(\n\t\tref,\n\t\t() => ({\n\t\t\treset: () => {\n\t\t\t\tconst api = getGrecaptcha()\n\t\t\t\tif (api && version === 'v2' && widgetIdRef.current !== null) {\n\t\t\t\t\tapi.reset(widgetIdRef.current)\n\t\t\t\t}\n\t\t\t\tonTokenRef.current(null)\n\t\t\t},\n\t\t\texecute,\n\t\t}),\n\t\t[execute, version]\n\t)\n\n\tuseEffect(() => {\n\t\tif (!ready) {\n\t\t\treturn\n\t\t}\n\t\tconst api = getGrecaptcha()\n\t\tif (!api) {\n\t\t\treturn\n\t\t}\n\t\tlet active = true\n\t\tif (version === 'v3') {\n\t\t\tapi.ready(() => {\n\t\t\t\tif (active) {\n\t\t\t\t\tvoid execute()\n\t\t\t\t}\n\t\t\t})\n\t\t\treturn () => {\n\t\t\t\tactive = false\n\t\t\t}\n\t\t}\n\t\tconst container = containerRef.current\n\t\tif (!container) {\n\t\t\treturn\n\t\t}\n\t\tapi.ready(() => {\n\t\t\tif (!active || widgetIdRef.current !== null) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\twidgetIdRef.current = api.render(container, {\n\t\t\t\t...optionsRef.current,\n\t\t\t\tsitekey: siteKey,\n\t\t\t\tcallback: (token: string) => onTokenRef.current(token),\n\t\t\t\t'expired-callback': () => onTokenRef.current(null),\n\t\t\t\t'error-callback': () => onTokenRef.current(null),\n\t\t\t})\n\t\t})\n\t\treturn () => {\n\t\t\tactive = false\n\t\t\tif (widgetIdRef.current !== null) {\n\t\t\t\ttry {\n\t\t\t\t\tapi.reset(widgetIdRef.current)\n\t\t\t\t} catch {}\n\t\t\t\twidgetIdRef.current = null\n\t\t\t}\n\t\t\t// grecaptcha has no remove(); clearing the container drops the detached widget DOM.\n\t\t\tcontainer.replaceChildren()\n\t\t}\n\t}, [ready, siteKey, version, execute])\n\n\treturn <div ref={containerRef} className={className} />\n}\n"],"mappings":";;;;;;AAOA,MAAa,uBAAuB;;;;;;AAiCpC,MAAa,oBAAoB,EAChC,SACA,SACA,QACA,SACA,SACA,WACA,WACA,UAC4B;CAC5B,MAAM,MACL,aAAa,kDAAkC,YAAY,OAAO,UAAU;CAC7E,MAAM,eAAe,OAAuB,IAAI;CAChD,MAAM,cAAc,OAAsB,IAAI;CAC9C,MAAM,aAAa,OAAO,OAAO;CACjC,WAAW,UAAU;CACrB,MAAM,aAAa,OAAO,OAAO;CACjC,WAAW,UAAU;CACrB,MAAM,YAAY,OAAO,MAAM;CAC/B,UAAU,UAAU;CACpB,MAAM,QAAQ,iBAAiB,GAAG;CAElC,MAAM,UAAU,YACf,OAAO,mBAAoD;EAC1D,MAAM,MAAM,cAAc;EAC1B,IAAI,CAAC,OAAO,YAAY,MACvB,OAAO;EAER,IAAI;GACH,MAAM,QAAQ,MAAM,IAAI,QAAQ,SAAS,EACxC,QAAQ,kBAAkB,UAAU,WAAW,SAChD,CAAC;GACD,WAAW,QAAQ,KAAK;GACxB,OAAO;EACR,QAAQ;GACP,WAAW,QAAQ,IAAI;GACvB,OAAO;EACR;CACD,GACA,CAAC,SAAS,OAAO,CAClB;CAEA,oBACC,YACO;EACN,aAAa;GACZ,MAAM,MAAM,cAAc;GAC1B,IAAI,OAAO,YAAY,QAAQ,YAAY,YAAY,MACtD,IAAI,MAAM,YAAY,OAAO;GAE9B,WAAW,QAAQ,IAAI;EACxB;EACA;CACD,IACA,CAAC,SAAS,OAAO,CAClB;CAEA,gBAAgB;EACf,IAAI,CAAC,OACJ;EAED,MAAM,MAAM,cAAc;EAC1B,IAAI,CAAC,KACJ;EAED,IAAI,SAAS;EACb,IAAI,YAAY,MAAM;GACrB,IAAI,YAAY;IACf,IAAI,QACH,QAAa;GAEf,CAAC;GACD,aAAa;IACZ,SAAS;GACV;EACD;EACA,MAAM,YAAY,aAAa;EAC/B,IAAI,CAAC,WACJ;EAED,IAAI,YAAY;GACf,IAAI,CAAC,UAAU,YAAY,YAAY,MACtC;GAED,YAAY,UAAU,IAAI,OAAO,WAAW;IAC3C,GAAG,WAAW;IACd,SAAS;IACT,WAAW,UAAkB,WAAW,QAAQ,KAAK;IACrD,0BAA0B,WAAW,QAAQ,IAAI;IACjD,wBAAwB,WAAW,QAAQ,IAAI;GAChD,CAAC;EACF,CAAC;EACD,aAAa;GACZ,SAAS;GACT,IAAI,YAAY,YAAY,MAAM;IACjC,IAAI;KACH,IAAI,MAAM,YAAY,OAAO;IAC9B,QAAQ,CAAC;IACT,YAAY,UAAU;GACvB;GAEA,UAAU,gBAAgB;EAC3B;CACD,GAAG;EAAC;EAAO;EAAS;EAAS;CAAO,CAAC;CAErC,OAAO,oBAAC,OAAD;EAAK,KAAK;EAAyB;CAAY,CAAA;AACvD"}

package/dist/react/captcha/TurnstileCaptcha.d.ts

@@ -0,0 +1,28 @@
+import { CaptchaWidgetHandle } from "./types.js";
+import { Ref } from "react";
+
+//#region src/react/captcha/TurnstileCaptcha.d.ts
+declare const TURNSTILE_SCRIPT_URL = "https://challenges.cloudflare.com/turnstile/v0/api.js?render=explicit";
+type TurnstileCaptchaProps = {
+  /** Turnstile site key (public). */siteKey: string; /** Receives each fresh token, and null when the token expires or errors. */
+  onToken: (token: string | null) => void; /** Extra vendor render params (theme, size, appearance, ...). */
+  options?: Record<string, unknown>;
+  className?: string; /** Override the vendor script URL. */
+  scriptSrc?: string;
+  ref?: Ref<CaptchaWidgetHandle>;
+};
+/**
+ * Headless Cloudflare Turnstile widget: loads the vendor script once, renders the widget into a
+ * bare div, and reports tokens through `onToken`. Pass the latest token to `<Form captchaToken>`.
+ */
+declare const TurnstileCaptcha: ({
+  siteKey,
+  onToken,
+  options,
+  className,
+  scriptSrc,
+  ref
+}: TurnstileCaptchaProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { TURNSTILE_SCRIPT_URL, TurnstileCaptcha, TurnstileCaptchaProps };
+//# sourceMappingURL=TurnstileCaptcha.d.ts.map

package/dist/react/captcha/TurnstileCaptcha.js

@@ -0,0 +1,53 @@
+"use client";
+import { useCaptchaScript } from "./useCaptchaScript.js";
+import { getTurnstile } from "./vendors.js";
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useImperativeHandle, useRef } from "react";
+//#region src/react/captcha/TurnstileCaptcha.tsx
+const TURNSTILE_SCRIPT_URL = "https://challenges.cloudflare.com/turnstile/v0/api.js?render=explicit";
+/**
+* Headless Cloudflare Turnstile widget: loads the vendor script once, renders the widget into a
+* bare div, and reports tokens through `onToken`. Pass the latest token to `<Form captchaToken>`.
+*/
+const TurnstileCaptcha = ({ siteKey, onToken, options, className, scriptSrc = TURNSTILE_SCRIPT_URL, ref }) => {
+	const containerRef = useRef(null);
+	const widgetIdRef = useRef(null);
+	const onTokenRef = useRef(onToken);
+	onTokenRef.current = onToken;
+	const optionsRef = useRef(options);
+	optionsRef.current = options;
+	const ready = useCaptchaScript(scriptSrc);
+	useImperativeHandle(ref, () => ({ reset: () => {
+		const api = getTurnstile();
+		if (api && widgetIdRef.current !== null) api.reset(widgetIdRef.current);
+		onTokenRef.current(null);
+	} }), []);
+	useEffect(() => {
+		if (!ready) return;
+		const container = containerRef.current;
+		const api = getTurnstile();
+		if (!container || !api) return;
+		const widgetId = api.render(container, {
+			...optionsRef.current,
+			sitekey: siteKey,
+			callback: (token) => onTokenRef.current(token),
+			"expired-callback": () => onTokenRef.current(null),
+			"error-callback": () => onTokenRef.current(null)
+		});
+		widgetIdRef.current = widgetId;
+		return () => {
+			widgetIdRef.current = null;
+			try {
+				api.remove(widgetId);
+			} catch {}
+		};
+	}, [ready, siteKey]);
+	return /* @__PURE__ */ jsx("div", {
+		ref: containerRef,
+		className
+	});
+};
+//#endregion
+export { TURNSTILE_SCRIPT_URL, TurnstileCaptcha };
+
+//# sourceMappingURL=TurnstileCaptcha.js.map

package/dist/react/captcha/TurnstileCaptcha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnstileCaptcha.js","names":[],"sources":["../../../src/react/captcha/TurnstileCaptcha.tsx"],"sourcesContent":["'use client'\n\nimport { type Ref, useEffect, useImperativeHandle, useRef } from 'react'\nimport type { CaptchaWidgetHandle } from './types'\nimport { useCaptchaScript } from './useCaptchaScript'\nimport { getTurnstile } from './vendors'\n\nexport const TURNSTILE_SCRIPT_URL =\n\t'https://challenges.cloudflare.com/turnstile/v0/api.js?render=explicit'\n\nexport type TurnstileCaptchaProps = {\n\t/** Turnstile site key (public). */\n\tsiteKey: string\n\t/** Receives each fresh token, and null when the token expires or errors. */\n\tonToken: (token: string | null) => void\n\t/** Extra vendor render params (theme, size, appearance, ...). */\n\toptions?: Record<string, unknown>\n\tclassName?: string\n\t/** Override the vendor script URL. */\n\tscriptSrc?: string\n\tref?: Ref<CaptchaWidgetHandle>\n}\n\n/**\n * Headless Cloudflare Turnstile widget: loads the vendor script once, renders the widget into a\n * bare div, and reports tokens through `onToken`. Pass the latest token to `<Form captchaToken>`.\n */\nexport const TurnstileCaptcha = ({\n\tsiteKey,\n\tonToken,\n\toptions,\n\tclassName,\n\tscriptSrc = TURNSTILE_SCRIPT_URL,\n\tref,\n}: TurnstileCaptchaProps) => {\n\tconst containerRef = useRef<HTMLDivElement>(null)\n\tconst widgetIdRef = useRef<string | null>(null)\n\tconst onTokenRef = useRef(onToken)\n\tonTokenRef.current = onToken\n\tconst optionsRef = useRef(options)\n\toptionsRef.current = options\n\tconst ready = useCaptchaScript(scriptSrc)\n\n\tuseImperativeHandle(\n\t\tref,\n\t\t() => ({\n\t\t\treset: () => {\n\t\t\t\tconst api = getTurnstile()\n\t\t\t\tif (api && widgetIdRef.current !== null) {\n\t\t\t\t\tapi.reset(widgetIdRef.current)\n\t\t\t\t}\n\t\t\t\tonTokenRef.current(null)\n\t\t\t},\n\t\t}),\n\t\t[]\n\t)\n\n\tuseEffect(() => {\n\t\tif (!ready) {\n\t\t\treturn\n\t\t}\n\t\tconst container = containerRef.current\n\t\tconst api = getTurnstile()\n\t\tif (!container || !api) {\n\t\t\treturn\n\t\t}\n\t\tconst widgetId = api.render(container, {\n\t\t\t...optionsRef.current,\n\t\t\tsitekey: siteKey,\n\t\t\tcallback: (token: string) => onTokenRef.current(token),\n\t\t\t'expired-callback': () => onTokenRef.current(null),\n\t\t\t'error-callback': () => onTokenRef.current(null),\n\t\t})\n\t\twidgetIdRef.current = widgetId\n\t\treturn () => {\n\t\t\twidgetIdRef.current = null\n\t\t\ttry {\n\t\t\t\tapi.remove(widgetId)\n\t\t\t} catch {}\n\t\t}\n\t}, [ready, siteKey])\n\n\treturn <div ref={containerRef} className={className} />\n}\n"],"mappings":";;;;;;AAOA,MAAa,uBACZ;;;;;AAmBD,MAAa,oBAAoB,EAChC,SACA,SACA,SACA,WACA,YAAY,sBACZ,UAC4B;CAC5B,MAAM,eAAe,OAAuB,IAAI;CAChD,MAAM,cAAc,OAAsB,IAAI;CAC9C,MAAM,aAAa,OAAO,OAAO;CACjC,WAAW,UAAU;CACrB,MAAM,aAAa,OAAO,OAAO;CACjC,WAAW,UAAU;CACrB,MAAM,QAAQ,iBAAiB,SAAS;CAExC,oBACC,YACO,EACN,aAAa;EACZ,MAAM,MAAM,aAAa;EACzB,IAAI,OAAO,YAAY,YAAY,MAClC,IAAI,MAAM,YAAY,OAAO;EAE9B,WAAW,QAAQ,IAAI;CACxB,EACD,IACA,CAAC,CACF;CAEA,gBAAgB;EACf,IAAI,CAAC,OACJ;EAED,MAAM,YAAY,aAAa;EAC/B,MAAM,MAAM,aAAa;EACzB,IAAI,CAAC,aAAa,CAAC,KAClB;EAED,MAAM,WAAW,IAAI,OAAO,WAAW;GACtC,GAAG,WAAW;GACd,SAAS;GACT,WAAW,UAAkB,WAAW,QAAQ,KAAK;GACrD,0BAA0B,WAAW,QAAQ,IAAI;GACjD,wBAAwB,WAAW,QAAQ,IAAI;EAChD,CAAC;EACD,YAAY,UAAU;EACtB,aAAa;GACZ,YAAY,UAAU;GACtB,IAAI;IACH,IAAI,OAAO,QAAQ;GACpB,QAAQ,CAAC;EACV;CACD,GAAG,CAAC,OAAO,OAAO,CAAC;CAEnB,OAAO,oBAAC,OAAD;EAAK,KAAK;EAAyB;CAAY,CAAA;AACvD"}

package/dist/react/captcha/types.d.ts

@@ -0,0 +1,8 @@
+//#region src/react/captcha/types.d.ts
+/** Imperative handle exposed by the captcha widget components via their `ref` prop. */
+type CaptchaWidgetHandle = {
+  /** Reset the widget, invalidating the current token. */reset: () => void;
+};
+//#endregion
+export { CaptchaWidgetHandle };
+//# sourceMappingURL=types.d.ts.map

package/dist/react/captcha/useCaptchaScript.js

@@ -0,0 +1,45 @@
+"use client";
+import { useEffect, useState } from "react";
+//#region src/react/captcha/useCaptchaScript.ts
+const pending = /* @__PURE__ */ new Map();
+const loadScript = (src) => {
+	const cached = pending.get(src);
+	if (cached) return cached;
+	const promise = new Promise((resolve, reject) => {
+		const script = document.createElement("script");
+		script.src = src;
+		script.async = true;
+		script.addEventListener("load", () => resolve());
+		script.addEventListener("error", () => {
+			pending.delete(src);
+			script.remove();
+			reject(/* @__PURE__ */ new Error(`Failed to load ${src}`));
+		});
+		document.head.appendChild(script);
+	});
+	pending.set(src, promise);
+	return promise;
+};
+/**
+* Load a vendor captcha script once per src, shared across all widget instances. SSR-safe (the
+* DOM is only touched inside the effect). A failed load evicts the cache entry so a later mount
+* can retry; consumers just see `ready` stay false.
+*/
+const useCaptchaScript = (src) => {
+	const [ready, setReady] = useState(false);
+	useEffect(() => {
+		let active = true;
+		setReady(false);
+		loadScript(src).then(() => {
+			if (active) setReady(true);
+		}, () => {});
+		return () => {
+			active = false;
+		};
+	}, [src]);
+	return ready;
+};
+//#endregion
+export { useCaptchaScript };
+
+//# sourceMappingURL=useCaptchaScript.js.map

package/dist/react/captcha/useCaptchaScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCaptchaScript.js","names":[],"sources":["../../../src/react/captcha/useCaptchaScript.ts"],"sourcesContent":["'use client'\n\nimport { useEffect, useState } from 'react'\n\nconst pending = new Map<string, Promise<void>>()\n\nconst loadScript = (src: string): Promise<void> => {\n\tconst cached = pending.get(src)\n\tif (cached) {\n\t\treturn cached\n\t}\n\tconst promise = new Promise<void>((resolve, reject) => {\n\t\tconst script = document.createElement('script')\n\t\tscript.src = src\n\t\tscript.async = true\n\t\tscript.addEventListener('load', () => resolve())\n\t\tscript.addEventListener('error', () => {\n\t\t\tpending.delete(src)\n\t\t\tscript.remove()\n\t\t\treject(new Error(`Failed to load ${src}`))\n\t\t})\n\t\tdocument.head.appendChild(script)\n\t})\n\tpending.set(src, promise)\n\treturn promise\n}\n\n/**\n * Load a vendor captcha script once per src, shared across all widget instances. SSR-safe (the\n * DOM is only touched inside the effect). A failed load evicts the cache entry so a later mount\n * can retry; consumers just see `ready` stay false.\n */\nexport const useCaptchaScript = (src: string): boolean => {\n\tconst [ready, setReady] = useState(false)\n\tuseEffect(() => {\n\t\tlet active = true\n\t\tsetReady(false)\n\t\tloadScript(src).then(\n\t\t\t() => {\n\t\t\t\tif (active) {\n\t\t\t\t\tsetReady(true)\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {}\n\t\t)\n\t\treturn () => {\n\t\t\tactive = false\n\t\t}\n\t}, [src])\n\treturn ready\n}\n"],"mappings":";;;AAIA,MAAM,0BAAU,IAAI,IAA2B;AAE/C,MAAM,cAAc,QAA+B;CAClD,MAAM,SAAS,QAAQ,IAAI,GAAG;CAC9B,IAAI,QACH,OAAO;CAER,MAAM,UAAU,IAAI,SAAe,SAAS,WAAW;EACtD,MAAM,SAAS,SAAS,cAAc,QAAQ;EAC9C,OAAO,MAAM;EACb,OAAO,QAAQ;EACf,OAAO,iBAAiB,cAAc,QAAQ,CAAC;EAC/C,OAAO,iBAAiB,eAAe;GACtC,QAAQ,OAAO,GAAG;GAClB,OAAO,OAAO;GACd,uBAAO,IAAI,MAAM,kBAAkB,KAAK,CAAC;EAC1C,CAAC;EACD,SAAS,KAAK,YAAY,MAAM;CACjC,CAAC;CACD,QAAQ,IAAI,KAAK,OAAO;CACxB,OAAO;AACR;;;;;;AAOA,MAAa,oBAAoB,QAAyB;CACzD,MAAM,CAAC,OAAO,YAAY,SAAS,KAAK;CACxC,gBAAgB;EACf,IAAI,SAAS;EACb,SAAS,KAAK;EACd,WAAW,GAAG,EAAE,WACT;GACL,IAAI,QACH,SAAS,IAAI;EAEf,SACM,CAAC,CACR;EACA,aAAa;GACZ,SAAS;EACV;CACD,GAAG,CAAC,GAAG,CAAC;CACR,OAAO;AACR"}

package/dist/react/captcha/vendors.js

@@ -0,0 +1,8 @@
+//#region src/react/captcha/vendors.ts
+const getTurnstile = () => globalThis.turnstile;
+const getGrecaptcha = () => globalThis.grecaptcha;
+const getHcaptcha = () => globalThis.hcaptcha;
+//#endregion
+export { getGrecaptcha, getHcaptcha, getTurnstile };
+
+//# sourceMappingURL=vendors.js.map

package/dist/react/captcha/vendors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendors.js","names":[],"sources":["../../../src/react/captcha/vendors.ts"],"sourcesContent":["export type TurnstileRenderParams = {\n\tsitekey: string\n\tcallback?: (token: string) => void\n\t'expired-callback'?: () => void\n\t'error-callback'?: () => void\n\t[key: string]: unknown\n}\n\nexport type TurnstileApi = {\n\trender(container: HTMLElement, params: TurnstileRenderParams): string\n\treset(widgetId: string): void\n\tremove(widgetId: string): void\n}\n\nexport type RecaptchaRenderParams = {\n\tsitekey: string\n\tcallback?: (token: string) => void\n\t'expired-callback'?: () => void\n\t'error-callback'?: () => void\n\t[key: string]: unknown\n}\n\nexport type GrecaptchaApi = {\n\tready(cb: () => void): void\n\trender(container: HTMLElement, params: RecaptchaRenderParams): number\n\treset(widgetId?: number): void\n\texecute(siteKey: string, options?: { action?: string }): Promise<string>\n}\n\nexport type HcaptchaRenderParams = {\n\tsitekey: string\n\tcallback?: (token: string) => void\n\t'expired-callback'?: () => void\n\t'error-callback'?: () => void\n\t[key: string]: unknown\n}\n\nexport type HcaptchaApi = {\n\trender(container: HTMLElement, params: HcaptchaRenderParams): string\n\treset(widgetId?: string): void\n\tremove(widgetId?: string): void\n}\n\nexport const getTurnstile = (): TurnstileApi | undefined =>\n\t(globalThis as { turnstile?: TurnstileApi }).turnstile\n\nexport const getGrecaptcha = (): GrecaptchaApi | undefined =>\n\t(globalThis as { grecaptcha?: GrecaptchaApi }).grecaptcha\n\nexport const getHcaptcha = (): HcaptchaApi | undefined =>\n\t(globalThis as { hcaptcha?: HcaptchaApi }).hcaptcha\n"],"mappings":";AA2CA,MAAa,qBACX,WAA4C;AAE9C,MAAa,sBACX,WAA8C;AAEhD,MAAa,oBACX,WAA0C"}

package/dist/react/cn.d.ts

@@ -0,0 +1,6 @@
+//#region src/react/cn.d.ts
+/** Joins class names, filtering out falsy values. */
+declare const cn: (...classes: (string | undefined | null | false)[]) => string;
+//#endregion
+export { cn };
+//# sourceMappingURL=cn.d.ts.map

package/dist/react/cn.js

@@ -0,0 +1,8 @@
+"use client";
+//#region src/react/cn.ts
+/** Joins class names, filtering out falsy values. */
+const cn = (...classes) => classes.filter(Boolean).join(" ");
+//#endregion
+export { cn };
+
+//# sourceMappingURL=cn.js.map

package/dist/react/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","names":[],"sources":["../../src/react/cn.ts"],"sourcesContent":["'use client'\n\n/** Joins class names, filtering out falsy values. */\nexport const cn = (...classes: (string | undefined | null | false)[]): string =>\n\tclasses.filter(Boolean).join(' ')\n"],"mappings":";;;AAGA,MAAa,MAAM,GAAG,YACrB,QAAQ,OAAO,OAAO,EAAE,KAAK,GAAG"}

package/dist/react/contract.d.ts

@@ -0,0 +1,31 @@
+import { FormFieldInstance } from "../submissions/types.js";
+import { ReactNode } from "react";
+
+//#region src/react/contract.d.ts
+/** A localized translator the renderer uses for built-in copy. `(key) => string`; unknown keys return the key. */
+type RendererTranslate = (key: string) => string;
+/**
+ * The props every field renderer receives. The renderer turns one field instance plus its current value
+ * into an accessible control. Supplied by `<Form>` or directly in tests. Generic over the
+ * value type so custom renderers can narrow it.
+ */
+type FieldRendererProps<TValue = unknown> = {
+  /** The stored field instance (name, label, blockType, required, placeholder, description, options, ...). */field: FormFieldInstance; /** The control's stable id, for label/aria wiring. */
+  id: string; /** The field machine name (form value key). */
+  name: string;
+  value: TValue | undefined;
+  onChange: (value: TValue) => void;
+  onBlur: () => void; /** Blocking error messages for this field. */
+  errors: string[];
+  required: boolean;
+  disabled?: boolean;
+  locale: string;
+  t: RendererTranslate;
+};
+/** A field renderer: maps `FieldRendererProps` to React output. */
+type FieldRenderer<TValue = unknown> = (props: FieldRendererProps<TValue>) => ReactNode;
+/** Identity helper that pins a renderer to the `FieldRenderer` type so authors get prop inference. */
+declare const defineFieldRenderer: <TValue = unknown>(renderer: FieldRenderer<TValue>) => FieldRenderer<TValue>;
+//#endregion
+export { FieldRenderer, FieldRendererProps, RendererTranslate, defineFieldRenderer };
+//# sourceMappingURL=contract.d.ts.map

package/dist/react/contract.js

@@ -0,0 +1,7 @@
+//#region src/react/contract.ts
+/** Identity helper that pins a renderer to the `FieldRenderer` type so authors get prop inference. */
+const defineFieldRenderer = (renderer) => renderer;
+//#endregion
+export { defineFieldRenderer };
+
+//# sourceMappingURL=contract.js.map

package/dist/react/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","names":[],"sources":["../../src/react/contract.ts"],"sourcesContent":["import type { ReactNode } from 'react'\nimport type { FormFieldInstance } from '../submissions/types'\n\n/** A localized translator the renderer uses for built-in copy. `(key) => string`; unknown keys return the key. */\nexport type RendererTranslate = (key: string) => string\n\n/**\n * The props every field renderer receives. The renderer turns one field instance plus its current value\n * into an accessible control. Supplied by `<Form>` or directly in tests. Generic over the\n * value type so custom renderers can narrow it.\n */\nexport type FieldRendererProps<TValue = unknown> = {\n\t/** The stored field instance (name, label, blockType, required, placeholder, description, options, ...). */\n\tfield: FormFieldInstance\n\t/** The control's stable id, for label/aria wiring. */\n\tid: string\n\t/** The field machine name (form value key). */\n\tname: string\n\tvalue: TValue | undefined\n\tonChange: (value: TValue) => void\n\tonBlur: () => void\n\t/** Blocking error messages for this field. */\n\terrors: string[]\n\trequired: boolean\n\tdisabled?: boolean\n\tlocale: string\n\tt: RendererTranslate\n}\n\n/** A field renderer: maps `FieldRendererProps` to React output. */\nexport type FieldRenderer<TValue = unknown> = (props: FieldRendererProps<TValue>) => ReactNode\n\n/** Identity helper that pins a renderer to the `FieldRenderer` type so authors get prop inference. */\nexport const defineFieldRenderer = <TValue = unknown>(\n\trenderer: FieldRenderer<TValue>\n): FieldRenderer<TValue> => renderer\n"],"mappings":";;AAiCA,MAAa,uBACZ,aAC2B"}

package/dist/react/events.js

@@ -0,0 +1,14 @@
+"use client";
+//#region src/react/events.ts
+/** Emit a lifecycle event through the sink, stamping `formId` + an ISO `at`. */
+const emitFormEvent = (sink, formId, event) => {
+	sink.emit({
+		...event,
+		formId,
+		at: (/* @__PURE__ */ new Date()).toISOString()
+	});
+};
+//#endregion
+export { emitFormEvent };
+
+//# sourceMappingURL=events.js.map

package/dist/react/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../src/react/events.ts"],"sourcesContent":["'use client'\n\nimport type { FormEvent, FormEventSink } from '../events/types'\n\n/** Distribute `Omit` across the event union so each variant keeps its discriminated extras. */\ntype DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never\n\n/** Emit a lifecycle event through the sink, stamping `formId` + an ISO `at`. */\nexport const emitFormEvent = (\n\tsink: FormEventSink,\n\tformId: string,\n\tevent: DistributiveOmit<FormEvent, 'formId' | 'at'>\n): void => {\n\tvoid sink.emit({ ...event, formId, at: new Date().toISOString() } as FormEvent)\n}\n"],"mappings":";;;AAQA,MAAa,iBACZ,MACA,QACA,UACU;CACV,KAAU,KAAK;EAAE,GAAG;EAAO;EAAQ,qBAAI,IAAI,KAAK,GAAE,YAAY;CAAE,CAAc;AAC/E"}

package/dist/react/fetchResults.d.ts

@@ -0,0 +1,25 @@
+import { FieldAggregation } from "../aggregation/types.js";
+
+//#region src/react/fetchResults.d.ts
+type FetchResultsInput = {
+  formId: number | string; /** Restrict to one field. Omit to get every public/enumerable field. */
+  field?: string; /** Payload API route prefix; defaults to `/api`. */
+  apiRoute?: string; /** Injectable for testing; defaults to global `fetch`. */
+  fetchImpl?: typeof fetch;
+};
+type FetchResultsResult = {
+  ok: true;
+  results: FieldAggregation[];
+} | {
+  ok: false;
+  message?: string;
+};
+/**
+ * Fetch aggregate poll/survey results from the form-builder results endpoint
+ * (`GET {apiRoute}/forms/:id/results`). Returns the server-resolved aggregations; the endpoint gates public
+ * access by the form's poll opt-in and results visibility. Pure: inject `fetchImpl` in tests.
+ */
+declare const fetchFormResults: (input: FetchResultsInput) => Promise<FetchResultsResult>;
+//#endregion
+export { FetchResultsInput, FetchResultsResult, fetchFormResults };
+//# sourceMappingURL=fetchResults.d.ts.map

package/dist/react/fetchResults.js

@@ -0,0 +1,31 @@
+//#region src/react/fetchResults.ts
+/**
+* Fetch aggregate poll/survey results from the form-builder results endpoint
+* (`GET {apiRoute}/forms/:id/results`). Returns the server-resolved aggregations; the endpoint gates public
+* access by the form's poll opt-in and results visibility. Pure: inject `fetchImpl` in tests.
+*/
+const fetchFormResults = async (input) => {
+	const { formId, field, apiRoute = "/api", fetchImpl = fetch } = input;
+	const query = field ? `?field=${encodeURIComponent(field)}` : "";
+	let response;
+	try {
+		response = await fetchImpl(`${apiRoute}/forms/${formId}/results${query}`, { method: "GET" });
+	} catch (error) {
+		return {
+			ok: false,
+			message: error instanceof Error ? error.message : "Network error"
+		};
+	}
+	if (!response.ok) return {
+		ok: false,
+		message: `Request failed (${response.status})`
+	};
+	return {
+		ok: true,
+		results: (await response.json().catch(() => ({}))).results ?? []
+	};
+};
+//#endregion
+export { fetchFormResults };
+
+//# sourceMappingURL=fetchResults.js.map

package/dist/react/fetchResults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchResults.js","names":[],"sources":["../../src/react/fetchResults.ts"],"sourcesContent":["import type { FieldAggregation } from '../aggregation/types'\n\nexport type FetchResultsInput = {\n\tformId: number | string\n\t/** Restrict to one field. Omit to get every public/enumerable field. */\n\tfield?: string\n\t/** Payload API route prefix; defaults to `/api`. */\n\tapiRoute?: string\n\t/** Injectable for testing; defaults to global `fetch`. */\n\tfetchImpl?: typeof fetch\n}\n\nexport type FetchResultsResult =\n\t| { ok: true; results: FieldAggregation[] }\n\t| { ok: false; message?: string }\n\n/**\n * Fetch aggregate poll/survey results from the form-builder results endpoint\n * (`GET {apiRoute}/forms/:id/results`). Returns the server-resolved aggregations; the endpoint gates public\n * access by the form's poll opt-in and results visibility. Pure: inject `fetchImpl` in tests.\n */\nexport const fetchFormResults = async (input: FetchResultsInput): Promise<FetchResultsResult> => {\n\tconst { formId, field, apiRoute = '/api', fetchImpl = fetch } = input\n\tconst query = field ? `?field=${encodeURIComponent(field)}` : ''\n\tlet response: Response\n\ttry {\n\t\tresponse = await fetchImpl(`${apiRoute}/forms/${formId}/results${query}`, { method: 'GET' })\n\t} catch (error) {\n\t\treturn { ok: false, message: error instanceof Error ? error.message : 'Network error' }\n\t}\n\tif (!response.ok) {\n\t\treturn { ok: false, message: `Request failed (${response.status})` }\n\t}\n\tconst body = (await response.json().catch(() => ({}))) as { results?: FieldAggregation[] }\n\treturn { ok: true, results: body.results ?? [] }\n}\n"],"mappings":";;;;;;AAqBA,MAAa,mBAAmB,OAAO,UAA0D;CAChG,MAAM,EAAE,QAAQ,OAAO,WAAW,QAAQ,YAAY,UAAU;CAChE,MAAM,QAAQ,QAAQ,UAAU,mBAAmB,KAAK,MAAM;CAC9D,IAAI;CACJ,IAAI;EACH,WAAW,MAAM,UAAU,GAAG,SAAS,SAAS,OAAO,UAAU,SAAS,EAAE,QAAQ,MAAM,CAAC;CAC5F,SAAS,OAAO;EACf,OAAO;GAAE,IAAI;GAAO,SAAS,iBAAiB,QAAQ,MAAM,UAAU;EAAgB;CACvF;CACA,IAAI,CAAC,SAAS,IACb,OAAO;EAAE,IAAI;EAAO,SAAS,mBAAmB,SAAS,OAAO;CAAG;CAGpE,OAAO;EAAE,IAAI;EAAM,UAAS,MADR,SAAS,KAAK,EAAE,aAAa,CAAC,EAAE,GACnB,WAAW,CAAC;CAAE;AAChD"}

package/dist/react/presentation/Backdrop.d.ts

@@ -0,0 +1,18 @@
+//#region src/react/presentation/Backdrop.d.ts
+type BackdropProps = {
+  onClick?: () => void;
+  className?: string;
+};
+/** A full-viewport backdrop behind an overlay surface. Styling comes from the `data-fb-backdrop` hook. */
+declare const Backdrop: ({
+  onClick,
+  className
+}: BackdropProps) => import("react").DetailedReactHTMLElement<{
+  'data-fb-backdrop': string;
+  className: string | undefined;
+  onClick: (() => void) | undefined;
+  'aria-hidden': true;
+}, HTMLElement>;
+//#endregion
+export { Backdrop, BackdropProps };
+//# sourceMappingURL=Backdrop.d.ts.map

package/dist/react/presentation/Backdrop.js

@@ -0,0 +1,14 @@
+"use client";
+import { createElement } from "react";
+//#region src/react/presentation/Backdrop.tsx
+/** A full-viewport backdrop behind an overlay surface. Styling comes from the `data-fb-backdrop` hook. */
+const Backdrop = ({ onClick, className }) => createElement("div", {
+	"data-fb-backdrop": "",
+	className,
+	onClick,
+	"aria-hidden": true
+});
+//#endregion
+export { Backdrop };
+
+//# sourceMappingURL=Backdrop.js.map

package/dist/react/presentation/Backdrop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backdrop.js","names":[],"sources":["../../../src/react/presentation/Backdrop.tsx"],"sourcesContent":["'use client'\n\nimport { createElement } from 'react'\n\nexport type BackdropProps = {\n\tonClick?: () => void\n\tclassName?: string\n}\n\n/** A full-viewport backdrop behind an overlay surface. Styling comes from the `data-fb-backdrop` hook. */\nexport const Backdrop = ({ onClick, className }: BackdropProps) =>\n\tcreateElement('div', { 'data-fb-backdrop': '', className, onClick, 'aria-hidden': true })\n"],"mappings":";;;;AAUA,MAAa,YAAY,EAAE,SAAS,gBACnC,cAAc,OAAO;CAAE,oBAAoB;CAAI;CAAW;CAAS,eAAe;AAAK,CAAC"}

package/dist/react/presentation/DialogSurface.d.ts

@@ -0,0 +1,35 @@
+import { ReactNode } from "react";
+
+//#region src/react/presentation/DialogSurface.d.ts
+type DialogSurfaceProps = {
+  open: boolean;
+  onClose: () => void; /** Accessible name; pass either label or labelledBy. */
+  label?: string;
+  labelledBy?: string; /** CSS data hook, e.g. 'modal' | 'drawer'. */
+  surface?: string;
+  closeLabel?: string;
+  closeOnEscape?: boolean;
+  closeOnOutsideClick?: boolean;
+  children?: ReactNode;
+};
+/**
+ * Accessible, dependency-free overlay surface: backdrop + role=dialog/aria-modal, focus-trap,
+ * scroll-lock, Escape/outside-click dismiss, initial focus, and focus restore on close. Composes the
+ * exported primitives so a consumer can rebuild it from the same parts.
+ */
+declare const DialogSurface: ({
+  open,
+  onClose,
+  label,
+  labelledBy,
+  surface,
+  closeLabel,
+  closeOnEscape,
+  closeOnOutsideClick,
+  children
+}: DialogSurfaceProps) => import("react").ReactElement<{
+  'data-fb-overlay': string;
+}, string | import("react").JSXElementConstructor<any>> | null;
+//#endregion
+export { DialogSurface, DialogSurfaceProps };
+//# sourceMappingURL=DialogSurface.d.ts.map

package/dist/react/presentation/DialogSurface.js

@@ -0,0 +1,53 @@
+"use client";
+import { Backdrop } from "./Backdrop.js";
+import { useDismiss } from "./useDismiss.js";
+import { useFocusTrap } from "./useFocusTrap.js";
+import { useScrollLock } from "./useScrollLock.js";
+import { createElement, useEffect, useRef } from "react";
+//#region src/react/presentation/DialogSurface.tsx
+/**
+* Accessible, dependency-free overlay surface: backdrop + role=dialog/aria-modal, focus-trap,
+* scroll-lock, Escape/outside-click dismiss, initial focus, and focus restore on close. Composes the
+* exported primitives so a consumer can rebuild it from the same parts.
+*/
+const DialogSurface = ({ open, onClose, label, labelledBy, surface, closeLabel = "Close", closeOnEscape, closeOnOutsideClick, children }) => {
+	const ref = useRef(null);
+	const restoreRef = useRef(null);
+	useScrollLock(open);
+	useFocusTrap(ref, open);
+	useDismiss({
+		active: open,
+		onDismiss: onClose,
+		closeOnEscape,
+		closeOnOutsideClick
+	}, ref);
+	useEffect(() => {
+		if (!open) return;
+		restoreRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+		ref.current?.focus();
+		return () => {
+			restoreRef.current?.focus();
+		};
+	}, [open]);
+	if (!open) return null;
+	return createElement("div", { "data-fb-overlay": surface ?? "" }, [createElement(Backdrop, { key: "backdrop" }), createElement("div", {
+		key: "surface",
+		ref,
+		role: "dialog",
+		"aria-modal": true,
+		"aria-label": labelledBy ? void 0 : label,
+		"aria-labelledby": labelledBy,
+		"data-fb-dialog": surface ?? "",
+		tabIndex: -1
+	}, [createElement("button", {
+		key: "close",
+		type: "button",
+		"data-fb-dialog-close": "",
+		"aria-label": closeLabel,
+		onClick: onClose
+	}, "×"), createElement("div", { key: "body" }, children)])]);
+};
+//#endregion
+export { DialogSurface };
+
+//# sourceMappingURL=DialogSurface.js.map

package/dist/react/presentation/DialogSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogSurface.js","names":[],"sources":["../../../src/react/presentation/DialogSurface.tsx"],"sourcesContent":["'use client'\n\nimport { createElement, type ReactNode, useEffect, useRef } from 'react'\nimport { Backdrop } from './Backdrop'\nimport { useDismiss } from './useDismiss'\nimport { useFocusTrap } from './useFocusTrap'\nimport { useScrollLock } from './useScrollLock'\n\nexport type DialogSurfaceProps = {\n\topen: boolean\n\tonClose: () => void\n\t/** Accessible name; pass either label or labelledBy. */\n\tlabel?: string\n\tlabelledBy?: string\n\t/** CSS data hook, e.g. 'modal' | 'drawer'. */\n\tsurface?: string\n\tcloseLabel?: string\n\tcloseOnEscape?: boolean\n\tcloseOnOutsideClick?: boolean\n\tchildren?: ReactNode\n}\n\n/**\n * Accessible, dependency-free overlay surface: backdrop + role=dialog/aria-modal, focus-trap,\n * scroll-lock, Escape/outside-click dismiss, initial focus, and focus restore on close. Composes the\n * exported primitives so a consumer can rebuild it from the same parts.\n */\nexport const DialogSurface = ({\n\topen,\n\tonClose,\n\tlabel,\n\tlabelledBy,\n\tsurface,\n\tcloseLabel = 'Close',\n\tcloseOnEscape,\n\tcloseOnOutsideClick,\n\tchildren,\n}: DialogSurfaceProps) => {\n\tconst ref = useRef<HTMLDivElement>(null)\n\tconst restoreRef = useRef<HTMLElement | null>(null)\n\n\tuseScrollLock(open)\n\tuseFocusTrap(ref, open)\n\tuseDismiss({ active: open, onDismiss: onClose, closeOnEscape, closeOnOutsideClick }, ref)\n\n\tuseEffect(() => {\n\t\tif (!open) {\n\t\t\treturn\n\t\t}\n\t\trestoreRef.current =\n\t\t\tdocument.activeElement instanceof HTMLElement ? document.activeElement : null\n\t\tref.current?.focus()\n\t\treturn () => {\n\t\t\trestoreRef.current?.focus()\n\t\t}\n\t}, [open])\n\n\tif (!open) {\n\t\treturn null\n\t}\n\n\treturn createElement('div', { 'data-fb-overlay': surface ?? '' }, [\n\t\t// No onClick here: useDismiss already closes on an outside pointerdown (the backdrop is outside\n\t\t// the dialog ref), so wiring onClose here too would fire it twice per click and would ignore\n\t\t// closeOnOutsideClick. The backdrop stays purely presentational.\n\t\tcreateElement(Backdrop, { key: 'backdrop' }),\n\t\tcreateElement(\n\t\t\t'div',\n\t\t\t{\n\t\t\t\tkey: 'surface',\n\t\t\t\tref,\n\t\t\t\trole: 'dialog',\n\t\t\t\t'aria-modal': true,\n\t\t\t\t'aria-label': labelledBy ? undefined : label,\n\t\t\t\t'aria-labelledby': labelledBy,\n\t\t\t\t'data-fb-dialog': surface ?? '',\n\t\t\t\ttabIndex: -1,\n\t\t\t},\n\t\t\t[\n\t\t\t\tcreateElement(\n\t\t\t\t\t'button',\n\t\t\t\t\t{\n\t\t\t\t\t\tkey: 'close',\n\t\t\t\t\t\ttype: 'button',\n\t\t\t\t\t\t'data-fb-dialog-close': '',\n\t\t\t\t\t\t'aria-label': closeLabel,\n\t\t\t\t\t\tonClick: onClose,\n\t\t\t\t\t},\n\t\t\t\t\t'\\xd7'\n\t\t\t\t),\n\t\t\t\tcreateElement('div', { key: 'body' }, children),\n\t\t\t]\n\t\t),\n\t])\n}\n"],"mappings":";;;;;;;;;;;;AA2BA,MAAa,iBAAiB,EAC7B,MACA,SACA,OACA,YACA,SACA,aAAa,SACb,eACA,qBACA,eACyB;CACzB,MAAM,MAAM,OAAuB,IAAI;CACvC,MAAM,aAAa,OAA2B,IAAI;CAElD,cAAc,IAAI;CAClB,aAAa,KAAK,IAAI;CACtB,WAAW;EAAE,QAAQ;EAAM,WAAW;EAAS;EAAe;CAAoB,GAAG,GAAG;CAExF,gBAAgB;EACf,IAAI,CAAC,MACJ;EAED,WAAW,UACV,SAAS,yBAAyB,cAAc,SAAS,gBAAgB;EAC1E,IAAI,SAAS,MAAM;EACnB,aAAa;GACZ,WAAW,SAAS,MAAM;EAC3B;CACD,GAAG,CAAC,IAAI,CAAC;CAET,IAAI,CAAC,MACJ,OAAO;CAGR,OAAO,cAAc,OAAO,EAAE,mBAAmB,WAAW,GAAG,GAAG,CAIjE,cAAc,UAAU,EAAE,KAAK,WAAW,CAAC,GAC3C,cACC,OACA;EACC,KAAK;EACL;EACA,MAAM;EACN,cAAc;EACd,cAAc,aAAa,KAAA,IAAY;EACvC,mBAAmB;EACnB,kBAAkB,WAAW;EAC7B,UAAU;CACX,GACA,CACC,cACC,UACA;EACC,KAAK;EACL,MAAM;EACN,wBAAwB;EACxB,cAAc;EACd,SAAS;CACV,GACA,GACD,GACA,cAAc,OAAO,EAAE,KAAK,OAAO,GAAG,QAAQ,CAC/C,CACD,CACD,CAAC;AACF"}

package/dist/react/presentation/presentations.d.ts

@@ -0,0 +1,7 @@
+import { FormPresentation } from "./types.js";
+
+//#region src/react/presentation/presentations.d.ts
+declare const defaultPresentations: Record<string, FormPresentation>;
+//#endregion
+export { defaultPresentations };
+//# sourceMappingURL=presentations.d.ts.map

package/dist/react/presentation/presentations.js

@@ -0,0 +1,32 @@
+"use client";
+import { defaultPresentationDescriptors } from "../../presentations/defaults.js";
+import { DialogSurface } from "./DialogSurface.js";
+import { createElement } from "react";
+//#region src/react/presentation/presentations.tsx
+const overlayWrapper = (surface) => {
+	const Wrapper = ({ open, onClose, title, closeLabel, children }) => createElement(DialogSurface, {
+		open,
+		onClose,
+		label: title,
+		surface,
+		closeLabel
+	}, children);
+	Wrapper.displayName = `${surface}Wrapper`;
+	return Wrapper;
+};
+const defaultPresentations = {
+	page: defaultPresentationDescriptors.page,
+	inline: defaultPresentationDescriptors.inline,
+	modal: {
+		...defaultPresentationDescriptors.modal,
+		Wrapper: overlayWrapper("modal")
+	},
+	drawer: {
+		...defaultPresentationDescriptors.drawer,
+		Wrapper: overlayWrapper("drawer")
+	}
+};
+//#endregion
+export { defaultPresentations };
+
+//# sourceMappingURL=presentations.js.map

package/dist/react/presentation/presentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.js","names":[],"sources":["../../../src/react/presentation/presentations.tsx"],"sourcesContent":["'use client'\n\nimport { createElement } from 'react'\nimport { defaultPresentationDescriptors } from '../../presentations/defaults'\nimport { DialogSurface } from './DialogSurface'\nimport type { FormPresentation, PresentationWrapperProps } from './types'\n\nconst overlayWrapper = (surface: 'modal' | 'drawer') => {\n\tconst Wrapper = ({ open, onClose, title, closeLabel, children }: PresentationWrapperProps) =>\n\t\tcreateElement(DialogSurface, { open, onClose, label: title, surface, closeLabel }, children)\n\tWrapper.displayName = `${surface}Wrapper`\n\treturn Wrapper\n}\n\nexport const defaultPresentations: Record<string, FormPresentation> = {\n\tpage: defaultPresentationDescriptors.page,\n\tinline: defaultPresentationDescriptors.inline,\n\tmodal: { ...defaultPresentationDescriptors.modal, Wrapper: overlayWrapper('modal') },\n\tdrawer: { ...defaultPresentationDescriptors.drawer, Wrapper: overlayWrapper('drawer') },\n}\n"],"mappings":";;;;;AAOA,MAAM,kBAAkB,YAAgC;CACvD,MAAM,WAAW,EAAE,MAAM,SAAS,OAAO,YAAY,eACpD,cAAc,eAAe;EAAE;EAAM;EAAS,OAAO;EAAO;EAAS;CAAW,GAAG,QAAQ;CAC5F,QAAQ,cAAc,GAAG,QAAQ;CACjC,OAAO;AACR;AAEA,MAAa,uBAAyD;CACrE,MAAM,+BAA+B;CACrC,QAAQ,+BAA+B;CACvC,OAAO;EAAE,GAAG,+BAA+B;EAAO,SAAS,eAAe,OAAO;CAAE;CACnF,QAAQ;EAAE,GAAG,+BAA+B;EAAQ,SAAS,eAAe,QAAQ;CAAE;AACvF"}

package/dist/react/presentation/registry.d.ts

@@ -0,0 +1,11 @@
+import { FormPresentation } from "./types.js";
+
+//#region src/react/presentation/registry.d.ts
+type PresentationRegistry = Map<string, FormPresentation>;
+/** `false` removes, `true` keeps the default, a presentation adds or replaces one. */
+type PresentationOption = boolean | FormPresentation;
+type PresentationsConfig = Record<string, PresentationOption>;
+declare const resolvePresentations: (defaults?: Record<string, FormPresentation>, config?: PresentationsConfig) => PresentationRegistry;
+//#endregion
+export { PresentationOption, PresentationRegistry, PresentationsConfig, resolvePresentations };
+//# sourceMappingURL=registry.d.ts.map