@yahoo/uds-create-config 4.11.0 → 4.12.1

package/dist/entities/native/NativeStyleProperty.d.ts

@@ -30,7 +30,14 @@ declare const rnStyleKey: z.ZodEnum<{
   overflow: "overflow";
   padding: "padding";
   width: "width";
+  elevation: "elevation";
   fontFamily: "fontFamily";
+  fontSize: "fontSize";
+  fontStyle: "fontStyle";
+  fontVariant: "fontVariant";
+  fontWeight: "fontWeight";
+  letterSpacing: "letterSpacing";
+  pointerEvents: "pointerEvents";
   alignContent: "alignContent";
   alignItems: "alignItems";
   alignSelf: "alignSelf";
@@ -72,7 +79,6 @@ declare const rnStyleKey: z.ZodEnum<{
   boxShadow: "boxShadow";
   boxSizing: "boxSizing";
   columnGap: "columnGap";
-  elevation: "elevation";
   experimental_backgroundImage: "experimental_backgroundImage";
   experimental_backgroundPosition: "experimental_backgroundPosition";
   experimental_backgroundRepeat: "experimental_backgroundRepeat";
@@ -82,10 +88,6 @@ declare const rnStyleKey: z.ZodEnum<{
   flexGrow: "flexGrow";
   flexShrink: "flexShrink";
   flexWrap: "flexWrap";
-  fontSize: "fontSize";
-  fontStyle: "fontStyle";
-  fontVariant: "fontVariant";
-  fontWeight: "fontWeight";
   includeFontPadding: "includeFontPadding";
   insetBlock: "insetBlock";
   insetBlockEnd: "insetBlockEnd";
@@ -94,7 +96,6 @@ declare const rnStyleKey: z.ZodEnum<{
   insetInlineEnd: "insetInlineEnd";
   insetInlineStart: "insetInlineStart";
   justifyContent: "justifyContent";
-  letterSpacing: "letterSpacing";
   lineHeight: "lineHeight";
   marginBlock: "marginBlock";
   marginBlockEnd: "marginBlockEnd";
@@ -135,7 +136,6 @@ declare const rnStyleKey: z.ZodEnum<{
   paddingStart: "paddingStart";
   paddingTop: "paddingTop";
   paddingVertical: "paddingVertical";
-  pointerEvents: "pointerEvents";
   resizeMode: "resizeMode";
   rotation: "rotation";
   rowGap: "rowGap";
@@ -172,7 +172,7 @@ declare const NativeStyleProperty: EntityClass<z.ZodObject<Omit<{
   arbitrary: z.ZodDefault<z.ZodBoolean>;
   negates: z.ZodDefault<z.ZodBoolean>;
   opacityOf: z.ZodOptional<z.ZodLazy<z.ZodType<Ref, unknown, z.core.$ZodTypeInternals<Ref, unknown>>>>;
-}, "values" | "properties" | "classPrefix"> & {
+}, "values" | "classPrefix" | "properties"> & {
   properties: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEnum<{
     filter: "filter";
     transform: "transform";
@@ -197,7 +197,14 @@ declare const NativeStyleProperty: EntityClass<z.ZodObject<Omit<{
     overflow: "overflow";
     padding: "padding";
     width: "width";
+    elevation: "elevation";
     fontFamily: "fontFamily";
+    fontSize: "fontSize";
+    fontStyle: "fontStyle";
+    fontVariant: "fontVariant";
+    fontWeight: "fontWeight";
+    letterSpacing: "letterSpacing";
+    pointerEvents: "pointerEvents";
     alignContent: "alignContent";
     alignItems: "alignItems";
     alignSelf: "alignSelf";
@@ -239,7 +246,6 @@ declare const NativeStyleProperty: EntityClass<z.ZodObject<Omit<{
     boxShadow: "boxShadow";
     boxSizing: "boxSizing";
     columnGap: "columnGap";
-    elevation: "elevation";
     experimental_backgroundImage: "experimental_backgroundImage";
     experimental_backgroundPosition: "experimental_backgroundPosition";
     experimental_backgroundRepeat: "experimental_backgroundRepeat";
@@ -249,10 +255,6 @@ declare const NativeStyleProperty: EntityClass<z.ZodObject<Omit<{
     flexGrow: "flexGrow";
     flexShrink: "flexShrink";
     flexWrap: "flexWrap";
-    fontSize: "fontSize";
-    fontStyle: "fontStyle";
-    fontVariant: "fontVariant";
-    fontWeight: "fontWeight";
     includeFontPadding: "includeFontPadding";
     insetBlock: "insetBlock";
     insetBlockEnd: "insetBlockEnd";
@@ -261,7 +263,6 @@ declare const NativeStyleProperty: EntityClass<z.ZodObject<Omit<{
     insetInlineEnd: "insetInlineEnd";
     insetInlineStart: "insetInlineStart";
     justifyContent: "justifyContent";
-    letterSpacing: "letterSpacing";
     lineHeight: "lineHeight";
     marginBlock: "marginBlock";
     marginBlockEnd: "marginBlockEnd";
@@ -302,7 +303,6 @@ declare const NativeStyleProperty: EntityClass<z.ZodObject<Omit<{
     paddingStart: "paddingStart";
     paddingTop: "paddingTop";
     paddingVertical: "paddingVertical";
-    pointerEvents: "pointerEvents";
     resizeMode: "resizeMode";
     rotation: "rotation";
     rowGap: "rowGap";

package/dist/entities/system/CanvasRole.d.ts

@@ -15,7 +15,7 @@ import { z } from "zod";
  * one ("mirrors `@yahoo/uds-create-config`'s `CanvasRole` union without importing it") — a second
  * source of truth wearing a comment admitting it.
  */
-declare const CANVAS_ROLES: readonly ["frame", "text", "image"];
+declare const CANVAS_ROLES: readonly ["frame", "text", "image", "icon"];
 type CanvasRoleName = (typeof CANVAS_ROLES)[number];
 declare const CanvasRole: EntityClass<z.ZodObject<{
   entries: z.ZodArray<z.ZodObject<{
@@ -24,6 +24,10 @@ declare const CanvasRole: EntityClass<z.ZodObject<{
     }, z.core.$strip>;
     default: z.ZodOptional<z.ZodBoolean>;
     defaultProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    props: z.ZodOptional<z.ZodObject<{
+      glyph: z.ZodString;
+      axes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
   }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<Record<never, never>, z.core.$strip>, "canvas-role", {
   readonly create: {

package/dist/entities/system/CanvasRole.js

@@ -30,14 +30,19 @@ import { z } from "zod";
 const CANVAS_ROLES = [
 	"frame",
 	"text",
-	"image"
+	"image",
+	"icon"
 ];
 const CanvasRole = defineEntity({
 	kind: "canvas-role",
 	fields: z.object({ entries: z.array(z.object({
 		component: Component.describe("The component this tool inserts, as a ref: `{ \"__ref\": \"component:<path>\" }`."),
 		default: z.boolean().optional().describe("The entry the tool inserts when none is chosen; mark one."),
-		defaultProps: z.record(z.string(), z.unknown()).optional().describe("Props the inserted component starts with, keyed by prop name.")
+		defaultProps: z.record(z.string(), z.unknown()).optional().describe("Props the inserted component starts with, keyed by prop name."),
+		props: z.object({
+			glyph: z.string().describe("The prop that takes the glyph: one whose domain is an icon library (`name: { type: \"variant\", value: Icon.ref(\"icons\") }`). Its libraries are what the picker offers."),
+			axes: z.array(z.string()).optional().describe("The props the picker offers as axes (`variant`, `size`), each with the values the prop itself declares.")
+		}).optional().describe("What the tool exposes of the component. Read by the `icon` role: the picker draws every glyph through this component and offers the named props as its axes.")
 	})).describe(`The components a canvas insert tool draws with. The entity's path is the tool: one of ${CANVAS_ROLES.map((role) => `\`${role}\``).join(", ")}. A role with no entity registered has its tool disabled.`) }),
 	schemas: { create: { description: `Register a canvas insert tool for this system. \`path\` is the role, one of ${CANVAS_ROLES.map((role) => `\`${role}\``).join(", ")}; \`data.entries\` names the components that tool inserts, one marked \`default\`. A system whose roles are unregistered has those canvas tools disabled, so register \`frame\` and \`text\` once a layout primitive and a text primitive exist.` } }
 });

package/dist/entities/system/Component.js

@@ -1,18 +1,17 @@
-import { reject, rejectData } from "../../framework/rejection.js";
 import { canonicalCondition, isRef, kindOf, memberOf, pathOf, ref, refLeaf, refSchema, splitRef } from "../../framework/utils/refs.js";
+import { childrenPolicy } from "./element.js";
+import { reject, rejectData } from "../../framework/rejection.js";
 import { isPlainObject } from "../../framework/utils/field-path.js";
 import { pathInput } from "../../framework/schemas.js";
 import { defineEntity } from "../../framework/defineEntity.js";
 import { defineSubEntity } from "../../framework/defineSubEntity.js";
 import { derivedColor, gradient } from "./color.js";
-import { childrenPolicy } from "./element.js";
 import { listedIn } from "../../framework/utils/enumerated.js";
 import { valueSchemaOf } from "../../framework/value-domain.js";
 import { glyphLeafOf } from "./glyph-identity.js";
 import { Style, addBagKeyIssues, anatomyPropValue, bagNameEdges, bagRewriteName, bindBagTokens, collectBag, isPlainRecord, openBag, styleValue } from "./style-bag.js";
 import { storedPreview } from "../../framework/preview-store.js";
 import { glyphPropsOf, propValueDomain, refListOf, resolveComponentProps, stylePropValueLeaves, validateComponentProps } from "../../framework/projections.js";
-import { intoName, routedPropIn, routesContent } from "../../framework/prop-surface.js";
 import { slotAnatomyPropOf, slotTargetsOf, withoutTruthyTerm } from "../../framework/render-spec.js";
 import { listSlots, namedSlots, slotHostedBy, slotOf } from "../../spec/slot.js";
 import { cellAt } from "../../spec/cell.js";
@@ -20,6 +19,7 @@ import { instanceAt } from "../../spec/instance.js";
 import { Package } from "./Package.js";
 import { File } from "./File.js";
 import { iconDomainInvariants } from "./icon-domain-invariants.js";
+import { intoName, routedPropIn, routesContent } from "../../framework/prop-surface.js";
 import { z } from "zod";
 //#region src/entities/system/Component.ts
 /**

package/dist/entities/system/Icon.d.ts

@@ -12,11 +12,13 @@ import { z } from "zod";
  *  - `{ export: { filled: '{name}Filled' } }`: a variant is another export, named by the template
  *    with `{name}` replaced by the member's name; a variant not listed draws the bare export (Tabler).
  */
+/** @deprecated With the group's `variantAs`; see there. */
 declare const iconVariantAs: z.ZodUnion<readonly [z.ZodObject<{
   prop: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
   export: z.ZodRecord<z.ZodString, z.ZodString>;
 }, z.core.$strict>]>;
+/** @deprecated With the group's `variantAs`; see there. */
 type IconVariantAs = z.infer<typeof iconVariantAs>;
 /**
  * Icon (`icons/AcornIcon`) — one glyph in an icon library. The library (`icons`) is an EMERGENT group

package/dist/entities/system/Icon.js

@@ -14,6 +14,7 @@ import { z } from "zod";
 *  - `{ export: { filled: '{name}Filled' } }`: a variant is another export, named by the template
 *    with `{name}` replaced by the member's name; a variant not listed draws the bare export (Tabler).
 */
+/** @deprecated With the group's `variantAs`; see there. */
 const iconVariantAs = z.union([z.strictObject({ prop: z.string().min(1) }), z.strictObject({ export: z.record(z.string().min(1), z.string().min(1)) })]);
 /**
 * Icon (`icons/AcornIcon`) — one glyph in an icon library. The library (`icons`) is an EMERGENT group
@@ -44,12 +45,17 @@ const Icon = defineEntity({
 		/** Where member metadata comes from and how to read it — `{ from, format }`. The build resolves
 		*  the source and bakes each member's fields; see `icon-metadata.ts`. */
 		metadata: iconMetadataDeclaration.optional(),
-		/** Named sizes the set ships (`sm: 16`). */
+		/** Named sizes the set ships (`sm: 16`).
+		*  @deprecated How a glyph is sized is the icon tool's component's business: the icon tool's component declares its own `size` and `variant` props, and every surface reads those. TODO: remove with a migration once no surface reads the library's copy. */
 		sizes: z.record(z.string(), z.number()).optional(),
-		/** Weights/styles the set ships (`regular`, `fill`). */
+		/** Weights/styles the set ships (`regular`, `fill`).
+		*  @deprecated Which styles a glyph takes is the icon tool's component's business: the icon tool's component declares its own `size` and `variant` props, and every surface reads those. TODO: remove with a migration once no surface reads the library's copy. */
 		variants: z.array(z.string()).optional(),
 		/** How a variant reaches the glyph; see {@link iconVariantAs}. Absent, a variant is dropped at
-		*  render. */
+		*  render.
+		*  @deprecated Only the framework's raw-draw path read it; the icon tool's component passes a
+		*  variant the way its package wants, and a set whose styles are separate exports lists them as
+		*  members. TODO: remove with `sizes` and `variants`. */
 		variantAs: iconVariantAs.optional()
 	}),
 	groupComputed: {

package/dist/entities/system/Modifier.d.ts

@@ -27,8 +27,8 @@ type WebActivation = (typeof WEB_ACTIVATIONS)[number];
  */
 declare const modifierGroupFields: z.ZodObject<{
   type: z.ZodOptional<z.ZodEnum<{
-    mode: "mode";
     state: "state";
+    mode: "mode";
   }>>;
   default: z.ZodOptional<z.ZodObject<{
     __ref: z.ZodString;
@@ -49,8 +49,8 @@ declare const Modifier: EntityClass<z.ZodObject<{
   }, z.core.$strip>, z.ZodObject<Record<never, never>, z.core.$strip>, "composite", Record<never, never>, Record<never, never>, false, Record<never, never>, Record<never, never>>>]>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodOptional<z.ZodEnum<{
-    mode: "mode";
     state: "state";
+    mode: "mode";
   }>>;
   default: z.ZodOptional<z.ZodObject<{
     __ref: z.ZodString;

package/dist/entities/system/copy-plan.js

@@ -1,5 +1,5 @@
-import { rejectData } from "../../framework/rejection.js";
 import { MINTED, collectRefs, isMintedRow, kindOf, pathOf, rewriteRefs, sourceOf, splitRef } from "../../framework/utils/refs.js";
+import { rejectData } from "../../framework/rejection.js";
 import { kindBorrowable } from "../../framework/registry.js";
 import { File } from "./File.js";
 import { componentModuleFilePaths, componentRegistryImports } from "./component-module.js";

package/dist/entities/system/defineComponent.d.ts

@@ -247,10 +247,13 @@ type ValueOf<D> = D extends readonly (infer Member)[] ? Member : D extends {
 /**
  * A glyph as a value: the component an icon library exports. Its `displayName` is the member it is,
  * which is what register stores (`icon:phosphor/XIcon`) and what the renderer resolves back to the
- * component. Sizing is the placing component's business, so the one prop every glyph takes is `size`.
+ * component. Sizing is the placing component's business, and the vocabulary of `size` is the
+ * library's own (one package takes pixels, another a named bucket), so the type states nothing about
+ * it: with the default any glyph fits, and a component that knows its library narrows
+ * (`GlyphComponent<number>`).
  */
-type GlyphComponent = ComponentType<{
-  size?: number;
+type GlyphComponent<Size extends string | number = never> = ComponentType<{
+  size?: Size;
 }>;
 /**
  * The members a ref-delegated domain offers, read off the registered paths: a variant whose domain

package/dist/entities/system/element.d.ts

@@ -58,7 +58,8 @@ declare function renderedElement(config: Config, path: string, seen?: Set<string
  * Elements that may not be given children — React throws when one is.
  *
  * The list is HTML's, not the config's: whether `<input>` takes children is a fact about the DOM, and
- * a design system has no say in it.
+ * a design system has no say in it. `textarea` is not void, but its content is its `value`, and React
+ * refuses children on it the same way.
  */
 declare const VOID_ELEMENTS: ReadonlySet<string>;
 /**

package/dist/entities/system/element.js

@@ -89,7 +89,8 @@ function renderedElement(config, path, seen = /* @__PURE__ */ new Set()) {
 * Elements that may not be given children — React throws when one is.
 *
 * The list is HTML's, not the config's: whether `<input>` takes children is a fact about the DOM, and
-* a design system has no say in it.
+* a design system has no say in it. `textarea` is not void, but its content is its `value`, and React
+* refuses children on it the same way.
 */
 const VOID_ELEMENTS = new Set([
 	"area",
@@ -104,6 +105,7 @@ const VOID_ELEMENTS = new Set([
 	"meta",
 	"param",
 	"source",
+	"textarea",
 	"track",
 	"wbr"
 ]);

package/dist/entities/system/icon-library.d.ts

@@ -5,24 +5,30 @@ import { Icon, IconVariantAs } from "./Icon.js";
 /**
  * An icon library as its group node reads: the path, the stored set facts (`sizes`, `variants`,
  * `package`, `variantAs`, `metadata`) and the computeds the entity declares (`members`, `module`,
- * `version`), plus the per-member and drawer-side facts this projection derives. Typed off
+ * `version`), plus the per-member and component-side facts this projection derives. Typed off
  * `Icon.groups`, so a field added on the entity is visible here without a second declaration.
  */
 type IconLibrary = {
   readonly path: string;
 } & Undefinable<Omit<ReturnType<typeof Icon.groups>[number]['meta'], 'items' | 'sizes' | 'variants'>> & {
+  /** @deprecated The library's copy of what the icon tool's component declares as `size`. TODO: remove
+   *  with the group field. */
   readonly sizes: Readonly<Record<string, number>>;
+  /** @deprecated The library's copy of what the icon tool's component declares as `variant`. TODO:
+   *  remove with the group field. */
   readonly variants: readonly string[];
   /** For a ragged set, the members whose own `variants` differ from the set's, by leaf. A member
    *  listing exactly the set's variants is left out, so the map stays as sparse as the
    *  raggedness. */
   readonly memberVariants?: Readonly<Record<string, readonly string[]>>;
-  /** The variant the library's drawer declares in its `defaultProps` — what a picker seeds when nothing is
+  /** The variant the component bound to the library declares in its `defaultProps` — what a picker seeds when nothing is
    *  stored. Passed through as declared; a policy read validates it against {@link variants}
-   *  before trusting it. */
+   *  before trusting it.
+   *  @deprecated The icon tool's entry carries `defaultProps`; read them through `iconToolOf`. */
   readonly defaultVariant?: string;
-  /** The size bucket the library's drawer declares in its `defaultProps`. Same contract as
-   *  {@link defaultVariant}: declared, not validated. */
+  /** The size bucket the component bound to the library declares in its `defaultProps`. Same contract as
+   *  {@link defaultVariant}: declared, not validated.
+   *  @deprecated As {@link defaultVariant}. */
   readonly defaultSizeKey?: string;
 };
 /** A field that may hold `undefined` may be left out: a computed's `string | undefined` reads as an
@@ -39,6 +45,8 @@ declare function iconLibrary(config: Config | null | undefined, path: string): I
  * With `variants`, the member's own list, only the templates for variants it ships are added: a
  * ragged set's member has no export for the rest, and naming one fails the module's bundle.
  */
+/** @deprecated Reads `variantAs`, which goes with it; a set whose styles are separate exports lists
+ *  them as members, and codegen imports members. */
 declare function glyphExportNames({
   variantAs,
   name,
@@ -85,6 +93,11 @@ declare function resolveIconLibraries({
  * binds nothing — `glyphLibrariesOf` is the one reading of the edge, shared with
  * {@link glyphComponentOf}.
  */
+/**
+ * The libraries the canvas's icon tool offers: those its component's glyph prop is bound to. Empty
+ * when the `icon` canvas role is unregistered, which is also when the tool is disabled.
+ */
+declare function iconToolLibraries(config: Config | null | undefined): IconLibrary[];
 declare function librariesBoundBy({
   config,
   component
@@ -112,6 +125,8 @@ declare function iconCategories(config: Config | null | undefined, libraryPath:
  * same across glyphs. A member listing only variants the set doesn't ship falls back to the set's,
  * so the axis is never empty for a set that ships one.
  */
+/** @deprecated The axis is the icon tool's (`iconToolAxisOptions`); a member's own `variants` stay
+ *  metadata to narrow it by. TODO: rewrite the callers over the tool and remove. */
 declare function memberVariantOptions(library: IconLibrary, member: string): readonly string[];
 /**
  * Whether an element type declares a prop that may survive layer-style projection. A placed
@@ -120,4 +135,4 @@ declare function memberVariantOptions(library: IconLibrary, member: string): rea
  */
 declare function isDeclaredElementProp(config: Config | null | undefined, elementType: string, propName: string): boolean;
 //#endregion
-export { IconLibrary, glyphExportNames, glyphType, iconCategories, iconLibraries, iconLibrary, isDeclaredElementProp, librariesBoundBy, libraryHolding, memberVariantOptions, placedGlyphElement, resolveIconLibraries };
+export { IconLibrary, glyphExportNames, glyphType, iconCategories, iconLibraries, iconLibrary, iconToolLibraries, isDeclaredElementProp, librariesBoundBy, libraryHolding, memberVariantOptions, placedGlyphElement, resolveIconLibraries };

package/dist/entities/system/icon-library.js

@@ -1,8 +1,8 @@
 import { createSliceMemo } from "../../framework/memo.js";
-import { glyphComponentOf, glyphLibrariesOf, resolveComponentProps } from "../../framework/projections.js";
+import { glyphComponentOf, glyphLibrariesOf, iconToolOf, resolveComponentProps } from "../../framework/projections.js";
 import { Component } from "./Component.js";
-import { Icon } from "./Icon.js";
 import { parseGlyphType } from "../../spec/glyph-jsx.js";
+import { Icon } from "./Icon.js";
 //#region src/entities/system/icon-library.ts
 /**
 * Icon-library reads — an icon group's node with its computeds, and the policy reads over it.
@@ -17,7 +17,7 @@ import { parseGlyphType } from "../../spec/glyph-jsx.js";
 *
 * This is the one home for the question "what icon sets does this system have" — Studio owns only
 * UI policy on top (picker state, grid geometry, recents, search ranking). A library is cached on
-* the slices it reads — the set (`icon`), its drawer's defaults (`component`) and the package row
+* the slices it reads — the set (`icon`), its component's defaults (`component`) and the package row
 * its version comes from (`package`) — so it is reference-stable across calls on one config and
 * safe in a dep array.
 */
@@ -40,7 +40,7 @@ function iconLibrary(config, path) {
 }
 /** Per-config cache of {@link iconLibrary} answers. `package` is in the key because the set's
 *  `version` resolves through the package row, not off the group node. The member walk underneath
-*  keys on the icon slice alone, so a component write re-reads only each library's drawer defaults. */
+*  keys on the icon slice alone, so a component write re-reads only each library's component defaults. */
 const librariesOf = createSliceMemo({
 	kinds: [
 		"icon",
@@ -65,21 +65,24 @@ function readIconLibrary(config, path) {
 		sizes: sizes ?? EMPTY_SIZES,
 		variants: variants ?? EMPTY_VARIANTS,
 		...set.memberVariants ? { memberVariants: set.memberVariants } : {},
-		...drawerDefaults({
+		...componentDefaults({
 			config,
 			library: path
 		})
 	};
 }
 /**
-* The defaults the set's drawer declares: the component whose own variant prop names this library
+* The defaults the set's component declares: the component whose own variant prop names this library
 * carries "what a bare glyph looks like", read back here so every picker seeds from that one
 * declaration rather than its own literal. A library no component draws from has no defaults.
+*
+* @deprecated The icon tool's entry carries `defaultProps`. TODO: remove with `defaultVariant` and
+* `defaultSizeKey`.
 */
-function drawerDefaults({ config, library }) {
-	const drawer = glyphComponentOf(config, library);
-	if (!drawer) return {};
-	const defaults = Component.get(config, drawer.path)?.defaultProps;
+function componentDefaults({ config, library }) {
+	const bound = glyphComponentOf(config, library);
+	if (!bound) return {};
+	const defaults = Component.get(config, bound.path)?.defaultProps;
 	const variant = defaults?.variant;
 	const size = defaults?.size;
 	return {
@@ -133,6 +136,8 @@ function sameVariants({ own, declared }) {
 * With `variants`, the member's own list, only the templates for variants it ships are added: a
 * ragged set's member has no export for the rest, and naming one fails the module's bundle.
 */
+/** @deprecated Reads `variantAs`, which goes with it; a set whose styles are separate exports lists
+*  them as members, and codegen imports members. */
 function glyphExportNames({ variantAs, name, variants }) {
 	const names = new Set([name]);
 	if (variantAs && "export" in variantAs) for (const [variant, template] of Object.entries(variantAs.export)) {
@@ -151,15 +156,18 @@ function glyphExportNames({ variantAs, name, variants }) {
 */
 function placedGlyphElement(config, glyph, props = {}) {
 	const parsed = parseGlyphType(glyph);
-	const drawer = parsed && config ? glyphComponentOf(config, parsed.slug) : void 0;
-	if (!parsed || !drawer) return {
+	const bound = parsed && config ? glyphComponentOf(config, parsed.slug) : void 0;
+	if (!parsed || !bound || !config) return {
 		type: glyph,
 		props
 	};
+	const tool = iconToolOf(config);
+	const defaults = tool && tool.component === bound.path ? tool.defaultProps : {};
 	return {
-		type: `component:${drawer.path}`,
+		type: `component:${bound.path}`,
 		props: {
-			[drawer.prop]: parsed.member,
+			...defaults,
+			[bound.prop]: parsed.member,
 			...props
 		}
 	};
@@ -197,6 +205,17 @@ function resolveIconLibraries({ config, hints }) {
 * binds nothing — `glyphLibrariesOf` is the one reading of the edge, shared with
 * {@link glyphComponentOf}.
 */
+/**
+* The libraries the canvas's icon tool offers: those its component's glyph prop is bound to. Empty
+* when the `icon` canvas role is unregistered, which is also when the tool is disabled.
+*/
+function iconToolLibraries(config) {
+	if (!config) return NO_LIBRARIES;
+	const tool = iconToolOf(config);
+	if (!tool) return NO_LIBRARIES;
+	const declaration = resolveComponentProps(config, tool.component)[tool.glyph];
+	return glyphLibrariesOf(declaration?.value).map((path) => iconLibrary(config, path)).filter((library) => library !== void 0);
+}
 function librariesBoundBy({ config, component }) {
 	if (!config) return NO_LIBRARIES;
 	const cache = boundLibrariesOf(config);
@@ -253,6 +272,8 @@ function iconCategories(config, libraryPath) {
 * same across glyphs. A member listing only variants the set doesn't ship falls back to the set's,
 * so the axis is never empty for a set that ships one.
 */
+/** @deprecated The axis is the icon tool's (`iconToolAxisOptions`); a member's own `variants` stay
+*  metadata to narrow it by. TODO: rewrite the callers over the tool and remove. */
 function memberVariantOptions(library, member) {
 	const own = library.memberVariants?.[member];
 	if (!own || own.length === 0) return library.variants;
@@ -281,4 +302,4 @@ function isDeclaredElementProp(config, elementType, propName) {
 	return false;
 }
 //#endregion
-export { glyphExportNames, glyphType, iconCategories, iconLibraries, iconLibrary, isDeclaredElementProp, librariesBoundBy, libraryHolding, memberVariantOptions, placedGlyphElement, resolveIconLibraries };
+export { glyphExportNames, glyphType, iconCategories, iconLibraries, iconLibrary, iconToolLibraries, isDeclaredElementProp, librariesBoundBy, libraryHolding, memberVariantOptions, placedGlyphElement, resolveIconLibraries };

package/dist/entities/system/link-plan.js

@@ -1,5 +1,5 @@
-import { rejectData } from "../../framework/rejection.js";
 import { collectRefs, isMintedRow, ref, sourceOf, splitRef } from "../../framework/utils/refs.js";
+import { rejectData } from "../../framework/rejection.js";
 import { blockedBy } from "../../framework/plan.js";
 import { PIN_KIND, covers, declarationOf, narrowDeclaration } from "./link-declaration.js";
 import { planCopy, sourceEntries } from "./copy-plan.js";

package/dist/framework/Config.d.ts

@@ -72,7 +72,7 @@ interface RecordedSource {
  * The dense-counter `2` a short-lived scheme stamped before the chain existed reads as the mint
  * that replaced it (see `detectedWireVersion`).
  */
-declare const SERIALIZED_CONFIG_VERSION = 20260922013625;
+declare const SERIALIZED_CONFIG_VERSION = 20260923005318;
 interface SerializedConfig {
   /** See {@link SERIALIZED_CONFIG_VERSION}. Always written; a stored artifact may lack it. */
   readonly version: number;

package/dist/framework/Config.js

@@ -1,6 +1,6 @@
+import { ENTITY_PATH_MESSAGE, MINTED, collectRefs, entityRefOf, isEntityPath, isExtendedRef, isMintedRow, isRef, kindOf, memberOf, memberRef, pathOf, qualifyRefs, ref, rewriteRefNamespace, rewriteRefSource, rewriteRefs, singletonRef, sourceOf, splitRef } from "./utils/refs.js";
 import "./config-operation-kind.js";
 import { ConfigFormatError, ConfigRejection, isConfigRejection, issuePath, refusalIssues, reject, rejectData, rejectInvalid, rejectReferrers } from "./rejection.js";
-import { ENTITY_PATH_MESSAGE, MINTED, collectRefs, entityRefOf, isEntityPath, isExtendedRef, isMintedRow, isRef, kindOf, memberOf, memberRef, pathOf, qualifyRefs, ref, rewriteRefNamespace, rewriteRefSource, rewriteRefs, singletonRef, sourceOf, splitRef } from "./utils/refs.js";
 import { describePatch } from "./plan.js";
 import { applyPathDelta, isPlainObject, namedFields, pathSegments, sectionDelta, touchedFields } from "./utils/field-path.js";
 import { METADATA_KEYS, declaredField } from "./utils/field-schema.js";
@@ -4836,7 +4836,7 @@ var Config = class Config {
 	*  links from the provided sources. A declared `linkedKind` with no provided source throws. */
 	hydrateFrom(stored, options) {
 		const claimed = schemaVersionOf(stored);
-		if (claimed > 20260922013625) throw new SchemaVersionTooNew(claimed);
+		if (claimed > 20260923005318) throw new SchemaVersionTooNew(claimed);
 		const wire = upgradeSerializedConfig(stored);
 		if (!Array.isArray(wire.ownedKinds) || typeof wire.items !== "object" || wire.items === null) throw new ConfigFormatError(`Config "${stored.name ?? "system-config"}" cannot be hydrated: this is not a serialized config-v2 config (no "ownedKinds"/"items"). A pre-cutover build artifact converts through the registered cutover migration — import the config type's module (e.g. \`configs/system\`) before hydrating, or port the repo once with \`uds migrate\`.`);
 		const leftover = wire.options;

package/dist/framework/defineEntity.js

@@ -1,5 +1,5 @@
-import { CONFIG_OPERATION_KIND } from "./config-operation-kind.js";
 import { isRef, kindOf, pathOf, ref, refSchema, sourceOf } from "./utils/refs.js";
+import { CONFIG_OPERATION_KIND } from "./config-operation-kind.js";
 import { resolveFields } from "./schemas.js";
 import { buildKind } from "./registry.js";
 import { brandGroup } from "./utils/group.js";

package/dist/framework/inline-sources.js

@@ -1,5 +1,5 @@
-import { rejectData } from "./rejection.js";
 import { MINTED, collectRefs, entityRefOf, isRef, kindOf, pathOf, ref, rewriteRefs, sourceOf } from "./utils/refs.js";
+import { rejectData } from "./rejection.js";
 import { kindBorrowable } from "./registry.js";
 //#region src/framework/inline-sources.ts
 /**

package/dist/framework/plan.js

@@ -1,5 +1,5 @@
-import { isConfigRejection } from "./rejection.js";
 import { splitRef } from "./utils/refs.js";
+import { isConfigRejection } from "./rejection.js";
 //#region src/framework/plan.ts
 /**
 * One line for a patch, read off the patch itself: its kind, what it did, and where. The payload

package/dist/framework/projections.d.ts

@@ -431,13 +431,31 @@ declare function glyphLibrariesOf(domain: unknown): string[];
  */
 declare function glyphPropsOf(config: Config, path: string, seen?: ReadonlySet<string>): Record<string, readonly string[]>;
 /**
- * The component that draws a library's glyphs on their own — the one whose own prop declares the
- * library as its domain (`name: { type: 'variant', value: Icon.ref('phosphor') }`, or a list of
- * libraries that includes it), with that prop. Derived from the components, never declared on the
- * set: the edge runs from the component to the library. `undefined` when no component draws from
- * it, in which case a placed glyph is the member drawn raw.
- *
- * Asked per library, so a system may have one drawer binding several libraries or one drawer per
+ * The canvas's icon tool: the `icon` canvas role's entry, as the component it inserts, the prop that
+ * takes the glyph, the props the picker offers as axes, and the props an inserted instance starts
+ * with. The default entry, else the first; `undefined` when the role is unregistered or its entry
+ * names no glyph prop, which disables the tool.
+ */
+interface IconTool {
+  readonly component: string;
+  readonly glyph: string;
+  readonly axes: readonly string[];
+  readonly defaultProps: Readonly<Record<string, unknown>>;
+}
+declare function iconToolOf(config: Config): IconTool | undefined;
+/** The values an icon tool's axis offers: the leaves of that prop's own domain on the tool's
+ *  component, whether it enumerates them or delegates to a library's facet. */
+declare function iconToolAxisOptions(config: Config, tool: IconTool, axis: string): string[];
+/**
+ * The component that draws a library's glyphs on their own, with the prop that takes the glyph. The
+ * icon tool's component when the `icon` canvas role names one whose glyph prop is bound to the
+ * library; otherwise the component whose own prop declares the library as its domain
+ * (`name: { type: 'variant', value: Icon.ref('phosphor') }`, or a list of libraries that includes
+ * it). Derived from the components, never declared on the set: the edge runs from the component to
+ * the library. `undefined` when no component draws from it, in which case a placed glyph is the
+ * member drawn raw.
+ *
+ * Asked per library, so a system may have one component binding several libraries or one per
  * library. Two components binding the same library resolve to the first in registration order.
  */
 declare function glyphComponentOf(config: Config, library: string): {
@@ -482,6 +500,7 @@ declare function validateComponentProps(config: Config, componentPath: string, p
 declare function previewDefaults(config: Config, path: string,
 /** The cell's own prop values. Given, every `preview({ when })` entry that holds for the cell —
  *  tested against the defaults under these values, as a rule's `when` is — adds its props. */
+
 cell?: Record<string, unknown>): Record<string, unknown>;
 /**
  * Only what the `preview({ when })` entries add for a cell — the props of every condition that holds
@@ -556,4 +575,4 @@ declare function propValueFromAxis(config: Config, path: string, prop: string, v
 /** The `value` a string, number or boolean prop declares as its default, per prop. */
 declare function declaredPropDefaults(props: Record<string, unknown> | undefined): Record<string, unknown>;
 //#endregion
-export { IndexedPreviewCondition, PreviewMatrix, PropDeclaration, StylePropEntry, StylePropertyItem, authoredBag, authoredValue, className, cssPropValue, cssVar, cssVarRef, declaredPropDefaults, declaredPropRouting, glyphComponentOf, glyphLibrariesOf, glyphPropsOf, holdingPreviewConditions, keyedPreviewConditions, memberFromLeaf, memberLeaves, negatedCssValue, opacityPercentage, previewConditionalProps, previewConditions, previewDefaults, previewMatrix, propOwner, propValueDomain, propValueFromAxis, refListOf, renderStyleValue, resolveComponentProps, resolveFieldValue, resolveTokenValue, resolveTokenValueUnder, routedBag, sourceVarPrefix, styleAliasesOf, styleDeclarations, stylePropEntries, stylePropLeafForToken, stylePropNegates, stylePropTokenGroup, stylePropTokenPath, stylePropTokenValues, stylePropValueFromLeaf, stylePropValueLeaves, stylePropValues, stylePropertiesWriting, stylePropertyAccepts, stylePropertyFor, stylePropertyPathFor, validateComponentProps };
+export { IconTool, IndexedPreviewCondition, PreviewMatrix, PropDeclaration, StylePropEntry, StylePropertyItem, authoredBag, authoredValue, className, cssPropValue, cssVar, cssVarRef, declaredPropDefaults, declaredPropRouting, glyphComponentOf, glyphLibrariesOf, glyphPropsOf, holdingPreviewConditions, iconToolAxisOptions, iconToolOf, keyedPreviewConditions, memberFromLeaf, memberLeaves, negatedCssValue, opacityPercentage, previewConditionalProps, previewConditions, previewDefaults, previewMatrix, propOwner, propValueDomain, propValueFromAxis, refListOf, renderStyleValue, resolveComponentProps, resolveFieldValue, resolveTokenValue, resolveTokenValueUnder, routedBag, sourceVarPrefix, styleAliasesOf, styleDeclarations, stylePropEntries, stylePropLeafForToken, stylePropNegates, stylePropTokenGroup, stylePropTokenPath, stylePropTokenValues, stylePropValueFromLeaf, stylePropValueLeaves, stylePropValues, stylePropertiesWriting, stylePropertyAccepts, stylePropertyFor, stylePropertyPathFor, validateComponentProps };