@yahoo/uds-create-config 2.33.1 → 2.35.0

package/dist/linkedNodePrefixes.js

@@ -0,0 +1,99 @@
+import { slugifyLinkedName } from "./registry-aliases.js";
+//#region src/linkedNodePrefixes.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.
+*/
+/** CSS identifiers can't start with a digit (or a hyphen-digit pair) —
+*  prepend a letter sentinel when a candidate would. */
+function ensureCssIdentStart(candidate) {
+	return /^[a-zA-Z_]/.test(candidate) ? candidate : `x${candidate}`;
+}
+/** `1.5.0` → `v1-5-0` — a CSS-safe version fragment. */
+function versionFragment(version) {
+	return `v${version.replace(/[^a-zA-Z0-9]+/g, "-")}`;
+}
+function nodeKey(node) {
+	return `${node.systemId}@${node.version}`;
+}
+/**
+* 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.
+*/
+function assignLinkedNodePrefixes(nodes, consumerPrefix) {
+	const sorted = [...nodes].sort((a, b) => a.systemId.localeCompare(b.systemId) || a.version.localeCompare(b.version));
+	const byslug = /* @__PURE__ */ new Map();
+	for (const node of sorted) {
+		const slug = slugifyLinkedName(node.name);
+		const group = byslug.get(slug);
+		if (group) group.push(node);
+		else byslug.set(slug, [node]);
+	}
+	const out = /* @__PURE__ */ new Map();
+	const usedSlugs = /* @__PURE__ */ new Set();
+	for (const [slug, group] of byslug) {
+		const systemsInOrder = [];
+		for (const node of group) if (!systemsInOrder.includes(node.systemId)) systemsInOrder.push(node.systemId);
+		for (const node of group) {
+			const systemRank = systemsInOrder.indexOf(node.systemId);
+			const versionsOfSystem = group.filter((n) => n.systemId === node.systemId);
+			let finalSlug = slug;
+			if (systemRank > 0) finalSlug += `-x${node.systemId.slice(0, 8)}`;
+			if (versionsOfSystem.length > 1 && versionsOfSystem.indexOf(node) > 0) finalSlug += `-${versionFragment(node.version)}`;
+			const collisionBase = finalSlug;
+			let collisionIndex = 2;
+			while (usedSlugs.has(finalSlug)) {
+				finalSlug = `${collisionBase}-${collisionIndex}`;
+				collisionIndex++;
+			}
+			usedSlugs.add(finalSlug);
+			const base = ensureCssIdentStart(consumerPrefix === "" ? `x${node.systemId.slice(0, 8)}` : consumerPrefix);
+			out.set(nodeKey(node), {
+				slug: finalSlug,
+				cssPrefix: `${base}-linked-${finalSlug}`
+			});
+		}
+	}
+	return out;
+}
+/**
+* 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.
+*/
+function resolveDeclaredNames(declarations) {
+	const sorted = [...declarations].sort((a, b) => a.key.localeCompare(b.key) || a.declarerKey.localeCompare(b.declarerKey));
+	const names = /* @__PURE__ */ new Map();
+	for (const decl of sorted) if (!names.has(decl.key)) names.set(decl.key, decl.name);
+	return names;
+}
+//#endregion
+export { assignLinkedNodePrefixes, resolveDeclaredNames };

package/dist/native/NativeConfig.d.ts

@@ -1,7 +1,7 @@
 import { LinkedSystemPin, LinkedSystemsInput } from "../types.js";
 import { ConfigValidationError } from "../config-diagnostics.js";
 import { NativeComponentDefinition, NativeComponentGroupDefinition, NativeComponentPropMarker, NativeComponentPropsFromMarkers, NativeComponentStyles, NativeLayerDefinition, NativeLayerKind, SerializedNativeComponentGroup } from "./components.js";
-import { NativeAssetGroupDefinition, NativeBuildOptions, NativeDefaultModes, NativeFontAssetGroupDefinition, NativeModeDefinition, NativeStyleEngine, NativeTokenGroupDefinition, SerializedNativeConfig } from "./types.js";
+import { NativeAssetGroupDefinition, NativeBuildOptions, NativeDefaultModes, NativeDependencyPolicy, NativeFontAssetGroupDefinition, NativeModeDefinition, NativeStyleEngine, NativeTokenGroupDefinition, SerializedNativeConfig } from "./types.js";
 import { NativeConfigDiagnostic } from "./validation.js";
 
 //#region src/native/NativeConfig.d.ts
@@ -15,6 +15,7 @@ declare class NativeConfig {
   namespace?: string;
   styleEngine?: NativeStyleEngine;
   buildOptions?: NativeBuildOptions;
+  dependencyPolicy?: NativeDependencyPolicy;
   defaultModes?: NativeDefaultModes;
   readonly modes: Map<string, NativeModeDefinition>;
   readonly tokenGroups: Map<string, NativeTokenGroupDefinition>;
@@ -33,6 +34,7 @@ declare class NativeConfig {
     namespace?: string;
     styleEngine?: NativeStyleEngine;
     buildOptions?: NativeBuildOptions;
+    dependencyPolicy?: NativeDependencyPolicy;
     defaultModes?: NativeDefaultModes;
   }): this;
   registerModes(modes: Record<string, NativeModeDefinition>): this;

package/dist/native/NativeConfig.js

@@ -15,6 +15,7 @@ var NativeConfig = class NativeConfig {
 	namespace;
 	styleEngine;
 	buildOptions;
+	dependencyPolicy;
 	defaultModes;
 	modes = /* @__PURE__ */ new Map();
 	tokenGroups = /* @__PURE__ */ new Map();
@@ -46,6 +47,15 @@ var NativeConfig = class NativeConfig {
 			this.styleEngine = options.styleEngine;
 		}
 		if (options.buildOptions !== void 0) this.buildOptions = { ...options.buildOptions };
+		if (options.dependencyPolicy !== void 0) {
+			const diagnostics = validateSerializedNativeConfig({
+				schemaVersion: NativeConfig.SCHEMA_VERSION,
+				platform: "native",
+				dependencyPolicy: options.dependencyPolicy
+			});
+			if (diagnostics.length > 0) throw new NativeConfigValidationError(diagnostics);
+			this.dependencyPolicy = Object.fromEntries(Object.entries(options.dependencyPolicy).map(([name, policy]) => [name, { ...policy }]));
+		}
 		if (options.defaultModes !== void 0) this.defaultModes = { ...options.defaultModes };
 		return this;
 	}
@@ -118,6 +128,7 @@ var NativeConfig = class NativeConfig {
 		config.namespace = json.namespace;
 		config.styleEngine = json.styleEngine;
 		config.buildOptions = json.buildOptions ? { ...json.buildOptions } : void 0;
+		config.dependencyPolicy = json.dependencyPolicy ? Object.fromEntries(Object.entries(json.dependencyPolicy).map(([name, policy]) => [name, { ...policy }])) : void 0;
 		config.defaultModes = json.defaultModes ? { ...json.defaultModes } : void 0;
 		for (const [name, mode] of Object.entries(json.modes ?? {})) config.modes.set(name, mode);
 		for (const [name, group] of Object.entries(json.tokenGroups ?? {})) config.tokenGroups.set(name, group);
@@ -136,6 +147,7 @@ var NativeConfig = class NativeConfig {
 		if (this.namespace !== void 0) out.namespace = this.namespace;
 		if (this.styleEngine !== void 0) out.styleEngine = this.styleEngine;
 		if (this.buildOptions !== void 0) out.buildOptions = { ...this.buildOptions };
+		if (this.dependencyPolicy !== void 0) out.dependencyPolicy = Object.fromEntries(Object.entries(this.dependencyPolicy).map(([name, policy]) => [name, { ...policy }]));
 		if (this.defaultModes !== void 0) out.defaultModes = { ...this.defaultModes };
 		if (this.modes.size > 0) out.modes = Object.fromEntries(this.modes);
 		if (this.tokenGroups.size > 0) out.tokenGroups = Object.fromEntries(this.tokenGroups);

package/dist/native/index.d.ts

@@ -3,7 +3,7 @@ import { ColorSpace, MixExpr, alpha, mix } from "../colorExpressions.js";
 import { SystemLink, TokenType } from "../types.js";
 import { DefinedTokenGroupValue } from "../factories.js";
 import { NativeComponentBuilder, NativeComponentDefinition, NativeComponentGroupDefinition, NativeComponentProps, NativeComponentStyleHelpers, NativeComponentStyledBuilder, NativeComponentStyles, NativeLayerDefinition, NativeLayerKind, NativeLayerStyle, NativeLayerStyles, NativeRenderProps, NativeStyleValue, RegisteredNativeComponent, SerializedNativeComponentGroup, defineNativeComponent, defineNativeComponentGroup, nativeLayer } from "./components.js";
-import { ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeDefaultModes, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeSelectableValue, NativeStyleEngine, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig } from "./types.js";
+import { ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeDefaultModes, NativeDependencyPolicy, NativeDependencyPolicyEntry, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeSelectableValue, NativeStyleEngine, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig } from "./types.js";
 import { NativeAssetGroupBuilder, NativeFontAssetGroupConfig, defineAssetGroup } from "./assets.js";
 import { defineMode } from "./modes.js";
 import { NativeConfigDiagnostic, NativeConfigDiagnosticCode, validateSerializedNativeConfig } from "./validation.js";

package/dist/native/types.d.ts

@@ -56,6 +56,13 @@ interface NativeBuildOptions {
   /** Trusted root containing native component definitions and render source. */
   componentsDir?: string;
 }
+/** Where a consuming project must make a native component dependency available. */
+interface NativeDependencyPolicyEntry {
+  providedBy: 'consumer' | 'registry';
+  /** Semver range accepted by the system that authored the components. */
+  version: string;
+}
+type NativeDependencyPolicy = Record<string, NativeDependencyPolicyEntry>;
 interface NativeFontAssetMember {
   /** Family identifier React Native consumes after the app registers the font. */
   fontFamily: string;
@@ -74,6 +81,7 @@ interface SerializedNativeConfig {
   namespace?: string;
   styleEngine?: NativeStyleEngine;
   buildOptions?: NativeBuildOptions;
+  dependencyPolicy?: NativeDependencyPolicy;
   defaultModes?: NativeDefaultModes;
   modes?: Record<string, NativeModeDefinition>;
   tokenGroups?: Record<string, NativeTokenGroupDefinition>;
@@ -84,4 +92,4 @@ interface SerializedNativeConfig {
   linkedSystems?: Record<string, LinkedSystemPin>;
 }
 //#endregion
-export { ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeDefaultModes, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeSelectableValue, NativeStyleEngine, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig };
+export { ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeDefaultModes, NativeDependencyPolicy, NativeDependencyPolicyEntry, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeSelectableValue, NativeStyleEngine, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig };

package/dist/native/validation.d.ts

@@ -1,7 +1,7 @@
 import { ConfigDiagnostic } from "../config-diagnostics.js";
 
 //#region src/native/validation.d.ts
-type NativeConfigDiagnosticCode = 'INVALID_SCHEMA' | 'UNSUPPORTED_SCHEMA_VERSION' | 'PLATFORM_MISMATCH' | 'INVALID_NAMESPACE' | 'INVALID_NATIVE_VALUE' | 'UNSUPPORTED_NATIVE_FIELD' | 'INCOMPLETE_OS_VALUE' | 'NESTED_OS_VALUE' | 'INVALID_REFERENCE' | 'UNRESOLVED_TOKEN_REFERENCE' | 'TOKEN_REFERENCE_CYCLE' | 'UNRESOLVED_ASSET_REFERENCE' | 'UNOWNED_MODIFIER' | 'DUPLICATE_MODIFIER' | 'INVALID_DEFAULT_MODE' | 'INVALID_MODE_CONDITION' | 'INVALID_MODE_COMBINATION' | 'UNSUPPORTED_COLOR_EXPRESSION';
+type NativeConfigDiagnosticCode = 'INVALID_SCHEMA' | 'UNSUPPORTED_SCHEMA_VERSION' | 'PLATFORM_MISMATCH' | 'INVALID_NAMESPACE' | 'INVALID_NATIVE_VALUE' | 'UNSUPPORTED_NATIVE_FIELD' | 'INCOMPLETE_OS_VALUE' | 'NESTED_OS_VALUE' | 'INVALID_REFERENCE' | 'UNRESOLVED_TOKEN_REFERENCE' | 'TOKEN_REFERENCE_CYCLE' | 'UNRESOLVED_ASSET_REFERENCE' | 'UNOWNED_MODIFIER' | 'DUPLICATE_MODIFIER' | 'INVALID_DEFAULT_MODE' | 'INVALID_DEPENDENCY_POLICY' | 'INVALID_MODE_CONDITION' | 'INVALID_MODE_COMBINATION' | 'UNSUPPORTED_COLOR_EXPRESSION';
 type NativeConfigDiagnostic = ConfigDiagnostic<NativeConfigDiagnosticCode>;
 declare function validateSerializedNativeConfig(input: unknown, expectedSchemaVersion?: number): NativeConfigDiagnostic[];
 //#endregion

package/dist/native/validation.js

@@ -3,6 +3,7 @@ import { isMixExpr } from "../colorExpressions.js";
 import { EXACT_SEMVER_RE, UUID_RE } from "../linked-system-pins.js";
 import { createModeBackedModifierLookup, modifierTreeToOverrideRows, resolveOverrideRow } from "../token-override-rows.js";
 import { isOperatingSystemValue } from "./values.js";
+import { validRange } from "semver";
 //#region src/native/validation.ts
 const TOP_LEVEL_KEYS = new Set([
 	"schemaVersion",
@@ -11,6 +12,7 @@ const TOP_LEVEL_KEYS = new Set([
 	"namespace",
 	"styleEngine",
 	"buildOptions",
+	"dependencyPolicy",
 	"defaultModes",
 	"modes",
 	"tokenGroups",
@@ -21,6 +23,7 @@ const TOP_LEVEL_KEYS = new Set([
 ]);
 const LINKED_SYSTEM_PIN_KEYS = new Set(["name", "version"]);
 const BUILD_OPTIONS_KEYS = new Set(["componentsDir"]);
+const DEPENDENCY_POLICY_KEYS = new Set(["providedBy", "version"]);
 const COMPONENT_KEYS = new Set([
 	"id",
 	"layers",
@@ -104,6 +107,7 @@ function validateSerializedNativeConfig(input, expectedSchemaVersion = 4) {
 	validateNamespace(input.namespace, diagnostics);
 	validateStyleEngine(input.styleEngine, diagnostics);
 	validateBuildOptions(input.buildOptions, diagnostics);
+	validateDependencyPolicy(input.dependencyPolicy, diagnostics);
 	validateModes(input.modes, diagnostics);
 	validateDefaultModes(input.defaultModes, input.modes, diagnostics);
 	validateAssetGroups(input.assetGroups, diagnostics);
@@ -115,6 +119,29 @@ function validateSerializedNativeConfig(input, expectedSchemaVersion = 4) {
 	validateModifierOwnership(input, diagnostics);
 	return dedupe(diagnostics);
 }
+function validateDependencyPolicy(value, diagnostics) {
+	if (value === void 0) return;
+	const definition = { kind: "config" };
+	if (!isRecord(value)) {
+		push(diagnostics, "INVALID_DEPENDENCY_POLICY", ["dependencyPolicy"], definition, "dependencyPolicy must be a record keyed by npm package name.");
+		return;
+	}
+	for (const [name, policy] of Object.entries(value)) {
+		const path = ["dependencyPolicy", name];
+		if (!isValidPackageName(name)) push(diagnostics, "INVALID_DEPENDENCY_POLICY", path, definition, `"${name}" is not a valid npm package name.`);
+		if (!isRecord(policy)) {
+			push(diagnostics, "INVALID_DEPENDENCY_POLICY", path, definition, "Dependency policy entries must be plain objects.");
+			continue;
+		}
+		reportUnknownKeys(policy, DEPENDENCY_POLICY_KEYS, path, definition, diagnostics);
+		if (policy.providedBy !== "consumer" && policy.providedBy !== "registry") push(diagnostics, "INVALID_DEPENDENCY_POLICY", [...path, "providedBy"], definition, "providedBy must be either \"consumer\" or \"registry\".");
+		if (typeof policy.version !== "string" || validRange(policy.version) === null) push(diagnostics, "INVALID_DEPENDENCY_POLICY", [...path, "version"], definition, "version must be a valid semver range.");
+	}
+}
+function isValidPackageName(name) {
+	if (name.length === 0 || name.length > 214 || name !== name.toLowerCase()) return false;
+	return /^(?:@[a-z0-9~][a-z0-9._~-]*\/)?[a-z0-9~][a-z0-9._~-]*$/.test(name);
+}
 function validateLinkedSystems(value, diagnostics) {
 	if (value === void 0) return;
 	const definition = { kind: "config" };

package/dist/native.d.ts

@@ -2,11 +2,11 @@ import { AssetRef, TokenRef, asset, token } from "./refs.js";
 import { ColorSpace, MixExpr, alpha, mix } from "./colorExpressions.js";
 import { SystemLink, TokenType } from "./types.js";
 import { NativeComponentBuilder, NativeComponentDefinition, NativeComponentGroupDefinition, NativeComponentProps, NativeComponentStyleHelpers, NativeComponentStyledBuilder, NativeComponentStyles, NativeLayerDefinition, NativeLayerKind, NativeLayerStyle, NativeLayerStyles, NativeRenderProps, NativeStyleValue, RegisteredNativeComponent, SerializedNativeComponentGroup, defineNativeComponent, defineNativeComponentGroup, nativeLayer } from "./native/components.js";
-import { ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeDefaultModes, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeSelectableValue, NativeStyleEngine, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig } from "./native/types.js";
+import { ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeDefaultModes, NativeDependencyPolicy, NativeDependencyPolicyEntry, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeSelectableValue, NativeStyleEngine, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig } from "./native/types.js";
 import { NativeAssetGroupBuilder, NativeFontAssetGroupConfig, defineAssetGroup } from "./native/assets.js";
 import { defineMode } from "./native/modes.js";
 import { NativeConfigDiagnostic, NativeConfigDiagnosticCode, validateSerializedNativeConfig } from "./native/validation.js";
 import { NativeConfig, NativeConfigValidationError } from "./native/NativeConfig.js";
 import { isOperatingSystemValue, operatingSystem } from "./native/values.js";
 import { DefinedNativeTokenGroup, defineTokenGroup } from "./native/index.js";
-export { AssetRef, ColorSpace, DefinedNativeTokenGroup, MixExpr, ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupBuilder, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeComponentBuilder, NativeComponentDefinition, NativeComponentGroupDefinition, NativeComponentProps, NativeComponentStyleHelpers, NativeComponentStyledBuilder, NativeComponentStyles, NativeConfig, NativeConfigDiagnostic, NativeConfigDiagnosticCode, NativeConfigValidationError, NativeDefaultModes, NativeFontAssetGroupConfig, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLayerDefinition, NativeLayerKind, NativeLayerStyle, NativeLayerStyles, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeRenderProps, NativeSelectableValue, NativeStyleEngine, NativeStyleValue, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, RegisteredNativeComponent, SerializedNativeComponentGroup, SerializedNativeConfig, SystemLink, TokenRef, TokenType, alpha, asset, defineAssetGroup, defineMode, defineNativeComponent, defineNativeComponentGroup, defineTokenGroup, isOperatingSystemValue, mix, nativeLayer, operatingSystem, token, validateSerializedNativeConfig };
+export { AssetRef, ColorSpace, DefinedNativeTokenGroup, MixExpr, ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupBuilder, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeComponentBuilder, NativeComponentDefinition, NativeComponentGroupDefinition, NativeComponentProps, NativeComponentStyleHelpers, NativeComponentStyledBuilder, NativeComponentStyles, NativeConfig, NativeConfigDiagnostic, NativeConfigDiagnosticCode, NativeConfigValidationError, NativeDefaultModes, NativeDependencyPolicy, NativeDependencyPolicyEntry, NativeFontAssetGroupConfig, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLayerDefinition, NativeLayerKind, NativeLayerStyle, NativeLayerStyles, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeRenderProps, NativeSelectableValue, NativeStyleEngine, NativeStyleValue, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, RegisteredNativeComponent, SerializedNativeComponentGroup, SerializedNativeConfig, SystemLink, TokenRef, TokenType, alpha, asset, defineAssetGroup, defineMode, defineNativeComponent, defineNativeComponentGroup, defineTokenGroup, isOperatingSystemValue, mix, nativeLayer, operatingSystem, token, validateSerializedNativeConfig };

package/dist/refs.d.ts

@@ -85,6 +85,18 @@ type TagName = string;
 interface TokenRef<TName extends string = string> {
   readonly __kind: 'token';
   readonly ref: TName;
+  /**
+   * Namespace scope for refs authored in extension payloads. Absent on
+   * source-authored refs (they resolve in their own system's namespace).
+   * `'consumer'` is stamped by the extension merge on plain `token()` refs
+   * — a consumer-authored ref always means the consumer's own tokens.
+   */
+  readonly scope?: 'consumer';
+  /** Pinned-system scope from a registry barrel's `token()` utility. */
+  readonly system?: {
+    readonly id: string;
+    readonly version: string;
+  };
 }
 interface TokenGroupRef<TName extends string = string> {
   readonly __kind: 'tokenGroup';
@@ -153,6 +165,13 @@ type AnyRef = TokenRef | TokenGroupRef | CompositeRef | ModeRef | StylePropRef |
 /** Doc-alignment alias kept for ergonomic import. */
 type TokenQualifiedName = TokenName;
 declare function token<TName extends TokenName>(ref: TName): TokenRef<TName>;
+/**
+ * Curried factory behind a registry barrel's `token()` utility —
+ * `yahooOs.token('color/red-1')` names THAT system's token, letting a
+ * consumer mix references across pinned systems unambiguously. The plain
+ * `token()` import always means the consumer's own namespace.
+ */
+declare function systemToken(systemId: string, version: string): <TName extends TokenName>(ref: TName) => TokenRef<TName>;
 declare function tokenGroup<TName extends TokenGroupName>(ref: TName): TokenGroupRef<TName>;
 /**
  * `composite(ref)` returns a bare `CompositeRef` plus an `.on(layer)`
@@ -182,4 +201,4 @@ declare function isComponentRef(value: unknown): value is ComponentRef;
 declare function isAssetGroupRef(value: unknown): value is AssetGroupRef;
 declare function isAssetRef(value: unknown): value is AssetRef;
 //#endregion
-export { 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 };
+export { 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 };

package/dist/refs.js

@@ -5,6 +5,22 @@ function token(ref) {
 		ref
 	};
 }
+/**
+* Curried factory behind a registry barrel's `token()` utility —
+* `yahooOs.token('color/red-1')` names THAT system's token, letting a
+* consumer mix references across pinned systems unambiguously. The plain
+* `token()` import always means the consumer's own namespace.
+*/
+function systemToken(systemId, version) {
+	return (ref) => ({
+		__kind: "token",
+		ref,
+		system: {
+			id: systemId,
+			version
+		}
+	});
+}
 function tokenGroup(ref) {
 	return {
 		__kind: "tokenGroup",
@@ -110,4 +126,4 @@ function isAssetRef(value) {
 	return isRefOf(value, "asset");
 }
 //#endregion
-export { asset, assetGroup, component, composite, isAssetGroupRef, isAssetRef, isComponentRef, isCompositeRef, isModeRef, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, mode, styleProp, tag, token, tokenGroup };
+export { asset, assetGroup, component, composite, isAssetGroupRef, isAssetRef, isComponentRef, isCompositeRef, isModeRef, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, mode, styleProp, systemToken, tag, token, tokenGroup };