@prismicio/vue 3.1.0 → 3.1.2

package/dist/components/PrismicRichText.d.ts

@@ -0,0 +1,139 @@
+import { AllowedComponentProps, ComponentCustomProps, ComputedRef, ConcreteComponent, PropType, VNodeProps } from "vue";
+import { HTMLFunctionSerializer, HTMLMapSerializer, LinkResolverFunction } from "@prismicio/helpers";
+import { RichTextField } from "@prismicio/types";
+import { VueUseOptions } from "../types";
+/**
+ * Props for `<PrismicRichText />`.
+ */
+export type PrismicRichTextProps = {
+    /**
+     * The Prismic rich text or title field to render.
+     */
+    field: RichTextField | null | undefined;
+    /**
+     * A link resolver function used to resolve link when not using the route
+     * resolver parameter with `@prismicio/client`.
+     *
+     * @defaultValue The link resolver provided to `@prismicio/vue` plugin if configured.
+     *
+     * @see Link resolver documentation {@link https://prismic.io/docs/core-concepts/link-resolver-route-resolver#link-resolver}
+     */
+    linkResolver?: LinkResolverFunction;
+    /**
+     * An HTML serializer to customize the way rich text fields are rendered.
+     *
+     * @defaultValue The HTML serializer provided to `@prismicio/vue` plugin if configured.
+     *
+     * @see HTML serializer documentation {@link https://prismic.io/docs/core-concepts/html-serializer}
+     */
+    htmlSerializer?: HTMLFunctionSerializer | HTMLMapSerializer;
+    /**
+     * An HTML tag name, a component, or a functional component used to wrap the
+     * output.
+     *
+     * @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}.
+ */
+export type UsePrismicRichTextOptions = VueUseOptions<Omit<PrismicRichTextProps, "wrapper">>;
+/**
+ * Return type of {@link usePrismicRichText}.
+ */
+export type UsePrismicRichTextReturnType = {
+    /**
+     * Serialized rich text field as HTML.
+     */
+    html: ComputedRef<string>;
+};
+/**
+ * A low level composable that returns a serialized rich text field as HTML.
+ *
+ * @param props - {@link UsePrismicRichTextOptions}
+ *
+ * @returns - Serialized rich text field as HTML
+ *   {@link UsePrismicRichTextReturnType}
+ */
+export declare const usePrismicRichText: (props: UsePrismicRichTextOptions) => UsePrismicRichTextReturnType;
+/**
+ * `<PrismicRichText />` implementation.
+ *
+ * @internal
+ */
+export declare const PrismicRichTextImpl: import("vue").DefineComponent<{
+    field: {
+        type: PropType<[] | [import("@prismicio/types").RTNode, ...import("@prismicio/types").RTNode[]] | null | undefined>;
+        default: undefined;
+        required: false;
+    };
+    linkResolver: {
+        type: PropType<LinkResolverFunction<string>>;
+        default: undefined;
+        required: false;
+    };
+    htmlSerializer: {
+        type: PropType<HTMLFunctionSerializer | HTMLMapSerializer>;
+        default: undefined;
+        required: false;
+    };
+    wrapper: {
+        type: PropType<string | ConcreteComponent<{}, any, any, import("vue").ComputedOptions, import("vue").MethodOptions>>;
+        default: undefined;
+        required: false;
+    };
+    fallback: {
+        type: PropType<string>;
+        default: undefined;
+        required: false;
+    };
+}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, VNodeProps & AllowedComponentProps & ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    field: {
+        type: PropType<[] | [import("@prismicio/types").RTNode, ...import("@prismicio/types").RTNode[]] | null | undefined>;
+        default: undefined;
+        required: false;
+    };
+    linkResolver: {
+        type: PropType<LinkResolverFunction<string>>;
+        default: undefined;
+        required: false;
+    };
+    htmlSerializer: {
+        type: PropType<HTMLFunctionSerializer | HTMLMapSerializer>;
+        default: undefined;
+        required: false;
+    };
+    wrapper: {
+        type: PropType<string | ConcreteComponent<{}, any, any, import("vue").ComputedOptions, import("vue").MethodOptions>>;
+        default: undefined;
+        required: false;
+    };
+    fallback: {
+        type: PropType<string>;
+        default: undefined;
+        required: false;
+    };
+}>>, {
+    wrapper: string | ConcreteComponent<{}, any, any, import("vue").ComputedOptions, import("vue").MethodOptions>;
+    field: [] | [import("@prismicio/types").RTNode, ...import("@prismicio/types").RTNode[]] | null | undefined;
+    linkResolver: LinkResolverFunction<string>;
+    fallback: string;
+    htmlSerializer: HTMLFunctionSerializer | HTMLMapSerializer;
+}>;
+/**
+ * Component to render a Prismic rich text field as HTML.
+ *
+ * @see Component props {@link PrismicRichTextProps}
+ * @see Templating rich text and title fields {@link https://prismic.io/docs/technologies/vue-template-content#rich-text-and-titles}
+ */
+export declare const PrismicRichText: new () => {
+    $props: AllowedComponentProps & ComponentCustomProps & VNodeProps & PrismicRichTextProps;
+};

package/dist/components/PrismicRichText.js

@@ -0,0 +1,103 @@
+import { computed, unref, defineComponent, ref, inject, watch, nextTick, onBeforeUnmount, h } from "vue";
+import { routerKey } from "vue-router";
+import { isFilled, asHTML } from "@prismicio/helpers";
+import { usePrismic } from "../usePrismic.js";
+import { simplyResolveComponent } from "../lib/simplyResolveComponent.js";
+import { isInternalURL } from "../lib/isInternalURL.js";
+const defaultWrapper = "div";
+const usePrismicRichText = (props) => {
+  const { options } = usePrismic();
+  const html = computed(() => {
+    const field = unref(props.field);
+    if (!isFilled.richText(field)) {
+      return unref(props.fallback) ?? "";
+    }
+    const linkResolver = unref(props.linkResolver) ?? options.linkResolver;
+    const htmlSerializer = unref(props.htmlSerializer) ?? options.htmlSerializer;
+    return asHTML(unref(field), linkResolver, htmlSerializer);
+  });
+  return {
+    html
+  };
+};
+const PrismicRichTextImpl = /* @__PURE__ */ defineComponent({
+  name: "PrismicRichText",
+  props: {
+    field: {
+      type: Array,
+      default: void 0,
+      required: false
+    },
+    linkResolver: {
+      type: Function,
+      default: void 0,
+      required: false
+    },
+    htmlSerializer: {
+      type: [Function, Object],
+      default: void 0,
+      required: false
+    },
+    wrapper: {
+      type: [String, Object, Function],
+      default: void 0,
+      required: false
+    },
+    fallback: {
+      type: String,
+      default: void 0,
+      required: false
+    }
+  },
+  setup(props) {
+    const { html } = usePrismicRichText(props);
+    const root = ref(null);
+    const maybeRouter = inject(routerKey, null);
+    if (maybeRouter) {
+      let links = [];
+      const navigate = function(event) {
+        event.preventDefault();
+        maybeRouter.push(this.href);
+      };
+      const addListeners = () => {
+        const node = root.value && "$el" in root.value ? root.value.$el : root.value;
+        if (node && "querySelectorAll" in node) {
+          links = Array.from(node.querySelectorAll("a")).map((element) => {
+            const href = element.getAttribute("href");
+            if (href && isInternalURL(href)) {
+              const listener = navigate.bind({ href });
+              element.addEventListener("click", listener);
+              return { element, listener };
+            } else {
+              return false;
+            }
+          }).filter((link) => link);
+        }
+      };
+      const removeListeners = () => {
+        links.forEach(({ element, listener }) => element.removeEventListener("click", listener));
+        links = [];
+      };
+      watch(html, () => {
+        removeListeners();
+        nextTick(addListeners);
+      }, { immediate: true });
+      onBeforeUnmount(() => {
+        removeListeners();
+      });
+    }
+    return () => {
+      return h(simplyResolveComponent(props.wrapper || defaultWrapper), {
+        innerHTML: html.value,
+        ref: root
+      });
+    };
+  }
+});
+const PrismicRichText = PrismicRichTextImpl;
+export {
+  PrismicRichText,
+  PrismicRichTextImpl,
+  usePrismicRichText
+};
+//# sourceMappingURL=PrismicRichText.js.map

package/dist/components/PrismicRichText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrismicRichText.js","sources":["../../../src/components/PrismicRichText.ts"],"sourcesContent":["import {\n\tAllowedComponentProps,\n\tComponent,\n\tComponentCustomProps,\n\tcomputed,\n\tComputedRef,\n\tConcreteComponent,\n\tdefineComponent,\n\th,\n\tinject,\n\tnextTick,\n\tonBeforeUnmount,\n\tPropType,\n\tref,\n\tunref,\n\tVNodeProps,\n\twatch,\n} from \"vue\";\nimport { routerKey } from \"vue-router\";\n\nimport {\n\tasHTML,\n\tHTMLFunctionSerializer,\n\tHTMLMapSerializer,\n\tisFilled,\n\tLinkResolverFunction,\n} from \"@prismicio/helpers\";\nimport { RichTextField } from \"@prismicio/types\";\n\nimport { VueUseOptions } from \"../types\";\nimport { usePrismic } from \"../usePrismic\";\nimport { simplyResolveComponent } from \"../lib/simplyResolveComponent\";\nimport { isInternalURL } from \"../lib/isInternalURL\";\n\n/**\n * The default component rendered to wrap the HTML output.\n */\nconst defaultWrapper = \"div\";\n\n/**\n * Props for `<PrismicRichText />`.\n */\nexport type PrismicRichTextProps = {\n\t/**\n\t * The Prismic rich text or title field to render.\n\t */\n\tfield: RichTextField | null | undefined;\n\n\t/**\n\t * A link resolver function used to resolve link when not using the route\n\t * resolver parameter with `@prismicio/client`.\n\t *\n\t * @defaultValue The link resolver provided to `@prismicio/vue` plugin if configured.\n\t *\n\t * @see Link resolver documentation {@link https://prismic.io/docs/core-concepts/link-resolver-route-resolver#link-resolver}\n\t */\n\tlinkResolver?: LinkResolverFunction;\n\n\t/**\n\t * An HTML serializer to customize the way rich text fields are rendered.\n\t *\n\t * @defaultValue The HTML serializer provided to `@prismicio/vue` plugin if configured.\n\t *\n\t * @see HTML serializer documentation {@link https://prismic.io/docs/core-concepts/html-serializer}\n\t */\n\thtmlSerializer?: HTMLFunctionSerializer | HTMLMapSerializer;\n\n\t/**\n\t * An HTML tag name, a component, or a functional component used to wrap the\n\t * output.\n\t *\n\t * @defaultValue `\"div\"`\n\t */\n\twrapper?: string | ConcreteComponent;\n\n\t/**\n\t * The HTML value to be rendered when the field is empty. If a fallback is not\n\t * given, `\"\"` (nothing) will be rendered.\n\t */\n\tfallback?: string;\n};\n\n/**\n * Options for {@link usePrismicRichText}.\n */\nexport type UsePrismicRichTextOptions = VueUseOptions<\n\tOmit<PrismicRichTextProps, \"wrapper\">\n>;\n\n/**\n * Return type of {@link usePrismicRichText}.\n */\nexport type UsePrismicRichTextReturnType = {\n\t/**\n\t * Serialized rich text field as HTML.\n\t */\n\thtml: ComputedRef<string>;\n};\n\n/**\n * A low level composable that returns a serialized rich text field as HTML.\n *\n * @param props - {@link UsePrismicRichTextOptions}\n *\n * @returns - Serialized rich text field as HTML\n *   {@link UsePrismicRichTextReturnType}\n */\nexport const usePrismicRichText = (\n\tprops: UsePrismicRichTextOptions,\n): UsePrismicRichTextReturnType => {\n\tconst { options } = usePrismic();\n\n\tconst html = computed(() => {\n\t\tconst field = unref(props.field);\n\n\t\tif (!isFilled.richText(field)) {\n\t\t\treturn unref(props.fallback) ?? \"\";\n\t\t}\n\n\t\tconst linkResolver = unref(props.linkResolver) ?? options.linkResolver;\n\t\tconst htmlSerializer =\n\t\t\tunref(props.htmlSerializer) ?? options.htmlSerializer;\n\n\t\treturn asHTML(unref(field), linkResolver, htmlSerializer);\n\t});\n\n\treturn {\n\t\thtml,\n\t};\n};\n\n/**\n * `<PrismicRichText />` implementation.\n *\n * @internal\n */\nexport const PrismicRichTextImpl = /*#__PURE__*/ defineComponent({\n\tname: \"PrismicRichText\",\n\tprops: {\n\t\tfield: {\n\t\t\ttype: Array as unknown as PropType<RichTextField | null | undefined>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\tlinkResolver: {\n\t\t\ttype: Function as PropType<LinkResolverFunction>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\thtmlSerializer: {\n\t\t\ttype: [Function, Object] as PropType<\n\t\t\t\tHTMLFunctionSerializer | HTMLMapSerializer\n\t\t\t>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\twrapper: {\n\t\t\ttype: [String, Object, Function] as PropType<string | ConcreteComponent>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\tfallback: {\n\t\t\ttype: String as PropType<string>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t},\n\tsetup(props) {\n\t\tconst { html } = usePrismicRichText(props);\n\n\t\tconst root = ref<HTMLElement | Comment | Component | null>(null);\n\n\t\tconst maybeRouter = inject(routerKey, null);\n\t\tif (maybeRouter) {\n\t\t\ttype InternalLink = {\n\t\t\t\telement: HTMLAnchorElement;\n\t\t\t\tlistener: EventListener;\n\t\t\t};\n\t\t\tlet links: InternalLink[] = [];\n\n\t\t\tconst navigate: EventListener = function (\n\t\t\t\tthis: { href: string },\n\t\t\t\tevent: Event,\n\t\t\t) {\n\t\t\t\tevent.preventDefault();\n\t\t\t\tmaybeRouter.push(this.href);\n\t\t\t};\n\n\t\t\tconst addListeners = () => {\n\t\t\t\tconst node: HTMLElement | Comment | null =\n\t\t\t\t\troot.value && \"$el\" in root.value ? root.value.$el : root.value;\n\t\t\t\tif (node && \"querySelectorAll\" in node) {\n\t\t\t\t\t// Get all internal link tags and add listeners on them\n\t\t\t\t\tlinks = Array.from(node.querySelectorAll(\"a\"))\n\t\t\t\t\t\t.map((element) => {\n\t\t\t\t\t\t\tconst href = element.getAttribute(\"href\");\n\n\t\t\t\t\t\t\tif (href && isInternalURL(href)) {\n\t\t\t\t\t\t\t\tconst listener = navigate.bind({ href });\n\t\t\t\t\t\t\t\telement.addEventListener(\"click\", listener);\n\n\t\t\t\t\t\t\t\treturn { element, listener };\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t})\n\t\t\t\t\t\t.filter((link): link is InternalLink => link as boolean);\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tconst removeListeners = () => {\n\t\t\t\tlinks.forEach(({ element, listener }) =>\n\t\t\t\t\telement.removeEventListener(\"click\", listener),\n\t\t\t\t);\n\t\t\t\tlinks = [];\n\t\t\t};\n\n\t\t\twatch(\n\t\t\t\thtml,\n\t\t\t\t() => {\n\t\t\t\t\tremoveListeners();\n\t\t\t\t\tnextTick(addListeners);\n\t\t\t\t},\n\t\t\t\t{ immediate: true },\n\t\t\t);\n\n\t\t\tonBeforeUnmount(() => {\n\t\t\t\tremoveListeners();\n\t\t\t});\n\t\t}\n\n\t\treturn () => {\n\t\t\treturn h(simplyResolveComponent(props.wrapper || defaultWrapper), {\n\t\t\t\tinnerHTML: html.value,\n\t\t\t\tref: root,\n\t\t\t});\n\t\t};\n\t},\n});\n\n// export the public type for h/tsx inference\n// also to avoid inline import() in generated d.ts files\n/**\n * Component to render a Prismic rich text field as HTML.\n *\n * @see Component props {@link PrismicRichTextProps}\n * @see Templating rich text and title fields {@link https://prismic.io/docs/technologies/vue-template-content#rich-text-and-titles}\n */\nexport const PrismicRichText = PrismicRichTextImpl as unknown as {\n\tnew (): {\n\t\t$props: AllowedComponentProps &\n\t\t\tComponentCustomProps &\n\t\t\tVNodeProps &\n\t\t\tPrismicRichTextProps;\n\t};\n};\n"],"names":[],"mappings":";;;;;;AAqCA,MAAM,iBAAiB;AAsEV,MAAA,qBAAqB,CACjC,UACiC;AAC3B,QAAA,EAAE,YAAY;AAEd,QAAA,OAAO,SAAS,MAAK;AACpB,UAAA,QAAQ,MAAM,MAAM,KAAK;AAE/B,QAAI,CAAC,SAAS,SAAS,KAAK,GAAG;AACvB,aAAA,MAAM,MAAM,QAAQ,KAAK;AAAA,IAChC;AAED,UAAM,eAAe,MAAM,MAAM,YAAY,KAAK,QAAQ;AAC1D,UAAM,iBACL,MAAM,MAAM,cAAc,KAAK,QAAQ;AAExC,WAAO,OAAO,MAAM,KAAK,GAAG,cAAc,cAAc;AAAA,EAAA,CACxD;AAEM,SAAA;AAAA,IACN;AAAA,EAAA;AAEF;AAOO,MAAM,sBAAoD,gCAAA;AAAA,EAChE,MAAM;AAAA,EACN,OAAO;AAAA,IACN,OAAO;AAAA,MACN,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,cAAc;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,gBAAgB;AAAA,MACf,MAAM,CAAC,UAAU,MAAM;AAAA,MAGvB,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,SAAS;AAAA,MACR,MAAM,CAAC,QAAQ,QAAQ,QAAQ;AAAA,MAC/B,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,UAAU;AAAA,MACT,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,EACD;AAAA,EACD,MAAM,OAAK;AACV,UAAM,EAAE,KAAA,IAAS,mBAAmB,KAAK;AAEnC,UAAA,OAAO,IAA8C,IAAI;AAEzD,UAAA,cAAc,OAAO,WAAW,IAAI;AAC1C,QAAI,aAAa;AAKhB,UAAI,QAAwB,CAAA;AAEtB,YAAA,WAA0B,SAE/B,OAAY;AAEZ,cAAM,eAAc;AACR,oBAAA,KAAK,KAAK,IAAI;AAAA,MAAA;AAG3B,YAAM,eAAe,MAAK;AACnB,cAAA,OACL,KAAK,SAAS,SAAS,KAAK,QAAQ,KAAK,MAAM,MAAM,KAAK;AACvD,YAAA,QAAQ,sBAAsB,MAAM;AAE/B,kBAAA,MAAM,KAAK,KAAK,iBAAiB,GAAG,CAAC,EAC3C,IAAI,CAAC,YAAW;AACV,kBAAA,OAAO,QAAQ,aAAa,MAAM;AAEpC,gBAAA,QAAQ,cAAc,IAAI,GAAG;AAChC,oBAAM,WAAW,SAAS,KAAK,EAAE,KAAM,CAAA;AAC/B,sBAAA,iBAAiB,SAAS,QAAQ;AAEnC,qBAAA,EAAE,SAAS;mBACZ;AACC,qBAAA;AAAA,YACP;AAAA,UACD,CAAA,EACA,OAAO,CAAC,SAA+B,IAAe;AAAA,QACxD;AAAA,MAAA;AAGF,YAAM,kBAAkB,MAAK;AACtB,cAAA,QAAQ,CAAC,EAAE,SAAS,SAAA,MACzB,QAAQ,oBAAoB,SAAS,QAAQ,CAAC;AAE/C,gBAAQ,CAAA;AAAA;AAGT,YACC,MACA,MAAK;;AAEJ,iBAAS,YAAY;AAAA,MAAA,GAEtB,EAAE,WAAW,KAAA,CAAM;AAGpB,sBAAgB,MAAK;;OAEpB;AAAA,IACD;AAED,WAAO,MAAK;AACX,aAAO,EAAE,uBAAuB,MAAM,WAAW,cAAc,GAAG;AAAA,QACjE,WAAW,KAAK;AAAA,QAChB,KAAK;AAAA,MAAA,CACL;AAAA,IAAA;AAAA,EAEH;AACA,CAAA;AAUM,MAAM,kBAAkB;"}

package/dist/components/PrismicText.cjs

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const vue = require("vue");
+const helpers = require("@prismicio/helpers");
+const simplyResolveComponent = require("../lib/simplyResolveComponent.cjs");
+const defaultWrapper = "div";
+const usePrismicText = (props) => {
+  const text = vue.computed(() => {
+    const field = vue.unref(props.field);
+    if (!helpers.isFilled.richText(field)) {
+      return vue.unref(props.fallback) ?? "";
+    }
+    return helpers.asText(vue.unref(field), vue.unref(props.separator));
+  });
+  return {
+    text
+  };
+};
+const PrismicTextImpl = /* @__PURE__ */ vue.defineComponent({
+  name: "PrismicText",
+  props: {
+    field: {
+      type: Array,
+      default: void 0,
+      required: false
+    },
+    separator: {
+      type: String,
+      default: void 0,
+      required: false
+    },
+    wrapper: {
+      type: [String, Object, Function],
+      default: void 0,
+      required: false
+    },
+    fallback: {
+      type: String,
+      default: void 0,
+      required: false
+    }
+  },
+  setup(props) {
+    const { text } = usePrismicText(props);
+    return () => {
+      const parent = simplyResolveComponent.simplyResolveComponent(props.wrapper || defaultWrapper);
+      return vue.h(parent, null, {
+        default: () => text.value
+      });
+    };
+  }
+});
+const PrismicText = PrismicTextImpl;
+exports.PrismicText = PrismicText;
+exports.PrismicTextImpl = PrismicTextImpl;
+exports.usePrismicText = usePrismicText;
+//# sourceMappingURL=PrismicText.cjs.map

package/dist/components/PrismicText.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrismicText.cjs","sources":["../../../src/components/PrismicText.ts"],"sourcesContent":["import {\n\tAllowedComponentProps,\n\tComponentCustomProps,\n\tcomputed,\n\tComputedRef,\n\tConcreteComponent,\n\tdefineComponent,\n\th,\n\tPropType,\n\tunref,\n\tVNode,\n\tVNodeProps,\n} from \"vue\";\n\nimport { asText, isFilled } from \"@prismicio/helpers\";\nimport { RichTextField } from \"@prismicio/types\";\n\nimport { VueUseOptions } from \"../types\";\nimport { simplyResolveComponent } from \"../lib/simplyResolveComponent\";\n\n/**\n * The default component rendered to wrap the text output.\n */\nconst defaultWrapper = \"div\";\n/**\n * Props for `<PrismicText />`.\n */\nexport type PrismicTextProps = {\n\t/**\n\t * The Prismic rich text or title field to render.\n\t */\n\tfield: RichTextField | null | undefined;\n\n\t/**\n\t * Separator used to join each element.\n\t *\n\t * @defaultValue `\" \"` (a space)\n\t */\n\tseparator?: string;\n\n\t/**\n\t * An HTML tag name, a component, or a functional component used to wrap the\n\t * output.\n\t *\n\t * @defaultValue `\"div\"`\n\t */\n\twrapper?: string | ConcreteComponent;\n\n\t/**\n\t * The string value to be rendered when the field is empty. If a fallback is\n\t * not given, `\"\"` (nothing) will be rendered.\n\t */\n\tfallback?: string;\n};\n\n/**\n * Options for {@link usePrismicText}.\n */\nexport type UsePrismicTextOptions = VueUseOptions<\n\tOmit<PrismicTextProps, \"wrapper\">\n>;\n\n/**\n * Return type of {@link usePrismicText}.\n */\nexport type UsePrismicTextReturnType = {\n\t/**\n\t * Serialized rich text field as plain text.\n\t */\n\ttext: ComputedRef<string>;\n};\n\n/**\n * A low level composable that returns a serialized rich text field as plain\n * text.\n *\n * @param props - {@link UsePrismicTextOptions}\n *\n * @returns - Serialized rich text field as plain text\n *   {@link UsePrismicTextReturnType}\n */\nexport const usePrismicText = (\n\tprops: UsePrismicTextOptions,\n): UsePrismicTextReturnType => {\n\tconst text = computed(() => {\n\t\tconst field = unref(props.field);\n\n\t\tif (!isFilled.richText(field)) {\n\t\t\treturn unref(props.fallback) ?? \"\";\n\t\t}\n\n\t\treturn asText(unref(field), unref(props.separator));\n\t});\n\n\treturn {\n\t\ttext,\n\t};\n};\n\n/**\n * `<PrismicText />` implementation.\n *\n * @internal\n */\nexport const PrismicTextImpl = /*#__PURE__*/ defineComponent({\n\tname: \"PrismicText\",\n\tprops: {\n\t\tfield: {\n\t\t\ttype: Array as unknown as PropType<RichTextField | null | undefined>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\tseparator: {\n\t\t\ttype: String as PropType<string>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\twrapper: {\n\t\t\ttype: [String, Object, Function] as PropType<string | ConcreteComponent>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\tfallback: {\n\t\t\ttype: String as PropType<string>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t},\n\tsetup(props) {\n\t\tconst { text } = usePrismicText(props);\n\n\t\treturn () => {\n\t\t\tconst parent = simplyResolveComponent(props.wrapper || defaultWrapper);\n\n\t\t\t// This works but is absurd\n\t\t\t// if (typeof parent === \"string\") {\n\t\t\t// \treturn h(parent, null, { default: () => text.value });\n\t\t\t// } else {\n\t\t\t// \treturn h(parent, null, { default: () => text.value });\n\t\t\t// }\n\n\t\t\treturn h(parent as VNode, null, {\n\t\t\t\tdefault: () => text.value,\n\t\t\t});\n\t\t};\n\t},\n});\n\n// export the public type for h/tsx inference\n// also to avoid inline import() in generated d.ts files\n/**\n * Component to render a Prismic rich text field as plain text.\n *\n * @see Component props {@link PrismicTextProps}\n * @see Templating rich text and title fields {@link https://prismic.io/docs/technologies/vue-template-content#rich-text-and-titles}\n */\nexport const PrismicText = PrismicTextImpl as unknown as {\n\tnew (): {\n\t\t$props: AllowedComponentProps &\n\t\t\tComponentCustomProps &\n\t\t\tVNodeProps &\n\t\t\tPrismicTextProps;\n\t};\n};\n"],"names":["computed","unref","isFilled","asText","defineComponent","simplyResolveComponent","h"],"mappings":";;;;;AAuBA,MAAM,iBAAiB;AA0DV,MAAA,iBAAiB,CAC7B,UAC6B;AACvB,QAAA,OAAOA,IAAAA,SAAS,MAAK;AACpB,UAAA,QAAQC,IAAAA,MAAM,MAAM,KAAK;AAE/B,QAAI,CAACC,QAAA,SAAS,SAAS,KAAK,GAAG;AACvB,aAAAD,UAAM,MAAM,QAAQ,KAAK;AAAA,IAChC;AAED,WAAOE,QAAAA,OAAOF,IAAAA,MAAM,KAAK,GAAGA,IAAAA,MAAM,MAAM,SAAS,CAAC;AAAA,EAAA,CAClD;AAEM,SAAA;AAAA,IACN;AAAA,EAAA;AAEF;AAOO,MAAM,kBAAgDG,oBAAAA,gBAAA;AAAA,EAC5D,MAAM;AAAA,EACN,OAAO;AAAA,IACN,OAAO;AAAA,MACN,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,WAAW;AAAA,MACV,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,SAAS;AAAA,MACR,MAAM,CAAC,QAAQ,QAAQ,QAAQ;AAAA,MAC/B,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,UAAU;AAAA,MACT,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,EACD;AAAA,EACD,MAAM,OAAK;AACV,UAAM,EAAE,KAAA,IAAS,eAAe,KAAK;AAErC,WAAO,MAAK;AACX,YAAM,SAASC,uBAAA,uBAAuB,MAAM,WAAW,cAAc;AAS9D,aAAAC,IAAA,EAAE,QAAiB,MAAM;AAAA,QAC/B,SAAS,MAAM,KAAK;AAAA,MAAA,CACpB;AAAA,IAAA;AAAA,EAEH;AACA,CAAA;AAUM,MAAM,cAAc;;;;"}

package/dist/components/PrismicText.d.ts

@@ -0,0 +1,117 @@
+import { AllowedComponentProps, ComponentCustomProps, ComputedRef, ConcreteComponent, PropType, VNode, VNodeProps } from "vue";
+import { RichTextField } from "@prismicio/types";
+import { VueUseOptions } from "../types";
+/**
+ * Props for `<PrismicText />`.
+ */
+export type PrismicTextProps = {
+    /**
+     * The Prismic rich text or title field to render.
+     */
+    field: RichTextField | null | undefined;
+    /**
+     * Separator used to join each element.
+     *
+     * @defaultValue `" "` (a space)
+     */
+    separator?: string;
+    /**
+     * An HTML tag name, a component, or a functional component used to wrap the
+     * output.
+     *
+     * @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}.
+ */
+export type UsePrismicTextOptions = VueUseOptions<Omit<PrismicTextProps, "wrapper">>;
+/**
+ * Return type of {@link usePrismicText}.
+ */
+export type UsePrismicTextReturnType = {
+    /**
+     * Serialized rich text field as plain text.
+     */
+    text: ComputedRef<string>;
+};
+/**
+ * A low level composable that returns a serialized rich text field as plain
+ * text.
+ *
+ * @param props - {@link UsePrismicTextOptions}
+ *
+ * @returns - Serialized rich text field as plain text
+ *   {@link UsePrismicTextReturnType}
+ */
+export declare const usePrismicText: (props: UsePrismicTextOptions) => UsePrismicTextReturnType;
+/**
+ * `<PrismicText />` implementation.
+ *
+ * @internal
+ */
+export declare const PrismicTextImpl: import("vue").DefineComponent<{
+    field: {
+        type: PropType<[] | [import("@prismicio/types").RTNode, ...import("@prismicio/types").RTNode[]] | null | undefined>;
+        default: undefined;
+        required: false;
+    };
+    separator: {
+        type: PropType<string>;
+        default: undefined;
+        required: false;
+    };
+    wrapper: {
+        type: PropType<string | ConcreteComponent<{}, any, any, import("vue").ComputedOptions, import("vue").MethodOptions>>;
+        default: undefined;
+        required: false;
+    };
+    fallback: {
+        type: PropType<string>;
+        default: undefined;
+        required: false;
+    };
+}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, VNodeProps & AllowedComponentProps & ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    field: {
+        type: PropType<[] | [import("@prismicio/types").RTNode, ...import("@prismicio/types").RTNode[]] | null | undefined>;
+        default: undefined;
+        required: false;
+    };
+    separator: {
+        type: PropType<string>;
+        default: undefined;
+        required: false;
+    };
+    wrapper: {
+        type: PropType<string | ConcreteComponent<{}, any, any, import("vue").ComputedOptions, import("vue").MethodOptions>>;
+        default: undefined;
+        required: false;
+    };
+    fallback: {
+        type: PropType<string>;
+        default: undefined;
+        required: false;
+    };
+}>>, {
+    wrapper: string | ConcreteComponent<{}, any, any, import("vue").ComputedOptions, import("vue").MethodOptions>;
+    field: [] | [import("@prismicio/types").RTNode, ...import("@prismicio/types").RTNode[]] | null | undefined;
+    separator: string;
+    fallback: string;
+}>;
+/**
+ * Component to render a Prismic rich text field as plain text.
+ *
+ * @see Component props {@link PrismicTextProps}
+ * @see Templating rich text and title fields {@link https://prismic.io/docs/technologies/vue-template-content#rich-text-and-titles}
+ */
+export declare const PrismicText: new () => {
+    $props: AllowedComponentProps & ComponentCustomProps & VNodeProps & PrismicTextProps;
+};

package/dist/components/PrismicText.js

@@ -0,0 +1,57 @@
+import { computed, unref, defineComponent, h } from "vue";
+import { isFilled, asText } from "@prismicio/helpers";
+import { simplyResolveComponent } from "../lib/simplyResolveComponent.js";
+const defaultWrapper = "div";
+const usePrismicText = (props) => {
+  const text = computed(() => {
+    const field = unref(props.field);
+    if (!isFilled.richText(field)) {
+      return unref(props.fallback) ?? "";
+    }
+    return asText(unref(field), unref(props.separator));
+  });
+  return {
+    text
+  };
+};
+const PrismicTextImpl = /* @__PURE__ */ defineComponent({
+  name: "PrismicText",
+  props: {
+    field: {
+      type: Array,
+      default: void 0,
+      required: false
+    },
+    separator: {
+      type: String,
+      default: void 0,
+      required: false
+    },
+    wrapper: {
+      type: [String, Object, Function],
+      default: void 0,
+      required: false
+    },
+    fallback: {
+      type: String,
+      default: void 0,
+      required: false
+    }
+  },
+  setup(props) {
+    const { text } = usePrismicText(props);
+    return () => {
+      const parent = simplyResolveComponent(props.wrapper || defaultWrapper);
+      return h(parent, null, {
+        default: () => text.value
+      });
+    };
+  }
+});
+const PrismicText = PrismicTextImpl;
+export {
+  PrismicText,
+  PrismicTextImpl,
+  usePrismicText
+};
+//# sourceMappingURL=PrismicText.js.map

package/dist/components/PrismicText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrismicText.js","sources":["../../../src/components/PrismicText.ts"],"sourcesContent":["import {\n\tAllowedComponentProps,\n\tComponentCustomProps,\n\tcomputed,\n\tComputedRef,\n\tConcreteComponent,\n\tdefineComponent,\n\th,\n\tPropType,\n\tunref,\n\tVNode,\n\tVNodeProps,\n} from \"vue\";\n\nimport { asText, isFilled } from \"@prismicio/helpers\";\nimport { RichTextField } from \"@prismicio/types\";\n\nimport { VueUseOptions } from \"../types\";\nimport { simplyResolveComponent } from \"../lib/simplyResolveComponent\";\n\n/**\n * The default component rendered to wrap the text output.\n */\nconst defaultWrapper = \"div\";\n/**\n * Props for `<PrismicText />`.\n */\nexport type PrismicTextProps = {\n\t/**\n\t * The Prismic rich text or title field to render.\n\t */\n\tfield: RichTextField | null | undefined;\n\n\t/**\n\t * Separator used to join each element.\n\t *\n\t * @defaultValue `\" \"` (a space)\n\t */\n\tseparator?: string;\n\n\t/**\n\t * An HTML tag name, a component, or a functional component used to wrap the\n\t * output.\n\t *\n\t * @defaultValue `\"div\"`\n\t */\n\twrapper?: string | ConcreteComponent;\n\n\t/**\n\t * The string value to be rendered when the field is empty. If a fallback is\n\t * not given, `\"\"` (nothing) will be rendered.\n\t */\n\tfallback?: string;\n};\n\n/**\n * Options for {@link usePrismicText}.\n */\nexport type UsePrismicTextOptions = VueUseOptions<\n\tOmit<PrismicTextProps, \"wrapper\">\n>;\n\n/**\n * Return type of {@link usePrismicText}.\n */\nexport type UsePrismicTextReturnType = {\n\t/**\n\t * Serialized rich text field as plain text.\n\t */\n\ttext: ComputedRef<string>;\n};\n\n/**\n * A low level composable that returns a serialized rich text field as plain\n * text.\n *\n * @param props - {@link UsePrismicTextOptions}\n *\n * @returns - Serialized rich text field as plain text\n *   {@link UsePrismicTextReturnType}\n */\nexport const usePrismicText = (\n\tprops: UsePrismicTextOptions,\n): UsePrismicTextReturnType => {\n\tconst text = computed(() => {\n\t\tconst field = unref(props.field);\n\n\t\tif (!isFilled.richText(field)) {\n\t\t\treturn unref(props.fallback) ?? \"\";\n\t\t}\n\n\t\treturn asText(unref(field), unref(props.separator));\n\t});\n\n\treturn {\n\t\ttext,\n\t};\n};\n\n/**\n * `<PrismicText />` implementation.\n *\n * @internal\n */\nexport const PrismicTextImpl = /*#__PURE__*/ defineComponent({\n\tname: \"PrismicText\",\n\tprops: {\n\t\tfield: {\n\t\t\ttype: Array as unknown as PropType<RichTextField | null | undefined>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\tseparator: {\n\t\t\ttype: String as PropType<string>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\twrapper: {\n\t\t\ttype: [String, Object, Function] as PropType<string | ConcreteComponent>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t\tfallback: {\n\t\t\ttype: String as PropType<string>,\n\t\t\tdefault: undefined,\n\t\t\trequired: false,\n\t\t},\n\t},\n\tsetup(props) {\n\t\tconst { text } = usePrismicText(props);\n\n\t\treturn () => {\n\t\t\tconst parent = simplyResolveComponent(props.wrapper || defaultWrapper);\n\n\t\t\t// This works but is absurd\n\t\t\t// if (typeof parent === \"string\") {\n\t\t\t// \treturn h(parent, null, { default: () => text.value });\n\t\t\t// } else {\n\t\t\t// \treturn h(parent, null, { default: () => text.value });\n\t\t\t// }\n\n\t\t\treturn h(parent as VNode, null, {\n\t\t\t\tdefault: () => text.value,\n\t\t\t});\n\t\t};\n\t},\n});\n\n// export the public type for h/tsx inference\n// also to avoid inline import() in generated d.ts files\n/**\n * Component to render a Prismic rich text field as plain text.\n *\n * @see Component props {@link PrismicTextProps}\n * @see Templating rich text and title fields {@link https://prismic.io/docs/technologies/vue-template-content#rich-text-and-titles}\n */\nexport const PrismicText = PrismicTextImpl as unknown as {\n\tnew (): {\n\t\t$props: AllowedComponentProps &\n\t\t\tComponentCustomProps &\n\t\t\tVNodeProps &\n\t\t\tPrismicTextProps;\n\t};\n};\n"],"names":[],"mappings":";;;AAuBA,MAAM,iBAAiB;AA0DV,MAAA,iBAAiB,CAC7B,UAC6B;AACvB,QAAA,OAAO,SAAS,MAAK;AACpB,UAAA,QAAQ,MAAM,MAAM,KAAK;AAE/B,QAAI,CAAC,SAAS,SAAS,KAAK,GAAG;AACvB,aAAA,MAAM,MAAM,QAAQ,KAAK;AAAA,IAChC;AAED,WAAO,OAAO,MAAM,KAAK,GAAG,MAAM,MAAM,SAAS,CAAC;AAAA,EAAA,CAClD;AAEM,SAAA;AAAA,IACN;AAAA,EAAA;AAEF;AAOO,MAAM,kBAAgD,gCAAA;AAAA,EAC5D,MAAM;AAAA,EACN,OAAO;AAAA,IACN,OAAO;AAAA,MACN,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,WAAW;AAAA,MACV,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,SAAS;AAAA,MACR,MAAM,CAAC,QAAQ,QAAQ,QAAQ;AAAA,MAC/B,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,IACD,UAAU;AAAA,MACT,MAAM;AAAA,MACN,SAAS;AAAA,MACT,UAAU;AAAA,IACV;AAAA,EACD;AAAA,EACD,MAAM,OAAK;AACV,UAAM,EAAE,KAAA,IAAS,eAAe,KAAK;AAErC,WAAO,MAAK;AACX,YAAM,SAAS,uBAAuB,MAAM,WAAW,cAAc;AAS9D,aAAA,EAAE,QAAiB,MAAM;AAAA,QAC/B,SAAS,MAAM,KAAK;AAAA,MAAA,CACpB;AAAA,IAAA;AAAA,EAEH;AACA,CAAA;AAUM,MAAM,cAAc;"}

package/dist/components/SliceZone.cjs

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const vue = require("vue");
+const simplyResolveComponent = require("../lib/simplyResolveComponent.cjs");
+const __PRODUCTION__ = require("../lib/__PRODUCTION__.cjs");
+const usePrismic = require("../usePrismic.cjs");
+const getSliceComponentProps = (propsHint) => ({
+  slice: {
+    type: Object,
+    required: true
+  },
+  index: {
+    type: Number,
+    required: true
+  },
+  slices: {
+    type: Array,
+    required: true
+  },
+  context: {
+    type: null,
+    required: true
+  }
+});
+const TODOSliceComponent = __PRODUCTION__.__PRODUCTION__ ? () => null : /* @__PURE__ */ vue.defineComponent({
+  name: "TODOSliceComponent",
+  props: getSliceComponentProps(),
+  setup(props) {
+    const type = vue.computed(() => "slice_type" in props.slice ? props.slice.slice_type : props.slice.type);
+    vue.watchEffect(() => {
+      console.warn(`[SliceZone] Could not find a component for Slice type "${type.value}"`, props.slice);
+    });
+    return () => {
+      return vue.h("section", {
+        "data-slice-zone-todo-component": "",
+        "data-slice-type": type.value
+      }, [`Could not find a component for Slice type "${type.value}"`]);
+    };
+  }
+});
+const defineSliceZoneComponents = (components) => {
+  const result = {};
+  let type;
+  for (type in components) {
+    const component = components[type];
+    result[type] = typeof component === "string" ? component : vue.markRaw(component);
+  }
+  return result;
+};
+const SliceZoneImpl = /* @__PURE__ */ vue.defineComponent({
+  name: "SliceZone",
+  props: {
+    slices: {
+      type: Array,
+      required: true
+    },
+    components: {
+      type: Object,
+      default: void 0,
+      required: false
+    },
+    resolver: {
+      type: Function,
+      default: void 0,
+      required: false
+    },
+    context: {
+      type: null,
+      default: void 0,
+      required: false
+    },
+    defaultComponent: {
+      type: Object,
+      default: void 0,
+      required: false
+    },
+    wrapper: {
+      type: [String, Object, Function],
+      default: void 0,
+      required: false
+    }
+  },
+  setup(props) {
+    if (!props.slices) {
+      return () => null;
+    }
+    const { options } = usePrismic.usePrismic();
+    const renderedSlices = vue.computed(() => {
+      return props.slices.map((slice, index) => {
+        var _a;
+        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: type,
+            i: index
+          });
+          if (resolvedComponent) {
+            component = resolvedComponent;
+          }
+        }
+        const key = "id" in slice && slice.id ? slice.id : `${index}-${JSON.stringify(slice)}`;
+        const p = {
+          key,
+          slice,
+          index,
+          context: props.context,
+          slices: props.slices
+        };
+        return vue.h(simplyResolveComponent.simplyResolveComponent(component), p);
+      });
+    });
+    return () => {
+      if (props.wrapper) {
+        const parent = simplyResolveComponent.simplyResolveComponent(props.wrapper);
+        if (typeof parent === "string") {
+          return vue.h(parent, null, renderedSlices.value);
+        } else {
+          return vue.h(parent, null, { default: () => renderedSlices.value });
+        }
+      } else {
+        return renderedSlices.value;
+      }
+    };
+  }
+});
+const SliceZone = SliceZoneImpl;
+exports.SliceZone = SliceZone;
+exports.SliceZoneImpl = SliceZoneImpl;
+exports.TODOSliceComponent = TODOSliceComponent;
+exports.defineSliceZoneComponents = defineSliceZoneComponents;
+exports.getSliceComponentProps = getSliceComponentProps;
+//# sourceMappingURL=SliceZone.cjs.map