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

package/dist/react/FormResults.js

@@ -0,0 +1,93 @@
+"use client";
+import { keys } from "../translations/keys.js";
+import { en } from "../translations/en.js";
+import { makeTranslate } from "../translations/makeTranslate.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/react/FormResults.tsx
+const OneResult = ({ result, t, showCounts, winningValues }) => {
+	if (result.total === 0) return /* @__PURE__ */ jsxs("section", {
+		className: "fb-results__field",
+		children: [result.label ? /* @__PURE__ */ jsx("h3", {
+			className: "fb-results__label",
+			children: result.label
+		}) : null, /* @__PURE__ */ jsx("p", {
+			className: "fb-results__empty",
+			children: t(keys.resultsNoResponses)
+		})]
+	});
+	return /* @__PURE__ */ jsxs("section", {
+		className: "fb-results__field",
+		children: [
+			result.label ? /* @__PURE__ */ jsx("h3", {
+				className: "fb-results__label",
+				children: result.label
+			}) : null,
+			/* @__PURE__ */ jsx("ul", {
+				className: "fb-results__list",
+				children: result.buckets.map((bucket) => {
+					const isWinner = winningValues?.includes(bucket.value) ?? false;
+					return /* @__PURE__ */ jsxs("li", {
+						className: isWinner ? "fb-results__row fb-results__bucket--winner" : "fb-results__row",
+						children: [
+							/* @__PURE__ */ jsxs("span", {
+								className: "fb-results__option",
+								children: [bucket.label, isWinner ? /* @__PURE__ */ jsx("span", {
+									className: "fb-results__winner-badge",
+									children: t(keys.resultsWinner)
+								}) : null]
+							}),
+							/* @__PURE__ */ jsx("span", {
+								className: "fb-results__bar",
+								children: /* @__PURE__ */ jsx("span", {
+									className: "fb-results__bar-fill",
+									style: { width: `${bucket.percentage}%` },
+									"aria-hidden": "true"
+								})
+							}),
+							/* @__PURE__ */ jsxs("span", {
+								className: "fb-results__pct",
+								children: [bucket.percentage, "%"]
+							}),
+							showCounts ? /* @__PURE__ */ jsx("span", {
+								className: "fb-results__count",
+								children: bucket.count
+							}) : null
+						]
+					}, bucket.value);
+				})
+			}),
+			/* @__PURE__ */ jsxs("p", {
+				className: "fb-results__total",
+				children: [
+					result.total,
+					" ",
+					t(keys.resultsResponses),
+					result.truncated ? ` (${t(keys.resultsTruncated)})` : ""
+				]
+			})
+		]
+	});
+};
+/**
+* Presentational results view for polls and survey summaries: per-option bars with percentages. Headless,
+* data resolved server-side via `aggregateFieldResponses`/`aggregateFormResponses` and passed in (it never
+* fetches). The option label, count, and percentage are real text (the accessible content); the bar fill
+* is `aria-hidden` visual sugar sized by inline width. With `winningValues`, every matching bucket gets
+* the winner class and a translated badge (real text, so the outcome is accessible); a tie highlights more than one.
+*/
+const FormResults = ({ results, t, showCounts = true, winningValues }) => {
+	const translate = t ?? makeTranslate(en);
+	return /* @__PURE__ */ jsx("div", {
+		className: "fb-results",
+		children: (Array.isArray(results) ? results : [results]).map((result) => /* @__PURE__ */ jsx(OneResult, {
+			result,
+			t: translate,
+			showCounts,
+			winningValues
+		}, result.field))
+	});
+};
+//#endregion
+export { FormResults };
+
+//# sourceMappingURL=FormResults.js.map

package/dist/react/FormResults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormResults.js","names":[],"sources":["../../src/react/FormResults.tsx"],"sourcesContent":["'use client'\n\nimport type { ReactNode } from 'react'\nimport type { FieldAggregation } from '../aggregation/types'\nimport { en } from '../translations/en'\nimport { keys } from '../translations/keys'\nimport { makeTranslate } from '../translations/makeTranslate'\nimport type { RendererTranslate } from './contract'\n\nexport type FormResultsProps = {\n\t/** One field aggregation or several (a survey summary), resolved server-side and passed in. */\n\tresults: FieldAggregation | FieldAggregation[]\n\t/** Localized translator for built-in copy. Defaults to identity (returns the key). */\n\tt?: RendererTranslate\n\tlocale?: string\n\t/** Show the raw count beside each option. Default true. */\n\tshowCounts?: boolean\n\t/** The recorded outcome's stable option values; every matching bucket is highlighted as a winner (a tie highlights more than one). */\n\twinningValues?: string[]\n}\n\nconst OneResult = ({\n\tresult,\n\tt,\n\tshowCounts,\n\twinningValues,\n}: {\n\tresult: FieldAggregation\n\tt: RendererTranslate\n\tshowCounts: boolean\n\twinningValues?: string[]\n}): ReactNode => {\n\tif (result.total === 0) {\n\t\treturn (\n\t\t\t<section className=\"fb-results__field\">\n\t\t\t\t{result.label ? <h3 className=\"fb-results__label\">{result.label}</h3> : null}\n\t\t\t\t<p className=\"fb-results__empty\">{t(keys.resultsNoResponses)}</p>\n\t\t\t</section>\n\t\t)\n\t}\n\treturn (\n\t\t<section className=\"fb-results__field\">\n\t\t\t{result.label ? <h3 className=\"fb-results__label\">{result.label}</h3> : null}\n\t\t\t<ul className=\"fb-results__list\">\n\t\t\t\t{result.buckets.map((bucket) => {\n\t\t\t\t\tconst isWinner = winningValues?.includes(bucket.value) ?? false\n\t\t\t\t\treturn (\n\t\t\t\t\t\t<li\n\t\t\t\t\t\t\tkey={bucket.value}\n\t\t\t\t\t\t\tclassName={\n\t\t\t\t\t\t\t\tisWinner ? 'fb-results__row fb-results__bucket--winner' : 'fb-results__row'\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t>\n\t\t\t\t\t\t\t<span className=\"fb-results__option\">\n\t\t\t\t\t\t\t\t{bucket.label}\n\t\t\t\t\t\t\t\t{isWinner ? (\n\t\t\t\t\t\t\t\t\t<span className=\"fb-results__winner-badge\">{t(keys.resultsWinner)}</span>\n\t\t\t\t\t\t\t\t) : null}\n\t\t\t\t\t\t\t</span>\n\t\t\t\t\t\t\t<span className=\"fb-results__bar\">\n\t\t\t\t\t\t\t\t<span\n\t\t\t\t\t\t\t\t\tclassName=\"fb-results__bar-fill\"\n\t\t\t\t\t\t\t\t\tstyle={{ width: `${bucket.percentage}%` }}\n\t\t\t\t\t\t\t\t\taria-hidden=\"true\"\n\t\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t</span>\n\t\t\t\t\t\t\t<span className=\"fb-results__pct\">{bucket.percentage}%</span>\n\t\t\t\t\t\t\t{showCounts ? <span className=\"fb-results__count\">{bucket.count}</span> : null}\n\t\t\t\t\t\t</li>\n\t\t\t\t\t)\n\t\t\t\t})}\n\t\t\t</ul>\n\t\t\t<p className=\"fb-results__total\">\n\t\t\t\t{result.total} {t(keys.resultsResponses)}\n\t\t\t\t{result.truncated ? ` (${t(keys.resultsTruncated)})` : ''}\n\t\t\t</p>\n\t\t</section>\n\t)\n}\n\n/**\n * Presentational results view for polls and survey summaries: per-option bars with percentages. Headless,\n * data resolved server-side via `aggregateFieldResponses`/`aggregateFormResponses` and passed in (it never\n * fetches). The option label, count, and percentage are real text (the accessible content); the bar fill\n * is `aria-hidden` visual sugar sized by inline width. With `winningValues`, every matching bucket gets\n * the winner class and a translated badge (real text, so the outcome is accessible); a tie highlights more than one.\n */\nexport const FormResults = ({\n\tresults,\n\tt,\n\tshowCounts = true,\n\twinningValues,\n}: FormResultsProps): ReactNode => {\n\tconst translate: RendererTranslate = t ?? makeTranslate(en)\n\tconst list = Array.isArray(results) ? results : [results]\n\treturn (\n\t\t<div className=\"fb-results\">\n\t\t\t{list.map((result) => (\n\t\t\t\t<OneResult\n\t\t\t\t\tkey={result.field}\n\t\t\t\t\tresult={result}\n\t\t\t\t\tt={translate}\n\t\t\t\t\tshowCounts={showCounts}\n\t\t\t\t\twinningValues={winningValues}\n\t\t\t\t/>\n\t\t\t))}\n\t\t</div>\n\t)\n}\n"],"mappings":";;;;;;AAqBA,MAAM,aAAa,EAClB,QACA,GACA,YACA,oBAMgB;CAChB,IAAI,OAAO,UAAU,GACpB,OACC,qBAAC,WAAD;EAAS,WAAU;YAAnB,CACE,OAAO,QAAQ,oBAAC,MAAD;GAAI,WAAU;aAAqB,OAAO;EAAU,CAAA,IAAI,MACxE,oBAAC,KAAD;GAAG,WAAU;aAAqB,EAAE,KAAK,kBAAkB;EAAK,CAAA,CACxD;;CAGX,OACC,qBAAC,WAAD;EAAS,WAAU;YAAnB;GACE,OAAO,QAAQ,oBAAC,MAAD;IAAI,WAAU;cAAqB,OAAO;GAAU,CAAA,IAAI;GACxE,oBAAC,MAAD;IAAI,WAAU;cACZ,OAAO,QAAQ,KAAK,WAAW;KAC/B,MAAM,WAAW,eAAe,SAAS,OAAO,KAAK,KAAK;KAC1D,OACC,qBAAC,MAAD;MAEC,WACC,WAAW,+CAA+C;gBAH5D;OAMC,qBAAC,QAAD;QAAM,WAAU;kBAAhB,CACE,OAAO,OACP,WACA,oBAAC,QAAD;SAAM,WAAU;mBAA4B,EAAE,KAAK,aAAa;QAAQ,CAAA,IACrE,IACC;;OACN,oBAAC,QAAD;QAAM,WAAU;kBACf,oBAAC,QAAD;SACC,WAAU;SACV,OAAO,EAAE,OAAO,GAAG,OAAO,WAAW,GAAG;SACxC,eAAY;QACZ,CAAA;OACI,CAAA;OACN,qBAAC,QAAD;QAAM,WAAU;kBAAhB,CAAmC,OAAO,YAAW,GAAO;;OAC3D,aAAa,oBAAC,QAAD;QAAM,WAAU;kBAAqB,OAAO;OAAY,CAAA,IAAI;MACvE;QApBE,OAAO,KAoBT;IAEN,CAAC;GACE,CAAA;GACJ,qBAAC,KAAD;IAAG,WAAU;cAAb;KACE,OAAO;KAAM;KAAE,EAAE,KAAK,gBAAgB;KACtC,OAAO,YAAY,KAAK,EAAE,KAAK,gBAAgB,EAAE,KAAK;IACrD;;EACK;;AAEX;;;;;;;;AASA,MAAa,eAAe,EAC3B,SACA,GACA,aAAa,MACb,oBACkC;CAClC,MAAM,YAA+B,KAAK,cAAc,EAAE;CAE1D,OACC,oBAAC,OAAD;EAAK,WAAU;aAFH,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,OAAO,GAGhD,KAAK,WACV,oBAAC,WAAD;GAES;GACR,GAAG;GACS;GACG;EACf,GALK,OAAO,KAKZ,CACD;CACG,CAAA;AAEP"}

package/dist/react/FormSteps.d.ts

@@ -0,0 +1,17 @@
+//#region src/react/FormSteps.d.ts
+type FormStepsProps = {
+  /** Additional CSS class on the wrapping `.fb-form-steps` list. */className?: string;
+};
+/**
+ * Step-progress indicator for multi-step forms: an ordered list of the flow's steps with the
+ * current one marked via `aria-current="step"` and a `--current` class. Step labels use the
+ * step's title, falling back to the translated "Step {n}" (same semantics as the admin flow
+ * builder). Carries no styling opinions beyond `fb-form-steps` classes. Renders nothing when
+ * the form has fewer than two steps. Must render inside `<Form>`.
+ */
+declare const FormSteps: ({
+  className
+}: FormStepsProps) => import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+export { FormSteps, FormStepsProps };
+//# sourceMappingURL=FormSteps.d.ts.map

package/dist/react/FormSteps.js

@@ -0,0 +1,35 @@
+"use client";
+import { keys } from "../translations/keys.js";
+import { stepLabel } from "../flow/stepLabel.js";
+import { cn } from "./cn.js";
+import { useFormContext } from "./FormContext.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/react/FormSteps.tsx
+/**
+* Step-progress indicator for multi-step forms: an ordered list of the flow's steps with the
+* current one marked via `aria-current="step"` and a `--current` class. Step labels use the
+* step's title, falling back to the translated "Step {n}" (same semantics as the admin flow
+* builder). Carries no styling opinions beyond `fb-form-steps` classes. Renders nothing when
+* the form has fewer than two steps. Must render inside `<Form>`.
+*/
+const FormSteps = ({ className }) => {
+	const { step, t } = useFormContext();
+	const steps = step.flow?.steps;
+	if (!steps || steps.length < 2) return null;
+	const fallbackTitle = t(keys.flowStepFallbackTitle);
+	return /* @__PURE__ */ jsx("ol", {
+		className: cn("fb-form-steps", className),
+		children: steps.map((flowStep, index) => {
+			const current = index === step.stepIndex;
+			return /* @__PURE__ */ jsx("li", {
+				className: cn("fb-form-steps__step", current && "fb-form-steps__step--current"),
+				"aria-current": current ? "step" : void 0,
+				children: stepLabel(flowStep, index, fallbackTitle)
+			}, flowStep.id);
+		})
+	});
+};
+//#endregion
+export { FormSteps };
+
+//# sourceMappingURL=FormSteps.js.map

package/dist/react/FormSteps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormSteps.js","names":[],"sources":["../../src/react/FormSteps.tsx"],"sourcesContent":["'use client'\n\nimport { stepLabel } from '../flow/stepLabel'\nimport { keys } from '../translations/keys'\nimport { cn } from './cn'\nimport { useFormContext } from './FormContext'\n\nexport type FormStepsProps = {\n\t/** Additional CSS class on the wrapping `.fb-form-steps` list. */\n\tclassName?: string\n}\n\n/**\n * Step-progress indicator for multi-step forms: an ordered list of the flow's steps with the\n * current one marked via `aria-current=\"step\"` and a `--current` class. Step labels use the\n * step's title, falling back to the translated \"Step {n}\" (same semantics as the admin flow\n * builder). Carries no styling opinions beyond `fb-form-steps` classes. Renders nothing when\n * the form has fewer than two steps. Must render inside `<Form>`.\n */\nexport const FormSteps = ({ className }: FormStepsProps) => {\n\tconst { step, t } = useFormContext()\n\tconst steps = step.flow?.steps\n\tif (!steps || steps.length < 2) {\n\t\treturn null\n\t}\n\tconst fallbackTitle = t(keys.flowStepFallbackTitle)\n\treturn (\n\t\t<ol className={cn('fb-form-steps', className)}>\n\t\t\t{steps.map((flowStep, index) => {\n\t\t\t\tconst current = index === step.stepIndex\n\t\t\t\treturn (\n\t\t\t\t\t<li\n\t\t\t\t\t\tkey={flowStep.id}\n\t\t\t\t\t\tclassName={cn('fb-form-steps__step', current && 'fb-form-steps__step--current')}\n\t\t\t\t\t\taria-current={current ? 'step' : undefined}\n\t\t\t\t\t>\n\t\t\t\t\t\t{stepLabel(flowStep, index, fallbackTitle)}\n\t\t\t\t\t</li>\n\t\t\t\t)\n\t\t\t})}\n\t\t</ol>\n\t)\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,MAAa,aAAa,EAAE,gBAAgC;CAC3D,MAAM,EAAE,MAAM,MAAM,eAAe;CACnC,MAAM,QAAQ,KAAK,MAAM;CACzB,IAAI,CAAC,SAAS,MAAM,SAAS,GAC5B,OAAO;CAER,MAAM,gBAAgB,EAAE,KAAK,qBAAqB;CAClD,OACC,oBAAC,MAAD;EAAI,WAAW,GAAG,iBAAiB,SAAS;YAC1C,MAAM,KAAK,UAAU,UAAU;GAC/B,MAAM,UAAU,UAAU,KAAK;GAC/B,OACC,oBAAC,MAAD;IAEC,WAAW,GAAG,uBAAuB,WAAW,8BAA8B;IAC9E,gBAAc,UAAU,SAAS,KAAA;cAEhC,UAAU,UAAU,OAAO,aAAa;GACtC,GALE,SAAS,EAKX;EAEN,CAAC;CACE,CAAA;AAEN"}

package/dist/react/Honeypot.d.ts

@@ -0,0 +1,22 @@
+import { Ref } from "react";
+
+//#region src/react/Honeypot.d.ts
+type HoneypotProps = {
+  name: string;
+  inputRef?: Ref<HTMLInputElement>;
+};
+/**
+ * A visually hidden honeypot decoy. Real users never see or tab to it; bots that fill every input
+ * trip it, and the server rejects the submission.
+ *
+ * `autoComplete="new-password"` is used instead of `"off"` because Chrome frequently ignores `"off"`
+ * but reliably respects `"new-password"` to prevent autofill. The field name is intentionally generic
+ * (no "email" token) to avoid Chrome's email-address heuristic.
+ */
+declare const Honeypot: ({
+  name,
+  inputRef
+}: HoneypotProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { Honeypot, HoneypotProps };
+//# sourceMappingURL=Honeypot.d.ts.map

package/dist/react/Honeypot.js

@@ -0,0 +1,38 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/react/Honeypot.tsx
+const HIDDEN = {
+	position: "absolute",
+	width: 1,
+	height: 1,
+	padding: 0,
+	margin: -1,
+	overflow: "hidden",
+	clip: "rect(0, 0, 0, 0)",
+	whiteSpace: "nowrap",
+	border: 0
+};
+/**
+* A visually hidden honeypot decoy. Real users never see or tab to it; bots that fill every input
+* trip it, and the server rejects the submission.
+*
+* `autoComplete="new-password"` is used instead of `"off"` because Chrome frequently ignores `"off"`
+* but reliably respects `"new-password"` to prevent autofill. The field name is intentionally generic
+* (no "email" token) to avoid Chrome's email-address heuristic.
+*/
+const Honeypot = ({ name, inputRef }) => /* @__PURE__ */ jsx("div", {
+	"aria-hidden": "true",
+	style: HIDDEN,
+	children: /* @__PURE__ */ jsxs("label", { children: ["Leave this field empty", /* @__PURE__ */ jsx("input", {
+		ref: inputRef,
+		type: "text",
+		name,
+		tabIndex: -1,
+		autoComplete: "new-password",
+		defaultValue: ""
+	})] })
+});
+//#endregion
+export { Honeypot };
+
+//# sourceMappingURL=Honeypot.js.map

package/dist/react/Honeypot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Honeypot.js","names":[],"sources":["../../src/react/Honeypot.tsx"],"sourcesContent":["'use client'\n\nimport type { CSSProperties, Ref } from 'react'\n\nconst HIDDEN: CSSProperties = {\n\tposition: 'absolute',\n\twidth: 1,\n\theight: 1,\n\tpadding: 0,\n\tmargin: -1,\n\toverflow: 'hidden',\n\tclip: 'rect(0, 0, 0, 0)',\n\twhiteSpace: 'nowrap',\n\tborder: 0,\n}\n\nexport type HoneypotProps = {\n\tname: string\n\tinputRef?: Ref<HTMLInputElement>\n}\n\n/**\n * A visually hidden honeypot decoy. Real users never see or tab to it; bots that fill every input\n * trip it, and the server rejects the submission.\n *\n * `autoComplete=\"new-password\"` is used instead of `\"off\"` because Chrome frequently ignores `\"off\"`\n * but reliably respects `\"new-password\"` to prevent autofill. The field name is intentionally generic\n * (no \"email\" token) to avoid Chrome's email-address heuristic.\n */\nexport const Honeypot = ({ name, inputRef }: HoneypotProps) => (\n\t<div aria-hidden=\"true\" style={HIDDEN}>\n\t\t<label>\n\t\t\tLeave this field empty\n\t\t\t<input\n\t\t\t\tref={inputRef}\n\t\t\t\ttype=\"text\"\n\t\t\t\tname={name}\n\t\t\t\ttabIndex={-1}\n\t\t\t\tautoComplete=\"new-password\"\n\t\t\t\tdefaultValue=\"\"\n\t\t\t/>\n\t\t</label>\n\t</div>\n)\n"],"mappings":";;;AAIA,MAAM,SAAwB;CAC7B,UAAU;CACV,OAAO;CACP,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,UAAU;CACV,MAAM;CACN,YAAY;CACZ,QAAQ;AACT;;;;;;;;;AAeA,MAAa,YAAY,EAAE,MAAM,eAChC,oBAAC,OAAD;CAAK,eAAY;CAAO,OAAO;WAC9B,qBAAC,SAAD,EAAA,UAAA,CAAO,0BAEN,oBAAC,SAAD;EACC,KAAK;EACL,MAAK;EACC;EACN,UAAU;EACV,cAAa;EACb,cAAa;CACb,CAAA,CACK,EAAA,CAAA;AACH,CAAA"}

package/dist/react/Poll.d.ts

@@ -0,0 +1,43 @@
+import { FormProps } from "./Form.js";
+import { fetchFormResults } from "./fetchResults.js";
+
+//#region src/react/Poll.d.ts
+type PollProps = FormProps & {
+  /** The choice field whose results are shown after voting (should match the form's public `poll.resultsField`). */resultsField: string; /** localStorage key for the per-browser voted guard. Default `fb-poll-{form.id}`. */
+  storageKey?: string;
+  /**
+   * Server-known voted state, ORed with the localStorage guard: `true` marks the visitor as voted;
+   * `false`/omitted falls back to localStorage. SSR hosts using the plugin's `poll.votedCookie`
+   * option pass `hasVotedCookie(cookieHeader, form.id)` here.
+   */
+  hasVoted?: boolean;
+  /**
+   * Injectable results fetch (testing); defaults to `fetchFormResults`. Pass a stable reference (module
+   * scope, `useCallback`, or `useMemo`): an inline function re-runs the load effect and double-fetches.
+   */
+  fetchResultsImpl?: typeof fetchFormResults;
+};
+/**
+ * A poll: renders `<Form>` while open and not yet voted, then fetches the aggregate results and shows
+ * `<FormResults>`. Lifecycle comes from `form.poll`: past `closesAt` the poll is closed (a translated
+ * notice plus results, which the endpoint serves for any visibility once closed); a voted-but-open
+ * `afterClose` poll shows a translated wait notice instead of fetching (the endpoint would refuse). A
+ * recorded `outcome.winningValues` (via `resolvePollOutcome`) supersedes everything: a translated final
+ * notice plus results with every winning bucket highlighted (a tie highlights more than one). A
+ * per-browser localStorage flag (`storageKey`) skips straight to results on revisit; `hasVoted: true`
+ * (e.g. from the server-set voted cookie) marks voted regardless of localStorage. The guard is UX, not
+ * integrity (bypassable): server-enforced
+ * one-per-identity dedup composes via `req.user` (authed forms) or a `notAlreadySubmitted` rule.
+ */
+declare const Poll: ({
+  resultsField,
+  storageKey,
+  hasVoted,
+  fetchResultsImpl,
+  apiRoute,
+  onSuccess,
+  ...formProps
+}: PollProps) => import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+export { Poll, PollProps };
+//# sourceMappingURL=Poll.d.ts.map

package/dist/react/Poll.js

@@ -0,0 +1,135 @@
+"use client";
+import { keys } from "../translations/keys.js";
+import { isPollClosed } from "../form/pollState.js";
+import { en } from "../translations/en.js";
+import { makeTranslate } from "../translations/makeTranslate.js";
+import { Form } from "./Form.js";
+import { FormResults } from "./FormResults.js";
+import { fetchFormResults } from "./fetchResults.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from "react";
+//#region src/react/Poll.tsx
+const readVoted = (key) => {
+	try {
+		return window.localStorage.getItem(key) != null;
+	} catch {
+		return false;
+	}
+};
+const writeVoted = (key) => {
+	try {
+		window.localStorage.setItem(key, "1");
+	} catch {}
+};
+/**
+* A poll: renders `<Form>` while open and not yet voted, then fetches the aggregate results and shows
+* `<FormResults>`. Lifecycle comes from `form.poll`: past `closesAt` the poll is closed (a translated
+* notice plus results, which the endpoint serves for any visibility once closed); a voted-but-open
+* `afterClose` poll shows a translated wait notice instead of fetching (the endpoint would refuse). A
+* recorded `outcome.winningValues` (via `resolvePollOutcome`) supersedes everything: a translated final
+* notice plus results with every winning bucket highlighted (a tie highlights more than one). A
+* per-browser localStorage flag (`storageKey`) skips straight to results on revisit; `hasVoted: true`
+* (e.g. from the server-set voted cookie) marks voted regardless of localStorage. The guard is UX, not
+* integrity (bypassable): server-enforced
+* one-per-identity dedup composes via `req.user` (authed forms) or a `notAlreadySubmitted` rule.
+*/
+const Poll = ({ resultsField, storageKey, hasVoted, fetchResultsImpl = fetchFormResults, apiRoute, onSuccess, ...formProps }) => {
+	const key = storageKey ?? `fb-poll-${formProps.form.id}`;
+	const poll = formProps.form.poll;
+	const closed = isPollClosed(poll);
+	const winningValues = poll?.outcome?.winningValues;
+	const finalized = Array.isArray(winningValues) && winningValues.length > 0;
+	const resultsAwaitClose = !closed && !finalized && poll?.resultsVisibility === "afterClose";
+	const [voted, setVoted] = useState(false);
+	const [results, setResults] = useState(null);
+	const [loadFailed, setLoadFailed] = useState(false);
+	const translate = useMemo(() => formProps.t ?? makeTranslate(en), [formProps.t]);
+	const loadResults = useCallback(async () => {
+		const result = await fetchResultsImpl({
+			formId: formProps.form.id,
+			field: resultsField,
+			apiRoute
+		});
+		if (result.ok) {
+			setResults(result.results);
+			setLoadFailed(false);
+		} else setLoadFailed(true);
+	}, [
+		fetchResultsImpl,
+		formProps.form.id,
+		resultsField,
+		apiRoute
+	]);
+	const resultsError = /* @__PURE__ */ jsx("p", {
+		className: "fb-poll__error",
+		role: "alert",
+		children: translate(keys.pollResultsError)
+	});
+	useEffect(() => {
+		const already = hasVoted === true || readVoted(key);
+		if (already) setVoted(true);
+		if (already && !resultsAwaitClose || closed || finalized) loadResults();
+	}, [
+		hasVoted,
+		key,
+		loadResults,
+		closed,
+		resultsAwaitClose,
+		finalized
+	]);
+	const handleSuccess = useCallback((submissionId, result) => {
+		writeVoted(key);
+		setVoted(true);
+		if (!resultsAwaitClose) loadResults();
+		onSuccess?.(submissionId, result);
+	}, [
+		key,
+		loadResults,
+		onSuccess,
+		resultsAwaitClose
+	]);
+	if (finalized) return /* @__PURE__ */ jsxs("div", {
+		className: "fb-poll fb-poll--final",
+		children: [/* @__PURE__ */ jsx("p", {
+			className: "fb-poll__final",
+			children: translate(keys.pollFinalResult)
+		}), loadFailed ? resultsError : results ? /* @__PURE__ */ jsx(FormResults, {
+			results,
+			winningValues,
+			t: formProps.t,
+			locale: formProps.locale
+		}) : null]
+	});
+	if (closed) return /* @__PURE__ */ jsxs("div", {
+		className: "fb-poll fb-poll--closed",
+		children: [/* @__PURE__ */ jsx("p", {
+			className: "fb-poll__closed",
+			children: translate(keys.pollClosed)
+		}), loadFailed ? resultsError : results ? /* @__PURE__ */ jsx(FormResults, {
+			results,
+			t: formProps.t,
+			locale: formProps.locale
+		}) : null]
+	});
+	if (voted) {
+		if (resultsAwaitClose) return /* @__PURE__ */ jsx("p", {
+			className: "fb-poll__await-close",
+			children: translate(keys.pollResultsAfterClose)
+		});
+		if (loadFailed) return resultsError;
+		return results ? /* @__PURE__ */ jsx(FormResults, {
+			results,
+			t: formProps.t,
+			locale: formProps.locale
+		}) : null;
+	}
+	return /* @__PURE__ */ jsx(Form, {
+		...formProps,
+		apiRoute,
+		onSuccess: handleSuccess
+	});
+};
+//#endregion
+export { Poll };
+
+//# sourceMappingURL=Poll.js.map

package/dist/react/Poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Poll.js","names":[],"sources":["../../src/react/Poll.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useEffect, useMemo, useState } from 'react'\nimport type { FieldAggregation } from '../aggregation/types'\nimport { isPollClosed } from '../form/pollState'\nimport { en } from '../translations/en'\nimport { keys } from '../translations/keys'\nimport { makeTranslate } from '../translations/makeTranslate'\nimport { Form, type FormProps } from './Form'\nimport { FormResults } from './FormResults'\nimport { type FetchResultsResult, fetchFormResults } from './fetchResults'\n\nexport type PollProps = FormProps & {\n\t/** The choice field whose results are shown after voting (should match the form's public `poll.resultsField`). */\n\tresultsField: string\n\t/** localStorage key for the per-browser voted guard. Default `fb-poll-{form.id}`. */\n\tstorageKey?: string\n\t/**\n\t * Server-known voted state, ORed with the localStorage guard: `true` marks the visitor as voted;\n\t * `false`/omitted falls back to localStorage. SSR hosts using the plugin's `poll.votedCookie`\n\t * option pass `hasVotedCookie(cookieHeader, form.id)` here.\n\t */\n\thasVoted?: boolean\n\t/**\n\t * Injectable results fetch (testing); defaults to `fetchFormResults`. Pass a stable reference (module\n\t * scope, `useCallback`, or `useMemo`): an inline function re-runs the load effect and double-fetches.\n\t */\n\tfetchResultsImpl?: typeof fetchFormResults\n}\n\nconst readVoted = (key: string): boolean => {\n\ttry {\n\t\treturn window.localStorage.getItem(key) != null\n\t} catch {\n\t\treturn false\n\t}\n}\n\nconst writeVoted = (key: string): void => {\n\ttry {\n\t\twindow.localStorage.setItem(key, '1')\n\t} catch {\n\t\t// Private mode / storage disabled: the guard is best-effort UX, never integrity.\n\t}\n}\n\n/**\n * A poll: renders `<Form>` while open and not yet voted, then fetches the aggregate results and shows\n * `<FormResults>`. Lifecycle comes from `form.poll`: past `closesAt` the poll is closed (a translated\n * notice plus results, which the endpoint serves for any visibility once closed); a voted-but-open\n * `afterClose` poll shows a translated wait notice instead of fetching (the endpoint would refuse). A\n * recorded `outcome.winningValues` (via `resolvePollOutcome`) supersedes everything: a translated final\n * notice plus results with every winning bucket highlighted (a tie highlights more than one). A\n * per-browser localStorage flag (`storageKey`) skips straight to results on revisit; `hasVoted: true`\n * (e.g. from the server-set voted cookie) marks voted regardless of localStorage. The guard is UX, not\n * integrity (bypassable): server-enforced\n * one-per-identity dedup composes via `req.user` (authed forms) or a `notAlreadySubmitted` rule.\n */\nexport const Poll = ({\n\tresultsField,\n\tstorageKey,\n\thasVoted,\n\tfetchResultsImpl = fetchFormResults,\n\tapiRoute,\n\tonSuccess,\n\t...formProps\n}: PollProps) => {\n\tconst key = storageKey ?? `fb-poll-${formProps.form.id}`\n\tconst poll = formProps.form.poll\n\tconst closed = isPollClosed(poll)\n\tconst winningValues = poll?.outcome?.winningValues\n\tconst finalized = Array.isArray(winningValues) && winningValues.length > 0\n\tconst resultsAwaitClose = !closed && !finalized && poll?.resultsVisibility === 'afterClose'\n\tconst [voted, setVoted] = useState(false)\n\tconst [results, setResults] = useState<FieldAggregation[] | null>(null)\n\tconst [loadFailed, setLoadFailed] = useState(false)\n\tconst translate = useMemo(() => formProps.t ?? makeTranslate(en), [formProps.t])\n\n\tconst loadResults = useCallback(async () => {\n\t\tconst result: FetchResultsResult = await fetchResultsImpl({\n\t\t\tformId: formProps.form.id,\n\t\t\tfield: resultsField,\n\t\t\tapiRoute,\n\t\t})\n\t\t// A failed load surfaces as an error, not an empty result set: `[]` would read as \"no votes yet\".\n\t\tif (result.ok) {\n\t\t\tsetResults(result.results)\n\t\t\tsetLoadFailed(false)\n\t\t} else {\n\t\t\tsetLoadFailed(true)\n\t\t}\n\t}, [fetchResultsImpl, formProps.form.id, resultsField, apiRoute])\n\n\tconst resultsError = (\n\t\t<p className=\"fb-poll__error\" role=\"alert\">\n\t\t\t{translate(keys.pollResultsError)}\n\t\t</p>\n\t)\n\n\tuseEffect(() => {\n\t\tconst already = hasVoted === true || readVoted(key)\n\t\tif (already) {\n\t\t\tsetVoted(true)\n\t\t}\n\t\tif ((already && !resultsAwaitClose) || closed || finalized) {\n\t\t\tvoid loadResults()\n\t\t}\n\t}, [hasVoted, key, loadResults, closed, resultsAwaitClose, finalized])\n\n\tconst handleSuccess = useCallback<NonNullable<FormProps['onSuccess']>>(\n\t\t(submissionId, result) => {\n\t\t\twriteVoted(key)\n\t\t\tsetVoted(true)\n\t\t\tif (!resultsAwaitClose) {\n\t\t\t\tvoid loadResults()\n\t\t\t}\n\t\t\t// Forward the resolved success response so a Poll host gets the same onSuccess payload as a Form host.\n\t\t\tonSuccess?.(submissionId, result)\n\t\t},\n\t\t[key, loadResults, onSuccess, resultsAwaitClose]\n\t)\n\n\tif (finalized) {\n\t\treturn (\n\t\t\t<div className=\"fb-poll fb-poll--final\">\n\t\t\t\t<p className=\"fb-poll__final\">{translate(keys.pollFinalResult)}</p>\n\t\t\t\t{loadFailed ? (\n\t\t\t\t\tresultsError\n\t\t\t\t) : results ? (\n\t\t\t\t\t<FormResults\n\t\t\t\t\t\tresults={results}\n\t\t\t\t\t\twinningValues={winningValues}\n\t\t\t\t\t\tt={formProps.t}\n\t\t\t\t\t\tlocale={formProps.locale}\n\t\t\t\t\t/>\n\t\t\t\t) : null}\n\t\t\t</div>\n\t\t)\n\t}\n\n\tif (closed) {\n\t\treturn (\n\t\t\t<div className=\"fb-poll fb-poll--closed\">\n\t\t\t\t<p className=\"fb-poll__closed\">{translate(keys.pollClosed)}</p>\n\t\t\t\t{loadFailed ? (\n\t\t\t\t\tresultsError\n\t\t\t\t) : results ? (\n\t\t\t\t\t<FormResults results={results} t={formProps.t} locale={formProps.locale} />\n\t\t\t\t) : null}\n\t\t\t</div>\n\t\t)\n\t}\n\n\tif (voted) {\n\t\tif (resultsAwaitClose) {\n\t\t\treturn <p className=\"fb-poll__await-close\">{translate(keys.pollResultsAfterClose)}</p>\n\t\t}\n\t\tif (loadFailed) {\n\t\t\treturn resultsError\n\t\t}\n\t\treturn results ? (\n\t\t\t<FormResults results={results} t={formProps.t} locale={formProps.locale} />\n\t\t) : null\n\t}\n\n\treturn <Form {...formProps} apiRoute={apiRoute} onSuccess={handleSuccess} />\n}\n"],"mappings":";;;;;;;;;;;AA8BA,MAAM,aAAa,QAAyB;CAC3C,IAAI;EACH,OAAO,OAAO,aAAa,QAAQ,GAAG,KAAK;CAC5C,QAAQ;EACP,OAAO;CACR;AACD;AAEA,MAAM,cAAc,QAAsB;CACzC,IAAI;EACH,OAAO,aAAa,QAAQ,KAAK,GAAG;CACrC,QAAQ,CAER;AACD;;;;;;;;;;;;;AAcA,MAAa,QAAQ,EACpB,cACA,YACA,UACA,mBAAmB,kBACnB,UACA,WACA,GAAG,gBACa;CAChB,MAAM,MAAM,cAAc,WAAW,UAAU,KAAK;CACpD,MAAM,OAAO,UAAU,KAAK;CAC5B,MAAM,SAAS,aAAa,IAAI;CAChC,MAAM,gBAAgB,MAAM,SAAS;CACrC,MAAM,YAAY,MAAM,QAAQ,aAAa,KAAK,cAAc,SAAS;CACzE,MAAM,oBAAoB,CAAC,UAAU,CAAC,aAAa,MAAM,sBAAsB;CAC/E,MAAM,CAAC,OAAO,YAAY,SAAS,KAAK;CACxC,MAAM,CAAC,SAAS,cAAc,SAAoC,IAAI;CACtE,MAAM,CAAC,YAAY,iBAAiB,SAAS,KAAK;CAClD,MAAM,YAAY,cAAc,UAAU,KAAK,cAAc,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;CAE/E,MAAM,cAAc,YAAY,YAAY;EAC3C,MAAM,SAA6B,MAAM,iBAAiB;GACzD,QAAQ,UAAU,KAAK;GACvB,OAAO;GACP;EACD,CAAC;EAED,IAAI,OAAO,IAAI;GACd,WAAW,OAAO,OAAO;GACzB,cAAc,KAAK;EACpB,OACC,cAAc,IAAI;CAEpB,GAAG;EAAC;EAAkB,UAAU,KAAK;EAAI;EAAc;CAAQ,CAAC;CAEhE,MAAM,eACL,oBAAC,KAAD;EAAG,WAAU;EAAiB,MAAK;YACjC,UAAU,KAAK,gBAAgB;CAC9B,CAAA;CAGJ,gBAAgB;EACf,MAAM,UAAU,aAAa,QAAQ,UAAU,GAAG;EAClD,IAAI,SACH,SAAS,IAAI;EAEd,IAAK,WAAW,CAAC,qBAAsB,UAAU,WAChD,YAAiB;CAEnB,GAAG;EAAC;EAAU;EAAK;EAAa;EAAQ;EAAmB;CAAS,CAAC;CAErE,MAAM,gBAAgB,aACpB,cAAc,WAAW;EACzB,WAAW,GAAG;EACd,SAAS,IAAI;EACb,IAAI,CAAC,mBACJ,YAAiB;EAGlB,YAAY,cAAc,MAAM;CACjC,GACA;EAAC;EAAK;EAAa;EAAW;CAAiB,CAChD;CAEA,IAAI,WACH,OACC,qBAAC,OAAD;EAAK,WAAU;YAAf,CACC,oBAAC,KAAD;GAAG,WAAU;aAAkB,UAAU,KAAK,eAAe;EAAK,CAAA,GACjE,aACA,eACG,UACH,oBAAC,aAAD;GACU;GACM;GACf,GAAG,UAAU;GACb,QAAQ,UAAU;EAClB,CAAA,IACE,IACA;;CAIP,IAAI,QACH,OACC,qBAAC,OAAD;EAAK,WAAU;YAAf,CACC,oBAAC,KAAD;GAAG,WAAU;aAAmB,UAAU,KAAK,UAAU;EAAK,CAAA,GAC7D,aACA,eACG,UACH,oBAAC,aAAD;GAAsB;GAAS,GAAG,UAAU;GAAG,QAAQ,UAAU;EAAS,CAAA,IACvE,IACA;;CAIP,IAAI,OAAO;EACV,IAAI,mBACH,OAAO,oBAAC,KAAD;GAAG,WAAU;aAAwB,UAAU,KAAK,qBAAqB;EAAK,CAAA;EAEtF,IAAI,YACH,OAAO;EAER,OAAO,UACN,oBAAC,aAAD;GAAsB;GAAS,GAAG,UAAU;GAAG,QAAQ,UAAU;EAAS,CAAA,IACvE;CACL;CAEA,OAAO,oBAAC,MAAD;EAAM,GAAI;EAAqB;EAAU,WAAW;CAAgB,CAAA;AAC5E"}

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

@@ -0,0 +1,28 @@
+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;
+  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,
+  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, 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 = 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 { 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\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\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)\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":";;;;;;AAOA,MAAa,sBAAsB;;;;;AAmBnC,MAAa,mBAAmB,EAC/B,SACA,SACA,SACA,WACA,YAAY,qBACZ,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,SAAS;CAExC,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,41 @@
+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;
+  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,
+  ref
+}: RecaptchaCaptchaProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { RECAPTCHA_SCRIPT_URL, RecaptchaCaptcha, RecaptchaCaptchaHandle, RecaptchaCaptchaProps };
+//# sourceMappingURL=RecaptchaCaptcha.d.ts.map