@snowcone-app/ui 0.4.8 → 0.4.10

package/dist/index.js

@@ -5571,6 +5571,67 @@ function useMockupBackgroundOptional() {
   return useContext5(MockupBackgroundContext);
 }
 
+// src/patterns/croppedFrameComposite.ts
+var COMPOSITE_QUALITY = 0.92;
+function isFullRect(rect) {
+  if (!rect) return true;
+  return rect.x === 0 && rect.y === 0 && rect.w === 1 && rect.h === 1;
+}
+function compositeOffset(rect, bgWidth, bgHeight) {
+  return {
+    dx: Math.round(rect.x * bgWidth),
+    dy: Math.round(rect.y * bgHeight)
+  };
+}
+function allBackgroundsSeeded(mockupIds, seeded) {
+  return mockupIds.length > 0 && mockupIds.every((id) => seeded.has(id));
+}
+function loadImageElement(url) {
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    img.crossOrigin = "anonymous";
+    img.onload = () => {
+      if (img.decode) {
+        img.decode().then(
+          () => resolve(img),
+          () => resolve(img)
+        );
+      } else {
+        resolve(img);
+      }
+    };
+    img.onerror = () => reject(
+      new Error(`E_OVERLAY_FRAME_LOAD: image failed to load: ${url.slice(0, 160)}`)
+    );
+    img.src = url;
+  });
+}
+async function compositeCroppedFrame(args) {
+  const frame = await loadImageElement(args.frameUrl);
+  const width = args.background.naturalWidth;
+  const height = args.background.naturalHeight;
+  if (!width || !height) {
+    throw new Error("E_OVERLAY_BG_EMPTY: background image has no pixels");
+  }
+  const canvas = args.canvas ?? document.createElement("canvas");
+  canvas.width = width;
+  canvas.height = height;
+  const ctx = canvas.getContext("2d");
+  if (!ctx) {
+    throw new Error("E_OVERLAY_NO_2D_CONTEXT: canvas 2d context unavailable");
+  }
+  ctx.drawImage(args.background, 0, 0);
+  const { dx, dy } = compositeOffset(args.rect, width, height);
+  ctx.drawImage(frame, dx, dy);
+  const blob = await new Promise(
+    (resolve) => canvas.toBlob(resolve, "image/webp", COMPOSITE_QUALITY)
+  );
+  if (!blob) {
+    throw new Error("E_OVERLAY_ENCODE_FAILED: canvas.toBlob returned null");
+  }
+  return blob;
+}
+
 // src/patterns/RealtimeProvider.tsx
 import { jsx as jsx52 } from "react/jsx-runtime";
 var DEFAULT_ARTBOARD_SIZE = 2e3;
@@ -5586,7 +5647,8 @@ function RealtimeProvider({
   mockupWidth = 1400,
   autoEnable = false,
   shop,
-  grantUrl
+  grantUrl,
+  delivery = "cropped"
 }) {
   const productContext = useProductOptional();
   const mockupBg = useMockupBackgroundOptional();
@@ -5611,6 +5673,9 @@ function RealtimeProvider({
   const placementSettingsOverridesRef = useRef12({});
   const lastSentVariantIdRef = useRef12(null);
   const lastSentBgRef = useRef12(void 0);
+  const spreadCropsRef = useRef12(void 0);
+  const [spreadCropsVersion, setSpreadCropsVersion] = useState17(0);
+  const lastSentSpreadCropsRef = useRef12("null");
   const lastSentColorsRef = useRef12({});
   const realtimeMockup = useRealtimeMockup2({
     wsUrl,
@@ -5687,58 +5752,214 @@ function RealtimeProvider({
   const registeredBlobUrlsRef = useRef12(/* @__PURE__ */ new Set());
   const pendingPlacementsRef = useRef12(/* @__PURE__ */ new Set());
   const pendingMockupIdsRef = useRef12(/* @__PURE__ */ new Set());
-  useEffect17(() => {
-    if (rawMockupResults.length === 0) {
-      if (mockupResultsRef.current.length > 0) {
-        mockupResultsRef.current = [];
-        mockupSubscribersRef.current.forEach((cb) => cb([]));
+  const backgroundsRef = useRef12(/* @__PURE__ */ new Map());
+  const croppedActiveRef = useRef12(false);
+  const cropCapableRef = useRef12(true);
+  const lastConfigBaseRef = useRef12(null);
+  const sceneGenRef = useRef12(0);
+  const processedFrameRef = useRef12(/* @__PURE__ */ new Map());
+  const compositeQueueRef = useRef12(/* @__PURE__ */ new Map());
+  const compositeBusyRef = useRef12(/* @__PURE__ */ new Set());
+  const compositeCanvasRef = useRef12(null);
+  const registerBlobUrl = useCallback10((blobOrUrl, placementName) => {
+    let url;
+    if (blobOrUrl instanceof Blob) {
+      if (registeredBlobUrlsRef.current.size >= MAX_CONCURRENT_BLOBS) {
+        const oldest = registeredBlobUrlsRef.current.values().next().value;
+        if (oldest) {
+          URL.revokeObjectURL(oldest);
+          registeredBlobUrlsRef.current.delete(oldest);
+          mockupUrlCacheRef.current.forEach((value, key) => {
+            if (value.url === oldest) {
+              mockupUrlCacheRef.current.delete(key);
+            }
+          });
+          mockupResultsRef.current = mockupResultsRef.current.filter(
+            (r) => r.imageUrl !== oldest
+          );
+        }
       }
-      return;
+      url = URL.createObjectURL(blobOrUrl);
+      registeredBlobUrlsRef.current.add(url);
+    } else {
+      url = blobOrUrl;
     }
-    console.log(`[RTP] rawMockupResults changed: ${rawMockupResults.length} result(s)`, rawMockupResults.map((r) => `${r.mockupId}${r.imageUrl ? " \u2713url" : " \u2717NO-URL"}`));
-    mockupResultsRef.current = rawMockupResults;
-    const now = Date.now();
-    rawMockupResults.forEach((result) => {
-      if (result.imageUrl) {
+    return url;
+  }, []);
+  const croppedDeliveryEnabled = delivery !== "full-frame";
+  const sendCropConfig = useCallback10(
+    (withCrop) => {
+      const base = lastConfigBaseRef.current;
+      if (!base) return;
+      croppedActiveRef.current = withCrop;
+      sendConfigRaw({
+        ...base,
+        placementSettings: { ...placementSettingsOverridesRef.current },
+        ...withCrop ? { overlayCrop: "auto" } : {}
+      });
+    },
+    [sendConfigRaw]
+  );
+  const unflipCrop = useCallback10(() => {
+    if (!croppedActiveRef.current) return;
+    sendCropConfig(false);
+  }, [sendCropConfig]);
+  const maybeFlipCrop = useCallback10(() => {
+    if (!croppedDeliveryEnabled || !cropCapableRef.current) return;
+    if (croppedActiveRef.current) return;
+    const base = lastConfigBaseRef.current;
+    if (!base) return;
+    const ids = base.mockupIds ?? [];
+    const seeded = new Set(backgroundsRef.current.keys());
+    if (allBackgroundsSeeded(ids, seeded)) {
+      console.log(`[RTP] Cropped delivery ON \u2014 all ${ids.length} mockup background(s) seeded`);
+      sendCropConfig(true);
+    } else {
+      const missing = ids.filter((id) => !seeded.has(id));
+      console.log(`[RTP] Cropped delivery waiting \u2014 ${missing.length}/${ids.length} mockup(s) unseeded: [${missing.slice(0, 8).join(", ")}]`);
+    }
+  }, [croppedDeliveryEnabled, sendCropConfig]);
+  const invalidateBackgrounds = useCallback10(() => {
+    sceneGenRef.current += 1;
+    backgroundsRef.current.clear();
+    processedFrameRef.current.clear();
+    compositeQueueRef.current.clear();
+    croppedActiveRef.current = false;
+  }, []);
+  const deliverResults = useCallback10(
+    (results) => {
+      if (results.length === 0) return;
+      const now = Date.now();
+      const merged = [...mockupResultsRef.current];
+      results.forEach((result) => {
+        const idx = merged.findIndex((r) => r.mockupId === result.mockupId);
+        if (idx >= 0) merged[idx] = result;
+        else merged.push(result);
+      });
+      mockupResultsRef.current = merged;
+      const clearedPlacements = /* @__PURE__ */ new Set();
+      results.forEach((result) => {
         const wasPending = pendingMockupIdsRef.current.has(result.mockupId);
         mockupUrlCacheRef.current.set(result.mockupId, {
           url: result.imageUrl,
-          isBlob: false,
-          // Server URLs are not blob URLs
+          isBlob: result.imageUrl.startsWith("blob:"),
           timestamp: now
         });
         pendingMockupIdsRef.current.delete(result.mockupId);
         if (wasPending) {
           console.log(`[RTP] Cleared pending for ${result.mockupId} \u2014 url cached`);
         }
+        if (result.placement) clearedPlacements.add(result.placement);
+      });
+      if (clearedPlacements.size > 0) {
+        clearedPlacements.forEach((p) => pendingPlacementsRef.current.delete(p));
       } else {
-        console.log(`[RTP] Result for ${result.mockupId} has NO imageUrl \u2014 not caching, pending NOT cleared`);
+        pendingPlacementsRef.current.clear();
       }
-    });
-    const clearedPlacements = /* @__PURE__ */ new Set();
-    rawMockupResults.forEach((result) => {
-      if (result.placement) clearedPlacements.add(result.placement);
-    });
-    if (clearedPlacements.size > 0) {
-      clearedPlacements.forEach((p) => pendingPlacementsRef.current.delete(p));
-    } else {
-      pendingPlacementsRef.current.clear();
+      mockupSubscribersRef.current.forEach((cb) => cb(results));
+      results.forEach((result) => {
+        const subscribers = mockupSubscribersByIdRef.current.get(result.mockupId);
+        if (subscribers && subscribers.size > 0) {
+          console.log(`[RTP] Notifying ${subscribers.size} subscriber(s) for ${result.mockupId}`);
+          subscribers.forEach((cb) => cb(result));
+        } else {
+          console.log(`[RTP] No subscribers for ${result.mockupId} \u2014 result received but nobody listening`);
+        }
+      });
+      if (hasBlobInFlightRef.current && !hasPendingBlobs() && !pipelineResetCooldownRef.current) {
+        hasBlobInFlightRef.current = false;
+        pipelineSettledSubscribersRef.current.forEach((cb) => cb());
+      }
+    },
+    [hasPendingBlobs]
+  );
+  const runComposite = useCallback10(
+    async (result) => {
+      const gen = sceneGenRef.current;
+      const bg = backgroundsRef.current.get(result.mockupId);
+      if (!bg) {
+        console.error(
+          `[RealtimeProvider] E_OVERLAY_NO_BACKGROUND: cropped frame for ${result.mockupId} has no frozen background \u2014 falling back to full-frame and re-rendering it.`
+        );
+        unflipCrop();
+        updateMockupIdsRaw([result.mockupId]);
+        return;
+      }
+      try {
+        if (!bg.imgPromise) bg.imgPromise = loadImageElement(bg.url);
+        const background = await bg.imgPromise;
+        if (!compositeCanvasRef.current && typeof document !== "undefined") {
+          compositeCanvasRef.current = document.createElement("canvas");
+        }
+        const blob = await compositeCroppedFrame({
+          background,
+          frameUrl: result.imageUrl,
+          rect: result.cropRect,
+          canvas: compositeCanvasRef.current ?? void 0
+        });
+        if (gen !== sceneGenRef.current) return;
+        deliverResults([{ ...result, imageUrl: registerBlobUrl(blob) }]);
+      } catch (err) {
+        console.error(
+          "[RealtimeProvider] E_OVERLAY_COMPOSITE_FAILED: cropped-frame composite failed \u2014 full-frame delivery for the rest of this session.",
+          err
+        );
+        cropCapableRef.current = false;
+        unflipCrop();
+        updateMockupIdsRaw([result.mockupId]);
+      }
+    },
+    [deliverResults, registerBlobUrl, unflipCrop, updateMockupIdsRaw]
+  );
+  const pumpCompositeQueue = useCallback10(
+    (mockupId) => {
+      if (compositeBusyRef.current.has(mockupId)) return;
+      const job = compositeQueueRef.current.get(mockupId);
+      if (!job) return;
+      compositeQueueRef.current.delete(mockupId);
+      compositeBusyRef.current.add(mockupId);
+      void runComposite(job).finally(() => {
+        compositeBusyRef.current.delete(mockupId);
+        pumpCompositeQueue(mockupId);
+      });
+    },
+    [runComposite]
+  );
+  useEffect17(() => {
+    if (rawMockupResults.length === 0) {
+      if (mockupResultsRef.current.length > 0) {
+        mockupResultsRef.current = [];
+        mockupSubscribersRef.current.forEach((cb) => cb([]));
+      }
+      return;
     }
-    mockupSubscribersRef.current.forEach((cb) => cb(rawMockupResults));
+    console.log(`[RTP] rawMockupResults changed: ${rawMockupResults.length} result(s)`, rawMockupResults.map((r) => `${r.mockupId}${r.imageUrl ? " \u2713url" : " \u2717NO-URL"}${r.cropRect ? " [crop]" : ""}`));
+    const displayable = [];
     rawMockupResults.forEach((result) => {
-      const subscribers = mockupSubscribersByIdRef.current.get(result.mockupId);
-      if (subscribers && subscribers.size > 0) {
-        console.log(`[RTP] Notifying ${subscribers.size} subscriber(s) for ${result.mockupId}`);
-        subscribers.forEach((cb) => cb(result));
-      } else {
-        console.log(`[RTP] No subscribers for ${result.mockupId} \u2014 result received but nobody listening`);
+      if (!result.imageUrl) {
+        console.log(`[RTP] Result for ${result.mockupId} has NO imageUrl \u2014 not caching, pending NOT cleared`);
+        return;
+      }
+      const firstSight = processedFrameRef.current.get(result.mockupId) !== result.imageUrl;
+      const sessionLive = configSentRef.current;
+      if (isFullRect(result.cropRect)) {
+        if (firstSight && sessionLive) {
+          processedFrameRef.current.set(result.mockupId, result.imageUrl);
+          backgroundsRef.current.set(result.mockupId, { url: result.imageUrl });
+        }
+        displayable.push(result);
+      } else if (firstSight && sessionLive) {
+        processedFrameRef.current.set(result.mockupId, result.imageUrl);
+        compositeQueueRef.current.set(result.mockupId, result);
+        pumpCompositeQueue(result.mockupId);
+      } else if (pendingMockupIdsRef.current.has(result.mockupId)) {
+        const cached = mockupUrlCacheRef.current.get(result.mockupId);
+        if (cached) displayable.push({ ...result, imageUrl: cached.url });
       }
     });
-    if (hasBlobInFlightRef.current && !hasPendingBlobs() && !pipelineResetCooldownRef.current) {
-      hasBlobInFlightRef.current = false;
-      pipelineSettledSubscribersRef.current.forEach((cb) => cb());
-    }
-  }, [rawMockupResults]);
+    deliverResults(displayable);
+    maybeFlipCrop();
+  }, [rawMockupResults, deliverResults, maybeFlipCrop, pumpCompositeQueue]);
   const sendCanvasBlob = useCallback10(
     (placement, blob, mockupCount, baseThrottleMs) => {
       blobQueuedGenRef.current = pipelineGenRef.current;
@@ -5797,10 +6018,13 @@ function RealtimeProvider({
         configSentRef.current = false;
         lastSentVariantIdRef.current = null;
         lastSentBgRef.current = void 0;
+        lastSentSpreadCropsRef.current = "null";
         lastSentColorsRef.current = {};
+        invalidateBackgrounds();
+        lastConfigBaseRef.current = null;
       };
     }
-  }, [isEnabled, connect, disconnect, wsUrl]);
+  }, [isEnabled, connect, disconnect, wsUrl, invalidateBackgrounds]);
   useEffect17(() => {
     if (rawMockupResults.length > 0 && isPendingMockupsRef.current) {
       isPendingMockupsRef.current = false;
@@ -5819,9 +6043,14 @@ function RealtimeProvider({
     const isFirstSend = !configSentRef.current;
     const variantChanged = lastSentVariantIdRef.current !== null && lastSentVariantIdRef.current !== variantId;
     const bgChanged = configSentRef.current && lastSentBgRef.current !== mockupBg;
-    if (!isFirstSend && !variantChanged && !bgChanged) {
+    const spreadCropsJson = JSON.stringify(spreadCropsRef.current ?? null);
+    const spreadCropsChanged = configSentRef.current && lastSentSpreadCropsRef.current !== spreadCropsJson;
+    if (!isFirstSend && !variantChanged && !bgChanged && !spreadCropsChanged) {
       return;
     }
+    if (variantChanged || bgChanged) {
+      invalidateBackgrounds();
+    }
     const mockupIds = [];
     if (product.mockups && Array.isArray(product.mockups)) {
       product.mockups.forEach((mockup) => {
@@ -5837,6 +6066,7 @@ function RealtimeProvider({
       shop,
       width: mockupWidth,
       ...mockupBg ? { bg: mockupBg } : {},
+      ...spreadCropsRef.current ? { spreadCrops: spreadCropsRef.current } : {},
       placementSettings: { ...placementSettingsOverridesRef.current }
     } : {
       productId,
@@ -5846,6 +6076,7 @@ function RealtimeProvider({
       seal: "bypass-sig-for-k6-load-test",
       width: mockupWidth,
       ...mockupBg ? { bg: mockupBg } : {},
+      ...spreadCropsRef.current ? { spreadCrops: spreadCropsRef.current } : {},
       placementSettings: { ...placementSettingsOverridesRef.current }
     };
     if (variantChanged) {
@@ -5854,10 +6085,14 @@ function RealtimeProvider({
         pendingBlobSubscribersRef.current.forEach((cb) => cb(p.label));
       });
     }
-    sendConfigRaw(configPayload);
+    lastConfigBaseRef.current = configPayload;
+    sendConfigRaw(
+      croppedActiveRef.current ? { ...configPayload, overlayCrop: "auto" } : configPayload
+    );
     configSentRef.current = true;
     lastSentVariantIdRef.current = variantId;
     lastSentBgRef.current = mockupBg;
+    lastSentSpreadCropsRef.current = spreadCropsJson;
     setTimeout(() => {
       const colorPlacements = placements.filter((p) => p.type === "color");
       colorPlacements.forEach((p) => {
@@ -5875,8 +6110,10 @@ function RealtimeProvider({
     productContext?.selection,
     sendConfigRaw,
     sendColorBlobTracked,
+    invalidateBackgrounds,
     mockupWidth,
-    mockupBg
+    mockupBg,
+    spreadCropsVersion
   ]);
   useEffect17(() => {
     if (!isEnabled || !isConnected || !isConfigured || !productContext?.product)
@@ -5903,6 +6140,15 @@ function RealtimeProvider({
     productContext?.selection,
     sendColorBlobTracked
   ]);
+  const updateMockupIdsGuarded = useCallback10(
+    (mockupIds) => {
+      if (croppedActiveRef.current && mockupIds.some((id) => !backgroundsRef.current.has(id))) {
+        unflipCrop();
+      }
+      return updateMockupIdsRaw(mockupIds);
+    },
+    [updateMockupIdsRaw, unflipCrop]
+  );
   const updatePlacementSettingsWrapped = useCallback10(
     (settings) => {
       placementSettingsOverridesRef.current = settings;
@@ -5910,6 +6156,17 @@ function RealtimeProvider({
     },
     [updatePlacementSettingsRaw]
   );
+  const setSpreadCrops = useCallback10(
+    (crops) => {
+      const next = crops && Object.keys(crops).length > 0 ? crops : void 0;
+      if (JSON.stringify(next ?? null) === JSON.stringify(spreadCropsRef.current ?? null)) {
+        return;
+      }
+      spreadCropsRef.current = next;
+      setSpreadCropsVersion((v) => v + 1);
+    },
+    []
+  );
   const enableRealtime = useCallback10(() => {
     setIsEnabled(true);
   }, []);
@@ -6091,28 +6348,6 @@ function RealtimeProvider({
   const isMockupLoading = useCallback10((mockupId) => {
     return pendingMockupIdsRef.current.has(mockupId);
   }, []);
-  const registerBlobUrl = useCallback10((blobOrUrl, placementName) => {
-    let url;
-    if (blobOrUrl instanceof Blob) {
-      if (registeredBlobUrlsRef.current.size >= MAX_CONCURRENT_BLOBS) {
-        const oldest = registeredBlobUrlsRef.current.values().next().value;
-        if (oldest) {
-          URL.revokeObjectURL(oldest);
-          registeredBlobUrlsRef.current.delete(oldest);
-          mockupUrlCacheRef.current.forEach((value, key) => {
-            if (value.url === oldest) {
-              mockupUrlCacheRef.current.delete(key);
-            }
-          });
-        }
-      }
-      url = URL.createObjectURL(blobOrUrl);
-      registeredBlobUrlsRef.current.add(url);
-    } else {
-      url = blobOrUrl;
-    }
-    return url;
-  }, []);
   const subscribeMockupResultsRef = useRef12(subscribeMockupResults);
   const subscribeMockupResultByIdRef = useRef12(subscribeMockupResultById);
   const subscribePendingBlobRef = useRef12(subscribePendingBlob);
@@ -6193,8 +6428,9 @@ function RealtimeProvider({
       disableRealtime,
       sendCanvasBlob,
       sendCanvasState,
-      updateMockupIds: updateMockupIdsRaw,
+      updateMockupIds: updateMockupIdsGuarded,
       updatePlacementSettings: updatePlacementSettingsWrapped,
+      setSpreadCrops,
       getMockupResultsImmediate: () => mockupResultsRef.current,
       subscribeMockupResults: stableSubscribeMockupResults,
       subscribeMockupResultById: stableSubscribeMockupResultById,
@@ -6229,8 +6465,9 @@ function RealtimeProvider({
       disableRealtime,
       sendCanvasBlob,
       sendCanvasState,
-      updateMockupIdsRaw,
+      updateMockupIdsGuarded,
       updatePlacementSettingsWrapped,
+      setSpreadCrops,
       stableSubscribeMockupResults,
       stableSubscribeMockupResultById,
       notifyPendingExport,
@@ -9745,7 +9982,10 @@ var HeroProductImage = memo3(function HeroProductImage2({
   // Quick crossfade
   shimmerDelay = 200,
   shimmerFadeDuration = 500,
-  darkShimmerFadeInDuration = 300
+  darkShimmerFadeInDuration = 300,
+  emptyText = "No artwork",
+  errorText = "Error loading",
+  unavailableText = "Preview unavailable"
 }) {
   const context = useProductOptional();
   const designContext = useDesignOptional();
@@ -10190,7 +10430,7 @@ var HeroProductImage = memo3(function HeroProductImage2({
               )
             }
           ),
-          /* @__PURE__ */ jsx61("p", { className: "text-xs", children: "No artwork" })
+          /* @__PURE__ */ jsx61("p", { className: "text-xs", children: emptyText })
         ] })
       }
     );
@@ -10201,7 +10441,7 @@ var HeroProductImage = memo3(function HeroProductImage2({
       {
         className: `bg-red-50 flex items-center justify-center ${className || ""}`,
         style,
-        children: /* @__PURE__ */ jsx61("div", { className: "text-red-600 text-center p-4", children: /* @__PURE__ */ jsx61("p", { className: "text-xs", children: "Error loading" }) })
+        children: /* @__PURE__ */ jsx61("div", { className: "text-red-600 text-center p-4", children: /* @__PURE__ */ jsx61("p", { className: "text-xs", children: errorText }) })
       }
     );
   }
@@ -10220,7 +10460,7 @@ var HeroProductImage = memo3(function HeroProductImage2({
             crossOrigin: "anonymous",
             className: "absolute inset-0 w-full h-full object-cover",
             draggable,
-            src: retriedUrlRef.current === renderedUrl ? `${renderedUrl}${renderedUrl.includes("?") ? "&" : "?"}_cb=${retryNonce}` : renderedUrl,
+            src: renderedUrl,
             loading: "eager",
             fetchPriority: "high",
             onClick,
@@ -10236,7 +10476,8 @@ var HeroProductImage = memo3(function HeroProductImage2({
             onError: () => {
               if (renderedUrl && retriedUrlRef.current !== renderedUrl) {
                 retriedUrlRef.current = renderedUrl;
-                setRetryNonce((n) => n + 1);
+                void fetch(renderedUrl, { mode: "cors", cache: "reload", credentials: "omit" }).catch(() => {
+                }).then(() => setRetryNonce((n) => n + 1));
                 return;
               }
               setImgFailed(true);
@@ -10250,9 +10491,10 @@ var HeroProductImage = memo3(function HeroProductImage2({
                 );
               }
             }
-          }
+          },
+          retryNonce
         ),
-        imgFailed && !prevUrl && /* @__PURE__ */ jsx61("div", { className: "absolute inset-0 flex items-center justify-center bg-muted", children: /* @__PURE__ */ jsx61("p", { className: "text-muted-foreground text-xs", children: "Preview unavailable" }) }),
+        imgFailed && !prevUrl && /* @__PURE__ */ jsx61("div", { className: "absolute inset-0 flex items-center justify-center bg-muted", children: /* @__PURE__ */ jsx61("p", { className: "text-muted-foreground text-xs", children: unavailableText }) }),
         realtimeContext?.renderError && /* @__PURE__ */ jsx61(
           "div",
           {
@@ -11761,7 +12003,10 @@ var MobileProductCarousel = memo4(function MobileProductCarousel2({
   onZoomChange,
   stickyHeroContext,
   mockupWidth,
-  onMockupUrlGenerated
+  onMockupUrlGenerated,
+  renderImageAction,
+  errorText,
+  unavailableText
 }) {
   const [activeIndex, setActiveIndex] = useState40(currentIndex);
   const [touchStart, setTouchStart] = useState40(
@@ -12295,34 +12540,52 @@ var MobileProductCarousel = memo4(function MobileProductCarousel2({
             children: images.map((image, index) => {
               const DECODE_WINDOW = 1;
               const isWithinDecodeWindow = Math.abs(index - activeIndex) <= DECODE_WINDOW;
-              return /* @__PURE__ */ jsx74(
+              return /* @__PURE__ */ jsxs50(
                 "div",
                 {
                   className: "w-full h-full flex-shrink-0 relative select-none",
-                  children: !isWithinDecodeWindow ? /* @__PURE__ */ jsx74("div", { className: "w-full h-full bg-muted" }) : image.isPlaceholder ? (
-                    // Rainbow prism loader (same as the /create route) instead of
-                    // a flat pulse; fills this relative slide via inset:0.
-                    /* @__PURE__ */ jsx74(LoadingOverlayPrismCandyInline, { visible: true, variant: "light" })
-                  ) : image.isRealMockup && currentArtwork ? /* @__PURE__ */ jsx74(
-                    HeroProductImage,
-                    {
-                      productId,
-                      artwork: currentArtwork,
-                      placement: image.placement,
-                      mockupId: image.mockupId,
-                      width: mockupWidth,
-                      realtimeUrl: image.mockupId ? realtimeMockupUrls[image.mockupId] ?? generatedUrlsRef.current.get(image.mockupId) ?? void 0 : void 0,
-                      onUrlGenerated: image.mockupId ? (url) => handleUrlGenerated(image.mockupId, url) : void 0,
-                      className: "w-full h-full object-cover cursor-pointer pointer-events-none"
-                    }
-                  ) : image.isRealMockup && !currentArtwork ? /* @__PURE__ */ jsx74(LoadingOverlayPrismCandyInline, { visible: true, variant: "light" }) : /* @__PURE__ */ jsx74(
-                    StaticCarouselImage,
-                    {
-                      src: image.src,
-                      alt: image.label ?? "",
-                      className: "w-full h-full object-cover cursor-pointer pointer-events-none"
-                    }
-                  )
+                  children: [
+                    !isWithinDecodeWindow ? /* @__PURE__ */ jsx74("div", { className: "w-full h-full bg-muted" }) : image.isPlaceholder ? (
+                      // Rainbow prism loader (same as the /create route) instead of
+                      // a flat pulse; fills this relative slide via inset:0.
+                      /* @__PURE__ */ jsx74(LoadingOverlayPrismCandyInline, { visible: true, variant: "light" })
+                    ) : image.isRealMockup && currentArtwork ? /* @__PURE__ */ jsx74(
+                      HeroProductImage,
+                      {
+                        productId,
+                        artwork: currentArtwork,
+                        placement: image.placement,
+                        mockupId: image.mockupId,
+                        width: mockupWidth,
+                        realtimeUrl: image.mockupId ? realtimeMockupUrls[image.mockupId] ?? generatedUrlsRef.current.get(image.mockupId) ?? void 0 : void 0,
+                        onUrlGenerated: image.mockupId ? (url) => handleUrlGenerated(image.mockupId, url) : void 0,
+                        errorText,
+                        unavailableText,
+                        className: "w-full h-full object-cover cursor-pointer pointer-events-none"
+                      }
+                    ) : image.isRealMockup && !currentArtwork ? /* @__PURE__ */ jsx74(LoadingOverlayPrismCandyInline, { visible: true, variant: "light" }) : /* @__PURE__ */ jsx74(
+                      StaticCarouselImage,
+                      {
+                        src: image.src,
+                        alt: image.label ?? "",
+                        className: "w-full h-full object-cover cursor-pointer pointer-events-none"
+                      }
+                    ),
+                    isWithinDecodeWindow && (() => {
+                      const action = renderImageAction?.(image, index);
+                      return action ? /* @__PURE__ */ jsx74(
+                        "div",
+                        {
+                          className: "absolute top-3 right-3 z-10",
+                          onClick: (e) => e.stopPropagation(),
+                          onTouchStart: (e) => e.stopPropagation(),
+                          onTouchEnd: (e) => e.stopPropagation(),
+                          onMouseDown: (e) => e.stopPropagation(),
+                          children: action
+                        }
+                      ) : null;
+                    })()
+                  ]
                 },
                 index
               );