@prismicio/client/dist/types/value/link.d.ts

The official JavaScript + TypeScript client library for Prismic

import { GroupField } from "./group.js";
import { SliceZone } from "./sliceZone.js";
import { FilledContentRelationshipField } from "./contentRelationship.js";
import { FilledLinkToMediaField } from "./linkToMedia.js";
import { AnyRegularField, FieldState } from "./types.js";

//#region src/types/value/link.d.ts

/**
 * Link types
 */
declare const LinkType: {
  readonly Any: "Any";
  readonly Document: "Document";
  readonly Media: "Media";
  readonly Web: "Web";
};
/**
 * A link field.
 *
 * @typeParam TypeEnum - Type API ID of the document.
 * @typeParam LangEnum - Language API ID of the document.
 * @typeParam DataInterface - Data fields for the document (filled via the
 *   `fetchLinks` or `graphQuery` query parameter).
 * @typeParam State - State of the field which determines its shape.
 * @typeParam Variant - Variants of the link.
 */
type LinkField<TypeEnum = string, LangEnum = string, DataInterface extends Record<string, AnyRegularField | GroupField | SliceZone> | unknown = unknown, State extends FieldState = FieldState, Variant = string> = State extends "empty" ? EmptyLinkField<typeof LinkType.Any, Variant> : FilledLinkField<TypeEnum, LangEnum, DataInterface, Variant>;
/**
 * A link field that is filled.
 *
 * @typeParam TypeEnum - Type API ID of the document.
 * @typeParam LangEnum - Language API ID of the document.
 * @typeParam DataInterface - Data fields for the document (filled via the
 *   `fetchLinks` or `graphQuery` query parameter).
 * @typeParam Variant - Variants of the link.
 */
type FilledLinkField<TypeEnum = string, LangEnum = string, DataInterface extends Record<string, AnyRegularField | GroupField | SliceZone> | unknown = unknown, Variant = string> = (FilledContentRelationshipField<TypeEnum, LangEnum, DataInterface> & OptionalLinkProperties<Variant>) | FilledLinkToMediaField<Variant> | FilledLinkToWebField<Variant>;
/**
 * A link field that is not filled.
 *
 * @typeParam _Unused - THIS PARAMETER IS NOT USED. If you are passing a type,
 *   **please remove it**.
 * @typeParam Variant - Variants of the link.
 */
type EmptyLinkField<_Unused extends (typeof LinkType)[keyof typeof LinkType] = typeof LinkType.Any, Variant = string> = {
  link_type: "Any";
} & OptionalLinkProperties<Variant>;
/**
 * A link field pointing to a relative or absolute URL.
 *
 * @typeParam Variant - Variants of the link.
 */
type FilledLinkToWebField<Variant = string> = {
  link_type: "Web";
  url: string;
  target?: string;
} & OptionalLinkProperties<Variant>;
/**
 * Optional properties available to link fields. It is used to augment existing
 * link-like fields (like content relationship fields) with field-specific
 * properties.
 *
 * @typeParam Variant - Variants of the link.
 *
 * @internal
 */
type OptionalLinkProperties<Variant = string> = {
  text?: string;
  variant?: Variant;
};
//#endregion
export { EmptyLinkField, FilledLinkField, FilledLinkToWebField, LinkField, LinkType, OptionalLinkProperties };
//# sourceMappingURL=link.d.ts.map