tailwindcss-patch 9.0.1 → 9.2.0

package/src/v4/source.ts

@@ -0,0 +1,193 @@
+import type { NormalizedTailwindCssPatchOptions, TailwindCssPatchOptions } from '../config'
+import type { TailwindV4ResolvedSource, TailwindV4SourceOptions } from './types'
+import { promises as fs } from 'node:fs'
+import process from 'node:process'
+import path from 'pathe'
+import { normalizeOptions } from '../config'
+
+function resolveBase(value: string | undefined, fallback: string) {
+  return value === undefined
+    ? fallback
+    : path.isAbsolute(value)
+      ? path.resolve(value)
+      : path.resolve(fallback, value)
+}
+
+function uniquePaths(values: Iterable<string | undefined>) {
+  const result: string[] = []
+  for (const value of values) {
+    if (!value) {
+      continue
+    }
+    const resolved = path.resolve(value)
+    if (!result.includes(resolved)) {
+      result.push(resolved)
+    }
+  }
+  return result
+}
+
+function toCssImportPath(value: string) {
+  return value.replaceAll('\\', '/')
+}
+
+function quoteCssImport(value: string) {
+  return value.replaceAll('\\', '\\\\').replaceAll('"', '\\"')
+}
+
+function isPostcssPluginSpecifier(packageName: string) {
+  return packageName === '@tailwindcss/postcss'
+    || /(?:^|[/\\])@tailwindcss[/\\]postcss(?:[/\\]|$)/.test(packageName)
+    || /(?:^|[/\\])postcss(?:[/\\]|$)/i.test(packageName)
+    || /postcss\.config\.[cm]?[jt]s$/i.test(packageName)
+}
+
+function createDefaultCss(packageName: string | undefined) {
+  const cssPackageName = packageName && !isPostcssPluginSpecifier(packageName)
+    ? packageName
+    : 'tailwindcss'
+  return `@import "${quoteCssImport(toCssImportPath(cssPackageName))}";`
+}
+
+async function pathExists(filePath: string) {
+  try {
+    await fs.access(filePath)
+    return true
+  }
+  catch {
+    return false
+  }
+}
+
+async function resolveCssEntries(entries: string[], projectRoot: string, base: string | undefined) {
+  const resolvedEntries = entries.map(entry => ({
+    original: entry,
+    absolute: path.isAbsolute(entry) ? path.resolve(entry) : path.resolve(projectRoot, entry),
+  }))
+  const resolvedBase = base ?? path.dirname(resolvedEntries[0]?.absolute ?? projectRoot)
+  const dependencies = resolvedEntries.map(entry => entry.absolute)
+  const cssParts: string[] = []
+
+  for (const entry of resolvedEntries) {
+    if (await pathExists(entry.absolute)) {
+      cssParts.push(await fs.readFile(entry.absolute, 'utf8'))
+      continue
+    }
+
+    const importPath = path.isAbsolute(entry.original)
+      ? entry.absolute
+      : path.relative(resolvedBase, entry.absolute)
+    cssParts.push(`@import "${quoteCssImport(toCssImportPath(importPath))}";`)
+  }
+
+  return {
+    base: resolvedBase,
+    css: cssParts.join('\n'),
+    dependencies,
+  }
+}
+
+function normalizeResolvedSource(
+  source: {
+    projectRoot: string
+    cwd: string
+    base: string
+    baseFallbacks: string[]
+    css: string
+    dependencies: string[]
+  },
+): TailwindV4ResolvedSource {
+  const baseFallbacks = uniquePaths([
+    ...source.baseFallbacks,
+    source.projectRoot,
+    source.cwd,
+  ]).filter(base => base !== source.base)
+
+  return {
+    projectRoot: source.projectRoot,
+    base: source.base,
+    baseFallbacks,
+    css: source.css,
+    dependencies: Array.from(new Set(source.dependencies.map(dependency => path.resolve(dependency)))),
+  }
+}
+
+export async function resolveTailwindV4Source(options: TailwindV4SourceOptions = {}): Promise<TailwindV4ResolvedSource> {
+  const projectRoot = resolveBase(options.projectRoot, process.cwd())
+  const cwd = resolveBase(options.cwd, projectRoot)
+  const configuredBase = options.base === undefined ? undefined : resolveBase(options.base, projectRoot)
+  const baseFallbacks = uniquePaths(options.baseFallbacks?.map(base => resolveBase(base, projectRoot)) ?? [])
+
+  if (options.css !== undefined) {
+    return normalizeResolvedSource({
+      projectRoot,
+      cwd,
+      base: configuredBase ?? cwd,
+      baseFallbacks,
+      css: options.css,
+      dependencies: [],
+    })
+  }
+
+  if (options.cssEntries?.length) {
+    const entries = await resolveCssEntries(options.cssEntries, projectRoot, configuredBase)
+    return normalizeResolvedSource({
+      projectRoot,
+      cwd,
+      base: entries.base,
+      baseFallbacks,
+      css: entries.css,
+      dependencies: entries.dependencies,
+    })
+  }
+
+  return normalizeResolvedSource({
+    projectRoot,
+    cwd,
+    base: configuredBase ?? cwd,
+    baseFallbacks,
+    css: createDefaultCss(options.packageName),
+    dependencies: [],
+  })
+}
+
+function resolveConfigDir(config: string | undefined, projectRoot: string) {
+  if (!config) {
+    return undefined
+  }
+  const configPath = path.isAbsolute(config) ? config : path.resolve(projectRoot, config)
+  return path.dirname(configPath)
+}
+
+function createSourceOptionsFromNormalizedPatchOptions(
+  options: NormalizedTailwindCssPatchOptions,
+): TailwindV4SourceOptions {
+  const v4 = options.tailwind.v4
+  const configDir = resolveConfigDir(options.tailwind.config, options.projectRoot)
+  const baseFallbacks = uniquePaths([
+    v4?.configuredBase,
+    options.tailwind.cwd,
+    options.projectRoot,
+    configDir,
+  ])
+
+  return {
+    projectRoot: options.projectRoot,
+    ...(options.tailwind.cwd === undefined ? {} : { cwd: options.tailwind.cwd }),
+    ...(v4?.configuredBase === undefined ? {} : { base: v4.configuredBase }),
+    baseFallbacks,
+    ...(v4?.css === undefined ? {} : { css: v4.css }),
+    ...(v4?.cssEntries === undefined ? {} : { cssEntries: v4.cssEntries }),
+    packageName: options.tailwind.packageName,
+  }
+}
+
+export function tailwindV4SourceOptionsFromPatchOptions(options: TailwindCssPatchOptions): TailwindV4SourceOptions {
+  return createSourceOptionsFromNormalizedPatchOptions(normalizeOptions(options))
+}
+
+export async function resolveTailwindV4SourceFromPatchOptions(
+  options: TailwindCssPatchOptions,
+): Promise<TailwindV4ResolvedSource> {
+  return resolveTailwindV4Source(tailwindV4SourceOptionsFromPatchOptions(options))
+}

package/src/v4/types.ts

@@ -0,0 +1,64 @@
+export interface TailwindV4SourceOptions {
+  projectRoot?: string
+  cwd?: string
+  base?: string
+  baseFallbacks?: string[]
+  css?: string
+  cssEntries?: string[]
+  packageName?: string
+}
+
+export interface TailwindV4ResolvedSource {
+  projectRoot: string
+  base: string
+  baseFallbacks: string[]
+  css: string
+  dependencies: string[]
+}
+
+export interface TailwindV4CandidateSource {
+  content: string
+  extension?: string
+}
+
+export interface TailwindV4GenerateOptions {
+  candidates?: Iterable<string>
+  sources?: TailwindV4CandidateSource[]
+  /**
+   * 扫描文件系统 source entries 中的候选类名。
+   *
+   * - `true`：使用 Tailwind v4 编译入口解析出的 `@source` 列表。
+   * - `TailwindV4SourcePattern[]`：使用调用方显式传入的 source 列表。
+   */
+  scanSources?: boolean | TailwindV4SourcePattern[]
+}
+
+export interface TailwindV4SourcePattern {
+  base: string
+  pattern: string
+  negated: boolean
+}
+
+export interface TailwindV4GenerateResult {
+  css: string
+  classSet: Set<string>
+  rawCandidates: Set<string>
+  dependencies: string[]
+  sources: TailwindV4SourcePattern[]
+  root: null | 'none' | {
+    base: string
+    pattern: string
+  }
+}
+
+export interface TailwindV4DesignSystem {
+  parseCandidate: (candidate: string) => unknown[]
+  candidatesToCss: (candidates: string[]) => Array<string | null | undefined>
+}
+
+export interface TailwindV4Engine {
+  source: TailwindV4ResolvedSource
+  loadDesignSystem: () => Promise<TailwindV4DesignSystem>
+  validateCandidates: (candidates: Iterable<string>) => Promise<Set<string>>
+  generate: (options?: TailwindV4GenerateOptions) => Promise<TailwindV4GenerateResult>
+}

package/dist/index.bundle-BGBMTX9A.js

@@ -1,35 +0,0 @@
-require("./chunk-8l464Juk.js");
-require("./validate-B8H-8rWO.js");
-//#region src/index.bundle.ts
-const require$1 = (0, require("node:module").createRequire)(require("url").pathToFileURL(__filename).href);
-function loadCliModule() {
-	return require$1("./commands/cli-runtime.js");
-}
-function mountTailwindcssPatchCommands(cli, options = {}) {
-	return loadCliModule().mountTailwindcssPatchCommands(cli, options);
-}
-function createTailwindcssPatchCli(options = {}) {
-	return loadCliModule().createTailwindcssPatchCli(options);
-}
-function defineConfig(config) {
-	return config;
-}
-//#endregion
-Object.defineProperty(exports, "createTailwindcssPatchCli", {
-	enumerable: true,
-	get: function() {
-		return createTailwindcssPatchCli;
-	}
-});
-Object.defineProperty(exports, "defineConfig", {
-	enumerable: true,
-	get: function() {
-		return defineConfig;
-	}
-});
-Object.defineProperty(exports, "mountTailwindcssPatchCommands", {
-	enumerable: true,
-	get: function() {
-		return mountTailwindcssPatchCommands;
-	}
-});

package/dist/index.bundle-ByrTqrr3.mjs

@@ -1,18 +0,0 @@
-import "./validate-BI8356RT.mjs";
-import { createRequire } from "node:module";
-//#region src/index.bundle.ts
-const require = createRequire(import.meta.url);
-function loadCliModule() {
-	return require("./commands/cli-runtime.js");
-}
-function mountTailwindcssPatchCommands(cli, options = {}) {
-	return loadCliModule().mountTailwindcssPatchCommands(cli, options);
-}
-function createTailwindcssPatchCli(options = {}) {
-	return loadCliModule().createTailwindcssPatchCli(options);
-}
-function defineConfig(config) {
-	return config;
-}
-//#endregion
-export { defineConfig as n, mountTailwindcssPatchCommands as r, createTailwindcssPatchCli as t };