@snowcone-app/ui 0.4.9 → 0.4.10

package/dist/index.d.cts

@@ -3030,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
@@ -4243,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
@@ -4664,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

@@ -3030,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
@@ -4243,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
@@ -4664,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