@prismicio/vue 4.3.1 → 5.0.0-alpha.1

package/src/composables.ts

@@ -1,492 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unused-vars */
-// Imports for @link references:
-import type { Client } from "@prismicio/client"
-
-/* eslint-enable @typescript-eslint/no-unused-vars */
-import type { PrismicDocument, Query } from "@prismicio/client"
-
-import type {
-	ClientComposableReturnType,
-	ClientMethodParameters,
-	ComposableOnlyParameters,
-} from "./useStatefulPrismicClientMethod"
-import { useStatefulPrismicClientMethod } from "./useStatefulPrismicClientMethod"
-
-// Composables
-
-/**
- * A composable that queries content from the Prismic repository.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.get}
- */
-export const usePrismicDocuments = <TDocument extends PrismicDocument>(
-	...args: [
-		params?: ClientMethodParameters<"get">[0] & ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<Query<TDocument>> =>
-	useStatefulPrismicClientMethod("get", args)
-
-/**
- * A composable that queries content from the Prismic repository and returns
- * only the first result, if any.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of the Prismic document returned
- *
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getFirst}
- */
-export const useFirstPrismicDocument = <TDocument extends PrismicDocument>(
-	...args: [
-		params?: ClientMethodParameters<"getFirst">[0] & ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument> =>
-	useStatefulPrismicClientMethod("getFirst", args)
-
-/**
- * A composable that queries a document from the Prismic repository with a
- * specific ID.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of the Prismic document returned
- *
- * @param id - ID of the document
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getByID}
- */
-export const usePrismicDocumentByID = <TDocument extends PrismicDocument>(
-	...args: [
-		id: ClientMethodParameters<"getByID">[0],
-		params?: ClientMethodParameters<"getByID">[1] & ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument> =>
-	useStatefulPrismicClientMethod("getByID", args)
-
-/**
- * A composable that queries documents from the Prismic repository with specific
- * IDs.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param ids - A list of document IDs
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getByIDs}
- */
-export const usePrismicDocumentsByIDs = <TDocument extends PrismicDocument>(
-	...args: [
-		ids: ClientMethodParameters<"getByIDs">[0],
-		params?: ClientMethodParameters<"getByIDs">[1] & ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<Query<TDocument>> =>
-	useStatefulPrismicClientMethod("getByIDs", args)
-
-/**
- * A composable that queries all documents from the Prismic repository with
- * specific IDs.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param ids - A list of document IDs
- * @param params - Parameters to filter and sort results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getAllByIDs}
- */
-export const useAllPrismicDocumentsByIDs = <TDocument extends PrismicDocument>(
-	...args: [
-		ids: ClientMethodParameters<"getAllByIDs">[0],
-		params?: ClientMethodParameters<"getAllByIDs">[1] &
-			ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument[]> =>
-	useStatefulPrismicClientMethod("getAllByIDs", args)
-
-/**
- * A composable that queries a document from the Prismic repository with a
- * specific UID and Custom Type.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of the Prismic document returned
- *
- * @param documentType - The API ID of the document's Custom Type
- * @param uid - UID of the document
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getByUID}
- */
-export const usePrismicDocumentByUID = <TDocument extends PrismicDocument>(
-	...args: [
-		documentType: ClientMethodParameters<"getByUID">[0],
-		uid: ClientMethodParameters<"getByUID">[1],
-		params?: ClientMethodParameters<"getByUID">[2] & ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument> =>
-	useStatefulPrismicClientMethod("getByUID", args)
-
-/**
- * A composable that queries documents from the Prismic repository with specific
- * UIDs.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param documentType - The API ID of the document's Custom Type
- * @param uids - A list of document UIDs
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getByIDs}
- */
-export const usePrismicDocumentsByUIDs = <TDocument extends PrismicDocument>(
-	...args: [
-		documentType: ClientMethodParameters<"getByUIDs">[0],
-		uids: ClientMethodParameters<"getByUIDs">[1],
-		params?: ClientMethodParameters<"getByUIDs">[2] & ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<Query<TDocument>> =>
-	useStatefulPrismicClientMethod("getByUIDs", args)
-
-/**
- * A composable that queries all documents from the Prismic repository with
- * specific UIDs.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param documentType - The API ID of the document's Custom Type
- * @param uids - A list of document UIDs
- * @param params - Parameters to filter and sort results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getAllByIDs}
- */
-export const useAllPrismicDocumentsByUIDs = <TDocument extends PrismicDocument>(
-	...args: [
-		documentType: ClientMethodParameters<"getAllByUIDs">[0],
-		ids: ClientMethodParameters<"getAllByUIDs">[1],
-		params?: ClientMethodParameters<"getAllByUIDs">[2] &
-			ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument[]> =>
-	useStatefulPrismicClientMethod("getAllByUIDs", args)
-
-/**
- * A composable that queries a singleton document from the Prismic repository
- * for a specific Custom Type.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of the Prismic document returned
- *
- * @param documentType - The API ID of the singleton Custom Type
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getSingle}
- */
-export const useSinglePrismicDocument = <TDocument extends PrismicDocument>(
-	...args: [
-		documentType: ClientMethodParameters<"getSingle">[0],
-		params?: ClientMethodParameters<"getSingle">[1] & ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument> =>
-	useStatefulPrismicClientMethod("getSingle", args)
-
-/**
- * A composable that queries documents from the Prismic repository for a
- * specific Custom Type.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param documentType - The API ID of the Custom Type
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getByType}
- */
-export const usePrismicDocumentsByType = <TDocument extends PrismicDocument>(
-	...args: [
-		documentType: ClientMethodParameters<"getByType">[0],
-		params?: ClientMethodParameters<"getByType">[1] & ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<Query<TDocument>> =>
-	useStatefulPrismicClientMethod("getByType", args)
-
-/**
- * A composable that queries all documents from the Prismic repository for a
- * specific Custom Type.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param documentType - The API ID of the Custom Type
- * @param params - Parameters to filter and sort results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getAllByType}
- */
-export const useAllPrismicDocumentsByType = <TDocument extends PrismicDocument>(
-	...args: [
-		documentType: ClientMethodParameters<"getAllByType">[0],
-		params?: ClientMethodParameters<"getAllByType">[1] &
-			ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument[]> =>
-	useStatefulPrismicClientMethod("getAllByType", args)
-
-/**
- * A composable that queries documents from the Prismic repository with a
- * specific tag.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param tag - The tag that must be included on a document
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getByTag}
- */
-export const usePrismicDocumentsByTag = <TDocument extends PrismicDocument>(
-	...args: [
-		tag: ClientMethodParameters<"getByTag">[0],
-		params?: ClientMethodParameters<"getByTag">[1] & ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<Query<TDocument>> =>
-	useStatefulPrismicClientMethod("getByTag", args)
-
-/**
- * A composable that queries all documents from the Prismic repository with a
- * specific tag.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param tag - The tag that must be included on a document
- * @param params - Parameters to filter and sort results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getAllByTag}
- */
-export const useAllPrismicDocumentsByTag = <TDocument extends PrismicDocument>(
-	...args: [
-		tag: ClientMethodParameters<"getAllByTag">[0],
-		params?: ClientMethodParameters<"getAllByTag">[1] &
-			ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument[]> =>
-	useStatefulPrismicClientMethod("getAllByTag", args)
-
-/**
- * A composable that queries documents from the Prismic repository with specific
- * tags. A document must be tagged with all of the queried tags to be included.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param tags - A list of tags that must be included on a document
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getByTags}
- */
-export const usePrismicDocumentsByEveryTag = <
-	TDocument extends PrismicDocument,
->(
-	...args: [
-		tags: ClientMethodParameters<"getByEveryTag">[0],
-		params?: ClientMethodParameters<"getByEveryTag">[1] &
-			ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<Query<TDocument>> =>
-	useStatefulPrismicClientMethod("getByEveryTag", args)
-
-/**
- * A composable that queries all documents from the Prismic repository with
- * specific tags. A document must be tagged with all of the queried tags to be
- * included.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param tags - A list of tags that must be included on a document
- * @param params - Parameters to filter and sort results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getAllByTags}
- */
-export const useAllPrismicDocumentsByEveryTag = <
-	TDocument extends PrismicDocument,
->(
-	...args: [
-		tags: ClientMethodParameters<"getAllByEveryTag">[0],
-		params?: ClientMethodParameters<"getAllByEveryTag">[1] &
-			ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument[]> =>
-	useStatefulPrismicClientMethod("getAllByEveryTag", args)
-
-/**
- * A composable that queries documents from the Prismic repository with specific
- * tags. A document must be tagged with at least one of the queried tags to be
- * included.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param tags - A list of tags that must be included on a document
- * @param params - Parameters to filter, sort, and paginate results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getByTags}
- */
-export const usePrismicDocumentsBySomeTags = <
-	TDocument extends PrismicDocument,
->(
-	...args: [
-		tags: ClientMethodParameters<"getBySomeTags">[0],
-		params?: ClientMethodParameters<"getBySomeTags">[1] &
-			ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<Query<TDocument>> =>
-	useStatefulPrismicClientMethod("getBySomeTags", args)
-
-/**
- * A composable that queries all documents from the Prismic repository with
- * specific tags. A document must be tagged with at least one of the queried
- * tags to be included.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param tags - A list of tags that must be included on a document
- * @param params - Parameters to filter and sort results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getAllByTags}
- */
-export const useAllPrismicDocumentsBySomeTags = <
-	TDocument extends PrismicDocument,
->(
-	...args: [
-		tags: ClientMethodParameters<"getAllBySomeTags">[0],
-		params?: ClientMethodParameters<"getAllBySomeTags">[1] &
-			ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument[]> =>
-	useStatefulPrismicClientMethod("getAllBySomeTags", args)
-
-/**
- * **IMPORTANT**: Avoid using `dangerouslyUseAllPrismicDocuments` as it may be
- * slower and require more resources than other composables. Prefer using other
- * composables that filter by predicates such as
- * `useAllPrismicDocumentsByType`.
- *
- * A composable that queries content from the Prismic repository and returns all
- * matching content. If no predicates are provided, all documents will be
- * fetched.
- *
- * @remarks
- * An additional `@prismicio/client` instance can be provided at
- * `params.client`.
- *
- * @typeParam TDocument - Type of Prismic documents returned
- *
- * @param params - Parameters to filter and sort results
- *
- * @returns The composable payload {@link ClientComposableReturnType}
- *
- * @see Underlying `@prismicio/client` method {@link Client.getAll}
- */
-export const dangerouslyUseAllPrismicDocuments = <
-	TDocument extends PrismicDocument,
->(
-	...args: [
-		params?: ClientMethodParameters<"dangerouslyGetAll">[0] &
-			ComposableOnlyParameters,
-	]
-): ClientComposableReturnType<TDocument[]> =>
-	useStatefulPrismicClientMethod("dangerouslyGetAll", args)

package/src/globalExtensions.ts

@@ -1,12 +0,0 @@
-import type { PrismicPlugin } from "./types"
-
-declare module "vue" {
-	export interface ComponentCustomProperties {
-		/**
-		 * `@prismicio/vue` plugin interface exposed on `this`.
-		 *
-		 * @see `@prismicio/vue` plugin interface {@link PrismicPlugin}
-		 */
-		$prismic: PrismicPlugin
-	}
-}

package/src/injectionSymbols.ts

@@ -1,17 +0,0 @@
-import type { InjectionKey } from "vue"
-
-import type { PrismicPlugin } from "./types"
-
-/* eslint-disable @typescript-eslint/no-unused-vars */
-// Imports for @link references:
-import type { usePrismic } from "./usePrismic"
-
-/* eslint-enable @typescript-eslint/no-unused-vars */
-
-/**
- * `@prismicio/vue` plugin interface interface location used for
- * {@link usePrismic}.
- *
- * @internal
- */
-export const prismicKey = Symbol("prismic") as InjectionKey<PrismicPlugin>

package/src/lib/__PRODUCTION__.ts

@@ -1,12 +0,0 @@
-// We need to polyfill process if it doesn't exist, such as in the browser.
-if (typeof process === "undefined") {
-	globalThis.process = { env: {} } as typeof process
-}
-
-/**
- * `true` if in the production environment, `false` otherwise.
- *
- * This boolean can be used to perform actions only in development environments,
- * such as logging.
- */
-export const __PRODUCTION__ = process.env.NODE_ENV === "production"

package/src/lib/getSlots.ts

@@ -1,43 +0,0 @@
-import {
-	type ConcreteComponent,
-	type Slot,
-	type Slots,
-	Text,
-	type VNode,
-	h,
-} from "vue"
-
-/**
- * Get the appropriate `slots` object/array according to the provided parent,
- * fixing `Non-function value encountered for default slot.` warnings.
- *
- * @param parent - The parent inheriting slots
- * @param slots - The `slots` to transform for parent
- * @param defaultParams - The parameters to provide to the default slot
- *
- * @returns The appropriate slots object/array
- *
- * @internal
- */
-export const getSlots = (
-	parent: string | ConcreteComponent,
-	slots: Slots,
-	defaultPayload?: unknown,
-	fallback?: string,
-): VNode[] | Slots | Slot | undefined => {
-	const fallbackSlot = fallback ? () => [h(Text, fallback)] : undefined
-	if (typeof parent === "string") {
-		return slots.default ? slots.default(defaultPayload) : fallbackSlot?.()
-	} else {
-		if (slots.default) {
-			const content = slots.default(defaultPayload)
-
-			return {
-				...slots,
-				default: content.length ? () => content : fallbackSlot,
-			}
-		} else {
-			return fallbackSlot
-		}
-	}
-}

package/src/lib/simplyResolveComponent.ts

@@ -1,18 +0,0 @@
-import type { ConcreteComponent, DefineComponent, Raw, VNode } from "vue"
-import { resolveDynamicComponent } from "vue"
-
-/**
- * A stricter version of {@link resolveDynamicComponent} that resolves only type
- * {@link VNode} for existing components or provided `string`.
- *
- * @param component - An HTML tag name, a component, or a functional component
- *
- * @returns Resolved component as a {@link VNode} or provided `string`.
- *
- * @internal
- */
-export const simplyResolveComponent = (
-	component: string | ConcreteComponent | Raw<DefineComponent>,
-): string | VNode => {
-	return resolveDynamicComponent(component) as string | VNode
-}