@yahoo/uds-create-cli 5.70.0 → 5.71.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahoo/uds-create-cli",
-  "version": "5.70.0",
+  "version": "5.71.0",
   "publishConfig": {
     "access": "public"
   },
@@ -32,10 +32,10 @@
     "@modelcontextprotocol/sdk": "^1.32.2",
     "@orpc/client": "^1.13.9",
     "@orpc/contract": "^1.13.9",
-    "@yahoo/uds-create-config": "5.70.0",
-    "@yahoo/uds-create-loader": "5.70.0",
-    "@yahoo/uds-create-types": "5.70.0",
-    "@yahoo/uds-create-utils": "5.70.0",
+    "@yahoo/uds-create-config": "5.71.0",
+    "@yahoo/uds-create-loader": "5.71.0",
+    "@yahoo/uds-create-types": "5.71.0",
+    "@yahoo/uds-create-utils": "5.71.0",
     "esbuild": "^0.27.4",
     "ts-morph": "^27.0.2",
     "get-tsconfig": "^4.10.0",
@@ -52,13 +52,13 @@
     "lodash": "^4.17.23",
     "prettier": "^3.8.1"
   },
-  "udsSchemaVersion": 20261102185610,
+  "udsSchemaVersion": 20261102193912,
   "optionalDependencies": {
-    "@yahoo/uds-create-cli-darwin-arm64": "5.70.0",
-    "@yahoo/uds-create-cli-darwin-x64": "5.70.0",
-    "@yahoo/uds-create-cli-linux-arm64": "5.70.0",
-    "@yahoo/uds-create-cli-linux-x64": "5.70.0",
-    "@yahoo/uds-create-cli-linux-arm64-musl": "5.70.0",
-    "@yahoo/uds-create-cli-linux-x64-musl": "5.70.0"
+    "@yahoo/uds-create-cli-darwin-arm64": "5.71.0",
+    "@yahoo/uds-create-cli-darwin-x64": "5.71.0",
+    "@yahoo/uds-create-cli-linux-arm64": "5.71.0",
+    "@yahoo/uds-create-cli-linux-x64": "5.71.0",
+    "@yahoo/uds-create-cli-linux-arm64-musl": "5.71.0",
+    "@yahoo/uds-create-cli-linux-x64-musl": "5.71.0"
   }
 }

package/subprocess/transform-runner.mjs

@@ -83515,6 +83515,13 @@ var propMappingRuleSchema = external_exports.object({
   unset: external_exports.array(external_exports.string()).optional().describe("The props to remove. A prop the rule matches on stays unless it is named here, so a removed prop has to be.")
 });
 var propMappingRulesSchema = external_exports.array(propMappingRuleSchema).min(1).describe("Every rule whose `when` matches an instance as stored applies to it, so separate props are mapped by separate rules, and a combination by one rule naming both.");
+var swapMappingRulesSchema = external_exports.array(propMappingRuleSchema).describe("The rules for the swapped instances, as a mapping has them. `when: {}` applies to every one of them (to `unset` a prop the new component lacks), and none keeps their props as they are.");
+var mapPropsRulesSchema = external_exports.array(propMappingRuleSchema).default([]).describe("Every rule whose `when` matches an instance as stored applies to it, so separate props are mapped by separate rules, and a combination by one rule naming both. A mapping needs at least one. With `from`, none keeps the swapped instances' props, and `when: {}` reaches every swapped instance.");
+var mappingScopeSchema = external_exports.object({
+  canvas: external_exports.string().min(1).describe("The design file's canvas id."),
+  nodes: external_exports.array(external_exports.string().min(1)).min(1).describe("The ids of the nodes it reaches, in that design file.")
+}).describe("Create only: limits the mapping to these nodes of one design file, for fixing one instance before asking about the rest. A checkout's call sites aren't nodes, so there it isn't taken.");
+var mappingFromSchema = external_exports.string().min(1).describe("The component whose instances become this one's, as a path: the one a design file still names after the system lost it (`SelectContent`, replaced by `SelectMenu`). It needn't exist. Which component replaces which is the user's call: propose it, and apply it only once they confirm.");
 function valueRefusal(config2, component, prop, value) {
   if (typeof value !== "string" || value.startsWith("[")) return void 0;
   if (prop.kind === "variant" || prop.kind === "slot") return prop.values && !prop.values.includes(value) ? `"${value}", which isn't one of its values (${prop.values.join(", ")})` : void 0;
@@ -83524,9 +83531,10 @@ function valueRefusal(config2, component, prop, value) {
 }
 function propMappingErrors(config2, mapping) {
   if (!config2.resolve("component", mapping.component)) return [`No component "${mapping.component}"`];
+  if (mapping.from === mapping.component) return [`"${mapping.component}" can't replace itself: \`from\` names the component its instances are now`];
   const errors = [];
   mapping.rules.forEach((rule, i) => {
-    if (Object.keys(rule.when).length === 0) errors.push(`Rule ${i + 1} matches every instance: name what it matches in \`when\``);
+    if (Object.keys(rule.when).length === 0 && mapping.from === void 0) errors.push(`Rule ${i + 1} matches every instance: name what it matches in \`when\``);
     for (const [name, value] of Object.entries(rule.set ?? {})) {
       const prop = surfaceProp(config2, mapping.component, name);
       if (!prop) {
@@ -83567,6 +83575,10 @@ function mapBag(bag, rules) {
     bag: next
   };
 }
+function retyped(type, to) {
+  const at = type.lastIndexOf("@");
+  return `component:${to}${type.includes(":") && at > 0 ? type.slice(at) : ""}`;
+}
 function mapProps(walk, component, props, at) {
   let next;
   if (component === walk.mapping.component) {
@@ -83617,8 +83629,10 @@ function applyPropMapping(config2, spec2, mapping) {
   let elements;
   let changed = 0;
   const conflicts = [];
+  const reached = mapping.only ? new Set(mapping.only.nodes) : void 0;
   for (const [key2, element2] of Object.entries(spec2.elements ?? {})) {
-    if (!element2?.props) continue;
+    if (!element2) continue;
+    if (reached && !reached.has(key2)) continue;
     const walk = {
       config: config2,
       mapping,
@@ -83626,14 +83640,18 @@ function applyPropMapping(config2, spec2, mapping) {
       conflicts,
       changed: 0
     };
-    const props = mapProps(walk, componentOf(element2.type), element2.props, "props");
-    if (!props) continue;
+    const component = componentOf(element2.type);
+    const swapped = mapping.from !== void 0 && component === mapping.from && typeof element2.type === "string";
+    if (!swapped && !element2.props) continue;
+    const props = mapProps(walk, swapped ? mapping.component : component, element2.props ?? {}, "props");
+    if (!props && !swapped) continue;
     elements ??= { ...spec2.elements };
     elements[key2] = {
       ...element2,
-      props
+      ...swapped ? { type: retyped(element2.type, mapping.component) } : {},
+      ...props ? { props } : {}
     };
-    changed += walk.changed;
+    changed += walk.changed + (swapped && walk.changed === 0 ? 1 : 0);
   }
   return elements ? {
     spec: {
@@ -83655,7 +83673,7 @@ function mapComponentProps(config2, mapping, instances) {
     errors
   };
   const { spec: spec2, conflicts } = applyPropMapping(config2, { elements: Object.fromEntries(instances.map((props, i) => [String(i), {
-    type: `component:${mapping.component}`,
+    type: `component:${mapping.from ?? mapping.component}`,
     props
   }])) }, mapping);
   return {
@@ -83664,7 +83682,7 @@ function mapComponentProps(config2, mapping, instances) {
       const after5 = spec2.elements?.[String(i)]?.props ?? props;
       return {
         props: after5,
-        changed: after5 !== props,
+        changed: after5 !== props || mapping.from !== void 0,
         conflicts: conflicts.filter((conflict) => conflict.element === String(i)).flatMap((conflict) => conflict.props)
       };
     })
@@ -87099,12 +87117,16 @@ var ComponentEntity = defineEntity({
     "map-props": {
       input: external_exports.object({
         path: pathInput("component"),
-        data: external_exports.object({ rules: propMappingRulesSchema })
+        data: external_exports.object({
+          from: mappingFromSchema.optional(),
+          only: mappingScopeSchema.optional(),
+          rules: mapPropsRulesSchema
+        })
       }),
       readOnly: false,
       approval: "reference-change",
       label: "Map props",
-      description: "Move a component's instances onto its props as they are now, after its API changed: `variant: 'primary'` becomes `color: 'brand', prominence: 'solid'`. It changes nothing in the config. Where it runs decides what it moves: in Create, the instances in the branch's design files; in a checkout (`uds config edit`, the local UDS MCP), the call sites in the project's source. Refuses a rule that writes a prop or value the component doesn't take. Run it with `plan: true` first: the plan says what it would move, and writes nothing.",
+      description: "Move a component's instances onto its props as they are now, after its API changed: `variant: 'primary'` becomes `color: 'brand', prominence: 'solid'`. It changes nothing in the config. Where it runs decides what it moves: in Create, the instances in the branch's design files; in a checkout (`uds config edit`, the local UDS MCP), the call sites in the project's source. With `from`, it swaps the component too: instances of `from`, a component the system may no longer have, become this component's, and the rules move their props onto it (`when: {}` reaches every swapped instance). Refuses a rule that writes a prop or value the component doesn't take. Run it with `plan: true` first: the plan says what it would move, and writes nothing.",
       scope: "item",
       title: (entity) => `Map ${entity} props`,
       example: ({ config: config2, path: path2 }) => {
@@ -87115,10 +87137,7 @@ var ComponentEntity = defineEntity({
         };
       },
       handler: (input2, config2) => {
-        const errors = propMappingErrors(config2, {
-          component: String(input2.path),
-          rules: input2.data.rules
-        });
+        const errors = propMappingErrors(config2, mappingOf(String(input2.path), input2.data));
         if (errors.length > 0) rejectData(errors.join(" "));
         return config2;
       }
@@ -87127,7 +87146,8 @@ var ComponentEntity = defineEntity({
       input: external_exports.object({
         path: pathInput("component"),
         data: external_exports.object({
-          rules: propMappingRulesSchema,
+          from: mappingFromSchema.optional(),
+          rules: mapPropsRulesSchema,
           instances: external_exports.array(external_exports.record(external_exports.string(), external_exports.unknown())).default([]).describe("Instances' props as they are stored or written: each comes back with the rules applied.")
         })
       }),
@@ -87139,10 +87159,7 @@ var ComponentEntity = defineEntity({
       example: ({ config: config2, path: path2 }) => exampleMapping(config2, path2),
       handler: (input2, config2) => {
         const data = input2.data;
-        return mapComponentProps(config2, {
-          component: String(input2.path),
-          rules: data.rules
-        }, data.instances ?? []);
+        return mapComponentProps(config2, mappingOf(String(input2.path), input2.data), data.instances ?? []);
       }
     }
   },
@@ -87257,6 +87274,16 @@ function exampleProps(config2, componentPath) {
   }
   return {};
 }
+function mappingOf(component, data) {
+  const { from, only, rules = [] } = data ?? {};
+  if (from === void 0 && rules.length === 0) rejectData("Name at least one rule in `rules`, or `from` to swap another component's instances onto this one.");
+  return {
+    component,
+    ...from === void 0 ? {} : { from: from.replace(/^component:/, "") },
+    ...only === void 0 ? {} : { only },
+    rules
+  };
+}
 function exampleMapping(config2, componentPath) {
   const instance = exampleProps(config2, componentPath);
   const [name, value] = Object.entries(instance)[0] ?? [];
@@ -89766,7 +89793,7 @@ var Entity = class {
 };
 
 // ../config/dist/framework/schema-version.js
-var CURRENT_SCHEMA_VERSION = 20261102185610;
+var CURRENT_SCHEMA_VERSION = 20261102193912;
 var SETTINGS_AS_KIND_VERSION = 20260908171448;
 var SchemaVersionTooNew = class extends ConfigFormatError {
   found;
@@ -89786,7 +89813,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 \u2014 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 > 20261102185610) throw new Error(`Schema migration ${migration.version} is newer than CURRENT_SCHEMA_VERSION (${CURRENT_SCHEMA_VERSION}) \u2014 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 > 20261102193912) throw new Error(`Schema migration ${migration.version} is newer than CURRENT_SCHEMA_VERSION (${CURRENT_SCHEMA_VERSION}) \u2014 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);
   }
 }
@@ -89817,7 +89844,7 @@ function pendingFor(version2, target2, options) {
   return [...(options?.migrations ?? REGISTERED).values()].filter((m) => m.version > version2 && m.version <= target2).sort((a, b) => a.version - b.version);
 }
 function upgradeSerializedConfig(json2, options) {
-  const target2 = options?.target ?? 20261102185610;
+  const target2 = options?.target ?? 20261102193912;
   const version2 = detectedWireVersion(json2);
   if (version2 > target2) throw new SchemaVersionTooNew(version2, target2);
   const raw = json2;
@@ -96703,7 +96730,7 @@ var Config = class Config2 {
   *  links from the provided sources. A declared `linkedKind` with no provided source throws. */
   hydrateFrom(stored, options) {
     const claimed = schemaVersionOf(stored);
-    if (claimed > 20261102185610) throw new SchemaVersionTooNew(claimed);
+    if (claimed > 20261102193912) 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 \u2014 import the config type's module (e.g. \`configs/system\`) before hydrating.`);
     const leftover = wire.options;
@@ -100271,6 +100298,15 @@ var linkReplaceMigration = {
   up: (json2) => json2
 };
 
+// ../config/dist/migrations/20261102193912_map_props_from.js
+var MAP_PROPS_FROM_VERSION = 20261102193912;
+var mapPropsFromMigration = {
+  version: MAP_PROPS_FROM_VERSION,
+  up(json2) {
+    return json2;
+  }
+};
+
 // ../../node_modules/css-tree/lib/generator/sourceMap.js
 var import_source_map_generator = __toESM(require_source_map_generator(), 1);
 var trackNodes = /* @__PURE__ */ new Set(["Atrule", "Selector", "Declaration"]);
@@ -103009,6 +103045,7 @@ if (!registeredSchemaMigrations().has(20261030134149)) registerSchemaMigrations(
 if (!registeredSchemaMigrations().has(20261030163028)) registerSchemaMigrations(layerPrefixMigration);
 if (!registeredSchemaMigrations().has(20261102143821)) registerSchemaMigrations(defaultColorsMigration);
 if (!registeredSchemaMigrations().has(20261102185610)) registerSchemaMigrations(linkReplaceMigration);
+if (!registeredSchemaMigrations().has(20261102193912)) registerSchemaMigrations(mapPropsFromMigration);
 
 // ../config/dist/capture/node-ops.js
 var DEFAULT_WIDTH = 1600;