weapp-tailwindcss 5.5.3 → 5.5.5

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;