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

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

@@ -0,0 +1,31 @@
+import { FormAdapters } from "../adapters.js";
+import { CaptchaWidgetHandle } from "./types.js";
+import { Ref } from "react";
+
+//#region src/react/captcha/HcaptchaCaptcha.d.ts
+declare const HCAPTCHA_SCRIPT_URL = "https://js.hcaptcha.com/1/api.js?render=explicit";
+type HcaptchaCaptchaProps = {
+  /** hCaptcha 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, ...). */
+  options?: Record<string, unknown>;
+  className?: string; /** Override the vendor script URL. */
+  scriptSrc?: string; /** Host-owned effects; only `loadScript` applies here (consent-gated or CSP-nonced script loading). */
+  adapters?: Pick<FormAdapters, 'loadScript'>;
+  ref?: Ref<CaptchaWidgetHandle>;
+};
+/**
+ * Headless hCaptcha 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 HcaptchaCaptcha: ({
+  siteKey,
+  onToken,
+  options,
+  className,
+  scriptSrc,
+  adapters,
+  ref
+}: HcaptchaCaptchaProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { HCAPTCHA_SCRIPT_URL, HcaptchaCaptcha, HcaptchaCaptchaProps };
+//# sourceMappingURL=HcaptchaCaptcha.d.ts.map

package/dist/react/captcha/HcaptchaCaptcha.js

@@ -0,0 +1,53 @@
+"use client";
+import { useCaptchaScript } from "./useCaptchaScript.js";
+import { getHcaptcha } from "./vendors.js";
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useImperativeHandle, useRef } from "react";
+//#region src/react/captcha/HcaptchaCaptcha.tsx
+const HCAPTCHA_SCRIPT_URL = "https://js.hcaptcha.com/1/api.js?render=explicit";
+/**
+* Headless hCaptcha 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 HcaptchaCaptcha = ({ siteKey, onToken, options, className, scriptSrc = HCAPTCHA_SCRIPT_URL, adapters, 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, adapters?.loadScript);
+	useImperativeHandle(ref, () => ({ reset: () => {
+		const api = getHcaptcha();
+		if (api && widgetIdRef.current !== null) api.reset(widgetIdRef.current);
+		onTokenRef.current(null);
+	} }), []);
+	useEffect(() => {
+		if (!ready) return;
+		const container = containerRef.current;
+		const api = getHcaptcha();
+		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 { HCAPTCHA_SCRIPT_URL, HcaptchaCaptcha };
+
+//# sourceMappingURL=HcaptchaCaptcha.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HcaptchaCaptcha.js","names":[],"sources":["../../../src/react/captcha/HcaptchaCaptcha.tsx"],"sourcesContent":["'use client'\n\nimport { type Ref, useEffect, useImperativeHandle, useRef } from 'react'\nimport type { FormAdapters } from '../adapters'\nimport type { CaptchaWidgetHandle } from './types'\nimport { useCaptchaScript } from './useCaptchaScript'\nimport { getHcaptcha } from './vendors'\n\nexport const HCAPTCHA_SCRIPT_URL = 'https://js.hcaptcha.com/1/api.js?render=explicit'\n\nexport type HcaptchaCaptchaProps = {\n\t/** hCaptcha 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, ...). */\n\toptions?: Record<string, unknown>\n\tclassName?: string\n\t/** Override the vendor script URL. */\n\tscriptSrc?: string\n\t/** Host-owned effects; only `loadScript` applies here (consent-gated or CSP-nonced script loading). */\n\tadapters?: Pick<FormAdapters, 'loadScript'>\n\tref?: Ref<CaptchaWidgetHandle>\n}\n\n/**\n * Headless hCaptcha widget: loads the vendor script once, renders the widget into a bare div,\n * and reports tokens through `onToken`. Pass the latest token to `<Form captchaToken>`.\n */\nexport const HcaptchaCaptcha = ({\n\tsiteKey,\n\tonToken,\n\toptions,\n\tclassName,\n\tscriptSrc = HCAPTCHA_SCRIPT_URL,\n\tadapters,\n\tref,\n}: HcaptchaCaptchaProps) => {\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, adapters?.loadScript)\n\n\tuseImperativeHandle(\n\t\tref,\n\t\t() => ({\n\t\t\treset: () => {\n\t\t\t\tconst api = getHcaptcha()\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 = getHcaptcha()\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":";;;;;;AAQA,MAAa,sBAAsB;;;;;AAqBnC,MAAa,mBAAmB,EAC/B,SACA,SACA,SACA,WACA,YAAY,qBACZ,UACA,UAC2B;CAC3B,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,WAAW,UAAU,UAAU;CAE9D,oBACC,YACO,EACN,aAAa;EACZ,MAAM,MAAM,YAAY;EACxB,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,YAAY;EACxB,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/RecaptchaCaptcha.d.ts

@@ -0,0 +1,44 @@
+import { FormAdapters } from "../adapters.js";
+import { CaptchaWidgetHandle } from "./types.js";
+import { Ref } from "react";
+
+//#region src/react/captcha/RecaptchaCaptcha.d.ts
+declare const RECAPTCHA_SCRIPT_URL = "https://www.google.com/recaptcha/api.js";
+type RecaptchaCaptchaHandle = CaptchaWidgetHandle & {
+  /**
+   * v3 only: fetch a fresh token on demand and report it through `onToken`. v3 tokens expire
+   * after about two minutes, so call this right before submit for a long-lived form. Resolves
+   * null for v2 or when execution fails.
+   */
+  execute: (action?: string) => Promise<string | null>;
+};
+type RecaptchaCaptchaProps = {
+  /** reCAPTCHA site key (public). */siteKey: string; /** 'v2' renders the checkbox widget; 'v3' runs invisibly and produces score-based tokens. */
+  version: 'v2' | 'v3'; /** v3 action name reported to reCAPTCHA. Default 'submit'. */
+  action?: string; /** Receives each fresh token, and null when the token expires, errors, or is reset. */
+  onToken: (token: string | null) => void; /** Extra vendor render params for v2 (theme, size, ...). */
+  options?: Record<string, unknown>;
+  className?: string; /** Override the vendor script URL (the version-specific `render` query is not appended). */
+  scriptSrc?: string; /** Host-owned effects; only `loadScript` applies here (consent-gated or CSP-nonced script loading). */
+  adapters?: Pick<FormAdapters, 'loadScript'>;
+  ref?: Ref<RecaptchaCaptchaHandle>;
+};
+/**
+ * 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>`.
+ */
+declare const RecaptchaCaptcha: ({
+  siteKey,
+  version,
+  action,
+  onToken,
+  options,
+  className,
+  scriptSrc,
+  adapters,
+  ref
+}: RecaptchaCaptchaProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { RECAPTCHA_SCRIPT_URL, RecaptchaCaptcha, RecaptchaCaptchaHandle, RecaptchaCaptchaProps };
+//# sourceMappingURL=RecaptchaCaptcha.d.ts.map

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, adapters, 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, adapters?.loadScript);
+	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 { FormAdapters } from '../adapters'\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\t/** Host-owned effects; only `loadScript` applies here (consent-gated or CSP-nonced script loading). */\n\tadapters?: Pick<FormAdapters, 'loadScript'>\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\tadapters,\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, adapters?.loadScript)\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":";;;;;;AAQA,MAAa,uBAAuB;;;;;;AAmCpC,MAAa,oBAAoB,EAChC,SACA,SACA,QACA,SACA,SACA,WACA,WACA,UACA,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,KAAK,UAAU,UAAU;CAExD,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,31 @@
+import { FormAdapters } from "../adapters.js";
+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; /** Host-owned effects; only `loadScript` applies here (consent-gated or CSP-nonced script loading). */
+  adapters?: Pick<FormAdapters, 'loadScript'>;
+  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,
+  adapters,
+  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, adapters, 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, adapters?.loadScript);
+	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 { FormAdapters } from '../adapters'\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\t/** Host-owned effects; only `loadScript` applies here (consent-gated or CSP-nonced script loading). */\n\tadapters?: Pick<FormAdapters, 'loadScript'>\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\tadapters,\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, adapters?.loadScript)\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":";;;;;;AAQA,MAAa,uBACZ;;;;;AAqBD,MAAa,oBAAoB,EAChC,SACA,SACA,SACA,WACA,YAAY,sBACZ,UACA,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,WAAW,UAAU,UAAU;CAE9D,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,63 @@
+"use client";
+import { useEffect, useState } from "react";
+//#region src/react/captcha/useCaptchaScript.ts
+const pending = /* @__PURE__ */ new Map();
+const injectScript = (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;
+};
+const customCaches = /* @__PURE__ */ new WeakMap();
+const loadThrough = (loader, src) => {
+	let cache = customCaches.get(loader);
+	if (!cache) {
+		cache = /* @__PURE__ */ new Map();
+		customCaches.set(loader, cache);
+	}
+	const cached = cache.get(src);
+	if (cached) return cached;
+	const promise = loader(src).catch((error) => {
+		cache.delete(src);
+		throw error;
+	});
+	cache.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. A host `loadScript` (e.g. a consent-gated
+* loader) replaces the `document.head` injection; pass a stable reference, since a new function
+* identity re-runs the load with a fresh cache.
+*/
+const useCaptchaScript = (src, loadScript) => {
+	const [ready, setReady] = useState(false);
+	useEffect(() => {
+		let active = true;
+		setReady(false);
+		(loadScript ? loadThrough(loadScript, src) : injectScript(src)).then(() => {
+			if (active) setReady(true);
+		}, () => {});
+		return () => {
+			active = false;
+		};
+	}, [src, loadScript]);
+	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'\nimport type { LoadScript } from '../adapters'\n\nconst pending = new Map<string, Promise<void>>()\n\nconst injectScript = (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// A custom loader gets the same per-src cache and evict-on-failure retry, keyed per loader so two\n// adapters (or the default injector) never share entries.\nconst customCaches = new WeakMap<LoadScript, Map<string, Promise<void>>>()\n\nconst loadThrough = (loader: LoadScript, src: string): Promise<void> => {\n\tlet cache = customCaches.get(loader)\n\tif (!cache) {\n\t\tcache = new Map()\n\t\tcustomCaches.set(loader, cache)\n\t}\n\tconst cached = cache.get(src)\n\tif (cached) {\n\t\treturn cached\n\t}\n\tconst promise = loader(src).catch((error) => {\n\t\tcache.delete(src)\n\t\tthrow error\n\t})\n\tcache.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. A host `loadScript` (e.g. a consent-gated\n * loader) replaces the `document.head` injection; pass a stable reference, since a new function\n * identity re-runs the load with a fresh cache.\n */\nexport const useCaptchaScript = (src: string, loadScript?: LoadScript): boolean => {\n\tconst [ready, setReady] = useState(false)\n\tuseEffect(() => {\n\t\tlet active = true\n\t\tsetReady(false)\n\t\tconst load = loadScript ? loadThrough(loadScript, src) : injectScript(src)\n\t\tload.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, loadScript])\n\treturn ready\n}\n"],"mappings":";;;AAKA,MAAM,0BAAU,IAAI,IAA2B;AAE/C,MAAM,gBAAgB,QAA+B;CACpD,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;AAIA,MAAM,+BAAe,IAAI,QAAgD;AAEzE,MAAM,eAAe,QAAoB,QAA+B;CACvE,IAAI,QAAQ,aAAa,IAAI,MAAM;CACnC,IAAI,CAAC,OAAO;EACX,wBAAQ,IAAI,IAAI;EAChB,aAAa,IAAI,QAAQ,KAAK;CAC/B;CACA,MAAM,SAAS,MAAM,IAAI,GAAG;CAC5B,IAAI,QACH,OAAO;CAER,MAAM,UAAU,OAAO,GAAG,EAAE,OAAO,UAAU;EAC5C,MAAM,OAAO,GAAG;EAChB,MAAM;CACP,CAAC;CACD,MAAM,IAAI,KAAK,OAAO;CACtB,OAAO;AACR;;;;;;;;AASA,MAAa,oBAAoB,KAAa,eAAqC;CAClF,MAAM,CAAC,OAAO,YAAY,SAAS,KAAK;CACxC,gBAAgB;EACf,IAAI,SAAS;EACb,SAAS,KAAK;EAEd,CADa,aAAa,YAAY,YAAY,GAAG,IAAI,aAAa,GAAG,GACpE,WACE;GACL,IAAI,QACH,SAAS,IAAI;EAEf,SACM,CAAC,CACR;EACA,aAAa;GACZ,SAAS;EACV;CACD,GAAG,CAAC,KAAK,UAAU,CAAC;CACpB,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/contract.d.ts

@@ -15,9 +15,8 @@ type FieldRendererProps<TValue = unknown> = {
   name: string;
   value: TValue | undefined;
   onChange: (value: TValue) => void;
-  onBlur: () => void; /** Blocking error messages for this field (already filtered to error severity). */
-  errors: string[]; /** Advisory messages (warning severity). */
-  warnings?: string[];
+  onBlur: () => void; /** Blocking error messages for this field. */
+  errors: string[];
   required: boolean;
   disabled?: boolean;
   locale: string;

package/dist/react/contract.js.map

@@ -1 +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 (already filtered to error severity). */\n\terrors: string[]\n\t/** Advisory messages (warning severity). */\n\twarnings?: 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":";;AAmCA,MAAa,uBACZ,aAC2B"}
+{"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/fetchResults.d.ts

@@ -17,7 +17,7 @@ type FetchResultsResult = {
 /**
  * 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 `showResults` opt-in. Pure: inject `fetchImpl` in tests.
+ * access by the form's poll opt-in and results visibility. Pure: inject `fetchImpl` in tests.
  */
 declare const fetchFormResults: (input: FetchResultsInput) => Promise<FetchResultsResult>;
 //#endregion

package/dist/react/fetchResults.js

@@ -2,7 +2,7 @@
 /**
 * 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 `showResults` opt-in. Pure: inject `fetchImpl` in tests.
+* 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;

package/dist/react/fetchResults.js.map

@@ -1 +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 `showResults` opt-in. 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"}
+{"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/DialogSurface.js

@@ -30,10 +30,7 @@ const DialogSurface = ({ open, onClose, label, labelledBy, surface, closeLabel =
 		};
 	}, [open]);
 	if (!open) return null;
-	return createElement("div", { "data-fb-overlay": surface ?? "" }, [createElement(Backdrop, {
-		key: "backdrop",
-		onClick: onClose
-	}), createElement("div", {
+	return createElement("div", { "data-fb-overlay": surface ?? "" }, [createElement(Backdrop, { key: "backdrop" }), createElement("div", {
 		key: "surface",
 		ref,
 		role: "dialog",

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

@@ -1 +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\tcreateElement(Backdrop, { key: 'backdrop', onClick: onClose }),\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,CACjE,cAAc,UAAU;EAAE,KAAK;EAAY,SAAS;CAAQ,CAAC,GAC7D,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"}
+{"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/primitives/Checkbox.d.ts

@@ -8,7 +8,9 @@ type CheckboxProps = {
   required?: boolean;
   disabled?: boolean;
   invalid?: boolean;
-  describedById?: string;
+  describedById?: string; /** Overrides the accessible name (e.g. when the visible label is rich HTML with a plain-text equivalent). */
+  ariaLabel?: string; /** `switch` renders the same input as `role="switch"` styled as a toggle; omit for the plain checkbox. */
+  variant?: 'checkbox' | 'switch';
 };
 declare const Checkbox: ({
   id,
@@ -19,7 +21,9 @@ declare const Checkbox: ({
   required,
   disabled,
   invalid,
-  describedById
+  describedById,
+  ariaLabel,
+  variant
 }: CheckboxProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
 export { Checkbox, CheckboxProps };

package/dist/react/primitives/Checkbox.js

@@ -1,9 +1,10 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
 //#region src/react/primitives/Checkbox.tsx
-const Checkbox = ({ id, name, checked, onChange, onBlur, required, disabled, invalid, describedById }) => /* @__PURE__ */ jsx("input", {
+const Checkbox = ({ id, name, checked, onChange, onBlur, required, disabled, invalid, describedById, ariaLabel, variant }) => /* @__PURE__ */ jsx("input", {
 	type: "checkbox",
-	className: "fb-checkbox",
+	role: variant === "switch" ? "switch" : void 0,
+	className: variant === "switch" ? "fb-checkbox fb-switch" : "fb-checkbox",
 	id,
 	name,
 	checked,
@@ -11,6 +12,7 @@ const Checkbox = ({ id, name, checked, onChange, onBlur, required, disabled, inv
 	disabled,
 	"aria-invalid": invalid || void 0,
 	"aria-describedby": describedById,
+	"aria-label": ariaLabel,
 	onChange: (e) => onChange(e.target.checked),
 	onBlur
 });

package/dist/react/primitives/Checkbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"Checkbox.js","names":[],"sources":["../../../src/react/primitives/Checkbox.tsx"],"sourcesContent":["'use client'\n\nexport type CheckboxProps = {\n\tid: string\n\tname: string\n\tchecked: boolean\n\tonChange: (checked: boolean) => void\n\tonBlur?: () => void\n\trequired?: boolean\n\tdisabled?: boolean\n\tinvalid?: boolean\n\tdescribedById?: string\n}\n\nexport const Checkbox = ({\n\tid,\n\tname,\n\tchecked,\n\tonChange,\n\tonBlur,\n\trequired,\n\tdisabled,\n\tinvalid,\n\tdescribedById,\n}: CheckboxProps) => (\n\t<input\n\t\ttype=\"checkbox\"\n\t\tclassName=\"fb-checkbox\"\n\t\tid={id}\n\t\tname={name}\n\t\tchecked={checked}\n\t\trequired={required}\n\t\tdisabled={disabled}\n\t\taria-invalid={invalid || undefined}\n\t\taria-describedby={describedById}\n\t\tonChange={(e) => onChange(e.target.checked)}\n\t\tonBlur={onBlur}\n\t/>\n)\n"],"mappings":";;;AAcA,MAAa,YAAY,EACxB,IACA,MACA,SACA,UACA,QACA,UACA,UACA,SACA,oBAEA,oBAAC,SAAD;CACC,MAAK;CACL,WAAU;CACN;CACE;CACG;CACC;CACA;CACV,gBAAc,WAAW,KAAA;CACzB,oBAAkB;CAClB,WAAW,MAAM,SAAS,EAAE,OAAO,OAAO;CAClC;AACR,CAAA"}
+{"version":3,"file":"Checkbox.js","names":[],"sources":["../../../src/react/primitives/Checkbox.tsx"],"sourcesContent":["'use client'\n\nexport type CheckboxProps = {\n\tid: string\n\tname: string\n\tchecked: boolean\n\tonChange: (checked: boolean) => void\n\tonBlur?: () => void\n\trequired?: boolean\n\tdisabled?: boolean\n\tinvalid?: boolean\n\tdescribedById?: string\n\t/** Overrides the accessible name (e.g. when the visible label is rich HTML with a plain-text equivalent). */\n\tariaLabel?: string\n\t/** `switch` renders the same input as `role=\"switch\"` styled as a toggle; omit for the plain checkbox. */\n\tvariant?: 'checkbox' | 'switch'\n}\n\nexport const Checkbox = ({\n\tid,\n\tname,\n\tchecked,\n\tonChange,\n\tonBlur,\n\trequired,\n\tdisabled,\n\tinvalid,\n\tdescribedById,\n\tariaLabel,\n\tvariant,\n}: CheckboxProps) => (\n\t<input\n\t\ttype=\"checkbox\"\n\t\trole={variant === 'switch' ? 'switch' : undefined}\n\t\tclassName={variant === 'switch' ? 'fb-checkbox fb-switch' : 'fb-checkbox'}\n\t\tid={id}\n\t\tname={name}\n\t\tchecked={checked}\n\t\trequired={required}\n\t\tdisabled={disabled}\n\t\taria-invalid={invalid || undefined}\n\t\taria-describedby={describedById}\n\t\taria-label={ariaLabel}\n\t\tonChange={(e) => onChange(e.target.checked)}\n\t\tonBlur={onBlur}\n\t/>\n)\n"],"mappings":";;;AAkBA,MAAa,YAAY,EACxB,IACA,MACA,SACA,UACA,QACA,UACA,UACA,SACA,eACA,WACA,cAEA,oBAAC,SAAD;CACC,MAAK;CACL,MAAM,YAAY,WAAW,WAAW,KAAA;CACxC,WAAW,YAAY,WAAW,0BAA0B;CACxD;CACE;CACG;CACC;CACA;CACV,gBAAc,WAAW,KAAA;CACzB,oBAAkB;CAClB,cAAY;CACZ,WAAW,MAAM,SAAS,EAAE,OAAO,OAAO;CAClC;AACR,CAAA"}

package/dist/react/primitives/ChoiceGroup.d.ts

@@ -0,0 +1,40 @@
+//#region src/react/primitives/ChoiceGroup.d.ts
+type ChoiceOption = {
+  label: string;
+  value: string;
+};
+type ChoiceGroupProps = {
+  name: string;
+  value: string;
+  options: ChoiceOption[];
+  onChange: (value: string) => void;
+  onBlur?: () => void;
+  required?: boolean;
+  disabled?: boolean;
+  invalid?: boolean;
+  describedById?: string; /** id of the element that names the group (`aria-labelledby`); omit when the field has no label. */
+  labelledById?: string; /** `radio` is the plain native list; `buttons` is the same semantics styled as a segmented control. */
+  variant: 'radio' | 'buttons';
+};
+/**
+ * A native `role="radiogroup"` of radio inputs backing a single-select field: the `radio` and
+ * `buttons` display variants of the select field type. `aria-invalid` sits on each radio input, not
+ * the group `div` (a `div` can't take focus), so the terminal-submit focus routing
+ * (`[aria-invalid="true"]`) can land on it same as any other control.
+ */
+declare const ChoiceGroup: ({
+  name,
+  value,
+  options,
+  onChange,
+  onBlur,
+  required,
+  disabled,
+  invalid,
+  describedById,
+  labelledById,
+  variant
+}: ChoiceGroupProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { ChoiceGroup, ChoiceGroupProps, ChoiceOption };
+//# sourceMappingURL=ChoiceGroup.d.ts.map