@wix/headless-forms 0.0.20 → 0.0.21

package/cjs/dist/react/Form.js

@@ -38,6 +38,7 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = __importStar(require("react"));
 const react_2 = require("@wix/headless-utils/react");
 const form_public_1 = require("@wix/form-public");
+const essentials_1 = require("@wix/essentials");
 const Form_js_1 = require("./core/Form.js");
 const FieldContext_js_1 = require("./context/FieldContext.js");
 const FieldLayoutContext_js_1 = require("./context/FieldLayoutContext.js");
@@ -525,13 +526,15 @@ exports.Submitted = react_1.default.forwardRef((props, ref) => {
  */
 exports.Fields = react_1.default.forwardRef((props, ref) => {
     const [formErrors, setFormErrors] = (0, react_1.useState)([]);
+    const currentLocale = essentials_1.i18n.getLocale();
+    const currentLanguage = essentials_1.i18n.getLanguage();
     const handleFormValidate = (0, react_1.useCallback)((errors) => {
         setFormErrors(errors);
     }, []);
-    return ((0, jsx_runtime_1.jsx)(Form_js_1.Fields, { children: ({ form, formValues, submitForm, handleForm }) => {
+    return ((0, jsx_runtime_1.jsx)(Form_js_1.Fields, { children: ({ form, formValues, submitForm, handleForm, addressTemplates }) => {
             if (!form)
                 return null;
-            return ((0, jsx_runtime_1.jsx)("div", { ref: ref, children: (0, jsx_runtime_1.jsx)(form_public_1.FormProvider, { currency: 'USD', locale: 'en', children: (0, jsx_runtime_1.jsx)(FieldsWithForm, { form: form, values: formValues, onChange: handleForm, errors: formErrors, onValidate: handleFormValidate, fields: props.fieldMap, submitForm: submitForm, rowGapClassname: props.rowGapClassname, columnGapClassname: props.columnGapClassname }) }) }));
+            return ((0, jsx_runtime_1.jsx)("div", { ref: ref, children: (0, jsx_runtime_1.jsx)(form_public_1.FormProvider, { currency: 'USD', locale: currentLanguage, regionalFormat: currentLocale, addressTemplates: addressTemplates, children: (0, jsx_runtime_1.jsx)(form_public_1.UniqueFieldSuffixContextProvider, { parentId: form._id ?? '', children: (0, jsx_runtime_1.jsx)(FieldsWithForm, { form: form, values: formValues, onChange: handleForm, errors: formErrors, onValidate: handleFormValidate, fields: props.fieldMap, submitForm: submitForm, rowGapClassname: props.rowGapClassname, columnGapClassname: props.columnGapClassname }) }) }) }));
         } }));
 });
 const FieldsWithForm = ({ form, submitForm, values, onChange, errors, onValidate, fields: fieldMap, rowGapClassname, columnGapClassname, }) => {

package/cjs/dist/react/core/Form.d.ts

@@ -229,6 +229,7 @@ export interface FieldsRenderProps {
     /** Function to submit the form with values */
     submitForm: () => Promise<void>;
     handleForm: (formValues: FormValues) => Promise<void>;
+    addressTemplates: any[];
 }
 /**
  * Props for Fields headless component

package/cjs/dist/react/core/Form.js

@@ -230,14 +230,16 @@ function Submitted(props) {
  * ```
  */
 function Fields(props) {
-    const { formSignal, submitForm, handleForm, formValuesSignal } = (0, services_manager_react_1.useService)(form_service_js_1.FormServiceDefinition);
+    const { formSignal, submitForm, handleForm, formValuesSignal, addressTemplatesSignal, } = (0, services_manager_react_1.useService)(form_service_js_1.FormServiceDefinition);
     const form = formSignal.get();
     const formValues = formValuesSignal.get();
+    const addressTemplates = addressTemplatesSignal.get();
     return props.children({
         form,
         formValues,
         submitForm,
         handleForm,
+        addressTemplates,
     });
 }
 /**

package/cjs/dist/react/index.d.ts

@@ -1,3 +1,3 @@
 export * as Form from './Form.js';
 export * from './types.js';
-export { PhoneField, FileUpload } from '@wix/form-public';
+export { Checkbox, CheckboxGroup, DateInput, DatePicker, DateTimeInput, Dropdown, FileUpload, MultilineAddress, NumberInput, PhoneInput, RadioGroup, RatingInput, Tags, TextArea, TextInput, TimeInput, LoginBar, SubmitButton, FormProvider, } from '@wix/form-public';

package/cjs/dist/react/index.js

@@ -36,9 +36,26 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileUpload = exports.PhoneField = exports.Form = void 0;
+exports.FormProvider = exports.SubmitButton = exports.LoginBar = exports.TimeInput = exports.TextInput = exports.TextArea = exports.Tags = exports.RatingInput = exports.RadioGroup = exports.PhoneInput = exports.NumberInput = exports.MultilineAddress = exports.FileUpload = exports.Dropdown = exports.DateTimeInput = exports.DatePicker = exports.DateInput = exports.CheckboxGroup = exports.Checkbox = exports.Form = void 0;
 exports.Form = __importStar(require("./Form.js"));
 __exportStar(require("./types.js"), exports);
 var form_public_1 = require("@wix/form-public");
-Object.defineProperty(exports, "PhoneField", { enumerable: true, get: function () { return form_public_1.PhoneField; } });
+Object.defineProperty(exports, "Checkbox", { enumerable: true, get: function () { return form_public_1.Checkbox; } });
+Object.defineProperty(exports, "CheckboxGroup", { enumerable: true, get: function () { return form_public_1.CheckboxGroup; } });
+Object.defineProperty(exports, "DateInput", { enumerable: true, get: function () { return form_public_1.DateInput; } });
+Object.defineProperty(exports, "DatePicker", { enumerable: true, get: function () { return form_public_1.DatePicker; } });
+Object.defineProperty(exports, "DateTimeInput", { enumerable: true, get: function () { return form_public_1.DateTimeInput; } });
+Object.defineProperty(exports, "Dropdown", { enumerable: true, get: function () { return form_public_1.Dropdown; } });
 Object.defineProperty(exports, "FileUpload", { enumerable: true, get: function () { return form_public_1.FileUpload; } });
+Object.defineProperty(exports, "MultilineAddress", { enumerable: true, get: function () { return form_public_1.MultilineAddress; } });
+Object.defineProperty(exports, "NumberInput", { enumerable: true, get: function () { return form_public_1.NumberInput; } });
+Object.defineProperty(exports, "PhoneInput", { enumerable: true, get: function () { return form_public_1.PhoneInput; } });
+Object.defineProperty(exports, "RadioGroup", { enumerable: true, get: function () { return form_public_1.RadioGroup; } });
+Object.defineProperty(exports, "RatingInput", { enumerable: true, get: function () { return form_public_1.RatingInput; } });
+Object.defineProperty(exports, "Tags", { enumerable: true, get: function () { return form_public_1.Tags; } });
+Object.defineProperty(exports, "TextArea", { enumerable: true, get: function () { return form_public_1.TextArea; } });
+Object.defineProperty(exports, "TextInput", { enumerable: true, get: function () { return form_public_1.TextInput; } });
+Object.defineProperty(exports, "TimeInput", { enumerable: true, get: function () { return form_public_1.TimeInput; } });
+Object.defineProperty(exports, "LoginBar", { enumerable: true, get: function () { return form_public_1.LoginBar; } });
+Object.defineProperty(exports, "SubmitButton", { enumerable: true, get: function () { return form_public_1.SubmitButton; } });
+Object.defineProperty(exports, "FormProvider", { enumerable: true, get: function () { return form_public_1.FormProvider; } });

package/cjs/dist/services/form-service.d.ts

@@ -26,6 +26,8 @@ export type SubmitResponse = {
 export interface FormServiceAPI {
     /** Reactive signal containing the current form data */
     formSignal: ReadOnlySignal<forms.Form | null>;
+    /** Reactive signal containing the address templates */
+    addressTemplatesSignal: ReadOnlySignal<any[]>;
     /** Reactive signal indicating if a form is currently being loaded */
     isLoadingSignal: ReadOnlySignal<boolean>;
     /** Reactive signal containing any error message, or null if no error */
@@ -69,6 +71,7 @@ export type FormServiceConfig = {
 } | {
     form: forms.Form;
     onSubmit?: OnSubmit;
+    addressTemplates?: any[];
 };
 /**
  * Implementation of the Form service that manages reactive form data and submissions.

package/cjs/dist/services/form-service.js

@@ -6,6 +6,7 @@ const forms_1 = require("@wix/forms");
 const services_definitions_1 = require("@wix/services-definitions");
 const signals_1 = require("@wix/services-definitions/core-services/signals");
 const essentials_1 = require("@wix/essentials");
+const address_forms_js_1 = require("./utils/address-forms.js");
 /**
  * Service definition for the Form service.
  * This defines the contract that the FormService must implement.
@@ -47,17 +48,20 @@ exports.FormService = services_definitions_1.implementService.withConfig()(expor
     });
     const hasSchema = 'form' in config;
     const formSignal = signalsService.signal(hasSchema ? config.form : null);
+    const hasAddressTemplates = 'addressTemplates' in config;
+    const addressTemplatesSignal = signalsService.signal(hasAddressTemplates ? config.addressTemplates : null);
     const formValuesSignal = signalsService.signal({});
     if (!hasSchema) {
         loadForm(config.formId, config.namespace, config.additionalMetadata);
     }
     async function loadForm(id, namespace, additionalMetadata) {
+        let form;
         isLoadingSignal.set(true);
         errorSignal.set(null);
         try {
-            const result = await fetchForm({ id, namespace, additionalMetadata });
-            if (result) {
-                formSignal.set(result);
+            form = await fetchForm({ id, namespace, additionalMetadata });
+            if (form) {
+                formSignal.set(form);
             }
             else {
                 errorSignal.set('Form not found');
@@ -65,10 +69,32 @@ exports.FormService = services_definitions_1.implementService.withConfig()(expor
         }
         catch (err) {
             errorSignal.set('Failed to load form');
+            isLoadingSignal.set(false);
             throw err;
         }
-        finally {
+        if (!hasAddressTemplates && (0, address_forms_js_1.hasMultilineAddressField)(form)) {
+            loadAddressTemplates();
+        }
+        isLoadingSignal.set(false);
+    }
+    async function loadAddressTemplates() {
+        const form = formSignal.get();
+        if (!form || !(0, address_forms_js_1.hasMultilineAddressField)(form)) {
+            return;
+        }
+        try {
+            const addressTemplates = await (0, address_forms_js_1.fetchAddressForms)();
+            if (addressTemplates) {
+                addressTemplatesSignal.set(addressTemplates);
+            }
+            else {
+                errorSignal.set('Address templates not found');
+            }
+        }
+        catch (err) {
+            errorSignal.set('Failed to address templates');
             isLoadingSignal.set(false);
+            throw err;
         }
     }
     async function defaultSubmitHandler(formId, formValues) {
@@ -120,6 +146,7 @@ exports.FormService = services_definitions_1.implementService.withConfig()(expor
         errorSignal,
         submitResponseSignal,
         formValuesSignal,
+        addressTemplatesSignal,
         submitForm,
         handleForm,
     };
@@ -185,5 +212,9 @@ async function fetchForm({ id, namespace, additionalMetadata, }) {
  */
 async function loadFormServiceConfig(formId, namespace, additionalMetadata) {
     const form = await fetchForm({ id: formId, namespace, additionalMetadata });
-    return { form };
+    let addressTemplates;
+    if ((0, address_forms_js_1.hasMultilineAddressField)(form)) {
+        addressTemplates = await (0, address_forms_js_1.fetchAddressForms)();
+    }
+    return { form, addressTemplates };
 }

package/cjs/dist/services/utils/address-forms.d.ts

@@ -0,0 +1,95 @@
+import { forms } from '@wix/forms';
+export declare const ADDRESS_FORM_ID_BY_COUNTRY: {
+    COMMON: string;
+    US: string;
+    UY: string;
+    TH: string;
+    TR: string;
+    SZ: string;
+    ZA: string;
+    SE: string;
+    SI: string;
+    SK: string;
+    RS: string;
+    SB: string;
+    SG: string;
+    SN: string;
+    SD: string;
+    RU: string;
+    RO: string;
+    PY: string;
+    PT: string;
+    PL: string;
+    PH: string;
+    PE: string;
+    PA: string;
+    PK: string;
+    NZ: string;
+    NO: string;
+    NG: string;
+    NL: string;
+    MY: string;
+    MH: string;
+    MX: string;
+    KR: string;
+    JP: string;
+    IT: string;
+    IS: string;
+    IE: string;
+    IN: string;
+    IL: string;
+    ID: string;
+    HU: string;
+    HR: string;
+    GR: string;
+    GB: string;
+    FR: string;
+    ES: string;
+    EG: string;
+    DO: string;
+    DK: string;
+    DE: string;
+    CZ: string;
+    CY: string;
+    CR: string;
+    CO: string;
+    CI: string;
+    CN: string;
+    CL: string;
+    CH: string;
+    CA: string;
+    CF: string;
+    BR: string;
+    BS: string;
+    BE: string;
+    BG: string;
+    AT: string;
+    AU: string;
+    AR: string;
+    AE: string;
+};
+export declare const DEFAULT_COUNTRY = "COMMON";
+/**
+ * Checks if a form has multiline address fields
+ *
+ * @param form - The form to check
+ * @param options - Optional configuration
+ * @param options.excludeEcomAddress - If true, excludes ecom-specific address fields
+ * @returns true if the form contains multiline address fields
+ */
+export declare function hasMultilineAddressField(form: forms.Form): boolean;
+/**
+ * Fetches address form templates for all supported countries.
+ * These templates are needed for rendering multiline address fields
+ * with country-specific address formats.
+ *
+ * @returns Array of address templates indexed by country, or undefined if fetch fails
+ * @throws {Error} When the API request fails
+ *
+ * @example
+ * ```tsx
+ * const addressTemplates = await fetchAddressForms();
+ * // Returns: [{ country: 'US', id: '...', template: {...} }, ...]
+ * ```
+ */
+export declare function fetchAddressForms(): Promise<any>;

package/cjs/dist/services/utils/address-forms.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_COUNTRY = exports.ADDRESS_FORM_ID_BY_COUNTRY = void 0;
+exports.hasMultilineAddressField = hasMultilineAddressField;
+exports.fetchAddressForms = fetchAddressForms;
+const essentials_1 = require("@wix/essentials");
+const forms_1 = require("@wix/forms");
+exports.ADDRESS_FORM_ID_BY_COUNTRY = {
+    COMMON: '0d5dcb6d-1403-4b80-b73e-6d90a2245561',
+    US: 'ebe1c447-8fd5-4c7a-8cf1-75b94db68698',
+    UY: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    TH: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    TR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SZ: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    ZA: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SI: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SK: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    RS: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SB: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SG: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SN: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SD: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    RU: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    RO: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PY: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PT: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PL: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PH: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PA: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PK: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    NZ: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    NO: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    NG: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    NL: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    MY: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    MH: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    MX: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    KR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    JP: 'e51fc7b5-0c29-40c6-b2e8-58d9fa5e3c29',
+    IT: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    IS: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    IE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    IN: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    IL: 'bc7a8d54-8df3-47cb-bb9b-3338fd6246e5',
+    ID: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    HU: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    HR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    GR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    GB: '3d059d26-8ce8-48ce-9779-b23e42014454',
+    FR: 'fbc1fb24-37bc-4c0f-afa4-35e88a43127d',
+    ES: 'f0e74759-d378-4ae7-9db7-42b4c7d02094',
+    EG: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    DO: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    DK: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    DE: 'c7bde0e2-187e-44e7-8f51-14162259eb2b',
+    CZ: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CY: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CO: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CI: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CN: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CL: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CH: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CA: '2b942888-7d93-41ee-b85c-5705263f9eea',
+    CF: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    BR: '3160f799-1ade-455b-87f9-128875ec874e',
+    BS: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    BE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    BG: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    AT: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    AU: '76f1a42e-b609-4c8b-b41a-7ebf2fbb5a56',
+    AR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    AE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+};
+exports.DEFAULT_COUNTRY = 'COMMON';
+const addressCountryToFormMap = Object.entries(exports.ADDRESS_FORM_ID_BY_COUNTRY).map(([country, id]) => ({ country, id }));
+/**
+ * Checks if a form has multiline address fields
+ *
+ * @param form - The form to check
+ * @param options - Optional configuration
+ * @param options.excludeEcomAddress - If true, excludes ecom-specific address fields
+ * @returns true if the form contains multiline address fields
+ */
+function hasMultilineAddressField(form) {
+    return (form.formFields?.some((field) => field.inputOptions?.inputType === forms_1.forms.InputType.ADDRESS) ?? false);
+}
+/**
+ * Overrides template field IDs if needed
+ * This can be customized based on specific requirements
+ */
+function overrideTemplateFieldIds(templates) {
+    // Default implementation - no overrides
+    // Override this if you need custom field ID mappings
+    return templates;
+}
+/**
+ * Fetches address form templates for all supported countries.
+ * These templates are needed for rendering multiline address fields
+ * with country-specific address formats.
+ *
+ * @returns Array of address templates indexed by country, or undefined if fetch fails
+ * @throws {Error} When the API request fails
+ *
+ * @example
+ * ```tsx
+ * const addressTemplates = await fetchAddressForms();
+ * // Returns: [{ country: 'US', id: '...', template: {...} }, ...]
+ * ```
+ */
+async function fetchAddressForms() {
+    try {
+        const url = `https://www.wixapis.com/form-template-service/v1/templates?templateIds=0d5dcb6d-1403-4b80-b73e-6d90a2245561&templateIds=ebe1c447-8fd5-4c7a-8cf1-75b94db68698&templateIds=b7b59987-e5c6-4ec7-a4af-f48318a68a5d&templateIds=e51fc7b5-0c29-40c6-b2e8-58d9fa5e3c29&templateIds=bc7a8d54-8df3-47cb-bb9b-3338fd6246e5&templateIds=3d059d26-8ce8-48ce-9779-b23e42014454&templateIds=fbc1fb24-37bc-4c0f-afa4-35e88a43127d&templateIds=f0e74759-d378-4ae7-9db7-42b4c7d02094&templateIds=c7bde0e2-187e-44e7-8f51-14162259eb2b&templateIds=2b942888-7d93-41ee-b85c-5705263f9eea&templateIds=3160f799-1ade-455b-87f9-128875ec874e&templateIds=76f1a42e-b609-4c8b-b41a-7ebf2fbb5a56&namespace=wix.form_platform.form`;
+        const response = await essentials_1.httpClient.fetchWithAuth(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch form: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        const templatesWithOverrides = data.templates && overrideTemplateFieldIds(data.templates);
+        return addressCountryToFormMap
+            .map((addressCountryToForm) => ({
+            ...addressCountryToForm,
+            template: templatesWithOverrides?.find((_form) => {
+                return _form.id === addressCountryToForm.id;
+            }),
+        }))
+            .filter((addressCountryToForm) => Boolean(addressCountryToForm.template));
+    }
+    catch (error) {
+        console.error('Failed to fetch address forms:', error);
+        throw error;
+    }
+}

package/cjs/dist/services/utils/index.d.ts

@@ -1 +1,2 @@
 export { getUploadUrl, uploadFile } from './file-upload-utils';
+export { hasMultilineAddressField, fetchAddressForms } from './address-forms';

package/cjs/dist/services/utils/index.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uploadFile = exports.getUploadUrl = void 0;
+exports.fetchAddressForms = exports.hasMultilineAddressField = exports.uploadFile = exports.getUploadUrl = void 0;
 var file_upload_utils_1 = require("./file-upload-utils");
 Object.defineProperty(exports, "getUploadUrl", { enumerable: true, get: function () { return file_upload_utils_1.getUploadUrl; } });
 Object.defineProperty(exports, "uploadFile", { enumerable: true, get: function () { return file_upload_utils_1.uploadFile; } });
+var address_forms_1 = require("./address-forms");
+Object.defineProperty(exports, "hasMultilineAddressField", { enumerable: true, get: function () { return address_forms_1.hasMultilineAddressField; } });
+Object.defineProperty(exports, "fetchAddressForms", { enumerable: true, get: function () { return address_forms_1.fetchAddressForms; } });

package/dist/react/Form.js

@@ -1,7 +1,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import React, { useState, useCallback } from 'react';
 import { AsChildSlot } from '@wix/headless-utils/react';
-import { useForm, FormProvider, } from '@wix/form-public';
+import { useForm, FormProvider, UniqueFieldSuffixContextProvider, } from '@wix/form-public';
+import { i18n } from '@wix/essentials';
 import { Root as CoreRoot, Loading as CoreLoading, LoadingError as CoreLoadingError, Error as CoreError, Submitted as CoreSubmitted, Fields as CoreFields, Field as CoreField, } from './core/Form.js';
 import { FieldContext, useFieldContext, } from './context/FieldContext.js';
 import { FieldLayoutProvider, useFieldLayout, } from './context/FieldLayoutContext.js';
@@ -489,13 +490,15 @@ export const Submitted = React.forwardRef((props, ref) => {
  */
 export const Fields = React.forwardRef((props, ref) => {
     const [formErrors, setFormErrors] = useState([]);
+    const currentLocale = i18n.getLocale();
+    const currentLanguage = i18n.getLanguage();
     const handleFormValidate = useCallback((errors) => {
         setFormErrors(errors);
     }, []);
-    return (_jsx(CoreFields, { children: ({ form, formValues, submitForm, handleForm }) => {
+    return (_jsx(CoreFields, { children: ({ form, formValues, submitForm, handleForm, addressTemplates }) => {
             if (!form)
                 return null;
-            return (_jsx("div", { ref: ref, children: _jsx(FormProvider, { currency: 'USD', locale: 'en', children: _jsx(FieldsWithForm, { form: form, values: formValues, onChange: handleForm, errors: formErrors, onValidate: handleFormValidate, fields: props.fieldMap, submitForm: submitForm, rowGapClassname: props.rowGapClassname, columnGapClassname: props.columnGapClassname }) }) }));
+            return (_jsx("div", { ref: ref, children: _jsx(FormProvider, { currency: 'USD', locale: currentLanguage, regionalFormat: currentLocale, addressTemplates: addressTemplates, children: _jsx(UniqueFieldSuffixContextProvider, { parentId: form._id ?? '', children: _jsx(FieldsWithForm, { form: form, values: formValues, onChange: handleForm, errors: formErrors, onValidate: handleFormValidate, fields: props.fieldMap, submitForm: submitForm, rowGapClassname: props.rowGapClassname, columnGapClassname: props.columnGapClassname }) }) }) }));
         } }));
 });
 const FieldsWithForm = ({ form, submitForm, values, onChange, errors, onValidate, fields: fieldMap, rowGapClassname, columnGapClassname, }) => {

package/dist/react/core/Form.d.ts

@@ -229,6 +229,7 @@ export interface FieldsRenderProps {
     /** Function to submit the form with values */
     submitForm: () => Promise<void>;
     handleForm: (formValues: FormValues) => Promise<void>;
+    addressTemplates: any[];
 }
 /**
  * Props for Fields headless component

package/dist/react/core/Form.js

@@ -221,14 +221,16 @@ export function Submitted(props) {
  * ```
  */
 export function Fields(props) {
-    const { formSignal, submitForm, handleForm, formValuesSignal } = useService(FormServiceDefinition);
+    const { formSignal, submitForm, handleForm, formValuesSignal, addressTemplatesSignal, } = useService(FormServiceDefinition);
     const form = formSignal.get();
     const formValues = formValuesSignal.get();
+    const addressTemplates = addressTemplatesSignal.get();
     return props.children({
         form,
         formValues,
         submitForm,
         handleForm,
+        addressTemplates,
     });
 }
 /**

package/dist/react/index.d.ts

@@ -1,3 +1,3 @@
 export * as Form from './Form.js';
 export * from './types.js';
-export { PhoneField, FileUpload } from '@wix/form-public';
+export { Checkbox, CheckboxGroup, DateInput, DatePicker, DateTimeInput, Dropdown, FileUpload, MultilineAddress, NumberInput, PhoneInput, RadioGroup, RatingInput, Tags, TextArea, TextInput, TimeInput, LoginBar, SubmitButton, FormProvider, } from '@wix/form-public';

package/dist/react/index.js

@@ -1,3 +1,3 @@
 export * as Form from './Form.js';
 export * from './types.js';
-export { PhoneField, FileUpload } from '@wix/form-public';
+export { Checkbox, CheckboxGroup, DateInput, DatePicker, DateTimeInput, Dropdown, FileUpload, MultilineAddress, NumberInput, PhoneInput, RadioGroup, RatingInput, Tags, TextArea, TextInput, TimeInput, LoginBar, SubmitButton, FormProvider, } from '@wix/form-public';

package/dist/services/form-service.d.ts

@@ -26,6 +26,8 @@ export type SubmitResponse = {
 export interface FormServiceAPI {
     /** Reactive signal containing the current form data */
     formSignal: ReadOnlySignal<forms.Form | null>;
+    /** Reactive signal containing the address templates */
+    addressTemplatesSignal: ReadOnlySignal<any[]>;
     /** Reactive signal indicating if a form is currently being loaded */
     isLoadingSignal: ReadOnlySignal<boolean>;
     /** Reactive signal containing any error message, or null if no error */
@@ -69,6 +71,7 @@ export type FormServiceConfig = {
 } | {
     form: forms.Form;
     onSubmit?: OnSubmit;
+    addressTemplates?: any[];
 };
 /**
  * Implementation of the Form service that manages reactive form data and submissions.

package/dist/services/form-service.js

@@ -2,6 +2,7 @@ import { submissions } from '@wix/forms';
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
 import { httpClient } from '@wix/essentials';
+import { fetchAddressForms, hasMultilineAddressField, } from './utils/address-forms.js';
 /**
  * Service definition for the Form service.
  * This defines the contract that the FormService must implement.
@@ -43,17 +44,20 @@ export const FormService = implementService.withConfig()(FormServiceDefinition,
     });
     const hasSchema = 'form' in config;
     const formSignal = signalsService.signal(hasSchema ? config.form : null);
+    const hasAddressTemplates = 'addressTemplates' in config;
+    const addressTemplatesSignal = signalsService.signal(hasAddressTemplates ? config.addressTemplates : null);
     const formValuesSignal = signalsService.signal({});
     if (!hasSchema) {
         loadForm(config.formId, config.namespace, config.additionalMetadata);
     }
     async function loadForm(id, namespace, additionalMetadata) {
+        let form;
         isLoadingSignal.set(true);
         errorSignal.set(null);
         try {
-            const result = await fetchForm({ id, namespace, additionalMetadata });
-            if (result) {
-                formSignal.set(result);
+            form = await fetchForm({ id, namespace, additionalMetadata });
+            if (form) {
+                formSignal.set(form);
             }
             else {
                 errorSignal.set('Form not found');
@@ -61,10 +65,32 @@ export const FormService = implementService.withConfig()(FormServiceDefinition,
         }
         catch (err) {
             errorSignal.set('Failed to load form');
+            isLoadingSignal.set(false);
             throw err;
         }
-        finally {
+        if (!hasAddressTemplates && hasMultilineAddressField(form)) {
+            loadAddressTemplates();
+        }
+        isLoadingSignal.set(false);
+    }
+    async function loadAddressTemplates() {
+        const form = formSignal.get();
+        if (!form || !hasMultilineAddressField(form)) {
+            return;
+        }
+        try {
+            const addressTemplates = await fetchAddressForms();
+            if (addressTemplates) {
+                addressTemplatesSignal.set(addressTemplates);
+            }
+            else {
+                errorSignal.set('Address templates not found');
+            }
+        }
+        catch (err) {
+            errorSignal.set('Failed to address templates');
             isLoadingSignal.set(false);
+            throw err;
         }
     }
     async function defaultSubmitHandler(formId, formValues) {
@@ -116,6 +142,7 @@ export const FormService = implementService.withConfig()(FormServiceDefinition,
         errorSignal,
         submitResponseSignal,
         formValuesSignal,
+        addressTemplatesSignal,
         submitForm,
         handleForm,
     };
@@ -181,5 +208,9 @@ async function fetchForm({ id, namespace, additionalMetadata, }) {
  */
 export async function loadFormServiceConfig(formId, namespace, additionalMetadata) {
     const form = await fetchForm({ id: formId, namespace, additionalMetadata });
-    return { form };
+    let addressTemplates;
+    if (hasMultilineAddressField(form)) {
+        addressTemplates = await fetchAddressForms();
+    }
+    return { form, addressTemplates };
 }

package/dist/services/utils/address-forms.d.ts

@@ -0,0 +1,95 @@
+import { forms } from '@wix/forms';
+export declare const ADDRESS_FORM_ID_BY_COUNTRY: {
+    COMMON: string;
+    US: string;
+    UY: string;
+    TH: string;
+    TR: string;
+    SZ: string;
+    ZA: string;
+    SE: string;
+    SI: string;
+    SK: string;
+    RS: string;
+    SB: string;
+    SG: string;
+    SN: string;
+    SD: string;
+    RU: string;
+    RO: string;
+    PY: string;
+    PT: string;
+    PL: string;
+    PH: string;
+    PE: string;
+    PA: string;
+    PK: string;
+    NZ: string;
+    NO: string;
+    NG: string;
+    NL: string;
+    MY: string;
+    MH: string;
+    MX: string;
+    KR: string;
+    JP: string;
+    IT: string;
+    IS: string;
+    IE: string;
+    IN: string;
+    IL: string;
+    ID: string;
+    HU: string;
+    HR: string;
+    GR: string;
+    GB: string;
+    FR: string;
+    ES: string;
+    EG: string;
+    DO: string;
+    DK: string;
+    DE: string;
+    CZ: string;
+    CY: string;
+    CR: string;
+    CO: string;
+    CI: string;
+    CN: string;
+    CL: string;
+    CH: string;
+    CA: string;
+    CF: string;
+    BR: string;
+    BS: string;
+    BE: string;
+    BG: string;
+    AT: string;
+    AU: string;
+    AR: string;
+    AE: string;
+};
+export declare const DEFAULT_COUNTRY = "COMMON";
+/**
+ * Checks if a form has multiline address fields
+ *
+ * @param form - The form to check
+ * @param options - Optional configuration
+ * @param options.excludeEcomAddress - If true, excludes ecom-specific address fields
+ * @returns true if the form contains multiline address fields
+ */
+export declare function hasMultilineAddressField(form: forms.Form): boolean;
+/**
+ * Fetches address form templates for all supported countries.
+ * These templates are needed for rendering multiline address fields
+ * with country-specific address formats.
+ *
+ * @returns Array of address templates indexed by country, or undefined if fetch fails
+ * @throws {Error} When the API request fails
+ *
+ * @example
+ * ```tsx
+ * const addressTemplates = await fetchAddressForms();
+ * // Returns: [{ country: 'US', id: '...', template: {...} }, ...]
+ * ```
+ */
+export declare function fetchAddressForms(): Promise<any>;

package/dist/services/utils/address-forms.js

@@ -0,0 +1,130 @@
+import { httpClient } from '@wix/essentials';
+import { forms } from '@wix/forms';
+export const ADDRESS_FORM_ID_BY_COUNTRY = {
+    COMMON: '0d5dcb6d-1403-4b80-b73e-6d90a2245561',
+    US: 'ebe1c447-8fd5-4c7a-8cf1-75b94db68698',
+    UY: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    TH: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    TR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SZ: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    ZA: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SI: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SK: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    RS: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SB: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SG: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SN: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    SD: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    RU: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    RO: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PY: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PT: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PL: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PH: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PA: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    PK: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    NZ: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    NO: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    NG: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    NL: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    MY: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    MH: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    MX: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    KR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    JP: 'e51fc7b5-0c29-40c6-b2e8-58d9fa5e3c29',
+    IT: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    IS: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    IE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    IN: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    IL: 'bc7a8d54-8df3-47cb-bb9b-3338fd6246e5',
+    ID: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    HU: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    HR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    GR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    GB: '3d059d26-8ce8-48ce-9779-b23e42014454',
+    FR: 'fbc1fb24-37bc-4c0f-afa4-35e88a43127d',
+    ES: 'f0e74759-d378-4ae7-9db7-42b4c7d02094',
+    EG: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    DO: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    DK: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    DE: 'c7bde0e2-187e-44e7-8f51-14162259eb2b',
+    CZ: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CY: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CO: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CI: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CN: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CL: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CH: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    CA: '2b942888-7d93-41ee-b85c-5705263f9eea',
+    CF: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    BR: '3160f799-1ade-455b-87f9-128875ec874e',
+    BS: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    BE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    BG: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    AT: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    AU: '76f1a42e-b609-4c8b-b41a-7ebf2fbb5a56',
+    AR: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+    AE: 'b7b59987-e5c6-4ec7-a4af-f48318a68a5d',
+};
+export const DEFAULT_COUNTRY = 'COMMON';
+const addressCountryToFormMap = Object.entries(ADDRESS_FORM_ID_BY_COUNTRY).map(([country, id]) => ({ country, id }));
+/**
+ * Checks if a form has multiline address fields
+ *
+ * @param form - The form to check
+ * @param options - Optional configuration
+ * @param options.excludeEcomAddress - If true, excludes ecom-specific address fields
+ * @returns true if the form contains multiline address fields
+ */
+export function hasMultilineAddressField(form) {
+    return (form.formFields?.some((field) => field.inputOptions?.inputType === forms.InputType.ADDRESS) ?? false);
+}
+/**
+ * Overrides template field IDs if needed
+ * This can be customized based on specific requirements
+ */
+function overrideTemplateFieldIds(templates) {
+    // Default implementation - no overrides
+    // Override this if you need custom field ID mappings
+    return templates;
+}
+/**
+ * Fetches address form templates for all supported countries.
+ * These templates are needed for rendering multiline address fields
+ * with country-specific address formats.
+ *
+ * @returns Array of address templates indexed by country, or undefined if fetch fails
+ * @throws {Error} When the API request fails
+ *
+ * @example
+ * ```tsx
+ * const addressTemplates = await fetchAddressForms();
+ * // Returns: [{ country: 'US', id: '...', template: {...} }, ...]
+ * ```
+ */
+export async function fetchAddressForms() {
+    try {
+        const url = `https://www.wixapis.com/form-template-service/v1/templates?templateIds=0d5dcb6d-1403-4b80-b73e-6d90a2245561&templateIds=ebe1c447-8fd5-4c7a-8cf1-75b94db68698&templateIds=b7b59987-e5c6-4ec7-a4af-f48318a68a5d&templateIds=e51fc7b5-0c29-40c6-b2e8-58d9fa5e3c29&templateIds=bc7a8d54-8df3-47cb-bb9b-3338fd6246e5&templateIds=3d059d26-8ce8-48ce-9779-b23e42014454&templateIds=fbc1fb24-37bc-4c0f-afa4-35e88a43127d&templateIds=f0e74759-d378-4ae7-9db7-42b4c7d02094&templateIds=c7bde0e2-187e-44e7-8f51-14162259eb2b&templateIds=2b942888-7d93-41ee-b85c-5705263f9eea&templateIds=3160f799-1ade-455b-87f9-128875ec874e&templateIds=76f1a42e-b609-4c8b-b41a-7ebf2fbb5a56&namespace=wix.form_platform.form`;
+        const response = await httpClient.fetchWithAuth(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch form: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        const templatesWithOverrides = data.templates && overrideTemplateFieldIds(data.templates);
+        return addressCountryToFormMap
+            .map((addressCountryToForm) => ({
+            ...addressCountryToForm,
+            template: templatesWithOverrides?.find((_form) => {
+                return _form.id === addressCountryToForm.id;
+            }),
+        }))
+            .filter((addressCountryToForm) => Boolean(addressCountryToForm.template));
+    }
+    catch (error) {
+        console.error('Failed to fetch address forms:', error);
+        throw error;
+    }
+}

package/dist/services/utils/index.d.ts

@@ -1 +1,2 @@
 export { getUploadUrl, uploadFile } from './file-upload-utils';
+export { hasMultilineAddressField, fetchAddressForms } from './address-forms';

package/dist/services/utils/index.js

@@ -1 +1,2 @@
 export { getUploadUrl, uploadFile } from './file-upload-utils';
+export { hasMultilineAddressField, fetchAddressForms } from './address-forms';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-forms",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -42,7 +42,7 @@
     "vitest": "^3.1.4"
   },
   "dependencies": {
-    "@wix/form-public": "^0.68.0",
+    "@wix/form-public": "^0.95.0",
     "@wix/forms": "^1.0.331",
     "@wix/headless-utils": "0.0.8",
     "@wix/services-definitions": "^0.1.4",
@@ -59,5 +59,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "4cc244b64113d6b53fa1ed4d4a8d082fece7978b89d43da73d1dae9f"
+  "falconPackageHash": "7a802b3af894bd379d396ecadf0577e0d20335ee486354273b550919"
 }