@businessdash/sdk 0.9.60

package/dist/socials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socials.d.ts","sourceRoot":"","sources":["../src/socials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAC1B,MAAM,GACN,WAAW,GACX,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,WAAW,GACX,SAAS,GACT,SAAS,GACT,UAAU,GACV,aAAa,GACb,gBAAgB,GAChB,MAAM,GACN,UAAU,GACV,MAAM,GACN,aAAa,GACb,OAAO,GACP,WAAW,GACX,KAAK,GACL,UAAU,GACV,SAAS,GACT,UAAU,GACV,QAAQ,GACR,cAAc,GACd,MAAM,GACN,SAAS,GACT,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,UAAU,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,iBAAiB,CAAC;IACvB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EA6EzD,CAAC;AA8BF,iGAAiG;AACjG,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAM5E;AAED,4FAA4F;AAC5F,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,kBAAkB,GAC1B,MAAM,CAKR;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,OAAO,GACd,qBAAqB,EAAE,CAyBzB"}

package/dist/socials.js

@@ -0,0 +1,172 @@
+/**
+ * Canonical social-profile support.
+ *
+ * The company profile (`storefrontMeta().socials`) is a free-form record keyed
+ * by BIAB's field keys (`meta`, `twitterX`, `tikTok`, …). Consumers kept
+ * re-implementing the key→icon→href mapping by hand and getting BIAB's exact
+ * keys wrong (e.g. mapping `facebook`/`x` and silently dropping `meta`/`twitterX`).
+ * This module is the single source of truth: every platform BIAB supports, in
+ * render order, with a stable icon slug + a handle→URL normalizer, plus alias
+ * resolution so older/lowercase spellings still match.
+ *
+ * `iconSlug` is a https://simpleicons.org slug (render it however you like —
+ * e.g. `https://cdn.simpleicons.org/<slug>`); `null` means there's no brand
+ * glyph, so fall back to a generic icon. For a drop-in React renderer that does
+ * this for you, see `SocialLinks` in `@businessdash/sdk/react`.
+ */
+/** Every platform BIAB supports, in footer render order. */
+export const SOCIAL_PLATFORMS = [
+    {
+        key: "meta",
+        label: "Facebook",
+        iconSlug: "facebook",
+        hrefPrefix: "https://facebook.com/",
+    },
+    {
+        key: "instagram",
+        label: "Instagram",
+        iconSlug: "instagram",
+        hrefPrefix: "https://instagram.com/",
+    },
+    { key: "twitterX", label: "X", iconSlug: "x", hrefPrefix: "https://x.com/" },
+    {
+        key: "tikTok",
+        label: "TikTok",
+        iconSlug: "tiktok",
+        hrefPrefix: "https://tiktok.com/@",
+    },
+    {
+        key: "youTube",
+        label: "YouTube",
+        iconSlug: "youtube",
+        hrefPrefix: "https://youtube.com/",
+    },
+    {
+        key: "linkedIn",
+        label: "LinkedIn",
+        iconSlug: "linkedin",
+        hrefPrefix: "https://linkedin.com/",
+    },
+    {
+        key: "pinterest",
+        label: "Pinterest",
+        iconSlug: "pinterest",
+        hrefPrefix: "https://pinterest.com/",
+    },
+    {
+        key: "threads",
+        label: "Threads",
+        iconSlug: "threads",
+        hrefPrefix: "https://threads.net/@",
+    },
+    { key: "bluesky", label: "Bluesky", iconSlug: "bluesky" },
+    { key: "mastodon", label: "Mastodon", iconSlug: "mastodon" },
+    { key: "truthSocial", label: "Truth Social", iconSlug: "truthsocial" },
+    { key: "googleBusiness", label: "Google", iconSlug: "google" },
+    { key: "yelp", label: "Yelp", iconSlug: "yelp" },
+    { key: "nextdoor", label: "Nextdoor", iconSlug: "nextdoor" },
+    { key: "angi", label: "Angi", iconSlug: null },
+    { key: "homeAdvisor", label: "HomeAdvisor", iconSlug: null },
+    { key: "houzz", label: "Houzz", iconSlug: "houzz" },
+    { key: "thumbtack", label: "Thumbtack", iconSlug: "thumbtack" },
+    { key: "bbb", label: "Better Business Bureau", iconSlug: null },
+    {
+        key: "whatsApp",
+        label: "WhatsApp",
+        iconSlug: "whatsapp",
+        hrefPrefix: "https://wa.me/",
+    },
+    { key: "discord", label: "Discord", iconSlug: "discord" },
+    { key: "substack", label: "Substack", iconSlug: "substack" },
+    { key: "reddit", label: "Reddit", iconSlug: "reddit" },
+    { key: "buyMeACoffee", label: "Buy Me a Coffee", iconSlug: "buymeacoffee" },
+    { key: "kofi", label: "Ko-fi", iconSlug: "kofi" },
+    { key: "patreon", label: "Patreon", iconSlug: "patreon" },
+    { key: "twitch", label: "Twitch", iconSlug: "twitch" },
+    { key: "vimeo", label: "Vimeo", iconSlug: "vimeo" },
+    {
+        key: "github",
+        label: "GitHub",
+        iconSlug: "github",
+        hrefPrefix: "https://github.com/",
+    },
+    { key: "behance", label: "Behance", iconSlug: "behance" },
+    { key: "dribbble", label: "Dribbble", iconSlug: "dribbble" },
+];
+const PLATFORM_BY_KEY = new Map(SOCIAL_PLATFORMS.map((p) => [p.key.toLowerCase(), p]));
+/** Older / alternate spellings → canonical key (all compared lowercased + de-punctuated). */
+const ALIASES = {
+    facebook: "meta",
+    fb: "meta",
+    x: "twitterX",
+    twitter: "twitterX",
+    tiktok: "tikTok",
+    youtube: "youTube",
+    linkedin: "linkedIn",
+    google: "googleBusiness",
+    googlemybusiness: "googleBusiness",
+    truthsocial: "truthSocial",
+    homeadvisor: "homeAdvisor",
+    betterbusinessbureau: "bbb",
+    whatsapp: "whatsApp",
+    buymeacoffee: "buyMeACoffee",
+    "ko-fi": "kofi",
+};
+/** Strip case + separators so `Truth Social`, `truth_social`, `truthSocial` all collapse. */
+function canonicalize(raw) {
+    return raw.toLowerCase().replace(/[\s_-]+/g, "");
+}
+/** Resolve any incoming social key (BIAB key, alias, or loose spelling) to its platform meta. */
+export function resolveSocialPlatform(key) {
+    const c = canonicalize(key);
+    const direct = PLATFORM_BY_KEY.get(c);
+    if (direct)
+        return direct;
+    const aliased = ALIASES[c];
+    return aliased ? (PLATFORM_BY_KEY.get(aliased.toLowerCase()) ?? null) : null;
+}
+/** Turn a stored value (full URL or bare handle) into an href using the platform prefix. */
+export function socialHref(value, platform) {
+    const v = value.trim();
+    if (/^(https?:\/\/|mailto:|tel:)/i.test(v))
+        return v;
+    if (platform.hrefPrefix)
+        return platform.hrefPrefix + v.replace(/^@/, "");
+    return `https://${v.replace(/^\/+/, "")}`;
+}
+/**
+ * Turn the company profile's `socials` record into a render-ready, de-duped list
+ * in canonical order — every platform that has a non-empty value, resolved to its
+ * label, icon slug, and a normalized URL. Empty values and unknown keys are
+ * dropped. Pass `storefrontMeta().socials` straight in.
+ */
+export function resolveSocialProfiles(socials) {
+    if (!socials || typeof socials !== "object")
+        return [];
+    const present = new Map();
+    for (const [rawKey, rawVal] of Object.entries(socials)) {
+        if (typeof rawVal !== "string")
+            continue;
+        const value = rawVal.trim();
+        if (!value)
+            continue;
+        const platform = resolveSocialPlatform(rawKey);
+        if (!platform || present.has(platform.key))
+            continue;
+        present.set(platform.key, value);
+    }
+    const rows = [];
+    for (const platform of SOCIAL_PLATFORMS) {
+        const value = present.get(platform.key);
+        if (!value)
+            continue;
+        rows.push({
+            key: platform.key,
+            label: platform.label,
+            iconSlug: platform.iconSlug,
+            url: socialHref(value, platform),
+        });
+    }
+    return rows;
+}
+//# sourceMappingURL=socials.js.map

package/dist/socials.js.map

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

package/dist/static.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@businessdash/sdk/static` — static data utilities and type helpers.
+ *
+ * Use this entrypoint for type‑safe enum / choice declarations and any other
+ * compile‑time static data definitions that ship with your collections.
+ *
+ * ```ts
+ * import { Enums } from "@businessdash/sdk/static";
+ *
+ * const Status = Enums(["active", "inactive"] as const);
+ * ```
+ */
+export { type DefineEnums, type Enum, type EnumEntry, Enums, type InferEnum, type InferEnumValues, } from "./enums.js";
+//# sourceMappingURL=static.d.ts.map

package/dist/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../src/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,EACL,KAAK,SAAS,EACd,KAAK,eAAe,GACpB,MAAM,YAAY,CAAC"}

package/dist/static.js

@@ -0,0 +1,14 @@
+/**
+ * `@businessdash/sdk/static` — static data utilities and type helpers.
+ *
+ * Use this entrypoint for type‑safe enum / choice declarations and any other
+ * compile‑time static data definitions that ship with your collections.
+ *
+ * ```ts
+ * import { Enums } from "@businessdash/sdk/static";
+ *
+ * const Status = Enums(["active", "inactive"] as const);
+ * ```
+ */
+export { Enums, } from "./enums.js";
+//# sourceMappingURL=static.js.map

package/dist/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../src/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAIN,KAAK,GAGL,MAAM,YAAY,CAAC"}

package/dist/url-pattern.d.ts

@@ -0,0 +1,47 @@
+/**
+ * URL pattern parser + variant enumeration for parallel pages.
+ *
+ * A pattern is a string like `"/repair/[service]/[area]"`. Each
+ * `[name]` segment is a variable slot. The parser extracts the
+ * variable names + validates them against a binding map; the
+ * enumerator computes the cartesian product of variable values into
+ * concrete URLs.
+ *
+ * Pure functions — no I/O, no React, no DB. Safe to import from
+ * both server and client bundles.
+ */
+export type ParallelPagePatternSegment = {
+    kind: "literal";
+    value: string;
+} | {
+    kind: "variable";
+    name: string;
+};
+export type ParsedParallelPagePattern = {
+    pattern: string;
+    segments: ParallelPagePatternSegment[];
+    variableNames: string[];
+};
+/**
+ * Parse a `routePattern` into ordered segments. Throws on malformed
+ * input — the SDK + tRPC router both call this at write time so the
+ * row never persists an unparseable pattern.
+ */
+export declare function parseParallelPagePattern(pattern: string): ParsedParallelPagePattern;
+/**
+ * Materialise a single variant URL given the resolved slug values
+ * (`{ service: "garage-door", area: "saint-paul" }` → "/repair/garage-door/saint-paul").
+ */
+export declare function materialiseParallelPagePath(parsed: ParsedParallelPagePattern, values: Readonly<Record<string, string>>): string;
+/**
+ * Enumerate the cartesian product of variable values into a flat
+ * array of variant maps. Order: each input value array is iterated
+ * in turn, with the LAST variable's values cycling fastest — so the
+ * result is stable + diffable across reads (useful for sitemaps and
+ * `generateStaticParams`).
+ *
+ * Returns an empty array when ANY variable has zero values (the
+ * cartesian product of a zero-length axis is empty).
+ */
+export declare function enumerateParallelPageVariants(variableNames: readonly string[], valuesByVariable: Readonly<Record<string, ReadonlyArray<string>>>): Array<Record<string, string>>;
+//# sourceMappingURL=url-pattern.d.ts.map

package/dist/url-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-pattern.d.ts","sourceRoot":"","sources":["../src/url-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,0BAA0B,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AASF;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,MAAM,GACb,yBAAyB,CAyC3B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACtC,MAAM,CAgBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC5C,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,GAC/D,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkC/B"}

package/dist/url-pattern.js

@@ -0,0 +1,124 @@
+/**
+ * URL pattern parser + variant enumeration for parallel pages.
+ *
+ * A pattern is a string like `"/repair/[service]/[area]"`. Each
+ * `[name]` segment is a variable slot. The parser extracts the
+ * variable names + validates them against a binding map; the
+ * enumerator computes the cartesian product of variable values into
+ * concrete URLs.
+ *
+ * Pure functions — no I/O, no React, no DB. Safe to import from
+ * both server and client bundles.
+ */
+/**
+ * Allowed variable-name characters — lowercase letters, digits, and
+ * hyphens / underscores so `[snow-removal]` and `[event_kind]` work.
+ * Matches the regex used by Next.js dynamic-route segments.
+ */
+const VARIABLE_NAME = /^[a-z][a-z0-9_-]*$/;
+/**
+ * Parse a `routePattern` into ordered segments. Throws on malformed
+ * input — the SDK + tRPC router both call this at write time so the
+ * row never persists an unparseable pattern.
+ */
+export function parseParallelPagePattern(pattern) {
+    if (typeof pattern !== "string" || pattern.length === 0) {
+        throw new Error("Pattern must be a non-empty string.");
+    }
+    if (!pattern.startsWith("/")) {
+        throw new Error(`Pattern must start with "/" — got ${JSON.stringify(pattern)}.`);
+    }
+    const parts = pattern.slice(1).split("/");
+    const segments = [];
+    const variableNames = [];
+    const seen = new Set();
+    for (const part of parts) {
+        if (part.length === 0) {
+            throw new Error(`Pattern contains an empty segment (double slash?) — ${JSON.stringify(pattern)}.`);
+        }
+        const variableMatch = /^\[([^\]]+)\]$/.exec(part);
+        if (!variableMatch) {
+            segments.push({ kind: "literal", value: part });
+            continue;
+        }
+        const name = variableMatch[1] ?? "";
+        if (!VARIABLE_NAME.test(name)) {
+            throw new Error(`Variable segment "[${name}]" is not a valid identifier ` +
+                "(use lowercase letters, digits, hyphens, underscores).");
+        }
+        if (seen.has(name)) {
+            throw new Error(`Variable "[${name}]" appears more than once in ${JSON.stringify(pattern)}.`);
+        }
+        seen.add(name);
+        variableNames.push(name);
+        segments.push({ kind: "variable", name });
+    }
+    return { pattern, segments, variableNames };
+}
+/**
+ * Materialise a single variant URL given the resolved slug values
+ * (`{ service: "garage-door", area: "saint-paul" }` → "/repair/garage-door/saint-paul").
+ */
+export function materialiseParallelPagePath(parsed, values) {
+    const out = [];
+    for (const seg of parsed.segments) {
+        if (seg.kind === "literal") {
+            out.push(seg.value);
+            continue;
+        }
+        const v = values[seg.name];
+        if (v === undefined || v === null || v === "") {
+            throw new Error(`Missing value for "[${seg.name}]" when materialising ${parsed.pattern}.`);
+        }
+        out.push(encodeURIComponent(v));
+    }
+    return `/${out.join("/")}`;
+}
+/**
+ * Enumerate the cartesian product of variable values into a flat
+ * array of variant maps. Order: each input value array is iterated
+ * in turn, with the LAST variable's values cycling fastest — so the
+ * result is stable + diffable across reads (useful for sitemaps and
+ * `generateStaticParams`).
+ *
+ * Returns an empty array when ANY variable has zero values (the
+ * cartesian product of a zero-length axis is empty).
+ */
+export function enumerateParallelPageVariants(variableNames, valuesByVariable) {
+    if (variableNames.length === 0)
+        return [{}];
+    for (const name of variableNames) {
+        const list = valuesByVariable[name];
+        if (!list) {
+            throw new Error(`Missing value array for variable "${name}". ` +
+                `Provide one entry in valuesByVariable for every variable in the pattern.`);
+        }
+        if (list.length === 0)
+            return [];
+    }
+    const out = [];
+    const indices = variableNames.map(() => 0);
+    while (true) {
+        const variant = {};
+        for (let i = 0; i < variableNames.length; i++) {
+            const name = variableNames[i];
+            const idx = indices[i];
+            variant[name] = valuesByVariable[name][idx];
+        }
+        out.push(variant);
+        // Increment indices like an odometer (last variable cycles
+        // fastest). When the first variable rolls over, we're done.
+        let i = variableNames.length - 1;
+        while (i >= 0) {
+            indices[i] = indices[i] + 1;
+            if (indices[i] < valuesByVariable[variableNames[i]].length)
+                break;
+            indices[i] = 0;
+            i--;
+        }
+        if (i < 0)
+            break;
+    }
+    return out;
+}
+//# sourceMappingURL=url-pattern.js.map

package/dist/url-pattern.js.map

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

package/dist/vanilla.d.ts

@@ -0,0 +1,77 @@
+/**
+ * `@businessdash/sdk/vanilla` — framework-free imperative DOM binding for `<BiabForm>`.
+ *
+ * `mountBiabForm(elOrSelector, opts)` mounts a fully-rendered, schema-driven form
+ * into any DOM node. It owns nothing of the form's logic — all of that lives in
+ * the headless `createFormController` core (`@businessdash/sdk/forms`). This binding
+ * is the "render layer": it subscribes to the controller's `snapshot()` and, on
+ * every notify, rebuilds the form's DOM by walking `snapshot.visibleFields` and
+ * dispatching per field `type`. It is a faithful port of the dashboard renderer
+ * (`FormPreview.tsx`) so a drop-in `<biab-form>` reproduces the builder preview.
+ *
+ * Rendering rules (kept identical to the dashboard):
+ *   - Light DOM, no shadow root, so the consumer's CSS cascades straight in.
+ *   - Stable `biab-*` class hooks + `data-biab-*` attributes on every node.
+ *   - Applies `schema.settings`: animation (none/fade/slide/scale/scroll),
+ *     multi-step ("consecutive") nav, progress bar/steps, concurrent-reveal
+ *     gating inside groups, plus the org icon when `showOrgIcon` is set.
+ *   - condition_block / or_condition / input_group / flex_row layout nodes are
+ *     walked exactly as the core's validation helpers expect.
+ *
+ * Compiled to dist (plain TS, no JSX). The web-component binding
+ * (`@businessdash/sdk/element`) wraps this same `mountBiabForm`.
+ */
+import { type FormController, type FormData, type FormSubmitOptions } from "./forms-core/index.js";
+import type { BiabClient, FormSchema, FormSubmitResult } from "./sdk.js";
+export * from "./forms-core/index.js";
+export interface MountBiabFormOptions {
+    /** The SDK client. Required unless `schema` is supplied (SSR / pre-fetched).
+     *  Still used for `submit` / `uploadFile` when both are given. */
+    client?: BiabClient;
+    /** Form slug. Required when loading via `client`. */
+    slug?: string;
+    /** Pre-fetched schema (SSR). `load()` adopts it synchronously. */
+    schema?: FormSchema;
+    /** Label for the final submit button. Default "Submit". */
+    submitLabel?: string;
+    /** Validate on the server but store nothing (no side effects). */
+    dryRun?: boolean;
+    /** Extra class(es) added to the root `.biab-form` element. */
+    class?: string;
+    /** Alias for `class` — accepted for cross-framework parity. */
+    className?: string;
+    /** Default submit options merged into every submit (call opts win). */
+    submitOptions?: FormSubmitOptions;
+    /** Global HTML autofill switch. Omit to infer a sensible `autocomplete`
+     *  token per field; `false` emits `autocomplete="off"` on every input. */
+    autoComplete?: boolean;
+    /** Per-field autofill overrides keyed by field id: a literal token,
+     *  `true` (infer), or `false` (off). Wins over the global switch. */
+    fieldAutoComplete?: Record<string, string | boolean>;
+    /** Fired with the working values when the user submits (before the network
+     *  round-trip is mapped to a result). Convenience for simple consumers. */
+    onSubmit?: (data: FormData) => void;
+    /** Fired after a successful submit. */
+    onSuccess?: (result: Extract<FormSubmitResult, {
+        ok: true;
+    }>) => void;
+    /** Fired after a failed submit. */
+    onError?: (result: Extract<FormSubmitResult, {
+        ok: false;
+    }>) => void;
+}
+/** Handle returned by `mountBiabForm` — drive or tear down the mounted form. */
+export interface BiabFormInstance {
+    /** The underlying headless controller (advanced use). */
+    controller: FormController;
+    /** Re-fetch (or re-adopt) the schema and re-render. */
+    reload(): Promise<void>;
+    /** Programmatically submit (same as clicking the submit button). */
+    submit(options?: FormSubmitOptions): Promise<FormSubmitResult>;
+    /** Reset values / errors / step and re-render. */
+    reset(): void;
+    /** Unsubscribe, stop the controller, and clear the host element. */
+    destroy(): void;
+}
+export declare function mountBiabForm(elOrSelector: Element | string, opts: MountBiabFormOptions): BiabFormInstance;
+//# sourceMappingURL=vanilla.d.ts.map

package/dist/vanilla.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vanilla.d.ts","sourceRoot":"","sources":["../src/vanilla.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,EAKN,KAAK,cAAc,EAEnB,KAAK,QAAQ,EAEb,KAAK,iBAAiB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACX,UAAU,EAEV,UAAU,EACV,gBAAgB,EAChB,MAAM,UAAU,CAAC;AAGlB,cAAc,uBAAuB,CAAC;AAMtC,MAAM,WAAW,oBAAoB;IACpC;sEACkE;IAClE,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC;8EAC0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;yEACqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACrD;+EAC2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,uCAAuC;IACvC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;IACtE,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,EAAE,EAAE,KAAK,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;CACrE;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAChC,yDAAyD;IACzD,UAAU,EAAE,cAAc,CAAC;IAC3B,uDAAuD;IACvD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,oEAAoE;IACpE,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/D,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;IACd,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAAC;CAChB;AAo3BD,wBAAgB,aAAa,CAC5B,YAAY,EAAE,OAAO,GAAG,MAAM,EAC9B,IAAI,EAAE,oBAAoB,GACxB,gBAAgB,CA2RlB"}