@yahoo/uds-create-config 2.34.0 → 2.36.0

package/dist/Config.d.ts

@@ -100,6 +100,21 @@ declare class Config {
    * link-marked value against it.
    */
   readonly linkedSystems: Map<string, LinkedSystemPin>;
+  /**
+   * Supply the closure-accurate node prefix assignment (build sites know the
+   * full transitive closure; the pins-derived fallback below only sees direct
+   * pins). Affects how system-scoped refs without consumer entries derive.
+   */
+  setLinkedNodePrefixes(prefixes: ReadonlyMap<string, string>): this;
+  /**
+   * The CSS prefix a pinned system's regenerated node sheet uses — the var
+   * namespace a system-scoped ref resolves into when no consumer entry
+   * exists. Explicit build-supplied assignment wins; otherwise derived from
+   * the direct pins with the same pure assignment the build uses (identical
+   * for directly pinned systems, which are the only ones payload refs may
+   * name). Null when the system isn't pinned.
+   */
+  linkedNodeVarPrefix(systemId: string, version?: string): string | null;
   /**
    * Set top-level config metadata in one call — the single scalar-setter,
    * replacing the former `withPrefix` / `withPreflight` / `withName` /

package/dist/Config.js

@@ -1,5 +1,5 @@
 import "./brands.js";
-import "./entity-utils.js";
+import { makeTokenRefToCss } from "./entity-utils.js";
 import { AssetGroup } from "./AssetGroup.js";
 import { attachSourcePath } from "./captureCallerPath.js";
 import { isAssetGroupRef, isModeRef, isTokenRef } from "./refs.js";
@@ -9,6 +9,7 @@ import { Component, assertDefinitionAcceptsPlaceable } from "./Component.js";
 import { ComponentGroup } from "./ComponentGroup.js";
 import { CompositeStyle } from "./CompositeStyle.js";
 import { assertLinkedTokenPinned, assertLinkedValuePinned, validateLinkedSystemPin } from "./linked-system-pins.js";
+import { assignLinkedNodePrefixes } from "./linkedNodePrefixes.js";
 import { Mode } from "./Mode.js";
 import { Modifier } from "./Modifier.js";
 import { CssMotionDef, JsMotionDef } from "./MotionDef.js";
@@ -72,6 +73,43 @@ var Config = class Config {
 	* link-marked value against it.
 	*/
 	linkedSystems = /* @__PURE__ */ new Map();
+	/** Build-supplied node CSS prefixes (`{systemId}@{version}` → prefix). */
+	#linkedNodePrefixes;
+	/**
+	* Supply the closure-accurate node prefix assignment (build sites know the
+	* full transitive closure; the pins-derived fallback below only sees direct
+	* pins). Affects how system-scoped refs without consumer entries derive.
+	*/
+	setLinkedNodePrefixes(prefixes) {
+		this.#linkedNodePrefixes = prefixes;
+		this.#invalidate();
+		return this;
+	}
+	/**
+	* The CSS prefix a pinned system's regenerated node sheet uses — the var
+	* namespace a system-scoped ref resolves into when no consumer entry
+	* exists. Explicit build-supplied assignment wins; otherwise derived from
+	* the direct pins with the same pure assignment the build uses (identical
+	* for directly pinned systems, which are the only ones payload refs may
+	* name). Null when the system isn't pinned.
+	*/
+	linkedNodeVarPrefix(systemId, version) {
+		if (this.#linkedNodePrefixes) {
+			if (version) {
+				const exact = this.#linkedNodePrefixes.get(`${systemId}@${version}`);
+				if (exact) return exact;
+			}
+			for (const [key, prefix] of this.#linkedNodePrefixes) if (key.startsWith(`${systemId}@`)) return prefix;
+			return null;
+		}
+		const pin = this.linkedSystems.get(systemId);
+		if (!pin) return null;
+		return assignLinkedNodePrefixes([...this.linkedSystems.entries()].map(([id, p]) => ({
+			systemId: id,
+			version: p.version,
+			name: p.name
+		})), this.prefix).get(`${systemId}@${pin.version}`)?.cssPrefix ?? null;
+	}
 	#derived;
 	/**
 	* Set top-level config metadata in one call — the single scalar-setter,
@@ -892,6 +930,10 @@ var Config = class Config {
 				prefixGetter: () => this.prefix,
 				definition: def,
 				tokenLookup: (ref, context) => this.resolveTokenRef(ref, context),
+				linkedVarRef: (system, ref) => {
+					const prefix = this.linkedNodeVarPrefix(system.id, system.version);
+					return prefix ? makeTokenRefToCss(prefix)(ref) : void 0;
+				},
 				stylePropertiesLookup: (ns) => this.#stylePropertiesFor(ns)
 			}));
 		}
@@ -1619,21 +1661,30 @@ function validateNamespace(value) {
 */
 function visit(qualified, token, resolve, seen) {
 	if (seen.has(qualified)) throw new Error(`Token cycle detected at '${qualified}'`);
-	const followRef = (ref) => {
-		const next = resolve(ref, token.link);
+	const followRef = (marker) => {
+		let context = token.link;
+		if (marker.scope === "consumer") context = void 0;
+		else if (marker.system) context = {
+			kind: "token",
+			systemId: marker.system.id,
+			systemVersion: marker.system.version,
+			sourceKey: marker.ref
+		};
+		const next = resolve(marker.ref, context);
 		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).`);
+			if (marker.system) return;
+			if (context && token.link) {
+				const [sourceGroup] = marker.ref.split("/");
+				throw new Error(`Token '${qualified}' is linked from system "${token.link.systemId}" and references its token '${marker.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}'`);
+			throw new Error(`Token '${qualified}' references unknown token '${marker.ref}'`);
 		}
 		visit(`${next.namespace}/${next.name}`, next, resolve, new Set(seen).add(qualified));
 	};
-	if (isTokenRefValue(token.value)) followRef(token.value.ref);
+	if (isTokenRefValue(token.value)) followRef(token.value);
 	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);
+		if (isTokenRefValue(inner)) followRef(inner);
 	}
 }
 /** A `token()` ref marker — `{ ref: 'ns/name' }` — in a value position. */

package/dist/Token.d.ts

@@ -21,6 +21,16 @@ type ResolvedTokenLiteral = string | number | boolean | undefined;
  * tokens pass no context and resolve against the consumer's keys directly.
  */
 type TokenSiblingLookup = (qualifiedName: string, context?: SystemLink) => Token | undefined;
+/**
+ * Fallback for system-scoped refs with NO consumer entry: the var reference
+ * into the pinned system's regenerated node sheet (`var(--<nodePrefix>-…)`).
+ * The node sheet emits all its tokens, so the reference always resolves on
+ * the page — `undefined` only when the system isn't pinned.
+ */
+type LinkedVarRefLookup = (system: {
+  id: string;
+  version: string;
+}, qualifiedName: string) => string | undefined;
 declare class Token {
   #private;
   readonly name: string;
@@ -37,6 +47,7 @@ declare class Token {
     prefixGetter: () => string;
     definition: TokenDefinition;
     lookup: TokenSiblingLookup;
+    linkedVarRef?: LinkedVarRefLookup;
     groupTypeGetter: () => TokenType | undefined;
   });
   /**
@@ -62,4 +73,4 @@ declare class Token {
   };
 }
 //#endregion
-export { ResolvedTokenLiteral, Token, TokenSiblingLookup };
+export { LinkedVarRefLookup, ResolvedTokenLiteral, Token, TokenSiblingLookup };

package/dist/Token.js

@@ -13,6 +13,7 @@ var Token = class {
 	link;
 	#prefixGetter;
 	#lookup;
+	#linkedVarRef;
 	#groupTypeGetter;
 	#derived;
 	constructor(args) {
@@ -24,6 +25,7 @@ var Token = class {
 		this.link = args.definition.link;
 		this.#prefixGetter = args.prefixGetter;
 		this.#lookup = args.lookup;
+		this.#linkedVarRef = args.linkedVarRef;
 		this.#groupTypeGetter = args.groupTypeGetter;
 	}
 	/**
@@ -46,6 +48,7 @@ var Token = class {
 			const link = this.link;
 			const prefixGetter = this.#prefixGetter;
 			const lookup = this.#lookup;
+			const linkedVarRef = this.#linkedVarRef;
 			const groupTypeGetter = this.#groupTypeGetter;
 			this.#derived = {
 				namespace,
@@ -58,10 +61,10 @@ var Token = class {
 					return `var(${buildCssVar(prefixGetter(), namespace, name)})`;
 				},
 				get value() {
-					return chaseLiteral(tokenValue, lookup, link);
+					return chaseLiteral(tokenValue, lookup, link, void 0, linkedVarRef);
 				},
 				get cssValueType() {
-					const literal = chaseLiteral(tokenValue, lookup, link);
+					const literal = chaseLiteral(tokenValue, lookup, link, void 0, linkedVarRef);
 					return resolveTokenValueType({
 						value: typeof literal === "string" ? literal : String(tokenValue),
 						type: tokenType
@@ -69,7 +72,7 @@ var Token = class {
 				},
 				*modifierValues() {
 					if (!modifiers) return;
-					for (const [key, value] of Object.entries(modifiers)) yield [key, resolveModifierLiteral(value, lookup, link)];
+					for (const [key, value] of Object.entries(modifiers)) yield [key, resolveModifierLiteral(value, lookup, link, linkedVarRef)];
 				}
 			};
 		}
@@ -100,20 +103,31 @@ function collectModifiers(definition) {
 	}
 	return count > 0 ? modifiers : void 0;
 }
-function chaseLiteral(value, lookup, context, seen = /* @__PURE__ */ new Set()) {
+function chaseLiteral(value, lookup, context, seen = /* @__PURE__ */ new Set(), linkedVarRef) {
 	if (isTokenRef(value)) {
-		const seenKey = `${context?.systemId ?? ""}:${value.ref}`;
+		let refContext = context;
+		if (value.scope === "consumer") refContext = void 0;
+		else if (value.system) refContext = {
+			kind: "token",
+			systemId: value.system.id,
+			systemVersion: value.system.version,
+			sourceKey: value.ref
+		};
+		const seenKey = `${refContext?.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, next.link, seen);
+		const next = lookup(value.ref, refContext);
+		if (!next) {
+			if (value.system && linkedVarRef) return linkedVarRef(value.system, value.ref);
+			return;
+		}
+		return chaseLiteral(next.value, lookup, next.link, seen, linkedVarRef);
 	}
 	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
 }
-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);
+function resolveModifierLiteral(value, lookup, context, linkedVarRef) {
+	if (typeof value === "object" && value !== null && "value" in value) return chaseLiteral(value.value, lookup, context, void 0, linkedVarRef);
+	return chaseLiteral(value, lookup, context, void 0, linkedVarRef);
 }
 //#endregion
 export { Token };

package/dist/TokenGroup.d.ts

@@ -1,5 +1,5 @@
 import { SerializedTokenGroup, TokenGroupDefinition } from "./types.js";
-import { Token, TokenSiblingLookup } from "./Token.js";
+import { LinkedVarRefLookup, Token, TokenSiblingLookup } from "./Token.js";
 
 //#region src/TokenGroup.d.ts
 type StylePropertiesLookup = (namespace: string) => readonly string[];
@@ -14,6 +14,7 @@ declare class TokenGroup {
     prefixGetter: () => string;
     definition: TokenGroupDefinition;
     tokenLookup: TokenSiblingLookup;
+    linkedVarRef?: LinkedVarRefLookup;
     stylePropertiesLookup: StylePropertiesLookup;
   });
   get derived(): {

package/dist/TokenGroup.js

@@ -28,6 +28,7 @@ var TokenGroup = class {
 			prefixGetter: args.prefixGetter,
 			definition: tokenDef,
 			lookup: args.tokenLookup,
+			linkedVarRef: args.linkedVarRef,
 			groupTypeGetter
 		}));
 		this.tokens = tokens;

package/dist/extension.d.ts

@@ -17,8 +17,14 @@ declare function applyComponentExtension(def: ComponentDefinition, patch: Compon
 /**
  * Apply an engine-generated inverse. Unlike payloads, inverses carry
  * removals (`null` reverts an added path), so removal is permitted here.
+ * `lenient` skips stale paths (removals of keys that no longer exist,
+ * children that left the family) instead of throwing — the extension
+ * DELETE path uses it so a source-shape change can never trap a consumer
+ * with an extension they cannot remove.
  */
-declare function applyComponentExtensionInverse(def: ComponentDefinition, inverse: ComponentExtension): {
+declare function applyComponentExtensionInverse(def: ComponentDefinition, inverse: ComponentExtension, options?: {
+  lenient?: boolean;
+}): {
   result: ComponentDefinition;
 };
 /**

package/dist/extension.js

@@ -31,12 +31,28 @@ function isMergeable(value) {
 	return isPlainObject(value) && !isMarker(value);
 }
 /**
+* A consumer-authored `token()` ref means the CONSUMER's namespace — stamp
+* it so downstream resolution (consumer derived tables, node replay) never
+* mistakes it for a source-namespace ref riding a linked definition.
+* System-scoped refs (barrel `token()` utilities) and already-scoped refs
+* pass through unchanged. Applied to payload values only — inverses carry
+* values captured from the definition, whose scoping is already correct.
+*/
+function stampConsumerScope(value) {
+	if (!isPlainObject(value)) return value;
+	if (value.__kind === "token" && value.scope === void 0 && value.system === void 0) return {
+		...value,
+		scope: "consumer"
+	};
+	return value;
+}
+/**
 * Merge `patch` into `base` (copy-on-write) and collect the inverse patch.
 * Returns the merged node; writes each touched key's inverse into `inverse`.
 * `allowRemoval` is false for authored payloads (additive only) and true
 * when applying an engine-generated inverse, whose `null`s revert additions.
 */
-function mergeNode(base, patch, inverse, path, allowRemoval) {
+function mergeNode(base, patch, inverse, path, allowRemoval, label = "Component extension", lenient = false) {
 	const result = { ...base };
 	for (const [key, patchValue] of Object.entries(patch)) {
 		if (patchValue === void 0) continue;
@@ -44,8 +60,11 @@ function mergeNode(base, patch, inverse, path, allowRemoval) {
 		const had = Object.hasOwn(base, key);
 		const baseValue = base[key];
 		if (patchValue === null) {
-			if (!allowRemoval) throw new Error(`Component extension: "${keyPath}" is null — extensions add and override values but never remove them.`);
-			if (!had) throw new Error(`Component extension: "${keyPath}" does not exist, so the inverse cannot remove it — the stored inverse is stale.`);
+			if (!allowRemoval) throw new Error(`${label}: "${keyPath}" is null — extensions add and override values but never remove them.`);
+			if (!had) {
+				if (lenient) continue;
+				throw new Error(`${label}: "${keyPath}" does not exist, so the inverse cannot remove it — the stored inverse is stale.`);
+			}
 			delete result[key];
 			inverse[key] = baseValue;
 			continue;
@@ -53,13 +72,13 @@ function mergeNode(base, patch, inverse, path, allowRemoval) {
 		if (isMergeable(patchValue)) {
 			const childBase = isMergeable(baseValue) ? baseValue : {};
 			const childInverse = {};
-			result[key] = mergeNode(childBase, patchValue, childInverse, keyPath, allowRemoval);
+			result[key] = mergeNode(childBase, patchValue, childInverse, keyPath, allowRemoval, label, lenient);
 			if (!had) inverse[key] = null;
 			else if (!isMergeable(baseValue)) inverse[key] = baseValue;
 			else if (Object.keys(childInverse).length > 0) inverse[key] = childInverse;
 			continue;
 		}
-		result[key] = patchValue;
+		result[key] = allowRemoval ? patchValue : stampConsumerScope(patchValue);
 		inverse[key] = had ? baseValue : null;
 	}
 	return result;
@@ -73,11 +92,11 @@ function assertExtendableRoots(patch) {
 * definition fields (merged onto the parent) and the `subcomponents` block
 * (each entry merged onto the matching `__subcomponents` child).
 */
-function applyPatch(def, patch, allowRemoval) {
+function applyPatch(def, patch, allowRemoval, lenient = false) {
 	assertExtendableRoots(patch);
 	const { subcomponents: subPatches, ...fieldPatch } = patch;
 	const inverse = {};
-	const result = mergeNode(def, fieldPatch, inverse, "", allowRemoval);
+	const result = mergeNode(def, fieldPatch, inverse, "", allowRemoval, void 0, lenient);
 	if (subPatches !== void 0) {
 		if (!isMergeable(subPatches)) throw new Error("Component extension: \"subcomponents\" must be an object mapping child component names to their overrides.");
 		const children = def.__subcomponents;
@@ -87,6 +106,7 @@ function applyPatch(def, patch, allowRemoval) {
 			if (childPatch === void 0) continue;
 			const child = children?.[childName];
 			if (!child) {
+				if (lenient) continue;
 				const known = Object.keys(children ?? {});
 				const hint = known.length > 0 ? `known subcomponents are ${known.map((n) => `"${n}"`).join(", ")}.` : "this component has no subcomponents.";
 				throw new Error(`Component extension: subcomponent "${childName}" does not exist — ${hint}`);
@@ -95,7 +115,7 @@ function applyPatch(def, patch, allowRemoval) {
 			if (Object.hasOwn(childPatch, "subcomponents")) throw new Error(`Component extension: subcomponent "${childName}" cannot declare nested subcomponents.`);
 			assertExtendableRoots(childPatch);
 			const childInverse = {};
-			mergedChildren[childName] = mergeNode(child, childPatch, childInverse, `subcomponents.${childName}`, allowRemoval);
+			mergedChildren[childName] = mergeNode(child, childPatch, childInverse, `subcomponents.${childName}`, allowRemoval, void 0, lenient);
 			if (Object.keys(childInverse).length > 0) subInverse[childName] = childInverse;
 		}
 		result.__subcomponents = mergedChildren;
@@ -117,9 +137,13 @@ function applyComponentExtension(def, patch) {
 /**
 * Apply an engine-generated inverse. Unlike payloads, inverses carry
 * removals (`null` reverts an added path), so removal is permitted here.
+* `lenient` skips stale paths (removals of keys that no longer exist,
+* children that left the family) instead of throwing — the extension
+* DELETE path uses it so a source-shape change can never trap a consumer
+* with an extension they cannot remove.
 */
-function applyComponentExtensionInverse(def, inverse) {
-	return { result: applyPatch(def, inverse, true).result };
+function applyComponentExtensionInverse(def, inverse, options) {
+	return { result: applyPatch(def, inverse, true, options?.lenient ?? false).result };
 }
 /**
 * Apply an extension payload to one component inside a FLAT serialized

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ASSET_CLASS_CAPABILITIES, AssetKind, isPlaceable } from "./asset-kind.js";
-import { AnyRef, AssetGroupName, AssetGroupRef, AssetName, AssetRef, ComponentName, ComponentRef, CompositeName, CompositeRef, CompositeRefBuilder, ModeName, ModeRef, MotionName, RegisteredAssetGroups, RegisteredComponents, RegisteredCompositeStyles, RegisteredModes, RegisteredModifiers, RegisteredMotion, RegisteredStyleProps, RegisteredTokenGroups, StylePropName, StylePropRef, TagName, TagRef, TokenGroupName, TokenGroupRef, TokenName, TokenQualifiedName, TokenRawNameRegistry, TokenRef, asset, assetGroup, component, composite, isAssetGroupRef, isAssetRef, isComponentRef, isCompositeRef, isModeRef, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, mode, styleProp, tag, token, tokenGroup } from "./refs.js";
+import { AnyRef, AssetGroupName, AssetGroupRef, AssetName, AssetRef, ComponentName, ComponentRef, CompositeName, CompositeRef, CompositeRefBuilder, ModeName, ModeRef, MotionName, RegisteredAssetGroups, RegisteredComponents, RegisteredCompositeStyles, RegisteredModes, RegisteredModifiers, RegisteredMotion, RegisteredStyleProps, RegisteredTokenGroups, StylePropName, StylePropRef, TagName, TagRef, TokenGroupName, TokenGroupRef, TokenName, TokenQualifiedName, TokenRawNameRegistry, TokenRef, asset, assetGroup, component, composite, isAssetGroupRef, isAssetRef, isComponentRef, isCompositeRef, isModeRef, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, mode, styleProp, systemToken, tag, token, tokenGroup } from "./refs.js";
 import { ColorFn, ColorKeyword, CssAngle, CssColor, CssLength, CssPercentage, CssRatio, CssTime, CssValue, CssValueTypeName, CssVarRef, HexColor, HslColor, RgbColor } from "./types/css-values.js";
 import { ColorExpression, ColorSpace, ColorValue, GradientStop, GradientValue, LengthOrPercent, LineDirection, LinearGradientExpr, MixExpr, RadialGradientExpr, RadialSize, TokenRefToCss, alpha, isColorExpression, isLinearGradientExpr, isMixExpr, isRadialGradientExpr, linearGradient, mix, radialGradient, resolveColorExpression } from "./colorExpressions.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";
@@ -33,9 +33,10 @@ import { ELEMENT_MARKER_KIND, ElementMarker, OpaqueLeafPredicate, hasElementMark
 import { LinkedComponentValue, applyComponentExtension, applyComponentExtensionInverse, extendSerializedComponents, linkedComponent } from "./extension.js";
 import { collectFontFaceCss, deriveFontFaceCss, familiesInRawCss } from "./font-face.js";
 import { interpolate } from "./interpolate.js";
+import { LinkedNameDeclaration, LinkedNodeIdentity, LinkedNodePrefix, assignLinkedNodePrefixes, resolveDeclaredNames } from "./linkedNodePrefixes.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, type ComponentExtension, type ComponentExtensionRecord, 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 LinkedComponentValue, 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, VOID_HTML_TAGS, type ValuesEntry, type VariantInfo, type VariantMarker, type VariantMarkerArray, type VariantMarkerObject, alpha, applyComponentExtension, applyComponentExtensionInverse, 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, extendSerializedComponents, 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, linkedComponent, 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 };
+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, type ComponentExtension, type ComponentExtensionRecord, 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 LinkedComponentValue, type LinkedNameDeclaration, type LinkedNodeIdentity, type LinkedNodePrefix, 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, VOID_HTML_TAGS, type ValuesEntry, type VariantInfo, type VariantMarker, type VariantMarkerArray, type VariantMarkerObject, alpha, applyComponentExtension, applyComponentExtensionInverse, asChild, asset, assetGroup, assignLinkedNodePrefixes, 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, extendSerializedComponents, 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, linkedComponent, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveDeclaredNames, resolveFontStack, resolveOverrideRow, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, slugifyLinkedName, string, styleProp, systemToken, tag, token, tokenGroup, variant };

package/dist/index.js

@@ -4,7 +4,7 @@ import { AssetGroup } from "./AssetGroup.js";
 import { ASSET_CLASS_CAPABILITIES, isPlaceable } from "./asset-kind.js";
 import { resolveAssetRefCss, resolveFontStack } from "./asset-value.js";
 import { SOURCE_PATH_KEY, attachSourcePath, captureCallerPath, readSourcePath } from "./captureCallerPath.js";
-import { asset, assetGroup, component, composite, isAssetGroupRef, isAssetRef, isComponentRef, isCompositeRef, isModeRef, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, mode, styleProp, tag, token, tokenGroup } from "./refs.js";
+import { asset, assetGroup, component, composite, isAssetGroupRef, isAssetRef, isComponentRef, isCompositeRef, isModeRef, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, mode, styleProp, systemToken, tag, token, tokenGroup } from "./refs.js";
 import { alpha, isColorExpression, isLinearGradientExpr, isMixExpr, isRadialGradientExpr, linearGradient, mix, radialGradient, resolveColorExpression } from "./colorExpressions.js";
 import { defineAssetGroup, defineAssetIcon } from "./defineAssetGroup.js";
 import { ELEMENT_MARKER_KIND, hasElementMarkerDeep, isElementLikeValue, isElementMarker, reviveElementMarkersDeep, serializeElementsDeep } from "./element-marker.js";
@@ -12,6 +12,8 @@ import { PREVIEW_SEED_KEY, isBoolMarker, isLayerMarker, isMotionMarker, isNumber
 import { Component, Layer, VOID_HTML_TAGS } from "./Component.js";
 import { ComponentGroup } from "./ComponentGroup.js";
 import { CompositeStyle } from "./CompositeStyle.js";
+import { buildRegistryAliases, slugifyLinkedName } from "./registry-aliases.js";
+import { assignLinkedNodePrefixes, resolveDeclaredNames } from "./linkedNodePrefixes.js";
 import { Mode, ModeOption } from "./Mode.js";
 import { Modifier } from "./Modifier.js";
 import { CssMotionDef, JsMotionDef, MOTION_CSS_DEFINITION_KEYS, MOTION_JS_DEFINITION_KEYS, MOTION_JS_FIELD_KEYS } from "./MotionDef.js";
@@ -28,9 +30,8 @@ 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, VOID_HTML_TAGS, alpha, applyComponentExtension, applyComponentExtensionInverse, 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, extendSerializedComponents, 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, linkedComponent, 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 };
+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, VOID_HTML_TAGS, alpha, applyComponentExtension, applyComponentExtensionInverse, asChild, asset, assetGroup, assignLinkedNodePrefixes, 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, extendSerializedComponents, 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, linkedComponent, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveDeclaredNames, resolveFontStack, resolveOverrideRow, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, slugifyLinkedName, string, styleProp, systemToken, tag, token, tokenGroup, variant };

package/dist/linkedNodePrefixes.d.ts

@@ -0,0 +1,73 @@
+//#region src/linkedNodePrefixes.d.ts
+/**
+ * Node-scoped CSS-prefix assignment for materialized linked systems.
+ *
+ * Every linked node (`{systemId}@{version}`) regenerates its CSS at consumer
+ * build time from its sealed `config.json`, with its `prefix` overridden to a
+ * composed, collision-free identity: `<consumerPrefix>-linked-<slug>`. One
+ * prefix per NODE (not per link path) — the module graph resolves each node's
+ * files once, so its lowered class names can only carry one prefix; sharing a
+ * node between parents shares byte-identical sealed content, so sharing the
+ * prefix is correct.
+ *
+ * The assignment must be identical everywhere it's consumed (pull-time shim
+ * generation, `uds build` CSS regeneration, the bundler loaders), so every
+ * consumer derives it from the same inputs with the same pure functions:
+ * node identities from the registry tree, display names from the declaring
+ * configs' `registerLinkedSystems` entries ({@link resolveDeclaredNames}),
+ * and the consumer's own prefix. Nothing is persisted — the registry tree is
+ * the source of truth.
+ */
+/** Identity of one linked node, as pulled from the server closure. */
+interface LinkedNodeIdentity {
+  systemId: string;
+  version: string;
+  /** Display-name snapshot captured at link time (from the consumer's
+   *  `registerLinkedSystems` entry / the server's system record). */
+  name: string;
+}
+/** Assigned naming for one node. */
+interface LinkedNodePrefix {
+  /** Filesystem/import-safe slug of the node's display name. */
+  slug: string;
+  /** The node's composed CSS identity — every var and class name of its
+   *  regenerated CSS derives from this. */
+  cssPrefix: string;
+}
+/**
+ * Assign each node in a linked closure its slug + composed CSS prefix,
+ * keyed by `{systemId}@{version}`.
+ *
+ * Deterministic and input-order independent: nodes are processed sorted by
+ * `(systemId, version)`. Within a slug-collision group the first sorted node
+ * keeps the bare slug; a different system appends `-x<systemId[0..8]>`; the
+ * same system at another version appends `-v<version>` — so every node in
+ * the closure gets a unique, stable prefix.
+ *
+ * `consumerPrefix` is the consuming system's own `Config.prefix`. An empty
+ * prefix is disallowed as a base (a bare `linked-…` could collide with the
+ * consumer's unprefixed classes) — the node's own uuid fragment substitutes.
+ */
+declare function assignLinkedNodePrefixes(nodes: LinkedNodeIdentity[], consumerPrefix: string): Map<string, LinkedNodePrefix>;
+/** One `registerLinkedSystems` declaration observed while walking a
+ *  closure: `declarerKey` is the declaring node's `{systemId}@{version}` pair
+ *  (empty string for the consumer's own config). */
+interface LinkedNameDeclaration {
+  /** The declared child's `{systemId}@{version}` pair key. */
+  key: string;
+  /** The declarer's display-name snapshot for the child. */
+  name: string;
+  /** The declaring node's pair key; `''` = the consumer root config. */
+  declarerKey: string;
+}
+/**
+ * Resolve each node's display name from the closure's declarations. A node
+ * can be declared by several parents under different name snapshots; the
+ * winner is the declaration with the lowest `declarerKey` in sort order (the
+ * consumer's own declarations sort first as `''`), so every tool that walks
+ * the same closure derives the same names — and therefore the same slugs and
+ * CSS prefixes — without any persisted mapping.
+ */
+declare function resolveDeclaredNames(declarations: LinkedNameDeclaration[]): Map<string, string>;
+//#endregion
+export { LinkedNameDeclaration, LinkedNodeIdentity, LinkedNodePrefix, assignLinkedNodePrefixes, resolveDeclaredNames };