@weapp-tailwindcss/engine 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ice breaker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @weapp-tailwindcss/engine
+
+> English | [简体中文](./README.zh-CN.md)
+
+Candidate extraction, source scanning, and style generation for Tailwind CSS 4. Use this package independently or through `weapp-tailwindcss`, its PostCSS package, and CLI.
+
+```ts
+import { createTailwindV4Engine, resolveTailwindV4Source } from '@weapp-tailwindcss/engine'
+
+const source = await resolveTailwindV4Source({
+  projectRoot: process.cwd(),
+  css: '@import "tailwindcss";',
+})
+const engine = createTailwindV4Engine(source)
+const result = await engine.generate({ candidates: ['flex', 'text-red-500'] })
+console.log(result.css)
+```
+
+The root entry exports candidate extraction, position reports, source scanning, and the v4 API. `@weapp-tailwindcss/engine/v4` exports the v4 API. Both entries support ESM, CJS, and TypeScript. Extract candidates from templates, JavaScript strings, SFCs, and CSS `@apply`, with source positions and valid candidate sets.
+
+Supports `@source`, multiple CSS sources, the design system, bare arbitrary values, incremental generation sessions, and cache disposal. Only Tailwind CSS 4 is supported. There are no v3, multi-version dispatcher, custom generator, or HTML parser compatibility entry points. Platform compatibility transforms belong to `@weapp-tailwindcss/postcss`.
+
+## Source
+
+The source and corresponding v4 and extraction tests were migrated from the MIT-licensed [tailwindcss-mangle](https://github.com/sonofmagic/tailwindcss-mangle/tree/6bf58cebe073a06dfeac7ed44f55ecff50deb763/packages/engine) commit identified by the npm provenance for `@tailwindcss-mangle/engine@0.2.0`. The original [MIT license](./LICENSE) is retained. This package is maintained independently and does not depend on the old engine or a local submodule at runtime.

package/README.zh-CN.md

@@ -0,0 +1,25 @@
+# @weapp-tailwindcss/engine
+
+> [English](./README.md) | 简体中文
+
+Tailwind CSS 4 的候选提取、文件扫描和样式生成引擎，可独立使用，也供 `weapp-tailwindcss`、PostCSS 包与 CLI 复用。
+
+```ts
+import { createTailwindV4Engine, resolveTailwindV4Source } from '@weapp-tailwindcss/engine'
+
+const source = await resolveTailwindV4Source({
+  projectRoot: process.cwd(),
+  css: '@import "tailwindcss";',
+})
+const engine = createTailwindV4Engine(source)
+const result = await engine.generate({ candidates: ['flex', 'text-red-500'] })
+console.log(result.css)
+```
+
+包根导出候选提取、位置报告、扫描工具和 v4 API；`@weapp-tailwindcss/engine/v4` 导出 v4 API。两者均支持 ESM、CJS 和 TypeScript。候选提取包括模板、JS 字符串、SFC 和 CSS `@apply`，保留源码位置及有效候选集合。
+
+支持 `@source`、多 CSS 来源、design system、裸任意值、增量生成会话与缓存释放。只支持 Tailwind CSS 4；不提供 v3、多版本分发、自定义生成器或 HTML parser 兼容入口。小程序平台兼容转换由 `@weapp-tailwindcss/postcss` 完成。
+
+## 来源
+
+源码及对应 v4、提取测试迁自 MIT 项目 [tailwindcss-mangle](https://github.com/sonofmagic/tailwindcss-mangle/tree/6bf58cebe073a06dfeac7ed44f55ecff50deb763/packages/engine)，对应 npm `@tailwindcss-mangle/engine@0.2.0` 的发布证明。保留原始 [MIT 许可证](./LICENSE)。本包独立维护，不在运行时依赖旧 engine 或本地 submodule。

package/dist/index-BKLDGE3a.d.cts

@@ -0,0 +1,267 @@
+import { SourceEntry } from "@tailwindcss/oxide";
+import { Root } from "postcss";
+//#region src/v4/bare-arbitrary-values/escape.d.ts
+declare function escapeCssClassName(value: string): string;
+//#endregion
+//#region src/v4/bare-arbitrary-values/types.d.ts
+interface BareArbitraryValueOptions {
+  /**
+   * 允许作为无方括号任意值的单位列表。
+   */
+  units?: string[];
+}
+interface BareArbitraryValueResolveResult {
+  candidate: string;
+  canonicalCandidate: string;
+}
+interface BareArbitraryValueSourceCandidate {
+  rawCandidate: string;
+  start: number;
+  end: number;
+}
+//#endregion
+//#region src/v4/bare-arbitrary-values/extract.d.ts
+declare function extractBareArbitraryValueSourceCandidatesWithPositions(content: string, options?: boolean | BareArbitraryValueOptions): BareArbitraryValueSourceCandidate[];
+declare function extractBareArbitraryValueSourceCandidates(content: string, options?: boolean | BareArbitraryValueOptions): string[];
+//#endregion
+//#region src/v4/bare-arbitrary-values/resolve.d.ts
+declare function isBareArbitraryValuesEnabled(options: boolean | BareArbitraryValueOptions | undefined): boolean;
+declare function resolveBareArbitraryValueCandidate(candidate: string, options?: boolean | BareArbitraryValueOptions): BareArbitraryValueResolveResult | undefined;
+//#endregion
+//#region src/style-candidates.d.ts
+interface TailwindStyleSource {
+  content: string;
+  extension?: string;
+  file?: string;
+}
+interface TailwindStyleCandidateOptions {
+  candidates?: Iterable<string>;
+  sources?: TailwindStyleSource[];
+  /**
+   * 启用 UnoCSS 风格的裸任意值，例如 `p-10%`、`p-2.5px`。
+   */
+  bareArbitraryValues?: boolean | BareArbitraryValueOptions;
+}
+declare function collectTailwindStyleCandidates(options?: TailwindStyleCandidateOptions): Promise<Set<string>>;
+//#endregion
+//#region src/v4/types.d.ts
+interface TailwindV4SourceOptions {
+  projectRoot?: string;
+  cwd?: string;
+  base?: string;
+  baseFallbacks?: string[];
+  css?: string;
+  cssSources?: TailwindV4CssSource[];
+  cssEntries?: string[];
+  packageName?: string;
+}
+interface TailwindV4CssSource {
+  css: string;
+  base?: string;
+  file?: string;
+  dependencies?: string[];
+}
+interface TailwindV4ResolvedSource {
+  projectRoot: string;
+  base: string;
+  baseFallbacks: string[];
+  css: string;
+  dependencies: string[];
+}
+interface TailwindV4CandidateSource {
+  content: string;
+  extension?: string;
+}
+interface SourceEntry$1 extends TailwindV4CandidateSource {
+  id: string;
+}
+interface GenerationRequest {
+  candidates?: Iterable<string>;
+  sourceEntries?: SourceEntry$1[];
+  /**
+   * 启用 UnoCSS 风格的裸任意值，例如 `p-10%`、`p-2.5px`。
+   */
+  bareArbitraryValues?: TailwindV4GenerateOptions['bareArbitraryValues'];
+}
+type GenerationChange = {
+  type: 'all';
+} | {
+  type: 'candidates';
+} | {
+  type: 'sourceEntries';
+} | {
+  type: 'dependencies';
+  paths?: Iterable<string>;
+} | {
+  type: 'source';
+  source: TailwindV4ResolvedSource;
+};
+type CssFragmentKind = 'tailwind' | 'theme' | 'preflight';
+interface CssFragment {
+  id: string;
+  kind: CssFragmentKind;
+  root: Root;
+  sourceId: string;
+  order: number;
+}
+interface TailwindGenerationArtifact {
+  fragments: CssFragment[];
+  classSet: Set<string>;
+  rawCandidates: Set<string>;
+  dependencies: string[];
+  sourceEntries: SourceEntry$1[];
+}
+interface TailwindGenerationSession {
+  readonly source: TailwindV4ResolvedSource;
+  generate: (request?: GenerationRequest) => Promise<TailwindGenerationArtifact>;
+  invalidate: (change: GenerationChange) => void;
+  dispose: () => void;
+}
+interface TailwindV4StyleSource extends TailwindStyleSource {}
+interface TailwindV4GenerateOptions {
+  candidates?: Iterable<string>;
+  sources?: TailwindV4CandidateSource[];
+  /**
+   * 启用 UnoCSS 风格的裸任意值，例如 `p-10%`、`p-2.5px`。
+   */
+  bareArbitraryValues?: boolean | {
+    units?: string[];
+  };
+  /**
+   * 扫描文件系统 source entries 中的候选类名。
+   *
+   * - `true`：使用 Tailwind v4 编译入口解析出的 `@source` 列表。
+   * - `TailwindV4SourcePattern[]`：使用调用方显式传入的 source 列表。
+   */
+  scanSources?: boolean | TailwindV4SourcePattern[];
+}
+type TailwindV4CompiledSourceRoot = null | 'none' | {
+  base: string;
+  pattern: string;
+};
+interface TailwindV4SourcePattern {
+  base: string;
+  pattern: string;
+  negated: boolean;
+}
+interface TailwindV4GenerateResult {
+  css: string;
+  classSet: Set<string>;
+  rawCandidates: Set<string>;
+  dependencies: string[];
+  sources: TailwindV4SourcePattern[];
+  root: TailwindV4CompiledSourceRoot;
+}
+interface TailwindV4StyleGenerateOptions extends TailwindV4SourceOptions {
+  source?: TailwindV4ResolvedSource;
+  candidates?: Iterable<string>;
+  sources?: TailwindV4StyleSource[];
+  /**
+   * 启用 UnoCSS 风格的裸任意值，例如 `p-10%`、`p-2.5px`。
+   */
+  bareArbitraryValues?: TailwindV4GenerateOptions['bareArbitraryValues'];
+  /**
+   * 除内存来源外，还扫描 Tailwind CSS v4 编译后解析的来源入口。
+   */
+  scanSources?: TailwindV4GenerateOptions['scanSources'];
+}
+interface TailwindV4StyleGenerateResult extends TailwindV4GenerateResult {
+  tokens: Set<string>;
+  source: TailwindV4ResolvedSource;
+}
+interface TailwindV4DesignSystem {
+  parseCandidate: (candidate: string) => unknown[];
+  candidatesToCss: (candidates: string[]) => Array<string | null | undefined>;
+}
+interface TailwindV4Engine {
+  source: TailwindV4ResolvedSource;
+  loadDesignSystem: () => Promise<TailwindV4DesignSystem>;
+  validateCandidates: (candidates: Iterable<string>) => Promise<Set<string>>;
+  generate: (options?: TailwindV4GenerateOptions) => Promise<TailwindV4GenerateResult>;
+}
+//#endregion
+//#region src/v4/candidates/inline-source.d.ts
+declare function extractTailwindV4InlineSourceCandidates(css: string): {
+  included: Set<string>;
+  excluded: Set<string>;
+};
+//#endregion
+//#region src/v4/candidates.d.ts
+declare function resolveValidTailwindV4Candidates(designSystem: TailwindV4DesignSystem, candidates: Iterable<string>, options?: {
+  bareArbitraryValues?: boolean | BareArbitraryValueOptions;
+}): Set<string>;
+declare function replaceBareArbitraryValueSelectors(css: string, candidates: Iterable<string>, options?: boolean | BareArbitraryValueOptions): string;
+declare function canonicalizeBareArbitraryValueCandidates(candidates: Iterable<string>, options?: boolean | BareArbitraryValueOptions): string[];
+//#endregion
+//#region src/v4/engine.d.ts
+declare function createTailwindV4Engine(source: TailwindV4ResolvedSource): TailwindV4Engine;
+//#endregion
+//#region src/v4/generation-session.d.ts
+declare function createTailwindGenerationSession(source: TailwindV4ResolvedSource): TailwindGenerationSession;
+//#endregion
+//#region src/v4/node-adapter.d.ts
+interface TailwindV4CompiledSource {
+  sources: TailwindV4SourcePattern[];
+  root: TailwindV4CompiledSourceRoot;
+  build: (candidates: string[]) => string;
+}
+interface TailwindV4NodeModule {
+  compile: (css: string, options: {
+    base: string;
+    onDependency: (dependency: string) => void;
+    customCssResolver?: (id: string, base: string) => Promise<string | false | undefined>;
+  }) => Promise<TailwindV4CompiledSource>;
+  __unstable__loadDesignSystem: (css: string, options: {
+    base: string;
+  }) => Promise<TailwindV4DesignSystem>;
+}
+declare function loadTailwindV4NodeModule(baseCandidates: string[]): Promise<TailwindV4NodeModule>;
+declare function getTailwindV4DesignSystemCacheKey(source: Pick<TailwindV4ResolvedSource, 'css' | 'base' | 'baseFallbacks'>): string;
+declare function loadTailwindV4DesignSystem(source: TailwindV4ResolvedSource, options?: {
+  cache?: boolean;
+}): Promise<TailwindV4DesignSystem>;
+declare function compileTailwindV4Source(source: TailwindV4ResolvedSource): Promise<{
+  compiled: TailwindV4CompiledSource;
+  dependencies: Set<string>;
+}>;
+//#endregion
+//#region src/v4/source-scan/matcher.d.ts
+declare function isFileExcludedByTailwindV4SourceEntries(file: string, entries: TailwindV4SourcePattern[] | undefined): boolean;
+declare function isFileMatchedByTailwindV4SourceEntries(file: string, entries: TailwindV4SourcePattern[] | undefined): boolean;
+declare function createTailwindV4SourceEntryMatcher(entries: TailwindV4SourcePattern[] | undefined): ((file: string) => boolean) | undefined;
+declare function createTailwindV4SourceExclusionMatcher(entries: TailwindV4SourcePattern[] | undefined): ((file: string) => boolean) | undefined;
+declare function groupTailwindV4SourceEntriesByBase(entries: TailwindV4SourcePattern[]): Map<string, TailwindV4SourcePattern[]>;
+declare function expandTailwindV4SourceEntries(entries: TailwindV4SourcePattern[], resolveFiles: (options: {
+  cwd: string;
+  sources: TailwindV4SourcePattern[];
+}) => Promise<string[]>): Promise<string[]>;
+declare function mergeTailwindV4SourceEntries(...entries: Array<TailwindV4SourcePattern[] | undefined>): TailwindV4SourcePattern[];
+//#endregion
+//#region src/v4/source-scan/sources.d.ts
+declare const TAILWIND_V4_IGNORED_CONTENT_DIRS: string[];
+declare const TAILWIND_V4_IGNORED_EXTENSIONS: string[];
+declare const TAILWIND_V4_IGNORED_FILES: string[];
+declare const TAILWIND_V4_AUTO_SOURCE_SCAN_PATTERN = "**/*";
+declare function toPosixPath(value: string): string;
+declare function resolveSourceScanPath(value: string): string;
+declare function normalizeGlobPattern(pattern: string): string;
+declare function createTailwindV4DefaultIgnoreSources(base: string): TailwindV4SourcePattern[];
+declare function createTailwindV4RootSources(root: TailwindV4CompiledSourceRoot, fallbackBase: string): TailwindV4SourcePattern[];
+declare function createTailwindV4CompiledSourceEntries(root: TailwindV4CompiledSourceRoot, sources: TailwindV4SourcePattern[], fallbackBase: string): TailwindV4SourcePattern[];
+declare function resolveTailwindV4SourceEntry(sourcePath: string, base: string, negated: boolean, defaultPattern?: string): Promise<TailwindV4SourcePattern>;
+declare function normalizeTailwindV4SourceEntries(sources: TailwindV4SourcePattern[], options?: {
+  cwd?: string;
+  defaultPattern?: string;
+}): Promise<TailwindV4SourcePattern[]>;
+declare function expandTailwindV4SourceEntryBraces(sources: TailwindV4SourcePattern[]): TailwindV4SourcePattern[];
+declare function normalizeTailwindV4ScannerSources(sources: TailwindV4SourcePattern[] | undefined, cwd: string, ignoredSources?: TailwindV4SourcePattern[]): SourceEntry[];
+declare function resolveTailwindV4SourceBaseCandidates(projectRoot: string, base: string, baseFallbacks: string[]): string[];
+//#endregion
+//#region src/v4/source.d.ts
+declare function resolveTailwindV4Source(options?: TailwindV4SourceOptions): Promise<TailwindV4ResolvedSource>;
+//#endregion
+//#region src/v4/style-generator.d.ts
+declare function collectTailwindV4StyleCandidates(options: Pick<TailwindV4StyleGenerateOptions, 'bareArbitraryValues' | 'candidates' | 'sources'>): Promise<Set<string>>;
+declare function generateTailwindV4Style(options?: TailwindV4StyleGenerateOptions): Promise<TailwindV4StyleGenerateResult>;
+//#endregion
+export { TailwindV4StyleGenerateOptions as $, createTailwindGenerationSession as A, SourceEntry$1 as B, isFileExcludedByTailwindV4SourceEntries as C, getTailwindV4DesignSystemCacheKey as D, compileTailwindV4Source as E, extractTailwindV4InlineSourceCandidates as F, TailwindV4CssSource as G, TailwindGenerationSession as H, CssFragment as I, TailwindV4GenerateOptions as J, TailwindV4DesignSystem as K, CssFragmentKind as L, canonicalizeBareArbitraryValueCandidates as M, replaceBareArbitraryValueSelectors as N, loadTailwindV4DesignSystem as O, resolveValidTailwindV4Candidates as P, TailwindV4SourcePattern as Q, GenerationChange as R, groupTailwindV4SourceEntriesByBase as S, mergeTailwindV4SourceEntries as T, TailwindV4CandidateSource as U, TailwindGenerationArtifact as V, TailwindV4CompiledSourceRoot as W, TailwindV4ResolvedSource as X, TailwindV4GenerateResult as Y, TailwindV4SourceOptions as Z, resolveTailwindV4SourceEntry as _, TAILWIND_V4_IGNORED_CONTENT_DIRS as a, isBareArbitraryValuesEnabled as at, createTailwindV4SourceExclusionMatcher as b, createTailwindV4CompiledSourceEntries as c, extractBareArbitraryValueSourceCandidatesWithPositions as ct, expandTailwindV4SourceEntryBraces as d, BareArbitraryValueSourceCandidate as dt, TailwindV4StyleGenerateResult as et, normalizeGlobPattern as f, escapeCssClassName as ft, resolveTailwindV4SourceBaseCandidates as g, resolveSourceScanPath as h, TAILWIND_V4_AUTO_SOURCE_SCAN_PATTERN as i, collectTailwindStyleCandidates as it, createTailwindV4Engine as j, loadTailwindV4NodeModule as k, createTailwindV4DefaultIgnoreSources as l, BareArbitraryValueOptions as lt, normalizeTailwindV4SourceEntries as m, generateTailwindV4Style as n, TailwindStyleCandidateOptions as nt, TAILWIND_V4_IGNORED_EXTENSIONS as o, resolveBareArbitraryValueCandidate as ot, normalizeTailwindV4ScannerSources as p, TailwindV4Engine as q, resolveTailwindV4Source as r, TailwindStyleSource as rt, TAILWIND_V4_IGNORED_FILES as s, extractBareArbitraryValueSourceCandidates as st, collectTailwindV4StyleCandidates as t, TailwindV4StyleSource as tt, createTailwindV4RootSources as u, BareArbitraryValueResolveResult as ut, toPosixPath as v, isFileMatchedByTailwindV4SourceEntries as w, expandTailwindV4SourceEntries as x, createTailwindV4SourceEntryMatcher as y, GenerationRequest as z };

package/dist/index-CJQBHKch.d.ts

@@ -0,0 +1,267 @@
+import { Root } from "postcss";
+import { SourceEntry } from "@tailwindcss/oxide";
+//#region src/v4/bare-arbitrary-values/escape.d.ts
+declare function escapeCssClassName(value: string): string;
+//#endregion
+//#region src/v4/bare-arbitrary-values/types.d.ts
+interface BareArbitraryValueOptions {
+  /**
+   * 允许作为无方括号任意值的单位列表。
+   */
+  units?: string[];
+}
+interface BareArbitraryValueResolveResult {
+  candidate: string;
+  canonicalCandidate: string;
+}
+interface BareArbitraryValueSourceCandidate {
+  rawCandidate: string;
+  start: number;
+  end: number;
+}
+//#endregion
+//#region src/v4/bare-arbitrary-values/extract.d.ts
+declare function extractBareArbitraryValueSourceCandidatesWithPositions(content: string, options?: boolean | BareArbitraryValueOptions): BareArbitraryValueSourceCandidate[];
+declare function extractBareArbitraryValueSourceCandidates(content: string, options?: boolean | BareArbitraryValueOptions): string[];
+//#endregion
+//#region src/v4/bare-arbitrary-values/resolve.d.ts
+declare function isBareArbitraryValuesEnabled(options: boolean | BareArbitraryValueOptions | undefined): boolean;
+declare function resolveBareArbitraryValueCandidate(candidate: string, options?: boolean | BareArbitraryValueOptions): BareArbitraryValueResolveResult | undefined;
+//#endregion
+//#region src/style-candidates.d.ts
+interface TailwindStyleSource {
+  content: string;
+  extension?: string;
+  file?: string;
+}
+interface TailwindStyleCandidateOptions {
+  candidates?: Iterable<string>;
+  sources?: TailwindStyleSource[];
+  /**
+   * 启用 UnoCSS 风格的裸任意值，例如 `p-10%`、`p-2.5px`。
+   */
+  bareArbitraryValues?: boolean | BareArbitraryValueOptions;
+}
+declare function collectTailwindStyleCandidates(options?: TailwindStyleCandidateOptions): Promise<Set<string>>;
+//#endregion
+//#region src/v4/types.d.ts
+interface TailwindV4SourceOptions {
+  projectRoot?: string;
+  cwd?: string;
+  base?: string;
+  baseFallbacks?: string[];
+  css?: string;
+  cssSources?: TailwindV4CssSource[];
+  cssEntries?: string[];
+  packageName?: string;
+}
+interface TailwindV4CssSource {
+  css: string;
+  base?: string;
+  file?: string;
+  dependencies?: string[];
+}
+interface TailwindV4ResolvedSource {
+  projectRoot: string;
+  base: string;
+  baseFallbacks: string[];
+  css: string;
+  dependencies: string[];
+}
+interface TailwindV4CandidateSource {
+  content: string;
+  extension?: string;
+}
+interface SourceEntry$1 extends TailwindV4CandidateSource {
+  id: string;
+}
+interface GenerationRequest {
+  candidates?: Iterable<string>;
+  sourceEntries?: SourceEntry$1[];
+  /**
+   * 启用 UnoCSS 风格的裸任意值，例如 `p-10%`、`p-2.5px`。
+   */
+  bareArbitraryValues?: TailwindV4GenerateOptions['bareArbitraryValues'];
+}
+type GenerationChange = {
+  type: 'all';
+} | {
+  type: 'candidates';
+} | {
+  type: 'sourceEntries';
+} | {
+  type: 'dependencies';
+  paths?: Iterable<string>;
+} | {
+  type: 'source';
+  source: TailwindV4ResolvedSource;
+};
+type CssFragmentKind = 'tailwind' | 'theme' | 'preflight';
+interface CssFragment {
+  id: string;
+  kind: CssFragmentKind;
+  root: Root;
+  sourceId: string;
+  order: number;
+}
+interface TailwindGenerationArtifact {
+  fragments: CssFragment[];
+  classSet: Set<string>;
+  rawCandidates: Set<string>;
+  dependencies: string[];
+  sourceEntries: SourceEntry$1[];
+}
+interface TailwindGenerationSession {
+  readonly source: TailwindV4ResolvedSource;
+  generate: (request?: GenerationRequest) => Promise<TailwindGenerationArtifact>;
+  invalidate: (change: GenerationChange) => void;
+  dispose: () => void;
+}
+interface TailwindV4StyleSource extends TailwindStyleSource {}
+interface TailwindV4GenerateOptions {
+  candidates?: Iterable<string>;
+  sources?: TailwindV4CandidateSource[];
+  /**
+   * 启用 UnoCSS 风格的裸任意值，例如 `p-10%`、`p-2.5px`。
+   */
+  bareArbitraryValues?: boolean | {
+    units?: string[];
+  };
+  /**
+   * 扫描文件系统 source entries 中的候选类名。
+   *
+   * - `true`：使用 Tailwind v4 编译入口解析出的 `@source` 列表。
+   * - `TailwindV4SourcePattern[]`：使用调用方显式传入的 source 列表。
+   */
+  scanSources?: boolean | TailwindV4SourcePattern[];
+}
+type TailwindV4CompiledSourceRoot = null | 'none' | {
+  base: string;
+  pattern: string;
+};
+interface TailwindV4SourcePattern {
+  base: string;
+  pattern: string;
+  negated: boolean;
+}
+interface TailwindV4GenerateResult {
+  css: string;
+  classSet: Set<string>;
+  rawCandidates: Set<string>;
+  dependencies: string[];
+  sources: TailwindV4SourcePattern[];
+  root: TailwindV4CompiledSourceRoot;
+}
+interface TailwindV4StyleGenerateOptions extends TailwindV4SourceOptions {
+  source?: TailwindV4ResolvedSource;
+  candidates?: Iterable<string>;
+  sources?: TailwindV4StyleSource[];
+  /**
+   * 启用 UnoCSS 风格的裸任意值，例如 `p-10%`、`p-2.5px`。
+   */
+  bareArbitraryValues?: TailwindV4GenerateOptions['bareArbitraryValues'];
+  /**
+   * 除内存来源外，还扫描 Tailwind CSS v4 编译后解析的来源入口。
+   */
+  scanSources?: TailwindV4GenerateOptions['scanSources'];
+}
+interface TailwindV4StyleGenerateResult extends TailwindV4GenerateResult {
+  tokens: Set<string>;
+  source: TailwindV4ResolvedSource;
+}
+interface TailwindV4DesignSystem {
+  parseCandidate: (candidate: string) => unknown[];
+  candidatesToCss: (candidates: string[]) => Array<string | null | undefined>;
+}
+interface TailwindV4Engine {
+  source: TailwindV4ResolvedSource;
+  loadDesignSystem: () => Promise<TailwindV4DesignSystem>;
+  validateCandidates: (candidates: Iterable<string>) => Promise<Set<string>>;
+  generate: (options?: TailwindV4GenerateOptions) => Promise<TailwindV4GenerateResult>;
+}
+//#endregion
+//#region src/v4/candidates/inline-source.d.ts
+declare function extractTailwindV4InlineSourceCandidates(css: string): {
+  included: Set<string>;
+  excluded: Set<string>;
+};
+//#endregion
+//#region src/v4/candidates.d.ts
+declare function resolveValidTailwindV4Candidates(designSystem: TailwindV4DesignSystem, candidates: Iterable<string>, options?: {
+  bareArbitraryValues?: boolean | BareArbitraryValueOptions;
+}): Set<string>;
+declare function replaceBareArbitraryValueSelectors(css: string, candidates: Iterable<string>, options?: boolean | BareArbitraryValueOptions): string;
+declare function canonicalizeBareArbitraryValueCandidates(candidates: Iterable<string>, options?: boolean | BareArbitraryValueOptions): string[];
+//#endregion
+//#region src/v4/engine.d.ts
+declare function createTailwindV4Engine(source: TailwindV4ResolvedSource): TailwindV4Engine;
+//#endregion
+//#region src/v4/generation-session.d.ts
+declare function createTailwindGenerationSession(source: TailwindV4ResolvedSource): TailwindGenerationSession;
+//#endregion
+//#region src/v4/node-adapter.d.ts
+interface TailwindV4CompiledSource {
+  sources: TailwindV4SourcePattern[];
+  root: TailwindV4CompiledSourceRoot;
+  build: (candidates: string[]) => string;
+}
+interface TailwindV4NodeModule {
+  compile: (css: string, options: {
+    base: string;
+    onDependency: (dependency: string) => void;
+    customCssResolver?: (id: string, base: string) => Promise<string | false | undefined>;
+  }) => Promise<TailwindV4CompiledSource>;
+  __unstable__loadDesignSystem: (css: string, options: {
+    base: string;
+  }) => Promise<TailwindV4DesignSystem>;
+}
+declare function loadTailwindV4NodeModule(baseCandidates: string[]): Promise<TailwindV4NodeModule>;
+declare function getTailwindV4DesignSystemCacheKey(source: Pick<TailwindV4ResolvedSource, 'css' | 'base' | 'baseFallbacks'>): string;
+declare function loadTailwindV4DesignSystem(source: TailwindV4ResolvedSource, options?: {
+  cache?: boolean;
+}): Promise<TailwindV4DesignSystem>;
+declare function compileTailwindV4Source(source: TailwindV4ResolvedSource): Promise<{
+  compiled: TailwindV4CompiledSource;
+  dependencies: Set<string>;
+}>;
+//#endregion
+//#region src/v4/source-scan/matcher.d.ts
+declare function isFileExcludedByTailwindV4SourceEntries(file: string, entries: TailwindV4SourcePattern[] | undefined): boolean;
+declare function isFileMatchedByTailwindV4SourceEntries(file: string, entries: TailwindV4SourcePattern[] | undefined): boolean;
+declare function createTailwindV4SourceEntryMatcher(entries: TailwindV4SourcePattern[] | undefined): ((file: string) => boolean) | undefined;
+declare function createTailwindV4SourceExclusionMatcher(entries: TailwindV4SourcePattern[] | undefined): ((file: string) => boolean) | undefined;
+declare function groupTailwindV4SourceEntriesByBase(entries: TailwindV4SourcePattern[]): Map<string, TailwindV4SourcePattern[]>;
+declare function expandTailwindV4SourceEntries(entries: TailwindV4SourcePattern[], resolveFiles: (options: {
+  cwd: string;
+  sources: TailwindV4SourcePattern[];
+}) => Promise<string[]>): Promise<string[]>;
+declare function mergeTailwindV4SourceEntries(...entries: Array<TailwindV4SourcePattern[] | undefined>): TailwindV4SourcePattern[];
+//#endregion
+//#region src/v4/source-scan/sources.d.ts
+declare const TAILWIND_V4_IGNORED_CONTENT_DIRS: string[];
+declare const TAILWIND_V4_IGNORED_EXTENSIONS: string[];
+declare const TAILWIND_V4_IGNORED_FILES: string[];
+declare const TAILWIND_V4_AUTO_SOURCE_SCAN_PATTERN = "**/*";
+declare function toPosixPath(value: string): string;
+declare function resolveSourceScanPath(value: string): string;
+declare function normalizeGlobPattern(pattern: string): string;
+declare function createTailwindV4DefaultIgnoreSources(base: string): TailwindV4SourcePattern[];
+declare function createTailwindV4RootSources(root: TailwindV4CompiledSourceRoot, fallbackBase: string): TailwindV4SourcePattern[];
+declare function createTailwindV4CompiledSourceEntries(root: TailwindV4CompiledSourceRoot, sources: TailwindV4SourcePattern[], fallbackBase: string): TailwindV4SourcePattern[];
+declare function resolveTailwindV4SourceEntry(sourcePath: string, base: string, negated: boolean, defaultPattern?: string): Promise<TailwindV4SourcePattern>;
+declare function normalizeTailwindV4SourceEntries(sources: TailwindV4SourcePattern[], options?: {
+  cwd?: string;
+  defaultPattern?: string;
+}): Promise<TailwindV4SourcePattern[]>;
+declare function expandTailwindV4SourceEntryBraces(sources: TailwindV4SourcePattern[]): TailwindV4SourcePattern[];
+declare function normalizeTailwindV4ScannerSources(sources: TailwindV4SourcePattern[] | undefined, cwd: string, ignoredSources?: TailwindV4SourcePattern[]): SourceEntry[];
+declare function resolveTailwindV4SourceBaseCandidates(projectRoot: string, base: string, baseFallbacks: string[]): string[];
+//#endregion
+//#region src/v4/source.d.ts
+declare function resolveTailwindV4Source(options?: TailwindV4SourceOptions): Promise<TailwindV4ResolvedSource>;
+//#endregion
+//#region src/v4/style-generator.d.ts
+declare function collectTailwindV4StyleCandidates(options: Pick<TailwindV4StyleGenerateOptions, 'bareArbitraryValues' | 'candidates' | 'sources'>): Promise<Set<string>>;
+declare function generateTailwindV4Style(options?: TailwindV4StyleGenerateOptions): Promise<TailwindV4StyleGenerateResult>;
+//#endregion
+export { TailwindV4StyleGenerateOptions as $, createTailwindGenerationSession as A, SourceEntry$1 as B, isFileExcludedByTailwindV4SourceEntries as C, getTailwindV4DesignSystemCacheKey as D, compileTailwindV4Source as E, extractTailwindV4InlineSourceCandidates as F, TailwindV4CssSource as G, TailwindGenerationSession as H, CssFragment as I, TailwindV4GenerateOptions as J, TailwindV4DesignSystem as K, CssFragmentKind as L, canonicalizeBareArbitraryValueCandidates as M, replaceBareArbitraryValueSelectors as N, loadTailwindV4DesignSystem as O, resolveValidTailwindV4Candidates as P, TailwindV4SourcePattern as Q, GenerationChange as R, groupTailwindV4SourceEntriesByBase as S, mergeTailwindV4SourceEntries as T, TailwindV4CandidateSource as U, TailwindGenerationArtifact as V, TailwindV4CompiledSourceRoot as W, TailwindV4ResolvedSource as X, TailwindV4GenerateResult as Y, TailwindV4SourceOptions as Z, resolveTailwindV4SourceEntry as _, TAILWIND_V4_IGNORED_CONTENT_DIRS as a, isBareArbitraryValuesEnabled as at, createTailwindV4SourceExclusionMatcher as b, createTailwindV4CompiledSourceEntries as c, extractBareArbitraryValueSourceCandidatesWithPositions as ct, expandTailwindV4SourceEntryBraces as d, BareArbitraryValueSourceCandidate as dt, TailwindV4StyleGenerateResult as et, normalizeGlobPattern as f, escapeCssClassName as ft, resolveTailwindV4SourceBaseCandidates as g, resolveSourceScanPath as h, TAILWIND_V4_AUTO_SOURCE_SCAN_PATTERN as i, collectTailwindStyleCandidates as it, createTailwindV4Engine as j, loadTailwindV4NodeModule as k, createTailwindV4DefaultIgnoreSources as l, BareArbitraryValueOptions as lt, normalizeTailwindV4SourceEntries as m, generateTailwindV4Style as n, TailwindStyleCandidateOptions as nt, TAILWIND_V4_IGNORED_EXTENSIONS as o, resolveBareArbitraryValueCandidate as ot, normalizeTailwindV4ScannerSources as p, TailwindV4Engine as q, resolveTailwindV4Source as r, TailwindStyleSource as rt, TAILWIND_V4_IGNORED_FILES as s, extractBareArbitraryValueSourceCandidates as st, collectTailwindV4StyleCandidates as t, TailwindV4StyleSource as tt, createTailwindV4RootSources as u, BareArbitraryValueResolveResult as ut, toPosixPath as v, isFileMatchedByTailwindV4SourceEntries as w, expandTailwindV4SourceEntries as x, createTailwindV4SourceEntryMatcher as y, GenerationRequest as z };