@yahoo/uds 3.134.0 → 3.134.1

package/dist/tailwind/dist/css/generate.js

@@ -2,6 +2,7 @@
 import { cyan, magenta, yellow } from "../cli/dist/lib/colors.js";
 import { print } from "../cli/dist/lib/print.js";
 import { spinStop } from "../cli/dist/lib/spinner.js";
+import { measureAsync } from "./perf.js";
 import { resolveEntryPaths } from "../utils/entryPoints.js";
 import { loadConfigFile, scanDirectoriesForSafelist } from "./nodeUtils.js";
 import { defaultTokensConfig } from "../config/dist/index.js";
@@ -34,7 +35,7 @@ const generateCSS = async (safelist, config, options) => {
 	const cssFlags = getCssFeatureFlags(options?.cssOptions);
 	const optimizationConfig = options?.cssOptions?.optimization;
 	const scopeClass = normalizeScope(options?.scope) ?? normalizeScope(options?.cssOptions?.scope);
-	let css = await applyScopedColorModeFix((await postcss(buildPostcssPlugins({
+	const plugins = buildPostcssPlugins({
 		tailwindPlugin: createTailwindPlugin({
 			contentDir,
 			rawContents: getArbitrarySafelistRawContent(safelist),
@@ -46,15 +47,17 @@ const generateCSS = async (safelist, config, options) => {
 		shouldPruneVars: cssFlags.shouldPruneVars,
 		safeVarPrefixes: options?.safeVarPrefixes ?? [],
 		scopeClass
-	})).process(sourceCSS, { from: void 0 })).css, scopeClass);
+	});
+	const result = await measureAsync("gen:postcss", () => postcss(plugins).process(sourceCSS, { from: void 0 }));
+	let css = await measureAsync("gen:scoped-color-fix", () => applyScopedColorModeFix(result.css, scopeClass));
 	if (!css.includes("uds-light-mode-icon") || !css.includes("uds-dark-mode-icon")) css = `${css} ${getInternalIconModeCss(scopeClass)}`.trim();
-	const optimizedCss = await optimizeGeneratedCss({
+	const optimizedCss = await measureAsync("gen:optimize", () => optimizeGeneratedCss({
 		css,
 		shouldOptimize: cssFlags.shouldOptimize,
 		optimizationConfig,
 		referenceCss: options?.referenceCss,
 		scopeClass
-	});
+	}));
 	css = optimizedCss.css;
 	const sizeBytes = Buffer.byteLength(css, "utf8");
 	const sizeGzipBytes = gzipSync(css).length;

package/dist/tailwind/dist/css/generate.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate.js","names":[],"sources":["../../src/css/generate.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { gzipSync } from 'node:zlib';\n\nimport { cyan, magenta, print, spinStop, yellow } from '@yahoo/uds-cli/lib';\nimport type { UniversalTokensConfig } from '@yahoo/uds-config';\nimport { defaultTokensConfig } from '@yahoo/uds-config';\nimport postcss from 'postcss';\nimport type { SafelistConfig } from 'tailwindcss/types/config';\n\nimport type { SerializedComponentInfo } from '../commands/generateComponentData';\nimport {\n  deduplicateSafelist,\n  getInternalSafelistClasses,\n  getThemeAndScaleClasses,\n} from '../purger/optimized';\nimport type { EntryValue } from '../utils/entryPoints';\nimport { resolveEntryPaths } from '../utils/entryPoints';\nimport {\n  applyScopedColorModeFix,\n  buildPostcssPlugins,\n  createTailwindPlugin,\n  getCssFeatureFlags,\n  getInternalIconModeCss,\n  optimizeGeneratedCss,\n  printSimpleModeStats,\n} from './generate.helpers';\nimport { loadConfigFile, scanDirectoriesForSafelist } from './nodeUtils';\nimport type { UDSCSSOptimizationOptions, UDSCSSVarSafelistPattern } from './theme';\nimport {\n  extractRuntimeConfigValues,\n  extractVariantDefaults,\n  getConfigurableCssVariables,\n  getMotionVarPrefixes,\n} from './utils';\n\n/**\n * Result from generating CSS\n */\ninterface CSSResult {\n  css: string;\n  sizeBytes: number;\n  sizeGzipBytes: number;\n  classCount: number;\n  optimizationStats?: {\n    originalSize: number;\n    originalSizeGzip: number;\n    fontFacesRemoved: number;\n    emptyRulesRemoved: number;\n    validationErrors: string[];\n  };\n}\n\n/**\n * CSS generation options for uds.theme.ts\n */\ninterface UDSCSSOptions {\n  /** CSS scope wrapper class (optional) */\n  scope?: string;\n  /** Safelist of CSS classes to always include */\n  safelist?: SafelistConfig[];\n  /** CSS optimization settings */\n  optimization?: UDSCSSOptimizationOptions;\n  /** Include Tailwind preflight/reset styles (default: true) */\n  preflight?: boolean;\n  /** Include @font-face declarations (default: true) */\n  fontFaceDeclarations?: boolean;\n  /** Debounce delay (ms) for watch mode regenerations */\n  watchDebounce?: number;\n}\n\n/**\n * Options for generateCSS function\n */\ninterface GenerateCSSOptions {\n  /** CSS scope wrapper class */\n  scope?: string;\n  /** Directory to scan for arbitrary Tailwind classes (className props) */\n  contentDir?: string | string[];\n  /** CSS generation options from theme config */\n  cssOptions?: UDSCSSOptions;\n  /** Reference CSS to deduplicate font-faces against (for scoped CSS) */\n  referenceCss?: string;\n  /** CSS variable prefixes or patterns to preserve during pruning */\n  safeVarPrefixes?: UDSCSSVarSafelistPattern[];\n}\n\nconst normalizeScope = (scope?: string): string | undefined => {\n  const trimmedScope = scope?.trim();\n  return trimmedScope ? trimmedScope : undefined;\n};\n\nconst getArbitrarySafelistRawContent = (safelist: SafelistConfig[]): string[] => {\n  const arbitraryClasses = safelist.filter(\n    (entry): entry is string => typeof entry === 'string' && entry.includes('['),\n  );\n\n  if (arbitraryClasses.length === 0) {\n    return [];\n  }\n\n  return [`<div class=\"${arbitraryClasses.join(' ')}\"></div>`];\n};\n\n/**\n * Generate CSS from a safelist using Tailwind + PostCSS\n * @param safelist - UDS component classes to include\n * @param config - Token configuration\n * @param options - Additional options\n */\nconst generateCSS = async (\n  safelist: SafelistConfig[],\n  config: UniversalTokensConfig,\n  options?: GenerateCSSOptions,\n): Promise<CSSResult> => {\n  // Do we need base?\n  const sourceCSS = '@tailwind base; @tailwind components; @tailwind utilities';\n\n  const contentDir = options?.contentDir ?? path.join(process.cwd(), 'src');\n  const cssFlags = getCssFeatureFlags(options?.cssOptions);\n  const optimizationConfig = options?.cssOptions?.optimization;\n  const scopeClass = normalizeScope(options?.scope) ?? normalizeScope(options?.cssOptions?.scope);\n  const twPlugin = createTailwindPlugin({\n    contentDir,\n    rawContents: getArbitrarySafelistRawContent(safelist),\n    safelist,\n    config,\n    enablePreflight: cssFlags.enablePreflight,\n    enableFontFaceDeclarations: cssFlags.enableFontFaceDeclarations,\n  });\n  const plugins = buildPostcssPlugins({\n    tailwindPlugin: twPlugin,\n    shouldPruneVars: cssFlags.shouldPruneVars,\n    safeVarPrefixes: options?.safeVarPrefixes ?? [],\n    scopeClass,\n  });\n\n  const result = await postcss(plugins).process(sourceCSS, { from: undefined });\n  let css = await applyScopedColorModeFix(result.css, scopeClass);\n  if (!css.includes('uds-light-mode-icon') || !css.includes('uds-dark-mode-icon')) {\n    css = `${css} ${getInternalIconModeCss(scopeClass)}`.trim();\n  }\n  const optimizedCss = await optimizeGeneratedCss({\n    css,\n    shouldOptimize: cssFlags.shouldOptimize,\n    optimizationConfig,\n    referenceCss: options?.referenceCss,\n    scopeClass,\n  });\n  css = optimizedCss.css;\n\n  const sizeBytes = Buffer.byteLength(css, 'utf8');\n  const sizeGzipBytes = gzipSync(css).length;\n\n  return {\n    css,\n    sizeBytes,\n    sizeGzipBytes,\n    classCount: safelist.length,\n    optimizationStats: optimizedCss.optimizationStats,\n  };\n};\n\n/**\n * Generate CSS in simple mode (no uds.theme.ts)\n */\nconst generateSimpleModeCSS = async (options: {\n  workspaceDir: string;\n  entry: EntryValue;\n  outFile: string;\n  variants: Record<string, Record<string, string>>;\n  autoVariants: Record<string, Record<string, string>>;\n  componentData: Record<string, SerializedComponentInfo>;\n  scope?: string;\n  configPath?: string;\n  isWatch?: boolean;\n  silent?: boolean;\n  verbose?: boolean;\n}): Promise<{ success: boolean; outputPath: string; packageDirs?: string[] }> => {\n  const isWatch = options.isWatch === true;\n  const isSilent = options.silent === true;\n  const shouldLogStats = !isSilent && !isWatch;\n  const startTime = performance.now();\n  const colorModes: ('dark' | 'light')[] = ['dark']; // Light mode is already in :root\n\n  // Load config if provided, otherwise use default\n  let tokensConfig: UniversalTokensConfig = defaultTokensConfig;\n  if (options.configPath) {\n    const loadedConfig = await loadConfigFile<UniversalTokensConfig>(options.configPath);\n    if (loadedConfig) {\n      tokensConfig = loadedConfig;\n    } else if (shouldLogStats) {\n      spinStop('⚠️', `Config file not found: ${options.configPath}, using defaults`);\n    }\n  }\n\n  // Extract variant defaults from config for auto-variant class generation\n  const variantDefaults = extractVariantDefaults(tokensConfig);\n  const runtimeConfigValues = extractRuntimeConfigValues(tokensConfig);\n\n  const resolvedEntries = resolveEntryPaths(options.entry, options.workspaceDir);\n  const entryDirs = resolvedEntries.map((entry) => entry.absolutePath);\n  const scanResult = await scanDirectoriesForSafelist(\n    entryDirs,\n    colorModes,\n    options.variants,\n    options.autoVariants,\n    options.componentData,\n    variantDefaults,\n    runtimeConfigValues,\n  );\n\n  const totalFilesScanned = scanResult.filesScanned;\n  const allClasses: string[] = [...scanResult.safelist];\n  const allComponents = new Set<string>(scanResult.components);\n  const packageDirs: string[] = [\n    ...new Set(\n      resolvedEntries.map((entry) =>\n        entry.kind === 'directory' ? entry.absolutePath : entry.watchDirectory,\n      ),\n    ),\n  ];\n\n  // Add color mode classes\n  const fullSafelist = [\n    ...allClasses,\n    ...getThemeAndScaleClasses(colorModes),\n    ...getInternalSafelistClasses(),\n  ];\n  const finalSafelist = deduplicateSafelist(fullSafelist);\n\n  // Generate CSS (Tailwind will scan entry dir for arbitrary classes on className props)\n  const cssResult = await generateCSS(finalSafelist, tokensConfig, {\n    scope: options.scope,\n    contentDir: entryDirs,\n    safeVarPrefixes: [\n      ...getMotionVarPrefixes(options.componentData, [...allComponents]),\n      ...getConfigurableCssVariables(),\n    ],\n  });\n\n  // Write output\n  const outputPath = path.isAbsolute(options.outFile)\n    ? options.outFile\n    : path.join(options.workspaceDir, options.outFile);\n  const outputDir = path.dirname(outputPath);\n\n  if (!fs.existsSync(outputDir)) {\n    fs.mkdirSync(outputDir, { recursive: true });\n  }\n\n  fs.writeFileSync(outputPath, cssResult.css);\n\n  const duration = Math.round(performance.now() - startTime);\n\n  if (shouldLogStats) {\n    printSimpleModeStats({\n      cwd: options.workspaceDir,\n      outputPath,\n      totalFilesScanned,\n      scannedFilePaths: scanResult.filePaths,\n      classCount: cssResult.classCount,\n      sizeBytes: cssResult.sizeBytes,\n      sizeGzipBytes: cssResult.sizeGzipBytes,\n      duration,\n      scope: options.scope,\n      verbose: options.verbose,\n      optimizationStats: cssResult.optimizationStats,\n      print,\n      magenta,\n      cyan,\n      yellow,\n    });\n  }\n\n  return { success: true, outputPath, packageDirs };\n};\n\nexport { generateCSS, generateSimpleModeCSS };\nexport type { UDSCSSOptions };\n"],"mappings":"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"}
+{"version":3,"file":"generate.js","names":[],"sources":["../../src/css/generate.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { gzipSync } from 'node:zlib';\n\nimport { cyan, magenta, print, spinStop, yellow } from '@yahoo/uds-cli/lib';\nimport type { UniversalTokensConfig } from '@yahoo/uds-config';\nimport { defaultTokensConfig } from '@yahoo/uds-config';\nimport postcss from 'postcss';\nimport type { SafelistConfig } from 'tailwindcss/types/config';\n\nimport type { SerializedComponentInfo } from '../commands/generateComponentData';\nimport {\n  deduplicateSafelist,\n  getInternalSafelistClasses,\n  getThemeAndScaleClasses,\n} from '../purger/optimized';\nimport type { EntryValue } from '../utils/entryPoints';\nimport { resolveEntryPaths } from '../utils/entryPoints';\nimport {\n  applyScopedColorModeFix,\n  buildPostcssPlugins,\n  createTailwindPlugin,\n  getCssFeatureFlags,\n  getInternalIconModeCss,\n  optimizeGeneratedCss,\n  printSimpleModeStats,\n} from './generate.helpers';\nimport { loadConfigFile, scanDirectoriesForSafelist } from './nodeUtils';\nimport { measureAsync } from './perf';\nimport type { UDSCSSOptimizationOptions, UDSCSSVarSafelistPattern } from './theme';\nimport {\n  extractRuntimeConfigValues,\n  extractVariantDefaults,\n  getConfigurableCssVariables,\n  getMotionVarPrefixes,\n} from './utils';\n\n/**\n * Result from generating CSS\n */\ninterface CSSResult {\n  css: string;\n  sizeBytes: number;\n  sizeGzipBytes: number;\n  classCount: number;\n  optimizationStats?: {\n    originalSize: number;\n    originalSizeGzip: number;\n    fontFacesRemoved: number;\n    emptyRulesRemoved: number;\n    validationErrors: string[];\n  };\n}\n\n/**\n * CSS generation options for uds.theme.ts\n */\ninterface UDSCSSOptions {\n  /** CSS scope wrapper class (optional) */\n  scope?: string;\n  /** Safelist of CSS classes to always include */\n  safelist?: SafelistConfig[];\n  /** CSS optimization settings */\n  optimization?: UDSCSSOptimizationOptions;\n  /** Include Tailwind preflight/reset styles (default: true) */\n  preflight?: boolean;\n  /** Include @font-face declarations (default: true) */\n  fontFaceDeclarations?: boolean;\n  /** Debounce delay (ms) for watch mode regenerations */\n  watchDebounce?: number;\n}\n\n/**\n * Options for generateCSS function\n */\ninterface GenerateCSSOptions {\n  /** CSS scope wrapper class */\n  scope?: string;\n  /** Directory to scan for arbitrary Tailwind classes (className props) */\n  contentDir?: string | string[];\n  /** CSS generation options from theme config */\n  cssOptions?: UDSCSSOptions;\n  /** Reference CSS to deduplicate font-faces against (for scoped CSS) */\n  referenceCss?: string;\n  /** CSS variable prefixes or patterns to preserve during pruning */\n  safeVarPrefixes?: UDSCSSVarSafelistPattern[];\n}\n\nconst normalizeScope = (scope?: string): string | undefined => {\n  const trimmedScope = scope?.trim();\n  return trimmedScope ? trimmedScope : undefined;\n};\n\nconst getArbitrarySafelistRawContent = (safelist: SafelistConfig[]): string[] => {\n  const arbitraryClasses = safelist.filter(\n    (entry): entry is string => typeof entry === 'string' && entry.includes('['),\n  );\n\n  if (arbitraryClasses.length === 0) {\n    return [];\n  }\n\n  return [`<div class=\"${arbitraryClasses.join(' ')}\"></div>`];\n};\n\n/**\n * Generate CSS from a safelist using Tailwind + PostCSS\n * @param safelist - UDS component classes to include\n * @param config - Token configuration\n * @param options - Additional options\n */\nconst generateCSS = async (\n  safelist: SafelistConfig[],\n  config: UniversalTokensConfig,\n  options?: GenerateCSSOptions,\n): Promise<CSSResult> => {\n  // Do we need base?\n  const sourceCSS = '@tailwind base; @tailwind components; @tailwind utilities';\n\n  const contentDir = options?.contentDir ?? path.join(process.cwd(), 'src');\n  const cssFlags = getCssFeatureFlags(options?.cssOptions);\n  const optimizationConfig = options?.cssOptions?.optimization;\n  const scopeClass = normalizeScope(options?.scope) ?? normalizeScope(options?.cssOptions?.scope);\n  const twPlugin = createTailwindPlugin({\n    contentDir,\n    rawContents: getArbitrarySafelistRawContent(safelist),\n    safelist,\n    config,\n    enablePreflight: cssFlags.enablePreflight,\n    enableFontFaceDeclarations: cssFlags.enableFontFaceDeclarations,\n  });\n  const plugins = buildPostcssPlugins({\n    tailwindPlugin: twPlugin,\n    shouldPruneVars: cssFlags.shouldPruneVars,\n    safeVarPrefixes: options?.safeVarPrefixes ?? [],\n    scopeClass,\n  });\n\n  const result = await measureAsync('gen:postcss', () =>\n    postcss(plugins).process(sourceCSS, { from: undefined }),\n  );\n  let css = await measureAsync('gen:scoped-color-fix', () =>\n    applyScopedColorModeFix(result.css, scopeClass),\n  );\n  if (!css.includes('uds-light-mode-icon') || !css.includes('uds-dark-mode-icon')) {\n    css = `${css} ${getInternalIconModeCss(scopeClass)}`.trim();\n  }\n  const optimizedCss = await measureAsync('gen:optimize', () =>\n    optimizeGeneratedCss({\n      css,\n      shouldOptimize: cssFlags.shouldOptimize,\n      optimizationConfig,\n      referenceCss: options?.referenceCss,\n      scopeClass,\n    }),\n  );\n  css = optimizedCss.css;\n\n  const sizeBytes = Buffer.byteLength(css, 'utf8');\n  const sizeGzipBytes = gzipSync(css).length;\n\n  return {\n    css,\n    sizeBytes,\n    sizeGzipBytes,\n    classCount: safelist.length,\n    optimizationStats: optimizedCss.optimizationStats,\n  };\n};\n\n/**\n * Generate CSS in simple mode (no uds.theme.ts)\n */\nconst generateSimpleModeCSS = async (options: {\n  workspaceDir: string;\n  entry: EntryValue;\n  outFile: string;\n  variants: Record<string, Record<string, string>>;\n  autoVariants: Record<string, Record<string, string>>;\n  componentData: Record<string, SerializedComponentInfo>;\n  scope?: string;\n  configPath?: string;\n  isWatch?: boolean;\n  silent?: boolean;\n  verbose?: boolean;\n}): Promise<{ success: boolean; outputPath: string; packageDirs?: string[] }> => {\n  const isWatch = options.isWatch === true;\n  const isSilent = options.silent === true;\n  const shouldLogStats = !isSilent && !isWatch;\n  const startTime = performance.now();\n  const colorModes: ('dark' | 'light')[] = ['dark']; // Light mode is already in :root\n\n  // Load config if provided, otherwise use default\n  let tokensConfig: UniversalTokensConfig = defaultTokensConfig;\n  if (options.configPath) {\n    const loadedConfig = await loadConfigFile<UniversalTokensConfig>(options.configPath);\n    if (loadedConfig) {\n      tokensConfig = loadedConfig;\n    } else if (shouldLogStats) {\n      spinStop('⚠️', `Config file not found: ${options.configPath}, using defaults`);\n    }\n  }\n\n  // Extract variant defaults from config for auto-variant class generation\n  const variantDefaults = extractVariantDefaults(tokensConfig);\n  const runtimeConfigValues = extractRuntimeConfigValues(tokensConfig);\n\n  const resolvedEntries = resolveEntryPaths(options.entry, options.workspaceDir);\n  const entryDirs = resolvedEntries.map((entry) => entry.absolutePath);\n  const scanResult = await scanDirectoriesForSafelist(\n    entryDirs,\n    colorModes,\n    options.variants,\n    options.autoVariants,\n    options.componentData,\n    variantDefaults,\n    runtimeConfigValues,\n  );\n\n  const totalFilesScanned = scanResult.filesScanned;\n  const allClasses: string[] = [...scanResult.safelist];\n  const allComponents = new Set<string>(scanResult.components);\n  const packageDirs: string[] = [\n    ...new Set(\n      resolvedEntries.map((entry) =>\n        entry.kind === 'directory' ? entry.absolutePath : entry.watchDirectory,\n      ),\n    ),\n  ];\n\n  // Add color mode classes\n  const fullSafelist = [\n    ...allClasses,\n    ...getThemeAndScaleClasses(colorModes),\n    ...getInternalSafelistClasses(),\n  ];\n  const finalSafelist = deduplicateSafelist(fullSafelist);\n\n  // Generate CSS (Tailwind will scan entry dir for arbitrary classes on className props)\n  const cssResult = await generateCSS(finalSafelist, tokensConfig, {\n    scope: options.scope,\n    contentDir: entryDirs,\n    safeVarPrefixes: [\n      ...getMotionVarPrefixes(options.componentData, [...allComponents]),\n      ...getConfigurableCssVariables(),\n    ],\n  });\n\n  // Write output\n  const outputPath = path.isAbsolute(options.outFile)\n    ? options.outFile\n    : path.join(options.workspaceDir, options.outFile);\n  const outputDir = path.dirname(outputPath);\n\n  if (!fs.existsSync(outputDir)) {\n    fs.mkdirSync(outputDir, { recursive: true });\n  }\n\n  fs.writeFileSync(outputPath, cssResult.css);\n\n  const duration = Math.round(performance.now() - startTime);\n\n  if (shouldLogStats) {\n    printSimpleModeStats({\n      cwd: options.workspaceDir,\n      outputPath,\n      totalFilesScanned,\n      scannedFilePaths: scanResult.filePaths,\n      classCount: cssResult.classCount,\n      sizeBytes: cssResult.sizeBytes,\n      sizeGzipBytes: cssResult.sizeGzipBytes,\n      duration,\n      scope: options.scope,\n      verbose: options.verbose,\n      optimizationStats: cssResult.optimizationStats,\n      print,\n      magenta,\n      cyan,\n      yellow,\n    });\n  }\n\n  return { success: true, outputPath, packageDirs };\n};\n\nexport { generateCSS, generateSimpleModeCSS };\nexport type { UDSCSSOptions };\n"],"mappings":"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"}

package/dist/tailwind/dist/css/nodeUtils.cjs

@@ -2,6 +2,7 @@
 const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
 const require_colors = require("../cli/dist/lib/colors.cjs");
 const require_print = require("../cli/dist/lib/print.cjs");
+const require_perf = require("./perf.cjs");
 const require_purgeFromCode = require("../purger/optimized/purgeFromCode.cjs");
 const require_entryPoints = require("../utils/entryPoints.cjs");
 let node_fs = require("node:fs");
@@ -22,14 +23,23 @@ const loadConfigFile = async (configPath) => {
 		throw new Error(`Failed to load config file: ${absolutePath}\n${error instanceof Error ? error.message : "Unknown error"}`);
 	}
 };
-const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
-	const files = (await (0, fast_glob.default)("**/*.{js,jsx,mjs,cjs,ts,tsx}", {
+const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false, pool) => {
+	const files = await require_perf.measureAsync("scan:glob", () => (0, fast_glob.default)("**/*.{js,jsx,mjs,cjs,ts,tsx}", {
 		cwd: dir,
 		absolute: true,
 		ignore: ["**/node_modules/**"]
-	})).sort((left, right) => left.localeCompare(right));
-	const results = await Promise.all(files.map(async (filePath) => {
-		return require_purgeFromCode.purgeFromCodeOptimized(node_fs.default.readFileSync(filePath, "utf-8"), {
+	}).then((f) => f.sort((left, right) => left.localeCompare(right))));
+	const processFile = (filePath) => {
+		const code = node_fs.default.readFileSync(filePath, "utf-8");
+		if (pool) return pool.processFile({
+			code,
+			filePath,
+			colorModes,
+			variantDefaults,
+			runtimeConfigValues,
+			includeAllClassNamePrimitives
+		});
+		return require_purgeFromCode.purgeFromCodeOptimized(code, {
 			colorModes,
 			variantDefaults,
 			runtimeConfigValues,
@@ -39,7 +49,8 @@ const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants,
 			includeAllClassNamePrimitives,
 			filePath
 		});
-	}));
+	};
+	const results = await require_perf.measureAsync("scan:purge-all-files", () => Promise.all(files.map(processFile)));
 	const allClasses = results.flatMap((result) => result.safelist);
 	const allComponents = new Set(results.flatMap((result) => result.components));
 	const filesWithComponents = results.filter((result) => result.components.length > 0).length;
@@ -69,10 +80,10 @@ const scanFileForSafelist = async (filePath, colorModes, variants, autoVariants,
 		filePaths: [filePath]
 	};
 };
-const scanDirectoriesForSafelist = async (dirs, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
+const scanDirectoriesForSafelist = async (dirs, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false, pool) => {
 	const results = await Promise.all(dirs.map((dir) => {
 		if (node_fs.default.existsSync(dir) && node_fs.default.statSync(dir).isFile()) return scanFileForSafelist(dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives);
-		return scanDirectoryForSafelist(dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives);
+		return scanDirectoryForSafelist(dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives, pool);
 	}));
 	return {
 		safelist: results.flatMap((result) => result.safelist),

package/dist/tailwind/dist/css/nodeUtils.js

@@ -1,6 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
 import { cyan, green, magenta, red } from "../cli/dist/lib/colors.js";
 import { print } from "../cli/dist/lib/print.js";
+import { measureAsync } from "./perf.js";
 import { purgeFromCodeOptimized } from "../purger/optimized/purgeFromCode.js";
 import { formatEntryValue } from "../utils/entryPoints.js";
 import fs from "node:fs";
@@ -18,14 +19,23 @@ const loadConfigFile = async (configPath) => {
 		throw new Error(`Failed to load config file: ${absolutePath}\n${error instanceof Error ? error.message : "Unknown error"}`);
 	}
 };
-const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
-	const files = (await fg("**/*.{js,jsx,mjs,cjs,ts,tsx}", {
+const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false, pool) => {
+	const files = await measureAsync("scan:glob", () => fg("**/*.{js,jsx,mjs,cjs,ts,tsx}", {
 		cwd: dir,
 		absolute: true,
 		ignore: ["**/node_modules/**"]
-	})).sort((left, right) => left.localeCompare(right));
-	const results = await Promise.all(files.map(async (filePath) => {
-		return purgeFromCodeOptimized(fs.readFileSync(filePath, "utf-8"), {
+	}).then((f) => f.sort((left, right) => left.localeCompare(right))));
+	const processFile = (filePath) => {
+		const code = fs.readFileSync(filePath, "utf-8");
+		if (pool) return pool.processFile({
+			code,
+			filePath,
+			colorModes,
+			variantDefaults,
+			runtimeConfigValues,
+			includeAllClassNamePrimitives
+		});
+		return purgeFromCodeOptimized(code, {
 			colorModes,
 			variantDefaults,
 			runtimeConfigValues,
@@ -35,7 +45,8 @@ const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants,
 			includeAllClassNamePrimitives,
 			filePath
 		});
-	}));
+	};
+	const results = await measureAsync("scan:purge-all-files", () => Promise.all(files.map(processFile)));
 	const allClasses = results.flatMap((result) => result.safelist);
 	const allComponents = new Set(results.flatMap((result) => result.components));
 	const filesWithComponents = results.filter((result) => result.components.length > 0).length;
@@ -65,10 +76,10 @@ const scanFileForSafelist = async (filePath, colorModes, variants, autoVariants,
 		filePaths: [filePath]
 	};
 };
-const scanDirectoriesForSafelist = async (dirs, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
+const scanDirectoriesForSafelist = async (dirs, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false, pool) => {
 	const results = await Promise.all(dirs.map((dir) => {
 		if (fs.existsSync(dir) && fs.statSync(dir).isFile()) return scanFileForSafelist(dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives);
-		return scanDirectoryForSafelist(dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives);
+		return scanDirectoryForSafelist(dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives, pool);
 	}));
 	return {
 		safelist: results.flatMap((result) => result.safelist),

package/dist/tailwind/dist/css/nodeUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodeUtils.js","names":[],"sources":["../../src/css/nodeUtils.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\n\nimport { cyan, green, magenta, print, red } from '@yahoo/uds-cli/lib';\nimport fg from 'fast-glob';\n\nimport type { SerializedComponentInfo } from '../commands/generateComponentData';\nimport type { RuntimeConfigValues, VariantDefaults } from '../purger/optimized/purgeFromCode';\nimport { purgeFromCodeOptimized } from '../purger/optimized/purgeFromCode';\nimport type { EntryValue } from '../utils/entryPoints';\nimport { formatEntryValue } from '../utils/entryPoints';\n\ntype SafelistScanResult = {\n  safelist: string[];\n  components: string[];\n  filesScanned: number;\n  filesWithComponents: number;\n  filePaths: string[];\n};\n\nconst loadConfigFile = async <T>(configPath: string): Promise<T | null> => {\n  const absolutePath = path.isAbsolute(configPath)\n    ? configPath\n    : path.join(process.cwd(), configPath);\n\n  if (!fs.existsSync(absolutePath)) {\n    return null;\n  }\n\n  try {\n    const module = await import(absolutePath);\n    return module.default ?? module.config ?? module;\n  } catch (error) {\n    throw new Error(\n      `Failed to load config file: ${absolutePath}\\n${error instanceof Error ? error.message : 'Unknown error'}`,\n    );\n  }\n};\n\nconst scanDirectoryForSafelist = async (\n  dir: string,\n  colorModes: ('dark' | 'light')[],\n  variants: Record<string, Record<string, string>>,\n  autoVariants: Record<string, Record<string, string>>,\n  componentData: Record<string, SerializedComponentInfo>,\n  variantDefaults?: VariantDefaults,\n  runtimeConfigValues?: RuntimeConfigValues,\n  includeAllClassNamePrimitives = false,\n): Promise<SafelistScanResult> => {\n  const files = (\n    await fg('**/*.{js,jsx,mjs,cjs,ts,tsx}', {\n      cwd: dir,\n      absolute: true,\n      ignore: ['**/node_modules/**'],\n    })\n  ).sort((left, right) => left.localeCompare(right));\n\n  const results = await Promise.all(\n    files.map(async (filePath) => {\n      const code = fs.readFileSync(filePath, 'utf-8');\n      return purgeFromCodeOptimized(code, {\n        colorModes,\n        variantDefaults,\n        runtimeConfigValues,\n        variants,\n        autoVariants,\n        componentData,\n        includeAllClassNamePrimitives,\n        filePath,\n      });\n    }),\n  );\n\n  const allClasses = results.flatMap((result) => result.safelist);\n  const allComponents = new Set(results.flatMap((result) => result.components));\n  const filesWithComponents = results.filter((result) => result.components.length > 0).length;\n\n  return {\n    safelist: allClasses,\n    components: [...allComponents],\n    filesScanned: files.length,\n    filesWithComponents,\n    filePaths: files,\n  };\n};\n\nconst scanFileForSafelist = async (\n  filePath: string,\n  colorModes: ('dark' | 'light')[],\n  variants: Record<string, Record<string, string>>,\n  autoVariants: Record<string, Record<string, string>>,\n  componentData: Record<string, SerializedComponentInfo>,\n  variantDefaults?: VariantDefaults,\n  runtimeConfigValues?: RuntimeConfigValues,\n  includeAllClassNamePrimitives = false,\n): Promise<SafelistScanResult> => {\n  const code = fs.readFileSync(filePath, 'utf-8');\n  const result = await purgeFromCodeOptimized(code, {\n    colorModes,\n    variantDefaults,\n    runtimeConfigValues,\n    variants,\n    autoVariants,\n    componentData,\n    includeAllClassNamePrimitives,\n  });\n\n  return {\n    safelist: result.safelist,\n    components: result.components,\n    filesScanned: 1,\n    filesWithComponents: result.components.length > 0 ? 1 : 0,\n    filePaths: [filePath],\n  };\n};\n\nconst scanDirectoriesForSafelist = async (\n  dirs: string[],\n  colorModes: ('dark' | 'light')[],\n  variants: Record<string, Record<string, string>>,\n  autoVariants: Record<string, Record<string, string>>,\n  componentData: Record<string, SerializedComponentInfo>,\n  variantDefaults?: VariantDefaults,\n  runtimeConfigValues?: RuntimeConfigValues,\n  includeAllClassNamePrimitives = false,\n): Promise<SafelistScanResult> => {\n  const results = await Promise.all(\n    dirs.map((dir) => {\n      if (fs.existsSync(dir) && fs.statSync(dir).isFile()) {\n        return scanFileForSafelist(\n          dir,\n          colorModes,\n          variants,\n          autoVariants,\n          componentData,\n          variantDefaults,\n          runtimeConfigValues,\n          includeAllClassNamePrimitives,\n        );\n      }\n\n      return scanDirectoryForSafelist(\n        dir,\n        colorModes,\n        variants,\n        autoVariants,\n        componentData,\n        variantDefaults,\n        runtimeConfigValues,\n        includeAllClassNamePrimitives,\n      );\n    }),\n  );\n\n  return {\n    safelist: results.flatMap((result) => result.safelist),\n    components: [...new Set(results.flatMap((result) => result.components))],\n    filesScanned: results.reduce((total, result) => total + result.filesScanned, 0),\n    filesWithComponents: results.reduce((total, result) => total + result.filesWithComponents, 0),\n    filePaths: results\n      .flatMap((result) => result.filePaths)\n      .sort((left, right) => left.localeCompare(right)),\n  };\n};\n\nconst findMonorepoRoot = (startDir: string): string | null => {\n  const findUp = (currentDir: string): string | null => {\n    if (fs.existsSync(path.join(currentDir, 'packages'))) {\n      return currentDir;\n    }\n\n    const parentDir = path.dirname(currentDir);\n    return parentDir === currentDir ? null : findUp(parentDir);\n  };\n\n  return findUp(startDir);\n};\n\nconst readPackageName = (packageJsonPath: string): string | null => {\n  try {\n    const pkgJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as { name?: string };\n    return typeof pkgJson.name === 'string' ? pkgJson.name : null;\n  } catch {\n    return null;\n  }\n};\n\nconst findPackageRootFromResolvedEntry = (\n  resolvedEntryPath: string,\n  packageName: string,\n): string | null => {\n  let currentPath = fs.statSync(resolvedEntryPath).isDirectory()\n    ? resolvedEntryPath\n    : path.dirname(resolvedEntryPath);\n\n  while (true) {\n    const packageJsonPath = path.join(currentPath, 'package.json');\n    if (fs.existsSync(packageJsonPath) && readPackageName(packageJsonPath) === packageName) {\n      return currentPath;\n    }\n\n    const parentPath = path.dirname(currentPath);\n    if (parentPath === currentPath) {\n      return null;\n    }\n\n    currentPath = parentPath;\n  }\n};\n\nconst findPackageRootInNodeModules = (startDir: string, packageName: string): string | null => {\n  let currentDir = startDir;\n\n  while (true) {\n    const packageJsonPath = path.join(currentDir, 'node_modules', packageName, 'package.json');\n    if (fs.existsSync(packageJsonPath)) {\n      return path.dirname(packageJsonPath);\n    }\n\n    const parentDir = path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      return null;\n    }\n\n    currentDir = parentDir;\n  }\n};\n\nconst resolvePackageRoot = (workspaceDir: string, packageName: string): string | null => {\n  const requireFromWorkspace = createRequire(path.join(workspaceDir, 'package.json'));\n\n  try {\n    const resolvedPackageJson = requireFromWorkspace.resolve(\n      path.join(packageName, 'package.json'),\n    );\n    return path.dirname(resolvedPackageJson);\n  } catch {\n    try {\n      const resolvedPackageEntry = requireFromWorkspace.resolve(packageName);\n      const packageRoot = findPackageRootFromResolvedEntry(resolvedPackageEntry, packageName);\n      if (packageRoot) {\n        return packageRoot;\n      }\n    } catch {\n      // Fall through to explicit node_modules lookup below.\n    }\n\n    return findPackageRootInNodeModules(workspaceDir, packageName);\n  }\n};\n\ntype PackageJsonShape = {\n  uds?: {\n    scope?: string;\n  };\n};\n\nconst findPackageRootInMonorepo = (monorepoRoot: string, packageName: string): string | null => {\n  const packageJsonPaths = fg.sync('packages/**/package.json', {\n    cwd: monorepoRoot,\n    absolute: true,\n    ignore: ['**/node_modules/**', '**/dist/**'],\n  });\n\n  const matchingPath = packageJsonPaths.find((pkgJsonPath) => {\n    return readPackageName(pkgJsonPath) === packageName;\n  });\n\n  return matchingPath ? path.dirname(matchingPath) : null;\n};\n\nconst findPackageRoot = (packageName: string): string | null => {\n  const workspaceDir = process.cwd();\n  const monorepoRoot = findMonorepoRoot(workspaceDir);\n\n  let packageRoot = resolvePackageRoot(workspaceDir, packageName);\n  if (!packageRoot && monorepoRoot) {\n    packageRoot = findPackageRootInMonorepo(monorepoRoot, packageName);\n  }\n\n  return packageRoot;\n};\n\nconst buildPackageSourceCandidates = (\n  workspaceDir: string,\n  packageName: string,\n  packageRoot: string | null,\n): string[] => {\n  return [\n    packageRoot ? path.join(packageRoot, 'src') : null,\n    packageRoot ? path.join(packageRoot, 'lib') : null,\n    packageRoot ? path.join(packageRoot, 'dist') : null,\n    packageRoot,\n    path.join(workspaceDir, 'node_modules', packageName, 'src'),\n    path.join(workspaceDir, 'node_modules', packageName, 'lib'),\n    path.join(workspaceDir, 'node_modules', packageName, 'dist'),\n    path.join(workspaceDir, 'node_modules', packageName),\n  ].filter(Boolean) as string[];\n};\n\nconst getFirstExistingPath = (candidates: string[]): string | null =>\n  candidates.find((candidate) => fs.existsSync(candidate)) ?? null;\n\nconst findPackageSourceDir = (packageName: string): string | null => {\n  const workspaceDir = process.cwd();\n  const packageRoot = findPackageRoot(packageName);\n\n  return getFirstExistingPath(buildPackageSourceCandidates(workspaceDir, packageName, packageRoot));\n};\n\nconst getPackageUdsScope = (packageName: string): string | null => {\n  const packageRoot = findPackageRoot(packageName);\n  if (!packageRoot) {\n    return null;\n  }\n\n  const packageJsonPath = path.join(packageRoot, 'package.json');\n  if (!fs.existsSync(packageJsonPath)) {\n    return null;\n  }\n\n  try {\n    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as PackageJsonShape;\n    const scope = packageJson.uds?.scope;\n    return typeof scope === 'string' && scope.trim().length > 0 ? scope.trim() : null;\n  } catch {\n    return null;\n  }\n};\n\nconst scaffoldThemeConfig = async (options: {\n  outputPath?: string;\n  configPath?: string;\n  entry?: EntryValue;\n  force?: boolean;\n}): Promise<void> => {\n  const workspaceDir = process.cwd();\n  const outputPath = options.outputPath ?? 'uds.theme.ts';\n  const absoluteOutputPath = path.isAbsolute(outputPath)\n    ? outputPath\n    : path.join(workspaceDir, outputPath);\n\n  if (fs.existsSync(absoluteOutputPath) && !options.force) {\n    print(red(`Error: ${outputPath} already exists. Use --force to overwrite.`));\n    process.exitCode = 1;\n    return;\n  }\n\n  const configPath = options.configPath ?? './uds.config.ts';\n  const entry = options.entry ?? './src';\n  const serializedEntry = formatEntryValue(entry);\n\n  const template = `import { defineTheme } from '@yahoo/uds';\n\n/**\n * UDS Theme Configuration\n * \n * This file configures CSS generation for your app and shared packages.\n * Run \\`uds css\\` to generate optimized CSS.\n */\nexport default defineTheme({\n  // Path to your uds.config.ts file\n  config: '${configPath}',\n\n  // Entry directory or .tsx file path for scanning your app code\n  entry: ${serializedEntry},\n\n  // Color modes to include (light mode is always in :root)\n  colorModes: ['dark'],\n\n  // Packages that inherit your app's theme (merged into main uds.css)\n  // inherit: ['@your-org/shared-ui'],\n\n  // Packages that generate separate scoped CSS outputs.\n  // Scope class is discovered from each package.json uds.scope.\n  // When entry is omitted, the package is scanned the same way as inherit.\n  // scoped: {\n  //   '@your-org/shared-ui': './packages/shared-ui/uds.config.ts'\n  // }\n  //\n  // Or use the expanded form for custom output paths:\n  // scoped: {\n  //   '@your-org/shared-ui': {\n  //     config: './packages/shared-ui/uds.config.ts',\n  //     entry: './src',\n  //     // outFile defaults to dist/shared-ui.css\n  //     outFile: 'dist/shared-ui.css'\n  //   },\n  // },\n\n  // CSS generation options (all optional)\n  // css: {\n  //   safelist: [],\n  //   preflight: true,\n  //   fontFaceDeclarations: true,\n  //   optimization: {\n  //     removeUnusedFonts: false,\n  //     removeEmptyRules: true,\n  //     deduplicateScopedCss: true\n  //   }\n  // }\n});\n`;\n\n  fs.writeFileSync(absoluteOutputPath, template);\n\n  print('');\n  print(green('✅ Created uds.theme.ts'));\n  print('');\n  print(`${magenta('Next steps:')}`);\n  print(`   1. Review and customize ${cyan(outputPath)}`);\n  print(`   2. Run ${cyan('uds css')} to generate CSS`);\n  print('');\n};\n\nexport {\n  findPackageRoot,\n  findPackageSourceDir,\n  getPackageUdsScope,\n  loadConfigFile,\n  scaffoldThemeConfig,\n  scanDirectoriesForSafelist,\n  scanDirectoryForSafelist,\n};\nexport type { SafelistScanResult };\n"],"mappings":"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"}
+{"version":3,"file":"nodeUtils.js","names":[],"sources":["../../src/css/nodeUtils.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\n\nimport { cyan, green, magenta, print, red } from '@yahoo/uds-cli/lib';\nimport fg from 'fast-glob';\n\nimport type { SerializedComponentInfo } from '../commands/generateComponentData';\nimport type { RuntimeConfigValues, VariantDefaults } from '../purger/optimized/purgeFromCode';\nimport { purgeFromCodeOptimized } from '../purger/optimized/purgeFromCode';\nimport type { EntryValue } from '../utils/entryPoints';\nimport { formatEntryValue } from '../utils/entryPoints';\nimport { measureAsync } from './perf';\nimport type { WorkerPool } from './workerPool';\n\ntype SafelistScanResult = {\n  safelist: string[];\n  components: string[];\n  filesScanned: number;\n  filesWithComponents: number;\n  filePaths: string[];\n};\n\nconst loadConfigFile = async <T>(configPath: string): Promise<T | null> => {\n  const absolutePath = path.isAbsolute(configPath)\n    ? configPath\n    : path.join(process.cwd(), configPath);\n\n  if (!fs.existsSync(absolutePath)) {\n    return null;\n  }\n\n  try {\n    const module = await import(absolutePath);\n    return module.default ?? module.config ?? module;\n  } catch (error) {\n    throw new Error(\n      `Failed to load config file: ${absolutePath}\\n${error instanceof Error ? error.message : 'Unknown error'}`,\n    );\n  }\n};\n\nconst scanDirectoryForSafelist = async (\n  dir: string,\n  colorModes: ('dark' | 'light')[],\n  variants: Record<string, Record<string, string>>,\n  autoVariants: Record<string, Record<string, string>>,\n  componentData: Record<string, SerializedComponentInfo>,\n  variantDefaults?: VariantDefaults,\n  runtimeConfigValues?: RuntimeConfigValues,\n  includeAllClassNamePrimitives = false,\n  pool?: WorkerPool,\n): Promise<SafelistScanResult> => {\n  const files = await measureAsync('scan:glob', () =>\n    fg('**/*.{js,jsx,mjs,cjs,ts,tsx}', {\n      cwd: dir,\n      absolute: true,\n      ignore: ['**/node_modules/**'],\n    }).then((f) => f.sort((left, right) => left.localeCompare(right))),\n  );\n\n  const processFile = (filePath: string) => {\n    const code = fs.readFileSync(filePath, 'utf-8');\n    if (pool) {\n      return pool.processFile({\n        code,\n        filePath,\n        colorModes,\n        variantDefaults,\n        runtimeConfigValues,\n        includeAllClassNamePrimitives,\n      });\n    }\n    return purgeFromCodeOptimized(code, {\n      colorModes,\n      variantDefaults,\n      runtimeConfigValues,\n      variants,\n      autoVariants,\n      componentData,\n      includeAllClassNamePrimitives,\n      filePath,\n    });\n  };\n\n  const results = await measureAsync('scan:purge-all-files', () =>\n    Promise.all(files.map(processFile)),\n  );\n\n  const allClasses = results.flatMap((result) => result.safelist);\n  const allComponents = new Set(results.flatMap((result) => result.components));\n  const filesWithComponents = results.filter((result) => result.components.length > 0).length;\n\n  return {\n    safelist: allClasses,\n    components: [...allComponents],\n    filesScanned: files.length,\n    filesWithComponents,\n    filePaths: files,\n  };\n};\n\nconst scanFileForSafelist = async (\n  filePath: string,\n  colorModes: ('dark' | 'light')[],\n  variants: Record<string, Record<string, string>>,\n  autoVariants: Record<string, Record<string, string>>,\n  componentData: Record<string, SerializedComponentInfo>,\n  variantDefaults?: VariantDefaults,\n  runtimeConfigValues?: RuntimeConfigValues,\n  includeAllClassNamePrimitives = false,\n): Promise<SafelistScanResult> => {\n  const code = fs.readFileSync(filePath, 'utf-8');\n  const result = await purgeFromCodeOptimized(code, {\n    colorModes,\n    variantDefaults,\n    runtimeConfigValues,\n    variants,\n    autoVariants,\n    componentData,\n    includeAllClassNamePrimitives,\n  });\n\n  return {\n    safelist: result.safelist,\n    components: result.components,\n    filesScanned: 1,\n    filesWithComponents: result.components.length > 0 ? 1 : 0,\n    filePaths: [filePath],\n  };\n};\n\nconst scanDirectoriesForSafelist = async (\n  dirs: string[],\n  colorModes: ('dark' | 'light')[],\n  variants: Record<string, Record<string, string>>,\n  autoVariants: Record<string, Record<string, string>>,\n  componentData: Record<string, SerializedComponentInfo>,\n  variantDefaults?: VariantDefaults,\n  runtimeConfigValues?: RuntimeConfigValues,\n  includeAllClassNamePrimitives = false,\n  pool?: WorkerPool,\n): Promise<SafelistScanResult> => {\n  const results = await Promise.all(\n    dirs.map((dir) => {\n      if (fs.existsSync(dir) && fs.statSync(dir).isFile()) {\n        return scanFileForSafelist(\n          dir,\n          colorModes,\n          variants,\n          autoVariants,\n          componentData,\n          variantDefaults,\n          runtimeConfigValues,\n          includeAllClassNamePrimitives,\n        );\n      }\n\n      return scanDirectoryForSafelist(\n        dir,\n        colorModes,\n        variants,\n        autoVariants,\n        componentData,\n        variantDefaults,\n        runtimeConfigValues,\n        includeAllClassNamePrimitives,\n        pool,\n      );\n    }),\n  );\n\n  return {\n    safelist: results.flatMap((result) => result.safelist),\n    components: [...new Set(results.flatMap((result) => result.components))],\n    filesScanned: results.reduce((total, result) => total + result.filesScanned, 0),\n    filesWithComponents: results.reduce((total, result) => total + result.filesWithComponents, 0),\n    filePaths: results\n      .flatMap((result) => result.filePaths)\n      .sort((left, right) => left.localeCompare(right)),\n  };\n};\n\nconst findMonorepoRoot = (startDir: string): string | null => {\n  const findUp = (currentDir: string): string | null => {\n    if (fs.existsSync(path.join(currentDir, 'packages'))) {\n      return currentDir;\n    }\n\n    const parentDir = path.dirname(currentDir);\n    return parentDir === currentDir ? null : findUp(parentDir);\n  };\n\n  return findUp(startDir);\n};\n\nconst readPackageName = (packageJsonPath: string): string | null => {\n  try {\n    const pkgJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as { name?: string };\n    return typeof pkgJson.name === 'string' ? pkgJson.name : null;\n  } catch {\n    return null;\n  }\n};\n\nconst findPackageRootFromResolvedEntry = (\n  resolvedEntryPath: string,\n  packageName: string,\n): string | null => {\n  let currentPath = fs.statSync(resolvedEntryPath).isDirectory()\n    ? resolvedEntryPath\n    : path.dirname(resolvedEntryPath);\n\n  while (true) {\n    const packageJsonPath = path.join(currentPath, 'package.json');\n    if (fs.existsSync(packageJsonPath) && readPackageName(packageJsonPath) === packageName) {\n      return currentPath;\n    }\n\n    const parentPath = path.dirname(currentPath);\n    if (parentPath === currentPath) {\n      return null;\n    }\n\n    currentPath = parentPath;\n  }\n};\n\nconst findPackageRootInNodeModules = (startDir: string, packageName: string): string | null => {\n  let currentDir = startDir;\n\n  while (true) {\n    const packageJsonPath = path.join(currentDir, 'node_modules', packageName, 'package.json');\n    if (fs.existsSync(packageJsonPath)) {\n      return path.dirname(packageJsonPath);\n    }\n\n    const parentDir = path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      return null;\n    }\n\n    currentDir = parentDir;\n  }\n};\n\nconst resolvePackageRoot = (workspaceDir: string, packageName: string): string | null => {\n  const requireFromWorkspace = createRequire(path.join(workspaceDir, 'package.json'));\n\n  try {\n    const resolvedPackageJson = requireFromWorkspace.resolve(\n      path.join(packageName, 'package.json'),\n    );\n    return path.dirname(resolvedPackageJson);\n  } catch {\n    try {\n      const resolvedPackageEntry = requireFromWorkspace.resolve(packageName);\n      const packageRoot = findPackageRootFromResolvedEntry(resolvedPackageEntry, packageName);\n      if (packageRoot) {\n        return packageRoot;\n      }\n    } catch {\n      // Fall through to explicit node_modules lookup below.\n    }\n\n    return findPackageRootInNodeModules(workspaceDir, packageName);\n  }\n};\n\ntype PackageJsonShape = {\n  uds?: {\n    scope?: string;\n  };\n};\n\nconst findPackageRootInMonorepo = (monorepoRoot: string, packageName: string): string | null => {\n  const packageJsonPaths = fg.sync('packages/**/package.json', {\n    cwd: monorepoRoot,\n    absolute: true,\n    ignore: ['**/node_modules/**', '**/dist/**'],\n  });\n\n  const matchingPath = packageJsonPaths.find((pkgJsonPath) => {\n    return readPackageName(pkgJsonPath) === packageName;\n  });\n\n  return matchingPath ? path.dirname(matchingPath) : null;\n};\n\nconst findPackageRoot = (packageName: string): string | null => {\n  const workspaceDir = process.cwd();\n  const monorepoRoot = findMonorepoRoot(workspaceDir);\n\n  let packageRoot = resolvePackageRoot(workspaceDir, packageName);\n  if (!packageRoot && monorepoRoot) {\n    packageRoot = findPackageRootInMonorepo(monorepoRoot, packageName);\n  }\n\n  return packageRoot;\n};\n\nconst buildPackageSourceCandidates = (\n  workspaceDir: string,\n  packageName: string,\n  packageRoot: string | null,\n): string[] => {\n  return [\n    packageRoot ? path.join(packageRoot, 'src') : null,\n    packageRoot ? path.join(packageRoot, 'lib') : null,\n    packageRoot ? path.join(packageRoot, 'dist') : null,\n    packageRoot,\n    path.join(workspaceDir, 'node_modules', packageName, 'src'),\n    path.join(workspaceDir, 'node_modules', packageName, 'lib'),\n    path.join(workspaceDir, 'node_modules', packageName, 'dist'),\n    path.join(workspaceDir, 'node_modules', packageName),\n  ].filter(Boolean) as string[];\n};\n\nconst getFirstExistingPath = (candidates: string[]): string | null =>\n  candidates.find((candidate) => fs.existsSync(candidate)) ?? null;\n\nconst findPackageSourceDir = (packageName: string): string | null => {\n  const workspaceDir = process.cwd();\n  const packageRoot = findPackageRoot(packageName);\n\n  return getFirstExistingPath(buildPackageSourceCandidates(workspaceDir, packageName, packageRoot));\n};\n\nconst getPackageUdsScope = (packageName: string): string | null => {\n  const packageRoot = findPackageRoot(packageName);\n  if (!packageRoot) {\n    return null;\n  }\n\n  const packageJsonPath = path.join(packageRoot, 'package.json');\n  if (!fs.existsSync(packageJsonPath)) {\n    return null;\n  }\n\n  try {\n    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as PackageJsonShape;\n    const scope = packageJson.uds?.scope;\n    return typeof scope === 'string' && scope.trim().length > 0 ? scope.trim() : null;\n  } catch {\n    return null;\n  }\n};\n\nconst scaffoldThemeConfig = async (options: {\n  outputPath?: string;\n  configPath?: string;\n  entry?: EntryValue;\n  force?: boolean;\n}): Promise<void> => {\n  const workspaceDir = process.cwd();\n  const outputPath = options.outputPath ?? 'uds.theme.ts';\n  const absoluteOutputPath = path.isAbsolute(outputPath)\n    ? outputPath\n    : path.join(workspaceDir, outputPath);\n\n  if (fs.existsSync(absoluteOutputPath) && !options.force) {\n    print(red(`Error: ${outputPath} already exists. Use --force to overwrite.`));\n    process.exitCode = 1;\n    return;\n  }\n\n  const configPath = options.configPath ?? './uds.config.ts';\n  const entry = options.entry ?? './src';\n  const serializedEntry = formatEntryValue(entry);\n\n  const template = `import { defineTheme } from '@yahoo/uds';\n\n/**\n * UDS Theme Configuration\n * \n * This file configures CSS generation for your app and shared packages.\n * Run \\`uds css\\` to generate optimized CSS.\n */\nexport default defineTheme({\n  // Path to your uds.config.ts file\n  config: '${configPath}',\n\n  // Entry directory or .tsx file path for scanning your app code\n  entry: ${serializedEntry},\n\n  // Color modes to include (light mode is always in :root)\n  colorModes: ['dark'],\n\n  // Packages that inherit your app's theme (merged into main uds.css)\n  // inherit: ['@your-org/shared-ui'],\n\n  // Packages that generate separate scoped CSS outputs.\n  // Scope class is discovered from each package.json uds.scope.\n  // When entry is omitted, the package is scanned the same way as inherit.\n  // scoped: {\n  //   '@your-org/shared-ui': './packages/shared-ui/uds.config.ts'\n  // }\n  //\n  // Or use the expanded form for custom output paths:\n  // scoped: {\n  //   '@your-org/shared-ui': {\n  //     config: './packages/shared-ui/uds.config.ts',\n  //     entry: './src',\n  //     // outFile defaults to dist/shared-ui.css\n  //     outFile: 'dist/shared-ui.css'\n  //   },\n  // },\n\n  // CSS generation options (all optional)\n  // css: {\n  //   safelist: [],\n  //   preflight: true,\n  //   fontFaceDeclarations: true,\n  //   optimization: {\n  //     removeUnusedFonts: false,\n  //     removeEmptyRules: true,\n  //     deduplicateScopedCss: true\n  //   }\n  // }\n});\n`;\n\n  fs.writeFileSync(absoluteOutputPath, template);\n\n  print('');\n  print(green('✅ Created uds.theme.ts'));\n  print('');\n  print(`${magenta('Next steps:')}`);\n  print(`   1. Review and customize ${cyan(outputPath)}`);\n  print(`   2. Run ${cyan('uds css')} to generate CSS`);\n  print('');\n};\n\nexport {\n  findPackageRoot,\n  findPackageSourceDir,\n  getPackageUdsScope,\n  loadConfigFile,\n  scaffoldThemeConfig,\n  scanDirectoriesForSafelist,\n  scanDirectoryForSafelist,\n};\nexport type { SafelistScanResult };\n"],"mappings":"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"}

package/dist/tailwind/dist/css/perf.cjs

@@ -0,0 +1,92 @@
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+require("../_virtual/_rolldown/runtime.cjs");
+let node_perf_hooks = require("node:perf_hooks");
+//#region src/css/perf.ts
+const PERF_PREFIX = "uds:css:";
+const isPerfEnabled = () => process.env.UDS_PERF === "1";
+const memorySnapshots = [];
+const captureMemory = (label) => {
+	if (!isPerfEnabled()) return;
+	const mem = process.memoryUsage();
+	memorySnapshots.push({
+		label,
+		rss: mem.rss,
+		heapUsed: mem.heapUsed,
+		heapTotal: mem.heapTotal,
+		external: mem.external,
+		timestamp: node_perf_hooks.performance.now()
+	});
+};
+const measureAsync = async (name, fn, detail) => {
+	if (!isPerfEnabled()) return fn();
+	const markName = `${PERF_PREFIX}${name}`;
+	const startMark = `${markName}:start`;
+	const endMark = `${markName}:end`;
+	node_perf_hooks.performance.mark(startMark, { detail });
+	const result = await fn();
+	node_perf_hooks.performance.mark(endMark);
+	node_perf_hooks.performance.measure(markName, startMark, endMark);
+	return result;
+};
+const collectTimings = () => {
+	return node_perf_hooks.performance.getEntriesByType("measure").filter((entry) => entry.name.startsWith(PERF_PREFIX)).map((entry) => ({
+		name: entry.name.slice(8),
+		durationMs: Math.round(entry.duration * 100) / 100,
+		startTime: Math.round(entry.startTime * 100) / 100,
+		detail: entry.detail
+	}));
+};
+const collectPerfData = () => ({
+	timings: collectTimings(),
+	memory: [...memorySnapshots]
+});
+const clearTimings = () => {
+	node_perf_hooks.performance.clearMarks();
+	node_perf_hooks.performance.clearMeasures();
+	memorySnapshots.length = 0;
+};
+const formatMs = (ms) => {
+	if (ms < 1e3) return `${Math.round(ms)}ms`;
+	return `${(ms / 1e3).toFixed(1)}s`;
+};
+const formatMemoryMB = (bytes) => `${(bytes / 1024 / 1024).toFixed(0)} MB`;
+const formatTimingTree = (timings, totalMs) => {
+	const lines = [];
+	const grouped = /* @__PURE__ */ new Map();
+	for (const entry of timings) {
+		const group = entry.name.split(":")[0] ?? "other";
+		const existing = grouped.get(group) ?? [];
+		existing.push(entry);
+		grouped.set(group, existing);
+	}
+	for (const [group, entries] of grouped) {
+		const topLevel = entries.filter((e) => e.name === group || e.name.split(":").length === 1).sort((a, b) => b.durationMs - a.durationMs)[0];
+		const subEntries = entries.filter((e) => e.name !== group && e.name.startsWith(`${group}:`));
+		if (topLevel) {
+			const pct = totalMs > 0 ? (topLevel.durationMs / totalMs * 100).toFixed(1) : "0.0";
+			lines.push(`  ${group}: ${formatMs(topLevel.durationMs)} (${pct}%)`);
+		}
+		for (const sub of subEntries.sort((a, b) => b.durationMs - a.durationMs)) {
+			const subName = sub.name.slice(group.length + 1);
+			lines.push(`    ├─ ${subName}: ${formatMs(sub.durationMs)}`);
+		}
+	}
+	return lines.join("\n");
+};
+const printPerfSummary = (totalMs) => {
+	if (!isPerfEnabled()) return;
+	const data = collectPerfData();
+	console.log("\n\x1B[35mPhase breakdown:\x1B[0m");
+	console.log(formatTimingTree(data.timings, totalMs));
+	if (data.memory.length > 0) {
+		const peak = data.memory.reduce((max, snap) => snap.rss > max.rss ? snap : max, data.memory[0]);
+		console.log(`  Peak memory: ${formatMemoryMB(peak.rss)} RSS, ${formatMemoryMB(peak.heapUsed)} heap`);
+	}
+	console.log("");
+};
+//#endregion
+exports.captureMemory = captureMemory;
+exports.clearTimings = clearTimings;
+exports.isPerfEnabled = isPerfEnabled;
+exports.measureAsync = measureAsync;
+exports.printPerfSummary = printPerfSummary;

package/dist/tailwind/dist/css/perf.js

@@ -0,0 +1,89 @@
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+import { performance } from "node:perf_hooks";
+//#region src/css/perf.ts
+const PERF_PREFIX = "uds:css:";
+const isPerfEnabled = () => process.env.UDS_PERF === "1";
+const memorySnapshots = [];
+const captureMemory = (label) => {
+	if (!isPerfEnabled()) return;
+	const mem = process.memoryUsage();
+	memorySnapshots.push({
+		label,
+		rss: mem.rss,
+		heapUsed: mem.heapUsed,
+		heapTotal: mem.heapTotal,
+		external: mem.external,
+		timestamp: performance.now()
+	});
+};
+const measureAsync = async (name, fn, detail) => {
+	if (!isPerfEnabled()) return fn();
+	const markName = `${PERF_PREFIX}${name}`;
+	const startMark = `${markName}:start`;
+	const endMark = `${markName}:end`;
+	performance.mark(startMark, { detail });
+	const result = await fn();
+	performance.mark(endMark);
+	performance.measure(markName, startMark, endMark);
+	return result;
+};
+const collectTimings = () => {
+	return performance.getEntriesByType("measure").filter((entry) => entry.name.startsWith(PERF_PREFIX)).map((entry) => ({
+		name: entry.name.slice(8),
+		durationMs: Math.round(entry.duration * 100) / 100,
+		startTime: Math.round(entry.startTime * 100) / 100,
+		detail: entry.detail
+	}));
+};
+const collectPerfData = () => ({
+	timings: collectTimings(),
+	memory: [...memorySnapshots]
+});
+const clearTimings = () => {
+	performance.clearMarks();
+	performance.clearMeasures();
+	memorySnapshots.length = 0;
+};
+const formatMs = (ms) => {
+	if (ms < 1e3) return `${Math.round(ms)}ms`;
+	return `${(ms / 1e3).toFixed(1)}s`;
+};
+const formatMemoryMB = (bytes) => `${(bytes / 1024 / 1024).toFixed(0)} MB`;
+const formatTimingTree = (timings, totalMs) => {
+	const lines = [];
+	const grouped = /* @__PURE__ */ new Map();
+	for (const entry of timings) {
+		const group = entry.name.split(":")[0] ?? "other";
+		const existing = grouped.get(group) ?? [];
+		existing.push(entry);
+		grouped.set(group, existing);
+	}
+	for (const [group, entries] of grouped) {
+		const topLevel = entries.filter((e) => e.name === group || e.name.split(":").length === 1).sort((a, b) => b.durationMs - a.durationMs)[0];
+		const subEntries = entries.filter((e) => e.name !== group && e.name.startsWith(`${group}:`));
+		if (topLevel) {
+			const pct = totalMs > 0 ? (topLevel.durationMs / totalMs * 100).toFixed(1) : "0.0";
+			lines.push(`  ${group}: ${formatMs(topLevel.durationMs)} (${pct}%)`);
+		}
+		for (const sub of subEntries.sort((a, b) => b.durationMs - a.durationMs)) {
+			const subName = sub.name.slice(group.length + 1);
+			lines.push(`    ├─ ${subName}: ${formatMs(sub.durationMs)}`);
+		}
+	}
+	return lines.join("\n");
+};
+const printPerfSummary = (totalMs) => {
+	if (!isPerfEnabled()) return;
+	const data = collectPerfData();
+	console.log("\n\x1B[35mPhase breakdown:\x1B[0m");
+	console.log(formatTimingTree(data.timings, totalMs));
+	if (data.memory.length > 0) {
+		const peak = data.memory.reduce((max, snap) => snap.rss > max.rss ? snap : max, data.memory[0]);
+		console.log(`  Peak memory: ${formatMemoryMB(peak.rss)} RSS, ${formatMemoryMB(peak.heapUsed)} heap`);
+	}
+	console.log("");
+};
+//#endregion
+export { captureMemory, clearTimings, isPerfEnabled, measureAsync, printPerfSummary };
+
+//# sourceMappingURL=perf.js.map

package/dist/tailwind/dist/css/perf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.js","names":[],"sources":["../../src/css/perf.ts"],"sourcesContent":["import { performance } from 'node:perf_hooks';\n\nconst PERF_PREFIX = 'uds:css:';\n\nconst isPerfEnabled = (): boolean => process.env.UDS_PERF === '1';\n\n// --- Types ---\n\ntype MemorySnapshot = {\n  label: string;\n  rss: number;\n  heapUsed: number;\n  heapTotal: number;\n  external: number;\n  timestamp: number;\n};\n\ntype TimingEntry = {\n  name: string;\n  durationMs: number;\n  startTime: number;\n  detail?: unknown;\n};\n\ntype PerfData = {\n  timings: TimingEntry[];\n  memory: MemorySnapshot[];\n};\n\n// --- Memory tracking ---\n\nconst memorySnapshots: MemorySnapshot[] = [];\n\nconst captureMemory = (label: string): void => {\n  if (!isPerfEnabled()) {\n    return;\n  }\n\n  const mem = process.memoryUsage();\n  memorySnapshots.push({\n    label,\n    rss: mem.rss,\n    heapUsed: mem.heapUsed,\n    heapTotal: mem.heapTotal,\n    external: mem.external,\n    timestamp: performance.now(),\n  });\n};\n\n// --- Synchronous measurement ---\n\nconst measureSync = <T>(name: string, fn: () => T, detail?: unknown): T => {\n  if (!isPerfEnabled()) {\n    return fn();\n  }\n\n  const markName = `${PERF_PREFIX}${name}`;\n  const startMark = `${markName}:start`;\n  const endMark = `${markName}:end`;\n\n  performance.mark(startMark, { detail });\n  const result = fn();\n  performance.mark(endMark);\n  performance.measure(markName, startMark, endMark);\n\n  return result;\n};\n\n// --- Asynchronous measurement ---\n\nconst measureAsync = async <T>(\n  name: string,\n  fn: () => Promise<T>,\n  detail?: unknown,\n): Promise<T> => {\n  if (!isPerfEnabled()) {\n    return fn();\n  }\n\n  const markName = `${PERF_PREFIX}${name}`;\n  const startMark = `${markName}:start`;\n  const endMark = `${markName}:end`;\n\n  performance.mark(startMark, { detail });\n  const result = await fn();\n  performance.mark(endMark);\n  performance.measure(markName, startMark, endMark);\n\n  return result;\n};\n\n// --- Collecting results ---\n\nconst collectTimings = (): TimingEntry[] => {\n  return performance\n    .getEntriesByType('measure')\n    .filter((entry) => entry.name.startsWith(PERF_PREFIX))\n    .map((entry) => ({\n      name: entry.name.slice(PERF_PREFIX.length),\n      durationMs: Math.round(entry.duration * 100) / 100,\n      startTime: Math.round(entry.startTime * 100) / 100,\n      detail: (entry as PerformanceMeasure).detail,\n    }));\n};\n\nconst collectPerfData = (): PerfData => ({\n  timings: collectTimings(),\n  memory: [...memorySnapshots],\n});\n\nconst clearTimings = (): void => {\n  performance.clearMarks();\n  performance.clearMeasures();\n  memorySnapshots.length = 0;\n};\n\n// --- Formatting ---\n\nconst formatMs = (ms: number): string => {\n  if (ms < 1000) {\n    return `${Math.round(ms)}ms`;\n  }\n\n  return `${(ms / 1000).toFixed(1)}s`;\n};\n\nconst formatMemoryMB = (bytes: number): string => `${(bytes / 1024 / 1024).toFixed(0)} MB`;\n\nconst formatTimingTree = (timings: TimingEntry[], totalMs: number): string => {\n  const lines: string[] = [];\n  const grouped = new Map<string, TimingEntry[]>();\n\n  // Group by first segment (e.g., \"scan\", \"gen\", \"opt\")\n  for (const entry of timings) {\n    const segments = entry.name.split(':');\n    const group = segments[0] ?? 'other';\n    const existing = grouped.get(group) ?? [];\n    existing.push(entry);\n    grouped.set(group, existing);\n  }\n\n  for (const [group, entries] of grouped) {\n    // Find the top-level entry for this group (shortest name)\n    const topLevel = entries\n      .filter((e) => e.name === group || e.name.split(':').length === 1)\n      .sort((a, b) => b.durationMs - a.durationMs)[0];\n\n    const subEntries = entries.filter((e) => e.name !== group && e.name.startsWith(`${group}:`));\n\n    if (topLevel) {\n      const pct = totalMs > 0 ? ((topLevel.durationMs / totalMs) * 100).toFixed(1) : '0.0';\n      lines.push(`  ${group}: ${formatMs(topLevel.durationMs)} (${pct}%)`);\n    }\n\n    for (const sub of subEntries.sort((a, b) => b.durationMs - a.durationMs)) {\n      const subName = sub.name.slice(group.length + 1);\n      lines.push(`    ├─ ${subName}: ${formatMs(sub.durationMs)}`);\n    }\n  }\n\n  return lines.join('\\n');\n};\n\nconst printPerfSummary = (totalMs: number): void => {\n  if (!isPerfEnabled()) {\n    return;\n  }\n\n  const data = collectPerfData();\n\n  console.log('\\n\\x1b[35mPhase breakdown:\\x1b[0m');\n  console.log(formatTimingTree(data.timings, totalMs));\n\n  if (data.memory.length > 0) {\n    const peak = data.memory.reduce(\n      (max, snap) => (snap.rss > max.rss ? snap : max),\n      data.memory[0]!,\n    );\n    console.log(\n      `  Peak memory: ${formatMemoryMB(peak.rss)} RSS, ${formatMemoryMB(peak.heapUsed)} heap`,\n    );\n  }\n\n  console.log('');\n};\n\nexport {\n  captureMemory,\n  clearTimings,\n  collectPerfData,\n  collectTimings,\n  formatMemoryMB,\n  formatMs,\n  formatTimingTree,\n  isPerfEnabled,\n  measureAsync,\n  measureSync,\n  PERF_PREFIX,\n  printPerfSummary,\n};\n\nexport type { MemorySnapshot, PerfData, TimingEntry };\n"],"mappings":";;;AAEA,MAAM,cAAc;AAEpB,MAAM,sBAA+B,QAAQ,IAAI,aAAa;AA2B9D,MAAM,kBAAoC,EAAE;AAE5C,MAAM,iBAAiB,UAAwB;AAC7C,KAAI,CAAC,eAAe,CAClB;CAGF,MAAM,MAAM,QAAQ,aAAa;AACjC,iBAAgB,KAAK;EACnB;EACA,KAAK,IAAI;EACT,UAAU,IAAI;EACd,WAAW,IAAI;EACf,UAAU,IAAI;EACd,WAAW,YAAY,KAAK;EAC7B,CAAC;;AAwBJ,MAAM,eAAe,OACnB,MACA,IACA,WACe;AACf,KAAI,CAAC,eAAe,CAClB,QAAO,IAAI;CAGb,MAAM,WAAW,GAAG,cAAc;CAClC,MAAM,YAAY,GAAG,SAAS;CAC9B,MAAM,UAAU,GAAG,SAAS;AAE5B,aAAY,KAAK,WAAW,EAAE,QAAQ,CAAC;CACvC,MAAM,SAAS,MAAM,IAAI;AACzB,aAAY,KAAK,QAAQ;AACzB,aAAY,QAAQ,UAAU,WAAW,QAAQ;AAEjD,QAAO;;AAKT,MAAM,uBAAsC;AAC1C,QAAO,YACJ,iBAAiB,UAAU,CAC3B,QAAQ,UAAU,MAAM,KAAK,WAAW,YAAY,CAAC,CACrD,KAAK,WAAW;EACf,MAAM,MAAM,KAAK,MAAM,EAAmB;EAC1C,YAAY,KAAK,MAAM,MAAM,WAAW,IAAI,GAAG;EAC/C,WAAW,KAAK,MAAM,MAAM,YAAY,IAAI,GAAG;EAC/C,QAAS,MAA6B;EACvC,EAAE;;AAGP,MAAM,yBAAmC;CACvC,SAAS,gBAAgB;CACzB,QAAQ,CAAC,GAAG,gBAAgB;CAC7B;AAED,MAAM,qBAA2B;AAC/B,aAAY,YAAY;AACxB,aAAY,eAAe;AAC3B,iBAAgB,SAAS;;AAK3B,MAAM,YAAY,OAAuB;AACvC,KAAI,KAAK,IACP,QAAO,GAAG,KAAK,MAAM,GAAG,CAAC;AAG3B,QAAO,IAAI,KAAK,KAAM,QAAQ,EAAE,CAAC;;AAGnC,MAAM,kBAAkB,UAA0B,IAAI,QAAQ,OAAO,MAAM,QAAQ,EAAE,CAAC;AAEtF,MAAM,oBAAoB,SAAwB,YAA4B;CAC5E,MAAM,QAAkB,EAAE;CAC1B,MAAM,0BAAU,IAAI,KAA4B;AAGhD,MAAK,MAAM,SAAS,SAAS;EAE3B,MAAM,QADW,MAAM,KAAK,MAAM,IACZ,CAAC,MAAM;EAC7B,MAAM,WAAW,QAAQ,IAAI,MAAM,IAAI,EAAE;AACzC,WAAS,KAAK,MAAM;AACpB,UAAQ,IAAI,OAAO,SAAS;;AAG9B,MAAK,MAAM,CAAC,OAAO,YAAY,SAAS;EAEtC,MAAM,WAAW,QACd,QAAQ,MAAM,EAAE,SAAS,SAAS,EAAE,KAAK,MAAM,IAAI,CAAC,WAAW,EAAE,CACjE,MAAM,GAAG,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC;EAE/C,MAAM,aAAa,QAAQ,QAAQ,MAAM,EAAE,SAAS,SAAS,EAAE,KAAK,WAAW,GAAG,MAAM,GAAG,CAAC;AAE5F,MAAI,UAAU;GACZ,MAAM,MAAM,UAAU,KAAM,SAAS,aAAa,UAAW,KAAK,QAAQ,EAAE,GAAG;AAC/E,SAAM,KAAK,KAAK,MAAM,IAAI,SAAS,SAAS,WAAW,CAAC,IAAI,IAAI,IAAI;;AAGtE,OAAK,MAAM,OAAO,WAAW,MAAM,GAAG,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE;GACxE,MAAM,UAAU,IAAI,KAAK,MAAM,MAAM,SAAS,EAAE;AAChD,SAAM,KAAK,UAAU,QAAQ,IAAI,SAAS,IAAI,WAAW,GAAG;;;AAIhE,QAAO,MAAM,KAAK,KAAK;;AAGzB,MAAM,oBAAoB,YAA0B;AAClD,KAAI,CAAC,eAAe,CAClB;CAGF,MAAM,OAAO,iBAAiB;AAE9B,SAAQ,IAAI,oCAAoC;AAChD,SAAQ,IAAI,iBAAiB,KAAK,SAAS,QAAQ,CAAC;AAEpD,KAAI,KAAK,OAAO,SAAS,GAAG;EAC1B,MAAM,OAAO,KAAK,OAAO,QACtB,KAAK,SAAU,KAAK,MAAM,IAAI,MAAM,OAAO,KAC5C,KAAK,OAAO,GACb;AACD,UAAQ,IACN,kBAAkB,eAAe,KAAK,IAAI,CAAC,QAAQ,eAAe,KAAK,SAAS,CAAC,OAClF;;AAGH,SAAQ,IAAI,GAAG"}

package/dist/tailwind/dist/css/purgeWorker.cjs

@@ -0,0 +1,47 @@
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+require("../_virtual/_rolldown/runtime.cjs");
+const require_purgeFromCode = require("../purger/optimized/purgeFromCode.cjs");
+let node_worker_threads = require("node:worker_threads");
+//#region src/css/purgeWorker.ts
+let sharedConfig = null;
+node_worker_threads.parentPort?.on("message", async (msg) => {
+	if (msg.type === "init") {
+		sharedConfig = msg.config;
+		node_worker_threads.parentPort?.postMessage({ type: "ready" });
+		return;
+	}
+	if (msg.type === "task") {
+		if (!sharedConfig) {
+			node_worker_threads.parentPort?.postMessage({
+				type: "error",
+				id: msg.id,
+				error: "Worker not initialized"
+			});
+			return;
+		}
+		try {
+			const result = await require_purgeFromCode.purgeFromCodeOptimized(msg.code, {
+				...sharedConfig,
+				colorModes: msg.colorModes,
+				variantDefaults: msg.variantDefaults,
+				runtimeConfigValues: msg.runtimeConfigValues,
+				includeAllClassNamePrimitives: msg.includeAllClassNamePrimitives,
+				filePath: msg.filePath
+			});
+			node_worker_threads.parentPort?.postMessage({
+				type: "result",
+				id: msg.id,
+				result
+			});
+		} catch (error) {
+			node_worker_threads.parentPort?.postMessage({
+				type: "error",
+				id: msg.id,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+		return;
+	}
+	if (msg.type === "done") process.exit(0);
+});
+//#endregion

package/dist/tailwind/dist/css/purgeWorker.d.cts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/tailwind/dist/css/purgeWorker.d.ts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/tailwind/dist/css/purgeWorker.js

@@ -0,0 +1,48 @@
+/*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
+import { purgeFromCodeOptimized } from "../purger/optimized/purgeFromCode.js";
+import { parentPort } from "node:worker_threads";
+//#region src/css/purgeWorker.ts
+let sharedConfig = null;
+parentPort?.on("message", async (msg) => {
+	if (msg.type === "init") {
+		sharedConfig = msg.config;
+		parentPort?.postMessage({ type: "ready" });
+		return;
+	}
+	if (msg.type === "task") {
+		if (!sharedConfig) {
+			parentPort?.postMessage({
+				type: "error",
+				id: msg.id,
+				error: "Worker not initialized"
+			});
+			return;
+		}
+		try {
+			const result = await purgeFromCodeOptimized(msg.code, {
+				...sharedConfig,
+				colorModes: msg.colorModes,
+				variantDefaults: msg.variantDefaults,
+				runtimeConfigValues: msg.runtimeConfigValues,
+				includeAllClassNamePrimitives: msg.includeAllClassNamePrimitives,
+				filePath: msg.filePath
+			});
+			parentPort?.postMessage({
+				type: "result",
+				id: msg.id,
+				result
+			});
+		} catch (error) {
+			parentPort?.postMessage({
+				type: "error",
+				id: msg.id,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+		return;
+	}
+	if (msg.type === "done") process.exit(0);
+});
+//#endregion
+
+//# sourceMappingURL=purgeWorker.js.map

package/dist/tailwind/dist/css/purgeWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purgeWorker.js","names":[],"sources":["../../src/css/purgeWorker.ts"],"sourcesContent":["import { parentPort } from 'node:worker_threads';\n\nimport type { PurgeFromCodeOptions } from '../purger/optimized/purgeFromCode';\nimport { purgeFromCodeOptimized } from '../purger/optimized/purgeFromCode';\n\ntype SharedConfig = Pick<PurgeFromCodeOptions, 'variants' | 'autoVariants' | 'componentData'>;\n\ntype InitMessage = {\n  type: 'init';\n  config: SharedConfig;\n};\n\ntype TaskMessage = {\n  type: 'task';\n  id: number;\n  code: string;\n  filePath: string;\n  colorModes?: ('dark' | 'light')[];\n  variantDefaults?: PurgeFromCodeOptions['variantDefaults'];\n  runtimeConfigValues?: PurgeFromCodeOptions['runtimeConfigValues'];\n  includeAllClassNamePrimitives?: boolean;\n};\n\ntype DoneMessage = {\n  type: 'done';\n};\n\ntype WorkerMessage = DoneMessage | InitMessage | TaskMessage;\n\nlet sharedConfig: SharedConfig | null = null;\n\nparentPort?.on('message', async (msg: WorkerMessage) => {\n  if (msg.type === 'init') {\n    sharedConfig = msg.config;\n    parentPort?.postMessage({ type: 'ready' });\n    return;\n  }\n\n  if (msg.type === 'task') {\n    if (!sharedConfig) {\n      parentPort?.postMessage({ type: 'error', id: msg.id, error: 'Worker not initialized' });\n      return;\n    }\n\n    try {\n      const result = await purgeFromCodeOptimized(msg.code, {\n        ...sharedConfig,\n        colorModes: msg.colorModes,\n        variantDefaults: msg.variantDefaults,\n        runtimeConfigValues: msg.runtimeConfigValues,\n        includeAllClassNamePrimitives: msg.includeAllClassNamePrimitives,\n        filePath: msg.filePath,\n      });\n      parentPort?.postMessage({ type: 'result', id: msg.id, result });\n    } catch (error) {\n      parentPort?.postMessage({\n        type: 'error',\n        id: msg.id,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n    return;\n  }\n\n  if (msg.type === 'done') {\n    process.exit(0);\n  }\n});\n"],"mappings":";;;;AA6BA,IAAI,eAAoC;AAExC,YAAY,GAAG,WAAW,OAAO,QAAuB;AACtD,KAAI,IAAI,SAAS,QAAQ;AACvB,iBAAe,IAAI;AACnB,cAAY,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1C;;AAGF,KAAI,IAAI,SAAS,QAAQ;AACvB,MAAI,CAAC,cAAc;AACjB,eAAY,YAAY;IAAE,MAAM;IAAS,IAAI,IAAI;IAAI,OAAO;IAA0B,CAAC;AACvF;;AAGF,MAAI;GACF,MAAM,SAAS,MAAM,uBAAuB,IAAI,MAAM;IACpD,GAAG;IACH,YAAY,IAAI;IAChB,iBAAiB,IAAI;IACrB,qBAAqB,IAAI;IACzB,+BAA+B,IAAI;IACnC,UAAU,IAAI;IACf,CAAC;AACF,eAAY,YAAY;IAAE,MAAM;IAAU,IAAI,IAAI;IAAI;IAAQ,CAAC;WACxD,OAAO;AACd,eAAY,YAAY;IACtB,MAAM;IACN,IAAI,IAAI;IACR,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAC9D,CAAC;;AAEJ;;AAGF,KAAI,IAAI,SAAS,OACf,SAAQ,KAAK,EAAE;EAEjB"}