@usgb/forms 0.1.0 → 1.0.0

package/dist/src/contract/collectContext.d.ts

@@ -0,0 +1,9 @@
+import { TrackingKey, TrackingValue, HostAdapter } from './types';
+import { TrackingRegistryEntry } from '../definitions/types';
+export declare function collectTrackingContext(args: {
+    trackingFields: TrackingKey[];
+    trackingRegistry: Record<string, TrackingRegistryEntry>;
+    adapter: HostAdapter;
+}): Partial<Record<TrackingKey, TrackingValue>>;
+export declare function createIdempotencyKey(): string;
+//# sourceMappingURL=collectContext.d.ts.map

package/dist/src/contract/collectContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectContext.d.ts","sourceRoot":"","sources":["../../../src/contract/collectContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAkB,aAAa,EAAE,MAAM,SAAS,CAAA;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAiB1C,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IACzC,cAAc,EAAE,WAAW,EAAE,CAAA;IAC7B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IACvD,OAAO,EAAE,WAAW,CAAA;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAgD9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C"}

package/dist/src/contract/createStubAdapter.d.ts

@@ -0,0 +1,9 @@
+import { HostAdapter, HostId, SubmissionPayload, SubmitResult } from './types';
+export interface StubAdapterOptions {
+    host?: HostId;
+    delayMs?: number;
+    result?: SubmitResult;
+    onSubmit?: (payload: SubmissionPayload) => void;
+}
+export declare function createStubAdapter(options?: StubAdapterOptions | HostId): HostAdapter;
+//# sourceMappingURL=createStubAdapter.d.ts.map

package/dist/src/contract/createStubAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStubAdapter.d.ts","sourceRoot":"","sources":["../../../src/contract/createStubAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,WAAW,EACX,MAAM,EACN,iBAAiB,EACjB,YAAY,EACf,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,kBAAkB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAClD;AAED,wBAAgB,iBAAiB,CAC7B,OAAO,GAAE,kBAAkB,GAAG,MAAW,GAC1C,WAAW,CAkCb"}

package/dist/src/contract/types.d.ts

@@ -0,0 +1,90 @@
+export type HostId = 'pwa' | 'wordpress';
+export type TrackingStatus = 'collected' | 'unavailable' | 'consent-withheld';
+export type TrackingKey = 'page_url' | 'page_title' | 'referrer' | 'first_touch_url' | 'utm_source' | 'utm_medium' | 'utm_campaign' | 'utm_term' | 'utm_content' | 'gclid' | 'msclkid' | 'gbraid' | 'wbraid' | 'hubspot_utk' | 'ga_client_id' | 'ga_session_id' | 'snowplow_id' | 'vwo_uuid' | 'user_agent' | 'ip_address';
+export interface TrackingValue {
+    status: TrackingStatus;
+    value?: string;
+}
+export interface ConsentPayload {
+    definitionId: string;
+    definitionVersion: string;
+    values: Record<string, boolean | string>;
+    timestamp: string;
+    source?: string;
+    placement?: string;
+}
+export interface SubmissionPayload {
+    formId: string;
+    definitionVersion: string;
+    submissionContractVersion: string;
+    idempotencyKey: string;
+    data: Record<string, unknown>;
+    consent?: ConsentPayload;
+    context: {
+        host: HostId;
+        source?: string;
+        campaign?: string;
+        page?: string;
+        tracking: Partial<Record<TrackingKey, TrackingValue>>;
+    };
+}
+export interface SubmitResult {
+    status: 'accepted' | 'failed';
+    message?: string;
+}
+/** Host CMS routes for documents named in package-owned consent copy. */
+export interface LegalUrls {
+    clientAgreement?: string;
+    privacyPolicy?: string;
+    userAgreement?: string;
+    marketLossPolicy?: string;
+    electronicDisclaimer?: string;
+    termsOfSale?: string;
+}
+export type LegalUrlKey = keyof LegalUrls;
+/** Magento CMS paths used by the PWA. WordPress must pass its own permalinks. */
+export declare const PWA_LEGAL_URLS: LegalUrls;
+export declare function isCompleteLegalUrls(urls: LegalUrls | undefined, required?: readonly LegalUrlKey[]): urls is LegalUrls;
+export interface FieldOption {
+    value: string;
+    label: string;
+}
+export interface AddressValidationResult {
+    status: 'valid' | 'suggested' | 'invalid';
+    message?: string;
+    suggested?: Record<string, unknown>;
+}
+export interface HostAdapter {
+    host: HostId;
+    getTrackingHints(): Partial<Record<TrackingKey, string | undefined>>;
+    submit(payload: SubmissionPayload): Promise<SubmitResult>;
+    /** Optional — used by address kind later. */
+    getFieldOptions?(field: string): Promise<FieldOption[]>;
+    /** Optional — used by address kind later. */
+    validateAddress?(data: Record<string, unknown>): Promise<AddressValidationResult>;
+    /** Optional — used by multi-step flow later. */
+    submitStep?(stepId: string, payload: SubmissionPayload): Promise<SubmitResult>;
+}
+export type FormAppearance = 'light' | 'navy';
+export type FormVariant = 'dense' | 'large' | 'sidebar' | 'two-column';
+export type FormAnalyticsEvent = {
+    type: 'view';
+    formId: string;
+} | {
+    type: 'validation_failure';
+    formId: string;
+    fields: string[];
+} | {
+    type: 'submit_attempt';
+    formId: string;
+} | {
+    type: 'success';
+    formId: string;
+    status: 'accepted';
+} | {
+    type: 'failure';
+    formId: string;
+    message?: string;
+};
+export type FormAnalytics = (event: FormAnalyticsEvent) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/contract/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/contract/types.ts"],"names":[],"mappings":"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"}

package/dist/src/definitions/consents.d.ts

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+import { LegalUrlKey, LegalUrls } from '../contract/types';
+export interface ConsentCheckbox {
+    type: 'checkbox';
+    name: string;
+    required: boolean;
+    content: ConsentContent;
+}
+export interface ConsentNotice {
+    type: 'notice';
+    content: ConsentContent;
+}
+export type ConsentContent = ReactNode | ((urls: LegalUrls) => ReactNode);
+export type ConsentItem = ConsentCheckbox | ConsentNotice;
+export interface ConsentDefinition {
+    definitionId: string;
+    definitionVersion: string;
+    /** Host URLs that must be present before this legal copy can render. */
+    requiredLegalUrls: LegalUrlKey[];
+    /** Ordered checkbox and clickwrap-notice content. */
+    items: ConsentItem[];
+}
+export declare function resolveConsentContent(content: ConsentContent, urls: LegalUrls): ReactNode;
+/**
+ * lead-tcpa v1 — WordPress Main Investors Kit TCPA pattern.
+ * Copy is pending legal review; treat as versioned package content.
+ * Document URLs come from the host (`legalUrls` / WC attributes).
+ */
+export declare const LEAD_TCPA_V1: ConsentDefinition;
+/**
+ * Clickwrap notice found on WordPress lead forms. It has no checkbox value;
+ * submitting the form is the acknowledgment.
+ */
+export declare const LEAD_CLICKWRAP_V1: ConsentDefinition;
+export declare const CONSENT_DEFINITIONS: Record<string, ConsentDefinition>;
+export declare function getConsentDefinition(definitionId: string, definitionVersion: string): ConsentDefinition | undefined;
+//# sourceMappingURL=consents.d.ts.map

package/dist/src/definitions/consents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consents.d.ts","sourceRoot":"","sources":["../../../src/definitions/consents.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE/D,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,cAAc,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,cAAc,CAAA;CAC1B;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,SAAS,CAAC,CAAA;AACzE,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,aAAa,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,iBAAiB,EAAE,WAAW,EAAE,CAAA;IAChC,qDAAqD;IACrD,KAAK,EAAE,WAAW,EAAE,CAAA;CACvB;AAED,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,SAAS,GAChB,SAAS,CAEX;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,iBAkC1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBAwD/B,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAKjE,CAAA;AAED,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,GAC1B,iBAAiB,GAAG,SAAS,CAE/B"}

package/dist/src/definitions/fields.d.ts

@@ -0,0 +1,19 @@
+export type FieldControl = 'text' | 'email' | 'tel';
+export type FieldName = 'firstname' | 'lastname' | 'email' | 'phone';
+export interface FieldDefinition {
+    name: FieldName;
+    control: FieldControl;
+    label: string;
+    autoComplete?: string;
+    /** Returns true or an error message. */
+    validate: (value: string, required: boolean) => true | string;
+    /** Canonical value for the submission payload after validation. */
+    serialize?: (value: string) => string;
+}
+export declare function toNanpDigits(value: string): string | null;
+/** Magento signup strips punctuation but keeps a leading `1` when present. */
+export declare function serializeNanpPhone(value: string): string;
+export declare const FIELD_REGISTRY: Record<FieldName, FieldDefinition>;
+export declare function getFieldDefinition(name: string): FieldDefinition | undefined;
+export declare function isFieldName(name: string): name is FieldName;
+//# sourceMappingURL=fields.d.ts.map

package/dist/src/definitions/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/definitions/fields.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAA;AAEnD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAA;AAEpE,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,YAAY,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wCAAwC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,CAAA;IAC7D,mEAAmE;IACnE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CACxC;AAkBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASzD;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASxD;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,eAAe,CA0C7D,CAAA;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAE3D"}

package/dist/src/definitions/index.d.ts

@@ -0,0 +1,7 @@
+export type { FormsManifest, FormDefinition, FormEditorMeta, FormKind, FormFlow, FormFieldRef, FormFieldGroup, FormConsentDefinition } from './types';
+export type { FieldName, FieldDefinition, FieldControl } from './fields';
+export { formsManifest, getFormDefinition, listFormDefinitions } from './manifest';
+export { FIELD_REGISTRY, getFieldDefinition, isFieldName, toNanpDigits, serializeNanpPhone } from './fields';
+export { LEAD_TCPA_V1, LEAD_CLICKWRAP_V1, CONSENT_DEFINITIONS, getConsentDefinition, resolveConsentContent } from './consents';
+export type { ConsentDefinition, ConsentContent, ConsentItem, ConsentCheckbox, ConsentNotice } from './consents';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/definitions/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,aAAa,EACb,cAAc,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,qBAAqB,EACxB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACxE,OAAO,EACH,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EACH,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,kBAAkB,EACrB,MAAM,UAAU,CAAA;AACjB,OAAO,EACH,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACxB,MAAM,YAAY,CAAA;AACnB,YAAY,EACR,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,eAAe,EACf,aAAa,EAChB,MAAM,YAAY,CAAA"}

package/dist/src/definitions/manifest.d.ts

@@ -0,0 +1,8 @@
+import { FormDefinition, FormsManifest } from './types';
+export declare const formsManifest: FormsManifest;
+export declare function getFormDefinition(formId: string): FormDefinition | undefined;
+export declare function listFormDefinitions(): Array<{
+    formId: string;
+    definition: FormDefinition;
+}>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/src/definitions/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/definitions/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5D,eAAO,MAAM,aAAa,EAAmB,aAAa,CAAA;AAE1D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE5E;AAED,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,cAAc,CAAA;CAC7B,CAAC,CAKD"}

package/dist/src/definitions/types.d.ts

@@ -0,0 +1,77 @@
+export type TrackingCollection = 'browser' | 'host-adapter' | 'server';
+export interface TrackingRegistryEntry {
+    destination: string;
+    category: string;
+    collection: TrackingCollection;
+    required: boolean;
+    states: Array<'collected' | 'unavailable' | 'consent-withheld'>;
+    description?: string;
+}
+export interface FormEditorMeta {
+    label: string;
+    description: string;
+    whenToUse: string;
+    whenNotToUse: string;
+    supportedAppearances: Array<'light' | 'navy'>;
+    supportedVariants: Array<'dense' | 'large' | 'sidebar' | 'two-column'>;
+}
+export interface FormConsentDefinition {
+    definitionId: string;
+    definitionVersion: string;
+    required: boolean;
+    submitFields: string[];
+}
+export type FormKind = 'lead' | 'newsletter';
+export type FormFieldGroup = 'name';
+export interface FormFieldRef {
+    name: string;
+    required: boolean;
+    group?: FormFieldGroup;
+}
+export type FormFlow = {
+    type: 'single';
+} | {
+    type: 'steps';
+    steps: Array<{
+        id: string;
+        fields: string[];
+        continueLabel?: string;
+    }>;
+};
+/**
+ * Package-owned recipe for one predefined form (`forms[formId]` in the
+ * manifest). Hosts pass `formId` only — they do not supply fields.
+ * See `context.md` in this directory.
+ */
+export interface FormDefinition {
+    /** Version of this form’s recipe; bump when fields/consent/tracking change. */
+    definitionVersion: string;
+    /** Behavior family (`lead`, `newsletter`). Not the catalog form id. */
+    kind: FormKind;
+    flow: FormFlow;
+    supportedHosts: Array<'pwa' | 'wordpress'>;
+    fields: FormFieldRef[];
+    trackingFields: string[];
+    consent?: FormConsentDefinition;
+    editor: FormEditorMeta;
+}
+export interface FormsManifest {
+    schemaVersion: string;
+    package: {
+        name: string;
+        compatiblePackageVersions: string;
+    };
+    submissionContract: {
+        version: string;
+        transport: 'server-proxy';
+        payloadShape: 'data-and-context';
+    };
+    trackingRegistry: Record<string, TrackingRegistryEntry>;
+    forms: Record<string, FormDefinition>;
+    hostAdapterContract: {
+        hosts: Array<'pwa' | 'wordpress'>;
+        mayProvide: string[];
+        mustNotDefine: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/definitions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/definitions/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAA;AAEtE,MAAM,WAAW,qBAAqB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,kBAAkB,CAAA;IAC9B,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,KAAK,CAAC,WAAW,GAAG,aAAa,GAAG,kBAAkB,CAAC,CAAA;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAA;IAC7C,iBAAiB,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC,CAAA;CACzE;AAED,MAAM,WAAW,qBAAqB;IAClC,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAA;AAE5C,MAAM,MAAM,cAAc,GAAG,MAAM,CAAA;AAEnC,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,cAAc,CAAA;CACzB;AAED,MAAM,MAAM,QAAQ,GACd;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IACI,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,KAAK,CAAC;QACT,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,EAAE,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;KACzB,CAAC,CAAA;CACL,CAAA;AAEP;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,CAAA;IACzB,uEAAuE;IACvE,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,QAAQ,CAAA;IACd,cAAc,EAAE,KAAK,CAAC,KAAK,GAAG,WAAW,CAAC,CAAA;IAC1C,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,OAAO,CAAC,EAAE,qBAAqB,CAAA;IAC/B,MAAM,EAAE,cAAc,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE;QACL,IAAI,EAAE,MAAM,CAAA;QACZ,yBAAyB,EAAE,MAAM,CAAA;KACpC,CAAA;IACD,kBAAkB,EAAE;QAChB,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,cAAc,CAAA;QACzB,YAAY,EAAE,kBAAkB,CAAA;KACnC,CAAA;IACD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IACvD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACrC,mBAAmB,EAAE;QACjB,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,WAAW,CAAC,CAAA;QACjC,UAAU,EAAE,MAAM,EAAE,CAAA;QACpB,aAAa,EAAE,MAAM,EAAE,CAAA;KAC1B,CAAA;CACJ"}

package/dist/src/form/FormShell.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { FormAppearance } from '../contract/types';
+export declare function FormShell({ className, appearance, variantValue, kind, children }: {
+    className?: string;
+    appearance: FormAppearance;
+    variantValue: string;
+    kind?: string;
+    children: React.ReactNode;
+}): React.ReactElement;
+//# sourceMappingURL=FormShell.d.ts.map

package/dist/src/form/FormShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormShell.d.ts","sourceRoot":"","sources":["../../../src/form/FormShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,wBAAgB,SAAS,CAAC,EACtB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,IAAI,EACJ,QAAQ,EACX,EAAE;IACC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,cAAc,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B,GAAG,KAAK,CAAC,YAAY,CAWrB"}

package/dist/src/form/RegisteredTextField.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+import { FormFieldRef } from '../definitions/types';
+import { FormValues } from './useUsgbFormSession';
+import { FieldErrors, UseFormRegister } from 'react-hook-form';
+export declare function RegisteredTextField({ fieldRef, fieldIds, register, errors, hideLabel, placeholderCase, showError }: {
+    fieldRef: FormFieldRef;
+    fieldIds: Record<string, string>;
+    register: UseFormRegister<FormValues>;
+    errors: FieldErrors<FormValues>;
+    hideLabel: boolean;
+    placeholderCase: 'upper' | 'title';
+    showError?: boolean;
+}): React.ReactElement | null;
+//# sourceMappingURL=RegisteredTextField.d.ts.map

package/dist/src/form/RegisteredTextField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegisteredTextField.d.ts","sourceRoot":"","sources":["../../../src/form/RegisteredTextField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEnE,wBAAgB,mBAAmB,CAAC,EAChC,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,SAAS,EACT,eAAe,EACf,SAAgB,EACnB,EAAE;IACC,QAAQ,EAAE,YAAY,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;IACrC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,CAAA;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,EAAE,OAAO,GAAG,OAAO,CAAA;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA4B5B"}

package/dist/src/form/UsgbForm.d.ts

@@ -0,0 +1,25 @@
+import { default as React } from 'react';
+import { FormAnalytics, FormAppearance, FormVariant, HostAdapter, LegalUrls, SubmissionPayload } from '../contract/types';
+export interface UsgbFormProps {
+    formId: string;
+    appearance?: FormAppearance;
+    variants?: FormVariant[];
+    heading?: string;
+    body?: string;
+    ctaLabel?: string;
+    source?: string;
+    campaign?: string;
+    /** Required legal-document hrefs are declared by the consent definition. */
+    legalUrls?: LegalUrls;
+    /** Host thank-you copy. Used when `successUrl` is omitted. */
+    successMessage?: string;
+    /** Host thank-you page. After accept, analytics and onAccepted are invoked, then navigate. */
+    successUrl?: string;
+    adapter: HostAdapter;
+    analytics?: FormAnalytics;
+    className?: string;
+    onAccepted?: (payload: SubmissionPayload) => void;
+    onFailed?: (payload: SubmissionPayload, message?: string) => void;
+}
+export declare function UsgbForm({ formId, appearance, variants, heading, body, ctaLabel, source, campaign, legalUrls, successMessage, successUrl, adapter, analytics, className, onAccepted, onFailed }: Readonly<UsgbFormProps>): React.ReactElement;
+//# sourceMappingURL=UsgbForm.d.ts.map

package/dist/src/form/UsgbForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsgbForm.d.ts","sourceRoot":"","sources":["../../../src/form/UsgbForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACzB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,0BAA0B,CAAA;AAEjC,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,WAAW,CAAA;IACpB,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACjD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACpE;AAmID,wBAAgB,QAAQ,CAAC,EACrB,MAAM,EACN,UAAoB,EACpB,QAAoB,EACpB,OAAO,EACP,IAAI,EACJ,QAA8B,EAC9B,MAAM,EACN,QAAQ,EACR,SAAS,EACT,cAAc,EACd,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACX,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,YAAY,CA2G9C"}

package/dist/src/form/chunkFields.d.ts

@@ -0,0 +1,17 @@
+import { FormFieldRef } from '../definitions/types';
+export type FieldChunk = {
+    type: 'group';
+    group: string;
+    fields: FormFieldRef[];
+} | {
+    type: 'field';
+    field: FormFieldRef;
+};
+/**
+ * Collapse adjacent fields that share the same `group` into one chunk so the
+ * renderer can wrap them in `.usgb-form-grid` (e.g. firstname + lastname for
+ * `two-column`). Ungrouped fields stay as single-field chunks. Only consecutive
+ * matching groups merge — a gap in the array starts a new group.
+ */
+export declare function chunkFields(fields: FormFieldRef[]): FieldChunk[];
+//# sourceMappingURL=chunkFields.d.ts.map

package/dist/src/form/chunkFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkFields.d.ts","sourceRoot":"","sources":["../../../src/form/chunkFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,MAAM,MAAM,UAAU,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAA;AAE5C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,CAmBhE"}

package/dist/src/form/kinds/LeadKindForm.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { KindFormProps } from './types';
+export declare function LeadKindForm({ definition, variants, ctaLabel, legalUrls, session }: Readonly<KindFormProps>): React.ReactElement;
+//# sourceMappingURL=LeadKindForm.d.ts.map

package/dist/src/form/kinds/LeadKindForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeadKindForm.d.ts","sourceRoot":"","sources":["../../../../src/form/kinds/LeadKindForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAA;AAOtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,wBAAgB,YAAY,CAAC,EACzB,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACV,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,YAAY,CA0G9C"}

package/dist/src/form/kinds/NewsletterKindForm.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { KindFormProps } from './types';
+export declare function NewsletterKindForm({ definition, ctaLabel, session }: Readonly<KindFormProps>): React.ReactElement;
+//# sourceMappingURL=NewsletterKindForm.d.ts.map

package/dist/src/form/kinds/NewsletterKindForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NewsletterKindForm.d.ts","sourceRoot":"","sources":["../../../../src/form/kinds/NewsletterKindForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,wBAAgB,kBAAkB,CAAC,EAC/B,UAAU,EACV,QAAQ,EACR,OAAO,EACV,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,YAAY,CAiD9C"}

package/dist/src/form/kinds/index.d.ts

@@ -0,0 +1,6 @@
+import { ComponentType } from 'react';
+import { FormKind } from '../../definitions/types';
+import { KindFormProps } from './types';
+export type { KindFormProps } from './types';
+export declare const KIND_RENDERERS: Record<FormKind, ComponentType<KindFormProps>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/form/kinds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/form/kinds/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAGzE,CAAA"}

package/dist/src/form/kinds/types.d.ts

@@ -0,0 +1,11 @@
+import { FormDefinition } from '../../definitions/types';
+import { FormVariant, LegalUrls } from '../../contract/types';
+import { UsgbFormSession } from '../useUsgbFormSession';
+export interface KindFormProps {
+    definition: FormDefinition;
+    variants: FormVariant[];
+    ctaLabel: string;
+    legalUrls?: LegalUrls;
+    session: UsgbFormSession;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/form/kinds/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/form/kinds/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,cAAc,CAAA;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,OAAO,EAAE,eAAe,CAAA;CAC3B"}

package/dist/src/form/useUsgbFormSession.d.ts

@@ -0,0 +1,41 @@
+import { BaseSyntheticEvent } from 'react';
+import { FieldErrors, UseFormRegister } from 'react-hook-form';
+import { ConsentCheckbox, ConsentDefinition } from '../definitions/consents';
+import { FormDefinition } from '../definitions/types';
+import { FormAnalytics, HostAdapter, SubmissionPayload } from '../contract/types';
+export type FormValues = Record<string, string | boolean>;
+export type SubmitUiState = {
+    kind: 'idle';
+} | {
+    kind: 'submitting';
+} | {
+    kind: 'accepted';
+} | {
+    kind: 'failed';
+    message?: string;
+};
+declare function trimmedOrUndefined(value?: string): string | undefined;
+export interface UseUsgbFormSessionArgs {
+    formId: string;
+    definition: FormDefinition;
+    variantValue: string;
+    source?: string;
+    campaign?: string;
+    successUrl?: string;
+    adapter: HostAdapter;
+    analytics?: FormAnalytics;
+    onAccepted?: (payload: SubmissionPayload) => void;
+    onFailed?: (payload: SubmissionPayload, message?: string) => void;
+}
+export interface UsgbFormSession {
+    register: UseFormRegister<FormValues>;
+    errors: FieldErrors<FormValues>;
+    fieldIds: Record<string, string>;
+    consentDef: ConsentDefinition | undefined;
+    consentCheckboxes: ConsentCheckbox[];
+    uiState: SubmitUiState;
+    onSubmit: (event?: BaseSyntheticEvent) => Promise<void>;
+}
+export declare function useUsgbFormSession({ formId, definition, variantValue, source, campaign, successUrl, adapter, analytics, onAccepted, onFailed }: UseUsgbFormSessionArgs): UsgbFormSession;
+export { trimmedOrUndefined };
+//# sourceMappingURL=useUsgbFormSession.d.ts.map

package/dist/src/form/useUsgbFormSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUsgbFormSession.d.ts","sourceRoot":"","sources":["../../../src/form/useUsgbFormSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAA;AAC/C,OAAO,EAEH,KAAK,WAAW,EAChB,KAAK,eAAe,EACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAEH,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACzB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,sBAAsB,CAAA;AAKxE,OAAO,KAAK,EACR,aAAa,EACb,WAAW,EACX,iBAAiB,EAEpB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;AAEzD,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAgB1C,iBAAS,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,cAAc,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,WAAW,CAAA;IACpB,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACjD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACpE;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;IACrC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAAA;IACzC,iBAAiB,EAAE,eAAe,EAAE,CAAA;IACpC,OAAO,EAAE,aAAa,CAAA;IACtB,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1D;AAED,wBAAgB,kBAAkB,CAAC,EAC/B,MAAM,EACN,UAAU,EACV,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,UAAU,EACV,OAAO,EACP,SAAS,EACT,UAAU,EACV,QAAQ,EACX,EAAE,sBAAsB,GAAG,eAAe,CAuK1C;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/src/index.d.ts

@@ -0,0 +1,14 @@
+export { UsgbForm } from './form/UsgbForm';
+export type { UsgbFormProps } from './form/UsgbForm';
+export { FieldLabel } from './ui/FieldLabel';
+export { FieldError } from './ui/FieldError';
+export { Button } from './ui/Button';
+export { TextField } from './ui/TextField';
+export { ConsentField } from './ui/ConsentField';
+export { createStubAdapter } from './contract/createStubAdapter';
+export { collectTrackingContext, createIdempotencyKey } from './contract/collectContext';
+export type { HostId, HostAdapter, LegalUrlKey, LegalUrls, SubmissionPayload, SubmitResult, TrackingKey, TrackingValue, TrackingStatus, ConsentPayload, FieldOption, AddressValidationResult, FormAppearance, FormVariant, FormAnalytics, FormAnalyticsEvent } from './contract/types';
+export { isCompleteLegalUrls, PWA_LEGAL_URLS } from './contract/types';
+export { formsManifest, getFormDefinition, listFormDefinitions, getConsentDefinition, resolveConsentContent, LEAD_TCPA_V1, LEAD_CLICKWRAP_V1, FIELD_REGISTRY, getFieldDefinition } from './definitions';
+export type { FormsManifest, FormDefinition, FormEditorMeta, FormKind, FormFlow, FormFieldRef, FieldName, FieldDefinition, ConsentDefinition, ConsentContent, ConsentItem, ConsentCheckbox, ConsentNotice } from './definitions';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EACH,sBAAsB,EACtB,oBAAoB,EACvB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACR,MAAM,EACN,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,cAAc,EACd,WAAW,EACX,aAAa,EACb,kBAAkB,EACrB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtE,OAAO,EACH,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACrB,MAAM,eAAe,CAAA;AACtB,YAAY,EACR,aAAa,EACb,cAAc,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,eAAe,EACf,aAAa,EAChB,MAAM,eAAe,CAAA"}

package/dist/src/ui/Button.d.ts

@@ -0,0 +1,7 @@
+import { default as React, ButtonHTMLAttributes } from 'react';
+export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: 'primary';
+    loading?: boolean;
+}
+export declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=Button.d.ts.map

package/dist/src/ui/Button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/ui/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAc,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAG/D,MAAM,WAAW,WAAY,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IACxE,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,eAAO,MAAM,MAAM,uFA6BlB,CAAA"}

package/dist/src/ui/ConsentField.d.ts

@@ -0,0 +1,9 @@
+import { default as React, InputHTMLAttributes } from 'react';
+export interface ConsentFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> {
+    id: string;
+    label: React.ReactNode;
+    errorMessage?: string;
+    required?: boolean;
+}
+export declare const ConsentField: React.ForwardRefExoticComponent<ConsentFieldProps & React.RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=ConsentField.d.ts.map

package/dist/src/ui/ConsentField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsentField.d.ts","sourceRoot":"","sources":["../../../src/ui/ConsentField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAc,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAK9D,MAAM,WAAW,iBACb,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC3D,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,eAAO,MAAM,YAAY,4FA+BxB,CAAA"}

package/dist/src/ui/FieldError.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+export interface FieldErrorProps {
+    id?: string;
+    message?: string | React.ReactNode;
+    className?: string;
+}
+export declare function FieldError({ id, message, className }: Readonly<FieldErrorProps>): React.ReactElement | null;
+//# sourceMappingURL=FieldError.d.ts.map

package/dist/src/ui/FieldError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldError.d.ts","sourceRoot":"","sources":["../../../src/ui/FieldError.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,MAAM,WAAW,eAAe;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,UAAU,CAAC,EACvB,EAAE,EACF,OAAO,EACP,SAAS,EACZ,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAavD"}

package/dist/src/ui/FieldLabel.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+export interface FieldLabelProps {
+    htmlFor: string;
+    children: React.ReactNode;
+    className?: string;
+    required?: boolean;
+}
+export declare function FieldLabel({ htmlFor, children, className, required }: Readonly<FieldLabelProps>): React.ReactElement;
+//# sourceMappingURL=FieldLabel.d.ts.map

package/dist/src/ui/FieldLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldLabel.d.ts","sourceRoot":"","sources":["../../../src/ui/FieldLabel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,UAAU,CAAC,EACvB,OAAO,EACP,QAAQ,EACR,SAAS,EACT,QAAQ,EACX,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,YAAY,CAWhD"}

package/dist/src/ui/TextField.d.ts

@@ -0,0 +1,19 @@
+import { default as React, InputHTMLAttributes } from 'react';
+export interface TextFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> {
+    id: string;
+    label: string;
+    type?: 'text' | 'email' | 'tel';
+    errorMessage?: string;
+    required?: boolean;
+    /** When true, hide the visible label and use placeholder (+ * if required). */
+    hideLabel?: boolean;
+    /**
+     * Placeholder casing when `hideLabel` is set.
+     * Dense uses uppercase; sidebar matches live HubSpot title case.
+     */
+    placeholderCase?: 'upper' | 'title';
+    /** When false, omit the inline error (caller renders it elsewhere). */
+    showError?: boolean;
+}
+export declare const TextField: React.ForwardRefExoticComponent<TextFieldProps & React.RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=TextField.d.ts.map

package/dist/src/ui/TextField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextField.d.ts","sourceRoot":"","sources":["../../../src/ui/TextField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAc,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAS9D,MAAM,WAAW,cACb,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC3D,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAA;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IACnC,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,eAAO,MAAM,SAAS,yFA4DrB,CAAA"}

package/dist/src/ui/icons.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+export declare function FieldErrorIcon(): React.ReactElement;
+export declare function CheckboxMarkIcon(): React.ReactElement;
+//# sourceMappingURL=icons.d.ts.map

package/dist/src/ui/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../src/ui/icons.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,wBAAgB,cAAc,IAAI,KAAK,CAAC,YAAY,CAwBnD;AAED,wBAAgB,gBAAgB,IAAI,KAAK,CAAC,YAAY,CAqBrD"}