@fayz-ai/storefront 0.6.0 → 0.8.0

package/README.md

@@ -5,9 +5,11 @@
 [![npm](https://img.shields.io/npm/v/@fayz-ai/storefront.svg)](https://www.npmjs.com/package/@fayz-ai/storefront)
 [![license](https://img.shields.io/npm/l/@fayz-ai/storefront.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)
 
+**Status:** beta — published to npm and used across Fayz dogfood apps. Pre-1.0: minor APIs may change before 1.0.
+
 `@fayz-ai/storefront` is the customer-facing surface of the Fayz SDK: a storefront scaffold that renders a page as a tree of **blocks** (hero, products, manifesto, cart, …) defined in the app manifest. Two completely different brands come out of the same template with zero custom components — the storefront is *data*, not a fork.
 
-It reads commerce from `@fayz-ai/shop`, so the same engine powering an admin also powers the public store. Customize from labels to a fully bespoke section via the [customization ladder](../../docs/customization-ladder.md) — never by editing this package.
+It reads commerce from `@fayz-ai/shop`, so the same engine powering an admin also powers the public store. Customize from labels to a fully bespoke section via the [customization ladder](../../docs/CUSTOMIZATION.md) — never by editing this package.
 
 ## What's inside
 - **Scaffold** — `defineStorefront(config)` + `StorefrontScaffold` rendered by `renderApp`

package/dist/auth.d.ts

@@ -1,6 +1,16 @@
 import type { AuthAdapter } from '@fayz-ai/core';
-export type StorefrontAuthAdapter = AuthAdapter | 'mock' | 'supabase';
-export declare function resolveAuthAdapter(configured: StorefrontAuthAdapter | undefined): AuthAdapter;
+import { type AuthPluginOptions } from '@fayz-ai/plugin-auth';
+export type StorefrontAuthAdapter = AuthAdapter | 'mock' | 'supabase' | (string & {});
+export interface StorefrontAuthConfig {
+    adapter?: AuthPluginOptions['adapter'];
+    provider?: AuthPluginOptions['provider'];
+    routes?: AuthPluginOptions['routes'];
+    supabase?: AuthPluginOptions['supabase'];
+}
+export declare function resolveAuthAdapter(configured: StorefrontAuthAdapter | StorefrontAuthConfig | undefined, fallback?: {
+    supabaseUrl?: string;
+    supabaseAnonKey?: string;
+}): AuthAdapter;
 /** Called once by createStorefrontApp. Restores any persisted session. */
 export declare function initCustomerAuth(adapter: AuthAdapter): void;
 export declare function getCustomerAuthAdapter(): AuthAdapter;

package/dist/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,eAAe,CAAA;AAa1D,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,CAAA;AAIrE,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,qBAAqB,GAAG,SAAS,GAC5C,WAAW,CAQb;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAgB3D;AAED,wBAAgB,sBAAsB,IAAI,WAAW,CAGpD;AAgCD,MAAM,WAAW,uBAAuB;IACtC,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,uBAAuB,GAC7B,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAWjC;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAE3F;AAED,mEAAmE;AACnE,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAKjC;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAMrD"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,eAAe,CAAA;AAC1D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAA;AAY7B,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAErF,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;IACtC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAA;IACxC,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAA;CACzC;AAsBD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,qBAAqB,GAAG,oBAAoB,GAAG,SAAS,EACpE,QAAQ,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,WAAW,CAeb;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAgB3D;AAED,wBAAgB,sBAAsB,IAAI,WAAW,CAGpD;AAgCD,MAAM,WAAW,uBAAuB;IACtC,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,uBAAuB,GAC7B,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAWjC;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAE3F;AAED,mEAAmE;AACnE,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAKjC;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAMrD"}

package/dist/blocks.d.ts

@@ -1,6 +1,6 @@
 import type { BlockNode } from '@fayz-ai/core';
-import type { HomeSection } from './sections';
+import type { StorefrontSection } from './sections';
 export declare function registerStorefrontBlocks(): void;
-/** Convert the legacy HomeSection[] blueprint into a generic block tree. */
-export declare function sectionsToBlocks(sections: HomeSection[]): BlockNode[];
+/** Convert the typed storefront section blueprint into a generic block tree. */
+export declare function sectionsToBlocks(sections: readonly StorefrontSection[]): BlockNode[];
 //# sourceMappingURL=blocks.d.ts.map

package/dist/blocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../src/blocks.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAsB7C,wBAAgB,wBAAwB,IAAI,IAAI,CAW/C;AAKD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAKrE"}
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../src/blocks.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAwBnD,wBAAgB,wBAAwB,IAAI,IAAI,CAa/C;AAKD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,EAAE,CAKpF"}

package/dist/component-contracts.d.ts

@@ -0,0 +1,124 @@
+import type React from 'react';
+import type { Category, CreateProductEnquiryInput, Product, ProductEnquiry, ProductImage } from '@fayz-ai/shop/types';
+import type { ProductOptionGroup, ProductOptionSelection } from './product-options';
+import type { ResolvedStorefrontConfig, StorefrontCommerceMode } from './config';
+import type { MediaCarouselItem } from './sections';
+export interface StorefrontComponentBaseProps {
+    config: ResolvedStorefrontConfig;
+    commerceMode: StorefrontCommerceMode;
+    className?: string;
+    testId?: string;
+}
+export interface StorefrontActions {
+    navigateTo: (to: string) => void;
+    addToCart: (product: Product, quantity?: number, options?: ProductOptionSelection) => void;
+    openCart: () => void;
+    closeCart: () => void;
+    createProductEnquiry: (input: CreateProductEnquiryInput) => Promise<ProductEnquiry>;
+}
+export interface ProductCardProps extends StorefrontComponentBaseProps {
+    product: Product;
+    actions: Pick<StorefrontActions, 'navigateTo' | 'addToCart' | 'openCart'>;
+}
+export interface ProductDetailProps extends StorefrontComponentBaseProps {
+    product: Product;
+    primaryImage?: ProductImage;
+    optionGroups: ProductOptionGroup[];
+    selectedOptions: ProductOptionSelection;
+    setSelectedOptions: React.Dispatch<React.SetStateAction<ProductOptionSelection>>;
+    quantity: number;
+    setQuantity: React.Dispatch<React.SetStateAction<number>>;
+    soldOut: boolean;
+    lowStock: boolean;
+    actions: Pick<StorefrontActions, 'addToCart' | 'createProductEnquiry' | 'navigateTo'>;
+    addToCart: () => void;
+    openEnquiry: () => void;
+}
+export interface ProductGalleryProps extends StorefrontComponentBaseProps {
+    product: Product;
+    images: ProductImage[];
+    primaryImage?: ProductImage;
+}
+export interface ProductPriceProps extends StorefrontComponentBaseProps {
+    product: Product;
+    value: number;
+    compareAt?: number | null;
+}
+export interface ProductActionsProps extends StorefrontComponentBaseProps {
+    product: Product;
+    quantity: number;
+    setQuantity: React.Dispatch<React.SetStateAction<number>>;
+    soldOut: boolean;
+    actions: Pick<StorefrontActions, 'addToCart' | 'createProductEnquiry' | 'navigateTo'>;
+    addToCart: () => void;
+    openEnquiry: () => void;
+}
+export interface ProductEnquiryFormContractProps extends StorefrontComponentBaseProps {
+    product: Product;
+    onSuccess?: () => void;
+}
+export interface CategoryCardProps extends StorefrontComponentBaseProps {
+    category: Category;
+    actions: Pick<StorefrontActions, 'navigateTo'>;
+}
+export interface CollectionSectionProps extends StorefrontComponentBaseProps {
+    title: string;
+    subtitle?: string;
+    products: Product[];
+    category?: Category;
+    children?: React.ReactNode;
+}
+export interface HeroSectionContractProps extends StorefrontComponentBaseProps {
+    title: string;
+    subtitle?: string;
+    eyebrow?: string;
+    image?: string;
+    cta?: string;
+    href?: string;
+    children?: React.ReactNode;
+}
+export interface MediaCarouselProps extends StorefrontComponentBaseProps {
+    items: MediaCarouselItem[];
+    height?: 'medium' | 'tall' | 'screen';
+    autoplayMs?: number;
+    overlay?: 'dark' | 'soft' | 'none';
+}
+export interface ProductSliderProps extends StorefrontComponentBaseProps {
+    title: string;
+    subtitle?: string;
+    eyebrow?: string;
+    filter?: 'sale' | 'new' | 'all';
+    categoryName?: string;
+    collection?: string;
+    limit?: number;
+    cta?: string;
+    href?: string;
+}
+export interface StorefrontChromeProps extends StorefrontComponentBaseProps {
+    children?: React.ReactNode;
+}
+export interface StorefrontStateProps extends StorefrontComponentBaseProps {
+    title?: string;
+    message?: string;
+    children?: React.ReactNode;
+}
+export interface StorefrontComponents {
+    ProductCard?: React.ComponentType<ProductCardProps>;
+    ProductDetail?: React.ComponentType<ProductDetailProps>;
+    ProductGallery?: React.ComponentType<ProductGalleryProps>;
+    ProductPrice?: React.ComponentType<ProductPriceProps>;
+    ProductActions?: React.ComponentType<ProductActionsProps>;
+    ProductEnquiryForm?: React.ComponentType<ProductEnquiryFormContractProps>;
+    CategoryCard?: React.ComponentType<CategoryCardProps>;
+    CollectionSection?: React.ComponentType<CollectionSectionProps>;
+    HeroSection?: React.ComponentType<HeroSectionContractProps>;
+    MediaCarousel?: React.ComponentType<MediaCarouselProps>;
+    ProductSlider?: React.ComponentType<ProductSliderProps>;
+    Header?: React.ComponentType<StorefrontChromeProps>;
+    Footer?: React.ComponentType<StorefrontChromeProps>;
+    Shell?: React.ComponentType<StorefrontChromeProps>;
+    EmptyState?: React.ComponentType<StorefrontStateProps>;
+    LoadingState?: React.ComponentType<StorefrontStateProps>;
+    ErrorState?: React.ComponentType<StorefrontStateProps>;
+}
+//# sourceMappingURL=component-contracts.d.ts.map

package/dist/component-contracts.d.ts.map

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

package/dist/component-selectors.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Stable selectors that custom storefront components must preserve.
+ *
+ * Apps can fully customize the visual tree, but replacement components still
+ * need these anchors so smoke tests, QA, and agents can operate stores.
+ */
+export declare const productCardComponentContract: {
+    readonly root: {
+        readonly 'data-testid': "product-card";
+    };
+    readonly name: {
+        readonly 'data-testid': "product-card-name";
+    };
+    readonly priceTestId: "product-card-price";
+    readonly addButton: {
+        readonly 'data-testid': "product-card-add";
+    };
+};
+export declare const storefrontComponentContracts: {
+    readonly productCard: {
+        readonly root: {
+            readonly 'data-testid': "product-card";
+        };
+        readonly name: {
+            readonly 'data-testid': "product-card-name";
+        };
+        readonly priceTestId: "product-card-price";
+        readonly addButton: {
+            readonly 'data-testid': "product-card-add";
+        };
+    };
+    readonly productDetail: {
+        readonly root: {
+            readonly 'data-testid': "pdp-root";
+        };
+        readonly gallery: {
+            readonly 'data-testid': "pdp-gallery";
+        };
+        readonly name: {
+            readonly 'data-testid': "pdp-name";
+        };
+        readonly description: {
+            readonly 'data-testid': "pdp-description";
+        };
+        readonly actions: {
+            readonly 'data-testid': "pdp-actions";
+        };
+        readonly addButton: {
+            readonly 'data-testid': "pdp-add-to-cart";
+        };
+        readonly enquiryButton: {
+            readonly 'data-testid': "pdp-enquiry-button";
+        };
+        readonly enquiryForm: {
+            readonly 'data-testid': "enquiry-form";
+        };
+    };
+};
+export type ProductCardComponentContract = typeof productCardComponentContract;
+export type ProductDetailComponentContract = typeof storefrontComponentContracts.productDetail;
+//# sourceMappingURL=component-selectors.d.ts.map

package/dist/component-selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-selectors.d.ts","sourceRoot":"","sources":["../src/component-selectors.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;CAK/B,CAAA;AAEV,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY/B,CAAA;AAEV,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAA;AAC9E,MAAM,MAAM,8BAA8B,GAAG,OAAO,4BAA4B,CAAC,aAAa,CAAA"}

package/dist/components/CartDrawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CartDrawer.d.ts","sourceRoot":"","sources":["../../src/components/CartDrawer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAiBlD,wBAAgB,UAAU,6BAwOzB"}
+{"version":3,"file":"CartDrawer.d.ts","sourceRoot":"","sources":["../../src/components/CartDrawer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAkBlD,wBAAgB,UAAU,6BAwOzB"}

package/dist/components/ProductCard.d.ts

@@ -1,7 +1,4 @@
 import React from 'react';
-import type { Product } from '@fayz-ai/shop/types';
-export interface ProductCardProps {
-    product: Product;
-}
-export declare function ProductCard({ product }: ProductCardProps): React.JSX.Element;
+import type { ProductCardProps } from '../component-contracts';
+export declare function ProductCard({ product, config: providedConfig, actions: providedActions }: ProductCardProps): React.JSX.Element;
 //# sourceMappingURL=ProductCard.d.ts.map

package/dist/components/ProductCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductCard.d.ts","sourceRoot":"","sources":["../../src/components/ProductCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AASlD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,gBAAgB,qBAwFxD"}
+{"version":3,"file":"ProductCard.d.ts","sourceRoot":"","sources":["../../src/components/ProductCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,gBAAgB,qBA2G1G"}

package/dist/components/ProductEnquiryForm.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { Product } from '@fayz-ai/shop/types';
+export interface ProductEnquiryFormProps {
+    product: Product;
+    onSuccess?: () => void;
+}
+export declare function ProductEnquiryForm({ product, onSuccess }: ProductEnquiryFormProps): React.JSX.Element;
+//# sourceMappingURL=ProductEnquiryForm.d.ts.map

package/dist/components/ProductEnquiryForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductEnquiryForm.d.ts","sourceRoot":"","sources":["../../src/components/ProductEnquiryForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAGvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAYD,wBAAgB,kBAAkB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,uBAAuB,qBAuJjF"}

package/dist/components/ProductGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductGrid.d.ts","sourceRoot":"","sources":["../../src/components/ProductGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,qBA2B3F"}
+{"version":3,"file":"ProductGrid.d.ts","sourceRoot":"","sources":["../../src/components/ProductGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,qBAmC3F"}

package/dist/components/RelatedProducts.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { Product } from '@fayz-ai/shop/types';
 /** "Você também pode gostar" — products from the same category, excluding the
- *  current one. Renders through the store's configured card slot for visual
+ *  current one. Renders through the store's configured card component for visual
  *  consistency with the catalog. Hidden when there's nothing relevant. */
 export declare function RelatedProducts({ product }: {
     product: Product;

package/dist/components/RelatedProducts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RelatedProducts.d.ts","sourceRoot":"","sources":["../../src/components/RelatedProducts.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAuB,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKvE;;0EAE0E;AAC1E,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,4BAqBhE"}
+{"version":3,"file":"RelatedProducts.d.ts","sourceRoot":"","sources":["../../src/components/RelatedProducts.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAuB,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMvE;;0EAE0E;AAC1E,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,4BA6BhE"}

package/dist/components/SmoothImage.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { type StorefrontImageLoadingConfig } from '../config';
+export interface SmoothImageProps extends React.ImgHTMLAttributes<HTMLImageElement> {
+    imageLoading?: StorefrontImageLoadingConfig;
+}
+export declare function SmoothImage({ imageLoading, loading, decoding, onLoad, style, ...props }: SmoothImageProps): React.JSX.Element;
+//# sourceMappingURL=SmoothImage.d.ts.map

package/dist/components/SmoothImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmoothImage.d.ts","sourceRoot":"","sources":["../../src/components/SmoothImage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAA+B,KAAK,4BAA4B,EAAE,MAAM,WAAW,CAAA;AAE1F,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC;IACjF,YAAY,CAAC,EAAE,4BAA4B,CAAA;CAC5C;AAED,wBAAgB,WAAW,CAAC,EAC1B,YAAY,EACZ,OAAgB,EAChB,QAAkB,EAClB,MAAM,EACN,KAAK,EACL,GAAG,KAAK,EACT,EAAE,gBAAgB,qBA4ClB"}

package/dist/components/StorefrontFooter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorefrontFooter.d.ts","sourceRoot":"","sources":["../../src/components/StorefrontFooter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,wBAAgB,gBAAgB,sBA6F/B"}
+{"version":3,"file":"StorefrontFooter.d.ts","sourceRoot":"","sources":["../../src/components/StorefrontFooter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,wBAAgB,gBAAgB,sBAuG/B"}

package/dist/components/StorefrontHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorefrontHeader.d.ts","sourceRoot":"","sources":["../../src/components/StorefrontHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AA8QvC,wBAAgB,gBAAgB,sBAuE/B"}
+{"version":3,"file":"StorefrontHeader.d.ts","sourceRoot":"","sources":["../../src/components/StorefrontHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AA0SvC,wBAAgB,gBAAgB,sBA2E/B"}

package/dist/components/sections/CategoryShowcase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CategoryShowcase.d.ts","sourceRoot":"","sources":["../../../src/components/sections/CategoryShowcase.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,4BAqEhG"}
+{"version":3,"file":"CategoryShowcase.d.ts","sourceRoot":"","sources":["../../../src/components/sections/CategoryShowcase.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,4BAqEhG"}

package/dist/components/sections/HeroSection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeroSection.d.ts","sourceRoot":"","sources":["../../../src/components/sections/HeroSection.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AA6C9C,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,MAAM,EACN,MAAe,GAChB,EAAE;IACD,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAC3B,4BAwHA"}
+{"version":3,"file":"HeroSection.d.ts","sourceRoot":"","sources":["../../../src/components/sections/HeroSection.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AA+C9C,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,MAAM,EACN,MAAe,GAChB,EAAE;IACD,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAC3B,4BAsIA"}

package/dist/components/sections/MediaCarousel.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { MediaCarouselItem } from '../../sections';
+export interface MediaCarouselProps {
+    items: MediaCarouselItem[];
+    height?: 'medium' | 'tall' | 'screen';
+    autoplayMs?: number;
+    overlay?: 'dark' | 'soft' | 'none';
+    className?: string;
+}
+export declare function MediaCarousel({ items, height, autoplayMs, overlay, className, }: MediaCarouselProps): React.JSX.Element | null;
+//# sourceMappingURL=MediaCarousel.d.ts.map

package/dist/components/sections/MediaCarousel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaCarousel.d.ts","sourceRoot":"","sources":["../../../src/components/sections/MediaCarousel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAK1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAcD,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,MAAe,EACf,UAAiB,EACjB,OAAgB,EAChB,SAAc,GACf,EAAE,kBAAkB,4BA0GpB"}

package/dist/components/sections/MiscSections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MiscSections.d.ts","sourceRoot":"","sources":["../../../src/components/sections/MiscSections.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAYvC,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,qBAkBtG;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,GAAG,EACH,IAAI,EACJ,KAAK,EACL,GAAS,GACV,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,qBA4BA;AAED,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,qBAO/E;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,qBA0BjH;AAED,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,qBAyCxF"}
+{"version":3,"file":"MiscSections.d.ts","sourceRoot":"","sources":["../../../src/components/sections/MiscSections.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAavC,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,qBAkBtG;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,GAAG,EACH,IAAI,EACJ,KAAK,EACL,GAAS,GACV,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,qBA4BA;AAED,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,qBAO/E;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,qBA0BjH;AAED,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,qBAyCxF"}

package/dist/components/sections/ProductRail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductRail.d.ts","sourceRoot":"","sources":["../../../src/components/sections/ProductRail.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAA;AAQtC,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAc,EACd,KAAS,GACV,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,4BAoDA"}
+{"version":3,"file":"ProductRail.d.ts","sourceRoot":"","sources":["../../../src/components/sections/ProductRail.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAA;AAStC,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAc,EACd,KAAS,GACV,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,4BA2DA"}

package/dist/components/sections/ProductSlider.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+export interface ProductSliderProps {
+    title: string;
+    subtitle?: string;
+    eyebrow?: string;
+    filter?: 'sale' | 'new' | 'all';
+    categoryName?: string;
+    collection?: string;
+    limit?: number;
+    cta?: string;
+    href?: string;
+    className?: string;
+}
+export declare function ProductSlider({ title, subtitle, eyebrow, filter, categoryName, collection, limit, cta, href, className, }: ProductSliderProps): React.JSX.Element | null;
+//# sourceMappingURL=ProductSlider.d.ts.map

package/dist/components/sections/ProductSlider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductSlider.d.ts","sourceRoot":"","sources":["../../../src/components/sections/ProductSlider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0B,MAAM,OAAO,CAAA;AAS9C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAc,EACd,YAAY,EACZ,UAAU,EACV,KAAU,EACV,GAAgB,EAChB,IAAI,EACJ,SAAc,GACf,EAAE,kBAAkB,4BAqFpB"}

package/dist/config.d.ts

@@ -1,13 +1,10 @@
 import React from 'react';
-import type { Product } from '@fayz-ai/shop/types';
 import type { ShopProvider } from '@fayz-ai/shop/provider';
 import type { MockShopSeed } from '@fayz-ai/shop/mock';
 import type { StorefrontTheme } from './theme';
 import type { HomeConfig, NavLink, FooterConfig } from './sections';
-import type { StorefrontAuthAdapter } from './auth';
-export interface ProductCardSlotProps {
-    product: Product;
-}
+import type { StorefrontAuthConfig } from './auth';
+import type { StorefrontComponents } from './component-contracts';
 export type StorefrontRouteKind = 'home' | 'catalog' | 'product' | 'checkout' | 'account' | 'order' | 'custom';
 export type StorefrontRouteParams = Record<string, string>;
 export interface StorefrontRouteComponentProps {
@@ -16,6 +13,14 @@ export interface StorefrontRouteComponentProps {
     config: ResolvedStorefrontConfig;
 }
 export type StorefrontRouteChrome = 'default' | 'focused';
+export type StorefrontCommerceMode = 'checkout' | 'catalog' | 'enquiry';
+export type StorefrontImageLoadingMode = 'fade' | 'none';
+export interface StorefrontImageLoadingConfig {
+    mode?: StorefrontImageLoadingMode;
+    durationMs?: number;
+    easing?: string;
+    blur?: boolean;
+}
 export interface StorefrontRouteDefinition {
     /**
      * Stable identifier for generated-code diffs, QA reports, and route ownership.
@@ -40,20 +45,19 @@ export interface StorefrontRouteDefinition {
      */
     component: React.ComponentType<StorefrontRouteComponentProps>;
 }
-export interface StorefrontSlots {
-    /**
-     * Product card renderer used by catalog grids and product rails.
-     *
-     * Custom renderers must preserve `productCardSlotContract` selectors so
-     * checkout smoke tests, QA, and agents can still operate the storefront.
-     */
-    ProductCard?: React.ComponentType<ProductCardSlotProps>;
-}
 export interface StorefrontDiscountConfig {
     code: string;
     percent: number;
     title?: string;
 }
+export interface StorefrontEnquiryConfig {
+    label?: string;
+    successMessage?: string;
+    subjectPrefix?: string;
+    email?: string;
+    whatsappUrl?: string;
+    requirePhone?: boolean;
+}
 export interface StorefrontConfig {
     /** Store display name (header, page title) */
     name: string;
@@ -65,6 +69,8 @@ export interface StorefrontConfig {
     locale?: string;
     /** Visual identity: colors, fonts, radius, header/card personality */
     theme?: StorefrontTheme;
+    /** Checkout-first default, catalog-only browsing, or product enquiry flow. */
+    commerceMode?: StorefrontCommerceMode;
     /** Promo message above the header (e.g. 'FRETE GRÁTIS ACIMA DE R$ 300') */
     announcement?: string;
     /** Home page blueprint. When set, `/` renders it and the catalog moves to /catalog. */
@@ -99,9 +105,7 @@ export interface StorefrontConfig {
         returns?: string;
     };
     /** Customer auth — same AuthAdapter contract as createSaasApp. Default: mock. */
-    auth?: {
-        adapter?: StorefrontAuthAdapter;
-    };
+    auth?: StorefrontAuthConfig;
     /** Shipping pricing — default { flatRate: 0 } */
     shipping?: {
         flatRate?: number;
@@ -115,15 +119,21 @@ export interface StorefrontConfig {
     payments?: {
         mode?: 'mock' | 'pix-mercadopago';
     };
-    /** Feature toggles — discounts default off; accounts default on */
+    /** Product enquiry behavior for catalog/enquiry stores. */
+    enquiry?: StorefrontEnquiryConfig;
+    /** Feature toggles — defaults depend on commerceMode. */
     features?: {
         discounts?: boolean;
         accounts?: boolean;
+        cart?: boolean;
+        checkout?: boolean;
     };
-    /** Code-level customization slots. Kept out of serialized manifests. */
-    slots?: StorefrontSlots;
+    /** Global storefront image reveal behavior. Default is a soft fade. */
+    imageLoading?: StorefrontImageLoadingConfig;
+    /** Code-level component replacements. Kept out of serialized manifests. */
+    components?: StorefrontComponents;
     /** Code-level route overrides/custom routes. Kept out of serialized manifests. */
-    routes?: StorefrontRouteDefinition[];
+    routes?: readonly StorefrontRouteDefinition[];
 }
 export interface ResolvedStorefrontConfig extends StorefrontConfig {
     currency: string;
@@ -135,10 +145,15 @@ export interface ResolvedStorefrontConfig extends StorefrontConfig {
     payments: {
         mode: 'mock' | 'pix-mercadopago';
     };
+    commerceMode: StorefrontCommerceMode;
+    enquiry: Required<Pick<StorefrontEnquiryConfig, 'label' | 'successMessage' | 'subjectPrefix'>> & Omit<StorefrontEnquiryConfig, 'label' | 'successMessage' | 'subjectPrefix'>;
     features: {
         discounts: boolean;
         accounts: boolean;
+        cart: boolean;
+        checkout: boolean;
     };
+    imageLoading: Required<StorefrontImageLoadingConfig>;
     /** Where the full product list lives ('/' without a home page, '/catalog' with one) */
     catalogPath: string;
     nav: NavLink[];
@@ -146,4 +161,6 @@ export interface ResolvedStorefrontConfig extends StorefrontConfig {
 export declare function resolveConfig(config: StorefrontConfig): ResolvedStorefrontConfig;
 export declare const StorefrontConfigProvider: React.Provider<ResolvedStorefrontConfig | null>;
 export declare function useStorefrontConfig(): ResolvedStorefrontConfig;
+export declare function useStorefrontConfigOptional(): ResolvedStorefrontConfig | null;
+export declare function getStorefrontComponents(config: ResolvedStorefrontConfig): StorefrontComponents;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/createStorefrontApp.d.ts

@@ -1,5 +1,8 @@
 import React from 'react';
+import type { ShopProvider } from '@fayz-ai/shop/provider';
 import type { StorefrontConfig } from './config';
+import type { StorefrontComponents } from './component-contracts';
+import type { StorefrontSection } from './sections';
 export declare function initStorefrontRuntime(config: StorefrontConfig): void;
 /** The inner storefront UI. Reads everything from the config context, so it is
  *  shared by createStorefrontApp and the manifest-driven StorefrontScaffold. */
@@ -13,4 +16,13 @@ export declare function StorefrontShell(): React.JSX.Element;
  *   const App = createStorefrontApp({ name: 'Aurora Goods', currency: 'BRL' })
  */
 export declare function createStorefrontApp(config: StorefrontConfig): React.ComponentType;
+export interface CreateStorefrontOptions {
+    config: StorefrontConfig;
+    provider?: ShopProvider;
+    components?: StorefrontComponents;
+    routes?: StorefrontConfig['routes'];
+    pages?: StorefrontConfig['routes'];
+    sections?: readonly StorefrontSection[];
+}
+export declare function createStorefront(options: CreateStorefrontOptions): React.ComponentType;
 //# sourceMappingURL=createStorefrontApp.d.ts.map

package/dist/createStorefrontApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createStorefrontApp.d.ts","sourceRoot":"","sources":["../src/createStorefrontApp.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,KAAK,EAAE,gBAAgB,EAA4B,MAAM,UAAU,CAAA;AA0G1E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAcpE;AAED;gFACgF;AAChF,wBAAgB,eAAe,sBAgB9B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAajF"}
+{"version":3,"file":"createStorefrontApp.d.ts","sourceRoot":"","sources":["../src/createStorefrontApp.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D,OAAO,KAAK,EAAE,gBAAgB,EAA4B,MAAM,UAAU,CAAA;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AA2GnD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAmCpE;AAED;gFACgF;AAChF,wBAAgB,eAAe,sBAkC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAajF;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,UAAU,CAAC,EAAE,oBAAoB,CAAA;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACxC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,KAAK,CAAC,aAAa,CAgBtF"}

package/dist/define.d.ts

@@ -0,0 +1,17 @@
+import type { StorefrontConfig, StorefrontRouteDefinition } from './config';
+import type { StorefrontComponents } from './component-contracts';
+import type { StorefrontSection } from './sections';
+import type { CreateStorefrontOptions } from './createStorefrontApp';
+/**
+ * Identity helpers for generated/custom storefronts.
+ *
+ * They do not add runtime behavior; they make the intended client-app shape
+ * explicit and keep TypeScript inference tight across config, components, routes,
+ * sections and app creation options.
+ */
+export declare function defineStorefrontConfig<const T extends StorefrontConfig>(config: T): T;
+export declare function defineStorefrontComponents<const T extends StorefrontComponents>(components: T): T;
+export declare function defineStorefrontRoutes<const T extends readonly StorefrontRouteDefinition[]>(routes: T): T;
+export declare function defineStorefrontSections<const T extends readonly StorefrontSection[]>(sections: T): T;
+export declare function defineStorefrontApp<const T extends CreateStorefrontOptions>(options: T): T;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,CAAC,SAAS,gBAAgB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAErF;AAED,wBAAgB,0BAA0B,CAAC,KAAK,CAAC,CAAC,SAAS,oBAAoB,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAEjG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,yBAAyB,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEzG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,iBAAiB,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAErG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,uBAAuB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAE1F"}

package/dist/hooks/index.d.ts

@@ -1,6 +1,7 @@
 export { useProducts } from './useProducts';
 export { useProduct } from './useProduct';
 export { useCategories } from './useCategories';
+export { useStorefront, useCatalog, useCart, useEnquiry, useStorefrontActions } from './useStorefront';
 export { useMyOrders } from './useMyOrders';
 export { useDiscountValidator } from './useDiscountValidator';
 //# sourceMappingURL=index.d.ts.map