tailwindcss-patch 9.4.2 → 9.4.4

package/src/style-generator.ts

@@ -0,0 +1,80 @@
+import type {
+  TailwindStyleCandidateOptions,
+  TailwindStyleSource,
+} from './style-candidates'
+import type {
+  TailwindV3StyleGenerateOptions,
+  TailwindV3StyleGenerateResult,
+} from './v3'
+import type {
+  TailwindV4StyleGenerateOptions,
+  TailwindV4StyleGenerateResult,
+} from './v4'
+import { collectTailwindStyleCandidates } from './style-candidates'
+import { generateTailwindV3Style } from './v3'
+import { generateTailwindV4Style } from './v4'
+
+export interface CustomTailwindStyleGenerateContext {
+  tokens: Set<string>
+  classSet: Set<string>
+  sources: TailwindStyleSource[]
+}
+
+export interface CustomTailwindStyleGenerateOptions extends TailwindStyleCandidateOptions {
+  generate: (context: CustomTailwindStyleGenerateContext) => string | Promise<string>
+}
+
+export interface CustomTailwindStyleGenerateResult {
+  version: 'custom'
+  css: string
+  tokens: Set<string>
+  classSet: Set<string>
+  sources: TailwindStyleSource[]
+}
+
+export type TailwindStyleGenerateOptions
+  = | ({ version: 3 } & TailwindV3StyleGenerateOptions)
+    | ({ version: 4 } & TailwindV4StyleGenerateOptions)
+    | ({ version: 'custom' } & CustomTailwindStyleGenerateOptions)
+
+export type TailwindStyleGenerateResult
+  = | TailwindV3StyleGenerateResult
+    | (TailwindV4StyleGenerateResult & { version: 4 })
+    | CustomTailwindStyleGenerateResult
+
+export async function generateCustomStyle(
+  options: CustomTailwindStyleGenerateOptions,
+): Promise<CustomTailwindStyleGenerateResult> {
+  const tokens = await collectTailwindStyleCandidates(options)
+  const classSet = new Set(tokens)
+  const sources = options.sources ?? []
+  const css = await options.generate({
+    tokens,
+    classSet,
+    sources,
+  })
+
+  return {
+    version: 'custom',
+    css,
+    tokens,
+    classSet,
+    sources,
+  }
+}
+
+export async function generateTailwindStyle(
+  options: TailwindStyleGenerateOptions,
+): Promise<TailwindStyleGenerateResult> {
+  if (options.version === 3) {
+    return generateTailwindV3Style(options)
+  }
+  if (options.version === 4) {
+    const result = await generateTailwindV4Style(options)
+    return {
+      ...result,
+      version: 4,
+    }
+  }
+  return generateCustomStyle(options)
+}

package/src/v3/index.ts

@@ -0,0 +1,11 @@
+export {
+  generateTailwindV3RawStyle,
+  generateTailwindV3Style,
+} from './style-generator'
+export type {
+  TailwindV3RawStyleGenerateOptions,
+  TailwindV3RawStyleGenerateResult,
+  TailwindV3StyleGenerateOptions,
+  TailwindV3StyleGenerateResult,
+  TailwindV3StyleLayer,
+} from './style-generator'

package/src/v3/style-generator.ts

@@ -0,0 +1,384 @@
+import type { Node } from 'postcss'
+import type { Config } from 'tailwindcss'
+import type { TailwindStyleCandidateOptions, TailwindStyleSource } from '../style-candidates'
+import type { TailwindcssRuntimeContext } from '../types'
+import { createRequire } from 'node:module'
+import process from 'node:process'
+import path from 'pathe'
+import postcss from 'postcss'
+import { collectTailwindStyleCandidates } from '../style-candidates'
+
+type NodeRequire = ReturnType<typeof createRequire>
+
+interface TailwindV3CreateContextModule {
+  createContext: (
+    tailwindConfig: Config,
+    changedContent?: Array<{ content?: string, extension?: string }>,
+    root?: ReturnType<typeof postcss.root>,
+  ) => TailwindcssRuntimeContext
+}
+
+interface TailwindV3GenerateRulesModule {
+  generateRules: (
+    candidates: Set<string>,
+    context: TailwindcssRuntimeContext,
+  ) => Array<[unknown, Node]>
+}
+
+interface TailwindV3ProcessResult {
+  css: string
+  messages: Array<Record<string, unknown>>
+}
+
+interface TailwindV3CollapseRulesModule {
+  default?: (context: TailwindcssRuntimeContext) => (root: postcss.Root, result: TailwindV3ProcessResult) => void
+}
+
+interface TailwindV3ProcessTailwindFeaturesModule {
+  default?: (
+    setupContext: () => (root: postcss.Root) => TailwindcssRuntimeContext,
+  ) => (root: postcss.Root, result: TailwindV3ProcessResult) => Promise<TailwindcssRuntimeContext>
+}
+
+interface TailwindV3ResolveDefaultsAtRulesModule {
+  default?: (context: TailwindcssRuntimeContext) => (root: postcss.Root, result: TailwindV3ProcessResult) => void
+}
+
+interface TailwindV3ValidateConfigModule {
+  validateConfig: (config: unknown) => Config
+}
+
+interface TailwindV3SharedStateModule {
+  NOT_ON_DEMAND?: string
+}
+
+type ResolveConfig = (config: Config) => Config
+
+interface TailwindV3Offsets {
+  sort: <T>(rules: Array<[unknown, T]>) => Array<[{
+    layer: 'base' | 'components' | 'defaults' | 'utilities' | 'variants'
+  }, T]>
+}
+
+export interface TailwindV3StyleGenerateOptions extends TailwindStyleCandidateOptions {
+  /**
+   * Tailwind v3 package name or alias. Defaults to `tailwindcss`.
+   */
+  packageName?: string
+  /**
+   * `createRequire` base used to resolve the Tailwind v3 package.
+   */
+  cwd?: string
+  /**
+   * Inline Tailwind v3 config. `content` is injected from collected candidates.
+   */
+  config?: Partial<Config>
+  /**
+   * Generate all layers by default. Pass a subset to emit only selected layers.
+   */
+  layers?: TailwindV3StyleLayer[]
+}
+
+export type TailwindV3StyleLayer = 'base' | 'components' | 'utilities' | 'variants'
+
+export interface TailwindV3RawStyleGenerateOptions extends TailwindStyleCandidateOptions {
+  /**
+   * Tailwind v3 package name or alias. Defaults to `tailwindcss`.
+   */
+  packageName?: string
+  /**
+   * `createRequire` base used to resolve the Tailwind v3 package.
+   */
+  cwd?: string
+  /**
+   * Tailwind v3 entry CSS. Defaults to `@tailwind utilities;`.
+   */
+  css?: string
+  /**
+   * Inline Tailwind v3 config. Candidate content is injected automatically.
+   */
+  config?: Partial<Config>
+  /**
+   * Directly append generated utility rules when the CSS is exactly `@tailwind utilities;`.
+   * This mirrors Tailwind v3's internal fast path and keeps output order aligned.
+   */
+  directUtilitiesOnly?: boolean | 'auto'
+}
+
+export interface TailwindV3RawStyleGenerateResult {
+  version: 3
+  css: string
+  tokens: Set<string>
+  classSet: Set<string>
+  context: TailwindcssRuntimeContext
+  dependencies: string[]
+  sources: TailwindStyleSource[]
+  config: Config
+}
+
+export interface TailwindV3StyleGenerateResult {
+  version: 3
+  css: string
+  tokens: Set<string>
+  classSet: Set<string>
+  sources: TailwindStyleSource[]
+  config: Config
+}
+
+function createPackageRequire(cwd?: string): NodeRequire {
+  return createRequire(path.join(path.resolve(cwd ?? process.cwd()), 'package.json'))
+}
+
+function createDefaultTailwindV3Config(tokens: Set<string>): Config {
+  return {
+    content: [
+      {
+        raw: [...tokens].join(' '),
+        extension: 'html',
+      },
+    ],
+    theme: {
+      extend: {},
+    },
+    plugins: [],
+  }
+}
+
+function getDefaultExport<T>(module: { default?: T } | T): T {
+  if (module && typeof module === 'object' && 'default' in module) {
+    return module.default as T
+  }
+  return module as T
+}
+
+function loadTailwindV3Modules(options: Pick<TailwindV3StyleGenerateOptions, 'cwd' | 'packageName'>) {
+  const packageName = options.packageName ?? 'tailwindcss'
+  const moduleRequire = createPackageRequire(options.cwd)
+  const resolveConfig = getDefaultExport<ResolveConfig>(
+    moduleRequire(`${packageName}/lib/public/resolve-config`) as { default?: ResolveConfig } | ResolveConfig,
+  )
+  const contextModule = moduleRequire(`${packageName}/lib/lib/setupContextUtils`) as TailwindV3CreateContextModule
+  const generateRulesModule = moduleRequire(`${packageName}/lib/lib/generateRules`) as TailwindV3GenerateRulesModule
+  const collapseAdjacentRulesModule = moduleRequire(`${packageName}/lib/lib/collapseAdjacentRules`) as TailwindV3CollapseRulesModule
+  const collapseDuplicateDeclarationsModule = moduleRequire(`${packageName}/lib/lib/collapseDuplicateDeclarations`) as TailwindV3CollapseRulesModule
+  const processTailwindFeaturesModule = moduleRequire(`${packageName}/lib/processTailwindFeatures`) as TailwindV3ProcessTailwindFeaturesModule
+  const resolveDefaultsAtRulesModule = moduleRequire(`${packageName}/lib/lib/resolveDefaultsAtRules`) as TailwindV3ResolveDefaultsAtRulesModule
+  const sharedStateModule = moduleRequire(`${packageName}/lib/lib/sharedState`) as TailwindV3SharedStateModule
+  const validateConfigModule = moduleRequire(`${packageName}/lib/util/validateConfig.js`) as TailwindV3ValidateConfigModule
+  return {
+    collapseAdjacentRules: getDefaultExport(collapseAdjacentRulesModule),
+    collapseDuplicateDeclarations: getDefaultExport(collapseDuplicateDeclarationsModule),
+    createContext: contextModule.createContext,
+    generateRules: generateRulesModule.generateRules,
+    notOnDemandCandidate: sharedStateModule.NOT_ON_DEMAND ?? '*',
+    processTailwindFeatures: getDefaultExport(processTailwindFeaturesModule),
+    resolveDefaultsAtRules: getDefaultExport(resolveDefaultsAtRulesModule),
+    resolveConfig,
+    validateConfig: validateConfigModule.validateConfig,
+  }
+}
+
+function createRawContentEntries(candidates: Iterable<string>, sources: TailwindStyleSource[]) {
+  const entries: Array<{ raw: string, extension: string }> = []
+  const candidateContent = [...candidates].join(' ')
+  if (candidateContent.length > 0) {
+    entries.push({
+      raw: candidateContent,
+      extension: 'html',
+    })
+  }
+  for (const source of sources) {
+    entries.push({
+      raw: source.content,
+      extension: source.extension ?? 'html',
+    })
+  }
+  return entries
+}
+
+function createChangedContentEntries(candidates: Iterable<string>, sources: TailwindStyleSource[]) {
+  return createRawContentEntries(candidates, sources).map(entry => ({
+    content: entry.raw,
+    extension: entry.extension,
+  }))
+}
+
+function createTailwindConfigWithContent(
+  config: Partial<Config> | undefined,
+  tokens: Set<string>,
+  sources: TailwindStyleSource[],
+) {
+  const userContent = config?.content
+  return {
+    ...createDefaultTailwindV3Config(tokens),
+    ...(config ?? {}),
+    content: [
+      ...(Array.isArray(userContent) ? userContent : []),
+      ...createRawContentEntries(tokens, sources),
+    ],
+  } as Config
+}
+
+function isDirectUtilitiesOnlyCss(css: string) {
+  return css.replace(/\s+/g, '') === '@tailwindutilities;'
+}
+
+function sortCandidates(candidates: Iterable<string>) {
+  return [...candidates].sort((a, z) => {
+    if (a === z) {
+      return 0
+    }
+    return a < z ? -1 : 1
+  })
+}
+
+function appendUtilityRules(
+  root: postcss.Root,
+  context: TailwindcssRuntimeContext,
+  rules: Array<[unknown, Node]>,
+) {
+  const sortedRules = (context.offsets as unknown as TailwindV3Offsets).sort(rules)
+  for (const [sort, rule] of sortedRules) {
+    const tailwindRaw = rule.raws.tailwind as { parentLayer?: string } | undefined
+    if (sort.layer === 'utilities' || (sort.layer === 'variants' && tailwindRaw?.parentLayer === 'utilities')) {
+      root.append(rule.clone())
+    }
+  }
+}
+
+function collectClassSet(context: TailwindcssRuntimeContext, notOnDemandCandidate: string) {
+  const classSet = new Set<string>()
+  for (const candidate of context.classCache.keys()) {
+    if (String(candidate) !== String(notOnDemandCandidate)) {
+      classSet.add(candidate)
+    }
+  }
+  return classSet
+}
+
+function collectDependencyMessages(result: TailwindV3ProcessResult) {
+  const dependencies = new Set<string>()
+  for (const message of result.messages) {
+    const file = message.file
+    if (message.type === 'dependency' && typeof file === 'string') {
+      dependencies.add(file)
+    }
+  }
+  return [...dependencies]
+}
+
+function buildStylesheetNodes(
+  rules: Array<[unknown, Node]>,
+  context: TailwindcssRuntimeContext,
+  layers: TailwindV3StyleLayer[],
+) {
+  const sortedRules = (context.offsets as unknown as TailwindV3Offsets).sort(rules)
+  const nodes: Node[] = []
+  const layerSet = new Set<TailwindV3StyleLayer>(layers)
+
+  for (const [sort, rule] of sortedRules) {
+    const layer = sort.layer === 'defaults' ? 'base' : sort.layer
+    if (layerSet.has(layer)) {
+      nodes.push(rule.clone())
+    }
+  }
+  return nodes
+}
+
+function createRootFromNodes(nodes: Node[]) {
+  const root = postcss.root()
+  for (const node of nodes) {
+    root.append(node)
+  }
+  return root
+}
+
+export async function generateTailwindV3Style(
+  options: TailwindV3StyleGenerateOptions = {},
+): Promise<TailwindV3StyleGenerateResult> {
+  const tokens = await collectTailwindStyleCandidates(options)
+  const { createContext, generateRules, resolveConfig } = loadTailwindV3Modules(options)
+  const userContent = options.config?.content
+  const config = resolveConfig({
+    ...createDefaultTailwindV3Config(tokens),
+    ...(options.config ?? {}),
+    content: [
+      ...(Array.isArray(userContent) ? userContent : []),
+      {
+        raw: [...tokens].join(' '),
+        extension: 'html',
+      },
+    ],
+  } as Config)
+  const root = postcss.root()
+  const context = createContext(config, [], root)
+  const rules = generateRules(tokens, context)
+  const nodes = buildStylesheetNodes(rules, context, options.layers ?? ['base', 'components', 'utilities', 'variants'])
+  const css = createRootFromNodes(nodes).toString()
+
+  return {
+    version: 3,
+    css,
+    tokens,
+    classSet: new Set(context.classCache.keys()),
+    sources: options.sources ?? [],
+    config,
+  }
+}
+
+export async function generateTailwindV3RawStyle(
+  options: TailwindV3RawStyleGenerateOptions = {},
+): Promise<TailwindV3RawStyleGenerateResult> {
+  const tokens = await collectTailwindStyleCandidates(options)
+  const {
+    collapseAdjacentRules,
+    collapseDuplicateDeclarations,
+    createContext,
+    generateRules,
+    notOnDemandCandidate,
+    processTailwindFeatures,
+    resolveConfig,
+    resolveDefaultsAtRules,
+    validateConfig,
+  } = loadTailwindV3Modules(options)
+  const css = options.css ?? '@tailwind utilities;'
+  const config = validateConfig(resolveConfig(createTailwindConfigWithContent(options.config, tokens, options.sources ?? [])))
+  const root = postcss.parse(css, {
+    from: undefined,
+  })
+  const result: TailwindV3ProcessResult = {
+    css: '',
+    messages: [],
+  }
+  const changedContent = createChangedContentEntries(tokens, options.sources ?? [])
+  const shouldUseDirectUtilities = options.directUtilitiesOnly === true
+    || (options.directUtilitiesOnly !== false && isDirectUtilitiesOnlyCss(css))
+  let context: TailwindcssRuntimeContext
+
+  if (shouldUseDirectUtilities) {
+    context = createContext(config, changedContent, root)
+    generateRules(new Set(sortCandidates([notOnDemandCandidate, ...tokens])), context)
+    root.removeAll()
+    appendUtilityRules(root, context, [...context.ruleCache])
+    resolveDefaultsAtRules(context)(root, result)
+    collapseAdjacentRules(context)(root, result)
+    collapseDuplicateDeclarations(context)(root, result)
+  }
+  else {
+    const setupContext = () => {
+      return (currentRoot: postcss.Root) => createContext(config, changedContent, currentRoot)
+    }
+    context = await processTailwindFeatures(setupContext)(root, result)
+  }
+
+  return {
+    version: 3,
+    css: root.toString(),
+    tokens,
+    classSet: collectClassSet(context, notOnDemandCandidate),
+    context,
+    dependencies: collectDependencyMessages(result),
+    sources: options.sources ?? [],
+    config,
+  }
+}

package/src/v4/index.ts

@@ -1,9 +1,3 @@
-export {
-  canonicalizeBareArbitraryValueCandidates,
-  extractTailwindV4InlineSourceCandidates,
-  replaceBareArbitraryValueSelectors,
-  resolveValidTailwindV4Candidates,
-} from './candidates'
 export {
   escapeCssClassName,
   extractBareArbitraryValueSourceCandidates,
@@ -11,6 +5,12 @@ export {
   isBareArbitraryValuesEnabled,
   resolveBareArbitraryValueCandidate,
 } from './bare-arbitrary-values'
+export {
+  canonicalizeBareArbitraryValueCandidates,
+  extractTailwindV4InlineSourceCandidates,
+  replaceBareArbitraryValueSelectors,
+  resolveValidTailwindV4Candidates,
+} from './candidates'
 export { createTailwindV4Engine } from './engine'
 export {
   compileTailwindV4Source,
@@ -43,6 +43,10 @@ export {
   TAILWIND_V4_IGNORED_EXTENSIONS,
   TAILWIND_V4_IGNORED_FILES,
 } from './source-scan'
+export {
+  collectTailwindV4StyleCandidates,
+  generateTailwindV4Style,
+} from './style-generator'
 export type {
   TailwindV4CandidateSource,
   TailwindV4CompiledSourceRoot,
@@ -54,4 +58,7 @@ export type {
   TailwindV4ResolvedSource,
   TailwindV4SourceOptions,
   TailwindV4SourcePattern,
+  TailwindV4StyleGenerateOptions,
+  TailwindV4StyleGenerateResult,
+  TailwindV4StyleSource,
 } from './types'

package/src/v4/style-generator.ts

@@ -0,0 +1,44 @@
+import type {
+  TailwindV4SourceOptions,
+  TailwindV4StyleGenerateOptions,
+  TailwindV4StyleGenerateResult,
+} from './types'
+import { collectTailwindStyleCandidates } from '../style-candidates'
+import { createTailwindV4Engine } from './engine'
+import { resolveTailwindV4Source } from './source'
+
+function createSourceOptions(options: TailwindV4StyleGenerateOptions): TailwindV4SourceOptions {
+  return {
+    ...(options.projectRoot === undefined ? {} : { projectRoot: options.projectRoot }),
+    ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+    ...(options.base === undefined ? {} : { base: options.base }),
+    ...(options.baseFallbacks === undefined ? {} : { baseFallbacks: options.baseFallbacks }),
+    ...(options.css === undefined ? {} : { css: options.css }),
+    ...(options.cssSources === undefined ? {} : { cssSources: options.cssSources }),
+    ...(options.cssEntries === undefined ? {} : { cssEntries: options.cssEntries }),
+    ...(options.packageName === undefined ? {} : { packageName: options.packageName }),
+  }
+}
+
+export async function collectTailwindV4StyleCandidates(
+  options: Pick<TailwindV4StyleGenerateOptions, 'bareArbitraryValues' | 'candidates' | 'sources'>,
+): Promise<Set<string>> {
+  return collectTailwindStyleCandidates(options)
+}
+
+export async function generateTailwindV4Style(
+  options: TailwindV4StyleGenerateOptions = {},
+): Promise<TailwindV4StyleGenerateResult> {
+  const source = options.source ?? await resolveTailwindV4Source(createSourceOptions(options))
+  const candidates = await collectTailwindV4StyleCandidates(options)
+  const result = await createTailwindV4Engine(source).generate({
+    candidates,
+    ...(options.bareArbitraryValues === undefined ? {} : { bareArbitraryValues: options.bareArbitraryValues }),
+    ...(options.scanSources === undefined ? {} : { scanSources: options.scanSources }),
+  })
+  return {
+    ...result,
+    tokens: result.rawCandidates,
+    source,
+  }
+}

package/src/v4/types.ts

@@ -1,3 +1,5 @@
+import type { TailwindStyleSource } from '../style-candidates'
+
 export interface TailwindV4SourceOptions {
   projectRoot?: string
   cwd?: string
@@ -29,6 +31,8 @@ export interface TailwindV4CandidateSource {
   extension?: string
 }
 
+export interface TailwindV4StyleSource extends TailwindStyleSource {}
+
 export interface TailwindV4GenerateOptions {
   candidates?: Iterable<string>
   sources?: TailwindV4CandidateSource[]
@@ -67,6 +71,25 @@ export interface TailwindV4GenerateResult {
   root: TailwindV4CompiledSourceRoot
 }
 
+export interface TailwindV4StyleGenerateOptions extends TailwindV4SourceOptions {
+  source?: TailwindV4ResolvedSource
+  candidates?: Iterable<string>
+  sources?: TailwindV4StyleSource[]
+  /**
+   * Enables UnoCSS-style bare arbitrary values such as `p-10%` and `p-2.5px`.
+   */
+  bareArbitraryValues?: TailwindV4GenerateOptions['bareArbitraryValues']
+  /**
+   * Scans the compiled Tailwind CSS v4 source entries in addition to in-memory sources.
+   */
+  scanSources?: TailwindV4GenerateOptions['scanSources']
+}
+
+export interface TailwindV4StyleGenerateResult extends TailwindV4GenerateResult {
+  tokens: Set<string>
+  source: TailwindV4ResolvedSource
+}
+
 export interface TailwindV4DesignSystem {
   parseCandidate: (candidate: string) => unknown[]
   candidatesToCss: (candidates: string[]) => Array<string | null | undefined>

package/dist/chunk-8l464Juk.js

@@ -1,28 +0,0 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-Object.defineProperty(exports, "__toESM", {
-	enumerable: true,
-	get: function() {
-		return __toESM;
-	}
-});