tailwind-styled-v4 5.0.11 → 5.0.13

package/dist/shared.d.mts

@@ -642,4 +642,110 @@ declare function createObservabilityClient(opts?: {
     timeoutMs?: number;
 }): ObservabilityClient;
 
-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, 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 TailwindConfig, TailwindConfigSchema, type TailwindInfo, TelemetryCollector, type TelemetrySummary, type WorkerPathOptions, type WorkerPathResult, assertTailwindV4, createBuildTimer, createEsmRequire, createObservabilityClient, detectTailwind, formatErrorCode, formatNativeNotFoundError, generateBarrelFile, generateClassRenameCodemod, generateComponentCode, generateStorybookStory, getDirname, getFilename, getGlobalTelemetry, getSuggestion, getTailwindVersion, isTailwindV4, parseJsonFileWithSchema, parseJsonWithSchema, parseNative, resetGlobalTelemetry, resolveFromRoot, resolveLoaderPath, resolveNativeBinary, resolveNativeNodePath, resolveWorkerPath, safeParseNative, tryRequire };
+/**
+ * staticStateExtractor.ts — Build-time State CSS Pre-generator
+ *
+ * Mengkoordinasi pipeline untuk mengeliminasi runtime CSS injection untuk `states` config.
+ *
+ * Flow:
+ *   1. Walk semua source files (.ts/.tsx/.js/.jsx)
+ *   2. Per file: panggil `extractTwStateConfigs()` (Rust NAPI)
+ *      → temukan semua `tw.tag({ states: {...} })` calls
+ *   3. Kumpulkan semua configs, panggil `generateStaticStateCss()` (Rust NAPI)
+ *      → compute hash identik dengan runtime stateEngine.ts
+ *      → generate CSS rules dengan selector `.tw-s-[hash][data-stateName="true"]`
+ *   4. Append hasilnya ke safelist CSS file
+ *
+ * Hasilnya: browser load state CSS dari static file — ZERO runtime injection,
+ * ZERO flicker saat component dengan states di-render.
+ *
+ * Dipanggil dari withTailwindStyled.ts setelah initial Tailwind CSS scan.
+ *
+ * @module staticStateExtractor
+ */
+interface TwStateConfigEntry {
+    tag: string;
+    componentName: string;
+    statesJson: string;
+    sourceFile: string;
+}
+interface StaticStateCssInput {
+    tag: string;
+    componentName: string;
+    statesJson: string;
+}
+interface GeneratedStateRule {
+    selector: string;
+    declarations: string;
+    cssRule: string;
+    componentName: string;
+    stateName: string;
+}
+interface StaticStateExtractionResult {
+    /** Total source files di-scan */
+    filesScanned: number;
+    /** Files yang punya tw() state configs */
+    filesWithStates: number;
+    /** Total komponen dengan states ditemukan */
+    componentsFound: number;
+    /** Total CSS rules yang di-generate */
+    rulesGenerated: number;
+    /** Rules yang tidak bisa di-resolve (butuh Tailwind full pipeline) */
+    rulesSkipped: number;
+    /** CSS yang siap di-append ke safelist file */
+    generatedCss: string;
+    /** Debug: semua rules yang di-generate */
+    rules: GeneratedStateRule[];
+}
+/**
+ * Scan semua source files di `srcDir`, extract tw() state configs,
+ * generate static CSS, dan return hasilnya.
+ *
+ * @param srcDir Root directory untuk scan (biasanya `process.cwd()/src`)
+ * @param options Optional configuration
+ */
+declare function extractStaticStateCss(srcDir: string, options?: {
+    /** Emit debug logging */
+    verbose?: boolean;
+    /** Max files untuk di-scan (default: unlimited) */
+    maxFiles?: number;
+    /**
+     * CSS output dari Tailwind pipeline (isi `_initial-scan.css`).
+     *
+     * Kalau di-provide, dipakai untuk resolve class names via `parseTailwindCssToClassMap`
+     * → semua Tailwind class (termasuk `w-full`, `ring-2`, dll) bisa di-resolve dengan benar.
+     *
+     * Kalau tidak di-provide, fallback ke Rust resolver (hanya class sederhana yang ter-resolve).
+     */
+    resolvedCss?: string;
+}): StaticStateExtractionResult;
+/** Nama file output untuk static state CSS — di-import langsung dari globals.css */
+declare const TW_STATE_STATIC_FILENAME = "_tw-state-static.css";
+/**
+ * Extract static state CSS dan tulis ke file terpisah `_tw-state-static.css`
+ * di `.next/tw-classes/_tw-state-static.css` — grouped bersama `_initial-scan.css`.
+ *
+ * File ini harus di-`@import` langsung dari globals.css karena berisi raw CSS
+ * (bukan Tailwind class names), sehingga tidak bisa di-pickup oleh `@source`.
+ *
+ * Dipanggil dari `withTailwindStyled.ts` setelah initial Tailwind scan.
+ *
+ * @param srcDir Source directory untuk scan
+ * @param safelistPath Path ke safelist CSS file — dipakai untuk derive direktori output
+ * @param options Optional config
+ * @returns Summary string untuk logging
+ */
+declare function appendStaticStateCssToSafelist(srcDir: string, safelistPath: string, options?: {
+    verbose?: boolean;
+    /**
+     * CSS output dari Tailwind pipeline — isi dari `_initial-scan.css`.
+     *
+     * Wajib di-provide untuk resolve semua Tailwind class dengan benar.
+     * Kalau tidak di-provide, fallback ke Rust resolver (class sederhana saja).
+     */
+    resolvedCss?: string;
+}): string;
+
+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 };

package/dist/shared.d.ts

@@ -642,4 +642,110 @@ declare function createObservabilityClient(opts?: {
     timeoutMs?: number;
 }): ObservabilityClient;
 
-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, 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 TailwindConfig, TailwindConfigSchema, type TailwindInfo, TelemetryCollector, type TelemetrySummary, type WorkerPathOptions, type WorkerPathResult, assertTailwindV4, createBuildTimer, createEsmRequire, createObservabilityClient, detectTailwind, formatErrorCode, formatNativeNotFoundError, generateBarrelFile, generateClassRenameCodemod, generateComponentCode, generateStorybookStory, getDirname, getFilename, getGlobalTelemetry, getSuggestion, getTailwindVersion, isTailwindV4, parseJsonFileWithSchema, parseJsonWithSchema, parseNative, resetGlobalTelemetry, resolveFromRoot, resolveLoaderPath, resolveNativeBinary, resolveNativeNodePath, resolveWorkerPath, safeParseNative, tryRequire };
+/**
+ * staticStateExtractor.ts — Build-time State CSS Pre-generator
+ *
+ * Mengkoordinasi pipeline untuk mengeliminasi runtime CSS injection untuk `states` config.
+ *
+ * Flow:
+ *   1. Walk semua source files (.ts/.tsx/.js/.jsx)
+ *   2. Per file: panggil `extractTwStateConfigs()` (Rust NAPI)
+ *      → temukan semua `tw.tag({ states: {...} })` calls
+ *   3. Kumpulkan semua configs, panggil `generateStaticStateCss()` (Rust NAPI)
+ *      → compute hash identik dengan runtime stateEngine.ts
+ *      → generate CSS rules dengan selector `.tw-s-[hash][data-stateName="true"]`
+ *   4. Append hasilnya ke safelist CSS file
+ *
+ * Hasilnya: browser load state CSS dari static file — ZERO runtime injection,
+ * ZERO flicker saat component dengan states di-render.
+ *
+ * Dipanggil dari withTailwindStyled.ts setelah initial Tailwind CSS scan.
+ *
+ * @module staticStateExtractor
+ */
+interface TwStateConfigEntry {
+    tag: string;
+    componentName: string;
+    statesJson: string;
+    sourceFile: string;
+}
+interface StaticStateCssInput {
+    tag: string;
+    componentName: string;
+    statesJson: string;
+}
+interface GeneratedStateRule {
+    selector: string;
+    declarations: string;
+    cssRule: string;
+    componentName: string;
+    stateName: string;
+}
+interface StaticStateExtractionResult {
+    /** Total source files di-scan */
+    filesScanned: number;
+    /** Files yang punya tw() state configs */
+    filesWithStates: number;
+    /** Total komponen dengan states ditemukan */
+    componentsFound: number;
+    /** Total CSS rules yang di-generate */
+    rulesGenerated: number;
+    /** Rules yang tidak bisa di-resolve (butuh Tailwind full pipeline) */
+    rulesSkipped: number;
+    /** CSS yang siap di-append ke safelist file */
+    generatedCss: string;
+    /** Debug: semua rules yang di-generate */
+    rules: GeneratedStateRule[];
+}
+/**
+ * Scan semua source files di `srcDir`, extract tw() state configs,
+ * generate static CSS, dan return hasilnya.
+ *
+ * @param srcDir Root directory untuk scan (biasanya `process.cwd()/src`)
+ * @param options Optional configuration
+ */
+declare function extractStaticStateCss(srcDir: string, options?: {
+    /** Emit debug logging */
+    verbose?: boolean;
+    /** Max files untuk di-scan (default: unlimited) */
+    maxFiles?: number;
+    /**
+     * CSS output dari Tailwind pipeline (isi `_initial-scan.css`).
+     *
+     * Kalau di-provide, dipakai untuk resolve class names via `parseTailwindCssToClassMap`
+     * → semua Tailwind class (termasuk `w-full`, `ring-2`, dll) bisa di-resolve dengan benar.
+     *
+     * Kalau tidak di-provide, fallback ke Rust resolver (hanya class sederhana yang ter-resolve).
+     */
+    resolvedCss?: string;
+}): StaticStateExtractionResult;
+/** Nama file output untuk static state CSS — di-import langsung dari globals.css */
+declare const TW_STATE_STATIC_FILENAME = "_tw-state-static.css";
+/**
+ * Extract static state CSS dan tulis ke file terpisah `_tw-state-static.css`
+ * di `.next/tw-classes/_tw-state-static.css` — grouped bersama `_initial-scan.css`.
+ *
+ * File ini harus di-`@import` langsung dari globals.css karena berisi raw CSS
+ * (bukan Tailwind class names), sehingga tidak bisa di-pickup oleh `@source`.
+ *
+ * Dipanggil dari `withTailwindStyled.ts` setelah initial Tailwind scan.
+ *
+ * @param srcDir Source directory untuk scan
+ * @param safelistPath Path ke safelist CSS file — dipakai untuk derive direktori output
+ * @param options Optional config
+ * @returns Summary string untuk logging
+ */
+declare function appendStaticStateCssToSafelist(srcDir: string, safelistPath: string, options?: {
+    verbose?: boolean;
+    /**
+     * CSS output dari Tailwind pipeline — isi dari `_initial-scan.css`.
+     *
+     * Wajib di-provide untuk resolve semua Tailwind class dengan benar.
+     * Kalau tidak di-provide, fallback ke Rust resolver (class sederhana saja).
+     */
+    resolvedCss?: string;
+}): string;
+
+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 };