@yahoo/uds 3.66.0 → 3.67.0-beta.1

package/dist/tokens/automation/utils/defaults.cjs

@@ -0,0 +1,15 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+
+//#region src/tokens/automation/utils/defaults.ts
+function getConfigDefaultValue(config, componentName, variant) {
+	const result = (config[componentName]?.defaults)?.[variant];
+	if (result === void 0) throw new Error(`The variant default for "${variant}" is not defined for the component "${componentName}"`);
+	return result;
+}
+function isConfigDefaultValue(config, componentName, variant, value) {
+	return getConfigDefaultValue(config, componentName, variant) === value;
+}
+
+//#endregion
+exports.getConfigDefaultValue = getConfigDefaultValue;
+exports.isConfigDefaultValue = isConfigDefaultValue;

package/dist/tokens/automation/utils/defaults.d.cts

@@ -0,0 +1,8 @@
+import { UniversalTokensConfigAuto } from "../../../generated/universalTokensConfigAuto.cjs";
+
+//#region src/tokens/automation/utils/defaults.d.ts
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+declare function getConfigDefaultValue(config: UniversalTokensConfigAuto, componentName: keyof UniversalTokensConfigAuto, variant: KeysOfUnion<UniversalTokensConfigAuto[keyof UniversalTokensConfigAuto]['defaults']>): string;
+declare function isConfigDefaultValue(config: UniversalTokensConfigAuto, componentName: keyof UniversalTokensConfigAuto, variant: KeysOfUnion<UniversalTokensConfigAuto[keyof UniversalTokensConfigAuto]['defaults']>, value: unknown): boolean;
+//#endregion
+export { getConfigDefaultValue, isConfigDefaultValue };

package/dist/tokens/automation/utils/defaults.d.ts

@@ -0,0 +1,8 @@
+import { UniversalTokensConfigAuto } from "../../../generated/universalTokensConfigAuto.js";
+
+//#region src/tokens/automation/utils/defaults.d.ts
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+declare function getConfigDefaultValue(config: UniversalTokensConfigAuto, componentName: keyof UniversalTokensConfigAuto, variant: KeysOfUnion<UniversalTokensConfigAuto[keyof UniversalTokensConfigAuto]['defaults']>): string;
+declare function isConfigDefaultValue(config: UniversalTokensConfigAuto, componentName: keyof UniversalTokensConfigAuto, variant: KeysOfUnion<UniversalTokensConfigAuto[keyof UniversalTokensConfigAuto]['defaults']>, value: unknown): boolean;
+//#endregion
+export { getConfigDefaultValue, isConfigDefaultValue };

package/dist/tokens/automation/utils/defaults.js

@@ -0,0 +1,13 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+//#region src/tokens/automation/utils/defaults.ts
+function getConfigDefaultValue(config, componentName, variant) {
+	const result = (config[componentName]?.defaults)?.[variant];
+	if (result === void 0) throw new Error(`The variant default for "${variant}" is not defined for the component "${componentName}"`);
+	return result;
+}
+function isConfigDefaultValue(config, componentName, variant, value) {
+	return getConfigDefaultValue(config, componentName, variant) === value;
+}
+
+//#endregion
+export { getConfigDefaultValue, isConfigDefaultValue };

package/dist/tokens/automation/utils/generateKeyFromFlatConfigPath.cjs

@@ -0,0 +1,26 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+
+//#region src/tokens/automation/utils/generateKeyFromFlatConfigPath.ts
+/**
+* Converts a flattened configuration path into a simplified alias key.
+*
+* @param path - The flattened configuration path (e.g., "checkbox.variables.xs.rest.value").
+* @returns A simplified alias key (e.g., "checkbox/xs/rest").
+*/
+function generateKeyFromFlatConfigPath(path) {
+	const replaceStrings = [
+		"root/",
+		"variables/",
+		"variant/",
+		"/value"
+	];
+	let key = path;
+	key = key.replaceAll(".", "/");
+	replaceStrings.forEach((replaceString) => {
+		key = key.replaceAll(replaceString, "");
+	});
+	return key;
+}
+
+//#endregion
+exports.generateKeyFromFlatConfigPath = generateKeyFromFlatConfigPath;

package/dist/tokens/automation/utils/generateKeyFromFlatConfigPath.d.cts

@@ -0,0 +1,10 @@
+//#region src/tokens/automation/utils/generateKeyFromFlatConfigPath.d.ts
+/**
+ * Converts a flattened configuration path into a simplified alias key.
+ *
+ * @param path - The flattened configuration path (e.g., "checkbox.variables.xs.rest.value").
+ * @returns A simplified alias key (e.g., "checkbox/xs/rest").
+ */
+declare function generateKeyFromFlatConfigPath(path: string): string;
+//#endregion
+export { generateKeyFromFlatConfigPath };

package/dist/tokens/automation/utils/generateKeyFromFlatConfigPath.d.ts

@@ -0,0 +1,10 @@
+//#region src/tokens/automation/utils/generateKeyFromFlatConfigPath.d.ts
+/**
+ * Converts a flattened configuration path into a simplified alias key.
+ *
+ * @param path - The flattened configuration path (e.g., "checkbox.variables.xs.rest.value").
+ * @returns A simplified alias key (e.g., "checkbox/xs/rest").
+ */
+declare function generateKeyFromFlatConfigPath(path: string): string;
+//#endregion
+export { generateKeyFromFlatConfigPath };

package/dist/tokens/automation/utils/generateKeyFromFlatConfigPath.js

@@ -0,0 +1,25 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+//#region src/tokens/automation/utils/generateKeyFromFlatConfigPath.ts
+/**
+* Converts a flattened configuration path into a simplified alias key.
+*
+* @param path - The flattened configuration path (e.g., "checkbox.variables.xs.rest.value").
+* @returns A simplified alias key (e.g., "checkbox/xs/rest").
+*/
+function generateKeyFromFlatConfigPath(path) {
+	const replaceStrings = [
+		"root/",
+		"variables/",
+		"variant/",
+		"/value"
+	];
+	let key = path;
+	key = key.replaceAll(".", "/");
+	replaceStrings.forEach((replaceString) => {
+		key = key.replaceAll(replaceString, "");
+	});
+	return key;
+}
+
+//#endregion
+export { generateKeyFromFlatConfigPath };

package/dist/tokens/automation/utils/generateSchemaKey.cjs

@@ -0,0 +1,14 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+
+//#region src/tokens/automation/utils/generateSchemaKey.ts
+function generateSchemaKey({ variantKey, variantValue, layer, subComponentName, stateKey, stateValue }) {
+	if (subComponentName) {
+		if (stateKey && stateValue) return `${subComponentName}/${variantKey}/${variantValue}/${stateKey}/${stateValue}/${layer}`;
+		return `${subComponentName}/${variantKey}/${variantValue}/${layer}`;
+	}
+	if (stateKey && stateValue) return `${variantKey}/${variantValue}/${stateKey}/${stateValue}/${layer}`;
+	return `${variantKey}/${variantValue}/${layer}`;
+}
+
+//#endregion
+exports.generateSchemaKey = generateSchemaKey;

package/dist/tokens/automation/utils/generateSchemaKey.d.cts

@@ -0,0 +1,18 @@
+//#region src/tokens/automation/utils/generateSchemaKey.d.ts
+declare function generateSchemaKey({
+  variantKey,
+  variantValue,
+  layer,
+  subComponentName,
+  stateKey,
+  stateValue
+}: {
+  variantKey: string;
+  variantValue: string;
+  layer: string;
+  subComponentName?: string;
+  stateKey?: string;
+  stateValue?: string;
+}): string;
+//#endregion
+export { generateSchemaKey };

package/dist/tokens/automation/utils/generateSchemaKey.d.ts

@@ -0,0 +1,18 @@
+//#region src/tokens/automation/utils/generateSchemaKey.d.ts
+declare function generateSchemaKey({
+  variantKey,
+  variantValue,
+  layer,
+  subComponentName,
+  stateKey,
+  stateValue
+}: {
+  variantKey: string;
+  variantValue: string;
+  layer: string;
+  subComponentName?: string;
+  stateKey?: string;
+  stateValue?: string;
+}): string;
+//#endregion
+export { generateSchemaKey };

package/dist/tokens/automation/utils/generateSchemaKey.js

@@ -0,0 +1,13 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+//#region src/tokens/automation/utils/generateSchemaKey.ts
+function generateSchemaKey({ variantKey, variantValue, layer, subComponentName, stateKey, stateValue }) {
+	if (subComponentName) {
+		if (stateKey && stateValue) return `${subComponentName}/${variantKey}/${variantValue}/${stateKey}/${stateValue}/${layer}`;
+		return `${subComponentName}/${variantKey}/${variantValue}/${layer}`;
+	}
+	if (stateKey && stateValue) return `${variantKey}/${variantValue}/${stateKey}/${stateValue}/${layer}`;
+	return `${variantKey}/${variantValue}/${layer}`;
+}
+
+//#endregion
+export { generateSchemaKey };

package/dist/tokens/automation/utils/getConfigComponentVariant.cjs

@@ -0,0 +1,17 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_tokens_automation_utils_coalesceConfigVariant = require('./coalesceConfigVariant.cjs');
+
+//#region src/tokens/automation/utils/getConfigComponentVariant.ts
+function getConfigComponentVariant(config, variantKey, subComponentName) {
+	const result = require_tokens_automation_utils_coalesceConfigVariant.coalesceConfigVariant(config, variantKey);
+	switch (result.type) {
+		case "no-variants": return null;
+		case "no-sub-components": return result.variant;
+		case "has-sub-components":
+			if (!subComponentName) throw new Error("subComponentName argument name is required for configs with subcomponents");
+			return result.variants[subComponentName];
+	}
+}
+
+//#endregion
+exports.getConfigComponentVariant = getConfigComponentVariant;

package/dist/tokens/automation/utils/getConfigComponentVariant.d.cts

@@ -0,0 +1,8 @@
+import { ComponentConfig, VariantConfig } from "../types/ComponentConfig.cjs";
+import "../types/index.cjs";
+import "../index.cjs";
+
+//#region src/tokens/automation/utils/getConfigComponentVariant.d.ts
+declare function getConfigComponentVariant<C extends ComponentConfig>(config: C, variantKey: string, subComponentName?: string): VariantConfig<string> | null;
+//#endregion
+export { getConfigComponentVariant };

package/dist/tokens/automation/utils/getConfigComponentVariant.d.ts

@@ -0,0 +1,8 @@
+import { ComponentConfig, VariantConfig } from "../types/ComponentConfig.js";
+import "../types/index.js";
+import "../index.js";
+
+//#region src/tokens/automation/utils/getConfigComponentVariant.d.ts
+declare function getConfigComponentVariant<C extends ComponentConfig>(config: C, variantKey: string, subComponentName?: string): VariantConfig<string> | null;
+//#endregion
+export { getConfigComponentVariant };

package/dist/tokens/automation/utils/getConfigComponentVariant.js

@@ -0,0 +1,17 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { coalesceConfigVariant } from "./coalesceConfigVariant.js";
+
+//#region src/tokens/automation/utils/getConfigComponentVariant.ts
+function getConfigComponentVariant(config, variantKey, subComponentName) {
+	const result = coalesceConfigVariant(config, variantKey);
+	switch (result.type) {
+		case "no-variants": return null;
+		case "no-sub-components": return result.variant;
+		case "has-sub-components":
+			if (!subComponentName) throw new Error("subComponentName argument name is required for configs with subcomponents");
+			return result.variants[subComponentName];
+	}
+}
+
+//#endregion
+export { getConfigComponentVariant };

package/dist/tokens/automation/utils/getConfigVariantComponentStatesMatrix.cjs

@@ -0,0 +1,26 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_tokens_automation_utils_variantConfigGuards = require('./variantConfigGuards.cjs');
+const require_tokens_automation_utils_cartesianProduct = require('./cartesianProduct.cjs');
+const require_tokens_automation_utils_getConfigComponentVariant = require('./getConfigComponentVariant.cjs');
+let lodash_entries_js = require("lodash/entries.js");
+lodash_entries_js = require_rolldown_runtime.__toESM(lodash_entries_js);
+
+//#region src/tokens/automation/utils/getConfigVariantComponentStatesMatrix.ts
+function getConfigVariantComponentStates(config, variantKey, subComponentName) {
+	const componentVariant = require_tokens_automation_utils_getConfigComponentVariant.getConfigComponentVariant(config, variantKey, subComponentName);
+	if (!componentVariant || !require_tokens_automation_utils_variantConfigGuards.isVariantConfigWithComponentStates(componentVariant)) return null;
+	return componentVariant?.componentStates ?? null;
+}
+function getConfigVariantComponentStatesMatrix(config, variantKey, subComponentName) {
+	const componentStates = getConfigVariantComponentStates(config, variantKey, subComponentName);
+	if (!componentStates) return null;
+	return require_tokens_automation_utils_cartesianProduct.cartesianProduct((0, lodash_entries_js.default)(componentStates).map(([key, c]) => c.options.map((c$1) => ({ [key]: c$1 })))).map((p) => Array.isArray(p) ? p.reduce((acc, curr) => ({
+		...acc,
+		...curr
+	}), {}) : p);
+}
+
+//#endregion
+exports.getConfigVariantComponentStates = getConfigVariantComponentStates;
+exports.getConfigVariantComponentStatesMatrix = getConfigVariantComponentStatesMatrix;

package/dist/tokens/automation/utils/getConfigVariantComponentStatesMatrix.d.cts

@@ -0,0 +1,9 @@
+import { ComponentConfig, ComponentStateConfig } from "../types/ComponentConfig.cjs";
+import "../types/index.cjs";
+import "../index.cjs";
+
+//#region src/tokens/automation/utils/getConfigVariantComponentStatesMatrix.d.ts
+declare function getConfigVariantComponentStates<C extends ComponentConfig>(config: C, variantKey: string, subComponentName?: string): Readonly<Record<string, ComponentStateConfig>> | null;
+declare function getConfigVariantComponentStatesMatrix<C extends ComponentConfig>(config: C, variantKey: string, subComponentName?: string): {}[] | null;
+//#endregion
+export { getConfigVariantComponentStates, getConfigVariantComponentStatesMatrix };

package/dist/tokens/automation/utils/getConfigVariantComponentStatesMatrix.d.ts

@@ -0,0 +1,9 @@
+import { ComponentConfig, ComponentStateConfig } from "../types/ComponentConfig.js";
+import "../types/index.js";
+import "../index.js";
+
+//#region src/tokens/automation/utils/getConfigVariantComponentStatesMatrix.d.ts
+declare function getConfigVariantComponentStates<C extends ComponentConfig>(config: C, variantKey: string, subComponentName?: string): Readonly<Record<string, ComponentStateConfig>> | null;
+declare function getConfigVariantComponentStatesMatrix<C extends ComponentConfig>(config: C, variantKey: string, subComponentName?: string): {}[] | null;
+//#endregion
+export { getConfigVariantComponentStates, getConfigVariantComponentStatesMatrix };

package/dist/tokens/automation/utils/getConfigVariantComponentStatesMatrix.js

@@ -0,0 +1,23 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { isVariantConfigWithComponentStates } from "./variantConfigGuards.js";
+import { cartesianProduct } from "./cartesianProduct.js";
+import { getConfigComponentVariant } from "./getConfigComponentVariant.js";
+import { entries } from "lodash-es";
+
+//#region src/tokens/automation/utils/getConfigVariantComponentStatesMatrix.ts
+function getConfigVariantComponentStates(config, variantKey, subComponentName) {
+	const componentVariant = getConfigComponentVariant(config, variantKey, subComponentName);
+	if (!componentVariant || !isVariantConfigWithComponentStates(componentVariant)) return null;
+	return componentVariant?.componentStates ?? null;
+}
+function getConfigVariantComponentStatesMatrix(config, variantKey, subComponentName) {
+	const componentStates = getConfigVariantComponentStates(config, variantKey, subComponentName);
+	if (!componentStates) return null;
+	return cartesianProduct(entries(componentStates).map(([key, c]) => c.options.map((c$1) => ({ [key]: c$1 })))).map((p) => Array.isArray(p) ? p.reduce((acc, curr) => ({
+		...acc,
+		...curr
+	}), {}) : p);
+}
+
+//#endregion
+export { getConfigVariantComponentStates, getConfigVariantComponentStatesMatrix };

package/dist/tokens/automation/utils/getConfigVariantProperties.cjs

@@ -0,0 +1,24 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_tokens_utils_mapValues = require('../../utils/mapValues.cjs');
+const require_tokens_automation_utils_variantConfigGuards = require('./variantConfigGuards.cjs');
+
+//#region src/tokens/automation/utils/getConfigVariantProperties.ts
+/**
+* Gets the properties of a variant config grouped by layer.
+*
+* @param variant - The variant config to get the properties from
+* @returns A Record of layer names to their properties, or null if no properties are found
+*/
+function getConfigVariantProperties(variant) {
+	if (!variant || !require_tokens_automation_utils_variantConfigGuards.isVariantConfigWithProperties(variant)) return null;
+	const result = require_tokens_utils_mapValues.mapValues(variant.layers, (layer) => layer.properties);
+	for (const layerKey in result) {
+		const layerProperties = result[layerKey];
+		if (!layerProperties || Object.keys(layerProperties).length === 0) delete result[layerKey];
+	}
+	if (Object.keys(result).length === 0) return null;
+	return result;
+}
+
+//#endregion
+exports.getConfigVariantProperties = getConfigVariantProperties;

package/dist/tokens/automation/utils/getConfigVariantProperties.d.cts

@@ -0,0 +1,19 @@
+import { SelectedConfigurableProperty } from "../properties.cjs";
+import { VariantConfig } from "../types/ComponentConfig.cjs";
+import "../types/index.cjs";
+import "../../index.cjs";
+
+//#region src/tokens/automation/utils/getConfigVariantProperties.d.ts
+
+/**
+ * Gets the properties of a variant config grouped by layer.
+ *
+ * @param variant - The variant config to get the properties from
+ * @returns A Record of layer names to their properties, or null if no properties are found
+ */
+declare function getConfigVariantProperties(variant?: VariantConfig): {
+  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"color" | "borderColor" | "borderWidth" | "backgroundColor" | "borderRadius" | "spacingHorizontal" | "spacingVertical" | "width" | "height" | "insetShadow" | "gap" | "textVariant" | "shadow" | "opacity" | "scaleEffect" | "fontFamily" | "fontSize" | "fontVariationSettings" | "fontWeight" | "letterSpacing" | "lineHeight" | "padding" | "textDecorationLine" | "textTransform" | "iconSize", string, ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[] | ("borderWidths" | "spacingAliases")[] | "borderRadii"[] | ("spectrumColors" | "linePaletteColors" | "alwaysPaletteAliases")[] | "textVariants"[] | "spacingAliases"[] | ("spectrumColors" | "foregroundPaletteColors" | "alwaysPaletteAliases")[] | "opacitySteps"[] | "iconSizes"[] | "textDecorationLines"[] | "shadowVariants"[] | "shadowVariantsWithInvert"[] | "scaleEffects"[], readonly (readonly string[])[]>>>;
+  root: Readonly<Record<string, SelectedConfigurableProperty<"color" | "borderColor" | "borderWidth" | "backgroundColor" | "borderRadius" | "spacingHorizontal" | "spacingVertical" | "width" | "height" | "insetShadow" | "gap" | "textVariant" | "shadow" | "opacity" | "scaleEffect" | "fontFamily" | "fontSize" | "fontVariationSettings" | "fontWeight" | "letterSpacing" | "lineHeight" | "padding" | "textDecorationLine" | "textTransform" | "iconSize", string, ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[] | ("borderWidths" | "spacingAliases")[] | "borderRadii"[] | ("spectrumColors" | "linePaletteColors" | "alwaysPaletteAliases")[] | "textVariants"[] | "spacingAliases"[] | ("spectrumColors" | "foregroundPaletteColors" | "alwaysPaletteAliases")[] | "opacitySteps"[] | "iconSizes"[] | "textDecorationLines"[] | "shadowVariants"[] | "shadowVariantsWithInvert"[] | "scaleEffects"[], readonly (readonly string[])[]>>>;
+} | null;
+//#endregion
+export { getConfigVariantProperties };

package/dist/tokens/automation/utils/getConfigVariantProperties.d.ts

@@ -0,0 +1,19 @@
+import { SelectedConfigurableProperty } from "../properties.js";
+import { VariantConfig } from "../types/ComponentConfig.js";
+import "../types/index.js";
+import "../../index.js";
+
+//#region src/tokens/automation/utils/getConfigVariantProperties.d.ts
+
+/**
+ * Gets the properties of a variant config grouped by layer.
+ *
+ * @param variant - The variant config to get the properties from
+ * @returns A Record of layer names to their properties, or null if no properties are found
+ */
+declare function getConfigVariantProperties(variant?: VariantConfig): {
+  [x: string]: Readonly<Record<string, SelectedConfigurableProperty<"color" | "borderColor" | "borderWidth" | "backgroundColor" | "borderRadius" | "spacingHorizontal" | "spacingVertical" | "width" | "height" | "insetShadow" | "gap" | "textVariant" | "shadow" | "opacity" | "scaleEffect" | "fontFamily" | "fontSize" | "fontVariationSettings" | "fontWeight" | "letterSpacing" | "lineHeight" | "padding" | "textDecorationLine" | "textTransform" | "iconSize", string, ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[] | ("borderWidths" | "spacingAliases")[] | "borderRadii"[] | ("spectrumColors" | "linePaletteColors" | "alwaysPaletteAliases")[] | "textVariants"[] | "spacingAliases"[] | ("spectrumColors" | "foregroundPaletteColors" | "alwaysPaletteAliases")[] | "opacitySteps"[] | "iconSizes"[] | "textDecorationLines"[] | "shadowVariants"[] | "shadowVariantsWithInvert"[] | "scaleEffects"[], readonly (readonly string[])[]>>>;
+  root: Readonly<Record<string, SelectedConfigurableProperty<"color" | "borderColor" | "borderWidth" | "backgroundColor" | "borderRadius" | "spacingHorizontal" | "spacingVertical" | "width" | "height" | "insetShadow" | "gap" | "textVariant" | "shadow" | "opacity" | "scaleEffect" | "fontFamily" | "fontSize" | "fontVariationSettings" | "fontWeight" | "letterSpacing" | "lineHeight" | "padding" | "textDecorationLine" | "textTransform" | "iconSize", string, ("backgroundPaletteColors" | "spectrumColors" | "alwaysPaletteAliases")[] | ("borderWidths" | "spacingAliases")[] | "borderRadii"[] | ("spectrumColors" | "linePaletteColors" | "alwaysPaletteAliases")[] | "textVariants"[] | "spacingAliases"[] | ("spectrumColors" | "foregroundPaletteColors" | "alwaysPaletteAliases")[] | "opacitySteps"[] | "iconSizes"[] | "textDecorationLines"[] | "shadowVariants"[] | "shadowVariantsWithInvert"[] | "scaleEffects"[], readonly (readonly string[])[]>>>;
+} | null;
+//#endregion
+export { getConfigVariantProperties };

package/dist/tokens/automation/utils/getConfigVariantProperties.js

@@ -0,0 +1,24 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { mapValues } from "../../utils/mapValues.js";
+import { isVariantConfigWithProperties } from "./variantConfigGuards.js";
+
+//#region src/tokens/automation/utils/getConfigVariantProperties.ts
+/**
+* Gets the properties of a variant config grouped by layer.
+*
+* @param variant - The variant config to get the properties from
+* @returns A Record of layer names to their properties, or null if no properties are found
+*/
+function getConfigVariantProperties(variant) {
+	if (!variant || !isVariantConfigWithProperties(variant)) return null;
+	const result = mapValues(variant.layers, (layer) => layer.properties);
+	for (const layerKey in result) {
+		const layerProperties = result[layerKey];
+		if (!layerProperties || Object.keys(layerProperties).length === 0) delete result[layerKey];
+	}
+	if (Object.keys(result).length === 0) return null;
+	return result;
+}
+
+//#endregion
+export { getConfigVariantProperties };

package/dist/tokens/automation/utils/getConfigVariantPseudoStates.cjs

@@ -0,0 +1,34 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_tokens_automation_utils_variantConfigGuards = require('./variantConfigGuards.cjs');
+const require_tokens_automation_utils_getConfigComponentVariant = require('./getConfigComponentVariant.cjs');
+
+//#region src/tokens/automation/utils/getConfigVariantPseudoStates.ts
+const DEFAULT_PSEUDO_STATES = ["rest"];
+function getConfigVariantPseudoStates(config, variantKey, state, subComponentName) {
+	const componentVariant = require_tokens_automation_utils_getConfigComponentVariant.getConfigComponentVariant(config, variantKey, subComponentName);
+	if (!componentVariant) return null;
+	const variantLayers = require_tokens_automation_utils_variantConfigGuards.isVariantConfigWithProperties(componentVariant) ? Object.entries(componentVariant?.layers ?? {}) : [];
+	const stateLayers = require_tokens_automation_utils_variantConfigGuards.isVariantConfigWithComponentStates(componentVariant) && state ? Object.entries(componentVariant.componentStates[state].layers ?? {}) : [];
+	return [...variantLayers, ...stateLayers].flatMap(([layerKey, layer]) => Object.entries(layer.properties).map(([propertyKey, property]) => [
+		layerKey,
+		propertyKey,
+		property
+	])).flatMap(([layerKey, propertyKey, property]) => [...property.skipRestState ? DEFAULT_PSEUDO_STATES.filter((s) => s !== "rest") : DEFAULT_PSEUDO_STATES, ...property.pseudoStates ?? []].map((pseudoState) => [
+		layerKey,
+		propertyKey,
+		property,
+		pseudoState
+	])).reduce((acc, [layerKey, propertyKey, property, pseudoState]) => {
+		acc[pseudoState] = acc[pseudoState] ?? [];
+		const info = [
+			layerKey,
+			propertyKey,
+			property
+		];
+		acc[pseudoState].push(info);
+		return acc;
+	}, {});
+}
+
+//#endregion
+exports.getConfigVariantPseudoStates = getConfigVariantPseudoStates;

package/dist/tokens/automation/utils/getConfigVariantPseudoStates.d.cts

@@ -0,0 +1,11 @@
+import { SelectedConfigurableProperty } from "../properties.cjs";
+import { ComponentConfig, PossibleStatesWithRest } from "../types/ComponentConfig.cjs";
+import "../types/index.cjs";
+import "../../index.cjs";
+
+//#region src/tokens/automation/utils/getConfigVariantPseudoStates.d.ts
+type GenericProperty = SelectedConfigurableProperty<any, any>;
+type InfoTuple = [string, string, GenericProperty];
+declare function getConfigVariantPseudoStates<C extends ComponentConfig>(config: C, variantKey: string, state?: string, subComponentName?: string): Record<PossibleStatesWithRest, InfoTuple[]> | null;
+//#endregion
+export { getConfigVariantPseudoStates };

package/dist/tokens/automation/utils/getConfigVariantPseudoStates.d.ts

@@ -0,0 +1,11 @@
+import { SelectedConfigurableProperty } from "../properties.js";
+import { ComponentConfig, PossibleStatesWithRest } from "../types/ComponentConfig.js";
+import "../types/index.js";
+import "../../index.js";
+
+//#region src/tokens/automation/utils/getConfigVariantPseudoStates.d.ts
+type GenericProperty = SelectedConfigurableProperty<any, any>;
+type InfoTuple = [string, string, GenericProperty];
+declare function getConfigVariantPseudoStates<C extends ComponentConfig>(config: C, variantKey: string, state?: string, subComponentName?: string): Record<PossibleStatesWithRest, InfoTuple[]> | null;
+//#endregion
+export { getConfigVariantPseudoStates };

package/dist/tokens/automation/utils/getConfigVariantPseudoStates.js

@@ -0,0 +1,34 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { isVariantConfigWithComponentStates, isVariantConfigWithProperties } from "./variantConfigGuards.js";
+import { getConfigComponentVariant } from "./getConfigComponentVariant.js";
+
+//#region src/tokens/automation/utils/getConfigVariantPseudoStates.ts
+const DEFAULT_PSEUDO_STATES = ["rest"];
+function getConfigVariantPseudoStates(config, variantKey, state, subComponentName) {
+	const componentVariant = getConfigComponentVariant(config, variantKey, subComponentName);
+	if (!componentVariant) return null;
+	const variantLayers = isVariantConfigWithProperties(componentVariant) ? Object.entries(componentVariant?.layers ?? {}) : [];
+	const stateLayers = isVariantConfigWithComponentStates(componentVariant) && state ? Object.entries(componentVariant.componentStates[state].layers ?? {}) : [];
+	return [...variantLayers, ...stateLayers].flatMap(([layerKey, layer]) => Object.entries(layer.properties).map(([propertyKey, property]) => [
+		layerKey,
+		propertyKey,
+		property
+	])).flatMap(([layerKey, propertyKey, property]) => [...property.skipRestState ? DEFAULT_PSEUDO_STATES.filter((s) => s !== "rest") : DEFAULT_PSEUDO_STATES, ...property.pseudoStates ?? []].map((pseudoState) => [
+		layerKey,
+		propertyKey,
+		property,
+		pseudoState
+	])).reduce((acc, [layerKey, propertyKey, property, pseudoState]) => {
+		acc[pseudoState] = acc[pseudoState] ?? [];
+		const info = [
+			layerKey,
+			propertyKey,
+			property
+		];
+		acc[pseudoState].push(info);
+		return acc;
+	}, {});
+}
+
+//#endregion
+export { getConfigVariantPseudoStates };

package/dist/tokens/automation/utils/getConfigVariants.cjs

@@ -0,0 +1,39 @@
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_tokens_automation_utils_coalesceConfigVariant = require('./coalesceConfigVariant.cjs');
+const require_tokens_automation_utils_subcomponents = require('./subcomponents.cjs');
+let lodash_entries_js = require("lodash/entries.js");
+lodash_entries_js = require_rolldown_runtime.__toESM(lodash_entries_js);
+
+//#region src/tokens/automation/utils/getConfigVariants.ts
+function getConfigVariants(config, variantKey = "variant") {
+	const result = require_tokens_automation_utils_coalesceConfigVariant.coalesceConfigVariant(config, variantKey);
+	if (result.type === "no-variants") return {
+		type: "no-variants",
+		description: "No variants"
+	};
+	if (result.type === "no-sub-components") {
+		if (require_tokens_automation_utils_subcomponents.getConfigSubcomponents(config)) throw new Error("A config with a root variants.variant defintion cannot have subcomponents");
+		return {
+			type: "no-sub-components",
+			description: result.variant.description,
+			variantNames: [...result.variant.options]
+		};
+	}
+	const variantToSubcomponentNames = (0, lodash_entries_js.default)(result.variants).reduce((acc, [subComponentName, subComponentVariantDef]) => {
+		for (const variant of subComponentVariantDef.options) {
+			acc[variant] ??= [];
+			if (!acc[variant].includes(subComponentName)) acc[variant].push(subComponentName);
+		}
+		return acc;
+	}, {});
+	return {
+		type: "has-sub-components",
+		description: Object.values(result.variants).map((c) => c.description).filter((c) => c)[0] ?? "",
+		variantNames: Object.keys(variantToSubcomponentNames),
+		variantToSubcomponentNames
+	};
+}
+
+//#endregion
+exports.getConfigVariants = getConfigVariants;

package/dist/tokens/automation/utils/getConfigVariants.d.cts

@@ -0,0 +1,19 @@
+import { ComponentConfig } from "../types/ComponentConfig.cjs";
+import "../types/index.cjs";
+
+//#region src/tokens/automation/utils/getConfigVariants.d.ts
+declare function getConfigVariants<C extends ComponentConfig>(config: C, variantKey?: string): {
+  type: 'has-sub-components';
+  description: string;
+  variantNames: Array<string>;
+  variantToSubcomponentNames: Record<string, Array<string>>;
+} | {
+  type: 'no-sub-components';
+  description: string;
+  variantNames: Array<string>;
+} | {
+  description: string;
+  type: 'no-variants';
+};
+//#endregion
+export { getConfigVariants };

package/dist/tokens/automation/utils/getConfigVariants.d.ts

@@ -0,0 +1,19 @@
+import { ComponentConfig } from "../types/ComponentConfig.js";
+import "../types/index.js";
+
+//#region src/tokens/automation/utils/getConfigVariants.d.ts
+declare function getConfigVariants<C extends ComponentConfig>(config: C, variantKey?: string): {
+  type: 'has-sub-components';
+  description: string;
+  variantNames: Array<string>;
+  variantToSubcomponentNames: Record<string, Array<string>>;
+} | {
+  type: 'no-sub-components';
+  description: string;
+  variantNames: Array<string>;
+} | {
+  description: string;
+  type: 'no-variants';
+};
+//#endregion
+export { getConfigVariants };