@prismicio/react 3.2.1-alpha.0 → 3.2.2-pr.236.d65a0c3

package/src/SliceZone.tsx

@@ -5,7 +5,7 @@ import { DEV } from "esm-env";
 /**
  * Returns the type of a `SliceLike` type.
  *
- * @typeParam Slice - The Slice from which the type will be extracted.
+ * @typeParam TSlice - The slice from which the type will be extracted.
  */
 type ExtractSliceType<TSlice extends SliceLike> = TSlice extends Slice
 	? TSlice["slice_type"]
@@ -14,10 +14,10 @@ type ExtractSliceType<TSlice extends SliceLike> = TSlice extends Slice
 		: never;
 
 /**
- * The minimum required properties to represent a Prismic Slice from the Prismic
- * Rest API V2 for the `unstable_mapSliceZone()` helper.
+ * The minimum required properties to represent a Prismic slice from the Prismic
+ * Content API for the `mapSliceZone()` helper.
  *
- * @typeParam SliceType - Type name of the Slice.
+ * @typeParam SliceType - Type name of the slice.
  */
 export type SliceLikeRestV2<TSliceType extends string = string> = Pick<
 	Slice<TSliceType>,
@@ -25,30 +25,30 @@ export type SliceLikeRestV2<TSliceType extends string = string> = Pick<
 >;
 
 /**
- * The minimum required properties to represent a Prismic Slice from the Prismic
- * GraphQL API for the `unstable_mapSliceZone()` helper.
+ * The minimum required properties to represent a Prismic slice from the Prismic
+ * GraphQL API for the `mapSliceZone()` helper.
  *
- * @typeParam SliceType - Type name of the Slice.
+ * @typeParam SliceType - Type name of the slice.
  */
 export type SliceLikeGraphQL<TSliceType extends string = string> = {
 	type: Slice<TSliceType>["slice_type"];
 };
 
 /**
- * The minimum required properties to represent a Prismic Slice for the
- * `unstable_mapSliceZone()` helper.
+ * The minimum required properties to represent a Prismic slice for the
+ * `mapSliceZone()` helper.
  *
- * If using Prismic's Rest API V2, use the `Slice` export from
+ * If using Prismic's Content API, use the `Slice` export from
  * `@prismicio/client` for a full interface.
  *
- * @typeParam SliceType - Type name of the Slice.
+ * @typeParam SliceType - Type name of the slice.
  */
 export type SliceLike<TSliceType extends string = string> = (
 	| SliceLikeRestV2<TSliceType>
 	| SliceLikeGraphQL<TSliceType>
 ) & {
 	/**
-	 * If `true`, this Slice has been modified from its original value using a
+	 * If `true`, this slice has been modified from its original value using a
 	 * mapper and `@prismicio/client`'s `mapSliceZone()`.
 	 *
 	 * @internal
@@ -60,21 +60,21 @@ export type SliceLike<TSliceType extends string = string> = (
  * A looser version of the `SliceZone` type from `@prismicio/client` using
  * `SliceLike`.
  *
- * If using Prismic's Rest API V2, use the `SliceZone` export from
+ * If using Prismic's Content API, use the `SliceZone` export from
  * `@prismicio/client` for the full type.
  *
- * @typeParam TSlice - The type(s) of a Slice in the Slice Zone.
+ * @typeParam TSlice - The type(s) of a slice in the slice zone.
  */
 export type SliceZoneLike<TSlice extends SliceLike = SliceLike> =
 	readonly TSlice[];
 
 /**
- * React props for a component rendering content from a Prismic Slice using the
+ * React props for a component rendering content from a Prismic slice using the
  * `<SliceZone>` component.
  *
- * @typeParam TSlice - The Slice passed as a prop.
+ * @typeParam TSlice - The slice passed as a prop.
  * @typeParam TContext - Arbitrary data passed to `<SliceZone>` and made
- *   available to all Slice components.
+ *   available to all slice components.
  */
 export type SliceComponentProps<
 	TSlice extends SliceLike = SliceLike,
@@ -83,30 +83,30 @@ export type SliceComponentProps<
 	/** Slice data for this component. */
 	slice: TSlice;
 
-	/** The index of the Slice in the Slice Zone. */
+	/** The index of the slice in the slice zone. */
 	index: number;
 
-	/** All Slices from the Slice Zone to which the Slice belongs. */
-	// TODO: We have to keep this list of Slices general due to circular
+	/** All slices from the slice zone to which the slice belongs. */
+	// TODO: We have to keep this list of slices general due to circular
 	// reference limtiations. If we had another generic to determine the full
-	// union of Slice types, it would include TSlice. This causes TypeScript to
+	// union of slice types, it would include TSlice. This causes TypeScript to
 	// throw a compilation error.
 	slices: SliceZoneLike<
 		TSlice extends SliceLikeGraphQL ? SliceLikeGraphQL : SliceLikeRestV2
 	>;
 
 	/**
-	 * Arbitrary data passed to `<SliceZone>` and made available to all Slice
+	 * Arbitrary data passed to `<SliceZone>` and made available to all slice
 	 * components.
 	 */
 	context: TContext;
 };
 
 /**
- * A React component to be rendered for each instance of its Slice.
+ * A React component to be rendered for each instance of its slice.
  *
- * @typeParam TSlice - The type(s) of a Slice in the Slice Zone.
- * @typeParam TContext - Arbitrary data made available to all Slice components.
+ * @typeParam TSlice - The type(s) of a slice in the slice zone.
+ * @typeParam TContext - Arbitrary data made available to all slice components.
  */
 export type SliceComponentType<
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -115,21 +115,21 @@ export type SliceComponentType<
 > = ComponentType<SliceComponentProps<TSlice, TContext>>;
 
 /**
- * A record of Slice types mapped to a React component. The component will be
- * rendered for each instance of its Slice.
+ * A record of slice types mapped to a React component. The component will be
+ * rendered for each instance of its slice.
  *
  * @deprecated This type is no longer used by `@prismicio/react`. Prefer using
  *   `Record<string, SliceComponentType<any>>` instead.
  *
- * @typeParam TSlice - The type(s) of a Slice in the Slice Zone.
- * @typeParam TContext - Arbitrary data made available to all Slice components.
+ * @typeParam TSlice - The type(s) of a slice in the slice zone.
+ * @typeParam TContext - Arbitrary data made available to all slice components.
  */
 export type SliceZoneComponents<
 	TSlice extends SliceLike = SliceLike,
 	TContext = unknown,
 > =
 	// This is purposely not wrapped in Partial to ensure a component is provided
-	// for all Slice types. <SliceZone> will render a default component if one is
+	// for all slice types. <SliceZone> will render a default component if one is
 	// not provided, but it *should* be a type error if an explicit component is
 	// missing.
 	//
@@ -149,14 +149,14 @@ export type SliceZoneComponents<
 /**
  * React props for the `<SliceZone>` component.
  *
- * @typeParam TSlice - The type(s) of a Slice in the Slice Zone.
- * @typeParam TContext - Arbitrary data made available to all Slice components.
+ * @typeParam TSlice - The type(s) of a slice in the slice zone.
+ * @typeParam TContext - Arbitrary data made available to all slice components.
  */
 export type SliceZoneProps<TContext = unknown> = {
-	/** List of Slice data from the Slice Zone. */
+	/** List of slice data from the slice zone. */
 	slices?: SliceZoneLike;
 
-	/** A record mapping Slice types to React components. */
+	/** A record mapping slice types to React components. */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	components?: Record<string, ComponentType<any>>;
 
@@ -167,12 +167,12 @@ export type SliceZoneProps<TContext = unknown> = {
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	defaultComponent?: ComponentType<SliceComponentProps<any, TContext>>;
 
-	/** Arbitrary data made available to all Slice components. */
+	/** Arbitrary data made available to all slice components. */
 	context?: TContext;
 };
 
 /**
- * This Slice component can be used as a reminder to provide a proper
+ * This slice component can be used as a reminder to provide a proper
  * implementation.
  *
  * This is also the default React component rendered when a component mapping
@@ -190,32 +190,28 @@ export const TODOSliceComponent = <TSlice extends SliceLike>({
 	const type = "slice_type" in slice ? slice.slice_type : slice.type;
 
 	console.warn(
-		`[SliceZone] Could not find a component for Slice type "${type}"`,
+		`[SliceZone] Could not find a component for slice type "${type}"`,
 		slice,
 	);
 
 	return (
 		<section data-slice-zone-todo-component="" data-slice-type={type}>
-			Could not find a component for Slice type &ldquo;{type}
+			Could not find a component for slice type &ldquo;{type}
 			&rdquo;
 		</section>
 	);
 };
 
 /**
- * Renders content from a Prismic Slice Zone using React components for each
- * type of Slice.
+ * Renders slices in a slice zone as React components.
  *
- * If a component is not provided for a type of Slice, a default component can
- * be provided. A fallback component is provided by default that will not be
- * rendered in a production build of your app.
+ * @example
  *
- * @typeParam TSlice - The type(s) of a Slice in the Slice Zone.
- * @typeParam TContext - Arbitrary data made available to all Slice components.
+ * ```tsx
+ * <SliceZone slices={page.data.slices} components={components} />;
+ * ```
  *
- * @returns The Slice Zone's content as React components.
- *
- * @see Learn about Prismic Slices and Slice Zones {@link https://prismic.io/docs/core-concepts/slices}
+ * @see Learn how to create slices, use slice variations, and display slices: {@link https://prismic.io/docs/slices}
  */
 export const SliceZone: FC<SliceZoneProps> = (props) => {
 	const {