@yahoo/uds-create-cli 5.68.5 → 5.70.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahoo/uds-create-cli",
-  "version": "5.68.5",
+  "version": "5.70.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.68.5",
-    "@yahoo/uds-create-loader": "5.68.5",
-    "@yahoo/uds-create-types": "5.68.5",
-    "@yahoo/uds-create-utils": "5.68.5",
+    "@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",
     "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": 20261030163028,
+  "udsSchemaVersion": 20261102185610,
   "optionalDependencies": {
-    "@yahoo/uds-create-cli-darwin-arm64": "5.68.5",
-    "@yahoo/uds-create-cli-darwin-x64": "5.68.5",
-    "@yahoo/uds-create-cli-linux-arm64": "5.68.5",
-    "@yahoo/uds-create-cli-linux-x64": "5.68.5",
-    "@yahoo/uds-create-cli-linux-arm64-musl": "5.68.5",
-    "@yahoo/uds-create-cli-linux-x64-musl": "5.68.5"
+    "@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"
   }
 }

package/subprocess/transform-runner.mjs

@@ -31026,11 +31026,11 @@ var require_scope = __commonJS({
         }
         const {
           init,
-          unique: unique2,
+          unique: unique3,
           kind = "var",
           id
         } = opts;
-        if (!init && !unique2 && (kind === "var" || kind === "let") && isAnonymousFunctionExpression(path2) && isCallExpression2(path2.parent, {
+        if (!init && !unique3 && (kind === "var" || kind === "let") && isAnonymousFunctionExpression(path2) && isCallExpression2(path2.parent, {
           callee: path2.node
         }) && path2.parent.arguments.length <= path2.node.params.length && isIdentifier4(id)) {
           path2.pushContainer("params", id);
@@ -31043,12 +31043,12 @@ var require_scope = __commonJS({
         }
         const blockHoist = opts._blockHoist == null ? 2 : opts._blockHoist;
         const dataKey = `declaration:${kind}:${blockHoist}`;
-        let declarPath = !unique2 && path2.getData(dataKey);
+        let declarPath = !unique3 && path2.getData(dataKey);
         if (!declarPath) {
           const declar = variableDeclaration(kind, []);
           declar._blockHoist = blockHoist;
           [declarPath] = path2.unshiftContainer("body", [declar]);
-          if (!unique2) path2.setData(dataKey, declarPath);
+          if (!unique3) path2.setData(dataKey, declarPath);
         }
         const declarator = variableDeclarator(id, init);
         const len = declarPath.node.declarations.push(declarator);
@@ -63636,6 +63636,9 @@ function blockedBy(attempt) {
     throw error61;
   }
 }
+function unique(refs) {
+  return [...new Set(refs)];
+}
 function addresses(targets) {
   return targets.map((target2) => {
     const { kind, qualifiedPath } = splitRef2(target2);
@@ -63652,13 +63655,17 @@ function planRename({ config: config2, kind, path: path2, to }) {
     path: path2,
     to
   }]));
-  const throughSource = config2.sourceDependentsOf(kind, path2);
+  const moves = config2.renamedParts(kind, path2, to);
+  const moving = [path2, ...moves.map((move2) => move2.from)];
+  const throughSource = unique(moving.flatMap((from) => config2.sourceDependentsOf(kind, from)));
   const drawn = new Set(throughSource);
+  const moved = new Set(moving.map((from) => `${kind}:${from}`));
   return {
     from: path2,
     to,
-    rewrites: addresses(config2.dependentsOf(kind, path2).filter((ref2) => !drawn.has(ref2))),
+    rewrites: addresses(unique(moving.flatMap((from) => config2.dependentsOf(kind, from))).filter((ref2) => !drawn.has(ref2) && !moved.has(ref2))),
     throughSource: addresses(throughSource),
+    ...moves.length > 0 ? { moves } : {},
     ...blocked === void 0 ? {} : { blocked }
   };
 }
@@ -65153,7 +65160,7 @@ function titleCase(kind) {
   return kind.split(/[-_]/).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
 function buildKind(spec2) {
-  const { name, prepareLinkedBody, rebaseLinkedBody, layerKeys, fields, groupFields, subEntities = {}, computed, label, labelPlural, schemas: userSchemas, derived, sourceIdentity, sourceOrigin, authoredRefs, linkable, localGroupFields, emergentGroups, singleton = false, bareMember, sourceResolution, bulkAdopts, bulkExcludes, bulkOverlay, bulkDirectives, bulkOverlayWrite, nameEdges, rewriteName, styleBags, uniqueLeaves, authoredValue: authoredValue2, mentionFields, invariants, structuralBody, authoredBody, sourceType, answeredHere } = spec2;
+  const { name, prepareLinkedBody, rebaseLinkedBody, layerKeys, fields, groupFields, subEntities = {}, computed, label, labelPlural, schemas: userSchemas, derived, sourceIdentity, sourceOrigin, authoredRefs, linkable, localGroupFields, emergentGroups, singleton = false, bareMember, sourceResolution, bulkAdopts, bulkExcludes, bulkOverlay, bulkDirectives, bulkOverlayWrite, nameEdges, rewriteName, styleBags, uniqueLeaves, parts, authoredValue: authoredValue2, mentionFields, invariants, structuralBody, authoredBody, sourceType, answeredHere } = spec2;
   const allComputed = {
     sources: ({ member, config: config2 }) => sourceSlugs(member, config2),
     borrowedFrom: ({ config: config2, path: path2 }) => config2.borrowedFrom(name, path2),
@@ -65202,6 +65209,7 @@ function buildKind(spec2) {
     rewriteName,
     styleBags,
     ...uniqueLeaves ? { uniqueLeaves } : {},
+    ...parts ? { parts } : {},
     ...authoredValue2 ? { authoredValue: authoredValue2 } : {},
     ...mentionFields?.length ? { mentionFields } : {},
     ...invariants ? { invariants } : {},
@@ -65340,6 +65348,7 @@ function defineEntity(spec2) {
     styleBags: spec2.styleBags,
     rewriteName: spec2.rewriteName,
     uniqueLeaves: spec2.uniqueLeaves,
+    parts: spec2.parts,
     authoredValue: spec2.authoredValue,
     mentionFields: spec2.mentionFields,
     invariants: spec2.invariants,
@@ -70853,6 +70862,29 @@ var LintSection = defineSubEntity({
   singleton: true,
   fields: lintFields
 });
+var defaultColorValue = external_exports.union([external_exports.string().min(1), refTo("token")]);
+var defaultColor = external_exports.union([defaultColorValue, external_exports.strictObject({
+  value: defaultColorValue,
+  output: external_exports.boolean().optional()
+})]);
+var defaultsFields = external_exports.strictObject({
+  background: defaultColor.meta({
+    title: "Background",
+    valueType: "color",
+    description: "The background this system's components sit on: a CSS colour (`#ffffff`) or a token (`Token.ref('color/surface')`). The stylesheet sets it on `body`, and Create paints it behind a component's matrix cells, under the modes picked there. `{ value, output: false }` keeps it out of the stylesheet. Unset, neither paints one."
+  }).optional(),
+  color: defaultColor.meta({
+    title: "Text color",
+    valueType: "color",
+    description: "The text colour this system's components inherit: a CSS colour or a token. The stylesheet sets it on `body`, and Create applies it to a component's matrix cells, under the modes picked there. `{ value, output: false }` keeps it out of the stylesheet. Unset, neither sets one."
+  }).optional()
+});
+var DefaultsSection = defineSubEntity({
+  name: "defaults",
+  label: "Defaults",
+  singleton: true,
+  fields: defaultsFields
+});
 var foldersOf = (file2) => file2.split("/").slice(0, -1);
 function sharedFolders(lists) {
   return lists.reduce((shared, folders) => {
@@ -70927,14 +70959,16 @@ var Settings = defineEntity({
     build: buildFields.meta({ title: "Build" }).optional(),
     css: cssFields.meta({ title: "CSS" }).optional(),
     playground: playgroundFields.meta({ title: "Playground" }).optional(),
-    lint: lintFields.meta({ title: "Lint" }).optional()
+    lint: lintFields.meta({ title: "Lint" }).optional(),
+    defaults: defaultsFields.meta({ title: "Defaults" }).optional()
   }),
   subEntities: {
     system: SystemSection,
     build: BuildSection,
     css: CssSection,
     playground: PlaygroundSection,
-    lint: LintSection
+    lint: LintSection,
+    defaults: DefaultsSection
   },
   computed: {
     /**
@@ -84646,6 +84680,14 @@ function freeLayerKey(config2, path2, hint = "el") {
   while (taken.has(`${hint}${ordinal}`)) ordinal += 1;
   return `${hint}${ordinal}`;
 }
+function duplicateLayerKey({ config: config2, path: path2, source }) {
+  const body = config2.resolve("component", path2)?.toJSON();
+  const taken = /* @__PURE__ */ new Set([...Object.keys(body?.layers ?? {}), ...Object.keys(body?.anatomy ?? {})]);
+  const base = source.replace(/\d+$/, "") || source;
+  let ordinal = 2;
+  while (taken.has(`${base}${ordinal}`)) ordinal += 1;
+  return `${base}${ordinal}`;
+}
 function asElementRef(config2, value) {
   if (typeof value !== "string") return value;
   const { kind, qualifiedPath } = splitRef2(value);
@@ -86146,6 +86188,7 @@ function withoutProps(conditions, names) {
 }
 var ComponentEntity = defineEntity({
   kind: "component",
+  parts: true,
   rebaseLinkedBody: (args) => {
     const body = { ...translateLinkedStyleBags({
       ...args,
@@ -86548,7 +86591,11 @@ var ComponentEntity = defineEntity({
         let next = config2;
         let previous = source;
         for (let n = 0; n < count; n++) {
-          const key2 = freeLayerKey(next, path2, source);
+          const key2 = duplicateLayerKey({
+            config: next,
+            path: path2,
+            source
+          });
           const siblings = next.resolve("component", path2)?.toJSON()?.anatomy?.[parent]?.children ?? [];
           const index = siblings.indexOf(previous) + 1;
           next = next.run([{
@@ -89067,7 +89114,7 @@ function isNode(value) {
 function literal2(value) {
   return typeof value === "string" ? `'${value}'` : String(value);
 }
-function unique(parts) {
+function unique2(parts) {
   return [...new Set(parts)];
 }
 function renderSignature(schema, options = {}) {
@@ -89088,9 +89135,9 @@ function renderSignature(schema, options = {}) {
       return shown.join(" | ");
     }
     const variants2 = node2.anyOf ?? node2.oneOf;
-    if (variants2) return unique(variants2.filter((member) => !isNever(member)).map((member) => render(member, remaining))).join(" | ");
-    if (node2.allOf) return unique(node2.allOf.map((member) => render(member, remaining))).join(" & ");
-    if (Array.isArray(node2.type)) return unique(node2.type.map((type) => render({
+    if (variants2) return unique2(variants2.filter((member) => !isNever(member)).map((member) => render(member, remaining))).join(" | ");
+    if (node2.allOf) return unique2(node2.allOf.map((member) => render(member, remaining))).join(" & ");
+    if (Array.isArray(node2.type)) return unique2(node2.type.map((type) => render({
       ...node2,
       type
     }, remaining))).join(" | ");
@@ -89719,7 +89766,7 @@ var Entity = class {
 };
 
 // ../config/dist/framework/schema-version.js
-var CURRENT_SCHEMA_VERSION = 20261030163028;
+var CURRENT_SCHEMA_VERSION = 20261102185610;
 var SETTINGS_AS_KIND_VERSION = 20260908171448;
 var SchemaVersionTooNew = class extends ConfigFormatError {
   found;
@@ -89739,7 +89786,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 > 20261030163028) 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 > 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.`);
     REGISTERED.set(migration.version, migration);
   }
 }
@@ -89770,7 +89817,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 ?? 20261030163028;
+  const target2 = options?.target ?? 20261102185610;
   const version2 = detectedWireVersion(json2);
   if (version2 > target2) throw new SchemaVersionTooNew(version2, target2);
   const raw = json2;
@@ -92488,10 +92535,23 @@ var Config = class Config2 {
       if (borrowed !== void 0 && isRef2(storedBody) && pathOf2(storedBody) === patch.path) reject("UNSUPPORTED", `Cannot rename ${patch.kind} "${patch.path}" \u2014 it carries "${borrowed}"'s own name for it. Place it at a path of your own to name it, or link it as a value.`);
       const { value } = extension ? extensionChange(entry, patch.kind, patch.to, extension, false) : itemChange(entry, patch.kind, patch.to, stored);
       const moved = snapshot.withRenamed(patch.kind, "item", patch.path, patch.to, value);
-      return this.cascadeRename(moved, `${patch.kind}:${patch.path}`, `${patch.kind}:${patch.to}`, this.entityOf(patch.kind)?.sourceIdentity ? {
+      let next = this.cascadeRename(moved, `${patch.kind}:${patch.path}`, `${patch.kind}:${patch.to}`, this.entityOf(patch.kind)?.sourceIdentity ? {
         from: patch.path,
         to: patch.to
       } : void 0);
+      const parts = this.partMoves(snapshot, entry, patch.path, patch.to);
+      for (const part of parts) {
+        const taken = snapshot.get(patch.kind, part.to);
+        if (taken && !isMintedRow(taken.toJSON())) reject("ALREADY_EXISTS", `Cannot rename ${patch.kind} "${patch.path}" to "${patch.to}" \u2014 its part "${part.from}" would land on the ${patch.kind} already at "${part.to}".`);
+      }
+      for (const part of parts) {
+        const current = next.get(patch.kind, part.from);
+        if (!current) continue;
+        const { value: value2 } = itemChange(entry, patch.kind, part.to, current.toJSON());
+        next = next.withRenamed(patch.kind, "item", part.from, part.to, value2);
+        next = this.cascadeRename(next, `${patch.kind}:${part.from}`, `${patch.kind}:${part.to}`);
+      }
+      return next;
     }
     const updateSchema = dataSchema(entry.schemas, "update");
     if (!updateSchema) reject("UNSUPPORTED", `${patch.kind} has no update operation`);
@@ -93110,6 +93170,22 @@ var Config = class Config2 {
   * subgroup (`color/brand/primary`) belongs to `color` too. Getting either wrong is silent: one drags
   * an unrelated group along, the other skips half of what the user sees under the heading.
   */
+  /**
+  * The parts a rename of `from` to `to` moves with it, for a kind that declares
+  * {@link EntityKind.parts}: every item named under `from`, at any depth.
+  */
+  partMoves(snapshot, entry, from, to) {
+    if (!entry.parts || from === to) return [];
+    return this.groupMembers(snapshot, entry.name, from).map(({ path: path2 }) => ({
+      from: path2,
+      to: `${to}${path2.slice(from.length)}`
+    }));
+  }
+  /** The parts renaming `path` to `to` would move with it — see {@link EntityKind.parts}. */
+  renamedParts(kind, path2, to) {
+    const entry = this.entityOf(kind);
+    return entry ? this.partMoves(this.state.snapshot, entry, path2, to) : [];
+  }
   groupMembers(snapshot, kind, group) {
     const members2 = [];
     for (const [path2, entity] of snapshot.slice(kind).items) if (path2.startsWith(`${group}/`)) members2.push({
@@ -96627,7 +96703,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 > 20261030163028) throw new SchemaVersionTooNew(claimed);
+    if (claimed > 20261102185610) 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;
@@ -97963,7 +98039,15 @@ function planLinkApplied({ config: config2, input: input2 }) {
   const shadows = [];
   const gains = /* @__PURE__ */ new Map();
   let leftAnywhere = false;
+  const replacements = replacementTakes({
+    config: config2,
+    slug: slug2,
+    source,
+    input: input2
+  });
+  const landing = new Set(replacements.entries.map(({ kind, path: path2 }) => `${kind}:${path2}`));
   const shadow2 = (kind, path2) => {
+    if (landing.has(`${kind}:${path2}`)) return true;
     const held = config2.resolve(kind, path2);
     if (!held || held.borrowedFrom === slug2) return true;
     if (sharedWithOrigin({
@@ -98043,7 +98127,7 @@ function planLinkApplied({ config: config2, input: input2 }) {
         if (path2 === "*") continue;
         rejectData(`Cannot link "${path2}" through "${slug2}" \u2014 the source has no ${kind} there.`, ["data", accessor]);
       }
-      const taken = entries.filter((entry) => {
+      const taken2 = entries.filter((entry) => {
         const fit = config2.canBorrow({
           kind,
           path: entry.from,
@@ -98053,12 +98137,12 @@ function planLinkApplied({ config: config2, input: input2 }) {
         if (source.resolve(kind, path2)) rejectData(fit.error, ["data", accessor]);
         return false;
       }).filter((entry) => shadow2(kind, entry.from));
-      if (taken.length === entries.length) {
+      if (taken2.length === entries.length) {
         if (path2 !== "*") gained.push(path2);
         continue;
       }
       whole = false;
-      gained.push(...taken.map((entry) => entry.from));
+      gained.push(...taken2.map((entry) => entry.from));
     }
     if (whole) gains.set(accessor, "*");
     else if (gained.length > 0) gains.set(accessor, gained);
@@ -98108,12 +98192,13 @@ function planLinkApplied({ config: config2, input: input2 }) {
     declared2 = Object.keys(next).length === 0 ? current : next;
   }
   const planned = [
+    ...replacements.patches,
     ...takes2,
     ...declares,
     ...shadows
   ];
   let result = planned.length > 0 ? applied(config2, planned) : void 0;
-  if (takes2.length > 0 && result && "failed" in result) throw result.failed;
+  if ((takes2.length > 0 || replacements.patches.length > 0) && result && "failed" in result) throw result.failed;
   const { dropped, stranded, patches: drops } = takes2.length > 0 && result && "config" in result ? directivesTakenFrom({
     config: config2,
     slug: slug2,
@@ -98124,7 +98209,74 @@ function planLinkApplied({ config: config2, input: input2 }) {
     patches: []
   };
   if (drops.length > 0 && result && "config" in result) result = applied(result.config, drops);
-  const patches = [...planned, ...drops];
+  const taken = [];
+  const leaves2 = [];
+  for (const entry of replacements.entries) {
+    const { kind, accessor, path: path2, replaces, from } = entry;
+    if (from === void 0 || !result || !("config" in result)) {
+      taken.push({
+        kind,
+        path: replaces,
+        with: path2,
+        ...from ? { from } : {},
+        excluded: false,
+        dropped: []
+      });
+      continue;
+    }
+    const leftOut = { [accessor]: [replaces] };
+    const keptFor = linkedDependents({
+      config: result.config,
+      slug: from,
+      data: leftOut
+    });
+    if (keptFor.length > 0) {
+      taken.push({
+        kind,
+        path: replaces,
+        with: path2,
+        from,
+        excluded: false,
+        keptFor,
+        dropped: []
+      });
+      continue;
+    }
+    const exclusion = planExclude({
+      config: result.config,
+      input: {
+        path: from,
+        data: leftOut
+      }
+    });
+    if (exclusion.blocked !== void 0) {
+      taken.push({
+        kind,
+        path: replaces,
+        with: path2,
+        from,
+        excluded: false,
+        keptBecause: exclusion.blocked,
+        dropped: []
+      });
+      continue;
+    }
+    leaves2.push(...exclusion.patches);
+    result = applied(result.config, exclusion.patches);
+    taken.push({
+      kind,
+      path: replaces,
+      with: path2,
+      from,
+      excluded: true,
+      dropped: exclusion.dropped
+    });
+  }
+  const patches = [
+    ...planned,
+    ...drops,
+    ...leaves2
+  ];
   return {
     plan: {
       declared: declared2,
@@ -98138,6 +98290,7 @@ function planLinkApplied({ config: config2, input: input2 }) {
       addresses: addresses2,
       linked,
       extended,
+      replaced: taken,
       dropped,
       shared,
       patches,
@@ -98149,6 +98302,71 @@ function planLinkApplied({ config: config2, input: input2 }) {
     after: stranded.length === 0 && result && "config" in result ? result.config : void 0
   };
 }
+function replacementTakes({ config: config2, slug: slug2, source, input: input2 }) {
+  const entries = [];
+  const patches = [];
+  const accessors = config2.accessors();
+  const landing = /* @__PURE__ */ new Map();
+  for (const [accessor, pairs] of Object.entries(input2.replace ?? {})) {
+    const kind = accessors[accessor]?.kind;
+    if (!kind) rejectData(`Cannot replace anything through "${slug2}" \u2014 this system has no "${accessor}".`, ["replace", accessor]);
+    for (const [replaces, path2] of Object.entries(pairs)) {
+      const at = [
+        "replace",
+        accessor,
+        replaces
+      ];
+      if (input2.data !== "*" && !covers({
+        declared: input2.data,
+        accessor,
+        path: path2
+      })) rejectData(`Cannot replace "${replaces}" with "${path2}" \u2014 \`data\` doesn't link "${path2}" through "${slug2}". Name it there too.`, at);
+      if (!source.resolve(kind, path2)) rejectData(`Cannot replace "${replaces}" with "${path2}" \u2014 "${slug2}" has no ${kind} "${path2}".`, at);
+      if (path2 === replaces) rejectData(`Cannot replace "${path2}" with itself \u2014 taking the source's "${path2}" over it is \`onLinked: 'take'\`.`, at);
+      const twice = landing.get(`${kind}:${path2}`);
+      if (twice !== void 0) rejectData(`Cannot replace both "${twice}" and "${replaces}" with "${path2}".`, at);
+      const held = config2.resolve(kind, replaces);
+      if (!held) rejectData(`Cannot replace "${replaces}" \u2014 this system has no ${kind} "${replaces}".`, at);
+      if (held.borrowedFrom === slug2) rejectData(`Cannot replace "${replaces}" with "${path2}" \u2014 "${replaces}" already comes from "${slug2}".`, at);
+      const occupied = config2.storedBody(kind, path2);
+      if (occupied !== void 0 && !isMintedRow(occupied)) rejectData(`Cannot replace "${replaces}" with "${path2}" \u2014 this system already has a ${kind} of its own at "${path2}".`, at);
+      landing.set(`${kind}:${path2}`, replaces);
+      const from = held.borrowedFrom ?? declaredElsewhere({
+        config: config2,
+        slug: slug2,
+        kind,
+        path: replaces
+      });
+      const stored = config2.storedBody(kind, replaces);
+      const minted = stored !== void 0 && isMintedRow(stored);
+      entries.push({
+        kind,
+        accessor,
+        path: path2,
+        replaces,
+        ...from ? { from } : {}
+      });
+      patches.push({
+        kind,
+        operation: minted ? "create" : "replace",
+        path: replaces,
+        data: {
+          ...ref(kind, path2, slug2),
+          extend: {}
+        }
+      }, {
+        kind,
+        operation: "rename",
+        path: replaces,
+        to: path2
+      });
+    }
+  }
+  return {
+    entries,
+    patches
+  };
+}
 function directivesTakenFrom({ config: config2, slug: slug2, after: after5 }) {
   const key2 = (at) => `${at.slug}\0${at.accessor}\0${at.path}`;
   const already = new Set(danglingDirectives(config2).map(key2));
@@ -98953,7 +99171,16 @@ var linkInput = external_exports.object({
   data: external_exports.union([external_exports.literal("*"), external_exports.record(external_exports.string(), copyPaths)]),
   /** What to do at a path another linked system provides: `'take'` makes it follow this source,
   *  `'keep'` leaves it where it comes from. Required when there is one; `link-plan` lists them. */
-  onLinked: external_exports.enum(["keep", "take"]).optional()
+  onLinked: external_exports.enum(["keep", "take"]).optional(),
+  /**
+  * A component this config holds under one name, replaced with the source's of another name, keyed
+  * by accessor: `{ components: { SelectContent: 'SelectMenu' } }` replaces the `SelectContent` this
+  * config holds with the source's `SelectMenu`. Every ref to `SelectContent` is renamed to
+  * `SelectMenu`, so design files and code follow the way they follow a rename, and the system
+  * `SelectContent` came through stops deriving it unless its own rows still use it. Each source path
+  * is one `data` names; `link-plan` lists each in `replaced`. A take at the same name is `onLinked`.
+  */
+  replace: external_exports.record(external_exports.string(), external_exports.record(external_exports.string().min(1), external_exports.string().min(1))).optional()
 });
 var unlinkInput = external_exports.object({
   path: pathInput("linked-system"),
@@ -98995,7 +99222,8 @@ function linkPlanInputOf(input2) {
   return {
     path: String(input2.path),
     data: input2.data,
-    ...input2.onLinked === void 0 ? {} : { onLinked: input2.onLinked }
+    ...input2.onLinked === void 0 ? {} : { onLinked: input2.onLinked },
+    ...input2.replace === void 0 ? {} : { replace: input2.replace }
   };
 }
 function linkExample({ config: config2, path: path2 }) {
@@ -99074,7 +99302,7 @@ var LinkedSystemDefinition = defineEntity({
       input: linkInput,
       readOnly: false,
       label: "Link from",
-      description: "Draw entities from a linked system, following the source: `data` names them by accessor \u2014 `{ tokens: ['color/brand', 'color'] }` takes an entity and a folder's members, `{ tokens: '*' }` every token, and `'*'` the whole system. What this config already holds at those paths is replaced by theirs, so run `linked-system/link-plan` with the same input first to see what that is. To hold their values as your own instead, `copy`.",
+      description: "Draw entities from a linked system, following the source: `data` names them by accessor \u2014 `{ tokens: ['color/brand', 'color'] }` takes an entity and a folder's members, `{ tokens: '*' }` every token, and `'*'` the whole system. What this config already holds at those paths is replaced by theirs, so run `linked-system/link-plan` with the same input first to see what that is. To replace something this config holds under another name (the `SelectContent` it has with the source's `SelectMenu`), name the pair in `replace` (`{ components: { SelectContent: 'SelectMenu' } }`): every reference to the old name moves to the new one, in design files and code too. To hold their values as your own instead, `copy`.",
       scope: "item",
       approval: "reference-change",
       title: (entity) => `Link something from ${entity}`,
@@ -99097,7 +99325,7 @@ var LinkedSystemDefinition = defineEntity({
       input: linkInput,
       readOnly: true,
       label: "Plan a link",
-      description: "What `link` with the same input replaces \u2014 rows of yours deleted so the source shows through, every path another linked system provides (`linked`, turned into extensions when `onLinked` says take), the `options` entries another linked system holds at what a take moves, which it removes since they would apply to nothing (`dropped`), members left alone because they are already here from the same origin, paths another linked system declares that the link reaches as a different entity (`settled`), whose row stays, and why the config would refuse the link (`blocked`), a collision it would leave among them. Writes nothing.",
+      description: "What `link` with the same input replaces \u2014 rows of yours deleted so the source shows through, every path another linked system provides (`linked`, turned into extensions when `onLinked` says take), the `options` entries another linked system holds at what a take moves, which it removes since they would apply to nothing (`dropped`), members left alone because they are already here from the same origin, paths another linked system declares that the link reaches as a different entity (`settled`), whose row stays, what `replace` replaces under another name (`replaced`: each path, what replaces it, the pin it came through, and whether it is left out of that pin or kept because rows of that pin still use it), and why the config would refuse the link (`blocked`), a collision it would leave among them. Writes nothing.",
       scope: "item",
       title: (entity) => `Plan a link from ${entity}`,
       example: linkExample,
@@ -100027,6 +100255,22 @@ var layerPrefixMigration = {
   up: (json2) => json2
 };
 
+// ../config/dist/migrations/20261102143821_default_colors.js
+var DEFAULT_COLORS_VERSION = 20261102143821;
+var defaultColorsMigration = {
+  version: DEFAULT_COLORS_VERSION,
+  up(json2) {
+    return json2;
+  }
+};
+
+// ../config/dist/migrations/20261102185610_link_replace.js
+var LINK_REPLACE_VERSION = 20261102185610;
+var linkReplaceMigration = {
+  version: LINK_REPLACE_VERSION,
+  up: (json2) => 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"]);
@@ -101288,9 +101532,9 @@ function tokenVarIndex(tokenRecord, varPrefix) {
     const name = cssVar(void 0, "token", path2, varPrefix);
     byVar.set(name, byVar.has(name) ? null : path2);
   }
-  const unique2 = /* @__PURE__ */ new Map();
-  for (const [name, path2] of byVar) if (path2 !== null) unique2.set(name, path2);
-  return unique2;
+  const unique3 = /* @__PURE__ */ new Map();
+  for (const [name, path2] of byVar) if (path2 !== null) unique3.set(name, path2);
+  return unique3;
 }
 function withTokenRefs(declarations, tokenByVar) {
   return Object.fromEntries(Object.entries(declarations).map(([property, value]) => {
@@ -101332,15 +101576,15 @@ function bindFontFamilyTokens({ tokenRecord, fontRecord, globalStyleRecord, varP
   const fonts = /* @__PURE__ */ new Map();
   for (const [path2, body] of Object.entries(fontRecord)) if (body && typeof body === "object" && "fontFamily" in body) fonts.set(path2, body);
   if (fonts.size === 0) return;
-  const unique2 = (pairs) => {
+  const unique3 = (pairs) => {
     const seen = /* @__PURE__ */ new Map();
     for (const [key2, path2] of pairs) seen.set(key2, seen.has(key2) ? null : path2);
     const out = /* @__PURE__ */ new Map();
     for (const [key2, path2] of seen) if (path2 !== null) out.set(key2, path2);
     return out;
   };
-  const byLeaf = unique2([...fonts.keys()].map((path2) => [path2.slice(path2.lastIndexOf("/") + 1), path2]));
-  const byFamily = unique2([...fonts].map(([path2, body]) => [body.fontFamily.toLowerCase(), path2]));
+  const byLeaf = unique3([...fonts.keys()].map((path2) => [path2.slice(path2.lastIndexOf("/") + 1), path2]));
+  const byFamily = unique3([...fonts].map(([path2, body]) => [body.fontFamily.toLowerCase(), path2]));
   const propertyPrefix = `--${varPrefix}-font-family-`;
   const rootVars = /* @__PURE__ */ new Map();
   for (const [name, style] of Object.entries(globalStyleRecord)) {
@@ -102763,6 +103007,8 @@ if (!registeredSchemaMigrations().has(20261027184442)) registerSchemaMigrations(
 if (!registeredSchemaMigrations().has(20261027205147)) registerSchemaMigrations(lintIgnoreMigration);
 if (!registeredSchemaMigrations().has(20261030134149)) registerSchemaMigrations(componentMapPropsMigration);
 if (!registeredSchemaMigrations().has(20261030163028)) registerSchemaMigrations(layerPrefixMigration);
+if (!registeredSchemaMigrations().has(20261102143821)) registerSchemaMigrations(defaultColorsMigration);
+if (!registeredSchemaMigrations().has(20261102185610)) registerSchemaMigrations(linkReplaceMigration);
 
 // ../config/dist/capture/node-ops.js
 var DEFAULT_WIDTH = 1600;