@businessdash/sdk 0.9.60 → 0.9.80

package/dist/store-core/index.js

@@ -0,0 +1,277 @@
+/**
+ * `@businessdash/sdk/store` — the headless storefront + cart controller.
+ *
+ * ## Why this exists
+ *
+ * Until now the only storefront the SDK offered was `<Storefront>`: a
+ * BusinessDash-hosted page in a sandboxed iframe. It works, and it ships fast,
+ * but it renders OUR markup inside YOUR app — your design system stops at the
+ * iframe boundary, and there is no way to put a product card in your own grid.
+ * That was true in every binding, React included.
+ *
+ * This is the native path. It owns all of the behaviour — pagination, category
+ * filtering, the cart, coupons, the product detail — and none of the markup.
+ * Exactly the split `createFormController` already uses for forms: one
+ * framework-agnostic controller, and a thin reactive view per framework.
+ *
+ * A binding subscribes to `snapshot()` and renders it. That is the whole
+ * contract, and it is why React, Solid, Vue, Svelte, Qwik, Angular and plain
+ * DOM can each expose a native storefront without any of them reimplementing
+ * what "add to cart" means.
+ *
+ * ## Money
+ *
+ * Every price crossing this boundary is an INTEGER of the currency's minor unit
+ * — cents for USD. The controller never divides, rounds or formats: it passes
+ * what the API sent straight to your renderer. Format at the edge, where you
+ * know the locale.
+ *
+ * @module
+ */
+const DEFAULT_PAGE_SIZE = 24;
+function toError(cause, fallback) {
+    return cause instanceof Error ? cause : new Error(fallback);
+}
+export function createStoreController(options) {
+    const { client, onError } = options;
+    const pageSize = options.pageSize ?? DEFAULT_PAGE_SIZE;
+    let destroyed = false;
+    let cursor = null;
+    /**
+     * Guards against a stale page landing after the category changed. Every
+     * product fetch captures the token it started under and drops its result if
+     * the token moved on — otherwise clicking two categories quickly can leave
+     * the second one's products under the first one's heading.
+     */
+    let requestToken = 0;
+    const subscribers = new Set();
+    const state = {
+        status: "idle",
+        products: [],
+        categories: [],
+        cart: null,
+        activeProduct: null,
+        categoryId: options.categoryId ?? null,
+        hasMore: false,
+        error: null,
+        pending: {
+            products: false,
+            categories: false,
+            product: false,
+            cart: false,
+        },
+    };
+    let cached = null;
+    function snapshot() {
+        if (!cached) {
+            cached = {
+                status: state.status,
+                products: state.products,
+                categories: state.categories,
+                cart: state.cart,
+                activeProduct: state.activeProduct,
+                categoryId: state.categoryId,
+                hasMore: state.hasMore,
+                error: state.error,
+                pending: state.pending,
+                itemCount: state.cart?.itemCount ?? 0,
+                subtotal: state.cart?.subtotal ?? 0,
+                currency: state.cart?.currency ?? null,
+            };
+        }
+        return cached;
+    }
+    function notify() {
+        if (destroyed)
+            return;
+        cached = null;
+        const next = snapshot();
+        for (const cb of subscribers)
+            cb(next);
+    }
+    function fail(cause, fallback) {
+        const error = toError(cause, fallback);
+        state.error = error;
+        if (state.status !== "ready")
+            state.status = "error";
+        onError?.(error);
+    }
+    /** Run a cart mutation, keeping `pending.cart` honest even on failure. */
+    async function cartAction(run, fallback) {
+        if (destroyed)
+            return;
+        state.pending.cart = true;
+        state.error = null;
+        notify();
+        try {
+            const cart = await run();
+            if (destroyed)
+                return;
+            state.cart = cart;
+        }
+        catch (cause) {
+            if (destroyed)
+                return;
+            fail(cause, fallback);
+        }
+        finally {
+            if (!destroyed) {
+                state.pending.cart = false;
+                notify();
+            }
+        }
+    }
+    async function fetchProducts(append) {
+        const token = ++requestToken;
+        state.pending.products = true;
+        if (!append)
+            state.error = null;
+        notify();
+        try {
+            const page = await client.storefront.listProducts({
+                limit: pageSize,
+                ...(append && cursor !== null ? { cursor } : {}),
+                ...(state.categoryId ? { categoryId: state.categoryId } : {}),
+            });
+            // A newer request superseded this one — its result is now wrong.
+            if (destroyed || token !== requestToken)
+                return;
+            state.products = append ? [...state.products, ...page.items] : page.items;
+            cursor = page.nextCursor;
+            state.hasMore = page.nextCursor !== null;
+            state.status = "ready";
+        }
+        catch (cause) {
+            if (destroyed || token !== requestToken)
+                return;
+            fail(cause, "Failed to load products.");
+        }
+        finally {
+            if (!destroyed && token === requestToken) {
+                state.pending.products = false;
+                notify();
+            }
+        }
+    }
+    return {
+        snapshot,
+        subscribe(callback) {
+            subscribers.add(callback);
+            return () => {
+                subscribers.delete(callback);
+            };
+        },
+        async load() {
+            if (destroyed)
+                return;
+            if (state.status === "idle")
+                state.status = "loading";
+            state.pending.categories = true;
+            notify();
+            // Categories and the cart are independent of the product page, so all
+            // three go out together rather than waterfalling.
+            const categories = client.storefront
+                .listCategories()
+                .then((res) => {
+                if (destroyed)
+                    return;
+                state.categories = res.items;
+            })
+                .catch((cause) => {
+                if (!destroyed)
+                    fail(cause, "Failed to load categories.");
+            })
+                .finally(() => {
+                if (!destroyed)
+                    state.pending.categories = false;
+            });
+            const cart = client.cart
+                .get()
+                .then((res) => {
+                if (destroyed)
+                    return;
+                state.cart = res;
+            })
+                .catch((cause) => {
+                // A visitor with no cart yet is normal, not an error worth
+                // surfacing — leave `cart` null and let the products render.
+                void cause;
+            });
+            await Promise.all([fetchProducts(false), categories, cart]);
+            if (!destroyed)
+                notify();
+        },
+        async loadMore() {
+            if (destroyed || !state.hasMore || state.pending.products)
+                return;
+            await fetchProducts(true);
+        },
+        async filterByCategory(categoryId) {
+            if (destroyed)
+                return;
+            state.categoryId = categoryId;
+            cursor = null;
+            await fetchProducts(false);
+        },
+        async openProduct(productId) {
+            if (destroyed)
+                return;
+            state.pending.product = true;
+            state.error = null;
+            notify();
+            try {
+                const detail = await client.storefront.getProduct(productId);
+                if (destroyed)
+                    return;
+                state.activeProduct = detail;
+            }
+            catch (cause) {
+                if (!destroyed)
+                    fail(cause, "Failed to load the product.");
+            }
+            finally {
+                if (!destroyed) {
+                    state.pending.product = false;
+                    notify();
+                }
+            }
+        },
+        closeProduct() {
+            if (destroyed)
+                return;
+            state.activeProduct = null;
+            notify();
+        },
+        addToCart(input) {
+            return cartAction(() => client.cart.addItem(input), "Failed to add the item to the cart.");
+        },
+        updateQuantity(itemId, quantity) {
+            // The API treats 0 as a removal; going through `removeItem` keeps that
+            // explicit rather than relying on every binding knowing the convention.
+            if (quantity <= 0) {
+                return cartAction(() => client.cart.removeItem(itemId), "Failed to remove the item.");
+            }
+            return cartAction(() => client.cart.updateItem(itemId, { quantity }), "Failed to update the quantity.");
+        },
+        removeItem(itemId) {
+            return cartAction(() => client.cart.removeItem(itemId), "Failed to remove the item.");
+        },
+        applyCoupon(code) {
+            return cartAction(() => client.cart.applyCoupon({ code }), "That coupon could not be applied.");
+        },
+        removeCoupon() {
+            return cartAction(() => client.cart.removeCoupon(), "Failed to remove the coupon.");
+        },
+        clearCart() {
+            return cartAction(() => client.cart.clear(), "Failed to clear the cart.");
+        },
+        refreshCart() {
+            return cartAction(() => client.cart.get(), "Failed to read the cart.");
+        },
+        destroy() {
+            destroyed = true;
+            subscribers.clear();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/store-core/index.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `@businessdash/sdk/store` — the framework-agnostic storefront + cart core.
+ *
+ * Bindings shipped as SOURCE (Vue / Svelte / Solid / Qwik / Angular) import
+ * through this public subpath rather than a relative path, so the consumer's
+ * bundler resolves it exactly as their own code would. `forms` works the same
+ * way.
+ *
+ * @module
+ */
+export * from "./store-core/index.js";
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/store.js

@@ -0,0 +1,12 @@
+/**
+ * `@businessdash/sdk/store` — the framework-agnostic storefront + cart core.
+ *
+ * Bindings shipped as SOURCE (Vue / Svelte / Solid / Qwik / Angular) import
+ * through this public subpath rather than a relative path, so the consumer's
+ * bundler resolves it exactly as their own code would. `forms` works the same
+ * way.
+ *
+ * @module
+ */
+export * from "./store-core/index.js";
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/vanilla.d.ts

@@ -74,4 +74,115 @@ export interface BiabFormInstance {
     destroy(): void;
 }
 export declare function mountBiabForm(elOrSelector: Element | string, opts: MountBiabFormOptions): BiabFormInstance;
+import { type ChatController } from "./chat-core/index.js";
+import { type StoreController } from "./store-core/index.js";
+export type CreateStorefrontOptions = {
+    apiKey: string;
+    baseUrl: string;
+    pageSize?: number;
+    categoryId?: string | null;
+    onError?: (error: Error) => void;
+};
+/** Headless storefront + cart. Call `load()` to populate it. */
+export declare function createStorefront(options: CreateStorefrontOptions): StoreController;
+export type CreateChatOptions = {
+    apiKey: string;
+    baseUrl: string;
+    onError?: (error: Error) => void;
+};
+/** Headless Front Desk chat — the native alternative to the iframe widget. */
+export declare function createChat(options: CreateChatOptions): ChatController;
+export type { ChatController, ChatSnapshot } from "./chat-core/index.js";
+export type { StoreController, StoreSnapshot, } from "./store-core/index.js";
+import { type BlogController } from "./blog-core/index.js";
+export type CreateBlogOptions = {
+    apiKey: string;
+    baseUrl: string;
+    pageSize?: number;
+    commentPageSize?: number;
+    categoryId?: string | null;
+    onError?: (error: Error) => void;
+};
+/** Headless blog — posts, taxonomy, a single post, comments and likes. */
+export declare function createBlog(options: CreateBlogOptions): BlogController;
+export type { BlogController, BlogSnapshot } from "./blog-core/index.js";
+import { type FollowersController, type UserController } from "./account-core/index.js";
+import { type CheckoutController } from "./checkout-core/index.js";
+/** Headless checkout — mint a Stripe session, then `redirect()` or render it. */
+export declare function createCheckout(options: {
+    apiKey: string;
+    baseUrl: string;
+    onError?: (error: Error) => void;
+}): CheckoutController;
+/** The signed-in customer, read from the auth handler's `/me`. */
+export declare function createUser(options?: {
+    basePath?: string;
+}): UserController;
+/** Newsletter / follower subscribe, bound to a publishable token. */
+export declare function createFollowers(options: {
+    token: string;
+    siteId: string;
+    baseUrl?: string;
+    onError?: (error: Error) => void;
+}): FollowersController;
+export type { FollowersController, FollowersSnapshot, UserController, UserSnapshot, } from "./account-core/index.js";
+export { signIn, signInHref, signOut, signOutHref, signUp, signUpHref, } from "./account-core/index.js";
+export type { CheckoutController, CheckoutSnapshot, } from "./checkout-core/index.js";
+import { type MarketingController } from "./marketing-core/index.js";
+import { type CreateVerifyControllerOptions, type VerifyController } from "./verify-core/index.js";
+/**
+ * Headless marketing pages — the index, plus one page at a time.
+ *
+ * Bound to the PUBLISHABLE client, like followers: marketing pages are a
+ * browser-readable surface keyed by site, so they need a `siteId` and work with
+ * an origin-locked `pk_…` token.
+ */
+export declare function createMarketing(options: {
+    token: string;
+    siteId: string;
+    baseUrl?: string;
+    onError?: (error: Error) => void;
+}): MarketingController;
+/** Headless email / phone verification. Read `flow` before rendering a field. */
+export declare function createVerify(options: {
+    apiKey: string;
+    baseUrl: string;
+} & Omit<CreateVerifyControllerOptions, "client">): VerifyController;
+export type { MarketingController, MarketingSnapshot, } from "./marketing-core/index.js";
+export type { VerifyController, VerifyFlow, VerifySnapshot, } from "./verify-core/index.js";
+import { type PortalController } from "./portal-core/index.js";
+/**
+ * The signed-in customer's portal. `sessionToken` is required — every portal
+ * route is scoped to the customer, and without one it renders empty rather than
+ * signed-out.
+ */
+export declare function createPortal(options: {
+    apiKey: string;
+    baseUrl: string;
+    sessionToken: string;
+    onError?: (error: Error) => void;
+}): PortalController;
+export type { PortalController, PortalSnapshot } from "./portal-core/index.js";
+export type MountSocialLinksOptions = {
+    socials: unknown;
+    /** Icon colour — hex without `#`, or a CSS keyword. */
+    color?: string;
+    /** Icon edge length in px. Default 20. */
+    size?: number;
+    class?: string;
+    linkClass?: string;
+    iconClass?: string;
+};
+/**
+ * Render a company's social links into `target`, replacing its contents.
+ *
+ * Returns a `destroy()` that empties the element again, so a single-page app
+ * can tear it down. Renders nothing at all when there are no profiles — an
+ * empty `<ul>` in a footer is worse than no list.
+ */
+export declare function mountSocialLinks(target: Element, options: MountSocialLinksOptions): {
+    destroy: () => void;
+};
+export type { SocialLinkRow } from "./social-core/index.js";
+export { resolveSocialLinks } from "./social-core/index.js";
 //# sourceMappingURL=vanilla.d.ts.map

package/dist/vanilla.d.ts.map

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

package/dist/vanilla.js

@@ -900,4 +900,210 @@ function observeReveal(node) {
     }, { threshold: 0.15, rootMargin: "0px 0px -8% 0px" });
     obs.observe(node);
 }
+// ─────────────────────────────────────────────────────────────────────────────
+// Native storefront + chat, framework-free
+//
+// There is no reactivity system here to bridge into, so the controllers ARE the
+// binding: subscribe, render, call the actions. That is also why these are the
+// reference implementations — every framework binding is a wrapper around
+// exactly these objects.
+//
+//   const store = createStorefront({ apiKey, baseUrl });
+//   store.subscribe((s) => render(s.products));
+//   await store.load();
+//
+// Remember to `destroy()` when the surface goes away.
+// ─────────────────────────────────────────────────────────────────────────────
+import { createChatController, } from "./chat-core/index.js";
+import { BiabDevClient as BiabDevClientForSurfaces } from "./client.js";
+import { createStoreController, } from "./store-core/index.js";
+/** Headless storefront + cart. Call `load()` to populate it. */
+export function createStorefront(options) {
+    return createStoreController({
+        client: new BiabDevClientForSurfaces({
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl,
+        }),
+        ...(options.pageSize ? { pageSize: options.pageSize } : {}),
+        ...(options.categoryId ? { categoryId: options.categoryId } : {}),
+        ...(options.onError ? { onError: options.onError } : {}),
+    });
+}
+/** Headless Front Desk chat — the native alternative to the iframe widget. */
+export function createChat(options) {
+    return createChatController({
+        client: new BiabDevClientForSurfaces({
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl,
+        }),
+        ...(options.onError ? { onError: options.onError } : {}),
+    });
+}
+import { createBlogController, } from "./blog-core/index.js";
+/** Headless blog — posts, taxonomy, a single post, comments and likes. */
+export function createBlog(options) {
+    return createBlogController({
+        client: new BiabDevClientForSurfaces({
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl,
+        }),
+        ...(options.pageSize ? { pageSize: options.pageSize } : {}),
+        ...(options.commentPageSize
+            ? { commentPageSize: options.commentPageSize }
+            : {}),
+        ...(options.categoryId ? { categoryId: options.categoryId } : {}),
+        ...(options.onError ? { onError: options.onError } : {}),
+    });
+}
+import { createFollowersController, createUserController, } from "./account-core/index.js";
+import { createCheckoutController, } from "./checkout-core/index.js";
+import { createBiabClient as createBiabClientForFollowers } from "./sdk.js";
+/** Headless checkout — mint a Stripe session, then `redirect()` or render it. */
+export function createCheckout(options) {
+    return createCheckoutController({
+        client: new BiabDevClientForSurfaces({
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl,
+        }),
+        ...(options.onError ? { onError: options.onError } : {}),
+    });
+}
+/** The signed-in customer, read from the auth handler's `/me`. */
+export function createUser(options = {}) {
+    return createUserController(options);
+}
+/** Newsletter / follower subscribe, bound to a publishable token. */
+export function createFollowers(options) {
+    // Followers hang off the PUBLISHABLE client (`createBiabClient`), not
+    // `BiabDevClient`: they are the one surface a browser calls directly with an
+    // origin-locked `pk_…` token and no backend.
+    return createFollowersController({
+        client: createBiabClientForFollowers({
+            apiKey: options.token,
+            siteId: options.siteId,
+            baseUrl: options.baseUrl ?? DEFAULT_PACKAGE_BASE_URL_FOR_SURFACES,
+        }),
+        siteId: options.siteId,
+        ...(options.onError ? { onError: options.onError } : {}),
+    });
+}
+export { signIn, signInHref, signOut, signOutHref, signUp, signUpHref, } from "./account-core/index.js";
+/** Production package-API base, used when a surface doesn't specify one. */
+const DEFAULT_PACKAGE_BASE_URL_FOR_SURFACES = "https://businessdash.us/api/package/v1";
+import { createMarketingController, } from "./marketing-core/index.js";
+import { createVerifyController, } from "./verify-core/index.js";
+/**
+ * Headless marketing pages — the index, plus one page at a time.
+ *
+ * Bound to the PUBLISHABLE client, like followers: marketing pages are a
+ * browser-readable surface keyed by site, so they need a `siteId` and work with
+ * an origin-locked `pk_…` token.
+ */
+export function createMarketing(options) {
+    return createMarketingController({
+        client: createBiabClientForFollowers({
+            apiKey: options.token,
+            siteId: options.siteId,
+            baseUrl: options.baseUrl ?? DEFAULT_PACKAGE_BASE_URL_FOR_SURFACES,
+        }),
+        ...(options.onError ? { onError: options.onError } : {}),
+    });
+}
+/** Headless email / phone verification. Read `flow` before rendering a field. */
+export function createVerify(options) {
+    const { apiKey, baseUrl, ...rest } = options;
+    return createVerifyController({
+        client: new BiabDevClientForSurfaces({ apiKey, baseUrl }),
+        ...rest,
+    });
+}
+import { createPortalController, } from "./portal-core/index.js";
+/**
+ * The signed-in customer's portal. `sessionToken` is required — every portal
+ * route is scoped to the customer, and without one it renders empty rather than
+ * signed-out.
+ */
+export function createPortal(options) {
+    return createPortalController({
+        client: new BiabDevClientForSurfaces({
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl,
+        }),
+        sessionToken: options.sessionToken,
+        ...(options.onError ? { onError: options.onError } : {}),
+    });
+}
+import { resolveSocialLinks, SOCIAL_FALLBACK_GLYPH, SOCIAL_LIST_STYLE, } from "./social-core/index.js";
+/**
+ * Render a company's social links into `target`, replacing its contents.
+ *
+ * Returns a `destroy()` that empties the element again, so a single-page app
+ * can tear it down. Renders nothing at all when there are no profiles — an
+ * empty `<ul>` in a footer is worse than no list.
+ */
+export function mountSocialLinks(target, options) {
+    const size = options.size ?? 20;
+    const rows = resolveSocialLinks(options.socials, { color: options.color });
+    target.replaceChildren();
+    if (rows.length === 0)
+        return { destroy: () => target.replaceChildren() };
+    const ul = document.createElement("ul");
+    if (options.class)
+        ul.className = options.class;
+    for (const [prop, value] of Object.entries(SOCIAL_LIST_STYLE)) {
+        ul.style.setProperty(prop, value);
+    }
+    for (const row of rows) {
+        const li = document.createElement("li");
+        const a = document.createElement("a");
+        a.href = row.url;
+        a.target = "_blank";
+        a.rel = "noopener noreferrer";
+        a.title = row.label;
+        a.setAttribute("aria-label", row.label);
+        if (options.linkClass)
+            a.className = options.linkClass;
+        a.append(socialGlyph(row, size, options.iconClass));
+        li.append(a);
+        ul.append(li);
+    }
+    target.append(ul);
+    return { destroy: () => target.replaceChildren() };
+}
+/** Brand icon when the platform has one, generic globe when it doesn't. */
+function socialGlyph(row, size, iconClass) {
+    if (row.iconUrl) {
+        const img = document.createElement("img");
+        img.src = row.iconUrl;
+        img.alt = row.label;
+        img.width = size;
+        img.height = size;
+        img.loading = "lazy";
+        if (iconClass)
+            img.className = iconClass;
+        return img;
+    }
+    const ns = "http://www.w3.org/2000/svg";
+    const svg = document.createElementNS(ns, "svg");
+    svg.setAttribute("viewBox", SOCIAL_FALLBACK_GLYPH.viewBox);
+    svg.setAttribute("width", String(size));
+    svg.setAttribute("height", String(size));
+    svg.setAttribute("fill", "none");
+    svg.setAttribute("stroke", "currentColor");
+    svg.setAttribute("stroke-width", String(SOCIAL_FALLBACK_GLYPH.strokeWidth));
+    svg.setAttribute("aria-hidden", "true");
+    if (iconClass)
+        svg.setAttribute("class", iconClass);
+    const title = document.createElementNS(ns, "title");
+    title.textContent = row.label;
+    const circle = document.createElementNS(ns, "circle");
+    circle.setAttribute("cx", String(SOCIAL_FALLBACK_GLYPH.circle.cx));
+    circle.setAttribute("cy", String(SOCIAL_FALLBACK_GLYPH.circle.cy));
+    circle.setAttribute("r", String(SOCIAL_FALLBACK_GLYPH.circle.r));
+    const path = document.createElementNS(ns, "path");
+    path.setAttribute("d", SOCIAL_FALLBACK_GLYPH.path);
+    svg.append(title, circle, path);
+    return svg;
+}
+export { resolveSocialLinks } from "./social-core/index.js";
 //# sourceMappingURL=vanilla.js.map