@csszyx/unplugin 0.9.0 → 0.9.1

package/dist/index.cjs

@@ -3,7 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const cssMangler = require('./css-mangler.cjs');
-const unplugin = require('./shared/unplugin.CL0F6RZa.cjs');
+const unplugin = require('./shared/unplugin.CFp386gH.cjs');
+const types = require('@csszyx/types');
 require('postcss');
 require('postcss-selector-parser');
 require('node:fs');
@@ -14,10 +15,11 @@ require('node:url');
 require('@csszyx/compiler');
 require('@csszyx/core');
 require('@csszyx/svelte-adapter');
-require('@csszyx/types');
 require('@csszyx/vue-adapter');
 require('unplugin');
 require('node:crypto');
+require('./shared/unplugin.DUxdYaSG.cjs');
+require('postcss-value-parser');
 
 
 
@@ -28,20 +30,35 @@ exports.mangleCSSSync = cssMangler.mangleCSSSync;
 exports.unescapeTailwindClass = cssMangler.unescapeTailwindClass;
 exports.assertNoRSCBoundaryViolation = unplugin.assertNoRSCBoundaryViolation;
 exports.assertNoRSCGraphViolation = unplugin.assertNoRSCGraphViolation;
+exports.createGlobalVarAliasValidationOptions = unplugin.createGlobalVarAliasValidationOptions;
+exports.createGlobalVarMapAssetSource = unplugin.createGlobalVarMapAssetSource;
+exports.createGlobalVarScanCacheKey = unplugin.createGlobalVarScanCacheKey;
 exports.createRSCModuleRecord = unplugin.createRSCModuleRecord;
 exports.default = unplugin.unplugin;
 exports.deleteRSCModuleRecord = unplugin.deleteRSCModuleRecord;
 exports.esbuildPlugin = unplugin.esbuildPlugin;
+exports.extractGlobalVarAliasesForManifest = unplugin.extractGlobalVarAliasesForManifest;
 exports.findRSCBoundaryViolation = unplugin.findRSCBoundaryViolation;
 exports.findRSCGraphViolation = unplugin.findRSCGraphViolation;
 exports.hasTokens = unplugin.hasTokens;
 exports.hasUseClientDirective = unplugin.hasUseClientDirective;
 exports.hasUseServerDirective = unplugin.hasUseServerDirective;
 exports.isRSCServerModule = unplugin.isRSCServerModule;
+exports.isTailwindReservedGlobalVar = unplugin.isTailwindReservedGlobalVar;
 exports.mangleCodeClassesSync = unplugin.mangleCodeClassesSync;
 exports.mergeThemes = unplugin.mergeThemes;
+exports.normalizeGlobalVarAliasesForCache = unplugin.normalizeGlobalVarAliasesForCache;
 exports.parseThemeBlocks = unplugin.parseThemeBlocks;
+exports.planGlobalVarAliases = unplugin.planGlobalVarAliases;
+exports.readGlobalVarScanCache = unplugin.readGlobalVarScanCache;
+exports.resolveGlobalVarScanCacheDir = unplugin.resolveGlobalVarScanCacheDir;
+exports.rewriteGlobalVarCssAliases = unplugin.rewriteGlobalVarCssAliases;
 exports.rollupPlugin = unplugin.rollupPlugin;
+exports.scanGlobalVarCss = unplugin.scanGlobalVarCss;
 exports.unplugin = unplugin.unplugin;
+exports.validateGlobalVarAliasInputs = unplugin.validateGlobalVarAliasInputs;
 exports.vitePlugin = unplugin.vitePlugin;
 exports.webpackPlugin = unplugin.webpackPlugin;
+exports.writeGlobalVarScanCache = unplugin.writeGlobalVarScanCache;
+exports.CSSZYX_GLOBAL_ALIAS_PREFIX = types.CSSZYX_GLOBAL_ALIAS_PREFIX;
+exports.TAILWIND_RESERVED_PREFIXES = types.TAILWIND_RESERVED_PREFIXES;

package/dist/index.d.cts

@@ -1,15 +1,101 @@
-import _default from './shared/unplugin.DUbr5w-N.cjs';
 export { CSSManglerOptions, CSSManglerResult, MangleMap, createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.cjs';
+export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
+import { G as GlobalVarScanCacheKeyInput, C as CssVarScanResult, S as ScanGlobalVarCssOptions, P as PlanGlobalVarAliasesInput, a as GlobalVarAliasPlan, R as RewriteGlobalVarCssAliasesOptions, b as GlobalVarCssAliasRewriteResult, c as CreateGlobalVarAliasValidationOptionsInput, V as ValidateGlobalVarAliasInputsOptions, d as GlobalVarAliasValidationResult } from './shared/unplugin.DLrBgECN.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';
+export = undefined;
+export { e as CssVarDefinition, f as CssVarLocation, g as CssVarReference, h as GlobalVarAliasDiagnostic, i as GlobalVarAliasDiagnosticSeverity, j as GlobalVarAliasEntry, k as GlobalVarCodeSource, l as GlobalVarCssAssetSource, m as GlobalVarCssSource, n as GlobalVarScanCacheEntry, o as createGlobalVarMapAssetSource, p as esbuildPlugin, q as extractGlobalVarAliasesForManifest, r as mangleCodeClassesSync, s as normalizeGlobalVarAliasesForCache, t as rollupPlugin, u as unplugin, v as vitePlugin, w as webpackPlugin } from './shared/unplugin.DLrBgECN.cjs';
 import 'postcss';
-import '@csszyx/types';
+import '@csszyx/compiler';
 import 'esbuild';
 import 'rollup';
 import 'unplugin';
 import 'vite';
 
+/**
+ * Resolves the global variable scan cache directory.
+ *
+ * @param cacheDir csszyx cache root.
+ * @returns Cache directory for Phase H CSS scans.
+ */
+declare function resolveGlobalVarScanCacheDir(cacheDir: string): string;
+/**
+ * Creates a cache key from file path, mtime, and content hash.
+ *
+ * @param input Cache key input.
+ * @returns Stable SHA-256 cache key.
+ */
+declare function createGlobalVarScanCacheKey(input: GlobalVarScanCacheKeyInput): string;
+/**
+ * Reads a cached global variable scan result when the key matches.
+ *
+ * @param cacheDir Global variable scan cache directory.
+ * @param key Expected cache key.
+ * @returns Cached scan result, or null on miss/corruption.
+ */
+declare function readGlobalVarScanCache(cacheDir: string, key: string): CssVarScanResult | null;
+/**
+ * Writes a global variable scan result cache entry.
+ *
+ * @param cacheDir Global variable scan cache directory.
+ * @param key Cache key.
+ * @param result Scan result to cache.
+ */
+declare function writeGlobalVarScanCache(cacheDir: string, key: string, result: CssVarScanResult): void;
+
+/**
+ * Scans one CSS source for custom-property definitions and var() references.
+ *
+ * @param css CSS source text.
+ * @param options Scan options.
+ * @returns Definitions, references, registrations, and ownership metadata.
+ */
+declare function scanGlobalVarCss(css: string, options?: ScanGlobalVarCssOptions): CssVarScanResult;
+
+/**
+ * Plans deterministic global aliases for explicit app-owned tokens.
+ *
+ * @param input Planner input.
+ * @returns Alias plan or fail-closed diagnostics.
+ */
+declare function planGlobalVarAliases(input: PlanGlobalVarAliasesInput): GlobalVarAliasPlan;
+/**
+ * Checks if a custom-property name is reserved by Tailwind v4.
+ *
+ * @param name Custom-property name.
+ * @returns true when the name is Tailwind-owned by namespace.
+ */
+declare function isTailwindReservedGlobalVar(name: string): boolean;
+
+/**
+ * Rewrites one CSS source with a validated global variable alias plan.
+ *
+ * This is intentionally pure M5 plumbing. It does not integrate with build
+ * hooks yet; callers must provide a fail-closed plan from `planGlobalVarAliases`.
+ *
+ * @param options Rewrite options.
+ * @returns Rewritten CSS and rewrite counters.
+ */
+declare function rewriteGlobalVarCssAliases(options: RewriteGlobalVarCssAliasesOptions): GlobalVarCssAliasRewriteResult;
+
+/**
+ * Runs the Phase H pure validation pipeline without mutating build output.
+ *
+ * @param options Validation input.
+ * @returns CSS scans, alias plan, and JS/JSX out-of-band diagnostics.
+ */
+declare function validateGlobalVarAliasInputs(options: ValidateGlobalVarAliasInputsOptions): GlobalVarAliasValidationResult;
+/**
+ * Builds validation options from bundler CSS assets and observed source files.
+ *
+ * This keeps production hook wiring deterministic: the same normalized CSS asset
+ * inventory can feed fail-closed validation before any CSS/TSX rewrite mutates
+ * output.
+ *
+ * @param input Bundler output and user global-var alias config fields.
+ * @returns Normalized validation options.
+ */
+declare function createGlobalVarAliasValidationOptions(input: CreateGlobalVarAliasValidationOptionsInput): ValidateGlobalVarAliasInputsOptions;
+
 /**
  * Direct RSC boundary violation found in a transformed module.
  */
@@ -162,5 +248,5 @@ declare function mergeThemes(themes: ParsedTheme[]): ParsedTheme;
  */
 declare function hasTokens(theme: ParsedTheme): boolean;
 
-export { assertNoRSCBoundaryViolation, assertNoRSCGraphViolation, createRSCModuleRecord, deleteRSCModuleRecord, findRSCBoundaryViolation, findRSCGraphViolation, hasTokens, hasUseClientDirective, hasUseServerDirective, isRSCServerModule, mergeThemes, parseThemeBlocks };
+export { CreateGlobalVarAliasValidationOptionsInput, CssVarScanResult, GlobalVarAliasPlan, GlobalVarAliasValidationResult, GlobalVarCssAliasRewriteResult, GlobalVarScanCacheKeyInput, PlanGlobalVarAliasesInput, RewriteGlobalVarCssAliasesOptions, ScanGlobalVarCssOptions, ValidateGlobalVarAliasInputsOptions, assertNoRSCBoundaryViolation, assertNoRSCGraphViolation, createGlobalVarAliasValidationOptions, createGlobalVarScanCacheKey, createRSCModuleRecord, deleteRSCModuleRecord, findRSCBoundaryViolation, findRSCGraphViolation, hasTokens, hasUseClientDirective, hasUseServerDirective, isRSCServerModule, isTailwindReservedGlobalVar, mergeThemes, parseThemeBlocks, planGlobalVarAliases, readGlobalVarScanCache, resolveGlobalVarScanCacheDir, rewriteGlobalVarCssAliases, scanGlobalVarCss, validateGlobalVarAliasInputs, writeGlobalVarScanCache };
 export type { ParsedTheme, RSCBoundaryViolation, RSCModuleRecord };

package/dist/index.d.mts

@@ -1,12 +1,99 @@
 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';
+export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
+import { G as GlobalVarScanCacheKeyInput, C as CssVarScanResult, S as ScanGlobalVarCssOptions, P as PlanGlobalVarAliasesInput, a as GlobalVarAliasPlan, R as RewriteGlobalVarCssAliasesOptions, b as GlobalVarCssAliasRewriteResult, c as CreateGlobalVarAliasValidationOptionsInput, V as ValidateGlobalVarAliasInputsOptions, d as GlobalVarAliasValidationResult } from './shared/unplugin.DLrBgECN.mjs';
+export { e as CssVarDefinition, f as CssVarLocation, g as CssVarReference, h as GlobalVarAliasDiagnostic, i as GlobalVarAliasDiagnosticSeverity, j as GlobalVarAliasEntry, k as GlobalVarCodeSource, l as GlobalVarCssAssetSource, m as GlobalVarCssSource, n as GlobalVarScanCacheEntry, o as createGlobalVarMapAssetSource, u as default, p as esbuildPlugin, q as extractGlobalVarAliasesForManifest, r as mangleCodeClassesSync, s as normalizeGlobalVarAliasesForCache, t as rollupPlugin, u as unplugin, v as vitePlugin, w as webpackPlugin } from './shared/unplugin.DLrBgECN.mjs';
 import 'postcss';
-import '@csszyx/types';
+import '@csszyx/compiler';
 import 'esbuild';
 import 'rollup';
 import 'unplugin';
 import 'vite';
 
+/**
+ * Resolves the global variable scan cache directory.
+ *
+ * @param cacheDir csszyx cache root.
+ * @returns Cache directory for Phase H CSS scans.
+ */
+declare function resolveGlobalVarScanCacheDir(cacheDir: string): string;
+/**
+ * Creates a cache key from file path, mtime, and content hash.
+ *
+ * @param input Cache key input.
+ * @returns Stable SHA-256 cache key.
+ */
+declare function createGlobalVarScanCacheKey(input: GlobalVarScanCacheKeyInput): string;
+/**
+ * Reads a cached global variable scan result when the key matches.
+ *
+ * @param cacheDir Global variable scan cache directory.
+ * @param key Expected cache key.
+ * @returns Cached scan result, or null on miss/corruption.
+ */
+declare function readGlobalVarScanCache(cacheDir: string, key: string): CssVarScanResult | null;
+/**
+ * Writes a global variable scan result cache entry.
+ *
+ * @param cacheDir Global variable scan cache directory.
+ * @param key Cache key.
+ * @param result Scan result to cache.
+ */
+declare function writeGlobalVarScanCache(cacheDir: string, key: string, result: CssVarScanResult): void;
+
+/**
+ * Scans one CSS source for custom-property definitions and var() references.
+ *
+ * @param css CSS source text.
+ * @param options Scan options.
+ * @returns Definitions, references, registrations, and ownership metadata.
+ */
+declare function scanGlobalVarCss(css: string, options?: ScanGlobalVarCssOptions): CssVarScanResult;
+
+/**
+ * Plans deterministic global aliases for explicit app-owned tokens.
+ *
+ * @param input Planner input.
+ * @returns Alias plan or fail-closed diagnostics.
+ */
+declare function planGlobalVarAliases(input: PlanGlobalVarAliasesInput): GlobalVarAliasPlan;
+/**
+ * Checks if a custom-property name is reserved by Tailwind v4.
+ *
+ * @param name Custom-property name.
+ * @returns true when the name is Tailwind-owned by namespace.
+ */
+declare function isTailwindReservedGlobalVar(name: string): boolean;
+
+/**
+ * Rewrites one CSS source with a validated global variable alias plan.
+ *
+ * This is intentionally pure M5 plumbing. It does not integrate with build
+ * hooks yet; callers must provide a fail-closed plan from `planGlobalVarAliases`.
+ *
+ * @param options Rewrite options.
+ * @returns Rewritten CSS and rewrite counters.
+ */
+declare function rewriteGlobalVarCssAliases(options: RewriteGlobalVarCssAliasesOptions): GlobalVarCssAliasRewriteResult;
+
+/**
+ * Runs the Phase H pure validation pipeline without mutating build output.
+ *
+ * @param options Validation input.
+ * @returns CSS scans, alias plan, and JS/JSX out-of-band diagnostics.
+ */
+declare function validateGlobalVarAliasInputs(options: ValidateGlobalVarAliasInputsOptions): GlobalVarAliasValidationResult;
+/**
+ * Builds validation options from bundler CSS assets and observed source files.
+ *
+ * This keeps production hook wiring deterministic: the same normalized CSS asset
+ * inventory can feed fail-closed validation before any CSS/TSX rewrite mutates
+ * output.
+ *
+ * @param input Bundler output and user global-var alias config fields.
+ * @returns Normalized validation options.
+ */
+declare function createGlobalVarAliasValidationOptions(input: CreateGlobalVarAliasValidationOptionsInput): ValidateGlobalVarAliasInputsOptions;
+
 /**
  * Direct RSC boundary violation found in a transformed module.
  */
@@ -159,5 +246,5 @@ declare function mergeThemes(themes: ParsedTheme[]): ParsedTheme;
  */
 declare function hasTokens(theme: ParsedTheme): boolean;
 
-export { assertNoRSCBoundaryViolation, assertNoRSCGraphViolation, createRSCModuleRecord, deleteRSCModuleRecord, findRSCBoundaryViolation, findRSCGraphViolation, hasTokens, hasUseClientDirective, hasUseServerDirective, isRSCServerModule, mergeThemes, parseThemeBlocks };
+export { CreateGlobalVarAliasValidationOptionsInput, CssVarScanResult, GlobalVarAliasPlan, GlobalVarAliasValidationResult, GlobalVarCssAliasRewriteResult, GlobalVarScanCacheKeyInput, PlanGlobalVarAliasesInput, RewriteGlobalVarCssAliasesOptions, ScanGlobalVarCssOptions, ValidateGlobalVarAliasInputsOptions, assertNoRSCBoundaryViolation, assertNoRSCGraphViolation, createGlobalVarAliasValidationOptions, createGlobalVarScanCacheKey, createRSCModuleRecord, deleteRSCModuleRecord, findRSCBoundaryViolation, findRSCGraphViolation, hasTokens, hasUseClientDirective, hasUseServerDirective, isRSCServerModule, isTailwindReservedGlobalVar, mergeThemes, parseThemeBlocks, planGlobalVarAliases, readGlobalVarScanCache, resolveGlobalVarScanCacheDir, rewriteGlobalVarCssAliases, scanGlobalVarCss, validateGlobalVarAliasInputs, writeGlobalVarScanCache };
 export type { ParsedTheme, RSCBoundaryViolation, RSCModuleRecord };

package/dist/index.mjs

@@ -1,5 +1,6 @@
 export { createPostCSSPlugin, escapeCSSClassName, mangleCSS, mangleCSSSync, unescapeTailwindClass } from './css-mangler.mjs';
-export { a as assertNoRSCBoundaryViolation, b as assertNoRSCGraphViolation, c as createRSCModuleRecord, u as default, d as deleteRSCModuleRecord, e as esbuildPlugin, f as findRSCBoundaryViolation, g as findRSCGraphViolation, h as hasTokens, i as hasUseClientDirective, j as hasUseServerDirective, k as isRSCServerModule, m as mangleCodeClassesSync, l as mergeThemes, p as parseThemeBlocks, r as rollupPlugin, u as unplugin, v as vitePlugin, w as webpackPlugin } from './shared/unplugin.BEOG6ePC.mjs';
+export { a as assertNoRSCBoundaryViolation, b as assertNoRSCGraphViolation, c as createGlobalVarAliasValidationOptions, d as createGlobalVarMapAssetSource, e as createGlobalVarScanCacheKey, f as createRSCModuleRecord, u as default, g as deleteRSCModuleRecord, h as esbuildPlugin, i as extractGlobalVarAliasesForManifest, j as findRSCBoundaryViolation, k as findRSCGraphViolation, l as hasTokens, m as hasUseClientDirective, n as hasUseServerDirective, o as isRSCServerModule, p as isTailwindReservedGlobalVar, q as mangleCodeClassesSync, r as mergeThemes, s as normalizeGlobalVarAliasesForCache, t as parseThemeBlocks, v as planGlobalVarAliases, w as readGlobalVarScanCache, x as resolveGlobalVarScanCacheDir, y as rewriteGlobalVarCssAliases, z as rollupPlugin, A as scanGlobalVarCss, u as unplugin, B as validateGlobalVarAliasInputs, C as vitePlugin, D as webpackPlugin, E as writeGlobalVarScanCache } from './shared/unplugin.BbtspS8t.mjs';
+export { CSSZYX_GLOBAL_ALIAS_PREFIX, TAILWIND_RESERVED_PREFIXES } from '@csszyx/types';
 import 'postcss';
 import 'postcss-selector-parser';
 import 'node:fs';
@@ -10,7 +11,8 @@ import 'node:url';
 import '@csszyx/compiler';
 import '@csszyx/core';
 import '@csszyx/svelte-adapter';
-import '@csszyx/types';
 import '@csszyx/vue-adapter';
 import 'unplugin';
 import 'node:crypto';
+import './shared/unplugin.BceVw1eW.mjs';
+import 'postcss-value-parser';

package/dist/next-prebuild.cjs

@@ -0,0 +1,148 @@
+'use strict';
+
+const node_crypto = require('node:crypto');
+const fs = require('node:fs');
+const path = require('node:path');
+const nextTransformMetadata = require('./shared/unplugin.B_U4rZvG.cjs');
+const nextWatcherCycle = require('./shared/unplugin.s62yJbu1.cjs');
+const transformCache = require('./shared/unplugin.DUxdYaSG.cjs');
+require('@csszyx/compiler');
+require('node:os');
+require('proper-lockfile');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopNamespaceCompat(e) {
+    if (e && typeof e === 'object' && 'default' in e) return e;
+    const n = Object.create(null);
+    if (e) {
+        for (const k in e) {
+            n[k] = e[k];
+        }
+    }
+    n.default = e;
+    return n;
+}
+
+const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
+
+function runNextPrebuild(options) {
+  assertProductionManglingBoundary(options);
+  const csszyxVersion = options.csszyxVersion ?? nextTransformMetadata.readPackageVersion("../package.json", (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('next-prebuild.cjs', document.baseURI).href)));
+  const compilerVersion = options.compilerVersion ?? nextTransformMetadata.readPackageVersion("../../compiler/package.json", (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('next-prebuild.cjs', document.baseURI).href)));
+  const nativeVersion = options.nativeVersion ?? compilerVersion;
+  const nextVersion = options.nextVersion ?? "unknown-next";
+  const context = nextWatcherCycle.createNextStateContext({
+    explicitRoot: options.explicitRoot,
+    loaderRootContext: options.loaderRootContext,
+    loaderContext: options.loaderContext,
+    cwd: options.cwd,
+    cacheDir: options.cacheDir,
+    safelistOutputFile: options.safelistOutputFile,
+    config: options.config ?? {},
+    env: options.env ?? process.env,
+    envKeys: options.envKeys,
+    nextVersion,
+    csszyxVersion,
+    nativeVersion,
+    mode: options.mode ?? "production"
+  });
+  const cacheRoot = transformCache.resolveTransformCacheDir(
+    context.root,
+    path__namespace.relative(context.root, context.cacheDir)
+  );
+  const files = [];
+  let scannedCount = 0;
+  let transformedCount = 0;
+  let skippedMissingCount = 0;
+  for (const filename of uniqueFiles(options.files)) {
+    scannedCount++;
+    if (!fs.existsSync(filename)) {
+      skippedMissingCount++;
+      continue;
+    }
+    const source = fs.readFileSync(filename, "utf8");
+    const transform = nextTransformMetadata.transformNextSource({
+      source,
+      filename,
+      parserMode: options.parserMode ?? "rust",
+      compilerOptions: options.compilerOptions,
+      cacheRoot,
+      pluginVersion: csszyxVersion,
+      compilerVersion,
+      astBudget: options.astBudget,
+      allowBabelFallback: options.allowBabelFallback
+    });
+    const metadata = nextTransformMetadata.collectNextTransformMetadata(transform.result, source, filename);
+    transformedCount++;
+    const shardResult = nextWatcherCycle.writeNextSafelistShard(
+      context.safelist.shardsDir,
+      nextTransformMetadata.createNextSafelistShardFromMetadata(metadata, createShardCacheKey(context, metadata)),
+      options.writeOptions
+    );
+    files.push({
+      filename,
+      shardPath: shardResult.filePath,
+      classCount: metadata.classes.length,
+      cacheStatus: transform.cacheStatus,
+      producer: transform.producer
+    });
+  }
+  const cycle = nextWatcherCycle.runNextWatcherCycle(context, {
+    writeOptions: options.writeOptions,
+    lockOptions: {
+      root: context.root,
+      mode: context.manifestExpectation.mode,
+      command: "csszyx next prebuild"
+    },
+    createdAt: options.createdAt
+  });
+  return {
+    context,
+    scannedCount,
+    transformedCount,
+    skippedMissingCount,
+    classCount: cycle.materialize.classCount,
+    sourceCount: cycle.materialize.sourceCount,
+    manifestPath: context.manifestPath,
+    safelistOutputPath: context.safelist.outputPath,
+    files,
+    cycle
+  };
+}
+function assertProductionManglingBoundary(options) {
+  if (options.allowProductionMangling) {
+    return;
+  }
+  if ((options.mode ?? "production") !== "production") {
+    return;
+  }
+  if (options.compilerOptions?.mangleVars === true || hasEnabledMangleVars(options.config)) {
+    throw new Error(
+      "[csszyx] Next prebuild does not support production CSS variable mangling. Use Next Webpack mode for full csszyx parity."
+    );
+  }
+}
+function hasEnabledMangleVars(config) {
+  if (config === null || typeof config !== "object" || Array.isArray(config)) {
+    return false;
+  }
+  return config.mangleVars === true;
+}
+function uniqueFiles(files) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const file of files) {
+    const resolved = path__namespace.resolve(file);
+    if (seen.has(resolved)) {
+      continue;
+    }
+    seen.add(resolved);
+    result.push(resolved);
+  }
+  return result;
+}
+function createShardCacheKey(context, metadata) {
+  return node_crypto.createHash("sha256").update(context.identity.generation).update("\0").update(path__namespace.relative(context.root, metadata.sourcePath).replace(/\\/g, "/")).digest("hex");
+}
+
+exports.runNextPrebuild = runNextPrebuild;

package/dist/next-prebuild.d.cts

@@ -0,0 +1,66 @@
+import { TransformSourceCodeOptions } from '@csszyx/compiler';
+import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.CPEWNSA0.cjs';
+import { a as NextSourceTransformOutput, N as NextSourceParserMode } from './shared/unplugin.CScQRdTp.cjs';
+import { N as NextWatcherCycleResult } from './shared/unplugin.xeED_qwh.cjs';
+
+/** Serializable options accepted by the Next Turbopack csszyx prebuild core. */
+interface NextPrebuildOptions {
+    files: readonly string[];
+    explicitRoot?: string;
+    loaderRootContext?: string;
+    loaderContext?: string;
+    cwd?: string;
+    cacheDir?: string;
+    safelistOutputFile?: string;
+    parserMode?: NextSourceParserMode;
+    compilerOptions?: TransformSourceCodeOptions;
+    config?: JsonLike;
+    env?: Record<string, string | undefined>;
+    envKeys?: readonly string[];
+    nextVersion?: string;
+    csszyxVersion?: string;
+    compilerVersion?: string;
+    nativeVersion?: string;
+    mode?: 'development' | 'production';
+    astBudget?: number;
+    allowBabelFallback?: boolean;
+    allowProductionMangling?: boolean;
+    writeOptions?: AtomicWriteOptions;
+    createdAt?: string;
+}
+/** Per-file result captured by one prebuild pass. */
+interface NextPrebuildFileResult {
+    filename: string;
+    shardPath: string | null;
+    classCount: number;
+    cacheStatus: NextSourceTransformOutput['cacheStatus'];
+    producer: NextSourceTransformOutput['producer'];
+}
+/** Aggregated result returned by `runNextPrebuild`. */
+interface NextPrebuildResult {
+    context: NextStateContext;
+    scannedCount: number;
+    transformedCount: number;
+    skippedMissingCount: number;
+    classCount: number;
+    sourceCount: number;
+    manifestPath: string;
+    safelistOutputPath: string;
+    files: NextPrebuildFileResult[];
+    cycle: NextWatcherCycleResult;
+}
+/**
+ * Run one synchronous Next Turbopack csszyx prebuild pass.
+ *
+ * The prebuild walks an explicit file list, reuses the same state, transform,
+ * metadata, shard, and materialization contract as the loader, and finalizes
+ * the canonical Tailwind safelist plus a completed generation manifest. It
+ * intentionally does not own glob/chokidar dependencies or a CLI surface yet.
+ *
+ * @param options Prebuild input options.
+ * @returns Summary covering scanned/transformed counts and materialization paths.
+ */
+declare function runNextPrebuild(options: NextPrebuildOptions): NextPrebuildResult;
+
+export { runNextPrebuild };
+export type { NextPrebuildFileResult, NextPrebuildOptions, NextPrebuildResult };

package/dist/next-prebuild.d.mts

@@ -0,0 +1,66 @@
+import { TransformSourceCodeOptions } from '@csszyx/compiler';
+import { J as JsonLike, A as AtomicWriteOptions, N as NextStateContext } from './shared/unplugin.CPEWNSA0.mjs';
+import { a as NextSourceTransformOutput, N as NextSourceParserMode } from './shared/unplugin.CScQRdTp.mjs';
+import { N as NextWatcherCycleResult } from './shared/unplugin.CdZxp0x-.mjs';
+
+/** Serializable options accepted by the Next Turbopack csszyx prebuild core. */
+interface NextPrebuildOptions {
+    files: readonly string[];
+    explicitRoot?: string;
+    loaderRootContext?: string;
+    loaderContext?: string;
+    cwd?: string;
+    cacheDir?: string;
+    safelistOutputFile?: string;
+    parserMode?: NextSourceParserMode;
+    compilerOptions?: TransformSourceCodeOptions;
+    config?: JsonLike;
+    env?: Record<string, string | undefined>;
+    envKeys?: readonly string[];
+    nextVersion?: string;
+    csszyxVersion?: string;
+    compilerVersion?: string;
+    nativeVersion?: string;
+    mode?: 'development' | 'production';
+    astBudget?: number;
+    allowBabelFallback?: boolean;
+    allowProductionMangling?: boolean;
+    writeOptions?: AtomicWriteOptions;
+    createdAt?: string;
+}
+/** Per-file result captured by one prebuild pass. */
+interface NextPrebuildFileResult {
+    filename: string;
+    shardPath: string | null;
+    classCount: number;
+    cacheStatus: NextSourceTransformOutput['cacheStatus'];
+    producer: NextSourceTransformOutput['producer'];
+}
+/** Aggregated result returned by `runNextPrebuild`. */
+interface NextPrebuildResult {
+    context: NextStateContext;
+    scannedCount: number;
+    transformedCount: number;
+    skippedMissingCount: number;
+    classCount: number;
+    sourceCount: number;
+    manifestPath: string;
+    safelistOutputPath: string;
+    files: NextPrebuildFileResult[];
+    cycle: NextWatcherCycleResult;
+}
+/**
+ * Run one synchronous Next Turbopack csszyx prebuild pass.
+ *
+ * The prebuild walks an explicit file list, reuses the same state, transform,
+ * metadata, shard, and materialization contract as the loader, and finalizes
+ * the canonical Tailwind safelist plus a completed generation manifest. It
+ * intentionally does not own glob/chokidar dependencies or a CLI surface yet.
+ *
+ * @param options Prebuild input options.
+ * @returns Summary covering scanned/transformed counts and materialization paths.
+ */
+declare function runNextPrebuild(options: NextPrebuildOptions): NextPrebuildResult;
+
+export { runNextPrebuild };
+export type { NextPrebuildFileResult, NextPrebuildOptions, NextPrebuildResult };