@joycostudio/iris 0.0.0-stage → 0.0.1

package/dist/next.cjs

@@ -0,0 +1,380 @@
+"use strict";
+"use client";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/next/index.tsx
+var next_exports = {};
+__export(next_exports, {
+  createIrisNextImage: () => createIrisNextImage
+});
+module.exports = __toCommonJS(next_exports);
+var import_image = __toESM(require("next/image.js"), 1);
+var import_react = require("react");
+
+// packages/core/placeholder.ts
+function placeholderSettings(input) {
+  if (!input || input === "none") return null;
+  const options = input === "blur" ? {} : input;
+  return {
+    width: options.width ?? 10,
+    quality: options.quality ?? 40,
+    blur: options.blur ?? 12
+  };
+}
+function resolvePlaceholder({
+  asset,
+  placeholder
+}) {
+  const settings = placeholderSettings(placeholder);
+  if (!settings) return null;
+  const url = asset.placeholders?.find(
+    (item) => item.width === settings.width && item.quality === settings.quality
+  )?.url ?? (settings.width === 10 && settings.quality === 40 ? asset.placeholder : void 0);
+  return url ? { url, blur: settings.blur } : null;
+}
+
+// packages/next/index.tsx
+var import_react2 = require("@joycostudio/iris/react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var Image = "default" in import_image.default ? import_image.default.default : import_image.default;
+var EMPTY_IMAGE = "data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs=";
+function isEmptyImage(image) {
+  return (image.currentSrc || image.src) === EMPTY_IMAGE;
+}
+function createIrisNextImage({
+  iris,
+  catalog
+}) {
+  return function IrisImage({
+    recipe: override,
+    usage,
+    ...props
+  }) {
+    const src = typeof props.src === "string" ? props.src : props.src && "src" in props.src ? props.src.src : null;
+    const asset = src ? catalog[src] : void 0;
+    if (!src || !asset)
+      return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        Image,
+        {
+          ...props,
+          "data-iris": props["data-iris"] || props.alt || src || void 0
+        }
+      );
+    const contextUsage = {
+      width: props.width ? Number(props.width) : void 0,
+      ...usage,
+      priority: Boolean(props.priority || props.preload || usage?.priority)
+    };
+    const selected = iris.select({
+      asset,
+      usage: contextUsage,
+      recipe: override
+    });
+    if (!selected.ok) throw new Error(`Iris: ${selected.error.message}`);
+    const { name, recipe } = selected.data;
+    const animated = asset.animated || /\.(?:gif|svg)(?:[?#]|$)/i.test(src);
+    const direct = props.unoptimized || animated;
+    const sizes = props.sizes || (props.width ? `${props.width}px` : "100vw");
+    const normalProps = {
+      ...props,
+      src,
+      sizes,
+      unoptimized: direct,
+      placeholder: "empty"
+    };
+    const { props: normal } = (0, import_image.getImageProps)(normalProps);
+    const liveProgressive = Boolean(
+      normal.src === src && !normal.srcSet && asset.progressive
+    );
+    const preview = !direct && !liveProgressive ? previewImage({ recipe, asset, props: normalProps }) : void 0;
+    const progressiveDelivery = liveProgressive;
+    const placeholder = !liveProgressive ? resolvePlaceholder({ asset, placeholder: recipe.placeholder }) : null;
+    const previewSettings = recipe.preview && recipe.preview !== "none" ? recipe.preview : null;
+    const loadPreviewFirst = Boolean(preview && previewSettings?.loadFirst);
+    const key = JSON.stringify([
+      src,
+      name,
+      sizes,
+      props.quality,
+      previewSettings,
+      liveProgressive,
+      loadPreviewFirst
+    ]);
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      DeliveryImage,
+      {
+        ...normalProps,
+        src,
+        source: src,
+        unoptimized: Boolean(direct),
+        recipeName: name,
+        preview,
+        loadPreviewFirst,
+        previewMinDisplayMs: previewSettings?.minDisplayMs ?? 0,
+        blurDataURL: placeholder?.url,
+        blurRadius: placeholder?.blur ?? 0,
+        progressiveDelivery
+      },
+      key
+    );
+  };
+}
+function previewImage({
+  recipe,
+  asset,
+  props
+}) {
+  const preview = recipe.preview;
+  if (!preview || preview === "none") return void 0;
+  if (preview.url)
+    return preview.url === asset.src ? void 0 : { src: preview.url, unoptimized: true };
+  const quality = preview.quality ?? props.quality;
+  const { props: candidates } = (0, import_image.getImageProps)({
+    ...props,
+    quality,
+    width: 1,
+    height: 1,
+    fill: false,
+    sizes: "1px",
+    placeholder: "empty",
+    overrideSrc: void 0
+  });
+  const widths = (candidates.srcSet?.split(", ") ?? []).flatMap((item) => {
+    const match = item.match(/^(.*) (\d+)w$/);
+    return match ? [{ url: match[1], width: Number(match[2]) }] : [];
+  });
+  if (!widths.length) return void 0;
+  const loader = ({ width }) => {
+    const cap = preview.ratio === void 0 ? Math.min(width, preview.maxWidth ?? 640) : Math.min(
+      Math.floor(width * preview.ratio),
+      preview.maxWidth ?? Infinity
+    );
+    const smaller = widths.filter((candidate) => candidate.width < width);
+    const selected = smaller.filter((candidate) => candidate.width <= cap).at(-1) ?? smaller[0] ?? widths[0];
+    return selected.url;
+  };
+  return { src: asset.src, loader, quality, unoptimized: false };
+}
+function DeliveryImage({
+  source,
+  recipeName,
+  preview,
+  loadPreviewFirst,
+  previewMinDisplayMs,
+  progressiveDelivery,
+  style,
+  onLoad,
+  onError,
+  onLoadCapture,
+  blurDataURL,
+  blurRadius,
+  ...props
+}) {
+  const [loaded, setLoaded] = (0, import_react.useState)(false);
+  const [previewLoaded, setPreviewLoaded] = (0, import_react.useState)(false);
+  const [finalStarted, setFinalStarted] = (0, import_react.useState)(!loadPreviewFirst);
+  const layerZIndex = typeof style?.zIndex === "number" ? style.zIndex : 0;
+  const iris = (0, import_react2.useIrisDebugger)();
+  const finalRef = (0, import_react.useRef)(null);
+  const previewRef = (0, import_react.useRef)(null);
+  const previewMarked = (0, import_react.useRef)(false);
+  const attachFinal = (0, import_react.useCallback)((image) => {
+    finalRef.current = image;
+    if (image?.complete && image.naturalWidth && !isEmptyImage(image))
+      setLoaded(true);
+  }, []);
+  (0, import_react.useEffect)(() => {
+    let timer;
+    let observer;
+    const startFallback = () => {
+      timer ?? (timer = setTimeout(() => setFinalStarted(true), 3e3));
+    };
+    if (loadPreviewFirst && !finalStarted && previewLoaded) {
+      timer = setTimeout(() => setFinalStarted(true), previewMinDisplayMs);
+    } else if (loadPreviewFirst && !finalStarted && previewRef.current) {
+      if (typeof IntersectionObserver === "undefined") startFallback();
+      else {
+        observer = new IntersectionObserver((entries) => {
+          if (entries.some((entry) => entry.isIntersecting)) {
+            startFallback();
+            observer?.disconnect();
+          }
+        });
+        observer.observe(previewRef.current);
+      }
+    }
+    return () => {
+      observer?.disconnect();
+      if (timer) clearTimeout(timer);
+    };
+  }, [loadPreviewFirst, finalStarted, previewLoaded, previewMinDisplayMs]);
+  const revealPreview = (0, import_react.useCallback)(
+    (image) => {
+      if (!image.isConnected || !image.naturalWidth || previewMarked.current)
+        return;
+      previewMarked.current = true;
+      setPreviewLoaded(true);
+      if (finalRef.current) iris?.markPreview(finalRef.current, image);
+    },
+    [iris]
+  );
+  const attachPreview = (0, import_react.useCallback)(
+    (image) => {
+      previewRef.current = image;
+      if (image?.complete && image.naturalWidth) revealPreview(image);
+    },
+    [revealPreview]
+  );
+  (0, import_react.useLayoutEffect)(() => {
+    if (iris && finalRef.current) {
+      iris.startTimeline(finalRef.current);
+      if (finalRef.current.complete && finalRef.current.naturalWidth && !isEmptyImage(finalRef.current))
+        iris.markFinal(finalRef.current);
+    }
+  }, [iris, source]);
+  (0, import_react.useLayoutEffect)(() => {
+    const image = finalRef.current;
+    if (finalStarted && image?.complete && image.naturalWidth && !isEmptyImage(image)) {
+      setLoaded(true);
+      iris?.markFinal(image);
+    }
+  }, [finalStarted, iris]);
+  const layers = /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      Image,
+      {
+        ...props,
+        src: finalStarted ? props.src : EMPTY_IMAGE,
+        unoptimized: finalStarted ? props.unoptimized : true,
+        loader: finalStarted ? props.loader : void 0,
+        overrideSrc: finalStarted ? props.overrideSrc : void 0,
+        priority: finalStarted ? props.priority : false,
+        preload: finalStarted ? props.preload : false,
+        fetchPriority: finalStarted ? props.fetchPriority : "auto",
+        ref: attachFinal,
+        "data-iris": props["data-iris"] || props.alt || source,
+        "data-iris-src": source,
+        "data-iris-recipe": recipeName,
+        "data-iris-delivery": progressiveDelivery ? "progressive" : void 0,
+        placeholder: "empty",
+        style: {
+          ...style,
+          ...preview || blurDataURL ? { zIndex: layerZIndex + 2 } : {},
+          ...loaded ? { backgroundImage: "none" } : {}
+        },
+        onLoadCapture: (event) => {
+          if (isEmptyImage(event.currentTarget)) return;
+          event.currentTarget.style.backgroundImage = "none";
+          setLoaded(true);
+          onLoadCapture?.(event);
+        },
+        onLoad: (event) => {
+          if (isEmptyImage(event.currentTarget)) return;
+          setLoaded(true);
+          iris?.markFinal(event.currentTarget);
+          onLoad?.(event);
+        },
+        onError: (event) => {
+          if (isEmptyImage(event.currentTarget)) return;
+          onError?.(event);
+        }
+      }
+    ),
+    preview && !loaded && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      Image,
+      {
+        ...props,
+        src: preview.src,
+        loader: preview.loader,
+        overrideSrc: void 0,
+        ref: attachPreview,
+        unoptimized: preview.unoptimized,
+        quality: preview.quality,
+        fill: true,
+        width: void 0,
+        height: void 0,
+        alt: "",
+        "aria-hidden": "true",
+        "data-iris": void 0,
+        "data-slot": "image-preview",
+        priority: false,
+        preload: false,
+        fetchPriority: "auto",
+        placeholder: "empty",
+        style: {
+          ...style,
+          pointerEvents: "none",
+          zIndex: layerZIndex + 1,
+          backgroundImage: "none"
+        },
+        onLoadCapture: (event) => revealPreview(event.currentTarget),
+        onError: () => setFinalStarted(true)
+      }
+    ),
+    !loaded && !previewLoaded && blurDataURL && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "span",
+      {
+        "aria-hidden": "true",
+        "data-slot": "image-placeholder",
+        "data-stage": "blur",
+        style: {
+          position: "absolute",
+          inset: 0,
+          ...style,
+          pointerEvents: "none",
+          zIndex: layerZIndex,
+          backgroundImage: `url(${JSON.stringify(blurDataURL)})`,
+          backgroundSize: style?.objectFit === "contain" ? "contain" : style?.objectFit === "cover" ? "cover" : "100% 100%",
+          backgroundPosition: style?.objectPosition ?? "center",
+          backgroundRepeat: "no-repeat",
+          filter: `blur(${blurRadius}px)`,
+          clipPath: "inset(0)"
+        }
+      }
+    )
+  ] });
+  return preview || blurDataURL ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "span",
+    {
+      "data-slot": "iris-image",
+      style: props.fill ? { position: "absolute", inset: 0, isolation: "isolate" } : {
+        position: "relative",
+        display: "inline-grid",
+        maxWidth: "100%",
+        isolation: "isolate"
+      },
+      children: layers
+    }
+  ) : layers;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createIrisNextImage
+});
+//# sourceMappingURL=next.cjs.map

package/dist/next.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../packages/next/index.tsx","../packages/core/placeholder.ts"],"sourcesContent":["\"use client\"\n\nimport NextImage, { getImageProps, type ImageProps } from \"next/image.js\"\nimport {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useRef,\n  useState,\n} from \"react\"\nimport type {\n  IrisCatalogAsset,\n  IrisPolicy,\n  IrisPolicyUsage,\n  IrisRecipe,\n} from \"../core\"\nimport { resolvePlaceholder } from \"../core/placeholder\"\nimport { useIrisDebugger } from \"@joycostudio/iris/react\"\n\n// Next exposes a CommonJS entry; native ESM and bundlers unwrap it differently.\nconst Image = (\n  \"default\" in NextImage ? NextImage.default : NextImage\n) as typeof NextImage\nconst EMPTY_IMAGE = \"data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs=\"\n\nfunction isEmptyImage(image: HTMLImageElement) {\n  return (image.currentSrc || image.src) === EMPTY_IMAGE\n}\n\nexport type IrisNextImageProps<Custom = Record<string, unknown>> =\n  ImageProps & {\n    recipe?: string\n    usage?: IrisPolicyUsage<Custom>\n    \"data-iris\"?: string\n  }\n\n/** Next owns responsive widths, optimizer URLs and allowed quality values. */\nexport function createIrisNextImage<Custom>({\n  iris,\n  catalog,\n}: {\n  iris: IrisPolicy<Custom>\n  catalog: Readonly<Record<string, IrisCatalogAsset>>\n}) {\n  return function IrisImage({\n    recipe: override,\n    usage,\n    ...props\n  }: IrisNextImageProps<Custom>) {\n    const src =\n      typeof props.src === \"string\"\n        ? props.src\n        : props.src && \"src\" in props.src\n          ? props.src.src\n          : null\n    const asset = src ? catalog[src] : undefined\n    if (!src || !asset)\n      return (\n        <Image\n          {...props}\n          data-iris={props[\"data-iris\"] || props.alt || src || undefined}\n        />\n      )\n    const contextUsage = {\n      width: props.width ? Number(props.width) : undefined,\n      ...usage,\n      priority: Boolean(props.priority || props.preload || usage?.priority),\n    }\n    const selected = iris.select({\n      asset,\n      usage: contextUsage,\n      recipe: override,\n    })\n    if (!selected.ok) throw new Error(`Iris: ${selected.error.message}`)\n    const { name, recipe } = selected.data\n    const animated = asset.animated || /\\.(?:gif|svg)(?:[?#]|$)/i.test(src)\n    const direct = props.unoptimized || animated\n    const sizes = props.sizes || (props.width ? `${props.width}px` : \"100vw\")\n    const normalProps = {\n      ...props,\n      src,\n      sizes,\n      unoptimized: direct,\n      placeholder: \"empty\" as const,\n    }\n    const { props: normal } = getImageProps(normalProps)\n    // Source metadata describes the served file only when Next passes it through.\n    const liveProgressive = Boolean(\n      normal.src === src && !normal.srcSet && asset.progressive\n    )\n    const preview =\n      !direct && !liveProgressive\n        ? previewImage({ recipe, asset, props: normalProps })\n        : undefined\n    const progressiveDelivery = liveProgressive\n    const placeholder = !liveProgressive\n      ? resolvePlaceholder({ asset, placeholder: recipe.placeholder })\n      : null\n    const previewSettings =\n      recipe.preview && recipe.preview !== \"none\" ? recipe.preview : null\n    const loadPreviewFirst = Boolean(preview && previewSettings?.loadFirst)\n    const key = JSON.stringify([\n      src,\n      name,\n      sizes,\n      props.quality,\n      previewSettings,\n      liveProgressive,\n      loadPreviewFirst,\n    ])\n    return (\n      <DeliveryImage\n        key={key}\n        {...normalProps}\n        src={src}\n        source={src}\n        unoptimized={Boolean(direct)}\n        recipeName={name}\n        preview={preview}\n        loadPreviewFirst={loadPreviewFirst}\n        previewMinDisplayMs={previewSettings?.minDisplayMs ?? 0}\n        blurDataURL={placeholder?.url}\n        blurRadius={placeholder?.blur ?? 0}\n        progressiveDelivery={progressiveDelivery}\n      />\n    )\n  }\n}\n\ntype PreviewImage = {\n  src: string\n  loader?: NonNullable<ImageProps[\"loader\"]>\n  quality?: ImageProps[\"quality\"]\n  unoptimized: boolean\n}\n\nfunction previewImage({\n  recipe,\n  asset,\n  props,\n}: {\n  recipe: IrisRecipe\n  asset: IrisCatalogAsset\n  props: ImageProps\n}): PreviewImage | undefined {\n  const preview = recipe.preview\n  if (!preview || preview === \"none\") return undefined\n  if (preview.url)\n    return preview.url === asset.src\n      ? undefined\n      : { src: preview.url, unoptimized: true }\n\n  // Next knows the optimizer's allowed widths (and any custom loader). Build\n  // those URLs once, then map each responsive final descriptor to a smaller\n  // preview URL. The browser applies the same `sizes` to both images, so a\n  // ratio follows the width it actually selects at each viewport and DPR.\n  const quality = preview.quality ?? props.quality\n  const { props: candidates } = getImageProps({\n    ...props,\n    quality,\n    width: 1,\n    height: 1,\n    fill: false,\n    sizes: \"1px\",\n    placeholder: \"empty\",\n    overrideSrc: undefined,\n  })\n  const widths = (candidates.srcSet?.split(\", \") ?? []).flatMap((item) => {\n    const match = item.match(/^(.*) (\\d+)w$/)\n    return match ? [{ url: match[1], width: Number(match[2]) }] : []\n  })\n  if (!widths.length) return undefined\n  const loader: NonNullable<ImageProps[\"loader\"]> = ({ width }) => {\n    const cap =\n      preview.ratio === undefined\n        ? Math.min(width, preview.maxWidth ?? 640)\n        : Math.min(\n            Math.floor(width * preview.ratio),\n            preview.maxWidth ?? Infinity\n          )\n    const smaller = widths.filter((candidate) => candidate.width < width)\n    const selected =\n      smaller.filter((candidate) => candidate.width <= cap).at(-1) ??\n      smaller[0] ??\n      widths[0]\n    return selected.url\n  }\n  return { src: asset.src, loader, quality, unoptimized: false }\n}\n\nfunction DeliveryImage({\n  source,\n  recipeName,\n  preview,\n  loadPreviewFirst,\n  previewMinDisplayMs,\n  progressiveDelivery,\n  style,\n  onLoad,\n  onError,\n  onLoadCapture,\n  blurDataURL,\n  blurRadius,\n  ...props\n}: ImageProps & {\n  source: string\n  recipeName: string\n  preview?: PreviewImage\n  loadPreviewFirst: boolean\n  previewMinDisplayMs: number\n  blurRadius: number\n  progressiveDelivery: boolean\n  \"data-iris\"?: string\n}) {\n  const [loaded, setLoaded] = useState(false)\n  const [previewLoaded, setPreviewLoaded] = useState(false)\n  const [finalStarted, setFinalStarted] = useState(!loadPreviewFirst)\n  // Keep each fallback behind the final image. Browsers can paint an image as\n  // soon as it decodes, even before React hydrates and receives its load event.\n  // Covering the final with a blur made already-loaded images wait for hydration.\n  const layerZIndex = typeof style?.zIndex === \"number\" ? style.zIndex : 0\n  const iris = useIrisDebugger()\n  const finalRef = useRef<HTMLImageElement | null>(null)\n  const previewRef = useRef<HTMLImageElement | null>(null)\n  const previewMarked = useRef(false)\n  const attachFinal = useCallback((image: HTMLImageElement | null) => {\n    finalRef.current = image\n    if (image?.complete && image.naturalWidth && !isEmptyImage(image))\n      setLoaded(true)\n  }, [])\n  useEffect(() => {\n    let timer: ReturnType<typeof setTimeout> | undefined\n    let observer: IntersectionObserver | undefined\n    const startFallback = () => {\n      timer ??= setTimeout(() => setFinalStarted(true), 3000)\n    }\n    if (loadPreviewFirst && !finalStarted && previewLoaded) {\n      timer = setTimeout(() => setFinalStarted(true), previewMinDisplayMs)\n    } else if (loadPreviewFirst && !finalStarted && previewRef.current) {\n      if (typeof IntersectionObserver === \"undefined\") startFallback()\n      else {\n        observer = new IntersectionObserver((entries) => {\n          if (entries.some((entry) => entry.isIntersecting)) {\n            startFallback()\n            observer?.disconnect()\n          }\n        })\n        observer.observe(previewRef.current)\n      }\n    }\n    return () => {\n      observer?.disconnect()\n      if (timer) clearTimeout(timer)\n    }\n  }, [loadPreviewFirst, finalStarted, previewLoaded, previewMinDisplayMs])\n  const revealPreview = useCallback(\n    (image: HTMLImageElement) => {\n      if (!image.isConnected || !image.naturalWidth || previewMarked.current)\n        return\n      previewMarked.current = true\n      setPreviewLoaded(true)\n      if (finalRef.current) iris?.markPreview(finalRef.current, image)\n    },\n    [iris]\n  )\n  const attachPreview = useCallback(\n    (image: HTMLImageElement | null) => {\n      previewRef.current = image\n      if (image?.complete && image.naturalWidth) revealPreview(image)\n    },\n    [revealPreview]\n  )\n  useLayoutEffect(() => {\n    if (iris && finalRef.current) {\n      iris.startTimeline(finalRef.current)\n      if (\n        finalRef.current.complete &&\n        finalRef.current.naturalWidth &&\n        !isEmptyImage(finalRef.current)\n      )\n        iris.markFinal(finalRef.current)\n    }\n  }, [iris, source])\n  useLayoutEffect(() => {\n    const image = finalRef.current\n    if (\n      finalStarted &&\n      image?.complete &&\n      image.naturalWidth &&\n      !isEmptyImage(image)\n    ) {\n      setLoaded(true)\n      iris?.markFinal(image)\n    }\n  }, [finalStarted, iris])\n  const layers = (\n    <>\n      <Image\n        {...props}\n        src={finalStarted ? props.src : EMPTY_IMAGE}\n        unoptimized={finalStarted ? props.unoptimized : true}\n        loader={finalStarted ? props.loader : undefined}\n        overrideSrc={finalStarted ? props.overrideSrc : undefined}\n        priority={finalStarted ? props.priority : false}\n        preload={finalStarted ? props.preload : false}\n        fetchPriority={finalStarted ? props.fetchPriority : \"auto\"}\n        ref={attachFinal}\n        data-iris={props[\"data-iris\"] || props.alt || source}\n        data-iris-src={source}\n        data-iris-recipe={recipeName}\n        data-iris-delivery={progressiveDelivery ? \"progressive\" : undefined}\n        placeholder=\"empty\"\n        style={{\n          ...style,\n          ...(preview || blurDataURL ? { zIndex: layerZIndex + 2 } : {}),\n          ...(loaded ? { backgroundImage: \"none\" } : {}),\n        }}\n        onLoadCapture={(event) => {\n          if (isEmptyImage(event.currentTarget)) return\n          event.currentTarget.style.backgroundImage = \"none\"\n          setLoaded(true)\n          onLoadCapture?.(event)\n        }}\n        onLoad={(event) => {\n          if (isEmptyImage(event.currentTarget)) return\n          setLoaded(true)\n          iris?.markFinal(event.currentTarget)\n          onLoad?.(event)\n        }}\n        onError={(event) => {\n          if (isEmptyImage(event.currentTarget)) return\n          onError?.(event)\n        }}\n      />\n      {preview && !loaded && (\n        <Image\n          {...props}\n          src={preview.src}\n          loader={preview.loader}\n          overrideSrc={undefined}\n          ref={attachPreview}\n          unoptimized={preview.unoptimized}\n          quality={preview.quality}\n          fill\n          width={undefined}\n          height={undefined}\n          alt=\"\"\n          aria-hidden=\"true\"\n          data-iris={undefined}\n          data-slot=\"image-preview\"\n          priority={false}\n          preload={false}\n          fetchPriority=\"auto\"\n          placeholder=\"empty\"\n          style={{\n            ...style,\n            pointerEvents: \"none\",\n            zIndex: layerZIndex + 1,\n            backgroundImage: \"none\",\n          }}\n          onLoadCapture={(event) => revealPreview(event.currentTarget)}\n          onError={() => setFinalStarted(true)}\n        />\n      )}\n      {!loaded && !previewLoaded && blurDataURL && (\n        <span\n          aria-hidden=\"true\"\n          data-slot=\"image-placeholder\"\n          data-stage=\"blur\"\n          style={{\n            position: \"absolute\",\n            inset: 0,\n            ...style,\n            pointerEvents: \"none\",\n            zIndex: layerZIndex,\n            backgroundImage: `url(${JSON.stringify(blurDataURL)})`,\n            backgroundSize:\n              style?.objectFit === \"contain\"\n                ? \"contain\"\n                : style?.objectFit === \"cover\"\n                  ? \"cover\"\n                  : \"100% 100%\",\n            backgroundPosition: style?.objectPosition ?? \"center\",\n            backgroundRepeat: \"no-repeat\",\n            filter: `blur(${blurRadius}px)`,\n            clipPath: \"inset(0)\",\n          }}\n        />\n      )}\n    </>\n  )\n  // Isolate the layers so their z-index cannot cover captions or controls in\n  // the parent. Keep the containing block mounted after load to avoid shifts.\n  return preview || blurDataURL ? (\n    <span\n      data-slot=\"iris-image\"\n      style={\n        props.fill\n          ? { position: \"absolute\", inset: 0, isolation: \"isolate\" }\n          : {\n              position: \"relative\",\n              display: \"inline-grid\",\n              maxWidth: \"100%\",\n              isolation: \"isolate\",\n            }\n      }\n    >\n      {layers}\n    </span>\n  ) : (\n    layers\n  )\n}\n","import type { IrisCatalogAsset, IrisRecipe } from \"./policy-types\"\n\nexport function placeholderSettings(input: IrisRecipe[\"placeholder\"]) {\n  if (!input || input === \"none\") return null\n  const options = input === \"blur\" ? {} : input\n  return {\n    width: options.width ?? 10,\n    quality: options.quality ?? 40,\n    blur: options.blur ?? 12,\n  }\n}\n\nexport function resolvePlaceholder({\n  asset,\n  placeholder,\n}: {\n  asset: IrisCatalogAsset\n  placeholder: IrisRecipe[\"placeholder\"]\n}) {\n  const settings = placeholderSettings(placeholder)\n  if (!settings) return null\n  const url =\n    asset.placeholders?.find(\n      (item) =>\n        item.width === settings.width && item.quality === settings.quality\n    )?.url ??\n    (settings.width === 10 && settings.quality === 40\n      ? asset.placeholder\n      : undefined)\n  return url ? { url, blur: settings.blur } : null\n}\n"],"mappings":"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","names":["import_react","NextImage"]}

package/dist/next.d.cts

@@ -0,0 +1,16 @@
+import * as react from 'react';
+import { ImageProps } from 'next/image.js';
+import { k as IrisPolicyUsage, a as IrisPolicy, c as IrisCatalogAsset } from './policy-types-LoD2Ldcl.cjs';
+
+type IrisNextImageProps<Custom = Record<string, unknown>> = ImageProps & {
+    recipe?: string;
+    usage?: IrisPolicyUsage<Custom>;
+    "data-iris"?: string;
+};
+/** Next owns responsive widths, optimizer URLs and allowed quality values. */
+declare function createIrisNextImage<Custom>({ iris, catalog, }: {
+    iris: IrisPolicy<Custom>;
+    catalog: Readonly<Record<string, IrisCatalogAsset>>;
+}): ({ recipe: override, usage, ...props }: IrisNextImageProps<Custom>) => react.JSX.Element;
+
+export { type IrisNextImageProps, createIrisNextImage };

package/dist/next.d.ts

@@ -0,0 +1,16 @@
+import * as react from 'react';
+import { ImageProps } from 'next/image.js';
+import { k as IrisPolicyUsage, a as IrisPolicy, c as IrisCatalogAsset } from './policy-types-LoD2Ldcl.js';
+
+type IrisNextImageProps<Custom = Record<string, unknown>> = ImageProps & {
+    recipe?: string;
+    usage?: IrisPolicyUsage<Custom>;
+    "data-iris"?: string;
+};
+/** Next owns responsive widths, optimizer URLs and allowed quality values. */
+declare function createIrisNextImage<Custom>({ iris, catalog, }: {
+    iris: IrisPolicy<Custom>;
+    catalog: Readonly<Record<string, IrisCatalogAsset>>;
+}): ({ recipe: override, usage, ...props }: IrisNextImageProps<Custom>) => react.JSX.Element;
+
+export { type IrisNextImageProps, createIrisNextImage };