@wix/headless-forms 0.0.1

package/cjs/dist/react/constants/calling-country-codes.d.ts

@@ -0,0 +1,242 @@
+declare const CALLING_COUNTRY_CODES: {
+    readonly AW: "ABW";
+    readonly AO: "AGO";
+    readonly AF: "AFG";
+    readonly AI: "AIA";
+    readonly AX: "ALA";
+    readonly AL: "ALB";
+    readonly AD: "AND";
+    readonly AE: "ARE";
+    readonly AR: "ARG";
+    readonly AM: "ARM";
+    readonly AS: "ASM";
+    readonly AG: "ATG";
+    readonly AU: "AUS";
+    readonly AT: "AUT";
+    readonly AZ: "AZE";
+    readonly BI: "BDI";
+    readonly BE: "BEL";
+    readonly BJ: "BEN";
+    readonly BQ: "BES";
+    readonly BF: "BFA";
+    readonly BD: "BGD";
+    readonly BG: "BGR";
+    readonly BH: "BHR";
+    readonly BS: "BHS";
+    readonly BA: "BIH";
+    readonly BL: "BLM";
+    readonly BY: "BLR";
+    readonly BZ: "BLZ";
+    readonly BM: "BMU";
+    readonly BO: "BOL";
+    readonly BR: "BRA";
+    readonly BB: "BRB";
+    readonly BN: "BRN";
+    readonly BT: "BTN";
+    readonly BW: "BWA";
+    readonly CF: "CAF";
+    readonly CA: "CAN";
+    readonly CC: "CCK";
+    readonly CH: "CHE";
+    readonly CL: "CHL";
+    readonly CN: "CHN";
+    readonly CI: "CIV";
+    readonly CM: "CMR";
+    readonly CD: "COD";
+    readonly CG: "COG";
+    readonly CK: "COK";
+    readonly CO: "COL";
+    readonly KM: "COM";
+    readonly CV: "CPV";
+    readonly CR: "CRI";
+    readonly CW: "CUW";
+    readonly CX: "CXR";
+    readonly KY: "CYM";
+    readonly CY: "CYP";
+    readonly CZ: "CZE";
+    readonly DE: "DEU";
+    readonly DJ: "DJI";
+    readonly DM: "DMA";
+    readonly DK: "DNK";
+    readonly DO: "DOM";
+    readonly DZ: "DZA";
+    readonly EC: "ECU";
+    readonly EG: "EGY";
+    readonly ER: "ERI";
+    readonly ES: "ESP";
+    readonly EE: "EST";
+    readonly ET: "ETH";
+    readonly FI: "FIN";
+    readonly FJ: "FJI";
+    readonly FK: "FLK";
+    readonly FR: "FRA";
+    readonly FO: "FRO";
+    readonly FM: "FSM";
+    readonly GA: "GAB";
+    readonly GB: "GBR";
+    readonly GE: "GEO";
+    readonly GG: "GGY";
+    readonly GH: "GHA";
+    readonly GI: "GIB";
+    readonly GN: "GIN";
+    readonly GP: "GLP";
+    readonly GM: "GMB";
+    readonly GW: "GNB";
+    readonly GQ: "GNQ";
+    readonly GR: "GRC";
+    readonly GD: "GRD";
+    readonly GL: "GRL";
+    readonly GT: "GTM";
+    readonly GF: "GUF";
+    readonly GU: "GUM";
+    readonly GY: "GUY";
+    readonly HK: "HKG";
+    readonly HN: "HND";
+    readonly HR: "HRV";
+    readonly HT: "HTI";
+    readonly HU: "HUN";
+    readonly ID: "IDN";
+    readonly IM: "IMN";
+    readonly IN: "IND";
+    readonly IO: "IOT";
+    readonly IE: "IRL";
+    readonly IS: "ISL";
+    readonly IL: "ISR";
+    readonly IT: "ITA";
+    readonly IQ: "IRQ";
+    readonly JM: "JAM";
+    readonly JE: "JEY";
+    readonly JO: "JOR";
+    readonly JP: "JPN";
+    readonly KZ: "KAZ";
+    readonly KE: "KEN";
+    readonly KG: "KGZ";
+    readonly KH: "KHM";
+    readonly KI: "KIR";
+    readonly KN: "KNA";
+    readonly KR: "KOR";
+    readonly KW: "KWT";
+    readonly LA: "LAO";
+    readonly LB: "LBN";
+    readonly LR: "LBR";
+    readonly LY: "LBY";
+    readonly LC: "LCA";
+    readonly LI: "LIE";
+    readonly LK: "LKA";
+    readonly LS: "LSO";
+    readonly LT: "LTU";
+    readonly LU: "LUX";
+    readonly LV: "LVA";
+    readonly MO: "MAC";
+    readonly MF: "MAF";
+    readonly MA: "MAR";
+    readonly MC: "MCO";
+    readonly MD: "MDA";
+    readonly MG: "MDG";
+    readonly MV: "MDV";
+    readonly MX: "MEX";
+    readonly MH: "MHL";
+    readonly MK: "MKD";
+    readonly ML: "MLI";
+    readonly MT: "MLT";
+    readonly MM: "MMR";
+    readonly ME: "MNE";
+    readonly MN: "MNG";
+    readonly MP: "MNP";
+    readonly MZ: "MOZ";
+    readonly MR: "MRT";
+    readonly MS: "MSR";
+    readonly MQ: "MTQ";
+    readonly MU: "MUS";
+    readonly MW: "MWI";
+    readonly MY: "MYS";
+    readonly YT: "MYT";
+    readonly NA: "NAM";
+    readonly NC: "NCL";
+    readonly NE: "NER";
+    readonly NF: "NFK";
+    readonly NG: "NGA";
+    readonly NI: "NIC";
+    readonly NU: "NIU";
+    readonly NL: "NLD";
+    readonly NO: "NOR";
+    readonly NP: "NPL";
+    readonly NR: "NRU";
+    readonly NZ: "NZL";
+    readonly OM: "OMN";
+    readonly PK: "PAK";
+    readonly PA: "PAN";
+    readonly PE: "PER";
+    readonly PH: "PHL";
+    readonly PW: "PLW";
+    readonly PG: "PNG";
+    readonly PL: "POL";
+    readonly PR: "PRI";
+    readonly PT: "PRT";
+    readonly PY: "PRY";
+    readonly PS: "PSE";
+    readonly PF: "PYF";
+    readonly QA: "QAT";
+    readonly RE: "REU";
+    readonly RO: "ROU";
+    readonly RU: "RUS";
+    readonly RW: "RWA";
+    readonly SA: "SAU";
+    readonly SD: "SDN";
+    readonly SN: "SEN";
+    readonly SG: "SGP";
+    readonly SH: "SHN";
+    readonly SJ: "SJM";
+    readonly SB: "SLB";
+    readonly SL: "SLE";
+    readonly SV: "SLV";
+    readonly SM: "SMR";
+    readonly SO: "SOM";
+    readonly PM: "SPM";
+    readonly RS: "SRB";
+    readonly SS: "SSD";
+    readonly ST: "STP";
+    readonly SR: "SUR";
+    readonly SK: "SVK";
+    readonly SI: "SVN";
+    readonly SE: "SWE";
+    readonly SZ: "SWZ";
+    readonly SX: "SXM";
+    readonly SC: "SYC";
+    readonly TC: "TCA";
+    readonly TD: "TCD";
+    readonly TG: "TGO";
+    readonly TH: "THA";
+    readonly TJ: "TJK";
+    readonly TK: "TKL";
+    readonly TM: "TKM";
+    readonly TL: "TLS";
+    readonly TO: "TON";
+    readonly TT: "TTO";
+    readonly TN: "TUN";
+    readonly TR: "TUR";
+    readonly TV: "TUV";
+    readonly TW: "TWN";
+    readonly TZ: "TZA";
+    readonly UG: "UGA";
+    readonly UA: "UKR";
+    readonly UY: "URY";
+    readonly US: "USA";
+    readonly UZ: "UZB";
+    readonly VA: "VAT";
+    readonly VC: "VCT";
+    readonly VE: "VEN";
+    readonly VG: "VGB";
+    readonly VI: "VIR";
+    readonly VN: "VNM";
+    readonly VU: "VUT";
+    readonly WF: "WLF";
+    readonly WS: "WSM";
+    readonly XK: "KOS";
+    readonly YE: "YEM";
+    readonly ZA: "ZAF";
+    readonly ZM: "ZMB";
+    readonly ZW: "ZWE";
+};
+export type CallingCountryCode = keyof typeof CALLING_COUNTRY_CODES;
+export {};

package/cjs/dist/react/constants/calling-country-codes.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const CALLING_COUNTRY_CODES = {
+    AW: 'ABW',
+    AO: 'AGO',
+    AF: 'AFG',
+    AI: 'AIA',
+    AX: 'ALA',
+    AL: 'ALB',
+    AD: 'AND',
+    AE: 'ARE',
+    AR: 'ARG',
+    AM: 'ARM',
+    AS: 'ASM',
+    AG: 'ATG',
+    AU: 'AUS',
+    AT: 'AUT',
+    AZ: 'AZE',
+    BI: 'BDI',
+    BE: 'BEL',
+    BJ: 'BEN',
+    BQ: 'BES',
+    BF: 'BFA',
+    BD: 'BGD',
+    BG: 'BGR',
+    BH: 'BHR',
+    BS: 'BHS',
+    BA: 'BIH',
+    BL: 'BLM',
+    BY: 'BLR',
+    BZ: 'BLZ',
+    BM: 'BMU',
+    BO: 'BOL',
+    BR: 'BRA',
+    BB: 'BRB',
+    BN: 'BRN',
+    BT: 'BTN',
+    BW: 'BWA',
+    CF: 'CAF',
+    CA: 'CAN',
+    CC: 'CCK',
+    CH: 'CHE',
+    CL: 'CHL',
+    CN: 'CHN',
+    CI: 'CIV',
+    CM: 'CMR',
+    CD: 'COD',
+    CG: 'COG',
+    CK: 'COK',
+    CO: 'COL',
+    KM: 'COM',
+    CV: 'CPV',
+    CR: 'CRI',
+    CW: 'CUW',
+    CX: 'CXR',
+    KY: 'CYM',
+    CY: 'CYP',
+    CZ: 'CZE',
+    DE: 'DEU',
+    DJ: 'DJI',
+    DM: 'DMA',
+    DK: 'DNK',
+    DO: 'DOM',
+    DZ: 'DZA',
+    EC: 'ECU',
+    EG: 'EGY',
+    ER: 'ERI',
+    ES: 'ESP',
+    EE: 'EST',
+    ET: 'ETH',
+    FI: 'FIN',
+    FJ: 'FJI',
+    FK: 'FLK',
+    FR: 'FRA',
+    FO: 'FRO',
+    FM: 'FSM',
+    GA: 'GAB',
+    GB: 'GBR',
+    GE: 'GEO',
+    GG: 'GGY',
+    GH: 'GHA',
+    GI: 'GIB',
+    GN: 'GIN',
+    GP: 'GLP',
+    GM: 'GMB',
+    GW: 'GNB',
+    GQ: 'GNQ',
+    GR: 'GRC',
+    GD: 'GRD',
+    GL: 'GRL',
+    GT: 'GTM',
+    GF: 'GUF',
+    GU: 'GUM',
+    GY: 'GUY',
+    HK: 'HKG',
+    HN: 'HND',
+    HR: 'HRV',
+    HT: 'HTI',
+    HU: 'HUN',
+    ID: 'IDN',
+    IM: 'IMN',
+    IN: 'IND',
+    IO: 'IOT',
+    IE: 'IRL',
+    IS: 'ISL',
+    IL: 'ISR',
+    IT: 'ITA',
+    IQ: 'IRQ',
+    JM: 'JAM',
+    JE: 'JEY',
+    JO: 'JOR',
+    JP: 'JPN',
+    KZ: 'KAZ',
+    KE: 'KEN',
+    KG: 'KGZ',
+    KH: 'KHM',
+    KI: 'KIR',
+    KN: 'KNA',
+    KR: 'KOR',
+    KW: 'KWT',
+    LA: 'LAO',
+    LB: 'LBN',
+    LR: 'LBR',
+    LY: 'LBY',
+    LC: 'LCA',
+    LI: 'LIE',
+    LK: 'LKA',
+    LS: 'LSO',
+    LT: 'LTU',
+    LU: 'LUX',
+    LV: 'LVA',
+    MO: 'MAC',
+    MF: 'MAF',
+    MA: 'MAR',
+    MC: 'MCO',
+    MD: 'MDA',
+    MG: 'MDG',
+    MV: 'MDV',
+    MX: 'MEX',
+    MH: 'MHL',
+    MK: 'MKD',
+    ML: 'MLI',
+    MT: 'MLT',
+    MM: 'MMR',
+    ME: 'MNE',
+    MN: 'MNG',
+    MP: 'MNP',
+    MZ: 'MOZ',
+    MR: 'MRT',
+    MS: 'MSR',
+    MQ: 'MTQ',
+    MU: 'MUS',
+    MW: 'MWI',
+    MY: 'MYS',
+    YT: 'MYT',
+    NA: 'NAM',
+    NC: 'NCL',
+    NE: 'NER',
+    NF: 'NFK',
+    NG: 'NGA',
+    NI: 'NIC',
+    NU: 'NIU',
+    NL: 'NLD',
+    NO: 'NOR',
+    NP: 'NPL',
+    NR: 'NRU',
+    NZ: 'NZL',
+    OM: 'OMN',
+    PK: 'PAK',
+    PA: 'PAN',
+    PE: 'PER',
+    PH: 'PHL',
+    PW: 'PLW',
+    PG: 'PNG',
+    PL: 'POL',
+    PR: 'PRI',
+    PT: 'PRT',
+    PY: 'PRY',
+    PS: 'PSE',
+    PF: 'PYF',
+    QA: 'QAT',
+    RE: 'REU',
+    RO: 'ROU',
+    RU: 'RUS',
+    RW: 'RWA',
+    SA: 'SAU',
+    SD: 'SDN',
+    SN: 'SEN',
+    SG: 'SGP',
+    SH: 'SHN',
+    SJ: 'SJM',
+    SB: 'SLB',
+    SL: 'SLE',
+    SV: 'SLV',
+    SM: 'SMR',
+    SO: 'SOM',
+    PM: 'SPM',
+    RS: 'SRB',
+    SS: 'SSD',
+    ST: 'STP',
+    SR: 'SUR',
+    SK: 'SVK',
+    SI: 'SVN',
+    SE: 'SWE',
+    SZ: 'SWZ',
+    SX: 'SXM',
+    SC: 'SYC',
+    TC: 'TCA',
+    TD: 'TCD',
+    TG: 'TGO',
+    TH: 'THA',
+    TJ: 'TJK',
+    TK: 'TKL',
+    TM: 'TKM',
+    TL: 'TLS',
+    TO: 'TON',
+    TT: 'TTO',
+    TN: 'TUN',
+    TR: 'TUR',
+    TV: 'TUV',
+    TW: 'TWN',
+    TZ: 'TZA',
+    UG: 'UGA',
+    UA: 'UKR',
+    UY: 'URY',
+    US: 'USA',
+    UZ: 'UZB',
+    VA: 'VAT',
+    VC: 'VCT',
+    VE: 'VEN',
+    VG: 'VGB',
+    VI: 'VIR',
+    VN: 'VNM',
+    VU: 'VUT',
+    WF: 'WLF',
+    WS: 'WSM',
+    XK: 'KOS',
+    YE: 'YEM',
+    ZA: 'ZAF',
+    ZM: 'ZMB',
+    ZW: 'ZWE',
+};

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

@@ -0,0 +1,215 @@
+import { FormServiceConfig } from '../../services/form-service.js';
+export interface RootProps {
+    children: React.ReactNode;
+    formServiceConfig: FormServiceConfig;
+}
+/**
+ * Root component that provides the Form service context to its children.
+ * This component sets up the necessary services for rendering and managing form data.
+ *
+ * @order 1
+ * @component
+ * @param {React.ReactNode} children - Child components that will have access to form context
+ * @param {FormServiceConfig} formServiceConfig - Configuration object containing form data
+ * @example
+ * ```tsx
+ * import { Form } from '@wix/headless-forms/react';
+ * import { loadFormServiceConfig } from '@wix/headless-forms/services';
+ *
+ * // Pattern 1: Pre-loaded form data (SSR/SSG)
+ * function FormPage({ formServiceConfig }) {
+ *   return (
+ *     <Form.Root formServiceConfig={formServiceConfig}>
+ *       <Form.Loading>
+ *         {({ isLoading }) => isLoading ? <div>Loading form...</div> : null}
+ *       </Form.Loading>
+ *       <Form.LoadingError>
+ *         {({ error, hasError }) => hasError ? <div>{error}</div> : null}
+ *       </Form.LoadingError>
+ *       <Form.Fields fieldMap={FIELD_MAP} />
+ *     </Form.Root>
+ *   );
+ * }
+ *
+ * // Pattern 2: Lazy loading with formId (Client-side)
+ * function DynamicFormPage({ formId }) {
+ *   return (
+ *     <Form.Root formServiceConfig={{ formId }}>
+ *       <Form.Loading>
+ *         {({ isLoading }) => isLoading ? <div>Loading form...</div> : null}
+ *       </Form.Loading>
+ *       <Form.LoadingError>
+ *         {({ error, hasError }) => hasError ? <div>{error}</div> : null}
+ *       </Form.LoadingError>
+ *       <Form.Fields fieldMap={FIELD_MAP} />
+ *     </Form.Root>
+ *   );
+ * }
+ * ```
+ */
+export declare function Root(props: RootProps): React.ReactNode;
+/**
+ * Props for FormLoading headless component
+ */
+export interface FormLoadingProps {
+    /** Render prop function that receives loading state data */
+    children: (props: FormLoadingRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for FormLoading component
+ */
+export interface FormLoadingRenderProps {
+    /** Whether the form is currently loading */
+    isLoading: boolean;
+}
+/**
+ * Headless component for form loading state access
+ *
+ * @component
+ * @param {FormLoadingProps} props - Component props
+ * @param {FormLoadingProps['children']} props.children - Render prop function that receives loading state
+ * @example
+ * ```tsx
+ * import { Form } from '@wix/headless-forms/react';
+ *
+ * function FormLoadingIndicator() {
+ *   return (
+ *     <Form.Loading>
+ *       {({ isLoading }) => (
+ *         isLoading ? (
+ *           <div>Loading form...</div>
+ *         ) : null
+ *       )}
+ *     </Form.Loading>
+ *   );
+ * }
+ * ```
+ */
+export declare function Loading(props: FormLoadingProps): import("react").ReactNode;
+/**
+ * Props for FormError headless component
+ */
+export interface FormErrorProps {
+    /** Render prop function that receives error state data */
+    children: (props: FormErrorRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for FormError component
+ */
+export interface FormErrorRenderProps {
+    /** Error message if there's an error */
+    error: string | null;
+    /** Whether there's an error */
+    hasError: boolean;
+}
+/**
+ * Headless component for form error state access
+ *
+ * @component
+ * @param {FormErrorProps} props - Component props
+ * @param {FormErrorProps['children']} props.children - Render prop function that receives error state
+ * @example
+ * ```tsx
+ * import { Form } from '@wix/headless-forms/react';
+ *
+ * function FormErrorDisplay() {
+ *   return (
+ *     <Form.LoadingError>
+ *       {({ error, hasError }) => (
+ *         hasError ? (
+ *           <div className="error-message">
+ *             {error}
+ *           </div>
+ *         ) : null
+ *       )}
+ *     </Form.LoadingError>
+ *   );
+ * }
+ * ```
+ */
+export declare function LoadingError(props: FormErrorProps): import("react").ReactNode;
+/**
+ * Props for Form Error headless component
+ */
+export interface FormSubmitErrorProps {
+    /** Render prop function that receives submit error state data */
+    children: (props: FormSubmitErrorRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for Form Error component
+ */
+export interface FormSubmitErrorRenderProps {
+    /** Submit error message */
+    error: string | null;
+    /** Whether there's a submit error */
+    hasError: boolean;
+}
+/**
+ * Headless component for form submit error state access
+ *
+ * @component
+ * @param {FormSubmitErrorProps} props - Component props
+ * @param {FormSubmitErrorProps['children']} props.children - Render prop function that receives submit error state
+ * @example
+ * ```tsx
+ * import { Form } from '@wix/headless-forms/react';
+ *
+ * function FormSubmitErrorDisplay() {
+ *   return (
+ *     <Form.Error>
+ *       {({ error, hasError }) => (
+ *         hasError ? (
+ *           <div className="error-message">
+ *             {error}
+ *           </div>
+ *         ) : null
+ *       )}
+ *     </Form.Error>
+ *   );
+ * }
+ * ```
+ */
+export declare function Error(props: FormSubmitErrorProps): import("react").ReactNode;
+/**
+ * Props for Form Submitted headless component
+ */
+export interface FormSubmittedProps {
+    /** Render prop function that receives submission state data */
+    children: (props: FormSubmittedRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for Form Submitted component
+ */
+export interface FormSubmittedRenderProps {
+    /** Whether the form has been submitted */
+    isSubmitted: boolean;
+    /** Success message */
+    message: string;
+}
+/**
+ * Headless component for form submission state access
+ *
+ * @component
+ * @param {FormSubmittedProps} props - Component props
+ * @param {FormSubmittedProps['children']} props.children - Render prop function that receives submission state
+ * @example
+ * ```tsx
+ * import { Form } from '@wix/headless-forms/react';
+ *
+ * function FormSubmittedDisplay() {
+ *   return (
+ *     <Form.Submitted>
+ *       {({ isSubmitted, message }) => (
+ *         isSubmitted ? (
+ *           <div className="success-message">
+ *             <h2>Thank You!</h2>
+ *             <p>{message}</p>
+ *           </div>
+ *         ) : null
+ *       )}
+ *     </Form.Submitted>
+ *   );
+ * }
+ * ```
+ */
+export declare function Submitted(props: FormSubmittedProps): import("react").ReactNode;