@yahoo/uds 3.123.0 → 3.124.0-beta.1

package/dist/tailwind/dist/css/generate.helpers.cjs

@@ -8,6 +8,7 @@ const require_plugin = require('../plugin.cjs');
 const require_optimizeCSS = require('../utils/optimizeCSS.cjs');
 const require_postcssPreserveVars = require('../utils/postcssPreserveVars.cjs');
 const require_postcss = require('./postcss.cjs');
+const require_runner_helpers = require('./runner.helpers.cjs');
 const require_utils = require('./utils.cjs');
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
@@ -40,7 +41,7 @@ const getCssFeatureFlags = (cssOptions) => {
 	};
 };
 const getContentGlobs = (contentDir) => {
-	return (Array.isArray(contentDir) ? contentDir : [contentDir]).map((dir) => require_entryPoints.hasAllowedEntryFileExtension(dir) ? dir : node_path.default.join(dir, "**/*.{js,jsx,ts,tsx}"));
+	return (Array.isArray(contentDir) ? contentDir : [contentDir]).map((dir) => require_entryPoints.hasAllowedEntryFileExtension(dir) ? dir : node_path.default.join(dir, "**/*.{js,jsx,mjs,cjs,ts,tsx}"));
 };
 const getRawContentEntries = (rawContents) => rawContents.map((rawContent) => ({
 	raw: rawContent,
@@ -90,7 +91,7 @@ const buildPostcssPlugins = (options) => {
 };
 const applyScopedColorModeFix = async (css, scopeClass) => {
 	if (!scopeClass) return css;
-	return (await (0, postcss.default)([require_postcss.fixScopedColorModeSelectorsPlugin(scopeClass)]).process(css, { from: void 0 })).css;
+	return (await (0, postcss.default)([require_postcss.fixScopedSelfOrParentSelectorsPlugin(scopeClass), require_postcss.fixScopedColorModeSelectorsPlugin(scopeClass)]).process(css, { from: void 0 })).css;
 };
 const optimizeGeneratedCss = async (options) => {
 	if (!options.shouldOptimize) return { css: options.css };
@@ -115,22 +116,29 @@ const optimizeGeneratedCss = async (options) => {
 };
 const printSimpleModeStats = (options) => {
 	const { print, magenta, cyan, yellow } = options;
+	const getDisplayPath = (targetPath) => {
+		const relativePath = node_path.default.relative(options.cwd, targetPath);
+		return relativePath.length === 0 ? "." : relativePath;
+	};
 	print("");
-	print(`${magenta("Output:")} ${cyan(options.outputPath)}`);
+	print(`${magenta("Output:")} ${cyan(getDisplayPath(options.outputPath))}`);
 	print(`${magenta("Stats:")}`);
 	print(`   Files scanned: ${options.totalFilesScanned}`);
+	if (options.verbose && options.scannedFilePaths && options.scannedFilePaths.length > 0) [...new Set(options.scannedFilePaths)].sort((left, right) => left.localeCompare(right)).forEach((filePath) => print(`      • ${cyan(getDisplayPath(filePath))}`));
 	print(`   Classes: ${options.classCount}`);
 	print(`   Size: ${require_utils.formatBytes(options.sizeBytes)} (${require_utils.formatBytes(options.sizeGzipBytes)} gzipped)`);
 	const optimizationStats = options.optimizationStats;
 	if (optimizationStats) {
-		const savedBytesGzip = optimizationStats.originalSizeGzip - options.sizeGzipBytes;
-		if (savedBytesGzip > 0) print(`   Optimized: saved ${require_utils.formatBytes(savedBytesGzip)} gzip (${optimizationStats.fontFacesRemoved} unused @font-face, ${optimizationStats.emptyRulesRemoved} empty rules removed)`);
+		if (optimizationStats.originalSizeGzip - options.sizeGzipBytes > 0) {
+			if (optimizationStats.fontFacesRemoved > 0) print(`      • removed ${optimizationStats.fontFacesRemoved} unused @font-face`);
+			if (optimizationStats.emptyRulesRemoved > 0) print(`      • removed ${optimizationStats.emptyRulesRemoved} empty rules`);
+		}
 		if (optimizationStats.validationErrors.length > 0) {
 			print(`   ${yellow("Validation warnings:")}`);
 			optimizationStats.validationErrors.forEach((error) => print(`      ${yellow("•")} ${error}`));
 		}
 	}
-	print(`   Time: ${options.duration}ms`);
+	print(`   Time: ${require_runner_helpers.formatCssDuration(options.duration)}`);
 	if (options.scope) print(`   Scope: ${cyan(options.scope)}`);
 };
 

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

@@ -6,7 +6,8 @@ import { getIconStyles } from "../tailwind/components/getIconStyles.js";
 import { tailwindPlugin } from "../plugin.js";
 import { optimizeCSS } from "../utils/optimizeCSS.js";
 import { preserveVars, preserveVarsCleanup } from "../utils/postcssPreserveVars.js";
-import { fixScopedColorModeSelectorsPlugin } from "./postcss.js";
+import { fixScopedColorModeSelectorsPlugin, fixScopedSelfOrParentSelectorsPlugin } from "./postcss.js";
+import { formatCssDuration } from "./runner.helpers.js";
 import { formatBytes } from "./utils.js";
 import path from "node:path";
 import postcss from "postcss";
@@ -33,7 +34,7 @@ const getCssFeatureFlags = (cssOptions) => {
 	};
 };
 const getContentGlobs = (contentDir) => {
-	return (Array.isArray(contentDir) ? contentDir : [contentDir]).map((dir) => hasAllowedEntryFileExtension(dir) ? dir : path.join(dir, "**/*.{js,jsx,ts,tsx}"));
+	return (Array.isArray(contentDir) ? contentDir : [contentDir]).map((dir) => hasAllowedEntryFileExtension(dir) ? dir : path.join(dir, "**/*.{js,jsx,mjs,cjs,ts,tsx}"));
 };
 const getRawContentEntries = (rawContents) => rawContents.map((rawContent) => ({
 	raw: rawContent,
@@ -83,7 +84,7 @@ const buildPostcssPlugins = (options) => {
 };
 const applyScopedColorModeFix = async (css, scopeClass) => {
 	if (!scopeClass) return css;
-	return (await postcss([fixScopedColorModeSelectorsPlugin(scopeClass)]).process(css, { from: void 0 })).css;
+	return (await postcss([fixScopedSelfOrParentSelectorsPlugin(scopeClass), fixScopedColorModeSelectorsPlugin(scopeClass)]).process(css, { from: void 0 })).css;
 };
 const optimizeGeneratedCss = async (options) => {
 	if (!options.shouldOptimize) return { css: options.css };
@@ -108,22 +109,29 @@ const optimizeGeneratedCss = async (options) => {
 };
 const printSimpleModeStats = (options) => {
 	const { print, magenta, cyan, yellow } = options;
+	const getDisplayPath = (targetPath) => {
+		const relativePath = path.relative(options.cwd, targetPath);
+		return relativePath.length === 0 ? "." : relativePath;
+	};
 	print("");
-	print(`${magenta("Output:")} ${cyan(options.outputPath)}`);
+	print(`${magenta("Output:")} ${cyan(getDisplayPath(options.outputPath))}`);
 	print(`${magenta("Stats:")}`);
 	print(`   Files scanned: ${options.totalFilesScanned}`);
+	if (options.verbose && options.scannedFilePaths && options.scannedFilePaths.length > 0) [...new Set(options.scannedFilePaths)].sort((left, right) => left.localeCompare(right)).forEach((filePath) => print(`      • ${cyan(getDisplayPath(filePath))}`));
 	print(`   Classes: ${options.classCount}`);
 	print(`   Size: ${formatBytes(options.sizeBytes)} (${formatBytes(options.sizeGzipBytes)} gzipped)`);
 	const optimizationStats = options.optimizationStats;
 	if (optimizationStats) {
-		const savedBytesGzip = optimizationStats.originalSizeGzip - options.sizeGzipBytes;
-		if (savedBytesGzip > 0) print(`   Optimized: saved ${formatBytes(savedBytesGzip)} gzip (${optimizationStats.fontFacesRemoved} unused @font-face, ${optimizationStats.emptyRulesRemoved} empty rules removed)`);
+		if (optimizationStats.originalSizeGzip - options.sizeGzipBytes > 0) {
+			if (optimizationStats.fontFacesRemoved > 0) print(`      • removed ${optimizationStats.fontFacesRemoved} unused @font-face`);
+			if (optimizationStats.emptyRulesRemoved > 0) print(`      • removed ${optimizationStats.emptyRulesRemoved} empty rules`);
+		}
 		if (optimizationStats.validationErrors.length > 0) {
 			print(`   ${yellow("Validation warnings:")}`);
 			optimizationStats.validationErrors.forEach((error) => print(`      ${yellow("•")} ${error}`));
 		}
 	}
-	print(`   Time: ${options.duration}ms`);
+	print(`   Time: ${formatCssDuration(options.duration)}`);
 	if (options.scope) print(`   Scope: ${cyan(options.scope)}`);
 };
 

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

@@ -1 +1 @@
-{"version":3,"file":"generate.helpers.js","names":[],"sources":["../../src/css/generate.helpers.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { UniversalTokensConfig } from '@yahoo/uds-config';\nimport autoprefixer from 'autoprefixer';\nimport postcss from 'postcss';\n// @ts-expect-error - no types\nimport pruneVar from 'postcss-prune-var';\nimport postcssScope from 'postcss-scope';\nimport tailwindcss from 'tailwindcss';\nimport type { SafelistConfig } from 'tailwindcss/types/config';\n\n// eslint-disable-next-line import/no-relative-packages\nimport { iconPruneVarsSafelist } from '../../../icons/src/safelist';\nimport { getInternalSafelistClasses } from '../purger/optimized/utils/safelist';\nimport { getIconStyles } from '../tailwind/components/getIconStyles';\nimport { tailwindPlugin } from '../tailwind/tailwindPlugin';\nimport { hasAllowedEntryFileExtension } from '../utils/entryPoints';\nimport type { OptimizeCSSOptions } from '../utils/optimizeCSS';\nimport { optimizeCSS } from '../utils/optimizeCSS';\nimport { preserveVars, preserveVarsCleanup } from '../utils/postcssPreserveVars';\nimport { fixScopedColorModeSelectorsPlugin } from './postcss';\nimport type { UDSCSSOptimizationOptions, UDSCSSVarSafelistPattern } from './theme';\nimport { formatBytes } from './utils';\n\ntype CssOptimizationOptions = UDSCSSOptimizationOptions;\n\ntype CssOptionsLike = {\n  preflight?: boolean;\n  fontFaceDeclarations?: boolean;\n  optimization?: CssOptimizationOptions;\n};\n\ntype CssFeatureFlags = {\n  enablePreflight: boolean;\n  enableFontFaceDeclarations: boolean;\n  shouldOptimize: boolean;\n  shouldPruneVars: boolean;\n};\n\nconst getPruneVarSafelist = (cssOptions?: CssOptionsLike): UDSCSSVarSafelistPattern[] => {\n  const pruneVars = cssOptions?.optimization?.pruneVars;\n  const configuredSafelist =\n    pruneVars && typeof pruneVars === 'object' ? (pruneVars.safelist ?? []) : [];\n\n  return [...iconPruneVarsSafelist, ...configuredSafelist];\n};\n\nconst getCssFeatureFlags = (cssOptions?: CssOptionsLike): CssFeatureFlags => {\n  const optimizationConfig = cssOptions?.optimization;\n  const shouldOptimize = optimizationConfig?.enabled !== false;\n  const pruneVars = optimizationConfig?.pruneVars;\n\n  return {\n    enablePreflight: cssOptions?.preflight !== false,\n    enableFontFaceDeclarations: cssOptions?.fontFaceDeclarations !== false,\n    shouldOptimize,\n    shouldPruneVars: shouldOptimize && pruneVars !== false,\n  };\n};\n\nconst getContentGlobs = (contentDir: string | string[]): string[] => {\n  const contentDirs = Array.isArray(contentDir) ? contentDir : [contentDir];\n\n  return contentDirs.map((dir) =>\n    hasAllowedEntryFileExtension(dir) ? dir : path.join(dir, '**/*.{js,jsx,ts,tsx}'),\n  );\n};\n\nconst getRawContentEntries = (rawContents: string[]): Array<{ raw: string; extension: 'html' }> =>\n  rawContents.map((rawContent) => ({ raw: rawContent, extension: 'html' }));\n\nconst getInternalSafelistRawContent = (safelist: SafelistConfig[]): string[] => {\n  const internalClasses = new Set(getInternalSafelistClasses());\n  const matchedInternalClasses = safelist.filter(\n    (entry): entry is string => typeof entry === 'string' && internalClasses.has(entry),\n  );\n\n  if (matchedInternalClasses.length === 0) {\n    return [];\n  }\n\n  return [`<div class=\"${matchedInternalClasses.join(' ')}\"></div>`];\n};\n\nconst getInternalIconModeCss = (scopeClass?: string): string => {\n  const iconStyles = getIconStyles();\n\n  return Object.entries(iconStyles)\n    .map(([selector, declarations]) => {\n      const scopedSelector = scopeClass ? `${scopeClass} ${selector}` : selector;\n      const declarationString = Object.entries(declarations)\n        .map(([property, value]) => `${property}: ${value};`)\n        .join(' ');\n\n      return `${scopedSelector} { ${declarationString} }`;\n    })\n    .join(' ');\n};\n\nconst createTailwindPlugin = (options: {\n  contentDir: string | string[];\n  rawContents?: string[];\n  safelist: SafelistConfig[];\n  config: UniversalTokensConfig;\n  enablePreflight: boolean;\n  enableFontFaceDeclarations: boolean;\n}): postcss.AcceptedPlugin => {\n  const plugin = tailwindcss({\n    content: [\n      ...getContentGlobs(options.contentDir),\n      ...getRawContentEntries(getInternalSafelistRawContent(options.safelist)),\n      ...getRawContentEntries(options.rawContents ?? []),\n    ],\n    safelist: options.safelist,\n    corePlugins: { preflight: options.enablePreflight },\n    plugins: [\n      tailwindPlugin({\n        config: options.config,\n        disableFontFaceDeclarations: !options.enableFontFaceDeclarations,\n        ignorePluginSafelists: true,\n      }),\n    ],\n  });\n\n  return plugin as postcss.AcceptedPlugin;\n};\n\nconst getPruneVarPlugins = (\n  safeVarPrefixes: UDSCSSVarSafelistPattern[],\n): postcss.AcceptedPlugin[] => {\n  if (safeVarPrefixes.length === 0) {\n    return [pruneVar() as postcss.AcceptedPlugin];\n  }\n\n  return [\n    preserveVars({ preserve: safeVarPrefixes }) as postcss.AcceptedPlugin,\n    pruneVar() as postcss.AcceptedPlugin,\n    preserveVarsCleanup() as postcss.AcceptedPlugin,\n  ];\n};\n\nconst buildPostcssPlugins = (options: {\n  tailwindPlugin: postcss.AcceptedPlugin;\n  shouldPruneVars: boolean;\n  safeVarPrefixes: UDSCSSVarSafelistPattern[];\n  scopeClass?: string;\n}): postcss.AcceptedPlugin[] => {\n  const plugins: postcss.AcceptedPlugin[] = [options.tailwindPlugin, autoprefixer()];\n\n  if (options.shouldPruneVars) {\n    plugins.push(...getPruneVarPlugins(options.safeVarPrefixes));\n  }\n\n  if (options.scopeClass) {\n    plugins.push(postcssScope(options.scopeClass) as postcss.AcceptedPlugin);\n  }\n\n  return plugins;\n};\n\nconst applyScopedColorModeFix = async (css: string, scopeClass?: string): Promise<string> => {\n  if (!scopeClass) {\n    return css;\n  }\n\n  const fixResult = await postcss([fixScopedColorModeSelectorsPlugin(scopeClass)]).process(css, {\n    from: undefined,\n  });\n\n  return fixResult.css;\n};\n\nconst optimizeGeneratedCss = async (options: {\n  css: string;\n  shouldOptimize: boolean;\n  optimizationConfig?: CssOptimizationOptions;\n  referenceCss?: string;\n  scopeClass?: string;\n}): Promise<{\n  css: string;\n  optimizationStats?: {\n    originalSize: number;\n    originalSizeGzip: number;\n    fontFacesRemoved: number;\n    emptyRulesRemoved: number;\n    validationErrors: string[];\n  };\n}> => {\n  if (!options.shouldOptimize) {\n    return { css: options.css };\n  }\n\n  const optimizationOptions: OptimizeCSSOptions = {\n    removeUnusedFonts: options.optimizationConfig?.removeUnusedFonts,\n    removeEmptyRules: options.optimizationConfig?.removeEmptyRules,\n    aggregateDuplicateSelectors: options.optimizationConfig?.aggregateDuplicateSelectors,\n    referenceCss: options.referenceCss,\n    scopeClass: options.scopeClass,\n  };\n\n  const optimized = await optimizeCSS(options.css, optimizationOptions);\n  return {\n    css: optimized.css,\n    optimizationStats: {\n      originalSize: optimized.stats.originalSize,\n      originalSizeGzip: optimized.stats.originalSizeGzip,\n      fontFacesRemoved: optimized.stats.fontFacesRemoved,\n      emptyRulesRemoved: optimized.stats.emptyRulesRemoved,\n      validationErrors: optimized.validation.errors,\n    },\n  };\n};\n\nconst printSimpleModeStats = (options: {\n  outputPath: string;\n  totalFilesScanned: number;\n  classCount: number;\n  sizeBytes: number;\n  sizeGzipBytes: number;\n  duration: number;\n  scope?: string;\n  optimizationStats?: {\n    originalSizeGzip: number;\n    fontFacesRemoved: number;\n    emptyRulesRemoved: number;\n    validationErrors: string[];\n  };\n  print: (value: string) => void;\n  magenta: (value: string) => string;\n  cyan: (value: string) => string;\n  yellow: (value: string) => string;\n}): void => {\n  const { print, magenta, cyan, yellow } = options;\n\n  print('');\n  print(`${magenta('Output:')} ${cyan(options.outputPath)}`);\n  print(`${magenta('Stats:')}`);\n  print(`   Files scanned: ${options.totalFilesScanned}`);\n  print(`   Classes: ${options.classCount}`);\n  print(\n    `   Size: ${formatBytes(options.sizeBytes)} (${formatBytes(options.sizeGzipBytes)} gzipped)`,\n  );\n\n  const optimizationStats = options.optimizationStats;\n  if (optimizationStats) {\n    const savedBytesGzip = optimizationStats.originalSizeGzip - options.sizeGzipBytes;\n    if (savedBytesGzip > 0) {\n      print(\n        `   Optimized: saved ${formatBytes(savedBytesGzip)} gzip (${optimizationStats.fontFacesRemoved} unused @font-face, ${optimizationStats.emptyRulesRemoved} empty rules removed)`,\n      );\n    }\n\n    if (optimizationStats.validationErrors.length > 0) {\n      print(`   ${yellow('Validation warnings:')}`);\n      optimizationStats.validationErrors.forEach((error) => print(`      ${yellow('•')} ${error}`));\n    }\n  }\n\n  print(`   Time: ${options.duration}ms`);\n  if (options.scope) {\n    print(`   Scope: ${cyan(options.scope)}`);\n  }\n};\n\nexport {\n  applyScopedColorModeFix,\n  buildPostcssPlugins,\n  createTailwindPlugin,\n  getContentGlobs,\n  getCssFeatureFlags,\n  getInternalIconModeCss,\n  getInternalSafelistRawContent,\n  getPruneVarSafelist,\n  optimizeGeneratedCss,\n  printSimpleModeStats,\n};\n"],"mappings":"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"}
+{"version":3,"file":"generate.helpers.js","names":[],"sources":["../../src/css/generate.helpers.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { UniversalTokensConfig } from '@yahoo/uds-config';\nimport autoprefixer from 'autoprefixer';\nimport postcss from 'postcss';\n// @ts-expect-error - no types\nimport pruneVar from 'postcss-prune-var';\nimport postcssScope from 'postcss-scope';\nimport tailwindcss from 'tailwindcss';\nimport type { SafelistConfig } from 'tailwindcss/types/config';\n\n// eslint-disable-next-line import/no-relative-packages\nimport { iconPruneVarsSafelist } from '../../../icons/src/safelist';\nimport { getInternalSafelistClasses } from '../purger/optimized/utils/safelist';\nimport { getIconStyles } from '../tailwind/components/getIconStyles';\nimport { tailwindPlugin } from '../tailwind/tailwindPlugin';\nimport { hasAllowedEntryFileExtension } from '../utils/entryPoints';\nimport type { OptimizeCSSOptions } from '../utils/optimizeCSS';\nimport { optimizeCSS } from '../utils/optimizeCSS';\nimport { preserveVars, preserveVarsCleanup } from '../utils/postcssPreserveVars';\nimport { fixScopedColorModeSelectorsPlugin, fixScopedSelfOrParentSelectorsPlugin } from './postcss';\nimport { formatCssDuration } from './runner.helpers';\nimport type { UDSCSSOptimizationOptions, UDSCSSVarSafelistPattern } from './theme';\nimport { formatBytes } from './utils';\n\ntype CssOptimizationOptions = UDSCSSOptimizationOptions;\n\ntype CssOptionsLike = {\n  preflight?: boolean;\n  fontFaceDeclarations?: boolean;\n  optimization?: CssOptimizationOptions;\n};\n\ntype CssFeatureFlags = {\n  enablePreflight: boolean;\n  enableFontFaceDeclarations: boolean;\n  shouldOptimize: boolean;\n  shouldPruneVars: boolean;\n};\n\nconst getPruneVarSafelist = (cssOptions?: CssOptionsLike): UDSCSSVarSafelistPattern[] => {\n  const pruneVars = cssOptions?.optimization?.pruneVars;\n  const configuredSafelist =\n    pruneVars && typeof pruneVars === 'object' ? (pruneVars.safelist ?? []) : [];\n\n  return [...iconPruneVarsSafelist, ...configuredSafelist];\n};\n\nconst getCssFeatureFlags = (cssOptions?: CssOptionsLike): CssFeatureFlags => {\n  const optimizationConfig = cssOptions?.optimization;\n  const shouldOptimize = optimizationConfig?.enabled !== false;\n  const pruneVars = optimizationConfig?.pruneVars;\n\n  return {\n    enablePreflight: cssOptions?.preflight !== false,\n    enableFontFaceDeclarations: cssOptions?.fontFaceDeclarations !== false,\n    shouldOptimize,\n    shouldPruneVars: shouldOptimize && pruneVars !== false,\n  };\n};\n\nconst getContentGlobs = (contentDir: string | string[]): string[] => {\n  const contentDirs = Array.isArray(contentDir) ? contentDir : [contentDir];\n\n  return contentDirs.map((dir) =>\n    hasAllowedEntryFileExtension(dir) ? dir : path.join(dir, '**/*.{js,jsx,mjs,cjs,ts,tsx}'),\n  );\n};\n\nconst getRawContentEntries = (rawContents: string[]): Array<{ raw: string; extension: 'html' }> =>\n  rawContents.map((rawContent) => ({ raw: rawContent, extension: 'html' }));\n\nconst getInternalSafelistRawContent = (safelist: SafelistConfig[]): string[] => {\n  const internalClasses = new Set(getInternalSafelistClasses());\n  const matchedInternalClasses = safelist.filter(\n    (entry): entry is string => typeof entry === 'string' && internalClasses.has(entry),\n  );\n\n  if (matchedInternalClasses.length === 0) {\n    return [];\n  }\n\n  return [`<div class=\"${matchedInternalClasses.join(' ')}\"></div>`];\n};\n\nconst getInternalIconModeCss = (scopeClass?: string): string => {\n  const iconStyles = getIconStyles();\n\n  return Object.entries(iconStyles)\n    .map(([selector, declarations]) => {\n      const scopedSelector = scopeClass ? `${scopeClass} ${selector}` : selector;\n      const declarationString = Object.entries(declarations)\n        .map(([property, value]) => `${property}: ${value};`)\n        .join(' ');\n\n      return `${scopedSelector} { ${declarationString} }`;\n    })\n    .join(' ');\n};\n\nconst createTailwindPlugin = (options: {\n  contentDir: string | string[];\n  rawContents?: string[];\n  safelist: SafelistConfig[];\n  config: UniversalTokensConfig;\n  enablePreflight: boolean;\n  enableFontFaceDeclarations: boolean;\n}): postcss.AcceptedPlugin => {\n  const plugin = tailwindcss({\n    content: [\n      ...getContentGlobs(options.contentDir),\n      ...getRawContentEntries(getInternalSafelistRawContent(options.safelist)),\n      ...getRawContentEntries(options.rawContents ?? []),\n    ],\n    safelist: options.safelist,\n    corePlugins: { preflight: options.enablePreflight },\n    plugins: [\n      tailwindPlugin({\n        config: options.config,\n        disableFontFaceDeclarations: !options.enableFontFaceDeclarations,\n        ignorePluginSafelists: true,\n      }),\n    ],\n  });\n\n  return plugin as postcss.AcceptedPlugin;\n};\n\nconst getPruneVarPlugins = (\n  safeVarPrefixes: UDSCSSVarSafelistPattern[],\n): postcss.AcceptedPlugin[] => {\n  if (safeVarPrefixes.length === 0) {\n    return [pruneVar() as postcss.AcceptedPlugin];\n  }\n\n  return [\n    preserveVars({ preserve: safeVarPrefixes }) as postcss.AcceptedPlugin,\n    pruneVar() as postcss.AcceptedPlugin,\n    preserveVarsCleanup() as postcss.AcceptedPlugin,\n  ];\n};\n\nconst buildPostcssPlugins = (options: {\n  tailwindPlugin: postcss.AcceptedPlugin;\n  shouldPruneVars: boolean;\n  safeVarPrefixes: UDSCSSVarSafelistPattern[];\n  scopeClass?: string;\n}): postcss.AcceptedPlugin[] => {\n  const plugins: postcss.AcceptedPlugin[] = [options.tailwindPlugin, autoprefixer()];\n\n  if (options.shouldPruneVars) {\n    plugins.push(...getPruneVarPlugins(options.safeVarPrefixes));\n  }\n\n  if (options.scopeClass) {\n    plugins.push(postcssScope(options.scopeClass) as postcss.AcceptedPlugin);\n  }\n\n  return plugins;\n};\n\nconst applyScopedColorModeFix = async (css: string, scopeClass?: string): Promise<string> => {\n  if (!scopeClass) {\n    return css;\n  }\n\n  const fixResult = await postcss([\n    fixScopedSelfOrParentSelectorsPlugin(scopeClass),\n    fixScopedColorModeSelectorsPlugin(scopeClass),\n  ]).process(css, {\n    from: undefined,\n  });\n\n  return fixResult.css;\n};\n\nconst optimizeGeneratedCss = async (options: {\n  css: string;\n  shouldOptimize: boolean;\n  optimizationConfig?: CssOptimizationOptions;\n  referenceCss?: string;\n  scopeClass?: string;\n}): Promise<{\n  css: string;\n  optimizationStats?: {\n    originalSize: number;\n    originalSizeGzip: number;\n    fontFacesRemoved: number;\n    emptyRulesRemoved: number;\n    validationErrors: string[];\n  };\n}> => {\n  if (!options.shouldOptimize) {\n    return { css: options.css };\n  }\n\n  const optimizationOptions: OptimizeCSSOptions = {\n    removeUnusedFonts: options.optimizationConfig?.removeUnusedFonts,\n    removeEmptyRules: options.optimizationConfig?.removeEmptyRules,\n    aggregateDuplicateSelectors: options.optimizationConfig?.aggregateDuplicateSelectors,\n    referenceCss: options.referenceCss,\n    scopeClass: options.scopeClass,\n  };\n\n  const optimized = await optimizeCSS(options.css, optimizationOptions);\n  return {\n    css: optimized.css,\n    optimizationStats: {\n      originalSize: optimized.stats.originalSize,\n      originalSizeGzip: optimized.stats.originalSizeGzip,\n      fontFacesRemoved: optimized.stats.fontFacesRemoved,\n      emptyRulesRemoved: optimized.stats.emptyRulesRemoved,\n      validationErrors: optimized.validation.errors,\n    },\n  };\n};\n\nconst printSimpleModeStats = (options: {\n  cwd: string;\n  outputPath: string;\n  totalFilesScanned: number;\n  scannedFilePaths?: string[];\n  classCount: number;\n  sizeBytes: number;\n  sizeGzipBytes: number;\n  duration: number;\n  scope?: string;\n  verbose?: boolean;\n  optimizationStats?: {\n    originalSizeGzip: number;\n    fontFacesRemoved: number;\n    emptyRulesRemoved: number;\n    validationErrors: string[];\n  };\n  print: (value: string) => void;\n  magenta: (value: string) => string;\n  cyan: (value: string) => string;\n  yellow: (value: string) => string;\n}): void => {\n  const { print, magenta, cyan, yellow } = options;\n  const getDisplayPath = (targetPath: string): string => {\n    const relativePath = path.relative(options.cwd, targetPath);\n    return relativePath.length === 0 ? '.' : relativePath;\n  };\n\n  print('');\n  print(`${magenta('Output:')} ${cyan(getDisplayPath(options.outputPath))}`);\n  print(`${magenta('Stats:')}`);\n  print(`   Files scanned: ${options.totalFilesScanned}`);\n  if (options.verbose && options.scannedFilePaths && options.scannedFilePaths.length > 0) {\n    [...new Set(options.scannedFilePaths)]\n      .sort((left, right) => left.localeCompare(right))\n      .forEach((filePath) => print(`      • ${cyan(getDisplayPath(filePath))}`));\n  }\n  print(`   Classes: ${options.classCount}`);\n  print(\n    `   Size: ${formatBytes(options.sizeBytes)} (${formatBytes(options.sizeGzipBytes)} gzipped)`,\n  );\n\n  const optimizationStats = options.optimizationStats;\n  if (optimizationStats) {\n    const savedBytesGzip = optimizationStats.originalSizeGzip - options.sizeGzipBytes;\n    if (savedBytesGzip > 0) {\n      if (optimizationStats.fontFacesRemoved > 0) {\n        print(`      • removed ${optimizationStats.fontFacesRemoved} unused @font-face`);\n      }\n      if (optimizationStats.emptyRulesRemoved > 0) {\n        print(`      • removed ${optimizationStats.emptyRulesRemoved} empty rules`);\n      }\n    }\n\n    if (optimizationStats.validationErrors.length > 0) {\n      print(`   ${yellow('Validation warnings:')}`);\n      optimizationStats.validationErrors.forEach((error) => print(`      ${yellow('•')} ${error}`));\n    }\n  }\n\n  print(`   Time: ${formatCssDuration(options.duration)}`);\n  if (options.scope) {\n    print(`   Scope: ${cyan(options.scope)}`);\n  }\n};\n\nexport {\n  applyScopedColorModeFix,\n  buildPostcssPlugins,\n  createTailwindPlugin,\n  getContentGlobs,\n  getCssFeatureFlags,\n  getInternalIconModeCss,\n  getInternalSafelistRawContent,\n  getPruneVarSafelist,\n  optimizeGeneratedCss,\n  printSimpleModeStats,\n};\n"],"mappings":"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"}

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

@@ -105,13 +105,16 @@ const generateSimpleModeCSS = async (options) => {
 	fs.writeFileSync(outputPath, cssResult.css);
 	const duration = Math.round(performance.now() - startTime);
 	if (shouldLogStats) printSimpleModeStats({
+		cwd: options.workspaceDir,
 		outputPath,
 		totalFilesScanned,
+		scannedFilePaths: scanResult.filePaths,
 		classCount: cssResult.classCount,
 		sizeBytes: cssResult.sizeBytes,
 		sizeGzipBytes: cssResult.sizeGzipBytes,
 		duration,
 		scope: options.scope,
+		verbose: options.verbose,
 		optimizationStats: cssResult.optimizationStats,
 		print,
 		magenta,

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}): 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      outputPath,\n      totalFilesScanned,\n      classCount: cssResult.classCount,\n      sizeBytes: cssResult.sizeBytes,\n      sizeGzipBytes: cssResult.sizeGzipBytes,\n      duration,\n      scope: options.scope,\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 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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"}

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

@@ -24,11 +24,11 @@ const loadConfigFile = async (configPath) => {
 	}
 };
 const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
-	const files = await (0, fast_glob.default)("**/*.{js,jsx,ts,tsx}", {
+	const files = (await (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"), {
 			colorModes,
@@ -41,10 +41,15 @@ const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants,
 			filePath
 		});
 	}));
+	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;
 	return {
-		safelist: results.flatMap((result) => result.safelist),
-		components: [...new Set(results.flatMap((result) => result.components))],
-		filesScanned: files.length
+		safelist: allClasses,
+		components: [...allComponents],
+		filesScanned: files.length,
+		filesWithComponents,
+		filePaths: files
 	};
 };
 const scanFileForSafelist = async (filePath, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
@@ -60,7 +65,9 @@ const scanFileForSafelist = async (filePath, colorModes, variants, autoVariants,
 	return {
 		safelist: result.safelist,
 		components: result.components,
-		filesScanned: 1
+		filesScanned: 1,
+		filesWithComponents: result.components.length > 0 ? 1 : 0,
+		filePaths: [filePath]
 	};
 };
 const scanDirectoriesForSafelist = async (dirs, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
@@ -71,7 +78,9 @@ const scanDirectoriesForSafelist = async (dirs, colorModes, variants, autoVarian
 	return {
 		safelist: results.flatMap((result) => result.safelist),
 		components: [...new Set(results.flatMap((result) => result.components))],
-		filesScanned: results.reduce((total, result) => total + result.filesScanned, 0)
+		filesScanned: results.reduce((total, result) => total + result.filesScanned, 0),
+		filesWithComponents: results.reduce((total, result) => total + result.filesWithComponents, 0),
+		filePaths: results.flatMap((result) => result.filePaths).sort((left, right) => left.localeCompare(right))
 	};
 };
 const findMonorepoRoot = (startDir) => {
@@ -82,13 +91,45 @@ const findMonorepoRoot = (startDir) => {
 	};
 	return findUp(startDir);
 };
+const readPackageName = (packageJsonPath) => {
+	try {
+		const pkgJson = JSON.parse(node_fs.default.readFileSync(packageJsonPath, "utf8"));
+		return typeof pkgJson.name === "string" ? pkgJson.name : null;
+	} catch {
+		return null;
+	}
+};
+const findPackageRootFromResolvedEntry = (resolvedEntryPath, packageName) => {
+	let currentPath = node_fs.default.statSync(resolvedEntryPath).isDirectory() ? resolvedEntryPath : node_path.default.dirname(resolvedEntryPath);
+	while (true) {
+		const packageJsonPath = node_path.default.join(currentPath, "package.json");
+		if (node_fs.default.existsSync(packageJsonPath) && readPackageName(packageJsonPath) === packageName) return currentPath;
+		const parentPath = node_path.default.dirname(currentPath);
+		if (parentPath === currentPath) return null;
+		currentPath = parentPath;
+	}
+};
+const findPackageRootInNodeModules = (startDir, packageName) => {
+	let currentDir = startDir;
+	while (true) {
+		const packageJsonPath = node_path.default.join(currentDir, "node_modules", packageName, "package.json");
+		if (node_fs.default.existsSync(packageJsonPath)) return node_path.default.dirname(packageJsonPath);
+		const parentDir = node_path.default.dirname(currentDir);
+		if (parentDir === currentDir) return null;
+		currentDir = parentDir;
+	}
+};
 const resolvePackageRoot = (workspaceDir, packageName) => {
-	const require = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+	const requireFromWorkspace = (0, node_module.createRequire)(node_path.default.join(workspaceDir, "package.json"));
 	try {
-		const resolvedPackageJson = require.resolve(node_path.default.join(packageName, "package.json"), { paths: [workspaceDir] });
+		const resolvedPackageJson = requireFromWorkspace.resolve(node_path.default.join(packageName, "package.json"));
 		return node_path.default.dirname(resolvedPackageJson);
 	} catch {
-		return null;
+		try {
+			const packageRoot = findPackageRootFromResolvedEntry(requireFromWorkspace.resolve(packageName), packageName);
+			if (packageRoot) return packageRoot;
+		} catch {}
+		return findPackageRootInNodeModules(workspaceDir, packageName);
 	}
 };
 const findPackageRootInMonorepo = (monorepoRoot, packageName) => {
@@ -97,14 +138,17 @@ const findPackageRootInMonorepo = (monorepoRoot, packageName) => {
 		absolute: true,
 		ignore: ["**/node_modules/**", "**/dist/**"]
 	}).find((pkgJsonPath) => {
-		try {
-			return JSON.parse(node_fs.default.readFileSync(pkgJsonPath, "utf8")).name === packageName;
-		} catch {
-			return false;
-		}
+		return readPackageName(pkgJsonPath) === packageName;
 	});
 	return matchingPath ? node_path.default.dirname(matchingPath) : null;
 };
+const findPackageRoot = (packageName) => {
+	const workspaceDir = process.cwd();
+	const monorepoRoot = findMonorepoRoot(workspaceDir);
+	let packageRoot = resolvePackageRoot(workspaceDir, packageName);
+	if (!packageRoot && monorepoRoot) packageRoot = findPackageRootInMonorepo(monorepoRoot, packageName);
+	return packageRoot;
+};
 const buildPackageSourceCandidates = (workspaceDir, packageName, packageRoot) => {
 	return [
 		packageRoot ? node_path.default.join(packageRoot, "src") : null,
@@ -119,11 +163,19 @@ const buildPackageSourceCandidates = (workspaceDir, packageName, packageRoot) =>
 };
 const getFirstExistingPath = (candidates) => candidates.find((candidate) => node_fs.default.existsSync(candidate)) ?? null;
 const findPackageSourceDir = (packageName) => {
-	const workspaceDir = process.cwd();
-	const monorepoRoot = findMonorepoRoot(workspaceDir);
-	let packageRoot = resolvePackageRoot(workspaceDir, packageName);
-	if (!packageRoot && monorepoRoot) packageRoot = findPackageRootInMonorepo(monorepoRoot, packageName);
-	return getFirstExistingPath(buildPackageSourceCandidates(workspaceDir, packageName, packageRoot));
+	return getFirstExistingPath(buildPackageSourceCandidates(process.cwd(), packageName, findPackageRoot(packageName)));
+};
+const getPackageUdsScope = (packageName) => {
+	const packageRoot = findPackageRoot(packageName);
+	if (!packageRoot) return null;
+	const packageJsonPath = node_path.default.join(packageRoot, "package.json");
+	if (!node_fs.default.existsSync(packageJsonPath)) return null;
+	try {
+		const scope = JSON.parse(node_fs.default.readFileSync(packageJsonPath, "utf8")).uds?.scope;
+		return typeof scope === "string" && scope.trim().length > 0 ? scope.trim() : null;
+	} catch {
+		return null;
+	}
 };
 const scaffoldThemeConfig = async (options) => {
 	const workspaceDir = process.cwd();
@@ -155,6 +207,23 @@ export default defineTheme({
   // Packages that inherit your app's theme (merged into main uds.css)
   // inherit: ['@your-org/shared-ui'],
 
+  // Packages that generate separate scoped CSS outputs.
+  // Scope class is discovered from each package.json uds.scope.
+  // When entry is omitted, the package is scanned the same way as inherit.
+  // scoped: {
+  //   '@your-org/shared-ui': './packages/shared-ui/uds.config.ts'
+  // }
+  //
+  // Or use the expanded form for custom output paths:
+  // scoped: {
+  //   '@your-org/shared-ui': {
+  //     config: './packages/shared-ui/uds.config.ts',
+  //     entry: './src',
+  //     // outFile defaults to dist/shared-ui.css
+  //     outFile: 'dist/shared-ui.css'
+  //   },
+  // },
+
   // CSS generation options (all optional)
   // css: {
   //   safelist: [],
@@ -179,7 +248,9 @@ export default defineTheme({
 };
 
 //#endregion
+exports.findPackageRoot = findPackageRoot;
 exports.findPackageSourceDir = findPackageSourceDir;
+exports.getPackageUdsScope = getPackageUdsScope;
 exports.loadConfigFile = loadConfigFile;
 exports.scaffoldThemeConfig = scaffoldThemeConfig;
 exports.scanDirectoriesForSafelist = scanDirectoriesForSafelist;

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

@@ -20,11 +20,11 @@ const loadConfigFile = async (configPath) => {
 	}
 };
 const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
-	const files = await fg("**/*.{js,jsx,ts,tsx}", {
+	const files = (await 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"), {
 			colorModes,
@@ -37,10 +37,15 @@ const scanDirectoryForSafelist = async (dir, colorModes, variants, autoVariants,
 			filePath
 		});
 	}));
+	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;
 	return {
-		safelist: results.flatMap((result) => result.safelist),
-		components: [...new Set(results.flatMap((result) => result.components))],
-		filesScanned: files.length
+		safelist: allClasses,
+		components: [...allComponents],
+		filesScanned: files.length,
+		filesWithComponents,
+		filePaths: files
 	};
 };
 const scanFileForSafelist = async (filePath, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
@@ -56,7 +61,9 @@ const scanFileForSafelist = async (filePath, colorModes, variants, autoVariants,
 	return {
 		safelist: result.safelist,
 		components: result.components,
-		filesScanned: 1
+		filesScanned: 1,
+		filesWithComponents: result.components.length > 0 ? 1 : 0,
+		filePaths: [filePath]
 	};
 };
 const scanDirectoriesForSafelist = async (dirs, colorModes, variants, autoVariants, componentData, variantDefaults, runtimeConfigValues, includeAllClassNamePrimitives = false) => {
@@ -67,7 +74,9 @@ const scanDirectoriesForSafelist = async (dirs, colorModes, variants, autoVarian
 	return {
 		safelist: results.flatMap((result) => result.safelist),
 		components: [...new Set(results.flatMap((result) => result.components))],
-		filesScanned: results.reduce((total, result) => total + result.filesScanned, 0)
+		filesScanned: results.reduce((total, result) => total + result.filesScanned, 0),
+		filesWithComponents: results.reduce((total, result) => total + result.filesWithComponents, 0),
+		filePaths: results.flatMap((result) => result.filePaths).sort((left, right) => left.localeCompare(right))
 	};
 };
 const findMonorepoRoot = (startDir) => {
@@ -78,13 +87,45 @@ const findMonorepoRoot = (startDir) => {
 	};
 	return findUp(startDir);
 };
+const readPackageName = (packageJsonPath) => {
+	try {
+		const pkgJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+		return typeof pkgJson.name === "string" ? pkgJson.name : null;
+	} catch {
+		return null;
+	}
+};
+const findPackageRootFromResolvedEntry = (resolvedEntryPath, packageName) => {
+	let currentPath = fs.statSync(resolvedEntryPath).isDirectory() ? resolvedEntryPath : path.dirname(resolvedEntryPath);
+	while (true) {
+		const packageJsonPath = path.join(currentPath, "package.json");
+		if (fs.existsSync(packageJsonPath) && readPackageName(packageJsonPath) === packageName) return currentPath;
+		const parentPath = path.dirname(currentPath);
+		if (parentPath === currentPath) return null;
+		currentPath = parentPath;
+	}
+};
+const findPackageRootInNodeModules = (startDir, packageName) => {
+	let currentDir = startDir;
+	while (true) {
+		const packageJsonPath = path.join(currentDir, "node_modules", packageName, "package.json");
+		if (fs.existsSync(packageJsonPath)) return path.dirname(packageJsonPath);
+		const parentDir = path.dirname(currentDir);
+		if (parentDir === currentDir) return null;
+		currentDir = parentDir;
+	}
+};
 const resolvePackageRoot = (workspaceDir, packageName) => {
-	const require = createRequire(import.meta.url);
+	const requireFromWorkspace = createRequire(path.join(workspaceDir, "package.json"));
 	try {
-		const resolvedPackageJson = require.resolve(path.join(packageName, "package.json"), { paths: [workspaceDir] });
+		const resolvedPackageJson = requireFromWorkspace.resolve(path.join(packageName, "package.json"));
 		return path.dirname(resolvedPackageJson);
 	} catch {
-		return null;
+		try {
+			const packageRoot = findPackageRootFromResolvedEntry(requireFromWorkspace.resolve(packageName), packageName);
+			if (packageRoot) return packageRoot;
+		} catch {}
+		return findPackageRootInNodeModules(workspaceDir, packageName);
 	}
 };
 const findPackageRootInMonorepo = (monorepoRoot, packageName) => {
@@ -93,14 +134,17 @@ const findPackageRootInMonorepo = (monorepoRoot, packageName) => {
 		absolute: true,
 		ignore: ["**/node_modules/**", "**/dist/**"]
 	}).find((pkgJsonPath) => {
-		try {
-			return JSON.parse(fs.readFileSync(pkgJsonPath, "utf8")).name === packageName;
-		} catch {
-			return false;
-		}
+		return readPackageName(pkgJsonPath) === packageName;
 	});
 	return matchingPath ? path.dirname(matchingPath) : null;
 };
+const findPackageRoot = (packageName) => {
+	const workspaceDir = process.cwd();
+	const monorepoRoot = findMonorepoRoot(workspaceDir);
+	let packageRoot = resolvePackageRoot(workspaceDir, packageName);
+	if (!packageRoot && monorepoRoot) packageRoot = findPackageRootInMonorepo(monorepoRoot, packageName);
+	return packageRoot;
+};
 const buildPackageSourceCandidates = (workspaceDir, packageName, packageRoot) => {
 	return [
 		packageRoot ? path.join(packageRoot, "src") : null,
@@ -115,11 +159,19 @@ const buildPackageSourceCandidates = (workspaceDir, packageName, packageRoot) =>
 };
 const getFirstExistingPath = (candidates) => candidates.find((candidate) => fs.existsSync(candidate)) ?? null;
 const findPackageSourceDir = (packageName) => {
-	const workspaceDir = process.cwd();
-	const monorepoRoot = findMonorepoRoot(workspaceDir);
-	let packageRoot = resolvePackageRoot(workspaceDir, packageName);
-	if (!packageRoot && monorepoRoot) packageRoot = findPackageRootInMonorepo(monorepoRoot, packageName);
-	return getFirstExistingPath(buildPackageSourceCandidates(workspaceDir, packageName, packageRoot));
+	return getFirstExistingPath(buildPackageSourceCandidates(process.cwd(), packageName, findPackageRoot(packageName)));
+};
+const getPackageUdsScope = (packageName) => {
+	const packageRoot = findPackageRoot(packageName);
+	if (!packageRoot) return null;
+	const packageJsonPath = path.join(packageRoot, "package.json");
+	if (!fs.existsSync(packageJsonPath)) return null;
+	try {
+		const scope = JSON.parse(fs.readFileSync(packageJsonPath, "utf8")).uds?.scope;
+		return typeof scope === "string" && scope.trim().length > 0 ? scope.trim() : null;
+	} catch {
+		return null;
+	}
 };
 const scaffoldThemeConfig = async (options) => {
 	const workspaceDir = process.cwd();
@@ -151,6 +203,23 @@ export default defineTheme({
   // Packages that inherit your app's theme (merged into main uds.css)
   // inherit: ['@your-org/shared-ui'],
 
+  // Packages that generate separate scoped CSS outputs.
+  // Scope class is discovered from each package.json uds.scope.
+  // When entry is omitted, the package is scanned the same way as inherit.
+  // scoped: {
+  //   '@your-org/shared-ui': './packages/shared-ui/uds.config.ts'
+  // }
+  //
+  // Or use the expanded form for custom output paths:
+  // scoped: {
+  //   '@your-org/shared-ui': {
+  //     config: './packages/shared-ui/uds.config.ts',
+  //     entry: './src',
+  //     // outFile defaults to dist/shared-ui.css
+  //     outFile: 'dist/shared-ui.css'
+  //   },
+  // },
+
   // CSS generation options (all optional)
   // css: {
   //   safelist: [],
@@ -175,5 +244,5 @@ export default defineTheme({
 };
 
 //#endregion
-export { findPackageSourceDir, loadConfigFile, scaffoldThemeConfig, scanDirectoriesForSafelist, scanDirectoryForSafelist };
+export { findPackageRoot, findPackageSourceDir, getPackageUdsScope, loadConfigFile, scaffoldThemeConfig, scanDirectoriesForSafelist, scanDirectoryForSafelist };
 //# sourceMappingURL=nodeUtils.js.map