@parag.more.withsurface.com/forms-sdk 0.1.4

package/dist/types/core/events/pushEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushEvents.d.ts","sourceRoot":"","sources":["../../../../src/core/events/pushEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,yBAAyB,GACzB,6BAA6B,GAC7B,2BAA2B,GAC3B,kBAAkB,CAAC;AAEvB,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,sBAAsB,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE;QACN,gBAAgB,GAAG;YAAE,IAAI,EAAE,qBAAqB,CAAC;YAAC,UAAU,EAAE,WAAW,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE;QAC3F,gBAAgB,GAAG;YAAE,IAAI,EAAE,kBAAkB,CAAC;YAAC,UAAU,EAAE,WAAW,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE;KACzF,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAgBjE,eAAO,MAAM,6BAA6B,0EAMvC;IACD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,KAAG,cAmBF,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,qBAAqB,4BAG/B;IACD,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAG,eAWF,CAAC"}

package/dist/types/core/events/pushEvents.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pushEvents.test.d.ts.map

package/dist/types/core/events/pushEvents.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushEvents.test.d.ts","sourceRoot":"","sources":["../../../../src/core/events/pushEvents.test.ts"],"names":[],"mappings":""}

package/dist/types/core/events/startedDetection.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `form_started` detection (forms-sdk-plan.md row 22): native fires it on the
+ * first deep-inequality between the current answer state and the snapshot
+ * taken at mount, once per form instance (`DualPaneAdjustableForm`'s
+ * `startedForm` ref + lodash `isEqual`). The detector captures the snapshot at
+ * creation; `check(current)` returns true exactly once, on the first
+ * divergence. The local deep-equal covers the answer-state shape (plain
+ * objects, arrays, primitives) — key order insensitive, like lodash.
+ */
+export declare const createStartedDetector: <T>(initial: T) => ((current: T) => boolean);
+//# sourceMappingURL=startedDetection.d.ts.map

package/dist/types/core/events/startedDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startedDetection.d.ts","sourceRoot":"","sources":["../../../../src/core/events/startedDetection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,WAAW,CAAC,KAAG,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAS7E,CAAC"}

package/dist/types/core/events/startedDetection.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=startedDetection.test.d.ts.map

package/dist/types/core/events/startedDetection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startedDetection.test.d.ts","sourceRoot":"","sources":["../../../../src/core/events/startedDetection.test.ts"],"names":[],"mappings":""}

package/dist/types/core/events/viewDetection.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `form_viewed` detection (forms-sdk-plan.md row 21): an IntersectionObserver
+ * on the bound form root, firing the callback exactly once per observer —
+ * form-render's `useDetectFormView` semantics with its React scaffolding
+ * removed. The once-guard replaces native's belt-and-braces 1 s throttle:
+ * with a single fire per instance there is nothing left to throttle. The
+ * caller (bind layer / engine) emits `form_viewed` + first-step
+ * `form_step_viewed`, exactly what native's throttled callback did.
+ *
+ * If `IntersectionObserver` is unavailable the callback fires immediately —
+ * losing view analytics entirely is worse than counting a below-fold mount,
+ * and native never handled this case (it would throw).
+ */
+export declare const observeFormView: (element: Element, onViewed: () => void) => (() => void);
+//# sourceMappingURL=viewDetection.d.ts.map

package/dist/types/core/events/viewDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewDetection.d.ts","sourceRoot":"","sources":["../../../../src/core/events/viewDetection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,YAAa,OAAO,YAAY,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAgBnF,CAAC"}

package/dist/types/core/events/viewDetection.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=viewDetection.test.d.ts.map

package/dist/types/core/events/viewDetection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewDetection.test.d.ts","sourceRoot":"","sources":["../../../../src/core/events/viewDetection.test.ts"],"names":[],"mappings":""}

package/dist/types/core/identity/browserFingerprint.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Canonical browser-fingerprint implementation for Surface lead identity.
+ *
+ * The lead-identity pipeline keys on the SHA-256 of `JSON.stringify` over the
+ * collected fields, so the object's insertion order, value shapes, and falsy
+ * fallbacks (`||`, not `??`) ARE the wire contract: any deviation produces a
+ * different hash and splits one visitor into two leads. Do not reorder fields,
+ * rename keys, or change fallback behavior here without a coordinated
+ * migration.
+ *
+ * This module supersedes the two byte-identical copies it was lifted from —
+ * `packages/form-render/src/lib/client/leads/browserFingerprint.ts` and the
+ * public tag's `src/lead/fingerprint.ts` (trysurface/scripts) — which consume
+ * it over time (forms-sdk-plan.md, parity row 9). The identity test in this
+ * directory pins hash equality against the form-render copy.
+ */
+export type Fingerprint = {
+    deviceType: "Mobile" | "Desktop";
+    screen: {
+        width: number;
+        height: number;
+        colorDepth: number;
+    };
+    userAgent: string;
+    browser: Array<{
+        brand: string;
+        version: string;
+    }>;
+    os: string;
+    language: string;
+    /** Absent (never null/empty) when `navigator.plugins` is null. */
+    plugins?: string[];
+    timezone: string;
+    environmentId: string;
+    /** SHA-256 hex of the serialized fields above. */
+    id: string;
+};
+export declare function getHash(input: string): Promise<string>;
+export declare const getBrowserFingerprint: (environmentId: string) => Promise<Fingerprint>;
+//# sourceMappingURL=browserFingerprint.d.ts.map

package/dist/types/core/identity/browserFingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserFingerprint.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/browserFingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,wBAAsB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5D;AAED,eAAO,MAAM,qBAAqB,kBAAyB,MAAM,KAAG,OAAO,CAAC,WAAW,CAwBtF,CAAC"}

package/dist/types/core/identity/browserFingerprint.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browserFingerprint.test.d.ts.map

package/dist/types/core/identity/browserFingerprint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserFingerprint.test.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/browserFingerprint.test.ts"],"names":[],"mappings":""}

package/dist/types/core/identity/ensureIdentified.d.ts

@@ -0,0 +1,27 @@
+import type { Transport } from "../client/transport";
+import { type LeadSource } from "./identify";
+import { type CachedLeadData } from "./leadDataCache";
+/**
+ * The boot-sequence identity step (forms-sdk-plan.md §2.2): resolve the
+ * visitor before any response write, since attribute sync silently no-ops for
+ * responses whose lead was never identified (row 60). Mirrors the tag's
+ * `identifyLead` flow: a fresh cache entry with a session and fingerprint
+ * skips the network entirely; otherwise compute the fingerprint, carry any
+ * cached leadId/session forward so the server can preserve identity, and
+ * cache the result under the shared tag key.
+ *
+ * `preview: true` blocks the identify call outright — the preview contract
+ * (§2.2) is that drafts never create leads. Concurrent calls (multi-form
+ * pages) may race one identify each; that is safe — the server find-or-creates
+ * by fingerprint, so both resolve to the same lead — and avoids the tag's
+ * module-level in-flight flag, which the SDK's instance-scoped rule forbids.
+ */
+export declare const ensureIdentified: ({ transport, environmentId, formId, pageUrl, source, preview, }: {
+    transport: Transport;
+    environmentId: string;
+    formId?: string;
+    pageUrl?: string;
+    source?: LeadSource;
+    preview?: boolean;
+}) => Promise<CachedLeadData | null>;
+//# sourceMappingURL=ensureIdentified.d.ts.map

package/dist/types/core/identity/ensureIdentified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureIdentified.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/ensureIdentified.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEnF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,oEAO1B;IACD,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAiChC,CAAC"}

package/dist/types/core/identity/ensureIdentified.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ensureIdentified.test.d.ts.map

package/dist/types/core/identity/ensureIdentified.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureIdentified.test.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/ensureIdentified.test.ts"],"names":[],"mappings":""}

package/dist/types/core/identity/identify.contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identify.contract.test.d.ts.map

package/dist/types/core/identity/identify.contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify.contract.test.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/identify.contract.test.ts"],"names":[],"mappings":""}

package/dist/types/core/identity/identify.d.ts

@@ -0,0 +1,48 @@
+import type { Transport } from "../client/transport";
+/**
+ * Wrapper for `POST /api/v1/lead/identify` (forms-sdk-plan.md row 10),
+ * mirroring form-render's `identifyLeadForFormRequest`: same payload fields,
+ * same URL normalization (trailing slashes stripped from href and pathname),
+ * same keepalive delivery, same `data.data` response unwrap, null on any
+ * failure. The wire types are structural mirrors of `ZLeadIdentifyPayload`
+ * (`@surface/types/v1/lead/app/types.ts`) — local because the SDK ships with
+ * zero runtime dependencies; the contract test validates them against the
+ * real schema.
+ *
+ * `source` defaults to `"sdkForm"` — the dedicated SDK value (Decisions #8),
+ * so SDK-originated leads stay distinguishable from the native runtime's
+ * `"surfaceForm"` in the leads hub and analytics.
+ */
+export type LeadSource = "surfaceForm" | "htmlForm" | "websiteDeAnon" | "webhook" | "website" | "imported" | "scheduler" | "linkedin" | "sdkForm";
+export type IdentifyPayload = {
+    environmentId: string;
+    source: LeadSource;
+    sourceURL: string;
+    sourceURLDomain: string;
+    sourceURLPath: string;
+    sourceUrlSearchParams: string;
+    leadId?: string | null;
+    formId?: string;
+    fingerprint?: string;
+    sessionIdFromParams?: string | null;
+    referrer?: string | null;
+};
+export type IdentifyResult = {
+    leadId: string;
+    sessionId: string;
+    existing: boolean;
+    leadHasExistingBookingAttr: boolean;
+    leadHasExistingEmailAttr: boolean;
+};
+export declare const buildIdentifyPayload: ({ environmentId, fingerprintId, pageUrl, source, formId, leadId, sessionIdFromParams, referrer, }: {
+    environmentId: string;
+    fingerprintId: string;
+    pageUrl: string;
+    source?: LeadSource;
+    formId?: string;
+    leadId?: string | null;
+    sessionIdFromParams?: string | null;
+    referrer?: string | null;
+}) => IdentifyPayload;
+export declare const identifyLead: (transport: Transport, payload: IdentifyPayload) => Promise<IdentifyResult | null>;
+//# sourceMappingURL=identify.d.ts.map

package/dist/types/core/identity/identify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/identify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,UAAU,GACV,eAAe,GACf,SAAS,GACT,SAAS,GACT,UAAU,GACV,WAAW,GACX,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,0BAA0B,EAAE,OAAO,CAAC;IACpC,wBAAwB,EAAE,OAAO,CAAC;CACnC,CAAC;AAIF,eAAO,MAAM,oBAAoB,sGAS9B;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,KAAG,eAeH,CAAC;AAIF,eAAO,MAAM,YAAY,cACZ,SAAS,WACX,eAAe,KACvB,OAAO,CAAC,cAAc,GAAG,IAAI,CAe/B,CAAC"}

package/dist/types/core/identity/identify.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identify.test.d.ts.map

package/dist/types/core/identity/identify.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify.test.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/identify.test.ts"],"names":[],"mappings":""}

package/dist/types/core/identity/journey.contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=journey.contract.test.d.ts.map

package/dist/types/core/identity/journey.contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.contract.test.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/journey.contract.test.ts"],"names":[],"mappings":""}

package/dist/types/core/identity/journey.d.ts

@@ -0,0 +1,28 @@
+import type { Transport } from "../client/transport";
+/**
+ * Opt-in user-journey page-view tracking (forms-sdk-plan.md row 16), the
+ * SDK's `journey: true` module. Mirrors the public tag's implementation
+ * (trysurface/scripts `src/store/{user-journey,journey-cookies}.ts`, verified
+ * at HEAD): same cookies (`surface_journey_id`, 60 d, eTLD+1 domain;
+ * `surface_recent_visit`, 1 d), same duplicate-URL skip, same delivery split —
+ * beacon when the journey id is already known (nothing to read back), fetch
+ * when it isn't so the server-issued id can be captured — and the same
+ * history-patching SPA route detection.
+ *
+ * Journey→response stitching stays server-side (UTM backfill on response
+ * create); the client's only job is delivering page views under a stable id.
+ */
+export declare const JOURNEY_COOKIE_NAME = "surface_journey_id";
+export declare const RECENT_VISIT_COOKIE_NAME = "surface_recent_visit";
+export type JourneyTracker = {
+    trackPageView: (url?: string) => Promise<void>;
+    /** Patches history + popstate; returns a teardown restoring the originals. */
+    observeRouteChanges: () => () => void;
+    /** Deletes both journey cookies — the native clear-on-first-step-completion hook. */
+    clear: () => void;
+};
+export declare const createJourneyTracker: ({ transport, environmentId, }: {
+    transport: Transport;
+    environmentId: string;
+}) => JourneyTracker;
+//# sourceMappingURL=journey.d.ts.map

package/dist/types/core/identity/journey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/journey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAqD/D,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,8EAA8E;IAC9E,mBAAmB,EAAE,MAAM,MAAM,IAAI,CAAC;IACtC,qFAAqF;IACrF,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,oBAAoB,kCAG9B;IACD,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,KAAG,cA6FH,CAAC"}

package/dist/types/core/identity/journey.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=journey.test.d.ts.map

package/dist/types/core/identity/journey.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.test.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/journey.test.ts"],"names":[],"mappings":""}

package/dist/types/core/identity/journey.testStubs.d.ts

@@ -0,0 +1,5 @@
+/** Minimal DOM stub for journey tests: cookie jar honoring max-age deletion, location, referrer. */
+export declare const stubJourneyDom: ({ href }?: {
+    href?: string;
+}) => Map<string, string>;
+//# sourceMappingURL=journey.testStubs.d.ts.map

package/dist/types/core/identity/journey.testStubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.testStubs.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/journey.testStubs.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,eAAO,MAAM,cAAc,cAA+C;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,wBAqB1F,CAAC"}

package/dist/types/core/identity/leadDataCache.d.ts

@@ -0,0 +1,27 @@
+/**
+ * TTL-stamped lead-identity cache (forms-sdk-plan.md row 11), byte-compatible
+ * with the public tag's `surfaceLeadData` localStorage entry — same key, same
+ * shape, same 10-minute TTL, same remove-on-expiry read semantics
+ * (trysurface/scripts `src/lead/identify.ts`).
+ *
+ * Sharing the tag's key IS the interop rule (plan §4.1): on a page where the
+ * tag is also installed, the SDK reads the identity the tag already resolved
+ * and skips its own identify — and vice versa — so both agree on the visitor
+ * without any cross-component protocol.
+ *
+ * Every access is guarded: no localStorage (SSR) reads as a cache miss, and
+ * storage exceptions (Safari private mode, quota) are swallowed — cache loss
+ * only costs an extra identify round-trip.
+ */
+export declare const LEAD_DATA_STORAGE_KEY = "surfaceLeadData";
+export declare const LEAD_DATA_TTL_MS: number;
+export type CachedLeadData = {
+    leadId: string | null;
+    leadSessionId: string | null;
+    fingerprint: string;
+    landingPageUrl?: string;
+    expiry?: number;
+};
+export declare const readLeadData: () => CachedLeadData | null;
+export declare const writeLeadData: (data: Omit<CachedLeadData, "expiry">) => void;
+//# sourceMappingURL=leadDataCache.d.ts.map

package/dist/types/core/identity/leadDataCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leadDataCache.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/leadDataCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,gBAAgB,QAAiB,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,YAAY,QAAO,cAAc,GAAG,IAoBhD,CAAC;AAEF,eAAO,MAAM,aAAa,SAAU,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,KAAG,IAUpE,CAAC"}

package/dist/types/core/identity/leadDataCache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=leadDataCache.test.d.ts.map

package/dist/types/core/identity/leadDataCache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leadDataCache.test.d.ts","sourceRoot":"","sources":["../../../../src/core/identity/leadDataCache.test.ts"],"names":[],"mappings":""}

package/dist/types/enrichment/attachEnrichment.d.ts

@@ -0,0 +1,35 @@
+import type { Transport } from "../core/client/transport";
+import type { FormEngine } from "../core/engine/formEngine";
+/**
+ * Real-time identity enrichment for SDK forms (field-run finding 4.10): the
+ * native renderer fires `/api/v1/services/enrichment/realtime` on blur of the
+ * IdentityInfo `enrichmentSourceField` (or `websiteUrl`, or EmailForm's email)
+ * and stores the result as the `selfServeEnrichment` APOLLO_EMAIL_ENRICHMENT
+ * external state — which the response payload forwards as `enrichedFields`
+ * and which drives field autofill. The SDK has no blur moment (headless
+ * callers have no DOM at all), so the trigger is a debounced answer-watch: a
+ * candidate value that is a valid email/domain and has been stable for
+ * `DEBOUNCE_MS` fires once (deduped per value, native semantics); completing
+ * a step flushes the pending debounce so a type-then-advance never loses the
+ * window. The request is never awaited — submission must not block on the
+ * vendor API — so a result can resolve after the finishing write; the engine
+ * persists it anyway by amending the stored response on setExternalState.
+ * Results merge existing-keys-win, exactly like native's G2 rule — a later
+ * trigger only fills gaps.
+ *
+ * The provider key never reaches the page: the endpoint resolves it
+ * server-side and is rate-limited per-IP and per-form.
+ */
+export type EnrichmentSource = {
+    questionId: string;
+    fieldNames: string[];
+};
+export declare const ENRICHMENT_STATE_ID = "selfServeEnrichment";
+export type AttachEnrichmentOptions = {
+    engine: FormEngine;
+    transport: Transport;
+    formId: string;
+    sources: EnrichmentSource[];
+};
+export declare const attachEnrichment: ({ engine, transport, formId, sources, }: AttachEnrichmentOptions) => (() => void);
+//# sourceMappingURL=attachEnrichment.d.ts.map

package/dist/types/enrichment/attachEnrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachEnrichment.d.ts","sourceRoot":"","sources":["../../../src/enrichment/attachEnrichment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAG5E,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAazD,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,4CAK1B,uBAAuB,KAAG,CAAC,MAAM,IAAI,CAsFvC,CAAC"}

package/dist/types/enrichment/attachEnrichment.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=attachEnrichment.test.d.ts.map

package/dist/types/enrichment/attachEnrichment.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachEnrichment.test.d.ts","sourceRoot":"","sources":["../../../src/enrichment/attachEnrichment.test.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,28 @@
+export { bindForm, type BindFormOptions } from "./bind/bindForm";
+export { mountBookingWidget, type BookingWidgetOptions } from "./bind/bookingWidget";
+export { createEmailValidator, type CreateEmailValidatorOptions, type EmailValidationResult, type EmailValidator, } from "./core/client/emailValidation";
+export { submitResponse, updateResponse, type CreateResponseResult } from "./core/client/responses";
+export { enrichmentSourcesOf, fetchRuntimeConfig, hasEnabledEnrichmentProvider, statefulQuestionIdsOf, statefulQuestionsOf, stepsOf, type RuntimeConfig, } from "./core/client/runtimeConfig";
+export { createSchedulerClient, toSchedulerAnswerState, type AvailabilitySummary, type Booking, type BookingAttendee, type SchedulerClient, type TimeSlot, } from "./core/client/scheduler";
+export { DEFAULT_API_BASE_URL, createTransport, type Transport, type TransportError, type TransportResult, } from "./core/client/transport";
+export { IDENTITY_INFO_ANSWER_KEYS, type DisclaimerAnswer, type DropdownAnswer, type EmailFormAnswer, type FileUploaderAnswer, type GraphicOptionsAnswer, type IdentityInfoAnswer, type IdentityInfoAnswerKey, type KnownAnswerState, type LongInputAnswer, type MMChoiceAnswer, type MultipleChoiceAnswer, type MultipleChoiceSingleAnswerAnswer, type MultipleOptionsAnswer, type SchedulerAnswer, type ShortInputAnswer, } from "./core/engine/answerStates";
+export { createFormEngine, type FormEngine, type FormEngineEvents, type FormEngineState, type ResolveNextStep, type ResolvedNextStep, } from "./core/engine/formEngine";
+export { DEFAULT_REDIRECT_TIMEOUT_MS, buildRedirectUrl, performRedirect, type RedirectType, } from "./core/engine/redirect";
+export { buildResponsesArray, createSubmitResponsePayload, createUpdateResponsePayload, type AnswerStates, type ExternalStates, type FormResponsePayload, type FormUpdateResponsePayload, type SingleFormResponse, } from "./core/engine/responsePayload";
+export { buildUrlData, constructUrlParamsObject, parseCookiesObject, type UrlData, } from "./core/engine/urlData";
+export { parsePrefillParams, parseQuestionId, type ParsedUrlQuestionId } from "./core/engine/urlPrefill";
+export { observeDropoff } from "./core/events/dropoffDetection";
+export { createEmitter, type Emitter, type Unsubscribe } from "./core/events/emitter";
+export { createFormJourneyTracker, type FormJourneyOutcome, type FormJourneyTrackPayload, type FormJourneyTracker, type FormJourneyTransitionReason, type FormJourneyVisit, } from "./core/events/formJourneyTracker";
+export { buildStepTransitionEventBatch, createPushEventClient, type PushEventBatch, type PushEventClient, type PushEventPayload, type PushEventProperty, type PushEventRequest, type SurfaceEventEntityType, type SurfaceEventType, } from "./core/events/pushEvents";
+export { createStartedDetector } from "./core/events/startedDetection";
+export { observeFormView } from "./core/events/viewDetection";
+export { getBrowserFingerprint, getHash, type Fingerprint } from "./core/identity/browserFingerprint";
+export { ensureIdentified } from "./core/identity/ensureIdentified";
+export { buildIdentifyPayload, identifyLead, type IdentifyPayload, type IdentifyResult, type LeadSource, } from "./core/identity/identify";
+export { JOURNEY_COOKIE_NAME, RECENT_VISIT_COOKIE_NAME, createJourneyTracker, type JourneyTracker, } from "./core/identity/journey";
+export { LEAD_DATA_STORAGE_KEY, LEAD_DATA_TTL_MS, readLeadData, writeLeadData, type CachedLeadData, } from "./core/identity/leadDataCache";
+export { ENRICHMENT_STATE_ID, attachEnrichment, type AttachEnrichmentOptions, type EnrichmentSource, } from "./enrichment/attachEnrichment";
+export { SurfaceForms, type SurfaceForm, type SurfaceFormsInitOptions } from "./surfaceForms";
+export { attachEmailValidation, type AttachEmailValidationOptions } from "./validation/attachEmailValidation";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export { useSurfaceForm, type UseSurfaceFormResult } from "./useSurfaceForm";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/react/ssr.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ssr.test.d.ts.map

package/dist/types/react/ssr.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.test.d.ts","sourceRoot":"","sources":["../../../src/react/ssr.test.ts"],"names":[],"mappings":""}

package/dist/types/react/useSurfaceForm.d.ts

@@ -0,0 +1,25 @@
+import type { FormEngine, FormEngineState } from "../core/engine/formEngine";
+/**
+ * React adapter (forms-sdk-plan.md §2.9): a thin `useSyncExternalStore`
+ * subscription over the headless engine's store contract. The host renders
+ * the current step from `state` with controlled inputs; every action is the
+ * engine's own method, so engine semantics are identical to the `bind/` mode
+ * by construction — only who applies visibility differs.
+ *
+ * Server snapshots reuse `engine.state()`: the engine is SSR-safe to create
+ * (no DOM access until interaction), so hydration sees the initial step.
+ */
+export type UseSurfaceFormResult = {
+    state: FormEngineState;
+    setAnswer: FormEngine["setAnswer"];
+    next: FormEngine["next"];
+    back: FormEngine["back"];
+    goToStep: FormEngine["goToStep"];
+    submit: FormEngine["submit"];
+    disqualify: FormEngine["disqualify"];
+    savePartial: FormEngine["savePartial"];
+    markViewed: FormEngine["markViewed"];
+    on: FormEngine["on"];
+};
+export declare const useSurfaceForm: (engine: FormEngine) => UseSurfaceFormResult;
+//# sourceMappingURL=useSurfaceForm.d.ts.map

package/dist/types/react/useSurfaceForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSurfaceForm.d.ts","sourceRoot":"","sources":["../../../src/react/useSurfaceForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE7E;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACnC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IACrC,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;IACvC,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IACrC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,cAAc,WAAY,UAAU,KAAG,oBAcnD,CAAC"}

package/dist/types/react/useSurfaceForm.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useSurfaceForm.test.d.ts.map

package/dist/types/react/useSurfaceForm.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSurfaceForm.test.d.ts","sourceRoot":"","sources":["../../../src/react/useSurfaceForm.test.tsx"],"names":[],"mappings":""}

package/dist/types/surfaceForms.d.ts

@@ -0,0 +1,120 @@
+import { type EmailValidationResult } from "./core/client/emailValidation";
+import { type RuntimeConfig } from "./core/client/runtimeConfig";
+import { type FormEngine, type ResolveNextStep } from "./core/engine/formEngine";
+import type { LeadSource } from "./core/identity/identify";
+import { type TrackingSettings } from "./tracking/attachTracking";
+/**
+ * The public entry point (forms-sdk-plan.md §2.2): composes the boot sequence
+ * in the native, load-bearing order — identify before the first write (row
+ * 60: attribute sync silently no-ops otherwise) — then wires events, journey,
+ * drop-off, and the optional DOM binding around one engine instance.
+ *
+ * **The form definition boots from the runtime-config endpoint** (§2.3,
+ * Decisions #7): when `steps` is omitted, init fetches the published record
+ * and derives the step order, the behavioral settings gates, and the expected
+ * questionIds for the §4.3 drift warning. Caller-provided `steps`/`settings`/
+ * `expectedQuestionIds` still win — offline tests and agents that already
+ * hold the record skip the fetch entirely.
+ *
+ * `preview: true` replicates the native guarantee that previews never pollute
+ * data (§2.2): identify, response writes, pushEvents, form-journey, and the
+ * journey module are all blocked client-side.
+ */
+export type SurfaceFormsInitOptions = {
+    environmentId: string;
+    formId: string;
+    /** Ordered logical steps of the form record; omitted = fetched from runtime-config. */
+    steps?: Array<{
+        id: string;
+        endStepKind?: "thank_you" | "disqualified";
+    }>;
+    /**
+     * Behavioral gates + customer-tag config (rows 51–55). Omitted values fill
+     * from runtime-config ONLY when `steps` is also omitted (the record fetch) —
+     * caller-provided `steps` skip the fetch entirely, so pass tracking settings
+     * explicitly in that offline mode.
+     */
+    settings?: {
+        trackPartialResponses?: boolean;
+        trackCookies?: boolean;
+    } & TrackingSettings;
+    apiBaseUrl?: string;
+    /** Enables the bind/ layer + view detection on this root. */
+    container?: Element;
+    /** Stateful questionIds from the record; unbound ones get the §4.3 runtime warning. */
+    expectedQuestionIds?: string[];
+    /** Routing evaluation; defaults to linear order until the extracted routing module lands. */
+    resolveNextStep?: ResolveNextStep;
+    /** Seeds a URL_DATA external-state entry under this id (attribution, row 56). */
+    urlDataStateId?: string;
+    source?: LeadSource;
+    /** Page-view tracking module (tag parity), default off. */
+    journey?: boolean;
+    /**
+     * Automatic waterfall email validation (row 37), default off: watches
+     * email answers (debounced, per-address verdicts, fail-open) and annotates
+     * the response `meta` with native's `isEmailValid`/`emailValidation`/
+     * `emailValidationFailed` keys. Opt-in because verdicts spend the form
+     * owner's validator quota. The on-demand `validateEmail` on the handle is
+     * always available and shares the same per-address cache.
+     */
+    emailValidation?: boolean;
+    preview?: boolean;
+    /**
+     * Signed token from the create_form / get_sdk_binding_map replies; with
+     * `preview: true` it unlocks the DRAFT config of a never-published form.
+     * Without it, preview serves the published config.
+     */
+    previewToken?: string;
+    /**
+     * Resume a stored response: pass the `responseId` + `resumeToken` pair a
+     * previous session's create returned (`state().resumeToken`, or the `saved`
+     * event). Boot fetches the stored answers through the token-gated read-back
+     * and seeds the engine — writes become updates and earlier answers are
+     * preserved; a failed fetch warns and starts fresh. Ignored in preview.
+     */
+    resume?: {
+        responseId: string;
+        resumeToken: string;
+    };
+    /** Logs every captured answer and warns on states the server would reject (unknown questionId, wrong/missing type, malformed choices). Development aid; never enable in production. */
+    debug?: boolean;
+    meta?: Record<string, unknown>;
+};
+export type SurfaceForm = Pick<FormEngine, "setAnswer" | "setExternalState" | "next" | "back" | "goToStep" | "submit" | "disqualify" | "savePartial" | "flush" | "markViewed" | "on" | "state" | "subscribe"> & {
+    /** Re-runs identify (e.g. after an SPA route change); cache makes it cheap. */
+    identify: () => Promise<unknown>;
+    /**
+     * On-demand waterfall email validation (row 37): resolves a per-address
+     * deliverability verdict, cached for the form's lifetime and fail-open on
+     * validator outage. Use it to gate your own navigation:
+     * `if ((await form.validateEmail(value)).isValid) form.next()`.
+     * In preview it resolves a synthetic valid verdict without network.
+     */
+    validateEmail: (email: string) => Promise<EmailValidationResult>;
+    /**
+     * Records caller-computed values (a qualification score, an A/B bucket, …)
+     * onto the response `meta` — they ride the next save, or amend the stored
+     * response when the form already finished. SDK-owned keys
+     * (`surfaceTagStatus` and the email-validation verdicts) are dropped with a
+     * console warning: dashboards trust those.
+     */
+    mergeMeta: (partial: Record<string, unknown>) => void;
+    /**
+     * What actually runs in THIS environment — the record can declare features
+     * (an enrichment source field) that the environment does not back with a
+     * provider, and nothing else surfaces that.
+     */
+    capabilities: {
+        enrichment: boolean;
+        emailValidation: boolean;
+        tracking: boolean;
+    };
+    /** The fetched published record (labels, component types); undefined when `steps` was caller-provided. */
+    runtimeConfig?: RuntimeConfig;
+    destroy: () => void;
+};
+export declare const SurfaceForms: {
+    init: ({ environmentId, formId, steps, settings, apiBaseUrl, container, expectedQuestionIds, resolveNextStep, urlDataStateId, source, journey, emailValidation, preview, previewToken, debug, resume, meta, }: SurfaceFormsInitOptions) => Promise<SurfaceForm>;
+};
+//# sourceMappingURL=surfaceForms.d.ts.map

package/dist/types/surfaceForms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceForms.d.ts","sourceRoot":"","sources":["../../src/surfaceForms.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEjG,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAMnG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGlF;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,GAAG,cAAc,CAAA;KAAE,CAAC,CAAC;IAC1E;;;;;OAKG;IACH,QAAQ,CAAC,EAAE;QACT,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,gBAAgB,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,6FAA6F;IAC7F,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,uLAAuL;IACvL,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAcF,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B,UAAU,EACR,WAAW,GACX,kBAAkB,GAClB,MAAM,GACN,MAAM,GACN,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,aAAa,GACb,OAAO,GACP,YAAY,GACZ,IAAI,GACJ,OAAO,GACP,WAAW,CACd,GAAG;IACF,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjE;;;;;;OAMG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtD;;;;OAIG;IACH,YAAY,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IACnF,0GAA0G;IAC1G,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,YAAY;IACvB,IAAI,2MAkBD,uBAAuB,KAAG,OAAO,CAAC,WAAW,CAAC;CAuPlD,CAAC"}

package/dist/types/surfaceForms.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=surfaceForms.test.d.ts.map

package/dist/types/surfaceForms.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceForms.test.d.ts","sourceRoot":"","sources":["../../src/surfaceForms.test.ts"],"names":[],"mappings":""}