@hanzo/commerce 7.3.5 → 7.3.7

package/dist/service/impls/standalone/order/firebase.js

@@ -0,0 +1,13 @@
+import { initializeApp, getApps } from 'firebase/app';
+const firebaseConfig = {
+    apiKey: process.env.NEXT_PUBLIC_FIREBASE_API_KEY,
+    authDomain: process.env.NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN,
+    projectId: process.env.NEXT_PUBLIC_FIREBASE_PROJECT_ID,
+    storageBucket: process.env.NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET,
+    messagingSenderId: process.env.NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID,
+    appId: process.env.NEXT_PUBLIC_FIREBASE_APP_ID,
+    measurementId: process.env.NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID,
+};
+// Initialize Firebase instance if there isn't one already
+export default getApps().length === 0 ? initializeApp(firebaseConfig) : getApps()[0];
+//# sourceMappingURL=firebase.js.map

package/dist/service/impls/standalone/order/firebase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.js","sourceRoot":"","sources":["../../../../../service/impls/standalone/order/firebase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAErD,MAAM,cAAc,GAAG;IACrB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B;IAChD,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,gCAAgC;IACxD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,+BAA+B;IACtD,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,mCAAmC;IAC9D,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,wCAAwC;IACvE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B;IAC9C,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,mCAAmC;CAC/D,CAAA;AAED,0DAA0D;AAC1D,eAAe,OAAO,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA"}

package/dist/service/impls/standalone/order/index.d.ts

@@ -0,0 +1,24 @@
+import type { ActualLineItemSnapshot } from '../actual-line-item';
+declare const createOrder: (email: string, items: ActualLineItemSnapshot[], options: {
+    dbName: string;
+    ordersTable: string;
+}, name?: string) => Promise<{
+    success: boolean;
+    error: any;
+    id?: string;
+}>;
+declare const updateOrderShippingInfo: (orderId: string, shippingInfo: any, options: {
+    dbName: string;
+    ordersTable: string;
+}) => Promise<{
+    success: boolean;
+    error: any;
+}>;
+declare const updateOrderPaymentInfo: (orderId: string, paymentInfo: any, options: {
+    dbName: string;
+    ordersTable: string;
+}) => Promise<{
+    success: boolean;
+    error: any;
+}>;
+export { createOrder, updateOrderShippingInfo, updateOrderPaymentInfo };

package/dist/service/impls/standalone/order/index.js

@@ -0,0 +1,61 @@
+import { getFirestore, collection, setDoc, doc, serverTimestamp, } from 'firebase/firestore';
+import firebaseApp from './firebase';
+let dbInstance = undefined;
+const getDBInstance = (name) => {
+    if (!dbInstance) {
+        dbInstance = getFirestore(firebaseApp, name);
+    }
+    return dbInstance;
+};
+const createOrder = async (email, items, options, name) => {
+    let error = null;
+    const ordersRef = collection(getDBInstance(options.dbName), options.ordersTable);
+    const orderId = `${email}-${new Date().toISOString()}`;
+    try {
+        await setDoc(doc(ordersRef, orderId), {
+            email,
+            name: name ?? '',
+            status: 'open',
+            timestamp: serverTimestamp(),
+            items,
+        });
+        return { success: !error, error, id: orderId };
+    }
+    catch (e) {
+        console.error('Error writing item document: ', e);
+        error = e;
+    }
+    return { success: !error, error };
+};
+const updateOrderShippingInfo = async (orderId, shippingInfo, options) => {
+    let error = null;
+    const ordersRef = collection(getDBInstance(options.dbName), options.ordersTable);
+    try {
+        await setDoc(doc(ordersRef, orderId), {
+            shippingInfo,
+            timestamp: serverTimestamp(),
+        }, { merge: true });
+    }
+    catch (e) {
+        console.error('Error writing item document: ', e);
+        error = e;
+    }
+    return { success: !error, error };
+};
+const updateOrderPaymentInfo = async (orderId, paymentInfo, options) => {
+    let error = null;
+    const ordersRef = collection(getDBInstance(options.dbName), options.ordersTable);
+    try {
+        await setDoc(doc(ordersRef, orderId), {
+            paymentInfo,
+            timestamp: serverTimestamp(),
+        }, { merge: true });
+    }
+    catch (e) {
+        console.error('Error writing item document: ', e);
+        error = e;
+    }
+    return { success: !error, error };
+};
+export { createOrder, updateOrderShippingInfo, updateOrderPaymentInfo };
+//# sourceMappingURL=index.js.map

package/dist/service/impls/standalone/order/index.js.map

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

package/dist/service/impls/standalone/persistence.d.ts

@@ -0,0 +1,4 @@
+import { StandaloneService, type StandaloneServiceSnapshot } from './index';
+declare const readSnapshot: (key: string) => StandaloneServiceSnapshot | undefined;
+declare const writeSnapshotsOnChange: (cmmc: StandaloneService, key: string) => void;
+export { readSnapshot, writeSnapshotsOnChange };

package/dist/service/impls/standalone/persistence.js

@@ -0,0 +1,22 @@
+import { reaction } from 'mobx';
+import { StandaloneService } from './index';
+const LS_KEY = 'lux-cart';
+const readSnapshot = (key) => {
+    const snapshotAsStr = localStorage.getItem(key);
+    return snapshotAsStr ? JSON.parse(snapshotAsStr) : undefined;
+};
+const writeSnapshotsOnChange = (cmmc, key) => {
+    if (typeof window !== 'undefined') {
+        reaction(() => (cmmc.cartTotal), (total) => {
+            if (total > 0) {
+                const snapshot = cmmc.takeSnapshot();
+                localStorage.setItem(key, JSON.stringify(snapshot));
+            }
+            else {
+                localStorage.removeItem(key);
+            }
+        });
+    }
+};
+export { readSnapshot, writeSnapshotsOnChange };
+//# sourceMappingURL=persistence.js.map

package/dist/service/impls/standalone/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../../../service/impls/standalone/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAC/B,OAAO,EAAE,iBAAiB,EAAkC,MAAM,SAAS,CAAA;AAE3E,MAAM,MAAM,GAAG,UAAU,CAAA;AAEzB,MAAM,YAAY,GAAG,CAAC,GAAW,EAA0C,EAAE;IAC3E,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/C,OAAO,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAA8B,CAAC,CAAC,CAAC,SAAS,CAAA;AAC3F,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,CAAC,IAAuB,EAAE,GAAW,EAAQ,EAAE;IAE5E,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,QAAQ,CACN,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EACtB,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;gBACpC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAE,CAAA;YACtD,CAAC;iBACI,CAAC;gBACJ,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;YAC9B,CAAC;QACH,CAAC,CACF,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED,OAAO,EACL,YAAY,EACZ,sBAAsB,EACvB,CAAA"}

package/dist/service/path-utils.d.ts

@@ -0,0 +1,7 @@
+import type { SelectedPaths } from '../types';
+export declare const getSelectedPaths: (skuPath: string) => {
+    paths: SelectedPaths;
+    level: number;
+};
+export declare const getParentPath: (skuPath: string) => string;
+export declare const lastToken: (skuPath: string) => string;

package/dist/service/path-utils.js

@@ -0,0 +1,16 @@
+import sep from './sep';
+export const getSelectedPaths = (skuPath) => {
+    const toks = skuPath.split(sep.tok);
+    const level = toks.length - 1;
+    const paths = {};
+    for (let l = 1; l <= level; l++) {
+        paths[l] = [toks[l]];
+    }
+    return {
+        paths,
+        level
+    };
+};
+export const getParentPath = (skuPath) => (skuPath.split(sep.tok).slice(0, -1).join(sep.tok));
+export const lastToken = (skuPath) => (skuPath.split(sep.tok).pop());
+//# sourceMappingURL=path-utils.js.map

package/dist/service/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../service/path-utils.ts"],"names":[],"mappings":"AACA,OAAO,GAAG,MAAM,OAAO,CAAA;AAEvB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAAe,EAC0B,EAAE;IAE3C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;IAC7B,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAG,CAAC;QACjC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IACtB,CAAC;IACD,OAAO;QACL,KAAK;QACL,KAAK;KACN,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,CACxD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAClD,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,CACpD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAC9B,CAAA"}

package/dist/service/sep.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    tok: string;
+    subTok: string;
+    decimal: string;
+};
+export default _default;

package/dist/service/sep.js

@@ -0,0 +1,6 @@
+export default {
+    tok: '-',
+    subTok: '_',
+    decimal: '.'
+};
+//# sourceMappingURL=sep.js.map

package/dist/service/sep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sep.js","sourceRoot":"","sources":["../../service/sep.ts"],"names":[],"mappings":"AAEA,eAAe;IACb,GAAG,EAAE,GAAG;IACR,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;CACa,CAAA"}

package/dist/types/category-node.d.ts

@@ -0,0 +1,36 @@
+import type { ReactNode } from 'react';
+interface CategoryNode {
+    skuToken: string;
+    label: string;
+    /**
+     * Explicitly marks this node as a "last user-visible" / "outermost" Category.
+     * Normally, a node is "outermost" when it has no subnodes
+     * (and thus is a family with products -- "single-family")
+     * But if it *has* subnodes, and its subNodes are actually sibling families
+     * of a Category, it must be marked as "outermost" ("multi-family")
+     * */
+    outermost?: boolean;
+    img?: string | ReactNode;
+    imgAR?: number;
+    /**
+     * One word prompt that describes the 'meaning' of
+     * the subnodes.
+     * For example, if a node is 'Lux Credit',
+     * it's subNodesLabel might be 'Level', so some UI's
+     * might be configured to render 'Level: Black'
+     *
+     * or something like...
+     *
+     * <Tabs title={parentNode.label + ': ' + parentNode.subNodesLabel} values={families.map((f) => (f.shortName))} />
+     *
+     * ...which renders
+     *
+     * Lux Credit Levels:
+     * Black   Elite   Founder   Sovereign
+    */
+    subNodesLabel?: string;
+    subNodes?: CategoryNode[];
+}
+type CategoryNodeRole = 'single-family' | 'family-in-multi-family' | 'multi-family' | 'non-outermost';
+type SelectedPaths = Record<number, string[]>;
+export type { CategoryNodeRole, CategoryNode, SelectedPaths };

package/dist/types/category-node.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=category-node.js.map

package/dist/types/category-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-node.js","sourceRoot":"","sources":["../../types/category-node.ts"],"names":[],"mappings":""}

package/dist/types/checkout.d.ts

@@ -0,0 +1,33 @@
+import type { ComponentType } from 'react';
+import type { UseFormReturn } from 'react-hook-form';
+type TransactionStatus = 'unpaid' | 'paid' | 'confirmed' | 'error';
+interface CheckoutStepComponentProps {
+    onDone: () => void;
+    orderId: string | undefined;
+    setOrderId: (orderId: string | undefined) => void;
+}
+interface CheckoutStep {
+    name: string;
+    label?: string;
+    Comp: ComponentType<CheckoutStepComponentProps>;
+}
+type ContactFormType = UseFormReturn<{
+    name: string;
+    email: string;
+}, any, {
+    name: string;
+    email: string;
+}>;
+interface PaymentMethodComponentProps {
+    onDone: () => void;
+    transactionStatus: TransactionStatus;
+    setTransactionStatus: (status: TransactionStatus) => void;
+    storePaymentInfo: (paymentInfo: any) => Promise<void>;
+    contactForm: ContactFormType;
+}
+interface PaymentMethodDesc {
+    value: string;
+    label: string;
+    Comp: ComponentType<PaymentMethodComponentProps>;
+}
+export { type TransactionStatus, type CheckoutStepComponentProps, type CheckoutStep, type PaymentMethodComponentProps, type PaymentMethodDesc, type ContactFormType, };

package/dist/types/checkout.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=checkout.js.map

package/dist/types/checkout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../../types/checkout.ts"],"names":[],"mappings":"AAuCA,OAAO,EAON,CAAA"}

package/dist/types/commerce-config.d.ts

@@ -0,0 +1,11 @@
+import type { ServiceOptions } from '..';
+import type { CategoryNode } from './category-node';
+import type { Family } from './family';
+import type { SelectionUISpecifier } from './selection-ui-specifier';
+interface CommerceConfig {
+    families: Family[];
+    rootNode: CategoryNode;
+    options?: ServiceOptions;
+    uiSpecifiers?: Record<string, SelectionUISpecifier>;
+}
+export { type CommerceConfig as default };

package/dist/types/commerce-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=commerce-config.js.map

package/dist/types/commerce-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce-config.js","sourceRoot":"","sources":["../../types/commerce-config.ts"],"names":[],"mappings":"AAYA,OAAO,EAAkC,CAAA"}

package/dist/types/commerce-service.d.ts

@@ -0,0 +1,109 @@
+import type { LineItem, ObsLineItemRef } from './line-item';
+import type { CategoryNode, SelectedPaths, CategoryNodeRole } from './category-node';
+import type { Family, ObsFamilyRef } from './family';
+import type Promo from './promo';
+interface CommerceService extends ObsLineItemRef, ObsFamilyRef {
+    /** Items in cart */
+    get cartItems(): LineItem[];
+    /** Total of all quantities of all items in cart */
+    get cartQuantity(): number;
+    /** Total of all prices x quantities of items in cart */
+    get cartTotal(): number;
+    /** cartItem whose quantity was modified most recently
+     * item: LineItem
+     * modified: number (timestamp)
+     * (undefined if cartEmpty)
+     */
+    get recentItem(): {
+        item: LineItem;
+        modified: number;
+    } | undefined;
+    get promoAppliedCartTotal(): number;
+    get cartEmpty(): boolean;
+    get appliedPromo(): Promo | null;
+    setAppliedPromo(promo: Promo | null): void;
+    /** returns the price with promo applied, of undefined if no promo or promo does not apply */
+    itemPromoPrice(item: LineItem): number | undefined;
+    getFamilySubtotal(familyId: string): number;
+    createOrder(email: string, name?: string): Promise<string | undefined>;
+    updateOrderShippingInfo(orderId: string, shippingInfo: any): Promise<void>;
+    updateOrderPaymentInfo(orderId: string, paymentInfo: any): Promise<void>;
+    /**
+     * Sets the tokens at each level supplied.
+     * If a level is selected as [], nothing will be selected.
+     * If a level is missing (undefined), everything at that level is selected
+     *
+     * This selects one or more Family's, and all the LineItem's in them.
+     *
+     * An empty value object selects all Family's and all LineItem's,
+     * */
+    selectPaths(value: SelectedPaths): Family[];
+    selectPath(skuPath: string): Family[];
+    /**
+     * With role as ...
+     *
+     * 'single-family':
+     *    item: item with skuPath as SKU, otherwise undefined
+     *    node: node at path (or item's parent node),
+     *    family: node at path as family (or item's parent node as family),
+     *    families: undefined
+     *
+     * 'family-in-multi-family':
+     *    item: item with skuPath as SKU, otherwise undefined
+     *    node: parent node of this family (or parent node of item's family)
+     *    family: this family (or item's family)
+     *    families: this family (or item's family) and siblings
+     *
+     * 'multi-family':
+     *    item: undefined
+     *    node: node at path
+     *    family: undefined
+     *    families: subnodes / families of this node
+     *
+     * 'non-outermost':
+     *    item: undefined
+     *    node: node at path
+     *    family: undefined
+     *    families: undefined
+     *
+    */
+    peek(skuPath: string): {
+        role: CategoryNodeRole;
+        family: Family | undefined;
+        families: Family[] | undefined;
+        node: CategoryNode | undefined;
+        item: LineItem | undefined;
+    } | string;
+    /** @deprecated
+     *  Whether this path defines a Family, or if it has further levels
+     * */
+    getNodeAtPath(skuPath: string): CategoryNode | undefined;
+    get selectedPaths(): SelectedPaths;
+    get selectedItems(): LineItem[];
+    get selectedFamilies(): Family[];
+    get hasSelection(): boolean;
+    /**
+     * Who are the subnodes selected at 'level'?
+     * If more than one value is selected at 'level',
+     * the returned CategoryNode[] may represent multiple sets.
+     * */
+    getSelectedNodesAtLevel(level: number): CategoryNode[] | undefined;
+    /**
+   * For convenience, so widgets can share state.
+   * "current" is unrelated to what branches and items are
+   * "selected" (with CategoryNode's and paths)
+   *
+   *  SEE ALSO: from ObsLineItemRef and ObsFamilyRef, there are also
+   *  get item(): LineItem | undefined
+   *  get family(): Family | undefined
+   *
+   *  These simply delegate to these functions
+   *  */
+    setCurrentItem(sku: string | undefined): boolean;
+    get currentItem(): LineItem | undefined;
+    setCurrentFamily(id: string | undefined): boolean;
+    get currentFamily(): Family | undefined;
+    getFamilyById(id: string): Family | undefined;
+    getItemBySku(sku: string): LineItem | undefined;
+}
+export { type CommerceService as default };

package/dist/types/commerce-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=commerce-service.js.map

package/dist/types/commerce-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce-service.js","sourceRoot":"","sources":["../../types/commerce-service.ts"],"names":[],"mappings":"AA6HA,OAAO,EAEN,CAAA"}

package/dist/types/components/Icons.d.ts

@@ -0,0 +1,18 @@
+declare const _default: {
+    shoppingCart: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    menu: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    chevronLeft: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    chevronRight: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    spinner: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    check: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    plus: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    minus: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    chevronDown: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    chevronsLeft: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    chevronsRight: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    placeholder: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    trash: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    search: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    barcode: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+};
+export default _default;

package/dist/types/components/add-to-cart-widget.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { LineItem } from '../types';
+declare const AddToCartWidget: React.FC<{
+    item: LineItem;
+    disabled?: boolean;
+    className?: string;
+    buttonClx?: string;
+    variant?: 'minimal' | 'primary' | 'primary-smaller' | 'outline';
+    onQuantityChanged?: (sku: string, oldV: number, newV: number) => void;
+}>;
+export default AddToCartWidget;

package/dist/types/components/buy/buy-card.d.ts

@@ -0,0 +1,30 @@
+import React, { type ComponentType } from 'react';
+import type { ItemSelectorProps, ItemSelectorCompProps } from '../../types';
+declare const BuyCard: React.FC<{
+    skuPath: string;
+    /** For any selectors that show a list of choices,
+     * starting with 'scrollAfter' elements,
+     * the list will scroll, and the card will
+     * have 'scrollHeightClx' applied to it to define and fix the height.
+     * This is most like something like '80vh'
+     * defaults are '5' and 'h-[70vh]'
+     * */
+    scrollAfter?: number;
+    scrollHeightClx?: string;
+    clx?: string;
+    famWidgetClx?: string;
+    addWidgetClx?: string;
+    selector: ComponentType<ItemSelectorProps>;
+    selectorProps?: ItemSelectorCompProps;
+    /** Show all items from all sibling families
+     * If skuPath defines a Family, the first of it's items will
+     * be selected. The facet widget will just select a the first
+     * item in the chosen Family without changings the overall set
+     * of choices. */
+    allVariants?: boolean;
+    familyTabAs?: 'image' | 'label' | 'image-and-label';
+    showItemMedia?: boolean;
+    onQuantityChanged?: (sku: string, oldV: number, newV: number) => void;
+    mobile?: boolean;
+}>;
+export default BuyCard;

package/dist/types/components/buy/carousel-buy-card.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+declare const CarouselBuyCard: React.FC<{
+    skuPath: string;
+    checkoutButton: React.ReactNode;
+    clx?: string;
+    selectorClx?: string;
+    addBtnClx?: string;
+    buttonsAreaClx?: string;
+    mobile?: boolean;
+    onQuantityChanged?: (sku: string, oldV: number, newV: number) => void;
+}>;
+export default CarouselBuyCard;

package/dist/types/components/buy/multi-family/all-variants-carousel.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { MultiFamilySelectorProps } from '../../../types';
+declare const AllVariantsCarousel: React.FC<MultiFamilySelectorProps>;
+export { AllVariantsCarousel as default };

package/dist/types/components/buy/multi-family/family-carousel/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { MultiFamilySelectorProps } from '../../../../types';
+declare const FamilyCarousel: React.FC<MultiFamilySelectorProps>;
+export default FamilyCarousel;

package/dist/types/components/buy/multi-family/family-carousel/slide.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { Dimensions } from '@hanzo/ui/types';
+import type { ItemSelectorOptions, Family, ItemSelector } from '../../../../types';
+declare const FamilySlide: React.FC<Omit<ItemSelector, 'items'> & {
+    family: Family;
+    mediaConstraint: Dimensions;
+    clx?: string;
+    mobile?: boolean;
+    options?: ItemSelectorOptions;
+}>;
+export default FamilySlide;

package/dist/types/components/buy/multi-family/family-carousel/state.d.ts

@@ -0,0 +1,20 @@
+import type { Family, LineItem, ObsLineItemRef, Product } from '../../../../types';
+declare class SlideState implements ObsLineItemRef {
+    _fam: Family;
+    _item: Product;
+    _syncSku: (sku: string) => void;
+    _selected: boolean;
+    constructor(fam: Family, initiallySelected: boolean, sync: (sku: string) => void);
+    selectSku: (sku: string) => void;
+    setSelected: (b: boolean) => void;
+    get id(): string;
+    get item(): LineItem | undefined;
+}
+declare class FamilyCarouselState {
+    _map: Map<string, SlideState>;
+    _syncSku: (sku: string) => void;
+    constructor(fams: Family[], syncSkuToCurrentSlide: (sku: string) => void);
+    setCurrentFamily: (id: string) => void;
+    getSlideState: (familyId: string) => SlideState | undefined;
+}
+export { SlideState, FamilyCarouselState };

package/dist/types/components/buy/multi-family/index.d.ts

@@ -0,0 +1,2 @@
+export { default as FamilyCarousel } from './family-carousel';
+export { default as AllVariantsCarousel } from './all-variants-carousel';

package/dist/types/components/buy/single-family-selector.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { Dimensions } from '@hanzo/ui/types';
+import type { ItemSelectorOptions, ItemSelectorProps, LineItem } from '../../types';
+declare const SingleFamilySelector: React.FC<{
+    items: LineItem[];
+    Selector: React.ComponentType<ItemSelectorProps>;
+    selOptions: ItemSelectorOptions | undefined;
+    scrollable?: boolean;
+    showItemMedia?: boolean;
+    mediaConstraint?: Dimensions;
+    mobile?: boolean;
+    clx?: string;
+    titleAreaClx?: string;
+}>;
+export default SingleFamilySelector;

package/dist/types/components/buy/title-and-byline.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+declare const TitleAndByline: React.FC<{
+    title: string | undefined;
+    byline?: string | undefined;
+    clx?: string;
+    bylineClx?: string;
+}>;
+export default TitleAndByline;

package/dist/types/components/cart/cart-panel/cart-line-item.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { LineItem } from '../../../types';
+declare const CartLineItem: React.FC<{
+    item: LineItem;
+    className?: string;
+    imgSizePx?: number;
+    showPromoCode?: boolean;
+    itemClicked?: (item: LineItem) => void;
+    selected?: boolean;
+}>;
+export default CartLineItem;

package/dist/types/components/cart/cart-panel/index.d.ts

@@ -0,0 +1,19 @@
+import React, { type PropsWithChildren } from 'react';
+declare const CartPanel: React.FC<PropsWithChildren & {
+    /** fix size and scroll after 'scrollAfter items in teh cart. */
+    scrollAfter?: number;
+    scrollHeightClx?: string;
+    imgSizePx?: number;
+    className?: string;
+    itemClx?: string;
+    listClx?: string;
+    noItemsClx?: string;
+    totalClx?: string;
+    buttonClx?: string;
+    showPromoCode?: boolean;
+    showShipping?: boolean;
+    selectItems?: boolean;
+    /** if not provided, 'checkout' button will be rendered */
+    handleCheckout?: () => void;
+}>;
+export default CartPanel;

package/dist/types/components/cart/cart-panel/promo-code.d.ts

@@ -0,0 +1,4 @@
+declare const PromoCode: (() => import("react").JSX.Element) & {
+    displayName: string;
+};
+export default PromoCode;

package/dist/types/components/cart/cart-panel/total-area.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+declare const TotalArea: React.FC<{
+    showPromoCode?: boolean;
+    showShipping?: boolean;
+    clx?: string;
+}>;
+export default TotalArea;

package/dist/types/components/checkout/payment-step-form/card-icon-row.d.ts

@@ -0,0 +1,2 @@
+declare const PaymentMethods: React.FC;
+export default PaymentMethods;

package/dist/types/components/checkout/payment-step-form/card-icons/amex.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { type LucideProps } from 'lucide-react';
+declare const Amex: React.FC<LucideProps>;
+export default Amex;

package/dist/types/components/checkout/payment-step-form/card-icons/diners-club.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { type LucideProps } from 'lucide-react';
+declare const DinersClub: React.FC<LucideProps>;
+export default DinersClub;