@prismicio/vue 3.0.0-beta.5 → 3.0.0-beta.8

package/dist/index.d.ts

@@ -5,6 +5,33 @@ import { Client, ClientConfig, predicate, cookie, PrismicError, ParsingError, Fo
 import { asText, asHTML, asLink, LinkResolverFunction, asDate, asImageSrc, asImageWidthSrcSet, asImagePixelDensitySrcSet, documentToLinkField, HTMLFunctionSerializer, HTMLMapSerializer } from '@prismicio/helpers';
 import { Slice, EmbedField, ImageField, LinkField, PrismicDocument, RichTextField, Query } from '@prismicio/types';
 
+/**
+ * Returns the type of a `SliceLike` type.
+ *
+ * @typeParam TSlice - The Slice from which the type will be extracted.
+ */
+declare type ExtractSliceType<TSlice extends SliceLike> = TSlice extends SliceLikeRestV2 ? TSlice["slice_type"] : TSlice extends SliceLikeGraphQL ? TSlice["type"] : never;
+/**
+ * The minimum required properties to represent a Prismic Slice from the Prismic
+ * Rest API V2 for the `<SliceZone>` component.
+ *
+ * If using Prismic's Rest API V2, use the `Slice` export from
+ * `@prismicio/types` for a full interface.
+ *
+ * @typeParam TSliceType - Type name of the Slice.
+ */
+declare type SliceLikeRestV2<TSliceType extends string = string> = {
+    slice_type: Slice<TSliceType>["slice_type"];
+};
+/**
+ * The minimum required properties to represent a Prismic Slice from the Prismic
+ * GraphQL API for the `<SliceZone>` component.
+ *
+ * @typeParam TSliceType - Type name of the Slice.
+ */
+declare type SliceLikeGraphQL<TSliceType extends string = string> = {
+    type: Slice<TSliceType>["slice_type"];
+};
 /**
  * The minimum required properties to represent a Prismic Slice for the
  * `<SliceZone />` component.
@@ -14,7 +41,7 @@ import { Slice, EmbedField, ImageField, LinkField, PrismicDocument, RichTextFiel
  *
  * @typeParam TSliceType - Type name of the Slice
  */
-declare type SliceLike<TSliceType extends string = string> = Pick<Slice<TSliceType>, "slice_type">;
+declare type SliceLike<TSliceType extends string = string> = SliceLikeRestV2<TSliceType> | SliceLikeGraphQL<TSliceType>;
 /**
  * A looser version of the `SliceZone` type from `@prismicio/types` using `SliceLike`.
  *
@@ -23,7 +50,7 @@ declare type SliceLike<TSliceType extends string = string> = Pick<Slice<TSliceTy
  *
  * @typeParam TSlice - The type(s) of slices in the Slice Zone
  */
-declare type SliceZoneLike<TSlice extends SliceLike> = readonly TSlice[];
+declare type SliceZoneLike<TSlice extends SliceLike = SliceLike> = readonly TSlice[];
 /**
  * Vue props for a component rendering content from a Prismic Slice using the
  * `<SliceZone />` component.
@@ -32,7 +59,7 @@ declare type SliceZoneLike<TSlice extends SliceLike> = readonly TSlice[];
  * @typeParam TContext - Arbitrary data passed to `<SliceZone />` and made
  *   available to all Slice components
  */
-declare type SliceComponentProps<TSlice extends SliceLike = SliceLike, TContext = unknown> = {
+declare type SliceComponentProps<TSlice extends SliceLike = any, TContext = unknown> = {
     /**
      * Slice data for this component.
      */
@@ -58,7 +85,7 @@ declare type SliceComponentProps<TSlice extends SliceLike = SliceLike, TContext
  * @typeParam TContext - Arbitrary data passed to `<SliceZone />` and made
  *   available to all Slice components
  */
-declare type DefineComponentSliceComponentProps<TSlice extends SliceLike = SliceLike, TContext = unknown> = {
+declare type DefineComponentSliceComponentProps<TSlice extends SliceLike = any, TContext = unknown> = {
     slice: {
         type: PropType<SliceComponentProps<TSlice, TContext>["slice"]>;
         required: true;
@@ -110,21 +137,23 @@ declare type DefineComponentSliceComponentProps<TSlice extends SliceLike = Slice
  *
  * @returns Props object to use with {@link defineComponent}
  */
-declare const getSliceComponentProps: <TSlice extends SliceLike<string> = SliceLike<string>, TContext = unknown>(propsHint?: ["slice", "index", "slices", "context"] | undefined) => DefineComponentSliceComponentProps<TSlice, TContext>;
+declare const getSliceComponentProps: <TSlice extends SliceLike<string> = SliceLike<string>, TContext = unknown>(propsHint?: ["slice", "index", "slices", "context"]) => DefineComponentSliceComponentProps<TSlice, TContext>;
 /**
  * A Vue component to be rendered for each instance of its Slice.
  *
  * @typeParam TSlice - The type(s) of slices in the Slice Zone
  * @typeParam TContext - Arbitrary data made available to all Slice components
  */
-declare type SliceComponentType<TSlice extends SliceLike = SliceLike, TContext = unknown> = DefineComponent<SliceComponentProps<TSlice, TContext>> | FunctionalComponent<SliceComponentProps<TSlice, TContext>>;
+declare type SliceComponentType<TSlice extends SliceLike = any, TContext = unknown> = DefineComponent<SliceComponentProps<TSlice, TContext>> | FunctionalComponent<SliceComponentProps<TSlice, TContext>>;
 /**
  * This Slice component can be used as a reminder to provide a proper implementation.
  *
  * This is also the default Vue component rendered when a component mapping
  * cannot be found in `<SliceZone />`.
  */
-declare const TODOSliceComponent: FunctionalComponent<SliceComponentProps<SliceLike<string>, unknown>, {}> | DefineComponent<SliceComponentProps<SliceLike<string>, unknown>, {}, {}, vue.ComputedOptions, vue.MethodOptions, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, VNodeProps & AllowedComponentProps & ComponentCustomProps, Readonly<SliceComponentProps<SliceLike<string>, unknown>>, {}>;
+declare const TODOSliceComponent: FunctionalComponent<SliceComponentProps<any, unknown>, {}> | DefineComponent<SliceComponentProps<any, unknown>, {}, {}, vue.ComputedOptions, vue.MethodOptions, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, VNodeProps & AllowedComponentProps & ComponentCustomProps, Readonly<SliceComponentProps<any, unknown>>, {
+    slice: any;
+}>;
 /**
  * A record of Slice types mapped to Vue components. Each components will be
  * rendered for each instance of their Slice type.
@@ -133,7 +162,7 @@ declare const TODOSliceComponent: FunctionalComponent<SliceComponentProps<SliceL
  * @typeParam TContext - Arbitrary data made available to all Slice components
  */
 declare type SliceZoneComponents<TSlice extends SliceLike = SliceLike, TContext = unknown> = {
-    [SliceType in keyof Record<TSlice["slice_type"], never>]: SliceComponentType<Extract<TSlice, SliceLike<SliceType>>, TContext> | string;
+    [SliceType in ExtractSliceType<TSlice>]: SliceComponentType<Extract<TSlice, SliceLike<SliceType>>, TContext> | string;
 };
 /**
  * Gets an optimized record of Slice types mapped to Vue components. Each
@@ -167,7 +196,7 @@ declare type SliceZoneComponents<TSlice extends SliceLike = SliceLike, TContext
  *
  * @returns A new optimized record of {@link SliceZoneComponents}
  */
-declare const defineSliceZoneComponents: <TSlice extends SliceLike<string> = SliceLike<string>, TContext = unknown>(components: SliceZoneComponents<TSlice, TContext>) => SliceZoneComponents<TSlice, TContext>;
+declare const defineSliceZoneComponents: <TSlice extends SliceLike<string> = any, TContext = unknown>(components: SliceZoneComponents<TSlice, TContext>) => SliceZoneComponents<TSlice, TContext>;
 /**
  * Arguments for a `<SliceZone>` `resolver` function.
  */
@@ -179,7 +208,7 @@ declare type SliceZoneResolverArgs<TSlice extends SliceLike = SliceLike> = {
     /**
      * The name of the Slice.
      */
-    sliceName: TSlice["slice_type"];
+    sliceName: ExtractSliceType<TSlice>;
     /**
      * The index of the Slice in the Slice Zone.
      */
@@ -196,18 +225,17 @@ declare type SliceZoneResolverArgs<TSlice extends SliceLike = SliceLike> = {
  *
  * @returns The Vue component to render for a Slice.
  */
-declare type SliceZoneResolver<TSlice extends SliceLike = SliceLike, TContext = unknown> = (args: SliceZoneResolverArgs<TSlice>) => SliceComponentType<TSlice, TContext> | string | undefined | null;
+declare type SliceZoneResolver<TSlice extends SliceLike = any, TContext = unknown> = (args: SliceZoneResolverArgs<TSlice>) => SliceComponentType<any, TContext> | string | undefined | null;
 /**
  * Props for `<SliceZone />`.
  *
- * @typeParam TSlice - The type(s) of slices in the Slice Zone
  * @typeParam TContext - Arbitrary data made available to all Slice components
  */
-declare type SliceZoneProps<TSlice extends SliceLike = SliceLike, TContext = unknown> = {
+declare type SliceZoneProps<TContext = unknown> = {
     /**
      * List of Slice data from the Slice Zone.
      */
-    slices: SliceZoneLike<TSlice>;
+    slices: SliceZoneLike;
     /**
      * A record mapping Slice types to Vue components.
      */
@@ -222,7 +250,7 @@ declare type SliceZoneProps<TSlice extends SliceLike = SliceLike, TContext = unk
      *
      * @returns The Vue component to render for a Slice.
      */
-    resolver?: SliceZoneResolver<TSlice, TContext>;
+    resolver?: SliceZoneResolver<any, TContext>;
     /**
      * Arbitrary data made available to all Slice components.
      */
@@ -236,7 +264,7 @@ declare type SliceZoneProps<TSlice extends SliceLike = SliceLike, TContext = unk
      *
      * @defaultValue The Slice Zone default component provided to `@prismicio/vue` plugin if configured, otherwise `null` when `process.env.NODE_ENV === "production"` else {@link TODOSliceComponent}.
      */
-    defaultComponent?: SliceComponentType<TSlice, TContext>;
+    defaultComponent?: SliceComponentType<any, TContext>;
     /**
      * An HTML tag name, a component, or a functional component used to wrap the
      * output. The Slice Zone is not wrapped by default.
@@ -677,8 +705,8 @@ declare type PrismicImageProps = {
      * Adds an additional `srcset` attribute to the image following given widths.
      *
      * @remarks
-     * A special value of `"auto"` is accepted to automatically use image widths
-     * coming from the API.
+     * A special value of `"thumbnails"` is accepted to automatically use image
+     * widths coming from the API.
      * @remarks
      * A special value of `"defaults"` is accepted to automatically use image
      * widths coming from the plugin configuration.
@@ -686,7 +714,7 @@ declare type PrismicImageProps = {
      * This prop is not compatible with the `pixelDensities` prop. When both are
      * used the `pixelDensities` prop will be ignored.
      */
-    widths?: NonNullable<Parameters<typeof asImageWidthSrcSet>[1]>["widths"] | "auto" | "defaults";
+    widths?: NonNullable<Parameters<typeof asImageWidthSrcSet>[1]>["widths"] | "thumbnails" | "defaults";
     /**
      * Adds an additional `srcset` attribute to the image following giving pixel densities.
      *
@@ -850,7 +878,7 @@ declare type PrismicTextProps = {
     /**
      * The Prismic rich text or title field to render.
      */
-    field: RichTextField;
+    field: RichTextField | null | undefined;
     /**
      * Separator used to join each element.
      *
@@ -863,6 +891,11 @@ declare type PrismicTextProps = {
      * @defaultValue `"div"`
      */
     wrapper?: string | ConcreteComponent;
+    /**
+     * The string value to be rendered when the field is empty. If a fallback is
+     * not given, `""` (nothing) will be rendered.
+     */
+    fallback?: string;
 };
 /**
  * Options for {@link usePrismicText}.
@@ -902,7 +935,7 @@ declare type PrismicRichTextProps = {
     /**
      * The Prismic rich text or title field to render.
      */
-    field: RichTextField;
+    field: RichTextField | null | undefined;
     /**
      * A link resolver function used to resolve link when not using the route
      * resolver parameter with `@prismicio/client`.
@@ -926,6 +959,11 @@ declare type PrismicRichTextProps = {
      * @defaultValue `"div"`
      */
     wrapper?: string | ConcreteComponent;
+    /**
+     * The HTML value to be rendered when the field is empty. If a fallback is not
+     * given, `""` (nothing) will be rendered.
+     */
+    fallback?: string;
 };
 /**
  * Options for {@link usePrismicRichText}.
@@ -1010,6 +1048,8 @@ declare const usePrismicDocuments: <TDocument extends PrismicDocument<Record<str
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<Query<TDocument>>;
 /**
@@ -1034,6 +1074,8 @@ declare const useFirstPrismicDocument: <TDocument extends PrismicDocument<Record
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument>;
 /**
@@ -1058,6 +1100,8 @@ declare const usePrismicDocumentByID: <TDocument extends PrismicDocument<Record<
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument>;
 /**
@@ -1082,6 +1126,8 @@ declare const usePrismicDocumentsByIDs: <TDocument extends PrismicDocument<Recor
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<Query<TDocument>>;
 /**
@@ -1100,12 +1146,16 @@ declare const usePrismicDocumentsByIDs: <TDocument extends PrismicDocument<Recor
  * @see Underlying `@prismicio/client` method {@link Client.getAllByIDs}
  */
 declare const useAllPrismicDocumentsByIDs: <TDocument extends PrismicDocument<Record<string, any>, string, string>>(ids: string[], params?: (Partial<_prismicio_client.BuildQueryURLArgs> & {
+    limit?: number | undefined;
+} & {
     signal?: {
         aborted: any;
         addEventListener: any;
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument[]>;
 /**
@@ -1132,6 +1182,8 @@ declare const usePrismicDocumentByUID: <TDocument extends PrismicDocument<Record
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument>;
 /**
@@ -1157,6 +1209,8 @@ declare const usePrismicDocumentsByUIDs: <TDocument extends PrismicDocument<Reco
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<Query<TDocument>>;
 /**
@@ -1176,12 +1230,16 @@ declare const usePrismicDocumentsByUIDs: <TDocument extends PrismicDocument<Reco
  * @see Underlying `@prismicio/client` method {@link Client.getAllByIDs}
  */
 declare const useAllPrismicDocumentsByUIDs: <TDocument extends PrismicDocument<Record<string, any>, string, string>>(documentType: string, ids: string[], params?: (Partial<_prismicio_client.BuildQueryURLArgs> & {
+    limit?: number | undefined;
+} & {
     signal?: {
         aborted: any;
         addEventListener: any;
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument[]>;
 /**
@@ -1207,6 +1265,8 @@ declare const useSinglePrismicDocument: <TDocument extends PrismicDocument<Recor
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument>;
 /**
@@ -1232,6 +1292,8 @@ declare const usePrismicDocumentsByType: <TDocument extends PrismicDocument<Reco
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<Query<TDocument>>;
 /**
@@ -1251,12 +1313,16 @@ declare const usePrismicDocumentsByType: <TDocument extends PrismicDocument<Reco
  * @see Underlying `@prismicio/client` method {@link Client.getAllByType}
  */
 declare const useAllPrismicDocumentsByType: <TDocument extends PrismicDocument<Record<string, any>, string, string>>(documentType: string, params?: (Partial<Omit<_prismicio_client.BuildQueryURLArgs, "page">> & {
+    limit?: number | undefined;
+} & {
     signal?: {
         aborted: any;
         addEventListener: any;
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument[]>;
 /**
@@ -1281,6 +1347,8 @@ declare const usePrismicDocumentsByTag: <TDocument extends PrismicDocument<Recor
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<Query<TDocument>>;
 /**
@@ -1300,12 +1368,16 @@ declare const usePrismicDocumentsByTag: <TDocument extends PrismicDocument<Recor
  * @see Underlying `@prismicio/client` method {@link Client.getAllByTag}
  */
 declare const useAllPrismicDocumentsByTag: <TDocument extends PrismicDocument<Record<string, any>, string, string>>(tag: string, params?: (Partial<Omit<_prismicio_client.BuildQueryURLArgs, "page">> & {
+    limit?: number | undefined;
+} & {
     signal?: {
         aborted: any;
         addEventListener: any;
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument[]>;
 /**
@@ -1331,6 +1403,8 @@ declare const usePrismicDocumentsByEveryTag: <TDocument extends PrismicDocument<
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<Query<TDocument>>;
 /**
@@ -1350,12 +1424,16 @@ declare const usePrismicDocumentsByEveryTag: <TDocument extends PrismicDocument<
  * @see Underlying `@prismicio/client` method {@link Client.getAllByTags}
  */
 declare const useAllPrismicDocumentsByEveryTag: <TDocument extends PrismicDocument<Record<string, any>, string, string>>(tags: string[], params?: (Partial<Omit<_prismicio_client.BuildQueryURLArgs, "page">> & {
+    limit?: number | undefined;
+} & {
     signal?: {
         aborted: any;
         addEventListener: any;
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument[]>;
 /**
@@ -1381,6 +1459,8 @@ declare const usePrismicDocumentsBySomeTags: <TDocument extends PrismicDocument<
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<Query<TDocument>>;
 /**
@@ -1401,12 +1481,16 @@ declare const usePrismicDocumentsBySomeTags: <TDocument extends PrismicDocument<
  * @see Underlying `@prismicio/client` method {@link Client.getAllByTags}
  */
 declare const useAllPrismicDocumentsBySomeTags: <TDocument extends PrismicDocument<Record<string, any>, string, string>>(tags: string[], params?: (Partial<Omit<_prismicio_client.BuildQueryURLArgs, "page">> & {
+    limit?: number | undefined;
+} & {
     signal?: {
         aborted: any;
         addEventListener: any;
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument[]>;
 /**
@@ -1437,6 +1521,8 @@ declare const dangerouslyUseAllPrismicDocuments: <TDocument extends PrismicDocum
         removeEventListener: any;
         dispatchEvent: any;
         onabort: any;
+        reason: any;
+        throwIfAborted: any;
     } | undefined;
 } & ComposableOnlyParameters) | undefined) => ClientComposableReturnType<TDocument[]>;
 
@@ -1458,4 +1544,4 @@ declare module "@vue/runtime-core" {
     }
 }
 
-export { ClientComposableReturnType, DefineComponentSliceComponentProps, PrismicClientComposableState, PrismicEmbed, PrismicEmbedProps, PrismicImage, PrismicImageProps, PrismicLink, PrismicLinkProps, PrismicPlugin, PrismicPluginOptions, PrismicRichText, PrismicRichTextProps, PrismicText, PrismicTextProps, SliceComponentProps, SliceComponentType, SliceLike, SliceZone, SliceZoneComponents, SliceZoneLike, SliceZoneProps, SliceZoneResolver, TODOSliceComponent, UsePrismicImageOptions, UsePrismicLinkOptions, UsePrismicRichTextOptions, UsePrismicTextOptions, createPrismic, dangerouslyUseAllPrismicDocuments, defineSliceZoneComponents, getSliceComponentProps, prismicKey, useAllPrismicDocumentsByEveryTag, useAllPrismicDocumentsByIDs, useAllPrismicDocumentsBySomeTags, useAllPrismicDocumentsByTag, useAllPrismicDocumentsByType, useAllPrismicDocumentsByUIDs, useFirstPrismicDocument, usePrismic, usePrismicDocumentByID, usePrismicDocumentByUID, usePrismicDocuments, usePrismicDocumentsByEveryTag, usePrismicDocumentsByIDs, usePrismicDocumentsBySomeTags, usePrismicDocumentsByTag, usePrismicDocumentsByType, usePrismicDocumentsByUIDs, usePrismicImage, usePrismicLink, usePrismicRichText, usePrismicText, useSinglePrismicDocument };
+export { ClientComposableReturnType, DefineComponentSliceComponentProps, PrismicClientComposableState, PrismicEmbed, PrismicEmbedProps, PrismicImage, PrismicImageProps, PrismicLink, PrismicLinkProps, PrismicPlugin, PrismicPluginOptions, PrismicRichText, PrismicRichTextProps, PrismicText, PrismicTextProps, SliceComponentProps, SliceComponentType, SliceLike, SliceLikeGraphQL, SliceLikeRestV2, SliceZone, SliceZoneComponents, SliceZoneLike, SliceZoneProps, SliceZoneResolver, TODOSliceComponent, UsePrismicImageOptions, UsePrismicLinkOptions, UsePrismicRichTextOptions, UsePrismicTextOptions, createPrismic, dangerouslyUseAllPrismicDocuments, defineSliceZoneComponents, getSliceComponentProps, prismicKey, useAllPrismicDocumentsByEveryTag, useAllPrismicDocumentsByIDs, useAllPrismicDocumentsBySomeTags, useAllPrismicDocumentsByTag, useAllPrismicDocumentsByType, useAllPrismicDocumentsByUIDs, useFirstPrismicDocument, usePrismic, usePrismicDocumentByID, usePrismicDocumentByUID, usePrismicDocuments, usePrismicDocumentsByEveryTag, usePrismicDocumentsByIDs, usePrismicDocumentsBySomeTags, usePrismicDocumentsByTag, usePrismicDocumentsByType, usePrismicDocumentsByUIDs, usePrismicImage, usePrismicLink, usePrismicRichText, usePrismicText, useSinglePrismicDocument };

package/dist/index.js

@@ -37,6 +37,11 @@ const PrismicEmbedImpl = /* @__PURE__ */ defineComponent({
 });
 const PrismicEmbed = PrismicEmbedImpl;
 
+if (typeof process === "undefined") {
+  globalThis.process = { env: {} };
+}
+const __PRODUCTION__ = process.env.NODE_ENV === "production";
+
 const prismicKey = Symbol("prismic");
 
 const usePrismic = () => {
@@ -59,18 +64,13 @@ const usePrismicImage = (props) => {
     const widths = unref(props.widths);
     const pixelDensities = unref(props.pixelDensities);
     if (widths) {
-      if (pixelDensities) {
-        console.warn("[PrismicImage] `widths` and `pixelDensities` props should not be use alongside each others, only `widths` will be applied", props);
-      }
-      if (widths === "auto") {
-        return asImageWidthSrcSet(field, imgixParams);
-      } else {
-        const { url, dimensions, alt: alt2, copyright: copyright2 } = field;
-        return asImageWidthSrcSet({ url, dimensions, alt: alt2, copyright: copyright2 }, {
-          ...imgixParams,
-          widths: widths === "defaults" ? (_a = options.components) == null ? void 0 : _a.imageWidthSrcSetDefaults : widths
-        });
+      if (!__PRODUCTION__ && 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.", props);
       }
+      return asImageWidthSrcSet(field, {
+        ...imgixParams,
+        widths: widths === "defaults" ? (_a = options.components) == null ? void 0 : _a.imageWidthSrcSetDefaults : widths
+      });
     } else if (pixelDensities) {
       return asImagePixelDensitySrcSet(field, {
         ...imgixParams,
@@ -290,7 +290,12 @@ const PrismicLink = PrismicLinkImpl;
 const defaultWrapper$1 = "div";
 const usePrismicText = (props) => {
   const text = computed(() => {
-    return asText(unref(props.field), unref(props.separator));
+    var _a;
+    const field = unref(props.field);
+    if (!isFilled.richText(field)) {
+      return (_a = unref(props.fallback)) != null ? _a : "";
+    }
+    return asText(unref(field), unref(props.separator));
   });
   return {
     text
@@ -301,7 +306,8 @@ const PrismicTextImpl = /* @__PURE__ */ defineComponent({
   props: {
     field: {
       type: Array,
-      required: true
+      default: void 0,
+      required: false
     },
     separator: {
       type: String,
@@ -312,12 +318,14 @@ const PrismicTextImpl = /* @__PURE__ */ defineComponent({
       type: [String, Object, Function],
       default: void 0,
       required: false
+    },
+    fallback: {
+      type: String,
+      default: void 0,
+      required: false
     }
   },
   setup(props) {
-    if (!props.field) {
-      return () => null;
-    }
     const { text } = usePrismicText(props);
     return () => {
       const parent = simplyResolveComponent(props.wrapper || defaultWrapper$1);
@@ -333,10 +341,14 @@ const defaultWrapper = "div";
 const usePrismicRichText = (props) => {
   const { options } = usePrismic();
   const html = computed(() => {
-    var _a, _b;
-    const linkResolver = (_a = unref(props.linkResolver)) != null ? _a : options.linkResolver;
-    const htmlSerializer = (_b = unref(props.htmlSerializer)) != null ? _b : options.htmlSerializer;
-    return asHTML(unref(props.field), linkResolver, htmlSerializer);
+    var _a, _b, _c;
+    const field = unref(props.field);
+    if (!isFilled.richText(field)) {
+      return (_a = unref(props.fallback)) != null ? _a : "";
+    }
+    const linkResolver = (_b = unref(props.linkResolver)) != null ? _b : options.linkResolver;
+    const htmlSerializer = (_c = unref(props.htmlSerializer)) != null ? _c : options.htmlSerializer;
+    return asHTML(unref(field), linkResolver, htmlSerializer);
   });
   return {
     html
@@ -347,7 +359,8 @@ const PrismicRichTextImpl = /* @__PURE__ */ defineComponent({
   props: {
     field: {
       type: Array,
-      required: true
+      default: void 0,
+      required: false
     },
     linkResolver: {
       type: Function,
@@ -363,16 +376,18 @@ const PrismicRichTextImpl = /* @__PURE__ */ defineComponent({
       type: [String, Object, Function],
       default: void 0,
       required: false
+    },
+    fallback: {
+      type: String,
+      default: void 0,
+      required: false
     }
   },
   setup(props) {
-    if (!props.field) {
-      return () => null;
-    }
     const { html } = usePrismicRichText(props);
     const root = ref(null);
     const maybeRouter = inject(routerKey, null);
-    if (maybeRouter) {
+    if (maybeRouter && html.value) {
       let links = [];
       const navigate = function(event) {
         event.preventDefault();
@@ -415,11 +430,6 @@ const PrismicRichTextImpl = /* @__PURE__ */ defineComponent({
 });
 const PrismicRichText = PrismicRichTextImpl;
 
-if (typeof process === "undefined") {
-  globalThis.process = { env: {} };
-}
-const __PRODUCTION__ = process.env.NODE_ENV === "production";
-
 const getSliceComponentProps = (propsHint) => ({
   slice: {
     type: Object,
@@ -442,16 +452,15 @@ const TODOSliceComponent = __PRODUCTION__ ? () => null : /* @__PURE__ */ defineC
   name: "TODOSliceComponent",
   props: getSliceComponentProps(),
   setup(props) {
+    const type = computed(() => "slice_type" in props.slice ? props.slice.slice_type : props.slice.type);
     watchEffect(() => {
-      console.warn(`[SliceZone] Could not find a component for Slice type "${props.slice.slice_type}"`, props.slice);
+      console.warn(`[SliceZone] Could not find a component for Slice type "${type.value}"`, props.slice);
     });
     return () => {
       return h("section", {
         "data-slice-zone-todo-component": "",
-        "data-slice-type": props.slice.slice_type
-      }, [
-        `Could not find a component for Slice type "${props.slice.slice_type}"`
-      ]);
+        "data-slice-type": type.value
+      }, [`Could not find a component for Slice type "${type.value}"`]);
     };
   }
 });
@@ -505,11 +514,12 @@ const SliceZoneImpl = /* @__PURE__ */ defineComponent({
     const renderedSlices = computed(() => {
       return props.slices.map((slice, index) => {
         var _a;
-        let component = props.components && slice.slice_type in props.components ? props.components[slice.slice_type] : props.defaultComponent || ((_a = options.components) == null ? void 0 : _a.sliceZoneDefaultComponent) || TODOSliceComponent;
+        const type = "slice_type" in slice ? slice.slice_type : slice.type;
+        let component = props.components && type in props.components ? props.components[type] : props.defaultComponent || ((_a = options.components) == null ? void 0 : _a.sliceZoneDefaultComponent) || TODOSliceComponent;
         if (props.resolver) {
           const resolvedComponent = props.resolver({
             slice,
-            sliceName: slice.slice_type,
+            sliceName: type,
             i: index
           });
           if (resolvedComponent) {
@@ -517,7 +527,7 @@ const SliceZoneImpl = /* @__PURE__ */ defineComponent({
           }
         }
         const p = {
-          key: `${slice.slice_type}-${index}`,
+          key: `${index}-${JSON.stringify(slice)}`,
           slice,
           index,
           context: props.context,
@@ -599,13 +609,13 @@ const createPrismic = (options) => {
   return prismic;
 };
 
-var PrismicClientComposableState;
-(function(PrismicClientComposableState2) {
+var PrismicClientComposableState = /* @__PURE__ */ ((PrismicClientComposableState2) => {
   PrismicClientComposableState2["Idle"] = "idle";
   PrismicClientComposableState2["Pending"] = "pending";
   PrismicClientComposableState2["Success"] = "success";
   PrismicClientComposableState2["Error"] = "error";
-})(PrismicClientComposableState || (PrismicClientComposableState = {}));
+  return PrismicClientComposableState2;
+})(PrismicClientComposableState || {});
 
 const isParams = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);