@fayz-ai/storefront 0.9.0 → 0.11.0

package/dist/{component-contracts.d.ts → extend/component-contracts.d.ts}

@@ -1,9 +1,10 @@
 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';
-import type { CartState } from './stores/cart.store';
+import type { ProductOptionGroup, ProductOptionSelection } from '../data/product-options';
+import type { ResolvedStorefrontConfig, StorefrontCommerceMode } from '../document/config';
+import type { MediaCarouselItem } from '../blocks/sections';
+import type { CartState } from '../stores/cart.store';
+import type { ComponentOverride } from './component-override';
 export interface StorefrontComponentBaseProps {
     config: ResolvedStorefrontConfig;
     commerceMode: StorefrontCommerceMode;
@@ -17,9 +18,26 @@ export interface StorefrontActions {
     closeCart: () => void;
     createProductEnquiry: (input: CreateProductEnquiryInput) => Promise<ProductEnquiry>;
 }
+/**
+ * Which photo the CARD shows — the grid-side counterpart of
+ * {@link ProductGalleryOrder}.
+ *
+ *   primary   the first `is_primary` row, else the first row (the default;
+ *             byte-identical to what the card has always done)
+ *   position  the lowest `sortOrder`, ties broken by image id
+ *
+ * `position` exists because `is_primary` is not a unique constraint: artorious
+ * carries products with TWO primary rows, which made the card's pick depend on
+ * PostgREST's tie order — the same card could show a different photo between
+ * two loads. The gallery got `order` in M2; the card had no equivalent and a
+ * store fork was the only way to sort by position.
+ */
+export type ProductCardImageOrder = 'primary' | 'position';
 export interface ProductCardProps extends StorefrontComponentBaseProps {
     product: Product;
     actions: Pick<StorefrontActions, 'navigateTo' | 'addToCart' | 'openCart'>;
+    /** Defaults to 'primary' — see {@link ProductCardImageOrder}. */
+    imageOrder?: ProductCardImageOrder;
 }
 export interface ProductDetailProps extends StorefrontComponentBaseProps {
     product: Product;
@@ -35,10 +53,24 @@ export interface ProductDetailProps extends StorefrontComponentBaseProps {
     addToCart: () => void;
     openEnquiry: () => void;
 }
+/**
+ * Which photo leads the gallery.
+ *
+ *   primary   the merchant's pick: isPrimary first, then sortOrder ascending (default)
+ *   position  sortOrder ascending, ignoring the primary flag
+ *   newest    sortOrder descending — the most recently added photo leads
+ *
+ * `newest` exists because of a real fork: artorious reimplemented the entire
+ * 158-line gallery to change ONLY this rule (its Supabase rows carried two
+ * conflicting is_primary flags, so sort_order was the only trustworthy signal).
+ * A props-only override (`components.ProductGallery.props.order`) now does it.
+ */
+export type ProductGalleryOrder = 'primary' | 'position' | 'newest';
 export interface ProductGalleryProps extends StorefrontComponentBaseProps {
     product: Product;
     images: ProductImage[];
     primaryImage?: ProductImage;
+    order?: ProductGalleryOrder;
 }
 export interface ProductPriceProps extends StorefrontComponentBaseProps {
     product: Product;
@@ -115,24 +147,44 @@ export interface StorefrontStateProps extends StorefrontComponentBaseProps {
 export interface CartDrawerFooterExtraProps extends StorefrontComponentBaseProps {
     cart: CartState;
 }
+/**
+ * Code-level component replacements.
+ *
+ * Each entry accepts either the component (what stores write today) or
+ * `{ component?, props? }`. Passing only `props` keeps the SDK component and
+ * forces some of its props — which is what four of five customizing stores
+ * actually wanted when they replaced a whole card instead.
+ *
+ * Every field takes the union rather than only the two surfaces stores have
+ * overridden so far: "why can I pass props to ProductCard but not CategoryCard"
+ * is a worse surface than one extra type.
+ */
 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>;
-    CartDrawerFooterExtra?: React.ComponentType<CartDrawerFooterExtraProps>;
+    ProductCard?: ComponentOverride<ProductCardProps>;
+    ProductDetail?: ComponentOverride<ProductDetailProps>;
+    ProductGallery?: ComponentOverride<ProductGalleryProps>;
+    ProductPrice?: ComponentOverride<ProductPriceProps>;
+    ProductActions?: ComponentOverride<ProductActionsProps>;
+    ProductEnquiryForm?: ComponentOverride<ProductEnquiryFormContractProps>;
+    CategoryCard?: ComponentOverride<CategoryCardProps>;
+    CollectionSection?: ComponentOverride<CollectionSectionProps>;
+    HeroSection?: ComponentOverride<HeroSectionContractProps>;
+    MediaCarousel?: ComponentOverride<MediaCarouselProps>;
+    ProductSlider?: ComponentOverride<ProductSliderProps>;
+    Header?: ComponentOverride<StorefrontChromeProps>;
+    Footer?: ComponentOverride<StorefrontChromeProps>;
+    Shell?: ComponentOverride<StorefrontChromeProps>;
+    EmptyState?: ComponentOverride<StorefrontStateProps>;
+    LoadingState?: ComponentOverride<StorefrontStateProps>;
+    ErrorState?: ComponentOverride<StorefrontStateProps>;
+    CartDrawerFooterExtra?: ComponentOverride<CartDrawerFooterExtraProps>;
 }
+/**
+ * The override surface as a runtime value, for validators and catalogs: a
+ * store document referencing an unknown component slot must be told the valid
+ * set (I2), and a type alone cannot say it at runtime. The `satisfies` +
+ * exhaustiveness pair keeps this list impossible to leave stale when a key is
+ * added to {@link StorefrontComponents}.
+ */
+export declare const STOREFRONT_COMPONENT_KEYS: readonly ["ProductCard", "ProductDetail", "ProductGallery", "ProductPrice", "ProductActions", "ProductEnquiryForm", "CategoryCard", "CollectionSection", "HeroSection", "MediaCarousel", "ProductSlider", "Header", "Footer", "Shell", "EmptyState", "LoadingState", "ErrorState", "CartDrawerFooterExtra"];
 //# sourceMappingURL=component-contracts.d.ts.map

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

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

package/dist/extend/component-override.d.ts

@@ -0,0 +1,38 @@
+import type { ComponentType } from 'react';
+/**
+ * Either the whole component (what stores write today), or an adjustment.
+ *
+ * `{ props }` alone keeps the SDK component and forces some of its props.
+ * `{ component, props }` replaces it and pre-binds props — useful for a wrapper
+ * that needs a couple of fixed values.
+ */
+export type ComponentOverride<P> = ComponentType<P> | {
+    component?: ComponentType<P>;
+    /** Props forced on the component, overriding what the page passes. */
+    props?: Partial<P>;
+};
+export interface ResolvedOverride<P> {
+    Component: ComponentType<P>;
+    /** Props to apply last, so an override wins over what the page computed. */
+    props: Partial<P>;
+    /** True when the store replaced the component rather than adjusting it. */
+    replaced: boolean;
+}
+/**
+ * Normalize both override forms against the SDK's own component.
+ *
+ * Override props are applied AFTER the page's, deliberately: an override that
+ * could not win over a computed prop would be unable to change the thing the
+ * store is overriding it for.
+ */
+export declare function resolveOverride<P>(override: ComponentOverride<P> | undefined, fallback: ComponentType<P>): ResolvedOverride<P>;
+/**
+ * The component an override resolves to, or undefined when the store only
+ * adjusted props. Lets a page keep its existing `if (Override) …` branch, which
+ * exists because replacing a page body is structurally different from tweaking
+ * one of its props.
+ */
+export declare function overrideComponent<P>(override: ComponentOverride<P> | undefined): ComponentType<P> | undefined;
+/** The props an override forces, whether or not it also replaces the component. */
+export declare function overrideProps<P>(override: ComponentOverride<P> | undefined): Partial<P>;
+//# sourceMappingURL=component-override.d.ts.map

package/dist/extend/component-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-override.d.ts","sourceRoot":"","sources":["../../src/extend/component-override.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAiB1C;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAC3B,aAAa,CAAC,CAAC,CAAC,GAChB;IACE,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC5B,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACnB,CAAA;AAgBL,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC3B,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACjB,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,EAC1C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,gBAAgB,CAAC,CAAC,CAAC,CASrB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAI7G;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAGvF"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"component-selectors.d.ts","sourceRoot":"","sources":["../../src/extend/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/extend/editor-bridge.d.ts

@@ -0,0 +1,59 @@
+export interface EditorBridgeOptions {
+    /**
+     * Origins allowed to drive the picker. An activation from anywhere else is
+     * ignored. Required: there is no safe default, because the parent of an
+     * iframe is chosen by whoever embedded it.
+     */
+    allowedOrigins: readonly string[];
+    /** Test seam. Defaults to the ambient window. */
+    target?: Window;
+}
+export interface PickedBlock {
+    /** Dotted document path — what applyChange accepts and validateStore reports. */
+    path: string;
+    /** The block's registered type, so the parent can look up its schema. */
+    type: string;
+    /** Bounding rect of the block's first painted child, for the parent's overlay. */
+    rect?: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+}
+export declare const EDITOR_MESSAGES: {
+    readonly activate: "ACTIVATE_ELEMENT_PICKER";
+    readonly deactivate: "DEACTIVATE_ELEMENT_PICKER";
+    readonly ready: "ELEMENT_PICKER_READY";
+    readonly picked: "ELEMENT_PICKED";
+    readonly cancelled: "ELEMENT_PICKER_CANCELLED";
+    readonly navigation: "NAVIGATION_CHANGE";
+};
+/**
+ * The nearest ancestor that is a block, and the element that actually paints.
+ *
+ * The stamp lives on a `display: contents` wrapper, which has no box of its
+ * own — `getBoundingClientRect()` on it returns zeros. So the rect comes from
+ * its first element child, which is the block's real root.
+ */
+export declare function blockAt(element: Element | null): {
+    path: string;
+    type: string;
+    node: Element;
+} | null;
+/**
+ * Wire the storefront to an editor parent. Returns a teardown.
+ *
+ * Inert when the page is not framed: a storefront served to a shopper has
+ * `window.parent === window`, nothing is registered, and editor mode stays off.
+ */
+export declare function connectEditorBridge(options: EditorBridgeOptions): () => void;
+/**
+ * Tell the parent the route changed, so its URL bar follows the iframe.
+ *
+ * Silent until an allowed parent has activated the bridge — the path is not
+ * sensitive, but broadcasting to '*' from every storefront is a habit worth
+ * not forming.
+ */
+export declare function reportNavigation(path: string, parentOrigin: string | null, target?: Window): void;
+//# sourceMappingURL=editor-bridge.d.ts.map

package/dist/extend/editor-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-bridge.d.ts","sourceRoot":"","sources":["../../src/extend/editor-bridge.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAA;IACZ,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACpE;AAED,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAA;AAEV;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAWrG;AAQD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,IAAI,CA8E5E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAIjG"}

package/dist/extend/extension-points.d.ts

@@ -0,0 +1,103 @@
+import type { Product } from '@fayz-ai/shop/types';
+import type { CartLine } from '../stores/cart.store';
+export declare const CART_LINE_ANNOTATION_POINT = "cart.lineAnnotation";
+export declare const ORDER_METADATA_POINT = "order.metadata";
+export declare const PRODUCT_CARD_BADGE_POINT = "product.cardBadge";
+export declare const CHECKOUT_FIELD_POINT = "checkout.field";
+export declare const BEFORE_PLACE_ORDER_VALVE = "checkout.beforePlaceOrder";
+/** Input of cart.lineAnnotation — one cart line, serializable. */
+export interface CartLineAnnotationInput {
+    productId: string;
+    name: string;
+    quantity: number;
+    unitPrice: number;
+    slug?: string;
+    optionsLabel?: string;
+}
+/** Output of cart.lineAnnotation — one annotation chip under the line. */
+export interface CartLineAnnotation {
+    /** Stable machine key (namespacing is the handler id; this keys within it). */
+    key: string;
+    /** Shopper-facing text. */
+    label: string;
+    /** Optional machine value carried alongside the label. */
+    value?: string;
+}
+export interface OrderMetadataInput {
+    items: Array<{
+        productId: string;
+        quantity: number;
+        unitPrice: number;
+    }>;
+    subtotal: number;
+    customerEmail?: string;
+}
+export interface ProductCardBadgeInput {
+    id: string;
+    slug: string;
+    name: string;
+    price: number;
+    inventoryCount: number;
+    compareAtPrice?: number | null;
+}
+export interface ProductCardBadge {
+    text: string;
+    tone?: 'default' | 'accent' | 'warning';
+}
+export interface CheckoutFieldInput {
+    customerEmail?: string;
+}
+/** Output of checkout.field — one extra field the checkout form renders. The
+ *  captured value lands in the order metadata under the handler's namespace. */
+export interface CheckoutFieldContribution {
+    id: string;
+    label: string;
+    type: 'text' | 'checkbox';
+    required?: boolean;
+    placeholder?: string;
+}
+/** Input of the beforePlaceOrder escape valve — the serializable placement
+ *  intent, BEFORE the default provider path runs. */
+export interface BeforePlaceOrderContext {
+    items: Array<{
+        productId: string;
+        variantId?: string;
+        quantity: number;
+        optionsLabel?: string;
+    }>;
+    customer: {
+        name: string;
+        email: string;
+    };
+    currency?: string;
+    discountCode?: string;
+    shippingTotal?: number;
+    notes?: string;
+    customerId?: string;
+}
+/** Test seam — clears the whole extension registry (declarations AND
+ *  handlers) and re-arms registration, so one suite cannot leak handlers into
+ *  the next. Pairs with core's clearExtensionPoints. */
+export declare function resetStorefrontExtensionPoints(): void;
+/** Declare the storefront extension points. Idempotent; called wherever blocks
+ *  are registered, so describeStore and the runtime always agree on the set. */
+export declare function registerStorefrontExtensionPoints(): void;
+/** Run cart.lineAnnotation for one line → its annotations, handler-ordered. */
+export declare function getCartLineAnnotations(line: CartLine): Promise<CartLineAnnotation[]>;
+/** Run product.cardBadge for one product → its badges, handler-ordered. */
+export declare function getProductCardBadges(product: Product): Promise<ProductCardBadge[]>;
+/** Run checkout.field → the extra fields a checkout form should render. */
+export declare function getCheckoutFieldContributions(input?: CheckoutFieldInput): Promise<Array<CheckoutFieldContribution & {
+    handlerId: string;
+}>>;
+/**
+ * Run order.metadata → the namespaced metadata object for a new order, or
+ * undefined when nothing contributed. Namespacing by handler id is the
+ * WooCommerce ExtendSchema rule: two extensions cannot clobber each other.
+ */
+export declare function collectOrderMetadata(input: OrderMetadataInput): Promise<Record<string, unknown> | undefined>;
+/** Run the beforePlaceOrder valve. Null → take the default path. */
+export declare function runBeforePlaceOrderValve<TOrder extends {
+    id: string;
+}>(ctx: BeforePlaceOrderContext): Promise<TOrder | null>;
+//# sourceMappingURL=extension-points.d.ts.map

package/dist/extend/extension-points.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-points.d.ts","sourceRoot":"","sources":["../../src/extend/extension-points.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAgBpD,eAAO,MAAM,0BAA0B,wBAAwB,CAAA;AAC/D,eAAO,MAAM,oBAAoB,mBAAmB,CAAA;AACpD,eAAO,MAAM,wBAAwB,sBAAsB,CAAA;AAC3D,eAAO,MAAM,oBAAoB,mBAAmB,CAAA;AACpD,eAAO,MAAM,wBAAwB,8BAA8B,CAAA;AAInE,kEAAkE;AAClE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAA;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxE,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;gFACgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;qDACqD;AACrD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChG,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAID;;wDAEwD;AACxD,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD;AAED;gFACgF;AAChF,wBAAgB,iCAAiC,IAAI,IAAI,CA8KxD;AAID,+EAA+E;AAC/E,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAe1F;AAED,2EAA2E;AAC3E,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAexF;AAED,2EAA2E;AAC3E,wBAAsB,6BAA6B,CAAC,KAAK,GAAE,kBAAuB,GAAG,OAAO,CAC1F,KAAK,CAAC,yBAAyB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CACzD,CAOA;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAQlH;AAED,oEAAoE;AACpE,wBAAsB,wBAAwB,CAAC,MAAM,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC1E,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}

package/dist/extend/slots.d.ts

@@ -0,0 +1,216 @@
+import React from 'react';
+import type { Product } from '@fayz-ai/shop/types';
+import type { StorefrontBlockLike } from '../blocks/page-blocks';
+import type { CartLine } from '../stores/cart.store';
+/** What each slot area hands to the blocks inside it. */
+export interface StorefrontSlotContextMap {
+    productDetail: {
+        product: Product;
+        soldOut: boolean;
+        lowStock: boolean;
+        /** Percent off, or 0 when the product is not discounted. */
+        discountPct: number;
+    };
+    /**
+     * The card, which renders once per product in a grid — so its context is the
+     * one product that card is for, not the list.
+     */
+    productCard: {
+        product: Product;
+        soldOut: boolean;
+        onSale: boolean;
+        /** True when the product has variants, so quick-add routes to the PDP. */
+        hasOptions: boolean;
+    };
+    catalog: {
+        /** The products currently visible, after filters and search. */
+        products: readonly Product[];
+        /** True while the list is being fetched. */
+        loading: boolean;
+    };
+    cart: {
+        lines: readonly CartLine[];
+        subtotal: number;
+    };
+    checkout: {
+        subtotal: number;
+        total: number;
+    };
+    header: Record<string, never>;
+    footer: Record<string, never>;
+}
+export type StorefrontSlotArea = keyof StorefrontSlotContextMap;
+type SlotBlocks = readonly StorefrontBlockLike[];
+/**
+ * Where a store may graft blocks into an SDK page.
+ *
+ * Position names read as "where", not "what": `afterPrice` keeps meaning the
+ * same thing if the price stops being a `<Price>` and starts being something
+ * else, which a name like `priceBelowSlot` would not.
+ */
+export interface StorefrontSlots {
+    productDetail?: {
+        /** Between the breadcrumb and the product name. */
+        beforeTitle?: SlotBlocks;
+        /** Immediately under the product name, above the price. */
+        afterTitle?: SlotBlocks;
+        /** Under the price and discount badge. */
+        afterPrice?: SlotBlocks;
+        /** Under the description paragraph. */
+        afterDescription?: SlotBlocks;
+        /** Above the quantity + add-to-cart row. Where trust seals go. */
+        beforeAddToCart?: SlotBlocks;
+        /** Under the add-to-cart row, above the delivery estimate. */
+        afterAddToCart?: SlotBlocks;
+        /** Under the gallery column, in the left half of the page. */
+        afterGallery?: SlotBlocks;
+        /** Above the specification table, below the two-column fold. */
+        beforeSpecs?: SlotBlocks;
+        /** The bottom of the page, after related products. */
+        afterDetail?: SlotBlocks;
+    };
+    /**
+     * The product card, wherever it appears — grid, rail, slider, related.
+     *
+     * This is where the fleet actually hurt: four of five customizing stores
+     * forked a ~120-line card to add one thing to it, and each fork then lost
+     * something else (the sale badge, the variant guard, `commerceMode` gating,
+     * `theme.productCard` honouring).
+     */
+    productCard?: {
+        /** Above the image, full card width. */
+        top?: SlotBlocks;
+        /** Over the image. The container is `relative`; content positions itself. */
+        imageOverlay?: SlotBlocks;
+        /** Between the product name and the price row. */
+        afterName?: SlotBlocks;
+        /** Under the price row. */
+        underPrice?: SlotBlocks;
+    };
+    catalog?: {
+        /** Above the page heading. */
+        beforeHeading?: SlotBlocks;
+        /** Between the heading and the filters/grid row. */
+        beforeGrid?: SlotBlocks;
+        /** Inside the filter column, under the filters. */
+        afterFilters?: SlotBlocks;
+        /** Under the product grid. */
+        afterGrid?: SlotBlocks;
+    };
+    cart?: {
+        /** Above the line items. */
+        beforeLines?: SlotBlocks;
+        /** Between the lines and the totals. */
+        beforeSummary?: SlotBlocks;
+        /** Under the totals, around the checkout button. */
+        afterSummary?: SlotBlocks;
+    };
+    checkout?: {
+        /** Above the checkout form. */
+        beforeForm?: SlotBlocks;
+        /** Under the payment method selector. */
+        afterPaymentMethods?: SlotBlocks;
+        /** Under the whole form, around the place-order button. */
+        afterForm?: SlotBlocks;
+    };
+    header?: {
+        /**
+         * Left of the account/cart icons.
+         *
+         * Named for the actions row rather than for the header, because the header
+         * has three layout variants (default, centered, search) that place the logo
+         * differently. A slot "left of the logo" would land somewhere different in
+         * each one; the actions row is shared, so this position is the same in all
+         * three.
+         */
+        beforeActions?: SlotBlocks;
+        /** Right of the cart icon. */
+        afterActions?: SlotBlocks;
+        /** A full-width strip under the whole header, in every variant. */
+        belowNav?: SlotBlocks;
+    };
+    footer?: {
+        /** Above the footer columns. */
+        before?: SlotBlocks;
+        /** Under the footer columns, above the credit line. */
+        after?: SlotBlocks;
+    };
+}
+export interface SlotDescriptor {
+    area: StorefrontSlotArea;
+    name: string;
+    /** Dotted id used in diagnostics and docs. */
+    id: string;
+    /** Where this slot sits in the page. */
+    position: string;
+    /** Keys the blocks inside receive through `useSlotContext`. */
+    provides: readonly string[];
+    /**
+     * `stable` means a store in our fleet actually needed this position and paid
+     * for it by forking something; `experimental` means the position is plausible
+     * but unproven and may move or be removed in a minor.
+     *
+     * The distinction is not decoration. Every slot is a compatibility promise,
+     * and a surface that promises two dozen positions nobody asked for is a
+     * surface that cannot be changed later. FastStore marks unproven API with an
+     * `__experimental` prefix for the same reason; this is the same idea as a
+     * field, so `fayz upgrade` can tell a store which unproven slots it depends on.
+     */
+    stability: 'stable' | 'experimental';
+    /** For stable slots: the fork that proves the position was needed. */
+    evidence?: string;
+}
+/**
+ * Every slot, with its position, the context it provides, and whether a real
+ * store ever asked for it.
+ *
+ * Shipped as data rather than written in prose because a prose inventory drifts
+ * the first time a slot is added. The docs page and the agent's prompt both read
+ * this, so there is one list and it is the code's.
+ *
+ * Six slots are `stable`: a store in the fleet needed that exact position and
+ * paid for it by forking a page or a component. The rest are `experimental` —
+ * plausible positions with no proven demand yet. Marking them honestly is what
+ * keeps the surface changeable; a store that builds on one is told, by
+ * `fayz upgrade`, that it did.
+ */
+export declare const STOREFRONT_SLOTS: readonly SlotDescriptor[];
+export interface ListSlotsOptions {
+    area?: StorefrontSlotArea;
+    /** Keep only slots a store has actually proven it needs. */
+    stableOnly?: boolean;
+}
+/** The slot inventory, optionally narrowed. */
+export declare function listSlots(areaOrOptions?: StorefrontSlotArea | ListSlotsOptions): readonly SlotDescriptor[];
+/** The slots a store's config actually fills, with their stability. */
+export declare function usedSlots(slots: StorefrontSlots | undefined): readonly SlotDescriptor[];
+/**
+ * The context the surrounding slot provides.
+ *
+ * The type parameter is the caller's assertion about which area it is rendering
+ * in, which is as much as a registry-resolved block can be given: the block is
+ * looked up by string, so nothing at the call site knows its area statically.
+ * Returns null outside a slot, so a block can work both in a slot and in a page.
+ */
+export declare function useSlotContext<A extends StorefrontSlotArea>(): StorefrontSlotContextMap[A] | null;
+export interface SlotProps<A extends StorefrontSlotArea> {
+    area: A;
+    name: string;
+    context?: StorefrontSlotContextMap[A];
+}
+/**
+ * Render the blocks a store put in one slot.
+ *
+ * The slot reads its own content out of the config rather than being handed it,
+ * so a page places `<Slot area="productDetail" name="afterPrice" />` without
+ * threading `config.slots` down to every position. That matters because there
+ * are two dozen of these call sites and every threaded prop is a chance to wire
+ * one to the wrong slot.
+ *
+ * Renders nothing — not even a wrapper — when the slot is empty, which is the
+ * overwhelmingly common case. An always-present wrapper would change the layout
+ * of every page for every store that uses no slots at all.
+ */
+export declare function Slot<A extends StorefrontSlotArea>({ area, name, context }: SlotProps<A>): React.JSX.Element | null;
+export {};
+//# sourceMappingURL=slots.d.ts.map

package/dist/extend/slots.d.ts.map

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

package/dist/hooks/index.d.ts

@@ -1,7 +1,26 @@
-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';
+export { useProducts } from './use-products';
+export { useProduct } from './use-product';
+export { useCategories } from './use-categories';
+export { useCatalog } from './use-catalog';
+export { useStorefront } from './use-storefront';
+export { useStorefrontActions } from './use-storefront-actions';
+export { useStorefrontHead } from './use-storefront-head';
+export { useRegion } from './use-region';
+export { usePolicies } from './use-policies';
+export type { StorefrontRegion } from './use-region';
+export type { PolicyKind, StorefrontPolicy, UsePolicies } from './use-policies';
+export { useCart } from './use-cart';
+export { useCheckout } from './use-checkout';
+export { useDiscountValidator } from './use-discount-validator';
+export { usePaymentMethods } from './use-payment-methods';
+export { useShipping } from './use-shipping';
+export { useAddress } from './use-address';
+export type { CheckoutTotals, CheckoutSubmission, UseCheckout } from './use-checkout';
+export type { UsePaymentMethods } from './use-payment-methods';
+export type { UseShipping } from './use-shipping';
+export type { AddressLookupStatus, UseAddress } from './use-address';
+export { useOrder } from './use-order';
+export { useMyOrders } from './use-my-orders';
+export type { UseOrder } from './use-order';
+export { useEnquiry } from './use-enquiry';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACtG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG1C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG/E,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACrF,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}