@yahoo/uds-v5-wip 1.21.0 → 1.23.0

package/dist/config/dist/component-resolution.d.ts

@@ -1 +1 @@
-export { };
+import { ComponentsConfig } from "@uds/types";

package/dist/config/dist/consts/defaultColors.d.ts

@@ -1,5 +1,4 @@
 //#region ../config/dist/consts/defaultColors.d.ts
-//#region src/consts/defaultColors.d.ts
 declare const defaultColors: {
   inherit: string;
   current: string;
@@ -248,6 +247,6 @@ declare const defaultColors: {
   'rose-800': string;
   'rose-900': string;
   'rose-950': string;
-}; //#endregion
+};
 //#endregion
 export { defaultColors };

package/dist/config/dist/createConfig.d.ts

@@ -3,7 +3,6 @@ import { TokenType, VarsConfig } from "./types.js";
 import { BaseModifierProp, ComponentsConfig, ConfigurableProp, MacroConfig, ModifierProp, MotionPreset, RemotionComponentDef, RemotionConfig, RemotionTransitionDef, StyleProp } from "@uds/types";
 
 //#region ../config/dist/createConfig.d.ts
-//#region src/createConfig.d.ts
 type MotionPresetsDef = Record<string, MotionPreset>;
 type MotionAliasValue<TMotion> = TMotion extends Record<string, infer V> ? Extract<V, string> : never;
 type EmptyMotion = {};
@@ -114,7 +113,6 @@ type EmptyTokens = {};
 type EmptyVars = {};
 /** Build a structured token reference object from atomic tokens */
 declare function buildTokenReference(atomic: AtomicToken<ModifierNameShape>[], configPrefix: string): Record<string, Record<string, string>>;
-/** Build a structured macro reference object for use in defineModifiers context */
 /** Extract all modifiers from mode groups and check if any are reserved */
 type CheckForReservedModifiers<T extends readonly ModeGroup[]> = true extends HasReservedModifier<GetModifierName<T>> ? 'ERROR: Cannot use reserved modifier names from ModifierProp. Please use a different modifier name.' : T;
 /** Global styles definition — CSS selector → style props */
@@ -163,6 +161,18 @@ interface UdsConfigData {
    * edits this via draft patches.
    */
   scopes?: Record<string, string[]>;
+  /**
+   * Token names contributed by any composed preset, keyed by namespace.
+   *
+   * Populated during `.compose()` — every token seen in the preset's `vars`
+   * or `atomic` is added to the set. A later local `.defineVars()` does NOT
+   * remove entries, so preset-overridden tokens remain marked as preset.
+   *
+   * Read by the rename path (MCP tool, canvas preview, CLI pull) to reject
+   * renames of preset tokens — they are read-only from the consumer's
+   * perspective.
+   */
+  presetTokenNames?: Record<string, string[]>;
 }
 interface ComponentConfig<TComponents extends ComponentsConfig<string> = ComponentsConfig<string>, TMotion extends MotionPresetsDef | undefined = MotionPresetsDef | undefined> {
   name?: string;
@@ -272,10 +282,6 @@ interface UdsConfig<TModifier extends ModifierNameShape = ModifierProp, TTokens
 type AnyUdsConfig = UdsConfig<ModifierNameShape, any, any, any, any, any, any>;
 /** Extract the raw config data from a builder instance */
 declare function resolveConfig(config: AnyUdsConfig): UdsConfigData;
-/**
- * Resolve configuration with all token references replaced by their raw values.
- * Useful for tools that need the actual values (e.g. anatomy generation).
- */
 declare function createConfigBuilder<TModifier extends ModifierNameShape = ModifierProp, TTokens = EmptyTokens, TMotion = EmptyMotion, TExt extends Record<string, any> = {}, TMacros = EmptyMacros, TModeModifiers extends ModifierNameShape = never, TVars extends VarsConfig = EmptyVars>(data: UdsConfigData, extensions?: TExt): UdsConfig<TModifier, TTokens, TMotion, TExt, TMacros, TModeModifiers, TVars> & TExt;
 interface InterpolateMarker {
   __type: 'interpolate';

package/dist/config/dist/createConfig.js

@@ -210,7 +210,8 @@ function resolveConfig(config) {
 		designPrinciples: config.designPrinciples,
 		vars: config.vars,
 		classNames: config.classNames,
-		scopes: config.scopes
+		scopes: config.scopes,
+		presetTokenNames: config.presetTokenNames
 	};
 	if (configData.vars && configData.scopes) {
 		const synthesized = synthesizeAtomicFromScopesAndVars(configData.vars, configData.scopes, configData.modes);
@@ -271,7 +272,8 @@ function resolvePresetData(input) {
 		designPrinciples: input.designPrinciples,
 		vars: input.vars,
 		classNames: input.classNames,
-		scopes: input.scopes
+		scopes: input.scopes,
+		presetTokenNames: input.presetTokenNames
 	};
 }
 function extractVarReferences(value) {
@@ -516,7 +518,8 @@ function createConfigBuilder(data, extensions) {
 				arbitraryTokens: input.arbitraryTokens ?? data.arbitraryTokens,
 				examples: input.examples ?? data.examples,
 				designPrinciples: input.designPrinciples ?? data.designPrinciples,
-				vars: input.vars ?? data.vars
+				vars: input.vars ?? data.vars,
+				presetTokenNames: input.presetTokenNames ?? data.presetTokenNames
 			}, extensions);
 		},
 		extend(ext) {

package/dist/config/dist/preset-merge.js

@@ -174,10 +174,43 @@ function applyPresetToData(base, preset, strategy) {
 		designPrinciples: mergedPrinciples,
 		vars: mergedVars,
 		classNames: mergedClassNames,
-		scopes: mergedScopes
+		scopes: mergedScopes,
+		presetTokenNames: mergePresetTokenNames(base, preset)
 	};
 	validateComponentVariants(merged.components);
 	return merged;
 }
+/**
+* Union preset-contributed token names by namespace.
+*
+* Every token in `preset.vars`, `preset.atomic`, and `preset.presetTokenNames`
+* (from a nested compose) is added to the set. The set only grows — a later
+* local `.defineVars()` does NOT remove entries, which is what gives preset
+* tokens their read-only identity even when locally overridden.
+*/
+function mergePresetTokenNames(base, preset) {
+	const result = {};
+	for (const [ns, names] of Object.entries(base.presetTokenNames ?? {})) result[ns] = new Set(names);
+	const add = (ns, name) => {
+		if (name.startsWith("$")) return;
+		let set = result[ns];
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			result[ns] = set;
+		}
+		set.add(name);
+	};
+	if (preset.vars) for (const [ns, group] of Object.entries(preset.vars)) for (const name of Object.keys(group)) add(ns, name);
+	if (preset.presetTokenNames) for (const [ns, names] of Object.entries(preset.presetTokenNames)) for (const name of names) add(ns, name);
+	if (preset.atomic) for (const group of preset.atomic) {
+		const ns = group.cssPrefix;
+		if (!ns) continue;
+		for (const token of group.tokens) add(ns, token.name);
+	}
+	if (Object.keys(result).length === 0) return void 0;
+	const out = {};
+	for (const [ns, set] of Object.entries(result)) out[ns] = [...set];
+	return out;
+}
 //#endregion
 export { applyPresetToData, deepMerge, mergeAtomic };

package/dist/config/dist/propertyGroups.d.ts

@@ -1,11 +1,6 @@
 import { ConfigurableProp } from "@uds/types";
 
 //#region ../config/dist/propertyGroups.d.ts
-//#region src/propertyGroups.d.ts
 type PropertyGroupId = 'textColor' | 'background' | 'borderColor' | 'outlineColor' | 'ringColor' | 'divideColor' | 'shadowColor' | 'svgFill' | 'svgStroke' | 'caretColor' | 'textDecorationColor' | 'opacity' | 'colorOpacity' | 'bgOpacity' | 'borderColorOpacity' | 'divideColorOpacity' | 'outlineColorOpacity' | 'ringColorOpacity' | 'textDecorationColorOpacity' | 'svgFillOpacity' | 'svgStrokeOpacity' | 'shadowColorOpacity' | 'caretColorOpacity' | 'fontFamily' | 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing' | 'blur' | 'backdropBlur' | 'animation' | 'shadow' | 'textShadow' | 'zIndex' | 'borderWidth' | 'borderRadius' | 'outlineWidth' | 'divideWidth' | 'ringWidth' | 'padding' | 'margin' | 'offset' | 'gap' | 'indent' | 'scrollSnapGap' | 'scrollSnapSpacing' | 'tableBorderSpacing' | 'width' | 'height' | 'aspectRatio' | 'positionPlacement' | 'flex' | 'transform' | 'strokeWidth';
-/**
- * A logical grouping of ConfigurableProps with a human-readable label.
- * Used by the Studio UI to let users scope token groups to specific properties.
- */
 //#endregion
 export { PropertyGroupId };

package/dist/config/dist/serialize.d.ts

@@ -1,7 +1,6 @@
 import { ArbitraryTokenGroup, AtomicToken, ExampleDef, ModeGroup, ModifierDef, MotionPresetsDef, UdsConfig } from "./createConfig.js";
 
 //#region ../config/dist/serialize.d.ts
-//#region src/serialize.d.ts
 type ModifierNameShape = `_${string}`;
 type TokenRef = {
   $ref: string;
@@ -18,6 +17,7 @@ interface SerializedConfig {
   examples?: Record<string, ExampleDef>;
   preflight: boolean;
   prefix: string;
+  presetTokenNames?: Record<string, string[]>;
 }
 type SerializedValue = string | TokenRef | {
   [key: string]: SerializedValue;
@@ -52,6 +52,6 @@ declare function serializeConfig(config: UdsConfig): SerializedConfig;
  * Resolves `$ref` markers back to `var()` strings using the atomic token
  * definitions, then reconstructs the builder chain.
  */
-declare function deserializeConfig(data: SerializedConfig): UdsConfig; //#endregion
+declare function deserializeConfig(data: SerializedConfig): UdsConfig;
 //#endregion
 export { SerializedConfig, TokenRef, buildReverseMap, deserializeConfig, serializeConfig };

package/dist/config/dist/serialize.js

@@ -100,7 +100,8 @@ function serializeConfig(config) {
 		globalStyles: Object.keys(globalStyles).length > 0 ? globalStyles : void 0,
 		examples: data.examples && Object.keys(data.examples).length > 0 ? data.examples : void 0,
 		preflight: data.preflight,
-		prefix: data.prefix
+		prefix: data.prefix,
+		presetTokenNames: data.presetTokenNames && Object.keys(data.presetTokenNames).length > 0 ? data.presetTokenNames : void 0
 	};
 }
 /**
@@ -142,7 +143,8 @@ function deserializeConfig(data) {
 		prefix: data.prefix ?? "uds",
 		arbitraryTokens: data.arbitraryTokens,
 		remotion: void 0,
-		globalStyles: {}
+		globalStyles: {},
+		presetTokenNames: data.presetTokenNames
 	});
 	if (data.globalStyles && Object.keys(data.globalStyles).length > 0) {
 		const globalStyles = {};

package/dist/config/dist/types.d.ts

@@ -1,5 +1,4 @@
 //#region ../config/dist/types.d.ts
-//#region src/types.d.ts
 /**
  * Scalar DTCG-aligned token types. Composite types (shadow, gradient,
  * typography, border, transition, cubicBezier) are intentionally deferred
@@ -60,6 +59,6 @@ type VarGroupDef<M extends `_${string}` = `_${string}`> = {
  *   spacing: { $type: 'dimension', 1: { value: '0.25rem' }, 2: { value: '0.5rem' } },
  * }
  */
-type VarsConfig<M extends `_${string}` = `_${string}`> = Record<string, VarGroupDef<M>>; //#endregion
+type VarsConfig<M extends `_${string}` = `_${string}`> = Record<string, VarGroupDef<M>>;
 //#endregion
 export { TokenType, VarGroupDef, VarTokenDef, VarsConfig };