@yahoo/uds-create-cli 5.73.1 → 5.74.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahoo/uds-create-cli",
-  "version": "5.73.1",
+  "version": "5.74.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.73.1",
-    "@yahoo/uds-create-loader": "5.73.1",
-    "@yahoo/uds-create-types": "5.73.1",
-    "@yahoo/uds-create-utils": "5.73.1",
+    "@yahoo/uds-create-config": "5.74.0",
+    "@yahoo/uds-create-loader": "5.74.0",
+    "@yahoo/uds-create-types": "5.74.0",
+    "@yahoo/uds-create-utils": "5.74.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": 20261102193912,
+  "udsSchemaVersion": 20261103115059,
   "optionalDependencies": {
-    "@yahoo/uds-create-cli-darwin-arm64": "5.73.1",
-    "@yahoo/uds-create-cli-darwin-x64": "5.73.1",
-    "@yahoo/uds-create-cli-linux-arm64": "5.73.1",
-    "@yahoo/uds-create-cli-linux-x64": "5.73.1",
-    "@yahoo/uds-create-cli-linux-arm64-musl": "5.73.1",
-    "@yahoo/uds-create-cli-linux-x64-musl": "5.73.1"
+    "@yahoo/uds-create-cli-darwin-arm64": "5.74.0",
+    "@yahoo/uds-create-cli-darwin-x64": "5.74.0",
+    "@yahoo/uds-create-cli-linux-arm64": "5.74.0",
+    "@yahoo/uds-create-cli-linux-x64": "5.74.0",
+    "@yahoo/uds-create-cli-linux-arm64-musl": "5.74.0",
+    "@yahoo/uds-create-cli-linux-x64-musl": "5.74.0"
   }
 }

package/subprocess/transform-runner.mjs

@@ -65160,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, parts, 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, authoredAt, sourceType, answeredHere } = spec2;
   const allComputed = {
     sources: ({ member, config: config2 }) => sourceSlugs(member, config2),
     borrowedFrom: ({ config: config2, path: path2 }) => config2.borrowedFrom(name, path2),
@@ -65215,6 +65215,7 @@ function buildKind(spec2) {
     ...invariants ? { invariants } : {},
     ...structuralBody ? { structuralBody } : {},
     ...authoredBody ? { authoredBody } : {},
+    ...authoredAt ? { authoredAt } : {},
     ...sourceType ? { sourceType } : {},
     ...answeredHere ? { answeredHere: true } : {}
   };
@@ -65354,6 +65355,7 @@ function defineEntity(spec2) {
     invariants: spec2.invariants,
     structuralBody: spec2.structuralBody,
     authoredBody: spec2.authoredBody,
+    authoredAt: spec2.authoredAt,
     sourceType: spec2.sourceType,
     answeredHere: spec2.answeredHere
   });
@@ -82615,9 +82617,9 @@ var Slot = class {
     const list = previewContentList(this.stored(source));
     const element2 = elementIn(list, from);
     if (!element2) return [];
-    const without2 = removeIn(list, from);
-    if (!without2) return [];
-    const content = placeIn(without2, to, element2);
+    const without3 = removeIn(list, from);
+    if (!without3) return [];
+    const content = placeIn(without3, to, element2);
     if (!content) return [];
     return this.writeSource({
       source,
@@ -89701,6 +89703,39 @@ function titleOf(config2, op) {
   return `${op.label} ${noun}`;
 }
 
+// ../config/dist/framework/authored-at.js
+function valueAt3(body, segments) {
+  let at = body;
+  for (const segment of segments) {
+    if (!isPlainObject(at) || !Object.hasOwn(at, segment)) return void 0;
+    at = at[segment];
+  }
+  return at;
+}
+function without(body, segments) {
+  const [head, ...rest] = segments;
+  if (head === void 0 || !Object.hasOwn(body, head)) return body;
+  const { [head]: child, ...others } = body;
+  if (rest.length === 0) return others;
+  if (!isPlainObject(child)) return body;
+  const remaining = without(child, rest);
+  return Object.keys(remaining).length === 0 ? others : {
+    ...others,
+    [head]: remaining
+  };
+}
+function storedFromAuthored({ body, authoredAt }) {
+  let stored = body;
+  for (const [field, at] of Object.entries(authoredAt)) {
+    const segments = at.split(".");
+    const value = valueAt3(stored, segments);
+    if (value === void 0) continue;
+    if (stored[field] !== void 0) rejectData(`\`${at}\` and \`${field}\` are one value, so a body sets only one of them. \`${field}\` is the deprecated spelling.`, segments);
+    stored = setAtPath(without(stored, segments), [field], value);
+  }
+  return stored;
+}
+
 // ../config/dist/framework/authoring.js
 function isAuthored(value) {
   if (typeof value !== "object" && typeof value !== "function") return false;
@@ -89827,7 +89862,7 @@ var Entity = class {
 };
 
 // ../config/dist/framework/schema-version.js
-var CURRENT_SCHEMA_VERSION = 20261102193912;
+var CURRENT_SCHEMA_VERSION = 20261103115059;
 var SETTINGS_AS_KIND_VERSION = 20260908171448;
 var SchemaVersionTooNew = class extends ConfigFormatError {
   found;
@@ -89847,7 +89882,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 > 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.`);
+    if (migration.version > 20261103115059) 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);
   }
 }
@@ -89878,7 +89913,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 ?? 20261102193912;
+  const target2 = options?.target ?? 20261103115059;
   const version2 = detectedWireVersion(json2);
   if (version2 > target2) throw new SchemaVersionTooNew(version2, target2);
   const raw = json2;
@@ -94962,6 +94997,18 @@ var Config = class Config2 {
   accessors() {
     return this.constructor.entities ?? {};
   }
+  /**
+  * The accessor spellings this config type has retired, each mapped to the accessor it is now
+  * (`{ linkedSystems: 'sources' }`). A writer locating an entity in authored source reads it, since a
+  * file written before the rename still spells the old one.
+  */
+  deprecatedAccessors() {
+    return this.constructor.deprecatedAccessors ?? {};
+  }
+  /** `name`, or the accessor it now is when it's a retired spelling. */
+  currentAccessor(name) {
+    return this.deprecatedAccessors()[name] ?? name;
+  }
   /** The kinds registered into this config — what it owns, whether or not they hold items yet.
   *  Tool derivation (reads + mutations) scopes to these so a config only exposes its own kinds
   *  (a source's kinds are read through their own config, so they derive none). */
@@ -96628,12 +96675,13 @@ var Config = class Config2 {
   * ({@link sources}: nobody resolved this) into a verdict. So the incremental case gets its own door.
   */
   attachResolved({ source, slug: slug2, answer }) {
-    const kind = this.sourceAccessors().get(source);
-    if (!kind) throw new Error(`attachResolved: "${source}" is not a source this config declares. Its source accessors are ${[...this.sourceAccessors().keys()].map((name) => `"${name}"`).join(", ") || "(none)"}.`);
+    const accessor = this.currentAccessor(source);
+    const kind = this.sourceAccessors().get(accessor);
+    if (!kind) throw new Error(`attachResolved: "${accessor}" is not a source this config declares. Its source accessors are ${[...this.sourceAccessors().keys()].map((name) => `"${name}"`).join(", ") || "(none)"}.`);
     const { config: resolved, ...state } = parseResolution({
-      source,
+      source: accessor,
       slug: slug2,
-      schema: Config2.resolutionSchemaOf(this, kind, source),
+      schema: Config2.resolutionSchemaOf(this, kind, accessor),
       answer
     });
     const sources = new Map(this.state.sources);
@@ -96717,12 +96765,13 @@ var Config = class Config2 {
   */
   static async resolveDeclared(config2, resolvers) {
     const kindOfAccessor = config2.sourceAccessors();
-    const missing = [...kindOfAccessor.keys()].filter((name) => !(name in resolvers));
+    const byAccessor = Object.fromEntries(Object.entries(resolvers).map(([name, resolve]) => [config2.currentAccessor(name), resolve]));
+    const missing = [...kindOfAccessor.keys()].filter((name) => !(name in byAccessor));
     if (missing.length > 0) throw new Error(`Config.load: no resolver for source ${missing.map((name) => `"${name}"`).join(", ")}. A source kind with no resolver answers nothing, which reads exactly like a config that borrows nothing \u2014 so it is refused here instead.`);
     const states = /* @__PURE__ */ new Map();
     const attached = {};
     for (const [name, kind] of kindOfAccessor) {
-      const resolve = resolvers[name];
+      const resolve = byAccessor[name];
       const bySlug = {};
       const declared2 = Config2.resolutionSchemaOf(config2, kind, name);
       const answers = await Promise.all(config2.list(kind).map(async (entity) => {
@@ -96764,7 +96813,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 > 20261102193912) throw new SchemaVersionTooNew(claimed);
+    if (claimed > 20261103115059) 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;
@@ -97004,7 +97053,11 @@ function extensionChange(entry, kind, path2, raw, validate2 = false) {
 }
 function itemChange(entry, kind, path2, raw, validate2 = false) {
   const body = isRef2(raw) || isComposedValue(raw) || typeof raw !== "object" || raw === null ? { [entry.primaryField]: raw } : raw;
-  const def = validate2 === "author" && entry.authoredBody ? entry.authoredBody(body) : body;
+  let def = validate2 === "author" && entry.authoredBody ? entry.authoredBody(body) : body;
+  if (validate2 === "author" && entry.authoredAt) def = storedFromAuthored({
+    body: def,
+    authoredAt: entry.authoredAt
+  });
   if (validate2) {
     const parsed = wholeBodySchema(entry)?.safeParse(def);
     if (parsed && !parsed.success) {
@@ -97056,6 +97109,8 @@ function loadGroupChange(meta3, kind, path2, raw, phase = "author") {
 function defineConfig(spec2) {
   const owned = spec2.entities;
   const sources = spec2.sources ?? {};
+  const aliases = spec2.deprecatedAccessors ?? {};
+  for (const [retired, current] of Object.entries(aliases)) if (retired in owned || !(current in owned)) throw new Error(`${spec2.name}: retired accessor "${retired}" has to name an owned accessor and not be one itself`);
   for (const name of Object.keys(sources)) {
     const cls = owned[name];
     if (!cls) throw new Error(`${spec2.name}: source "${name}" is not an owned entity of this config`);
@@ -97083,7 +97138,9 @@ function defineConfig(spec2) {
     *  which is why the chained authoring form (`new System().register(…)`) is the idiom. */
     register(records) {
       let next = this;
-      for (const [name, record2] of Object.entries(records)) {
+      for (const [written, record2] of Object.entries(records)) {
+        const name = aliases[written] ?? written;
+        if (name !== written && name in records) throw new Error(`"${written}" and "${name}" are one collection in config "${spec2.name}" ("${written}" is its retired spelling), so register takes only one of them`);
         const cls = owned[name];
         if (!cls) throw new Error(`"${name}" is not an owned entity of config "${spec2.name}"`);
         next = next.registerEntity(cls, record2);
@@ -97097,6 +97154,7 @@ function defineConfig(spec2) {
     static entities = owned;
     static derivedEntities = derived;
     static sources = sources;
+    static deprecatedAccessors = aliases;
     /** Swap kinds by their accessor name, across owned / derived. */
     static extend(swaps) {
       const pick2 = (base) => {
@@ -97112,11 +97170,19 @@ function defineConfig(spec2) {
         entities: pick2(owned),
         derivedEntities: pick2(derived),
         sources,
+        deprecatedAccessors: aliases,
         extendsBase: true
       });
     }
   }
-  for (const [name, cls] of [...Object.entries(owned), ...Object.entries(derived)]) {
+  for (const [name, cls] of [
+    ...Object.entries(owned),
+    ...Object.entries(derived),
+    ...Object.entries(aliases).flatMap(([retired, current]) => {
+      const entity = owned[current];
+      return entity ? [[retired, entity]] : [];
+    })
+  ]) {
     if (name in TypedConfig.prototype || name === "state") throw new Error(`${spec2.name}: entity accessor "${name}" collides with a Config member \u2014 rename the accessor (the KIND itself is unaffected)`);
     Object.defineProperty(TypedConfig.prototype, name, {
       get() {
@@ -99360,10 +99426,13 @@ var pinOptions = external_exports.record(external_exports.string(), external_exp
   extend: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
   hidden: external_exports.boolean().optional()
 }).refine((entry) => entry.override !== void 0 || entry.extend !== void 0 || entry.hidden !== void 0, { message: "An `options` entry needs `override`, `extend` or `hidden`." }))).optional().describe("Per-entity adjustments, keyed by accessor, then path, then verb.");
+var SOURCE_AUTHORED_AT = { link: "options.include" };
 var LinkedSystemDefinition = defineEntity({
   kind: "linked-system",
   label: "Linked system",
   labelPlural: "Linked systems",
+  entityName: "Source",
+  authoredAt: SOURCE_AUTHORED_AT,
   invariants: (config2) => [
     ...config2.list("linked-system").filter(({ path: path2 }) => !isLinkSlug(path2)).map(({ path: path2 }) => `Link "${path2}": ${LINK_SLUG_MESSAGE}`),
     ...linkRedirects(config2).filter((redirect) => redirect.problem !== void 0 && redirect.problem !== "missing").map(redirectSentence),
@@ -99964,15 +100033,19 @@ function storedPinOptions(options) {
   }
   return stored;
 }
-function linkedSystemItem(def) {
+function sourceItem(def) {
   if (typeof def !== "object" || def === null || isRef2(def)) return def;
-  if (!isPlainObject(def.options)) return def;
+  const body = storedFromAuthored({
+    body: def,
+    authoredAt: SOURCE_AUTHORED_AT
+  });
+  if (!isPlainObject(body.options)) return body;
   return {
-    ...def,
-    options: storedPinOptions(def.options)
+    ...body,
+    options: storedPinOptions(body.options)
   };
 }
-var LinkedSystem = Object.assign(LinkedSystemDefinition, { item: linkedSystemItem });
+var Source = Object.assign(LinkedSystemDefinition, { item: sourceItem });
 function excludedDirectives(config2) {
   return config2.list("linked-system").flatMap(({ path: slug2 }) => {
     const body = config2.storedBody("linked-system", slug2);
@@ -100133,7 +100206,7 @@ var nativeStyleArraysAndAutoMigration = {
 
 // ../config/dist/migrations/20261019165323_build_exclude.js
 var BUILD_EXCLUDE_VERSION = 20261019165323;
-function without(record2, key2) {
+function without2(record2, key2) {
   if (!(key2 in record2)) return record2;
   const { [key2]: _dropped, ...rest } = record2;
   return rest;
@@ -100142,7 +100215,7 @@ function settingsWithoutInclude(settings) {
   if (!isPlainObject(settings.build) || !("include" in settings.build)) return settings;
   return {
     ...settings,
-    build: without(settings.build, "include")
+    build: without2(settings.build, "include")
   };
 }
 function dropBuildInclude(json2) {
@@ -100171,7 +100244,7 @@ var after = before.refine((json2) => {
 function patchWithoutInclude(patch) {
   if (patch.kind !== "settings" || !("data" in patch)) return patch;
   if (!isPlainObject(patch.data)) return patch;
-  const data = "field" in patch ? patch.field === "build" ? without(patch.data, "include") : patch.data : without(settingsWithoutInclude(patch.data), "build.include");
+  const data = "field" in patch ? patch.field === "build" ? without2(patch.data, "include") : patch.data : without2(settingsWithoutInclude(patch.data), "build.include");
   if (data === patch.data) return patch;
   if ((Object.keys(data).length === 0 || Object.keys(data).length === 1 && isPlainObject(data.build) && Object.keys(data.build).length === 0) && patch.operation !== "create") return null;
   return {
@@ -100368,6 +100441,15 @@ var mapPropsFromMigration = {
   }
 };
 
+// ../config/dist/migrations/20261103115059_sources_authoring.js
+var SOURCES_AUTHORING_VERSION = 20261103115059;
+var sourcesAuthoringMigration = {
+  version: SOURCES_AUTHORING_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"]);
@@ -103016,9 +103098,13 @@ var System = defineConfig({
     canvasRoles: CanvasRole,
     globalStyles: GlobalStyle,
     devices: Device,
-    linkedSystems: LinkedSystem
+    sources: Source
+  },
+  sources: { sources: () => System },
+  deprecatedAccessors: {
+    /** @deprecated Use `sources`. */
+    linkedSystems: "sources"
   },
-  sources: { linkedSystems: () => System },
   derivedEntities: {
     operations: Operation,
     tools: Tool
@@ -103107,6 +103193,7 @@ if (!registeredSchemaMigrations().has(20261030163028)) registerSchemaMigrations(
 if (!registeredSchemaMigrations().has(20261102143821)) registerSchemaMigrations(defaultColorsMigration);
 if (!registeredSchemaMigrations().has(20261102185610)) registerSchemaMigrations(linkReplaceMigration);
 if (!registeredSchemaMigrations().has(20261102193912)) registerSchemaMigrations(mapPropsFromMigration);
+if (!registeredSchemaMigrations().has(20261103115059)) registerSchemaMigrations(sourcesAuthoringMigration);
 
 // ../config/dist/capture/node-ops.js
 var DEFAULT_WIDTH = 1600;
@@ -104352,9 +104439,13 @@ var ReactNativeSystem = defineConfig({
     guidance: Guidance,
     canvasRoles: CanvasRole,
     devices: Device,
-    linkedSystems: LinkedSystem
+    sources: Source
+  },
+  sources: { sources: () => ReactNativeSystem },
+  deprecatedAccessors: {
+    /** @deprecated Use `sources`. */
+    linkedSystems: "sources"
   },
-  sources: { linkedSystems: () => ReactNativeSystem },
   derivedEntities: {
     operations: Operation,
     tools: Tool