@driftime/sanity-plugin-icon 0.4.1 → 0.4.3

package/README.md

@@ -278,6 +278,37 @@ export const contactIcons: SanityIconName<"lucide">[] = ["mail", "phone", "globe
 
 <br />
 
+### Initial Values
+
+A field's `initialValue` names the icon a new document starts with. Once the build step has run, the name completes as it's typed.
+
+```typescript
+defineField({
+  name: "icon",
+  type: "icon",
+  description: "Icon shown beside the contact method.",
+  options: { library: "lucide", icons: ["mail", "phone", "globe"] },
+  initialValue: { name: "mail" },
+});
+```
+
+The initial value holds only the name. The first time the field is shown, the Studio finds the icon in the field's icon library and stores it with its icon library, style, and drawing. Until then, the stored icon has a name but no drawing, and it fails validation like any other icon in that state. A name the field doesn't offer is left as it is, and during development a message in the console names the field.
+
+Names complete from every icon library the build step listed, not only the field's. A function that returns the initial value needs `SanityIconInitialValue` as its return type, so the name is checked rather than widened to a string.
+
+```typescript
+import type { SanityIconInitialValue } from "@driftime/sanity-plugin-icon";
+
+defineField({
+  name: "icon",
+  type: "icon",
+  description: "Icon shown beside the contact method.",
+  initialValue: (): SanityIconInitialValue => ({ name: "mail" }),
+});
+```
+
+<br />
+
 ### The Project's Own Icons
 
 A folder of SVG files becomes an icon library of its own. It might hold a brand's marks, or a complete icon set drawn for a brand or a product. Pass the folder's path, relative to the project, to the build step under an identifier. Fields then name that identifier as their icon library.
@@ -349,7 +380,7 @@ When nothing readable is stored, it returns `undefined` and the preview falls ba
 
 ## Site
 
-On the site, one component draws a stored icon, and it's imported from `@driftime/sanity-plugin-icon/render`. That path carries no Studio code, so it's safe in server components and anywhere else on the site.
+On the site, `Icon` draws a stored icon, and `getIcon` finds an icon the site chooses itself. Both are imported from `@driftime/sanity-plugin-icon/render`. That path carries no Studio code, so it's safe in server components and anywhere else on the site.
 
 <br />
 
@@ -400,6 +431,41 @@ An icon needs nothing special in a query. It comes back as a plain object with t
 
 <br />
 
+### Looking Up Icons
+
+Some icons are chosen by the site rather than by an author, such as a default for an icon field left empty. `getIcon` finds an icon by name in an installed icon library and returns it as the Studio stores it, so `Icon` draws it the same way as an icon an author chose.
+
+```tsx
+import { getIcon, Icon } from "@driftime/sanity-plugin-icon/render";
+import type { SanityIcon } from "@driftime/sanity-plugin-icon/render";
+
+interface FeatureProps {
+  icon: SanityIcon | undefined;
+  title: string;
+}
+
+export async function Feature({ icon, title }: FeatureProps) {
+  const value = icon ?? (await getIcon({ library: "lucide", name: "house" }));
+
+  return (
+    <article>
+      <Icon value={value} className="size-8" />
+      <h3>{title}</h3>
+    </article>
+  );
+}
+```
+
+| Input     | Type                | Default             | Purpose                                                                     |
+| --------- | ------------------- | ------------------- | --------------------------------------------------------------------------- |
+| `library` | `SanityIconLibrary` | required            | The identifier of the icon library.                                         |
+| `style`   | `SanityIconStyle`   | the library's first | The style the icon is drawn in.                                             |
+| `name`    | `SanityIconName`    | required            | The icon's name, which completes as it's typed once the build step has run. |
+
+It reads the icon libraries the build step converts, so the site's own build needs the build step, as [Adding the Build Step](#adding-the-build-step) describes. It returns `undefined` when the build step hasn't run, or when the icon library, style, or name isn't installed. The first call for a style loads every icon in that style, so it suits server components and images rendered on the server better than the browser.
+
+<br />
+
 ## Reference
 
 The rest of this document covers the shape of a stored icon and everything the package exports.
@@ -450,6 +516,7 @@ The drawing is written with the name, which is what lets an icon render without
 | `iconLibraries(options?)`  | `@driftime/sanity-plugin-icon/vite`   | The build step as a Vite plugin, for a framework's list. |
 | `withIcons(options?)`      | `@driftime/sanity-plugin-icon/next`   | Adds the build step to a Next.js configuration.          |
 | `Icon`                     | `@driftime/sanity-plugin-icon/render` | Draws a stored icon.                                     |
+| `getIcon(lookup)`          | `@driftime/sanity-plugin-icon/render` | Finds an icon by name in an installed icon library.      |
 
 <br />
 
@@ -460,6 +527,7 @@ The drawing is written with the name, which is what lets an icon render without
 | `SanityIconConfig`            | `@driftime/sanity-plugin-icon`        | Everything `iconPlugin` accepts.                                      |
 | `SanityIconOptions`           | `@driftime/sanity-plugin-icon`        | The `options` an icon field accepts.                                  |
 | `SanityIconDefinition`        | `@driftime/sanity-plugin-icon`        | A field or array member of type `icon`.                               |
+| `SanityIconInitialValue`      | `@driftime/sanity-plugin-icon`        | The icon a field starts with.                                         |
 | `SanityIconSelection`         | `@driftime/sanity-plugin-icon`        | An icon library with a style and icons checked against it.            |
 | `SanityIconLibrary`           | `@driftime/sanity-plugin-icon`        | The identifier of a supported icon library.                           |
 | `SanityIconStyle`             | `@driftime/sanity-plugin-icon`        | The styles of an icon library, given its identifier.                  |
@@ -471,6 +539,7 @@ The drawing is written with the name, which is what lets an icon render without
 | `SanityIconWebpackCustomizer` | `@driftime/sanity-plugin-icon/next`   | A Next.js `webpack` option the build step runs first.                 |
 | `SanityIconProps`             | `@driftime/sanity-plugin-icon/render` | Everything `Icon` accepts: an `svg` element's props and `value`.      |
 | `SanityIcon`                  | `@driftime/sanity-plugin-icon/render` | A stored icon, with its icon library, its name, and its drawing.      |
+| `SanityIconLookup`            | `@driftime/sanity-plugin-icon/render` | Everything `getIcon` accepts: an icon library, a style, and a name.   |
 
 <br />
 

package/dist/{sets-kepuObH8.js → defaults-BEzCWZtH.js}

@@ -1,5 +1,3 @@
-import { n as isDefined, r as isRecord } from "./utils-COPacfAq.js";
-import { i as parseIconRoot, r as parseIconNode } from "./nodes-DAzj56Xn.js";
 /** Whether this is a development build, the only kind in which the plugin logs. */
 const isDevelopment = process.env.NODE_ENV === "development", prefixStyle = "color: #2276fc";
 /**
@@ -50,41 +48,6 @@ function createLogger(name) {
 }
 /** Package name, used as the prefix on every logged message. */
 const pluginName = "@driftime/sanity-plugin-icon", logger = createLogger(pluginName);
-/**
-* Reads one icon of a converted set, skipping it when its data isn't usable.
-*
-* @param value - The value to read.
-* @returns The icon, or undefined when the value isn't one.
-*/
-function parseIconSetIcon(value) {
-	if (!isRecord(value)) return;
-	let { name, keywords, node, root } = value, parsedNode = parseIconNode(node), parsedRoot = isDefined(root) ? parseIconRoot(root) : void 0;
-	if (typeof name == "string" && Array.isArray(keywords) && isDefined(parsedNode) && (!isDefined(root) || isDefined(parsedRoot))) return {
-		name,
-		keywords: keywords.filter((keyword) => typeof keyword == "string"),
-		node: parsedNode,
-		...isDefined(parsedRoot) && { root: parsedRoot }
-	};
-}
-/**
-* Reads a converted set, keeping only the icons whose data is usable.
-*
-* @param value - The value to read.
-* @returns The set, or undefined when the value isn't one.
-*/
-function parseIconSet(value) {
-	if (!isRecord(value)) return;
-	let { library, style, root, icons } = value, parsedRoot = parseIconRoot(root);
-	if (typeof library == "string" && typeof style == "string" && isDefined(parsedRoot) && Array.isArray(icons)) return {
-		library,
-		style,
-		root: parsedRoot,
-		icons: icons.flatMap((icon) => {
-			let parsed = parseIconSetIcon(icon);
-			return isDefined(parsed) ? [parsed] : [];
-		})
-	};
-}
-export { logger as n, pluginName as r, parseIconSet as t };
+export { pluginName as n, logger as t };
 
-//# sourceMappingURL=sets-kepuObH8.js.map
+//# sourceMappingURL=defaults-BEzCWZtH.js.map

package/dist/defaults-BEzCWZtH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults-BEzCWZtH.js","names":["isDevelopment","process","env","isDevelopment","prefixStyle","createLogger","name","prefix","format","message","info","console","warn","error","createLogger","pluginName","logger","\"NODE_ENV\""],"sources":["../../@repo/lib/environment.ts","../../@repo/lib/logger.ts","../src/config/defaults.ts"],"sourcesContent":["/** Whether this is a development build, the only kind in which the plugin logs. */\nexport const isDevelopment = process.env[\"NODE_ENV\"] === \"development\";\n","import { isDevelopment } from \"./environment\";\n\n/** Console style for the prefix, in the blue the Studio uses for its own messages. */\nconst prefixStyle = \"color: #2276fc\";\n\n/**\n * Creates a logger that prefixes messages with the plugin's name and only logs in development builds.\n * Browser consoles show the prefix in blue.\n *\n * @param name - The package name to prefix messages with.\n * @returns Functions that log progress, a warning, or an error, or format a message to throw.\n */\nexport function createLogger(name: string) {\n  const prefix = `[${name}]`;\n\n  /**\n   * Prefixes a message with the package name.\n   *\n   * @param message - The message.\n   * @returns The prefixed message.\n   */\n  function format(message: string) {\n    return `${prefix} ${message}`;\n  }\n\n  return {\n    /**\n     * Logs progress worth seeing, such as what a build step did, in development builds only.\n     *\n     * @param message - What happened.\n     */\n    info(message: string) {\n      if (isDevelopment) console.info(`%c${prefix}%c ${message}`, prefixStyle, \"\");\n    },\n    /**\n     * Logs a warning about something the plugin recovered from, in development builds only.\n     *\n     * @param message - What happened and what to do about it.\n     */\n    warn(message: string) {\n      if (isDevelopment) console.warn(`%c${prefix}%c ${message}`, prefixStyle, \"\");\n    },\n    /**\n     * Logs an error the plugin couldn't recover from, in development builds only.\n     *\n     * @param message - What went wrong and what to do about it.\n     */\n    error(message: string) {\n      if (isDevelopment) console.error(`%c${prefix}%c ${message}`, prefixStyle, \"\");\n    },\n    format,\n  };\n}\n","import { createLogger } from \"@repo/lib/logger\";\n\n/** Package name, used as the prefix on every logged message. */\nexport const pluginName = \"@driftime/sanity-plugin-icon\";\n\n/** The package's logger. */\nexport const logger = createLogger(pluginName);\n"],"mappings":";AACA,MAAaA,gBAAgBC,QAAQC,IAAIe,aAAgB,eCEnDb,cAAc;;;;;;;;AASpB,SAAgBC,aAAaC,MAAc;CACzC,IAAMC,SAAS,IAAID,KAAI;;;;;;;CAQvB,SAASE,OAAOC,SAAiB;EAC/B,OAAO,GAAGF,OAAM,GAAIE;CACtB;CAEA,OAAO;;;;;;EAMLC,KAAKD,SAAiB;GACpB,AAAIN,iBAAeQ,QAAQD,KAAK,KAAKH,OAAM,KAAME,WAAWL,aAAa,EAAE;EAC7E;;;;;;EAMAQ,KAAKH,SAAiB;GACpB,AAAIN,iBAAeQ,QAAQC,KAAK,KAAKL,OAAM,KAAME,WAAWL,aAAa,EAAE;EAC7E;;;;;;EAMAS,MAAMJ,SAAiB;GACrB,AAAIN,iBAAeQ,QAAQE,MAAM,KAAKN,OAAM,KAAME,WAAWL,aAAa,EAAE;EAC9E;EACAI;CACF;AACF;;ACjDA,MAAaO,aAAa,gCAGbC,SAASF,aAAaC,UAAU"}

package/dist/index.d.ts

@@ -1,52 +1,13 @@
-import { n as iconTypeName, t as SanityIcon } from "./types-qlHEYDoN.js";
+import { a as SanityIconName, i as SanityIconLibrary, n as ListedLibraryId, o as SanityIconStyle, r as SanityIcon, s as iconTypeName, t as IconLibraryId } from "./types-D9GjPlhU.js";
 import { t as SanityIconBuildOptions } from "./vite-ifICG8y9.js";
-import { BaseSchemaTypeOptions, TypeAliasDefinition } from "sanity";
+import { BaseSchemaTypeOptions, InitialValueProperty, TypeAliasDefinition } from "sanity";
 import { ComponentProps } from "react";
-import { SanityIconNames } from "@driftime/sanity-plugin-icon/names";
-/**
- * Styles of each library the plugin supports, the first being the default. For a library published as a family of
- * packages, its styles are the packages it publishes, and the installed ones are used.
- */
-declare const iconLibraryStyles: {
-  readonly central: ("round-filled-radius-0-stroke-1" | "round-filled-radius-0-stroke-1.5" | "round-filled-radius-0-stroke-2" | "round-filled-radius-1-stroke-1" | "round-filled-radius-1-stroke-1.5" | "round-filled-radius-1-stroke-2" | "round-filled-radius-2-stroke-1" | "round-filled-radius-2-stroke-1.5" | "round-filled-radius-2-stroke-2" | "round-filled-radius-3-stroke-1" | "round-filled-radius-3-stroke-1.5" | "round-filled-radius-3-stroke-2" | "round-outlined-radius-0-stroke-1" | "round-outlined-radius-0-stroke-1.5" | "round-outlined-radius-0-stroke-2" | "round-outlined-radius-1-stroke-1" | "round-outlined-radius-1-stroke-1.5" | "round-outlined-radius-1-stroke-2" | "round-outlined-radius-2-stroke-1" | "round-outlined-radius-2-stroke-1.5" | "round-outlined-radius-2-stroke-2" | "round-outlined-radius-3-stroke-1" | "round-outlined-radius-3-stroke-1.5" | "round-outlined-radius-3-stroke-2" | "square-filled-radius-0-stroke-1" | "square-filled-radius-0-stroke-1.5" | "square-filled-radius-0-stroke-2" | "square-outlined-radius-0-stroke-1" | "square-outlined-radius-0-stroke-1.5" | "square-outlined-radius-0-stroke-2")[];
-  readonly heroicons: readonly ["outline", "solid", "mini", "micro"];
-  readonly hugeicons: readonly ["stroke-rounded"];
-  readonly iconoir: readonly ["regular", "solid"];
-  readonly lucide: readonly ["default"];
-  readonly nucleo: readonly ["arcade", "core-essential-fill-24", "core-essential-fill-32", "core-essential-fill-48", "core-essential-outline-24", "core-essential-outline-32", "core-essential-outline-48", "core-fill-24", "core-fill-32", "core-fill-48", "core-outline-24", "core-outline-32", "core-outline-48", "credit-cards", "flags", "glass", "isometric", "micro-bold", "micro-bold-essential", "pixel", "pixel-essential", "sharp", "sharp-essential", "social-media", "ui-essential-fill-12", "ui-essential-fill-18", "ui-essential-fill-duo-18", "ui-essential-outline-12", "ui-essential-outline-18", "ui-essential-outline-duo-18", "ui-fill-12", "ui-fill-18", "ui-fill-duo-18", "ui-outline-12", "ui-outline-18", "ui-outline-duo-18"];
-  readonly phosphor: readonly ["regular", "thin", "light", "bold", "fill", "duotone"];
-  readonly tabler: readonly ["outline", "filled"];
-};
 declare module "@sanity/types" {
   interface IntrinsicDefinitions {
     /** Definition of a field of type `icon`. */
     icon: SanityIconDefinition;
   }
 }
-/** Styles of each supported library, from the plugin's own list. */
-type IconLibraryStyles = typeof iconLibraryStyles;
-/**
- * Identifier of a library the plugin supports.
- *
- * @public
- */
-type SanityIconLibrary = keyof IconLibraryStyles;
-/**
- * Styles a library offers. The project's own icon folders have one style, `default`.
- *
- * @public
- */
-type SanityIconStyle<Library extends string> = Library extends SanityIconLibrary ? IconLibraryStyles[Library][number] : "default";
-/**
- * Names of a library's icons, once the build step has listed the installed version's, or any name before then.
- *
- * @public
- */
-type SanityIconName<Library extends string> = Library extends keyof SanityIconNames ? SanityIconNames[Library] : string;
-/** Libraries the build step has listed, or any identifier before it has, so the project's own folders can be named. */
-type ListedLibraryId = [keyof SanityIconNames] extends [never] ? string & NonNullable<unknown> : Extract<keyof SanityIconNames, string>;
-/** Libraries a field can name: the supported ones, plus the project's own folders. */
-type IconLibraryId = SanityIconLibrary | ListedLibraryId;
 /**
  * A choice of library, style, and icons, where the style and icons are checked against the library.
  *
@@ -72,14 +33,25 @@ type SanityIconOptions = BaseSchemaTypeOptions & (SanityIconSelection | {
   icons?: undefined;
 });
 /**
- * Definition of a field or array member holding an icon, so its options are type-checked like a
+ * Icon a field starts with. The Studio saves its drawing from the field's library the first time the field is shown.
+ *
+ * @public
+ */
+interface SanityIconInitialValue {
+  /** Name of the icon, from any library the build step has listed. */
+  name: SanityIconName<ListedLibraryId>;
+}
+/**
+ * Definition of a field or array member holding an icon, so its options and initial value are type-checked like a
  * built-in type's.
  *
  * @public
  */
-interface SanityIconDefinition extends Omit<TypeAliasDefinition<typeof iconTypeName, undefined>, "options"> {
+interface SanityIconDefinition extends Omit<TypeAliasDefinition<typeof iconTypeName, undefined>, "options" | "initialValue"> {
   /** Options for the field. */
   options?: SanityIconOptions;
+  /** Icon the field starts with, or a function that returns one. */
+  initialValue?: InitialValueProperty<unknown, SanityIconInitialValue>;
 }
 /**
  * Plugin configuration, naming the library every icon field uses unless it names its own.
@@ -120,5 +92,5 @@ type DrawingProps = Omit<ComponentProps<"svg">, "children"> & {
  * @public
  */
 export declare function createIconPreview(value: SanityIcon | undefined): (() => import("react").FunctionComponentElement<DrawingProps>) | undefined;
-export type { SanityIconBuildOptions, SanityIconConfig, SanityIconDefinition, SanityIconLibrary, SanityIconName, SanityIconOptions, SanityIconSelection, SanityIconStyle };
+export type { SanityIconBuildOptions, SanityIconConfig, SanityIconDefinition, SanityIconInitialValue, SanityIconLibrary, SanityIconName, SanityIconOptions, SanityIconSelection, SanityIconStyle };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["SanityIconNames","BaseSchemaTypeOptions","TypeAliasDefinition","iconLibraryStyles","iconTypeName","_0","SanityIconDefinition","sideEffect","IconLibraryStyles","SanityIconLibrary","SanityIconStyle","Library","SanityIconName","ListedLibraryId","NonNullable","Extract","IconLibraryId","SanityIconSelection","SanityIconOptions","Omit","SanityIconConfig","iconPlugin","IconElement","Record","IconNode","IconRoot","IconDrawing","iconSvgAttributes","findDrawingProblem","root","node","parseIconNode","parseIconRoot","resolveIconDrawing","serializeIconDrawing","ComponentProps","IconDrawing","DrawingProps","Omit","Drawing","drawing","JSX","_$__components_drawing0","SanityIcon","createIconPreview","DrawingProps","_$__components_drawing0.DrawingProps"],"sources":["../src/lib/libraries.ts","../src/plugin.ts","../src/lib/nodes.ts","../src/components/drawing.tsx","../src/lib/preview.ts"],"mappings":";;;;;;;;;cAiEa;WACX;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;;YC/DU;;IAER,MAAMM;;;;KAKLE,2BAA2BL;;;;;;KAOpBM,0BAA0BD;;;;;;KAO1BE,gBAAgB,0BAA0BC,gBAAgBF,oBAClED,kBAAkBG;;;;;;KAQVC,eAAe,0BAA0BD,sBAAsBX,kBACvEA,gBAAgBW;;KAIfE,yBAAyBb,4CACjBc,uBACTC,cAAcf;;KAGbgB,gBAAgBP,oBAAoBI;;;;;;KAO7BI,yBACT,WAAWD;;EAEV,SAASL;;EAET,QAAQD,gBAAgBC;;EAExB,QAAQC,eAAeD;KAEzBK;;;;;;;KAQUE,oBAAoBjB,yBAC7BgB;EAAwB;EAAqB;EAAmB;;;;;;;;UAQlDX,6BAA6Ba,KAAKjB,2BAA2BE;;EAE5E,UAAUc;;;;;;;KAQAE,mBAAmBH;;;;;;;;;wBAiBfI,WAAW,QAAQD,oCAAgB;;KC1GvCE,eAAe,iBAAiB,YAAYC,wBAAwB,YAAYD;;KAGhFE,WAAWF;;KAGXG,WAAWF;;UAGNG;;EAEf,MAAMD;;EAEN,MAAMD;;KCuCIa,eAAeC,KAAKH;EAAuC,SAASC;;;;;;;;;wBC1ChEQ,kBAAkB,OAAOD,gDAAsB,yBAAtBD"}
+{"version":3,"file":"index.d.ts","names":["BaseSchemaTypeOptions","InitialValueProperty","TypeAliasDefinition","IconLibraryId","ListedLibraryId","SanityIconName","SanityIconStyle","iconTypeName","_0","SanityIconDefinition","sideEffect","SanityIconSelection","Library","SanityIconOptions","SanityIconInitialValue","Omit","SanityIconConfig","iconPlugin","IconElement","Record","IconNode","IconRoot","IconDrawing","iconSvgAttributes","findDrawingProblem","root","node","parseIconNode","parseIconRoot","resolveIconDrawing","serializeIconDrawing","ComponentProps","IconDrawing","DrawingProps","Omit","Drawing","drawing","JSX","_$__components_drawing0","SanityIcon","createIconPreview","DrawingProps","_$__components_drawing0.DrawingProps"],"sources":["../src/plugin.ts","../src/lib/nodes.ts","../src/components/drawing.tsx","../src/lib/preview.ts"],"mappings":";;;;;YAQY;;IAER,MAAMS;;;;;;;;KASEE,yBACT,WAAWR;;EAEV,SAASS;;EAET,QAAQN,gBAAgBM;;EAExB,QAAQP,eAAeO;KAEzBT;;;;;;;KAQUU,oBAAoBb,yBAC7BW;EAAwB;EAAqB;EAAmB;;;;;;;UAOlDG;;EAEf,MAAMT,eAAeD;;;;;;;;UASNK,6BAA6BM,KAC5Cb,2BAA2BK;;EAI3B,UAAUM;;EAEV,eAAeZ,8BAA8Ba;;;;;;;KAQnCE,mBAAmBL;;;;;;;;;wBAiBfM,WAAW,QAAQD,oCAAgB;;KCnFvCE,eAAe,iBAAiB,YAAYC,wBAAwB,YAAYD;;KAGhFE,WAAWF;;KAGXG,WAAWF;;UAGNG;;EAEf,MAAMD;;EAEN,MAAMD;;KCuCIa,eAAeC,KAAKH;EAAuC,SAASC;;;;;;;;;wBC1ChEQ,kBAAkB,OAAOD,gDAAsB,yBAAtBD"}

package/dist/index.js

@@ -1,7 +1,7 @@
-import { r as pluginName, t as parseIconSet } from "./sets-kepuObH8.js";
+import { n as pluginName, t as logger } from "./defaults-BEzCWZtH.js";
 import { n as isDefined, t as convertCase } from "./utils-COPacfAq.js";
 import { a as resolveIconDrawing, o as serializeIconDrawing } from "./nodes-DAzj56Xn.js";
-import { t as Drawing } from "./drawing-ByrcBbWB.js";
+import { a as splitMatches, i as selectIcons, n as normalizeTerms, o as Drawing, r as requestLibrary, t as iconTypeName } from "./types-v7Qz7ogk.js";
 import { t as getIconSetKey } from "./registry-BEEpqK3z.js";
 import { ChangeIndicator, FieldActionsProvider, FieldActionsResolver, FormField, defineField, definePlugin, defineType, getPublishedId, set, setIfMissing, unset, useFormValue } from "sanity";
 import { c } from "react/compiler-runtime";
@@ -12,7 +12,6 @@ import { Box, Button, Card, Dialog, Flex, Grid, Spinner, Stack, Text, TextInput
 import { SearchIcon } from "@sanity/icons/Search";
 import { WarningOutlineIcon } from "@sanity/icons/WarningOutline";
 import { Popover } from "@sanity/ui/popover";
-import { iconRegistry } from "@driftime/sanity-plugin-icon/sets";
 /**
 * Checks whether a form node has members, as objects and arrays of objects do.
 *
@@ -326,142 +325,6 @@ function Recent(t0) {
 	}), $[22] = props, $[23] = t2, $[24] = t4, $[25] = t5) : t5 = $[25], t5;
 }
 /**
-* Normalises text for search, so hyphenated names and multi-word keywords match the same way.
-*
-* @param value - The text.
-* @returns The normalised text.
-*/
-function normalizeTerms(value) {
-	return value.toLowerCase().replaceAll(/[\s-]+/gu, " ").trim();
-}
-/**
-* Splits text into the parts a search matches and the parts it doesn't, matching the way search does: ignoring case,
-* and treating spaces and hyphens alike.
-*
-* @param text - The text to split.
-* @param query - The normalised search.
-* @returns The parts in order, each with where it starts in the text and whether it matches.
-*/
-function splitMatches(text, query) {
-	if (!isDefined(query)) return [{
-		text,
-		start: 0,
-		match: !1
-	}];
-	let pattern = query.split(" ").map((word) => word.replaceAll(/[$()*+.?[\\\]^{|}]/gu, String.raw`\$&`)).join(String.raw`[\s-]+`), parts = text.split(RegExp(`(${pattern})`, "giu"));
-	return parts.map((part, index) => ({
-		text: part,
-		start: parts.slice(0, index).join("").length,
-		match: index % 2 == 1
-	}));
-}
-/**
-* Narrows the library to the named icons, in the order given. Unknown names are skipped, so a list keeps working
-* across library releases.
-*
-* @param library - Every icon in the library.
-* @param names - The icons to offer, or undefined for all of them.
-* @returns The icons to offer.
-*/
-function selectIcons(library, names) {
-	if (!isDefined(names)) return library;
-	let byName = new Map(library.map((icon) => [icon.name, icon]));
-	return [...new Set(names)].flatMap((name) => {
-		let icon = byName.get(name);
-		return isDefined(icon) ? [icon] : [];
-	});
-}
-/**
-* Lists identifiers as inline code, separated by commas.
-*
-* @param identifiers - The identifiers.
-* @returns The list.
-*/
-function formatList(identifiers) {
-	return identifiers.map((identifier) => `\`${identifier}\``).join(", ");
-}
-/**
-* Describes why a library the project hasn't installed can't be shown, and what to add.
-*
-* @param label - Readable name of the library.
-* @param packageName - Package the library is read from, or an example of one for a family of packages.
-* @param family - Whether the library is a family of packages, one per style.
-* @param listed - Whether the project's `package.json` lists the package.
-* @param sitePackage - Another package of the library the project lists, or undefined when there's none.
-* @returns The problem.
-*/
-function describeMissingLibrary(label, packageName, family, listed, sitePackage) {
-	return listed ? {
-		title: `${label} isn't installed yet`,
-		description: `\`${packageName}\` is in \`package.json\` but not in \`node_modules\`. Reinstall the project's dependencies.`
-	} : isDefined(sitePackage) ? {
-		title: `${label} needs \`${packageName}\``,
-		description: `The Studio reads ${label} from \`${packageName}\`, not \`${sitePackage}\`. Add it as a dev dependency.`
-	} : {
-		title: `${label} isn't installed`,
-		description: family ? `Install a ${label} style package, such as \`${packageName}\`.` : `Install \`${packageName}\` in the project.`
-	};
-}
-/**
-* Loads one library style from the sets the build step converted.
-*
-* @param library - Identifier of the library, or undefined when none is set.
-* @param style - Identifier of the style, or undefined for the library's default.
-* @returns The icons, or why they can't be shown.
-*/
-async function readLibrary(library, style) {
-	if (!isDefined(library)) return { problem: {
-		title: "No icon library set",
-		description: "Set `library` in the icon plugin's configuration or in the field's options."
-	} };
-	if (!iconRegistry.ready) return { problem: {
-		title: "Icons aren't set up",
-		description: "Add `withIcons()` to the Studio's build configuration, then restart the Studio."
-	} };
-	let info = iconRegistry.libraries[library];
-	if (!isDefined(info)) return { problem: {
-		title: "Unknown icon library",
-		description: `There's no icon library called \`${library}\`. Use one of: ${formatList(Object.keys(iconRegistry.libraries))}.`
-	} };
-	let { label, packageName, packagePrefix, styles, listed, installed, sitePackage } = info;
-	if (!installed) return { problem: describeMissingLibrary(label, packageName, isDefined(packagePrefix), listed, sitePackage) };
-	let resolvedStyle = style ?? styles[0] ?? "", loader = iconRegistry.sets[getIconSetKey(library, resolvedStyle)];
-	if (!isDefined(loader)) return { problem: isDefined(packagePrefix) ? {
-		title: `${label} style \`${resolvedStyle}\` isn't installed`,
-		description: `Install \`${packagePrefix}${resolvedStyle}\` in the project.`
-	} : {
-		title: `Unknown ${label} style`,
-		description: `${label} has no \`${resolvedStyle}\` style. Use one of: ${formatList(styles)}.`
-	} };
-	let module = await loader(), set = parseIconSet(module.default);
-	return isDefined(set) ? { icons: set.icons.map(({ name, keywords, node, root }) => ({
-		name,
-		label: convertCase(name, "title"),
-		tags: keywords.join(", "),
-		drawing: {
-			root: root ?? set.root,
-			node
-		},
-		terms: normalizeTerms([name, ...keywords].join(" "))
-	})) } : { problem: {
-		title: `Couldn't load ${label}`,
-		description: "Restart the Studio and try again."
-	} };
-}
-/** Library requests shared by every field in the session, keyed by library and style, since the data never changes. */
-const libraryRequests = /* @__PURE__ */ new Map();
-/**
-* Loads a library style, reusing a request already in progress.
-*
-* @param library - Identifier of the library, or undefined when none is set.
-* @param style - Identifier of the style, or undefined for the library's default.
-* @returns The icons, or why they can't be shown.
-*/
-async function requestLibrary(library, style) {
-	let key = getIconSetKey(library ?? "", style ?? ""), request = libraryRequests.get(key);
-	return isDefined(request) || (request = readLibrary(library, style), libraryRequests.set(key, request)), await request;
-}
-/**
 * Gap between the tooltip and its cell, set through margins because `@sanity/ui` offers no other way.
 * Only the top is set, since the tooltip always appears above the cell.
 */
@@ -938,8 +801,23 @@ function resolveIconOptions(options, config) {
 		icons
 	};
 }
-/** Schema type name of the icon object. */
-const iconTypeName = "icon";
+/**
+* Creates the patches that store an icon, with the library and style it was chosen from.
+*
+* @param icon - The icon.
+* @param library - Identifier of the library, or undefined when none is set.
+* @param style - Identifier of the style, or undefined for the library's default.
+* @returns The patches.
+*/
+function createSelectionPatches(icon, library, style) {
+	return [
+		setIfMissing({ _type: iconTypeName }),
+		isDefined(library) ? set(library, ["library"]) : unset(["library"]),
+		isDefined(style) ? set(style, ["style"]) : unset(["style"]),
+		set(icon.name, ["name"]),
+		set(serializeIconDrawing(icon.drawing), ["node"])
+	];
+}
 /**
 * Creates the icon field input, bound to the plugin's configuration. A field's own icons replace the
 * plugin's rather than adding to them.
@@ -949,39 +827,54 @@ const iconTypeName = "icon";
 */
 function createInput(config) {
 	function Input(t0) {
-		let $ = c(35), { id, schemaType, value, onChange, readOnly } = t0, { library: storedLibrary, name, node } = value ?? {}, [open, setOpen] = useState(!1), t1;
-		$[0] === schemaType.options ? t1 = $[1] : (t1 = resolveIconOptions(schemaType.options, config), $[0] = schemaType.options, $[1] = t1);
-		let { library, style, icons } = t1, selectedDrawing = resolveIconDrawing(node), selectedName = storedLibrary === library ? name : void 0, selectedLabel = isDefined(name) ? convertCase(name, "title") : void 0, t2;
-		$[2] !== library || $[3] !== onChange || $[4] !== setOpen || $[5] !== style ? (t2 = function handleSelect(icon) {
-			onChange([
-				setIfMissing({ _type: iconTypeName }),
-				isDefined(library) ? set(library, ["library"]) : unset(["library"]),
-				isDefined(style) ? set(style, ["style"]) : unset(["style"]),
-				set(icon.name, ["name"]),
-				set(serializeIconDrawing(icon.drawing), ["node"])
-			]), setOpen(!1);
-		}, $[2] = library, $[3] = onChange, $[4] = setOpen, $[5] = style, $[6] = t2) : t2 = $[6];
-		let handleSelect = t2, T0 = Flex, T1 = Button, t6 = isDefined(selectedDrawing) ? /* @__PURE__ */ jsx(Drawing, {
+		let $ = c(28), { id, schemaType, value, onChange, readOnly } = t0, { library: storedLibrary, name, node } = value ?? {}, [open, setOpen] = useState(!1), { library, style, icons } = resolveIconOptions(schemaType.options, config), selectedDrawing = resolveIconDrawing(node), selectedName = storedLibrary === library ? name : void 0, selectedLabel = isDefined(name) ? convertCase(name, "title") : void 0, undrawnName = isDefined(node) ? void 0 : name;
+		useEffect(() => {
+			let active = !0;
+			return (async function saveDrawing() {
+				if (!isDefined(undrawnName) || readOnly === !0) return;
+				let { icons: libraryIcons } = await requestLibrary(library, style);
+				if (!active || !isDefined(libraryIcons)) return;
+				let icon = selectIcons(libraryIcons, icons).find((candidate) => candidate.name === undrawnName);
+				if (!isDefined(icon)) {
+					logger.warn(`The icon field "${id}" starts with "${undrawnName}", which isn't one of its icons. Change its initialValue.`);
+					return;
+				}
+				onChange(createSelectionPatches(icon, library, style));
+			})(), () => {
+				active = !1;
+			};
+		}, [
+			id,
+			undrawnName,
+			readOnly,
+			library,
+			style,
+			icons,
+			onChange
+		]);
+		let handleSelect = function handleSelect(icon_0) {
+			onChange(createSelectionPatches(icon_0, library, style)), setOpen(!1);
+		}, T0 = Flex, T1 = Button, t4 = isDefined(selectedDrawing) ? /* @__PURE__ */ jsx(Drawing, {
 			drawing: selectedDrawing,
 			width: "1em",
 			height: "1em"
-		}) : /* @__PURE__ */ jsx(SquareDashedIcon, { ...defaultIconProps }), t7 = selectedLabel ?? "Select icon", t8;
-		$[7] === setOpen ? t8 = $[8] : (t8 = () => {
+		}) : /* @__PURE__ */ jsx(SquareDashedIcon, { ...defaultIconProps }), t5 = selectedLabel ?? "Select icon", t6;
+		$[0] === setOpen ? t6 = $[1] : (t6 = () => {
 			setOpen(!0);
-		}, $[7] = setOpen, $[8] = t8);
-		let t9 = isDefined(selectedLabel) ? `${selectedLabel} currently selected` : "Select icon", t10;
-		$[9] !== T1 || $[10] !== id || $[11] !== readOnly || $[12] !== t6 || $[13] !== t7 || $[14] !== t8 || $[15] !== t9 ? (t10 = /* @__PURE__ */ jsx(T1, {
+		}, $[0] = setOpen, $[1] = t6);
+		let t7 = isDefined(selectedLabel) ? `${selectedLabel} currently selected` : "Select icon", t8;
+		$[2] !== T1 || $[3] !== id || $[4] !== readOnly || $[5] !== t4 || $[6] !== t5 || $[7] !== t6 || $[8] !== t7 ? (t8 = /* @__PURE__ */ jsx(T1, {
 			id,
 			type: "button",
 			mode: "ghost",
-			icon: t6,
-			text: t7,
+			icon: t4,
+			text: t5,
 			disabled: readOnly,
-			onClick: t8,
-			"aria-label": t9
-		}), $[9] = T1, $[10] = id, $[11] = readOnly, $[12] = t6, $[13] = t7, $[14] = t8, $[15] = t9, $[16] = t10) : t10 = $[16];
-		let t11;
-		$[17] !== onChange || $[18] !== readOnly || $[19] !== value ? (t11 = isDefined(value) && /* @__PURE__ */ jsx(Button, {
+			onClick: t6,
+			"aria-label": t7
+		}), $[2] = T1, $[3] = id, $[4] = readOnly, $[5] = t4, $[6] = t5, $[7] = t6, $[8] = t7, $[9] = t8) : t8 = $[9];
+		let t9;
+		$[10] !== onChange || $[11] !== readOnly || $[12] !== value ? (t9 = isDefined(value) && /* @__PURE__ */ jsx(Button, {
 			type: "button",
 			mode: "ghost",
 			tone: "critical",
@@ -992,9 +885,9 @@ function createInput(config) {
 				onChange(unset());
 			},
 			"aria-label": "Clear the selected icon"
-		}), $[17] = onChange, $[18] = readOnly, $[19] = value, $[20] = t11) : t11 = $[20];
-		let t12;
-		$[21] !== handleSelect || $[22] !== icons || $[23] !== id || $[24] !== library || $[25] !== open || $[26] !== selectedName || $[27] !== setOpen || $[28] !== style ? (t12 = open && /* @__PURE__ */ jsx(Picker, {
+		}), $[10] = onChange, $[11] = readOnly, $[12] = value, $[13] = t9) : t9 = $[13];
+		let t10;
+		$[14] !== handleSelect || $[15] !== icons || $[16] !== id || $[17] !== library || $[18] !== open || $[19] !== selectedName || $[20] !== setOpen || $[21] !== style ? (t10 = open && /* @__PURE__ */ jsx(Picker, {
 			id: `${id}-library`,
 			library,
 			iconStyle: style,
@@ -1007,16 +900,16 @@ function createInput(config) {
 			onClickOutside: () => {
 				setOpen(!1);
 			}
-		}), $[21] = handleSelect, $[22] = icons, $[23] = id, $[24] = library, $[25] = open, $[26] = selectedName, $[27] = setOpen, $[28] = style, $[29] = t12) : t12 = $[29];
-		let t13;
-		return $[30] !== T0 || $[31] !== t10 || $[32] !== t11 || $[33] !== t12 ? (t13 = /* @__PURE__ */ jsxs(T0, {
+		}), $[14] = handleSelect, $[15] = icons, $[16] = id, $[17] = library, $[18] = open, $[19] = selectedName, $[20] = setOpen, $[21] = style, $[22] = t10) : t10 = $[22];
+		let t11;
+		return $[23] !== T0 || $[24] !== t10 || $[25] !== t8 || $[26] !== t9 ? (t11 = /* @__PURE__ */ jsxs(T0, {
 			gap: 2,
 			children: [
-				t10,
-				t11,
-				t12
+				t8,
+				t9,
+				t10
 			]
-		}), $[30] = T0, $[31] = t10, $[32] = t11, $[33] = t12, $[34] = t13) : t13 = $[34], t13;
+		}), $[23] = T0, $[24] = t10, $[25] = t8, $[26] = t9, $[27] = t11) : t11 = $[27], t11;
 	}
 	return Input;
 }