@csszyx/unplugin 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -1,8 +1,58 @@
 export { CSSManglerOptions, CSSManglerResult, MangleMap, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.cjs';
-export { u as default, e as esbuildPlugin, r as rollupPlugin, u as unplugin, v as vitePlugin, w as webpackPlugin } from './unplugin-B9noIooS.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';
 import 'postcss';
 import '@csszyx/types';
 import 'esbuild';
 import 'rollup';
 import 'unplugin';
 import 'vite';
+
+/**
+ * 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 { type ParsedTheme, hasTokens, mergeThemes, parseThemeBlocks };

package/dist/index.d.ts

@@ -1,8 +1,58 @@
 export { CSSManglerOptions, CSSManglerResult, MangleMap, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.js';
-export { u as default, e as esbuildPlugin, r as rollupPlugin, u as unplugin, v as vitePlugin, w as webpackPlugin } from './unplugin-B9noIooS.js';
+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.js';
 import 'postcss';
 import '@csszyx/types';
 import 'esbuild';
 import 'rollup';
 import 'unplugin';
 import 'vite';
+
+/**
+ * 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 { type ParsedTheme, hasTokens, mergeThemes, parseThemeBlocks };

package/dist/index.js

@@ -1,10 +1,14 @@
 import {
   esbuildPlugin,
+  hasTokens,
+  mangleCodeClassesSync,
+  mergeThemes,
+  parseThemeBlocks,
   rollupPlugin,
   unplugin,
   vitePlugin,
   webpackPlugin
-} from "./chunk-3J4XUYF5.js";
+} from "./chunk-CW4XYEQR.js";
 import {
   createPostCSSPlugin,
   escapeCSSClassName,
@@ -17,8 +21,12 @@ export {
   unplugin as default,
   esbuildPlugin,
   escapeCSSClassName,
+  hasTokens,
   mangleCSS,
   mangleCSSSync,
+  mangleCodeClassesSync,
+  mergeThemes,
+  parseThemeBlocks,
   rollupPlugin,
   unescapeTailwindClass,
   unplugin,

package/dist/{unplugin-B9noIooS.d.cts → unplugin-DUbr5w-N.d.cts}

@@ -4,6 +4,22 @@ import { InputPluginOption } from 'rollup';
 import { UnpluginInstance, WebpackPluginInstance } from 'unplugin';
 import { PluginOption } from 'vite';
 
+/**
+ * Mangles class strings in bundled code (JS/HTML assets) using the given mangle map.
+ *
+ * Exported for unit testing; the plugin calls this via the thin private wrapper that
+ * supplies state.mangleMap.
+ *
+ * Pass 1:   Direct `className="..."` / `class="..."` static strings
+ * Pass 1.5: Template literal quasi (static) segments in `className:\`...\``
+ * Pass 2:   `className:EXPR` patterns with ternary operators containing quoted strings
+ * Pass 3:   Quoted string arguments to csszyx runtime helpers (_szMerge, _szIf, etc.)
+ *
+ * @param code     bundled source code
+ * @param mangleMap class-name → mangled-token mapping
+ * @returns code with mangled class names
+ */
+declare function mangleCodeClassesSync(code: string, mangleMap: Record<string, string>): string;
 declare const unplugin: UnpluginInstance<PartialCsszyxConfig, boolean>;
 /**
  * Creates a Vite plugin array with both pre-transform and post-mangle plugins.
@@ -30,4 +46,4 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { esbuildPlugin as e, rollupPlugin as r, unplugin as u, vitePlugin as v, webpackPlugin as w };
+export { esbuildPlugin as e, mangleCodeClassesSync as m, rollupPlugin as r, unplugin as u, vitePlugin as v, webpackPlugin as w };

package/dist/{unplugin-B9noIooS.d.ts → unplugin-DUbr5w-N.d.ts}

@@ -4,6 +4,22 @@ import { InputPluginOption } from 'rollup';
 import { UnpluginInstance, WebpackPluginInstance } from 'unplugin';
 import { PluginOption } from 'vite';
 
+/**
+ * Mangles class strings in bundled code (JS/HTML assets) using the given mangle map.
+ *
+ * Exported for unit testing; the plugin calls this via the thin private wrapper that
+ * supplies state.mangleMap.
+ *
+ * Pass 1:   Direct `className="..."` / `class="..."` static strings
+ * Pass 1.5: Template literal quasi (static) segments in `className:\`...\``
+ * Pass 2:   `className:EXPR` patterns with ternary operators containing quoted strings
+ * Pass 3:   Quoted string arguments to csszyx runtime helpers (_szMerge, _szIf, etc.)
+ *
+ * @param code     bundled source code
+ * @param mangleMap class-name → mangled-token mapping
+ * @returns code with mangled class names
+ */
+declare function mangleCodeClassesSync(code: string, mangleMap: Record<string, string>): string;
 declare const unplugin: UnpluginInstance<PartialCsszyxConfig, boolean>;
 /**
  * Creates a Vite plugin array with both pre-transform and post-mangle plugins.
@@ -30,4 +46,4 @@ declare const rollupPlugin: (options?: PartialCsszyxConfig) => InputPluginOption
  */
 declare const esbuildPlugin: (options?: PartialCsszyxConfig) => Plugin;
 
-export { esbuildPlugin as e, rollupPlugin as r, unplugin as u, vitePlugin as v, webpackPlugin as w };
+export { esbuildPlugin as e, mangleCodeClassesSync as m, rollupPlugin as r, unplugin as u, vitePlugin as v, webpackPlugin as w };