tailwind-styled-v4 5.0.36 → 5.0.38

package/dist/shared.d.mts

@@ -1,6 +1,99 @@
-export { C as CompoundCondition, E as ErrorSource, H as HtmlTagName, L as LRUCache, c as LoadNativeBindingOptions, d as LoadNativeBindingResult, e as Logger, R as ResolveCandidatesOptions, T as TokenMap, f as TwError, V as VariantMatrix, b as VariantProps, a as VariantValue, g as createDebugLogger, h as createLogger, i as formatErrorMessage, j as hashContent, k as isTwError, l as loadNativeBinding, r as resolveNativeBindingCandidates, m as resolveRuntimeDir, w as wrapUnknownError } from './index-NDINUhLN.mjs';
 import { z } from 'zod';
-export { T as TraceSnapshot, a as TraceSummary, i as calculateHealth, j as createTraceSnapshot, f as formatDuration, b as formatMemory, g as getBuildTimeColor, c as getHealthColor, d as getMemoryColor, e as getModeColor, h as getPipelinePercentages } from './trace-Dz4vmZdy.mjs';
+
+/**
+ * Shared trace utilities for CLI, devtools, and dashboard
+ *
+ * Provides reusable trace snapshot handling, formatting, and analysis
+ * across the tailwind-styled-v4 ecosystem without introducing coupling.
+ */
+interface TraceSnapshot {
+    generatedAt: string;
+    buildMs: number | null;
+    scanMs: number | null;
+    analyzeMs: number | null;
+    compileMs: number | null;
+    memoryMb: {
+        rss: number;
+        heapUsed: number;
+        heapTotal: number;
+    } | null;
+    classCount: number | null;
+    fileCount: number | null;
+    cssBytes: number | null;
+    mode: string | null;
+    eventsReceived?: number;
+    eventsProcessed?: number;
+    batchesProcessed?: number;
+    incrementalUpdates?: number;
+    fullRescans?: number;
+}
+interface TraceSummary {
+    workspace: {
+        totalPackages: number;
+        totalFiles: number;
+        totalClasses: number;
+        lastScanDurationMs: number;
+        lastBuildDurationMs: number;
+    };
+    cache: {
+        hitRate: number;
+        totalEntries: number;
+        memoryUsageMb: number;
+    };
+    pipeline: {
+        scanDurationMs: number;
+        analyzeDurationMs: number;
+        compileDurationMs: number;
+        totalDurationMs: number;
+    };
+    health: {
+        status: "healthy" | "degraded" | "unhealthy";
+        issues: Array<{
+            severity: string;
+            message: string;
+        }>;
+    };
+}
+/**
+ * Get health status color for UI rendering
+ */
+declare function getHealthColor(status?: string): string;
+/**
+ * Get mode color for UI rendering
+ */
+declare function getModeColor(mode?: string | null): string;
+/**
+ * Format memory in human-readable format
+ */
+declare function formatMemory(bytes: number): string;
+/**
+ * Format duration in human-readable format
+ */
+declare function formatDuration(ms: number | null): string;
+/**
+ * Calculate health status from metrics
+ */
+declare function calculateHealth(metrics: TraceSnapshot, summary?: TraceSummary): "healthy" | "degraded" | "unhealthy";
+/**
+ * Get color for build time indicator
+ */
+declare function getBuildTimeColor(ms: number | null): string;
+/**
+ * Get color for memory usage indicator
+ */
+declare function getMemoryColor(mb: number): string;
+/**
+ * Create trace snapshot from dashboard data
+ */
+declare function createTraceSnapshot(data: Record<string, unknown>): TraceSnapshot;
+/**
+ * Calculate pipeline time distribution
+ */
+declare function getPipelinePercentages(metrics: TraceSnapshot): {
+    scanPct: number;
+    analyzePct: number;
+    compilePct: number;
+};
 
 /**
  * Error code registry — single source of truth for all error codes.
@@ -748,4 +841,93 @@ declare function appendStaticStateCssToSafelist(srcDir: string, safelistPath: st
 
 declare function setGlobalLogFile(filePath: string): void;
 
-export { type BuildPhaseTrace, type BuildPhases, type BuildTelemetry, type BuildTrace, type ClassInspection, type ClassProperty, type ClassUsageLocation, type ComponentCodegenOptions, type DashboardMetrics, type DashboardSummary, ERROR_CODES, type ErrorCode, type GeneratedStateRule, NativeAnalyzerReportSchema, NativeCacheEntrySchema, NativeCacheReadResultSchema, NativeCssCompileResultSchema, type NativeResolutionResult, NativeScanFileSchema, NativeScanResultSchema, NativeTransformResultSchema, NativeWatchResultSchema, type ObservabilityClient, type PackageJson, PackageJsonSchema, type RegistryFile, RegistryFileSchema, type RegistryPluginEntry, RegistryPluginEntrySchema, type ScanCache, type ScanCacheClassEntry, ScanCacheClassEntrySchema, ScanCacheSchema, type StaticStateCssInput, type StaticStateExtractionResult, TW_STATE_STATIC_FILENAME, type TailwindConfig, TailwindConfigSchema, type TailwindInfo, TelemetryCollector, type TelemetrySummary, type TwStateConfigEntry, type WorkerPathOptions, type WorkerPathResult, appendStaticStateCssToSafelist, assertTailwindV4, createBuildTimer, createEsmRequire, createObservabilityClient, detectTailwind, extractStaticStateCss, formatErrorCode, formatNativeNotFoundError, generateBarrelFile, generateClassRenameCodemod, generateComponentCode, generateStorybookStory, getDirname, getFilename, getGlobalTelemetry, getSuggestion, getTailwindVersion, isTailwindV4, parseJsonFileWithSchema, parseJsonWithSchema, parseNative, resetGlobalTelemetry, resolveFromRoot, resolveLoaderPath, resolveNativeBinary, resolveNativeNodePath, resolveWorkerPath, safeParseNative, setGlobalLogFile, tryRequire };
+type TokenMap = Record<string, string>;
+type VariantValue = string | number | boolean | undefined;
+type VariantProps = Record<string, VariantValue>;
+type HtmlTagName = keyof HTMLElementTagNameMap;
+type CompoundCondition = Record<string, string | number | boolean>;
+type VariantMatrix = Record<string, Array<string | number | boolean>>;
+interface Logger {
+    warn(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    log(...args: unknown[]): void;
+}
+declare function createLogger(namespace: string): Logger;
+declare function createDebugLogger(namespace: string, label?: string): (msg: string) => void;
+type ErrorSource = "rust" | "validation" | "compile" | "io" | "config" | "unknown";
+type ZodLikeIssue = {
+    path?: readonly PropertyKey[];
+    message?: string;
+};
+declare class TwError extends Error {
+    /** @deprecated Gunakan source */
+    readonly domain: string;
+    readonly source: ErrorSource;
+    readonly code: string;
+    readonly originalCause?: unknown;
+    constructor(domainOrSource: string, code: string, message: string, cause?: unknown);
+    static fromIo(code: string, message: string): TwError;
+    static fromCompile(code: string, message: string): TwError;
+    static fromRust(err: {
+        code?: string;
+        message?: string;
+    } | Error | unknown): TwError;
+    /** Buat TwError dari ZodError — dukung shape Zod v3 (`errors`) dan v4 (`issues`). */
+    static fromZod(err: {
+        issues?: ZodLikeIssue[];
+        errors?: ZodLikeIssue[];
+    }): TwError;
+    static wrap(source: string, code: string, err: unknown): TwError;
+    toString(): string;
+    toJSON(): {
+        name: string;
+        source: string;
+        code: string;
+        message: string;
+    };
+    toCliMessage(): string;
+}
+declare function wrapUnknownError(domain: string, code: string, error: unknown): TwError;
+declare function isTwError(err: unknown): err is TwError;
+interface LoadNativeBindingOptions<T> {
+    runtimeDir: string;
+    candidates: string[];
+    isValid: (module: unknown) => module is T;
+    invalidExportMessage: string;
+}
+interface LoadNativeBindingResult<T> {
+    binding: T | null;
+    loadErrors: Array<{
+        path: string;
+        message: string;
+    }>;
+    loadedPath?: string;
+}
+declare function loadNativeBinding<T>(options: LoadNativeBindingOptions<T>): LoadNativeBindingResult<T>;
+interface ResolveCandidatesOptions {
+    runtimeDir?: string;
+    envVarNames?: string[];
+    includeDefaultCandidates?: boolean;
+    enforceNodeExtensionForEnvPath?: boolean;
+    /** @deprecated — ignored, kept for backward compat */
+    packageName?: string;
+}
+declare function resolveNativeBindingCandidates(options: ResolveCandidatesOptions): string[];
+declare function resolveRuntimeDir(dir: string | undefined, importMetaUrl: string): string;
+declare function hashContent(content: string, algorithm?: string, length?: number): string;
+declare function formatErrorMessage(error: unknown): string;
+declare class LRUCache<K, V> {
+    private capacity;
+    private cache;
+    constructor(capacity: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    delete(key: K): boolean;
+    has(key: K): boolean;
+    clear(): void;
+    entries(): IterableIterator<[K, V]>;
+    get size(): number;
+}
+
+export { type BuildPhaseTrace, type BuildPhases, type BuildTelemetry, type BuildTrace, type ClassInspection, type ClassProperty, type ClassUsageLocation, type ComponentCodegenOptions, type CompoundCondition, type DashboardMetrics, type DashboardSummary, ERROR_CODES, type ErrorCode, type ErrorSource, type GeneratedStateRule, type HtmlTagName, LRUCache, type LoadNativeBindingOptions, type LoadNativeBindingResult, type Logger, NativeAnalyzerReportSchema, NativeCacheEntrySchema, NativeCacheReadResultSchema, NativeCssCompileResultSchema, type NativeResolutionResult, NativeScanFileSchema, NativeScanResultSchema, NativeTransformResultSchema, NativeWatchResultSchema, type ObservabilityClient, type PackageJson, PackageJsonSchema, type RegistryFile, RegistryFileSchema, type RegistryPluginEntry, RegistryPluginEntrySchema, type ResolveCandidatesOptions, type ScanCache, type ScanCacheClassEntry, ScanCacheClassEntrySchema, ScanCacheSchema, type StaticStateCssInput, type StaticStateExtractionResult, TW_STATE_STATIC_FILENAME, type TailwindConfig, TailwindConfigSchema, type TailwindInfo, TelemetryCollector, type TelemetrySummary, type TokenMap, type TraceSnapshot, type TraceSummary, TwError, type TwStateConfigEntry, type VariantMatrix, type VariantProps, type VariantValue, type WorkerPathOptions, type WorkerPathResult, appendStaticStateCssToSafelist, assertTailwindV4, calculateHealth, createBuildTimer, createDebugLogger, createEsmRequire, createLogger, createObservabilityClient, createTraceSnapshot, detectTailwind, extractStaticStateCss, formatDuration, formatErrorCode, formatErrorMessage, formatMemory, formatNativeNotFoundError, generateBarrelFile, generateClassRenameCodemod, generateComponentCode, generateStorybookStory, getBuildTimeColor, getDirname, getFilename, getGlobalTelemetry, getHealthColor, getMemoryColor, getModeColor, getPipelinePercentages, getSuggestion, getTailwindVersion, hashContent, isTailwindV4, isTwError, loadNativeBinding, parseJsonFileWithSchema, parseJsonWithSchema, parseNative, resetGlobalTelemetry, resolveFromRoot, resolveLoaderPath, resolveNativeBinary, resolveNativeBindingCandidates, resolveNativeNodePath, resolveRuntimeDir, resolveWorkerPath, safeParseNative, setGlobalLogFile, tryRequire, wrapUnknownError };

package/dist/shared.d.ts

@@ -1,6 +1,99 @@
-export { C as CompoundCondition, E as ErrorSource, H as HtmlTagName, L as LRUCache, c as LoadNativeBindingOptions, d as LoadNativeBindingResult, e as Logger, R as ResolveCandidatesOptions, T as TokenMap, f as TwError, V as VariantMatrix, b as VariantProps, a as VariantValue, g as createDebugLogger, h as createLogger, i as formatErrorMessage, j as hashContent, k as isTwError, l as loadNativeBinding, r as resolveNativeBindingCandidates, m as resolveRuntimeDir, w as wrapUnknownError } from './index-NDINUhLN.js';
 import { z } from 'zod';
-export { T as TraceSnapshot, a as TraceSummary, i as calculateHealth, j as createTraceSnapshot, f as formatDuration, b as formatMemory, g as getBuildTimeColor, c as getHealthColor, d as getMemoryColor, e as getModeColor, h as getPipelinePercentages } from './trace-Dz4vmZdy.js';
+
+/**
+ * Shared trace utilities for CLI, devtools, and dashboard
+ *
+ * Provides reusable trace snapshot handling, formatting, and analysis
+ * across the tailwind-styled-v4 ecosystem without introducing coupling.
+ */
+interface TraceSnapshot {
+    generatedAt: string;
+    buildMs: number | null;
+    scanMs: number | null;
+    analyzeMs: number | null;
+    compileMs: number | null;
+    memoryMb: {
+        rss: number;
+        heapUsed: number;
+        heapTotal: number;
+    } | null;
+    classCount: number | null;
+    fileCount: number | null;
+    cssBytes: number | null;
+    mode: string | null;
+    eventsReceived?: number;
+    eventsProcessed?: number;
+    batchesProcessed?: number;
+    incrementalUpdates?: number;
+    fullRescans?: number;
+}
+interface TraceSummary {
+    workspace: {
+        totalPackages: number;
+        totalFiles: number;
+        totalClasses: number;
+        lastScanDurationMs: number;
+        lastBuildDurationMs: number;
+    };
+    cache: {
+        hitRate: number;
+        totalEntries: number;
+        memoryUsageMb: number;
+    };
+    pipeline: {
+        scanDurationMs: number;
+        analyzeDurationMs: number;
+        compileDurationMs: number;
+        totalDurationMs: number;
+    };
+    health: {
+        status: "healthy" | "degraded" | "unhealthy";
+        issues: Array<{
+            severity: string;
+            message: string;
+        }>;
+    };
+}
+/**
+ * Get health status color for UI rendering
+ */
+declare function getHealthColor(status?: string): string;
+/**
+ * Get mode color for UI rendering
+ */
+declare function getModeColor(mode?: string | null): string;
+/**
+ * Format memory in human-readable format
+ */
+declare function formatMemory(bytes: number): string;
+/**
+ * Format duration in human-readable format
+ */
+declare function formatDuration(ms: number | null): string;
+/**
+ * Calculate health status from metrics
+ */
+declare function calculateHealth(metrics: TraceSnapshot, summary?: TraceSummary): "healthy" | "degraded" | "unhealthy";
+/**
+ * Get color for build time indicator
+ */
+declare function getBuildTimeColor(ms: number | null): string;
+/**
+ * Get color for memory usage indicator
+ */
+declare function getMemoryColor(mb: number): string;
+/**
+ * Create trace snapshot from dashboard data
+ */
+declare function createTraceSnapshot(data: Record<string, unknown>): TraceSnapshot;
+/**
+ * Calculate pipeline time distribution
+ */
+declare function getPipelinePercentages(metrics: TraceSnapshot): {
+    scanPct: number;
+    analyzePct: number;
+    compilePct: number;
+};
 
 /**
  * Error code registry — single source of truth for all error codes.
@@ -748,4 +841,93 @@ declare function appendStaticStateCssToSafelist(srcDir: string, safelistPath: st
 
 declare function setGlobalLogFile(filePath: string): void;
 
-export { type BuildPhaseTrace, type BuildPhases, type BuildTelemetry, type BuildTrace, type ClassInspection, type ClassProperty, type ClassUsageLocation, type ComponentCodegenOptions, type DashboardMetrics, type DashboardSummary, ERROR_CODES, type ErrorCode, type GeneratedStateRule, NativeAnalyzerReportSchema, NativeCacheEntrySchema, NativeCacheReadResultSchema, NativeCssCompileResultSchema, type NativeResolutionResult, NativeScanFileSchema, NativeScanResultSchema, NativeTransformResultSchema, NativeWatchResultSchema, type ObservabilityClient, type PackageJson, PackageJsonSchema, type RegistryFile, RegistryFileSchema, type RegistryPluginEntry, RegistryPluginEntrySchema, type ScanCache, type ScanCacheClassEntry, ScanCacheClassEntrySchema, ScanCacheSchema, type StaticStateCssInput, type StaticStateExtractionResult, TW_STATE_STATIC_FILENAME, type TailwindConfig, TailwindConfigSchema, type TailwindInfo, TelemetryCollector, type TelemetrySummary, type TwStateConfigEntry, type WorkerPathOptions, type WorkerPathResult, appendStaticStateCssToSafelist, assertTailwindV4, createBuildTimer, createEsmRequire, createObservabilityClient, detectTailwind, extractStaticStateCss, formatErrorCode, formatNativeNotFoundError, generateBarrelFile, generateClassRenameCodemod, generateComponentCode, generateStorybookStory, getDirname, getFilename, getGlobalTelemetry, getSuggestion, getTailwindVersion, isTailwindV4, parseJsonFileWithSchema, parseJsonWithSchema, parseNative, resetGlobalTelemetry, resolveFromRoot, resolveLoaderPath, resolveNativeBinary, resolveNativeNodePath, resolveWorkerPath, safeParseNative, setGlobalLogFile, tryRequire };
+type TokenMap = Record<string, string>;
+type VariantValue = string | number | boolean | undefined;
+type VariantProps = Record<string, VariantValue>;
+type HtmlTagName = keyof HTMLElementTagNameMap;
+type CompoundCondition = Record<string, string | number | boolean>;
+type VariantMatrix = Record<string, Array<string | number | boolean>>;
+interface Logger {
+    warn(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    log(...args: unknown[]): void;
+}
+declare function createLogger(namespace: string): Logger;
+declare function createDebugLogger(namespace: string, label?: string): (msg: string) => void;
+type ErrorSource = "rust" | "validation" | "compile" | "io" | "config" | "unknown";
+type ZodLikeIssue = {
+    path?: readonly PropertyKey[];
+    message?: string;
+};
+declare class TwError extends Error {
+    /** @deprecated Gunakan source */
+    readonly domain: string;
+    readonly source: ErrorSource;
+    readonly code: string;
+    readonly originalCause?: unknown;
+    constructor(domainOrSource: string, code: string, message: string, cause?: unknown);
+    static fromIo(code: string, message: string): TwError;
+    static fromCompile(code: string, message: string): TwError;
+    static fromRust(err: {
+        code?: string;
+        message?: string;
+    } | Error | unknown): TwError;
+    /** Buat TwError dari ZodError — dukung shape Zod v3 (`errors`) dan v4 (`issues`). */
+    static fromZod(err: {
+        issues?: ZodLikeIssue[];
+        errors?: ZodLikeIssue[];
+    }): TwError;
+    static wrap(source: string, code: string, err: unknown): TwError;
+    toString(): string;
+    toJSON(): {
+        name: string;
+        source: string;
+        code: string;
+        message: string;
+    };
+    toCliMessage(): string;
+}
+declare function wrapUnknownError(domain: string, code: string, error: unknown): TwError;
+declare function isTwError(err: unknown): err is TwError;
+interface LoadNativeBindingOptions<T> {
+    runtimeDir: string;
+    candidates: string[];
+    isValid: (module: unknown) => module is T;
+    invalidExportMessage: string;
+}
+interface LoadNativeBindingResult<T> {
+    binding: T | null;
+    loadErrors: Array<{
+        path: string;
+        message: string;
+    }>;
+    loadedPath?: string;
+}
+declare function loadNativeBinding<T>(options: LoadNativeBindingOptions<T>): LoadNativeBindingResult<T>;
+interface ResolveCandidatesOptions {
+    runtimeDir?: string;
+    envVarNames?: string[];
+    includeDefaultCandidates?: boolean;
+    enforceNodeExtensionForEnvPath?: boolean;
+    /** @deprecated — ignored, kept for backward compat */
+    packageName?: string;
+}
+declare function resolveNativeBindingCandidates(options: ResolveCandidatesOptions): string[];
+declare function resolveRuntimeDir(dir: string | undefined, importMetaUrl: string): string;
+declare function hashContent(content: string, algorithm?: string, length?: number): string;
+declare function formatErrorMessage(error: unknown): string;
+declare class LRUCache<K, V> {
+    private capacity;
+    private cache;
+    constructor(capacity: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    delete(key: K): boolean;
+    has(key: K): boolean;
+    clear(): void;
+    entries(): IterableIterator<[K, V]>;
+    get size(): number;
+}
+
+export { type BuildPhaseTrace, type BuildPhases, type BuildTelemetry, type BuildTrace, type ClassInspection, type ClassProperty, type ClassUsageLocation, type ComponentCodegenOptions, type CompoundCondition, type DashboardMetrics, type DashboardSummary, ERROR_CODES, type ErrorCode, type ErrorSource, type GeneratedStateRule, type HtmlTagName, LRUCache, type LoadNativeBindingOptions, type LoadNativeBindingResult, type Logger, NativeAnalyzerReportSchema, NativeCacheEntrySchema, NativeCacheReadResultSchema, NativeCssCompileResultSchema, type NativeResolutionResult, NativeScanFileSchema, NativeScanResultSchema, NativeTransformResultSchema, NativeWatchResultSchema, type ObservabilityClient, type PackageJson, PackageJsonSchema, type RegistryFile, RegistryFileSchema, type RegistryPluginEntry, RegistryPluginEntrySchema, type ResolveCandidatesOptions, type ScanCache, type ScanCacheClassEntry, ScanCacheClassEntrySchema, ScanCacheSchema, type StaticStateCssInput, type StaticStateExtractionResult, TW_STATE_STATIC_FILENAME, type TailwindConfig, TailwindConfigSchema, type TailwindInfo, TelemetryCollector, type TelemetrySummary, type TokenMap, type TraceSnapshot, type TraceSummary, TwError, type TwStateConfigEntry, type VariantMatrix, type VariantProps, type VariantValue, type WorkerPathOptions, type WorkerPathResult, appendStaticStateCssToSafelist, assertTailwindV4, calculateHealth, createBuildTimer, createDebugLogger, createEsmRequire, createLogger, createObservabilityClient, createTraceSnapshot, detectTailwind, extractStaticStateCss, formatDuration, formatErrorCode, formatErrorMessage, formatMemory, formatNativeNotFoundError, generateBarrelFile, generateClassRenameCodemod, generateComponentCode, generateStorybookStory, getBuildTimeColor, getDirname, getFilename, getGlobalTelemetry, getHealthColor, getMemoryColor, getModeColor, getPipelinePercentages, getSuggestion, getTailwindVersion, hashContent, isTailwindV4, isTwError, loadNativeBinding, parseJsonFileWithSchema, parseJsonWithSchema, parseNative, resetGlobalTelemetry, resolveFromRoot, resolveLoaderPath, resolveNativeBinary, resolveNativeBindingCandidates, resolveNativeNodePath, resolveRuntimeDir, resolveWorkerPath, safeParseNative, setGlobalLogFile, tryRequire, wrapUnknownError };