tailwind-styled-v4 5.0.11 → 5.0.12

package/dist/next.d.mts

@@ -48,4 +48,47 @@ interface TailwindStyledNextOptions {
 
 declare function withTailwindStyled(options?: TailwindStyledNextOptions): (nextConfig?: NextConfig) => NextConfig;
 
-export { type NextAdapterOptionsInput, NextAdapterOptionsSchema, type TailwindStyledNextOptions, parseNextAdapterOptions, withTailwindStyled };
+/**
+ * StaticCssWebpackPlugin
+ *
+ * Webpack plugin companion untuk tailwind-styled-v4 build-time migration.
+ *
+ * Masalah yang diselesaikan:
+ * - `webpackLoader.ts` di-invoke per-file saat transform. Kalau pakai append-to-file
+ *   langsung, ada dua bug: (1) rules lama tidak dibersihkan saat file di-edit/hapus
+ *   statenya, (2) duplicate rules kalau file di-transform ulang.
+ *
+ * Solusi: plugin ini maintain `_fileStaticCssMap: Map<filepath, css>` yang hidup
+ * selama proses webpack. Setiap kali loader transform file, ia update Map.
+ * Di `compiler.hooks.done`, plugin rebuild `_tw-state-static.css` dari scratch
+ * menggunakan seluruh isi Map → selalu fresh, tidak ada stale rules.
+ *
+ * HMR flow:
+ *   File berubah → webpack incremental compilation → loader transform file baru
+ *   → `setFileStaticCss(filepath, newCss)` update Map → `done` hook flush Map
+ *   → `_tw-state-static.css` berisi state terbaru dari semua file.
+ *
+ * File dihapus / state dihapus:
+ *   Webpack invalidate → loader transform ulang → `setFileStaticCss(filepath, undefined)`
+ *   hapus entry dari Map → `done` hook flush → file tidak ada stale rules.
+ */
+/**
+ * Dipanggil oleh `webpackLoader.ts` setiap kali file di-transform.
+ * Pass `undefined` / empty string untuk hapus entry (file tidak punya state CSS).
+ */
+declare function setFileStaticCss(filepath: string, css: string | undefined): void;
+interface WebpackCompiler {
+    hooks: {
+        done: {
+            tap(pluginName: string, callback: () => void): void;
+        };
+    };
+}
+declare class StaticCssWebpackPlugin {
+    static readonly PLUGIN_NAME = "TailwindStyledStaticCss";
+    private readonly outPath;
+    constructor(safelistPath: string);
+    apply(compiler: WebpackCompiler): void;
+}
+
+export { type NextAdapterOptionsInput, NextAdapterOptionsSchema, StaticCssWebpackPlugin, type TailwindStyledNextOptions, parseNextAdapterOptions, setFileStaticCss, withTailwindStyled };

package/dist/next.d.ts

@@ -48,4 +48,47 @@ interface TailwindStyledNextOptions {
 
 declare function withTailwindStyled(options?: TailwindStyledNextOptions): (nextConfig?: NextConfig) => NextConfig;
 
-export { type NextAdapterOptionsInput, NextAdapterOptionsSchema, type TailwindStyledNextOptions, parseNextAdapterOptions, withTailwindStyled };
+/**
+ * StaticCssWebpackPlugin
+ *
+ * Webpack plugin companion untuk tailwind-styled-v4 build-time migration.
+ *
+ * Masalah yang diselesaikan:
+ * - `webpackLoader.ts` di-invoke per-file saat transform. Kalau pakai append-to-file
+ *   langsung, ada dua bug: (1) rules lama tidak dibersihkan saat file di-edit/hapus
+ *   statenya, (2) duplicate rules kalau file di-transform ulang.
+ *
+ * Solusi: plugin ini maintain `_fileStaticCssMap: Map<filepath, css>` yang hidup
+ * selama proses webpack. Setiap kali loader transform file, ia update Map.
+ * Di `compiler.hooks.done`, plugin rebuild `_tw-state-static.css` dari scratch
+ * menggunakan seluruh isi Map → selalu fresh, tidak ada stale rules.
+ *
+ * HMR flow:
+ *   File berubah → webpack incremental compilation → loader transform file baru
+ *   → `setFileStaticCss(filepath, newCss)` update Map → `done` hook flush Map
+ *   → `_tw-state-static.css` berisi state terbaru dari semua file.
+ *
+ * File dihapus / state dihapus:
+ *   Webpack invalidate → loader transform ulang → `setFileStaticCss(filepath, undefined)`
+ *   hapus entry dari Map → `done` hook flush → file tidak ada stale rules.
+ */
+/**
+ * Dipanggil oleh `webpackLoader.ts` setiap kali file di-transform.
+ * Pass `undefined` / empty string untuk hapus entry (file tidak punya state CSS).
+ */
+declare function setFileStaticCss(filepath: string, css: string | undefined): void;
+interface WebpackCompiler {
+    hooks: {
+        done: {
+            tap(pluginName: string, callback: () => void): void;
+        };
+    };
+}
+declare class StaticCssWebpackPlugin {
+    static readonly PLUGIN_NAME = "TailwindStyledStaticCss";
+    private readonly outPath;
+    constructor(safelistPath: string);
+    apply(compiler: WebpackCompiler): void;
+}
+
+export { type NextAdapterOptionsInput, NextAdapterOptionsSchema, StaticCssWebpackPlugin, type TailwindStyledNextOptions, parseNextAdapterOptions, setFileStaticCss, withTailwindStyled };