weapp-tailwindcss 5.3.6 → 5.4.0

package/README.md

@@ -22,7 +22,7 @@ Bring Tailwind CSS to every platform. `weapp-tailwindcss` is the core compiler a
 | React Native / Expo | `@weapp-tailwindcss/react-native` |
 | ReactLynx / Rspeedy | `@weapp-tailwindcss/lynx` |
 
-Start with the [installation guide](https://tw.icebreaker.top/docs/quick-start/install) or select a framework from the [documentation website](https://tw.icebreaker.top/).
+Start with the [installation guide](https://tw.weapp.dev/docs/quick-start/install) or select a framework from the [documentation website](https://tw.weapp.dev/).
 
 ## Tailwind CSS 4 entry
 
@@ -46,7 +46,7 @@ pnpm exec weapp-tw -i src/input.css -o dist/output.css --watch
 
 The CLI generates Web CSS by default. `--target weapp` performs CSS-only mini-program compatibility conversion; complete WXML, JavaScript, and WXSS projects still require a bundler integration. Watch mode uses `@parcel/watcher` native events by default and supports explicit polling with `--poll`.
 
-See the [CLI guide](https://tw.icebreaker.top/docs/tools/weapp-tw-cli) for source maps, stdin/stdout, watch mode, and `canonicalize`.
+See the [CLI guide](https://tw.weapp.dev/docs/tools/weapp-tw-cli) for source maps, stdin/stdout, watch mode, and `canonicalize`.
 
 ## Runtime requirements
 
@@ -55,7 +55,7 @@ See the [CLI guide](https://tw.icebreaker.top/docs/tools/weapp-tw-cli) for sourc
 
 ## Community and support
 
-- [Documentation](https://tw.icebreaker.top/)
+- [Documentation](https://tw.weapp.dev/)
 - [GitHub Issues](https://github.com/sonofmagic/weapp-tailwindcss/issues)
 - [GitHub Discussions](https://github.com/sonofmagic/weapp-tailwindcss/discussions)
 

package/README.zh-CN.md

@@ -22,7 +22,7 @@
 | React Native / Expo | `@weapp-tailwindcss/react-native` |
 | ReactLynx / Rspeedy | `@weapp-tailwindcss/lynx` |
 
-从[安装指南](https://tw.icebreaker.top/zh-cn/docs/quick-start/install)开始，或在[中文官网](https://tw.icebreaker.top/zh-cn/)按框架选择接入方式。
+从[安装指南](https://tw.weapp.dev/zh-cn/docs/quick-start/install)开始，或在[中文官网](https://tw.weapp.dev/zh-cn/)按框架选择接入方式。
 
 ## Tailwind CSS 4 入口
 
@@ -46,7 +46,7 @@ pnpm exec weapp-tw -i src/input.css -o dist/output.css --watch
 
 CLI 默认生成 Web CSS。`--target weapp` 只进行小程序 CSS 兼容转换；完整 WXML、JavaScript 与 WXSS 项目仍需使用构建器集成。watch 默认使用 `@parcel/watcher` 原生事件，也可以通过 `--poll` 显式切换轮询。
 
-source map、stdin/stdout、watch 与 `canonicalize` 的完整用法见 [CLI 指南](https://tw.icebreaker.top/zh-cn/docs/tools/weapp-tw-cli)。
+source map、stdin/stdout、watch 与 `canonicalize` 的完整用法见 [CLI 指南](https://tw.weapp.dev/zh-cn/docs/tools/weapp-tw-cli)。
 
 ## 运行环境
 
@@ -55,9 +55,9 @@ source map、stdin/stdout、watch 与 `canonicalize` 的完整用法见 [CLI 指
 
 ## 社区与支持
 
-- [官方文档](https://tw.icebreaker.top)
+- [官方文档](https://tw.weapp.dev)
 - [GitHub Issues](https://github.com/sonofmagic/weapp-tailwindcss/issues)
-- [技术交流群](https://tw.icebreaker.top/zh-cn/docs/community/group)
+- [技术交流群](https://tw.weapp.dev/zh-cn/docs/community/group)
 
 ## License
 

package/dist/bundlers/shared/framework-postcss.d.ts

@@ -1,5 +1,6 @@
 import type { IStyleHandlerOptions, LoadedPostcssOptions } from '@weapp-tailwindcss/postcss/types';
 import type { GenerateCssByGeneratorResult } from './generator-css.js';
+import type { Compiler, CompilerSnapshot } from '../../core/compiler/index.js';
 import type { InternalUserDefinedOptions } from '../../types/index.js';
 export declare function resolveFrameworkPostcssOptions(value: unknown): LoadedPostcssOptions | undefined;
 export declare function collectFrameworkPostcssOptionsFromLoaderEntries(entries: unknown[], loaderContext?: unknown): LoadedPostcssOptions | undefined;
@@ -18,4 +19,6 @@ export declare function adaptGeneratedCssWithFrameworkRootPipeline(owner: Intern
     majorVersion: number;
     rawCandidates: Iterable<string>;
     styleHandler: InternalUserDefinedOptions['styleHandler'];
+    compiler?: Compiler | undefined;
+    snapshot?: CompilerSnapshot | undefined;
 }): Promise<string>;

package/dist/bundlers/shared/generator-css/result-helpers.d.ts

@@ -1,6 +1,6 @@
 import type { normalizeWeappTailwindcssGeneratorOptions } from '../../../generator/index.js';
 import { finalizeMiniProgramGeneratorCss } from './generation-helpers.js';
 export declare function isCssAlreadyRepresentedByMarkers(css: string, source: string): boolean;
-export declare function resolveGeneratedCssClassSet(target: string, classSet: Set<string>, candidates: Iterable<string>, css: string, escapeMap: Record<string, string> | undefined, previousClassSet?: Set<string> | undefined): Set<string>;
+export declare function resolveGeneratedCssClassSet(target: string, classSet: ReadonlySet<string>, candidates: Iterable<string>, css: string, escapeMap: Record<string, string> | undefined, previousClassSet?: Set<string> | undefined): Set<string>;
 export declare function finalizeWebGeneratorCss(css: string, target: string, webCompat: ReturnType<typeof normalizeWeappTailwindcssGeneratorOptions>['webCompat']): string;
 export declare function finalizeIncrementalGeneratorCss(previousCss: string, incrementalCss: string, target: string, majorVersion: number | undefined, cssPreflight: Parameters<typeof finalizeMiniProgramGeneratorCss>[3], options: Parameters<typeof finalizeMiniProgramGeneratorCss>[4], webCompat: ReturnType<typeof normalizeWeappTailwindcssGeneratorOptions>['webCompat']): string;

package/dist/bundlers/shared/generator-css/source-resolver/single-source.d.ts

@@ -13,4 +13,4 @@ export declare function resolveCandidateMatchedTailwindV4CssSource(_rawSource: s
 export declare function resolveTailwindV4CssEntryIncludesPreflight(cssEntry: string): Promise<boolean | undefined>;
 export declare function resolveCandidateMatchedTailwindV4CssEntry(sourceOptions: TailwindV4SourceOptions, selectionOptions: GeneratorSourceSelectionOptions | undefined): Promise<import("./metadata.js").GeneratorResolvedSource | undefined>;
 export declare function createTailwindV4CssSourceResolver(sourceOptions: TailwindV4SourceOptions, generatorOptions: NormalizedWeappTailwindcssGeneratorOptions | undefined): (cssSource: NonNullable<typeof sourceOptions.cssSources>[number], index: number) => Promise<import("./metadata.js").GeneratorResolvedSource>;
-export declare function resolveTailwindV4SourceSideEntrySource(resolvedEntrySource: ReturnType<typeof resolveSourceSideCssEntrySource>, sourceOptions: ReturnType<typeof resolveTailwindV4SourceOptionsFromRuntime>, generatorOptions: NormalizedWeappTailwindcssGeneratorOptions | undefined, file: string): Promise<import("../../../../generator/index.js").TailwindV4ResolvedSource | undefined>;
+export declare function resolveTailwindV4SourceSideEntrySource(resolvedEntrySource: ReturnType<typeof resolveSourceSideCssEntrySource>, sourceOptions: ReturnType<typeof resolveTailwindV4SourceOptionsFromRuntime>, generatorOptions: NormalizedWeappTailwindcssGeneratorOptions | undefined, file: string, currentCss?: string): Promise<import("../../../../generator/index.js").TailwindV4ResolvedSource | undefined>;

package/dist/bundlers/shared/generator-css/types.d.ts

@@ -1,6 +1,7 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
 import type { TailwindV4CssSource } from './source-resolver/types.js';
 import type { CompilationDependencyChange, SourceScope } from '../../../compiler/index.js';
+import type { CompilerSnapshot } from '../../../core/compiler/index.js';
 import type { TailwindSourceEntry } from '../../../tailwindcss/source-scan.js';
 import type { InternalUserDefinedOptions } from '../../../types/index.js';
 export interface GenerateCssByGeneratorOptions {
@@ -40,10 +41,11 @@ export interface GenerateCssByGeneratorOptions {
 }
 export interface GenerateCssByGeneratorResult {
     css: string;
-    classSet: Set<string>;
+    classSet: ReadonlySet<string>;
     target: string;
     source: 'generator';
     dependencies: string[];
+    snapshot?: CompilerSnapshot | undefined;
     incremental?: boolean | undefined;
     metadata?: {
         file: string;

package/dist/bundlers/shared/source-candidates/snapshot.d.ts

@@ -0,0 +1,19 @@
+import type { SourceCandidateCollectorSnapshot } from './types-and-cache.js';
+type CandidateMap = Map<string, Set<string>>;
+type SourceMap = Map<string, string>;
+interface SnapshotMaps {
+    candidatesById: CandidateMap;
+    scanCandidatesById: CandidateMap;
+    transformCandidatesById: CandidateMap;
+    cssCandidatesById: CandidateMap;
+    moduleCandidatesById: CandidateMap;
+    scanSourceById: SourceMap;
+    transformSourceById: SourceMap;
+    cssSourceById: SourceMap;
+    moduleSourceById: SourceMap;
+    inlineIncludedCandidates: Set<string>;
+    inlineExcludedCandidates: Set<string>;
+}
+export declare function createCandidateSnapshot(maps: SnapshotMaps): SourceCandidateCollectorSnapshot;
+export declare function restoreCandidateSnapshot(maps: SnapshotMaps, snapshot: SourceCandidateCollectorSnapshot, clear: () => void, recompute: (id: string) => void, setInlineCandidates: (included: Set<string>, excluded: Set<string>) => void): void;
+export {};

package/dist/bundlers/shared/source-candidates/source-priority.d.ts

@@ -0,0 +1 @@
+export declare function mergeSourcesByPriority(moduleSourceById: Map<string, string>, transformSourceById: Map<string, string>, cssSourceById: Map<string, string>, scanSourceById: Map<string, string>): Map<string, string>;

package/dist/bundlers/shared/source-candidates/types-and-cache.d.ts

@@ -25,6 +25,7 @@ export interface SourceCandidateStore {
     clearScan: () => void;
     resetScan: () => void;
     clear: () => void;
+    getRevision: () => number;
 }
 export interface SourceCandidateCollector extends SourceCandidateStore {
 }

package/dist/bundlers/shared/source-candidates/views.d.ts

@@ -0,0 +1,12 @@
+import type { TailwindSourceEntry } from '../../../tailwindcss/source-scan.js';
+type CandidateMap = Map<string, Set<string>>;
+interface CandidateViewOptions {
+    candidatesById: CandidateMap;
+    moduleCandidatesById: CandidateMap;
+    candidateCount: Map<string, number>;
+    inlineIncludedCandidates: Set<string>;
+    inlineExcludedCandidates: Set<string>;
+}
+export declare function collectCandidateValues(view: CandidateViewOptions, entries?: TailwindSourceEntry[], excludeEntries?: TailwindSourceEntry[]): Set<string>;
+export declare function collectCandidateSources(view: CandidateViewOptions, entries?: TailwindSourceEntry[], excludeEntries?: TailwindSourceEntry[]): Map<string, Set<string>>;
+export {};

package/dist/bundlers/shared/style-requests.d.ts

@@ -1,4 +1,5 @@
 export declare function stripRequestQuery(request: string): string;
 export declare function isSourceStyleRequest(request: string | undefined): boolean;
+export declare function isSfcStyleSourceRequest(request: string | undefined): boolean;
 export declare function isSourcePreprocessorRequest(request: string | undefined, lang?: string): boolean;
 export declare function isVueScopedStyleRequest(request: string | undefined): boolean;

package/dist/bundlers/vite/bundle-state.d.ts

@@ -9,7 +9,14 @@ export interface BundleStateEntry extends RuntimeSnapshotEntry {
 export interface BundleSnapshot extends RuntimeCompilationSnapshot<BundleStateEntry> {
     jsEntries: Map<string, OutputEntry>;
 }
-export type BundleBuildState = RuntimeCompilationBuildState;
+interface BundleEntryMetadata {
+    outputType: OutputAsset['type'] | OutputChunk['type'];
+    runtimeCandidate: boolean;
+    type: EntryType;
+}
+export interface BundleBuildState extends RuntimeCompilationBuildState {
+    entryMetadataByFile: Map<string, BundleEntryMetadata>;
+}
 export interface BuildBundleSnapshotOptions {
     hasOmittedKnownFiles?: boolean | undefined;
     removedFiles?: Iterable<string> | undefined;
@@ -20,3 +27,4 @@ export declare function classifyBundleEntry(file: string, opts: InternalUserDefi
 export declare function buildBundleSnapshot(bundle: Record<string, OutputAsset | OutputChunk>, opts: InternalUserDefinedOptions, outDir: string, state: BundleBuildState, forceAll?: boolean, options?: BuildBundleSnapshotOptions): BundleSnapshot;
 export declare function buildBundleSnapshotForBuild(bundle: Record<string, OutputAsset | OutputChunk>, opts: InternalUserDefinedOptions, outDir: string): BundleSnapshot;
 export declare function updateBundleBuildState(state: BundleBuildState, snapshot: BundleSnapshot, linkedByEntry: Map<string, Set<string>>, options?: UpdateRuntimeCompilationBuildStateOptions): void;
+export {};

package/dist/bundlers/vite/capability-profile.d.ts

@@ -0,0 +1,18 @@
+import type { ViteFrameworkName } from '../framework-selector.js';
+import type { UserDefinedOptions } from '../../types/index.js';
+export interface ViteCapabilityProfile {
+    name: 'framework' | 'generic-web';
+    frameworkName: ViteFrameworkName;
+    generatorTarget: 'web' | 'weapp' | 'app' | undefined;
+    platformFamily: 'web' | 'native-app' | 'mini-program' | 'unknown';
+    command?: 'serve' | 'build' | undefined;
+    watch?: boolean;
+    ssr?: boolean;
+    environmentName?: string;
+    sourceCandidates: boolean;
+    frameworkExtras: boolean;
+    serveJsTransform: boolean;
+    styleInjector: boolean;
+}
+export declare const frameworkViteCapabilityProfile: ViteCapabilityProfile;
+export declare function createGenericWebViteCapabilityProfile(options: UserDefinedOptions): ViteCapabilityProfile;

package/dist/bundlers/vite/generate-bundle/js-processing.d.ts

@@ -32,5 +32,17 @@ interface ProcessJsBundleEntryOptions {
     uniAppX: GenerateBundleContext['opts']['uniAppX'];
     useIncrementalMode: boolean;
 }
+interface ReplayCleanJsBundleEntryOptions {
+    cache: GenerateBundleContext['opts']['cache'];
+    debug: GenerateBundleContext['debug'];
+    entry: BundleStateEntry;
+    metrics: BundleMetrics;
+    rememberProcessCacheKey: (cacheKey: string, hashKey?: string | number) => void;
+    snapshot: BundleSnapshot;
+    transformFilterSignature: string;
+    transformRuntimeSignature: string;
+    useIncrementalMode: boolean;
+}
+export declare function replayCleanJsBundleEntry(options: ReplayCleanJsBundleEntryOptions): boolean;
 export declare function processJsBundleEntry(options: ProcessJsBundleEntryOptions): void;
 export {};

package/dist/bundlers/vite/hot-css-modules.d.ts

@@ -1,8 +1,8 @@
 import type { HmrContext, ModuleNode } from 'vite';
-export declare function resolveHotTailwindCssModules(ctx: HmrContext, tailwindRootCssModuleIds: Iterable<string | null | undefined>): Promise<ModuleNode[]>;
+export declare function resolveHotTailwindCssModules(ctx: HmrContext, tailwindRootCssModuleIds: Iterable<string | null | undefined>, selectModules?: (modules: ModuleNode[]) => ModuleNode[]): Promise<ModuleNode[]>;
 export declare function resolveHotSourceModulesByIds(ctx: HmrContext, ids: Iterable<string | null | undefined>): Promise<ModuleNode[]>;
 export declare function resolveHotSourceModules(ctx: HmrContext): Promise<ModuleNode[]>;
 export declare function mergeHotModulesByIdentity(root: string, ...groups: ModuleNode[][]): ModuleNode[];
 export declare function hasSelfAcceptingNonStyleHotModule(modules: ModuleNode[]): boolean;
-export declare function sendSupplementalCssHotUpdates(ctx: HmrContext, cssModules: ModuleNode[], fallbackCssIds?: Iterable<string>, fallbackSourceIds?: Iterable<string>): void;
+export declare function sendSupplementalCssHotUpdates(ctx: HmrContext, cssModules: ModuleNode[], fallbackCssIds?: Iterable<string>, fallbackSourceIds?: Iterable<string>, handledModules?: ModuleNode[]): void;
 export declare function sendFullReloadForUnresolvedHotUpdate(ctx: HmrContext): void;

package/dist/bundlers/vite/shared/configured-css-entry-observer.d.ts

@@ -0,0 +1,29 @@
+import type { Plugin } from 'vite';
+interface ConfiguredCssEntryObserverOptions {
+    delayMs?: number;
+    getEntries: () => string[] | undefined;
+    getRoot: () => string | undefined;
+    onMissing: (entries: string[]) => void;
+}
+export declare function createConfiguredCssEntryObserver(options: ConfiguredCssEntryObserverOptions): {
+    dispose(): void;
+    flush: () => void;
+    observe(id: string): void;
+    observeSourceImports(source: string, sourceId: string): void;
+    requestCheck(): void;
+};
+export declare function createConfiguredCssEntryDiagnostics(options: {
+    getEntries: () => string[] | undefined;
+    getRoot: () => string | undefined;
+    isWeb: () => boolean;
+}): {
+    observer: {
+        dispose(): void;
+        flush: () => void;
+        observe(id: string): void;
+        observeSourceImports(source: string, sourceId: string): void;
+        requestCheck(): void;
+    };
+    plugin: Plugin<any>;
+};
+export {};

package/dist/bundlers/vite/shared/create-framework-plugins.d.ts

@@ -1,6 +1,7 @@
 import type { HmrContext, Plugin, ResolvedConfig } from 'vite';
 import type { ViteFrameworkName } from '../../framework-selector.js';
 import type { createViteRuntimeClassSet } from '../runtime-class-set.js';
+import type { ViteHmrCssModuleVersionTracker } from './framework-hmr-module-version.js';
 import type { ViteFrameworkCssPipelineStrategy, ViteFrameworkExtraPluginPlatform, ViteFrameworkRuntimeFeatureContext } from './framework-strategy.js';
 import type { getCompilerContext } from '../../../context/index.js';
 import type { toCustomAttributesEntities } from '../../../context/custom-attributes.js';
@@ -26,6 +27,7 @@ export interface ViteFrameworkExtraPluginContext {
     ensureRuntimeClassSet: (...args: any[]) => Promise<Set<string>>;
     generateCss: (...args: any[]) => Promise<string | undefined>;
     getResolvedConfig: () => ResolvedConfig | undefined;
+    hmrCssModuleVersions: ViteHmrCssModuleVersionTracker;
     isEnabled: () => boolean;
     isIosPlatform: boolean;
     isNativeAppStyleTarget: () => boolean;
@@ -39,5 +41,11 @@ export interface ViteFrameworkExtraPluginContext {
     tailwindRootCssModuleIds: Set<string>;
     uniAppX: ReturnType<typeof getCompilerContext>['uniAppX'];
     viteProcessedCssSourceFiles: Iterable<string>;
+    webCssEntryDiagnostics: {
+        dispose: () => void;
+        flush: () => void;
+        observeSourceImports: (source: string, sourceId: string) => void;
+        requestCheck: () => void;
+    };
 }
 export declare function createViteFrameworkPlugins(options: (UserDefinedOptions | InternalUserDefinedOptions) | undefined, frameworkBranch: ViteFrameworkBranchContext): WeappTailwindcssVitePlugin[] | undefined;

package/dist/bundlers/vite/shared/framework-css-generation-queue.d.ts

@@ -0,0 +1 @@
+export declare function createFrameworkCssGenerationQueue<Args extends unknown[], Result>(normalizeId: (id: string) => string, generate: (id: string, ...args: Args) => Promise<Result>): (id: string, ...args: Args) => Promise<Result>;

package/dist/bundlers/vite/shared/framework-hmr-module-version.d.ts

@@ -0,0 +1,9 @@
+import type { ModuleNode, Plugin } from 'vite';
+export interface ViteHmrCssModuleVersionTracker {
+    clear: () => void;
+    filterIds: (ids: Iterable<string>, timestamp: number, root: string) => string[];
+    filterModules: (modules: ModuleNode[], timestamp: number, root: string) => ModuleNode[];
+    reserveRefreshTimestamp: (modules: ModuleNode[], timestamp: number, root: string) => number;
+}
+export declare function createViteHmrCssModuleVersionTracker(): ViteHmrCssModuleVersionTracker;
+export declare function createViteHmrCssModuleVersionFilterPlugin(tracker: ViteHmrCssModuleVersionTracker): Plugin;

package/dist/bundlers/vite/shared/framework-runtime-utils.d.ts

@@ -0,0 +1,5 @@
+export declare function collectConfiguredCssEntries(options: any): any[] | undefined;
+export declare function inferPlatformFromOutDir(outDir: any): string | undefined;
+export declare function isWebOrNativeAppPlatform(platform: any): boolean;
+export declare function isInternalUserDefinedOptions(options: any): boolean;
+export declare function isNuxtPageHotModule(id: any): boolean;

package/dist/bundlers/vite/shared/framework-source-scan-session.d.ts

@@ -2,11 +2,16 @@ import type { HmrContext } from 'vite';
 import type { createViteCssMemory } from '../css-memory.js';
 import type { createViteRuntimeClassSet } from '../runtime-class-set.js';
 import type { createSourceCandidateCollector } from '../source-candidates.js';
-import type { createViteHmrCandidateState, ViteSourceCandidateChange } from './framework-hmr-candidate-state.js';
+import type { createViteHmrCandidateState } from './framework-hmr-candidate-state.js';
 type SourceCandidateCollector = ReturnType<typeof createSourceCandidateCollector>;
 type CssMemory = ReturnType<typeof createViteCssMemory>;
 type RuntimeState = ReturnType<typeof createViteRuntimeClassSet>['runtimeState'];
 type HmrCandidateState = ReturnType<typeof createViteHmrCandidateState>;
+interface PendingSourceCandidateFileChange {
+    file: string;
+    source?: string;
+    event: 'create' | 'update' | 'delete';
+}
 interface FrameworkSourceScanSessionOptions {
     cssMemory: CssMemory;
     debug: (...args: any[]) => void;
@@ -26,17 +31,22 @@ export declare function createFrameworkSourceScanSession(options: FrameworkSourc
     getStats: () => {
         pendingSourceCandidateSyncByFile: number;
         pendingSourceCandidateSyncs: number;
+        pendingChangedFiles: number;
         pendingHotUpdateChangeByFile: number;
         sourceCandidateScanCache: number;
     };
     invalidate: () => void;
     isDependency: (file: string) => boolean;
     matches: (file: string) => boolean;
+    queueChangedFile: (change: Omit<PendingSourceCandidateFileChange, "file"> & {
+        id: string;
+    }) => void;
+    flushChangedFiles: () => any;
     shouldDiscoverAutoCssSources: (autoCssSourcesDiscovered: boolean) => boolean;
     sync: (syncOptions?: {
         force?: boolean;
     }) => Promise<void>;
-    syncChangedFile: (id: string, sourceOverride?: string) => Promise<ViteSourceCandidateChange | undefined>;
+    syncChangedFile: (id: string, sourceOverride?: string) => any;
     waitForPendingSyncs: () => Promise<void>;
 };
 export {};

package/dist/compiler/compilation-session-pool.d.ts

@@ -8,6 +8,7 @@ export interface CompilationScopeSource extends CompilationScopeGraphSource {
 export interface CompilationScopeGenerationResult {
     classSet: Iterable<string>;
     dependenciesBySource?: Iterable<readonly [string, Iterable<CompilationScopeDependency>]> | undefined;
+    snapshot?: unknown;
 }
 export interface CompilationScopeRequest {
     scope: SourceScope;

package/dist/compiler/framework-compiler-session.d.ts

@@ -0,0 +1,21 @@
+import type { Compiler, CompilerGenerateRequest, CompilerGenerateResult, CompilerSnapshot } from '../core/compiler/types.js';
+import type { TailwindV4ResolvedSource } from '../generator/index.js';
+import type { InternalUserDefinedOptions } from '../types/index.js';
+export declare class FrameworkCompilerSession {
+    readonly compiler: Compiler;
+    private readonly scopeRoots;
+    private readonly activeRoots;
+    private transactionId;
+    private disposed;
+    constructor(options: InternalUserDefinedOptions);
+    rootId(scopeId: string, sourceId: string): string;
+    generate(scopeId: string, sourceId: string, source: TailwindV4ResolvedSource, request: Omit<CompilerGenerateRequest, 'id' | 'source' | 'sourceOptions'>): Promise<CompilerGenerateResult>;
+    syncScope(scopeId: string, sourceIds: Iterable<string>): Promise<void>;
+    removeScope(scopeId: string): Promise<void>;
+    invalidate(ids: Iterable<string>): readonly string[];
+    mergeSnapshots(snapshots: Iterable<CompilerSnapshot>): CompilerSnapshot;
+    dispose(): Promise<void>;
+    private encode;
+}
+export declare function getFrameworkCompilerSession(owner: object, options: InternalUserDefinedOptions): FrameworkCompilerSession;
+export declare function disposeFrameworkCompilerSession(owner: object): Promise<void>;

package/dist/compiler/index.d.ts

@@ -5,6 +5,7 @@ export * from './compilation-scope-graph.js';
 export * from './compilation-session-pool.js';
 export * from './composition.js';
 export * from './emission-plan.js';
+export * from './framework-compiler-session.js';
 export * from './invalidation.js';
 export * from './mode.js';
 export * from './owner-lifecycle.js';