weapp-tailwindcss 5.5.3 → 5.5.4

package/dist/compiler/cache-telemetry.d.ts

@@ -0,0 +1,30 @@
+export type CacheInvalidationReason = 'source-change' | 'config-change' | 'runtime-change' | 'platform-change' | 'manual-clear' | 'capacity-eviction';
+export interface CacheTelemetry {
+    layer: 'source-scan' | 'candidate-index' | 'tailwind-generation' | 'postcss-result' | 'asset-emission';
+    keyFingerprint: string;
+    hit: boolean;
+    invalidationReason?: CacheInvalidationReason;
+    evicted?: boolean;
+    entries?: number;
+    memoryBytes?: number;
+    revision?: number;
+    operationId?: string;
+}
+export interface CacheTelemetryCollector {
+    record: (entry: CacheTelemetry) => void;
+    snapshot: () => readonly CacheTelemetry[];
+    clear: () => void;
+    hitRate: (layer?: CacheTelemetry['layer']) => number;
+    summary: (layer?: CacheTelemetry['layer']) => readonly CacheTelemetrySummary[];
+}
+export interface CacheTelemetrySummary {
+    layer: CacheTelemetry['layer'];
+    samples: number;
+    hits: number;
+    misses: number;
+    invalidations: number;
+    evictions: number;
+    entries: number;
+    memoryBytes: number;
+}
+export declare function createCacheTelemetryCollector(): CacheTelemetryCollector;

package/dist/compiler/candidate-index.d.ts

@@ -1,6 +1,9 @@
+import type { CacheTelemetryCollector } from './cache-telemetry.js';
 import type { CandidateChange } from './types.js';
 export declare class CandidateIndex {
+    private readonly telemetry?;
     private readonly candidatesBySource;
+    constructor(telemetry?: CacheTelemetryCollector | undefined);
     sync(sourceId: string, candidates: Iterable<string>): CandidateChange;
     remove(sourceId: string): CandidateChange;
     values(): Set<string>;

package/dist/compiler/capabilities.d.ts

@@ -0,0 +1,37 @@
+import type { CompilationDiagnosticEvent, CompilationEventListener } from './events.js';
+export type AdapterCapability = 'compilerHost' | 'sourceCandidates' | 'cssGeneration' | 'assetEmission' | 'watchUpdate' | 'diagnostics';
+export interface AdapterCapabilities {
+    adapter: string;
+    version: string;
+    capabilities: readonly AdapterCapability[];
+}
+export declare function createAdapterCapabilities(adapter: string, overrides?: Partial<AdapterCapabilities>): AdapterCapabilities;
+export declare const BUILTIN_ADAPTER_CAPABILITIES: {
+    readonly vite: AdapterCapabilities;
+    readonly webpack: AdapterCapabilities;
+    readonly rspack: AdapterCapabilities;
+    readonly gulp: AdapterCapabilities;
+};
+export interface CompilerHost {
+    readonly id: string;
+    readonly capabilities: AdapterCapabilities;
+    revision: number;
+    dispose: () => void;
+}
+export interface SourceCandidateProvider {
+    scan: (sourceId: string, source: string) => Promise<ReadonlySet<string>> | ReadonlySet<string>;
+}
+export interface CssGenerator {
+    generate: (candidates: ReadonlySet<string>) => Promise<string> | string;
+}
+export interface AssetEmitter {
+    emit: (assetId: string, content: string) => Promise<void> | void;
+}
+export interface WatchUpdateHandler {
+    update: (sourceId: string, source: string) => Promise<void> | void;
+}
+export interface DiagnosticReporter {
+    report: CompilationEventListener;
+}
+export declare function missingCapabilities(actual: AdapterCapabilities, required: readonly AdapterCapability[]): AdapterCapability[];
+export declare function createCapabilityDiagnostic(capabilities: AdapterCapabilities, required: readonly AdapterCapability[]): CompilationDiagnosticEvent | undefined;

package/dist/compiler/events.d.ts

@@ -1,4 +1,30 @@
-export type CompilationEvent = {
+export declare const COMPILATION_EVENT_SCHEMA_VERSION = 1;
+export interface CompilationDiagnosticEvent {
+    schemaVersion: typeof COMPILATION_EVENT_SCHEMA_VERSION;
+    type: 'diagnostic';
+    timestamp: string;
+    projectId?: string;
+    compilerId?: string;
+    adapter?: string;
+    phase: 'scan' | 'candidate' | 'generate' | 'postcss' | 'emit' | 'hmr';
+    revision?: number;
+    operationId?: string;
+    durationMs?: number;
+    cache?: {
+        hit: boolean;
+        key?: string;
+        reason?: string;
+    };
+    moduleId?: string;
+    sourceId?: string;
+    error?: {
+        name?: string;
+        message: string;
+        stack?: string;
+    };
+    evidence?: string[];
+}
+export type CompilationEvent = CompilationDiagnosticEvent | {
     type: 'source-updated';
     id: string;
     source: string;
@@ -29,4 +55,15 @@ export interface CompilationEventBus {
     subscribe: (listener: CompilationEventListener) => () => void;
     clear: () => void;
 }
+export interface CompilationEventReporter {
+    readonly events: readonly CompilationEvent[];
+    collect: CompilationEventListener;
+    toJSONL: () => string;
+    summarize: () => string;
+    clear: () => void;
+}
+export declare function createCompilationEventReporter(): CompilationEventReporter;
+export declare function redactCompilationPath(value: string, root?: string): string;
+export declare function serializeCompilationEvent(event: CompilationEvent): string;
+export declare function summarizeCompilationEvents(events: readonly CompilationEvent[]): string;
 export declare function createCompilationEventBus(): CompilationEventBus;

package/dist/compiler/index.d.ts

@@ -1,5 +1,7 @@
 export * from './artifact.js';
+export * from './cache-telemetry.js';
 export * from './candidate-index.js';
+export * from './capabilities.js';
 export * from './compilation-change-coordinator.js';
 export * from './compilation-scope-graph.js';
 export * from './compilation-session-pool.js';

package/dist/compiler/runtime-state.d.ts

@@ -1,4 +1,4 @@
-import type { CompilationEventBus } from './events.js';
+import type { CompilationEventBus, CompilationEventListener } from './events.js';
 import type { RefreshTailwindcssRuntimeOptions, TailwindcssRuntimeLike } from '../types/index.js';
 export interface CompilerRuntimeState {
     tailwindRuntime: TailwindcssRuntimeLike;
@@ -13,5 +13,6 @@ export interface CreateCompilerRuntimeStateOptions {
     readyPromise?: Promise<void>;
     refreshTailwindcssRuntime: (options?: RefreshTailwindcssRuntimeOptions) => Promise<TailwindcssRuntimeLike>;
     events?: CompilationEventBus;
+    reporter?: CompilationEventListener;
 }
 export declare function createCompilerRuntimeState(options: CreateCompilerRuntimeStateOptions): CompilerRuntimeState;

package/dist/{compiler-C9X5Afn4.js → compiler-CJ5yX-on.js}

@@ -1,6 +1,6 @@
 import { resolveMpxPlatform } from "./framework.js";
-import { A as resolveBooleanObjectOption, Bt as shouldUseUniAppWebRpxCompatibility, Ht as resolveValidTailwindV4Candidates$1, Lt as resolveCssMacroTailwindV4Source, Mt as _defineProperty, T as omitUndefined, Tt as isFileMatchedByTailwindSourceEntries, Vt as loadTailwindV4DesignSystem, a as resolveGeneratorRuntimeBranch, bt as createTailwindV4Engine$1, d as resolveTailwindV4SourceFromRuntime, i as normalizeWeappTailwindcssGeneratorOptions, t as createWeappTailwindcssGenerator, u as resolveTailwindV4Source$1 } from "./generator-C2aWns8n.js";
-import { c as getRuntimeClassSetCacheEntry, d as invalidateRuntimeClassSet, i as resolveUniAppXOptions, o as applyV4CssCalcDefaults, s as warnMissingCssEntries, t as createTailwindcssRuntimeFromContext, u as getRuntimeClassSetSignatureWithSources } from "./tailwindcss-c4PkOe1F.js";
+import { A as resolveBooleanObjectOption, Bt as shouldUseUniAppWebRpxCompatibility, Ht as resolveValidTailwindV4Candidates$1, Lt as resolveCssMacroTailwindV4Source, Mt as _defineProperty, T as omitUndefined, Tt as isFileMatchedByTailwindSourceEntries, Vt as loadTailwindV4DesignSystem, a as resolveGeneratorRuntimeBranch, bt as createTailwindV4Engine$1, d as resolveTailwindV4SourceFromRuntime, i as normalizeWeappTailwindcssGeneratorOptions, t as createWeappTailwindcssGenerator, u as resolveTailwindV4Source$1 } from "./generator-BgbYHNgD.js";
+import { c as getRuntimeClassSetCacheEntry, d as invalidateRuntimeClassSet, i as resolveUniAppXOptions, o as applyV4CssCalcDefaults, s as warnMissingCssEntries, t as createTailwindcssRuntimeFromContext, u as getRuntimeClassSetSignatureWithSources } from "./tailwindcss-o3Xe-o7M.js";
 import { i as isMap, n as defuOverrideArray$1 } from "./utils-MVwpU07P.js";
 import { a as DEFAULT_PARSE_CACHE_MAX_SOURCE_LENGTH, i as resolveDefaultCssPreflight, o as HARD_PARSE_CACHE_MAX_ENTRIES, r as getDefaultOptions } from "./defaults-CKx-4LcW.js";
 import { createRequire } from "node:module";
@@ -1527,9 +1527,28 @@ function createGenerationArtifact(fragments, options) {
 	});
 }
 //#endregion
+//#region src/core/compiler/source-fingerprint.ts
+function stableSerialize(value, stack = /* @__PURE__ */ new WeakSet()) {
+	if (value == null || typeof value === "number" || typeof value === "boolean" || typeof value === "string") return JSON.stringify(value);
+	if (typeof value === "function") return `[Function:${value.name}]`;
+	if (typeof value !== "object") return String(value);
+	if (stack.has(value)) return "[Circular]";
+	stack.add(value);
+	const serialized = Array.isArray(value) ? `[${value.map((item) => stableSerialize(item, stack)).join(",")}]` : `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableSerialize(value[key], stack)}`).join(",")}}`;
+	stack.delete(value);
+	return serialized;
+}
+function createSourceFingerprint(source) {
+	return createCompilerValueFingerprint(source);
+}
+function createCompilerValueFingerprint(value) {
+	return md5Hash(stableSerialize(value));
+}
+//#endregion
 //#region src/compiler/candidate-index.ts
 var CandidateIndex = class {
-	constructor() {
+	constructor(telemetry) {
+		this.telemetry = telemetry;
 		_defineProperty(this, "candidatesBySource", /* @__PURE__ */ new Map());
 	}
 	sync(sourceId, candidates) {
@@ -1538,6 +1557,14 @@ var CandidateIndex = class {
 		const addedCandidates = new Set([...next].filter((candidate) => !previous.has(candidate)));
 		const removedCandidates = new Set([...previous].filter((candidate) => !next.has(candidate)));
 		this.candidatesBySource.set(sourceId, next);
+		this.telemetry?.record({
+			layer: "candidate-index",
+			keyFingerprint: createCompilerValueFingerprint(sourceId),
+			hit: addedCandidates.size === 0 && removedCandidates.size === 0,
+			invalidationReason: addedCandidates.size || removedCandidates.size ? "source-change" : void 0,
+			entries: this.candidatesBySource.size,
+			memoryBytes: [...this.candidatesBySource.values()].reduce((total, values) => total + values.size * 32, 0)
+		});
 		return {
 			sourceId,
 			addedCandidates,
@@ -1547,6 +1574,14 @@ var CandidateIndex = class {
 	remove(sourceId) {
 		const previous = this.candidatesBySource.get(sourceId) ?? /* @__PURE__ */ new Set();
 		this.candidatesBySource.delete(sourceId);
+		this.telemetry?.record({
+			layer: "candidate-index",
+			keyFingerprint: createCompilerValueFingerprint(sourceId),
+			hit: false,
+			invalidationReason: "source-change",
+			evicted: true,
+			entries: this.candidatesBySource.size
+		});
 		return {
 			sourceId,
 			addedCandidates: /* @__PURE__ */ new Set(),
@@ -1569,6 +1604,25 @@ var CandidateIndex = class {
 	}
 };
 //#endregion
+//#region src/compiler/capabilities.ts
+/** 为适配器声明能力，便于统一契约检查并保持旧适配器兼容。 */
+function createAdapterCapabilities(adapter, overrides = {}) {
+	return {
+		adapter,
+		version: "1.0",
+		capabilities: [
+			"compilerHost",
+			"sourceCandidates",
+			"cssGeneration",
+			"assetEmission",
+			"watchUpdate",
+			"diagnostics"
+		],
+		...overrides
+	};
+}
+createAdapterCapabilities("vite"), createAdapterCapabilities("webpack"), createAdapterCapabilities("rspack"), createAdapterCapabilities("gulp");
+//#endregion
 //#region src/compiler/compilation-scope-graph.ts
 function sourceNodeId(sourceId) {
 	return `source:${sourceId}`;
@@ -2307,24 +2361,6 @@ function createCompilationEventBus() {
 	};
 }
 //#endregion
-//#region src/core/compiler/source-fingerprint.ts
-function stableSerialize(value, stack = /* @__PURE__ */ new WeakSet()) {
-	if (value == null || typeof value === "number" || typeof value === "boolean" || typeof value === "string") return JSON.stringify(value);
-	if (typeof value === "function") return `[Function:${value.name}]`;
-	if (typeof value !== "object") return String(value);
-	if (stack.has(value)) return "[Circular]";
-	stack.add(value);
-	const serialized = Array.isArray(value) ? `[${value.map((item) => stableSerialize(item, stack)).join(",")}]` : `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableSerialize(value[key], stack)}`).join(",")}}`;
-	stack.delete(value);
-	return serialized;
-}
-function createSourceFingerprint(source) {
-	return createCompilerValueFingerprint(source);
-}
-function createCompilerValueFingerprint(value) {
-	return md5Hash(stableSerialize(value));
-}
-//#endregion
 //#region src/core/compiler/generation-cache.ts
 function createCompilerGenerationCacheKey(request, candidates, target) {
 	return {
@@ -4352,7 +4388,9 @@ function createCompilerTransforms({ ensureActive, track, userOptions }) {
 const DEFAULT_MAX_ROOTS = 128;
 function createCompiler(options = {}) {
 	const { compiler: compilerOptions, ...userOptions } = options;
-	const rootStore = new CompilerRootStore(Math.max(1, Math.floor(compilerOptions?.maxRoots ?? DEFAULT_MAX_ROOTS)), compilerOptions?.onRootEvicted);
+	const maxRoots = Math.max(1, Math.floor(compilerOptions?.maxRoots ?? DEFAULT_MAX_ROOTS));
+	const cacheTelemetry = compilerOptions?.cacheTelemetry;
+	const rootStore = new CompilerRootStore(maxRoots, compilerOptions?.onRootEvicted);
 	const activeTasks = /* @__PURE__ */ new Set();
 	let lifecycle = "active";
 	let disposePromise;
@@ -4391,6 +4429,15 @@ function createCompiler(options = {}) {
 		const prepared = prepareCompilerGeneration(entry, request, source, !sourceReused || entry.appliedInvalidation !== invalidation);
 		const generationCacheKey = createCompilerGenerationCacheKey(request, prepared.compilation.candidates, target);
 		const reusableGeneration = engineReused && entry.generationCache && isSameCompilerGenerationCacheKey(entry.generationCache.key, generationCacheKey) ? entry.generationCache.result : void 0;
+		cacheTelemetry?.record({
+			layer: "tailwind-generation",
+			keyFingerprint: generationCacheKey.candidateSignature,
+			hit: reusableGeneration !== void 0,
+			invalidationReason: reusableGeneration === void 0 && !engineReused ? "source-change" : void 0,
+			entries: entry.generationCache ? 1 : 0,
+			revision: getLatestRevision(entry),
+			operationId: entry.id
+		});
 		try {
 			const generated = reusableGeneration ? reuseCompilerGenerationResult(reusableGeneration) : await generator.generate({
 				...generateOptions,
@@ -4860,6 +4907,7 @@ function createRuntimeAffectingSourceSignature(source, type) {
 /** 创建构建器无关的 runtime state，并保留旧字段供现有插件继续使用。 */
 function createCompilerRuntimeState(options) {
 	const events = options.events ?? createCompilationEventBus();
+	if (options.reporter) events.subscribe(options.reporter);
 	return {
 		tailwindRuntime: options.tailwindRuntime,
 		readyPromise: options.readyPromise ?? Promise.resolve(),

package/dist/{compiler-DMPaUcH6.cjs → compiler-DFROuh5Z.cjs}

@@ -1,7 +1,7 @@
 const require_rolldown_runtime = require("./rolldown-runtime-Ctb5zv51.cjs");
 const require_framework = require("./framework.cjs");
-const require_generator = require("./generator-BoZIiZD5.cjs");
-const require_tailwindcss = require("./tailwindcss-Bji4u8In.cjs");
+const require_generator = require("./generator-RK2HtgOb.cjs");
+const require_tailwindcss = require("./tailwindcss-B03BGeTO.cjs");
 require("./utils-CuKLf1Zv.cjs");
 const require_defaults = require("./defaults-CiGsr8Xq.cjs");
 let node_path = require("node:path");
@@ -38303,9 +38303,28 @@ function createGenerationArtifact(fragments, options) {
 	});
 }
 //#endregion
+//#region src/core/compiler/source-fingerprint.ts
+function stableSerialize(value, stack = /* @__PURE__ */ new WeakSet()) {
+	if (value == null || typeof value === "number" || typeof value === "boolean" || typeof value === "string") return JSON.stringify(value);
+	if (typeof value === "function") return `[Function:${value.name}]`;
+	if (typeof value !== "object") return String(value);
+	if (stack.has(value)) return "[Circular]";
+	stack.add(value);
+	const serialized = Array.isArray(value) ? `[${value.map((item) => stableSerialize(item, stack)).join(",")}]` : `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableSerialize(value[key], stack)}`).join(",")}}`;
+	stack.delete(value);
+	return serialized;
+}
+function createSourceFingerprint(source) {
+	return createCompilerValueFingerprint(source);
+}
+function createCompilerValueFingerprint(value) {
+	return (0, _weapp_tailwindcss_shared_node.md5)(stableSerialize(value));
+}
+//#endregion
 //#region src/compiler/candidate-index.ts
 var CandidateIndex = class {
-	constructor() {
+	constructor(telemetry) {
+		this.telemetry = telemetry;
 		require_generator._defineProperty(this, "candidatesBySource", /* @__PURE__ */ new Map());
 	}
 	sync(sourceId, candidates) {
@@ -38314,6 +38333,14 @@ var CandidateIndex = class {
 		const addedCandidates = new Set([...next].filter((candidate) => !previous.has(candidate)));
 		const removedCandidates = new Set([...previous].filter((candidate) => !next.has(candidate)));
 		this.candidatesBySource.set(sourceId, next);
+		this.telemetry?.record({
+			layer: "candidate-index",
+			keyFingerprint: createCompilerValueFingerprint(sourceId),
+			hit: addedCandidates.size === 0 && removedCandidates.size === 0,
+			invalidationReason: addedCandidates.size || removedCandidates.size ? "source-change" : void 0,
+			entries: this.candidatesBySource.size,
+			memoryBytes: [...this.candidatesBySource.values()].reduce((total, values) => total + values.size * 32, 0)
+		});
 		return {
 			sourceId,
 			addedCandidates,
@@ -38323,6 +38350,14 @@ var CandidateIndex = class {
 	remove(sourceId) {
 		const previous = this.candidatesBySource.get(sourceId) ?? /* @__PURE__ */ new Set();
 		this.candidatesBySource.delete(sourceId);
+		this.telemetry?.record({
+			layer: "candidate-index",
+			keyFingerprint: createCompilerValueFingerprint(sourceId),
+			hit: false,
+			invalidationReason: "source-change",
+			evicted: true,
+			entries: this.candidatesBySource.size
+		});
 		return {
 			sourceId,
 			addedCandidates: /* @__PURE__ */ new Set(),
@@ -38345,6 +38380,25 @@ var CandidateIndex = class {
 	}
 };
 //#endregion
+//#region src/compiler/capabilities.ts
+/** 为适配器声明能力，便于统一契约检查并保持旧适配器兼容。 */
+function createAdapterCapabilities(adapter, overrides = {}) {
+	return {
+		adapter,
+		version: "1.0",
+		capabilities: [
+			"compilerHost",
+			"sourceCandidates",
+			"cssGeneration",
+			"assetEmission",
+			"watchUpdate",
+			"diagnostics"
+		],
+		...overrides
+	};
+}
+createAdapterCapabilities("vite"), createAdapterCapabilities("webpack"), createAdapterCapabilities("rspack"), createAdapterCapabilities("gulp");
+//#endregion
 //#region src/compiler/compilation-scope-graph.ts
 function sourceNodeId(sourceId) {
 	return `source:${sourceId}`;
@@ -39059,24 +39113,6 @@ var AssetEmissionPlan = class {
 	}
 };
 //#endregion
-//#region src/core/compiler/source-fingerprint.ts
-function stableSerialize(value, stack = /* @__PURE__ */ new WeakSet()) {
-	if (value == null || typeof value === "number" || typeof value === "boolean" || typeof value === "string") return JSON.stringify(value);
-	if (typeof value === "function") return `[Function:${value.name}]`;
-	if (typeof value !== "object") return String(value);
-	if (stack.has(value)) return "[Circular]";
-	stack.add(value);
-	const serialized = Array.isArray(value) ? `[${value.map((item) => stableSerialize(item, stack)).join(",")}]` : `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableSerialize(value[key], stack)}`).join(",")}}`;
-	stack.delete(value);
-	return serialized;
-}
-function createSourceFingerprint(source) {
-	return createCompilerValueFingerprint(source);
-}
-function createCompilerValueFingerprint(value) {
-	return (0, _weapp_tailwindcss_shared_node.md5)(stableSerialize(value));
-}
-//#endregion
 //#region src/core/compiler/generation-cache.ts
 function createCompilerGenerationCacheKey(request, candidates, target) {
 	return {
@@ -41271,7 +41307,9 @@ function createCompilerTransforms({ ensureActive, track, userOptions }) {
 const DEFAULT_MAX_ROOTS = 128;
 function createCompiler(options = {}) {
 	const { compiler: compilerOptions, ...userOptions } = options;
-	const rootStore = new CompilerRootStore(Math.max(1, Math.floor(compilerOptions?.maxRoots ?? DEFAULT_MAX_ROOTS)), compilerOptions?.onRootEvicted);
+	const maxRoots = Math.max(1, Math.floor(compilerOptions?.maxRoots ?? DEFAULT_MAX_ROOTS));
+	const cacheTelemetry = compilerOptions?.cacheTelemetry;
+	const rootStore = new CompilerRootStore(maxRoots, compilerOptions?.onRootEvicted);
 	const activeTasks = /* @__PURE__ */ new Set();
 	let lifecycle = "active";
 	let disposePromise;
@@ -41310,6 +41348,15 @@ function createCompiler(options = {}) {
 		const prepared = prepareCompilerGeneration(entry, request, source, !sourceReused || entry.appliedInvalidation !== invalidation);
 		const generationCacheKey = createCompilerGenerationCacheKey(request, prepared.compilation.candidates, target);
 		const reusableGeneration = engineReused && entry.generationCache && isSameCompilerGenerationCacheKey(entry.generationCache.key, generationCacheKey) ? entry.generationCache.result : void 0;
+		cacheTelemetry?.record({
+			layer: "tailwind-generation",
+			keyFingerprint: generationCacheKey.candidateSignature,
+			hit: reusableGeneration !== void 0,
+			invalidationReason: reusableGeneration === void 0 && !engineReused ? "source-change" : void 0,
+			entries: entry.generationCache ? 1 : 0,
+			revision: getLatestRevision(entry),
+			operationId: entry.id
+		});
 		try {
 			const generated = reusableGeneration ? reuseCompilerGenerationResult(reusableGeneration) : await generator.generate({
 				...generateOptions,

package/dist/core/compiler/types.d.ts

@@ -1,4 +1,5 @@
 import type { Document, FinalizeMiniProgramCssOptions, IStyleHandlerOptions, Result as PostcssResult, Root } from '@weapp-tailwindcss/postcss';
+import type { CacheTelemetryCollector } from '../../compiler/cache-telemetry.js';
 import type { TailwindV4ResolvedSource, TailwindV4SourceOptions, WeappTailwindcssGenerateOptions, WeappTailwindcssGenerateResult } from '../../generator/index.js';
 import type { CreateJsHandlerOptions, ITemplateHandlerOptions, JsHandlerResult, UserDefinedOptions } from '../../types/index.js';
 export type CompilerTarget = 'tailwind' | 'weapp' | 'web';
@@ -56,6 +57,7 @@ export type CreateCompilerOptions = UserDefinedOptions & {
     compiler?: {
         maxRoots?: number | undefined;
         onRootEvicted?: ((id: string) => void) | undefined;
+        cacheTelemetry?: CacheTelemetryCollector | undefined;
     } | undefined;
 };
 export interface Compiler {

package/dist/core.cjs

@@ -1,8 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_compiler = require("./compiler-DMPaUcH6.cjs");
-const require_runtime_state = require("./runtime-state-BBQcA0n5.cjs");
+const require_compiler = require("./compiler-DFROuh5Z.cjs");
+const require_runtime_state = require("./runtime-state-XYSycuGu.cjs");
 let _weapp_tailwindcss_postcss = require("@weapp-tailwindcss/postcss");
 let _weapp_tailwindcss_shared = require("@weapp-tailwindcss/shared");
+let node_perf_hooks = require("node:perf_hooks");
 //#region src/core.ts
 const DEFAULT_MAIN_CHUNK_STYLE_OPTIONS = Object.freeze({ isMainChunk: true });
 function resolveTransformWxssOptions(options) {
@@ -28,6 +29,26 @@ function createContext(options = {}) {
 		refreshTailwindcssRuntime
 	});
 	const defaultJsHandlerOptionsCache = /* @__PURE__ */ new Map();
+	const diagnosticEvents = [];
+	runtimeState.events.subscribe((event) => {
+		if (event.type === "diagnostic") diagnosticEvents.push(event);
+	});
+	async function emitDiagnostic(phase, startedAt, operationId, error) {
+		await runtimeState.events.emit({
+			schemaVersion: 1,
+			type: "diagnostic",
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			compilerId: "weapp-tailwindcss",
+			phase,
+			revision: runtimeState.revision,
+			operationId,
+			durationMs: node_perf_hooks.performance.now() - startedAt,
+			error: error ? {
+				name: error instanceof Error ? error.name : void 0,
+				message: error instanceof Error ? error.message : String(error)
+			} : void 0
+		});
+	}
 	function getDefaultJsHandlerOptions(majorVersion = runtimeState.tailwindRuntime.majorVersion) {
 		if (typeof majorVersion !== "number") return;
 		let cached = defaultJsHandlerOptionsCache.get(majorVersion);
@@ -110,9 +131,17 @@ function createContext(options = {}) {
 	}
 	async function transformWxss(rawCss, options) {
 		await runtimeState.readyPromise;
-		const result = await styleHandler(rawCss, resolveTransformWxssOptions(options));
-		runtimeSet = await require_compiler.ensureRuntimeClassSet(runtimeState);
-		return result;
+		const startedAt = node_perf_hooks.performance.now();
+		const operationId = `css-${Date.now()}-${runtimeState.revision}`;
+		try {
+			const result = await styleHandler(rawCss, resolveTransformWxssOptions(options));
+			runtimeSet = await require_compiler.ensureRuntimeClassSet(runtimeState);
+			await emitDiagnostic("postcss", startedAt, operationId);
+			return result;
+		} catch (error) {
+			await emitDiagnostic("postcss", startedAt, operationId, error);
+			throw error;
+		}
 	}
 	async function getRuntimeSet(options) {
 		await runtimeState.readyPromise;
@@ -125,18 +154,38 @@ function createContext(options = {}) {
 		else if (runtimeSet.size === 0) runtimeSet = await require_compiler.ensureRuntimeClassSet(runtimeState, { forceCollect: true });
 		const resolvedOptions = resolveTransformJsOptions(options);
 		if (require_compiler.shouldSkipJsTransform(rawJs, resolvedOptions)) return { code: rawJs };
-		return await jsHandler(rawJs, runtimeSet, resolvedOptions);
+		const startedAt = node_perf_hooks.performance.now();
+		const operationId = `js-${Date.now()}-${runtimeState.revision}`;
+		try {
+			const result = await jsHandler(rawJs, runtimeSet, resolvedOptions);
+			await emitDiagnostic("candidate", startedAt, operationId);
+			return result;
+		} catch (error) {
+			await emitDiagnostic("candidate", startedAt, operationId, error);
+			throw error;
+		}
 	}
 	async function transformWxml(rawWxml, options) {
 		await runtimeState.readyPromise;
 		if (!options?.runtimeSet && runtimeSet.size === 0) runtimeSet = await require_compiler.ensureRuntimeClassSet(runtimeState, { forceCollect: true });
-		return templateHandler(rawWxml, resolveTransformWxmlOptions(options));
+		const startedAt = node_perf_hooks.performance.now();
+		const operationId = `template-${Date.now()}-${runtimeState.revision}`;
+		try {
+			const result = templateHandler(rawWxml, resolveTransformWxmlOptions(options));
+			await emitDiagnostic("scan", startedAt, operationId);
+			return result;
+		} catch (error) {
+			await emitDiagnostic("scan", startedAt, operationId, error);
+			throw error;
+		}
 	}
 	return {
 		getRuntimeSet,
 		transformWxss,
 		transformWxml,
-		transformJs
+		transformJs,
+		events: runtimeState.events,
+		getDiagnosticEvents: () => diagnosticEvents.slice()
 	};
 }
 //#endregion

package/dist/core.d.ts

@@ -1,3 +1,4 @@
+import type { CompilationDiagnosticEvent } from './compiler/events.js';
 import type { CreateJsHandlerOptions, IStyleHandlerOptions, ITemplateHandlerOptions, UserDefinedOptions } from './types/index.js';
 export { createCompilationEventBus, createCompilerRuntimeState } from './compiler/index.js';
 export type { CompilationEvent, CompilerHost, CompilerRuntimeState } from './compiler/index.js';
@@ -19,4 +20,6 @@ export declare function createContext(options?: UserDefinedOptions): {
     transformWxss: (rawCss: string, options?: Partial<IStyleHandlerOptions>) => Promise<import("postcss").Result<import("postcss").Document | import("postcss").Root>>;
     transformWxml: (rawWxml: string, options?: ITemplateHandlerOptions) => Promise<string>;
     transformJs: (rawJs: string, options?: RuntimeJsTransformOptions) => Promise<import("./types/index.js").JsHandlerResult>;
+    events: import("./compiler/index.js").CompilationEventBus;
+    getDiagnosticEvents: () => CompilationDiagnosticEvent[];
 };