@vtex/faststore 0.0.7 → 0.0.10

package/dist/particles/copy-text/copy-text.js

@@ -0,0 +1,140 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { useIntl } from "../../sdk/i18n/client.js";
+import { Button } from "../button/button.js";
+import { useEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/particles/copy-text/copy-text.tsx
+const CLEAR_AFTER_MS = 5e3;
+function isBlank(text) {
+	return text.trim().length === 0;
+}
+const CopyTextDefinition = defineComponent({
+	name: "CopyText",
+	importPath: "@vtex/faststore/components",
+	component: CopyText,
+	editor: {
+		label: "Copy Text",
+		category: "action"
+	},
+	schema: {
+		accessibleName: {
+			type: "string",
+			default: "Copy",
+			label: "Accessible name"
+		},
+		successMessage: {
+			type: "string",
+			default: "Copied",
+			label: "Success message"
+		},
+		failureMessage: {
+			type: "string",
+			default: "Could not copy",
+			label: "Failure message"
+		},
+		dismissLabel: {
+			type: "string",
+			default: "Dismiss",
+			label: "Dismiss label"
+		}
+	},
+	guideline: "Copies the text it is given and confirms the result inline. Pass the identifier as text and the visible icon or label as children. Do not pass surrounding heading text."
+});
+function CopyText({ text, accessibleName, successMessage, failureMessage, dismissLabel, children, className, ref }) {
+	const intl = useIntl();
+	const name = accessibleName ?? intl.formatMessage({ id: "fs/order.copy.action" });
+	const success = successMessage ?? intl.formatMessage({ id: "fs/order.copy.copied" });
+	const failure = failureMessage ?? intl.formatMessage({ id: "fs/order.copy.failure" });
+	const dismissText = dismissLabel ?? intl.formatMessage({ id: "fs/order.copy.dismiss" });
+	const [outcome, setOutcome] = useState("idle");
+	const actionRef = useRef(null);
+	const timerRef = useRef(null);
+	const generation = useRef(0);
+	const active = useRef(true);
+	function clearTimer() {
+		if (timerRef.current === null) return;
+		clearTimeout(timerRef.current);
+		timerRef.current = null;
+	}
+	useEffect(() => {
+		active.current = true;
+		return () => {
+			active.current = false;
+			if (timerRef.current === null) return;
+			clearTimeout(timerRef.current);
+			timerRef.current = null;
+		};
+	}, []);
+	function scheduleClear(token) {
+		clearTimer();
+		if (!active.current) return;
+		timerRef.current = setTimeout(() => {
+			if (!active.current || generation.current !== token) return;
+			setOutcome("idle");
+		}, CLEAR_AFTER_MS);
+	}
+	async function copy() {
+		if (isBlank(text) || outcome === "pending") return;
+		const token = generation.current + 1;
+		generation.current = token;
+		clearTimer();
+		setOutcome("pending");
+		const write = navigator.clipboard?.writeText;
+		if (typeof write !== "function") {
+			if (!active.current || generation.current !== token) return;
+			setOutcome("failure");
+			scheduleClear(token);
+			return;
+		}
+		try {
+			await write.call(navigator.clipboard, text);
+			if (!active.current || generation.current !== token) return;
+			setOutcome("success");
+		} catch {
+			if (!active.current || generation.current !== token) return;
+			setOutcome("failure");
+		}
+		scheduleClear(token);
+	}
+	useEffect(() => {
+		if (outcome === "success" || outcome === "failure") actionRef.current?.focus();
+	}, [outcome]);
+	function dismiss() {
+		generation.current += 1;
+		clearTimer();
+		setOutcome("idle");
+		actionRef.current?.focus();
+	}
+	const message = outcome === "success" ? success : failure;
+	return /* @__PURE__ */ jsxs("span", {
+		ref,
+		className,
+		"data-fs-copy-text": "",
+		"data-fs-copy-text-outcome": outcome,
+		children: [/* @__PURE__ */ jsx(Button, {
+			ref: actionRef,
+			type: "button",
+			"aria-label": name,
+			"data-fs-copy-text-action": "",
+			disabled: isBlank(text) || outcome === "pending",
+			onClick: () => {
+				copy();
+			},
+			children
+		}), outcome === "success" || outcome === "failure" ? /* @__PURE__ */ jsxs("output", {
+			"data-fs-copy-text-message": "",
+			children: [message, /* @__PURE__ */ jsx(Button, {
+				type: "button",
+				"aria-label": dismissText,
+				onClick: dismiss,
+				children: dismissText
+			})]
+		}) : null]
+	});
+}
+//#endregion
+export { CopyText, CopyTextDefinition };
+
+//# sourceMappingURL=copy-text.js.map

package/dist/particles/copy-text/copy-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-text.js","names":[],"sources":["../../../src/particles/copy-text/copy-text.tsx"],"sourcesContent":["'use client';\n\nimport { defineComponent } from '@vtex/fs-core';\nimport { type ReactNode, type Ref, useEffect, useRef, useState } from 'react';\nimport { useIntl } from '../../sdk/i18n/client.js';\nimport { Button } from '../button/button';\n\nconst CLEAR_AFTER_MS = 5000;\n\nexport type CopyTextOutcome = 'idle' | 'pending' | 'success' | 'failure';\n\nexport type CopyTextProps = Readonly<{\n  text: string;\n  accessibleName?: string;\n  successMessage?: string;\n  failureMessage?: string;\n  dismissLabel?: string;\n  children?: ReactNode;\n  className?: string;\n  ref?: Ref<HTMLSpanElement>;\n}>;\n\nfunction isBlank(text: string): boolean {\n  return text.trim().length === 0;\n}\n\nexport const CopyTextDefinition = defineComponent<CopyTextProps>({\n  name: 'CopyText',\n  importPath: '@vtex/faststore/components',\n  component: CopyText,\n  editor: { label: 'Copy Text', category: 'action' },\n  schema: {\n    accessibleName: { type: 'string', default: 'Copy', label: 'Accessible name' },\n    successMessage: { type: 'string', default: 'Copied', label: 'Success message' },\n    failureMessage: { type: 'string', default: 'Could not copy', label: 'Failure message' },\n    dismissLabel: { type: 'string', default: 'Dismiss', label: 'Dismiss label' },\n  },\n  guideline:\n    'Copies the text it is given and confirms the result inline. Pass the identifier as text and the visible icon or label as children. Do not pass surrounding heading text.',\n});\n\nexport function CopyText({\n  text,\n  accessibleName,\n  successMessage,\n  failureMessage,\n  dismissLabel,\n  children,\n  className,\n  ref,\n}: CopyTextProps) {\n  const intl = useIntl();\n  const name = accessibleName ?? intl.formatMessage({ id: 'fs/order.copy.action' });\n  const success = successMessage ?? intl.formatMessage({ id: 'fs/order.copy.copied' });\n  const failure = failureMessage ?? intl.formatMessage({ id: 'fs/order.copy.failure' });\n  const dismissText = dismissLabel ?? intl.formatMessage({ id: 'fs/order.copy.dismiss' });\n  const [outcome, setOutcome] = useState<CopyTextOutcome>('idle');\n  const actionRef = useRef<HTMLButtonElement>(null);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const generation = useRef(0);\n  const active = useRef(true);\n\n  function clearTimer() {\n    if (timerRef.current === null) return;\n    clearTimeout(timerRef.current);\n    timerRef.current = null;\n  }\n\n  useEffect(() => {\n    active.current = true;\n    return () => {\n      active.current = false;\n      if (timerRef.current === null) return;\n      clearTimeout(timerRef.current);\n      timerRef.current = null;\n    };\n  }, []);\n\n  function scheduleClear(token: number) {\n    clearTimer();\n    if (!active.current) return;\n    timerRef.current = setTimeout(() => {\n      if (!active.current || generation.current !== token) return;\n      setOutcome('idle');\n    }, CLEAR_AFTER_MS);\n  }\n\n  async function copy() {\n    if (isBlank(text) || outcome === 'pending') return;\n    const token = generation.current + 1;\n    generation.current = token;\n    clearTimer();\n    setOutcome('pending');\n\n    const write = navigator.clipboard?.writeText;\n    if (typeof write !== 'function') {\n      if (!active.current || generation.current !== token) return;\n      setOutcome('failure');\n      scheduleClear(token);\n      return;\n    }\n\n    try {\n      await write.call(navigator.clipboard, text);\n      if (!active.current || generation.current !== token) return;\n      setOutcome('success');\n    } catch {\n      if (!active.current || generation.current !== token) return;\n      setOutcome('failure');\n    }\n    scheduleClear(token);\n  }\n\n  // The action is disabled while pending, and a disabled control ignores focus(). Focus moves back\n  // once the outcome that re-enables it has committed.\n  useEffect(() => {\n    if (outcome === 'success' || outcome === 'failure') {\n      actionRef.current?.focus();\n    }\n  }, [outcome]);\n\n  function dismiss() {\n    generation.current += 1;\n    clearTimer();\n    setOutcome('idle');\n    actionRef.current?.focus();\n  }\n\n  const message = outcome === 'success' ? success : failure;\n\n  return (\n    <span ref={ref} className={className} data-fs-copy-text=\"\" data-fs-copy-text-outcome={outcome}>\n      <Button\n        ref={actionRef}\n        type=\"button\"\n        aria-label={name}\n        data-fs-copy-text-action=\"\"\n        disabled={isBlank(text) || outcome === 'pending'}\n        onClick={() => {\n          void copy();\n        }}\n      >\n        {children}\n      </Button>\n      {outcome === 'success' || outcome === 'failure' ? (\n        <output data-fs-copy-text-message=\"\">\n          {message}\n          <Button type=\"button\" aria-label={dismissText} onClick={dismiss}>\n            {dismissText}\n          </Button>\n        </output>\n      ) : null}\n    </span>\n  );\n}\n"],"mappings":"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"}

package/dist/particles/document-field/document-field.d.ts

@@ -3,13 +3,18 @@ import "../../core/dist/index.js";
 import { applyMask } from "../shared/input-mask.js";
 import { ComponentPropsWithRef, FocusEvent, ReactNode, Ref } from "react";
 //#region src/particles/document-field/document-field.d.ts
-export type DocumentType = 'CPF';
+export type DocumentType = 'CPF' | 'SSN' | 'SIN' | 'RFC';
 type DocumentFieldRequirement = 'mandatory' | 'optional';
 export type DocumentSpec = {
   id: DocumentType;
   name: string;
   mask: string;
+  placeholder: string;
+  /** Strips what the type never holds, before the mask runs. */
+  sanitize: (raw: string) => string;
   validate: (value: string) => boolean;
+  /** `'off'` for SSN and SIN, absent for CPF and RFC (Decision 9). */
+  autoComplete?: 'off';
 };
 export type DocumentFieldProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValue' | 'value' | 'onChange' | 'onBlur' | 'ref' | 'dangerouslySetInnerHTML'> & {
   /** Unused on the bound path — react-hook-form owns the value. */
@@ -54,9 +59,33 @@ export type DocumentFieldProps = Omit<ComponentPropsWithRef<'div'>, 'defaultValu
  * digits. Runs on blur/submit only, never per keystroke.
  */
 export declare function validateCPF(value: string): boolean;
+/**
+ * SSN validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16). Strips non-digits,
+ * requires exactly 9 digits, refuses area `000`, `666` and `>= 900`, group `00` and serial `0000`.
+ */
+export declare function validateSSN(value: string): boolean;
+/**
+ * SIN validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16). Strips non-digits,
+ * requires exactly 9 digits, refuses all zeros, and verifies the Luhn check.
+ */
+export declare function validateSIN(value: string): boolean;
+/**
+ * RFC (individual) validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16): after
+ * uppercasing and stripping every non A-Z0-9 character it is four letters, six digits and three
+ * letters or digits, and characters 5-10 read as a plausible month (1-12) and day (1-31). The day check
+ * is not calendar-aware, as in the library. The library's set of refused four-letter prefixes is not
+ * carried (the structure and the date are what a typo breaks).
+ */
+export declare function validateRFC(value: string): boolean;
 export declare const DOCUMENTS: Record<DocumentType, DocumentSpec>;
 /**
- * True when `type` is a document type this build supports (lets a host gate the field by locale).
+ * Turns the API's lower-case document id (`Payment.countries[].documents[].type`) into this table's key,
+ * or `null` for anything else, including a business document, a prototype key and a non-string.
+ */
+export declare function documentTypeFromId(id: unknown): DocumentType | null;
+/**
+ * True when `type` is one of the table's upper-case keys (`CPF`, `SSN`, `SIN`, `RFC`); the API's lower-case
+ * ids go through `documentTypeFromId`. Lets a host gate the field by locale.
  *
  * `Object.hasOwn`, not the `in` operator: `in` walks the prototype chain, so `constructor`,
  * `__proto__` and `toString` all satisfied it and were then trusted as a `DocumentType` by callers
@@ -66,9 +95,9 @@ export declare const DOCUMENTS: Record<DocumentType, DocumentSpec>;
  */
 export declare function isSupportedDocumentType(type: unknown): type is DocumentType;
 /**
- * Apply a document type's mask to raw input: strip non-digits for digit-only masks, then truncate to
- * the mask's slot count so excess characters never trail past the mask (e.g. a 15-digit paste into
- * the 11-slot CPF mask yields `111.444.777-35`, not `111.444.777-358888`).
+ * Apply a document type's mask to raw input: run the type's sanitiser, then truncate to the mask's slot
+ * count so excess characters never trail past the mask (e.g. a 15-digit paste into the 11-slot CPF mask
+ * yields `111.444.777-35`, not `111.444.777-358888`).
  */
 export declare function maskDocumentValue(rawValue: string, documentType: DocumentType): string;
 /**

package/dist/particles/document-field/document-field.js

@@ -5,7 +5,7 @@ import { FieldBinding, TEXT_FIELD_VALUE, mergeFieldValidator, useBoundField, use
 import { useComposedRef } from "../shared/compose-refs.js";
 import { applyMask, countSlots, isDigitOnly } from "../shared/input-mask.js";
 import { createContext, useContext, useMemo, useState } from "react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Field } from "@base-ui/react/field";
 import { useFormContext, useFormState } from "react-hook-form";
 //#region src/particles/document-field/document-field.tsx
@@ -15,20 +15,112 @@ import { useFormContext, useFormState } from "react-hook-form";
 * digits. Runs on blur/submit only, never per keystroke.
 */
 function validateCPF(value) {
-	const digits = value.replace(/[^\d]+/g, "");
+	const digits = value.replaceAll(/[^\d]+/g, "");
 	if (digits.length !== 11 || /(\d)\1{10}/.test(digits)) return false;
 	const values = digits.split("").map((el) => +el);
 	const rest = (count) => values.slice(0, count - 12).reduce((sum, el, index) => sum + el * (count - index), 0) * 10 % 11 % 10;
 	return rest(10) === values[9] && rest(11) === values[10];
 }
-const DOCUMENTS = { CPF: {
-	id: "CPF",
-	name: "CPF",
-	mask: "999.999.999-99",
-	validate: validateCPF
-} };
 /**
-* True when `type` is a document type this build supports (lets a host gate the field by locale).
+* SSN validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16). Strips non-digits,
+* requires exactly 9 digits, refuses area `000`, `666` and `>= 900`, group `00` and serial `0000`.
+*/
+function validateSSN(value) {
+	const digits = value.replaceAll(/\D/g, "");
+	if (digits.length !== 9) return false;
+	const area = digits.slice(0, 3);
+	if (area === "000" || area === "666" || Number(area) >= 900) return false;
+	if (digits.slice(3, 5) === "00") return false;
+	return digits.slice(5) !== "0000";
+}
+/**
+* SIN validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16). Strips non-digits,
+* requires exactly 9 digits, refuses all zeros, and verifies the Luhn check.
+*/
+function validateSIN(value) {
+	const digits = value.replaceAll(/\D/g, "");
+	if (digits.length !== 9 || /^0+$/.test(digits)) return false;
+	let sum = 0;
+	for (let index = 0; index < 9; index += 1) {
+		let digit = Number(digits[index]);
+		if (index % 2 === 1) {
+			digit *= 2;
+			if (digit > 9) digit -= 9;
+		}
+		sum += digit;
+	}
+	return sum % 10 === 0;
+}
+/**
+* RFC (individual) validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16): after
+* uppercasing and stripping every non A-Z0-9 character it is four letters, six digits and three
+* letters or digits, and characters 5-10 read as a plausible month (1-12) and day (1-31). The day check
+* is not calendar-aware, as in the library. The library's set of refused four-letter prefixes is not
+* carried (the structure and the date are what a typo breaks).
+*/
+function validateRFC(value) {
+	const rfc = value.toUpperCase().replaceAll(/[^A-Z0-9]/g, "");
+	if (!/^[A-Z]{4}\d{6}[A-Z0-9]{3}$/.test(rfc)) return false;
+	const month = Number(rfc.slice(6, 8));
+	const day = Number(rfc.slice(8, 10));
+	return month >= 1 && month <= 12 && day >= 1 && day <= 31;
+}
+function stripNonDigits(raw) {
+	return raw.replaceAll(/\D/g, "");
+}
+const DOCUMENTS = {
+	CPF: {
+		id: "CPF",
+		name: "CPF",
+		mask: "999.999.999-99",
+		placeholder: "000.000.000-00",
+		sanitize: stripNonDigits,
+		validate: validateCPF
+	},
+	SSN: {
+		id: "SSN",
+		name: "SSN",
+		mask: "999-99-9999",
+		placeholder: "000-00-0000",
+		sanitize: stripNonDigits,
+		validate: validateSSN,
+		autoComplete: "off"
+	},
+	SIN: {
+		id: "SIN",
+		name: "SIN",
+		mask: "999-999-999",
+		placeholder: "000-000-000",
+		sanitize: stripNonDigits,
+		validate: validateSIN,
+		autoComplete: "off"
+	},
+	RFC: {
+		id: "RFC",
+		name: "RFC",
+		mask: "SSSSSSSSSSSSS",
+		placeholder: "AAAA000000AAA",
+		sanitize: (raw) => raw.toUpperCase().replaceAll(/[^A-Z0-9]/g, ""),
+		validate: validateRFC
+	}
+};
+const DOCUMENT_TYPE_BY_API_ID = {
+	cpf: "CPF",
+	ssn: "SSN",
+	sin: "SIN",
+	rfc: "RFC"
+};
+/**
+* Turns the API's lower-case document id (`Payment.countries[].documents[].type`) into this table's key,
+* or `null` for anything else, including a business document, a prototype key and a non-string.
+*/
+function documentTypeFromId(id) {
+	if (typeof id !== "string" || !Object.hasOwn(DOCUMENT_TYPE_BY_API_ID, id)) return null;
+	return DOCUMENT_TYPE_BY_API_ID[id] ?? null;
+}
+/**
+* True when `type` is one of the table's upper-case keys (`CPF`, `SSN`, `SIN`, `RFC`); the API's lower-case
+* ids go through `documentTypeFromId`. Lets a host gate the field by locale.
 *
 * `Object.hasOwn`, not the `in` operator: `in` walks the prototype chain, so `constructor`,
 * `__proto__` and `toString` all satisfied it and were then trusted as a `DocumentType` by callers
@@ -40,15 +132,14 @@ function isSupportedDocumentType(type) {
 	return typeof type === "string" && Object.hasOwn(DOCUMENTS, type);
 }
 /**
-* Apply a document type's mask to raw input: strip non-digits for digit-only masks, then truncate to
-* the mask's slot count so excess characters never trail past the mask (e.g. a 15-digit paste into
-* the 11-slot CPF mask yields `111.444.777-35`, not `111.444.777-358888`).
+* Apply a document type's mask to raw input: run the type's sanitiser, then truncate to the mask's slot
+* count so excess characters never trail past the mask (e.g. a 15-digit paste into the 11-slot CPF mask
+* yields `111.444.777-35`, not `111.444.777-358888`).
 */
 function maskDocumentValue(rawValue, documentType) {
 	const spec = DOCUMENTS[documentType];
-	const sanitized = isDigitOnly(spec.mask) ? rawValue.replace(/\D/g, "") : rawValue;
 	const maxSlots = Math.max(...spec.mask.split("|").map(countSlots));
-	return applyMask(sanitized.slice(0, maxSlots), spec.mask);
+	return applyMask(spec.sanitize(rawValue).slice(0, maxSlots), spec.mask);
 }
 /**
 * Check-digit validity for a document value. An **empty** value is valid (the field is optional),
@@ -96,7 +187,7 @@ const DocumentFieldDefinition = defineComponent({
 			label: "Disabled"
 		}
 	},
-	guideline: "Presentational tax-document input composing the Field particle; applies the locale mask on change and runs check-digit validation on blur/submit. Data-agnostic (value/defaultValue/onValueChange); a host wires it to the shopper profile. CPF is optional by default: requirement only ever raises the field to required, announced as aria-required, and bound to a fieldset whose rule already says required it cannot lower it back. Recomposable (RFC:503): given children, they replace the default Field.Label + DocumentFieldInput + Field.Error anatomy, in any order."
+	guideline: "Presentational tax-document input composing the Field particle; applies the mask of its document type on change and runs the matching validation on blur/submit; documentType is one of CPF, SSN, SIN or RFC. Data-agnostic (value/defaultValue/onValueChange); a host wires it to the shopper profile. The document is optional by default: requirement only ever raises the field to required, announced as aria-required, and bound to a fieldset whose rule already says required it cannot lower it back. Recomposable (RFC:503): given children, they replace the default Field.Label + DocumentFieldInput + Field.Error anatomy, in any order."
 });
 /**
 * Presentational tax-document input (particle). Composes the `Field` particle (`Field.Root` +
@@ -141,7 +232,7 @@ const DocumentFieldInputDefinition = defineComponent({
 });
 /** Renders the masked document `<input>`, reading its value/handlers/ref from the enclosing `DocumentField`. */
 function DocumentFieldInput({ className }) {
-	const { ref, name, value, placeholder, disabled, required, numericOnly, onChange, onBlur } = useDocumentFieldInputContext();
+	const { ref, name, value, placeholder, disabled, required, numericOnly, autoComplete, onChange, onBlur } = useDocumentFieldInputContext();
 	return /* @__PURE__ */ jsx(Field.Control, {
 		ref,
 		name,
@@ -149,6 +240,7 @@ function DocumentFieldInput({ className }) {
 		placeholder,
 		disabled,
 		value,
+		autoComplete,
 		...numericOnly ? { inputMode: "numeric" } : {},
 		onChange,
 		onBlur,
@@ -156,7 +248,7 @@ function DocumentFieldInput({ className }) {
 		"data-fs-field-control": ""
 	});
 }
-function DocumentFieldView({ className, name, label, placeholder, disabled, required, numericOnly, displayValue, showInvalid, errorMessage, onChange, onBlur, ref, children, ...props }) {
+function DocumentFieldView({ className, name, label, placeholder, disabled, required, numericOnly, autoComplete, displayValue, showInvalid, errorMessage, onChange, onBlur, ref, children, ...props }) {
 	const inputContext = useMemo(() => ({
 		ref,
 		name,
@@ -165,6 +257,7 @@ function DocumentFieldView({ className, name, label, placeholder, disabled, requ
 		disabled,
 		required,
 		numericOnly,
+		autoComplete,
 		onChange,
 		onBlur
 	}), [
@@ -175,6 +268,7 @@ function DocumentFieldView({ className, name, label, placeholder, disabled, requ
 		disabled,
 		required,
 		numericOnly,
+		autoComplete,
 		onChange,
 		onBlur
 	]);
@@ -188,7 +282,7 @@ function DocumentFieldView({ className, name, label, placeholder, disabled, requ
 		"data-fs-field-root": "",
 		children: /* @__PURE__ */ jsx(DocumentFieldInputContext.Provider, {
 			value: inputContext,
-			children: children ?? /* @__PURE__ */ jsxs(Fragment, { children: [
+			children: children ?? /* @__PURE__ */ jsxs(Fragment$1, { children: [
 				label ? /* @__PURE__ */ jsx(Field.Label, {
 					"data-fs-field-label": "",
 					children: label
@@ -231,6 +325,7 @@ function UnboundDocumentField({ value, defaultValue = "", onValueChange, onBlur,
 		disabled,
 		required: requirement === "mandatory",
 		numericOnly,
+		autoComplete: DOCUMENTS[documentType].autoComplete,
 		displayValue,
 		showInvalid,
 		errorMessage,
@@ -288,6 +383,7 @@ function BoundDocumentField({ value: _value, defaultValue: _defaultValue, onValu
 			disabled: resolvedDisabled,
 			required: field.required,
 			numericOnly,
+			autoComplete: DOCUMENTS[documentType].autoComplete,
 			displayValue,
 			showInvalid,
 			errorMessage,
@@ -298,6 +394,6 @@ function BoundDocumentField({ value: _value, defaultValue: _defaultValue, onValu
 	});
 }
 //#endregion
-export { DOCUMENTS, DocumentField, DocumentFieldDefinition, DocumentFieldInput, DocumentFieldInputDefinition, applyMask, isSupportedDocumentType, isValidDocument, maskDocumentValue, validateCPF };
+export { DOCUMENTS, DocumentField, DocumentFieldDefinition, DocumentFieldInput, DocumentFieldInputDefinition, applyMask, documentTypeFromId, isSupportedDocumentType, isValidDocument, maskDocumentValue, validateCPF, validateRFC, validateSIN, validateSSN };
 
 //# sourceMappingURL=document-field.js.map

package/dist/particles/document-field/document-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-field.js","names":["BaseField"],"sources":["../../../src/particles/document-field/document-field.tsx"],"sourcesContent":["'use client';\nimport { Field as BaseField } from '@base-ui/react/field';\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ChangeEvent, ComponentPropsWithRef, FocusEvent, ReactNode, Ref } from 'react';\nimport { createContext, useContext, useMemo, useState } from 'react';\nimport { useFormContext, useFormState } from 'react-hook-form';\nimport {\n  FieldBinding,\n  type FieldContract,\n  type FieldRule,\n  mergeFieldValidator,\n  TEXT_FIELD_VALUE,\n  useBoundField,\n  useField,\n} from '../field/field.js';\nimport { useComposedRef } from '../shared/compose-refs.js';\nimport { applyMask, countSlots, isDigitOnly } from '../shared/input-mask.js';\n\n// `applyMask` was public from this module before the engine moved out; keep the export path stable.\nexport { applyMask } from '../shared/input-mask.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type DocumentType = 'CPF';\n\ntype DocumentFieldRequirement = 'mandatory' | 'optional';\n\nexport type DocumentSpec = {\n  id: DocumentType;\n  name: string;\n  mask: string;\n  validate: (value: string) => boolean;\n};\n\n// `dangerouslySetInnerHTML` is excluded — the rest spread this props type feeds forwards straight to\n// `Field.Root`, and a schema-authored `page.json` can supply it with no allowlist in between.\nexport type DocumentFieldProps = Omit<\n  ComponentPropsWithRef<'div'>,\n  'defaultValue' | 'value' | 'onChange' | 'onBlur' | 'ref' | 'dangerouslySetInnerHTML'\n> & {\n  /** Unused on the bound path — react-hook-form owns the value. */\n  value?: string;\n  /** Unused on the bound path — the field contract's `defaultValue` seeds it instead. */\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n  onBlur?: (event: FocusEvent<HTMLInputElement>) => void;\n  invalid?: boolean;\n  errorMessage?: string;\n  /** Falls back to the field contract's `label` when bound. */\n  label?: string;\n  /** Falls back to the field contract's `placeholder` when bound. */\n  placeholder?: string;\n  /** Falls back to the field contract's `disabled` when bound. */\n  disabled?: boolean;\n  /**\n   * Raises the field to required, the same word `PhoneField` uses. It only ever raises: bound to a\n   * fieldset whose rule already says required, `'optional'` does not lower it. Left unset it is no\n   * opinion, which keeps CPF optional by recommendation.\n   */\n  requirement?: DocumentFieldRequirement;\n  name?: string;\n  documentType?: DocumentType;\n  /**\n   * Lands on the `<input>` `Field.Control` renders — not on the wrapper `<div>`, as it did before\n   * (a deliberate, source-breaking re-route: the previous ref pointed at an untabbable div). Composed\n   * with react-hook-form's own ref on the bound path.\n   */\n  ref?: Ref<HTMLInputElement>;\n  /**\n   * Given, replaces the default `Field.Label` + `DocumentFieldInput` + `Field.Error` anatomy — any\n   * order, any subset. `DocumentFieldInput` is the one part that carries the mask, the composed ref\n   * and the particle's own value/handlers; a composed generic `Field.Control` would call\n   * `useController` a second time for the same name (RFC's named, accepted double-binder hole).\n   */\n  children?: ReactNode;\n};\n\n// ---------------------------------------------------------------------------\n// Ported check-digit validation (fastcheckout `packages/libs/validators/src/document`).\n// ---------------------------------------------------------------------------\n\n/**\n * CPF check-digit validation, ported from the legacy `validateCPF`. Strips non-digits, requires\n * exactly 11 digits, rejects all-equal sequences (e.g. `111.111.111-11`), and verifies both check\n * digits. Runs on blur/submit only, never per keystroke.\n */\nexport function validateCPF(value: string): boolean {\n  const digits = value.replace(/[^\\d]+/g, '');\n\n  if (digits.length !== 11 || /(\\d)\\1{10}/.test(digits)) {\n    return false;\n  }\n\n  const values = digits.split('').map((el) => +el);\n  const rest = (count: number) =>\n    ((values.slice(0, count - 12).reduce((sum, el, index) => sum + el * (count - index), 0) * 10) % 11) % 10;\n\n  return rest(10) === values[9] && rest(11) === values[10];\n}\n\n// ---------------------------------------------------------------------------\n// Document table (subset needed for the CPF launch). `documentType` selects the mask +\n// validator + digit-only input mode. Extendable later (SSN | SIN | CURP) without touching callers.\n// ---------------------------------------------------------------------------\n\nexport const DOCUMENTS: Record<DocumentType, DocumentSpec> = {\n  CPF: {\n    id: 'CPF',\n    name: 'CPF',\n    mask: '999.999.999-99',\n    validate: validateCPF,\n  },\n};\n\n/**\n * True when `type` is a document type this build supports (lets a host gate the field by locale).\n *\n * `Object.hasOwn`, not the `in` operator: `in` walks the prototype chain, so `constructor`,\n * `__proto__` and `toString` all satisfied it and were then trusted as a `DocumentType` by callers\n * (`client-profile-fieldset.tsx` renders the field on the strength of this narrowing). The value is\n * author-only — a literal written into `page.json`, never a runtime expression — so this is\n * robustness rather than a reachable defect, but the narrowing should not be able to lie.\n */\nexport function isSupportedDocumentType(type: unknown): type is DocumentType {\n  return typeof type === 'string' && Object.hasOwn(DOCUMENTS, type);\n}\n\n/**\n * Apply a document type's mask to raw input: strip non-digits for digit-only masks, then truncate to\n * the mask's slot count so excess characters never trail past the mask (e.g. a 15-digit paste into\n * the 11-slot CPF mask yields `111.444.777-35`, not `111.444.777-358888`).\n */\nexport function maskDocumentValue(rawValue: string, documentType: DocumentType): string {\n  const spec = DOCUMENTS[documentType];\n  const sanitized = isDigitOnly(spec.mask) ? rawValue.replace(/\\D/g, '') : rawValue;\n  const maxSlots = Math.max(...spec.mask.split('|').map(countSlots));\n  return applyMask(sanitized.slice(0, maxSlots), spec.mask);\n}\n\n/**\n * Check-digit validity for a document value. An **empty** value is valid (the field is optional),\n * mirroring the legacy `validateCardholderDocument`; a non-empty value must pass the document\n * type's check-digit validation.\n */\nexport function isValidDocument(value: string, documentType: DocumentType): boolean {\n  if (!value.trim()) return true;\n  return DOCUMENTS[documentType].validate(value);\n}\n\n// ---------------------------------------------------------------------------\n// Component\n// ---------------------------------------------------------------------------\n\nexport const DocumentFieldDefinition = defineComponent<DocumentFieldProps>({\n  name: 'DocumentField',\n  importPath: '@vtex/faststore/components',\n  component: DocumentField,\n  providesContext: 'document-field',\n  editor: { label: 'Document Field', category: 'content' },\n  schema: {\n    label: { type: 'string', label: 'Label' },\n    placeholder: { type: 'string', label: 'Placeholder' },\n    errorMessage: { type: 'string', label: 'Error message' },\n    documentType: { type: 'string', default: 'CPF', label: 'Document type' },\n    requirement: { type: ['mandatory', 'optional'] as const, label: 'Requirement' },\n    disabled: { type: 'boolean', default: false, label: 'Disabled' },\n  },\n  guideline:\n    'Presentational tax-document input composing the Field particle; applies the locale mask on change and runs check-digit validation on blur/submit. Data-agnostic (value/defaultValue/onValueChange); a host wires it to the shopper profile. CPF is optional by default: requirement only ever raises the field to required, announced as aria-required, and bound to a fieldset whose rule already says required it cannot lower it back. Recomposable (RFC:503): given children, they replace the default Field.Label + DocumentFieldInput + Field.Error anatomy, in any order.',\n});\n\n/**\n * Presentational tax-document input (particle). Composes the `Field` particle (`Field.Root` +\n * `Field.Label` + `Field.Control` + `Field.Error`) and owns the locale mask (applied progressively on\n * every change, never blocking typing) plus check-digit validation (run on blur/submit only — never\n * per keystroke). An empty value is valid (the field is optional). It surfaces `errorMessage` inline\n * when the check digit fails or when the host forces `invalid` (e.g. a server error surfaced by the\n * form that owns the write). It consumes no GraphQL and no domain context — value flows through\n * `value`/`defaultValue`/`onValueChange`, and `documentType` selects the mask + validator.\n *\n * Reads the field contract through `useField()` and `useFormContext()` and dispatches to a bound or an\n * unbound sub-component — \"bound\" means both are present. Every react-hook-form hook lives in\n * `BoundDocumentField`, so hook order never changes under a mounted component. Both sub-components\n * render the same `DocumentFieldView`, so the two paths cannot drift into different DOM.\n */\nexport function DocumentField(props: DocumentFieldProps): ReactNode {\n  const contract = useField();\n  const formContext = useFormContext();\n\n  if (contract && formContext) {\n    return <BoundDocumentField {...props} contract={contract} />;\n  }\n\n  return <UnboundDocumentField {...props} />;\n}\n\n// ---------------------------------------------------------------------------\n// Input part — catalogued, placeable (Decision 4). Carries the mask, the composed ref, and the\n// particle's own onChange/onBlur. Renders the RAW Base UI Field.Control, not this package's own\n// Field.Control wrapper — the latter would see the real ambient contract Decision 3 now provides\n// and call useController a second time for the same name, overwriting the composite's masked value\n// (the exact double-registration bug the removed FieldContractBoundary used to prevent globally).\n// ---------------------------------------------------------------------------\n\ntype DocumentFieldInputContextValue = {\n  ref?: Ref<HTMLInputElement>;\n  name?: string;\n  value: string;\n  placeholder?: string;\n  disabled: boolean;\n  /** Resolved by the binder, threaded here because this part is not the one that binds. */\n  required: boolean;\n  numericOnly: boolean;\n  onChange: (event: ChangeEvent<HTMLInputElement>) => void;\n  onBlur: (event: FocusEvent<HTMLInputElement>) => void;\n};\n\nconst DocumentFieldInputContext = createContext<DocumentFieldInputContextValue | null>(null);\n\nfunction useDocumentFieldInputContext(): DocumentFieldInputContextValue {\n  const context = useContext(DocumentFieldInputContext);\n  if (!context) {\n    throw new Error('DocumentFieldInput must be a descendant of DocumentField.');\n  }\n  return context;\n}\n\nexport type DocumentFieldInputProps = { className?: string };\n\nexport const DocumentFieldInputDefinition = defineComponent<DocumentFieldInputProps>({\n  name: 'DocumentFieldInput',\n  importPath: '@vtex/faststore/components',\n  component: DocumentFieldInput,\n  requiresContext: 'document-field',\n  editor: { label: 'Document Field Input', category: 'action' },\n  schema: {},\n  guideline:\n    \"The masked document <input> DocumentField owns. Must sit inside DocumentField, in either the default anatomy or an author's composed children. Carries the locale mask, the composed ref, and DocumentField's own onChange/onBlur — a composed Field.Control here instead re-registers the field with react-hook-form and loses the mask (unsupported, RFC's named double-binder hole).\",\n});\n\n/** Renders the masked document `<input>`, reading its value/handlers/ref from the enclosing `DocumentField`. */\nexport function DocumentFieldInput({ className }: DocumentFieldInputProps): ReactNode {\n  const { ref, name, value, placeholder, disabled, required, numericOnly, onChange, onBlur } =\n    useDocumentFieldInputContext();\n\n  return (\n    <BaseField.Control\n      ref={ref}\n      name={name}\n      // `aria-required`, not native `required`, for the reason password-field.tsx:89-91 records:\n      // this is a Base UI `Field.Control`, and native constraint tracking would flip `aria-invalid`\n      // on its own, ahead of react-hook-form's own validation.\n      aria-required={required || undefined}\n      placeholder={placeholder}\n      disabled={disabled}\n      value={value}\n      {...(numericOnly ? { inputMode: 'numeric' as const } : {})}\n      onChange={onChange}\n      onBlur={onBlur}\n      className={className}\n      data-fs-field-control=\"\"\n    />\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Shared view — identical DOM whether bound or unbound\n// ---------------------------------------------------------------------------\n\ntype DocumentFieldViewProps = Omit<\n  ComponentPropsWithRef<'div'>,\n  'defaultValue' | 'value' | 'onChange' | 'onBlur' | 'ref'\n> & {\n  ref?: Ref<HTMLInputElement>;\n  name?: string;\n  label?: string;\n  placeholder?: string;\n  disabled: boolean;\n  required: boolean;\n  numericOnly: boolean;\n  displayValue: string;\n  showInvalid: boolean;\n  errorMessage?: string;\n  onChange: (event: ChangeEvent<HTMLInputElement>) => void;\n  onBlur: (event: FocusEvent<HTMLInputElement>) => void;\n  children?: ReactNode;\n};\n\nfunction DocumentFieldView({\n  className,\n  name,\n  label,\n  placeholder,\n  disabled,\n  required,\n  numericOnly,\n  displayValue,\n  showInvalid,\n  errorMessage,\n  onChange,\n  onBlur,\n  ref,\n  children,\n  ...props\n}: DocumentFieldViewProps) {\n  const inputContext = useMemo<DocumentFieldInputContextValue>(\n    () => ({ ref, name, value: displayValue, placeholder, disabled, required, numericOnly, onChange, onBlur }),\n    [ref, name, displayValue, placeholder, disabled, required, numericOnly, onChange, onBlur],\n  );\n\n  return (\n    // Deliberately the RAW Base UI Field.Root/Label/Error, not this package's own Field.* wrapper,\n    // for the default anatomy — reproduces exactly what rendered before FieldContractBoundary was\n    // removed (Decision 3), including the host `invalid`/`errorMessage` override working\n    // unconditionally. Composed children, below, use the package's own Field.* parts on purpose —\n    // that is what makes a childless Field.Label / Field.Error resolve real text (FR-5).\n    <BaseField.Root\n      {...props}\n      className={className}\n      name={name}\n      invalid={showInvalid}\n      disabled={disabled}\n      data-fs-document-field=\"\"\n      data-fs-field-root=\"\"\n    >\n      <DocumentFieldInputContext.Provider value={inputContext}>\n        {children ?? (\n          <>\n            {label ? <BaseField.Label data-fs-field-label=\"\">{label}</BaseField.Label> : null}\n            <DocumentFieldInput />\n            {showInvalid && errorMessage ? (\n              <BaseField.Error match data-fs-field-error=\"\">\n                {errorMessage}\n              </BaseField.Error>\n            ) : null}\n          </>\n        )}\n      </DocumentFieldInputContext.Provider>\n    </BaseField.Root>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Unbound — today's body, moved verbatim\n// ---------------------------------------------------------------------------\n\nfunction UnboundDocumentField({\n  value,\n  defaultValue = '',\n  onValueChange,\n  onBlur,\n  invalid = false,\n  errorMessage,\n  label,\n  placeholder,\n  disabled = false,\n  requirement,\n  name = 'document',\n  documentType = 'CPF',\n  className,\n  ref,\n  children,\n  ...props\n}: DocumentFieldProps) {\n  const isControlled = value !== undefined;\n  const [internalValue, setInternalValue] = useState(() => maskDocumentValue(defaultValue, documentType));\n  const [checkInvalid, setCheckInvalid] = useState(false);\n\n  const currentValue = isControlled ? value : internalValue;\n  // Masking is idempotent, so masking here formats both a raw pre-fill (a controlled `value` seeded\n  // from the saved profile) and an already-masked typed value identically.\n  const displayValue = maskDocumentValue(currentValue, documentType);\n  const showInvalid = invalid || checkInvalid;\n  const numericOnly = isDigitOnly(DOCUMENTS[documentType].mask);\n\n  function handleChange(event: ChangeEvent<HTMLInputElement>) {\n    const masked = maskDocumentValue(event.target.value, documentType);\n    if (!isControlled) setInternalValue(masked);\n    // Clear a prior check-digit error while typing; it is re-evaluated on the next blur.\n    if (checkInvalid) setCheckInvalid(false);\n    onValueChange?.(masked);\n  }\n\n  function handleBlur(event: FocusEvent<HTMLInputElement>) {\n    // Validation runs only after the complete number is entered; empty is valid (optional field).\n    setCheckInvalid(!isValidDocument(currentValue, documentType));\n    onBlur?.(event);\n  }\n\n  return (\n    <DocumentFieldView\n      {...props}\n      ref={ref}\n      className={className}\n      name={name}\n      label={label}\n      placeholder={placeholder}\n      disabled={disabled}\n      required={requirement === 'mandatory'}\n      numericOnly={numericOnly}\n      displayValue={displayValue}\n      showInvalid={showInvalid}\n      errorMessage={errorMessage}\n      onChange={handleChange}\n      onBlur={handleBlur}\n    >\n      {children}\n    </DocumentFieldView>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Bound — reads the field contract, binds through useController\n// ---------------------------------------------------------------------------\n\ntype BoundDocumentFieldProps = DocumentFieldProps & { contract: FieldContract };\n\nfunction BoundDocumentField({\n  value: _value,\n  defaultValue: _defaultValue,\n  onValueChange,\n  onBlur,\n  invalid = false,\n  errorMessage,\n  label,\n  placeholder,\n  disabled,\n  requirement,\n  name,\n  documentType = 'CPF',\n  className,\n  ref: callerRef,\n  contract,\n  children,\n  ...props\n}: BoundDocumentFieldProps) {\n  // Check digit only. Requiredness is not decided here: `useBoundField` resolves it from the\n  // fieldset's baseline and the raise below. Returning the `errorMessage` prop (or a bare `false`\n  // when it is unset) keeps today's behaviour: the field goes invalid, and — since the composite's\n  // own inline text is driven by the `errorMessage` prop, not by react-hook-form's error message —\n  // text renders only when supplied. The check composes alongside whatever the fieldset validates;\n  // before this merge, any contract validator discarded the particle's own validation whole.\n  const rule = useMemo<FieldRule>(\n    () =>\n      mergeFieldValidator(contract.rule, 'checkDigit', (rawValue) => {\n        const raw = typeof rawValue === 'string' ? rawValue : String(rawValue ?? '');\n        return isValidDocument(raw, documentType) || (errorMessage ?? false);\n      }),\n    [contract.rule, documentType, errorMessage],\n  );\n\n  const field = useBoundField(contract, TEXT_FIELD_VALUE, rule, { required: requirement === 'mandatory' });\n  const { getFieldState } = useFormContext();\n  const { invalid: rhfInvalid } = getFieldState(contract.name, useFormState({ name: contract.name }));\n\n  const composedRef = useComposedRef<HTMLInputElement>(callerRef, field.ref);\n\n  const currentValue = typeof field.value === 'string' ? field.value : String(field.value ?? '');\n  const displayValue = maskDocumentValue(currentValue, documentType);\n  const showInvalid = invalid || rhfInvalid;\n  const numericOnly = isDigitOnly(DOCUMENTS[documentType].mask);\n  const resolvedLabel = label ?? contract.label;\n  const resolvedPlaceholder = placeholder ?? contract.placeholder;\n  const resolvedDisabled = disabled ?? contract.disabled ?? false;\n  // Unlike `UnboundDocumentField`, `name` carries no signature default here — a signature default\n  // would always win over the contract's name (Decision 5), colliding two bound fieldsets (e.g.\n  // `profile.document` and `billing.document`) on the same rendered `name=\"document\"`.\n  const resolvedName = name ?? contract.name;\n\n  function handleChange(event: ChangeEvent<HTMLInputElement>) {\n    const masked = maskDocumentValue(event.target.value, documentType);\n    field.onChange(masked);\n    onValueChange?.(masked);\n  }\n\n  function handleBlur(event: FocusEvent<HTMLInputElement>) {\n    field.onBlur();\n    onBlur?.(event);\n  }\n\n  return (\n    // Decision 3: replaces the empty-contract FieldContractBoundary with a re-provided contract\n    // carrying the RESOLVED name/label/placeholder — the values a composed childless Field.Label /\n    // Field.Error actually need, as opposed to the raw (possibly-undefined) ones the ambient\n    // contract from the enclosing FieldBinding carries. useBoundField above remains the sole binder\n    // for contract.name; this FieldBinding never registers anything itself.\n    <FieldBinding\n      name={contract.name}\n      label={resolvedLabel}\n      placeholder={resolvedPlaceholder}\n      defaultValue={contract.defaultValue}\n      rule={contract.rule}\n      options={contract.options}\n      disabled={resolvedDisabled}\n      readOnly={contract.readOnly}\n      autoComplete={contract.autoComplete}\n      inputMode={contract.inputMode}\n    >\n      <DocumentFieldView\n        {...props}\n        ref={composedRef}\n        className={className}\n        name={resolvedName}\n        label={resolvedLabel}\n        placeholder={resolvedPlaceholder}\n        disabled={resolvedDisabled}\n        required={field.required}\n        numericOnly={numericOnly}\n        displayValue={displayValue}\n        showInvalid={showInvalid}\n        errorMessage={errorMessage}\n        onChange={handleChange}\n        onBlur={handleBlur}\n      >\n        {children}\n      </DocumentFieldView>\n    </FieldBinding>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"document-field.js","names":["BaseField"],"sources":["../../../src/particles/document-field/document-field.tsx"],"sourcesContent":["'use client';\nimport { Field as BaseField } from '@base-ui/react/field';\nimport { defineComponent } from '@vtex/fs-core';\nimport type { ChangeEvent, ComponentPropsWithRef, FocusEvent, ReactNode, Ref } from 'react';\nimport { createContext, useContext, useMemo, useState } from 'react';\nimport { useFormContext, useFormState } from 'react-hook-form';\nimport {\n  FieldBinding,\n  type FieldContract,\n  type FieldRule,\n  mergeFieldValidator,\n  TEXT_FIELD_VALUE,\n  useBoundField,\n  useField,\n} from '../field/field.js';\nimport { useComposedRef } from '../shared/compose-refs.js';\nimport { applyMask, countSlots, isDigitOnly } from '../shared/input-mask.js';\n\n// `applyMask` was public from this module before the engine moved out; keep the export path stable.\nexport { applyMask } from '../shared/input-mask.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type DocumentType = 'CPF' | 'SSN' | 'SIN' | 'RFC';\n\ntype DocumentFieldRequirement = 'mandatory' | 'optional';\n\nexport type DocumentSpec = {\n  id: DocumentType;\n  name: string;\n  mask: string;\n  placeholder: string;\n  /** Strips what the type never holds, before the mask runs. */\n  sanitize: (raw: string) => string;\n  validate: (value: string) => boolean;\n  /** `'off'` for SSN and SIN, absent for CPF and RFC (Decision 9). */\n  autoComplete?: 'off';\n};\n\n// `dangerouslySetInnerHTML` is excluded — the rest spread this props type feeds forwards straight to\n// `Field.Root`, and a schema-authored `page.json` can supply it with no allowlist in between.\nexport type DocumentFieldProps = Omit<\n  ComponentPropsWithRef<'div'>,\n  'defaultValue' | 'value' | 'onChange' | 'onBlur' | 'ref' | 'dangerouslySetInnerHTML'\n> & {\n  /** Unused on the bound path — react-hook-form owns the value. */\n  value?: string;\n  /** Unused on the bound path — the field contract's `defaultValue` seeds it instead. */\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n  onBlur?: (event: FocusEvent<HTMLInputElement>) => void;\n  invalid?: boolean;\n  errorMessage?: string;\n  /** Falls back to the field contract's `label` when bound. */\n  label?: string;\n  /** Falls back to the field contract's `placeholder` when bound. */\n  placeholder?: string;\n  /** Falls back to the field contract's `disabled` when bound. */\n  disabled?: boolean;\n  /**\n   * Raises the field to required, the same word `PhoneField` uses. It only ever raises: bound to a\n   * fieldset whose rule already says required, `'optional'` does not lower it. Left unset it is no\n   * opinion, which keeps CPF optional by recommendation.\n   */\n  requirement?: DocumentFieldRequirement;\n  name?: string;\n  documentType?: DocumentType;\n  /**\n   * Lands on the `<input>` `Field.Control` renders — not on the wrapper `<div>`, as it did before\n   * (a deliberate, source-breaking re-route: the previous ref pointed at an untabbable div). Composed\n   * with react-hook-form's own ref on the bound path.\n   */\n  ref?: Ref<HTMLInputElement>;\n  /**\n   * Given, replaces the default `Field.Label` + `DocumentFieldInput` + `Field.Error` anatomy — any\n   * order, any subset. `DocumentFieldInput` is the one part that carries the mask, the composed ref\n   * and the particle's own value/handlers; a composed generic `Field.Control` would call\n   * `useController` a second time for the same name (RFC's named, accepted double-binder hole).\n   */\n  children?: ReactNode;\n};\n\n// ---------------------------------------------------------------------------\n// Ported check-digit validation (fastcheckout `packages/libs/validators/src/document`).\n// ---------------------------------------------------------------------------\n\n/**\n * CPF check-digit validation, ported from the legacy `validateCPF`. Strips non-digits, requires\n * exactly 11 digits, rejects all-equal sequences (e.g. `111.111.111-11`), and verifies both check\n * digits. Runs on blur/submit only, never per keystroke.\n */\nexport function validateCPF(value: string): boolean {\n  const digits = value.replaceAll(/[^\\d]+/g, '');\n\n  if (digits.length !== 11 || /(\\d)\\1{10}/.test(digits)) {\n    return false;\n  }\n\n  const values = digits.split('').map((el) => +el);\n  const rest = (count: number) =>\n    ((values.slice(0, count - 12).reduce((sum, el, index) => sum + el * (count - index), 0) * 10) % 11) % 10;\n\n  return rest(10) === values[9] && rest(11) === values[10];\n}\n\n/**\n * SSN validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16). Strips non-digits,\n * requires exactly 9 digits, refuses area `000`, `666` and `>= 900`, group `00` and serial `0000`.\n */\nexport function validateSSN(value: string): boolean {\n  const digits = value.replaceAll(/\\D/g, '');\n  if (digits.length !== 9) return false;\n  const area = digits.slice(0, 3);\n  if (area === '000' || area === '666' || Number(area) >= 900) return false;\n  if (digits.slice(3, 5) === '00') return false;\n  return digits.slice(5) !== '0000';\n}\n\n/**\n * SIN validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16). Strips non-digits,\n * requires exactly 9 digits, refuses all zeros, and verifies the Luhn check.\n */\nexport function validateSIN(value: string): boolean {\n  const digits = value.replaceAll(/\\D/g, '');\n  if (digits.length !== 9 || /^0+$/.test(digits)) return false;\n  let sum = 0;\n  for (let index = 0; index < 9; index += 1) {\n    let digit = Number(digits[index]);\n    if (index % 2 === 1) {\n      digit *= 2;\n      if (digit > 9) digit -= 9;\n    }\n    sum += digit;\n  }\n  return sum % 10 === 0;\n}\n\n/**\n * RFC (individual) validation, ported from `@vtex/country-forms` 1.2.0 (measured 2026-10-16): after\n * uppercasing and stripping every non A-Z0-9 character it is four letters, six digits and three\n * letters or digits, and characters 5-10 read as a plausible month (1-12) and day (1-31). The day check\n * is not calendar-aware, as in the library. The library's set of refused four-letter prefixes is not\n * carried (the structure and the date are what a typo breaks).\n */\nexport function validateRFC(value: string): boolean {\n  const rfc = value.toUpperCase().replaceAll(/[^A-Z0-9]/g, '');\n  if (!/^[A-Z]{4}\\d{6}[A-Z0-9]{3}$/.test(rfc)) return false;\n  const month = Number(rfc.slice(6, 8));\n  const day = Number(rfc.slice(8, 10));\n  return month >= 1 && month <= 12 && day >= 1 && day <= 31;\n}\n\nfunction stripNonDigits(raw: string): string {\n  return raw.replaceAll(/\\D/g, '');\n}\n\n// ---------------------------------------------------------------------------\n// Document table: the person documents of the four countries `Payment.countries` lists (CPF for BRA, SSN\n// for USA, SIN for CAN, RFC for MEX). Masks, rules and sanitisers follow `@vtex/country-forms` 1.2.0,\n// measured 2026-10-16; a later library release can drift from this hand port. `documentType` selects the\n// mask, the sanitiser, the validator and the digit-only input mode.\n// ---------------------------------------------------------------------------\n\nexport const DOCUMENTS: Record<DocumentType, DocumentSpec> = {\n  CPF: {\n    id: 'CPF',\n    name: 'CPF',\n    mask: '999.999.999-99',\n    placeholder: '000.000.000-00',\n    sanitize: stripNonDigits,\n    validate: validateCPF,\n  },\n  SSN: {\n    id: 'SSN',\n    name: 'SSN',\n    mask: '999-99-9999',\n    placeholder: '000-00-0000',\n    sanitize: stripNonDigits,\n    validate: validateSSN,\n    autoComplete: 'off',\n  },\n  SIN: {\n    id: 'SIN',\n    name: 'SIN',\n    mask: '999-999-999',\n    placeholder: '000-000-000',\n    sanitize: stripNonDigits,\n    validate: validateSIN,\n    autoComplete: 'off',\n  },\n  RFC: {\n    id: 'RFC',\n    name: 'RFC',\n    mask: 'SSSSSSSSSSSSS',\n    placeholder: 'AAAA000000AAA',\n    // Before `applyMask`, never after: its `S` slot spans `[A-ú]`, which accepts `é`, `_` and `~`.\n    sanitize: (raw) => raw.toUpperCase().replaceAll(/[^A-Z0-9]/g, ''),\n    validate: validateRFC,\n  },\n};\n\nconst DOCUMENT_TYPE_BY_API_ID: Readonly<Record<string, DocumentType>> = {\n  cpf: 'CPF',\n  ssn: 'SSN',\n  sin: 'SIN',\n  rfc: 'RFC',\n};\n\n/**\n * Turns the API's lower-case document id (`Payment.countries[].documents[].type`) into this table's key,\n * or `null` for anything else, including a business document, a prototype key and a non-string.\n */\nexport function documentTypeFromId(id: unknown): DocumentType | null {\n  if (typeof id !== 'string' || !Object.hasOwn(DOCUMENT_TYPE_BY_API_ID, id)) return null;\n  return DOCUMENT_TYPE_BY_API_ID[id] ?? null;\n}\n\n/**\n * True when `type` is one of the table's upper-case keys (`CPF`, `SSN`, `SIN`, `RFC`); the API's lower-case\n * ids go through `documentTypeFromId`. Lets a host gate the field by locale.\n *\n * `Object.hasOwn`, not the `in` operator: `in` walks the prototype chain, so `constructor`,\n * `__proto__` and `toString` all satisfied it and were then trusted as a `DocumentType` by callers\n * (`client-profile-fieldset.tsx` renders the field on the strength of this narrowing). The value is\n * author-only — a literal written into `page.json`, never a runtime expression — so this is\n * robustness rather than a reachable defect, but the narrowing should not be able to lie.\n */\nexport function isSupportedDocumentType(type: unknown): type is DocumentType {\n  return typeof type === 'string' && Object.hasOwn(DOCUMENTS, type);\n}\n\n/**\n * Apply a document type's mask to raw input: run the type's sanitiser, then truncate to the mask's slot\n * count so excess characters never trail past the mask (e.g. a 15-digit paste into the 11-slot CPF mask\n * yields `111.444.777-35`, not `111.444.777-358888`).\n */\nexport function maskDocumentValue(rawValue: string, documentType: DocumentType): string {\n  const spec = DOCUMENTS[documentType];\n  const maxSlots = Math.max(...spec.mask.split('|').map(countSlots));\n  return applyMask(spec.sanitize(rawValue).slice(0, maxSlots), spec.mask);\n}\n\n/**\n * Check-digit validity for a document value. An **empty** value is valid (the field is optional),\n * mirroring the legacy `validateCardholderDocument`; a non-empty value must pass the document\n * type's check-digit validation.\n */\nexport function isValidDocument(value: string, documentType: DocumentType): boolean {\n  if (!value.trim()) return true;\n  return DOCUMENTS[documentType].validate(value);\n}\n\n// ---------------------------------------------------------------------------\n// Component\n// ---------------------------------------------------------------------------\n\nexport const DocumentFieldDefinition = defineComponent<DocumentFieldProps>({\n  name: 'DocumentField',\n  importPath: '@vtex/faststore/components',\n  component: DocumentField,\n  providesContext: 'document-field',\n  editor: { label: 'Document Field', category: 'content' },\n  schema: {\n    label: { type: 'string', label: 'Label' },\n    placeholder: { type: 'string', label: 'Placeholder' },\n    errorMessage: { type: 'string', label: 'Error message' },\n    documentType: { type: 'string', default: 'CPF', label: 'Document type' },\n    requirement: { type: ['mandatory', 'optional'] as const, label: 'Requirement' },\n    disabled: { type: 'boolean', default: false, label: 'Disabled' },\n  },\n  guideline:\n    'Presentational tax-document input composing the Field particle; applies the mask of its document type on change and runs the matching validation on blur/submit; documentType is one of CPF, SSN, SIN or RFC. Data-agnostic (value/defaultValue/onValueChange); a host wires it to the shopper profile. The document is optional by default: requirement only ever raises the field to required, announced as aria-required, and bound to a fieldset whose rule already says required it cannot lower it back. Recomposable (RFC:503): given children, they replace the default Field.Label + DocumentFieldInput + Field.Error anatomy, in any order.',\n});\n\n/**\n * Presentational tax-document input (particle). Composes the `Field` particle (`Field.Root` +\n * `Field.Label` + `Field.Control` + `Field.Error`) and owns the locale mask (applied progressively on\n * every change, never blocking typing) plus check-digit validation (run on blur/submit only — never\n * per keystroke). An empty value is valid (the field is optional). It surfaces `errorMessage` inline\n * when the check digit fails or when the host forces `invalid` (e.g. a server error surfaced by the\n * form that owns the write). It consumes no GraphQL and no domain context — value flows through\n * `value`/`defaultValue`/`onValueChange`, and `documentType` selects the mask + validator.\n *\n * Reads the field contract through `useField()` and `useFormContext()` and dispatches to a bound or an\n * unbound sub-component — \"bound\" means both are present. Every react-hook-form hook lives in\n * `BoundDocumentField`, so hook order never changes under a mounted component. Both sub-components\n * render the same `DocumentFieldView`, so the two paths cannot drift into different DOM.\n */\nexport function DocumentField(props: DocumentFieldProps): ReactNode {\n  const contract = useField();\n  const formContext = useFormContext();\n\n  if (contract && formContext) {\n    return <BoundDocumentField {...props} contract={contract} />;\n  }\n\n  return <UnboundDocumentField {...props} />;\n}\n\n// ---------------------------------------------------------------------------\n// Input part — catalogued, placeable (Decision 4). Carries the mask, the composed ref, and the\n// particle's own onChange/onBlur. Renders the RAW Base UI Field.Control, not this package's own\n// Field.Control wrapper — the latter would see the real ambient contract Decision 3 now provides\n// and call useController a second time for the same name, overwriting the composite's masked value\n// (the exact double-registration bug the removed FieldContractBoundary used to prevent globally).\n// ---------------------------------------------------------------------------\n\ntype DocumentFieldInputContextValue = {\n  ref?: Ref<HTMLInputElement>;\n  name?: string;\n  value: string;\n  placeholder?: string;\n  disabled: boolean;\n  /** Resolved by the binder, threaded here because this part is not the one that binds. */\n  required: boolean;\n  numericOnly: boolean;\n  autoComplete?: 'off';\n  onChange: (event: ChangeEvent<HTMLInputElement>) => void;\n  onBlur: (event: FocusEvent<HTMLInputElement>) => void;\n};\n\nconst DocumentFieldInputContext = createContext<DocumentFieldInputContextValue | null>(null);\n\nfunction useDocumentFieldInputContext(): DocumentFieldInputContextValue {\n  const context = useContext(DocumentFieldInputContext);\n  if (!context) {\n    throw new Error('DocumentFieldInput must be a descendant of DocumentField.');\n  }\n  return context;\n}\n\nexport type DocumentFieldInputProps = { className?: string };\n\nexport const DocumentFieldInputDefinition = defineComponent<DocumentFieldInputProps>({\n  name: 'DocumentFieldInput',\n  importPath: '@vtex/faststore/components',\n  component: DocumentFieldInput,\n  requiresContext: 'document-field',\n  editor: { label: 'Document Field Input', category: 'action' },\n  schema: {},\n  guideline:\n    \"The masked document <input> DocumentField owns. Must sit inside DocumentField, in either the default anatomy or an author's composed children. Carries the locale mask, the composed ref, and DocumentField's own onChange/onBlur — a composed Field.Control here instead re-registers the field with react-hook-form and loses the mask (unsupported, RFC's named double-binder hole).\",\n});\n\n/** Renders the masked document `<input>`, reading its value/handlers/ref from the enclosing `DocumentField`. */\nexport function DocumentFieldInput({ className }: DocumentFieldInputProps): ReactNode {\n  const { ref, name, value, placeholder, disabled, required, numericOnly, autoComplete, onChange, onBlur } =\n    useDocumentFieldInputContext();\n\n  return (\n    <BaseField.Control\n      ref={ref}\n      name={name}\n      // `aria-required`, not native `required`, for the reason password-field.tsx:89-91 records:\n      // this is a Base UI `Field.Control`, and native constraint tracking would flip `aria-invalid`\n      // on its own, ahead of react-hook-form's own validation.\n      aria-required={required || undefined}\n      placeholder={placeholder}\n      disabled={disabled}\n      value={value}\n      autoComplete={autoComplete}\n      {...(numericOnly ? { inputMode: 'numeric' as const } : {})}\n      onChange={onChange}\n      onBlur={onBlur}\n      className={className}\n      data-fs-field-control=\"\"\n    />\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Shared view — identical DOM whether bound or unbound\n// ---------------------------------------------------------------------------\n\ntype DocumentFieldViewProps = Omit<\n  ComponentPropsWithRef<'div'>,\n  'defaultValue' | 'value' | 'onChange' | 'onBlur' | 'ref'\n> & {\n  ref?: Ref<HTMLInputElement>;\n  name?: string;\n  label?: string;\n  placeholder?: string;\n  disabled: boolean;\n  required: boolean;\n  numericOnly: boolean;\n  autoComplete?: 'off';\n  displayValue: string;\n  showInvalid: boolean;\n  errorMessage?: string;\n  onChange: (event: ChangeEvent<HTMLInputElement>) => void;\n  onBlur: (event: FocusEvent<HTMLInputElement>) => void;\n  children?: ReactNode;\n};\n\nfunction DocumentFieldView({\n  className,\n  name,\n  label,\n  placeholder,\n  disabled,\n  required,\n  numericOnly,\n  autoComplete,\n  displayValue,\n  showInvalid,\n  errorMessage,\n  onChange,\n  onBlur,\n  ref,\n  children,\n  ...props\n}: DocumentFieldViewProps) {\n  const inputContext = useMemo<DocumentFieldInputContextValue>(\n    () => ({\n      ref,\n      name,\n      value: displayValue,\n      placeholder,\n      disabled,\n      required,\n      numericOnly,\n      autoComplete,\n      onChange,\n      onBlur,\n    }),\n    [ref, name, displayValue, placeholder, disabled, required, numericOnly, autoComplete, onChange, onBlur],\n  );\n\n  return (\n    // Deliberately the RAW Base UI Field.Root/Label/Error, not this package's own Field.* wrapper,\n    // for the default anatomy — reproduces exactly what rendered before FieldContractBoundary was\n    // removed (Decision 3), including the host `invalid`/`errorMessage` override working\n    // unconditionally. Composed children, below, use the package's own Field.* parts on purpose —\n    // that is what makes a childless Field.Label / Field.Error resolve real text (FR-5).\n    <BaseField.Root\n      {...props}\n      className={className}\n      name={name}\n      invalid={showInvalid}\n      disabled={disabled}\n      data-fs-document-field=\"\"\n      data-fs-field-root=\"\"\n    >\n      <DocumentFieldInputContext.Provider value={inputContext}>\n        {children ?? (\n          <>\n            {label ? <BaseField.Label data-fs-field-label=\"\">{label}</BaseField.Label> : null}\n            <DocumentFieldInput />\n            {showInvalid && errorMessage ? (\n              <BaseField.Error match data-fs-field-error=\"\">\n                {errorMessage}\n              </BaseField.Error>\n            ) : null}\n          </>\n        )}\n      </DocumentFieldInputContext.Provider>\n    </BaseField.Root>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Unbound — today's body, moved verbatim\n// ---------------------------------------------------------------------------\n\nfunction UnboundDocumentField({\n  value,\n  defaultValue = '',\n  onValueChange,\n  onBlur,\n  invalid = false,\n  errorMessage,\n  label,\n  placeholder,\n  disabled = false,\n  requirement,\n  name = 'document',\n  documentType = 'CPF',\n  className,\n  ref,\n  children,\n  ...props\n}: DocumentFieldProps) {\n  const isControlled = value !== undefined;\n  const [internalValue, setInternalValue] = useState(() => maskDocumentValue(defaultValue, documentType));\n  const [checkInvalid, setCheckInvalid] = useState(false);\n\n  const currentValue = isControlled ? value : internalValue;\n  // Masking is idempotent, so masking here formats both a raw pre-fill (a controlled `value` seeded\n  // from the saved profile) and an already-masked typed value identically.\n  const displayValue = maskDocumentValue(currentValue, documentType);\n  const showInvalid = invalid || checkInvalid;\n  const numericOnly = isDigitOnly(DOCUMENTS[documentType].mask);\n\n  function handleChange(event: ChangeEvent<HTMLInputElement>) {\n    const masked = maskDocumentValue(event.target.value, documentType);\n    if (!isControlled) setInternalValue(masked);\n    // Clear a prior check-digit error while typing; it is re-evaluated on the next blur.\n    if (checkInvalid) setCheckInvalid(false);\n    onValueChange?.(masked);\n  }\n\n  function handleBlur(event: FocusEvent<HTMLInputElement>) {\n    // Validation runs only after the complete number is entered; empty is valid (optional field).\n    setCheckInvalid(!isValidDocument(currentValue, documentType));\n    onBlur?.(event);\n  }\n\n  return (\n    <DocumentFieldView\n      {...props}\n      ref={ref}\n      className={className}\n      name={name}\n      label={label}\n      placeholder={placeholder}\n      disabled={disabled}\n      required={requirement === 'mandatory'}\n      numericOnly={numericOnly}\n      autoComplete={DOCUMENTS[documentType].autoComplete}\n      displayValue={displayValue}\n      showInvalid={showInvalid}\n      errorMessage={errorMessage}\n      onChange={handleChange}\n      onBlur={handleBlur}\n    >\n      {children}\n    </DocumentFieldView>\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Bound — reads the field contract, binds through useController\n// ---------------------------------------------------------------------------\n\ntype BoundDocumentFieldProps = DocumentFieldProps & { contract: FieldContract };\n\nfunction BoundDocumentField({\n  value: _value,\n  defaultValue: _defaultValue,\n  onValueChange,\n  onBlur,\n  invalid = false,\n  errorMessage,\n  label,\n  placeholder,\n  disabled,\n  requirement,\n  name,\n  documentType = 'CPF',\n  className,\n  ref: callerRef,\n  contract,\n  children,\n  ...props\n}: BoundDocumentFieldProps) {\n  // Check digit only. Requiredness is not decided here: `useBoundField` resolves it from the\n  // fieldset's baseline and the raise below. Returning the `errorMessage` prop (or a bare `false`\n  // when it is unset) keeps today's behaviour: the field goes invalid, and — since the composite's\n  // own inline text is driven by the `errorMessage` prop, not by react-hook-form's error message —\n  // text renders only when supplied. The check composes alongside whatever the fieldset validates;\n  // before this merge, any contract validator discarded the particle's own validation whole.\n  const rule = useMemo<FieldRule>(\n    () =>\n      mergeFieldValidator(contract.rule, 'checkDigit', (rawValue) => {\n        const raw = typeof rawValue === 'string' ? rawValue : String(rawValue ?? '');\n        return isValidDocument(raw, documentType) || (errorMessage ?? false);\n      }),\n    [contract.rule, documentType, errorMessage],\n  );\n\n  const field = useBoundField(contract, TEXT_FIELD_VALUE, rule, { required: requirement === 'mandatory' });\n  const { getFieldState } = useFormContext();\n  const { invalid: rhfInvalid } = getFieldState(contract.name, useFormState({ name: contract.name }));\n\n  const composedRef = useComposedRef<HTMLInputElement>(callerRef, field.ref);\n\n  const currentValue = typeof field.value === 'string' ? field.value : String(field.value ?? '');\n  const displayValue = maskDocumentValue(currentValue, documentType);\n  const showInvalid = invalid || rhfInvalid;\n  const numericOnly = isDigitOnly(DOCUMENTS[documentType].mask);\n  const resolvedLabel = label ?? contract.label;\n  const resolvedPlaceholder = placeholder ?? contract.placeholder;\n  const resolvedDisabled = disabled ?? contract.disabled ?? false;\n  // Unlike `UnboundDocumentField`, `name` carries no signature default here — a signature default\n  // would always win over the contract's name (Decision 5), colliding two bound fieldsets (e.g.\n  // `profile.document` and `billing.document`) on the same rendered `name=\"document\"`.\n  const resolvedName = name ?? contract.name;\n\n  function handleChange(event: ChangeEvent<HTMLInputElement>) {\n    const masked = maskDocumentValue(event.target.value, documentType);\n    field.onChange(masked);\n    onValueChange?.(masked);\n  }\n\n  function handleBlur(event: FocusEvent<HTMLInputElement>) {\n    field.onBlur();\n    onBlur?.(event);\n  }\n\n  return (\n    // Decision 3: replaces the empty-contract FieldContractBoundary with a re-provided contract\n    // carrying the RESOLVED name/label/placeholder — the values a composed childless Field.Label /\n    // Field.Error actually need, as opposed to the raw (possibly-undefined) ones the ambient\n    // contract from the enclosing FieldBinding carries. useBoundField above remains the sole binder\n    // for contract.name; this FieldBinding never registers anything itself.\n    <FieldBinding\n      name={contract.name}\n      label={resolvedLabel}\n      placeholder={resolvedPlaceholder}\n      defaultValue={contract.defaultValue}\n      rule={contract.rule}\n      options={contract.options}\n      disabled={resolvedDisabled}\n      readOnly={contract.readOnly}\n      autoComplete={contract.autoComplete}\n      inputMode={contract.inputMode}\n    >\n      <DocumentFieldView\n        {...props}\n        ref={composedRef}\n        className={className}\n        name={resolvedName}\n        label={resolvedLabel}\n        placeholder={resolvedPlaceholder}\n        disabled={resolvedDisabled}\n        required={field.required}\n        numericOnly={numericOnly}\n        autoComplete={DOCUMENTS[documentType].autoComplete}\n        displayValue={displayValue}\n        showInvalid={showInvalid}\n        errorMessage={errorMessage}\n        onChange={handleChange}\n        onBlur={handleBlur}\n      >\n        {children}\n      </DocumentFieldView>\n    </FieldBinding>\n  );\n}\n"],"mappings":"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"}

package/dist/particles/field/field.js

@@ -619,6 +619,6 @@ const Field$1 = {
 	Checkbox: FieldCheckbox
 };
 //#endregion
-export { BOOLEAN_FIELD_VALUE, Field$1 as Field, FieldBinding, FieldCheckbox, FieldCheckboxDefinition, FieldControl, FieldControlDefinition, FieldDescription, FieldDescriptionDefinition, FieldError, FieldErrorDefinition, FieldLabel, FieldLabelDefinition, FieldRoot, FieldRootDefinition, FieldValidity, FieldValidityDefinition, FieldsetFieldContext, TEXT_FIELD_VALUE, mergeFieldValidator, resolveRequiredness, useBoundField, useField, useFieldsetContext, useFieldsetField, useFieldsetFieldNames, useNoAncestorFieldset };
+export { BOOLEAN_FIELD_VALUE, Field$1 as Field, FieldBinding, FieldCheckbox, FieldCheckboxDefinition, FieldControl, FieldControlDefinition, FieldDescription, FieldDescriptionDefinition, FieldError, FieldErrorDefinition, FieldLabel, FieldLabelDefinition, FieldRoot, FieldRootDefinition, FieldValidity, FieldValidityDefinition, FieldsetFieldContext, TEXT_FIELD_VALUE, mergeFieldValidator, readBaseline, resolveRequiredness, useBoundField, useField, useFieldsetContext, useFieldsetField, useFieldsetFieldNames, useNoAncestorFieldset };
 
 //# sourceMappingURL=field.js.map