@yahoo/uds-create-config 4.28.3 → 4.29.0

package/dist/framework/Config.d.ts

@@ -943,6 +943,8 @@ declare class Config {
    *  silently disagrees with it. Omitted, one is minted, which is what every non-optimistic caller
    *  wants. */
   apply(patch: Patch, id?: string): this;
+  /** {@link apply}, with the kind's invariants judged now or left to the batch that called this. */
+  private applyPatch;
   /**
    * Several patches as one step: each validates against the state the previous one produced, as
    * {@link apply} would, and the config is derived once at the end rather than once per patch.
@@ -951,8 +953,15 @@ declare class Config {
    * a copy of 2,600 entities takes a third of the time it would one patch at a time, and every
    * patch still lands in `pending` with its own stamp, so the sink and a replay see the same list.
    *
-   * A patch on a source kind goes through {@link apply} on its own, since that is where a pin that
-   * moves retires what was held under its slug, and where the rows its declaration mints re-derive.
+   * The kinds' invariants are judged once, on the state the batch ends on, since an invariant walks
+   * its whole kind and a walk after each of thousands of creates is quadratic in them. The rule
+   * itself is still the per-patch one: a batch that ends invalid is re-applied patch by patch,
+   * checked, and that pass decides, refusing at the patch that broke a rule or accepting a batch no
+   * single patch of which did. So the fast pass can only say yes early, never no.
+   *
+   * A patch on a source kind goes through {@link applyPatch} on its own, since that is where a pin
+   * that moves retires what was held under its slug, and where the rows its declaration mints
+   * re-derive.
    *
    * Several patches are one gesture, so they share one changeset; a single patch carries none.
    */
@@ -1034,6 +1043,8 @@ declare class Config {
   private wholeBodyChange;
   /** The next snapshot for one patch, validated. Pure in `snapshot`; reads metadata off `this`. */
   private computeApply;
+  /** {@link assertInvariants} for each kind a batch wrote, against the state the batch produced. */
+  private assertInvariantsOf;
   /**
    * This config's reads over another snapshot, for a check that wants nothing else: a plain clone
    * with the snapshot swapped in. Unlike {@link at}, it records no parent link for the snapshot, so a
@@ -1042,10 +1053,12 @@ declare class Config {
   private viewOf;
   /**
    * Refuse a state the kind's {@link EntityKind.invariants} reject, or one where a kind declaring
-   * {@link EntityKind.uniqueLeaves} holds a leaf twice. One kind when a patch names it, every kind
-   * after a registration. Never called on hydration.
+   * {@link EntityKind.uniqueLeaves} holds a leaf twice. One kind when a patch names it, the kinds a
+   * batch wrote once it has landed, every kind after a registration. Never called on hydration.
    */
   private assertInvariants;
+  /** The {@link EntityKind.uniqueLeaves} half of {@link assertInvariants} alone. */
+  private assertUniqueLeaves;
   /** One sentence per leaf that two items of `kind` hold, since a leaf has to name one item. */
   private duplicateLeaves;
   /** `patch` with a bare leaf resolved to the path it names — see {@link leafPath}. */

package/dist/framework/Config.js

@@ -1199,7 +1199,11 @@ var Config = class Config {
 	*  silently disagrees with it. Omitted, one is minted, which is what every non-optimistic caller
 	*  wants. */
 	apply(patch, id) {
-		const snapshot = this.computeApply(this.state.snapshot, patch);
+		return this.applyPatch(patch, id, true);
+	}
+	/** {@link apply}, with the kind's invariants judged now or left to the batch that called this. */
+	applyPatch(patch, id, checked) {
+		const snapshot = this.computeApply(this.state.snapshot, patch, "write", checked);
 		const sourceIdentity = this.entityOf(patch.kind)?.sourceIdentity;
 		let { recorded, sources, sourceStates } = this.state;
 		if (sourceIdentity && "path" in patch && movesSource(patch, sourceIdentity)) {
@@ -1232,8 +1236,15 @@ var Config = class Config {
 	* a copy of 2,600 entities takes a third of the time it would one patch at a time, and every
 	* patch still lands in `pending` with its own stamp, so the sink and a replay see the same list.
 	*
-	* A patch on a source kind goes through {@link apply} on its own, since that is where a pin that
-	* moves retires what was held under its slug, and where the rows its declaration mints re-derive.
+	* The kinds' invariants are judged once, on the state the batch ends on, since an invariant walks
+	* its whole kind and a walk after each of thousands of creates is quadratic in them. The rule
+	* itself is still the per-patch one: a batch that ends invalid is re-applied patch by patch,
+	* checked, and that pass decides, refusing at the patch that broke a rule or accepting a batch no
+	* single patch of which did. So the fast pass can only say yes early, never no.
+	*
+	* A patch on a source kind goes through {@link applyPatch} on its own, since that is where a pin
+	* that moves retires what was held under its slug, and where the rows its declaration mints
+	* re-derive.
 	*
 	* Several patches are one gesture, so they share one changeset; a single patch carries none.
 	*/
@@ -1241,13 +1252,35 @@ var Config = class Config {
 		if (patches.length === 0) return this;
 		const changeset = patches.length > 1 ? crypto.randomUUID() : void 0;
 		const stampOf = (patch) => stamp(patch, void 0, changeset);
-		if (patches.some((patch) => this.entityOf(patch.kind)?.sourceIdentity)) return patches.reduce((config, patch) => config.derive({
-			...config.apply(patch).state,
-			pending: [...config.state.pending, stampOf(patch)]
-		}), this);
-		let config = this;
-		for (const patch of patches) config = config.derive({ snapshot: config.computeApply(config.state.snapshot, patch) });
-		return config.derive({ pending: [...this.state.pending, ...patches.map(stampOf)] });
+		const touched = new Set(patches.map((patch) => patch.kind));
+		if (patches.some((patch) => this.entityOf(patch.kind)?.sourceIdentity)) {
+			const land = (checked) => patches.reduce((config, patch) => config.derive({
+				...config.applyPatch(patch, void 0, checked).state,
+				pending: [...config.state.pending, stampOf(patch)]
+			}), this);
+			try {
+				const landed = land(false);
+				landed.assertInvariantsOf(landed.state.snapshot, touched);
+				return landed;
+			} catch {
+				return land(true);
+			}
+		}
+		const land = (checked) => {
+			let config = this;
+			for (const patch of patches) config = config.derive({ snapshot: config.computeApply(config.state.snapshot, patch, "write", checked) });
+			return config;
+		};
+		const settle = () => {
+			try {
+				const landed = land(false);
+				landed.assertInvariantsOf(landed.state.snapshot, touched);
+				return landed;
+			} catch {
+				return land(true);
+			}
+		};
+		return settle().derive({ pending: [...this.state.pending, ...patches.map(stampOf)] });
 	}
 	/**
 	* Replay the pending patches onto a new base — what a remote change calls.
@@ -1273,9 +1306,24 @@ var Config = class Config {
 				const changesetId = entry.changeset;
 				const members = pending.slice(index).filter((member) => member.changeset === changesetId);
 				for (const member of members) replayed.add(member.id);
-				let scratch = snapshot;
+				const fast = () => {
+					try {
+						let landed = snapshot;
+						const touched = /* @__PURE__ */ new Set();
+						for (const member of members) {
+							landed = this.replayOne(landed, member.patch, false);
+							touched.add(member.patch.kind);
+						}
+						this.assertInvariantsOf(landed, touched);
+						return landed;
+					} catch {
+						return;
+					}
+				};
+				const landed = fast();
+				let scratch = landed ?? snapshot;
 				let failed;
-				for (const member of members) try {
+				if (landed === void 0) for (const member of members) try {
 					scratch = this.replayOne(scratch, member.patch);
 				} catch (error) {
 					failed = {
@@ -1330,14 +1378,14 @@ var Config = class Config {
 	* patch may fail because the rows it needs had not been derived yet (the pin it depends on is in
 	* this draft), so the replay derives against what it has built so far and goes once more.
 	*/
-	replayOne(snapshot, patch) {
+	replayOne(snapshot, patch, checked = true) {
 		try {
-			return this.computeApply(snapshot, patch, "replay");
+			return this.computeApply(snapshot, patch, "replay", checked);
 		} catch (error) {
 			const seeded = this.at(snapshot).withDerivedRows().state.snapshot;
 			if (seeded === snapshot) throw error;
 			try {
-				return this.computeApply(seeded, patch, "replay");
+				return this.computeApply(seeded, patch, "replay", checked);
 			} catch {
 				throw error;
 			}
@@ -1425,11 +1473,18 @@ var Config = class Config {
 		}));
 	}
 	/** The next snapshot for one patch, validated. Pure in `snapshot`; reads metadata off `this`. */
-	computeApply(snapshot, incoming, mode = "write") {
+	computeApply(snapshot, incoming, mode = "write", checked = true) {
 		const next = this.computeApplyPatch(snapshot, incoming, mode);
-		this.viewOf(next).assertInvariants(incoming.kind);
+		const view = this.viewOf(next);
+		if (checked) view.assertInvariants(incoming.kind);
+		else view.assertUniqueLeaves(incoming.kind);
 		return next;
 	}
+	/** {@link assertInvariants} for each kind a batch wrote, against the state the batch produced. */
+	assertInvariantsOf(snapshot, kinds) {
+		const view = this.viewOf(snapshot);
+		for (const kind of kinds) view.assertInvariants(kind);
+	}
 	/**
 	* This config's reads over another snapshot, for a check that wants nothing else: a plain clone
 	* with the snapshot swapped in. Unlike {@link at}, it records no parent link for the snapshot, so a
@@ -1446,8 +1501,8 @@ var Config = class Config {
 	}
 	/**
 	* Refuse a state the kind's {@link EntityKind.invariants} reject, or one where a kind declaring
-	* {@link EntityKind.uniqueLeaves} holds a leaf twice. One kind when a patch names it, every kind
-	* after a registration. Never called on hydration.
+	* {@link EntityKind.uniqueLeaves} holds a leaf twice. One kind when a patch names it, the kinds a
+	* batch wrote once it has landed, every kind after a registration. Never called on hydration.
 	*/
 	assertInvariants(kind) {
 		const kinds = kind === void 0 ? [...this.state.entities.keys()] : [kind];
@@ -1457,6 +1512,12 @@ var Config = class Config {
 			if (problems.length > 0) rejectData(`Invalid ${name}: ${problems.join(" ")}`);
 		}
 	}
+	/** The {@link EntityKind.uniqueLeaves} half of {@link assertInvariants} alone. */
+	assertUniqueLeaves(kind) {
+		if (!this.entityOf(kind)?.uniqueLeaves) return;
+		const problems = this.duplicateLeaves(kind);
+		if (problems.length > 0) rejectData(`Invalid ${kind}: ${problems.join(" ")}`);
+	}
 	/** One sentence per leaf that two items of `kind` hold, since a leaf has to name one item. */
 	duplicateLeaves(kind) {
 		const byLeaf = /* @__PURE__ */ new Map();

package/dist/framework/defineEntity.js

@@ -153,15 +153,18 @@ function defineEntity(spec) {
 		},
 		item: (def) => def,
 		group: (meta) => {
-			const body = { ...meta };
+			let body = { ...meta };
 			for (const [key, consume] of Object.entries(spec.groupInputs ?? {})) {
 				if (!(key in body)) continue;
 				const input = body[key];
 				delete body[key];
-				consume({
-					input,
-					body
-				});
+				body = {
+					...body,
+					...consume({
+						input,
+						body
+					})
+				};
 			}
 			return brandGroup(body);
 		},

package/dist/framework/projections.d.ts

@@ -439,25 +439,44 @@ declare function glyphLibrariesOf(domain: unknown): string[];
  */
 declare function glyphPropsOf(config: Config, path: string, seen?: ReadonlySet<string>): Record<string, readonly string[]>;
 /**
- * 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.
+ * One entry of the canvas's `icon` role, read as a tool: the component it inserts, the prop that
+ * takes the glyph, the libraries that prop draws from, the props the picker offers as axes, and the
+ * props an inserted instance starts with. Everything but `defaultProps` is derived from the
+ * component's own declaration when the entry carries no `props` override: the glyph prop is the
+ * prop whose domain is an icon library, and the axes are its other `variant`-typed props, in
+ * declaration order. `props: { glyph, axes }` on the entry overrides either.
  */
 interface IconTool {
   readonly component: string;
   readonly glyph: string;
+  /** The libraries the glyph prop's domain names, in declaration order: what this tool draws. */
+  readonly libraries: readonly string[];
   readonly axes: readonly string[];
   readonly defaultProps: Readonly<Record<string, unknown>>;
 }
+/**
+ * Every tool the `icon` role registers, in entry order. An entry whose component cannot be resolved
+ * or holds no glyph prop is not a tool and is left out; a role with none, or no role, is an empty
+ * list, which is also when the canvas's icon tool is disabled.
+ */
+declare function iconToolsOf(config: Config): readonly IconTool[];
+/**
+ * The canvas's icon tool: the role's default entry, else its first. What a plain click inserts, and
+ * the tool a surface with no library in hand reads.
+ */
 declare function iconToolOf(config: Config): IconTool | undefined;
+/**
+ * The tool a library's glyphs are drawn and placed through: the entry whose glyph prop's domain
+ * covers the library, the default entry when several do. `undefined` for a library no entry draws.
+ */
+declare function iconToolFor(config: Config, library: string): 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
+ * icon tool that covers the library when the `icon` canvas role has one ({@link iconToolFor});
+ * 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
@@ -583,4 +602,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 { 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 };
+export { IconTool, IndexedPreviewCondition, PreviewMatrix, PropDeclaration, StylePropEntry, StylePropertyItem, authoredBag, authoredValue, className, cssPropValue, cssVar, cssVarRef, declaredPropDefaults, declaredPropRouting, glyphComponentOf, glyphLibrariesOf, glyphPropsOf, holdingPreviewConditions, iconToolAxisOptions, iconToolFor, iconToolOf, iconToolsOf, 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 };

package/dist/framework/projections.js

@@ -982,17 +982,29 @@ function glyphPropsOfBody({ config, body, seen = /* @__PURE__ */ new Set() }) {
 	}
 	return out;
 }
+/**
+* Every tool the `icon` role registers, in entry order. An entry whose component cannot be resolved
+* or holds no glyph prop is not a tool and is left out; a role with none, or no role, is an empty
+* list, which is also when the canvas's icon tool is disabled.
+*/
+function iconToolsOf(config) {
+	return iconToolsCache(config).tools;
+}
+/**
+* The canvas's icon tool: the role's default entry, else its first. What a plain click inserts, and
+* the tool a surface with no library in hand reads.
+*/
 function iconToolOf(config) {
-	const entries = (config.resolve("canvas-role", "icon")?.toJSON())?.entries ?? [];
-	const entry = entries.find((candidate) => candidate.default) ?? entries[0];
-	const glyph = entry?.props?.glyph;
-	if (!entry || !glyph || !isRef(entry.component)) return void 0;
-	return {
-		component: pathOf(entry.component),
-		glyph,
-		axes: entry.props?.axes ?? [],
-		defaultProps: entry.defaultProps ?? {}
-	};
+	return iconToolsCache(config).defaultTool;
+}
+/**
+* The tool a library's glyphs are drawn and placed through: the entry whose glyph prop's domain
+* covers the library, the default entry when several do. `undefined` for a library no entry draws.
+*/
+function iconToolFor(config, library) {
+	const { tools, defaultTool } = iconToolsCache(config);
+	if (defaultTool?.libraries.includes(library)) return defaultTool;
+	return tools.find((tool) => tool.libraries.includes(library));
 }
 /** 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. */
@@ -1001,10 +1013,45 @@ function iconToolAxisOptions(config, tool, axis) {
 	if (!declaration) return [];
 	return propValueDomain(config, declaration)?.leaves ?? [];
 }
+/** The tools read once per role and component slice: an entry's derivation walks its component's
+*  resolved props, which every placement and every picker render would otherwise repeat. */
+const iconToolsCache = createSliceMemo({
+	kinds: ["canvas-role", "component"],
+	compute: (config) => {
+		const entries = (config.resolve("canvas-role", "icon")?.toJSON())?.entries ?? [];
+		const tools = [];
+		let defaultTool;
+		for (const entry of entries) {
+			const tool = iconToolFromEntry(config, entry);
+			if (!tool) continue;
+			tools.push(tool);
+			if (entry.default && !defaultTool) defaultTool = tool;
+		}
+		return {
+			tools,
+			defaultTool: defaultTool ?? tools[0]
+		};
+	}
+});
+function iconToolFromEntry(config, entry) {
+	if (!isRef(entry.component)) return void 0;
+	const component = pathOf(entry.component);
+	const declarations = resolveComponentProps(config, component);
+	const glyphProps = glyphPropsOf(config, component);
+	const glyph = entry.props?.glyph ?? Object.keys(glyphProps)[0];
+	if (!glyph) return void 0;
+	return {
+		component,
+		glyph,
+		libraries: glyphProps[glyph] ?? glyphLibrariesOf(declarations[glyph]?.value),
+		axes: entry.props?.axes ?? Object.entries(declarations).filter(([name, declaration]) => name !== glyph && !(name in glyphProps) && declaration?.type === "variant").map(([name]) => name),
+		defaultProps: entry.defaultProps ?? {}
+	};
+}
 /**
 * 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
+* icon tool that covers the library when the `icon` canvas role has one ({@link iconToolFor});
+* 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
@@ -1014,14 +1061,11 @@ function iconToolAxisOptions(config, tool, axis) {
 * library. Two components binding the same library resolve to the first in registration order.
 */
 function glyphComponentOf(config, library) {
-	const tool = iconToolOf(config);
-	if (tool) {
-		const declaration = resolveComponentProps(config, tool.component)[tool.glyph];
-		if (declaration && glyphLibrariesOf(declaration.value).includes(library)) return {
-			path: tool.component,
-			prop: tool.glyph
-		};
-	}
+	const tool = iconToolFor(config, library);
+	if (tool) return {
+		path: tool.component,
+		prop: tool.glyph
+	};
 	for (const component of config.list("component")) {
 		const { props = {} } = component.toJSON();
 		for (const [prop, declaration] of Object.entries(props)) {
@@ -1272,4 +1316,4 @@ function declaredPropDefaults(props) {
 	return out;
 }
 //#endregion
-export { LAYER_PROPS, authoredBag, authoredValue, className, cssPropValue, cssVar, cssVarRef, declaredPropDefaults, declaredPropRouting, glyphComponentOf, glyphLibrariesOf, glyphPropsOf, glyphPropsOfBody, holdingPreviewConditions, iconToolAxisOptions, iconToolOf, keyedPreviewConditions, layerPropsErrors, 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, takenByForward, validateComponentProps };
+export { LAYER_PROPS, authoredBag, authoredValue, className, cssPropValue, cssVar, cssVarRef, declaredPropDefaults, declaredPropRouting, glyphComponentOf, glyphLibrariesOf, glyphPropsOf, glyphPropsOfBody, holdingPreviewConditions, iconToolAxisOptions, iconToolFor, iconToolOf, iconToolsOf, keyedPreviewConditions, layerPropsErrors, 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, takenByForward, validateComponentProps };

package/dist/framework/prop-surface.d.ts

@@ -21,7 +21,7 @@ interface SurfaceVariantProp extends SurfacePropBase {
    *  groups — a surface offers the glyph picker rather than a select over every member, with a
    *  library switcher when there is more than one. A facet ref (`icon:phosphor#variants`) stays a
    *  plain list: its leaves are the group node's own field values, a menu-sized set. Mirrors
-   *  {@link SurfaceSlotProp.acceptsIconLibrary}. */
+   *  {@link SurfaceSlotProp.acceptsIconLibraries}. */
   readonly iconLibraries?: readonly string[];
 }
 interface SurfaceStylePropertyProp extends SurfacePropBase {
@@ -46,10 +46,10 @@ interface SurfaceSlotProp extends SurfacePropBase {
   readonly into?: string;
   /** Components this slot may be filled with (`accepts`), as paths. Empty when unconstrained. */
   readonly accepts: string[];
-  /** The icon library this slot accepts, when `accepts` names one — the picker offers its glyphs
-   *  beside any accepted components. The library is the group the glyphs live in; Studio labels it
-   *  the slot's icon set. */
-  readonly acceptsIconLibrary?: string;
+  /** The icon libraries this slot accepts, in declaration order, when `accepts` names any: the
+   *  picker offers their glyphs beside any accepted components, with a set switcher when there is
+   *  more than one. Each is the group the glyphs live in; Studio labels them the slot's icon sets. */
+  readonly acceptsIconLibraries?: readonly string[];
   /** What the prop on the other end of the routing is, when this slot targets a layer. Absent for an
    *  open slot (content the render places itself). */
   readonly valueKind?: SurfacePropKind;

package/dist/framework/prop-surface.js

@@ -235,7 +235,7 @@ function slotProp(config, componentPath, name, decl) {
 		};
 	}
 	const refs = acceptsRefs(decl.accepts);
-	const icons = refs.find((ref) => kindOf(ref) === "icon");
+	const icons = refs.filter((ref) => kindOf(ref) === "icon").map((ref) => pathOf(ref));
 	const body = Component.get(config, componentPath)?.toJSON();
 	const layers = body?.layers;
 	const routed = routeEnd(config, layers, decl)?.decl;
@@ -255,7 +255,7 @@ function slotProp(config, componentPath, name, decl) {
 			into: intoName(decl.into)
 		} : {},
 		accepts: refs.filter((ref) => kindOf(ref) === "component").map((ref) => pathOf(ref)),
-		...icons ? { acceptsIconLibrary: pathOf(icons) } : {},
+		...icons.length > 0 ? { acceptsIconLibraries: icons } : {},
 		...routedKind ? { valueKind: routedKind } : {},
 		...routed ? { valueOptions: propValueDomain(config, routed)?.leaves } : {},
 		...routedKind === "composite" ? { compositeName: refPath(routed?.value) } : {}

package/dist/framework/utils/group.d.ts

@@ -35,11 +35,13 @@ type GroupBody<F extends FieldsSchema, G extends FieldsSchema> = CreateInput<G>
  * A registration-time input: a key of an authored group body that the kind's `group()` hands to this
  * handler, with the rest of the body, and then strips. It is never stored, never part of the group
  * schema, and never seen by a hydrated config. What the handler does with it is the kind's business.
+ * A handler may answer with fields to lay over the body, which is how an input that stands for the
+ * members (a module namespace) becomes the `items` the group registers.
  */
 type GroupInputHandler<I> = (args: {
   readonly input: I; /** The body without its inputs: the members under `items` and the group's own fields. */
   readonly body: Readonly<Record<string, unknown>>;
-}) => void;
+}) => Readonly<Record<string, unknown>> | undefined;
 /** A kind's registration-time inputs, keyed by the body key each one consumes. `never` is the
  *  parameter position's bottom, so a handler declaring any input type fits. */
 type GroupInputs = Readonly<Record<string, GroupInputHandler<never>>>;

package/dist/index.d.ts

@@ -25,6 +25,7 @@ import { AttachedSources, Config, CssGrammar, Edition, HydrationOptions, ListOpt
 import { CapturedChild, CapturedElement, CapturedNode, CapturedNodeJson, CapturedText, DomLikeElement, capturedFromDom, elementFromCaptured } from "./capture/captured-tree.js";
 import { CaptureToSpecOptions, CaptureToSpecResult, IconAnswer, IconHook, Spec, SpecElement, specFromCapture } from "./capture/capture-to-spec.js";
 import { ClassGrammar, classGrammar } from "./capture/class-grammar.js";
+import { GlyphExportRule, ICON_METADATA_FORMATS, IconMemberMetadata, IconMetadataAdapter, IconMetadataDeclaration, IconMetadataFile, IconMetadataFormat, glyphExportRule, iconMemberMetadata, iconMetadata, iconMetadataDeclaration, iconMetadataFile, iconMetadataFileJsonSchema, iconMetadataFormat, iconMetadataSourceFile, tablerExportName, tablerStyledExportName } from "./entities/system/icon-metadata.js";
 import { Icon, IconVariantAs, iconVariantAs } from "./entities/system/Icon.js";
 import { IconLibrary, glyphExportNames, glyphType, iconCategories, iconLibraries, iconLibrary, iconToolLibraries, isDeclaredElementProp, librariesBoundBy, libraryHolding, memberVariantOptions, placedGlyphElement, resolveIconLibraries } from "./entities/system/icon-library.js";
 import { GlyphSource, IconGlyph, glyphSourcesOf, iconResolver, nameIconsInTree } from "./capture/icon-resolver.js";
@@ -33,7 +34,7 @@ import { BUILD_DEFAULTS } from "./configs/build-options.js";
 import { ANATOMY_MARKER, ComponentSpec, ComponentSpecs, ComputedFunctions, ComputedValue, ExpandOptions, ExpansionResult, RenderElement, RenderSpec, RepeatRow, RepeatSpec, ResolveContext, SlotTarget, VisibilityOperator, VisibilityTerm, anatomyElementComponent, anatomyTextProp, boundElementType, componentSpec, deriveSpec, entryKeyOf, expandComponent, expandSpec, instanceSpec, layerTextProp, liveStateProps, previewSpec, propInto, propsIntoLayer, readStatePointer, resolveValue, resolveVisibility, routeOf, slotTargetsOf, specWithResolvedVisibility, statePointerProp, valueForwardsOf, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey } from "./framework/render-spec.js";
 import { RefMember, STYLE_PROP_VALUE_FORMS, STYLE_PROP_VALUE_LEAVES, StylePropLeaf, StylePropValue, StylePropValueCtx, StylePropValueKind, StyleProperty, classifyStylePropValue, cssPropertyNames, leavesOfStylePropValue, stylePropValueFormOf, stylePropValueSchema, toCssPropertyName } from "./entities/system/StyleProperty.js";
 import { StoredPreviewCondition, UNCONDITIONAL_PREVIEW_KEY, storedPreview, unconditionalPreviewProps } from "./framework/preview-store.js";
-import { IconTool, PreviewMatrix, PropDeclaration, StylePropEntry, StylePropertyItem, authoredBag, authoredValue, className, cssPropValue, cssVar, cssVarRef, declaredPropDefaults, declaredPropRouting, glyphComponentOf, glyphLibrariesOf, glyphPropsOf, 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 } from "./framework/projections.js";
+import { IconTool, PreviewMatrix, PropDeclaration, StylePropEntry, StylePropertyItem, authoredBag, authoredValue, className, cssPropValue, cssVar, cssVarRef, declaredPropDefaults, declaredPropRouting, glyphComponentOf, glyphLibrariesOf, glyphPropsOf, iconToolAxisOptions, iconToolFor, iconToolOf, iconToolsOf, 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 } from "./framework/projections.js";
 import { PreviewElement, graftPreviewElements, isPreviewElement } from "./spec/preview-elements.js";
 import { Slot, SlotCell } from "./spec/slot.js";
 import { ColorValue, DERIVED_COLOR_SPACE, DerivedColor, Gradient, alpha, darken, isDerivedColor, isGradient, lighten, linearGradient, mix, renderDerivedColor, renderGradient } from "./entities/system/color.js";
@@ -71,7 +72,6 @@ import { Font, FontFile, fontFamilyStack } from "./entities/system/Font.js";
 import { GlobalStyle, globalStyleName } from "./entities/system/GlobalStyle.js";
 import { Guidance, GuidanceScope, GuidanceSegment, guidanceReaches, guidanceScopeOf, guidanceTextOf } from "./entities/system/Guidance.js";
 import { GuidanceStyle, GuidanceStyleBody } from "./entities/system/GuidanceStyle.js";
-import { ICON_METADATA_FORMATS, IconMemberMetadata, IconMetadataAdapter, IconMetadataDeclaration, IconMetadataFile, IconMetadataFormat, iconMemberMetadata, iconMetadata, iconMetadataDeclaration, iconMetadataFile, iconMetadataFileJsonSchema, iconMetadataFormat, tablerExportName } from "./entities/system/icon-metadata.js";
 import { MODIFIER_CATEGORIES, Modifier, ModifierCategory, ModifierGroupMeta, WEB_ACTIVATIONS, WebActivation, modeAxes, modifierAxes, modifierAxis, modifierCategory, modifierGroupFields, modifierInvariants, modifierLeaf } from "./entities/system/Modifier.js";
 import { Motion } from "./entities/system/Motion.js";
 import { Operation } from "./entities/system/Operation.js";
@@ -105,4 +105,4 @@ import { SpecNode, validateSpec } from "./framework/validate-spec.js";
 import { valueLeavesOf, valueSchemaOf } from "./framework/value-domain.js";
 import { views } from "./framework/views-facade.js";
 import { RN_STYLE_KEYS } from "./react-native/style-keys.generated.js";
-export { AI_LANES, ANATOMY_MARKER, AiChat, AiFlow, type AiFlowOrigin, AiGeneration, type AiLane, AiMessage, type AiMultiAgentMode, type AnatomyIssue, type AnatomyIssueKind, type AnatomyReport, type AnySystemConfig, type AsInput, type AttachedSources, type Authored, type AuthoredComponent, type AuthoredProp, type AuthoredPropBody, type AuthoringSignatureOptions, BUILD_DEFAULTS, type BindingKind, type BreakOutcome, type BreakPlan, type BreakPlanInput, type BreakPlanRow, type BreakReach, BuildSection, CANVAS_ROLES, CONFIG_OPERATION_KIND, CSS_DEFAULTS, CSS_PROPERTY_NAMES, CSS_WIDE_KEYWORDS, CURRENT_SCHEMA_VERSION, Canvas, CanvasConfig, CanvasRole, type CanvasRoleName, CanvasSection, type CaptureToSpecOptions, type CaptureToSpecResult, type CapturedChild, type CapturedElement, CapturedNode, type CapturedNodeJson, type Spec as CapturedSpec, type SpecElement as CapturedSpecElement, type CapturedText, type Cell, type CellSlot, type Change, type ChangeHook, type ChangeTarget, type ChildrenPolicy, type ClassGrammar, type CodeSlot, type Collection, type ColorValue, Component, type ComponentBody, type ComponentBuilder, type ComponentContractOf, type ComponentElementBody, type ComponentModuleSource, type ComponentPropBody, type ComponentPropsOf, type ComponentReference, type ComponentRegistryImport, type ComponentRegistryImportBinding, type ComponentRuleClass, type ComponentSpec, type ComponentSpecs, type ComponentStyleBody, type ComposedValue, type ComposedValueAuthoring, type ComposedValueForm, Composite, type ComputedFields, type ComputedFunctions, type ComputedInput, type ComputedMap, type ComputedValue, Config, type ConfigClass, type ConfigEdit, ConfigFormatError, type ConfigInstance, type ConfigIssue, type ConfigIssueCode, type ConfigKind, type ConfigOp, ConfigRejection, ConfigSession, type ConfigSessionOptions, type ConfigSink, type ConfigSource, type CopyPlan, type CopyPlanInput, type CopyPlanRow, type CreateInput, type CssGrammar, type CssPrefix, type CssPropertyEntry, CssSection, DERIVED_COLOR_SPACE, DERIVED_MUTATIONS, type DanglingDirective, type DanglingLocalRef, type DanglingRef, type DeclaredRuntimeModule, type DeletePlan, type DeriveMembers, type DerivedColor, type DerivedEntityClass, type DerivedOp, Device, type DiffOptions, Documentation, DocumentationLibrary, type DomLikeElement, type DraftSource, ENTITY_PATH_MESSAGE, EXPORT_MEMBER, type Edition, type ElementVisibility, type ElementVisibilityInput, Entity, type EntityAddress, type EntityChange, type EntityClass, type EntityKind, type EntityMap, type ExpandOptions, type ExpansionResult, type ExtendedComponentRef, type ExtendedRef, type FieldsSchema, File, Font, FontFile, type ForwardClaims, GROUP, GUIDANCE_LANES, GlobalStyle, type GlyphComponent, type GlyphSource, type GlyphValue, type GoverningCondition, type Gradient, type GroupBody, Guidance, type GuidanceLane, type GuidanceScope, type GuidanceSegment, GuidanceStyle, type GuidanceStyleBody, type HasSnapshot, type HydrationOptions, ICON_METADATA_FORMATS, Icon, type IconAnswer, type IconGlyph, type IconHook, type IconLibrary, type IconMemberMetadata, type IconMetadataAdapter, type IconMetadataDeclaration, type IconMetadataFile, type IconMetadataFormat, type IconTool, type IconVariantAs, type IdentifiedOp, type InferredRename, type Instance, type InstanceSlot, type InstanceSpec, type ItemOf, type KindSignature, type KindSlice, LINK_SLUG, LINK_SLUG_MESSAGE, type LayerElement, type LayerMap, type LayerPropDriver, type LayerStyleOptions, type LeafAddress, type LinkArrival, type LinkDeclaration, type LinkPaths, type LinkPlan, type LinkPlanInput, LinkedSystem, type LinkedSystemResolver, type LinkedSystemState, type ListOptions, type LiveConfig, type LocalOverlay, MINTED, MODIFIER_CATEGORIES, type MarkerKind, type MisdeclaredOverlay, Modifier, type ModifierCategory, type ModifierGroupMeta, Motion, NATIVE_ACTIVATIONS, type NativeActivation, NativeModifier, NativeSettings, NativeStyleProperty, NativeToken, Node, type OpHandler, type OpInput, Operation, type OverlayVerb, type OverrideCondition, type OwnedRecords, PLAYGROUND_DEFAULTS, Package, Page, type Patch, type PathOf, type PinDirective, type PinOptions, type PinOptionsField, type Plan, type PlanImpact, type PlanOp, PlaygroundSection, type PreviewElement, type PreviewMatrix, type ProjectedVisibility, type PropCondition, type PropDecl, type PropDeclaration, type PropMap, type PropRoute, RN_STYLE_KEYS, ReactNativeSystem, type ReactNativeSystemConfig, type RebaseConflict, type RebaseOrigin, type RebaseResult, type RecordedSource, type RedundantQualifier, type Ref, type RefGraph, type RefGraphEntry, type RefIndex, type RefIndexChange, type RefMember, type RefTarget, type RegisteredComponentContracts, type RegisteredEntities, type RegisteredMembers, type RegisteredModifiers, type RegisteredPaths, type RegisteredStyleProps, type RegisteredTokenValues, type RenamePlan, type RenderArgs, type RenderElement, type RenderSpec, type RenderedNode, type RenderedTarget, type RepeatRow, type RepeatSpec, type ResolveContext, type ResolveValueTypeInput, type ResolvedBinding, type ResolvedSource, type RootFontSize, SCRIPT_EXTENSIONS, SERIALIZED_CONFIG_VERSION, SIZE_TOLERANCE_PX, SLOT_CODE_FORMS, STYLE_PROPERTIES, STYLE_PROP_VALUE_FORMS, STYLE_PROP_VALUE_LEAVES, type SchemaEntry, type SchemaMigration, SchemaVersionTooNew, type SerializedConfig, type SerializedSourceAnswer, Settings, type SignatureOptions, type SkippedOp, type Slot, type SlotCell, type SlotCodeForm, type SlotDecl, type SlotTarget, Snapshot, type Source, type SourceAnswer, type SourceChange, type SourceMap, type SourceResolution, type SourceResolutionSchemas, type SourceResolver, type SourceRowState, type SourceState, type SourceUnavailable, type SourcesBySlug, type SourcesOf, type SpecNode, type SplitStyleProps, type StampedPatch, type StoredConfig, type StoredPreviewCondition, type StylePropEntry, type StylePropLeaf, type StylePropValue, type StylePropValueCtx, type StylePropValueKind, StyleProperty, type StylePropertyItem, type StyleRuleInput, type StyleValue, type SubEntityClass, type SubPatch, type SurfaceCompositeProp, type SurfaceProp, type SurfacePropCondition, type SurfacePropKind, type SurfaceScalarProp, type SurfaceSlotProp, type SurfaceStylePropertyProp, type SurfaceVariantProp, System, type SystemConfig, SystemSection, SystemSource, TOKEN_READERS, type TimingValue, Token, type TokenBinding, type TokenBody, type TokenGroupReader, type TokenMatch, type TokenReader, type TokenReaders, type TokenRefPath, type TokenReference, type TokenValueEntry, type TokenValueRow, type TokenValueState, Tool, type Transition, type TransitionSegment, type TraverseOptions, type TreeNode, UNCONDITIONAL_PREVIEW_KEY, UNREACHABLE, type UnadoptedDirective, type UnknownStyleLeaf, type UnlinkPlan, type UnlinkPlanInput, type UnreadableBorrow, type UnstatableCondition, type UpgradedDraft, type UserSchemas, VOID_ELEMENTS, type ValueOf, type ValueType, type VariantValueBody, type VariantValues, type VisibilityOperator, type VisibilityTerm, WEB_ACTIVATIONS, type WalkOptions, type WebActivation, addressOf, alpha, anatomyElementComponent, anatomyIssueKey, anatomyTextProp, applyPathDelta, authoredBag, authoredValue, authoringSignatures, baseOf, bindStateRef, bindingPath, blankComponentBody, borrowedGroup, borrowedItem, boundElementType, brandGroup, buildRefGraph, buildRefIndex, canonicalWhen, capturedFromDom, changeOf, changeValueAt, changesOf, childrenPolicy, classGrammar, className, classPrefixOf, classifyOverlay, classifyStylePropValue, codeSlotsOf, collectRefs, componentClassBase, componentCompositeClasses, componentLayerClass, componentModuleFilePaths, componentModuleKey, componentModuleSource, componentMotionClasses, componentPropClasses, componentRegistryImports, componentRuleClasses, componentSpec, composedValueAuthoring, composedValueFormOf, composedValueForms, composedValueSchemas, condArms, condValue, containsMarker, createCanvasConfig, createSliceMemo, cssPrefixes, cssPropValue, cssProperty, cssPropertyNames, cssValueIssue, cssVar, cssVarRef, danglingDirectives, danglingLocalRefs, danglingSourcedRefs, darken, declaredField, declaredPropDefaults, declaredPropRouting, declaredRuntimeModules, defineComponent, defineConfig, defineDerivedEntity, defineEntity, defineOverride, defineSubEntity, deriveCreateSchema, deriveSpec, deriveUpdateSchema, describeBody, describePatch, detectedWireVersion, diffRendered, editOp, elementFromCaptured, entityRefOf, entryKeyOf, expandComponent, expandSpec, fieldKeys, fontFamilyStack, forceModeAttribute, forceModeAttributeOf, forceModeProp, forceModePropGroup, forceModePropValue, forceModeProps, forceStateAttribute, forwardClaims, forwardedLayers, forwardedNames, forwardsOf, globalStyleName, glyphComponentOf, glyphExportNames, glyphLibrariesOf, glyphPropsOf, glyphSourcesOf, glyphType, graftPreviewElements, guidanceReaches, guidanceScopeOf, guidanceTextOf, iconCategories, iconLibraries, iconLibrary, iconMemberMetadata, iconMetadata, iconMetadataDeclaration, iconMetadataFile, iconMetadataFileJsonSchema, iconMetadataFormat, iconResolver, iconToolAxisOptions, iconToolLibraries, iconToolOf, iconVariantAs, inferredRenames, inputOf, instanceHolding, instanceSpec, intoName, isAuthored, isBinaryAsset, isComposedValue, isConfigFormatError, isConfigRejection, isCssProperty, isDeclaredElementProp, isDerivedColor, isEntityPath, isExtendedRef, isForceModeProp, isGradient, isGroupBody, isIdentifier, isLinkSlug, isMintedRow, isNativeConfig, isPlainObject, isPreviewElement, isRef, isReservedWord, isSystemConfig, isTokenReader, isTransition, isValueSlot, kebabComponent, keyedPreviewConditions, kindOf, kindsOf, layerPropDrivers, layerPropRoutes, layerRef, layerRoutedProps, layerStyles, layerTextProp, leafAddresses, leafVerb, leavesOfStylePropValue, librariesBoundBy, libraryHolding, lighten, linearGradient, liveStateProps, markerKind, matchEntities, matchTokens, memberFromLeaf, memberLeaves, memberOf, memberRef, memberVariantOptions, memoryConfigSource, misdeclaredOverlays, mix, modeAxes, modifierAxes, modifierAxis, modifierCategory, modifierGroupFields, modifierInvariants, modifierLeaf, modifierUtilitiesUsed, motionClassName, nameIconsInTree, namedFields, nativeTokenValue, negatedCssValue, normalizeName, normalizeStyleValue, opOf, opVerb, opacityPercentage, opsForKind, orRef, overlayVerb, overrideCondition, overrideKey, overrideKeyModifiers, overrideModifiers, ownValues, ownerOf, ownsItsValues, packageKey, packageName, parseRootFontSize, partsOf, pathDelta, pathOf, pathSegments, placedGlyphElement, planBreak, planCopy, planLink, planUnlink, previewConditionalProps, previewConditions, previewDefaults, previewMatrix, previewSpec, propApplies, propInto, propOwner, propRegistryRef, propValueDomain, propValueFromAxis, propsIntoLayer, readStatePointer, readsState, redundantQualifiers, ref, refGraphOf, refLeaf, refListOf, refSchema, refTo, registerSchemaMigrations, renderBindingsOf, renderComposedValue, renderDerivedColor, renderGradient, renderSignature, renderStyleValue, renderTransition, renderedElement, renderedSignatureOf, renderedTarget, resolutionSchema, resolveBinding, resolveComponentProps, resolveFieldValue, resolveIconLibraries, resolveInputDir, resolveOutDir, resolveRegistryDir, resolveTokenValue, resolveTokenValueUnder, resolveValue, resolveValueType, resolveVisibility, resolvedSource, rewriteRefNamespace, rewriteRefSource, rewriteRefs, rnStyleKey, rootFontSize, rootLayerOf, routeOf, routedBag, routedProp, routedPropIn, routesContent, ruleApplies, ruleCondition, runChangeHooks, schemaVersionOf, searchEntities, searchTokens, setAtPath, signatureOf, slotCodeForms, slotTargetsOf, snapshotHtml, sniffValueType, sourceEntries, sourceOf, sourceOfGroup, sourceOfItem, sourceRowStates, sourceSlugFor, sourceUnavailable, sourceUnreachable, sourceVarPrefix, specFromCapture, specToNodePatches, specWithResolvedVisibility, spellTokenRead, splitRef, splitStyleProps, stamp, standsInForCode, statePointerProp, stateRef, stateTest, storedPreview, styleAliasesOf, styleDeclarations, stylePropClassBase, stylePropClassName, stylePropClasses, stylePropEntries, stylePropLeafForToken, stylePropNegates, stylePropTokenGroup, stylePropTokenPath, stylePropTokenValues, stylePropValueFormOf, stylePropValueFromLeaf, stylePropValueLeaves, stylePropValueSchema, stylePropValues, stylePropertiesWriting, stylePropertyAccepts, stylePropertyFor, stylePropertyPathFor, styleRuleMotionClasses, suggestLinkSlug, summarizeChanges, surfaceProp, surfaceProps, tablerExportName, toCssPropertyName, tokenBinding, tokenExists, tokenValueRow, tokenValueRows, touchedFields, transition, unadoptedDirectives, unconditionalPreviewProps, unknownStyleLeaves, unreadableBorrows, unstatableConditions, updateRefIndex, upgradeDraftEntries, upgradePatch, upgradeSerializedConfig, validateComponentProps, validateSpec, valueAt, valueForwardsOf, valueLeavesOf, valueRef, valueSchemaOf, varPrefixOf, views, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };
+export { AI_LANES, ANATOMY_MARKER, AiChat, AiFlow, type AiFlowOrigin, AiGeneration, type AiLane, AiMessage, type AiMultiAgentMode, type AnatomyIssue, type AnatomyIssueKind, type AnatomyReport, type AnySystemConfig, type AsInput, type AttachedSources, type Authored, type AuthoredComponent, type AuthoredProp, type AuthoredPropBody, type AuthoringSignatureOptions, BUILD_DEFAULTS, type BindingKind, type BreakOutcome, type BreakPlan, type BreakPlanInput, type BreakPlanRow, type BreakReach, BuildSection, CANVAS_ROLES, CONFIG_OPERATION_KIND, CSS_DEFAULTS, CSS_PROPERTY_NAMES, CSS_WIDE_KEYWORDS, CURRENT_SCHEMA_VERSION, Canvas, CanvasConfig, CanvasRole, type CanvasRoleName, CanvasSection, type CaptureToSpecOptions, type CaptureToSpecResult, type CapturedChild, type CapturedElement, CapturedNode, type CapturedNodeJson, type Spec as CapturedSpec, type SpecElement as CapturedSpecElement, type CapturedText, type Cell, type CellSlot, type Change, type ChangeHook, type ChangeTarget, type ChildrenPolicy, type ClassGrammar, type CodeSlot, type Collection, type ColorValue, Component, type ComponentBody, type ComponentBuilder, type ComponentContractOf, type ComponentElementBody, type ComponentModuleSource, type ComponentPropBody, type ComponentPropsOf, type ComponentReference, type ComponentRegistryImport, type ComponentRegistryImportBinding, type ComponentRuleClass, type ComponentSpec, type ComponentSpecs, type ComponentStyleBody, type ComposedValue, type ComposedValueAuthoring, type ComposedValueForm, Composite, type ComputedFields, type ComputedFunctions, type ComputedInput, type ComputedMap, type ComputedValue, Config, type ConfigClass, type ConfigEdit, ConfigFormatError, type ConfigInstance, type ConfigIssue, type ConfigIssueCode, type ConfigKind, type ConfigOp, ConfigRejection, ConfigSession, type ConfigSessionOptions, type ConfigSink, type ConfigSource, type CopyPlan, type CopyPlanInput, type CopyPlanRow, type CreateInput, type CssGrammar, type CssPrefix, type CssPropertyEntry, CssSection, DERIVED_COLOR_SPACE, DERIVED_MUTATIONS, type DanglingDirective, type DanglingLocalRef, type DanglingRef, type DeclaredRuntimeModule, type DeletePlan, type DeriveMembers, type DerivedColor, type DerivedEntityClass, type DerivedOp, Device, type DiffOptions, Documentation, DocumentationLibrary, type DomLikeElement, type DraftSource, ENTITY_PATH_MESSAGE, EXPORT_MEMBER, type Edition, type ElementVisibility, type ElementVisibilityInput, Entity, type EntityAddress, type EntityChange, type EntityClass, type EntityKind, type EntityMap, type ExpandOptions, type ExpansionResult, type ExtendedComponentRef, type ExtendedRef, type FieldsSchema, File, Font, FontFile, type ForwardClaims, GROUP, GUIDANCE_LANES, GlobalStyle, type GlyphComponent, type GlyphExportRule, type GlyphSource, type GlyphValue, type GoverningCondition, type Gradient, type GroupBody, Guidance, type GuidanceLane, type GuidanceScope, type GuidanceSegment, GuidanceStyle, type GuidanceStyleBody, type HasSnapshot, type HydrationOptions, ICON_METADATA_FORMATS, Icon, type IconAnswer, type IconGlyph, type IconHook, type IconLibrary, type IconMemberMetadata, type IconMetadataAdapter, type IconMetadataDeclaration, type IconMetadataFile, type IconMetadataFormat, type IconTool, type IconVariantAs, type IdentifiedOp, type InferredRename, type Instance, type InstanceSlot, type InstanceSpec, type ItemOf, type KindSignature, type KindSlice, LINK_SLUG, LINK_SLUG_MESSAGE, type LayerElement, type LayerMap, type LayerPropDriver, type LayerStyleOptions, type LeafAddress, type LinkArrival, type LinkDeclaration, type LinkPaths, type LinkPlan, type LinkPlanInput, LinkedSystem, type LinkedSystemResolver, type LinkedSystemState, type ListOptions, type LiveConfig, type LocalOverlay, MINTED, MODIFIER_CATEGORIES, type MarkerKind, type MisdeclaredOverlay, Modifier, type ModifierCategory, type ModifierGroupMeta, Motion, NATIVE_ACTIVATIONS, type NativeActivation, NativeModifier, NativeSettings, NativeStyleProperty, NativeToken, Node, type OpHandler, type OpInput, Operation, type OverlayVerb, type OverrideCondition, type OwnedRecords, PLAYGROUND_DEFAULTS, Package, Page, type Patch, type PathOf, type PinDirective, type PinOptions, type PinOptionsField, type Plan, type PlanImpact, type PlanOp, PlaygroundSection, type PreviewElement, type PreviewMatrix, type ProjectedVisibility, type PropCondition, type PropDecl, type PropDeclaration, type PropMap, type PropRoute, RN_STYLE_KEYS, ReactNativeSystem, type ReactNativeSystemConfig, type RebaseConflict, type RebaseOrigin, type RebaseResult, type RecordedSource, type RedundantQualifier, type Ref, type RefGraph, type RefGraphEntry, type RefIndex, type RefIndexChange, type RefMember, type RefTarget, type RegisteredComponentContracts, type RegisteredEntities, type RegisteredMembers, type RegisteredModifiers, type RegisteredPaths, type RegisteredStyleProps, type RegisteredTokenValues, type RenamePlan, type RenderArgs, type RenderElement, type RenderSpec, type RenderedNode, type RenderedTarget, type RepeatRow, type RepeatSpec, type ResolveContext, type ResolveValueTypeInput, type ResolvedBinding, type ResolvedSource, type RootFontSize, SCRIPT_EXTENSIONS, SERIALIZED_CONFIG_VERSION, SIZE_TOLERANCE_PX, SLOT_CODE_FORMS, STYLE_PROPERTIES, STYLE_PROP_VALUE_FORMS, STYLE_PROP_VALUE_LEAVES, type SchemaEntry, type SchemaMigration, SchemaVersionTooNew, type SerializedConfig, type SerializedSourceAnswer, Settings, type SignatureOptions, type SkippedOp, type Slot, type SlotCell, type SlotCodeForm, type SlotDecl, type SlotTarget, Snapshot, type Source, type SourceAnswer, type SourceChange, type SourceMap, type SourceResolution, type SourceResolutionSchemas, type SourceResolver, type SourceRowState, type SourceState, type SourceUnavailable, type SourcesBySlug, type SourcesOf, type SpecNode, type SplitStyleProps, type StampedPatch, type StoredConfig, type StoredPreviewCondition, type StylePropEntry, type StylePropLeaf, type StylePropValue, type StylePropValueCtx, type StylePropValueKind, StyleProperty, type StylePropertyItem, type StyleRuleInput, type StyleValue, type SubEntityClass, type SubPatch, type SurfaceCompositeProp, type SurfaceProp, type SurfacePropCondition, type SurfacePropKind, type SurfaceScalarProp, type SurfaceSlotProp, type SurfaceStylePropertyProp, type SurfaceVariantProp, System, type SystemConfig, SystemSection, SystemSource, TOKEN_READERS, type TimingValue, Token, type TokenBinding, type TokenBody, type TokenGroupReader, type TokenMatch, type TokenReader, type TokenReaders, type TokenRefPath, type TokenReference, type TokenValueEntry, type TokenValueRow, type TokenValueState, Tool, type Transition, type TransitionSegment, type TraverseOptions, type TreeNode, UNCONDITIONAL_PREVIEW_KEY, UNREACHABLE, type UnadoptedDirective, type UnknownStyleLeaf, type UnlinkPlan, type UnlinkPlanInput, type UnreadableBorrow, type UnstatableCondition, type UpgradedDraft, type UserSchemas, VOID_ELEMENTS, type ValueOf, type ValueType, type VariantValueBody, type VariantValues, type VisibilityOperator, type VisibilityTerm, WEB_ACTIVATIONS, type WalkOptions, type WebActivation, addressOf, alpha, anatomyElementComponent, anatomyIssueKey, anatomyTextProp, applyPathDelta, authoredBag, authoredValue, authoringSignatures, baseOf, bindStateRef, bindingPath, blankComponentBody, borrowedGroup, borrowedItem, boundElementType, brandGroup, buildRefGraph, buildRefIndex, canonicalWhen, capturedFromDom, changeOf, changeValueAt, changesOf, childrenPolicy, classGrammar, className, classPrefixOf, classifyOverlay, classifyStylePropValue, codeSlotsOf, collectRefs, componentClassBase, componentCompositeClasses, componentLayerClass, componentModuleFilePaths, componentModuleKey, componentModuleSource, componentMotionClasses, componentPropClasses, componentRegistryImports, componentRuleClasses, componentSpec, composedValueAuthoring, composedValueFormOf, composedValueForms, composedValueSchemas, condArms, condValue, containsMarker, createCanvasConfig, createSliceMemo, cssPrefixes, cssPropValue, cssProperty, cssPropertyNames, cssValueIssue, cssVar, cssVarRef, danglingDirectives, danglingLocalRefs, danglingSourcedRefs, darken, declaredField, declaredPropDefaults, declaredPropRouting, declaredRuntimeModules, defineComponent, defineConfig, defineDerivedEntity, defineEntity, defineOverride, defineSubEntity, deriveCreateSchema, deriveSpec, deriveUpdateSchema, describeBody, describePatch, detectedWireVersion, diffRendered, editOp, elementFromCaptured, entityRefOf, entryKeyOf, expandComponent, expandSpec, fieldKeys, fontFamilyStack, forceModeAttribute, forceModeAttributeOf, forceModeProp, forceModePropGroup, forceModePropValue, forceModeProps, forceStateAttribute, forwardClaims, forwardedLayers, forwardedNames, forwardsOf, globalStyleName, glyphComponentOf, glyphExportNames, glyphExportRule, glyphLibrariesOf, glyphPropsOf, glyphSourcesOf, glyphType, graftPreviewElements, guidanceReaches, guidanceScopeOf, guidanceTextOf, iconCategories, iconLibraries, iconLibrary, iconMemberMetadata, iconMetadata, iconMetadataDeclaration, iconMetadataFile, iconMetadataFileJsonSchema, iconMetadataFormat, iconMetadataSourceFile, iconResolver, iconToolAxisOptions, iconToolFor, iconToolLibraries, iconToolOf, iconToolsOf, iconVariantAs, inferredRenames, inputOf, instanceHolding, instanceSpec, intoName, isAuthored, isBinaryAsset, isComposedValue, isConfigFormatError, isConfigRejection, isCssProperty, isDeclaredElementProp, isDerivedColor, isEntityPath, isExtendedRef, isForceModeProp, isGradient, isGroupBody, isIdentifier, isLinkSlug, isMintedRow, isNativeConfig, isPlainObject, isPreviewElement, isRef, isReservedWord, isSystemConfig, isTokenReader, isTransition, isValueSlot, kebabComponent, keyedPreviewConditions, kindOf, kindsOf, layerPropDrivers, layerPropRoutes, layerRef, layerRoutedProps, layerStyles, layerTextProp, leafAddresses, leafVerb, leavesOfStylePropValue, librariesBoundBy, libraryHolding, lighten, linearGradient, liveStateProps, markerKind, matchEntities, matchTokens, memberFromLeaf, memberLeaves, memberOf, memberRef, memberVariantOptions, memoryConfigSource, misdeclaredOverlays, mix, modeAxes, modifierAxes, modifierAxis, modifierCategory, modifierGroupFields, modifierInvariants, modifierLeaf, modifierUtilitiesUsed, motionClassName, nameIconsInTree, namedFields, nativeTokenValue, negatedCssValue, normalizeName, normalizeStyleValue, opOf, opVerb, opacityPercentage, opsForKind, orRef, overlayVerb, overrideCondition, overrideKey, overrideKeyModifiers, overrideModifiers, ownValues, ownerOf, ownsItsValues, packageKey, packageName, parseRootFontSize, partsOf, pathDelta, pathOf, pathSegments, placedGlyphElement, planBreak, planCopy, planLink, planUnlink, previewConditionalProps, previewConditions, previewDefaults, previewMatrix, previewSpec, propApplies, propInto, propOwner, propRegistryRef, propValueDomain, propValueFromAxis, propsIntoLayer, readStatePointer, readsState, redundantQualifiers, ref, refGraphOf, refLeaf, refListOf, refSchema, refTo, registerSchemaMigrations, renderBindingsOf, renderComposedValue, renderDerivedColor, renderGradient, renderSignature, renderStyleValue, renderTransition, renderedElement, renderedSignatureOf, renderedTarget, resolutionSchema, resolveBinding, resolveComponentProps, resolveFieldValue, resolveIconLibraries, resolveInputDir, resolveOutDir, resolveRegistryDir, resolveTokenValue, resolveTokenValueUnder, resolveValue, resolveValueType, resolveVisibility, resolvedSource, rewriteRefNamespace, rewriteRefSource, rewriteRefs, rnStyleKey, rootFontSize, rootLayerOf, routeOf, routedBag, routedProp, routedPropIn, routesContent, ruleApplies, ruleCondition, runChangeHooks, schemaVersionOf, searchEntities, searchTokens, setAtPath, signatureOf, slotCodeForms, slotTargetsOf, snapshotHtml, sniffValueType, sourceEntries, sourceOf, sourceOfGroup, sourceOfItem, sourceRowStates, sourceSlugFor, sourceUnavailable, sourceUnreachable, sourceVarPrefix, specFromCapture, specToNodePatches, specWithResolvedVisibility, spellTokenRead, splitRef, splitStyleProps, stamp, standsInForCode, statePointerProp, stateRef, stateTest, storedPreview, styleAliasesOf, styleDeclarations, stylePropClassBase, stylePropClassName, stylePropClasses, stylePropEntries, stylePropLeafForToken, stylePropNegates, stylePropTokenGroup, stylePropTokenPath, stylePropTokenValues, stylePropValueFormOf, stylePropValueFromLeaf, stylePropValueLeaves, stylePropValueSchema, stylePropValues, stylePropertiesWriting, stylePropertyAccepts, stylePropertyFor, stylePropertyPathFor, styleRuleMotionClasses, suggestLinkSlug, summarizeChanges, surfaceProp, surfaceProps, tablerExportName, tablerStyledExportName, toCssPropertyName, tokenBinding, tokenExists, tokenValueRow, tokenValueRows, touchedFields, transition, unadoptedDirectives, unconditionalPreviewProps, unknownStyleLeaves, unreadableBorrows, unstatableConditions, updateRefIndex, upgradeDraftEntries, upgradePatch, upgradeSerializedConfig, validateComponentProps, validateSpec, valueAt, valueForwardsOf, valueLeavesOf, valueRef, valueSchemaOf, varPrefixOf, views, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };