feat(async-list): port @sanity/sanity-plugin-async-list to the monorepo

.changeset/async-list-transfer.md

@@ -0,0 +1,14 @@
+---
+'@sanity/sanity-plugin-async-list': major
+---
+
+Port @sanity/sanity-plugin-async-list to the Sanity plugins monorepo
+
+This major release includes several breaking changes as part of the migration to the monorepo:
+
+- **React Compiler enabled**: The package is now built with React Compiler targeting React 19
+- **ESM-only**: CommonJS support has been removed. The package now ships only ESM
+- **React 19.2+ required**: Minimum React version is now 19.2 (previously ^18 || ^19)
+- **react-dom 19.2+ required**: `react-dom` is now a required peer dependency
+- **Sanity Studio v5+ required**: Minimum Sanity version is now v5 (Sanity v3 and v4 are no longer supported)
+- **Node.js 20.19+ required**: Minimum Node.js version is now 20.19 (previously >=18)

README.md

@@ -90,6 +90,7 @@ Sessions can be compared in the DevTools UI to diff bundle changes between build
 | [`@sanity/orderable-document-list`](./plugins/@sanity/orderable-document-list)                 | Drag-and-drop document ordering without leaving the editing surface |
 | [`@sanity/presets`](./plugins/@sanity/presets)                                                 | Experimental preset patterns for Sanity Studio                      |
 | [`@sanity/rich-date-input`](./plugins/@sanity/rich-date-input)                                 | Timezone-aware datetime input for Sanity Studio                     |
+| [`@sanity/sanity-plugin-async-list`](./plugins/@sanity/sanity-plugin-async-list)               | Autocomplete string input with options loaded from an external API  |
 | [`@sanity/studio-secrets`](./plugins/@sanity/studio-secrets)                                   | Manage Studio secrets at runtime                                    |
 | [`@sanity/vercel-protection-bypass`](./plugins/@sanity/vercel-protection-bypass)               | Setup tool for Vercel Deployment Protection in previews             |
 | [`sanity-plugin-aprimo`](./plugins/sanity-plugin-aprimo)                                       | Aprimo asset selector integration                                   |

dev/test-studio/package.json

@@ -24,6 +24,7 @@
     "@sanity/orderable-document-list": "workspace:*",
     "@sanity/presets": "workspace:*",
     "@sanity/rich-date-input": "workspace:*",
+    "@sanity/sanity-plugin-async-list": "workspace:*",
     "@sanity/sfcc": "workspace:*",
     "@sanity/studio-secrets": "workspace:*",
     "@sanity/ui": "catalog:",

dev/test-studio/sanity.config.ts

@@ -8,6 +8,7 @@ import {structureTool} from 'sanity/structure'
 
 import {aprimoExample} from '#aprimo'
 import {assistExample} from '#assist'
+import {asyncListExample} from '#async-list'
 import {bynderExample} from '#bynder'
 import {codeInputExample} from '#code-input'
 import {colorExample} from '#color'
@@ -104,6 +105,7 @@ export default defineConfig([
       assistExample(),
       googleTranslateExample(),
       // add new plugins here
+      asyncListExample(),
       orderableDocumentListExample(),
       latexInputExample(),
       debugLiveSyncTagsExample(),

dev/test-studio/src/async-list/index.tsx

@@ -0,0 +1,60 @@
+import {asyncList} from '@sanity/sanity-plugin-async-list'
+import {definePlugin, defineType} from 'sanity'
+
+const asyncListTest = defineType({
+  type: 'document',
+  name: 'asyncListTest',
+  title: 'Async List',
+  fields: [
+    {type: 'string', name: 'title', title: 'Title'},
+    {type: 'pokemon', name: 'pokemon', title: 'Pokemon (seed loader)'},
+    {type: 'disneyCharacter', name: 'disneyCharacter', title: 'Disney Character (search loader)'},
+  ],
+})
+
+export const asyncListExample = definePlugin(() => ({
+  name: 'async-list-example',
+  schema: {types: [asyncListTest]},
+  plugins: [
+    // Seed loader: fetches the options once when the field is rendered
+    asyncList({
+      schemaType: 'pokemon',
+      loader: async () => {
+        const response = await fetch('https://pokeapi.co/api/v2/pokemon?limit=151&offset=0')
+        const result: {results: {name: string}[]} = await response.json()
+
+        return result.results.map((item) => ({value: item.name}))
+      },
+      autocompleteProps: {
+        placeholder: 'Search Pokemon',
+      },
+    }),
+    // Search loader: re-runs the loader with the user's query as they type
+    asyncList({
+      schemaType: 'disneyCharacter',
+      loaderType: 'search',
+      loader: async ({query}) => {
+        const url = query
+          ? `https://api.disneyapi.dev/character?name=${encodeURIComponent(query)}`
+          : 'https://api.disneyapi.dev/character'
+
+        const response = await fetch(url)
+        const result: {data: {name: string}[] | {name: string} | null} = await response.json()
+        const characters = Array.isArray(result.data)
+          ? result.data
+          : result.data
+            ? [result.data]
+            : []
+
+        // The API can return multiple characters with the same name, but
+        // option values must be unique
+        const names = new Set<string>()
+        return characters.flatMap((item) => {
+          if (names.has(item.name)) return []
+          names.add(item.name)
+          return [{value: item.name}]
+        })
+      },
+    }),
+  ],
+}))

knip.jsonc

@@ -174,6 +174,15 @@
       ],
     },
     // add new plugin workspaces here
+    "plugins/@sanity/sanity-plugin-async-list": {
+      "entry": ["package.config.ts"],
+      "project": ["src/**/*.{ts,tsx}"],
+      "ignoreDependencies": [
+        // Used by @sanity/pkg-utils babel transform, not directly imported
+        "babel-plugin-styled-components",
+      ],
+    },
+
     "plugins/sanity-plugin-documents-pane": {
       "entry": ["package.config.ts"],
       "project": ["src/**/*.{ts,tsx}"],

plugins/@sanity/sanity-plugin-async-list/CHANGELOG.md

@@ -0,0 +1,91 @@
+# @sanity/sanity-plugin-async-list
+
+## [1.3.3](https://github.com/sanity-io/sanity-plugin-async-list/compare/v1.3.2...v1.3.3) (2025-12-29)
+
+### Bug Fixes
+
+- allow sanity v5 in peer dep ranges ([d90b92d](https://github.com/sanity-io/sanity-plugin-async-list/commit/d90b92d60715012a95c13702dedcbb9ec7ba8400))
+
+## [1.3.2](https://github.com/sanity-io/sanity-plugin-async-list/compare/v1.3.1...v1.3.2) (2025-07-10)
+
+### Bug Fixes
+
+- **deps:** allow studio v4 in peer dep ranges ([2926c2f](https://github.com/sanity-io/sanity-plugin-async-list/commit/2926c2f53c256aea7f6c6e53b6fe3667a5735d6c))
+
+## [1.3.1](https://github.com/sanity-io/sanity-plugin-async-list/compare/v1.3.0...v1.3.1) (2025-04-04)
+
+### Bug Fixes
+
+- add support for react 19 ([#13](https://github.com/sanity-io/sanity-plugin-async-list/issues/13)) ([92e9f8b](https://github.com/sanity-io/sanity-plugin-async-list/commit/92e9f8b75000435acfb5f9b6c713a74f2eb7cd18))
+
+## [1.3.0](https://github.com/sanity-io/sanity-plugin-async-list/compare/v1.2.2...v1.3.0) (2024-12-13)
+
+### Features
+
+- expose client to loader ([#10](https://github.com/sanity-io/sanity-plugin-async-list/issues/10)) ([226331a](https://github.com/sanity-io/sanity-plugin-async-list/commit/226331a63b77bb06a5c2011f30e0ea2b087da316))
+
+## [1.2.2](https://github.com/sanity-io/sanity-plugin-async-list/compare/v1.2.1...v1.2.2) (2024-12-13)
+
+### Bug Fixes
+
+- readonly and docs on schema options ([#9](https://github.com/sanity-io/sanity-plugin-async-list/issues/9)) ([3015c15](https://github.com/sanity-io/sanity-plugin-async-list/commit/3015c150184add8e82906dc15a60cbf452c7a61f))
+
+## [1.2.1](https://github.com/sanity-io/sanity-plugin-async-list/compare/v1.2.0...v1.2.1) (2024-12-13)
+
+### Bug Fixes
+
+- infinite fetch when used as component ([#7](https://github.com/sanity-io/sanity-plugin-async-list/issues/7)) ([6ff14b0](https://github.com/sanity-io/sanity-plugin-async-list/commit/6ff14b020534a1d46fc35ac67e91d0a9ef3bd820))
+
+## [1.2.0](https://github.com/sanity-io/sanity-plugin-async-list/compare/v1.1.1...v1.2.0) (2024-12-08)
+
+### Features
+
+- pass search query back to loader ([#6](https://github.com/sanity-io/sanity-plugin-async-list/issues/6)) ([7794480](https://github.com/sanity-io/sanity-plugin-async-list/commit/7794480f41a4040bddaab359071cd9769bb13ec9))
+
+## [1.1.1](https://github.com/sanity-io/sanity-plugin-async-list/compare/v1.1.0...v1.1.1) (2024-12-06)
+
+### Bug Fixes
+
+- package.json ([a99e8e5](https://github.com/sanity-io/sanity-plugin-async-list/commit/a99e8e5093ac2ec21d0ac74b9b0489a4f95a5213))
+
+## [1.1.0](https://github.com/sanity-io/sanity-plugin-async-list/compare/v1.0.0...v1.1.0) (2024-12-06)
+
+### Features
+
+- expose secrets ([#3](https://github.com/sanity-io/sanity-plugin-async-list/issues/3)) ([f3d5049](https://github.com/sanity-io/sanity-plugin-async-list/commit/f3d50498b9f8992783cb6fd2cb6f4973b4e95b6f))
+
+## 1.0.0 (2024-12-06)
+
+### Features
+
+- add semantic-release workflow ([0919d49](https://github.com/sanity-io/sanity-plugin-async-list/commit/0919d49a8d75162c057eac05d4830742d11682fc))
+- add semver config ([2171b2b](https://github.com/sanity-io/sanity-plugin-async-list/commit/2171b2bd41d95f2accaf99e9bc19503a689d1e9f))
+- remove dry-run ([112d45e](https://github.com/sanity-io/sanity-plugin-async-list/commit/112d45e9f87443418adbb6337a5ee64cb3bf7572))
+- semver workflow ([ec0d82c](https://github.com/sanity-io/sanity-plugin-async-list/commit/ec0d82c27624a9ba8da0723f78f207d4b40de586))
+- swap to yarn ([94d050a](https://github.com/sanity-io/sanity-plugin-async-list/commit/94d050aa30aaae8b8a7f05d8548e2fb72faa7507))
+
+### Bug Fixes
+
+- bump version and pull deps ([c177212](https://github.com/sanity-io/sanity-plugin-async-list/commit/c17721269fe3fcd9e85e148220c4e06907ca7754))
+- deps ([539590a](https://github.com/sanity-io/sanity-plugin-async-list/commit/539590abfddc5721585aa81d43be3e911430fed5))
+- deps for semantic-release ([0b1ae86](https://github.com/sanity-io/sanity-plugin-async-list/commit/0b1ae86705659641101518b56ed3b6d3aa6d9a97))
+- engines ([ca36861](https://github.com/sanity-io/sanity-plugin-async-list/commit/ca36861a0279dd7ef0132d0858444f33107a74fe))
+- env name ([e2d68ea](https://github.com/sanity-io/sanity-plugin-async-list/commit/e2d68ea72344f28cbc7e5bd0197f7917ae8920e2))
+- make public ([b925b17](https://github.com/sanity-io/sanity-plugin-async-list/commit/b925b172029398044fa2ebea05d4a13d17d1f0e3))
+- overrides ([10a1227](https://github.com/sanity-io/sanity-plugin-async-list/commit/10a12277d181f41a76982d521730e3a0b6367784))
+- pull dry-run ([aa1c96f](https://github.com/sanity-io/sanity-plugin-async-list/commit/aa1c96f3fe16af1311f184e5483d556339dd2b1a))
+- regenerate ([4c32e55](https://github.com/sanity-io/sanity-plugin-async-list/commit/4c32e553c93a35d002abd2f4c0dcccd12aff45b9))
+- regenerate package-lock ([5b63a30](https://github.com/sanity-io/sanity-plugin-async-list/commit/5b63a3088b517318accb87a3c7ecf4042f2452c7))
+- regenerate package-lock.json ([ff3d149](https://github.com/sanity-io/sanity-plugin-async-list/commit/ff3d1491a2dac7c032ac3f1568939b9080c1361e))
+- remove semantic-release for now ([87605b6](https://github.com/sanity-io/sanity-plugin-async-list/commit/87605b63ca75dfa0d7e6a50291b097c6ee187d9c))
+- resolutions ([bacefea](https://github.com/sanity-io/sanity-plugin-async-list/commit/bacefea1986d3db9e9b57885036753e0ae84793d))
+- resolve peer deps issues ([a56051b](https://github.com/sanity-io/sanity-plugin-async-list/commit/a56051b7e94bf57b1f527b51d4b70845102e9e03))
+- tweak action ([be5f805](https://github.com/sanity-io/sanity-plugin-async-list/commit/be5f805cfbdd687bbd8177ca76024fbf887010ab))
+- tweak workflow ([4959984](https://github.com/sanity-io/sanity-plugin-async-list/commit/4959984dda49fe85581ef4c2a0bc7c14204fd6dc))
+- ui was being bundled ([8dd8899](https://github.com/sanity-io/sanity-plugin-async-list/commit/8dd889936d6750c85af2a824507b9dada2e045bb))
+- update action ([2edca7f](https://github.com/sanity-io/sanity-plugin-async-list/commit/2edca7fe28629e2e6bb9db0ad8ef2333018dfbdd))
+- updates action ([df9a4ac](https://github.com/sanity-io/sanity-plugin-async-list/commit/df9a4ac5b22330a3043cfdbe6ad0ca1c1a443926))
+
+### Reverts
+
+- add yarn ([54007e7](https://github.com/sanity-io/sanity-plugin-async-list/commit/54007e710f1c9515bd1fd39b4220dcfe53d52c42))