@prismicio/react 3.2.2-pr.241.0f293b1 → 3.2.2-pr.241.fab3732

package/dist/PrismicImage.d.ts

@@ -1,63 +1,63 @@
-import { type ComponentProps, FC, ReactNode } from "react";
-import { type ImageFieldImage, asImagePixelDensitySrcSet, asImageWidthSrcSet } from "@prismicio/client";
+import { ComponentProps, FC, ReactNode } from "react";
+import { ImageFieldImage, asImagePixelDensitySrcSet, asImageWidthSrcSet } from "@prismicio/client";
+
+//#region src/PrismicImage.d.ts
 type ImgixURLParams = Omit<NonNullable<Parameters<typeof asImageWidthSrcSet>[1]>, "widths"> & Omit<NonNullable<Parameters<typeof asImagePixelDensitySrcSet>[1]>, "pixelDensities">;
 /** Props for `<PrismicImage>`. */
-export type PrismicImageProps = Omit<ComponentProps<"img">, "src" | "srcset" | "alt"> & {
-    /** The Prismic image field or thumbnail to render. */
-    field: ImageFieldImage | null | undefined;
-    /**
-     * An object of Imgix URL API parameters to transform the image.
-     *
-     * See: https://docs.imgix.com/apis/rendering
-     */
-    imgixParams?: {
-        [P in keyof ImgixURLParams]: ImgixURLParams[P] | null;
-    };
-    /**
-     * Declare an image as decorative by providing `alt=""`.
-     *
-     * See:
-     * https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/alt#decorative_images
-     */
-    alt?: "";
-    /**
-     * Declare an image as decorative only if the image field does not have
-     * alternative text by providing `fallbackAlt=""`.
-     *
-     * See:
-     * https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/alt#decorative_images
-     */
-    fallbackAlt?: "";
-    /**
-     * The value to be rendered when the field is empty. If a fallback is not
-     * given, `null` will be rendered.
-     */
-    fallback?: ReactNode;
+type PrismicImageProps = Omit<ComponentProps<"img">, "src" | "srcset" | "alt"> & {
+  /** The Prismic image field or thumbnail to render. */
+  field: ImageFieldImage | null | undefined;
+  /**
+   * An object of Imgix URL API parameters to transform the image.
+   *
+   * See: https://docs.imgix.com/apis/rendering
+   */
+  imgixParams?: { [P in keyof ImgixURLParams]: ImgixURLParams[P] | null };
+  /**
+   * Declare an image as decorative by providing `alt=""`.
+   *
+   * See:
+   * https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/alt#decorative_images
+   */
+  alt?: "";
+  /**
+   * Declare an image as decorative only if the image field does not have
+   * alternative text by providing `fallbackAlt=""`.
+   *
+   * See:
+   * https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/alt#decorative_images
+   */
+  fallbackAlt?: "";
+  /**
+   * The value to be rendered when the field is empty. If a fallback is not
+   * given, `null` will be rendered.
+   */
+  fallback?: ReactNode;
 } & ({
-    /**
-     * Widths (in pixels) used to build a `srcset` value for the image
-     * field.
-     *
-     * If omitted or set to `"defaults"`, the following widths will be used:
-     * 640, 750, 828, 1080, 1200, 1920, 2048, 3840.
-     *
-     * If the image field contains responsive views, each responsive view
-     * can be used as a width in the resulting `srcset` by passing
-     * `"thumbnails"` as the `widths` prop.
-     */
-    widths?: NonNullable<Parameters<typeof asImageWidthSrcSet>[1]>["widths"] | "defaults";
-    /** Not used when the `widths` prop is used. */
-    pixelDensities?: never;
+  /**
+   * Widths (in pixels) used to build a `srcset` value for the image
+   * field.
+   *
+   * If omitted or set to `"defaults"`, the following widths will be used:
+   * 640, 750, 828, 1080, 1200, 1920, 2048, 3840.
+   *
+   * If the image field contains responsive views, each responsive view
+   * can be used as a width in the resulting `srcset` by passing
+   * `"thumbnails"` as the `widths` prop.
+   */
+  widths?: NonNullable<Parameters<typeof asImageWidthSrcSet>[1]>["widths"] | "defaults";
+  /** Not used when the `widths` prop is used. */
+  pixelDensities?: never;
 } | {
-    /** Not used when the `widths` prop is used. */
-    widths?: never;
-    /**
-     * Pixel densities used to build a `srcset` value for the image field.
-     *
-     * If a `pixelDensities` prop is passed `"defaults"`, the following
-     * pixel densities will be used: 1, 2, 3.
-     */
-    pixelDensities: NonNullable<Parameters<typeof asImagePixelDensitySrcSet>[1]>["pixelDensities"] | "defaults";
+  /** Not used when the `widths` prop is used. */
+  widths?: never;
+  /**
+   * Pixel densities used to build a `srcset` value for the image field.
+   *
+   * If a `pixelDensities` prop is passed `"defaults"`, the following
+   * pixel densities will be used: 1, 2, 3.
+   */
+  pixelDensities: NonNullable<Parameters<typeof asImagePixelDensitySrcSet>[1]>["pixelDensities"] | "defaults";
 });
 /**
  * Renders an optimized image from a Prismic image field.
@@ -70,5 +70,7 @@ export type PrismicImageProps = Omit<ComponentProps<"img">, "src" | "srcset" | "
  *
  * @see Learn how to optimize images with imgix, use responsive images, and use framework-specific image components: {@link https://prismic.io/docs/fields/image}
  */
-export declare const PrismicImage: FC<PrismicImageProps>;
-export {};
+declare const PrismicImage: FC<PrismicImageProps>;
+//#endregion
+export { PrismicImage, PrismicImageProps };
+//# sourceMappingURL=PrismicImage.d.ts.map

package/dist/PrismicImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrismicImage.d.ts","names":[],"sources":["../src/PrismicImage.tsx"],"sourcesContent":[],"mappings":";;;;KAiBK,cAAA,GAAiB,KACrB,YAAY,kBAAkB,qCAG9B,KACC,YAAY,kBAAkB;;AAL3B,KAUO,iBAAA,GAAoB,IAVb,CAWlB,cAXkB,CAAA,KAAA,CAAA,EAAA,KAAA,GAAA,QAAA,GAAA,KAAA,CAAA,GAAA;EACY;EAAlB,KAAA,EAcL,eAdK,GAAA,IAAA,GAAA,SAAA;EAAZ;;;;;EAGA,WAAA,CAAA,EAAA,QAAI,MAkBwB,cAlBxB,GAkByC,cAlBzC,CAkBwD,CAlBxD,CAAA,GAAA,IAAA,EAMO;EACX;;;;;;EAkCW,GAAA,CAAA,EAAA,EAAA;EAeyB;;;;;;;EAiCxB,WAAA,CAAA,EAAA,EAmFZ;;;;;aAnIW;;;;;;;;;;;;;WAeL,YAAY,kBAAkB;;;;;;;;;;;;kBAe9B,YACA,kBAAkB;;;;;;;;;;;;;cAiBZ,cAAc,GAAG"}

package/dist/PrismicImage.js

@@ -1,50 +1,57 @@
-import { jsx, Fragment } from "react/jsx-runtime";
+import { devMsg } from "./lib/devMsg.js";
 import { forwardRef } from "react";
-import { isFilled, asImageWidthSrcSet, asImagePixelDensitySrcSet } from "@prismicio/client";
+import { asImagePixelDensitySrcSet, asImageWidthSrcSet, isFilled } from "@prismicio/client";
 import { DEV } from "esm-env";
-import { devMsg } from "./lib/devMsg.js";
-const PrismicImage = forwardRef(function PrismicImage2(props, ref) {
-  const { field, alt, fallbackAlt, imgixParams = {}, widths, pixelDensities, fallback, ...restProps } = props;
-  if (DEV) {
-    if (typeof alt === "string" && alt !== "") {
-      console.warn(`[PrismicImage] The "alt" prop can only be used to declare an image as decorative by passing an empty string (alt="") but was provided a non-empty string. You can resolve this warning by removing the "alt" prop or changing it to alt="". For more details, see ${devMsg("alt-must-be-an-empty-string")}`);
-    }
-    if (typeof fallbackAlt === "string" && fallbackAlt !== "") {
-      console.warn(`[PrismicImage] The "fallbackAlt" prop can only be used to declare an image as decorative by passing an empty string (fallbackAlt="") but was provided a non-empty string. You can resolve this warning by removing the "fallbackAlt" prop or changing it to fallbackAlt="". For more details, see ${devMsg("alt-must-be-an-empty-string")}`);
-    }
-    if (widths && pixelDensities) {
-      console.warn(`[PrismicImage] Only one of "widths" or "pixelDensities" props can be provided. You can resolve this warning by removing either the "widths" or "pixelDensities" prop. "widths" will be used in this case.`);
-    }
-  }
-  if (!isFilled.imageThumbnail(field)) {
-    return jsx(Fragment, { children: fallback });
-  }
-  const resolvedImgixParams = imgixParams;
-  for (const x in imgixParams) {
-    if (resolvedImgixParams[x] === null) {
-      resolvedImgixParams[x] = void 0;
-    }
-  }
-  let src;
-  let srcSet;
-  if (widths || !pixelDensities) {
-    const res = asImageWidthSrcSet(field, {
-      ...resolvedImgixParams,
-      widths: widths === "defaults" ? void 0 : widths
-    });
-    src = res.src;
-    srcSet = res.srcset;
-  } else if (pixelDensities) {
-    const res = asImagePixelDensitySrcSet(field, {
-      ...resolvedImgixParams,
-      pixelDensities: pixelDensities === "defaults" ? void 0 : pixelDensities
-    });
-    src = res.src;
-    srcSet = res.srcset;
-  }
-  return jsx("img", { ref, src, srcSet, alt: alt ?? (field.alt || fallbackAlt), ...restProps });
+import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
+
+//#region src/PrismicImage.tsx
+/**
+* Renders an optimized image from a Prismic image field.
+*
+* @example
+*
+* ```tsx
+* <PrismicImage field={slice.primary.photo} />;
+* ```
+*
+* @see Learn how to optimize images with imgix, use responsive images, and use framework-specific image components: {@link https://prismic.io/docs/fields/image}
+*/
+const PrismicImage = forwardRef(function PrismicImage$1(props, ref) {
+	const { field, alt, fallbackAlt, imgixParams = {}, widths, pixelDensities, fallback, ...restProps } = props;
+	if (DEV) {
+		if (typeof alt === "string" && alt !== "") console.warn(`[PrismicImage] The "alt" prop can only be used to declare an image as decorative by passing an empty string (alt="") but was provided a non-empty string. You can resolve this warning by removing the "alt" prop or changing it to alt="". For more details, see ${devMsg("alt-must-be-an-empty-string")}`);
+		if (typeof fallbackAlt === "string" && fallbackAlt !== "") console.warn(`[PrismicImage] The "fallbackAlt" prop can only be used to declare an image as decorative by passing an empty string (fallbackAlt="") but was provided a non-empty string. You can resolve this warning by removing the "fallbackAlt" prop or changing it to fallbackAlt="". For more details, see ${devMsg("alt-must-be-an-empty-string")}`);
+		if (widths && pixelDensities) console.warn(`[PrismicImage] Only one of "widths" or "pixelDensities" props can be provided. You can resolve this warning by removing either the "widths" or "pixelDensities" prop. "widths" will be used in this case.`);
+	}
+	if (!isFilled.imageThumbnail(field)) return /* @__PURE__ */ jsx(Fragment$1, { children: fallback });
+	const resolvedImgixParams = imgixParams;
+	for (const x in imgixParams) if (resolvedImgixParams[x] === null) resolvedImgixParams[x] = void 0;
+	let src;
+	let srcSet;
+	if (widths || !pixelDensities) {
+		const res = asImageWidthSrcSet(field, {
+			...resolvedImgixParams,
+			widths: widths === "defaults" ? void 0 : widths
+		});
+		src = res.src;
+		srcSet = res.srcset;
+	} else if (pixelDensities) {
+		const res = asImagePixelDensitySrcSet(field, {
+			...resolvedImgixParams,
+			pixelDensities: pixelDensities === "defaults" ? void 0 : pixelDensities
+		});
+		src = res.src;
+		srcSet = res.srcset;
+	}
+	return /* @__PURE__ */ jsx("img", {
+		ref,
+		src,
+		srcSet,
+		alt: alt ?? (field.alt || fallbackAlt),
+		...restProps
+	});
 });
-export {
-  PrismicImage
-};
-//# sourceMappingURL=PrismicImage.js.map
+
+//#endregion
+export { PrismicImage };
+//# sourceMappingURL=PrismicImage.js.map

package/dist/PrismicImage.js.map

@@ -1 +1 @@
-{"version":3,"file":"PrismicImage.js","sources":["../src/PrismicImage.tsx"],"sourcesContent":["import {\n\tForwardedRef,\n\tforwardRef,\n\ttype ComponentProps,\n\tFC,\n\tReactNode,\n} from \"react\";\nimport {\n\ttype ImageFieldImage,\n\tasImagePixelDensitySrcSet,\n\tasImageWidthSrcSet,\n\tisFilled,\n} from \"@prismicio/client\";\nimport { DEV } from \"esm-env\";\n\nimport { devMsg } from \"./lib/devMsg.js\";\n\ntype ImgixURLParams = Omit<\n\tNonNullable<Parameters<typeof asImageWidthSrcSet>[1]>,\n\t\"widths\"\n> &\n\tOmit<\n\t\tNonNullable<Parameters<typeof asImagePixelDensitySrcSet>[1]>,\n\t\t\"pixelDensities\"\n\t>;\n\n/** Props for `<PrismicImage>`. */\nexport type PrismicImageProps = Omit<\n\tComponentProps<\"img\">,\n\t\"src\" | \"srcset\" | \"alt\"\n> & {\n\t/** The Prismic image field or thumbnail to render. */\n\tfield: ImageFieldImage | null | undefined;\n\n\t/**\n\t * An object of Imgix URL API parameters to transform the image.\n\t *\n\t * See: https://docs.imgix.com/apis/rendering\n\t */\n\timgixParams?: { [P in keyof ImgixURLParams]: ImgixURLParams[P] | null };\n\n\t/**\n\t * Declare an image as decorative by providing `alt=\"\"`.\n\t *\n\t * See:\n\t * https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/alt#decorative_images\n\t */\n\talt?: \"\";\n\n\t/**\n\t * Declare an image as decorative only if the image field does not have\n\t * alternative text by providing `fallbackAlt=\"\"`.\n\t *\n\t * See:\n\t * https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/alt#decorative_images\n\t */\n\tfallbackAlt?: \"\";\n\n\t/**\n\t * The value to be rendered when the field is empty. If a fallback is not\n\t * given, `null` will be rendered.\n\t */\n\tfallback?: ReactNode;\n} & (\n\t\t| {\n\t\t\t\t/**\n\t\t\t\t * Widths (in pixels) used to build a `srcset` value for the image\n\t\t\t\t * field.\n\t\t\t\t *\n\t\t\t\t * If omitted or set to `\"defaults\"`, the following widths will be used:\n\t\t\t\t * 640, 750, 828, 1080, 1200, 1920, 2048, 3840.\n\t\t\t\t *\n\t\t\t\t * If the image field contains responsive views, each responsive view\n\t\t\t\t * can be used as a width in the resulting `srcset` by passing\n\t\t\t\t * `\"thumbnails\"` as the `widths` prop.\n\t\t\t\t */\n\t\t\t\twidths?:\n\t\t\t\t\t| NonNullable<Parameters<typeof asImageWidthSrcSet>[1]>[\"widths\"]\n\t\t\t\t\t| \"defaults\";\n\t\t\t\t/** Not used when the `widths` prop is used. */\n\t\t\t\tpixelDensities?: never;\n\t\t  }\n\t\t| {\n\t\t\t\t/** Not used when the `widths` prop is used. */\n\t\t\t\twidths?: never;\n\t\t\t\t/**\n\t\t\t\t * Pixel densities used to build a `srcset` value for the image field.\n\t\t\t\t *\n\t\t\t\t * If a `pixelDensities` prop is passed `\"defaults\"`, the following\n\t\t\t\t * pixel densities will be used: 1, 2, 3.\n\t\t\t\t */\n\t\t\t\tpixelDensities:\n\t\t\t\t\t| NonNullable<\n\t\t\t\t\t\t\tParameters<typeof asImagePixelDensitySrcSet>[1]\n\t\t\t\t\t  >[\"pixelDensities\"]\n\t\t\t\t\t| \"defaults\";\n\t\t  }\n\t);\n\n/**\n * Renders an optimized image from a Prismic image field.\n *\n * @example\n *\n * ```tsx\n * <PrismicImage field={slice.primary.photo} />;\n * ```\n *\n * @see Learn how to optimize images with imgix, use responsive images, and use framework-specific image components: {@link https://prismic.io/docs/fields/image}\n */\nexport const PrismicImage: FC<PrismicImageProps> = forwardRef(\n\tfunction PrismicImage(\n\t\tprops: PrismicImageProps,\n\t\tref: ForwardedRef<HTMLImageElement>,\n\t) {\n\t\tconst {\n\t\t\tfield,\n\t\t\talt,\n\t\t\tfallbackAlt,\n\t\t\timgixParams = {},\n\t\t\twidths,\n\t\t\tpixelDensities,\n\t\t\tfallback,\n\t\t\t...restProps\n\t\t} = props;\n\n\t\tif (DEV) {\n\t\t\tif (typeof alt === \"string\" && alt !== \"\") {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicImage] The \"alt\" prop can only be used to declare an image as decorative by passing an empty string (alt=\"\") but was provided a non-empty string. You can resolve this warning by removing the \"alt\" prop or changing it to alt=\"\". For more details, see ${devMsg(\n\t\t\t\t\t\t\"alt-must-be-an-empty-string\",\n\t\t\t\t\t)}`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (typeof fallbackAlt === \"string\" && fallbackAlt !== \"\") {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicImage] The \"fallbackAlt\" prop can only be used to declare an image as decorative by passing an empty string (fallbackAlt=\"\") but was provided a non-empty string. You can resolve this warning by removing the \"fallbackAlt\" prop or changing it to fallbackAlt=\"\". For more details, see ${devMsg(\n\t\t\t\t\t\t\"alt-must-be-an-empty-string\",\n\t\t\t\t\t)}`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (widths && pixelDensities) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicImage] Only one of \"widths\" or \"pixelDensities\" props can be provided. You can resolve this warning by removing either the \"widths\" or \"pixelDensities\" prop. \"widths\" will be used in this case.`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tif (!isFilled.imageThumbnail(field)) {\n\t\t\treturn <>{fallback}</>;\n\t\t}\n\n\t\tconst resolvedImgixParams = imgixParams;\n\t\tfor (const x in imgixParams) {\n\t\t\tif (resolvedImgixParams[x as keyof typeof resolvedImgixParams] === null) {\n\t\t\t\tresolvedImgixParams[x as keyof typeof resolvedImgixParams] = undefined;\n\t\t\t}\n\t\t}\n\n\t\tlet src: string | undefined;\n\t\tlet srcSet: string | undefined;\n\n\t\tif (widths || !pixelDensities) {\n\t\t\tconst res = asImageWidthSrcSet(field, {\n\t\t\t\t...resolvedImgixParams,\n\t\t\t\twidths: widths === \"defaults\" ? undefined : widths,\n\t\t\t} as ImgixURLParams);\n\n\t\t\tsrc = res.src;\n\t\t\tsrcSet = res.srcset;\n\t\t} else if (pixelDensities) {\n\t\t\tconst res = asImagePixelDensitySrcSet(field, {\n\t\t\t\t...resolvedImgixParams,\n\t\t\t\tpixelDensities:\n\t\t\t\t\tpixelDensities === \"defaults\" ? undefined : pixelDensities,\n\t\t\t} as ImgixURLParams);\n\n\t\t\tsrc = res.src;\n\t\t\tsrcSet = res.srcset;\n\t\t}\n\n\t\treturn (\n\t\t\t<img\n\t\t\t\tref={ref}\n\t\t\t\tsrc={src}\n\t\t\t\tsrcSet={srcSet}\n\t\t\t\talt={alt ?? (field.alt || fallbackAlt)}\n\t\t\t\t{...restProps}\n\t\t\t/>\n\t\t);\n\t},\n);\n"],"names":["PrismicImage","_jsx","_Fragment"],"mappings":";;;;;AA8GO,MAAM,eAAsC,WAClD,SAASA,cACR,OACA,KAAmC;AAEnC,QAAM,EACL,OACA,KACA,aACA,cAAc,CAAA,GACd,QACA,gBACA,UACA,GAAG,UACA,IAAA;AAEJ,MAAI,KAAK;AACR,QAAI,OAAO,QAAQ,YAAY,QAAQ,IAAI;AAC1C,cAAQ,KACP,qQAAqQ,OACpQ,6BAA6B,CAC7B,EAAE;AAAA,IAAA;AAIL,QAAI,OAAO,gBAAgB,YAAY,gBAAgB,IAAI;AAC1D,cAAQ,KACP,qSAAqS,OACpS,6BAA6B,CAC7B,EAAE;AAAA,IAAA;AAIL,QAAI,UAAU,gBAAgB;AAC7B,cAAQ,KACP,2MAA2M;AAAA,IAAA;AAAA,EAE7M;AAGD,MAAI,CAAC,SAAS,eAAe,KAAK,GAAG;AACpC,WAAOC,IAAAC,UAAA,EAAA,UAAG,UAAQ;AAAA,EAAA;AAGnB,QAAM,sBAAsB;AAC5B,aAAW,KAAK,aAAa;AACxB,QAAA,oBAAoB,CAAqC,MAAM,MAAM;AACxE,0BAAoB,CAAqC,IAAI;AAAA,IAAA;AAAA,EAC9D;AAGG,MAAA;AACA,MAAA;AAEA,MAAA,UAAU,CAAC,gBAAgB;AACxB,UAAA,MAAM,mBAAmB,OAAO;AAAA,MACrC,GAAG;AAAA,MACH,QAAQ,WAAW,aAAa,SAAY;AAAA,IAAA,CAC1B;AAEnB,UAAM,IAAI;AACV,aAAS,IAAI;AAAA,aACH,gBAAgB;AACpB,UAAA,MAAM,0BAA0B,OAAO;AAAA,MAC5C,GAAG;AAAA,MACH,gBACC,mBAAmB,aAAa,SAAY;AAAA,IAAA,CAC3B;AAEnB,UAAM,IAAI;AACV,aAAS,IAAI;AAAA,EAAA;AAGd,SACCD,IAAA,OAAA,EACC,KACA,KACA,QACA,KAAK,QAAQ,MAAM,OAAO,cAAY,GAClC,WAAS;AAGhB,CAAC;"}
+{"version":3,"file":"PrismicImage.js","names":["PrismicImage"],"sources":["../src/PrismicImage.tsx"],"sourcesContent":["import {\n\ttype ForwardedRef,\n\tforwardRef,\n\ttype ComponentProps,\n\ttype FC,\n\ttype ReactNode,\n} from \"react\";\nimport {\n\ttype ImageFieldImage,\n\tasImagePixelDensitySrcSet,\n\tasImageWidthSrcSet,\n\tisFilled,\n} from \"@prismicio/client\";\nimport { DEV } from \"esm-env\";\n\nimport { devMsg } from \"./lib/devMsg.js\";\n\ntype ImgixURLParams = Omit<\n\tNonNullable<Parameters<typeof asImageWidthSrcSet>[1]>,\n\t\"widths\"\n> &\n\tOmit<\n\t\tNonNullable<Parameters<typeof asImagePixelDensitySrcSet>[1]>,\n\t\t\"pixelDensities\"\n\t>;\n\n/** Props for `<PrismicImage>`. */\nexport type PrismicImageProps = Omit<\n\tComponentProps<\"img\">,\n\t\"src\" | \"srcset\" | \"alt\"\n> & {\n\t/** The Prismic image field or thumbnail to render. */\n\tfield: ImageFieldImage | null | undefined;\n\n\t/**\n\t * An object of Imgix URL API parameters to transform the image.\n\t *\n\t * See: https://docs.imgix.com/apis/rendering\n\t */\n\timgixParams?: { [P in keyof ImgixURLParams]: ImgixURLParams[P] | null };\n\n\t/**\n\t * Declare an image as decorative by providing `alt=\"\"`.\n\t *\n\t * See:\n\t * https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/alt#decorative_images\n\t */\n\talt?: \"\";\n\n\t/**\n\t * Declare an image as decorative only if the image field does not have\n\t * alternative text by providing `fallbackAlt=\"\"`.\n\t *\n\t * See:\n\t * https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/alt#decorative_images\n\t */\n\tfallbackAlt?: \"\";\n\n\t/**\n\t * The value to be rendered when the field is empty. If a fallback is not\n\t * given, `null` will be rendered.\n\t */\n\tfallback?: ReactNode;\n} & (\n\t\t| {\n\t\t\t\t/**\n\t\t\t\t * Widths (in pixels) used to build a `srcset` value for the image\n\t\t\t\t * field.\n\t\t\t\t *\n\t\t\t\t * If omitted or set to `\"defaults\"`, the following widths will be used:\n\t\t\t\t * 640, 750, 828, 1080, 1200, 1920, 2048, 3840.\n\t\t\t\t *\n\t\t\t\t * If the image field contains responsive views, each responsive view\n\t\t\t\t * can be used as a width in the resulting `srcset` by passing\n\t\t\t\t * `\"thumbnails\"` as the `widths` prop.\n\t\t\t\t */\n\t\t\t\twidths?:\n\t\t\t\t\t| NonNullable<Parameters<typeof asImageWidthSrcSet>[1]>[\"widths\"]\n\t\t\t\t\t| \"defaults\";\n\t\t\t\t/** Not used when the `widths` prop is used. */\n\t\t\t\tpixelDensities?: never;\n\t\t  }\n\t\t| {\n\t\t\t\t/** Not used when the `widths` prop is used. */\n\t\t\t\twidths?: never;\n\t\t\t\t/**\n\t\t\t\t * Pixel densities used to build a `srcset` value for the image field.\n\t\t\t\t *\n\t\t\t\t * If a `pixelDensities` prop is passed `\"defaults\"`, the following\n\t\t\t\t * pixel densities will be used: 1, 2, 3.\n\t\t\t\t */\n\t\t\t\tpixelDensities:\n\t\t\t\t\t| NonNullable<\n\t\t\t\t\t\t\tParameters<typeof asImagePixelDensitySrcSet>[1]\n\t\t\t\t\t  >[\"pixelDensities\"]\n\t\t\t\t\t| \"defaults\";\n\t\t  }\n\t);\n\n/**\n * Renders an optimized image from a Prismic image field.\n *\n * @example\n *\n * ```tsx\n * <PrismicImage field={slice.primary.photo} />;\n * ```\n *\n * @see Learn how to optimize images with imgix, use responsive images, and use framework-specific image components: {@link https://prismic.io/docs/fields/image}\n */\nexport const PrismicImage: FC<PrismicImageProps> = forwardRef(\n\tfunction PrismicImage(\n\t\tprops: PrismicImageProps,\n\t\tref: ForwardedRef<HTMLImageElement>,\n\t) {\n\t\tconst {\n\t\t\tfield,\n\t\t\talt,\n\t\t\tfallbackAlt,\n\t\t\timgixParams = {},\n\t\t\twidths,\n\t\t\tpixelDensities,\n\t\t\tfallback,\n\t\t\t...restProps\n\t\t} = props;\n\n\t\tif (DEV) {\n\t\t\tif (typeof alt === \"string\" && alt !== \"\") {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicImage] The \"alt\" prop can only be used to declare an image as decorative by passing an empty string (alt=\"\") but was provided a non-empty string. You can resolve this warning by removing the \"alt\" prop or changing it to alt=\"\". For more details, see ${devMsg(\n\t\t\t\t\t\t\"alt-must-be-an-empty-string\",\n\t\t\t\t\t)}`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (typeof fallbackAlt === \"string\" && fallbackAlt !== \"\") {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicImage] The \"fallbackAlt\" prop can only be used to declare an image as decorative by passing an empty string (fallbackAlt=\"\") but was provided a non-empty string. You can resolve this warning by removing the \"fallbackAlt\" prop or changing it to fallbackAlt=\"\". For more details, see ${devMsg(\n\t\t\t\t\t\t\"alt-must-be-an-empty-string\",\n\t\t\t\t\t)}`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (widths && pixelDensities) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicImage] Only one of \"widths\" or \"pixelDensities\" props can be provided. You can resolve this warning by removing either the \"widths\" or \"pixelDensities\" prop. \"widths\" will be used in this case.`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tif (!isFilled.imageThumbnail(field)) {\n\t\t\treturn <>{fallback}</>;\n\t\t}\n\n\t\tconst resolvedImgixParams = imgixParams;\n\t\tfor (const x in imgixParams) {\n\t\t\tif (resolvedImgixParams[x as keyof typeof resolvedImgixParams] === null) {\n\t\t\t\tresolvedImgixParams[x as keyof typeof resolvedImgixParams] = undefined;\n\t\t\t}\n\t\t}\n\n\t\tlet src: string | undefined;\n\t\tlet srcSet: string | undefined;\n\n\t\tif (widths || !pixelDensities) {\n\t\t\tconst res = asImageWidthSrcSet(field, {\n\t\t\t\t...resolvedImgixParams,\n\t\t\t\twidths: widths === \"defaults\" ? undefined : widths,\n\t\t\t} as ImgixURLParams);\n\n\t\t\tsrc = res.src;\n\t\t\tsrcSet = res.srcset;\n\t\t} else if (pixelDensities) {\n\t\t\tconst res = asImagePixelDensitySrcSet(field, {\n\t\t\t\t...resolvedImgixParams,\n\t\t\t\tpixelDensities:\n\t\t\t\t\tpixelDensities === \"defaults\" ? undefined : pixelDensities,\n\t\t\t} as ImgixURLParams);\n\n\t\t\tsrc = res.src;\n\t\t\tsrcSet = res.srcset;\n\t\t}\n\n\t\treturn (\n\t\t\t<img\n\t\t\t\tref={ref}\n\t\t\t\tsrc={src}\n\t\t\t\tsrcSet={srcSet}\n\t\t\t\talt={alt ?? (field.alt || fallbackAlt)}\n\t\t\t\t{...restProps}\n\t\t\t/>\n\t\t);\n\t},\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;AA8GA,MAAa,eAAsC,WAClD,SAASA,eACR,OACA,KACC;CACD,MAAM,EACL,OACA,KACA,aACA,cAAc,EAAE,EAChB,QACA,gBACA,UACA,GAAG,cACA;AAEJ,KAAI,KAAK;AACR,MAAI,OAAO,QAAQ,YAAY,QAAQ,GACtC,SAAQ,KACP,qQAAqQ,OACpQ,8BACA,GACD;AAGF,MAAI,OAAO,gBAAgB,YAAY,gBAAgB,GACtD,SAAQ,KACP,qSAAqS,OACpS,8BACA,GACD;AAGF,MAAI,UAAU,eACb,SAAQ,KACP,4MACA;;AAIH,KAAI,CAAC,SAAS,eAAe,MAAM,CAClC,QAAO,4CAAG,WAAY;CAGvB,MAAM,sBAAsB;AAC5B,MAAK,MAAM,KAAK,YACf,KAAI,oBAAoB,OAA2C,KAClE,qBAAoB,KAAyC;CAI/D,IAAI;CACJ,IAAI;AAEJ,KAAI,UAAU,CAAC,gBAAgB;EAC9B,MAAM,MAAM,mBAAmB,OAAO;GACrC,GAAG;GACH,QAAQ,WAAW,aAAa,SAAY;GAC5C,CAAmB;AAEpB,QAAM,IAAI;AACV,WAAS,IAAI;YACH,gBAAgB;EAC1B,MAAM,MAAM,0BAA0B,OAAO;GAC5C,GAAG;GACH,gBACC,mBAAmB,aAAa,SAAY;GAC7C,CAAmB;AAEpB,QAAM,IAAI;AACV,WAAS,IAAI;;AAGd,QACC,oBAAC;EACK;EACA;EACG;EACR,KAAK,QAAQ,MAAM,OAAO;EAC1B,GAAI;GACH;EAGJ"}

package/dist/PrismicLink.d.ts

@@ -1,67 +1,69 @@
 import { ComponentProps, ComponentType, ForwardedRef, HTMLAttributeAnchorTarget, ReactNode } from "react";
-import { type LinkField, type LinkResolverFunction, type PrismicDocument, type AsLinkAttrsConfig } from "@prismicio/client";
+import { AsLinkAttrsConfig, LinkField, LinkResolverFunction, PrismicDocument } from "@prismicio/client";
+
+//#region src/PrismicLink.d.ts
 /** The default component rendered for internal and external links. */
 declare const defaultComponent = "a";
 /** Props provided to a component when rendered with `<PrismicLink>`. */
-export interface LinkProps {
-    /** The URL to link. */
-    href: string;
-    /**
-     * The `target` attribute for anchor elements. If the Prismic field is
-     * configured to open in a new window, this prop defaults to `_blank`.
-     */
-    target?: HTMLAttributeAnchorTarget;
-    /**
-     * The `rel` attribute for anchor elements. If the `target` prop is set to
-     * `"_blank"`, this prop defaults to `"noopener noreferrer"`.
-     */
-    rel?: string;
-    /** Children for the component. */
-    children?: ReactNode;
+interface LinkProps {
+  /** The URL to link. */
+  href: string;
+  /**
+   * The `target` attribute for anchor elements. If the Prismic field is
+   * configured to open in a new window, this prop defaults to `_blank`.
+   */
+  target?: HTMLAttributeAnchorTarget;
+  /**
+   * The `rel` attribute for anchor elements. If the `target` prop is set to
+   * `"_blank"`, this prop defaults to `"noopener noreferrer"`.
+   */
+  rel?: string;
+  /** Children for the component. */
+  children?: ReactNode;
 }
-export type PrismicLinkProps<InternalComponentProps = ComponentProps<typeof defaultComponent>, ExternalComponentProps = ComponentProps<typeof defaultComponent>> = Omit<InternalComponentProps & ExternalComponentProps, "rel" | "href" | "children"> & {
-    /**
-     * The `rel` attribute for the link. By default, `"noreferrer"` is provided if
-     * the link's URL is external. This prop can be provided a function to use the
-     * link's metadata to determine the `rel` value.
-     */
-    rel?: string | AsLinkAttrsConfig["rel"];
-    /**
-     * The link resolver used to resolve links.
-     *
-     * @remarks
-     * If your app uses route resolvers when querying for your Prismic
-     * repository's content, a link resolver does not need to be provided.
-     *
-     * @see Learn about link resolvers and route resolvers {@link https://prismic.io/docs/routes}
-     */
-    linkResolver?: LinkResolverFunction;
-    /**
-     * The component rendered for internal URLs. Defaults to `<a>`.
-     *
-     * If your app uses a client-side router that requires a special Link
-     * component, provide the Link component to this prop.
-     */
-    internalComponent?: ComponentType<InternalComponentProps>;
-    /** The component rendered for external URLs. Defaults to `<a>`. */
-    externalComponent?: ComponentType<ExternalComponentProps>;
-    /**
-     * The children to render for the link. If no children are provided, the
-     * link's `text` property will be used.
-     */
-    children?: ReactNode;
+type PrismicLinkProps<InternalComponentProps = ComponentProps<typeof defaultComponent>, ExternalComponentProps = ComponentProps<typeof defaultComponent>> = Omit<InternalComponentProps & ExternalComponentProps, "rel" | "href" | "children"> & {
+  /**
+   * The `rel` attribute for the link. By default, `"noreferrer"` is provided if
+   * the link's URL is external. This prop can be provided a function to use the
+   * link's metadata to determine the `rel` value.
+   */
+  rel?: string | AsLinkAttrsConfig["rel"];
+  /**
+   * The link resolver used to resolve links.
+   *
+   * @remarks
+   * If your app uses route resolvers when querying for your Prismic
+   * repository's content, a link resolver does not need to be provided.
+   *
+   * @see Learn about link resolvers and route resolvers {@link https://prismic.io/docs/routes}
+   */
+  linkResolver?: LinkResolverFunction;
+  /**
+   * The component rendered for internal URLs. Defaults to `<a>`.
+   *
+   * If your app uses a client-side router that requires a special Link
+   * component, provide the Link component to this prop.
+   */
+  internalComponent?: ComponentType<InternalComponentProps>;
+  /** The component rendered for external URLs. Defaults to `<a>`. */
+  externalComponent?: ComponentType<ExternalComponentProps>;
+  /**
+   * The children to render for the link. If no children are provided, the
+   * link's `text` property will be used.
+   */
+  children?: ReactNode;
 } & ({
-    document: PrismicDocument | null | undefined;
-    href?: never;
-    field?: never;
+  document: PrismicDocument | null | undefined;
+  href?: never;
+  field?: never;
 } | {
-    field: LinkField | null | undefined;
-    href?: never;
-    document?: never;
+  field: LinkField | null | undefined;
+  href?: never;
+  document?: never;
 } | {
-    href: LinkProps["href"];
-    field?: LinkField | null | undefined;
-    document?: never;
+  href: LinkProps["href"];
+  field?: LinkField | null | undefined;
+  document?: never;
 });
 /**
  * Renders a link from a Prismic link field or page.
@@ -74,15 +76,9 @@ export type PrismicLinkProps<InternalComponentProps = ComponentProps<typeof defa
  *
  * @see Learn how to display links and use variants for styling: {@link https://prismic.io/docs/fields/link}
  */
-export declare const PrismicLink: <InternalComponentProps = ComponentProps<typeof defaultComponent>, ExternalComponentProps = ComponentProps<typeof defaultComponent>>(props: PrismicLinkProps<InternalComponentProps, ExternalComponentProps> & {
-    ref?: ForwardedRef<Element>;
+declare const PrismicLink: <InternalComponentProps = ComponentProps<typeof defaultComponent>, ExternalComponentProps = ComponentProps<typeof defaultComponent>>(props: PrismicLinkProps<InternalComponentProps, ExternalComponentProps> & {
+  ref?: ForwardedRef<Element>;
 }) => ReactNode;
-/**
- * Determines if a URL is internal or external.
- *
- * @param url - The URL to check if internal or external.
- *
- * @returns `true` if `url` is internal, `false` otherwise.
- */
-export declare function isInternalURL(url: string): boolean;
-export {};
+//#endregion
+export { LinkProps, PrismicLink, PrismicLinkProps };
+//# sourceMappingURL=PrismicLink.d.ts.map

package/dist/PrismicLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrismicLink.d.ts","names":[],"sources":["../src/PrismicLink.tsx"],"sourcesContent":[],"mappings":";;;;;cAoBM,gBAAA;AANqB;AASV,UAAA,SAAA,CAQP;EAYE;EACoC,IAAA,EAAA,MAAA;EAAtB;;;;EAGA,MAAA,CAAA,EAhBhB,yBAgBgB;EADtB;;;;EA4BiB,GAAA,CAAA,EAAA,MAAA;EAGc;EAAd,QAAA,CAAA,EArCT,SAqCS;;AASP,KA3CF,gBA2CE,CAAA,yBA1CY,cA0CZ,CAAA,OA1CkC,gBA0ClC,CAAA,EAAA,yBAzCY,cAyCZ,CAAA,OAzCkC,gBAyClC,CAAA,CAAA,GAxCV,IAwCU,CAvCb,sBAuCa,GAvCY,sBAuCZ,EAAA,KAAA,GAAA,MAAA,GAAA,UAAA,CAAA,GAAA;EAKH;;;;AAsBX;EAsFgD,GAAA,CAAA,EAAA,MAAA,GAhJhC,iBAgJgC,CAAA,KAAA,CAAA;EAAtB;;;;;;;;;EAMZ,YAAA,CAAA,EA3IE,oBA2IF;;;;;;;sBAnIO,cAAc;;sBAGd,cAAc;;;;;aAMvB;;YAGE;;;;SAKH;;;;QAKD;UACE;;;;;;;;;;;;;;cAgBC,uCAsFa,sBAAsB,4CACtB,sBAAsB,0BAExC,iBAAiB,wBAAwB;QACzC,aAAa;MAEhB"}

package/dist/PrismicLink.js

@@ -1,47 +1,66 @@
-import { jsx } from "react/jsx-runtime";
+import { devMsg } from "./lib/devMsg.js";
 import { forwardRef } from "react";
 import { asLinkAttrs } from "@prismicio/client";
 import { DEV } from "esm-env";
-import { devMsg } from "./lib/devMsg.js";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/PrismicLink.tsx
+/** The default component rendered for internal and external links. */
 const defaultComponent = "a";
-const PrismicLink = forwardRef(function PrismicLink2(props, ref) {
-  const { field, document: doc, linkResolver, internalComponent, externalComponent, children, ...restProps } = props;
-  if (DEV) {
-    if (field) {
-      if (!field.link_type) {
-        console.error(`[PrismicLink] This "field" prop value caused an error to be thrown.
-`, field);
-        throw new Error(`[PrismicLink] The provided field is missing required properties to properly render a link. The link will not render. For more details, see ${devMsg("missing-link-properties")}`);
-      } else if (("text" in field ? Object.keys(field).length > 2 : Object.keys(field).length > 1) && !("url" in field || "uid" in field || "id" in field)) {
-        console.warn(`[PrismicLink] The provided field is missing required properties to properly render a link. The link may not render correctly. For more details, see ${devMsg("missing-link-properties")}`, field);
-      }
-    } else if (doc) {
-      if (!("url" in doc || "id" in doc)) {
-        console.warn(`[PrismicLink] The provided document is missing required properties to properly render a link. The link may not render correctly. For more details, see ${devMsg("missing-link-properties")}`, doc);
-      }
-    }
-  }
-  const { href: computedHref, rel: computedRel, ...attrs } = asLinkAttrs(field ?? doc, {
-    linkResolver,
-    rel: typeof restProps.rel === "function" ? restProps.rel : void 0
-  });
-  let rel = computedRel;
-  if ("rel" in restProps && typeof restProps.rel !== "function") {
-    rel = restProps.rel;
-  }
-  const href = ("href" in restProps ? restProps.href : computedHref) || "";
-  const InternalComponent = internalComponent || defaultComponent;
-  const ExternalComponent = externalComponent || defaultComponent;
-  const Component = href ? isInternalURL(href) ? InternalComponent : ExternalComponent : InternalComponent;
-  return jsx(Component, { ref, ...attrs, ...restProps, href, rel, children: "children" in props ? children : field == null ? void 0 : field.text });
+/**
+* Renders a link from a Prismic link field or page.
+*
+* @example
+*
+* ```tsx
+* <PrismicLink field={slice.primary.link}>Click here</PrismicLink>;
+* ```
+*
+* @see Learn how to display links and use variants for styling: {@link https://prismic.io/docs/fields/link}
+*/
+const PrismicLink = forwardRef(function PrismicLink$1(props, ref) {
+	const { field, document: doc, linkResolver, internalComponent, externalComponent, children, ...restProps } = props;
+	if (DEV) {
+		if (field) {
+			if (!field.link_type) {
+				console.error(`[PrismicLink] This "field" prop value caused an error to be thrown.\n`, field);
+				throw new Error(`[PrismicLink] The provided field is missing required properties to properly render a link. The link will not render. For more details, see ${devMsg("missing-link-properties")}`);
+			} else if (("text" in field ? Object.keys(field).length > 2 : Object.keys(field).length > 1) && !("url" in field || "uid" in field || "id" in field)) console.warn(`[PrismicLink] The provided field is missing required properties to properly render a link. The link may not render correctly. For more details, see ${devMsg("missing-link-properties")}`, field);
+		} else if (doc) {
+			if (!("url" in doc || "id" in doc)) console.warn(`[PrismicLink] The provided document is missing required properties to properly render a link. The link may not render correctly. For more details, see ${devMsg("missing-link-properties")}`, doc);
+		}
+	}
+	const { href: computedHref, rel: computedRel, ...attrs } = asLinkAttrs(field ?? doc, {
+		linkResolver,
+		rel: typeof restProps.rel === "function" ? restProps.rel : void 0
+	});
+	let rel = computedRel;
+	if ("rel" in restProps && typeof restProps.rel !== "function") rel = restProps.rel;
+	const href = ("href" in restProps ? restProps.href : computedHref) || "";
+	const InternalComponent = internalComponent || defaultComponent;
+	const ExternalComponent = externalComponent || defaultComponent;
+	return /* @__PURE__ */ jsx(href ? isInternalURL(href) ? InternalComponent : ExternalComponent : InternalComponent, {
+		ref,
+		...attrs,
+		...restProps,
+		href,
+		rel,
+		children: "children" in props ? children : field?.text
+	});
 });
+/**
+* Determines if a URL is internal or external.
+*
+* @param url - The URL to check if internal or external.
+*
+* @returns `true` if `url` is internal, `false` otherwise.
+*/
 function isInternalURL(url) {
-  const isInternal = /^(\/(?!\/)|#)/.test(url);
-  const isSpecialLink = !isInternal && !/^https?:\/\//.test(url);
-  return isInternal && !isSpecialLink;
+	const isInternal = /^(\/(?!\/)|#)/.test(url);
+	const isSpecialLink = !isInternal && !/^https?:\/\//.test(url);
+	return isInternal && !isSpecialLink;
 }
-export {
-  PrismicLink,
-  isInternalURL
-};
-//# sourceMappingURL=PrismicLink.js.map
+
+//#endregion
+export { PrismicLink };
+//# sourceMappingURL=PrismicLink.js.map

package/dist/PrismicLink.js.map

@@ -1 +1 @@
-{"version":3,"file":"PrismicLink.js","sources":["../src/PrismicLink.tsx"],"sourcesContent":["import {\n\tComponentProps,\n\tComponentType,\n\tForwardedRef,\n\tHTMLAttributeAnchorTarget,\n\tReactNode,\n\tforwardRef,\n} from \"react\";\nimport {\n\ttype LinkField,\n\ttype LinkResolverFunction,\n\ttype PrismicDocument,\n\tasLinkAttrs,\n\ttype AsLinkAttrsConfig,\n} from \"@prismicio/client\";\nimport { DEV } from \"esm-env\";\n\nimport { devMsg } from \"./lib/devMsg.js\";\n\n/** The default component rendered for internal and external links. */\nconst defaultComponent = \"a\";\n\n/** Props provided to a component when rendered with `<PrismicLink>`. */\nexport interface LinkProps {\n\t/** The URL to link. */\n\thref: string;\n\n\t/**\n\t * The `target` attribute for anchor elements. If the Prismic field is\n\t * configured to open in a new window, this prop defaults to `_blank`.\n\t */\n\ttarget?: HTMLAttributeAnchorTarget;\n\n\t/**\n\t * The `rel` attribute for anchor elements. If the `target` prop is set to\n\t * `\"_blank\"`, this prop defaults to `\"noopener noreferrer\"`.\n\t */\n\trel?: string;\n\n\t/** Children for the component. */\n\tchildren?: ReactNode;\n}\n\nexport type PrismicLinkProps<\n\tInternalComponentProps = ComponentProps<typeof defaultComponent>,\n\tExternalComponentProps = ComponentProps<typeof defaultComponent>,\n> = Omit<\n\tInternalComponentProps & ExternalComponentProps,\n\t\"rel\" | \"href\" | \"children\"\n> & {\n\t/**\n\t * The `rel` attribute for the link. By default, `\"noreferrer\"` is provided if\n\t * the link's URL is external. This prop can be provided a function to use the\n\t * link's metadata to determine the `rel` value.\n\t */\n\trel?: string | AsLinkAttrsConfig[\"rel\"];\n\n\t/**\n\t * The link resolver used to resolve links.\n\t *\n\t * @remarks\n\t * If your app uses route resolvers when querying for your Prismic\n\t * repository's content, a link resolver does not need to be provided.\n\t *\n\t * @see Learn about link resolvers and route resolvers {@link https://prismic.io/docs/routes}\n\t */\n\tlinkResolver?: LinkResolverFunction;\n\n\t/**\n\t * The component rendered for internal URLs. Defaults to `<a>`.\n\t *\n\t * If your app uses a client-side router that requires a special Link\n\t * component, provide the Link component to this prop.\n\t */\n\tinternalComponent?: ComponentType<InternalComponentProps>;\n\n\t/** The component rendered for external URLs. Defaults to `<a>`. */\n\texternalComponent?: ComponentType<ExternalComponentProps>;\n\n\t/**\n\t * The children to render for the link. If no children are provided, the\n\t * link's `text` property will be used.\n\t */\n\tchildren?: ReactNode;\n} & (\n\t\t| {\n\t\t\t\tdocument: PrismicDocument | null | undefined;\n\t\t\t\thref?: never;\n\t\t\t\tfield?: never;\n\t\t  }\n\t\t| {\n\t\t\t\tfield: LinkField | null | undefined;\n\t\t\t\thref?: never;\n\t\t\t\tdocument?: never;\n\t\t  }\n\t\t| {\n\t\t\t\thref: LinkProps[\"href\"];\n\t\t\t\tfield?: LinkField | null | undefined;\n\t\t\t\tdocument?: never;\n\t\t  }\n\t);\n\n/**\n * Renders a link from a Prismic link field or page.\n *\n * @example\n *\n * ```tsx\n * <PrismicLink field={slice.primary.link}>Click here</PrismicLink>;\n * ```\n *\n * @see Learn how to display links and use variants for styling: {@link https://prismic.io/docs/fields/link}\n */\nexport const PrismicLink = forwardRef(function PrismicLink<\n\tInternalComponentProps = ComponentProps<typeof defaultComponent>,\n\tExternalComponentProps = ComponentProps<typeof defaultComponent>,\n>(\n\tprops: PrismicLinkProps<InternalComponentProps, ExternalComponentProps>,\n\tref: ForwardedRef<Element>,\n) {\n\tconst {\n\t\tfield,\n\t\tdocument: doc,\n\t\tlinkResolver,\n\t\tinternalComponent,\n\t\texternalComponent,\n\t\tchildren,\n\t\t...restProps\n\t} = props;\n\n\tif (DEV) {\n\t\tif (field) {\n\t\t\tif (!field.link_type) {\n\t\t\t\tconsole.error(\n\t\t\t\t\t`[PrismicLink] This \"field\" prop value caused an error to be thrown.\\n`,\n\t\t\t\t\tfield,\n\t\t\t\t);\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`[PrismicLink] The provided field is missing required properties to properly render a link. The link will not render. For more details, see ${devMsg(\n\t\t\t\t\t\t\"missing-link-properties\",\n\t\t\t\t\t)}`,\n\t\t\t\t);\n\t\t\t} else if (\n\t\t\t\t(\"text\" in field\n\t\t\t\t\t? Object.keys(field).length > 2\n\t\t\t\t\t: Object.keys(field).length > 1) &&\n\t\t\t\t!(\"url\" in field || \"uid\" in field || \"id\" in field)\n\t\t\t) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicLink] The provided field is missing required properties to properly render a link. The link may not render correctly. For more details, see ${devMsg(\n\t\t\t\t\t\t\"missing-link-properties\",\n\t\t\t\t\t)}`,\n\t\t\t\t\tfield,\n\t\t\t\t);\n\t\t\t}\n\t\t} else if (doc) {\n\t\t\tif (!(\"url\" in doc || \"id\" in doc)) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicLink] The provided document is missing required properties to properly render a link. The link may not render correctly. For more details, see ${devMsg(\n\t\t\t\t\t\t\"missing-link-properties\",\n\t\t\t\t\t)}`,\n\t\t\t\t\tdoc,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n\n\tconst {\n\t\thref: computedHref,\n\t\trel: computedRel,\n\t\t...attrs\n\t} = asLinkAttrs(field ?? doc, {\n\t\tlinkResolver,\n\t\trel: typeof restProps.rel === \"function\" ? restProps.rel : undefined,\n\t});\n\n\tlet rel: string | undefined = computedRel;\n\tif (\"rel\" in restProps && typeof restProps.rel !== \"function\") {\n\t\trel = restProps.rel;\n\t}\n\n\tconst href = (\"href\" in restProps ? restProps.href : computedHref) || \"\";\n\n\tconst InternalComponent = (internalComponent ||\n\t\tdefaultComponent) as ComponentType<LinkProps>;\n\tconst ExternalComponent = (externalComponent ||\n\t\tdefaultComponent) as ComponentType<LinkProps>;\n\tconst Component = href\n\t\t? isInternalURL(href)\n\t\t\t? InternalComponent\n\t\t\t: ExternalComponent\n\t\t: InternalComponent;\n\n\treturn (\n\t\t<Component ref={ref} {...attrs} {...restProps} href={href} rel={rel}>\n\t\t\t{\"children\" in props ? children : field?.text}\n\t\t</Component>\n\t);\n}) as <\n\tInternalComponentProps = ComponentProps<typeof defaultComponent>,\n\tExternalComponentProps = ComponentProps<typeof defaultComponent>,\n>(\n\tprops: PrismicLinkProps<InternalComponentProps, ExternalComponentProps> & {\n\t\tref?: ForwardedRef<Element>;\n\t},\n) => ReactNode;\n\n/**\n * Determines if a URL is internal or external.\n *\n * @param url - The URL to check if internal or external.\n *\n * @returns `true` if `url` is internal, `false` otherwise.\n */\n// TODO: This does not detect all relative URLs as internal such as `about` or `./about`. This function assumes relative URLs start with a \"/\" or \"#\"`.\nexport function isInternalURL(url: string): boolean {\n\tconst isInternal = /^(\\/(?!\\/)|#)/.test(url);\n\tconst isSpecialLink = !isInternal && !/^https?:\\/\\//.test(url);\n\n\treturn isInternal && !isSpecialLink;\n}\n"],"names":["PrismicLink","_jsx"],"mappings":";;;;;AAoBA,MAAM,mBAAmB;AA6FlB,MAAM,cAAc,WAAW,SAASA,aAI9C,OACA,KAA0B;AAEpB,QAAA,EACL,OACA,UAAU,KACV,cACA,mBACA,mBACA,UACA,GAAG,UAAA,IACA;AAEJ,MAAI,KAAK;AACR,QAAI,OAAO;AACN,UAAA,CAAC,MAAM,WAAW;AACrB,gBAAQ,MACP;AAAA,GACA,KAAK;AAEN,cAAM,IAAI,MACT,8IAA8I,OAC7I,yBAAyB,CACzB,EAAE;AAAA,MAAA,YAGH,UAAU,QACR,OAAO,KAAK,KAAK,EAAE,SAAS,IAC5B,OAAO,KAAK,KAAK,EAAE,SAAS,MAC/B,EAAE,SAAS,SAAS,SAAS,SAAS,QAAQ,QAC7C;AACD,gBAAQ,KACP,uJAAuJ,OACtJ,yBAAyB,CACzB,IACD,KAAK;AAAA,MAAA;AAAA,eAGG,KAAK;AACf,UAAI,EAAE,SAAS,OAAO,QAAQ,MAAM;AACnC,gBAAQ,KACP,0JAA0J,OACzJ,yBAAyB,CACzB,IACD,GAAG;AAAA,MAAA;AAAA,IAEL;AAAA,EACD;AAGK,QAAA,EACL,MAAM,cACN,KAAK,aACL,GAAG,UACA,YAAY,SAAS,KAAK;AAAA,IAC7B;AAAA,IACA,KAAK,OAAO,UAAU,QAAQ,aAAa,UAAU,MAAM;AAAA,EAAA,CAC3D;AAED,MAAI,MAA0B;AAC9B,MAAI,SAAS,aAAa,OAAO,UAAU,QAAQ,YAAY;AAC9D,UAAM,UAAU;AAAA,EAAA;AAGjB,QAAM,QAAQ,UAAU,YAAY,UAAU,OAAO,iBAAiB;AAEtE,QAAM,oBAAqB,qBAC1B;AACD,QAAM,oBAAqB,qBAC1B;AACD,QAAM,YAAY,OACf,cAAc,IAAI,IACjB,oBACA,oBACD;AAEH,SACCC,IAAC,WAAS,EAAC,KAAc,GAAA,UAAW,WAAW,MAAY,eACzD,cAAc,QAAQ,WAAW,+BAAO,MAAI;AAGhD,CAAC;AAiBK,SAAU,cAAc,KAAW;AAClC,QAAA,aAAa,gBAAgB,KAAK,GAAG;AAC3C,QAAM,gBAAgB,CAAC,cAAc,CAAC,eAAe,KAAK,GAAG;AAE7D,SAAO,cAAc,CAAC;AACvB;"}
+{"version":3,"file":"PrismicLink.js","names":["PrismicLink"],"sources":["../src/PrismicLink.tsx"],"sourcesContent":["import {\n\ttype ComponentProps,\n\ttype ComponentType,\n\ttype ForwardedRef,\n\ttype HTMLAttributeAnchorTarget,\n\ttype ReactNode,\n\tforwardRef,\n} from \"react\";\nimport {\n\ttype LinkField,\n\ttype LinkResolverFunction,\n\ttype PrismicDocument,\n\tasLinkAttrs,\n\ttype AsLinkAttrsConfig,\n} from \"@prismicio/client\";\nimport { DEV } from \"esm-env\";\n\nimport { devMsg } from \"./lib/devMsg.js\";\n\n/** The default component rendered for internal and external links. */\nconst defaultComponent = \"a\";\n\n/** Props provided to a component when rendered with `<PrismicLink>`. */\nexport interface LinkProps {\n\t/** The URL to link. */\n\thref: string;\n\n\t/**\n\t * The `target` attribute for anchor elements. If the Prismic field is\n\t * configured to open in a new window, this prop defaults to `_blank`.\n\t */\n\ttarget?: HTMLAttributeAnchorTarget;\n\n\t/**\n\t * The `rel` attribute for anchor elements. If the `target` prop is set to\n\t * `\"_blank\"`, this prop defaults to `\"noopener noreferrer\"`.\n\t */\n\trel?: string;\n\n\t/** Children for the component. */\n\tchildren?: ReactNode;\n}\n\nexport type PrismicLinkProps<\n\tInternalComponentProps = ComponentProps<typeof defaultComponent>,\n\tExternalComponentProps = ComponentProps<typeof defaultComponent>,\n> = Omit<\n\tInternalComponentProps & ExternalComponentProps,\n\t\"rel\" | \"href\" | \"children\"\n> & {\n\t/**\n\t * The `rel` attribute for the link. By default, `\"noreferrer\"` is provided if\n\t * the link's URL is external. This prop can be provided a function to use the\n\t * link's metadata to determine the `rel` value.\n\t */\n\trel?: string | AsLinkAttrsConfig[\"rel\"];\n\n\t/**\n\t * The link resolver used to resolve links.\n\t *\n\t * @remarks\n\t * If your app uses route resolvers when querying for your Prismic\n\t * repository's content, a link resolver does not need to be provided.\n\t *\n\t * @see Learn about link resolvers and route resolvers {@link https://prismic.io/docs/routes}\n\t */\n\tlinkResolver?: LinkResolverFunction;\n\n\t/**\n\t * The component rendered for internal URLs. Defaults to `<a>`.\n\t *\n\t * If your app uses a client-side router that requires a special Link\n\t * component, provide the Link component to this prop.\n\t */\n\tinternalComponent?: ComponentType<InternalComponentProps>;\n\n\t/** The component rendered for external URLs. Defaults to `<a>`. */\n\texternalComponent?: ComponentType<ExternalComponentProps>;\n\n\t/**\n\t * The children to render for the link. If no children are provided, the\n\t * link's `text` property will be used.\n\t */\n\tchildren?: ReactNode;\n} & (\n\t\t| {\n\t\t\t\tdocument: PrismicDocument | null | undefined;\n\t\t\t\thref?: never;\n\t\t\t\tfield?: never;\n\t\t  }\n\t\t| {\n\t\t\t\tfield: LinkField | null | undefined;\n\t\t\t\thref?: never;\n\t\t\t\tdocument?: never;\n\t\t  }\n\t\t| {\n\t\t\t\thref: LinkProps[\"href\"];\n\t\t\t\tfield?: LinkField | null | undefined;\n\t\t\t\tdocument?: never;\n\t\t  }\n\t);\n\n/**\n * Renders a link from a Prismic link field or page.\n *\n * @example\n *\n * ```tsx\n * <PrismicLink field={slice.primary.link}>Click here</PrismicLink>;\n * ```\n *\n * @see Learn how to display links and use variants for styling: {@link https://prismic.io/docs/fields/link}\n */\nexport const PrismicLink = forwardRef(function PrismicLink<\n\tInternalComponentProps = ComponentProps<typeof defaultComponent>,\n\tExternalComponentProps = ComponentProps<typeof defaultComponent>,\n>(\n\tprops: PrismicLinkProps<InternalComponentProps, ExternalComponentProps>,\n\tref: ForwardedRef<Element>,\n) {\n\tconst {\n\t\tfield,\n\t\tdocument: doc,\n\t\tlinkResolver,\n\t\tinternalComponent,\n\t\texternalComponent,\n\t\tchildren,\n\t\t...restProps\n\t} = props;\n\n\tif (DEV) {\n\t\tif (field) {\n\t\t\tif (!field.link_type) {\n\t\t\t\tconsole.error(\n\t\t\t\t\t`[PrismicLink] This \"field\" prop value caused an error to be thrown.\\n`,\n\t\t\t\t\tfield,\n\t\t\t\t);\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`[PrismicLink] The provided field is missing required properties to properly render a link. The link will not render. For more details, see ${devMsg(\n\t\t\t\t\t\t\"missing-link-properties\",\n\t\t\t\t\t)}`,\n\t\t\t\t);\n\t\t\t} else if (\n\t\t\t\t(\"text\" in field\n\t\t\t\t\t? Object.keys(field).length > 2\n\t\t\t\t\t: Object.keys(field).length > 1) &&\n\t\t\t\t!(\"url\" in field || \"uid\" in field || \"id\" in field)\n\t\t\t) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicLink] The provided field is missing required properties to properly render a link. The link may not render correctly. For more details, see ${devMsg(\n\t\t\t\t\t\t\"missing-link-properties\",\n\t\t\t\t\t)}`,\n\t\t\t\t\tfield,\n\t\t\t\t);\n\t\t\t}\n\t\t} else if (doc) {\n\t\t\tif (!(\"url\" in doc || \"id\" in doc)) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[PrismicLink] The provided document is missing required properties to properly render a link. The link may not render correctly. For more details, see ${devMsg(\n\t\t\t\t\t\t\"missing-link-properties\",\n\t\t\t\t\t)}`,\n\t\t\t\t\tdoc,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n\n\tconst {\n\t\thref: computedHref,\n\t\trel: computedRel,\n\t\t...attrs\n\t} = asLinkAttrs(field ?? doc, {\n\t\tlinkResolver,\n\t\trel: typeof restProps.rel === \"function\" ? restProps.rel : undefined,\n\t});\n\n\tlet rel: string | undefined = computedRel;\n\tif (\"rel\" in restProps && typeof restProps.rel !== \"function\") {\n\t\trel = restProps.rel;\n\t}\n\n\tconst href = (\"href\" in restProps ? restProps.href : computedHref) || \"\";\n\n\tconst InternalComponent = (internalComponent ||\n\t\tdefaultComponent) as ComponentType<LinkProps>;\n\tconst ExternalComponent = (externalComponent ||\n\t\tdefaultComponent) as ComponentType<LinkProps>;\n\tconst Component = href\n\t\t? isInternalURL(href)\n\t\t\t? InternalComponent\n\t\t\t: ExternalComponent\n\t\t: InternalComponent;\n\n\treturn (\n\t\t<Component ref={ref} {...attrs} {...restProps} href={href} rel={rel}>\n\t\t\t{\"children\" in props ? children : field?.text}\n\t\t</Component>\n\t);\n}) as <\n\tInternalComponentProps = ComponentProps<typeof defaultComponent>,\n\tExternalComponentProps = ComponentProps<typeof defaultComponent>,\n>(\n\tprops: PrismicLinkProps<InternalComponentProps, ExternalComponentProps> & {\n\t\tref?: ForwardedRef<Element>;\n\t},\n) => ReactNode;\n\n/**\n * Determines if a URL is internal or external.\n *\n * @param url - The URL to check if internal or external.\n *\n * @returns `true` if `url` is internal, `false` otherwise.\n */\n// TODO: This does not detect all relative URLs as internal such as `about` or `./about`. This function assumes relative URLs start with a \"/\" or \"#\"`.\nexport function isInternalURL(url: string): boolean {\n\tconst isInternal = /^(\\/(?!\\/)|#)/.test(url);\n\tconst isSpecialLink = !isInternal && !/^https?:\\/\\//.test(url);\n\n\treturn isInternal && !isSpecialLink;\n}\n"],"mappings":";;;;;;;;AAoBA,MAAM,mBAAmB;;;;;;;;;;;;AA6FzB,MAAa,cAAc,WAAW,SAASA,cAI9C,OACA,KACC;CACD,MAAM,EACL,OACA,UAAU,KACV,cACA,mBACA,mBACA,UACA,GAAG,cACA;AAEJ,KAAI,KACH;MAAI,OACH;OAAI,CAAC,MAAM,WAAW;AACrB,YAAQ,MACP,yEACA,MACA;AACD,UAAM,IAAI,MACT,8IAA8I,OAC7I,0BACA,GACD;eAEA,UAAU,QACR,OAAO,KAAK,MAAM,CAAC,SAAS,IAC5B,OAAO,KAAK,MAAM,CAAC,SAAS,MAC/B,EAAE,SAAS,SAAS,SAAS,SAAS,QAAQ,OAE9C,SAAQ,KACP,uJAAuJ,OACtJ,0BACA,IACD,MACA;aAEQ,KACV;OAAI,EAAE,SAAS,OAAO,QAAQ,KAC7B,SAAQ,KACP,0JAA0J,OACzJ,0BACA,IACD,IACA;;;CAKJ,MAAM,EACL,MAAM,cACN,KAAK,aACL,GAAG,UACA,YAAY,SAAS,KAAK;EAC7B;EACA,KAAK,OAAO,UAAU,QAAQ,aAAa,UAAU,MAAM;EAC3D,CAAC;CAEF,IAAI,MAA0B;AAC9B,KAAI,SAAS,aAAa,OAAO,UAAU,QAAQ,WAClD,OAAM,UAAU;CAGjB,MAAM,QAAQ,UAAU,YAAY,UAAU,OAAO,iBAAiB;CAEtE,MAAM,oBAAqB,qBAC1B;CACD,MAAM,oBAAqB,qBAC1B;AAOD,QACC,oBAPiB,OACf,cAAc,KAAK,GAClB,oBACA,oBACD;EAGc;EAAK,GAAI;EAAO,GAAI;EAAiB;EAAW;YAC9D,cAAc,QAAQ,WAAW,OAAO;GAC9B;EAEZ;;;;;;;;AAiBF,SAAgB,cAAc,KAAsB;CACnD,MAAM,aAAa,gBAAgB,KAAK,IAAI;CAC5C,MAAM,gBAAgB,CAAC,cAAc,CAAC,eAAe,KAAK,IAAI;AAE9D,QAAO,cAAc,CAAC"}