@puckeditor/field-contentful 0.21.0-canary.d1c0d6a2

package/README.md

@@ -0,0 +1,132 @@
+# field-contentful
+
+Select [entries](https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/entries) from a [Contentful](https://www.contentful.com) space.
+
+## Quick start
+
+```sh
+npm i @puckeditor/field-contentful
+```
+
+```jsx
+import createFieldContentful from "@puckeditor/field-contentful";
+
+const config = {
+  components: {
+    Example: {
+      fields: {
+        movie: createFieldContentful("movies", {
+          space: "my_space",
+          accessToken: "abcdefg123456",
+        }),
+      },
+      render: ({ data }) => {
+        return <p>{data?.fields.title || "No data selected"}</p>;
+      },
+    },
+  },
+};
+```
+
+## Args
+
+| Param                         | Example  | Type   | Status   |
+| ----------------------------- | -------- | ------ | -------- |
+| [`contentType`](#contenttype) | `movies` | String | Required |
+| [`options`](#options)         | `{}`     | Object | Required |
+
+### Required args
+
+#### `contentType`
+
+ID of the Contentful [Content Type](https://www.contentful.com/help/content-model-and-content-type/) to query.
+
+#### `options`
+
+| Param                                      | Example                                 | Type                                                            | Status                         |
+| ------------------------------------------ | --------------------------------------- | --------------------------------------------------------------- | ------------------------------ |
+| [`accessToken`](#optionsaccesstoken)       | `"abc123"`                              | String                                                          | Required (unless using client) |
+| [`space`](#optionsspace)                   | `"my-space"`                            | String                                                          | Required (unless using client) |
+| [`client`](#optionsclient)                 | `createClient()`                        | [ContentfulClientApi](https://www.npmjs.com/package/contentful) | -                              |
+| [`filterFields`](#optionsfilterfields)     | `{ "rating[gte]": { type: "number" } }` | Object                                                          | -                              |
+| [`initialFilters`](#optionsinitialfilters) | `{ "rating[gte]": 1 }`                  | Object                                                          | -                              |
+| [`titleField`](#optionstitlefield)         | `"name"`                                | String                                                          | -                              |
+
+##### `options.accessToken`
+
+Your Contentful access token.
+
+##### `options.space`
+
+The id for the Contentful space that contains your content.
+
+##### `options.client`
+
+A Contentful client as created by the [`contentful` Node.js package](https://www.npmjs.com/package/contentful). You can use this instead of `accessToken` and `space` if you want to reuse your client, or customise it more fully.
+
+##### `options.filterFields`
+
+An object describing which [`filterFields`](https://puckeditor.com/docs/api-reference/fields/external#filterfields) to render and pass the result directly to Contentful as [search parameters](https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters).
+
+```jsx
+createFieldContentful("movies", {
+  // ...
+  filterFields: {
+    // Filter the "rating" field by value greater than the user input
+    "fields.rating[gte]": {
+      type: "number",
+    },
+  },
+});
+```
+
+##### `options.initialFilters`
+
+The initial values for the filters defined in [`filterFields`](#optionsfilterfields). This data is passed directly directly to Contentful as [search parameters](https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters).
+
+```jsx
+createFieldContentful("movies", {
+  // ...
+  initialFilters: {
+    "fields.rating[gte]": 1,
+    select: "name,rating", // Can include search parameters not included in filterFields
+  },
+});
+```
+
+##### `options.titleField`
+
+The field to use as the title for the selected item. Defaults to `"title"`.
+
+```jsx
+createFieldContentful("movies", {
+  // ...
+  titleField: "name",
+});
+```
+
+## Returns
+
+An [External field](https://puckeditor.com/docs/api-reference/fields/external) type that loads Contentful [entries](https://contentful.github.io/contentful.js/contentful/10.6.16/types/Entry.html).
+
+## TypeScript
+
+You can use the `Entry` type for data loaded via Contentful:
+
+```tsx
+import createFieldContentful, { Entry } from "@/field-contentful";
+
+type MyProps = {
+  Example: {
+    movie: Entry<{ title: string; description: string; rating: number }>;
+  };
+};
+
+const config: Config<MyProps> = {
+  // ...
+};
+```
+
+## License
+
+MIT © [The Puck Contributors](https://github.com/puckeditor/puck/graphs/contributors)

package/dist/index.d.mts

@@ -0,0 +1,344 @@
+import { ReactElement, ReactNode, CSSProperties } from 'react';
+import { EditorStateSnapshot, Editor, Extensions } from '@tiptap/react';
+import { BlockquoteOptions } from '@tiptap/extension-blockquote';
+import { BoldOptions } from '@tiptap/extension-bold';
+import { CodeOptions } from '@tiptap/extension-code';
+import { CodeBlockOptions } from '@tiptap/extension-code-block';
+import { HardBreakOptions } from '@tiptap/extension-hard-break';
+import { HeadingOptions } from '@tiptap/extension-heading';
+import { HorizontalRuleOptions } from '@tiptap/extension-horizontal-rule';
+import { ItalicOptions } from '@tiptap/extension-italic';
+import { LinkOptions } from '@tiptap/extension-link';
+import { BulletListOptions, ListItemOptions, ListKeymapOptions, OrderedListOptions } from '@tiptap/extension-list';
+import { ParagraphOptions } from '@tiptap/extension-paragraph';
+import { StrikeOptions } from '@tiptap/extension-strike';
+import { TextAlignOptions } from '@tiptap/extension-text-align';
+import { UnderlineOptions } from '@tiptap/extension-underline';
+import { BaseEntry, ContentfulClientApi } from 'contentful';
+export { createClient } from 'contentful';
+
+declare const defaultEditorState: (ctx: EditorStateSnapshot, readOnly: boolean) => {
+    isAlignLeft?: undefined;
+    canAlignLeft?: undefined;
+    isAlignCenter?: undefined;
+    canAlignCenter?: undefined;
+    isAlignRight?: undefined;
+    canAlignRight?: undefined;
+    isAlignJustify?: undefined;
+    canAlignJustify?: undefined;
+    isBold?: undefined;
+    canBold?: undefined;
+    isItalic?: undefined;
+    canItalic?: undefined;
+    isUnderline?: undefined;
+    canUnderline?: undefined;
+    isStrike?: undefined;
+    canStrike?: undefined;
+    isInlineCode?: undefined;
+    canInlineCode?: undefined;
+    isBulletList?: undefined;
+    canBulletList?: undefined;
+    isOrderedList?: undefined;
+    canOrderedList?: undefined;
+    isCodeBlock?: undefined;
+    canCodeBlock?: undefined;
+    isBlockquote?: undefined;
+    canBlockquote?: undefined;
+    canHorizontalRule?: undefined;
+} | {
+    isAlignLeft: boolean;
+    canAlignLeft: boolean;
+    isAlignCenter: boolean;
+    canAlignCenter: boolean;
+    isAlignRight: boolean;
+    canAlignRight: boolean;
+    isAlignJustify: boolean;
+    canAlignJustify: boolean;
+    isBold: boolean;
+    canBold: boolean;
+    isItalic: boolean;
+    canItalic: boolean;
+    isUnderline: boolean;
+    canUnderline: boolean;
+    isStrike: boolean;
+    canStrike: boolean;
+    isInlineCode: boolean;
+    canInlineCode: boolean;
+    isBulletList: boolean;
+    canBulletList: boolean;
+    isOrderedList: boolean;
+    canOrderedList: boolean;
+    isCodeBlock: boolean;
+    canCodeBlock: boolean;
+    isBlockquote: boolean;
+    canBlockquote: boolean;
+    canHorizontalRule: boolean;
+};
+
+type RichTextSelector = (ctx: EditorStateSnapshot, readOnly: boolean) => Partial<Record<string, boolean>>;
+type DefaultEditorState = ReturnType<typeof defaultEditorState>;
+type EditorState<Selector extends RichTextSelector = RichTextSelector> = DefaultEditorState & ReturnType<Selector> & Record<string, boolean | undefined>;
+
+interface PuckRichTextOptions {
+    /**
+     * If set to false, the blockquote extension will not be registered
+     * @example blockquote: false
+     */
+    blockquote: Partial<BlockquoteOptions> | false;
+    /**
+     * If set to false, the bold extension will not be registered
+     * @example bold: false
+     */
+    bold: Partial<BoldOptions> | false;
+    /**
+     * If set to false, the bulletList extension will not be registered
+     * @example bulletList: false
+     */
+    bulletList: Partial<BulletListOptions> | false;
+    /**
+     * If set to false, the code extension will not be registered
+     * @example code: false
+     */
+    code: Partial<CodeOptions> | false;
+    /**
+     * If set to false, the codeBlock extension will not be registered
+     * @example codeBlock: false
+     */
+    codeBlock: Partial<CodeBlockOptions> | false;
+    /**
+     * If set to false, the document extension will not be registered
+     * @example document: false
+     */
+    document: false;
+    /**
+     * If set to false, the hardBreak extension will not be registered
+     * @example hardBreak: false
+     */
+    hardBreak: Partial<HardBreakOptions> | false;
+    /**
+     * If set to false, the heading extension will not be registered
+     * @example heading: false
+     */
+    heading: Partial<HeadingOptions> | false;
+    /**
+     * If set to false, the horizontalRule extension will not be registered
+     * @example horizontalRule: false
+     */
+    horizontalRule: Partial<HorizontalRuleOptions> | false;
+    /**
+     * If set to false, the italic extension will not be registered
+     * @example italic: false
+     */
+    italic: Partial<ItalicOptions> | false;
+    /**
+     * If set to false, the listItem extension will not be registered
+     * @example listItem: false
+     */
+    listItem: Partial<ListItemOptions> | false;
+    /**
+     * If set to false, the listItemKeymap extension will not be registered
+     * @example listKeymap: false
+     */
+    listKeymap: Partial<ListKeymapOptions> | false;
+    /**
+     * If set to false, the link extension will not be registered
+     * @example link: false
+     */
+    link: Partial<LinkOptions> | false;
+    /**
+     * If set to false, the orderedList extension will not be registered
+     * @example orderedList: false
+     */
+    orderedList: Partial<OrderedListOptions> | false;
+    /**
+     * If set to false, the paragraph extension will not be registered
+     * @example paragraph: false
+     */
+    paragraph: Partial<ParagraphOptions> | false;
+    /**
+     * If set to false, the strike extension will not be registered
+     * @example strike: false
+     */
+    strike: Partial<StrikeOptions> | false;
+    /**
+     * If set to false, the text extension will not be registered
+     * @example text: false
+     */
+    text: false;
+    /**
+     * If set to false, the textAlign extension will not be registered
+     * @example text: false
+     */
+    textAlign: Partial<TextAlignOptions> | false;
+    /**
+     * If set to false, the underline extension will not be registered
+     * @example underline: false
+     */
+    underline: Partial<UnderlineOptions> | false;
+}
+
+type FieldOption = {
+    label: string;
+    value: string | number | boolean | undefined | null | object;
+};
+type FieldOptions = Array<FieldOption> | ReadonlyArray<FieldOption>;
+interface BaseField {
+    label?: string;
+    labelIcon?: ReactElement;
+    metadata?: FieldMetadata;
+    visible?: boolean;
+}
+interface TextField extends BaseField {
+    type: "text";
+    placeholder?: string;
+    contentEditable?: boolean;
+}
+interface NumberField extends BaseField {
+    type: "number";
+    placeholder?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+interface TextareaField extends BaseField {
+    type: "textarea";
+    placeholder?: string;
+    contentEditable?: boolean;
+}
+interface SelectField extends BaseField {
+    type: "select";
+    options: FieldOptions;
+}
+interface RadioField extends BaseField {
+    type: "radio";
+    options: FieldOptions;
+}
+interface RichtextField<UserSelector extends RichTextSelector = RichTextSelector> extends BaseField {
+    type: "richtext";
+    contentEditable?: boolean;
+    initialHeight?: CSSProperties["height"];
+    options?: Partial<PuckRichTextOptions>;
+    renderMenu?: (props: {
+        children: ReactNode;
+        editor: Editor | null;
+        editorState: EditorState<UserSelector> | null;
+        readOnly: boolean;
+    }) => ReactNode;
+    renderInlineMenu?: (props: {
+        children: ReactNode;
+        editor: Editor | null;
+        editorState: EditorState<UserSelector> | null;
+        readOnly: boolean;
+    }) => ReactNode;
+    tiptap?: {
+        selector?: UserSelector;
+        extensions?: Extensions;
+    };
+}
+interface ArrayField<Props extends {
+    [key: string]: any;
+}[] = {
+    [key: string]: any;
+}[], UserField extends {} = {}> extends BaseField {
+    type: "array";
+    arrayFields: {
+        [SubPropName in keyof Props[0]]: UserField extends {
+            type: PropertyKey;
+        } ? Field<Props[0][SubPropName], UserField> | UserField : Field<Props[0][SubPropName], UserField>;
+    };
+    defaultItemProps?: Props[0] | ((index: number) => Props[0]);
+    getItemSummary?: (item: Props[0], index?: number) => ReactNode;
+    max?: number;
+    min?: number;
+}
+interface ObjectField<Props extends any = {
+    [key: string]: any;
+}, UserField extends {} = {}> extends BaseField {
+    type: "object";
+    objectFields: {
+        [SubPropName in keyof Props]: UserField extends {
+            type: PropertyKey;
+        } ? Field<Props[SubPropName]> | UserField : Field<Props[SubPropName]>;
+    };
+}
+type Adaptor<AdaptorParams = {}, TableShape extends Record<string, any> = {}, PropShape = TableShape> = {
+    name: string;
+    fetchList: (adaptorParams?: AdaptorParams) => Promise<TableShape[] | null>;
+    mapProp?: (value: TableShape) => PropShape;
+};
+type NotUndefined<T> = T extends undefined ? never : T;
+type ExternalFieldWithAdaptor<Props extends any = {
+    [key: string]: any;
+}> = BaseField & {
+    type: "external";
+    placeholder?: string;
+    adaptor: Adaptor<any, any, Props>;
+    adaptorParams?: object;
+    getItemSummary: (item: NotUndefined<Props>, index?: number) => ReactNode;
+};
+type CacheOpts = {
+    enabled?: boolean;
+};
+interface ExternalField<Props extends any = {
+    [key: string]: any;
+}> extends BaseField {
+    type: "external";
+    cache?: CacheOpts;
+    placeholder?: string;
+    fetchList: (params: {
+        query: string;
+        filters: Record<string, any>;
+    }) => Promise<any[] | null>;
+    mapProp?: (value: any) => Props;
+    mapRow?: (value: any) => Record<string, string | number | ReactElement>;
+    getItemSummary?: (item: NotUndefined<Props>, index?: number) => ReactNode;
+    showSearch?: boolean;
+    renderFooter?: (props: {
+        items: any[];
+    }) => ReactElement;
+    initialQuery?: string;
+    filterFields?: Record<string, Field>;
+    initialFilters?: Record<string, any>;
+}
+type CustomFieldRender<Value extends any> = (props: {
+    field: CustomField<Value>;
+    name: string;
+    id: string;
+    value: Value;
+    onChange: (value: Value) => void;
+    readOnly?: boolean;
+}) => ReactElement;
+interface CustomField<Value extends any> extends BaseField {
+    type: "custom";
+    render: CustomFieldRender<Value>;
+    contentEditable?: boolean;
+    key?: string;
+}
+interface SlotField extends BaseField {
+    type: "slot";
+    allow?: string[];
+    disallow?: string[];
+}
+type Field<ValueType = any, UserField extends {} = {}> = TextField | RichtextField | NumberField | TextareaField | SelectField | RadioField | ArrayField<ValueType extends {
+    [key: string]: any;
+}[] ? ValueType : never, UserField> | ObjectField<ValueType, UserField> | ExternalField<ValueType> | ExternalFieldWithAdaptor<ValueType> | CustomField<ValueType> | SlotField;
+
+type Metadata = {
+    [key: string]: any;
+};
+interface FieldMetadata extends Metadata {
+}
+
+type Entry<Fields extends Record<string, any> = {}> = BaseEntry & {
+    fields: Fields;
+};
+declare function createFieldContentful<T extends Entry = Entry>(contentType: string, options?: {
+    client?: ContentfulClientApi<undefined>;
+    space?: string;
+    accessToken?: string;
+    titleField?: string;
+    filterFields?: ExternalField["filterFields"];
+    initialFilters?: ExternalField["initialFilters"];
+}): ExternalField<T>;
+
+export { type Entry, createFieldContentful, createFieldContentful as default };

package/dist/index.d.ts

@@ -0,0 +1,344 @@
+import { ReactElement, ReactNode, CSSProperties } from 'react';
+import { EditorStateSnapshot, Editor, Extensions } from '@tiptap/react';
+import { BlockquoteOptions } from '@tiptap/extension-blockquote';
+import { BoldOptions } from '@tiptap/extension-bold';
+import { CodeOptions } from '@tiptap/extension-code';
+import { CodeBlockOptions } from '@tiptap/extension-code-block';
+import { HardBreakOptions } from '@tiptap/extension-hard-break';
+import { HeadingOptions } from '@tiptap/extension-heading';
+import { HorizontalRuleOptions } from '@tiptap/extension-horizontal-rule';
+import { ItalicOptions } from '@tiptap/extension-italic';
+import { LinkOptions } from '@tiptap/extension-link';
+import { BulletListOptions, ListItemOptions, ListKeymapOptions, OrderedListOptions } from '@tiptap/extension-list';
+import { ParagraphOptions } from '@tiptap/extension-paragraph';
+import { StrikeOptions } from '@tiptap/extension-strike';
+import { TextAlignOptions } from '@tiptap/extension-text-align';
+import { UnderlineOptions } from '@tiptap/extension-underline';
+import { BaseEntry, ContentfulClientApi } from 'contentful';
+export { createClient } from 'contentful';
+
+declare const defaultEditorState: (ctx: EditorStateSnapshot, readOnly: boolean) => {
+    isAlignLeft?: undefined;
+    canAlignLeft?: undefined;
+    isAlignCenter?: undefined;
+    canAlignCenter?: undefined;
+    isAlignRight?: undefined;
+    canAlignRight?: undefined;
+    isAlignJustify?: undefined;
+    canAlignJustify?: undefined;
+    isBold?: undefined;
+    canBold?: undefined;
+    isItalic?: undefined;
+    canItalic?: undefined;
+    isUnderline?: undefined;
+    canUnderline?: undefined;
+    isStrike?: undefined;
+    canStrike?: undefined;
+    isInlineCode?: undefined;
+    canInlineCode?: undefined;
+    isBulletList?: undefined;
+    canBulletList?: undefined;
+    isOrderedList?: undefined;
+    canOrderedList?: undefined;
+    isCodeBlock?: undefined;
+    canCodeBlock?: undefined;
+    isBlockquote?: undefined;
+    canBlockquote?: undefined;
+    canHorizontalRule?: undefined;
+} | {
+    isAlignLeft: boolean;
+    canAlignLeft: boolean;
+    isAlignCenter: boolean;
+    canAlignCenter: boolean;
+    isAlignRight: boolean;
+    canAlignRight: boolean;
+    isAlignJustify: boolean;
+    canAlignJustify: boolean;
+    isBold: boolean;
+    canBold: boolean;
+    isItalic: boolean;
+    canItalic: boolean;
+    isUnderline: boolean;
+    canUnderline: boolean;
+    isStrike: boolean;
+    canStrike: boolean;
+    isInlineCode: boolean;
+    canInlineCode: boolean;
+    isBulletList: boolean;
+    canBulletList: boolean;
+    isOrderedList: boolean;
+    canOrderedList: boolean;
+    isCodeBlock: boolean;
+    canCodeBlock: boolean;
+    isBlockquote: boolean;
+    canBlockquote: boolean;
+    canHorizontalRule: boolean;
+};
+
+type RichTextSelector = (ctx: EditorStateSnapshot, readOnly: boolean) => Partial<Record<string, boolean>>;
+type DefaultEditorState = ReturnType<typeof defaultEditorState>;
+type EditorState<Selector extends RichTextSelector = RichTextSelector> = DefaultEditorState & ReturnType<Selector> & Record<string, boolean | undefined>;
+
+interface PuckRichTextOptions {
+    /**
+     * If set to false, the blockquote extension will not be registered
+     * @example blockquote: false
+     */
+    blockquote: Partial<BlockquoteOptions> | false;
+    /**
+     * If set to false, the bold extension will not be registered
+     * @example bold: false
+     */
+    bold: Partial<BoldOptions> | false;
+    /**
+     * If set to false, the bulletList extension will not be registered
+     * @example bulletList: false
+     */
+    bulletList: Partial<BulletListOptions> | false;
+    /**
+     * If set to false, the code extension will not be registered
+     * @example code: false
+     */
+    code: Partial<CodeOptions> | false;
+    /**
+     * If set to false, the codeBlock extension will not be registered
+     * @example codeBlock: false
+     */
+    codeBlock: Partial<CodeBlockOptions> | false;
+    /**
+     * If set to false, the document extension will not be registered
+     * @example document: false
+     */
+    document: false;
+    /**
+     * If set to false, the hardBreak extension will not be registered
+     * @example hardBreak: false
+     */
+    hardBreak: Partial<HardBreakOptions> | false;
+    /**
+     * If set to false, the heading extension will not be registered
+     * @example heading: false
+     */
+    heading: Partial<HeadingOptions> | false;
+    /**
+     * If set to false, the horizontalRule extension will not be registered
+     * @example horizontalRule: false
+     */
+    horizontalRule: Partial<HorizontalRuleOptions> | false;
+    /**
+     * If set to false, the italic extension will not be registered
+     * @example italic: false
+     */
+    italic: Partial<ItalicOptions> | false;
+    /**
+     * If set to false, the listItem extension will not be registered
+     * @example listItem: false
+     */
+    listItem: Partial<ListItemOptions> | false;
+    /**
+     * If set to false, the listItemKeymap extension will not be registered
+     * @example listKeymap: false
+     */
+    listKeymap: Partial<ListKeymapOptions> | false;
+    /**
+     * If set to false, the link extension will not be registered
+     * @example link: false
+     */
+    link: Partial<LinkOptions> | false;
+    /**
+     * If set to false, the orderedList extension will not be registered
+     * @example orderedList: false
+     */
+    orderedList: Partial<OrderedListOptions> | false;
+    /**
+     * If set to false, the paragraph extension will not be registered
+     * @example paragraph: false
+     */
+    paragraph: Partial<ParagraphOptions> | false;
+    /**
+     * If set to false, the strike extension will not be registered
+     * @example strike: false
+     */
+    strike: Partial<StrikeOptions> | false;
+    /**
+     * If set to false, the text extension will not be registered
+     * @example text: false
+     */
+    text: false;
+    /**
+     * If set to false, the textAlign extension will not be registered
+     * @example text: false
+     */
+    textAlign: Partial<TextAlignOptions> | false;
+    /**
+     * If set to false, the underline extension will not be registered
+     * @example underline: false
+     */
+    underline: Partial<UnderlineOptions> | false;
+}
+
+type FieldOption = {
+    label: string;
+    value: string | number | boolean | undefined | null | object;
+};
+type FieldOptions = Array<FieldOption> | ReadonlyArray<FieldOption>;
+interface BaseField {
+    label?: string;
+    labelIcon?: ReactElement;
+    metadata?: FieldMetadata;
+    visible?: boolean;
+}
+interface TextField extends BaseField {
+    type: "text";
+    placeholder?: string;
+    contentEditable?: boolean;
+}
+interface NumberField extends BaseField {
+    type: "number";
+    placeholder?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+interface TextareaField extends BaseField {
+    type: "textarea";
+    placeholder?: string;
+    contentEditable?: boolean;
+}
+interface SelectField extends BaseField {
+    type: "select";
+    options: FieldOptions;
+}
+interface RadioField extends BaseField {
+    type: "radio";
+    options: FieldOptions;
+}
+interface RichtextField<UserSelector extends RichTextSelector = RichTextSelector> extends BaseField {
+    type: "richtext";
+    contentEditable?: boolean;
+    initialHeight?: CSSProperties["height"];
+    options?: Partial<PuckRichTextOptions>;
+    renderMenu?: (props: {
+        children: ReactNode;
+        editor: Editor | null;
+        editorState: EditorState<UserSelector> | null;
+        readOnly: boolean;
+    }) => ReactNode;
+    renderInlineMenu?: (props: {
+        children: ReactNode;
+        editor: Editor | null;
+        editorState: EditorState<UserSelector> | null;
+        readOnly: boolean;
+    }) => ReactNode;
+    tiptap?: {
+        selector?: UserSelector;
+        extensions?: Extensions;
+    };
+}
+interface ArrayField<Props extends {
+    [key: string]: any;
+}[] = {
+    [key: string]: any;
+}[], UserField extends {} = {}> extends BaseField {
+    type: "array";
+    arrayFields: {
+        [SubPropName in keyof Props[0]]: UserField extends {
+            type: PropertyKey;
+        } ? Field<Props[0][SubPropName], UserField> | UserField : Field<Props[0][SubPropName], UserField>;
+    };
+    defaultItemProps?: Props[0] | ((index: number) => Props[0]);
+    getItemSummary?: (item: Props[0], index?: number) => ReactNode;
+    max?: number;
+    min?: number;
+}
+interface ObjectField<Props extends any = {
+    [key: string]: any;
+}, UserField extends {} = {}> extends BaseField {
+    type: "object";
+    objectFields: {
+        [SubPropName in keyof Props]: UserField extends {
+            type: PropertyKey;
+        } ? Field<Props[SubPropName]> | UserField : Field<Props[SubPropName]>;
+    };
+}
+type Adaptor<AdaptorParams = {}, TableShape extends Record<string, any> = {}, PropShape = TableShape> = {
+    name: string;
+    fetchList: (adaptorParams?: AdaptorParams) => Promise<TableShape[] | null>;
+    mapProp?: (value: TableShape) => PropShape;
+};
+type NotUndefined<T> = T extends undefined ? never : T;
+type ExternalFieldWithAdaptor<Props extends any = {
+    [key: string]: any;
+}> = BaseField & {
+    type: "external";
+    placeholder?: string;
+    adaptor: Adaptor<any, any, Props>;
+    adaptorParams?: object;
+    getItemSummary: (item: NotUndefined<Props>, index?: number) => ReactNode;
+};
+type CacheOpts = {
+    enabled?: boolean;
+};
+interface ExternalField<Props extends any = {
+    [key: string]: any;
+}> extends BaseField {
+    type: "external";
+    cache?: CacheOpts;
+    placeholder?: string;
+    fetchList: (params: {
+        query: string;
+        filters: Record<string, any>;
+    }) => Promise<any[] | null>;
+    mapProp?: (value: any) => Props;
+    mapRow?: (value: any) => Record<string, string | number | ReactElement>;
+    getItemSummary?: (item: NotUndefined<Props>, index?: number) => ReactNode;
+    showSearch?: boolean;
+    renderFooter?: (props: {
+        items: any[];
+    }) => ReactElement;
+    initialQuery?: string;
+    filterFields?: Record<string, Field>;
+    initialFilters?: Record<string, any>;
+}
+type CustomFieldRender<Value extends any> = (props: {
+    field: CustomField<Value>;
+    name: string;
+    id: string;
+    value: Value;
+    onChange: (value: Value) => void;
+    readOnly?: boolean;
+}) => ReactElement;
+interface CustomField<Value extends any> extends BaseField {
+    type: "custom";
+    render: CustomFieldRender<Value>;
+    contentEditable?: boolean;
+    key?: string;
+}
+interface SlotField extends BaseField {
+    type: "slot";
+    allow?: string[];
+    disallow?: string[];
+}
+type Field<ValueType = any, UserField extends {} = {}> = TextField | RichtextField | NumberField | TextareaField | SelectField | RadioField | ArrayField<ValueType extends {
+    [key: string]: any;
+}[] ? ValueType : never, UserField> | ObjectField<ValueType, UserField> | ExternalField<ValueType> | ExternalFieldWithAdaptor<ValueType> | CustomField<ValueType> | SlotField;
+
+type Metadata = {
+    [key: string]: any;
+};
+interface FieldMetadata extends Metadata {
+}
+
+type Entry<Fields extends Record<string, any> = {}> = BaseEntry & {
+    fields: Fields;
+};
+declare function createFieldContentful<T extends Entry = Entry>(contentType: string, options?: {
+    client?: ContentfulClientApi<undefined>;
+    space?: string;
+    accessToken?: string;
+    titleField?: string;
+    filterFields?: ExternalField["filterFields"];
+    initialFilters?: ExternalField["initialFilters"];
+}): ExternalField<T>;
+
+export { type Entry, createFieldContentful, createFieldContentful as default };

package/dist/index.js

@@ -0,0 +1,120 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  createClient: () => import_contentful.createClient,
+  createFieldContentful: () => createFieldContentful,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+
+// ../tsup-config/react-import.js
+var import_react = __toESM(require("react"));
+
+// index.ts
+var import_contentful = require("contentful");
+function createFieldContentful(contentType, options = {}) {
+  const {
+    space,
+    accessToken,
+    titleField = "title",
+    filterFields,
+    initialFilters
+  } = options;
+  if (!options.client) {
+    if (!space || !accessToken) {
+      throw new Error(
+        'field-contentful: Must either specify "client", or "space" and "accessToken"'
+      );
+    }
+  }
+  const client = options.client || (0, import_contentful.createClient)({ space, accessToken });
+  const field = {
+    type: "external",
+    placeholder: "Select from Contentful",
+    showSearch: true,
+    fetchList: (_0) => __async(null, [_0], function* ({ query, filters = {} }) {
+      const entries = yield client.getEntries(__spreadProps(__spreadValues({}, filters), {
+        content_type: contentType,
+        query
+      }));
+      return entries.items;
+    }),
+    mapRow: ({ fields }) => fields,
+    getItemSummary: (item) => item.fields[titleField],
+    filterFields,
+    initialFilters
+  };
+  return field;
+}
+var index_default = createFieldContentful;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createClient,
+  createFieldContentful
+});

package/dist/index.mjs

@@ -0,0 +1,85 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// ../tsup-config/react-import.js
+import React from "react";
+
+// index.ts
+import { createClient } from "contentful";
+function createFieldContentful(contentType, options = {}) {
+  const {
+    space,
+    accessToken,
+    titleField = "title",
+    filterFields,
+    initialFilters
+  } = options;
+  if (!options.client) {
+    if (!space || !accessToken) {
+      throw new Error(
+        'field-contentful: Must either specify "client", or "space" and "accessToken"'
+      );
+    }
+  }
+  const client = options.client || createClient({ space, accessToken });
+  const field = {
+    type: "external",
+    placeholder: "Select from Contentful",
+    showSearch: true,
+    fetchList: (_0) => __async(null, [_0], function* ({ query, filters = {} }) {
+      const entries = yield client.getEntries(__spreadProps(__spreadValues({}, filters), {
+        content_type: contentType,
+        query
+      }));
+      return entries.items;
+    }),
+    mapRow: ({ fields }) => fields,
+    getItemSummary: (item) => item.fields[titleField],
+    filterFields,
+    initialFilters
+  };
+  return field;
+}
+var index_default = createFieldContentful;
+export {
+  createClient,
+  createFieldContentful,
+  index_default as default
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@puckeditor/field-contentful",
+  "version": "0.21.0-canary.d1c0d6a2",
+  "author": "Chris Villa <chris@puckeditor.com>",
+  "repository": "puckeditor/puck",
+  "bugs": "https://github.com/puckeditor/puck/issues",
+  "homepage": "https://puckeditor.com",
+  "private": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "import": "./dist/index.mjs",
+    "types": "./dist/index.d.ts"
+  },
+  "license": "MIT",
+  "scripts": {
+    "lint": "eslint \"**/*.ts*\"",
+    "build": "rm -rf dist && tsup index.ts",
+    "prepare": "yarn build"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@puckeditor/core": "^0.21.0-canary.d1c0d6a2",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "contentful": "^10.8.6",
+    "eslint": "^7.32.0",
+    "eslint-config-custom": "*",
+    "tsconfig": "*",
+    "tsup-config": "*",
+    "typescript": "^5.5.4"
+  },
+  "peerDependencies": {
+    "contentful": "^10.0.0",
+    "react": "^17.0.0 || ^18.0.0 || ^19.0.0"
+  }
+}