@yahoo/uds-create-config 4.0.4 → 4.1.0

package/dist/configs/react-native-system.js

@@ -19,6 +19,7 @@ import { iconKnockoutVariantsMigration } from "../migrations/20260909183001_icon
 import { linkedSystemLinkOpsMigration } from "../migrations/20260910212453_linked_system_link_ops.js";
 import { componentCreateBlankOpMigration } from "../migrations/20260914155048_component_create_blank_op.js";
 import { anatomyHarnessMigration } from "../migrations/20260914181845_anatomy_harness.js";
+import { anatomyNodeActionsMigration } from "../migrations/20260918161049_anatomy_node_actions.js";
 import { NativeModifier } from "../entities/native/NativeModifier.js";
 import { NativeSettings } from "../entities/native/NativeSettings.js";
 import { NativeStyleProperty } from "../entities/native/NativeStyleProperty.js";
@@ -64,5 +65,6 @@ if (!registeredSchemaMigrations().has(20260909183001)) registerSchemaMigrations(
 if (!registeredSchemaMigrations().has(20260910212453)) registerSchemaMigrations(linkedSystemLinkOpsMigration);
 if (!registeredSchemaMigrations().has(20260914155048)) registerSchemaMigrations(componentCreateBlankOpMigration);
 if (!registeredSchemaMigrations().has(20260914181845)) registerSchemaMigrations(anatomyHarnessMigration);
+if (!registeredSchemaMigrations().has(20260918161049)) registerSchemaMigrations(anatomyNodeActionsMigration);
 //#endregion
 export { ReactNativeSystem };

package/dist/configs/system.js

@@ -29,6 +29,7 @@ import { previewConditionsMigration } from "../migrations/20260912161840_preview
 import { fontVariableMigration } from "../migrations/20260912164927_font_variable.js";
 import { componentCreateBlankOpMigration } from "../migrations/20260914155048_component_create_blank_op.js";
 import { anatomyHarnessMigration } from "../migrations/20260914181845_anatomy_harness.js";
+import { anatomyNodeActionsMigration } from "../migrations/20260918161049_anatomy_node_actions.js";
 //#region src/configs/system.ts
 /**
 * `System` — the design-system config TYPE. Declares the exact kinds a design system owns (tokens,
@@ -78,5 +79,6 @@ if (!registeredSchemaMigrations().has(20260912161840)) registerSchemaMigrations(
 if (!registeredSchemaMigrations().has(20260912164927)) registerSchemaMigrations(fontVariableMigration);
 if (!registeredSchemaMigrations().has(20260914155048)) registerSchemaMigrations(componentCreateBlankOpMigration);
 if (!registeredSchemaMigrations().has(20260914181845)) registerSchemaMigrations(anatomyHarnessMigration);
+if (!registeredSchemaMigrations().has(20260918161049)) registerSchemaMigrations(anatomyNodeActionsMigration);
 //#endregion
 export { System };

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

@@ -314,6 +314,14 @@ interface ComponentElementBody {
   visible?: ElementVisibility;
   props?: Record<string, unknown>;
   text?: string;
+  /** Event name → the state actions it runs, in json-render's `on` grammar. */
+  on?: Record<string, {
+    action: 'setState';
+    params: {
+      statePath: string;
+      value?: unknown;
+    };
+  }[]>;
 }
 declare const componentFields: z.ZodObject<{
   layers: SubEntityClass<z.ZodUnion<readonly [z.ZodString, z.ZodLazy<z.ZodType<Ref, unknown, z.core.$ZodTypeInternals<Ref, unknown>>>, EntityClass<z.ZodObject<{

package/dist/entities/system/Component.js

@@ -605,10 +605,23 @@ function ownValues(declaration) {
 * see a real edge. Accepting a ref as well is what lets stored data re-validate on update.
 */
 function conditionValue(prop, declaration, config) {
+	const scalar = scalarConditionValue(declaration);
+	if (scalar) return scalar;
 	const domain = valueSchemaOf(declaration, config);
 	if (!ownsItsValues(declaration)) return domain;
 	return z.union([domain, refSchema]).transform((value) => isRef(value) ? value : valueRef(prop, String(value)));
 }
+/**
+* The condition on a boolean or number prop, in the prop's type. A preview axis spells every value
+* as a string and a rule's key stringifies it, so a writer reading either hands back `'true'` where
+* the author wrote `true`; the string form is taken and stored as the value it names.
+*/
+function scalarConditionValue(declaration) {
+	const decl = declaration;
+	if (decl?.value !== void 0) return void 0;
+	if (decl?.type === "boolean") return z.union([z.boolean(), z.enum(["true", "false"]).transform((value) => value === "true")]);
+	if (decl?.type === "number") return z.union([z.number(), z.string().refine((value) => value.trim() !== "" && Number.isFinite(Number(value)), { error: "a number condition is a number, or a string spelling one" }).transform(Number)]);
+}
 /** `ExampleComponent`, or the first numbered name no component holds. Models copy examples
 *  literally, so the path has to be one a create would take. */
 function freeExamplePath(config) {
@@ -937,6 +950,17 @@ const visibility = z.union([
 	z.array(z.union([stateCondition, orCondition])),
 	flatCondition
 ], { error: "a condition is `{ \"$state\": \"<prop>\" }` for a prop that is set, `{ \"$state\": \"<prop>\", \"eq\": \"<value>\" }` for one value of it (`neq`, `gt`, `gte`, `lt`, `lte` and `not: true` also work), `{ \"$or\": [ … ] }` for any of several, or a list of conditions that must all hold" });
+/** What an event on a node does to the state model: json-render's own `setState`, its path and the
+*  value to write, which may itself be a choice on the state (`{ $cond, $then, $else }`). */
+const stateAction = z.strictObject({
+	action: z.literal("setState"),
+	params: z.strictObject({
+		statePath: z.string(),
+		value: z.unknown()
+	})
+});
+/** json-render's `on` grammar as a stored node keeps it: event name → the actions it runs. */
+const nodeActions = z.record(z.string(), z.array(stateAction));
 /** One inserted node's accepted shape — {@link InsertedNode}, as the op validates it. Declared after
 *  {@link visibility} because a descendant may carry its own condition. */
 const insertedNode = z.strictObject({
@@ -1061,7 +1085,8 @@ const AnatomyNode = defineSubEntity({
 				cssBehind: false,
 				values: anatomyPropValue
 			}) : z.record(z.string(), anatomyPropValue)).optional().describe("Props passed to what the node renders, keyed by prop or style-property name, as literal values. Content is not set here: a `slot` prop's content lands where a `{ \"element\": \"Slot\", \"props\": { \"name\": \"<prop>\" } }` node sits among a parent's `children` (on the root when there is none), and a `forward` prop (`{ \"type\": \"forward\", \"target\": \"label/children\" }`) routes it into that layer with no node entry. `$state` belongs to `visible` and to an `element` a prop chooses."),
-			text: z.string().optional().describe("Literal text content, for a node that renders a fixed string.")
+			text: z.string().optional().describe("Literal text content, for a node that renders a fixed string."),
+			on: nodeActions.optional().describe("What an event on the node does to the state model, in json-render's `on` grammar: `{ \"press\": [{ \"action\": \"setState\", \"params\": { \"statePath\": \"/checked\", \"value\": … } }] }`. Read off the render's own handlers; a preview runs them so the composition responds as the component does.")
 		};
 		if (!config || !body) return z.object({
 			...shape,

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

@@ -249,6 +249,9 @@ type ValueOfDeclaration<D> = D extends {
 } ? boolean : D extends {
   type: 'slot';
 } ? ReactNode : D extends {
+  type: 'forward';
+  text: true;
+} ? string : D extends {
   type: 'forward';
   target: `${string}/children`;
 } ? ReactNode : unknown;

package/dist/entities/system/defineComponent.js

@@ -214,12 +214,29 @@ function storedRoutedForward(decl, layers) {
 	const element = layers?.[layer];
 	const path = isComponentElement(element) ? element.path : isRef(element) ? pathOf(element) : void 0;
 	if (!path) return decl;
-	const declaring = declaringPath(element, decl.into) ?? path;
+	const declaring = declaringPath(element, decl.into);
+	if (!declaring && !mentionsProp(element, decl.into)) return decl;
 	return {
 		...decl,
-		into: memberRef("component", declaring, "props", decl.into)
+		into: memberRef("component", declaring ?? path, "props", decl.into)
 	};
 }
+/** Whether the layer's element, or anything it forwards from, has a `props` entry for `prop` at all —
+*  declared or tombstoned. The same walk as {@link declaringPath}, asking a looser question. */
+function mentionsProp(element, prop, seen = /* @__PURE__ */ new Set()) {
+	if (!isComponentElement(element) || seen.has(element)) return false;
+	const body = element.body;
+	if (!body) return false;
+	const props = body.props;
+	if (props && prop in props) return true;
+	const forwards = body.forwards;
+	if (!forwards) return false;
+	const next = new Set(seen).add(element);
+	const layers = body.layers;
+	return Object.entries(forwards).some(([layer, entry]) => {
+		return (entry === "*" || Array.isArray(entry) && entry.some((one) => forwardedName(one) === prop)) && mentionsProp(layers?.[layer], prop, next);
+	});
+}
 /** The prop name a forwarding entry identifies, whichever spelling it is in — authored names have not
 *  become member refs yet at this point, and a re-authored body may hold either. */
 function forwardedName(entry) {

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 = 20260914181845;
+declare const SERIALIZED_CONFIG_VERSION = 20260918161049;
 interface SerializedConfig {
   /** See {@link SERIALIZED_CONFIG_VERSION}. Always written; a stored artifact may lack it. */
   readonly version: number;

package/dist/framework/Config.js

@@ -4715,7 +4715,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 > 20260914181845) throw new SchemaVersionTooNew(claimed);
+		if (claimed > 20260918161049) 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/render-spec.d.ts

@@ -17,6 +17,9 @@ interface RenderElement {
    *  json-render `Spec` is read through this type too, and its grammar has `$item`, `$index` and
    *  `$and` arms the entity refuses. */
   readonly visible?: unknown;
+  /** json-render's own `on` grammar: event name → the actions it runs. Carried from the anatomy
+   *  for the component's own composition, so a click in a preview writes the state model. */
+  readonly on?: unknown;
 }
 interface RenderSpec {
   readonly root: string;
@@ -67,6 +70,12 @@ declare function entryKeyOf(nodes: Record<string, {
  * and that was always stated rather than run.
  */
 declare function deriveSpec(config: Config, path: string): RenderSpec | undefined;
+/**
+ * The props a spec's actions write — the root of every `setState` path under any element's `on`.
+ * These are the props a preview must keep LIVE: their conditions stay for the renderer to judge
+ * against the state model rather than being settled once, and their styles paint per value.
+ */
+declare function liveStateProps(spec: RenderSpec): Set<string>;
 /**
  * ONE COMPONENT, as a spec — the instance form, and the only place the `component:` prefix is minted.
  *
@@ -180,11 +189,21 @@ interface ExpansionResult {
  *
  * A condition that does not resolve is left exactly as it was, so nothing is claimed about it.
  */
-declare function specWithResolvedVisibility(spec: RenderSpec, state: Record<string, unknown>): RenderSpec;
+declare function specWithResolvedVisibility(spec: RenderSpec, state: Record<string, unknown>, options?: {
+  /** Props the renderer keeps deciding at paint time — a choice reading one is left as it is. */readonly live?: ReadonlySet<string>;
+}): RenderSpec;
 /** The comparison a `$state` test can make: json-render's own operator set, minus the state pointer
  *  and the `not` modifier. Typed off the library so an operator it adds is a typecheck failure here
  *  until {@link COMPARATORS} handles it. */
 type VisibilityOperator = Exclude<keyof StateCondition, '$state' | 'not'>;
+/**
+ * A `$state` pointer read off a prop bag, the way json-render reads it: `/size` is the prop, and
+ * `/value/required` a member of an object prop. For a component's own anatomy the state model IS
+ * its prop bag.
+ */
+declare function readStatePointer(state: Record<string, unknown>, pointer: string): unknown;
+/** The prop a `$state` pointer reads — its first segment, for a pointer into an object prop. */
+declare function statePointerProp(pointer: string): string;
 /** A value in json-render's `visible` grammar, resolved against a prop bag. `undefined` when this
  *  reader can't settle it, which leaves the condition on the element for the renderer to judge. */
 declare function resolveVisibility(condition: unknown, state: Record<string, unknown>): boolean | undefined;
@@ -304,4 +323,4 @@ declare function expandSpec(config: Config, spec: RenderSpec, options?: ExpandOp
  */
 declare function expandComponent(config: Config, path: string, props?: Record<string, unknown>, options?: ExpandOptions): ExpansionResult;
 //#endregion
-export { ComponentSpec, ComponentSpecs, ExpandOptions, ExpansionResult, RenderElement, RenderSpec, SlotTarget, VisibilityOperator, VisibilityTerm, boundElementType, componentSpec, deriveSpec, entryKeyOf, expandComponent, expandSpec, instanceSpec, previewSpec, resolveVisibility, slotTargetsOf, specWithResolvedVisibility, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };
+export { ComponentSpec, ComponentSpecs, ExpandOptions, ExpansionResult, RenderElement, RenderSpec, SlotTarget, VisibilityOperator, VisibilityTerm, boundElementType, componentSpec, deriveSpec, entryKeyOf, expandComponent, expandSpec, instanceSpec, liveStateProps, previewSpec, readStatePointer, resolveVisibility, slotTargetsOf, specWithResolvedVisibility, statePointerProp, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };

package/dist/framework/render-spec.js

@@ -221,7 +221,8 @@ function deriveSpec(config, path) {
 			...Object.keys(props).length ? { props } : {},
 			...children?.length ? { children } : {},
 			...node.slots && Object.keys(node.slots).length ? { slots: node.slots } : {},
-			...node.visible !== void 0 ? { visible: node.visible } : {}
+			...node.visible !== void 0 ? { visible: node.visible } : {},
+			...node.on !== void 0 ? { on: node.on } : {}
 		};
 	}
 	return {
@@ -230,6 +231,31 @@ function deriveSpec(config, path) {
 	};
 }
 /**
+* The props a spec's actions write — the root of every `setState` path under any element's `on`.
+* These are the props a preview must keep LIVE: their conditions stay for the renderer to judge
+* against the state model rather than being settled once, and their styles paint per value.
+*/
+function liveStateProps(spec) {
+	const props = /* @__PURE__ */ new Set();
+	for (const element of Object.values(spec.elements)) {
+		if (typeof element.on !== "object" || element.on === null) continue;
+		for (const binding of Object.values(element.on)) {
+			const actions = Array.isArray(binding) ? binding : [binding];
+			for (const action of actions) {
+				const params = action?.params;
+				if (typeof params?.statePath === "string") props.add(statePointerProp(params.statePath));
+			}
+		}
+	}
+	return props;
+}
+/** Whether a value's choice reads any of `props`, at any depth. */
+function readsAnyOf(value, props) {
+	if (typeof value !== "object" || value === null || !("$cond" in value)) return false;
+	const choice = value;
+	return visibilityStateProps(choice.$cond).some((prop) => props.has(prop)) || readsAnyOf(choice.$then, props) || readsAnyOf(choice.$else, props);
+}
+/**
 * ONE COMPONENT, as a spec — the instance form, and the only place the `component:` prefix is minted.
 *
 * A spec type is `kind:identity`, always: the emitted registry keys every entry that way and holds
@@ -345,19 +371,31 @@ function expandable(sink, type) {
 *
 * A condition that does not resolve is left exactly as it was, so nothing is claimed about it.
 */
-function specWithResolvedVisibility(spec, state) {
+function specWithResolvedVisibility(spec, state, options = {}) {
 	let changed = false;
 	const elements = {};
+	const live = options.live;
 	for (const [key, element] of Object.entries(spec.elements)) {
 		const resolved = element.visible === void 0 ? void 0 : resolveVisibility(element.visible, state);
-		if (resolved === void 0 || resolved === element.visible) {
+		let props = element.props;
+		for (const [name, value] of Object.entries(element.props ?? {})) {
+			if (live?.size && readsAnyOf(value, live)) continue;
+			const settled = resolveChosenValue(value, state);
+			if (settled === value) continue;
+			props = {
+				...props,
+				[name]: settled
+			};
+		}
+		if ((resolved === void 0 || resolved === element.visible) && props === element.props) {
 			elements[key] = element;
 			continue;
 		}
 		changed = true;
 		elements[key] = {
 			...element,
-			visible: resolved
+			...props === element.props ? {} : { props },
+			...resolved === void 0 || resolved === element.visible ? {} : { visible: resolved }
 		};
 	}
 	return changed ? {
@@ -384,6 +422,23 @@ const OPERATORS = Object.keys(COMPARATORS);
 function operatorOf(test) {
 	return OPERATORS.find((name) => name in test);
 }
+/**
+* A `$state` pointer read off a prop bag, the way json-render reads it: `/size` is the prop, and
+* `/value/required` a member of an object prop. For a component's own anatomy the state model IS
+* its prop bag.
+*/
+function readStatePointer(state, pointer) {
+	let current = state;
+	for (const segment of pointer.replace(/^\//, "").split("/")) {
+		if (current === null || typeof current !== "object") return void 0;
+		current = current[segment];
+	}
+	return current;
+}
+/** The prop a `$state` pointer reads — its first segment, for a pointer into an object prop. */
+function statePointerProp(pointer) {
+	return pointer.replace(/^\//, "").split("/")[0] ?? "";
+}
 /** A value in json-render's `visible` grammar, resolved against a prop bag. `undefined` when this
 *  reader can't settle it, which leaves the condition on the element for the renderer to judge. */
 function resolveVisibility(condition, state) {
@@ -411,11 +466,20 @@ function resolveVisibility(condition, state) {
 	}
 	if (Array.isArray(test.$and)) return resolveVisibility(test.$and, state);
 	if (typeof test.$state !== "string") return void 0;
-	const value = state[test.$state.replace(/^\//, "")];
+	const value = readStatePointer(state, test.$state);
 	const operator = operatorOf(test);
 	const result = operator ? COMPARATORS[operator](value, test[operator]) : Boolean(value);
 	return test.not === true ? !result : result;
 }
+/** A json-render `{ $cond, $then, $else }` value settled against a prop bag: the arm the condition
+*  picks, itself settled, or the choice untouched when the condition can't be. */
+function resolveChosenValue(value, state) {
+	if (typeof value !== "object" || value === null || !("$cond" in value)) return value;
+	const choice = value;
+	const picked = resolveVisibility(choice.$cond, state);
+	if (picked === void 0) return value;
+	return resolveChosenValue(picked ? choice.$then : choice.$else, state);
+}
 /**
 * Which PROPS a `visible` condition reads, in the order they appear.
 *
@@ -447,7 +511,7 @@ function collectStateProps(condition, sink) {
 		for (const entry of test.$and) collectStateProps(entry, sink);
 		return;
 	}
-	if (typeof test.$state === "string") sink.push(test.$state.replace(/^\//, ""));
+	if (typeof test.$state === "string") sink.push(statePointerProp(test.$state));
 }
 /**
 * The tests a `visible` condition makes, in order, flattened to one list.
@@ -507,7 +571,7 @@ function collectTerms({ condition, junction, group, sink }) {
 	if (typeof test.$state !== "string") return;
 	const operator = operatorOf(test);
 	sink.push({
-		prop: test.$state.replace(/^\//, ""),
+		prop: statePointerProp(test.$state),
 		operator: operator ?? "truthy",
 		...operator ? { value: test[operator] } : {},
 		negated: test.not === true,
@@ -857,6 +921,10 @@ function expandInstance(sink, path, instanceProps, content, hint, instanceSlots)
 			]) || void 0
 		} : authoredProps(config, node.props);
 		if (node.text !== void 0) props.children = node.text;
+		for (const [name, value] of Object.entries(props)) {
+			const settled = resolveChosenValue(value, state);
+			if (settled !== value) props[name] = settled;
+		}
 		const children = [];
 		const boundFills = {};
 		for (const [name, value] of Object.entries(props)) {
@@ -942,12 +1010,21 @@ function expandSpec(config, spec, options = {}) {
 		for (const [name, fills] of Object.entries(element.slots ?? {})) slots[name] = fills.map((fill) => emit(fill)).filter((placed) => placed !== void 0);
 		const placed = place(sink, element.type, { ...element.props }, children, key, slots);
 		if (element.visible !== void 0) withCondition(sink, placed, { visible: element.visible });
+		if (element.on !== void 0) {
+			const target = sink.elements[placed];
+			if (target) sink.elements[placed] = {
+				...target,
+				on: element.on
+			};
+		}
 		emitting.delete(key);
 		return placed;
 	};
+	const root = emit(spec.root) ?? spec.root;
 	return {
 		spec: {
-			root: emit(spec.root) ?? spec.root,
+			...spec,
+			root,
 			elements: sink.elements
 		},
 		unresolved: [...sink.unresolved]
@@ -964,4 +1041,4 @@ function expandComponent(config, path, props = {}, options = {}) {
 	return expandSpec(config, instanceSpec(path, props), options);
 }
 //#endregion
-export { boundElementType, componentSpec, deriveSpec, entryKeyOf, expandComponent, expandSpec, instanceSpec, previewSpec, resolveVisibility, slotAnatomyPropOf, slotTargetsOf, specWithResolvedVisibility, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };
+export { boundElementType, componentSpec, deriveSpec, entryKeyOf, expandComponent, expandSpec, instanceSpec, liveStateProps, previewSpec, readStatePointer, resolveVisibility, slotAnatomyPropOf, slotTargetsOf, specWithResolvedVisibility, statePointerProp, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };

package/dist/framework/schema-version.d.ts

@@ -15,7 +15,7 @@ import { Patch, SerializedConfig } from "./Config.js";
  * sets this constant to its own older timestamp; the merge ref then carries a registered migration
  * newer than the constant, and the assertion fails until the author re-mints.
  */
-declare const CURRENT_SCHEMA_VERSION = 20260914181845;
+declare const CURRENT_SCHEMA_VERSION = 20260918161049;
 /** What the walkers need to see of an envelope — loose on purpose, so a typed `SerializedConfig`
  *  and a raw old-shape record both flow in without casts. */
 interface VersionStamped {

package/dist/framework/schema-version.js

@@ -13,7 +13,7 @@ import { ConfigFormatError } from "./rejection.js";
 * sets this constant to its own older timestamp; the merge ref then carries a registered migration
 * newer than the constant, and the assertion fails until the author re-mints.
 */
-const CURRENT_SCHEMA_VERSION = 20260914181845;
+const CURRENT_SCHEMA_VERSION = 20260918161049;
 /** The mint that moved `options` into the `settings` kind — restated here, rather than imported
 *  from the migration that owns it, because that migration imports this module. */
 const SETTINGS_AS_KIND_VERSION = 20260908171448;
@@ -45,7 +45,7 @@ function registerSchemaMigrations(...migrations) {
 	for (const migration of migrations) {
 		if (migration.version !== 1 && !isMintTimestamp(migration.version)) throw new Error(`Schema migration version ${migration.version} is not a mint timestamp — mint one with \`date +%Y%m%d%H%M%S\`, like a supabase migration.`);
 		if (REGISTERED.has(migration.version)) throw new Error(`A schema migration at version ${migration.version} is already registered.`);
-		if (migration.version > 20260914181845) throw new Error(`Schema migration ${migration.version} is newer than CURRENT_SCHEMA_VERSION (${CURRENT_SCHEMA_VERSION}) — a stale branch merged, or the mint forgot to bump the constant. Re-mint: set CURRENT_SCHEMA_VERSION to the newest migration version.`);
+		if (migration.version > 20260918161049) throw new Error(`Schema migration ${migration.version} is newer than CURRENT_SCHEMA_VERSION (${CURRENT_SCHEMA_VERSION}) — a stale branch merged, or the mint forgot to bump the constant. Re-mint: set CURRENT_SCHEMA_VERSION to the newest migration version.`);
 		REGISTERED.set(migration.version, migration);
 	}
 }
@@ -102,7 +102,7 @@ function pendingFor(version, target, options) {
 * Already-current input passes through untouched — same reference, so hot paths pay nothing.
 */
 function upgradeSerializedConfig(json, options) {
-	const target = options?.target ?? 20260914181845;
+	const target = options?.target ?? 20260918161049;
 	const version = detectedWireVersion(json);
 	if (version > target) throw new SchemaVersionTooNew(version, target);
 	const raw = json;
@@ -160,7 +160,7 @@ function upgradedSources(json, options) {
 * meaning under the current schema and replay skips it — reported by the caller, not swallowed here.
 */
 function upgradePatch(patch, writtenAt, options) {
-	const target = options?.target ?? 20260914181845;
+	const target = options?.target ?? 20260918161049;
 	if (writtenAt > target) throw new SchemaVersionTooNew(writtenAt, target);
 	let current = patch;
 	for (const migration of pendingFor(writtenAt, target, options)) {
@@ -179,7 +179,7 @@ function upgradePatch(patch, writtenAt, options) {
 * stamp would cause.
 */
 function upgradeDraftEntries(draft, options) {
-	const target = options?.target ?? 20260914181845;
+	const target = options?.target ?? 20260918161049;
 	const entries = [];
 	const held = [];
 	const retired = [];

package/dist/index.d.ts

@@ -76,7 +76,7 @@ import { ForwardClaims, SurfaceCompositeProp, SurfaceProp, SurfacePropKind, Surf
 import { DanglingLocalRef, UnknownStyleLeaf, danglingLocalRefs, unknownStyleLeaves } from "./framework/ref-integrity.js";
 import { resolveInputDir, resolveOutDir, resolveRegistryDir } from "./framework/registry-dir.js";
 import { InferredRename, inferredRenames } from "./framework/rename-inference.js";
-import { ComponentSpec, ComponentSpecs, ExpandOptions, ExpansionResult, RenderElement, RenderSpec, SlotTarget, VisibilityOperator, VisibilityTerm, boundElementType, componentSpec, deriveSpec, entryKeyOf, expandComponent, expandSpec, instanceSpec, previewSpec, resolveVisibility, slotTargetsOf, specWithResolvedVisibility, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey } from "./framework/render-spec.js";
+import { ComponentSpec, ComponentSpecs, ExpandOptions, ExpansionResult, RenderElement, RenderSpec, SlotTarget, VisibilityOperator, VisibilityTerm, boundElementType, componentSpec, deriveSpec, entryKeyOf, expandComponent, expandSpec, instanceSpec, liveStateProps, previewSpec, readStatePointer, resolveVisibility, slotTargetsOf, specWithResolvedVisibility, statePointerProp, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey } from "./framework/render-spec.js";
 import { CURRENT_SCHEMA_VERSION, SchemaMigration, SchemaVersionTooNew, UpgradedDraft, WalkOptions, detectedWireVersion, registerSchemaMigrations, schemaVersionOf, upgradeDraftEntries, upgradePatch, upgradeSerializedConfig } from "./framework/schema-version.js";
 import { ConfigSession, ConfigSessionOptions, ConfigSink, ConfigSource, DraftSource, RebaseOrigin, SourceChange, memoryConfigSource } from "./framework/session.js";
 import { SignatureOptions, renderSignature, signatureOf } from "./framework/signature.js";
@@ -89,4 +89,4 @@ import { views } from "./framework/views-facade.js";
 import { RN_STYLE_KEYS } from "./react-native/style-keys.generated.js";
 import { namedSlotTargets } from "./spec/empty-node-slots.js";
 import { PreviewElement, graftPreviewElements, isPreviewElement } from "./spec/preview-elements.js";
-export { AI_LANES, 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 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 Change, type ChangeHook, type ChangeTarget, type ChildrenPolicy, 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, Composite, type ComputedFields, type ComputedInput, type ComputedMap, 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_MUTATIONS, type DanglingDirective, type DanglingLocalRef, type DanglingRef, type DeclaredRuntimeModule, type DeletePlan, type DeriveMembers, type DerivedColor, type DerivedEntityClass, type DerivedOp, Device, type DiffOptions, 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 Gradient, type GroupBody, Guidance, type GuidanceLane, type GuidanceScope, type GuidanceSegment, GuidanceStyle, type GuidanceStyleBody, type HasSnapshot, type HydrationOptions, ICON_METADATA_FORMATS, Icon, type IconLibrary, type IconMemberMetadata, type IconMetadataAdapter, type IconMetadataDeclaration, type IconMetadataFile, type IconMetadataFormat, type IdentifiedOp, type InferredRename, type ItemOf, type KindSignature, type KindSlice, LINK_SLUG, LINK_SLUG_MESSAGE, type LayerElement, type LayerMap, 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 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 PropDecl, type PropDeclaration, type PropMap, 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 RegisteredModifiers, type RegisteredPaths, type RegisteredStyleProps, type RenamePlan, type RenderArgs, type RenderElement, type RenderSpec, type RenderedNode, type RenderedTarget, type ResolveValueTypeInput, type ResolvedSource, SCRIPT_EXTENSIONS, SERIALIZED_CONFIG_VERSION, SIZE_TOLERANCE_PX, 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 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 SurfacePropKind, type SurfaceScalarProp, type SurfaceSlotProp, type SurfaceStylePropertyProp, type SurfaceVariantProp, System, type SystemConfig, SystemSection, SystemSource, Token, type TokenBinding, type TokenBody, type TokenMatch, Tool, type TraverseOptions, type TreeNode, 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, anatomyIssueKey, applyPathDelta, assetType, authoredBag, authoredValue, authoringSignatures, baseOf, blankComponentBody, borrowedGroup, borrowedItem, boundElementType, brandGroup, buildRefGraph, buildRefIndex, canonicalWhen, changeOf, changeValueAt, changesOf, childrenPolicy, className, classPrefixOf, classifyStylePropValue, collectRefs, componentClassBase, componentCompositeClasses, componentLayerClass, componentModuleFilePaths, componentModuleKey, componentModuleSource, componentMotionClasses, componentPropClasses, componentRegistryImports, componentRuleClasses, componentSpec, createCanvasConfig, createSliceMemo, cssPrefixes, cssPropValue, cssProperty, cssPropertyNames, cssValueIssue, cssVar, cssVarRef, danglingDirectives, danglingLocalRefs, danglingSourcedRefs, darken, declaredField, declaredPropRouting, declaredRuntimeModules, defineComponent, defineConfig, defineDerivedEntity, defineEntity, defineOverride, defineSubEntity, deriveCreateSchema, deriveSpec, deriveUpdateSchema, describeBody, describePatch, detectedWireVersion, diffRendered, editOp, entityRefOf, entryKeyOf, expandComponent, expandSpec, fieldKeys, fontFamilyStack, forceModeAttribute, forceModeAttributeOf, forceModeProp, forceModePropGroup, forceModePropValue, forceModeProps, forceStateAttribute, forwardClaims, forwardedLayers, forwardedNames, forwardsOf, globalStyleName, graftPreviewElements, guidanceReaches, guidanceScopeOf, guidanceTextOf, iconCategories, iconLibraries, iconLibrary, iconMemberMetadata, iconMetadata, iconMetadataDeclaration, iconMetadataFile, iconMetadataFileJsonSchema, iconMetadataFormat, inferredRenames, inputOf, instanceSpec, intoName, isAuthored, isBinaryAsset, isConfigFormatError, isConfigRejection, isCssProperty, isDeclaredElementProp, isDerivedColor, isEntityPath, isExtendedRef, isForceModeProp, isGradient, isGroupBody, isLinkSlug, isMintedRow, isNativeConfig, isPlainObject, isPreviewElement, isRef, isSystemConfig, kebabComponent, kindOf, kindsOf, layerRef, layerRoutedProps, layerStyles, leafAddresses, leafVerb, leavesOfStylePropValue, lighten, linearGradient, matchEntities, matchTokens, memberFromLeaf, memberLeaves, memberOf, memberRef, memberVariantOptions, memoryConfigSource, misdeclaredOverlays, mix, modeAxes, modifierAxes, modifierAxis, modifierCategory, modifierGroupFields, modifierInvariants, modifierLeaf, modifierUtilitiesUsed, motionClassName, namedFields, namedSlotTargets, nativeTokenValue, negatedCssValue, normalizeName, normalizeStyleValue, opOf, opVerb, opacityPercentage, opsForKind, orRef, overlayVerb, overrideCondition, overrideKey, overrideKeyModifiers, overrideModifiers, ownValues, ownerOf, ownsItsValues, packageKey, packageName, partsOf, pathDelta, pathOf, pathSegments, planBreak, planCopy, planLink, planUnlink, previewConditionalProps, previewConditions, previewDefaults, previewMatrix, previewSpec, propOwner, propValueDomain, propValueFromAxis, redundantQualifiers, ref, refGraphOf, refLeaf, refSchema, registerSchemaMigrations, renderDerivedColor, renderGradient, renderSignature, renderStyleValue, renderedElement, renderedSignatureOf, renderedTarget, resolutionSchema, resolveComponentProps, resolveFieldValue, resolveIconLibrary, resolveInputDir, resolveOutDir, resolveRegistryDir, resolveTokenValue, resolveTokenValueUnder, resolveValueType, resolveVisibility, resolvedSource, rewriteRefNamespace, rewriteRefSource, rewriteRefs, rnStyleKey, rootLayerOf, routedBag, routedProp, routedPropIn, routesContent, ruleApplies, ruleCondition, runChangeHooks, schemaVersionOf, searchEntities, searchTokens, setAtPath, signatureOf, slotTargetsOf, snapshotHtml, sniffValueType, sourceEntries, sourceOf, sourceOfGroup, sourceOfItem, sourceRowStates, sourceSlugFor, sourceUnavailable, sourceUnreachable, sourceVarPrefix, specWithResolvedVisibility, splitRef, splitStyleProps, stamp, 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, toCssPropertyName, tokenBinding, touchedFields, unadoptedDirectives, unknownStyleLeaves, unreadableBorrows, unstatableConditions, updateRefIndex, upgradeDraftEntries, upgradePatch, upgradeSerializedConfig, validateComponentProps, validateSpec, valueAt, valueLeavesOf, valueRef, valueSchemaOf, varPrefixOf, views, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };
+export { AI_LANES, 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 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 Change, type ChangeHook, type ChangeTarget, type ChildrenPolicy, 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, Composite, type ComputedFields, type ComputedInput, type ComputedMap, 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_MUTATIONS, type DanglingDirective, type DanglingLocalRef, type DanglingRef, type DeclaredRuntimeModule, type DeletePlan, type DeriveMembers, type DerivedColor, type DerivedEntityClass, type DerivedOp, Device, type DiffOptions, 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 Gradient, type GroupBody, Guidance, type GuidanceLane, type GuidanceScope, type GuidanceSegment, GuidanceStyle, type GuidanceStyleBody, type HasSnapshot, type HydrationOptions, ICON_METADATA_FORMATS, Icon, type IconLibrary, type IconMemberMetadata, type IconMetadataAdapter, type IconMetadataDeclaration, type IconMetadataFile, type IconMetadataFormat, type IdentifiedOp, type InferredRename, type ItemOf, type KindSignature, type KindSlice, LINK_SLUG, LINK_SLUG_MESSAGE, type LayerElement, type LayerMap, 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 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 PropDecl, type PropDeclaration, type PropMap, 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 RegisteredModifiers, type RegisteredPaths, type RegisteredStyleProps, type RenamePlan, type RenderArgs, type RenderElement, type RenderSpec, type RenderedNode, type RenderedTarget, type ResolveValueTypeInput, type ResolvedSource, SCRIPT_EXTENSIONS, SERIALIZED_CONFIG_VERSION, SIZE_TOLERANCE_PX, 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 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 SurfacePropKind, type SurfaceScalarProp, type SurfaceSlotProp, type SurfaceStylePropertyProp, type SurfaceVariantProp, System, type SystemConfig, SystemSection, SystemSource, Token, type TokenBinding, type TokenBody, type TokenMatch, Tool, type TraverseOptions, type TreeNode, 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, anatomyIssueKey, applyPathDelta, assetType, authoredBag, authoredValue, authoringSignatures, baseOf, blankComponentBody, borrowedGroup, borrowedItem, boundElementType, brandGroup, buildRefGraph, buildRefIndex, canonicalWhen, changeOf, changeValueAt, changesOf, childrenPolicy, className, classPrefixOf, classifyStylePropValue, collectRefs, componentClassBase, componentCompositeClasses, componentLayerClass, componentModuleFilePaths, componentModuleKey, componentModuleSource, componentMotionClasses, componentPropClasses, componentRegistryImports, componentRuleClasses, componentSpec, createCanvasConfig, createSliceMemo, cssPrefixes, cssPropValue, cssProperty, cssPropertyNames, cssValueIssue, cssVar, cssVarRef, danglingDirectives, danglingLocalRefs, danglingSourcedRefs, darken, declaredField, declaredPropRouting, declaredRuntimeModules, defineComponent, defineConfig, defineDerivedEntity, defineEntity, defineOverride, defineSubEntity, deriveCreateSchema, deriveSpec, deriveUpdateSchema, describeBody, describePatch, detectedWireVersion, diffRendered, editOp, entityRefOf, entryKeyOf, expandComponent, expandSpec, fieldKeys, fontFamilyStack, forceModeAttribute, forceModeAttributeOf, forceModeProp, forceModePropGroup, forceModePropValue, forceModeProps, forceStateAttribute, forwardClaims, forwardedLayers, forwardedNames, forwardsOf, globalStyleName, graftPreviewElements, guidanceReaches, guidanceScopeOf, guidanceTextOf, iconCategories, iconLibraries, iconLibrary, iconMemberMetadata, iconMetadata, iconMetadataDeclaration, iconMetadataFile, iconMetadataFileJsonSchema, iconMetadataFormat, inferredRenames, inputOf, instanceSpec, intoName, isAuthored, isBinaryAsset, isConfigFormatError, isConfigRejection, isCssProperty, isDeclaredElementProp, isDerivedColor, isEntityPath, isExtendedRef, isForceModeProp, isGradient, isGroupBody, isLinkSlug, isMintedRow, isNativeConfig, isPlainObject, isPreviewElement, isRef, isSystemConfig, kebabComponent, kindOf, kindsOf, layerRef, layerRoutedProps, layerStyles, leafAddresses, leafVerb, leavesOfStylePropValue, lighten, linearGradient, liveStateProps, matchEntities, matchTokens, memberFromLeaf, memberLeaves, memberOf, memberRef, memberVariantOptions, memoryConfigSource, misdeclaredOverlays, mix, modeAxes, modifierAxes, modifierAxis, modifierCategory, modifierGroupFields, modifierInvariants, modifierLeaf, modifierUtilitiesUsed, motionClassName, namedFields, namedSlotTargets, nativeTokenValue, negatedCssValue, normalizeName, normalizeStyleValue, opOf, opVerb, opacityPercentage, opsForKind, orRef, overlayVerb, overrideCondition, overrideKey, overrideKeyModifiers, overrideModifiers, ownValues, ownerOf, ownsItsValues, packageKey, packageName, partsOf, pathDelta, pathOf, pathSegments, planBreak, planCopy, planLink, planUnlink, previewConditionalProps, previewConditions, previewDefaults, previewMatrix, previewSpec, propOwner, propValueDomain, propValueFromAxis, readStatePointer, redundantQualifiers, ref, refGraphOf, refLeaf, refSchema, registerSchemaMigrations, renderDerivedColor, renderGradient, renderSignature, renderStyleValue, renderedElement, renderedSignatureOf, renderedTarget, resolutionSchema, resolveComponentProps, resolveFieldValue, resolveIconLibrary, resolveInputDir, resolveOutDir, resolveRegistryDir, resolveTokenValue, resolveTokenValueUnder, resolveValueType, resolveVisibility, resolvedSource, rewriteRefNamespace, rewriteRefSource, rewriteRefs, rnStyleKey, rootLayerOf, routedBag, routedProp, routedPropIn, routesContent, ruleApplies, ruleCondition, runChangeHooks, schemaVersionOf, searchEntities, searchTokens, setAtPath, signatureOf, slotTargetsOf, snapshotHtml, sniffValueType, sourceEntries, sourceOf, sourceOfGroup, sourceOfItem, sourceRowStates, sourceSlugFor, sourceUnavailable, sourceUnreachable, sourceVarPrefix, specWithResolvedVisibility, splitRef, splitStyleProps, stamp, statePointerProp, 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, toCssPropertyName, tokenBinding, touchedFields, unadoptedDirectives, unknownStyleLeaves, unreadableBorrows, unstatableConditions, updateRefIndex, upgradeDraftEntries, upgradePatch, upgradeSerializedConfig, validateComponentProps, validateSpec, valueAt, valueLeavesOf, valueRef, valueSchemaOf, varPrefixOf, views, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };

package/dist/index.js

@@ -26,7 +26,7 @@ import { forwardClaims, forwardedLayers, intoName, routedProp, routedPropIn, rou
 import { graftPreviewElements, isPreviewElement } from "./spec/preview-elements.js";
 import { layerStyles, ruleApplies } from "./framework/layer-styles.js";
 import { componentClassBase, componentCompositeClasses, componentLayerClass, componentMotionClasses, componentPropClasses, componentRuleClasses, forceModeAttribute, forceModeAttributeOf, forceModeProp, forceModePropGroup, forceModePropValue, forceModeProps, forceStateAttribute, isForceModeProp, kebabComponent, layerRoutedProps, modifierUtilitiesUsed, motionClassName, ruleCondition, splitStyleProps, stylePropClassBase, stylePropClassName, stylePropClasses, styleRuleMotionClasses } from "./framework/class-names.js";
-import { boundElementType, componentSpec, deriveSpec, entryKeyOf, expandComponent, expandSpec, instanceSpec, previewSpec, resolveVisibility, slotTargetsOf, specWithResolvedVisibility, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey } from "./framework/render-spec.js";
+import { boundElementType, componentSpec, deriveSpec, entryKeyOf, expandComponent, expandSpec, instanceSpec, liveStateProps, previewSpec, readStatePointer, resolveVisibility, slotTargetsOf, specWithResolvedVisibility, statePointerProp, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey } from "./framework/render-spec.js";
 import { Package } from "./entities/system/Package.js";
 import { File, SCRIPT_EXTENSIONS, isBinaryAsset } from "./entities/system/File.js";
 import { Component, blankComponentBody, canonicalWhen, forwardedNames, layerRef, ownValues, ownsItsValues, valueRef } from "./entities/system/Component.js";
@@ -85,4 +85,4 @@ import { ConfigSession, memoryConfigSource } from "./framework/session.js";
 import { EXPORT_MEMBER, packageKey, packageName } from "./framework/utils/package-path.js";
 import { validateSpec } from "./framework/validate-spec.js";
 import { namedSlotTargets } from "./spec/empty-node-slots.js";
-export { AI_LANES, AiChat, AiFlow, AiGeneration, AiMessage, BUILD_DEFAULTS, BuildSection, CANVAS_ROLES, CONFIG_OPERATION_KIND, CSS_DEFAULTS, CSS_PROPERTY_NAMES, CSS_WIDE_KEYWORDS, CURRENT_SCHEMA_VERSION, Canvas, CanvasConfig, CanvasRole, CanvasSection, Component, Composite, Config, ConfigFormatError, ConfigRejection, ConfigSession, CssSection, DERIVED_MUTATIONS, Device, ENTITY_PATH_MESSAGE, EXPORT_MEMBER, Entity, File, Font, FontFile, GROUP, GUIDANCE_LANES, GlobalStyle, Guidance, GuidanceStyle, ICON_METADATA_FORMATS, Icon, LINK_SLUG, LINK_SLUG_MESSAGE, LinkedSystem, MINTED, MODIFIER_CATEGORIES, Modifier, Motion, NATIVE_ACTIVATIONS, NativeModifier, NativeSettings, NativeStyleProperty, NativeToken, Node, Operation, PLAYGROUND_DEFAULTS, Package, Page, PlaygroundSection, RN_STYLE_KEYS, ReactNativeSystem, SCRIPT_EXTENSIONS, SERIALIZED_CONFIG_VERSION, SIZE_TOLERANCE_PX, STYLE_PROPERTIES, STYLE_PROP_VALUE_FORMS, STYLE_PROP_VALUE_LEAVES, SchemaVersionTooNew, Settings, Snapshot, StyleProperty, System, SystemSection, SystemSource, Token, Tool, UNREACHABLE, VOID_ELEMENTS, WEB_ACTIVATIONS, addressOf, alpha, anatomyIssueKey, applyPathDelta, assetType, authoredBag, authoredValue, authoringSignatures, baseOf, blankComponentBody, borrowedGroup, borrowedItem, boundElementType, brandGroup, buildRefGraph, buildRefIndex, canonicalWhen, changeOf, changeValueAt, changesOf, childrenPolicy, className, classPrefixOf, classifyStylePropValue, collectRefs, componentClassBase, componentCompositeClasses, componentLayerClass, componentModuleFilePaths, componentModuleKey, componentModuleSource, componentMotionClasses, componentPropClasses, componentRegistryImports, componentRuleClasses, componentSpec, createCanvasConfig, createSliceMemo, cssPrefixes, cssPropValue, cssProperty, cssPropertyNames, cssValueIssue, cssVar, cssVarRef, danglingDirectives, danglingLocalRefs, danglingSourcedRefs, darken, declaredField, declaredPropRouting, declaredRuntimeModules, defineComponent, defineConfig, defineDerivedEntity, defineEntity, defineOverride, defineSubEntity, deriveCreateSchema, deriveSpec, deriveUpdateSchema, describeBody, describePatch, detectedWireVersion, diffRendered, editOp, entityRefOf, entryKeyOf, expandComponent, expandSpec, fieldKeys, fontFamilyStack, forceModeAttribute, forceModeAttributeOf, forceModeProp, forceModePropGroup, forceModePropValue, forceModeProps, forceStateAttribute, forwardClaims, forwardedLayers, forwardedNames, forwardsOf, globalStyleName, graftPreviewElements, guidanceReaches, guidanceScopeOf, guidanceTextOf, iconCategories, iconLibraries, iconLibrary, iconMemberMetadata, iconMetadata, iconMetadataDeclaration, iconMetadataFile, iconMetadataFileJsonSchema, iconMetadataFormat, inferredRenames, inputOf, instanceSpec, intoName, isAuthored, isBinaryAsset, isConfigFormatError, isConfigRejection, isCssProperty, isDeclaredElementProp, isDerivedColor, isEntityPath, isExtendedRef, isForceModeProp, isGradient, isGroupBody, isLinkSlug, isMintedRow, isNativeConfig, isPlainObject, isPreviewElement, isRef, isSystemConfig, kebabComponent, kindOf, kindsOf, layerRef, layerRoutedProps, layerStyles, leafAddresses, leafVerb, leavesOfStylePropValue, lighten, linearGradient, matchEntities, matchTokens, memberFromLeaf, memberLeaves, memberOf, memberRef, memberVariantOptions, memoryConfigSource, misdeclaredOverlays, mix, modeAxes, modifierAxes, modifierAxis, modifierCategory, modifierGroupFields, modifierInvariants, modifierLeaf, modifierUtilitiesUsed, motionClassName, namedFields, namedSlotTargets, nativeTokenValue, negatedCssValue, normalizeName, normalizeStyleValue, opOf, opVerb, opacityPercentage, opsForKind, orRef, overlayVerb, overrideCondition, overrideKey, overrideKeyModifiers, overrideModifiers, ownValues, ownerOf, ownsItsValues, packageKey, packageName, partsOf, pathDelta, pathOf, pathSegments, planBreak, planCopy, planLink, planUnlink, previewConditionalProps, previewConditions, previewDefaults, previewMatrix, previewSpec, propOwner, propValueDomain, propValueFromAxis, redundantQualifiers, ref, refGraphOf, refLeaf, refSchema, registerSchemaMigrations, renderDerivedColor, renderGradient, renderSignature, renderStyleValue, renderedElement, renderedSignatureOf, renderedTarget, resolutionSchema, resolveComponentProps, resolveFieldValue, resolveIconLibrary, resolveInputDir, resolveOutDir, resolveRegistryDir, resolveTokenValue, resolveTokenValueUnder, resolveValueType, resolveVisibility, resolvedSource, rewriteRefNamespace, rewriteRefSource, rewriteRefs, rnStyleKey, rootLayerOf, routedBag, routedProp, routedPropIn, routesContent, ruleApplies, ruleCondition, runChangeHooks, schemaVersionOf, searchEntities, searchTokens, setAtPath, signatureOf, slotTargetsOf, snapshotHtml, sniffValueType, sourceEntries, sourceOf, sourceOfGroup, sourceOfItem, sourceRowStates, sourceSlugFor, sourceUnavailable, sourceUnreachable, sourceVarPrefix, specWithResolvedVisibility, splitRef, splitStyleProps, stamp, 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, toCssPropertyName, tokenBinding, touchedFields, unadoptedDirectives, unknownStyleLeaves, unreadableBorrows, unstatableConditions, updateRefIndex, upgradeDraftEntries, upgradePatch, upgradeSerializedConfig, validateComponentProps, validateSpec, valueAt, valueLeavesOf, valueRef, valueSchemaOf, varPrefixOf, views, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };
+export { AI_LANES, AiChat, AiFlow, AiGeneration, AiMessage, BUILD_DEFAULTS, BuildSection, CANVAS_ROLES, CONFIG_OPERATION_KIND, CSS_DEFAULTS, CSS_PROPERTY_NAMES, CSS_WIDE_KEYWORDS, CURRENT_SCHEMA_VERSION, Canvas, CanvasConfig, CanvasRole, CanvasSection, Component, Composite, Config, ConfigFormatError, ConfigRejection, ConfigSession, CssSection, DERIVED_MUTATIONS, Device, ENTITY_PATH_MESSAGE, EXPORT_MEMBER, Entity, File, Font, FontFile, GROUP, GUIDANCE_LANES, GlobalStyle, Guidance, GuidanceStyle, ICON_METADATA_FORMATS, Icon, LINK_SLUG, LINK_SLUG_MESSAGE, LinkedSystem, MINTED, MODIFIER_CATEGORIES, Modifier, Motion, NATIVE_ACTIVATIONS, NativeModifier, NativeSettings, NativeStyleProperty, NativeToken, Node, Operation, PLAYGROUND_DEFAULTS, Package, Page, PlaygroundSection, RN_STYLE_KEYS, ReactNativeSystem, SCRIPT_EXTENSIONS, SERIALIZED_CONFIG_VERSION, SIZE_TOLERANCE_PX, STYLE_PROPERTIES, STYLE_PROP_VALUE_FORMS, STYLE_PROP_VALUE_LEAVES, SchemaVersionTooNew, Settings, Snapshot, StyleProperty, System, SystemSection, SystemSource, Token, Tool, UNREACHABLE, VOID_ELEMENTS, WEB_ACTIVATIONS, addressOf, alpha, anatomyIssueKey, applyPathDelta, assetType, authoredBag, authoredValue, authoringSignatures, baseOf, blankComponentBody, borrowedGroup, borrowedItem, boundElementType, brandGroup, buildRefGraph, buildRefIndex, canonicalWhen, changeOf, changeValueAt, changesOf, childrenPolicy, className, classPrefixOf, classifyStylePropValue, collectRefs, componentClassBase, componentCompositeClasses, componentLayerClass, componentModuleFilePaths, componentModuleKey, componentModuleSource, componentMotionClasses, componentPropClasses, componentRegistryImports, componentRuleClasses, componentSpec, createCanvasConfig, createSliceMemo, cssPrefixes, cssPropValue, cssProperty, cssPropertyNames, cssValueIssue, cssVar, cssVarRef, danglingDirectives, danglingLocalRefs, danglingSourcedRefs, darken, declaredField, declaredPropRouting, declaredRuntimeModules, defineComponent, defineConfig, defineDerivedEntity, defineEntity, defineOverride, defineSubEntity, deriveCreateSchema, deriveSpec, deriveUpdateSchema, describeBody, describePatch, detectedWireVersion, diffRendered, editOp, entityRefOf, entryKeyOf, expandComponent, expandSpec, fieldKeys, fontFamilyStack, forceModeAttribute, forceModeAttributeOf, forceModeProp, forceModePropGroup, forceModePropValue, forceModeProps, forceStateAttribute, forwardClaims, forwardedLayers, forwardedNames, forwardsOf, globalStyleName, graftPreviewElements, guidanceReaches, guidanceScopeOf, guidanceTextOf, iconCategories, iconLibraries, iconLibrary, iconMemberMetadata, iconMetadata, iconMetadataDeclaration, iconMetadataFile, iconMetadataFileJsonSchema, iconMetadataFormat, inferredRenames, inputOf, instanceSpec, intoName, isAuthored, isBinaryAsset, isConfigFormatError, isConfigRejection, isCssProperty, isDeclaredElementProp, isDerivedColor, isEntityPath, isExtendedRef, isForceModeProp, isGradient, isGroupBody, isLinkSlug, isMintedRow, isNativeConfig, isPlainObject, isPreviewElement, isRef, isSystemConfig, kebabComponent, kindOf, kindsOf, layerRef, layerRoutedProps, layerStyles, leafAddresses, leafVerb, leavesOfStylePropValue, lighten, linearGradient, liveStateProps, matchEntities, matchTokens, memberFromLeaf, memberLeaves, memberOf, memberRef, memberVariantOptions, memoryConfigSource, misdeclaredOverlays, mix, modeAxes, modifierAxes, modifierAxis, modifierCategory, modifierGroupFields, modifierInvariants, modifierLeaf, modifierUtilitiesUsed, motionClassName, namedFields, namedSlotTargets, nativeTokenValue, negatedCssValue, normalizeName, normalizeStyleValue, opOf, opVerb, opacityPercentage, opsForKind, orRef, overlayVerb, overrideCondition, overrideKey, overrideKeyModifiers, overrideModifiers, ownValues, ownerOf, ownsItsValues, packageKey, packageName, partsOf, pathDelta, pathOf, pathSegments, planBreak, planCopy, planLink, planUnlink, previewConditionalProps, previewConditions, previewDefaults, previewMatrix, previewSpec, propOwner, propValueDomain, propValueFromAxis, readStatePointer, redundantQualifiers, ref, refGraphOf, refLeaf, refSchema, registerSchemaMigrations, renderDerivedColor, renderGradient, renderSignature, renderStyleValue, renderedElement, renderedSignatureOf, renderedTarget, resolutionSchema, resolveComponentProps, resolveFieldValue, resolveIconLibrary, resolveInputDir, resolveOutDir, resolveRegistryDir, resolveTokenValue, resolveTokenValueUnder, resolveValueType, resolveVisibility, resolvedSource, rewriteRefNamespace, rewriteRefSource, rewriteRefs, rnStyleKey, rootLayerOf, routedBag, routedProp, routedPropIn, routesContent, ruleApplies, ruleCondition, runChangeHooks, schemaVersionOf, searchEntities, searchTokens, setAtPath, signatureOf, slotTargetsOf, snapshotHtml, sniffValueType, sourceEntries, sourceOf, sourceOfGroup, sourceOfItem, sourceRowStates, sourceSlugFor, sourceUnavailable, sourceUnreachable, sourceVarPrefix, specWithResolvedVisibility, splitRef, splitStyleProps, stamp, statePointerProp, 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, toCssPropertyName, tokenBinding, touchedFields, unadoptedDirectives, unknownStyleLeaves, unreadableBorrows, unstatableConditions, updateRefIndex, upgradeDraftEntries, upgradePatch, upgradeSerializedConfig, validateComponentProps, validateSpec, valueAt, valueLeavesOf, valueRef, valueSchemaOf, varPrefixOf, views, visibilityStateProps, visibilityTerms, withoutTruthyTerm, wrappedElementKey };

package/dist/migrations/20260918161049_anatomy_node_actions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * An anatomy node gains an optional `on`: json-render's own event grammar, event name → the
+ * `setState` actions it runs, read off the render's handlers (`onClick={() => !disabled &&
+ * setChecked(!checked)}` is `press` setting `/checked`). A preview runs them so the composition
+ * responds as the component does.
+ *
+ * Nothing stored before this version reshapes. A node without `on` means what its absence always
+ * meant: a node no event does anything to.
+ *
+ * Deletable once no stored artifact predates it.
+ */
+import type { SchemaMigration } from '../framework/schema-version';
+export declare const ANATOMY_NODE_ACTIONS_VERSION = 20260918161049;
+export declare const anatomyNodeActionsMigration: SchemaMigration;

package/dist/migrations/20260918161049_anatomy_node_actions.js

@@ -0,0 +1,10 @@
+//#region src/migrations/20260918161049_anatomy_node_actions.ts
+const ANATOMY_NODE_ACTIONS_VERSION = 20260918161049;
+const anatomyNodeActionsMigration = {
+	version: ANATOMY_NODE_ACTIONS_VERSION,
+	up(json) {
+		return json;
+	}
+};
+//#endregion
+export { ANATOMY_NODE_ACTIONS_VERSION, anatomyNodeActionsMigration };

package/dist/renderer/wrappers/event-bridge.js

@@ -1,5 +1,6 @@
 import React from "react";
 import { useStateStore } from "@json-render/react";
+import { resolveActionParam } from "@json-render/core";
 //#region src/renderer/wrappers/event-bridge.tsx
 /**
 * Map json-render `on.*` event bindings to React callback prop names.
@@ -21,6 +22,14 @@ const EVENT_TO_CALLBACKS = {
 	valueCommit: ["onValueCommit"],
 	dismiss: ["onDismiss"]
 };
+/** `checkedChange` → `onCheckedChange`, `selectedChange` → `onSelectedChange`: the callback a
+*  controlled prop's change is reported through, by the convention every UDS control follows. */
+function changeCallbackOf(eventName) {
+	const match = /^([a-z][A-Za-z0-9]*)Change$/.exec(eventName);
+	if (!match?.[1]) return void 0;
+	const prop = match[1];
+	return [`on${prop[0]?.toUpperCase()}${prop.slice(1)}Change`];
+}
 /**
 * Bridge json-render's `on.*` event bindings to React callback props.
 *
@@ -44,7 +53,7 @@ function wrapEventBridge(reg) {
 		if (!on) return React.createElement(Comp, renderProps);
 		const callbackProps = {};
 		for (const [eventName, binding] of Object.entries(on)) {
-			const callbackNames = EVENT_TO_CALLBACKS[eventName];
+			const callbackNames = EVENT_TO_CALLBACKS[eventName] ?? changeCallbackOf(eventName);
 			if (!callbackNames) continue;
 			const bindings = Array.isArray(binding) ? binding : [binding];
 			const handler = (...args) => {
@@ -52,7 +61,7 @@ function wrapEventBridge(reg) {
 				for (const b of bindings) {
 					const action = b;
 					if (action.action === "setState" && action.params?.statePath) {
-						const val = "value" in (action.params ?? {}) ? action.params.value : callbackValue;
+						const val = "value" in (action.params ?? {}) ? resolveActionParam(action.params.value, { stateModel: stateStore.getSnapshot() }) : callbackValue;
 						stateStore.set(action.params.statePath, val);
 					} else emit(eventName);
 				}