@numueg/theme-sdk 0.9.0 → 0.10.0

package/dist/index.d.mts

@@ -3,8 +3,8 @@ export { A as Address, a as CartItem, O as Order, d as OrderItem, f as ProductIm
 import { T as ThemeSettingsV3, c as SectionInstance, M as MountResult, B as BlockInstance, b as BlockSchema, a as BlockProps$1, f as SectionSchema, e as SectionProps$1 } from './theme-CNTB4KnU.mjs';
 export { E as ExternalThemeMetadata, h as MAX_BLOCK_DEPTH, P as PageTemplate, i as PresetBlock, S as SectionGroup, d as SectionPreset, g as SettingDefinition } from './theme-CNTB4KnU.mjs';
 export { KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, REQUIRED_TEMPLATES, SDK_VERSION, THEME_CONTRACT_VERSION, ValidationIssue, ValidationResult, mergeResults, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema } from './validation.mjs';
-import { C as CartContextValue, L as LocalizationState, a as CurrencyState, T as ThemeMountContext, b as ThemeRenderArgs, M as MenuItemData } from './mount-NLjFNyBv.mjs';
-export { c as CartContext, d as CartMutationResult, e as CollectionContext, f as CurrencyConfig, g as CurrencyContext, h as CustomerContext, i as LocalizationContext, N as NavigationContext, P as PageContext, j as ProductContext, S as ShopContext, k as ThemeMountPage, l as ThemeSettingsContext, m as buildThemeElement, n as mountTheme } from './mount-NLjFNyBv.mjs';
+import { C as CartContextValue, L as LocalizationState, a as CurrencyState, T as ThemeMountContext, b as ThemeRenderArgs, M as MenuItemData } from './mount-eAhGgGtZ.mjs';
+export { c as CartContext, d as CartMutationResult, e as CollectionContext, f as CurrencyConfig, g as CurrencyContext, h as CustomerContext, i as LocalizationContext, N as NavigationContext, P as PageContext, j as ProductContext, S as ShopContext, k as ThemeMountPage, l as ThemeSettingsContext, m as buildThemeElement, n as mountTheme } from './mount-eAhGgGtZ.mjs';
 import * as react from 'react';
 import { ReactElement, ReactNode, ElementType, CSSProperties, ImgHTMLAttributes, AnchorHTMLAttributes, ButtonHTMLAttributes, HTMLAttributes, FormHTMLAttributes, ComponentType } from 'react';
 export { resolveThemeSettings } from './normalize.mjs';
@@ -928,10 +928,30 @@ interface UseVariantSelection {
  * Shopify's behavior. Themes that prefer "Choose your size" empty
  * state can pass `autoSelect: false`.
  */
-declare function useVariantSelection(product: Pick<Product, "options" | "variants">, opts?: {
+declare function useVariantSelection(product: Pick<Product, "options" | "variants"> & {
+    id?: string;
+}, opts?: {
     autoSelect?: boolean;
 }): UseVariantSelection;
 
+/**
+ * Live variant-picker selection registry.
+ *
+ * `useVariantSelection` publishes its current axis→value map here keyed by
+ * product id; `AddToCartButton` reads it back at click time. This is what
+ * lets the selection reach the cart even when no real variant row matches —
+ * legacy products keep their axes in attributes JSON with a single
+ * placeholder variant whose option_values is {}, so `findVariantByOptions`
+ * returns null and there'd otherwise be nothing to send.
+ *
+ * Module-scoped (not React context) on purpose: the hook instance lives in
+ * the theme's PDP section while the button may be a sibling — they share no
+ * provider of ours. Bounded: one entry per product id, last write wins.
+ */
+declare function publishVariantSelection(productId: string | undefined | null, selection: Record<string, string>): void;
+/** Latest non-empty selection for a product, or null. */
+declare function readVariantSelection(productId: string | undefined | null): Record<string, string> | null;
+
 /**
  * Gift card balance check — Phase 8.3.
  *
@@ -1516,27 +1536,66 @@ interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"
     to: string;
     children: ReactNode;
 }
+/**
+ * Event dispatched on `window` when a Link is clicked and eligible for
+ * client-side (soft) navigation. `detail.href` is the target path.
+ *
+ * Contract: the event is CANCELABLE. A host that can perform soft
+ * navigation (e.g. the Next.js storefront routing through its client
+ * router) listens for it and calls `event.preventDefault()` to claim
+ * the navigation. If no listener claims it, the Link falls back to
+ * default anchor behavior — a normal full-page navigation — so themes
+ * running under hosts without the bridge (older storefronts, the CLI
+ * dev server, static previews) keep working unchanged.
+ */
+declare const NAVIGATE_EVENT = "numu:navigate";
+interface NavigateEventDetail {
+    href: string;
+}
+/**
+ * Ask the host to soft-navigate to `href`. Returns true when a host
+ * listener claimed the navigation (the caller should suppress its own
+ * default behavior), false when no handler is present (the caller
+ * should fall back to a full navigation). Exposed for themes that
+ * navigate programmatically (e.g. after a search submit).
+ */
+declare function requestNavigate(href: string): boolean;
 /**
  * Route-aware <Link>. Themes write paths as `/products/<slug>` (matches
  * the production subdomain root). The storefront proxy rewrites those
  * under `/<subdomain>/...` in dev path-segment routing; in production
  * the subdomain hostname does the same job at the edge.
  *
- * For plain anchor behavior — server-rendered HTML, full page nav — we
- * just emit a regular `<a>`. Themes that want client-side transitions
- * can wrap this in their own router-aware component; in practice
- * storefront pages are SSR'd so a full nav is fine and predictable.
- *
- * External URLs (have a protocol or start with `//`) pass through
- * unchanged so social-media links, CDN paths, etc. work without
- * special casing.
- */
-declare function Link({ to, children, ...rest }: LinkProps): react.JSX.Element;
+ * Navigation is a two-tier contract:
+ *   1. Soft (preferred): on an eligible plain left-click we dispatch a
+ *      cancelable NAVIGATE_EVENT. A router-aware host claims it with
+ *      preventDefault() and performs a client-side transition — React,
+ *      the SDK runtime, and the evaluated theme bundle all stay warm,
+ *      so page-to-page moves skip the full document reload + remount.
+ *   2. Hard (fallback): no listener claims the event → default anchor
+ *      behavior, a normal full-page navigation. Identical to the
+ *      pre-0.10 behavior, so themes never break on hosts without the
+ *      bridge.
+ *
+ * Soft navigation is only attempted for storefront-internal paths and
+ * unmodified left-clicks: external URLs (protocol or `//`), hash-only
+ * anchors, modified clicks (ctrl/cmd/shift/alt — "open in new tab"),
+ * non-left buttons, `target` other than `_self`, and `download` links
+ * all keep default browser behavior.
+ */
+declare function Link({ to, children, onClick, ...rest }: LinkProps): react.JSX.Element;
 
 interface AddToCartButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onClick" | "disabled"> {
     product: Product;
     variant?: ProductVariant;
     quantity?: number;
+    /**
+     * Picker axes to persist on the cart line ({Color: "Black"}). Optional —
+     * when omitted, the button reads the live useVariantSelection state for
+     * this product from the SDK registry, so existing themes get the variant
+     * label end-to-end (cart → checkout → order → email) with no changes.
+     */
+    selectedOptions?: Record<string, string>;
     /** Custom labels — fallbacks are English defaults. */
     label?: ReactNode;
     loadingLabel?: ReactNode;
@@ -1559,7 +1618,7 @@ interface AddToCartButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonEleme
  * Doesn't trap navigation — for "buy now" flows that should redirect
  * to checkout, themes wrap this in their own `<a>` after onAdded.
  */
-declare function AddToCartButton({ product, variant, quantity, label, loadingLabel, soldOutLabel, errorLabel, onAdded, ...rest }: AddToCartButtonProps): react.JSX.Element;
+declare function AddToCartButton({ product, variant, quantity, selectedOptions, label, loadingLabel, soldOutLabel, errorLabel, onAdded, ...rest }: AddToCartButtonProps): react.JSX.Element;
 
 interface SectionProps extends HTMLAttributes<HTMLElement> {
     /** Section instance id (the order key in templates). Required for the
@@ -2400,4 +2459,4 @@ declare function pickTranslations(bundle: LocaleBundle, locale: string): LocaleM
  */
 declare function buildLocaleBundle<T extends Record<string, unknown>>(modules: T): LocaleBundle;
 
-export { AddToCartButton, type AddressInput, type AnalyticsApi, type AnalyticsPayload, type AppManifestBlock, type AppPayload, type AppState, Block, BlockInstance, BlockProps$1 as BlockProps, BlockSchema, type CacheFetcher, type CacheMutator, type CachedResource, type CachedResourceState, Cart, CartContextValue, type CheckoutAddress, type CheckoutApi, type CheckoutSessionState, type CheckoutStep, Collection, CollectionCard, type CollectionCardProps, type CollectionCardSlots, CollectionProvider, type ComputedStyleTokens, CurrencyState, CurrencySwitcher, type CurrencySwitcherProps, Customer, type CustomerAddress, type CustomerAddressesState, type DefineBlockInput, type DefineSectionInput, type DefinedBlock, type DefinedSection, type DynamicResolveContext, type DynamicSourceRef, EditableImage, type EditableImageProps, EditableText, type EditableTextProps, type FocalSrcOptions, Form, type GiftCardBalance, HeroMedia, type HeroMediaProps, ICON_NAMES, Icon, IconMap, type IconProps, Image, type ImageTransform, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, type LocaleBundle, type LocaleMessages, LocaleSwitcher, type LocaleSwitcherProps, Logo, type LogoProps, type LogoShape, type LogoSize, MenuItemData, Money, MountResult, type MutateOptions, type NavigationItem, type NavigationState, NuMuProvider, type OrderDetail, type OrderListEntry, type OrderListState, type OrderState, Page, type PlaceOrderResult, Product, ProductCard, type ProductCardProps, type ProductCardSlots, ProductProvider, ProductVariant, type RelatedProductsState, type ReorderResult, type ReorderSkipReason, type ReorderSkippedItem, RichText, type RichTextProps, type SearchResults, type SearchState, Section, SectionContext, type SectionGroupInstance, SectionInstance, SectionProps$1 as SectionProps, SectionSchema, type ShippingRateOption, type ShopWithHelpers, SizeChart, Store, type ThemeEntry, ThemeMountContext, ThemeRenderArgs, ThemeSettingsV3, type UseCachedResourceOptions, type UseGiftCardBalance, type UseReorder, type UseSearchOptions, type UseShippingRatesOptions, type UseShippingRatesState, type UseVariantSelection, type WishlistItem, type WishlistState, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, clearSdkSingleton, collectBlocks, collectSections, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, findVariantByOptions, flattenMessages, focalSrc, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, pickTranslations, registerReactSingleton, registerSdkSingleton, resolveDynamicValue, resolveFontStack, resolveSettingsMap, resolveSizeChart, resolveSourcePath, sanitizeHtml, useAnalytics, useApp, useCachedResource, useCart, useCheckout, useCollection, useCollectionOptional, useCollections, useCurrency, useCurrentTemplate, useCustomer, useCustomerActions, useCustomerAddresses, useDirection, useFieldTranslation, useGiftCardBalance, useImage, useLocale, useLocalization, useMoney, useNavigation, useNumberFormat, useOrder, useOrders, usePage, useProduct, useProductOptional, useProductSizeChart, useProducts, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionGroup, useSectionOptional, useShippingRates, useShop, useThemeSettings, useTranslation, useVariantSelection, useWishlist };
+export { AddToCartButton, type AddressInput, type AnalyticsApi, type AnalyticsPayload, type AppManifestBlock, type AppPayload, type AppState, Block, BlockInstance, BlockProps$1 as BlockProps, BlockSchema, type CacheFetcher, type CacheMutator, type CachedResource, type CachedResourceState, Cart, CartContextValue, type CheckoutAddress, type CheckoutApi, type CheckoutSessionState, type CheckoutStep, Collection, CollectionCard, type CollectionCardProps, type CollectionCardSlots, CollectionProvider, type ComputedStyleTokens, CurrencyState, CurrencySwitcher, type CurrencySwitcherProps, Customer, type CustomerAddress, type CustomerAddressesState, type DefineBlockInput, type DefineSectionInput, type DefinedBlock, type DefinedSection, type DynamicResolveContext, type DynamicSourceRef, EditableImage, type EditableImageProps, EditableText, type EditableTextProps, type FocalSrcOptions, Form, type GiftCardBalance, HeroMedia, type HeroMediaProps, ICON_NAMES, Icon, IconMap, type IconProps, Image, type ImageTransform, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, type LocaleBundle, type LocaleMessages, LocaleSwitcher, type LocaleSwitcherProps, Logo, type LogoProps, type LogoShape, type LogoSize, MenuItemData, Money, MountResult, type MutateOptions, NAVIGATE_EVENT, type NavigateEventDetail, type NavigationItem, type NavigationState, NuMuProvider, type OrderDetail, type OrderListEntry, type OrderListState, type OrderState, Page, type PlaceOrderResult, Product, ProductCard, type ProductCardProps, type ProductCardSlots, ProductProvider, ProductVariant, type RelatedProductsState, type ReorderResult, type ReorderSkipReason, type ReorderSkippedItem, RichText, type RichTextProps, type SearchResults, type SearchState, Section, SectionContext, type SectionGroupInstance, SectionInstance, SectionProps$1 as SectionProps, SectionSchema, type ShippingRateOption, type ShopWithHelpers, SizeChart, Store, type ThemeEntry, ThemeMountContext, ThemeRenderArgs, ThemeSettingsV3, type UseCachedResourceOptions, type UseGiftCardBalance, type UseReorder, type UseSearchOptions, type UseShippingRatesOptions, type UseShippingRatesState, type UseVariantSelection, type WishlistItem, type WishlistState, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, clearSdkSingleton, collectBlocks, collectSections, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, findVariantByOptions, flattenMessages, focalSrc, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, pickTranslations, publishVariantSelection, readVariantSelection, registerReactSingleton, registerSdkSingleton, requestNavigate, resolveDynamicValue, resolveFontStack, resolveSettingsMap, resolveSizeChart, resolveSourcePath, sanitizeHtml, useAnalytics, useApp, useCachedResource, useCart, useCheckout, useCollection, useCollectionOptional, useCollections, useCurrency, useCurrentTemplate, useCustomer, useCustomerActions, useCustomerAddresses, useDirection, useFieldTranslation, useGiftCardBalance, useImage, useLocale, useLocalization, useMoney, useNavigation, useNumberFormat, useOrder, useOrders, usePage, useProduct, useProductOptional, useProductSizeChart, useProducts, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionGroup, useSectionOptional, useShippingRates, useShop, useThemeSettings, useTranslation, useVariantSelection, useWishlist };

package/dist/index.d.ts

@@ -3,8 +3,8 @@ export { A as Address, a as CartItem, O as Order, d as OrderItem, f as ProductIm
 import { T as ThemeSettingsV3, c as SectionInstance, M as MountResult, B as BlockInstance, b as BlockSchema, a as BlockProps$1, f as SectionSchema, e as SectionProps$1 } from './theme-CNTB4KnU.js';
 export { E as ExternalThemeMetadata, h as MAX_BLOCK_DEPTH, P as PageTemplate, i as PresetBlock, S as SectionGroup, d as SectionPreset, g as SettingDefinition } from './theme-CNTB4KnU.js';
 export { KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, REQUIRED_TEMPLATES, SDK_VERSION, THEME_CONTRACT_VERSION, ValidationIssue, ValidationResult, mergeResults, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema } from './validation.js';
-import { C as CartContextValue, L as LocalizationState, a as CurrencyState, T as ThemeMountContext, b as ThemeRenderArgs, M as MenuItemData } from './mount-CM4kGg9w.js';
-export { c as CartContext, d as CartMutationResult, e as CollectionContext, f as CurrencyConfig, g as CurrencyContext, h as CustomerContext, i as LocalizationContext, N as NavigationContext, P as PageContext, j as ProductContext, S as ShopContext, k as ThemeMountPage, l as ThemeSettingsContext, m as buildThemeElement, n as mountTheme } from './mount-CM4kGg9w.js';
+import { C as CartContextValue, L as LocalizationState, a as CurrencyState, T as ThemeMountContext, b as ThemeRenderArgs, M as MenuItemData } from './mount-HbnOAYZ-.js';
+export { c as CartContext, d as CartMutationResult, e as CollectionContext, f as CurrencyConfig, g as CurrencyContext, h as CustomerContext, i as LocalizationContext, N as NavigationContext, P as PageContext, j as ProductContext, S as ShopContext, k as ThemeMountPage, l as ThemeSettingsContext, m as buildThemeElement, n as mountTheme } from './mount-HbnOAYZ-.js';
 import * as react from 'react';
 import { ReactElement, ReactNode, ElementType, CSSProperties, ImgHTMLAttributes, AnchorHTMLAttributes, ButtonHTMLAttributes, HTMLAttributes, FormHTMLAttributes, ComponentType } from 'react';
 export { resolveThemeSettings } from './normalize.js';
@@ -928,10 +928,30 @@ interface UseVariantSelection {
  * Shopify's behavior. Themes that prefer "Choose your size" empty
  * state can pass `autoSelect: false`.
  */
-declare function useVariantSelection(product: Pick<Product, "options" | "variants">, opts?: {
+declare function useVariantSelection(product: Pick<Product, "options" | "variants"> & {
+    id?: string;
+}, opts?: {
     autoSelect?: boolean;
 }): UseVariantSelection;
 
+/**
+ * Live variant-picker selection registry.
+ *
+ * `useVariantSelection` publishes its current axis→value map here keyed by
+ * product id; `AddToCartButton` reads it back at click time. This is what
+ * lets the selection reach the cart even when no real variant row matches —
+ * legacy products keep their axes in attributes JSON with a single
+ * placeholder variant whose option_values is {}, so `findVariantByOptions`
+ * returns null and there'd otherwise be nothing to send.
+ *
+ * Module-scoped (not React context) on purpose: the hook instance lives in
+ * the theme's PDP section while the button may be a sibling — they share no
+ * provider of ours. Bounded: one entry per product id, last write wins.
+ */
+declare function publishVariantSelection(productId: string | undefined | null, selection: Record<string, string>): void;
+/** Latest non-empty selection for a product, or null. */
+declare function readVariantSelection(productId: string | undefined | null): Record<string, string> | null;
+
 /**
  * Gift card balance check — Phase 8.3.
  *
@@ -1516,27 +1536,66 @@ interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"
     to: string;
     children: ReactNode;
 }
+/**
+ * Event dispatched on `window` when a Link is clicked and eligible for
+ * client-side (soft) navigation. `detail.href` is the target path.
+ *
+ * Contract: the event is CANCELABLE. A host that can perform soft
+ * navigation (e.g. the Next.js storefront routing through its client
+ * router) listens for it and calls `event.preventDefault()` to claim
+ * the navigation. If no listener claims it, the Link falls back to
+ * default anchor behavior — a normal full-page navigation — so themes
+ * running under hosts without the bridge (older storefronts, the CLI
+ * dev server, static previews) keep working unchanged.
+ */
+declare const NAVIGATE_EVENT = "numu:navigate";
+interface NavigateEventDetail {
+    href: string;
+}
+/**
+ * Ask the host to soft-navigate to `href`. Returns true when a host
+ * listener claimed the navigation (the caller should suppress its own
+ * default behavior), false when no handler is present (the caller
+ * should fall back to a full navigation). Exposed for themes that
+ * navigate programmatically (e.g. after a search submit).
+ */
+declare function requestNavigate(href: string): boolean;
 /**
  * Route-aware <Link>. Themes write paths as `/products/<slug>` (matches
  * the production subdomain root). The storefront proxy rewrites those
  * under `/<subdomain>/...` in dev path-segment routing; in production
  * the subdomain hostname does the same job at the edge.
  *
- * For plain anchor behavior — server-rendered HTML, full page nav — we
- * just emit a regular `<a>`. Themes that want client-side transitions
- * can wrap this in their own router-aware component; in practice
- * storefront pages are SSR'd so a full nav is fine and predictable.
- *
- * External URLs (have a protocol or start with `//`) pass through
- * unchanged so social-media links, CDN paths, etc. work without
- * special casing.
- */
-declare function Link({ to, children, ...rest }: LinkProps): react.JSX.Element;
+ * Navigation is a two-tier contract:
+ *   1. Soft (preferred): on an eligible plain left-click we dispatch a
+ *      cancelable NAVIGATE_EVENT. A router-aware host claims it with
+ *      preventDefault() and performs a client-side transition — React,
+ *      the SDK runtime, and the evaluated theme bundle all stay warm,
+ *      so page-to-page moves skip the full document reload + remount.
+ *   2. Hard (fallback): no listener claims the event → default anchor
+ *      behavior, a normal full-page navigation. Identical to the
+ *      pre-0.10 behavior, so themes never break on hosts without the
+ *      bridge.
+ *
+ * Soft navigation is only attempted for storefront-internal paths and
+ * unmodified left-clicks: external URLs (protocol or `//`), hash-only
+ * anchors, modified clicks (ctrl/cmd/shift/alt — "open in new tab"),
+ * non-left buttons, `target` other than `_self`, and `download` links
+ * all keep default browser behavior.
+ */
+declare function Link({ to, children, onClick, ...rest }: LinkProps): react.JSX.Element;
 
 interface AddToCartButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onClick" | "disabled"> {
     product: Product;
     variant?: ProductVariant;
     quantity?: number;
+    /**
+     * Picker axes to persist on the cart line ({Color: "Black"}). Optional —
+     * when omitted, the button reads the live useVariantSelection state for
+     * this product from the SDK registry, so existing themes get the variant
+     * label end-to-end (cart → checkout → order → email) with no changes.
+     */
+    selectedOptions?: Record<string, string>;
     /** Custom labels — fallbacks are English defaults. */
     label?: ReactNode;
     loadingLabel?: ReactNode;
@@ -1559,7 +1618,7 @@ interface AddToCartButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonEleme
  * Doesn't trap navigation — for "buy now" flows that should redirect
  * to checkout, themes wrap this in their own `<a>` after onAdded.
  */
-declare function AddToCartButton({ product, variant, quantity, label, loadingLabel, soldOutLabel, errorLabel, onAdded, ...rest }: AddToCartButtonProps): react.JSX.Element;
+declare function AddToCartButton({ product, variant, quantity, selectedOptions, label, loadingLabel, soldOutLabel, errorLabel, onAdded, ...rest }: AddToCartButtonProps): react.JSX.Element;
 
 interface SectionProps extends HTMLAttributes<HTMLElement> {
     /** Section instance id (the order key in templates). Required for the
@@ -2400,4 +2459,4 @@ declare function pickTranslations(bundle: LocaleBundle, locale: string): LocaleM
  */
 declare function buildLocaleBundle<T extends Record<string, unknown>>(modules: T): LocaleBundle;
 
-export { AddToCartButton, type AddressInput, type AnalyticsApi, type AnalyticsPayload, type AppManifestBlock, type AppPayload, type AppState, Block, BlockInstance, BlockProps$1 as BlockProps, BlockSchema, type CacheFetcher, type CacheMutator, type CachedResource, type CachedResourceState, Cart, CartContextValue, type CheckoutAddress, type CheckoutApi, type CheckoutSessionState, type CheckoutStep, Collection, CollectionCard, type CollectionCardProps, type CollectionCardSlots, CollectionProvider, type ComputedStyleTokens, CurrencyState, CurrencySwitcher, type CurrencySwitcherProps, Customer, type CustomerAddress, type CustomerAddressesState, type DefineBlockInput, type DefineSectionInput, type DefinedBlock, type DefinedSection, type DynamicResolveContext, type DynamicSourceRef, EditableImage, type EditableImageProps, EditableText, type EditableTextProps, type FocalSrcOptions, Form, type GiftCardBalance, HeroMedia, type HeroMediaProps, ICON_NAMES, Icon, IconMap, type IconProps, Image, type ImageTransform, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, type LocaleBundle, type LocaleMessages, LocaleSwitcher, type LocaleSwitcherProps, Logo, type LogoProps, type LogoShape, type LogoSize, MenuItemData, Money, MountResult, type MutateOptions, type NavigationItem, type NavigationState, NuMuProvider, type OrderDetail, type OrderListEntry, type OrderListState, type OrderState, Page, type PlaceOrderResult, Product, ProductCard, type ProductCardProps, type ProductCardSlots, ProductProvider, ProductVariant, type RelatedProductsState, type ReorderResult, type ReorderSkipReason, type ReorderSkippedItem, RichText, type RichTextProps, type SearchResults, type SearchState, Section, SectionContext, type SectionGroupInstance, SectionInstance, SectionProps$1 as SectionProps, SectionSchema, type ShippingRateOption, type ShopWithHelpers, SizeChart, Store, type ThemeEntry, ThemeMountContext, ThemeRenderArgs, ThemeSettingsV3, type UseCachedResourceOptions, type UseGiftCardBalance, type UseReorder, type UseSearchOptions, type UseShippingRatesOptions, type UseShippingRatesState, type UseVariantSelection, type WishlistItem, type WishlistState, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, clearSdkSingleton, collectBlocks, collectSections, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, findVariantByOptions, flattenMessages, focalSrc, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, pickTranslations, registerReactSingleton, registerSdkSingleton, resolveDynamicValue, resolveFontStack, resolveSettingsMap, resolveSizeChart, resolveSourcePath, sanitizeHtml, useAnalytics, useApp, useCachedResource, useCart, useCheckout, useCollection, useCollectionOptional, useCollections, useCurrency, useCurrentTemplate, useCustomer, useCustomerActions, useCustomerAddresses, useDirection, useFieldTranslation, useGiftCardBalance, useImage, useLocale, useLocalization, useMoney, useNavigation, useNumberFormat, useOrder, useOrders, usePage, useProduct, useProductOptional, useProductSizeChart, useProducts, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionGroup, useSectionOptional, useShippingRates, useShop, useThemeSettings, useTranslation, useVariantSelection, useWishlist };
+export { AddToCartButton, type AddressInput, type AnalyticsApi, type AnalyticsPayload, type AppManifestBlock, type AppPayload, type AppState, Block, BlockInstance, BlockProps$1 as BlockProps, BlockSchema, type CacheFetcher, type CacheMutator, type CachedResource, type CachedResourceState, Cart, CartContextValue, type CheckoutAddress, type CheckoutApi, type CheckoutSessionState, type CheckoutStep, Collection, CollectionCard, type CollectionCardProps, type CollectionCardSlots, CollectionProvider, type ComputedStyleTokens, CurrencyState, CurrencySwitcher, type CurrencySwitcherProps, Customer, type CustomerAddress, type CustomerAddressesState, type DefineBlockInput, type DefineSectionInput, type DefinedBlock, type DefinedSection, type DynamicResolveContext, type DynamicSourceRef, EditableImage, type EditableImageProps, EditableText, type EditableTextProps, type FocalSrcOptions, Form, type GiftCardBalance, HeroMedia, type HeroMediaProps, ICON_NAMES, Icon, IconMap, type IconProps, Image, type ImageTransform, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, type LocaleBundle, type LocaleMessages, LocaleSwitcher, type LocaleSwitcherProps, Logo, type LogoProps, type LogoShape, type LogoSize, MenuItemData, Money, MountResult, type MutateOptions, NAVIGATE_EVENT, type NavigateEventDetail, type NavigationItem, type NavigationState, NuMuProvider, type OrderDetail, type OrderListEntry, type OrderListState, type OrderState, Page, type PlaceOrderResult, Product, ProductCard, type ProductCardProps, type ProductCardSlots, ProductProvider, ProductVariant, type RelatedProductsState, type ReorderResult, type ReorderSkipReason, type ReorderSkippedItem, RichText, type RichTextProps, type SearchResults, type SearchState, Section, SectionContext, type SectionGroupInstance, SectionInstance, SectionProps$1 as SectionProps, SectionSchema, type ShippingRateOption, type ShopWithHelpers, SizeChart, Store, type ThemeEntry, ThemeMountContext, ThemeRenderArgs, ThemeSettingsV3, type UseCachedResourceOptions, type UseGiftCardBalance, type UseReorder, type UseSearchOptions, type UseShippingRatesOptions, type UseShippingRatesState, type UseVariantSelection, type WishlistItem, type WishlistState, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, clearSdkSingleton, collectBlocks, collectSections, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, findVariantByOptions, flattenMessages, focalSrc, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, pickTranslations, publishVariantSelection, readVariantSelection, registerReactSingleton, registerSdkSingleton, requestNavigate, resolveDynamicValue, resolveFontStack, resolveSettingsMap, resolveSizeChart, resolveSourcePath, sanitizeHtml, useAnalytics, useApp, useCachedResource, useCart, useCheckout, useCollection, useCollectionOptional, useCollections, useCurrency, useCurrentTemplate, useCustomer, useCustomerActions, useCustomerAddresses, useDirection, useFieldTranslation, useGiftCardBalance, useImage, useLocale, useLocalization, useMoney, useNavigation, useNumberFormat, useOrder, useOrders, usePage, useProduct, useProductOptional, useProductSizeChart, useProducts, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionGroup, useSectionOptional, useShippingRates, useShop, useThemeSettings, useTranslation, useVariantSelection, useWishlist };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 export { resolveThemeSettings } from './chunk-XF2FGIVS.mjs';
-export { KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, REQUIRED_TEMPLATES, SDK_VERSION, THEME_CONTRACT_VERSION, mergeResults, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema } from './chunk-JIAA7TGR.mjs';
-import { ShopContext, ThemeSettingsContext, CurrentTemplateContext, PageContext, LocalizationContext, CurrencyContext, CartContext, CustomerContext, NavigationContext, CollectionContext, ProductContext, useShop, useLocalization, useCustomer, useThemeSettings } from './chunk-PUR3FRGQ.mjs';
-export { CartContext, CollectionContext, CurrencyContext, CustomerContext, LocalizationContext, NavigationContext, PageContext, ProductContext, ShopContext, ThemeSettingsContext, useCollections, useCustomer, useDirection, useFieldTranslation, useLocale, useLocalization, useNumberFormat, usePage, useProducts, useShop, useThemeSettings, useTranslation } from './chunk-PUR3FRGQ.mjs';
+export { KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, REQUIRED_TEMPLATES, SDK_VERSION, THEME_CONTRACT_VERSION, mergeResults, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema } from './chunk-EB2ESBLD.mjs';
+import { ShopContext, ThemeSettingsContext, CurrentTemplateContext, PageContext, LocalizationContext, CurrencyContext, CartContext, CustomerContext, NavigationContext, CollectionContext, ProductContext, useShop, useLocalization, useCustomer, useThemeSettings } from './chunk-4TMO5Y5W.mjs';
+export { CartContext, CollectionContext, CurrencyContext, CustomerContext, LocalizationContext, NavigationContext, PageContext, ProductContext, ShopContext, ThemeSettingsContext, useCollections, useCustomer, useDirection, useFieldTranslation, useLocale, useLocalization, useNumberFormat, usePage, useProducts, useShop, useThemeSettings, useTranslation } from './chunk-4TMO5Y5W.mjs';
 import { createContext, forwardRef, useState, useImperativeHandle, useEffect, useCallback, useMemo, useRef, useContext, useSyncExternalStore, StrictMode, createElement, Component } from 'react';
 import { hydrateRoot, createRoot } from 'react-dom/client';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
@@ -1020,6 +1020,25 @@ function availableValues(product, selection) {
   }
   return out;
 }
+
+// src/utils/selectionRegistry.ts
+var selections = /* @__PURE__ */ new Map();
+function publishVariantSelection(productId, selection) {
+  if (!productId) return;
+  selections.set(productId, selection);
+}
+function readVariantSelection(productId) {
+  if (!productId) return null;
+  const sel = selections.get(productId);
+  if (!sel) return null;
+  const filtered = {};
+  for (const [k, v] of Object.entries(sel)) {
+    if (v) filtered[k] = v;
+  }
+  return Object.keys(filtered).length > 0 ? filtered : null;
+}
+
+// src/hooks/useVariantSelection.ts
 function useVariantSelection(product, opts = {}) {
   const autoSelect = opts.autoSelect ?? true;
   const initial = useMemo(() => {
@@ -1038,6 +1057,9 @@ function useVariantSelection(product, opts = {}) {
     () => findVariantByOptions(product, selection),
     [product, selection]
   );
+  useEffect(() => {
+    publishVariantSelection(product.id, selection);
+  }, [product.id, selection]);
   const availability = useMemo(
     () => availableValues(product, selection),
     [product, selection]
@@ -1705,13 +1727,15 @@ function NuMuProvider({
     [reserveToken, buildApplyCart]
   );
   const addItem = useCallback(
-    async (productId, variantId, quantity) => {
+    async (productId, variantId, quantity, selectedOptions) => {
       const eventId = typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : `${Date.now()}`;
       const qty = quantity || 1;
+      const axes = selectedOptions && Object.keys(selectedOptions).length > 0 ? selectedOptions : readVariantSelection(productId) ?? void 0;
       const result = await mutate("/api/cart/add", {
         product_id: productId,
         variant_id: variantId,
         quantity: qty,
+        selected_options: axes,
         _event_id: eventId
       });
       if (!result.ok) return result;
@@ -2608,19 +2632,40 @@ function Logo({
   );
 }
 var ABSOLUTE_URL = /^[a-z]+:|^\/\//i;
-function Link({ to, children, ...rest }) {
+var NAVIGATE_EVENT = "numu:navigate";
+function requestNavigate(href) {
+  if (typeof window === "undefined") return false;
+  const event = new CustomEvent(NAVIGATE_EVENT, {
+    detail: { href },
+    cancelable: true
+  });
+  return !window.dispatchEvent(event);
+}
+function Link({ to, children, onClick, ...rest }) {
   const shop = useShop();
   const isAbsolute = ABSOLUTE_URL.test(to);
   let href = to;
   if (!isAbsolute && shop && !to.startsWith("/")) {
     href = `/${to}`;
   }
-  return /* @__PURE__ */ jsx("a", { href, ...rest, children });
+  const handleClick = (e) => {
+    onClick?.(e);
+    if (e.defaultPrevented) return;
+    if (e.button !== 0) return;
+    if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+    if (rest.target && rest.target !== "_self") return;
+    if (rest.download !== void 0) return;
+    if (isAbsolute) return;
+    if (to.startsWith("#") || href.startsWith("#")) return;
+    if (requestNavigate(href)) e.preventDefault();
+  };
+  return /* @__PURE__ */ jsx("a", { href, onClick: handleClick, ...rest, children });
 }
 function AddToCartButton({
   product,
   variant,
   quantity = 1,
+  selectedOptions,
   label = "Add to cart",
   loadingLabel = "Adding\u2026",
   soldOutLabel = "Sold out",
@@ -2647,7 +2692,7 @@ function AddToCartButton({
     if (state === "adding") return;
     setState("adding");
     try {
-      await addItem(product.id, variant?.id, quantity);
+      await addItem(product.id, variant?.id, quantity, selectedOptions);
       setState("idle");
       onAdded?.(product, variant);
     } catch {
@@ -3744,6 +3789,6 @@ function buildLocaleBundle(modules) {
   return bundle;
 }
 
-export { AddToCartButton, Block, CollectionCard, CollectionProvider, CurrencySwitcher, EditableImage, EditableText, Form, HeroMedia, ICON_NAMES, Icon, IconMap, Image, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, LocaleSwitcher, Logo, MAX_BLOCK_DEPTH, Money, NuMuProvider, ProductCard, ProductProvider, RichText, Section, SectionContext, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, buildThemeElement, clearSdkSingleton, collectBlocks, collectSections, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, findVariantByOptions, flattenMessages, focalSrc, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, mountTheme, pickTranslations, registerReactSingleton, registerSdkSingleton, resolveDynamicValue, resolveFontStack, resolveSettingsMap, resolveSizeChart, resolveSourcePath, sanitizeHtml, useAnalytics, useApp, useCachedResource, useCart, useCheckout, useCollection, useCollectionOptional, useCurrency, useCurrentTemplate, useCustomerActions, useCustomerAddresses, useGiftCardBalance, useImage, useMoney, useNavigation, useOrder, useOrders, useProduct, useProductOptional, useProductSizeChart, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionGroup, useSectionOptional, useShippingRates, useVariantSelection, useWishlist };
+export { AddToCartButton, Block, CollectionCard, CollectionProvider, CurrencySwitcher, EditableImage, EditableText, Form, HeroMedia, ICON_NAMES, Icon, IconMap, Image, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, LocaleSwitcher, Logo, MAX_BLOCK_DEPTH, Money, NAVIGATE_EVENT, NuMuProvider, ProductCard, ProductProvider, RichText, Section, SectionContext, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, buildThemeElement, clearSdkSingleton, collectBlocks, collectSections, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, findVariantByOptions, flattenMessages, focalSrc, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, mountTheme, pickTranslations, publishVariantSelection, readVariantSelection, registerReactSingleton, registerSdkSingleton, requestNavigate, resolveDynamicValue, resolveFontStack, resolveSettingsMap, resolveSizeChart, resolveSourcePath, sanitizeHtml, useAnalytics, useApp, useCachedResource, useCart, useCheckout, useCollection, useCollectionOptional, useCurrency, useCurrentTemplate, useCustomerActions, useCustomerAddresses, useGiftCardBalance, useImage, useMoney, useNavigation, useOrder, useOrders, useProduct, useProductOptional, useProductSizeChart, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionGroup, useSectionOptional, useShippingRates, useVariantSelection, useWishlist };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map