@csszyx/unplugin 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -7,6 +7,101 @@ import 'rollup';
 import 'unplugin';
 import 'vite';
 
+/**
+ * Direct RSC boundary violation found in a transformed module.
+ */
+interface RSCBoundaryViolation {
+    /** Forbidden runtime helper that crossed into an RSC server module. */
+    symbol: string;
+    /** Server module path where the import was found. */
+    path: string;
+    /** Import chain used in the fatal build error. */
+    importChain: string[];
+}
+/**
+ * RSC module metadata collected during the transform phase.
+ */
+interface RSCModuleRecord {
+    /** Normalized absolute module ID. */
+    id: string;
+    /** True when this module is an RSC server module entry or has `'use server'`. */
+    isServer: boolean;
+    /** True when this module declares the client boundary. */
+    isClient: boolean;
+    /** Local modules imported by this file after path resolution. */
+    imports: string[];
+    /** Forbidden runtime imports found directly in this module. */
+    runtimeImports: Array<{
+        source: string;
+        symbols: string[];
+    }>;
+}
+/**
+ * Returns true when a module starts with the top-level `'use server'`
+ * directive. Comments and blank lines before the directive are allowed, but
+ * detection stops at the first real statement.
+ *
+ * @param code module source
+ * @returns true when the module has a top-level `'use server'` directive
+ */
+declare function hasUseServerDirective(code: string): boolean;
+/**
+ * Returns true when a module starts with the top-level `'use client'`
+ * directive.
+ *
+ * @param code module source
+ * @returns true when the module has a top-level `'use client'` directive
+ */
+declare function hasUseClientDirective(code: string): boolean;
+/**
+ * Detects modules that should be treated as RSC server modules by csszyx.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns true when the module is server-side for RSC boundary purposes
+ */
+declare function isRSCServerModule(code: string, id: string): boolean;
+/**
+ * Finds the first direct forbidden runtime helper import in an RSC server
+ * module.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns violation details, or null when the module is allowed
+ */
+declare function findRSCBoundaryViolation(code: string, id: string): RSCBoundaryViolation | null;
+/**
+ * Builds module metadata for the RSC graph walker.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns graph metadata for the module
+ */
+declare function createRSCModuleRecord(code: string, id: string): RSCModuleRecord;
+/**
+ * Finds forbidden runtime helper imports reachable from an RSC server module.
+ * Traversal stops at `'use client'` modules because they define a separate
+ * client module graph.
+ *
+ * @param records module graph records keyed by normalized module ID
+ * @returns first graph violation, or null when the graph is allowed
+ */
+declare function findRSCGraphViolation(records: Map<string, RSCModuleRecord>): RSCBoundaryViolation | null;
+/**
+ * Throws the spec-format fatal RSC boundary error for graph-level violations.
+ *
+ * @param records module graph records keyed by normalized module ID
+ */
+declare function assertNoRSCGraphViolation(records: Map<string, RSCModuleRecord>): void;
+/**
+ * Throws the spec-format fatal RSC boundary error when a server module imports
+ * a forbidden csszyx runtime helper.
+ *
+ * @param code module source
+ * @param id module ID/path
+ */
+declare function assertNoRSCBoundaryViolation(code: string, id: string): void;
+
 /**
  * Theme Scanner — parses Tailwind v4 @theme blocks from CSS files.
  *
@@ -55,4 +150,4 @@ declare function mergeThemes(themes: ParsedTheme[]): ParsedTheme;
  */
 declare function hasTokens(theme: ParsedTheme): boolean;
 
-export { type ParsedTheme, hasTokens, mergeThemes, parseThemeBlocks };
+export { type ParsedTheme, type RSCBoundaryViolation, type RSCModuleRecord, assertNoRSCBoundaryViolation, assertNoRSCGraphViolation, createRSCModuleRecord, findRSCBoundaryViolation, findRSCGraphViolation, hasTokens, hasUseClientDirective, hasUseServerDirective, isRSCServerModule, mergeThemes, parseThemeBlocks };

package/dist/index.d.ts

@@ -7,6 +7,101 @@ import 'rollup';
 import 'unplugin';
 import 'vite';
 
+/**
+ * Direct RSC boundary violation found in a transformed module.
+ */
+interface RSCBoundaryViolation {
+    /** Forbidden runtime helper that crossed into an RSC server module. */
+    symbol: string;
+    /** Server module path where the import was found. */
+    path: string;
+    /** Import chain used in the fatal build error. */
+    importChain: string[];
+}
+/**
+ * RSC module metadata collected during the transform phase.
+ */
+interface RSCModuleRecord {
+    /** Normalized absolute module ID. */
+    id: string;
+    /** True when this module is an RSC server module entry or has `'use server'`. */
+    isServer: boolean;
+    /** True when this module declares the client boundary. */
+    isClient: boolean;
+    /** Local modules imported by this file after path resolution. */
+    imports: string[];
+    /** Forbidden runtime imports found directly in this module. */
+    runtimeImports: Array<{
+        source: string;
+        symbols: string[];
+    }>;
+}
+/**
+ * Returns true when a module starts with the top-level `'use server'`
+ * directive. Comments and blank lines before the directive are allowed, but
+ * detection stops at the first real statement.
+ *
+ * @param code module source
+ * @returns true when the module has a top-level `'use server'` directive
+ */
+declare function hasUseServerDirective(code: string): boolean;
+/**
+ * Returns true when a module starts with the top-level `'use client'`
+ * directive.
+ *
+ * @param code module source
+ * @returns true when the module has a top-level `'use client'` directive
+ */
+declare function hasUseClientDirective(code: string): boolean;
+/**
+ * Detects modules that should be treated as RSC server modules by csszyx.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns true when the module is server-side for RSC boundary purposes
+ */
+declare function isRSCServerModule(code: string, id: string): boolean;
+/**
+ * Finds the first direct forbidden runtime helper import in an RSC server
+ * module.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns violation details, or null when the module is allowed
+ */
+declare function findRSCBoundaryViolation(code: string, id: string): RSCBoundaryViolation | null;
+/**
+ * Builds module metadata for the RSC graph walker.
+ *
+ * @param code module source
+ * @param id module ID/path
+ * @returns graph metadata for the module
+ */
+declare function createRSCModuleRecord(code: string, id: string): RSCModuleRecord;
+/**
+ * Finds forbidden runtime helper imports reachable from an RSC server module.
+ * Traversal stops at `'use client'` modules because they define a separate
+ * client module graph.
+ *
+ * @param records module graph records keyed by normalized module ID
+ * @returns first graph violation, or null when the graph is allowed
+ */
+declare function findRSCGraphViolation(records: Map<string, RSCModuleRecord>): RSCBoundaryViolation | null;
+/**
+ * Throws the spec-format fatal RSC boundary error for graph-level violations.
+ *
+ * @param records module graph records keyed by normalized module ID
+ */
+declare function assertNoRSCGraphViolation(records: Map<string, RSCModuleRecord>): void;
+/**
+ * Throws the spec-format fatal RSC boundary error when a server module imports
+ * a forbidden csszyx runtime helper.
+ *
+ * @param code module source
+ * @param id module ID/path
+ */
+declare function assertNoRSCBoundaryViolation(code: string, id: string): void;
+
 /**
  * Theme Scanner — parses Tailwind v4 @theme blocks from CSS files.
  *
@@ -55,4 +150,4 @@ declare function mergeThemes(themes: ParsedTheme[]): ParsedTheme;
  */
 declare function hasTokens(theme: ParsedTheme): boolean;
 
-export { type ParsedTheme, hasTokens, mergeThemes, parseThemeBlocks };
+export { type ParsedTheme, type RSCBoundaryViolation, type RSCModuleRecord, assertNoRSCBoundaryViolation, assertNoRSCGraphViolation, createRSCModuleRecord, findRSCBoundaryViolation, findRSCGraphViolation, hasTokens, hasUseClientDirective, hasUseServerDirective, isRSCServerModule, mergeThemes, parseThemeBlocks };

package/dist/index.js

@@ -1,6 +1,14 @@
 import {
+  assertNoRSCBoundaryViolation,
+  assertNoRSCGraphViolation,
+  createRSCModuleRecord,
   esbuildPlugin,
+  findRSCBoundaryViolation,
+  findRSCGraphViolation,
   hasTokens,
+  hasUseClientDirective,
+  hasUseServerDirective,
+  isRSCServerModule,
   mangleCodeClassesSync,
   mergeThemes,
   parseThemeBlocks,
@@ -8,7 +16,7 @@ import {
   unplugin,
   vitePlugin,
   webpackPlugin
-} from "./chunk-HOQTC45W.js";
+} from "./chunk-GXGGTRUA.js";
 import {
   createPostCSSPlugin,
   escapeCSSClassName,
@@ -17,11 +25,19 @@ import {
   unescapeTailwindClass
 } from "./chunk-4M7CPGP7.js";
 export {
+  assertNoRSCBoundaryViolation,
+  assertNoRSCGraphViolation,
   createPostCSSPlugin,
+  createRSCModuleRecord,
   unplugin as default,
   esbuildPlugin,
   escapeCSSClassName,
+  findRSCBoundaryViolation,
+  findRSCGraphViolation,
   hasTokens,
+  hasUseClientDirective,
+  hasUseServerDirective,
+  isRSCServerModule,
   mangleCSS,
   mangleCSSSync,
   mangleCodeClassesSync,