@yahoo/uds 3.123.0 → 3.124.0-beta.1

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\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<{ safelist: string[]; components: string[]; filesScanned: number }> => {\n  const files = await fg('**/*.{js,jsx,ts,tsx}', {\n    cwd: dir,\n    absolute: true,\n    ignore: ['**/node_modules/**'],\n  });\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\n  return {\n    safelist: allClasses,\n    components: [...allComponents],\n    filesScanned: files.length,\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<{ safelist: string[]; components: string[]; filesScanned: number }> => {\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  };\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<{ safelist: string[]; components: string[]; filesScanned: number }> => {\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  };\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 resolvePackageRoot = (workspaceDir: string, packageName: string): string | null => {\n  const require = createRequire(import.meta.url);\n\n  try {\n    const resolvedPackageJson = require.resolve(path.join(packageName, 'package.json'), {\n      paths: [workspaceDir],\n    });\n    return path.dirname(resolvedPackageJson);\n  } catch {\n    return null;\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    try {\n      const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8')) as { name?: string };\n      return pkgJson.name === packageName;\n    } catch {\n      return false;\n    }\n  });\n\n  return matchingPath ? path.dirname(matchingPath) : null;\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 monorepoRoot = findMonorepoRoot(workspaceDir);\n\n  let packageRoot = resolvePackageRoot(workspaceDir, packageName);\n  if (!packageRoot && monorepoRoot) {\n    packageRoot = findPackageRootInMonorepo(monorepoRoot, packageName);\n  }\n\n  return getFirstExistingPath(buildPackageSourceCandidates(workspaceDir, packageName, packageRoot));\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  // 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  findPackageSourceDir,\n  loadConfigFile,\n  scaffoldThemeConfig,\n  scanDirectoriesForSafelist,\n  scanDirectoryForSafelist,\n};\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';\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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"}

package/dist/tailwind/dist/css/postcss.cjs

@@ -2,6 +2,26 @@
 const require_postcss_helpers = require('./postcss.helpers.cjs');
 
 //#region src/css/postcss.ts
+const fixScopedSelfOrParentSelectorsPlugin = (scopeClass) => {
+	return {
+		postcssPlugin: "fix-scoped-self-or-parent-selectors",
+		Once(root) {
+			root.walkRules((rule) => {
+				if (!rule.selector.includes(scopeClass)) return;
+				const nextSelectors = rule.selectors.reduce((acc, selector) => {
+					const sameElementSelector = require_postcss_helpers.getScopedSelfOrParentAlternativeSelector(selector, scopeClass);
+					if (sameElementSelector && !rule.selectors.includes(sameElementSelector)) return [
+						...acc,
+						selector,
+						sameElementSelector
+					];
+					return [...acc, selector];
+				}, []);
+				if (nextSelectors.length !== rule.selectors.length) rule.selectors = nextSelectors;
+			});
+		}
+	};
+};
 /**
 * PostCSS plugin to fix color mode selectors for scoped CSS.
 *
@@ -31,4 +51,5 @@ const fixScopedColorModeSelectorsPlugin = (scopeClass) => {
 };
 
 //#endregion
-exports.fixScopedColorModeSelectorsPlugin = fixScopedColorModeSelectorsPlugin;
+exports.fixScopedColorModeSelectorsPlugin = fixScopedColorModeSelectorsPlugin;
+exports.fixScopedSelfOrParentSelectorsPlugin = fixScopedSelfOrParentSelectorsPlugin;

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

@@ -3,6 +3,7 @@
 //#region src/css/postcss.helpers.ts
 const COLOR_MODE_RE = /^(\.(uds-color-mode-(?:dark|light)))(\s+.+)?$/;
 const escapeForRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+const SCOPED_SELF_OR_PARENT_RE = /^(\.[^\s>+~]+)(.*)$/;
 const getScopedColorModeAlternativeSelector = (selector, scopeClass, variant = "descendant") => {
 	const scopeMatch = selector.match(new RegExp(`^(${escapeForRegExp(scopeClass)})\\s+(.+)$`));
 	if (!scopeMatch) return null;
@@ -23,6 +24,16 @@ const buildScopedColorModeSelectorList = (ruleSelector, scopeClass) => {
 		];
 	}, []).join(", ");
 };
+const getScopedSelfOrParentAlternativeSelector = (selector, scopeClass) => {
+	const scopeMatch = selector.match(new RegExp(`^(${escapeForRegExp(scopeClass)})\\s+(.+)$`));
+	if (!scopeMatch) return null;
+	const targetMatch = scopeMatch[2].match(SCOPED_SELF_OR_PARENT_RE);
+	if (!targetMatch) return null;
+	const scopedTarget = targetMatch[1];
+	if (/^\.uds-color-mode-(?:dark|light)(?:$|[.#[:])/.test(scopedTarget)) return null;
+	return `${scopeClass}${scopedTarget}${targetMatch[2]}`;
+};
 
 //#endregion
-exports.buildScopedColorModeSelectorList = buildScopedColorModeSelectorList;
+exports.buildScopedColorModeSelectorList = buildScopedColorModeSelectorList;
+exports.getScopedSelfOrParentAlternativeSelector = getScopedSelfOrParentAlternativeSelector;

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

@@ -2,6 +2,7 @@
 //#region src/css/postcss.helpers.ts
 const COLOR_MODE_RE = /^(\.(uds-color-mode-(?:dark|light)))(\s+.+)?$/;
 const escapeForRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+const SCOPED_SELF_OR_PARENT_RE = /^(\.[^\s>+~]+)(.*)$/;
 const getScopedColorModeAlternativeSelector = (selector, scopeClass, variant = "descendant") => {
 	const scopeMatch = selector.match(new RegExp(`^(${escapeForRegExp(scopeClass)})\\s+(.+)$`));
 	if (!scopeMatch) return null;
@@ -22,7 +23,16 @@ const buildScopedColorModeSelectorList = (ruleSelector, scopeClass) => {
 		];
 	}, []).join(", ");
 };
+const getScopedSelfOrParentAlternativeSelector = (selector, scopeClass) => {
+	const scopeMatch = selector.match(new RegExp(`^(${escapeForRegExp(scopeClass)})\\s+(.+)$`));
+	if (!scopeMatch) return null;
+	const targetMatch = scopeMatch[2].match(SCOPED_SELF_OR_PARENT_RE);
+	if (!targetMatch) return null;
+	const scopedTarget = targetMatch[1];
+	if (/^\.uds-color-mode-(?:dark|light)(?:$|[.#[:])/.test(scopedTarget)) return null;
+	return `${scopeClass}${scopedTarget}${targetMatch[2]}`;
+};
 
 //#endregion
-export { buildScopedColorModeSelectorList };
+export { buildScopedColorModeSelectorList, getScopedSelfOrParentAlternativeSelector };
 //# sourceMappingURL=postcss.helpers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"postcss.helpers.js","names":[],"sources":["../../src/css/postcss.helpers.ts"],"sourcesContent":["const COLOR_MODE_RE = /^(\\.(uds-color-mode-(?:dark|light)))(\\s+.+)?$/;\n\nconst escapeForRegExp = (value: string): string => value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\ntype ScopedColorModeSelectorVariant = 'descendant' | 'same-element';\n\nconst getScopedColorModeAlternativeSelector = (\n  selector: string,\n  scopeClass: string,\n  variant: ScopedColorModeSelectorVariant = 'descendant',\n): string | null => {\n  const scopeMatch = selector.match(new RegExp(`^(${escapeForRegExp(scopeClass)})\\\\s+(.+)$`));\n\n  if (!scopeMatch) {\n    return null;\n  }\n\n  const afterScope = scopeMatch[2];\n  const colorModeMatch = afterScope.match(COLOR_MODE_RE);\n  if (!colorModeMatch) {\n    return null;\n  }\n\n  const colorModeClass = colorModeMatch[1];\n  const rest = colorModeMatch[3] ?? '';\n  return variant === 'same-element'\n    ? `${colorModeClass}${scopeClass}${rest}`\n    : `${colorModeClass} ${scopeClass}${rest}`;\n};\n\nconst buildScopedColorModeSelectorList = (ruleSelector: string, scopeClass: string): string => {\n  const selectors = ruleSelector.split(',').map((value) => value.trim());\n  const nextSelectors = selectors.reduce<string[]>((acc, selector) => {\n    const altSelectors = [\n      getScopedColorModeAlternativeSelector(selector, scopeClass),\n      getScopedColorModeAlternativeSelector(selector, scopeClass, 'same-element'),\n    ].filter((value): value is string => Boolean(value));\n    const nextAltSelectors = altSelectors.filter(\n      (altSelector) => !selectors.includes(altSelector) && !acc.includes(altSelector),\n    );\n\n    return [...acc, selector, ...nextAltSelectors];\n  }, []);\n\n  return nextSelectors.join(', ');\n};\n\nexport { buildScopedColorModeSelectorList, getScopedColorModeAlternativeSelector };\n"],"mappings":";;AAAA,MAAM,gBAAgB;AAEtB,MAAM,mBAAmB,UAA0B,MAAM,QAAQ,uBAAuB,OAAO;AAI/F,MAAM,yCACJ,UACA,YACA,UAA0C,iBACxB;CAClB,MAAM,aAAa,SAAS,MAAM,IAAI,OAAO,KAAK,gBAAgB,WAAW,CAAC,YAAY,CAAC;AAE3F,KAAI,CAAC,WACH,QAAO;CAIT,MAAM,iBADa,WAAW,GACI,MAAM,cAAc;AACtD,KAAI,CAAC,eACH,QAAO;CAGT,MAAM,iBAAiB,eAAe;CACtC,MAAM,OAAO,eAAe,MAAM;AAClC,QAAO,YAAY,iBACf,GAAG,iBAAiB,aAAa,SACjC,GAAG,eAAe,GAAG,aAAa;;AAGxC,MAAM,oCAAoC,cAAsB,eAA+B;CAC7F,MAAM,YAAY,aAAa,MAAM,IAAI,CAAC,KAAK,UAAU,MAAM,MAAM,CAAC;AAatE,QAZsB,UAAU,QAAkB,KAAK,aAAa;EAKlE,MAAM,mBAJe,CACnB,sCAAsC,UAAU,WAAW,EAC3D,sCAAsC,UAAU,YAAY,eAAe,CAC5E,CAAC,QAAQ,UAA2B,QAAQ,MAAM,CAAC,CACd,QACnC,gBAAgB,CAAC,UAAU,SAAS,YAAY,IAAI,CAAC,IAAI,SAAS,YAAY,CAChF;AAED,SAAO;GAAC,GAAG;GAAK;GAAU,GAAG;GAAiB;IAC7C,EAAE,CAAC,CAEe,KAAK,KAAK"}
+{"version":3,"file":"postcss.helpers.js","names":[],"sources":["../../src/css/postcss.helpers.ts"],"sourcesContent":["const COLOR_MODE_RE = /^(\\.(uds-color-mode-(?:dark|light)))(\\s+.+)?$/;\n\nconst escapeForRegExp = (value: string): string => value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\ntype ScopedColorModeSelectorVariant = 'descendant' | 'same-element';\n\nconst SCOPED_SELF_OR_PARENT_RE = /^(\\.[^\\s>+~]+)(.*)$/;\n\nconst getScopedColorModeAlternativeSelector = (\n  selector: string,\n  scopeClass: string,\n  variant: ScopedColorModeSelectorVariant = 'descendant',\n): string | null => {\n  const scopeMatch = selector.match(new RegExp(`^(${escapeForRegExp(scopeClass)})\\\\s+(.+)$`));\n\n  if (!scopeMatch) {\n    return null;\n  }\n\n  const afterScope = scopeMatch[2];\n  const colorModeMatch = afterScope.match(COLOR_MODE_RE);\n  if (!colorModeMatch) {\n    return null;\n  }\n\n  const colorModeClass = colorModeMatch[1];\n  const rest = colorModeMatch[3] ?? '';\n  return variant === 'same-element'\n    ? `${colorModeClass}${scopeClass}${rest}`\n    : `${colorModeClass} ${scopeClass}${rest}`;\n};\n\nconst buildScopedColorModeSelectorList = (ruleSelector: string, scopeClass: string): string => {\n  const selectors = ruleSelector.split(',').map((value) => value.trim());\n  const nextSelectors = selectors.reduce<string[]>((acc, selector) => {\n    const altSelectors = [\n      getScopedColorModeAlternativeSelector(selector, scopeClass),\n      getScopedColorModeAlternativeSelector(selector, scopeClass, 'same-element'),\n    ].filter((value): value is string => Boolean(value));\n    const nextAltSelectors = altSelectors.filter(\n      (altSelector) => !selectors.includes(altSelector) && !acc.includes(altSelector),\n    );\n\n    return [...acc, selector, ...nextAltSelectors];\n  }, []);\n\n  return nextSelectors.join(', ');\n};\n\nconst getScopedSelfOrParentAlternativeSelector = (\n  selector: string,\n  scopeClass: string,\n): string | null => {\n  const scopeMatch = selector.match(new RegExp(`^(${escapeForRegExp(scopeClass)})\\\\s+(.+)$`));\n\n  if (!scopeMatch) {\n    return null;\n  }\n\n  const afterScope = scopeMatch[2];\n  const targetMatch = afterScope.match(SCOPED_SELF_OR_PARENT_RE);\n  if (!targetMatch) {\n    return null;\n  }\n\n  const scopedTarget = targetMatch[1];\n  if (/^\\.uds-color-mode-(?:dark|light)(?:$|[.#[:])/.test(scopedTarget)) {\n    return null;\n  }\n\n  return `${scopeClass}${scopedTarget}${targetMatch[2]}`;\n};\n\nconst buildScopedSelfOrParentSelectorList = (ruleSelector: string, scopeClass: string): string => {\n  const selectors = ruleSelector.split(',').map((value) => value.trim());\n  const nextSelectors = selectors.reduce<string[]>((acc, selector) => {\n    const sameElementSelector = getScopedSelfOrParentAlternativeSelector(selector, scopeClass);\n    const nextAltSelectors: string[] = [];\n\n    if (\n      sameElementSelector &&\n      !selectors.includes(sameElementSelector) &&\n      !acc.includes(sameElementSelector)\n    ) {\n      nextAltSelectors.push(sameElementSelector);\n    }\n\n    return [...acc, selector, ...nextAltSelectors];\n  }, []);\n\n  return nextSelectors.join(', ');\n};\n\nexport {\n  buildScopedColorModeSelectorList,\n  buildScopedSelfOrParentSelectorList,\n  getScopedColorModeAlternativeSelector,\n  getScopedSelfOrParentAlternativeSelector,\n};\n"],"mappings":";;AAAA,MAAM,gBAAgB;AAEtB,MAAM,mBAAmB,UAA0B,MAAM,QAAQ,uBAAuB,OAAO;AAI/F,MAAM,2BAA2B;AAEjC,MAAM,yCACJ,UACA,YACA,UAA0C,iBACxB;CAClB,MAAM,aAAa,SAAS,MAAM,IAAI,OAAO,KAAK,gBAAgB,WAAW,CAAC,YAAY,CAAC;AAE3F,KAAI,CAAC,WACH,QAAO;CAIT,MAAM,iBADa,WAAW,GACI,MAAM,cAAc;AACtD,KAAI,CAAC,eACH,QAAO;CAGT,MAAM,iBAAiB,eAAe;CACtC,MAAM,OAAO,eAAe,MAAM;AAClC,QAAO,YAAY,iBACf,GAAG,iBAAiB,aAAa,SACjC,GAAG,eAAe,GAAG,aAAa;;AAGxC,MAAM,oCAAoC,cAAsB,eAA+B;CAC7F,MAAM,YAAY,aAAa,MAAM,IAAI,CAAC,KAAK,UAAU,MAAM,MAAM,CAAC;AAatE,QAZsB,UAAU,QAAkB,KAAK,aAAa;EAKlE,MAAM,mBAJe,CACnB,sCAAsC,UAAU,WAAW,EAC3D,sCAAsC,UAAU,YAAY,eAAe,CAC5E,CAAC,QAAQ,UAA2B,QAAQ,MAAM,CAAC,CACd,QACnC,gBAAgB,CAAC,UAAU,SAAS,YAAY,IAAI,CAAC,IAAI,SAAS,YAAY,CAChF;AAED,SAAO;GAAC,GAAG;GAAK;GAAU,GAAG;GAAiB;IAC7C,EAAE,CAAC,CAEe,KAAK,KAAK;;AAGjC,MAAM,4CACJ,UACA,eACkB;CAClB,MAAM,aAAa,SAAS,MAAM,IAAI,OAAO,KAAK,gBAAgB,WAAW,CAAC,YAAY,CAAC;AAE3F,KAAI,CAAC,WACH,QAAO;CAIT,MAAM,cADa,WAAW,GACC,MAAM,yBAAyB;AAC9D,KAAI,CAAC,YACH,QAAO;CAGT,MAAM,eAAe,YAAY;AACjC,KAAI,+CAA+C,KAAK,aAAa,CACnE,QAAO;AAGT,QAAO,GAAG,aAAa,eAAe,YAAY"}

package/dist/tailwind/dist/css/postcss.js

@@ -1,7 +1,27 @@
 /*! © 2026 Yahoo, Inc. UDS Tailwind and Purger v0.0.0-development */
-import { buildScopedColorModeSelectorList } from "./postcss.helpers.js";
+import { buildScopedColorModeSelectorList, getScopedSelfOrParentAlternativeSelector } from "./postcss.helpers.js";
 
 //#region src/css/postcss.ts
+const fixScopedSelfOrParentSelectorsPlugin = (scopeClass) => {
+	return {
+		postcssPlugin: "fix-scoped-self-or-parent-selectors",
+		Once(root) {
+			root.walkRules((rule) => {
+				if (!rule.selector.includes(scopeClass)) return;
+				const nextSelectors = rule.selectors.reduce((acc, selector) => {
+					const sameElementSelector = getScopedSelfOrParentAlternativeSelector(selector, scopeClass);
+					if (sameElementSelector && !rule.selectors.includes(sameElementSelector)) return [
+						...acc,
+						selector,
+						sameElementSelector
+					];
+					return [...acc, selector];
+				}, []);
+				if (nextSelectors.length !== rule.selectors.length) rule.selectors = nextSelectors;
+			});
+		}
+	};
+};
 /**
 * PostCSS plugin to fix color mode selectors for scoped CSS.
 *
@@ -31,5 +51,5 @@ const fixScopedColorModeSelectorsPlugin = (scopeClass) => {
 };
 
 //#endregion
-export { fixScopedColorModeSelectorsPlugin };
+export { fixScopedColorModeSelectorsPlugin, fixScopedSelfOrParentSelectorsPlugin };
 //# sourceMappingURL=postcss.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"postcss.js","names":[],"sources":["../../src/css/postcss.ts"],"sourcesContent":["import type postcss from 'postcss';\n\nimport { buildScopedColorModeSelectorList } from './postcss.helpers';\n\n/**\n * PostCSS plugin to fix color mode selectors for scoped CSS.\n *\n * postcss-scope converts selectors like:\n *   `.uds-color-mode-dark .foo` → `.scope .uds-color-mode-dark .foo`\n *\n * But the color mode class is typically on <html> or <body>, which is an\n * ANCESTOR of the scope, not a descendant. This plugin adds alternative\n * selectors so color modes work correctly:\n *\n *   `.scope .uds-color-mode-dark .foo` → `.scope .uds-color-mode-dark .foo, .uds-color-mode-dark .scope .foo, .uds-color-mode-dark.scope .foo`\n *\n * This ensures styles apply whether the color mode class is inside or outside the scope.\n */\nconst fixScopedColorModeSelectorsPlugin = (scopeClass: string): postcss.Plugin => {\n  const colorModePattern = /\\.(uds-color-mode-(?:dark|light))/;\n\n  return {\n    postcssPlugin: 'fix-scoped-color-mode-selectors',\n    // Use Once to process all rules after parsing is complete\n    Once(root) {\n      root.walkRules((rule) => {\n        // Skip if selector doesn't contain both scope and color mode\n        if (!rule.selector.includes(scopeClass) || !colorModePattern.test(rule.selector)) {\n          return;\n        }\n\n        const nextSelector = buildScopedColorModeSelectorList(rule.selector, scopeClass);\n        if (nextSelector !== rule.selector) {\n          rule.selector = nextSelector;\n        }\n      });\n    },\n  };\n};\nexport { fixScopedColorModeSelectorsPlugin };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,MAAM,qCAAqC,eAAuC;CAChF,MAAM,mBAAmB;AAEzB,QAAO;EACL,eAAe;EAEf,KAAK,MAAM;AACT,QAAK,WAAW,SAAS;AAEvB,QAAI,CAAC,KAAK,SAAS,SAAS,WAAW,IAAI,CAAC,iBAAiB,KAAK,KAAK,SAAS,CAC9E;IAGF,MAAM,eAAe,iCAAiC,KAAK,UAAU,WAAW;AAChF,QAAI,iBAAiB,KAAK,SACxB,MAAK,WAAW;KAElB;;EAEL"}
+{"version":3,"file":"postcss.js","names":[],"sources":["../../src/css/postcss.ts"],"sourcesContent":["import type postcss from 'postcss';\n\nimport {\n  buildScopedColorModeSelectorList,\n  getScopedSelfOrParentAlternativeSelector,\n} from './postcss.helpers';\n\nconst fixScopedSelfOrParentSelectorsPlugin = (scopeClass: string): postcss.Plugin => {\n  return {\n    postcssPlugin: 'fix-scoped-self-or-parent-selectors',\n    Once(root) {\n      root.walkRules((rule) => {\n        if (!rule.selector.includes(scopeClass)) {\n          return;\n        }\n\n        const nextSelectors = rule.selectors.reduce<string[]>((acc, selector) => {\n          const sameElementSelector = getScopedSelfOrParentAlternativeSelector(\n            selector,\n            scopeClass,\n          );\n\n          if (sameElementSelector && !rule.selectors.includes(sameElementSelector)) {\n            return [...acc, selector, sameElementSelector];\n          }\n\n          return [...acc, selector];\n        }, []);\n\n        if (nextSelectors.length !== rule.selectors.length) {\n          rule.selectors = nextSelectors;\n        }\n      });\n    },\n  };\n};\n\n/**\n * PostCSS plugin to fix color mode selectors for scoped CSS.\n *\n * postcss-scope converts selectors like:\n *   `.uds-color-mode-dark .foo` → `.scope .uds-color-mode-dark .foo`\n *\n * But the color mode class is typically on <html> or <body>, which is an\n * ANCESTOR of the scope, not a descendant. This plugin adds alternative\n * selectors so color modes work correctly:\n *\n *   `.scope .uds-color-mode-dark .foo` → `.scope .uds-color-mode-dark .foo, .uds-color-mode-dark .scope .foo, .uds-color-mode-dark.scope .foo`\n *\n * This ensures styles apply whether the color mode class is inside or outside the scope.\n */\nconst fixScopedColorModeSelectorsPlugin = (scopeClass: string): postcss.Plugin => {\n  const colorModePattern = /\\.(uds-color-mode-(?:dark|light))/;\n\n  return {\n    postcssPlugin: 'fix-scoped-color-mode-selectors',\n    // Use Once to process all rules after parsing is complete\n    Once(root) {\n      root.walkRules((rule) => {\n        // Skip if selector doesn't contain both scope and color mode\n        if (!rule.selector.includes(scopeClass) || !colorModePattern.test(rule.selector)) {\n          return;\n        }\n\n        const nextSelector = buildScopedColorModeSelectorList(rule.selector, scopeClass);\n        if (nextSelector !== rule.selector) {\n          rule.selector = nextSelector;\n        }\n      });\n    },\n  };\n};\nexport { fixScopedColorModeSelectorsPlugin, fixScopedSelfOrParentSelectorsPlugin };\n"],"mappings":";;;;AAOA,MAAM,wCAAwC,eAAuC;AACnF,QAAO;EACL,eAAe;EACf,KAAK,MAAM;AACT,QAAK,WAAW,SAAS;AACvB,QAAI,CAAC,KAAK,SAAS,SAAS,WAAW,CACrC;IAGF,MAAM,gBAAgB,KAAK,UAAU,QAAkB,KAAK,aAAa;KACvE,MAAM,sBAAsB,yCAC1B,UACA,WACD;AAED,SAAI,uBAAuB,CAAC,KAAK,UAAU,SAAS,oBAAoB,CACtE,QAAO;MAAC,GAAG;MAAK;MAAU;MAAoB;AAGhD,YAAO,CAAC,GAAG,KAAK,SAAS;OACxB,EAAE,CAAC;AAEN,QAAI,cAAc,WAAW,KAAK,UAAU,OAC1C,MAAK,YAAY;KAEnB;;EAEL;;;;;;;;;;;;;;;;AAiBH,MAAM,qCAAqC,eAAuC;CAChF,MAAM,mBAAmB;AAEzB,QAAO;EACL,eAAe;EAEf,KAAK,MAAM;AACT,QAAK,WAAW,SAAS;AAEvB,QAAI,CAAC,KAAK,SAAS,SAAS,WAAW,IAAI,CAAC,iBAAiB,KAAK,KAAK,SAAS,CAC9E;IAGF,MAAM,eAAe,iCAAiC,KAAK,UAAU,WAAW;AAChF,QAAI,iBAAiB,KAAK,SACxB,MAAK,WAAW;KAElB;;EAEL"}

package/dist/tailwind/dist/css/runner.cjs

@@ -8,19 +8,60 @@ const require_entryPoints = require('../utils/entryPoints.cjs');
 const require_nodeUtils = require('./nodeUtils.cjs');
 const require_index = require('../config/dist/index.cjs');
 const require_safelist = require('../purger/optimized/utils/safelist.cjs');
+const require_runner_helpers = require('./runner.helpers.cjs');
 const require_utils = require('./utils.cjs');
 const require_generate_helpers = require('./generate.helpers.cjs');
 const require_generate = require('./generate.cjs');
-const require_runner_helpers = require('./runner.helpers.cjs');
 let node_fs = require("node:fs");
 node_fs = require_runtime.__toESM(node_fs);
-let node_path = require("node:path");
-node_path = require_runtime.__toESM(node_path);
 
 //#region src/css/runner.ts
+const getScopedPackageOutputPath = (packageName, outFile) => {
+	if (typeof outFile === "string" && outFile.trim().length > 0) return outFile;
+	return `dist/${packageName.split("/").pop() ?? packageName}.css`;
+};
+const normalizeScopedPackageConfig = (scopedPackageValue) => {
+	if (typeof scopedPackageValue === "string") return { config: scopedPackageValue };
+	return scopedPackageValue;
+};
+const resolveScopedEntryDirs = (packageRoot, packageDir, entry) => {
+	if (entry === void 0) return [packageDir];
+	return require_entryPoints.resolveEntryPaths(entry, packageRoot).map((resolvedEntry) => resolvedEntry.absolutePath);
+};
+const PATH_SEPARATOR = "/";
+const normalizePath = (value) => value.replace(/\\/g, PATH_SEPARATOR);
+const isAbsolutePath = (value) => {
+	const normalizedValue = normalizePath(value);
+	return normalizedValue.startsWith(PATH_SEPARATOR) || /^[A-Za-z]:\//.test(normalizedValue);
+};
+const joinPath = (...parts) => {
+	const filteredParts = parts.filter((part) => part.length > 0);
+	if (filteredParts.length === 0) return "";
+	return filteredParts.map((part, index) => {
+		const normalizedPart = normalizePath(part);
+		if (index === 0) return normalizedPart.replace(/\/+$/g, "");
+		return normalizedPart.replace(/^\/+|\/+$/g, "");
+	}).join(PATH_SEPARATOR).replace(/\/+/g, PATH_SEPARATOR).replace(/\/\.\//g, PATH_SEPARATOR);
+};
+const dirnamePath = (value) => {
+	const normalizedValue = normalizePath(value).replace(/\/+$/g, "");
+	const lastSeparatorIndex = normalizedValue.lastIndexOf(PATH_SEPARATOR);
+	if (lastSeparatorIndex <= 0) return lastSeparatorIndex === 0 ? PATH_SEPARATOR : ".";
+	return normalizedValue.slice(0, lastSeparatorIndex);
+};
+const basenamePath = (value) => {
+	const normalizedValue = normalizePath(value).replace(/\/+$/g, "");
+	const lastSeparatorIndex = normalizedValue.lastIndexOf(PATH_SEPARATOR);
+	return lastSeparatorIndex >= 0 ? normalizedValue.slice(lastSeparatorIndex + 1) : normalizedValue;
+};
+const resolveOutputPath = (workspaceDir, outFile) => isAbsolutePath(outFile) ? outFile : joinPath(workspaceDir, outFile);
+const ensureOutputDirectory = (outputPath) => {
+	const outputDir = dirnamePath(outputPath);
+	if (!node_fs.default.existsSync(outputDir)) node_fs.default.mkdirSync(outputDir, { recursive: true });
+};
 const SOURCE_FILE_PATTERN = /\.(jsx?|tsx?)$/i;
-const getWatchDirs = (dirs) => [...new Set(dirs.filter((dir) => !dir.split(node_path.default.sep).includes("node_modules")))];
-const isCoveredByRecursiveWatch = (watchPath, targetPath) => targetPath === watchPath || targetPath.startsWith(`${watchPath}${node_path.default.sep}`);
+const getWatchDirs = (dirs) => [...new Set(dirs.filter((dir) => !normalizePath(dir).split(PATH_SEPARATOR).includes("node_modules")))];
+const isCoveredByRecursiveWatch = (watchPath, targetPath) => targetPath === watchPath || targetPath.startsWith(`${watchPath}${PATH_SEPARATOR}`);
 const getEntryWatchTargets = (entries) => {
 	const directoryTargets = getWatchDirs(entries.filter((entry) => entry.kind === "directory").map((entry) => entry.absolutePath)).map((watchPath) => ({
 		watchPath,
@@ -44,7 +85,7 @@ const watchSourceFiles = (targets, onFileChange) => {
 	targets.forEach((target) => {
 		node_fs.default.watch(target.watchPath, { recursive: target.recursive }, (_eventType, filename) => {
 			if (!filename || !SOURCE_FILE_PATTERN.test(filename)) return;
-			if (target.fileNames && !target.fileNames.includes(node_path.default.basename(String(filename)))) return;
+			if (target.fileNames && !target.fileNames.includes(basenamePath(String(filename)))) return;
 			onFileChange();
 		});
 	});
@@ -82,8 +123,13 @@ const createQueuedRegenerator = (options) => {
 	};
 	return regenerate;
 };
+const printVerboseScanFiles = (log, workspaceDir, filePaths) => {
+	require_runner_helpers.getVerboseScanFileList(workspaceDir, filePaths).forEach((filePath) => {
+		log.listItem(filePath);
+	});
+};
 const runCssCommand = async (options, context) => {
-	if (!node_fs.default.existsSync(node_path.default.join(options.workspaceDir, String(options.themeConfigPath)))) {
+	if (!node_fs.default.existsSync(joinPath(options.workspaceDir, String(options.themeConfigPath)))) {
 		await runSimpleMode(options, context);
 		return;
 	}
@@ -104,7 +150,8 @@ const runSimpleMode = async (options, context) => {
 			scope: options.scope,
 			configPath,
 			isWatch: options.watch,
-			silent: options.silent
+			silent: options.silent,
+			verbose: options.verbose
 		});
 		if (options.watch) await runSimpleModeWatch(options, context, entry, configPath, result.packageDirs ?? []);
 	} catch (error) {
@@ -184,7 +231,7 @@ const loadThemeModeSetup = async (options) => {
 };
 const runThemeMode = async (options, context) => {
 	const workspaceDir = options.workspaceDir;
-	const outputPath = node_path.default.isAbsolute(options.outFile) ? options.outFile : node_path.default.join(workspaceDir, String(options.outFile));
+	const outputPath = resolveOutputPath(workspaceDir, String(options.outFile));
 	let effectiveSilent = options.silent;
 	let log = require_logger.createLogger({ silent: effectiveSilent });
 	log.spinStart("Loading theme configuration...");
@@ -205,12 +252,21 @@ const runThemeMode = async (options, context) => {
 		const generateThemeModeCSS = async (opts) => {
 			const genStartTime = performance.now();
 			const genLog = opts?.isWatch ? require_logger.createLogger({ silent: true }) : log;
+			const scopedCssOutputs = [];
 			genLog.spinStart("Scanning app code...");
 			const appScanResult = await require_nodeUtils.scanDirectoriesForSafelist(entryDirs, colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults, runtimeConfigValues);
-			genLog.spinStop("✅", `Scanned ${appScanResult.filesScanned} files`);
+			genLog.spinStop("✅", require_runner_helpers.getScanSummaryMessage({
+				label: "app",
+				filesScanned: appScanResult.filesScanned,
+				filesWithComponents: appScanResult.filesWithComponents,
+				componentCount: appScanResult.components.length,
+				mode: "app"
+			}));
+			if (options.verbose) printVerboseScanFiles(genLog, workspaceDir, appScanResult.filePaths);
 			genLog.spinStart("Generating main CSS...");
 			const inheritedClasses = [...appScanResult.safelist];
 			const inheritedComponents = new Set(appScanResult.components);
+			const scopedPackageTargets = [];
 			const processInheritedPackage = async (packageName) => {
 				genLog.spinStart(`Processing package: ${packageName}...`);
 				const packageDir = require_nodeUtils.findPackageSourceDir(packageName);
@@ -222,12 +278,50 @@ const runThemeMode = async (options, context) => {
 				const packageScanResult = await require_nodeUtils.scanDirectoryForSafelist(packageDir, colorModes, context.variants, context.autoVariants, context.componentData, appVariantDefaults, runtimeConfigValues, true);
 				inheritedClasses.push(...packageScanResult.safelist);
 				packageScanResult.components.forEach((comp) => inheritedComponents.add(comp));
-				genLog.spinStop("✅", `${packageName}: ${packageScanResult.filesScanned} files (inherit)`);
+				genLog.spinStop("✅", require_runner_helpers.getScanSummaryMessage({
+					label: packageName,
+					filesScanned: packageScanResult.filesScanned,
+					filesWithComponents: packageScanResult.filesWithComponents,
+					componentCount: packageScanResult.components.length,
+					mode: "inherit"
+				}));
+				if (options.verbose) printVerboseScanFiles(genLog, workspaceDir, packageScanResult.filePaths);
+			};
+			const processScopedPackage = async (packageName, scopedPackageValue) => {
+				genLog.spinStart(`Processing scoped package: ${packageName}...`);
+				const scopedPackageConfig = normalizeScopedPackageConfig(scopedPackageValue);
+				const packageRoot = require_nodeUtils.findPackageRoot(packageName);
+				const packageDir = require_nodeUtils.findPackageSourceDir(packageName);
+				if (!packageRoot || !packageDir) {
+					genLog.spinStop("⚠️", `Scoped package not found: ${packageName}`);
+					return;
+				}
+				const scopeClass = require_nodeUtils.getPackageUdsScope(packageName);
+				if (!scopeClass) {
+					genLog.spinStop("⚠️", `Scoped package missing package.json uds.scope: ${packageName}`);
+					return;
+				}
+				const entryDirs = resolveScopedEntryDirs(packageRoot, packageDir, scopedPackageConfig.entry);
+				entryDirs.forEach((entryDir) => {
+					if (!packageDirs.includes(entryDir)) packageDirs.push(entryDir);
+				});
+				scopedPackageTargets.push({
+					packageName,
+					packageRoot,
+					packageDir,
+					entryDirs,
+					scopeClass,
+					config: scopedPackageConfig
+				});
 			};
 			await (themeConfig.inherit ?? []).reduce(async (promise, packageName) => {
 				await promise;
 				await processInheritedPackage(packageName);
 			}, Promise.resolve());
+			await Object.entries(themeConfig.scoped ?? {}).reduce(async (promise, [packageName, scopedPackageConfig]) => {
+				await promise;
+				await processScopedPackage(packageName, scopedPackageConfig);
+			}, Promise.resolve());
 			const mainSafelist = require_safelist.deduplicateSafelist([
 				...inheritedClasses,
 				...require_safelist.getThemeAndScaleClasses(colorModes),
@@ -244,24 +338,80 @@ const runThemeMode = async (options, context) => {
 					...require_generate_helpers.getPruneVarSafelist(themeConfig.css)
 				]
 			});
-			const outputDir = node_path.default.dirname(outputPath);
-			if (!node_fs.default.existsSync(outputDir)) node_fs.default.mkdirSync(outputDir, { recursive: true });
+			ensureOutputDirectory(outputPath);
 			node_fs.default.writeFileSync(outputPath, mainCssResult.css);
-			genLog.spinStop("✅", require_runner_helpers.getMainCssSummaryMessage({
+			for (const scopedPackageTarget of scopedPackageTargets) {
+				const packageConfig = await require_nodeUtils.loadConfigFile(isAbsolutePath(scopedPackageTarget.config.config) ? scopedPackageTarget.config.config : joinPath(scopedPackageTarget.packageRoot, scopedPackageTarget.config.config)) ?? require_index.defaultTokensConfig;
+				const packageVariantDefaults = require_utils.extractVariantDefaults(packageConfig);
+				const packageRuntimeConfigValues = require_utils.extractRuntimeConfigValues(packageConfig);
+				const packageScanResult = await require_nodeUtils.scanDirectoriesForSafelist(scopedPackageTarget.entryDirs, colorModes, context.variants, context.autoVariants, context.componentData, packageVariantDefaults, packageRuntimeConfigValues, true);
+				genLog.spinStop("✅", require_runner_helpers.getScanSummaryMessage({
+					label: scopedPackageTarget.packageName,
+					filesScanned: packageScanResult.filesScanned,
+					filesWithComponents: packageScanResult.filesWithComponents,
+					componentCount: packageScanResult.components.length,
+					mode: "scoped"
+				}));
+				if (options.verbose) printVerboseScanFiles(genLog, workspaceDir, packageScanResult.filePaths);
+				const packageSafelist = require_safelist.deduplicateSafelist([
+					...packageScanResult.safelist,
+					...require_safelist.getThemeAndScaleClasses(colorModes),
+					...require_safelist.getInternalSafelistClasses()
+				]);
+				const scopedCssResult = await require_generate.generateCSS([...themeConfig.css?.safelist ?? [], ...packageSafelist], packageConfig, {
+					scope: scopedPackageTarget.scopeClass,
+					contentDir: scopedPackageTarget.entryDirs,
+					cssOptions: themeConfig.css,
+					referenceCss: themeConfig.css?.optimization?.deduplicateScopedCss === false ? void 0 : mainCssResult.css,
+					safeVarPrefixes: [
+						...require_utils.getMotionVarPrefixes(context.componentData, [...packageScanResult.components]),
+						...require_utils.getConfigurableCssVariables(),
+						...require_generate_helpers.getPruneVarSafelist(themeConfig.css)
+					]
+				});
+				const scopedOutputPath = resolveOutputPath(workspaceDir, getScopedPackageOutputPath(scopedPackageTarget.packageName, scopedPackageTarget.config.outFile));
+				ensureOutputDirectory(scopedOutputPath);
+				node_fs.default.writeFileSync(scopedOutputPath, scopedCssResult.css);
+				scopedCssOutputs.push({
+					label: scopedPackageTarget.packageName,
+					outputPath: scopedOutputPath,
+					sizeGzipBytes: scopedCssResult.sizeGzipBytes,
+					optimizationStats: scopedCssResult.optimizationStats
+				});
+			}
+			const mainCssSummary = require_runner_helpers.getMainCssSummaryMessage({
 				sizeGzipBytes: mainCssResult.sizeGzipBytes,
 				optimizationStats: mainCssResult.optimizationStats,
 				formatBytes: require_utils.formatBytes
-			}));
+			});
+			genLog.spinStop("✅", mainCssSummary.summaryLine);
+			mainCssSummary.detailLines.forEach((detailLine) => {
+				genLog.print(detailLine);
+			});
+			scopedCssOutputs.forEach((scopedCssOutput) => {
+				const scopedCssSummary = require_runner_helpers.getScopedCssSummaryMessage(scopedCssOutput.label, {
+					sizeGzipBytes: scopedCssOutput.sizeGzipBytes,
+					optimizationStats: scopedCssOutput.optimizationStats,
+					formatBytes: require_utils.formatBytes
+				});
+				genLog.spinStop("✅", scopedCssSummary.summaryLine);
+				scopedCssSummary.detailLines.forEach((detailLine) => {
+					genLog.print(detailLine);
+				});
+			});
 			const duration = Math.round(performance.now() - genStartTime);
+			const outputFileSection = require_runner_helpers.getOutputFileSection(workspaceDir, [outputPath, ...scopedCssOutputs.map((scopedCssOutput) => scopedCssOutput.outputPath)]);
 			genLog.newline();
-			genLog.print(require_colors.green("CSS generation complete!"));
-			genLog.newline();
-			genLog.label("Output file:", outputPath);
+			genLog.print(outputFileSection.label);
+			outputFileSection.paths.forEach((filePath) => {
+				genLog.listItem(filePath);
+			});
 			genLog.newline();
-			genLog.print(`${require_colors.magenta("Total time:")} ${duration}ms`);
+			genLog.print(`${require_colors.magenta("Total time:")} ${require_runner_helpers.formatCssDuration(duration)}`);
 			return {
 				duration,
 				outputPath,
+				outputPaths: outputFileSection.paths,
 				packageDirs
 			};
 		};
@@ -292,7 +442,8 @@ const runThemeMode = async (options, context) => {
 				onSuccess: (result) => {
 					if (!effectiveSilent) {
 						const updatedAt = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-						log.print(`${require_colors.gray(`[${updatedAt}]`)} ${require_colors.green(`CSS updated (${result?.duration}ms)`)}`);
+						const updatedMessage = result?.duration == null ? "CSS updated" : `CSS updated (${require_runner_helpers.formatCssDuration(result.duration)})`;
+						log.print(`${require_colors.gray(`[${updatedAt}]`)} ${require_colors.green(updatedMessage)}`);
 						log.newline();
 					}
 				},

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

@@ -4,13 +4,60 @@ let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
 
 //#region src/css/runner.helpers.ts
-const getMainCssSummaryMessage = (options) => {
-	const { optimizationStats, sizeGzipBytes, formatBytes } = options;
-	if (!optimizationStats) return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip`;
+const getDisplayPath = (cwd, targetPath) => {
+	const relativePath = node_path.default.relative(cwd, targetPath);
+	return relativePath.length === 0 ? "." : relativePath;
+};
+const getVerboseScanFileList = (cwd, filePaths) => [...new Set(filePaths.map((filePath) => getDisplayPath(cwd, filePath)))].sort((left, right) => left.localeCompare(right));
+const getOptimizationDetailLines = (optimizationStats) => {
+	const detailLines = [];
+	if (optimizationStats.fontFacesRemoved > 0) detailLines.push(`      • removed ${optimizationStats.fontFacesRemoved} unused @font-face`);
+	if (optimizationStats.emptyRulesRemoved > 0) detailLines.push(`      • removed ${optimizationStats.emptyRulesRemoved} empty rules`);
+	return detailLines;
+};
+const formatCssDuration = (durationMs) => {
+	return `${(Math.floor(durationMs / 100) / 10).toFixed(1)}s`;
+};
+const getCssSummaryMessage = (options) => {
+	const { label, optimizationStats, sizeGzipBytes, formatBytes } = options;
+	const summaryLine = `${label}: ${formatBytes(sizeGzipBytes)} gzip`;
+	if (!optimizationStats) return {
+		summaryLine,
+		detailLines: []
+	};
 	const { originalSizeGzip, fontFacesRemoved, emptyRulesRemoved } = optimizationStats;
-	const savedBytesGzip = originalSizeGzip - sizeGzipBytes;
-	if (savedBytesGzip <= 0) return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip`;
-	return `Main CSS: ${formatBytes(sizeGzipBytes)} gzip)(optimized: saved ${formatBytes(savedBytesGzip)} gzip, ${fontFacesRemoved} unused @font-face, ${emptyRulesRemoved} empty rules removed)`;
+	if (originalSizeGzip - sizeGzipBytes <= 0) return {
+		summaryLine,
+		detailLines: []
+	};
+	return {
+		summaryLine,
+		detailLines: getOptimizationDetailLines({
+			originalSizeGzip,
+			fontFacesRemoved,
+			emptyRulesRemoved
+		})
+	};
+};
+const getMainCssSummaryMessage = (options) => {
+	return getCssSummaryMessage({
+		label: "Main CSS",
+		...options
+	});
+};
+const getScopedCssSummaryMessage = (packageName, options) => getCssSummaryMessage({
+	label: `${packageName} CSS`,
+	...options
+});
+const getOutputFileSection = (cwd, outputPaths) => ({
+	label: "Output files:",
+	paths: outputPaths.map((outputPath) => getDisplayPath(cwd, outputPath))
+});
+const getScanSummaryMessage = (options) => {
+	const nonComponentFileCount = Math.max(options.filesScanned - options.filesWithComponents, 0);
+	const fileLabel = nonComponentFileCount === 1 ? "file" : "files";
+	const componentLabel = options.componentCount === 1 ? "component" : "components";
+	return `${options.label}: ${nonComponentFileCount} ${fileLabel}, ${options.componentCount} ${componentLabel} (${options.mode})`;
 };
 const getWatchDirectoryGroups = (entryDirs, dirs) => {
 	const watchDirs = [...new Set(dirs.filter((dir) => !dir.split(node_path.default.sep).includes("node_modules")))];
@@ -21,5 +68,10 @@ const getWatchDirectoryGroups = (entryDirs, dirs) => {
 };
 
 //#endregion
+exports.formatCssDuration = formatCssDuration;
 exports.getMainCssSummaryMessage = getMainCssSummaryMessage;
+exports.getOutputFileSection = getOutputFileSection;
+exports.getScanSummaryMessage = getScanSummaryMessage;
+exports.getScopedCssSummaryMessage = getScopedCssSummaryMessage;
+exports.getVerboseScanFileList = getVerboseScanFileList;
 exports.getWatchDirectoryGroups = getWatchDirectoryGroups;