@csszyx/unplugin 0.6.2 → 0.8.0

package/dist/index.d.cts

@@ -1,5 +1,8 @@
+import _default from './shared/unplugin.DUbr5w-N.cjs';
 export { CSSManglerOptions, CSSManglerResult, MangleMap, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.cjs';
-export { u as default, e as esbuildPlugin, m as mangleCodeClassesSync, r as rollupPlugin, u as unplugin, v as vitePlugin, w as webpackPlugin } from './unplugin-DUbr5w-N.cjs';
+// @ts-ignore
+export = _default;
+export { e as esbuildPlugin, m as mangleCodeClassesSync, r as rollupPlugin, u as unplugin, v as vitePlugin, w as webpackPlugin } from './shared/unplugin.DUbr5w-N.cjs';
 import 'postcss';
 import '@csszyx/types';
 import 'esbuild';
@@ -7,6 +10,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 +153,5 @@ declare function mergeThemes(themes: ParsedTheme[]): ParsedTheme;
  */
 declare function hasTokens(theme: ParsedTheme): boolean;
 
-export { type ParsedTheme, hasTokens, mergeThemes, parseThemeBlocks };
+export { assertNoRSCBoundaryViolation, assertNoRSCGraphViolation, createRSCModuleRecord, findRSCBoundaryViolation, findRSCGraphViolation, hasTokens, hasUseClientDirective, hasUseServerDirective, isRSCServerModule, mergeThemes, parseThemeBlocks };
+export type { ParsedTheme, RSCBoundaryViolation, RSCModuleRecord };

package/dist/index.d.mts

@@ -0,0 +1,154 @@
+export { CSSManglerOptions, CSSManglerResult, MangleMap, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
+export { u as default, e as esbuildPlugin, m as mangleCodeClassesSync, r as rollupPlugin, u as unplugin, v as vitePlugin, w as webpackPlugin } from './shared/unplugin.DUbr5w-N.mjs';
+import 'postcss';
+import '@csszyx/types';
+import 'esbuild';
+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.
+ *
+ * Extracts custom design tokens and categorizes them by type so the
+ * type writer can generate accurate TypeScript augmentation.
+ *
+ * Supports:
+ *   - Multiple @theme blocks per file
+ *   - @theme inline { } syntax (inline keyword ignored)
+ *   - @theme inside @layer (two-pass strip)
+ *   - --color-brand-50 shade suffixes (deduped to 'brand')
+ *   - Multi-file merge via mergeThemes()
+ */
+/** Extracted and categorized custom tokens from @theme blocks. */
+interface ParsedTheme {
+    /** Custom color names (from --color-*): e.g. ['brand', 'brand-dark'] */
+    colors: string[];
+    /** Custom spacing tokens (from --spacing-*): e.g. ['xl', '2xs'] */
+    spacings: string[];
+    /** Custom font families (from --font-*): e.g. ['display', 'body'] */
+    fonts: string[];
+    /** Custom border radii (from --radius-*): e.g. ['button'] */
+    radii: string[];
+    /** Custom shadows (from --shadow-*): e.g. ['card'] */
+    shadows: string[];
+}
+/**
+ * Parse all @theme blocks in a CSS file and extract design tokens.
+ *
+ * @param cssContent - Raw CSS file content
+ * @returns Categorized design tokens
+ */
+declare function parseThemeBlocks(cssContent: string): ParsedTheme;
+/**
+ * Merge multiple ParsedTheme objects into one, deduplicating tokens.
+ *
+ * @param themes - Array of parsed themes to merge
+ * @returns Merged theme with unique tokens per category
+ */
+declare function mergeThemes(themes: ParsedTheme[]): ParsedTheme;
+/**
+ * Check if a ParsedTheme has any tokens.
+ *
+ * @param theme - Parsed theme to check
+ * @returns True if at least one category has tokens
+ */
+declare function hasTokens(theme: ParsedTheme): boolean;
+
+export { assertNoRSCBoundaryViolation, assertNoRSCGraphViolation, createRSCModuleRecord, findRSCBoundaryViolation, findRSCGraphViolation, hasTokens, hasUseClientDirective, hasUseServerDirective, isRSCServerModule, mergeThemes, parseThemeBlocks };
+export type { ParsedTheme, RSCBoundaryViolation, RSCModuleRecord };

package/dist/index.mjs

@@ -0,0 +1,12 @@
+export { createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
+export { a as assertNoRSCBoundaryViolation, b as assertNoRSCGraphViolation, c as createRSCModuleRecord, u as default, e as esbuildPlugin, f as findRSCBoundaryViolation, d as findRSCGraphViolation, h as hasTokens, g as hasUseClientDirective, i as hasUseServerDirective, j as isRSCServerModule, m as mangleCodeClassesSync, k as mergeThemes, p as parseThemeBlocks, r as rollupPlugin, u as unplugin, v as vitePlugin, w as webpackPlugin } from './shared/unplugin.DCv0RtVZ.mjs';
+import 'postcss';
+import 'postcss-selector-parser';
+import 'node:fs';
+import 'node:path';
+import '@csszyx/compiler';
+import '@csszyx/core';
+import '@csszyx/svelte-adapter';
+import '@csszyx/vue-adapter';
+import 'unplugin';
+import 'node:crypto';