@yahoo/uds-create-config 2.19.0 → 2.21.0

package/dist/Config.d.ts

@@ -1,5 +1,5 @@
 import { CssVarRef } from "./types/css-values.js";
-import { AnyStylePropDefinition, BuildOptions, CanvasRole, CanvasRoleEntry, CanvasRolesDefinitionInput, CanvasRolesInputConstraint, ComponentDefinition, ComponentGroupDefinition, CompositeStyleDefinition, GlobalStylesDef, LinkedComponentsInput, LinkedSystemEntry, ModeDefinition, ModifierDefinition, MotionDefinitionInput, PlaygroundOptions, SerializedConfig, TokenGroupDefinition, TokenModifierKey } from "./types.js";
+import { AnyStylePropDefinition, BuildOptions, CanvasRole, CanvasRoleEntry, CanvasRolesDefinitionInput, CanvasRolesInputConstraint, ComponentDefinition, ComponentGroupDefinition, CompositeStyleDefinition, GlobalStylesDef, LinkedSystemPin, LinkedSystemsInput, ModeDefinition, ModifierDefinition, MotionDefinitionInput, PlaygroundOptions, SerializedConfig, SystemLink, TokenGroupDefinition, TokenModifierKey } from "./types.js";
 import { AssetGroupDefinition } from "./defineAssetGroup.js";
 import { AssetGroup } from "./AssetGroup.js";
 import { cssVar } from "./brands.js";
@@ -94,11 +94,12 @@ declare class Config {
   readonly motion: Map<string, MotionDef>;
   readonly canvasRoles: Map<CanvasRole, readonly CanvasRoleEntry[]>;
   /**
-   * Components linked from other systems via {@link registerLinkedComponents},
-   * keyed by the source system's database UUID. Declaration only — resolution
-   * (materialized sources, rendering) is a separate, later concern.
+   * Source systems pinned via {@link registerLinkedSystems}, keyed by the
+   * source system's database UUID. A pin anchors every linked value from that
+   * system to one exact published version — registration validates each
+   * link-marked value against it.
    */
-  readonly linkedComponents: Map<string, LinkedSystemEntry>;
+  readonly linkedSystems: Map<string, LinkedSystemPin>;
   /**
    * Set top-level config metadata in one call — the single scalar-setter,
    * replacing the former `withPrefix` / `withPreflight` / `withName` /
@@ -149,20 +150,6 @@ declare class Config {
    * `config.components.get(type)` when `type` may be a spec/registry key.
    */
   getComponent(type: string): Component | undefined;
-  /**
-   * Identify an id-qualified linked-component reference
-   * (`'<systemId>:<Name>'`, e.g. `'96d1678f-…:Button'`). Returns the parsed
-   * `{ systemId, name }` when the system id is a registered
-   * {@link linkedComponents} entry AND the bare name is declared in its
-   * `components` list; `undefined` otherwise (including bare names and
-   * namespaced registry keys). This is declaration-lookup only — it never
-   * returns a renderable {@link Component}; resolution is deferred to the
-   * materialization/rendering work.
-   */
-  getLinkedComponentRef(type: string): {
-    systemId: string;
-    name: string;
-  } | undefined;
   /**
    * The bare, human-readable component name for a spec `type` — strips this
    * registry's `<namespace>:` prefix (`'uds:Text'` → `'Text'`) for display, and
@@ -331,18 +318,19 @@ declare class Config {
   registerComposites(composites: Record<string, CompositeStyleDefinition>): this;
   registerMotion(motion: Record<string, MotionDefinitionInput>): this;
   /**
-   * Declare components linked from other systems. Each record key is the
-   * source system's database UUID (the identity — globally unique, immutable,
-   * rename-proof); the entry carries the system's display-name snapshot at
-   * link time, an exact published version pin, and the bare names of the
-   * linked components.
+   * Pin the source systems this config links values from. Each record key is
+   * the source system's database UUID (the identity — globally unique,
+   * immutable, rename-proof); the pin carries the system's display-name
+   * snapshot at link time and an exact published version.
    *
-   * This is a data-only declaration: no imported component values, no
-   * layer/prop specs. A linked component's qualified reference is
-   * `<systemId>:<Name>` (see {@link getLinkedComponentRef}); resolution to a
-   * renderable component is deferred to the materialization/rendering work.
+   * One pin per system, one version per pin. Every linked value registered
+   * afterwards (a barrel value carrying a `link` marker) is validated against
+   * its pin — an unpinned system or a version mismatch throws at
+   * registration, so pins must appear before the `register*` calls that use
+   * them. The pin's `name` also feeds the registry folder slug the pull
+   * pipeline derives.
    */
-  registerLinkedComponents(input: LinkedComponentsInput): this;
+  registerLinkedSystems(input: LinkedSystemsInput): this;
   registerComponents(components: Record<string, ComponentDefinition>): this;
   /**
    * Build a single component from its definition with this config's context
@@ -437,6 +425,13 @@ declare class Config {
   registerProviders(providers: Record<string, ProviderComponent<Record<never, never>>>): this;
   get derived(): {
     readonly tokens: ReadonlyMap<string, Token>;
+    /**
+     * Provenance index for linked tokens — `"<systemId>:<sourceKey>"` →
+     * token. A `token()` ref authored inside a linked token names SOURCE-
+     * system groups, so it resolves through this index (rename-proof: the
+     * consumer's local group name never appears in the key).
+     */
+    readonly tokensBySource: ReadonlyMap<string, Token>;
     readonly cssVarRefs: Readonly<Record<string, Readonly<Record<string, CssVarRef>>>>;
     /**
      * Reverse lookup: a style modifier key (`_dark`) → the mode option that
@@ -446,6 +441,16 @@ declare class Config {
      */
     readonly modeOptionsByModifier: ReadonlyMap<TokenModifierKey, ModeOption>;
   };
+  /**
+   * Resolve a `token()` ref, provenance-aware — the ONE lookup every ref
+   * consumer (registration wiring, `validate()`, codegen emission) should
+   * use. A ref authored on a linked token (`context` set) names the SOURCE
+   * system's groups, so it resolves through the provenance index only —
+   * falling back to the consumer's own keys would let a coincidentally-named
+   * local group silently shadow a missing source group. Local refs resolve
+   * against consumer keys.
+   */
+  resolveTokenRef(ref: string, context?: SystemLink): Token | undefined;
   /**
    * Validate cross-references. Throws on cycles in token aliases or on
    * unknown refs in markers (`token()`, `composite()`, `mode()`,

package/dist/Config.js

@@ -65,11 +65,12 @@ var Config = class Config {
 	motion = /* @__PURE__ */ new Map();
 	canvasRoles = /* @__PURE__ */ new Map();
 	/**
-	* Components linked from other systems via {@link registerLinkedComponents},
-	* keyed by the source system's database UUID. Declaration only — resolution
-	* (materialized sources, rendering) is a separate, later concern.
+	* Source systems pinned via {@link registerLinkedSystems}, keyed by the
+	* source system's database UUID. A pin anchors every linked value from that
+	* system to one exact published version — registration validates each
+	* link-marked value against it.
 	*/
-	linkedComponents = /* @__PURE__ */ new Map();
+	linkedSystems = /* @__PURE__ */ new Map();
 	#derived;
 	/**
 	* Set top-level config metadata in one call — the single scalar-setter,
@@ -134,27 +135,6 @@ var Config = class Config {
 		if (namespace !== void 0 && namespace === this.namespace) return this.components.get(name);
 	}
 	/**
-	* Identify an id-qualified linked-component reference
-	* (`'<systemId>:<Name>'`, e.g. `'96d1678f-…:Button'`). Returns the parsed
-	* `{ systemId, name }` when the system id is a registered
-	* {@link linkedComponents} entry AND the bare name is declared in its
-	* `components` list; `undefined` otherwise (including bare names and
-	* namespaced registry keys). This is declaration-lookup only — it never
-	* returns a renderable {@link Component}; resolution is deferred to the
-	* materialization/rendering work.
-	*/
-	getLinkedComponentRef(type) {
-		const { namespace: systemId, name } = parseRegistryKey(type);
-		if (systemId === void 0) return void 0;
-		const entry = this.linkedComponents.get(systemId);
-		if (!entry) return void 0;
-		if (entry.components !== "all" && !entry.components.includes(name)) return;
-		return {
-			systemId,
-			name
-		};
-	}
-	/**
 	* The bare, human-readable component name for a spec `type` — strips this
 	* registry's `<namespace>:` prefix (`'uds:Text'` → `'Text'`) for display, and
 	* the `foreign:` sentinel third-party leaves carry (`'foreign:CopyIcon'` →
@@ -900,13 +880,16 @@ var Config = class Config {
 		return this;
 	}
 	registerTokenGroups(groups) {
-		for (const [namespace, def] of Object.entries(groups)) this.tokenGroups.set(namespace, new TokenGroup({
-			namespace,
-			prefixGetter: () => this.prefix,
-			definition: def,
-			tokenLookup: (ref) => this.derived.tokens.get(ref),
-			stylePropertiesLookup: (ns) => this.#stylePropertiesFor(ns)
-		}));
+		for (const [namespace, def] of Object.entries(groups)) {
+			for (const [tokenName, tokenDef] of Object.entries(def.tokens)) this.#assertLinkedTokenPinned(namespace, tokenName, tokenDef.link);
+			this.tokenGroups.set(namespace, new TokenGroup({
+				namespace,
+				prefixGetter: () => this.prefix,
+				definition: def,
+				tokenLookup: (ref, context) => this.resolveTokenRef(ref, context),
+				stylePropertiesLookup: (ns) => this.#stylePropertiesFor(ns)
+			}));
+		}
 		this.#invalidate();
 		return this;
 	}
@@ -938,24 +921,24 @@ var Config = class Config {
 		return this;
 	}
 	/**
-	* Declare components linked from other systems. Each record key is the
-	* source system's database UUID (the identity — globally unique, immutable,
-	* rename-proof); the entry carries the system's display-name snapshot at
-	* link time, an exact published version pin, and the bare names of the
-	* linked components.
+	* Pin the source systems this config links values from. Each record key is
+	* the source system's database UUID (the identity — globally unique,
+	* immutable, rename-proof); the pin carries the system's display-name
+	* snapshot at link time and an exact published version.
 	*
-	* This is a data-only declaration: no imported component values, no
-	* layer/prop specs. A linked component's qualified reference is
-	* `<systemId>:<Name>` (see {@link getLinkedComponentRef}); resolution to a
-	* renderable component is deferred to the materialization/rendering work.
+	* One pin per system, one version per pin. Every linked value registered
+	* afterwards (a barrel value carrying a `link` marker) is validated against
+	* its pin — an unpinned system or a version mismatch throws at
+	* registration, so pins must appear before the `register*` calls that use
+	* them. The pin's `name` also feeds the registry folder slug the pull
+	* pipeline derives.
 	*/
-	registerLinkedComponents(input) {
-		for (const [systemId, entry] of Object.entries(input)) {
-			validateLinkedSystemEntry(systemId, entry, this.linkedComponents);
-			this.linkedComponents.set(systemId, {
-				name: entry.name,
-				version: entry.version,
-				components: entry.components === "all" ? "all" : [...entry.components]
+	registerLinkedSystems(input) {
+		for (const [systemId, pin] of Object.entries(input)) {
+			validateLinkedSystemPin(systemId, pin, this.linkedSystems);
+			this.linkedSystems.set(systemId, {
+				name: pin.name,
+				version: pin.version
 			});
 		}
 		return this;
@@ -1254,11 +1237,13 @@ var Config = class Config {
 	get derived() {
 		if (!this.#derived) {
 			const tokens = /* @__PURE__ */ new Map();
+			const tokensBySource = /* @__PURE__ */ new Map();
 			const cssVarRefs = {};
 			for (const [namespace, group] of this.tokenGroups) {
 				const groupRefs = {};
 				for (const [name, token] of group.tokens) {
 					tokens.set(`${namespace}/${name}`, token);
+					if (token.link) tokensBySource.set(`${token.link.systemId}:${token.link.sourceKey}`, token);
 					groupRefs[name] = token.derived.cssVarRef;
 				}
 				cssVarRefs[namespace] = groupRefs;
@@ -1272,12 +1257,39 @@ var Config = class Config {
 			}
 			this.#derived = {
 				tokens,
+				tokensBySource,
 				cssVarRefs,
 				modeOptionsByModifier
 			};
 		}
 		return this.#derived;
 	}
+	/**
+	* Resolve a `token()` ref, provenance-aware — the ONE lookup every ref
+	* consumer (registration wiring, `validate()`, codegen emission) should
+	* use. A ref authored on a linked token (`context` set) names the SOURCE
+	* system's groups, so it resolves through the provenance index only —
+	* falling back to the consumer's own keys would let a coincidentally-named
+	* local group silently shadow a missing source group. Local refs resolve
+	* against consumer keys.
+	*/
+	resolveTokenRef(ref, context) {
+		if (context) return this.derived.tokensBySource.get(`${context.systemId}:${ref}`);
+		return this.derived.tokens.get(ref);
+	}
+	/**
+	* Pin-consistency gate for a link-marked token entering the registry.
+	* Catches hand-forged markers (unpinned system), stale registry barrels
+	* (version mismatch), and mis-kinded markers before they poison lookups.
+	*/
+	#assertLinkedTokenPinned(groupName, tokenName, link) {
+		if (!link) return;
+		const label = `Config.registerTokenGroups: token "${groupName}/${tokenName}"`;
+		if (link.kind !== "token") throw new Error(`${label} carries a "${link.kind}" link marker — a token entry can only carry kind "token" (a token-group link spreads to per-token markers).`);
+		const pin = this.linkedSystems.get(link.systemId);
+		if (!pin) throw new Error(`${label} is linked from system "${link.systemId}", which has no registerLinkedSystems pin — pin the system (name + exact version) before registering values linked from it.`);
+		if (pin.version !== link.systemVersion) throw new Error(`${label} is linked at version "${link.systemVersion}" but system "${pin.name}" is pinned at "${pin.version}" — the registry barrel is stale; re-run \`uds pull\`.`);
+	}
 	#invalidate() {
 		this.#derived = void 0;
 	}
@@ -1334,7 +1346,7 @@ var Config = class Config {
 	*/
 	validate() {
 		const tokens = this.derived.tokens;
-		for (const [qualified, token] of tokens) visit(qualified, token, tokens, /* @__PURE__ */ new Set());
+		for (const [qualified, token] of tokens) visit(qualified, token, (ref, context) => this.resolveTokenRef(ref, context), /* @__PURE__ */ new Set());
 		for (const styleProp of this.styleProps.values()) for (const groupName of styleProp.consumedTokenGroups()) if (!this.tokenGroups.has(groupName)) throw new Error(`Style prop '${styleProp.name}' references unknown token group '${groupName}'`);
 		for (const modifier of this.modifiers.values()) {
 			const selector = modifier.selector;
@@ -1422,10 +1434,7 @@ var Config = class Config {
 			out.canvasRoles = canvasRoles;
 		}
 		if (this.playgroundOptions.port !== void 0) out.playgroundOptions = { port: this.playgroundOptions.port };
-		if (this.linkedComponents.size > 0) out.linkedComponents = mapToRecord(this.linkedComponents, (entry) => ({
-			...entry,
-			components: entry.components === "all" ? "all" : [...entry.components]
-		}));
+		if (this.linkedSystems.size > 0) out.linkedSystems = mapToRecord(this.linkedSystems, (pin) => ({ ...pin }));
 		return out;
 	}
 	/**
@@ -1444,12 +1453,12 @@ var Config = class Config {
 		if (json.globalStyles) config.globalStyles = json.globalStyles;
 		if (json.rawCss) config.rawCss = [...json.rawCss];
 		if (json.modes) config.registerModes(json.modes);
+		if (json.linkedSystems) config.registerLinkedSystems(json.linkedSystems);
 		if (json.tokenGroups) config.registerTokenGroups(json.tokenGroups);
 		if (json.styleProps) config.registerStyleProps(json.styleProps);
 		if (json.modifiers) config.registerModifiers(json.modifiers);
 		if (json.compositeStyles) config.registerComposites(json.compositeStyles);
 		if (json.motion) config.registerMotion(json.motion);
-		if (json.linkedComponents) config.registerLinkedComponents(json.linkedComponents);
 		const componentsByName = json.components ?? {};
 		for (const def of Object.values(componentsByName)) if (def.sourceFilePath) attachSourcePath(def, def.sourceFilePath);
 		const isSubcomponent = /* @__PURE__ */ new Set();
@@ -1569,20 +1578,15 @@ function parseRegistryKey(type) {
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 /** Exact `major.minor.patch` with optional prerelease/build — no ranges. */
 const EXACT_SEMVER_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
-function validateLinkedSystemEntry(systemId, entry, existing) {
-	const label = `Config.registerLinkedComponents: system id "${systemId}"`;
-	if (!UUID_RE.test(systemId)) throw new Error(`${label} must be a UUID — links are keyed by the source system's database id, not its slug or name.`);
-	if (existing.has(systemId)) throw new Error(`${label} is already linked ("${existing.get(systemId)?.name}") — update or remove the existing entry instead of re-linking.`);
-	if (entry.name.trim().length === 0) throw new Error(`${label}: name must be non-empty — it's the system's display-name snapshot at link time.`);
-	if (!EXACT_SEMVER_RE.test(entry.version)) throw new Error(`${label}: version "${entry.version}" must be an exact semver literal (e.g. "1.3.1") — ranges and tags are not supported.`);
-	if (entry.components === "all") return;
-	if (entry.components.length === 0) throw new Error(`${label}: at least one component name is required (or pass 'all' to link every component).`);
-	const seen = /* @__PURE__ */ new Set();
-	for (const name of entry.components) {
-		if (name.trim().length === 0) throw new Error(`${label}: component names must be non-empty strings.`);
-		if (seen.has(name)) throw new Error(`${label}: duplicate component "${name}".`);
-		seen.add(name);
-	}
+function validateLinkedSystemPin(systemId, pin, existing) {
+	const label = `Config.registerLinkedSystems: system id "${systemId}"`;
+	if (!UUID_RE.test(systemId)) throw new Error(`${label} must be a UUID — pins are keyed by the source system's database id, not its slug or name.`);
+	if (existing.has(systemId)) {
+		const prior = existing.get(systemId);
+		throw new Error(`${label} is already pinned ("${prior?.name}" @ ${prior?.version}) — a config pins one version per system; update the existing pin instead of re-pinning.`);
+	}
+	if (pin.name.trim().length === 0) throw new Error(`${label}: name must be non-empty — it's the system's display-name snapshot at link time and feeds the registry folder slug.`);
+	if (!EXACT_SEMVER_RE.test(pin.version)) throw new Error(`${label}: version "${pin.version}" must be an exact semver literal (e.g. "1.3.1") — ranges and tags are not supported.`);
 }
 function validateNamespace(value) {
 	if (value.length === 0) throw new Error("Config.configure: namespace must be non-empty.");
@@ -1591,15 +1595,39 @@ function validateNamespace(value) {
 	if (value === "foreign") throw new Error(`Config.configure: namespace "${FOREIGN_NAMESPACE}" is reserved for third-party leaf components (the \`${FOREIGN_NAMESPACE}:<Component>\` sentinel).`);
 	return value;
 }
-function visit(qualified, token, tokens, seen) {
+/**
+* Cross-reference walk for one token's alias chain, provenance-aware.
+* `resolve` is the config's `resolveTokenRef` — a ref on a linked token
+* resolves through the provenance index (source-system keys), a local ref
+* through consumer keys. A dangling ref on a linked token is a closure
+* violation (the source group it names was never linked), which gets its own
+* actionable error; a dangling local ref stays the classic unknown-token
+* error. Modifier refs are checked for linked tokens only — the closure rule
+* is new with linking, and local modifier behavior is unchanged.
+*/
+function visit(qualified, token, resolve, seen) {
 	if (seen.has(qualified)) throw new Error(`Token cycle detected at '${qualified}'`);
-	const value = token.value;
-	if (typeof value === "object" && value !== null && "ref" in value && typeof value.ref === "string") {
-		const next = tokens.get(value.ref);
-		if (!next) throw new Error(`Token '${qualified}' references unknown token '${value.ref}'`);
-		visit(value.ref, next, tokens, new Set(seen).add(qualified));
+	const followRef = (ref) => {
+		const next = resolve(ref, token.link);
+		if (!next) {
+			if (token.link) {
+				const [sourceGroup] = ref.split("/");
+				throw new Error(`Token '${qualified}' is linked from system "${token.link.systemId}" and references its token '${ref}', which nothing in this config provides — link the source system's "${sourceGroup}" group too (refs on linked tokens resolve by provenance, not by local group names).`);
+			}
+			throw new Error(`Token '${qualified}' references unknown token '${ref}'`);
+		}
+		visit(`${next.namespace}/${next.name}`, next, resolve, new Set(seen).add(qualified));
+	};
+	if (isTokenRefValue(token.value)) followRef(token.value.ref);
+	if (token.link && token.modifiers) for (const value of Object.values(token.modifiers)) {
+		const inner = typeof value === "object" && value !== null && "value" in value ? value.value : value;
+		if (isTokenRefValue(inner)) followRef(inner.ref);
 	}
 }
+/** A `token()` ref marker — `{ ref: 'ns/name' }` — in a value position. */
+function isTokenRefValue(value) {
+	return typeof value === "object" && value !== null && "ref" in value && typeof value.ref === "string";
+}
 function stripName(entity) {
 	const { name: _name, namespace: _namespace, ...rest } = entity.toJSON();
 	return rest;

package/dist/Token.d.ts

@@ -12,8 +12,15 @@ type ResolvedTokenLiteral = string | number | boolean | undefined;
  * Looks up another token by `namespace/name`. Injected by the parent
  * Config so `Token.derived.value` can chase `token()` aliases without
  * holding a back-ref to the whole config object.
+ *
+ * `context` is the provenance of the token the ref was authored on. A ref
+ * inside a linked token is written against the SOURCE system's group names
+ * (`token('base/carbon-5')` in a group linked from Yahoo OS means Yahoo OS's
+ * `base` group, whatever the consumer renamed it to), so the lookup resolves
+ * it through the link markers instead of the consumer's own keys. Local
+ * tokens pass no context and resolve against the consumer's keys directly.
  */
-type TokenSiblingLookup = (qualifiedName: string) => Token | undefined;
+type TokenSiblingLookup = (qualifiedName: string, context?: SystemLink) => Token | undefined;
 declare class Token {
   #private;
   readonly name: string;

package/dist/Token.js

@@ -43,6 +43,7 @@ var Token = class {
 			const tokenValue = this.value;
 			const tokenType = this.type;
 			const modifiers = this.modifiers;
+			const link = this.link;
 			const prefixGetter = this.#prefixGetter;
 			const lookup = this.#lookup;
 			const groupTypeGetter = this.#groupTypeGetter;
@@ -57,10 +58,10 @@ var Token = class {
 					return `var(${buildCssVar(prefixGetter(), namespace, name)})`;
 				},
 				get value() {
-					return chaseLiteral(tokenValue, lookup);
+					return chaseLiteral(tokenValue, lookup, link);
 				},
 				get cssValueType() {
-					const literal = chaseLiteral(tokenValue, lookup);
+					const literal = chaseLiteral(tokenValue, lookup, link);
 					return resolveTokenValueType({
 						value: typeof literal === "string" ? literal : String(tokenValue),
 						type: tokenType
@@ -68,7 +69,7 @@ var Token = class {
 				},
 				*modifierValues() {
 					if (!modifiers) return;
-					for (const [key, value] of Object.entries(modifiers)) yield [key, resolveModifierLiteral(value, lookup)];
+					for (const [key, value] of Object.entries(modifiers)) yield [key, resolveModifierLiteral(value, lookup, link)];
 				}
 			};
 		}
@@ -99,19 +100,20 @@ function collectModifiers(definition) {
 	}
 	return count > 0 ? modifiers : void 0;
 }
-function chaseLiteral(value, lookup, seen = /* @__PURE__ */ new Set()) {
+function chaseLiteral(value, lookup, context, seen = /* @__PURE__ */ new Set()) {
 	if (isTokenRef(value)) {
-		if (seen.has(value.ref)) return void 0;
-		seen.add(value.ref);
-		const next = lookup(value.ref);
+		const seenKey = `${context?.systemId ?? ""}:${value.ref}`;
+		if (seen.has(seenKey)) return void 0;
+		seen.add(seenKey);
+		const next = lookup(value.ref, context);
 		if (!next) return void 0;
-		return chaseLiteral(next.value, lookup, seen);
+		return chaseLiteral(next.value, lookup, next.link, seen);
 	}
 	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
 }
-function resolveModifierLiteral(value, lookup) {
-	if (typeof value === "object" && value !== null && "value" in value) return chaseLiteral(value.value, lookup);
-	return chaseLiteral(value, lookup);
+function resolveModifierLiteral(value, lookup, context) {
+	if (typeof value === "object" && value !== null && "value" in value) return chaseLiteral(value.value, lookup, context);
+	return chaseLiteral(value, lookup, context);
 }
 //#endregion
 export { Token };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { ColorExpression, ColorSpace, ColorValue, GradientStop, GradientValue, L
 import { MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DRAG_AXES, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS } from "./motion-constants.js";
 import { CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, CssPropertyWithKeywords } from "./types/css-property-keywords.js";
 import { ColorCssProperty, CssGlobalKeyword, CssPropertyName, CssPropertyValues } from "./types/css-properties.js";
-import { AnyStylePropDefinition, ArbitrarySpec, BaseStyles, BuildOptions, CanvasRole, CanvasRoleEntry, CanvasRoleEntryInput, CanvasRolesDefinition, CanvasRolesDefinitionInput, CanvasRolesInputConstraint, ComponentDefinition, ComponentGroupDefinition, ComponentMetadata, CompositeStyleDefinition, CompositeStyleObject, CompoundPropsEntry, CssMotionDefinition, CssMotionFields, CssSlotMotion, FontAssetMember, GlobalStylesDef, JsMotionDefinition, JsMotionFields, JsSlotMotion, LayerInput, LinkedComponentsInput, LinkedSystemEntry, LiteralFor, ModeDefinition, ModeOptionDefinition, ModifierDefinition, MotionDefinitionInput, MotionDragBox, MotionKeyframes, MotionMetadata, MotionState, MotionStateKeyframe, MotionTransition, MotionVariants, MotionViewportOptions, OpacityPairSpec, PlaygroundOptions, PlaygroundPage, PlaygroundSpec, PreviewDefinition, PropBinding, SerializedAssetGroup, SerializedComponentGroup, SerializedConfig, SerializedFontAssetGroup, SerializedIconAssetGroup, SerializedPlaygroundOptions, SerializedTokenGroup, SlotMotion, StylePropDefinition, StylePropMetadata, StylePropProperty, SystemLink, TokenDefinition, TokenDefinitionFor, TokenGroupDefinition, TokenGroupDefinitionFor, TokenModifierKey, TokenModifierValue, TokenType, TokenValue, ValuesEntry } from "./types.js";
+import { AnyStylePropDefinition, ArbitrarySpec, BaseStyles, BuildOptions, CanvasRole, CanvasRoleEntry, CanvasRoleEntryInput, CanvasRolesDefinition, CanvasRolesDefinitionInput, CanvasRolesInputConstraint, ComponentDefinition, ComponentGroupDefinition, ComponentMetadata, CompositeStyleDefinition, CompositeStyleObject, CompoundPropsEntry, CssMotionDefinition, CssMotionFields, CssSlotMotion, FontAssetMember, GlobalStylesDef, JsMotionDefinition, JsMotionFields, JsSlotMotion, LayerInput, LinkedSystemPin, LinkedSystemsInput, LiteralFor, ModeDefinition, ModeOptionDefinition, ModifierDefinition, MotionDefinitionInput, MotionDragBox, MotionKeyframes, MotionMetadata, MotionState, MotionStateKeyframe, MotionTransition, MotionVariants, MotionViewportOptions, OpacityPairSpec, PlaygroundOptions, PlaygroundPage, PlaygroundSpec, PreviewDefinition, PropBinding, SerializedAssetGroup, SerializedComponentGroup, SerializedConfig, SerializedFontAssetGroup, SerializedIconAssetGroup, SerializedPlaygroundOptions, SerializedTokenGroup, SlotMotion, StylePropDefinition, StylePropMetadata, StylePropProperty, SystemLink, TokenDefinition, TokenDefinitionFor, TokenGroupDefinition, TokenGroupDefinitionFor, TokenModifierKey, TokenModifierValue, TokenType, TokenValue, ValuesEntry } from "./types.js";
 import { AssetGroupBuilder, AssetGroupConfig, AssetGroupDefinition, FontAssetGroupConfig, FontAssetGroupDefinition, IconAssetGroupConfig, IconAssetGroupDefinition, IconAssetMember, IconAssetMetadata, defineAssetGroup, defineAssetIcon } from "./defineAssetGroup.js";
 import { AssetGroup } from "./AssetGroup.js";
 import { resolveAssetRefCss, resolveFontStack } from "./asset-value.js";
@@ -32,8 +32,9 @@ import { ConfigDiagnostic, ConfigDiagnosticDefinition, ConfigValidationError } f
 import { ELEMENT_MARKER_KIND, ElementMarker, OpaqueLeafPredicate, hasElementMarkerDeep, isElementLikeValue, isElementMarker, reviveElementMarkersDeep, serializeElementsDeep } from "./element-marker.js";
 import { collectFontFaceCss, deriveFontFaceCss, familiesInRawCss } from "./font-face.js";
 import { interpolate } from "./interpolate.js";
+import { RegistryAliasSource, buildRegistryAliases, slugifyLinkedName } from "./registry-aliases.js";
 import { resolveRegistryDir } from "./registry-dir.js";
 import { ModeBackedModifierDefinition, ModeBackedModifierInput, ModeBackedModifierLookup, ModifierTree, OverrideModeRef, OverrideRow, buildModeBackedModifierLookup, buildNestedModifierUpdate, createModeBackedModifierLookup, mergeModifierUpdates, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, overrideRowsToModifierTree, resolveOverrideRow, resolveOverrideRowValue } from "./token-override-rows.js";
 import { rem } from "./units.js";
 import { EntityKind } from "@yahoo/uds-create-types/entity";
-export { ASSET_CLASS_CAPABILITIES, type AnyRef, type AnyStylePropDefinition, type ArbitrarySpec, AssetGroup, type AssetGroupBuilder, type AssetGroupConfig, type AssetGroupDefinition, type AssetGroupName, type AssetGroupRef, type AssetKind, type AssetName, type AssetRef, type BaseStyles, type BooleanMarker, type BoundComponent, type BuildOptions, CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, type CanvasRole, type CanvasRoleEntry, type CanvasRoleEntryInput, type CanvasRolesDefinition, type CanvasRolesDefinitionInput, type CanvasRolesInputConstraint, type ColorCssProperty, type ColorExpression, type ColorFn, type ColorKeyword, type ColorSpace, type ColorValue, Component, type ComponentBuilder, type ComponentBuilderMethods, type ComponentDefinition, ComponentGroup, type ComponentGroupDefinition, type ComponentKind, type ComponentMetadata, type ComponentName, type ComponentRef, type ComponentRenderFn, type CompositeInfo, type CompositeName, type CompositeRef, type CompositeRefBuilder, CompositeStyle, type CompositeStyleDefinition, type CompositeStyleObject, type CompoundPropsEntry, Config, type ConfigCallbackHelpers, type ConfigDiagnostic, type ConfigDiagnosticDefinition, ConfigValidationError, type Css, type CssAngle, type CssClassName, type CssColor, type CssDeclaration, type CssGlobalKeyword, type CssLength, CssMotionDef, type CssMotionDefinition, type CssMotionFields, type CssPercentage, type CssPropertyName, type CssPropertyValues, type CssPropertyWithKeywords, type CssRatio, type CssSelector, type CssSlotMotion, type CssTime, type CssValue, type CssValueTypeName, type CssVar, type CssVarRef, type DataAttrs, type DefineComponentFn, type DefinedComponent, type DefinedMotion, type DefinedProvider, type DefinedStyleProp, type DefinedTokenGroup, type DependenciesQuery, type DependencyKind, type DependencyRef, type DependentsQuery, ELEMENT_MARKER_KIND, type ElementMarker, type EntityKind, type FontAssetGroupConfig, type FontAssetGroupDefinition, type FontAssetMember, type FunctionInfo, type GlobalStylesDef, type GradientStop, type GradientValue, type HexColor, type HslColor, type IconAssetGroupConfig, type IconAssetGroupDefinition, type IconAssetMember, type IconAssetMetadata, JsMotionDef, type JsMotionDefinition, type JsMotionFields, type JsSlotMotion, Layer, type LayerInput, type LayerMarker, type LayerPropsMap, type LengthOrPercent, type LineDirection, type LinearGradientExpr, type LinkedComponentsInput, type LinkedSystemEntry, type LiteralFor, MOTION_CSS_DEFINITION_KEYS, MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DEFINITION_KEYS, MOTION_JS_DRAG_AXES, MOTION_JS_FIELD_KEYS, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS, type MixExpr, Mode, type ModeBackedModifierDefinition, type ModeBackedModifierInput, type ModeBackedModifierLookup, type ModeDefinition, type ModeName, ModeOption, type ModeOptionDefinition, type ModeRef, Modifier, type ModifierDefinition, type ModifierTree, type MotionDef, type MotionDefinitionInput, type MotionDragBox, type MotionKeyframes, type MotionMarker, type MotionMetadata, type MotionName, type MotionState, type MotionStateKeyframe, type MotionTransition, type MotionVariants, type MotionViewportOptions, type NumberMarker, type OpacityPairSpec, type OpaqueLeafPredicate, type OverrideModeRef, type OverrideRow, PREVIEW_SEED_KEY, type PlaygroundOptions, type PlaygroundPage, type PlaygroundSpec, type PreviewAxisMarker, type PreviewCallbackHelpers, type PreviewDefinition, type PreviewPropsRule, type PrimitivePropKind, type PropBase, type PropBinding, type PropInfo, type PropKind, Provider, type RadialGradientExpr, type RadialSize, type RawToken, type RegisteredAssetGroups, type RegisteredComponents, type RegisteredCompositeStyles, type RegisteredModes, type RegisteredModifiers, type RegisteredMotion, type RegisteredStyleProps, type RegisteredTokenGroups, type RequiredBrand, type ResolvedCompoundOverrides, type ResolvedTokenLiteral, type RgbColor, SOURCE_PATH_KEY, type SerializedAssetGroup, type SerializedComponentGroup, type SerializedConfig, type SerializedFontAssetGroup, type SerializedIconAssetGroup, type SerializedPlaygroundOptions, type SerializedTokenGroup, type SlotInfo, type SlotMarker, type SlotMotion, type SlotRef, type SlotValueKind, type SlotValueType, type StringMarker, StyleProp, type StylePropDefinition, type StylePropInfo, type StylePropKeyword, type StylePropMetadata, type StylePropName, type StylePropProperty, type StylePropRef, type StylePropTokenUsage, type SystemLink, type TagName, type TagRef, Token, type TokenDefinition, type TokenDefinitionFor, TokenGroup, type TokenGroupDefinition, type TokenGroupDefinitionFor, type TokenGroupMetadata, type TokenGroupName, type TokenGroupRef, type TokenModifierKey, type TokenModifierValue, type TokenName, type TokenQualifiedName, type TokenRawNameRegistry, type TokenRawValue, type TokenRef, type TokenRefToCss, type TokenType, type TokenValue, type TypedSlotRef, type ValuesEntry, type VariantInfo, type VariantMarker, type VariantMarkerArray, type VariantMarkerObject, alpha, asChild, asset, assetGroup, attachSourcePath, boolean, buildModeBackedModifierLookup, buildNestedModifierUpdate, captureCallerPath, collectFontFaceCss, component, composite, createModeBackedModifierLookup, cssClassName, cssDeclaration, cssSelector, cssVar, defineAssetGroup, defineAssetIcon, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineProvider, defineStyleProp, defineTokenGroup, deriveFontFaceCss, familiesInRawCss, findComponentReferrers, hasElementMarkerDeep, interpolate, isAssetGroupRef, isAssetRef, isBoolMarker, isColorExpression, isComponentRef, isCompositeRef, isElementLikeValue, isElementMarker, isLayerMarker, isLinearGradientExpr, isMixExpr, isModeRef, isMotionMarker, isNumberMarker, isPlaceable, isPreviewAxisMarker, isRadialGradientExpr, isSafeClassNameValue, isSlotMarker, isStringMarker, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, isVariantArrayMarker, isVariantMarker, linearGradient, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveFontStack, resolveOverrideRow, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, string, styleProp, tag, token, tokenGroup, variant };
+export { ASSET_CLASS_CAPABILITIES, type AnyRef, type AnyStylePropDefinition, type ArbitrarySpec, AssetGroup, type AssetGroupBuilder, type AssetGroupConfig, type AssetGroupDefinition, type AssetGroupName, type AssetGroupRef, type AssetKind, type AssetName, type AssetRef, type BaseStyles, type BooleanMarker, type BoundComponent, type BuildOptions, CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, type CanvasRole, type CanvasRoleEntry, type CanvasRoleEntryInput, type CanvasRolesDefinition, type CanvasRolesDefinitionInput, type CanvasRolesInputConstraint, type ColorCssProperty, type ColorExpression, type ColorFn, type ColorKeyword, type ColorSpace, type ColorValue, Component, type ComponentBuilder, type ComponentBuilderMethods, type ComponentDefinition, ComponentGroup, type ComponentGroupDefinition, type ComponentKind, type ComponentMetadata, type ComponentName, type ComponentRef, type ComponentRenderFn, type CompositeInfo, type CompositeName, type CompositeRef, type CompositeRefBuilder, CompositeStyle, type CompositeStyleDefinition, type CompositeStyleObject, type CompoundPropsEntry, Config, type ConfigCallbackHelpers, type ConfigDiagnostic, type ConfigDiagnosticDefinition, ConfigValidationError, type Css, type CssAngle, type CssClassName, type CssColor, type CssDeclaration, type CssGlobalKeyword, type CssLength, CssMotionDef, type CssMotionDefinition, type CssMotionFields, type CssPercentage, type CssPropertyName, type CssPropertyValues, type CssPropertyWithKeywords, type CssRatio, type CssSelector, type CssSlotMotion, type CssTime, type CssValue, type CssValueTypeName, type CssVar, type CssVarRef, type DataAttrs, type DefineComponentFn, type DefinedComponent, type DefinedMotion, type DefinedProvider, type DefinedStyleProp, type DefinedTokenGroup, type DependenciesQuery, type DependencyKind, type DependencyRef, type DependentsQuery, ELEMENT_MARKER_KIND, type ElementMarker, type EntityKind, type FontAssetGroupConfig, type FontAssetGroupDefinition, type FontAssetMember, type FunctionInfo, type GlobalStylesDef, type GradientStop, type GradientValue, type HexColor, type HslColor, type IconAssetGroupConfig, type IconAssetGroupDefinition, type IconAssetMember, type IconAssetMetadata, JsMotionDef, type JsMotionDefinition, type JsMotionFields, type JsSlotMotion, Layer, type LayerInput, type LayerMarker, type LayerPropsMap, type LengthOrPercent, type LineDirection, type LinearGradientExpr, type LinkedSystemPin, type LinkedSystemsInput, type LiteralFor, MOTION_CSS_DEFINITION_KEYS, MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DEFINITION_KEYS, MOTION_JS_DRAG_AXES, MOTION_JS_FIELD_KEYS, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS, type MixExpr, Mode, type ModeBackedModifierDefinition, type ModeBackedModifierInput, type ModeBackedModifierLookup, type ModeDefinition, type ModeName, ModeOption, type ModeOptionDefinition, type ModeRef, Modifier, type ModifierDefinition, type ModifierTree, type MotionDef, type MotionDefinitionInput, type MotionDragBox, type MotionKeyframes, type MotionMarker, type MotionMetadata, type MotionName, type MotionState, type MotionStateKeyframe, type MotionTransition, type MotionVariants, type MotionViewportOptions, type NumberMarker, type OpacityPairSpec, type OpaqueLeafPredicate, type OverrideModeRef, type OverrideRow, PREVIEW_SEED_KEY, type PlaygroundOptions, type PlaygroundPage, type PlaygroundSpec, type PreviewAxisMarker, type PreviewCallbackHelpers, type PreviewDefinition, type PreviewPropsRule, type PrimitivePropKind, type PropBase, type PropBinding, type PropInfo, type PropKind, Provider, type RadialGradientExpr, type RadialSize, type RawToken, type RegisteredAssetGroups, type RegisteredComponents, type RegisteredCompositeStyles, type RegisteredModes, type RegisteredModifiers, type RegisteredMotion, type RegisteredStyleProps, type RegisteredTokenGroups, type RegistryAliasSource, type RequiredBrand, type ResolvedCompoundOverrides, type ResolvedTokenLiteral, type RgbColor, SOURCE_PATH_KEY, type SerializedAssetGroup, type SerializedComponentGroup, type SerializedConfig, type SerializedFontAssetGroup, type SerializedIconAssetGroup, type SerializedPlaygroundOptions, type SerializedTokenGroup, type SlotInfo, type SlotMarker, type SlotMotion, type SlotRef, type SlotValueKind, type SlotValueType, type StringMarker, StyleProp, type StylePropDefinition, type StylePropInfo, type StylePropKeyword, type StylePropMetadata, type StylePropName, type StylePropProperty, type StylePropRef, type StylePropTokenUsage, type SystemLink, type TagName, type TagRef, Token, type TokenDefinition, type TokenDefinitionFor, TokenGroup, type TokenGroupDefinition, type TokenGroupDefinitionFor, type TokenGroupMetadata, type TokenGroupName, type TokenGroupRef, type TokenModifierKey, type TokenModifierValue, type TokenName, type TokenQualifiedName, type TokenRawNameRegistry, type TokenRawValue, type TokenRef, type TokenRefToCss, type TokenType, type TokenValue, type TypedSlotRef, type ValuesEntry, type VariantInfo, type VariantMarker, type VariantMarkerArray, type VariantMarkerObject, alpha, asChild, asset, assetGroup, attachSourcePath, boolean, buildModeBackedModifierLookup, buildNestedModifierUpdate, buildRegistryAliases, captureCallerPath, collectFontFaceCss, component, composite, createModeBackedModifierLookup, cssClassName, cssDeclaration, cssSelector, cssVar, defineAssetGroup, defineAssetIcon, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineProvider, defineStyleProp, defineTokenGroup, deriveFontFaceCss, familiesInRawCss, findComponentReferrers, hasElementMarkerDeep, interpolate, isAssetGroupRef, isAssetRef, isBoolMarker, isColorExpression, isComponentRef, isCompositeRef, isElementLikeValue, isElementMarker, isLayerMarker, isLinearGradientExpr, isMixExpr, isModeRef, isMotionMarker, isNumberMarker, isPlaceable, isPreviewAxisMarker, isRadialGradientExpr, isSafeClassNameValue, isSlotMarker, isStringMarker, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, isVariantArrayMarker, isVariantMarker, linearGradient, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveFontStack, resolveOverrideRow, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, slugifyLinkedName, string, styleProp, tag, token, tokenGroup, variant };

package/dist/index.js

@@ -27,8 +27,9 @@ import { asChild, boolean, defineComponent, defineComponentGroup, defineComposit
 import { collectFontFaceCss, deriveFontFaceCss, familiesInRawCss } from "./font-face.js";
 import { interpolate } from "./interpolate.js";
 import { MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DRAG_AXES, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS } from "./motion-constants.js";
+import { buildRegistryAliases, slugifyLinkedName } from "./registry-aliases.js";
 import { resolveRegistryDir } from "./registry-dir.js";
 import { buildModeBackedModifierLookup, buildNestedModifierUpdate, createModeBackedModifierLookup, mergeModifierUpdates, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, overrideRowsToModifierTree, resolveOverrideRow, resolveOverrideRowValue } from "./token-override-rows.js";
 import { CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS } from "./types/css-property-keywords.js";
 import { rem } from "./units.js";
-export { ASSET_CLASS_CAPABILITIES, AssetGroup, CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, Component, ComponentGroup, CompositeStyle, Config, ConfigValidationError, CssMotionDef, ELEMENT_MARKER_KIND, JsMotionDef, Layer, MOTION_CSS_DEFINITION_KEYS, MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DEFINITION_KEYS, MOTION_JS_DRAG_AXES, MOTION_JS_FIELD_KEYS, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS, Mode, ModeOption, Modifier, PREVIEW_SEED_KEY, Provider, SOURCE_PATH_KEY, StyleProp, Token, TokenGroup, alpha, asChild, asset, assetGroup, attachSourcePath, boolean, buildModeBackedModifierLookup, buildNestedModifierUpdate, captureCallerPath, collectFontFaceCss, component, composite, createModeBackedModifierLookup, cssClassName, cssDeclaration, cssSelector, cssVar, defineAssetGroup, defineAssetIcon, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineProvider, defineStyleProp, defineTokenGroup, deriveFontFaceCss, familiesInRawCss, findComponentReferrers, hasElementMarkerDeep, interpolate, isAssetGroupRef, isAssetRef, isBoolMarker, isColorExpression, isComponentRef, isCompositeRef, isElementLikeValue, isElementMarker, isLayerMarker, isLinearGradientExpr, isMixExpr, isModeRef, isMotionMarker, isNumberMarker, isPlaceable, isPreviewAxisMarker, isRadialGradientExpr, isSafeClassNameValue, isSlotMarker, isStringMarker, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, isVariantArrayMarker, isVariantMarker, linearGradient, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveFontStack, resolveOverrideRow, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, string, styleProp, tag, token, tokenGroup, variant };
+export { ASSET_CLASS_CAPABILITIES, AssetGroup, CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, Component, ComponentGroup, CompositeStyle, Config, ConfigValidationError, CssMotionDef, ELEMENT_MARKER_KIND, JsMotionDef, Layer, MOTION_CSS_DEFINITION_KEYS, MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DEFINITION_KEYS, MOTION_JS_DRAG_AXES, MOTION_JS_FIELD_KEYS, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS, Mode, ModeOption, Modifier, PREVIEW_SEED_KEY, Provider, SOURCE_PATH_KEY, StyleProp, Token, TokenGroup, alpha, asChild, asset, assetGroup, attachSourcePath, boolean, buildModeBackedModifierLookup, buildNestedModifierUpdate, buildRegistryAliases, captureCallerPath, collectFontFaceCss, component, composite, createModeBackedModifierLookup, cssClassName, cssDeclaration, cssSelector, cssVar, defineAssetGroup, defineAssetIcon, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineProvider, defineStyleProp, defineTokenGroup, deriveFontFaceCss, familiesInRawCss, findComponentReferrers, hasElementMarkerDeep, interpolate, isAssetGroupRef, isAssetRef, isBoolMarker, isColorExpression, isComponentRef, isCompositeRef, isElementLikeValue, isElementMarker, isLayerMarker, isLinearGradientExpr, isMixExpr, isModeRef, isMotionMarker, isNumberMarker, isPlaceable, isPreviewAxisMarker, isRadialGradientExpr, isSafeClassNameValue, isSlotMarker, isStringMarker, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, isVariantArrayMarker, isVariantMarker, linearGradient, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveFontStack, resolveOverrideRow, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, slugifyLinkedName, string, styleProp, tag, token, tokenGroup, variant };

package/dist/registry-aliases.d.ts

@@ -0,0 +1,33 @@
+//#region src/registry-aliases.d.ts
+/**
+ * Import-alias slugs for the linked-system registry (UDS-2771).
+ * Each top-level linked dependency gets a stable folder alias — the slug
+ * derives from the entry's `name` in the consumer's own
+ * `registerLinkedSystems` pin (stable across remote renames, fixable
+ * locally on collision). The pull materializer uses these aliases to
+ * rewrite a node's own `@uds-registry/{slug}` imports into relative paths,
+ * keeping the on-disk tree self-contained; the link patch applier uses the
+ * same slugs for the consumer's own barrel imports.
+ */
+/** One top-level declared dependency, as needed for alias building. */
+interface RegistryAliasSource {
+  systemId: string;
+  version: string;
+  /** Display name from the consumer's registerLinkedSystems pin. */
+  name: string;
+}
+/**
+ * Slug for one linked system's import alias: lowercase, hyphen-separated,
+ * ASCII-safe. Names that reduce to nothing get a generic fallback (the
+ * collision suffix in {@link buildRegistryAliases} keeps them distinct).
+ */
+declare function slugifyLinkedName(name: string): string;
+/**
+ * Map top-level declared dependencies to `slug → {systemId}@{version}` (the
+ * registry folder name). Colliding slugs keep declaration order: the first
+ * wins the bare slug, later ones get a `-{systemId-prefix}` suffix — still
+ * deterministic across machines.
+ */
+declare function buildRegistryAliases(roots: RegistryAliasSource[]): Record<string, string>;
+//#endregion
+export { RegistryAliasSource, buildRegistryAliases, slugifyLinkedName };

package/dist/registry-aliases.js

@@ -0,0 +1,27 @@
+//#region src/registry-aliases.ts
+/**
+* Slug for one linked system's import alias: lowercase, hyphen-separated,
+* ASCII-safe. Names that reduce to nothing get a generic fallback (the
+* collision suffix in {@link buildRegistryAliases} keeps them distinct).
+*/
+function slugifyLinkedName(name) {
+	const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+	return slug === "" ? "linked-system" : slug;
+}
+/**
+* Map top-level declared dependencies to `slug → {systemId}@{version}` (the
+* registry folder name). Colliding slugs keep declaration order: the first
+* wins the bare slug, later ones get a `-{systemId-prefix}` suffix — still
+* deterministic across machines.
+*/
+function buildRegistryAliases(roots) {
+	const aliases = {};
+	for (const root of roots) {
+		let slug = slugifyLinkedName(root.name);
+		if (aliases[slug] !== void 0) slug = `${slug}-${root.systemId.slice(0, 8)}`;
+		aliases[slug] = `${root.systemId}@${root.version}`;
+	}
+	return aliases;
+}
+//#endregion
+export { buildRegistryAliases, slugifyLinkedName };

package/dist/registry-dir.d.ts

@@ -9,8 +9,8 @@
  *   1. `buildOptions.registryDir` when the consumer sets one;
  *   2. `<componentsDir>/registry` — the default, keeping the registry inside
  *      the design system's own subtree;
- *   3. `.uds-registry` — the legacy project-root layout, for configs that
- *      declare no `componentsDir`.
+ *   3. `registry` at the project root, for configs that declare no
+ *      `componentsDir`.
  */
 interface RegistryDirOptions {
   componentsDir?: string;

package/dist/registry-dir.js

@@ -4,7 +4,7 @@ const normalize = (p) => p.replace(/\\/g, "/").replace(/\/+$/, "");
 function resolveRegistryDir(buildOptions) {
 	if (buildOptions?.registryDir) return normalize(buildOptions.registryDir);
 	if (buildOptions?.componentsDir) return `${normalize(buildOptions.componentsDir)}/registry`;
-	return ".uds-registry";
+	return "registry";
 }
 //#endregion
 export { resolveRegistryDir };