@yahoo/uds-create-config 4.0.3 → 4.0.5

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);
 				}

package/dist/spec/index.d.ts

@@ -1,6 +1,6 @@
 import { AcceptsChildNodes, ChildNodesClassification, ClassifyChildNodes, buildAcceptsChildNodes, buildClassifyChildNodes, namedSlotTargets, stripInjectedSlots, withContainerChildSlots, withEmptyNodeSlots, withRenderSlots } from "./empty-node-slots.js";
 import { GraftableElement, GraftableSpec, PreviewElement, PreviewSpecNode, PreviewValue, graftPreviewElements, hasPreviewElementDeep, isPreviewElement, previewElementNodes, previewElementType } from "./preview-elements.js";
-import { DocumentRename, RewritableSpec, SpecRewrite, rewriteSpecRefs } from "./rewrite-refs.js";
+import { DocumentRename, RewritableSpec, SpecRewrite, documentRenamesFromPatches, rewriteSpecRefs } from "./rewrite-refs.js";
 import { applyForcedModifiers, collectForcedModifierProps } from "./apply-forced-modifiers.js";
 import { AssetComponentMap, AssetJsxForm, AssetNodeResolver, assetJsxForm, jsxIdentifier, parseAssetType } from "./asset-jsx.js";
 import { CollapseTextLabelsResult, CollapsedTextLabel, collapseWrappedTextLabels } from "./collapse-text-labels.js";
@@ -26,4 +26,4 @@ import { SpecToJsxOptions, SpecToJsxResult, specToJsx } from "./specToJsx.js";
  *  element, without changing the rendered layer hierarchy. */
 declare const SYNTHETIC_TEXT_SLOT_PROP = "data-uds-synthetic-text-slot";
 //#endregion
-export { type AcceptsChildNodes, type AssetComponentMap, type AssetJsxForm, type AssetNodeResolver, type ChildNodesClassification, type ClassifyChildNodes, type CollapseTextLabelsResult, type CollapsedTextLabel, type DocumentRename, type GraftableElement, type GraftableSpec, type JsxToSpecOptions, type PreviewElement, type PreviewSpecNode, type PreviewValue, type RewritableSpec, SYNTHETIC_TEXT_SLOT_PROP, type SpecRewrite, type SpecToJsxOptions, type SpecToJsxResult, UNRESOLVED, applyForcedModifiers, assetJsxForm, buildAcceptsChildNodes, buildClassifyChildNodes, collapseWrappedTextLabels, collectForcedModifierProps, graftPreviewElements, hasPreviewElementDeep, hasUnresolvedProps, isPreviewElement, jsxIdentifier, jsxToSpec, namedSlotTargets, parseAssetType, previewElementNodes, previewElementType, rewriteSpecRefs, specToJsx, stripInjectedSlots, stripUnresolvedProps, withContainerChildSlots, withEmptyNodeSlots, withRenderSlots };
+export { type AcceptsChildNodes, type AssetComponentMap, type AssetJsxForm, type AssetNodeResolver, type ChildNodesClassification, type ClassifyChildNodes, type CollapseTextLabelsResult, type CollapsedTextLabel, type DocumentRename, type GraftableElement, type GraftableSpec, type JsxToSpecOptions, type PreviewElement, type PreviewSpecNode, type PreviewValue, type RewritableSpec, SYNTHETIC_TEXT_SLOT_PROP, type SpecRewrite, type SpecToJsxOptions, type SpecToJsxResult, UNRESOLVED, applyForcedModifiers, assetJsxForm, buildAcceptsChildNodes, buildClassifyChildNodes, collapseWrappedTextLabels, collectForcedModifierProps, documentRenamesFromPatches, graftPreviewElements, hasPreviewElementDeep, hasUnresolvedProps, isPreviewElement, jsxIdentifier, jsxToSpec, namedSlotTargets, parseAssetType, previewElementNodes, previewElementType, rewriteSpecRefs, specToJsx, stripInjectedSlots, stripUnresolvedProps, withContainerChildSlots, withEmptyNodeSlots, withRenderSlots };

package/dist/spec/index.js

@@ -4,7 +4,7 @@ import { buildAcceptsChildNodes, buildClassifyChildNodes, namedSlotTargets, stri
 import { applyForcedModifiers, collectForcedModifierProps } from "./apply-forced-modifiers.js";
 import { collapseWrappedTextLabels } from "./collapse-text-labels.js";
 import { UNRESOLVED, hasUnresolvedProps, jsxToSpec, stripUnresolvedProps } from "./jsxToSpec.js";
-import { rewriteSpecRefs } from "./rewrite-refs.js";
+import { documentRenamesFromPatches, rewriteSpecRefs } from "./rewrite-refs.js";
 import { specToJsx } from "./specToJsx.js";
 //#region src/spec/index.ts
 /**
@@ -25,4 +25,4 @@ import { specToJsx } from "./specToJsx.js";
 *  element, without changing the rendered layer hierarchy. */
 const SYNTHETIC_TEXT_SLOT_PROP = "data-uds-synthetic-text-slot";
 //#endregion
-export { SYNTHETIC_TEXT_SLOT_PROP, UNRESOLVED, applyForcedModifiers, assetJsxForm, buildAcceptsChildNodes, buildClassifyChildNodes, collapseWrappedTextLabels, collectForcedModifierProps, graftPreviewElements, hasPreviewElementDeep, hasUnresolvedProps, isPreviewElement, jsxIdentifier, jsxToSpec, namedSlotTargets, parseAssetType, previewElementNodes, previewElementType, rewriteSpecRefs, specToJsx, stripInjectedSlots, stripUnresolvedProps, withContainerChildSlots, withEmptyNodeSlots, withRenderSlots };
+export { SYNTHETIC_TEXT_SLOT_PROP, UNRESOLVED, applyForcedModifiers, assetJsxForm, buildAcceptsChildNodes, buildClassifyChildNodes, collapseWrappedTextLabels, collectForcedModifierProps, documentRenamesFromPatches, graftPreviewElements, hasPreviewElementDeep, hasUnresolvedProps, isPreviewElement, jsxIdentifier, jsxToSpec, namedSlotTargets, parseAssetType, previewElementNodes, previewElementType, rewriteSpecRefs, specToJsx, stripInjectedSlots, stripUnresolvedProps, withContainerChildSlots, withEmptyNodeSlots, withRenderSlots };

package/dist/spec/rewrite-refs.d.ts

@@ -35,6 +35,18 @@ type DocumentRename = /** A component's path — `element.type` and a node's own
   readonly from: string;
   readonly to: string;
 };
+/**
+ * The renames a list of patches recorded, oldest first — the only source that names both halves of every case.
+ *
+ * A renamed prop, variant value, layer, style property, token or modifier leaves no trace in the set of paths a
+ * config holds, and a component renamed to an unrelated name is indistinguishable from a delete plus a create.
+ * The patch says what happened, so nothing here has to infer it. That makes this the one place a rename becomes
+ * a document rewrite, whatever recorded the patch: a config's own pending edits, or a branch's stored rows.
+ *
+ * Replay order is preserved because renames compose — a component renamed twice in one draft only lands on the
+ * last name if the pairs are applied in the order they were made.
+ */
+declare function documentRenamesFromPatches(patches: readonly Record<string, unknown>[]): DocumentRename[];
 /** A spec as this reads it: the structural subset, loose because the rows are whatever was written months ago. */
 interface RewritableSpec {
   elements?: Record<string, {
@@ -55,4 +67,4 @@ interface SpecRewrite {
  */
 declare function rewriteSpecRefs(config: Config, spec: RewritableSpec, renames: readonly DocumentRename[]): SpecRewrite;
 //#endregion
-export { DocumentRename, RewritableSpec, SpecRewrite, rewriteSpecRefs };
+export { DocumentRename, RewritableSpec, SpecRewrite, documentRenamesFromPatches, rewriteSpecRefs };

package/dist/spec/rewrite-refs.js

@@ -12,36 +12,99 @@ import { Component } from "../entities/system/Component.js";
 * the config cascades through `cascadeRename` — which walks the ref index — and reaches none of the documents,
 * because a document holds no ref that index can see.
 *
-* So the rename has to be applied here, and the difficulty is that a spec's positions are CONTEXT-DEPENDENT:
+* So the rename has to be applied here, and the difficulty is that a spec's positions are context-dependent:
 *
 *  - `props.variant` is `Button`'s own prop only on elements whose type is `Button`. Rewriting the key wherever
 *    it appears would rename an unrelated component's `variant` too.
-*  - `props.bg` is the `bg` STYLE PROPERTY — unless the element's component declares its own `bg`, in which case
+*  - `props.bg` is the `bg` style property — unless the element's component declares its own `bg`, in which case
 *    the component's declaration wins and a style-property rename must leave it alone.
-*  - `props.bg = 'primary'` is a token LEAF inside whatever group the `bg` style property draws from, so a token
+*  - `props.bg = 'primary'` is a token leaf inside whatever group the `bg` style property draws from, so a token
 *    rename only touches values on props that draw from that token's group.
 *
 * Every one of those questions is answered by the config (`resolveComponentProps`, the prop's declaration, the
 * style property's own `values`), which is why this takes one and resolves rather than matching strings.
 *
-* A MODIFIER is the one position that answers for itself. `_hover` is a prop bag keyed by a modifier's path, and
+* A modifier is the one position that answers for itself. `_hover` is a prop bag keyed by a modifier's path, and
 * nothing else in a spec is `_`-prefixed — a component can't declare such a prop, and both the style resolver and
 * the prop validator skip the prefix on sight. So a modifier rename moves the key unconditionally, with no
-* component to scope it by. What the block CONTAINS is a second props bag against the same element, which is why
-* every other rename here descends into it: `_hover: { bg: 'accent' }` sets the same style property and the same
-* token as the bag around it, and stopping at the top level would leave the conditional half of a component
+* component to scope it by. The block it prefixes contains a second props bag against the same element, which is
+* why every other rename here descends into it: `_hover: { bg: 'accent' }` sets the same style property and the
+* same token as the bag around it, and stopping at the top level would leave the conditional half of a component
 * stale while the base half moved.
 *
-* `layerProps` is the same shape with one twist: its keys are the component's LAYER names, and each bag under one
-* belongs to what that layer RENDERS rather than to the component around it. So a layer rename moves the key —
+* `layerProps` is the same shape with one twist: its keys are the component's layer names, and each bag under one
+* belongs to what that layer renders rather than to the component around it. So a layer rename moves the key —
 * scoped to its component, since `text` on one component is a different layer from `text` on another — and every
 * other rename descends with the layer's own declarations, because `layerProps.text.variant` is `Text`'s variant.
 * A layer that renders a component can itself be overridden through `layerProps`, and that nests the same way.
 *
-* Renames arrive TYPED and EXACT, from the patch that recorded them — never inferred. The config supports a
+* Renames arrive typed and exact, from the patch that recorded them, never inferred. The config supports a
 * rename op per kind and a sub-rename for a component's `props` and `props/value`, so the patch log names both
 * halves of every case below.
 */
+/**
+* The renames a list of patches recorded, oldest first — the only source that names both halves of every case.
+*
+* A renamed prop, variant value, layer, style property, token or modifier leaves no trace in the set of paths a
+* config holds, and a component renamed to an unrelated name is indistinguishable from a delete plus a create.
+* The patch says what happened, so nothing here has to infer it. That makes this the one place a rename becomes
+* a document rewrite, whatever recorded the patch: a config's own pending edits, or a branch's stored rows.
+*
+* Replay order is preserved because renames compose — a component renamed twice in one draft only lands on the
+* last name if the pairs are applied in the order they were made.
+*/
+function documentRenamesFromPatches(patches) {
+	const renames = [];
+	for (const patch of patches) {
+		const { kind, operation, path, to, field, key } = patch;
+		if (typeof to !== "string" || typeof path !== "string") continue;
+		if (operation === "rename") {
+			if (kind === "component" && path !== to) renames.push({
+				kind: "component",
+				from: path,
+				to
+			});
+			else if (kind === "style-property" && path !== to) renames.push({
+				kind: "style-property",
+				from: path,
+				to
+			});
+			else if (kind === "token" && path !== to) renames.push({
+				kind: "token",
+				from: path,
+				to
+			});
+			else if (kind === "modifier" && path !== to) renames.push({
+				kind: "modifier",
+				from: path,
+				to
+			});
+			continue;
+		}
+		if (operation === "sub-rename" && kind === "component") {
+			if (field === "props" && typeof key === "string" && key !== to) renames.push({
+				kind: "component-prop",
+				component: path,
+				from: key,
+				to
+			});
+			else if (field === "layers" && typeof key === "string" && key !== to) renames.push({
+				kind: "layer",
+				component: path,
+				from: key,
+				to
+			});
+			else if (field === "props/value" && typeof key === "string" && typeof patch.prop === "string" && key !== to) renames.push({
+				kind: "variant-value",
+				component: path,
+				prop: patch.prop,
+				from: key,
+				to
+			});
+		}
+	}
+	return renames;
+}
 /** Whether a stored `type` names this component path, in either form it may be written in. */
 function namesComponent(type, path) {
 	if (typeof type !== "string") return false;
@@ -247,4 +310,4 @@ function rewriteSpecRefs(config, spec, renames) {
 	};
 }
 //#endregion
-export { rewriteSpecRefs };
+export { documentRenamesFromPatches, rewriteSpecRefs };