@snowcone-app/ui 0.4.8 → 0.4.10

package/dist/index.d.cts

@@ -2929,6 +2929,24 @@ interface RealtimeContextValue {
         tiles?: number;
         alignment?: string;
     }>) => boolean;
+    /**
+     * Declare spread-mode crop geometry (ADR-0060) for canvases that run
+     * combined spread/group artboards: artboard name → artboard dims + piece
+     * rects keyed by the product's placement labels. Sent on the realtime
+     * config (re-sent when it changes) so the server can slice each rendered
+     * spread canvas_state into per-placement images. Pass undefined to clear.
+     */
+    setSpreadCrops: (crops: Record<string, {
+        width: number;
+        height: number;
+        pieces: Array<{
+            placement: string;
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+    }> | undefined) => void;
     getMockupResultsImmediate: () => MockupResult[];
     subscribeMockupResults: (callback: (results: MockupResult[]) => void) => () => void;
     subscribeMockupResultById: (mockupId: string, callback: (result: MockupResult) => void) => () => void;
@@ -3012,13 +3030,25 @@ interface RealtimeProviderProps {
      * via a renewable token. Without them, the legacy seal path runs (shim).
      */
     grantUrl?: string;
+    /**
+     * Frame delivery strategy. `"cropped"` (default, the fast path): once every
+     * configured mockup has rendered one full frame (frozen internally as its
+     * background), the session flips to `overlayCrop: 'auto'` — the server ships
+     * only the product-region pixels per edit and the provider composites them
+     * over the frozen background before notifying consumers, so subscribers and
+     * the URL cache only ever see full-frame images. Opt out with
+     * `"full-frame"` to ship the whole scene on every render (the pre-crop
+     * behavior). Any composite failure falls back to full-frame delivery for
+     * the rest of the session automatically.
+     */
+    delivery?: "cropped" | "full-frame";
 }
 /**
  * RealtimeProvider - Manages realtime mockup WebSocket connection
  *
  * Must be used inside a <Product> provider to access product data.
  */
-declare function RealtimeProvider({ children, wsUrl, mockupWidth, autoEnable, shop, grantUrl, }: RealtimeProviderProps): react_jsx_runtime.JSX.Element;
+declare function RealtimeProvider({ children, wsUrl, mockupWidth, autoEnable, shop, grantUrl, delivery, }: RealtimeProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access realtime context
  * Throws if not inside RealtimeProvider
@@ -4225,6 +4255,13 @@ interface HeroProductImageProps {
     shimmerDelay?: number;
     shimmerFadeDuration?: number;
     darkShimmerFadeInDuration?: number;
+    /** Label shown when no artwork is applied. Host apps pass a localized
+     *  string (this package stays i18n-framework-free). */
+    emptyText?: string;
+    /** Label shown when mockup generation fails. */
+    errorText?: string;
+    /** Label shown when the image fails to load with no stale image to keep. */
+    unavailableText?: string;
 }
 /**
  * Hero-compatible version of ProductImage that renders as a simple img element
@@ -4646,6 +4683,19 @@ interface MobileProductCarouselProps {
      * provider's mockup cache themselves.
      */
     onMockupUrlGenerated?: (mockupId: string, url: string) => void;
+    /**
+     * Per-image action overlay, floated top-right of the slide (e.g. the
+     * draft preview's Pass button). Return null for images without actions.
+     * Taps on the action stop propagating so they don't trigger the
+     * carousel's tap-to-zoom or swipe handling.
+     */
+    renderImageAction?: (image: CarouselImage, index: number) => React__default.ReactNode;
+    /** Passed through to HeroProductImage — label when mockup generation
+     *  fails. Host apps pass a localized string. */
+    errorText?: string;
+    /** Passed through to HeroProductImage — label when the image fails to
+     *  load with no stale image to keep. */
+    unavailableText?: string;
 }
 /**
  * MobileProductCarousel - Memoized for performance

package/dist/index.d.ts

@@ -2929,6 +2929,24 @@ interface RealtimeContextValue {
         tiles?: number;
         alignment?: string;
     }>) => boolean;
+    /**
+     * Declare spread-mode crop geometry (ADR-0060) for canvases that run
+     * combined spread/group artboards: artboard name → artboard dims + piece
+     * rects keyed by the product's placement labels. Sent on the realtime
+     * config (re-sent when it changes) so the server can slice each rendered
+     * spread canvas_state into per-placement images. Pass undefined to clear.
+     */
+    setSpreadCrops: (crops: Record<string, {
+        width: number;
+        height: number;
+        pieces: Array<{
+            placement: string;
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+    }> | undefined) => void;
     getMockupResultsImmediate: () => MockupResult[];
     subscribeMockupResults: (callback: (results: MockupResult[]) => void) => () => void;
     subscribeMockupResultById: (mockupId: string, callback: (result: MockupResult) => void) => () => void;
@@ -3012,13 +3030,25 @@ interface RealtimeProviderProps {
      * via a renewable token. Without them, the legacy seal path runs (shim).
      */
     grantUrl?: string;
+    /**
+     * Frame delivery strategy. `"cropped"` (default, the fast path): once every
+     * configured mockup has rendered one full frame (frozen internally as its
+     * background), the session flips to `overlayCrop: 'auto'` — the server ships
+     * only the product-region pixels per edit and the provider composites them
+     * over the frozen background before notifying consumers, so subscribers and
+     * the URL cache only ever see full-frame images. Opt out with
+     * `"full-frame"` to ship the whole scene on every render (the pre-crop
+     * behavior). Any composite failure falls back to full-frame delivery for
+     * the rest of the session automatically.
+     */
+    delivery?: "cropped" | "full-frame";
 }
 /**
  * RealtimeProvider - Manages realtime mockup WebSocket connection
  *
  * Must be used inside a <Product> provider to access product data.
  */
-declare function RealtimeProvider({ children, wsUrl, mockupWidth, autoEnable, shop, grantUrl, }: RealtimeProviderProps): react_jsx_runtime.JSX.Element;
+declare function RealtimeProvider({ children, wsUrl, mockupWidth, autoEnable, shop, grantUrl, delivery, }: RealtimeProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access realtime context
  * Throws if not inside RealtimeProvider
@@ -4225,6 +4255,13 @@ interface HeroProductImageProps {
     shimmerDelay?: number;
     shimmerFadeDuration?: number;
     darkShimmerFadeInDuration?: number;
+    /** Label shown when no artwork is applied. Host apps pass a localized
+     *  string (this package stays i18n-framework-free). */
+    emptyText?: string;
+    /** Label shown when mockup generation fails. */
+    errorText?: string;
+    /** Label shown when the image fails to load with no stale image to keep. */
+    unavailableText?: string;
 }
 /**
  * Hero-compatible version of ProductImage that renders as a simple img element
@@ -4646,6 +4683,19 @@ interface MobileProductCarouselProps {
      * provider's mockup cache themselves.
      */
     onMockupUrlGenerated?: (mockupId: string, url: string) => void;
+    /**
+     * Per-image action overlay, floated top-right of the slide (e.g. the
+     * draft preview's Pass button). Return null for images without actions.
+     * Taps on the action stop propagating so they don't trigger the
+     * carousel's tap-to-zoom or swipe handling.
+     */
+    renderImageAction?: (image: CarouselImage, index: number) => React__default.ReactNode;
+    /** Passed through to HeroProductImage — label when mockup generation
+     *  fails. Host apps pass a localized string. */
+    errorText?: string;
+    /** Passed through to HeroProductImage — label when the image fails to
+     *  load with no stale image to keep. */
+    unavailableText?: string;
 }
 /**
  * MobileProductCarousel - Memoized for performance