@snowcone-app/sdk 0.1.12 → 0.1.13

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 export { createDevFetcher } from './dev-fetcher.cjs';
-import { O as OptionAttribute, a as OptionSelection, C as Combination, b as ComponentProps, F as FrameworkAdapter, c as ComponentDescriptor, d as ComponentState, e as ComponentContext, f as ComponentLifecycleHooks, E as EventHandler, g as FrameworkUtilities } from './websocket-B8_XAwWx.cjs';
-export { A as AdapterRegistry, M as MockupResult, P as ProductComponentContext, n as RealtimeMockupCallbacks, k as RealtimeMockupService, m as RealtimeMockupState, R as RenderResult, W as WebSocketConfig, l as WebSocketMessage, j as adapterRegistry, o as computeDisabledChoices, h as createComponent, i as defineComponent, p as deriveDefaultSelection, s as findBestCombination, q as getPricePreview, t as isOptionAvailable, r as resolveBestCombination } from './websocket-B8_XAwWx.cjs';
+import { PublicDesign, PublicFill, PublicOptions } from '@snowcone-app/mockup-url';
+import { O as OptionAttribute, a as OptionSelection, C as Combination, F as FrameworkAdapter, b as ComponentProps, c as ComponentDescriptor, d as ComponentState, e as ComponentContext, f as ComponentLifecycleHooks, E as EventHandler, g as FrameworkUtilities } from './websocket-Dum3OooZ.cjs';
+export { A as AdapterRegistry, M as MockupResult, P as ProductComponentContext, R as RealtimeMockupCallbacks, h as RealtimeMockupService, i as RealtimeMockupState, j as RenderResult, W as WebSocketConfig, k as WebSocketMessage, l as adapterRegistry, m as computeDisabledChoices, n as createComponent, o as defineComponent, p as deriveDefaultSelection, q as findBestCombination, r as getPricePreview, s as isOptionAvailable, t as resolveBestCombination } from './websocket-Dum3OooZ.cjs';
 
 interface CatalogProduct$2 {
     id: string;
@@ -34,8 +35,12 @@ interface CatalogProduct$2 {
             };
         };
         combinations?: {
-            price: number;
-            variantId: string;
+            price?: number;
+            variantId?: string;
+            /**
+             * A flat variant row. Carries `price`/`variantId` plus one entry per combination-affecting attribute, keyed by attribute name (e.g. {"Size":"M","Color":"Aqua"}).
+             */
+            [k: string]: string | number | undefined;
         }[];
         attributesList?: string[];
     };
@@ -58,9 +63,13 @@ interface CatalogProduct$2 {
     }[];
     placements?: {
         label: string;
-        type: 'image' | 'color';
-        width: number;
-        height: number;
+        /**
+         * URL-safe slug derived from `label` (e.g. "Left sleeve" -> "left_sleeve"). Used to address a placement in the public img/buy wire (asset.<key>, color.<key>).
+         */
+        key?: string;
+        type?: ('image' | 'color') | null;
+        width?: number | null;
+        height?: number | null;
         defaultScaleMode?: 'fill' | 'fit';
         fitMarginTop?: number;
         fitMarginRight?: number;
@@ -72,7 +81,7 @@ interface CatalogProduct$2 {
         offsetX?: number;
         offsetY?: number;
     }[];
-    defaultGvid?: string;
+    defaultGvid?: string | null;
 }
 
 /**
@@ -134,7 +143,7 @@ interface MaskOverride {
     id: string;
     blendConfig?: BlendConfig;
 }
-interface GetMockupUrlOptions {
+interface GetMockupUrlOptions$1 {
     design: DesignElement$1[];
     product: ProductSpec;
     effects?: Effects;
@@ -146,10 +155,11 @@ interface GetMockupUrlOptions {
 interface MockupServiceConfig {
     imageUrl?: string;
     signerUrl?: string;
-    accountId?: string;
+    /** Public Shop ID (= shop.id). Falls back to SNOWCONE_SHOP_ID env. */
+    shop?: string;
 }
 interface MockupService {
-    getMockupUrl(options: GetMockupUrlOptions): Promise<string>;
+    getMockupUrl(options: GetMockupUrlOptions$1): Promise<string>;
     getConfig(): MockupServiceConfig;
 }
 interface SignedUrlResponse {
@@ -166,6 +176,88 @@ interface RateLimitState {
     };
 }
 
+/** Default public host for the image-CDN model (ADR-0076). */
+declare const DEFAULT_MOCKUP_BASE = "https://img.snowcone.app";
+/**
+ * What fills one placement, re-exported from `@snowcone-app/mockup-url`:
+ *   - a bare `string` → an image URL (shorthand for `{ src }`),
+ *   - `{ src, align?, tile? }` → a positioned/tiled image,
+ *   - `{ color }` → a solid color (for `type:"color"` placements like a cap's Crown).
+ */
+type Fill = PublicFill;
+/** A design = placement key → {@link Fill}. */
+type Design = PublicDesign;
+/**
+ * Options for the code-first {@link getMockupUrl} form.
+ *
+ * Exactly one artwork source is expected for an image render: either a single
+ * default-placement `asset`, OR a multi-placement `design` map. `design` takes
+ * precedence if both are given.
+ */
+interface GetMockupUrlOptions {
+    /**
+     * Your **Shop ID** — the publishable token that identifies + bills the shop.
+     * Public and safe to expose (like Cloudinary's cloud name). This is your
+     * `shop.id`. Emitted on the URL as `&shop=`.
+     */
+    shop: string;
+    /**
+     * Single default-placement image — the get-started shorthand. Emitted as the
+     * readable `asset=` param. Ignored when {@link GetMockupUrlOptions.design} is
+     * supplied.
+     */
+    asset?: string;
+    /**
+     * Multi-placement design: a map of placement key → {@link Fill}. Emitted as
+     * the dotted `asset.<key>` / `color.<key>` / `tile.<key>` / `align.<key>`
+     * params. Takes precedence over `asset`.
+     */
+    design?: Design;
+    /**
+     * Variant option picks: attribute name → choice label (e.g. `{ size: "m" }`).
+     * Emitted as `opt.<attr>`. Matched case-insensitively by the resolver.
+     */
+    options?: PublicOptions;
+    /**
+     * Per-shop secret for L3 signed URLs. SERVER-SIDE ONLY — never ship to a
+     * browser. When present, an `&signature` HMAC is appended; the resolver
+     * verifies it.
+     */
+    secret?: string;
+    /** Override the public host. Default: `https://img.snowcone.app`. */
+    base?: string;
+    /** Display width override. */
+    width?: number;
+    /** Camera view / mockup scene override (`view=<mockupId>`). Emitted as `mockup=`. */
+    view?: string;
+    /** Specific mockup scene/angle override. Alias of {@link GetMockupUrlOptions.view}. */
+    mockup?: string;
+    /** Specific variant override (a resolved gvid). */
+    variant?: string;
+    /** Specific placement label override (only meaningful with a single `asset`). */
+    placement?: string;
+    /** Mockup canvas aspect ratio. Default 16:9 (omitted from the URL). */
+    aspect?: "16:9" | "2:3";
+}
+/**
+ * Build the public mockup image URL. Pure + synchronous — drop the result
+ * straight into an `<img src>`.
+ *
+ * Two call shapes:
+ *
+ *   // Code-first (preferred): productCode then options.
+ *   getMockupUrl("hoodie-black", { shop, asset });
+ *   getMockupUrl("KMYKUK", { shop, options: { size: "m" }, design: {…} });
+ *
+ *   // Legacy positional: (assetUrl, productCode, opts).
+ *   getMockupUrl(assetUrl, "hoodie-black", { shop });
+ *
+ * The query string is built by `buildPublicMockupUrl` (the shared single source
+ * of truth), never hand-rolled here.
+ */
+declare function getMockupUrl(productCode: string, opts: GetMockupUrlOptions): string;
+declare function getMockupUrl(assetUrl: string, productCode: string, opts: GetMockupUrlOptions): string;
+
 /**
  * Framework-agnostic state management utilities
  * Provides consistent state management patterns for React and Web Components
@@ -689,14 +781,6 @@ declare function filterImagePlacements(placements: Placement[]): Placement[];
  * Shared mockup URL generation logic for both React and Web Components
  */
 
-interface MockupConfig {
-    endpoint?: string;
-    mockupUrl?: string;
-    signerUrl?: string;
-    accountId?: string;
-    mode?: "mock" | "live";
-}
-
 interface MockupGenerationOptions {
     productId: string;
     mockupId: string;
@@ -718,14 +802,31 @@ interface MockupGenerationOptions {
  * Values are the selected option values
  */
 type UserSelection = Record<string, string>;
-declare function config(overrides?: MockupConfig): MockupConfig;
 /**
- * @deprecated Use `config` instead
+ * Config for the pure URL builder: the two things not on MockupGenerationOptions.
+ */
+interface BuildMockupUrlConfig {
+    /** Base of the renderer/CDN, e.g. https://cdn.snowcone.app */
+    mockupBaseUrl: string;
+    /** The shop's public Shop ID (= shop.id). */
+    shop: string;
+}
+/**
+ * Pure, deterministic, edge-safe builder for the canonical (UNSIGNED) mockup
+ * URL. The actual logic is the SINGLE SOURCE OF TRUTH in
+ * `@snowcone-app/mockup-url`, shared byte-for-byte with the edge resolve worker
+ * (`workers/mockup-resolver`) so signed URLs are stable CDN cache keys (ADR-0073
+ * §10). This thin wrapper preserves the SDK's public signature; it adds no
+ * logic of its own (the `maxWidthCache` lives in `mockupUrl`).
  */
-declare const resolveMockupConfig: typeof config;
+declare function buildMockupUrl(options: MockupGenerationOptions, cfg: BuildMockupUrlConfig): string;
 /**
- * Creates a mockup URL from the provided options
- * Uses configuration from config() which reads from environment/window
+ * Builds the canonical (UNSIGNED) mockup URL from generation options, resolving
+ * the base + account from `window.snowcone` / env. Used by the internal live
+ * preview path (realtime websocket renders sign internally; the static `<img>`
+ * developer flow uses {@link getMockupUrl} instead). No bypass token, no
+ * client-side signing — those were deleted with the image-CDN redesign
+ * (ADR-0075 §7).
  */
 declare function mockupUrl(options: MockupGenerationOptions): string;
 /**
@@ -870,7 +971,7 @@ declare function validateEffects(effects: Effects): ValidationResult;
 /**
  * Validates complete mockup URL options
  */
-declare function validateMockupOptions(options: GetMockupUrlOptions): ValidationResult;
+declare function validateMockupOptions(options: GetMockupUrlOptions$1): ValidationResult;
 /**
  * Helper function to format validation errors as a string
  */
@@ -2420,7 +2521,7 @@ interface SdkConfig {
         index?: string;
     };
 }
-interface MerchifyClient {
+interface SnowconeClient {
     catalog: {
         listProducts(config?: Partial<SdkConfig>): Promise<CatalogListResponse>;
         getProduct(idOrSlug: string, config?: Partial<SdkConfig>): Promise<CatalogProduct$2>;
@@ -2430,8 +2531,8 @@ interface MerchifyClient {
 declare function listProducts(config?: Partial<SdkConfig>): Promise<CatalogListResponse>;
 declare function getProduct(idOrSlug: string, config?: Partial<SdkConfig>): Promise<CatalogProduct$2>;
 /**
- * Create a unified Merchify client with catalog and mockup services
+ * Create a unified Snowcone client with catalog and mockup services
  */
-declare function createClient(config: SdkConfig): MerchifyClient;
+declare function createClient(config: SdkConfig): SnowconeClient;
 
-export { AbstractTemplateRenderer, type AddToCartOptions, Animations, type ArtSelectorContext, type ArtSelectorDescriptor, type ArtSelectorOptions, type ArtworkData, type AspectRatio, Attributes, type BaseDescriptor, type BlendConfig, type CartDetail, type CatalogListResponse, type CatalogProduct$2 as CatalogProduct, ClassNames, type ColorDesignElement, ColorPickerUtils, Combination, CommonProps, ComponentContext, type ComponentDefinition, ComponentDescriptor, ComponentEventManager, ComponentFactory, ComponentLifecycle, ComponentLifecycleHooks, type ComponentMetadata, ComponentProps, ComponentRegistry, ComponentState, type ComponentTemplate, ComponentTemplates, type ContainerDescriptor, ContextBridge, type ContextComparator, type ContextConsumer, ContextInjector, type ContextProviderConfig, type ContextSubscriber, ContextSynchronizer, DEFAULT_ARTWORK_URL, DEFAULT_ASPECT_RATIO, DEFAULT_COLOR, DEFAULT_PLACEMENT_DIMENSIONS, type Descriptor, type DesignElement, type DesignGenerationContext, type Effects, Elements, type ErrorContext, type ErrorHandler, ErrorManager, type EventDefinition, EventDelegator, EventEmitter, EventHandler, type EventListener, type EventPayload, Focus, FrameworkAdapter, FrameworkUtilities, type GetMockupUrlOptions, type ImageAlignment, type ImageDesignElement, type LifecycleHook, LifecycleManager, type LifecyclePhase, type LifecycleTransition, LitAdapter, type MaskOverride, type MerchifyClient, type MockupConfig, type MockupGenerationOptions, type MockupService, type MockupServiceConfig, OptionAttribute, type OptionChoice, type OptionChoiceRenderData, type OptionRenderData, OptionSelection, type Placement, type PlacementDesign, type ProductArtAlignmentContext, type ProductArtAlignmentDescriptor, type ProductArtAlignmentOptions, type ProductContext, type ProductContextEvents, ProductContextManager, type ProductData, type ProductFetcher, type ProductImageDescriptor, type ProductImageOptions, ProductLoader, type ProductMockupData, type ProductOptionChoice, type ProductOptionData, type ProductOptionsDescriptor, type ProductOptionsOptions, type ProductPlacement, type ProductPriceDescriptor, type ProductPriceOptions, ProductProps, type ProductSpec, type ProductTitleDescriptor, type ProductTitleOptions, type ProductVariant, type PropDefinition, type PropSchema, type PropType, PropertyManager, type RateLimitState, type RegularArtwork, type SdkConfig, type SeamlessPattern, type SignedUrlResponse, StandardComponents, StandardEvents, StateManager, type StateManagerOptions, type StateMiddleware, type StateSelector, type StateSubscriber, type StateUpdater, Styles, SvelteAdapter, SwatchUtils, type TagName, TemplateBuilder, type TemplateNode, type TemplateNodeType, type TemplateRenderer, type TextDescriptor, type TileCount, UniversalContextProvider, type UserSelection, type ValidationError, type ValidationResult, VueAdapter, autoRegister, componentRegistry, config, createAddToCartEvent, createAddToCartHandler, createCartDetail, createClient, createContextProvider, createDesignForPlacements, createErrorHandler, createEventManager, createLifecycle, createLitComponent, createProductContext, createProductLoader, createPropertyManager, createStateHook, createStateStore, createSvelteComponent, createUniversalProvider, createVueComponent, describeArtSelector, describeProductArtAlignment, describeProductImage, describeProductOptions, describeProductPrice, describeProductTitle, extractProductId, filterImagePlacements, findClosestSnapPoint, findVariantForSelection, formatPrice, formatValidationErrors, getDefaultVariantId, getEffectiveAlignment, getIncompleteSelectionMessage, getMissingSelections, getOptionRenderType, getProduct, getSelectionDisplayText, getSnapPoints, getVariant, handleOptionChange, isSelectionComplete, isValidAlignment, isValidTileCount, listProducts, mockupUrl, normalizeChoice, prepareOptionRenderData, registerStandardComponents, resolveMockupConfig, resolveMockupId, resolveVariantId, retryOperation, simulateCartOperation, toCombinations, toOptionAttributes, useFrameworkAdapter as useVueAdapter, validateAlignment, validateDesignElement, validateEffects, validateImageUrl, validateMockupOptions, validateProductSelection, validateProductSpec, validateRequiredOptions, validateTileCount, withContext, withErrorHandling, withSyncErrorHandling };
+export { AbstractTemplateRenderer, type AddToCartOptions, Animations, type ArtSelectorContext, type ArtSelectorDescriptor, type ArtSelectorOptions, type ArtworkData, type AspectRatio, Attributes, type BaseDescriptor, type BlendConfig, type BuildMockupUrlConfig, type CartDetail, type CatalogListResponse, type CatalogProduct$2 as CatalogProduct, ClassNames, type ColorDesignElement, ColorPickerUtils, Combination, CommonProps, ComponentContext, type ComponentDefinition, ComponentDescriptor, ComponentEventManager, ComponentFactory, ComponentLifecycle, ComponentLifecycleHooks, type ComponentMetadata, ComponentProps, ComponentRegistry, ComponentState, type ComponentTemplate, ComponentTemplates, type ContainerDescriptor, ContextBridge, type ContextComparator, type ContextConsumer, ContextInjector, type ContextProviderConfig, type ContextSubscriber, ContextSynchronizer, DEFAULT_ARTWORK_URL, DEFAULT_ASPECT_RATIO, DEFAULT_COLOR, DEFAULT_MOCKUP_BASE, DEFAULT_PLACEMENT_DIMENSIONS, type Descriptor, type Design, type DesignElement, type DesignGenerationContext, type Effects, Elements, type ErrorContext, type ErrorHandler, ErrorManager, type EventDefinition, EventDelegator, EventEmitter, EventHandler, type EventListener, type EventPayload, type Fill, Focus, FrameworkAdapter, FrameworkUtilities, type GetMockupUrlOptions, type ImageAlignment, type ImageDesignElement, type LifecycleHook, LifecycleManager, type LifecyclePhase, type LifecycleTransition, LitAdapter, type MaskOverride, type MockupGenerationOptions, type MockupService, type MockupServiceConfig, OptionAttribute, type OptionChoice, type OptionChoiceRenderData, type OptionRenderData, OptionSelection, type Placement, type PlacementDesign, type ProductArtAlignmentContext, type ProductArtAlignmentDescriptor, type ProductArtAlignmentOptions, type ProductContext, type ProductContextEvents, ProductContextManager, type ProductData, type ProductFetcher, type ProductImageDescriptor, type ProductImageOptions, ProductLoader, type ProductMockupData, type ProductOptionChoice, type ProductOptionData, type ProductOptionsDescriptor, type ProductOptionsOptions, type ProductPlacement, type ProductPriceDescriptor, type ProductPriceOptions, ProductProps, type ProductSpec, type ProductTitleDescriptor, type ProductTitleOptions, type ProductVariant, type PropDefinition, type PropSchema, type PropType, PropertyManager, type RateLimitState, type RegularArtwork, type SdkConfig, type SeamlessPattern, type SignedUrlResponse, type SnowconeClient, StandardComponents, StandardEvents, StateManager, type StateManagerOptions, type StateMiddleware, type StateSelector, type StateSubscriber, type StateUpdater, Styles, SvelteAdapter, SwatchUtils, type TagName, TemplateBuilder, type TemplateNode, type TemplateNodeType, type TemplateRenderer, type TextDescriptor, type TileCount, UniversalContextProvider, type UserSelection, type ValidationError, type ValidationResult, VueAdapter, autoRegister, buildMockupUrl, componentRegistry, createAddToCartEvent, createAddToCartHandler, createCartDetail, createClient, createContextProvider, createDesignForPlacements, createErrorHandler, createEventManager, createLifecycle, createLitComponent, createProductContext, createProductLoader, createPropertyManager, createStateHook, createStateStore, createSvelteComponent, createUniversalProvider, createVueComponent, describeArtSelector, describeProductArtAlignment, describeProductImage, describeProductOptions, describeProductPrice, describeProductTitle, extractProductId, filterImagePlacements, findClosestSnapPoint, findVariantForSelection, formatPrice, formatValidationErrors, getDefaultVariantId, getEffectiveAlignment, getIncompleteSelectionMessage, getMissingSelections, getMockupUrl, getOptionRenderType, getProduct, getSelectionDisplayText, getSnapPoints, getVariant, handleOptionChange, isSelectionComplete, isValidAlignment, isValidTileCount, listProducts, mockupUrl, normalizeChoice, prepareOptionRenderData, registerStandardComponents, resolveMockupId, resolveVariantId, retryOperation, simulateCartOperation, toCombinations, toOptionAttributes, useFrameworkAdapter as useVueAdapter, validateAlignment, validateDesignElement, validateEffects, validateImageUrl, validateMockupOptions, validateProductSelection, validateProductSpec, validateRequiredOptions, validateTileCount, withContext, withErrorHandling, withSyncErrorHandling };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { createDevFetcher } from './dev-fetcher.js';
-import { O as OptionAttribute, a as OptionSelection, C as Combination, b as ComponentProps, F as FrameworkAdapter, c as ComponentDescriptor, d as ComponentState, e as ComponentContext, f as ComponentLifecycleHooks, E as EventHandler, g as FrameworkUtilities } from './websocket-B8_XAwWx.js';
-export { A as AdapterRegistry, M as MockupResult, P as ProductComponentContext, n as RealtimeMockupCallbacks, k as RealtimeMockupService, m as RealtimeMockupState, R as RenderResult, W as WebSocketConfig, l as WebSocketMessage, j as adapterRegistry, o as computeDisabledChoices, h as createComponent, i as defineComponent, p as deriveDefaultSelection, s as findBestCombination, q as getPricePreview, t as isOptionAvailable, r as resolveBestCombination } from './websocket-B8_XAwWx.js';
+import { PublicDesign, PublicFill, PublicOptions } from '@snowcone-app/mockup-url';
+import { O as OptionAttribute, a as OptionSelection, C as Combination, F as FrameworkAdapter, b as ComponentProps, c as ComponentDescriptor, d as ComponentState, e as ComponentContext, f as ComponentLifecycleHooks, E as EventHandler, g as FrameworkUtilities } from './websocket-Dum3OooZ.js';
+export { A as AdapterRegistry, M as MockupResult, P as ProductComponentContext, R as RealtimeMockupCallbacks, h as RealtimeMockupService, i as RealtimeMockupState, j as RenderResult, W as WebSocketConfig, k as WebSocketMessage, l as adapterRegistry, m as computeDisabledChoices, n as createComponent, o as defineComponent, p as deriveDefaultSelection, q as findBestCombination, r as getPricePreview, s as isOptionAvailable, t as resolveBestCombination } from './websocket-Dum3OooZ.js';
 
 interface CatalogProduct$2 {
     id: string;
@@ -34,8 +35,12 @@ interface CatalogProduct$2 {
             };
         };
         combinations?: {
-            price: number;
-            variantId: string;
+            price?: number;
+            variantId?: string;
+            /**
+             * A flat variant row. Carries `price`/`variantId` plus one entry per combination-affecting attribute, keyed by attribute name (e.g. {"Size":"M","Color":"Aqua"}).
+             */
+            [k: string]: string | number | undefined;
         }[];
         attributesList?: string[];
     };
@@ -58,9 +63,13 @@ interface CatalogProduct$2 {
     }[];
     placements?: {
         label: string;
-        type: 'image' | 'color';
-        width: number;
-        height: number;
+        /**
+         * URL-safe slug derived from `label` (e.g. "Left sleeve" -> "left_sleeve"). Used to address a placement in the public img/buy wire (asset.<key>, color.<key>).
+         */
+        key?: string;
+        type?: ('image' | 'color') | null;
+        width?: number | null;
+        height?: number | null;
         defaultScaleMode?: 'fill' | 'fit';
         fitMarginTop?: number;
         fitMarginRight?: number;
@@ -72,7 +81,7 @@ interface CatalogProduct$2 {
         offsetX?: number;
         offsetY?: number;
     }[];
-    defaultGvid?: string;
+    defaultGvid?: string | null;
 }
 
 /**
@@ -134,7 +143,7 @@ interface MaskOverride {
     id: string;
     blendConfig?: BlendConfig;
 }
-interface GetMockupUrlOptions {
+interface GetMockupUrlOptions$1 {
     design: DesignElement$1[];
     product: ProductSpec;
     effects?: Effects;
@@ -146,10 +155,11 @@ interface GetMockupUrlOptions {
 interface MockupServiceConfig {
     imageUrl?: string;
     signerUrl?: string;
-    accountId?: string;
+    /** Public Shop ID (= shop.id). Falls back to SNOWCONE_SHOP_ID env. */
+    shop?: string;
 }
 interface MockupService {
-    getMockupUrl(options: GetMockupUrlOptions): Promise<string>;
+    getMockupUrl(options: GetMockupUrlOptions$1): Promise<string>;
     getConfig(): MockupServiceConfig;
 }
 interface SignedUrlResponse {
@@ -166,6 +176,88 @@ interface RateLimitState {
     };
 }
 
+/** Default public host for the image-CDN model (ADR-0076). */
+declare const DEFAULT_MOCKUP_BASE = "https://img.snowcone.app";
+/**
+ * What fills one placement, re-exported from `@snowcone-app/mockup-url`:
+ *   - a bare `string` → an image URL (shorthand for `{ src }`),
+ *   - `{ src, align?, tile? }` → a positioned/tiled image,
+ *   - `{ color }` → a solid color (for `type:"color"` placements like a cap's Crown).
+ */
+type Fill = PublicFill;
+/** A design = placement key → {@link Fill}. */
+type Design = PublicDesign;
+/**
+ * Options for the code-first {@link getMockupUrl} form.
+ *
+ * Exactly one artwork source is expected for an image render: either a single
+ * default-placement `asset`, OR a multi-placement `design` map. `design` takes
+ * precedence if both are given.
+ */
+interface GetMockupUrlOptions {
+    /**
+     * Your **Shop ID** — the publishable token that identifies + bills the shop.
+     * Public and safe to expose (like Cloudinary's cloud name). This is your
+     * `shop.id`. Emitted on the URL as `&shop=`.
+     */
+    shop: string;
+    /**
+     * Single default-placement image — the get-started shorthand. Emitted as the
+     * readable `asset=` param. Ignored when {@link GetMockupUrlOptions.design} is
+     * supplied.
+     */
+    asset?: string;
+    /**
+     * Multi-placement design: a map of placement key → {@link Fill}. Emitted as
+     * the dotted `asset.<key>` / `color.<key>` / `tile.<key>` / `align.<key>`
+     * params. Takes precedence over `asset`.
+     */
+    design?: Design;
+    /**
+     * Variant option picks: attribute name → choice label (e.g. `{ size: "m" }`).
+     * Emitted as `opt.<attr>`. Matched case-insensitively by the resolver.
+     */
+    options?: PublicOptions;
+    /**
+     * Per-shop secret for L3 signed URLs. SERVER-SIDE ONLY — never ship to a
+     * browser. When present, an `&signature` HMAC is appended; the resolver
+     * verifies it.
+     */
+    secret?: string;
+    /** Override the public host. Default: `https://img.snowcone.app`. */
+    base?: string;
+    /** Display width override. */
+    width?: number;
+    /** Camera view / mockup scene override (`view=<mockupId>`). Emitted as `mockup=`. */
+    view?: string;
+    /** Specific mockup scene/angle override. Alias of {@link GetMockupUrlOptions.view}. */
+    mockup?: string;
+    /** Specific variant override (a resolved gvid). */
+    variant?: string;
+    /** Specific placement label override (only meaningful with a single `asset`). */
+    placement?: string;
+    /** Mockup canvas aspect ratio. Default 16:9 (omitted from the URL). */
+    aspect?: "16:9" | "2:3";
+}
+/**
+ * Build the public mockup image URL. Pure + synchronous — drop the result
+ * straight into an `<img src>`.
+ *
+ * Two call shapes:
+ *
+ *   // Code-first (preferred): productCode then options.
+ *   getMockupUrl("hoodie-black", { shop, asset });
+ *   getMockupUrl("KMYKUK", { shop, options: { size: "m" }, design: {…} });
+ *
+ *   // Legacy positional: (assetUrl, productCode, opts).
+ *   getMockupUrl(assetUrl, "hoodie-black", { shop });
+ *
+ * The query string is built by `buildPublicMockupUrl` (the shared single source
+ * of truth), never hand-rolled here.
+ */
+declare function getMockupUrl(productCode: string, opts: GetMockupUrlOptions): string;
+declare function getMockupUrl(assetUrl: string, productCode: string, opts: GetMockupUrlOptions): string;
+
 /**
  * Framework-agnostic state management utilities
  * Provides consistent state management patterns for React and Web Components
@@ -689,14 +781,6 @@ declare function filterImagePlacements(placements: Placement[]): Placement[];
  * Shared mockup URL generation logic for both React and Web Components
  */
 
-interface MockupConfig {
-    endpoint?: string;
-    mockupUrl?: string;
-    signerUrl?: string;
-    accountId?: string;
-    mode?: "mock" | "live";
-}
-
 interface MockupGenerationOptions {
     productId: string;
     mockupId: string;
@@ -718,14 +802,31 @@ interface MockupGenerationOptions {
  * Values are the selected option values
  */
 type UserSelection = Record<string, string>;
-declare function config(overrides?: MockupConfig): MockupConfig;
 /**
- * @deprecated Use `config` instead
+ * Config for the pure URL builder: the two things not on MockupGenerationOptions.
+ */
+interface BuildMockupUrlConfig {
+    /** Base of the renderer/CDN, e.g. https://cdn.snowcone.app */
+    mockupBaseUrl: string;
+    /** The shop's public Shop ID (= shop.id). */
+    shop: string;
+}
+/**
+ * Pure, deterministic, edge-safe builder for the canonical (UNSIGNED) mockup
+ * URL. The actual logic is the SINGLE SOURCE OF TRUTH in
+ * `@snowcone-app/mockup-url`, shared byte-for-byte with the edge resolve worker
+ * (`workers/mockup-resolver`) so signed URLs are stable CDN cache keys (ADR-0073
+ * §10). This thin wrapper preserves the SDK's public signature; it adds no
+ * logic of its own (the `maxWidthCache` lives in `mockupUrl`).
  */
-declare const resolveMockupConfig: typeof config;
+declare function buildMockupUrl(options: MockupGenerationOptions, cfg: BuildMockupUrlConfig): string;
 /**
- * Creates a mockup URL from the provided options
- * Uses configuration from config() which reads from environment/window
+ * Builds the canonical (UNSIGNED) mockup URL from generation options, resolving
+ * the base + account from `window.snowcone` / env. Used by the internal live
+ * preview path (realtime websocket renders sign internally; the static `<img>`
+ * developer flow uses {@link getMockupUrl} instead). No bypass token, no
+ * client-side signing — those were deleted with the image-CDN redesign
+ * (ADR-0075 §7).
  */
 declare function mockupUrl(options: MockupGenerationOptions): string;
 /**
@@ -870,7 +971,7 @@ declare function validateEffects(effects: Effects): ValidationResult;
 /**
  * Validates complete mockup URL options
  */
-declare function validateMockupOptions(options: GetMockupUrlOptions): ValidationResult;
+declare function validateMockupOptions(options: GetMockupUrlOptions$1): ValidationResult;
 /**
  * Helper function to format validation errors as a string
  */
@@ -2420,7 +2521,7 @@ interface SdkConfig {
         index?: string;
     };
 }
-interface MerchifyClient {
+interface SnowconeClient {
     catalog: {
         listProducts(config?: Partial<SdkConfig>): Promise<CatalogListResponse>;
         getProduct(idOrSlug: string, config?: Partial<SdkConfig>): Promise<CatalogProduct$2>;
@@ -2430,8 +2531,8 @@ interface MerchifyClient {
 declare function listProducts(config?: Partial<SdkConfig>): Promise<CatalogListResponse>;
 declare function getProduct(idOrSlug: string, config?: Partial<SdkConfig>): Promise<CatalogProduct$2>;
 /**
- * Create a unified Merchify client with catalog and mockup services
+ * Create a unified Snowcone client with catalog and mockup services
  */
-declare function createClient(config: SdkConfig): MerchifyClient;
+declare function createClient(config: SdkConfig): SnowconeClient;
 
-export { AbstractTemplateRenderer, type AddToCartOptions, Animations, type ArtSelectorContext, type ArtSelectorDescriptor, type ArtSelectorOptions, type ArtworkData, type AspectRatio, Attributes, type BaseDescriptor, type BlendConfig, type CartDetail, type CatalogListResponse, type CatalogProduct$2 as CatalogProduct, ClassNames, type ColorDesignElement, ColorPickerUtils, Combination, CommonProps, ComponentContext, type ComponentDefinition, ComponentDescriptor, ComponentEventManager, ComponentFactory, ComponentLifecycle, ComponentLifecycleHooks, type ComponentMetadata, ComponentProps, ComponentRegistry, ComponentState, type ComponentTemplate, ComponentTemplates, type ContainerDescriptor, ContextBridge, type ContextComparator, type ContextConsumer, ContextInjector, type ContextProviderConfig, type ContextSubscriber, ContextSynchronizer, DEFAULT_ARTWORK_URL, DEFAULT_ASPECT_RATIO, DEFAULT_COLOR, DEFAULT_PLACEMENT_DIMENSIONS, type Descriptor, type DesignElement, type DesignGenerationContext, type Effects, Elements, type ErrorContext, type ErrorHandler, ErrorManager, type EventDefinition, EventDelegator, EventEmitter, EventHandler, type EventListener, type EventPayload, Focus, FrameworkAdapter, FrameworkUtilities, type GetMockupUrlOptions, type ImageAlignment, type ImageDesignElement, type LifecycleHook, LifecycleManager, type LifecyclePhase, type LifecycleTransition, LitAdapter, type MaskOverride, type MerchifyClient, type MockupConfig, type MockupGenerationOptions, type MockupService, type MockupServiceConfig, OptionAttribute, type OptionChoice, type OptionChoiceRenderData, type OptionRenderData, OptionSelection, type Placement, type PlacementDesign, type ProductArtAlignmentContext, type ProductArtAlignmentDescriptor, type ProductArtAlignmentOptions, type ProductContext, type ProductContextEvents, ProductContextManager, type ProductData, type ProductFetcher, type ProductImageDescriptor, type ProductImageOptions, ProductLoader, type ProductMockupData, type ProductOptionChoice, type ProductOptionData, type ProductOptionsDescriptor, type ProductOptionsOptions, type ProductPlacement, type ProductPriceDescriptor, type ProductPriceOptions, ProductProps, type ProductSpec, type ProductTitleDescriptor, type ProductTitleOptions, type ProductVariant, type PropDefinition, type PropSchema, type PropType, PropertyManager, type RateLimitState, type RegularArtwork, type SdkConfig, type SeamlessPattern, type SignedUrlResponse, StandardComponents, StandardEvents, StateManager, type StateManagerOptions, type StateMiddleware, type StateSelector, type StateSubscriber, type StateUpdater, Styles, SvelteAdapter, SwatchUtils, type TagName, TemplateBuilder, type TemplateNode, type TemplateNodeType, type TemplateRenderer, type TextDescriptor, type TileCount, UniversalContextProvider, type UserSelection, type ValidationError, type ValidationResult, VueAdapter, autoRegister, componentRegistry, config, createAddToCartEvent, createAddToCartHandler, createCartDetail, createClient, createContextProvider, createDesignForPlacements, createErrorHandler, createEventManager, createLifecycle, createLitComponent, createProductContext, createProductLoader, createPropertyManager, createStateHook, createStateStore, createSvelteComponent, createUniversalProvider, createVueComponent, describeArtSelector, describeProductArtAlignment, describeProductImage, describeProductOptions, describeProductPrice, describeProductTitle, extractProductId, filterImagePlacements, findClosestSnapPoint, findVariantForSelection, formatPrice, formatValidationErrors, getDefaultVariantId, getEffectiveAlignment, getIncompleteSelectionMessage, getMissingSelections, getOptionRenderType, getProduct, getSelectionDisplayText, getSnapPoints, getVariant, handleOptionChange, isSelectionComplete, isValidAlignment, isValidTileCount, listProducts, mockupUrl, normalizeChoice, prepareOptionRenderData, registerStandardComponents, resolveMockupConfig, resolveMockupId, resolveVariantId, retryOperation, simulateCartOperation, toCombinations, toOptionAttributes, useFrameworkAdapter as useVueAdapter, validateAlignment, validateDesignElement, validateEffects, validateImageUrl, validateMockupOptions, validateProductSelection, validateProductSpec, validateRequiredOptions, validateTileCount, withContext, withErrorHandling, withSyncErrorHandling };
+export { AbstractTemplateRenderer, type AddToCartOptions, Animations, type ArtSelectorContext, type ArtSelectorDescriptor, type ArtSelectorOptions, type ArtworkData, type AspectRatio, Attributes, type BaseDescriptor, type BlendConfig, type BuildMockupUrlConfig, type CartDetail, type CatalogListResponse, type CatalogProduct$2 as CatalogProduct, ClassNames, type ColorDesignElement, ColorPickerUtils, Combination, CommonProps, ComponentContext, type ComponentDefinition, ComponentDescriptor, ComponentEventManager, ComponentFactory, ComponentLifecycle, ComponentLifecycleHooks, type ComponentMetadata, ComponentProps, ComponentRegistry, ComponentState, type ComponentTemplate, ComponentTemplates, type ContainerDescriptor, ContextBridge, type ContextComparator, type ContextConsumer, ContextInjector, type ContextProviderConfig, type ContextSubscriber, ContextSynchronizer, DEFAULT_ARTWORK_URL, DEFAULT_ASPECT_RATIO, DEFAULT_COLOR, DEFAULT_MOCKUP_BASE, DEFAULT_PLACEMENT_DIMENSIONS, type Descriptor, type Design, type DesignElement, type DesignGenerationContext, type Effects, Elements, type ErrorContext, type ErrorHandler, ErrorManager, type EventDefinition, EventDelegator, EventEmitter, EventHandler, type EventListener, type EventPayload, type Fill, Focus, FrameworkAdapter, FrameworkUtilities, type GetMockupUrlOptions, type ImageAlignment, type ImageDesignElement, type LifecycleHook, LifecycleManager, type LifecyclePhase, type LifecycleTransition, LitAdapter, type MaskOverride, type MockupGenerationOptions, type MockupService, type MockupServiceConfig, OptionAttribute, type OptionChoice, type OptionChoiceRenderData, type OptionRenderData, OptionSelection, type Placement, type PlacementDesign, type ProductArtAlignmentContext, type ProductArtAlignmentDescriptor, type ProductArtAlignmentOptions, type ProductContext, type ProductContextEvents, ProductContextManager, type ProductData, type ProductFetcher, type ProductImageDescriptor, type ProductImageOptions, ProductLoader, type ProductMockupData, type ProductOptionChoice, type ProductOptionData, type ProductOptionsDescriptor, type ProductOptionsOptions, type ProductPlacement, type ProductPriceDescriptor, type ProductPriceOptions, ProductProps, type ProductSpec, type ProductTitleDescriptor, type ProductTitleOptions, type ProductVariant, type PropDefinition, type PropSchema, type PropType, PropertyManager, type RateLimitState, type RegularArtwork, type SdkConfig, type SeamlessPattern, type SignedUrlResponse, type SnowconeClient, StandardComponents, StandardEvents, StateManager, type StateManagerOptions, type StateMiddleware, type StateSelector, type StateSubscriber, type StateUpdater, Styles, SvelteAdapter, SwatchUtils, type TagName, TemplateBuilder, type TemplateNode, type TemplateNodeType, type TemplateRenderer, type TextDescriptor, type TileCount, UniversalContextProvider, type UserSelection, type ValidationError, type ValidationResult, VueAdapter, autoRegister, buildMockupUrl, componentRegistry, createAddToCartEvent, createAddToCartHandler, createCartDetail, createClient, createContextProvider, createDesignForPlacements, createErrorHandler, createEventManager, createLifecycle, createLitComponent, createProductContext, createProductLoader, createPropertyManager, createStateHook, createStateStore, createSvelteComponent, createUniversalProvider, createVueComponent, describeArtSelector, describeProductArtAlignment, describeProductImage, describeProductOptions, describeProductPrice, describeProductTitle, extractProductId, filterImagePlacements, findClosestSnapPoint, findVariantForSelection, formatPrice, formatValidationErrors, getDefaultVariantId, getEffectiveAlignment, getIncompleteSelectionMessage, getMissingSelections, getMockupUrl, getOptionRenderType, getProduct, getSelectionDisplayText, getSnapPoints, getVariant, handleOptionChange, isSelectionComplete, isValidAlignment, isValidTileCount, listProducts, mockupUrl, normalizeChoice, prepareOptionRenderData, registerStandardComponents, resolveMockupId, resolveVariantId, retryOperation, simulateCartOperation, toCombinations, toOptionAttributes, useFrameworkAdapter as useVueAdapter, validateAlignment, validateDesignElement, validateEffects, validateImageUrl, validateMockupOptions, validateProductSelection, validateProductSpec, validateRequiredOptions, validateTileCount, withContext, withErrorHandling, withSyncErrorHandling };