@madebywild/sanity-reference-collection-field 1.0.0 → 1.1.0

package/README.md

@@ -5,7 +5,6 @@
 
 Sanity field for selecting and configuring predefined reference collections.
 
-
 ## Install
 
 ```bash
@@ -15,12 +14,17 @@ pnpm add @madebywild/sanity-reference-collection-field
 ## Configure Plugin
 
 ```ts
+import { defineConfig } from "sanity";
 import { wildSanityReferenceCollectionFieldPlugin } from "@madebywild/sanity-reference-collection-field";
 
 export default defineConfig({
   plugins: [
     wildSanityReferenceCollectionFieldPlugin({
-      referenceKinds: ["post", "project", "teamMember"],
+      referenceKinds: [
+        "post",
+        { title: "Projects", value: "project" },
+        { title: "People", value: "person" },
+      ],
     }),
   ],
 });
@@ -29,16 +33,38 @@ export default defineConfig({
 ## Use in Schema
 
 ```ts
+import { defineField } from "sanity";
+
 defineField({
   name: "feed",
   type: "wild.referenceCollection",
   options: {
-    // Can be narrower than the plugin-level `referenceKinds`.
-    referenceKinds: ["post", "project"],
+    inline: true,
+    referenceKinds: ["post", { title: "Featured Projects", value: "project" }],
     extensions: {
-      filtering: true,
-      pagination: true,
+      // each supports `true` or { enabled: true/false }
+      filtering: {
+        enabled: true,
+        filterByKinds: ["post", "project"],
+      },
+      pagination: {
+        enabled: true,
+        pageCount: 12,
+      },
     },
   },
 });
 ```
+
+```ts
+// Example editor value shape
+{
+  collectionRef: "post",
+  options: {
+    withFilters: true,
+    filterByKinds: ["post", "project"],
+    withPagination: true,
+    pageCount: 12,
+  },
+}
+```

package/dist/index.cjs

@@ -54,7 +54,7 @@ function CollectionOptionsInput(props) {
   let t0;
   $[0] !== extensions || $[1] !== props ? (t0 = props.members.map((member) => member.kind !== "field" || !(extensions && isExtensionEnabled(extensions, "filtering")) && member.name === "withFilters" || !(extensions && isExtensionEnabled(extensions, "pagination")) && member.name === "withPagination" ? null : /* @__PURE__ */ jsxRuntime.jsx(sanity.MemberField, { member, ...props }, member.key)), $[0] = extensions, $[1] = props, $[2] = t0) : t0 = $[2];
   let t1;
-  return $[3] !== t0 ? (t1 = /* @__PURE__ */ jsxRuntime.jsx(ui.Stack, { space: 2, children: t0 }), $[3] = t0, $[4] = t1) : t1 = $[4], t1;
+  return $[3] !== t0 ? (t1 = /* @__PURE__ */ jsxRuntime.jsx(ui.Stack, { space: 4, children: t0 }), $[3] = t0, $[4] = t1) : t1 = $[4], t1;
 }
 function CollectionRefInput(t0) {
   const $ = compilerRuntime.c(14);
@@ -98,7 +98,7 @@ const typeName = "wild.referenceCollection", wildSanityReferenceCollectionFieldP
       name: typeName,
       type: "object",
       title: "Reference Collection",
-      description: "Create a collection of specific kinds.",
+      description: "Choose a content type and control how the collection is displayed.",
       icon: () => /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: "\u{1F503}" }),
       validation: (R) => R.custom((value) => value?.collectionRef ? !0 : {
         message: "Select a reference.",
@@ -111,8 +111,8 @@ const typeName = "wild.referenceCollection", wildSanityReferenceCollectionFieldP
       fields: [sanity.defineField({
         name: "collectionRef",
         type: "string",
-        title: "Reference",
-        description: "Select the kind of references for the collection to display.",
+        title: "Collection Type",
+        description: "Choose which type of content this collection should show.",
         components: {
           input: (props) => /* @__PURE__ */ jsxRuntime.jsx(CollectionRefInput, { pluginConfig: config, ...props })
         },
@@ -123,8 +123,8 @@ const typeName = "wild.referenceCollection", wildSanityReferenceCollectionFieldP
       }), sanity.defineField({
         type: "object",
         name: "options",
-        title: "Options",
-        description: "Configure how to render the collection.",
+        title: "Display Settings",
+        description: "Control filters and pagination for this collection.",
         options: {
           collapsed: !1,
           collapsible: !1
@@ -136,21 +136,46 @@ const typeName = "wild.referenceCollection", wildSanityReferenceCollectionFieldP
         fields: [sanity.defineField({
           name: "withFilters",
           type: "boolean",
-          title: "With Filters",
-          description: "Enable filters for the collection.",
+          title: "Enable Filters",
+          description: "Show filter controls for this collection.",
           initialValue: !1,
           options: {
             layout: "switch"
           }
+        }), sanity.defineField({
+          name: "filterByKinds",
+          type: "array",
+          title: "Available Filter Types",
+          description: "Choose which content types appear as filter options.",
+          hidden: ({
+            parent
+          }) => !parent?.withFilters,
+          of: [sanity.defineArrayMember({
+            type: "string"
+          })],
+          options: {
+            layout: "tags"
+          },
+          validation: (R) => R.unique()
         }), sanity.defineField({
           name: "withPagination",
           type: "boolean",
-          title: "With Pagination",
-          description: "Enable pagination for the collection.",
+          title: "Enable Pagination",
+          description: "Split collection results across multiple pages.",
           initialValue: !1,
           options: {
             layout: "switch"
           }
+        }), sanity.defineField({
+          name: "pageCount",
+          type: "number",
+          title: "Items Per Page",
+          description: "Set how many items to show on each page.",
+          hidden: ({
+            parent
+          }) => !parent?.withPagination,
+          initialValue: 12,
+          validation: (R) => R.integer().positive()
         })]
       })],
       preview: {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/input.tsx","../src/types.tsx","../src/index.tsx"],"sourcesContent":["import { CompactObjectInput } from \"@madebywild/sanity-utils/compact-object-input\";\nimport { Stack } from \"@sanity/ui\";\nimport * as React from \"react\";\nimport type { ObjectFieldProps } from \"sanity\";\nimport { MemberField, type ObjectInputProps, type ObjectMember, type StringInputProps } from \"sanity\";\nimport type { CollectionReference, FieldOptions, PluginConfig, ReferenceCollectionExtensions } from \"./types\";\n\nfunction isExtensionEnabled(extensions: ReferenceCollectionExtensions, key: keyof ReferenceCollectionExtensions) {\n  return extensions[key] && (extensions[key] === true || extensions[key].enabled !== false);\n}\n\nconst FieldContext = React.createContext<{ options?: FieldOptions }>({});\nconst useFieldCtx = () => React.useContext(FieldContext);\n\nfunction normalizeCollection(preset: CollectionReference) {\n  return typeof preset === \"string\" ? { title: preset, value: preset } : preset;\n}\n\nfunction CollectionFieldInput(props: ObjectInputProps) {\n  return (\n    <FieldContext.Provider value={{ options: props.schemaType.options as FieldOptions | undefined }}>\n      <CompactObjectInput space={4} {...props} />\n    </FieldContext.Provider>\n  );\n}\n\nfunction CollectionOptionsField(props: ObjectFieldProps) {\n  const { options } = useFieldCtx();\n  // We can hide the field if no extensions are enabled.\n  if (!options?.extensions || !Object.keys(options?.extensions).length) return null;\n  return <>{props.children}</>;\n}\n\nfunction CollectionOptionsInput(props: ObjectInputProps) {\n  const { options } = useFieldCtx();\n  const extensions = options?.extensions;\n\n  return (\n    <Stack space={2}>\n      {props.members.map((member: ObjectMember) => {\n        if (member.kind !== \"field\") return null;\n\n        // Custom filtering extension.\n        const filteringEnabled = extensions && isExtensionEnabled(extensions, \"filtering\");\n        if (!filteringEnabled && member.name === \"withFilters\") return null;\n\n        // Custom pagination extension.\n        const paginationEnabled = extensions && isExtensionEnabled(extensions, \"pagination\");\n        if (!paginationEnabled && member.name === \"withPagination\") return null;\n\n        return <MemberField key={member.key} member={member} {...props} />;\n      })}\n    </Stack>\n  );\n}\n\nfunction CollectionRefInput({\n  pluginConfig,\n  ...props\n}: StringInputProps & {\n  pluginConfig?: PluginConfig;\n}) {\n  const patchedSchemaType = React.useMemo(() => {\n    // Local options take precedence over plugin config.\n    const options = props.schemaType.options as FieldOptions | undefined;\n    const references = options?.referenceKinds ?? pluginConfig?.referenceKinds;\n\n    // No need to touch anything if the list is unchanged.\n    if (!references?.length) return props.schemaType;\n\n    return {\n      ...props.schemaType,\n      options: {\n        ...props.schemaType.options,\n        list: references.map(normalizeCollection),\n      },\n    };\n  }, [props.schemaType]);\n\n  return props.renderDefault({\n    ...props,\n    schemaType: patchedSchemaType,\n  });\n}\n\nexport { CollectionRefInput, CollectionFieldInput, CollectionOptionsField, CollectionOptionsInput };\n","import type { ObjectDefinition, ObjectOptions } from \"sanity\";\n\n/** @public */\nexport const typeName = \"wild.referenceCollection\" as const;\n\n/** @public */\nexport type CollectionReference = string | { title: string; value: string };\n\n/** @public */\nexport type ReferenceCollectionExtensions = Partial<{\n  /** Allows filtering the references. */\n  filtering: boolean | { enabled?: boolean };\n  /** Allows paginating the references. */\n  pagination: boolean | { enabled?: boolean };\n}>;\n\n/** @public */\nexport type PluginConfig = {\n  /**\n   * A list of references the user can choose from.\n   * Can be overridden per-field via `options.referenceKinds`.\n   * @example\n   * ```ts\n   * referenceKinds: [\"blogPost\", \"some-type\"],\n   * ```\n   */\n  referenceKinds: CollectionReference[];\n};\n\n/** @public */\nexport type FieldOptions = ObjectOptions & {\n  /**\n   * Whether the media field should be displayed inline.\n   * This will render all children inline on the same level.\n   */\n  inline?: boolean;\n  /**\n   * A list of references the user can choose from.\n   * Will take precedence over the plugin-level `referenceKinds`.\n   * @example\n   * ```ts\n   * referenceKinds: [\"blogPost\", \"some-type\"],\n   * ```\n   */\n  referenceKinds?: CollectionReference[];\n  /**\n   * List of extension that add additional behaviors to the link field.\n   */\n  extensions?: ReferenceCollectionExtensions;\n};\n\n// Add the custom field definition to Sanity's intrinsic definitions\n// so that type checking works correctly when using this field type.\ndeclare module \"sanity\" {\n  export interface IntrinsicDefinitions {\n    [typeName]: Omit<ObjectDefinition, \"type\" | \"fields\" | \"options\" | \"components\"> & {\n      type: typeof typeName;\n      options?: FieldOptions;\n    };\n  }\n}\n","import { defineField, definePlugin, defineType } from \"sanity\";\nimport { CollectionFieldInput, CollectionOptionsField, CollectionOptionsInput, CollectionRefInput } from \"./input\";\nimport {\n  type CollectionReference,\n  type FieldOptions,\n  type PluginConfig,\n  type ReferenceCollectionExtensions,\n  typeName,\n} from \"./types\";\n\n/** @public */\nconst wildSanityReferenceCollectionFieldPlugin = definePlugin<PluginConfig>((config) => {\n  return {\n    name: \"@madebywild/sanity-reference-collection-field\",\n    schema: {\n      types: [\n        defineType({\n          name: typeName,\n          type: \"object\",\n          title: \"Reference Collection\",\n          description: \"Create a collection of specific kinds.\",\n          icon: () => <>🔃</>,\n          validation: (R) => {\n            return R.custom((value) => {\n              return !value?.collectionRef ? { message: \"Select a reference.\", path: [\"collectionRef\"] } : true;\n            });\n          },\n          components: {\n            field: (props) => (props.schemaType.options.inline ? props.children : props.renderDefault(props)),\n            input: (props) => <CollectionFieldInput {...props} />,\n          },\n          fields: [\n            defineField({\n              name: \"collectionRef\",\n              type: \"string\",\n              title: \"Reference\",\n              description: \"Select the kind of references for the collection to display.\",\n              components: {\n                input: (props) => <CollectionRefInput pluginConfig={config} {...props} />,\n              },\n              options: {\n                layout: \"dropdown\",\n                list: config.referenceKinds,\n              },\n            }),\n            defineField({\n              type: \"object\",\n              name: \"options\",\n              title: \"Options\",\n              description: \"Configure how to render the collection.\",\n              options: {\n                collapsed: false,\n                collapsible: false,\n              },\n              components: {\n                field: (props) => <CollectionOptionsField {...props} />,\n                input: (props) => <CollectionOptionsInput {...props} />,\n              },\n              fields: [\n                defineField({\n                  name: \"withFilters\",\n                  type: \"boolean\",\n                  title: \"With Filters\",\n                  description: \"Enable filters for the collection.\",\n                  initialValue: false,\n                  options: { layout: \"switch\" },\n                }),\n                defineField({\n                  name: \"withPagination\",\n                  type: \"boolean\",\n                  title: \"With Pagination\",\n                  description: \"Enable pagination for the collection.\",\n                  initialValue: false,\n                  options: { layout: \"switch\" },\n                }),\n              ],\n            }),\n          ],\n          preview: {\n            select: {\n              collection: \"collectionRef\",\n            },\n            prepare({ collection }) {\n              return {\n                title: \"Reference Collection\",\n                subtitle: collection ? `Reference to ${collection}` : undefined,\n              };\n            },\n          },\n        }),\n      ],\n    },\n  };\n});\n\nexport {\n  wildSanityReferenceCollectionFieldPlugin,\n  typeName,\n  type ReferenceCollectionExtensions,\n  type PluginConfig,\n  type FieldOptions,\n  type CollectionReference,\n};\n"],"names":["isExtensionEnabled","extensions","key","enabled","FieldContext","React","createContext","useFieldCtx","useContext","normalizeCollection","preset","title","value","CollectionFieldInput","props","$","_c","t0","schemaType","options","t1","t2","jsx","CompactObjectInput","t3","CollectionOptionsField","Object","keys","length","children","CollectionOptionsInput","members","map","member","kind","name","MemberField","Stack","CollectionRefInput","pluginConfig","bb0","references","referenceKinds","t4","t5","list","t6","patchedSchemaType","renderDefault","typeName","wildSanityReferenceCollectionFieldPlugin","definePlugin","config","schema","types","defineType","type","description","icon","Fragment","validation","R","custom","collectionRef","message","path","components","field","inline","input","fields","defineField","layout","collapsed","collapsible","initialValue","preview","select","collection","prepare","subtitle","undefined"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/input.tsx","../src/types.tsx","../src/index.tsx"],"sourcesContent":["import { CompactObjectInput } from \"@madebywild/sanity-utils/compact-object-input\";\nimport { Stack } from \"@sanity/ui\";\nimport * as React from \"react\";\nimport type { ObjectFieldProps } from \"sanity\";\nimport { MemberField, type ObjectInputProps, type ObjectMember, type StringInputProps } from \"sanity\";\nimport type { CollectionReference, FieldOptions, PluginConfig, ReferenceCollectionExtensions } from \"./types\";\n\nfunction isExtensionEnabled(extensions: ReferenceCollectionExtensions, key: keyof ReferenceCollectionExtensions) {\n  return extensions[key] && (extensions[key] === true || extensions[key].enabled !== false);\n}\n\nconst FieldContext = React.createContext<{ options?: FieldOptions }>({});\nconst useFieldCtx = () => React.useContext(FieldContext);\n\nfunction normalizeCollection(preset: CollectionReference) {\n  return typeof preset === \"string\" ? { title: preset, value: preset } : preset;\n}\n\nfunction CollectionFieldInput(props: ObjectInputProps) {\n  return (\n    <FieldContext.Provider value={{ options: props.schemaType.options as FieldOptions | undefined }}>\n      <CompactObjectInput space={4} {...props} />\n    </FieldContext.Provider>\n  );\n}\n\nfunction CollectionOptionsField(props: ObjectFieldProps) {\n  const { options } = useFieldCtx();\n  // We can hide the field if no extensions are enabled.\n  if (!options?.extensions || !Object.keys(options?.extensions).length) return null;\n  return <>{props.children}</>;\n}\n\nfunction CollectionOptionsInput(props: ObjectInputProps) {\n  const { options } = useFieldCtx();\n  const extensions = options?.extensions;\n\n  return (\n    <Stack space={4}>\n      {props.members.map((member: ObjectMember) => {\n        if (member.kind !== \"field\") return null;\n\n        // Custom filtering extension.\n        const filteringEnabled = extensions && isExtensionEnabled(extensions, \"filtering\");\n        if (!filteringEnabled && member.name === \"withFilters\") return null;\n\n        // Custom pagination extension.\n        const paginationEnabled = extensions && isExtensionEnabled(extensions, \"pagination\");\n        if (!paginationEnabled && member.name === \"withPagination\") return null;\n\n        return <MemberField key={member.key} member={member} {...props} />;\n      })}\n    </Stack>\n  );\n}\n\nfunction CollectionRefInput({\n  pluginConfig,\n  ...props\n}: StringInputProps & {\n  pluginConfig?: PluginConfig;\n}) {\n  const patchedSchemaType = React.useMemo(() => {\n    // Local options take precedence over plugin config.\n    const options = props.schemaType.options as FieldOptions | undefined;\n    const references = options?.referenceKinds ?? pluginConfig?.referenceKinds;\n\n    // No need to touch anything if the list is unchanged.\n    if (!references?.length) return props.schemaType;\n\n    return {\n      ...props.schemaType,\n      options: {\n        ...props.schemaType.options,\n        list: references.map(normalizeCollection),\n      },\n    };\n  }, [props.schemaType]);\n\n  return props.renderDefault({\n    ...props,\n    schemaType: patchedSchemaType,\n  });\n}\n\nexport { CollectionRefInput, CollectionFieldInput, CollectionOptionsField, CollectionOptionsInput };\n","import type { ObjectDefinition, ObjectOptions } from \"sanity\";\n\n/** @public */\nexport const typeName = \"wild.referenceCollection\" as const;\n\n/** @public */\nexport type CollectionReference = string | { title: string; value: string };\n\n/** @public */\nexport type ReferenceCollectionExtensions = Partial<{\n  /** Allows filtering the references. */\n  filtering: boolean | { enabled?: boolean; filterByKinds?: string[] };\n  /** Allows paginating the references. */\n  pagination: boolean | { enabled?: boolean; pageCount?: number };\n}>;\n\n/** @public */\nexport type PluginConfig = {\n  /**\n   * A list of references the user can choose from.\n   * Can be overridden per-field via `options.referenceKinds`.\n   * @example\n   * ```ts\n   * referenceKinds: [\"blogPost\", \"some-type\"],\n   * ```\n   */\n  referenceKinds: CollectionReference[];\n};\n\n/** @public */\nexport type FieldOptions = ObjectOptions & {\n  /**\n   * Whether the media field should be displayed inline.\n   * This will render all children inline on the same level.\n   */\n  inline?: boolean;\n  /**\n   * A list of references the user can choose from.\n   * Will take precedence over the plugin-level `referenceKinds`.\n   * @example\n   * ```ts\n   * referenceKinds: [\"blogPost\", \"some-type\"],\n   * ```\n   */\n  referenceKinds?: CollectionReference[];\n  /**\n   * List of extension that add additional behaviors to the link field.\n   */\n  extensions?: ReferenceCollectionExtensions;\n};\n\n// Add the custom field definition to Sanity's intrinsic definitions\n// so that type checking works correctly when using this field type.\ndeclare module \"sanity\" {\n  export interface IntrinsicDefinitions {\n    [typeName]: Omit<ObjectDefinition, \"type\" | \"fields\" | \"options\" | \"components\"> & {\n      type: typeof typeName;\n      options?: FieldOptions;\n    };\n  }\n}\n","import { defineArrayMember, defineField, definePlugin, defineType } from \"sanity\";\nimport { CollectionFieldInput, CollectionOptionsField, CollectionOptionsInput, CollectionRefInput } from \"./input\";\nimport {\n  type CollectionReference,\n  type FieldOptions,\n  type PluginConfig,\n  type ReferenceCollectionExtensions,\n  typeName,\n} from \"./types\";\n\n/** @public */\nconst wildSanityReferenceCollectionFieldPlugin = definePlugin<PluginConfig>((config) => {\n  return {\n    name: \"@madebywild/sanity-reference-collection-field\",\n    schema: {\n      types: [\n        defineType({\n          name: typeName,\n          type: \"object\",\n          title: \"Reference Collection\",\n          description: \"Choose a content type and control how the collection is displayed.\",\n          icon: () => <>🔃</>,\n          validation: (R) => {\n            return R.custom((value) => {\n              return !value?.collectionRef ? { message: \"Select a reference.\", path: [\"collectionRef\"] } : true;\n            });\n          },\n          components: {\n            field: (props) => (props.schemaType.options.inline ? props.children : props.renderDefault(props)),\n            input: (props) => <CollectionFieldInput {...props} />,\n          },\n          fields: [\n            defineField({\n              name: \"collectionRef\",\n              type: \"string\",\n              title: \"Collection Type\",\n              description: \"Choose which type of content this collection should show.\",\n              components: {\n                input: (props) => <CollectionRefInput pluginConfig={config} {...props} />,\n              },\n              options: {\n                layout: \"dropdown\",\n                list: config.referenceKinds,\n              },\n            }),\n            defineField({\n              type: \"object\",\n              name: \"options\",\n              title: \"Display Settings\",\n              description: \"Control filters and pagination for this collection.\",\n              options: {\n                collapsed: false,\n                collapsible: false,\n              },\n              components: {\n                field: (props) => <CollectionOptionsField {...props} />,\n                input: (props) => <CollectionOptionsInput {...props} />,\n              },\n              fields: [\n                defineField({\n                  name: \"withFilters\",\n                  type: \"boolean\",\n                  title: \"Enable Filters\",\n                  description: \"Show filter controls for this collection.\",\n                  initialValue: false,\n                  options: { layout: \"switch\" },\n                }),\n                defineField({\n                  name: \"filterByKinds\",\n                  type: \"array\",\n                  title: \"Available Filter Types\",\n                  description: \"Choose which content types appear as filter options.\",\n                  hidden: ({ parent }) => !parent?.withFilters,\n                  of: [\n                    defineArrayMember({\n                      type: \"string\",\n                    }),\n                  ],\n                  options: { layout: \"tags\" },\n                  validation: (R) => R.unique(),\n                }),\n                defineField({\n                  name: \"withPagination\",\n                  type: \"boolean\",\n                  title: \"Enable Pagination\",\n                  description: \"Split collection results across multiple pages.\",\n                  initialValue: false,\n                  options: { layout: \"switch\" },\n                }),\n                defineField({\n                  name: \"pageCount\",\n                  type: \"number\",\n                  title: \"Items Per Page\",\n                  description: \"Set how many items to show on each page.\",\n                  hidden: ({ parent }) => !parent?.withPagination,\n                  initialValue: 12,\n                  validation: (R) => R.integer().positive(),\n                }),\n              ],\n            }),\n          ],\n          preview: {\n            select: {\n              collection: \"collectionRef\",\n            },\n            prepare({ collection }) {\n              return {\n                title: \"Reference Collection\",\n                subtitle: collection ? `Reference to ${collection}` : undefined,\n              };\n            },\n          },\n        }),\n      ],\n    },\n  };\n});\n\nexport {\n  wildSanityReferenceCollectionFieldPlugin,\n  typeName,\n  type ReferenceCollectionExtensions,\n  type PluginConfig,\n  type FieldOptions,\n  type CollectionReference,\n};\n"],"names":["isExtensionEnabled","extensions","key","enabled","FieldContext","React","createContext","useFieldCtx","useContext","normalizeCollection","preset","title","value","CollectionFieldInput","props","$","_c","t0","schemaType","options","t1","t2","jsx","CompactObjectInput","t3","CollectionOptionsField","Object","keys","length","children","CollectionOptionsInput","members","map","member","kind","name","MemberField","Stack","CollectionRefInput","pluginConfig","bb0","references","referenceKinds","t4","t5","list","t6","patchedSchemaType","renderDefault","typeName","wildSanityReferenceCollectionFieldPlugin","definePlugin","config","schema","types","defineType","type","description","icon","Fragment","validation","R","custom","collectionRef","message","path","components","field","inline","input","fields","defineField","layout","collapsed","collapsible","initialValue","hidden","parent","withFilters","of","defineArrayMember","unique","withPagination","integer","positive","preview","select","collection","prepare","subtitle","undefined"],"mappings":"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"}

package/dist/index.d.cts

@@ -12,10 +12,12 @@ type ReferenceCollectionExtensions = Partial<{
   /** Allows filtering the references. */
   filtering: boolean | {
     enabled?: boolean;
+    filterByKinds?: string[];
   };
   /** Allows paginating the references. */
   pagination: boolean | {
     enabled?: boolean;
+    pageCount?: number;
   };
 }>;
 /** @public */

package/dist/index.d.ts

@@ -12,10 +12,12 @@ type ReferenceCollectionExtensions = Partial<{
   /** Allows filtering the references. */
   filtering: boolean | {
     enabled?: boolean;
+    filterByKinds?: string[];
   };
   /** Allows paginating the references. */
   pagination: boolean | {
     enabled?: boolean;
+    pageCount?: number;
   };
 }>;
 /** @public */

package/dist/index.js

@@ -1,5 +1,5 @@
 import { jsx, Fragment } from "react/jsx-runtime";
-import { MemberField, definePlugin, defineType, defineField } from "sanity";
+import { MemberField, definePlugin, defineType, defineField, defineArrayMember } from "sanity";
 import { c } from "react/compiler-runtime";
 import { CompactObjectInput } from "@madebywild/sanity-utils/compact-object-input";
 import { Stack } from "@sanity/ui";
@@ -41,7 +41,7 @@ function CollectionOptionsInput(props) {
   let t0;
   $[0] !== extensions || $[1] !== props ? (t0 = props.members.map((member) => member.kind !== "field" || !(extensions && isExtensionEnabled(extensions, "filtering")) && member.name === "withFilters" || !(extensions && isExtensionEnabled(extensions, "pagination")) && member.name === "withPagination" ? null : /* @__PURE__ */ jsx(MemberField, { member, ...props }, member.key)), $[0] = extensions, $[1] = props, $[2] = t0) : t0 = $[2];
   let t1;
-  return $[3] !== t0 ? (t1 = /* @__PURE__ */ jsx(Stack, { space: 2, children: t0 }), $[3] = t0, $[4] = t1) : t1 = $[4], t1;
+  return $[3] !== t0 ? (t1 = /* @__PURE__ */ jsx(Stack, { space: 4, children: t0 }), $[3] = t0, $[4] = t1) : t1 = $[4], t1;
 }
 function CollectionRefInput(t0) {
   const $ = c(14);
@@ -85,7 +85,7 @@ const typeName = "wild.referenceCollection", wildSanityReferenceCollectionFieldP
       name: typeName,
       type: "object",
       title: "Reference Collection",
-      description: "Create a collection of specific kinds.",
+      description: "Choose a content type and control how the collection is displayed.",
       icon: () => /* @__PURE__ */ jsx(Fragment, { children: "\u{1F503}" }),
       validation: (R) => R.custom((value) => value?.collectionRef ? !0 : {
         message: "Select a reference.",
@@ -98,8 +98,8 @@ const typeName = "wild.referenceCollection", wildSanityReferenceCollectionFieldP
       fields: [defineField({
         name: "collectionRef",
         type: "string",
-        title: "Reference",
-        description: "Select the kind of references for the collection to display.",
+        title: "Collection Type",
+        description: "Choose which type of content this collection should show.",
         components: {
           input: (props) => /* @__PURE__ */ jsx(CollectionRefInput, { pluginConfig: config, ...props })
         },
@@ -110,8 +110,8 @@ const typeName = "wild.referenceCollection", wildSanityReferenceCollectionFieldP
       }), defineField({
         type: "object",
         name: "options",
-        title: "Options",
-        description: "Configure how to render the collection.",
+        title: "Display Settings",
+        description: "Control filters and pagination for this collection.",
         options: {
           collapsed: !1,
           collapsible: !1
@@ -123,21 +123,46 @@ const typeName = "wild.referenceCollection", wildSanityReferenceCollectionFieldP
         fields: [defineField({
           name: "withFilters",
           type: "boolean",
-          title: "With Filters",
-          description: "Enable filters for the collection.",
+          title: "Enable Filters",
+          description: "Show filter controls for this collection.",
           initialValue: !1,
           options: {
             layout: "switch"
           }
+        }), defineField({
+          name: "filterByKinds",
+          type: "array",
+          title: "Available Filter Types",
+          description: "Choose which content types appear as filter options.",
+          hidden: ({
+            parent
+          }) => !parent?.withFilters,
+          of: [defineArrayMember({
+            type: "string"
+          })],
+          options: {
+            layout: "tags"
+          },
+          validation: (R) => R.unique()
         }), defineField({
           name: "withPagination",
           type: "boolean",
-          title: "With Pagination",
-          description: "Enable pagination for the collection.",
+          title: "Enable Pagination",
+          description: "Split collection results across multiple pages.",
           initialValue: !1,
           options: {
             layout: "switch"
           }
+        }), defineField({
+          name: "pageCount",
+          type: "number",
+          title: "Items Per Page",
+          description: "Set how many items to show on each page.",
+          hidden: ({
+            parent
+          }) => !parent?.withPagination,
+          initialValue: 12,
+          validation: (R) => R.integer().positive()
         })]
       })],
       preview: {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/input.tsx","../src/types.tsx","../src/index.tsx"],"sourcesContent":["import { CompactObjectInput } from \"@madebywild/sanity-utils/compact-object-input\";\nimport { Stack } from \"@sanity/ui\";\nimport * as React from \"react\";\nimport type { ObjectFieldProps } from \"sanity\";\nimport { MemberField, type ObjectInputProps, type ObjectMember, type StringInputProps } from \"sanity\";\nimport type { CollectionReference, FieldOptions, PluginConfig, ReferenceCollectionExtensions } from \"./types\";\n\nfunction isExtensionEnabled(extensions: ReferenceCollectionExtensions, key: keyof ReferenceCollectionExtensions) {\n  return extensions[key] && (extensions[key] === true || extensions[key].enabled !== false);\n}\n\nconst FieldContext = React.createContext<{ options?: FieldOptions }>({});\nconst useFieldCtx = () => React.useContext(FieldContext);\n\nfunction normalizeCollection(preset: CollectionReference) {\n  return typeof preset === \"string\" ? { title: preset, value: preset } : preset;\n}\n\nfunction CollectionFieldInput(props: ObjectInputProps) {\n  return (\n    <FieldContext.Provider value={{ options: props.schemaType.options as FieldOptions | undefined }}>\n      <CompactObjectInput space={4} {...props} />\n    </FieldContext.Provider>\n  );\n}\n\nfunction CollectionOptionsField(props: ObjectFieldProps) {\n  const { options } = useFieldCtx();\n  // We can hide the field if no extensions are enabled.\n  if (!options?.extensions || !Object.keys(options?.extensions).length) return null;\n  return <>{props.children}</>;\n}\n\nfunction CollectionOptionsInput(props: ObjectInputProps) {\n  const { options } = useFieldCtx();\n  const extensions = options?.extensions;\n\n  return (\n    <Stack space={2}>\n      {props.members.map((member: ObjectMember) => {\n        if (member.kind !== \"field\") return null;\n\n        // Custom filtering extension.\n        const filteringEnabled = extensions && isExtensionEnabled(extensions, \"filtering\");\n        if (!filteringEnabled && member.name === \"withFilters\") return null;\n\n        // Custom pagination extension.\n        const paginationEnabled = extensions && isExtensionEnabled(extensions, \"pagination\");\n        if (!paginationEnabled && member.name === \"withPagination\") return null;\n\n        return <MemberField key={member.key} member={member} {...props} />;\n      })}\n    </Stack>\n  );\n}\n\nfunction CollectionRefInput({\n  pluginConfig,\n  ...props\n}: StringInputProps & {\n  pluginConfig?: PluginConfig;\n}) {\n  const patchedSchemaType = React.useMemo(() => {\n    // Local options take precedence over plugin config.\n    const options = props.schemaType.options as FieldOptions | undefined;\n    const references = options?.referenceKinds ?? pluginConfig?.referenceKinds;\n\n    // No need to touch anything if the list is unchanged.\n    if (!references?.length) return props.schemaType;\n\n    return {\n      ...props.schemaType,\n      options: {\n        ...props.schemaType.options,\n        list: references.map(normalizeCollection),\n      },\n    };\n  }, [props.schemaType]);\n\n  return props.renderDefault({\n    ...props,\n    schemaType: patchedSchemaType,\n  });\n}\n\nexport { CollectionRefInput, CollectionFieldInput, CollectionOptionsField, CollectionOptionsInput };\n","import type { ObjectDefinition, ObjectOptions } from \"sanity\";\n\n/** @public */\nexport const typeName = \"wild.referenceCollection\" as const;\n\n/** @public */\nexport type CollectionReference = string | { title: string; value: string };\n\n/** @public */\nexport type ReferenceCollectionExtensions = Partial<{\n  /** Allows filtering the references. */\n  filtering: boolean | { enabled?: boolean };\n  /** Allows paginating the references. */\n  pagination: boolean | { enabled?: boolean };\n}>;\n\n/** @public */\nexport type PluginConfig = {\n  /**\n   * A list of references the user can choose from.\n   * Can be overridden per-field via `options.referenceKinds`.\n   * @example\n   * ```ts\n   * referenceKinds: [\"blogPost\", \"some-type\"],\n   * ```\n   */\n  referenceKinds: CollectionReference[];\n};\n\n/** @public */\nexport type FieldOptions = ObjectOptions & {\n  /**\n   * Whether the media field should be displayed inline.\n   * This will render all children inline on the same level.\n   */\n  inline?: boolean;\n  /**\n   * A list of references the user can choose from.\n   * Will take precedence over the plugin-level `referenceKinds`.\n   * @example\n   * ```ts\n   * referenceKinds: [\"blogPost\", \"some-type\"],\n   * ```\n   */\n  referenceKinds?: CollectionReference[];\n  /**\n   * List of extension that add additional behaviors to the link field.\n   */\n  extensions?: ReferenceCollectionExtensions;\n};\n\n// Add the custom field definition to Sanity's intrinsic definitions\n// so that type checking works correctly when using this field type.\ndeclare module \"sanity\" {\n  export interface IntrinsicDefinitions {\n    [typeName]: Omit<ObjectDefinition, \"type\" | \"fields\" | \"options\" | \"components\"> & {\n      type: typeof typeName;\n      options?: FieldOptions;\n    };\n  }\n}\n","import { defineField, definePlugin, defineType } from \"sanity\";\nimport { CollectionFieldInput, CollectionOptionsField, CollectionOptionsInput, CollectionRefInput } from \"./input\";\nimport {\n  type CollectionReference,\n  type FieldOptions,\n  type PluginConfig,\n  type ReferenceCollectionExtensions,\n  typeName,\n} from \"./types\";\n\n/** @public */\nconst wildSanityReferenceCollectionFieldPlugin = definePlugin<PluginConfig>((config) => {\n  return {\n    name: \"@madebywild/sanity-reference-collection-field\",\n    schema: {\n      types: [\n        defineType({\n          name: typeName,\n          type: \"object\",\n          title: \"Reference Collection\",\n          description: \"Create a collection of specific kinds.\",\n          icon: () => <>🔃</>,\n          validation: (R) => {\n            return R.custom((value) => {\n              return !value?.collectionRef ? { message: \"Select a reference.\", path: [\"collectionRef\"] } : true;\n            });\n          },\n          components: {\n            field: (props) => (props.schemaType.options.inline ? props.children : props.renderDefault(props)),\n            input: (props) => <CollectionFieldInput {...props} />,\n          },\n          fields: [\n            defineField({\n              name: \"collectionRef\",\n              type: \"string\",\n              title: \"Reference\",\n              description: \"Select the kind of references for the collection to display.\",\n              components: {\n                input: (props) => <CollectionRefInput pluginConfig={config} {...props} />,\n              },\n              options: {\n                layout: \"dropdown\",\n                list: config.referenceKinds,\n              },\n            }),\n            defineField({\n              type: \"object\",\n              name: \"options\",\n              title: \"Options\",\n              description: \"Configure how to render the collection.\",\n              options: {\n                collapsed: false,\n                collapsible: false,\n              },\n              components: {\n                field: (props) => <CollectionOptionsField {...props} />,\n                input: (props) => <CollectionOptionsInput {...props} />,\n              },\n              fields: [\n                defineField({\n                  name: \"withFilters\",\n                  type: \"boolean\",\n                  title: \"With Filters\",\n                  description: \"Enable filters for the collection.\",\n                  initialValue: false,\n                  options: { layout: \"switch\" },\n                }),\n                defineField({\n                  name: \"withPagination\",\n                  type: \"boolean\",\n                  title: \"With Pagination\",\n                  description: \"Enable pagination for the collection.\",\n                  initialValue: false,\n                  options: { layout: \"switch\" },\n                }),\n              ],\n            }),\n          ],\n          preview: {\n            select: {\n              collection: \"collectionRef\",\n            },\n            prepare({ collection }) {\n              return {\n                title: \"Reference Collection\",\n                subtitle: collection ? `Reference to ${collection}` : undefined,\n              };\n            },\n          },\n        }),\n      ],\n    },\n  };\n});\n\nexport {\n  wildSanityReferenceCollectionFieldPlugin,\n  typeName,\n  type ReferenceCollectionExtensions,\n  type PluginConfig,\n  type FieldOptions,\n  type CollectionReference,\n};\n"],"names":["isExtensionEnabled","extensions","key","enabled","FieldContext","React","createContext","useFieldCtx","useContext","normalizeCollection","preset","title","value","CollectionFieldInput","props","$","_c","t0","schemaType","options","t1","t2","t3","CollectionOptionsField","Object","keys","length","children","CollectionOptionsInput","members","map","member","kind","name","CollectionRefInput","pluginConfig","bb0","references","referenceKinds","t4","t5","list","t6","patchedSchemaType","renderDefault","typeName","wildSanityReferenceCollectionFieldPlugin","definePlugin","config","schema","types","defineType","type","description","icon","validation","R","custom","collectionRef","message","path","components","field","inline","input","fields","defineField","layout","collapsed","collapsible","initialValue","preview","select","collection","prepare","subtitle","undefined"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/input.tsx","../src/types.tsx","../src/index.tsx"],"sourcesContent":["import { CompactObjectInput } from \"@madebywild/sanity-utils/compact-object-input\";\nimport { Stack } from \"@sanity/ui\";\nimport * as React from \"react\";\nimport type { ObjectFieldProps } from \"sanity\";\nimport { MemberField, type ObjectInputProps, type ObjectMember, type StringInputProps } from \"sanity\";\nimport type { CollectionReference, FieldOptions, PluginConfig, ReferenceCollectionExtensions } from \"./types\";\n\nfunction isExtensionEnabled(extensions: ReferenceCollectionExtensions, key: keyof ReferenceCollectionExtensions) {\n  return extensions[key] && (extensions[key] === true || extensions[key].enabled !== false);\n}\n\nconst FieldContext = React.createContext<{ options?: FieldOptions }>({});\nconst useFieldCtx = () => React.useContext(FieldContext);\n\nfunction normalizeCollection(preset: CollectionReference) {\n  return typeof preset === \"string\" ? { title: preset, value: preset } : preset;\n}\n\nfunction CollectionFieldInput(props: ObjectInputProps) {\n  return (\n    <FieldContext.Provider value={{ options: props.schemaType.options as FieldOptions | undefined }}>\n      <CompactObjectInput space={4} {...props} />\n    </FieldContext.Provider>\n  );\n}\n\nfunction CollectionOptionsField(props: ObjectFieldProps) {\n  const { options } = useFieldCtx();\n  // We can hide the field if no extensions are enabled.\n  if (!options?.extensions || !Object.keys(options?.extensions).length) return null;\n  return <>{props.children}</>;\n}\n\nfunction CollectionOptionsInput(props: ObjectInputProps) {\n  const { options } = useFieldCtx();\n  const extensions = options?.extensions;\n\n  return (\n    <Stack space={4}>\n      {props.members.map((member: ObjectMember) => {\n        if (member.kind !== \"field\") return null;\n\n        // Custom filtering extension.\n        const filteringEnabled = extensions && isExtensionEnabled(extensions, \"filtering\");\n        if (!filteringEnabled && member.name === \"withFilters\") return null;\n\n        // Custom pagination extension.\n        const paginationEnabled = extensions && isExtensionEnabled(extensions, \"pagination\");\n        if (!paginationEnabled && member.name === \"withPagination\") return null;\n\n        return <MemberField key={member.key} member={member} {...props} />;\n      })}\n    </Stack>\n  );\n}\n\nfunction CollectionRefInput({\n  pluginConfig,\n  ...props\n}: StringInputProps & {\n  pluginConfig?: PluginConfig;\n}) {\n  const patchedSchemaType = React.useMemo(() => {\n    // Local options take precedence over plugin config.\n    const options = props.schemaType.options as FieldOptions | undefined;\n    const references = options?.referenceKinds ?? pluginConfig?.referenceKinds;\n\n    // No need to touch anything if the list is unchanged.\n    if (!references?.length) return props.schemaType;\n\n    return {\n      ...props.schemaType,\n      options: {\n        ...props.schemaType.options,\n        list: references.map(normalizeCollection),\n      },\n    };\n  }, [props.schemaType]);\n\n  return props.renderDefault({\n    ...props,\n    schemaType: patchedSchemaType,\n  });\n}\n\nexport { CollectionRefInput, CollectionFieldInput, CollectionOptionsField, CollectionOptionsInput };\n","import type { ObjectDefinition, ObjectOptions } from \"sanity\";\n\n/** @public */\nexport const typeName = \"wild.referenceCollection\" as const;\n\n/** @public */\nexport type CollectionReference = string | { title: string; value: string };\n\n/** @public */\nexport type ReferenceCollectionExtensions = Partial<{\n  /** Allows filtering the references. */\n  filtering: boolean | { enabled?: boolean; filterByKinds?: string[] };\n  /** Allows paginating the references. */\n  pagination: boolean | { enabled?: boolean; pageCount?: number };\n}>;\n\n/** @public */\nexport type PluginConfig = {\n  /**\n   * A list of references the user can choose from.\n   * Can be overridden per-field via `options.referenceKinds`.\n   * @example\n   * ```ts\n   * referenceKinds: [\"blogPost\", \"some-type\"],\n   * ```\n   */\n  referenceKinds: CollectionReference[];\n};\n\n/** @public */\nexport type FieldOptions = ObjectOptions & {\n  /**\n   * Whether the media field should be displayed inline.\n   * This will render all children inline on the same level.\n   */\n  inline?: boolean;\n  /**\n   * A list of references the user can choose from.\n   * Will take precedence over the plugin-level `referenceKinds`.\n   * @example\n   * ```ts\n   * referenceKinds: [\"blogPost\", \"some-type\"],\n   * ```\n   */\n  referenceKinds?: CollectionReference[];\n  /**\n   * List of extension that add additional behaviors to the link field.\n   */\n  extensions?: ReferenceCollectionExtensions;\n};\n\n// Add the custom field definition to Sanity's intrinsic definitions\n// so that type checking works correctly when using this field type.\ndeclare module \"sanity\" {\n  export interface IntrinsicDefinitions {\n    [typeName]: Omit<ObjectDefinition, \"type\" | \"fields\" | \"options\" | \"components\"> & {\n      type: typeof typeName;\n      options?: FieldOptions;\n    };\n  }\n}\n","import { defineArrayMember, defineField, definePlugin, defineType } from \"sanity\";\nimport { CollectionFieldInput, CollectionOptionsField, CollectionOptionsInput, CollectionRefInput } from \"./input\";\nimport {\n  type CollectionReference,\n  type FieldOptions,\n  type PluginConfig,\n  type ReferenceCollectionExtensions,\n  typeName,\n} from \"./types\";\n\n/** @public */\nconst wildSanityReferenceCollectionFieldPlugin = definePlugin<PluginConfig>((config) => {\n  return {\n    name: \"@madebywild/sanity-reference-collection-field\",\n    schema: {\n      types: [\n        defineType({\n          name: typeName,\n          type: \"object\",\n          title: \"Reference Collection\",\n          description: \"Choose a content type and control how the collection is displayed.\",\n          icon: () => <>🔃</>,\n          validation: (R) => {\n            return R.custom((value) => {\n              return !value?.collectionRef ? { message: \"Select a reference.\", path: [\"collectionRef\"] } : true;\n            });\n          },\n          components: {\n            field: (props) => (props.schemaType.options.inline ? props.children : props.renderDefault(props)),\n            input: (props) => <CollectionFieldInput {...props} />,\n          },\n          fields: [\n            defineField({\n              name: \"collectionRef\",\n              type: \"string\",\n              title: \"Collection Type\",\n              description: \"Choose which type of content this collection should show.\",\n              components: {\n                input: (props) => <CollectionRefInput pluginConfig={config} {...props} />,\n              },\n              options: {\n                layout: \"dropdown\",\n                list: config.referenceKinds,\n              },\n            }),\n            defineField({\n              type: \"object\",\n              name: \"options\",\n              title: \"Display Settings\",\n              description: \"Control filters and pagination for this collection.\",\n              options: {\n                collapsed: false,\n                collapsible: false,\n              },\n              components: {\n                field: (props) => <CollectionOptionsField {...props} />,\n                input: (props) => <CollectionOptionsInput {...props} />,\n              },\n              fields: [\n                defineField({\n                  name: \"withFilters\",\n                  type: \"boolean\",\n                  title: \"Enable Filters\",\n                  description: \"Show filter controls for this collection.\",\n                  initialValue: false,\n                  options: { layout: \"switch\" },\n                }),\n                defineField({\n                  name: \"filterByKinds\",\n                  type: \"array\",\n                  title: \"Available Filter Types\",\n                  description: \"Choose which content types appear as filter options.\",\n                  hidden: ({ parent }) => !parent?.withFilters,\n                  of: [\n                    defineArrayMember({\n                      type: \"string\",\n                    }),\n                  ],\n                  options: { layout: \"tags\" },\n                  validation: (R) => R.unique(),\n                }),\n                defineField({\n                  name: \"withPagination\",\n                  type: \"boolean\",\n                  title: \"Enable Pagination\",\n                  description: \"Split collection results across multiple pages.\",\n                  initialValue: false,\n                  options: { layout: \"switch\" },\n                }),\n                defineField({\n                  name: \"pageCount\",\n                  type: \"number\",\n                  title: \"Items Per Page\",\n                  description: \"Set how many items to show on each page.\",\n                  hidden: ({ parent }) => !parent?.withPagination,\n                  initialValue: 12,\n                  validation: (R) => R.integer().positive(),\n                }),\n              ],\n            }),\n          ],\n          preview: {\n            select: {\n              collection: \"collectionRef\",\n            },\n            prepare({ collection }) {\n              return {\n                title: \"Reference Collection\",\n                subtitle: collection ? `Reference to ${collection}` : undefined,\n              };\n            },\n          },\n        }),\n      ],\n    },\n  };\n});\n\nexport {\n  wildSanityReferenceCollectionFieldPlugin,\n  typeName,\n  type ReferenceCollectionExtensions,\n  type PluginConfig,\n  type FieldOptions,\n  type CollectionReference,\n};\n"],"names":["isExtensionEnabled","extensions","key","enabled","FieldContext","React","createContext","useFieldCtx","useContext","normalizeCollection","preset","title","value","CollectionFieldInput","props","$","_c","t0","schemaType","options","t1","t2","t3","CollectionOptionsField","Object","keys","length","children","CollectionOptionsInput","members","map","member","kind","name","CollectionRefInput","pluginConfig","bb0","references","referenceKinds","t4","t5","list","t6","patchedSchemaType","renderDefault","typeName","wildSanityReferenceCollectionFieldPlugin","definePlugin","config","schema","types","defineType","type","description","icon","validation","R","custom","collectionRef","message","path","components","field","inline","input","fields","defineField","layout","collapsed","collapsible","initialValue","hidden","parent","withFilters","of","defineArrayMember","unique","withPagination","integer","positive","preview","select","collection","prepare","subtitle","undefined"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madebywild/sanity-reference-collection-field",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
   "sideEffects": false,
   "license": "UNLICENSED",

package/src/index.tsx

@@ -1,4 +1,4 @@
-import { defineField, definePlugin, defineType } from "sanity";
+import { defineArrayMember, defineField, definePlugin, defineType } from "sanity";
 import { CollectionFieldInput, CollectionOptionsField, CollectionOptionsInput, CollectionRefInput } from "./input";
 import {
   type CollectionReference,
@@ -18,7 +18,7 @@ const wildSanityReferenceCollectionFieldPlugin = definePlugin<PluginConfig>((con
           name: typeName,
           type: "object",
           title: "Reference Collection",
-          description: "Create a collection of specific kinds.",
+          description: "Choose a content type and control how the collection is displayed.",
           icon: () => <>🔃</>,
           validation: (R) => {
             return R.custom((value) => {
@@ -33,8 +33,8 @@ const wildSanityReferenceCollectionFieldPlugin = definePlugin<PluginConfig>((con
             defineField({
               name: "collectionRef",
               type: "string",
-              title: "Reference",
-              description: "Select the kind of references for the collection to display.",
+              title: "Collection Type",
+              description: "Choose which type of content this collection should show.",
               components: {
                 input: (props) => <CollectionRefInput pluginConfig={config} {...props} />,
               },
@@ -46,8 +46,8 @@ const wildSanityReferenceCollectionFieldPlugin = definePlugin<PluginConfig>((con
             defineField({
               type: "object",
               name: "options",
-              title: "Options",
-              description: "Configure how to render the collection.",
+              title: "Display Settings",
+              description: "Control filters and pagination for this collection.",
               options: {
                 collapsed: false,
                 collapsible: false,
@@ -60,19 +60,42 @@ const wildSanityReferenceCollectionFieldPlugin = definePlugin<PluginConfig>((con
                 defineField({
                   name: "withFilters",
                   type: "boolean",
-                  title: "With Filters",
-                  description: "Enable filters for the collection.",
+                  title: "Enable Filters",
+                  description: "Show filter controls for this collection.",
                   initialValue: false,
                   options: { layout: "switch" },
                 }),
+                defineField({
+                  name: "filterByKinds",
+                  type: "array",
+                  title: "Available Filter Types",
+                  description: "Choose which content types appear as filter options.",
+                  hidden: ({ parent }) => !parent?.withFilters,
+                  of: [
+                    defineArrayMember({
+                      type: "string",
+                    }),
+                  ],
+                  options: { layout: "tags" },
+                  validation: (R) => R.unique(),
+                }),
                 defineField({
                   name: "withPagination",
                   type: "boolean",
-                  title: "With Pagination",
-                  description: "Enable pagination for the collection.",
+                  title: "Enable Pagination",
+                  description: "Split collection results across multiple pages.",
                   initialValue: false,
                   options: { layout: "switch" },
                 }),
+                defineField({
+                  name: "pageCount",
+                  type: "number",
+                  title: "Items Per Page",
+                  description: "Set how many items to show on each page.",
+                  hidden: ({ parent }) => !parent?.withPagination,
+                  initialValue: 12,
+                  validation: (R) => R.integer().positive(),
+                }),
               ],
             }),
           ],

package/src/input.tsx

@@ -36,7 +36,7 @@ function CollectionOptionsInput(props: ObjectInputProps) {
   const extensions = options?.extensions;
 
   return (
-    <Stack space={2}>
+    <Stack space={4}>
       {props.members.map((member: ObjectMember) => {
         if (member.kind !== "field") return null;
 

package/src/types.tsx

@@ -9,9 +9,9 @@ export type CollectionReference = string | { title: string; value: string };
 /** @public */
 export type ReferenceCollectionExtensions = Partial<{
   /** Allows filtering the references. */
-  filtering: boolean | { enabled?: boolean };
+  filtering: boolean | { enabled?: boolean; filterByKinds?: string[] };
   /** Allows paginating the references. */
-  pagination: boolean | { enabled?: boolean };
+  pagination: boolean | { enabled?: boolean; pageCount?: number };
 }>;
 
 /** @public */