@kanso-labs/unplugin-style-dictionary 0.8.0 → 0.10.0

package/dist/index.js

@@ -36,9 +36,48 @@ function isMessageChannel(value) {
 function isThenable(value) {
 	return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
 }
+function looksLikeConfig(value) {
+	if (typeof value !== "object" || value === null) return false;
+	return [
+		"include",
+		"platforms",
+		"source",
+		"tokens"
+	].some((key) => key in value);
+}
+function nodeModulesNegations(paths) {
+	const negations = /* @__PURE__ */ new Set();
+	for (const file of paths) {
+		const normalised = file.replace(/\\/g, "/");
+		if (normalised.includes("/node_modules/")) negations.add(`!${normalised}`);
+	}
+	return Array.from(negations);
+}
+function nodeModulesWatchDirectories(paths) {
+	const directories = /* @__PURE__ */ new Set();
+	for (const file of paths) {
+		const normalised = file.replace(/\\/g, "/");
+		if (!normalised.includes("/node_modules/")) continue;
+		directories.add(path.dirname(normalised));
+	}
+	return Array.from(directories);
+}
 function paint(code, value, allowed) {
 	return allowed ? `\u001B[${code}m${value}\u001B[0m` : value;
 }
+async function patternsMatchingNothing(patterns) {
+	const barren = [];
+	for (const pattern of patterns) {
+		if (!GLOB_CHARACTERS.test(pattern)) {
+			if (!fs.existsSync(pattern)) barren.push(pattern);
+			continue;
+		}
+		try {
+			if ((await glob([pattern], { absolute: true })).length === 0) barren.push(pattern);
+		} catch {}
+	}
+	return barren;
+}
 function unwrapDefault(value) {
 	return typeof value === "object" && value !== null && "default" in value ? value.default ?? value : value;
 }
@@ -62,6 +101,43 @@ function temporaryPathFor(destination) {
 	const extension = path.extname(destination);
 	return path.join(path.dirname(destination), `.${path.basename(destination, extension)}.${process.pid}.${temporaryFileCounter++}.tmp`);
 }
+const RENAME_RETRY_CODES = /* @__PURE__ */ new Set(["EBUSY", "EPERM"]);
+const RENAME_RETRY_DELAYS_MS = [
+	1,
+	2,
+	4,
+	8,
+	16,
+	32,
+	64,
+	128
+];
+function isRetryableRenameError(error) {
+	return typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" && RENAME_RETRY_CODES.has(error.code);
+}
+const sleepSync = (ms) => {
+	Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+};
+async function renameWithRetry(temporary, destination) {
+	for (const delay of RENAME_RETRY_DELAYS_MS) try {
+		await fs.promises.rename(temporary, destination);
+		return;
+	} catch (err) {
+		if (!isRetryableRenameError(err)) throw err;
+		await new Promise((resolve) => setTimeout(resolve, delay));
+	}
+	await fs.promises.rename(temporary, destination);
+}
+function renameWithRetrySync(temporary, destination) {
+	for (const delay of RENAME_RETRY_DELAYS_MS) try {
+		fs.renameSync(temporary, destination);
+		return;
+	} catch (err) {
+		if (!isRetryableRenameError(err)) throw err;
+		sleepSync(delay);
+	}
+	fs.renameSync(temporary, destination);
+}
 const writeFileAtomic = async (file, data, options) => {
 	if (typeof file !== "string") return fs.promises.writeFile(file, data, options);
 	const temporary = temporaryPathFor(file);
@@ -71,7 +147,7 @@ const writeFileAtomic = async (file, data, options) => {
 			discardTemporaryFile(temporary);
 			return;
 		}
-		await fs.promises.rename(temporary, file);
+		await renameWithRetry(temporary, file);
 	} catch (err) {
 		discardTemporaryFile(temporary);
 		throw err;
@@ -89,7 +165,7 @@ const writeFileSyncAtomic = (file, data, options) => {
 			discardTemporaryFile(temporary);
 			return;
 		}
-		fs.renameSync(temporary, file);
+		renameWithRetrySync(temporary, file);
 	} catch (err) {
 		discardTemporaryFile(temporary);
 		throw err;
@@ -105,6 +181,9 @@ const IMPORTED_CONFIG_EXTENSIONS = [
 	".mjs",
 	".ts"
 ];
+function describeConfig(item, index) {
+	return item.file ? `The configuration ${item.file}` : `The configuration at position ${index + 1}`;
+}
 function isImportedConfig(file) {
 	return IMPORTED_CONFIG_EXTENSIONS.some((extension) => file.endsWith(extension));
 }
@@ -139,11 +218,16 @@ function statOrNull(file) {
 	}
 }
 const unpluginFactory = (options = {}, meta) => {
-	const isWebpack = meta.framework === "webpack";
-	const { cache = true, errorOverlay = true, failOnError = "build", logLevel, onBuildEnd, onBuildError, onBuildStart, report = true, root: rootOption, silent = false } = options;
+	const isWebpack = meta.framework === "webpack" || meta.framework === "rspack";
+	const { cache = true, errorOverlay = true, failOnError = "build", logLevel, onBuildEnd, onBuildError, onBuildStart, platforms: platformsOption, report = true, root: rootOption, silent = false } = options;
 	const level = logLevel ?? (silent ? "silent" : void 0);
 	const quiet = level === "silent" || level === "warn";
 	const verbosity = level === void 0 ? void 0 : level === "verbose" ? "verbose" : level === "silent" ? "silent" : "default";
+	const platformsFor = (context) => {
+		if (platformsOption === void 0) return void 0;
+		if (Array.isArray(platformsOption)) return platformsOption;
+		return context === void 0 ? platformsOption.build : platformsOption.watch;
+	};
 	const failsTheBuild = (context) => failOnError === true || (context === void 0 ? failOnError === "build" : failOnError === "serve");
 	let hostCommand = "build";
 	let hostMode;
@@ -164,6 +248,7 @@ const unpluginFactory = (options = {}, meta) => {
 	let cachedPatterns;
 	let watchRebuild = false;
 	let hasCompiled = false;
+	let hostClosed = false;
 	const expandPatterns = async (patterns) => {
 		const paths = /* @__PURE__ */ new Set();
 		const globs = [];
@@ -229,17 +314,33 @@ const unpluginFactory = (options = {}, meta) => {
 	};
 	const resolveConfigs = async () => {
 		let rawConfig = options.config;
-		if (!rawConfig) for (const file of [
-			"sd.config.json",
-			"config.json",
-			"sd.config.js",
-			"sd.config.mjs"
-		]) {
-			const fullPath = path.resolve(root, file);
-			if (fs.existsSync(fullPath)) {
+		if (rawConfig === false) return [];
+		if (!rawConfig) {
+			const defaults = [
+				"sd.config.json",
+				"config.json",
+				"sd.config.js",
+				"sd.config.mjs"
+			];
+			const rejected = [];
+			for (const file of defaults) {
+				const fullPath = path.resolve(root, file);
+				if (!fs.existsSync(fullPath)) continue;
+				if (!looksLikeConfig(await readConfigObject({
+					config: fullPath,
+					file: fullPath
+				}, false))) {
+					rejected.push(file);
+					continue;
+				}
+				if (!announcedDiscovery) {
+					announcedDiscovery = true;
+					log(`Using the configuration it found at ${fullPath}`, "info");
+				}
 				rawConfig = file;
 				break;
 			}
+			if (rejected.length > 0) log(`Ignored ${rejected.join(", ")} in ${root}: nothing there declares platforms, source, include or tokens, so it does not look like a Style Dictionary configuration. Name it with the config option if it is one, or set config to false to stop looking.`, "error");
 		}
 		if (!rawConfig) {
 			log("No configuration specified and no default config file found. Style Dictionary will not compile.", "error");
@@ -324,9 +425,11 @@ const unpluginFactory = (options = {}, meta) => {
 			return loaded;
 		}
 	};
-	const declaredDestinations = (configObj) => {
+	const declaredDestinations = (configObj, only) => {
 		const destinations = [];
-		for (const platform of Object.values(configObj.platforms ?? {})) {
+		const entries = Object.entries(configObj.platforms ?? {});
+		const selected = only ? entries.filter(([name]) => only.includes(name)) : entries;
+		for (const [, platform] of selected) {
 			const buildPath = platform.buildPath ?? "";
 			const absoluteBuildPath = path.isAbsolute(buildPath) ? buildPath : path.resolve(root, buildPath);
 			for (const file of platform.files ?? []) if (file.destination) destinations.push(path.isAbsolute(file.destination) ? file.destination : path.resolve(absoluteBuildPath, file.destination));
@@ -340,9 +443,9 @@ const unpluginFactory = (options = {}, meta) => {
 			return null;
 		}
 	};
-	const isUpToDate = async (item, configObj) => {
+	const isUpToDate = async (item, configObj, only) => {
 		if (Object.values(configObj.platforms ?? {}).some((platform) => (platform.actions?.length ?? 0) > 0)) return false;
-		const destinations = declaredDestinations(configObj);
+		const destinations = declaredDestinations(configObj, only);
 		if (destinations.length === 0) return false;
 		const extraWatches = options.watch ? Array.isArray(options.watch) ? options.watch : [options.watch] : [];
 		const sources = await expandPatterns([...sourcePatternsOf(configObj), ...extraWatches.map((pattern) => (path.isAbsolute(pattern) ? pattern : path.resolve(root, pattern)).replace(/\\/g, "/"))]);
@@ -405,9 +508,10 @@ const unpluginFactory = (options = {}, meta) => {
 		try {
 			if (!context) log("Compiling design tokens...", "info");
 			if (onBuildStart) callHook("onBuildStart", onBuildStart);
-			for (const item of resolvedConfigs) {
+			for (const [index, item] of resolvedConfigs.entries()) {
 				const declared = cache ? await readConfigObject(item, false) : null;
-				if (declared && await isUpToDate(item, declared)) {
+				const selectedPlatforms = platformsFor(context);
+				if (declared && await isUpToDate(item, declared, selectedPlatforms)) {
 					for (const destination of declaredDestinations(declared)) generatedFiles.add(destination);
 					skipped++;
 					continue;
@@ -417,8 +521,23 @@ const unpluginFactory = (options = {}, meta) => {
 					mutateOriginal: true,
 					verbosity
 				});
+				if (sd.allTokens.length === 0) {
+					const asObject = await readConfigObject(item, false);
+					const barren = asObject ? await patternsMatchingNothing(sourcePatternsOf(asObject)) : [];
+					throw new Error([
+						`${describeConfig(item, index)} resolved no tokens, so its output would be emptied.`,
+						barren.length > 0 ? `These patterns matched no files: ${barren.join(", ")}` : `It declares no source or include patterns that matched anything.`,
+						`Nothing was written. Set failOnError to false to build anyway.`
+					].join(" "));
+				}
 				sd.volume = atomicVolume;
-				await sd.buildAllPlatforms();
+				if (selectedPlatforms === void 0) await sd.buildAllPlatforms();
+				else {
+					const defined = Object.keys(sd.platforms);
+					const unknown = selectedPlatforms.filter((name) => !defined.includes(name));
+					if (unknown.length > 0) throw new Error(`${describeConfig(item, index)} does not define the platform(s) ${unknown.join(", ")}. It defines ${defined.join(", ")}.`);
+					for (const name of selectedPlatforms) await sd.buildPlatform(name);
+				}
 				for (const platform of Object.values(sd.platforms)) {
 					const buildPath = platform.buildPath ?? "";
 					for (const file of platform.files ?? []) if (file.destination) {
@@ -487,6 +606,8 @@ const unpluginFactory = (options = {}, meta) => {
 	let inFlight;
 	let waiting = [];
 	let refreshServerWatchList;
+	let announcedDiscovery = false;
+	let startupResolved;
 	let notifyBuildOutcome;
 	const drain = async () => {
 		while (pendingReason !== void 0) {
@@ -516,6 +637,7 @@ const unpluginFactory = (options = {}, meta) => {
 		}
 	};
 	const schedule = async (reason) => {
+		if (hostClosed) return;
 		pendingReason = reason;
 		const covered = new Promise((resolve, reject) => {
 			waiting.push((failure) => {
@@ -531,14 +653,46 @@ const unpluginFactory = (options = {}, meta) => {
 		debounceTimer.unref();
 		return covered;
 	};
+	const closeWatcher = () => {
+		hostClosed = true;
+	};
+	const adoptCompiler = (compiler) => {
+		if (rootOption === void 0) root = compiler.options.context ?? process.cwd();
+		hostMode = compiler.options.mode;
+		const pending = [];
+		host = { error: (message) => {
+			pending.push(message);
+		} };
+		compiler.hooks.compilation.tap("unplugin-style-dictionary", (compilation) => {
+			for (const message of pending.splice(0)) {
+				const reported = new Error(message);
+				reported.name = "UnpluginStyleDictionaryWarning";
+				compilation.warnings.push(reported);
+			}
+		});
+		const drainToConsole = () => {
+			for (const message of pending.splice(0)) console.error(paint("31", message, stderrColour));
+		};
+		compiler.hooks.failed.tap("unplugin-style-dictionary", drainToConsole);
+		compiler.hooks.done.tap("unplugin-style-dictionary", drainToConsole);
+		compiler.hooks.beforeCompile.tapPromise("unplugin-style-dictionary", async () => {
+			isWatching = compiler.watchMode;
+			const resolved = await resolveConfigs();
+			if (resolved.length === 0) return;
+			await compileOnceAcrossInstances(resolved);
+			hasCompiled = true;
+		});
+	};
 	return {
 		async buildStart() {
 			adoptHost(this);
 			adoptWatchMode(this);
 			const resolved = await resolveConfigs();
 			if (resolved.length === 0) return;
-			const { paths } = await getWatchTargets(resolved);
-			for (const file of paths) this.addWatchFile(file);
+			if (!hostClosed) {
+				const { paths } = await getWatchTargets(resolved);
+				for (const file of paths) this.addWatchFile(file);
+			}
 			if (isWebpack) return;
 			if (watchRebuild && hasCompiled) {
 				watchRebuild = false;
@@ -548,8 +702,12 @@ const unpluginFactory = (options = {}, meta) => {
 			hasCompiled = true;
 		},
 		name: "unplugin-style-dictionary",
+		rolldown: { closeWatcher },
+		rollup: { closeWatcher },
+		rspack: adoptCompiler,
 		vite: {
-			configResolved(config) {
+			closeWatcher,
+			async configResolved(config) {
 				if (rootOption === void 0) root = config.root || process.cwd();
 				hostCommand = config.command;
 				hostMode = config.mode;
@@ -561,16 +719,62 @@ const unpluginFactory = (options = {}, meta) => {
 						config.logger.info(message);
 					}
 				};
+				if (config.command !== "serve") return;
+				isWatching = true;
+				try {
+					startupResolved = await resolveConfigs();
+					if (startupResolved.length === 0) return;
+					const { paths } = await getWatchTargets(startupResolved);
+					const negations = nodeModulesNegations(paths);
+					if (negations.length === 0) return;
+					const existing = config.server.watch?.ignored;
+					config.server.watch = {
+						...config.server.watch,
+						ignored: [...Array.isArray(existing) ? existing : existing === void 0 ? [] : [existing], ...negations]
+					};
+				} catch (err) {
+					log(`Could not read the configuration while preparing the watch list: ${errorMessage(err)}`, "error");
+					startupResolved = void 0;
+				}
 			},
 			async configureServer(server) {
 				isWatching = true;
-				const resolved = await resolveConfigs();
+				const resolved = startupResolved ?? await resolveConfigs();
+				startupResolved = void 0;
 				if (resolved.length === 0) return;
 				let targets = await getWatchTargets(resolved);
 				server.watcher.add(targets.paths);
+				const ownWatchers = /* @__PURE__ */ new Map();
+				const watchNodeModules = (forPaths) => {
+					const wanted = new Set(nodeModulesWatchDirectories(forPaths));
+					for (const [directory, watcher] of ownWatchers) {
+						if (wanted.has(directory)) continue;
+						watcher.close();
+						ownWatchers.delete(directory);
+					}
+					for (const directory of wanted) {
+						if (ownWatchers.has(directory)) continue;
+						try {
+							const watcher = fs.watch(directory, (_event, filename) => {
+								if (filename === null) return;
+								const changed = path.posix.join(directory, filename);
+								if (!isWatchedSource(changed, targets.patterns)) return;
+								schedule(path.basename(changed)).catch(() => {});
+							});
+							watcher.unref();
+							ownWatchers.set(directory, watcher);
+						} catch {}
+					}
+				};
+				watchNodeModules(targets.paths);
+				server.httpServer?.once("close", () => {
+					for (const watcher of ownWatchers.values()) watcher.close();
+					ownWatchers.clear();
+				});
 				refreshServerWatchList = async (rebuilt) => {
 					targets = await getWatchTargets(rebuilt);
 					server.watcher.add(targets.paths);
+					watchNodeModules(targets.paths);
 				};
 				if (errorOverlay) {
 					let overlayShowing = false;
@@ -604,6 +808,7 @@ const unpluginFactory = (options = {}, meta) => {
 		async watchChange(id) {
 			adoptHost(this);
 			adoptWatchMode(this);
+			if (hostClosed) return;
 			watchRebuild = true;
 			if (cachedPatterns && !isWatchedSource(id, cachedPatterns)) return;
 			const resolved = await resolveConfigs();
@@ -613,33 +818,7 @@ const unpluginFactory = (options = {}, meta) => {
 			if (!isWebpack) await schedule(path.basename(id));
 			for (const file of await expandPatterns(patterns)) this.addWatchFile(file);
 		},
-		webpack(compiler) {
-			if (rootOption === void 0) root = compiler.options.context ?? process.cwd();
-			hostMode = compiler.options.mode;
-			const pending = [];
-			host = { error: (message) => {
-				pending.push(message);
-			} };
-			compiler.hooks.compilation.tap("unplugin-style-dictionary", (compilation) => {
-				for (const message of pending.splice(0)) {
-					const reported = new Error(message);
-					reported.name = "UnpluginStyleDictionaryWarning";
-					compilation.warnings.push(reported);
-				}
-			});
-			const drainToConsole = () => {
-				for (const message of pending.splice(0)) console.error(paint("31", message, stderrColour));
-			};
-			compiler.hooks.failed.tap("unplugin-style-dictionary", drainToConsole);
-			compiler.hooks.done.tap("unplugin-style-dictionary", drainToConsole);
-			compiler.hooks.beforeCompile.tapPromise("unplugin-style-dictionary", async () => {
-				isWatching = compiler.watchMode;
-				const resolved = await resolveConfigs();
-				if (resolved.length === 0) return;
-				await compileOnceAcrossInstances(resolved);
-				hasCompiled = true;
-			});
-		}
+		webpack: adoptCompiler
 	};
 };
 const unplugin = /* #__PURE__ */ createUnplugin(unpluginFactory);