vinext 0.1.1 → 0.1.3

package/dist/plugins/optimize-imports.js

@@ -1,3 +1,5 @@
+import { normalizePathSeparators } from "../utils/path.js";
+import { escapeRegExp } from "../utils/regex.js";
 import { getAstName } from "./ast-utils.js";
 import { createRequire } from "node:module";
 import path from "node:path";
@@ -99,6 +101,12 @@ const DEFAULT_OPTIMIZE_PACKAGES = [
 	"react-icons/wi",
 	"radix-ui"
 ];
+function createOptimizedImportSourceMatcher(packages) {
+	const pattern = [...packages].map(escapeRegExp).join("|");
+	if (!pattern) return () => false;
+	const importFromPattern = new RegExp(String.raw`(?:^|[;}\n\r])\s*import(?!\s*\()(?:(?!\bfrom\b)[\s\S])*?\bfrom\s*["'](?:${pattern})["']`, "m");
+	return (code) => code.includes("import") && code.includes("from") && importFromPattern.test(code);
+}
 /**
 * Resolve a package.json exports value to a string entry path.
 * Prefers node → import → module → default conditions, recursing into nested objects.
@@ -185,12 +193,12 @@ async function resolvePackageEntry(packageName, projectRoot, preferReactServer)
 			const dotExport = pkgJson.exports["."];
 			if (dotExport) {
 				const entryPath = resolveExportsValue(dotExport, preferReactServer);
-				if (entryPath) return path.resolve(pkgDir, entryPath).split(path.sep).join("/");
+				if (entryPath) return normalizePathSeparators(path.resolve(pkgDir, entryPath));
 			}
 		}
 		const entryField = pkgJson.module ?? pkgJson.main;
-		if (typeof entryField === "string") return path.resolve(pkgDir, entryField).split(path.sep).join("/");
-		return createRequire(path.join(projectRoot, "package.json")).resolve(packageName).split(path.sep).join("/");
+		if (typeof entryField === "string") return normalizePathSeparators(path.resolve(pkgDir, entryField));
+		return normalizePathSeparators(createRequire(path.join(projectRoot, "package.json")).resolve(packageName));
 	} catch {
 		return null;
 	}
@@ -228,14 +236,14 @@ async function buildExportMapFromFile(filePath, readFile, cache, visited, initia
 	const exportMap = /* @__PURE__ */ new Map();
 	const importBindings = /* @__PURE__ */ new Map();
 	const localDeclarations = /* @__PURE__ */ new Set();
-	const fileDir = path.dirname(filePath);
+	const fileDir = path.posix.dirname(filePath);
 	/**
 	* Normalize a source specifier: resolve relative paths to absolute so that
 	* entries in the export map always store absolute paths for file references.
 	* Bare package specifiers (e.g. "@radix-ui/react-slot") are returned unchanged.
 	*/
 	function normalizeSource(source) {
-		return source.startsWith(".") ? path.resolve(fileDir, source).split(path.sep).join("/") : source;
+		return source.startsWith(".") ? path.posix.join(fileDir, source) : source;
 	}
 	function recordLocalDeclaration(node) {
 		if (!node) return;
@@ -297,7 +305,7 @@ async function buildExportMapFromFile(filePath, readFile, cache, visited, initia
 					isNamespace: true
 				});
 			} else if (rawSource.startsWith(".")) {
-				const subPath = path.resolve(fileDir, rawSource).split(path.sep).join("/");
+				const subPath = path.posix.join(fileDir, rawSource);
 				const candidates = [
 					subPath,
 					`${subPath}.js`,
@@ -386,12 +394,15 @@ async function buildExportMapFromFile(filePath, readFile, cache, visited, initia
 * Handles: `export * as X from`, `export { A } from`, `import * as X; export { X }`,
 * and `export * from "./sub"` (recursively resolves wildcard re-exports).
 *
-* Returns null if the entry cannot be resolved, the file cannot be read, or
-* the file has a parse error. Returns an empty map if the file is valid but
-* exports nothing.
+* Returns null if `entryPath` is empty, the file cannot be read, or the file
+* has a parse error. Returns an empty map if the file is valid but exports
+* nothing.
+*
+* @param entryPath - Pre-resolved absolute path to the barrel entry file (the
+*   caller owns entry resolution + its caching), or null when it could not be
+*   resolved.
 */
-async function buildBarrelExportMap(packageName, resolveEntry, readFile, cache) {
-	const entryPath = resolveEntry(packageName);
+async function buildBarrelExportMap(entryPath, readFile, cache) {
 	if (!entryPath) return null;
 	const exportMapCache = cache ?? /* @__PURE__ */ new Map();
 	const cached = exportMapCache.get(entryPath);
@@ -413,14 +424,14 @@ function createOptimizeImportsPlugin(getNextConfig, getRoot) {
 	};
 	const entryPathCache = /* @__PURE__ */ new Map();
 	let optimizedPackages = /* @__PURE__ */ new Set();
-	let quotedPackages = [];
+	let hasOptimizedImportSource = () => false;
 	const registeredBarrels = /* @__PURE__ */ new Set();
 	return {
 		name: "vinext:optimize-imports",
 		buildStart() {
 			const nextConfig = getNextConfig();
 			optimizedPackages = new Set([...DEFAULT_OPTIMIZE_PACKAGES, ...nextConfig?.optimizePackageImports ?? []]);
-			quotedPackages = [...optimizedPackages].flatMap((pkg) => [`"${pkg}"`, `'${pkg}'`]);
+			hasOptimizedImportSource = createOptimizedImportSourceMatcher(optimizedPackages);
 			entryPathCache.clear();
 			barrelCaches.exportMapCache.clear();
 			barrelCaches.subpkgOrigin.clear();
@@ -441,12 +452,7 @@ function createOptimizeImportsPlugin(getNextConfig, getRoot) {
 				const preferReactServer = env?.name === "rsc";
 				if (id.startsWith("\0")) return null;
 				const packages = optimizedPackages;
-				let hasBarrelImport = false;
-				for (const quoted of quotedPackages) if (code.includes(quoted)) {
-					hasBarrelImport = true;
-					break;
-				}
-				if (!hasBarrelImport) return null;
+				if (!hasOptimizedImportSource(code)) return null;
 				let ast;
 				try {
 					ast = parseAst(code);
@@ -466,7 +472,7 @@ function createOptimizeImportsPlugin(getNextConfig, getRoot) {
 						barrelEntry = await resolvePackageEntry(importSource, root, preferReactServer);
 						entryPathCache.set(cacheKey, barrelEntry ?? null);
 					}
-					const exportMap = await buildBarrelExportMap(importSource, () => barrelEntry ?? null, readFileSafe, barrelCaches.exportMapCache);
+					const exportMap = await buildBarrelExportMap(barrelEntry, readFileSafe, barrelCaches.exportMapCache);
 					if (!exportMap || !barrelEntry) continue;
 					const envKey = preferReactServer ? "rsc" : "ssr";
 					const registeredKey = `${envKey}:${barrelEntry}`;
@@ -572,4 +578,4 @@ function createOptimizeImportsPlugin(getNextConfig, getRoot) {
 	};
 }
 //#endregion
-export { DEFAULT_OPTIMIZE_PACKAGES, buildBarrelExportMap, createOptimizeImportsPlugin };
+export { DEFAULT_OPTIMIZE_PACKAGES, buildBarrelExportMap, createOptimizeImportsPlugin, createOptimizedImportSourceMatcher };

package/dist/plugins/postcss.js

@@ -1,8 +1,11 @@
+import { importExportWithCommonJsFallback } from "../utils/commonjs-loader.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
 import path from "node:path";
-import { pathToFileURL } from "node:url";
 //#region src/plugins/postcss.ts
+async function loadPluginExport(resolvedPath) {
+	return importExportWithCommonJsFallback(resolvedPath);
+}
 /**
 * PostCSS config file names to search for, in priority order.
 * Matches the same search order as postcss-load-config / lilconfig.
@@ -65,8 +68,7 @@ async function resolvePostcssStringPluginsUncached(projectRoot) {
 		if (configPath.endsWith(".postcssrc")) {
 			if (fs.readFileSync(configPath, "utf-8").trim().startsWith("{")) return;
 		}
-		const mod = await import(pathToFileURL(configPath).href);
-		config = mod.default ?? mod;
+		config = await importExportWithCommonJsFallback(configPath);
 	} catch {
 		return;
 	}
@@ -76,14 +78,12 @@ async function resolvePostcssStringPluginsUncached(projectRoot) {
 	try {
 		return { plugins: await Promise.all(config.plugins.filter(Boolean).map(async (plugin) => {
 			if (typeof plugin === "string") {
-				const mod = await import(pathToFileURL(req.resolve(plugin)).href);
-				const fn = mod.default ?? mod;
+				const fn = await loadPluginExport(req.resolve(plugin));
 				return typeof fn === "function" ? fn() : fn;
 			}
 			if (Array.isArray(plugin) && typeof plugin[0] === "string") {
 				const [name, options] = plugin;
-				const mod = await import(pathToFileURL(req.resolve(name)).href);
-				const fn = mod.default ?? mod;
+				const fn = await loadPluginExport(req.resolve(name));
 				return typeof fn === "function" ? fn(options) : fn;
 			}
 			return plugin;

package/dist/plugins/sass.d.ts

@@ -1,33 +1,62 @@
+import { ResolvedConfig } from "vite";
+
 //#region src/plugins/sass.d.ts
-/**
- * Map a Next.js `sassOptions` object onto Vite's
- * `css.preprocessorOptions.scss` / `.sass` shape.
- *
- * Next.js (webpack + sass-loader) accepts:
- * - `additionalData` (or legacy `prependData`) — prepended to every source
- * - `includePaths` — directories searched by `@import`
- * - `loadPaths`    — modern Sass equivalent of `includePaths`
- * - `implementation` — Sass implementation package name (e.g. `sass-embedded`)
- * - other Sass options that get forwarded as-is
- *
- * Reference (Next.js source — destructures the same keys before forwarding
- * the rest to sass-loader):
- *   .nextjs-ref/packages/next/src/build/webpack/config/blocks/css/index.ts#L150-L180
- *   https://github.com/vercel/next.js/blob/canary/packages/next/src/build/webpack/config/blocks/css/index.ts
- *
- * Vite expects:
- * - `additionalData` (string or function) on the preprocessor options
- * - modern Sass options (`loadPaths`, `importers`, `implementation`, …)
- *   flattened next to `additionalData`
- *
- * @see https://vite.dev/config/shared-options.html#css-preprocessoroptions
- */
 type AdditionalData = string | ((source: string, filename: string) => string | Promise<string>);
 type VitePreprocessorOptions = {
   additionalData?: AdditionalData;
   loadPaths?: string[];
   [key: string]: any;
 };
+/**
+ * Create a Sass `FileImporter` that resolves webpack-style tilde (`~`) imports.
+ *
+ * Next.js (via sass-loader's `webpackImporter`) supports two tilde forms:
+ *
+ * 1. `~pkg/path` — resolves `pkg/path` from `node_modules`. Used for
+ *    third-party SCSS/CSS, e.g. `@import '~nprogress/nprogress.css'`.
+ *
+ * 2. `~/path` — resolves relative to the **project root** (the `~` acts as
+ *    an alias for the root). Used with Turbopack's `resolveAlias: { '~*': '*' }`
+ *    convention, e.g. `@use '~/styles/variables' as *`.
+ *
+ * Vite's built-in Sass resolver does not strip the `~` prefix, so any SCSS
+ * that uses tilde imports fails with "Can't find stylesheet to import" errors.
+ * This `FileImporter` runs before Vite's internal importer (added at the end
+ * of `importers[]` in the vite:css plugin) and canonicalises tilde URLs so
+ * Sass can load them from the filesystem.
+ *
+ * The returned object implements the modern Sass `FileImporter` interface:
+ * `findFileUrl` returns a `file://` URL and Sass automatically handles partial
+ * resolution (`_variables.scss` for `variables`), index files, and extensions.
+ *
+ * @param root - Absolute path to the Vite project root (used as the base for
+ *   `~/path` resolution and for locating `node_modules`).
+ */
+declare function createSassTildeImporter(root: string): {
+  findFileUrl(url: string): URL | null;
+};
 declare function buildSassPreprocessorOptions(sassOptions: Record<string, unknown> | null | undefined): VitePreprocessorOptions | undefined;
+/**
+ * Create a per-build binding of {@link SassAwareFileSystemLoader}.
+ *
+ * Returns:
+ * - `Loader` — a class to inject as postcss-modules' `css.modules.Loader`
+ *   option. postcss-modules instantiates it with the fixed
+ *   `(root, plugins, fileResolve)` signature, so the resolved Vite config is
+ *   captured in this factory's closure rather than passed to the constructor.
+ * - `setResolvedConfig` — called from vinext's `configResolved` hook to bind
+ *   that build's resolved config.
+ *
+ * One binding is created per vinext plugin instance, so concurrent or
+ * back-to-back builds in a single process never observe another build's
+ * config (root, sass options, `generateScopedName`, logger, …).
+ */
+declare function createSassAwareFileSystemLoader(): {
+  Loader: new (root: string, plugins: unknown[], fileResolve?: (newPath: string, relativeTo: string) => Promise<string>) => {
+    fetch(newPath: string, relativeTo: string, trace?: string): Promise<Record<string, string>>;
+    readonly finalSource: string;
+  };
+  setResolvedConfig: (config: ResolvedConfig) => void;
+};
 //#endregion
-export { buildSassPreprocessorOptions };
+export { buildSassPreprocessorOptions, createSassAwareFileSystemLoader, createSassTildeImporter };

package/dist/plugins/sass.js

@@ -1,4 +1,80 @@
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+import { preprocessCSS } from "vite";
+import { pathToFileURL } from "node:url";
 //#region src/plugins/sass.ts
+/**
+* Map a Next.js `sassOptions` object onto Vite's
+* `css.preprocessorOptions.scss` / `.sass` shape.
+*
+* Next.js (webpack + sass-loader) accepts:
+* - `additionalData` (or legacy `prependData`) — prepended to every source
+* - `includePaths` — directories searched by `@import`
+* - `loadPaths`    — modern Sass equivalent of `includePaths`
+* - `implementation` — Sass implementation package name (e.g. `sass-embedded`)
+* - other Sass options that get forwarded as-is
+*
+* Reference (Next.js source — destructures the same keys before forwarding
+* the rest to sass-loader):
+*   .nextjs-ref/packages/next/src/build/webpack/config/blocks/css/index.ts#L150-L180
+*   https://github.com/vercel/next.js/blob/canary/packages/next/src/build/webpack/config/blocks/css/index.ts
+*
+* Vite expects:
+* - `additionalData` (string or function) on the preprocessor options
+* - modern Sass options (`loadPaths`, `importers`, `implementation`, …)
+*   flattened next to `additionalData`
+*
+* @see https://vite.dev/config/shared-options.html#css-preprocessoroptions
+*/
+/**
+* Create a Sass `FileImporter` that resolves webpack-style tilde (`~`) imports.
+*
+* Next.js (via sass-loader's `webpackImporter`) supports two tilde forms:
+*
+* 1. `~pkg/path` — resolves `pkg/path` from `node_modules`. Used for
+*    third-party SCSS/CSS, e.g. `@import '~nprogress/nprogress.css'`.
+*
+* 2. `~/path` — resolves relative to the **project root** (the `~` acts as
+*    an alias for the root). Used with Turbopack's `resolveAlias: { '~*': '*' }`
+*    convention, e.g. `@use '~/styles/variables' as *`.
+*
+* Vite's built-in Sass resolver does not strip the `~` prefix, so any SCSS
+* that uses tilde imports fails with "Can't find stylesheet to import" errors.
+* This `FileImporter` runs before Vite's internal importer (added at the end
+* of `importers[]` in the vite:css plugin) and canonicalises tilde URLs so
+* Sass can load them from the filesystem.
+*
+* The returned object implements the modern Sass `FileImporter` interface:
+* `findFileUrl` returns a `file://` URL and Sass automatically handles partial
+* resolution (`_variables.scss` for `variables`), index files, and extensions.
+*
+* @param root - Absolute path to the Vite project root (used as the base for
+*   `~/path` resolution and for locating `node_modules`).
+*/
+function createSassTildeImporter(root) {
+	const rootBaseUrl = pathToFileURL(root.endsWith("/") ? root : root + "/");
+	const nodeModulesBaseUrl = pathToFileURL(path.join(root, "node_modules") + "/");
+	return { findFileUrl(url) {
+		if (!url.startsWith("~")) return null;
+		const stripped = url.slice(1);
+		if (stripped.startsWith("/")) return new URL(stripped.slice(1), rootBaseUrl);
+		if (!stripped) return null;
+		const simpleResolved = new URL(stripped, nodeModulesBaseUrl);
+		const pkgName = stripped.startsWith("@") ? stripped.split("/").slice(0, 2).join("/") : stripped.split("/")[0] ?? "";
+		const directPkgDir = path.join(root, "node_modules", pkgName);
+		if (pkgName && fs.existsSync(directPkgDir)) return simpleResolved;
+		const req = createRequire(path.join(root, "package.json"));
+		try {
+			const pkgJsonPath = req.resolve(`${pkgName}/package.json`);
+			const pkgDir = path.dirname(pkgJsonPath);
+			const afterPkg = stripped.startsWith("@") ? stripped.split("/").slice(2).join("/") : stripped.split("/").slice(1).join("/");
+			return pathToFileURL(afterPkg ? path.join(pkgDir, afterPkg) : pkgDir);
+		} catch {
+			return null;
+		}
+	} };
+}
 function buildSassPreprocessorOptions(sassOptions) {
 	if (!sassOptions || typeof sassOptions !== "object") return void 0;
 	const { prependData, additionalData, includePaths, loadPaths, ...rest } = sassOptions;
@@ -16,5 +92,177 @@ function buildSassPreprocessorOptions(sassOptions) {
 	if (Object.keys(out).length === 0) return void 0;
 	return out;
 }
+/**
+* Sort key comparator used by postcss-modules' FileSystemLoader to determine
+* the order in which dependency CSS is prepended to the output.
+* Mirrors the original `traceKeySorter` from postcss-modules source.
+*/
+function traceKeySorter(a, b) {
+	if (a.length < b.length) return a < b.substring(0, a.length) ? -1 : 1;
+	if (a.length > b.length) return a.substring(0, b.length) <= b ? -1 : 1;
+	return a < b ? -1 : 1;
+}
+/**
+* Mirrors Vite's internal `cssModuleRE` (`/\.module\.(css|less|sass|scss|…)/`).
+*
+* postcss-modules treats *every* `composes: x from './file'` dependency as a
+* CSS module regardless of its filename, but Vite's pipeline only applies
+* CSS-module scoping to `*.module.*` files. When a dependency is not named
+* `*.module.*` (e.g. `composes: x from './plain.css'`), we hand
+* `preprocessCSS` a virtual `*.module.*` filename (same directory, so Sass
+* imports and relative resolution are unaffected) so the dependency's classes
+* are scoped and its export tokens extracted — matching what postcss-modules'
+* built-in `FileSystemLoader` did.
+*/
+const CSS_MODULE_RE = /\.module\.\w+$/;
+/**
+* Sass-aware replacement for postcss-modules' `FileSystemLoader`.
+*
+* Implements the same constructor + `fetch` + `finalSource` interface that
+* postcss-modules calls when resolving `composes: className from 'file'`
+* dependencies.
+*
+* For every dependency file, Vite's `preprocessCSS` is used so that:
+* - `.scss`/`.sass` files are compiled through Sass *before* CSS-module
+*   scoping runs (fixing the "Invalid empty selector" LightningCSS crash).
+* - `.module.css` and `.module.scss` files have their class names scoped and
+*   export tokens extracted in exactly the same way as the top-level file.
+*
+* Failure handling: a missing Sass implementation is downgraded to a logged
+* warning and an empty token map so the build continues (class composition
+* will be incomplete); any other preprocessing error (e.g. a syntax error in
+* the composed dependency) propagates and fails the build, matching the
+* built-in `FileSystemLoader`. When no resolved config has been bound —
+* only reachable if the Loader is used outside vinext's `configResolved`
+* wiring — the Loader silently returns an empty token map.
+*
+* Recursion boundary: nested `composes` chains are handled by delegating to
+* `preprocessCSS`, which re-applies postcss-modules (and therefore this
+* Loader) for each dependency — every composed subtree gets its own inner
+* Loader instance rather than sharing this instance's `tokensByFile`/
+* `sources` state. Two intentional consequences, versus the built-in
+* single-loader recursion:
+* - A dependency reached from two sibling `composes` branches is inlined
+*   once per subtree; the duplicate identical rules are collapsed by
+*   LightningCSS during minification (bloat-free in practice, but the
+*   pre-minification CSS differs from the built-in loader's single pass).
+* - Circular `composes` chains are not short-circuited across the
+*   `preprocessCSS` boundary (the built-in loader's shared cache caught
+*   them). Cycles are invalid CSS-module inputs — webpack/Next.js errors on
+*   them too — so no cycle bookkeeping is layered on here.
+*
+* Not exported directly: postcss-modules constructs the Loader itself with a
+* fixed `(root, plugins, fileResolve)` signature, so the resolved Vite config
+* cannot be a constructor argument. `createSassAwareFileSystemLoader` returns
+* a subclass with the config bound per factory call (i.e. per vinext plugin
+* instance) instead of a module-level singleton, so multiple builds in one
+* process (monorepos, programmatic multi-build runners) each preprocess
+* `composes` dependencies with their own root/sass options/scoped-name
+* generator.
+*/
+var SassAwareFileSystemLoader = class {
+	root;
+	fileResolve;
+	sources;
+	traces;
+	importNr;
+	tokensByFile;
+	constructor(root, _plugins, fileResolve) {
+		if (root === "/" && process.platform === "win32") {
+			const cwdDrive = process.cwd().slice(0, 3);
+			if (!/^[A-Za-z]:\\$/.test(cwdDrive)) throw new Error(`Failed to obtain root from "${process.cwd()}".`);
+			root = cwdDrive;
+		}
+		this.root = root;
+		this.fileResolve = fileResolve;
+		this.sources = {};
+		this.traces = {};
+		this.importNr = 0;
+		this.tokensByFile = {};
+	}
+	/**
+	* The resolved Vite config used to preprocess `composes` dependencies.
+	* The base implementation has no config (`fetch` silently returns empty
+	* tokens); `createSassAwareFileSystemLoader` overrides this with the
+	* config bound to that factory call.
+	*/
+	getResolvedConfig() {
+		return null;
+	}
+	async fetch(_newPath, relativeTo, _trace) {
+		const newPath = _newPath.replace(/^["']|["']$/g, "");
+		const trace = _trace ?? String.fromCharCode(this.importNr++);
+		const useFileResolve = typeof this.fileResolve === "function";
+		const fileResolvedPath = useFileResolve ? await this.fileResolve(newPath, relativeTo) : void 0;
+		if (fileResolvedPath !== void 0 && !path.isAbsolute(fileResolvedPath)) throw new Error("The returned path from the \"fileResolve\" option must be absolute.");
+		const relativeDir = path.dirname(relativeTo);
+		const fileRelativePath = fileResolvedPath ?? (() => {
+			let resolved = path.resolve(path.resolve(this.root, relativeDir), newPath);
+			if (!useFileResolve && newPath[0] !== "." && !path.isAbsolute(newPath)) try {
+				resolved = createRequire(import.meta.url).resolve(newPath);
+			} catch {}
+			return resolved;
+		})();
+		const cached = this.tokensByFile[fileRelativePath];
+		if (cached) return cached;
+		const config = this.getResolvedConfig();
+		const rawSource = await fs.promises.readFile(fileRelativePath, "utf-8");
+		if (config) try {
+			const ext = path.extname(fileRelativePath);
+			const result = await preprocessCSS(rawSource, CSS_MODULE_RE.test(fileRelativePath) ? fileRelativePath : ext === "" ? `${fileRelativePath}.module.css` : `${fileRelativePath.slice(0, -ext.length)}.module${ext}`, config);
+			const exportTokens = result.modules ?? {};
+			this.sources[fileRelativePath] = result.code;
+			this.traces[trace] = fileRelativePath;
+			this.tokensByFile[fileRelativePath] = exportTokens;
+			return exportTokens;
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			if (!message.includes("Preprocessor dependency")) throw error;
+			config.logger.warn(`[vinext] Failed to preprocess \`composes\` dependency ${fileRelativePath}: ${message}. Classes composed from this file will be missing from the build output.`);
+		}
+		this.sources[fileRelativePath] = "";
+		this.traces[trace] = fileRelativePath;
+		this.tokensByFile[fileRelativePath] = {};
+		return {};
+	}
+	get finalSource() {
+		const { traces, sources } = this;
+		const written = /* @__PURE__ */ new Set();
+		return Object.keys(traces).sort(traceKeySorter).map((key) => {
+			const filename = traces[key];
+			if (!filename || written.has(filename)) return null;
+			written.add(filename);
+			return sources[filename];
+		}).join("");
+	}
+};
+/**
+* Create a per-build binding of {@link SassAwareFileSystemLoader}.
+*
+* Returns:
+* - `Loader` — a class to inject as postcss-modules' `css.modules.Loader`
+*   option. postcss-modules instantiates it with the fixed
+*   `(root, plugins, fileResolve)` signature, so the resolved Vite config is
+*   captured in this factory's closure rather than passed to the constructor.
+* - `setResolvedConfig` — called from vinext's `configResolved` hook to bind
+*   that build's resolved config.
+*
+* One binding is created per vinext plugin instance, so concurrent or
+* back-to-back builds in a single process never observe another build's
+* config (root, sass options, `generateScopedName`, logger, …).
+*/
+function createSassAwareFileSystemLoader() {
+	let resolvedConfig = null;
+	return {
+		Loader: class extends SassAwareFileSystemLoader {
+			getResolvedConfig() {
+				return resolvedConfig;
+			}
+		},
+		setResolvedConfig(config) {
+			resolvedConfig = config;
+		}
+	};
+}
 //#endregion
-export { buildSassPreprocessorOptions };
+export { buildSassPreprocessorOptions, createSassAwareFileSystemLoader, createSassTildeImporter };

package/dist/plugins/typeof-window.d.ts

@@ -0,0 +1,14 @@
+//#region src/plugins/typeof-window.d.ts
+type WindowType = "object" | "undefined";
+type EnvironmentLike = {
+  config: {
+    consumer: "client" | "server";
+  };
+};
+declare function getTypeofWindowReplacement(environment: EnvironmentLike): WindowType;
+declare function replaceTypeofWindow(code: string, replacement: WindowType): {
+  code: string;
+  map: import("magic-string").SourceMap;
+} | null;
+//#endregion
+export { getTypeofWindowReplacement, replaceTypeofWindow };