@kanso-labs/unplugin-style-dictionary 0.6.0 → 0.6.1

package/README.md

@@ -253,6 +253,29 @@ plugin subtracts its own output from the watch list, skips recompiling when a
 watch rebuild re-enters `buildStart`, and skips the write entirely when a
 rebuild renders bytes identical to what is already on disk.
 
+## Skipping a Build That Would Change Nothing
+
+A configuration whose output is already newer than everything it reads is not
+compiled again. `buildAllPlatforms` is around 80% of a build, and under Vite it
+runs inside `server.listen()` — so without this the dev server refused
+connections for the length of a compile whether or not a token had changed.
+
+Three things are compared: every file the configuration reads (its `source` and
+`include` matches, its own config file, and anything named by `watch`), every
+file it declares, and — for a configuration that is not a file — what the
+configuration looked like when those files were written.
+
+Two cases never skip, because neither can be settled from the filesystem:
+
+| Case                                                                                 | Why                                                                                                                                                                                                                                   |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| The first compile of a process, for a configuration given as an object or a function | There is no config file to stat, so an edit to the object inside `vite.config.ts` moves no mtime. Within one process the resolved configuration is compared against the one last built; across processes there is nothing to compare. |
+| A platform declaring `actions`                                                       | An action writes what no `destination` names, so a skip would leave its work undone.                                                                                                                                                  |
+
+A custom format that reads something off-disk — an environment variable, a
+network call — cannot be detected this way either. Set `cache: false` where that
+is the case, and every build runs.
+
 ## One Compile per Process
 
 A bundler instance that asks for a compile while an identical one is already

package/dist/index.js

@@ -103,6 +103,7 @@ function staticParentOf(pattern) {
 	const firstGlob = segments.findIndex((segment) => GLOB_CHARACTERS.test(segment));
 	return firstGlob === -1 ? path.posix.dirname(pattern) : segments.slice(0, firstGlob).join("/");
 }
+const compiledFingerprints = /* @__PURE__ */ new Set();
 const compilesInFlight = /* @__PURE__ */ new Map();
 function buildKey(root, resolved) {
 	try {
@@ -111,9 +112,25 @@ function buildKey(root, resolved) {
 		return null;
 	}
 }
+function sourcePatternsOf(configObj) {
+	const patterns = [];
+	const add = (pattern) => {
+		if (typeof pattern === "string") patterns.push((path.isAbsolute(pattern) ? pattern : path.resolve(process.cwd(), pattern)).replace(/\\/g, "/"));
+	};
+	for (const value of [configObj.source, configObj.include]) if (Array.isArray(value)) value.forEach(add);
+	else add(value);
+	return patterns;
+}
+function statOrNull(file) {
+	try {
+		return fs.statSync(file);
+	} catch {
+		return null;
+	}
+}
 const unpluginFactory = (options = {}, meta) => {
 	const isWebpack = meta.framework === "webpack";
-	const { failOnError = "build", logLevel, root: rootOption, silent = false } = options;
+	const { cache = true, failOnError = "build", logLevel, 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";
@@ -188,14 +205,14 @@ const unpluginFactory = (options = {}, meta) => {
 		const key = String(version).replace(".", "_");
 		return unwrapDefault(await import(`${pathToFileURL(file).href}?t=${key}`));
 	};
-	const readConfigObject = async (item, report) => {
+	const readConfigObject = async (item, reportErrors) => {
 		if (typeof item.config !== "string") return item.config;
 		try {
 			const loaded = isImportedConfig(item.config) ? await importConfigModule(item.config) : JSON5.parse(fs.readFileSync(item.config, "utf-8"));
 			if (isConfig(loaded)) return loaded;
-			if (report) log(`Config file did not resolve to a configuration object: ${item.config}`, "error");
+			if (reportErrors) log(`Config file did not resolve to a configuration object: ${item.config}`, "error");
 		} catch (err) {
-			if (report) log(`Failed to parse config file: ${item.config}. Error: ${errorMessage(err)}`, "error");
+			if (reportErrors) log(`Failed to parse config file: ${item.config}. Error: ${errorMessage(err)}`, "error");
 		}
 		return null;
 	};
@@ -246,6 +263,51 @@ const unpluginFactory = (options = {}, meta) => {
 			return loaded;
 		}
 	};
+	const declaredDestinations = (configObj) => {
+		const destinations = [];
+		for (const platform of Object.values(configObj.platforms ?? {})) {
+			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));
+		}
+		return destinations;
+	};
+	const configFingerprint = (item) => {
+		try {
+			return JSON.stringify([root, item.file ?? item.config], (_key, value) => typeof value === "function" ? `[fn]${String(value)}` : value);
+		} catch {
+			return null;
+		}
+	};
+	const isUpToDate = async (item, configObj) => {
+		if (Object.values(configObj.platforms ?? {}).some((platform) => (platform.actions?.length ?? 0) > 0)) return false;
+		const destinations = declaredDestinations(configObj);
+		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, "/"))]);
+		if (item.file) sources.push(item.file.replace(/\\/g, "/"));
+		if (sources.length === 0) return false;
+		let newestSource = -Infinity;
+		let sawFile = false;
+		for (const source of sources) {
+			const stats = statOrNull(source);
+			if (!stats) return false;
+			if (stats.isDirectory()) continue;
+			sawFile = true;
+			newestSource = Math.max(newestSource, stats.mtimeMs);
+		}
+		if (!sawFile) return false;
+		let oldestDestination = Infinity;
+		for (const destination of destinations) {
+			const stats = statOrNull(destination);
+			if (!stats) return false;
+			oldestDestination = Math.min(oldestDestination, stats.mtimeMs);
+		}
+		if (oldestDestination <= newestSource) return false;
+		if (item.file) return true;
+		const fingerprint = configFingerprint(item);
+		return fingerprint !== null && compiledFingerprints.has(fingerprint);
+	};
 	const reportSizes = (generatedFiles) => {
 		const fileInfos = [];
 		for (const filePath of generatedFiles) if (fs.existsSync(filePath)) {
@@ -278,9 +340,16 @@ const unpluginFactory = (options = {}, meta) => {
 	const runBuilds = async (resolvedConfigs, context) => {
 		const startTime = Date.now();
 		const generatedFiles = /* @__PURE__ */ new Set();
+		let skipped = 0;
 		try {
 			if (!context) log("Compiling design tokens...", "info");
 			for (const item of resolvedConfigs) {
+				const declared = cache ? await readConfigObject(item, false) : null;
+				if (declared && await isUpToDate(item, declared)) {
+					for (const destination of declaredDestinations(declared)) generatedFiles.add(destination);
+					skipped++;
+					continue;
+				}
 				const sd = new StyleDictionary(await configForBuild(item), { init: false });
 				await sd.extend(void 0, {
 					mutateOriginal: true,
@@ -296,6 +365,8 @@ const unpluginFactory = (options = {}, meta) => {
 						generatedFiles.add(absoluteDestination);
 					}
 				}
+				const fingerprint = configFingerprint(item);
+				if (fingerprint !== null) compiledFingerprints.add(fingerprint);
 			}
 			generatedDestinations.clear();
 			for (const destination of generatedFiles) generatedDestinations.add(destination.replace(/\\/g, "/"));
@@ -306,16 +377,21 @@ const unpluginFactory = (options = {}, meta) => {
 			return;
 		}
 		const duration = Date.now() - startTime;
+		const everythingSkipped = skipped === resolvedConfigs.length;
 		if (context) {
-			log(`Rebuilt design tokens due to change in ${context} (${duration}ms)`, "success");
+			log(everythingSkipped ? `Design tokens already up to date after change in ${context} (${duration}ms)` : `Rebuilt design tokens due to change in ${context} (${duration}ms)`, "success");
 			return;
 		}
-		if (!quiet && generatedFiles.size > 0) try {
+		if (report && !quiet && !everythingSkipped && generatedFiles.size > 0) try {
 			reportSizes(generatedFiles);
 		} catch (err) {
 			log(`Failed to report generated file sizes: ${errorMessage(err)}`, "error");
 		}
-		log(`Compiled successfully! (${duration}ms)`, "success");
+		if (everythingSkipped) {
+			log(`Design tokens are already up to date (${duration}ms)`, "success");
+			return;
+		}
+		log(skipped > 0 ? `Compiled successfully! (${duration}ms, ${skipped} already up to date)` : `Compiled successfully! (${duration}ms)`, "success");
 	};
 	const compileOnceAcrossInstances = async (resolvedConfigs) => {
 		const key = buildKey(root, resolvedConfigs);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Config } from 'style-dictionary'\nimport type { UnpluginFactory } from 'unplugin'\nimport type { ViteDevServer } from 'vite'\n\nimport JSON5 from 'json5'\nimport fs from 'node:fs'\nimport path from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport zlib from 'node:zlib'\nimport picomatch from 'picomatch'\nimport StyleDictionary from 'style-dictionary'\nimport { glob } from 'tinyglobby'\nimport { createUnplugin } from 'unplugin'\n\nimport type { UnpluginStyleDictionaryOptions } from './types.js'\n\nexport type * from './types.js'\n\n// Whether `file` matches one of the resolved config/token watch patterns.\n// Shared by the Vite-specific `configureServer` watcher and the universal\n// `watchChange` hook — both need it, and both must skip files that don't\n// match: without this filter, `watchChange` reacts to *any* changed\n// module-graph file, including this plugin's own generated output (since\n// consuming code imports it). Every regenerate is itself a \"change\", which\n// without filtering re-triggers a rebuild forever.\n//\n// Matching a pattern is only half of that, and this function is only the half\n// it can answer. A `buildPath` inside a `source` directory is a supported\n// layout, and under any correct matcher its output matches the very glob that\n// produced it — so the caller also subtracts what the last build wrote. See\n// `generatedDestinations` and `isWatchedSource` in the factory below.\n//\n// The patterns are Style Dictionary's own `source` and `include` globs, so the\n// filter has to admit exactly what the build reads — which is why the matching\n// is a real globber's rather than hand-rolled. The version this replaces was\n// wrong in both directions at once: it stripped `/**` out of a pattern and\n// prefix-matched the remainder, so `tokens/**/*.json` matched nothing sitting\n// directly in `tokens/` and `tokens/**` matched a `tokens-backup/` sibling,\n// while its regex branch mapped every `*` to `.*` — crossing `/` — and tested\n// it unanchored, so generated output under a watched directory matched its own\n// source glob and rebuilt forever.\n//\n// picomatch rather than `path.matchesGlob`, which would need no dependency at\n// all: that function is documented experimental, and on Node 20 — the floor\n// `engines` declares — it prints `ExperimentalWarning: glob is an experimental\n// feature and might change at any time` into the consumer's build output. The\n// dependency is free in practice, since `unplugin` depends on the same\n// picomatch and is already installed wherever this plugin is. Its `dot: false`\n// default is deliberate: it is what glob, and so Style Dictionary, reads\n// sources with, so a dotfile is invisible to the filter and to the build alike.\nexport function matchesWatchedFile(file: string, patterns: string[]): boolean {\n  const normalizedFile = file.replace(/\\\\/g, '/')\n\n  return patterns.some((pattern) => {\n    const normalizedPattern = pattern.replace(/\\\\/g, '/')\n\n    // A config file reaches this function as its own literal path, which is\n    // both the common case and the one shape that is not a glob at all.\n    return (\n      normalizedPattern === normalizedFile ||\n      picomatch.isMatch(normalizedFile, normalizedPattern)\n    )\n  })\n}\n\n// `catch` binds `unknown`, and a thrown non-Error — a string, a rejected\n// value out of a config module — carries no `.message`. The `as Error` casts\n// this replaces claimed otherwise and printed `undefined` for exactly those\n// cases, which is the least useful thing a failure log can say.\n// A rejected promise must carry an Error, and `catch` binds `unknown`. What\n// Style Dictionary throws is already one; anything else is wrapped rather than\n// handed on raw.\nfunction asError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(errorMessage(error))\n}\n\n// Best-effort cleanup of a temporary file whose write or rename failed. The\n// original failure is what the caller reports, so nothing here may throw.\nfunction discardTemporaryFile(temporary: string): void {\n  try {\n    fs.rmSync(temporary, { force: true })\n  } catch {\n    // Ignore: a leftover temporary file is not worth masking the real error.\n  }\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error)\n}\n\n// A config file is an untyped boundary: `JSON.parse` and a dynamic `import`\n// both hand back `any`, and an `any` assigned to `configObj` spreads through\n// every read of it downstream. These two narrow that boundary once, here.\n// They are type predicates rather than assertions on purpose — a predicate is\n// a check the compiler verifies, where a cast is only a claim.\nfunction isConfig(value: unknown): value is Config {\n  return typeof value === 'object' && value !== null\n}\n\n// A config module may expose its config as a `default` export or as the\n// namespace itself. `'default' in value` is what lets the compiler reach\n// `.default` without a cast.\nfunction unwrapDefault(value: unknown): unknown {\n  return typeof value === 'object' && value !== null && 'default' in value\n    ? (value.default ?? value)\n    : value\n}\n\n// Style Dictionary writes every generated file with a plain `writeFile` on the\n// volume it was handed, which truncates the destination and then streams the\n// new contents into it. Anything reading that file inside the window sees a\n// partial file: a consuming test run whose tokens are rebuilt mid-suite, or a\n// dev-server request landing on a rebuild, gets a truncated module and fails\n// to parse it. Writing a sibling temporary file and renaming it over the\n// destination closes the window — `rename` is atomic within a filesystem, so a\n// concurrent reader sees either the whole old file or the whole new one.\n\n// Temporary path for an atomic write of `destination`.\n//\n// It has to be a sibling of the destination, because `rename` is only atomic\n// within one filesystem and the system temp directory is often a different\n// mount. The final extension is dropped rather than kept, so the temporary\n// file cannot match a pattern written for the generated file's own extension.\n// That was load-bearing while `matchesWatchedFile` tested its globs\n// unanchored, where a leftover `vars.css.tmp` matched a `*.css` watch; it is\n// belt-and-braces now that the matcher anchors and, like the globber Style\n// Dictionary reads sources with, does not match the leading dot this name\n// already starts with. Both stay, because a temporary file only outlives its\n// rename when a write failed, and hiding one costs a string. The pid and\n// counter make the name unique, so two writes of the same destination —\n// parallel platforms in one build, or two builds overlapping — never share a\n// temporary file.\nlet temporaryFileCounter = 0\n\n// Whether the freshly rendered `temporary` holds exactly what `destination`\n// already holds. A rebuild whose inputs did not change renders byte-identical\n// output, and renaming that over the destination is a filesystem event the\n// host bundler reacts to — which is the whole of the rebuild loop, since\n// consuming code imports the generated file and every regenerate is therefore\n// a module-graph change. Comparing the two files rather than the `data`\n// argument keeps this indifferent to whether the caller passed a string, a\n// buffer or a stream, and to the encoding it passed with it.\n//\n// A destination that cannot be read is not identical, which covers the\n// ordinary case of it not existing yet.\nasync function rendersWhatIsAlreadyThere(\n  temporary: string,\n  destination: string,\n): Promise<boolean> {\n  try {\n    const [existing, rendered] = await Promise.all([\n      fs.promises.readFile(destination),\n      fs.promises.readFile(temporary),\n    ])\n\n    return existing.equals(rendered)\n  } catch {\n    return false\n  }\n}\n\nfunction rendersWhatIsAlreadyThereSync(\n  temporary: string,\n  destination: string,\n): boolean {\n  try {\n    return fs.readFileSync(destination).equals(fs.readFileSync(temporary))\n  } catch {\n    return false\n  }\n}\n\nfunction temporaryPathFor(destination: string): string {\n  const extension = path.extname(destination)\n\n  return path.join(\n    path.dirname(destination),\n    `.${path.basename(destination, extension)}.${process.pid}.${temporaryFileCounter++}.tmp`,\n  )\n}\n\nconst writeFileAtomic: typeof fs.promises.writeFile = async (\n  file,\n  data,\n  options,\n) => {\n  // A file handle or descriptor is already-open state that a rename cannot\n  // stand in for, so only a path is written atomically.\n  if (typeof file !== 'string') {\n    return fs.promises.writeFile(file, data, options)\n  }\n\n  const temporary = temporaryPathFor(file)\n\n  try {\n    await fs.promises.writeFile(temporary, data, options)\n\n    // The check sits in front of the rename rather than in place of it: the\n    // temporary file is still written, so a destination that does need\n    // replacing is still replaced in one atomic step and a concurrent reader\n    // still never sees a partial file.\n    if (await rendersWhatIsAlreadyThere(temporary, file)) {\n      discardTemporaryFile(temporary)\n      return\n    }\n\n    await fs.promises.rename(temporary, file)\n  } catch (err) {\n    discardTemporaryFile(temporary)\n    throw err\n  }\n}\n\nconst writeFileSyncAtomic: typeof fs.writeFileSync = (file, data, options) => {\n  if (typeof file !== 'string') {\n    fs.writeFileSync(file, data, options)\n    return\n  }\n\n  const temporary = temporaryPathFor(file)\n\n  try {\n    fs.writeFileSync(temporary, data, options)\n\n    if (rendersWhatIsAlreadyThereSync(temporary, file)) {\n      discardTemporaryFile(temporary)\n      return\n    }\n\n    fs.renameSync(temporary, file)\n  } catch (err) {\n    discardTemporaryFile(temporary)\n    throw err\n  }\n}\n\n// `node:fs` with both write entry points swapped for their atomic\n// equivalents, handed to Style Dictionary as the volume it builds through.\n// Everything else — reads, `mkdir`, `access`, the `promises` namespace — is\n// inherited from `node:fs` unchanged, so only the moment a file becomes\n// visible to readers changes. Custom actions receive this volume too, so\n// whatever they emit is written the same way.\n//\n// It is assigned onto the instance rather than passed as the `volume`\n// constructor option on purpose: that option marks the volume as a custom\n// filesystem shim, which switches Style Dictionary's path resolution off for\n// every read as well.\n// `Object.create` is declared as returning `any`, so pinning the result to\n// `typeof fs` is a claim no type guard can replace. The prototype link is the\n// whole point — see the note above — so rebuilding this with a spread, which\n// copies own properties and drops the chain, is not a substitute.\n/* oxlint-disable typescript/no-unsafe-type-assertion */\nconst atomicVolume = Object.create(fs, {\n  promises: {\n    value: Object.create(fs.promises, {\n      writeFile: { value: writeFileAtomic },\n    }) as typeof fs.promises,\n  },\n  writeFileSync: { value: writeFileSyncAtomic },\n}) as typeof fs\n/* oxlint-enable typescript/no-unsafe-type-assertion */\n\n// A pattern is a glob when any of these appear in it. Deliberately the set\n// picomatch and tinyglobby act on, since those two are what match and expand\n// here — a path containing one of these characters literally is not\n// distinguishable from a pattern, and would not be matchable either.\nconst GLOB_CHARACTERS = /[!*?[\\]{}]/\n\n// The config extensions Style Dictionary loads with `import` rather than by\n// parsing the file — the `case` list in its own `loadFile`. They are the only\n// ones Node's permanent module cache applies to, and so the only ones this\n// plugin has to read on the build's behalf.\n//\n// Everything else Style Dictionary parses as JSON5, including `.json`, and\n// this list is what makes the plugin split the same way. Reading the two\n// halves apart is what silently unwatched a whole family of configurations:\n// a `.json5` or `.jsonc` file went down the import branch and failed there\n// while the build succeeded, and a `.json` file carrying a comment or a\n// trailing comma failed strict `JSON.parse` for the same reason.\nconst IMPORTED_CONFIG_EXTENSIONS = ['.js', '.mjs', '.ts']\n\n// A configuration as `resolveConfigs` hands it on: either the object the\n// consumer passed or the path it was read from, plus the directory relative\n// paths inside it resolve against.\ninterface ResolvedConfig {\n  config: Config | string\n  file?: string\n}\n\n// Whether a config path is one Style Dictionary imports rather than parses.\nfunction isImportedConfig(file: string): boolean {\n  return IMPORTED_CONFIG_EXTENSIONS.some((extension) =>\n    file.endsWith(extension),\n  )\n}\n\n// The leading run of a pattern that contains no glob character —\n// `/p/tokens` for `/p/tokens/**/*.json`. Registering it alongside the files\n// that match today is what makes a token file created tomorrow visible:\n// watching only the current matches can never see a path that did not exist\n// when the watcher was built.\nfunction staticParentOf(pattern: string): string {\n  const segments = pattern.split('/')\n  const firstGlob = segments.findIndex((segment) =>\n    GLOB_CHARACTERS.test(segment),\n  )\n\n  return firstGlob === -1\n    ? path.posix.dirname(pattern)\n    : segments.slice(0, firstGlob).join('/')\n}\n\n// A compile that is running right now, keyed by `buildKey`, so bundler\n// instances in one process wait on each other rather than each starting their\n// own.\n//\n// Generated token files are a side effect on the filesystem, not per-bundler\n// output, and one process routinely holds several instances of this plugin. A\n// single `vitest run` on a project with two test projects and browser mode\n// stands up five Vite servers — the root one, one per project, and one more\n// per project once its HTTP server listens — and every one of them runs\n// `buildStart`. `hasCompiled` cannot see any of that: it is closure state\n// inside the factory, so each instance has its own and each compiles.\n//\n// Module scope is the only place a shared answer can live, since the\n// instances know nothing about each other. It stays a claim about identical\n// work, never about identity: the key carries the root and the resolved\n// configurations, so one script building two packages shares nothing.\nconst compilesInFlight = new Map<string, Promise<void>>()\n\n// A stable identity for a set of resolved configurations, or `null` for one\n// that cannot have a stable identity at all.\n//\n// Functions are serialised by source rather than dropped, because a `format`\n// or `transform` written inline is exactly what distinguishes two otherwise\n// identical configurations — and `JSON.stringify` omits a function outright,\n// which would make two different builds look like one.\nfunction buildKey(root: string, resolved: ResolvedConfig[]): null | string {\n  try {\n    return JSON.stringify(\n      [root, resolved.map((item) => item.file ?? item.config)],\n      (_key, value: unknown) =>\n        typeof value === 'function' ? `[fn]${String(value)}` : value,\n    )\n  } catch {\n    // A configuration that will not serialise — a circular reference, a\n    // BigInt — takes no shared identity rather than a wrong one, and compiles\n    // exactly as it did before.\n    return null\n  }\n}\n\nexport const unpluginFactory: UnpluginFactory<\n  undefined | UnpluginStyleDictionaryOptions,\n  false\n> = (options = {}, meta) => {\n  // webpack is the one target whose `buildStart` does not run before the\n  // module graph is resolved: unplugin taps it on `make`, an\n  // `AsyncParallelHook` that `EntryPlugin` taps too. The `webpack` key below\n  // compiles on `beforeCompile` instead, which webpack awaits before the\n  // compilation exists.\n  const isWebpack = meta.framework === 'webpack'\n  const {\n    failOnError = 'build',\n    logLevel,\n    root: rootOption,\n    silent = false,\n  } = options\n\n  // `silent` predates `logLevel` and names its quietest level, so it is read\n  // as one. `logLevel` wins when a consumer sets both.\n  const level = logLevel ?? (silent ? 'silent' : undefined)\n\n  // Whether the plugin keeps its own progress lines and size table to itself.\n  // A failure is reported at every level, which is why this gate is not on the\n  // error branch below.\n  const quiet = level === 'silent' || level === 'warn'\n\n  // What Style Dictionary is told, if anything. `undefined` is the point of\n  // this: it leaves whatever the consumer's own `log.verbosity` asked for\n  // standing, where the plugin used to overwrite it on every build. Style\n  // Dictionary has three levels to this option's four, so `'warn'` and\n  // `'info'` both map to its default — they differ in what the plugin itself\n  // says, not in what Style Dictionary does.\n  const verbosity =\n    level === undefined\n      ? undefined\n      : level === 'verbose'\n        ? 'verbose'\n        : level === 'silent'\n          ? 'silent'\n          : 'default'\n\n  // Whether a failure in this compile should be thrown rather than only\n  // reported. The two compiles are told apart by `runBuilds`'s `context`,\n  // which only the rebuild paths pass.\n  const failsTheBuild = (context: string | undefined): boolean =>\n    failOnError === true ||\n    (context === undefined ? failOnError === 'build' : failOnError === 'serve')\n  // Where a relative `config` path is looked up. The host sets it below\n  // unless the consumer named one, which is why an explicit option wins: a\n  // layout the host cannot describe is exactly what it is for.\n  let root = rootOption\n    ? path.resolve(process.cwd(), rootOption)\n    : process.cwd()\n\n  // Every absolute destination the last completed build wrote, spelled with\n  // forward slashes so it compares against a normalised watcher path. This is\n  // the half of the rebuild-loop guard that pattern matching cannot supply:\n  // output written under a watched directory matches the source glob that\n  // produced it, so without subtracting this set a supported layout rebuilds\n  // on its own writes for as long as the dev server runs.\n  const generatedDestinations = new Set<string>()\n\n  // The patterns the last `getWatchTargets` derived. `watchChange` tests a\n  // changed path against these before it resolves anything, so a file the\n  // plugin does not care about costs one glob match instead of a full config\n  // resolution — which, when `config` is a function, is the consumer's own\n  // code, and the place the README tells them to register custom formats.\n  //\n  // It is safe to filter on a list that may be one build out of date because\n  // the list always contains the config files themselves: an edit that adds a\n  // source matches as a config change, which re-resolves and re-derives. The\n  // one thing it cannot see is a `config` function that starts returning\n  // different sources with no file changing at all, and that was never\n  // observable without a rebuild to observe it in.\n  let cachedPatterns: string[] | undefined\n\n  // Whether `watchChange` has fired since the last `buildStart`, and whether\n  // anything has been compiled yet. Rollup, rolldown and webpack all run\n  // `watchChange` for every changed file and only then re-enter `buildStart`\n  // — unplugin's webpack adapter awaits both in one `make` tap — so a flag\n  // raised in the first is still standing in the second, and is what tells it\n  // this is a watch rebuild rather than the first build of the process.\n  let watchRebuild = false\n  let hasCompiled = false\n\n  // What a watcher is handed, and what a changed path is tested against, are\n  // not the same list, and conflating them is why a glob source was watched by\n  // nothing at all. Every watcher in play takes filenames rather than\n  // patterns: Vite's chokidar and rollup's `FileWatcher` are both constructed\n  // with `disableGlobbing: true`, Vite's `addWatchFile` drops anything that\n  // fails `fs.existsSync`, and webpack never globs `fileDependencies`. So the\n  // patterns stay for matching and the paths are expanded for registering.\n  const expandPatterns = async (patterns: string[]): Promise<string[]> => {\n    const paths = new Set<string>()\n    const globs: string[] = []\n\n    for (const pattern of patterns) {\n      if (GLOB_CHARACTERS.test(pattern)) {\n        globs.push(pattern)\n\n        // Watching the directory as well as its current contents. chokidar\n        // reports a creation inside a watched directory, which is the only\n        // way a token file added later is ever noticed.\n        const parent = staticParentOf(pattern)\n        if (parent && fs.existsSync(parent)) paths.add(parent)\n      } else {\n        paths.add(pattern)\n      }\n    }\n\n    if (globs.length > 0) {\n      try {\n        // tinyglobby matches with picomatch, which is what\n        // `matchesWatchedFile` tests with, so what is registered here and what\n        // is accepted there cannot disagree.\n        for (const match of await glob(globs, { absolute: true })) {\n          paths.add(match.replace(/\\\\/g, '/'))\n        }\n      } catch (err) {\n        log(`Failed to expand watch patterns: ${errorMessage(err)}`, 'error')\n      }\n    }\n\n    return Array.from(paths)\n  }\n\n  // Whether a changed file is a token or config source rather than something\n  // this plugin just wrote. Both watch entry points ask through here, so\n  // neither can react to its own output.\n  const isWatchedSource = (file: string, patterns: string[]): boolean =>\n    !generatedDestinations.has(file.replace(/\\\\/g, '/')) &&\n    matchesWatchedFile(file, patterns)\n\n  // Helper to log at the configured level\n  const log = (\n    message: string,\n    type: 'error' | 'info' | 'success' = 'info',\n  ) => {\n    const prefix = '[unplugin-style-dictionary]'\n\n    // Ahead of the `silent` gate on purpose. `silent` is about the progress\n    // lines and the size table; a compile that failed is not noise, and\n    // hiding it left a broken token set shipping with nothing said at all.\n    if (type === 'error') {\n      console.error(`\\x1b[31m${prefix} ${message}\\x1b[0m`)\n      return\n    }\n\n    if (quiet) return\n    if (type === 'success') {\n      console.log(`\\x1b[32m${prefix} ${message}\\x1b[0m`)\n    } else {\n      console.log(`\\x1b[36m${prefix} ${message}\\x1b[0m`)\n    }\n  }\n\n  // Resolve config file paths / objects\n  const resolveConfigs = async (): Promise<ResolvedConfig[]> => {\n    let rawConfig = options.config\n\n    // If config is not defined, look for default configuration files\n    if (!rawConfig) {\n      const defaults = [\n        'sd.config.json',\n        'config.json',\n        'sd.config.js',\n        'sd.config.mjs',\n      ]\n      for (const file of defaults) {\n        const fullPath = path.resolve(root, file)\n        if (fs.existsSync(fullPath)) {\n          rawConfig = file\n          break\n        }\n      }\n    }\n\n    if (!rawConfig) {\n      log(\n        'No configuration specified and no default config file found. Style Dictionary will not compile.',\n        'error',\n      )\n      return []\n    }\n\n    // Evaluate function if provided\n    if (typeof rawConfig === 'function') {\n      rawConfig = await rawConfig()\n    }\n\n    const configs = Array.isArray(rawConfig) ? rawConfig : [rawConfig]\n\n    return configs.map((conf) => {\n      if (typeof conf === 'string') {\n        const fullPath = path.resolve(root, conf)\n        return { config: fullPath, file: fullPath }\n      } else {\n        return { config: conf }\n      }\n    })\n  }\n\n  // Imports a config module, re-evaluating it only when the file itself has\n  // changed. The query string is what decides that, and it is not decoration:\n  // Node's ESM cache is permanent and keyed on the specifier, so a config\n  // imported without one is evaluated once and never read again — which is\n  // how an edited `.mjs` config went on building the platform map the process\n  // started with, for the rest of the session.\n  //\n  // `Date.now()` fixed that staleness and bought two problems. Every watcher\n  // event registered another module record in a map nothing prunes, re-running\n  // the config's own `registerFormat` side effects for a file nobody touched.\n  // And its millisecond granularity meant an edit landing inside the same\n  // millisecond as the previous import shared that import's key, and was\n  // served the old module anyway. `mtimeMs` carries sub-millisecond\n  // resolution and only moves when the file does.\n  const importConfigModule = async (file: string): Promise<unknown> => {\n    let version: number\n    try {\n      version = fs.statSync(file).mtimeMs\n    } catch {\n      // A config that cannot be stat'd is about to fail its import too. The\n      // old key is what keeps that failure the import's to report.\n      version = Date.now()\n    }\n\n    // The dot goes, and that is not cosmetic. `mtimeMs` is fractional, so the\n    // query it produces ends in something that reads as a file extension to\n    // anything deriving a loader from the specifier without stripping the\n    // query first — `sd.config.ts?t=1789565080284.6606` is then a `.6606`\n    // file, and a TypeScript config gets parsed as JavaScript. Replacing the\n    // one dot keeps every distinct mtime a distinct key.\n    const key = String(version).replace('.', '_')\n\n    // Sequential on purpose: a config module runs arbitrary code at import\n    // time — `registerFormat` and friends — and Style Dictionary's registries\n    // are global, so importing several at once would interleave those\n    // registrations.\n    return unwrapDefault(await import(`${pathToFileURL(file).href}?t=${key}`))\n  }\n\n  // What a configuration item says, as an object. `report` is what stops the\n  // two readers of this from saying the same thing twice: a bad config has\n  // nowhere else to surface when the watch list is being built, while a build\n  // falls back to handing Style Dictionary the path and lets its message\n  // through instead.\n  const readConfigObject = async (\n    item: ResolvedConfig,\n    report: boolean,\n  ): Promise<Config | null> => {\n    if (typeof item.config !== 'string') return item.config\n\n    try {\n      // JSON5 rather than `JSON.parse`, because that is what Style Dictionary\n      // reads these files with — it is a superset, so a plain `.json` config\n      // parses identically and one carrying a comment stops being a config\n      // the build understands and the watch list does not.\n      const loaded: unknown = isImportedConfig(item.config)\n        ? await importConfigModule(item.config)\n        : JSON5.parse(fs.readFileSync(item.config, 'utf-8'))\n\n      if (isConfig(loaded)) return loaded\n\n      if (report) {\n        log(\n          `Config file did not resolve to a configuration object: ${item.config}`,\n          'error',\n        )\n      }\n    } catch (err) {\n      if (report) {\n        log(\n          `Failed to parse config file: ${item.config}. Error: ${errorMessage(err)}`,\n          'error',\n        )\n      }\n    }\n\n    return null\n  }\n\n  // Parse token files to watch\n  const getWatchTargets = async (\n    resolvedConfigs: ResolvedConfig[],\n  ): Promise<{ paths: string[]; patterns: string[] }> => {\n    const filesToWatch = new Set<string>()\n\n    for (const item of resolvedConfigs) {\n      if (item.file) {\n        filesToWatch.add(item.file.replace(/\\\\/g, '/'))\n      }\n\n      const configObj = await readConfigObject(item, true)\n\n      if (configObj) {\n        const addPattern = (pattern: unknown) => {\n          if (typeof pattern === 'string') {\n            // Against the working directory, because that is where Style\n            // Dictionary resolves it: `combineJSON` globs each pattern with\n            // no `cwd` of its own. Resolving against the configuration file's\n            // directory instead is how the watch list came to name paths the\n            // build never reads — a configuration in a subdirectory built\n            // correctly and watched nothing at all.\n            const absolutePattern = path.isAbsolute(pattern)\n              ? pattern\n              : path.resolve(process.cwd(), pattern)\n            const normalized = absolutePattern.replace(/\\\\/g, '/')\n            filesToWatch.add(normalized)\n          }\n        }\n\n        if (configObj.source) {\n          if (Array.isArray(configObj.source)) {\n            configObj.source.forEach(addPattern)\n          } else {\n            addPattern(configObj.source)\n          }\n        }\n\n        if (configObj.include) {\n          if (Array.isArray(configObj.include)) {\n            configObj.include.forEach(addPattern)\n          } else {\n            addPattern(configObj.include)\n          }\n        }\n      }\n    }\n\n    // Add manually configured watch files\n    if (options.watch) {\n      const extraWatches = Array.isArray(options.watch)\n        ? options.watch\n        : [options.watch]\n      for (const pattern of extraWatches) {\n        const absolutePattern = path.isAbsolute(pattern)\n          ? pattern\n          : path.resolve(root, pattern)\n        filesToWatch.add(absolutePattern.replace(/\\\\/g, '/'))\n      }\n    }\n\n    const patterns = Array.from(filesToWatch)\n\n    // Recorded here rather than at each call site, so every path that derives\n    // a watch list refreshes the one `watchChange` filters against.\n    cachedPatterns = patterns\n\n    return { paths: await expandPatterns(patterns), patterns }\n  }\n\n  // What `new StyleDictionary` is handed for an item. Only a path in the JS\n  // family becomes an object, because those are exactly the extensions Style\n  // Dictionary's own `loadFile` reaches with `import` — the ones whose module\n  // record Node then caches forever, and so the only ones a build could read\n  // stale. The JSON5 family stays a path because there is nothing to gain:\n  // those are read from disk on every pass either way, so a build can never\n  // see one as it stood earlier in the process.\n  const configForBuild = async (\n    item: ResolvedConfig,\n  ): Promise<Config | string> => {\n    const { config } = item\n\n    if (typeof config !== 'string' || !isImportedConfig(config)) return config\n\n    const loaded = await readConfigObject(item, false)\n\n    // A config that could not be read falls back to the path, so the failure\n    // stays Style Dictionary's to report — it knows more about why an import\n    // failed than this does, a `.ts` config without type stripping especially.\n    if (!loaded) return item.config\n\n    // `loadFile` clones what it imports before handing it on, and passing an\n    // object skips that. It matters more here than it does there: the module\n    // record now outlives the build, and `extend` is called with\n    // `mutateOriginal`. Cloning throws on a config carrying functions — an\n    // inline transform — and Style Dictionary's own fallback in that case is\n    // to use the original, so this one matches it.\n    try {\n      return structuredClone(loaded)\n    } catch {\n      return loaded\n    }\n  }\n\n  // The size-and-gzip table, in a function of its own so that the compile\n  // `try` in `runBuilds` can stop before it. Everything here is presentation\n  // over files Style Dictionary has already finished writing, so a throw from\n  // it is a reporting bug and nothing more.\n  const reportSizes = (generatedFiles: Set<string>) => {\n    const fileInfos: Array<{\n      coloredPath: string\n      gzipSizeStr: string\n      relativeDisplayPath: string\n      sizeStr: string\n    }> = []\n\n    for (const filePath of generatedFiles) {\n      if (fs.existsSync(filePath)) {\n        const displayPath = path.relative(root, filePath).replace(/\\\\/g, '/')\n        const dir = path.dirname(displayPath)\n        const base = path.basename(displayPath)\n        const coloredPath =\n          dir === '.'\n            ? `\\x1b[32m${base}\\x1b[0m`\n            : `\\x1b[90m${dir}/\\x1b[0m\\x1b[32m${base}\\x1b[0m`\n\n        try {\n          const stats = fs.statSync(filePath)\n          const bytes = stats.size\n          const sizeStr = `${(bytes / 1024).toFixed(2)} kB`\n\n          const content = fs.readFileSync(filePath)\n          const gzipBytes = zlib.gzipSync(content).length\n          const gzipSizeStr = `${(gzipBytes / 1024).toFixed(2)} kB`\n\n          fileInfos.push({\n            coloredPath,\n            gzipSizeStr,\n            relativeDisplayPath: displayPath,\n            sizeStr,\n          })\n        } catch {\n          // One unreadable destination costs its row rather than the table.\n          // Deliberately narrower than the caller's `catch`: it covers the\n          // three filesystem and gzip calls above and not the arithmetic\n          // below, so a padding bug is reported rather than quietly printing\n          // short.\n        }\n      }\n    }\n\n    if (fileInfos.length > 0) {\n      const longestPathLength = Math.max(\n        ...fileInfos.map((f) => f.relativeDisplayPath.length),\n        0,\n      )\n      const longestSizeLength = Math.max(\n        ...fileInfos.map((f) => f.sizeStr.length),\n        0,\n      )\n\n      for (const info of fileInfos) {\n        const pathPadding = ' '.repeat(\n          Math.max(2, longestPathLength - info.relativeDisplayPath.length + 2),\n        )\n        const sizePadded = info.sizeStr.padStart(longestSizeLength)\n        console.log(\n          `${info.coloredPath}${pathPadding}\\x1b[90m${sizePadded} │ gzip: ${info.gzipSizeStr}\\x1b[0m`,\n        )\n      }\n    }\n  }\n\n  // Compile design tokens\n  const runBuilds = async (\n    resolvedConfigs: ResolvedConfig[],\n    context?: string,\n  ) => {\n    const startTime = Date.now()\n\n    // Ahead of the `try` rather than inside it, because the reporting below\n    // reads it and that reporting is deliberately outside.\n    const generatedFiles = new Set<string>()\n\n    try {\n      if (!context) {\n        log('Compiling design tokens...', 'info')\n      }\n\n      // Configurations are built one after another rather than with\n      // `Promise.all`, and that is load-bearing. Two configurations may name\n      // the same destination file, and each instance gets the atomic volume\n      // swapped onto it below — overlapping builds would interleave those\n      // writes and hand a reader a file assembled from both.\n      for (const item of resolvedConfigs) {\n        // `{ init: false }` is the escape hatch Style Dictionary documents on\n        // this constructor, and it is what makes a bad configuration\n        // catchable. Left to itself the constructor ends in a call to\n        // `init()` whose promise it neither stores nor returns, so a config\n        // that fails to load rejects a promise nobody holds: the `catch`\n        // below never runs, and the host dies with a raw stack or — where an\n        // `unhandledRejection` handler suppresses it — hangs on a\n        // `buildStart` that never settles. `await sd.hasInitialized` cannot\n        // observe it either, since that promise is only ever resolved, at the\n        // tail of a successful extend.\n        //\n        // It is handed the configuration as an object rather than as a path\n        // for the same reason: Style Dictionary imports a path with no\n        // cache-busting query of its own, so under a long-lived dev server\n        // every rebuild after the first built the config the process started\n        // with while the watch list followed the edit.\n        const sd = new StyleDictionary(await configForBuild(item), {\n          init: false,\n        })\n\n        // One initialisation rather than two. `init()` is `extend()` with\n        // `mutateOriginal`, so the old pair loaded the configuration and\n        // combined every source twice — running a custom parser or\n        // preprocessor twice with it — and the first of the two ran at\n        // default verbosity, which is how Style Dictionary's own warnings\n        // escaped this plugin's `silent`. `config` defaults to the one the\n        // constructor was handed.\n        //\n        // `verbosity` is `undefined` unless a consumer asked for a level, and\n        // Style Dictionary falls through an unset one to the configuration's\n        // own `log.verbosity`. Overwriting it here is what silenced the one\n        // line explaining why a build wrote nothing. `log.warnings` is not\n        // touched either way: a consumer's `warnings: 'error'` turning a\n        // missing output file into a thrown build is their decision.\n        await sd.extend(undefined, { mutateOriginal: true, verbosity })\n\n        // Swap in the atomic volume only now that the instance has finished\n        // reading its configs and token sources, so every write below lands\n        // through `rename` while the read path stays exactly as it was.\n        sd.volume = atomicVolume\n        await sd.buildAllPlatforms()\n\n        // Collected on every build rather than only on the ones whose size\n        // report prints it below. The set is also what keeps a rebuild from\n        // being triggered by the write it just made, and a rebuild passes a\n        // `context` — so gating the collection on `!context` left it empty on\n        // exactly the builds a watcher is live for.\n        for (const platform of Object.values(sd.platforms)) {\n          const buildPath = platform.buildPath ?? ''\n          for (const file of platform.files ?? []) {\n            if (file.destination) {\n              const absoluteBuildPath = path.isAbsolute(buildPath)\n                ? buildPath\n                : path.resolve(root, buildPath)\n              const absoluteDestination = path.isAbsolute(file.destination)\n                ? file.destination\n                : path.resolve(absoluteBuildPath, file.destination)\n              generatedFiles.add(absoluteDestination)\n            }\n          }\n        }\n      }\n\n      // Replaced wholesale rather than added to, so a destination dropped from\n      // a configuration stops being treated as ours and becomes watchable\n      // again. A build that throws never reaches this and leaves the previous\n      // set standing, which is the safe direction: the files it wrote before\n      // failing are still ours.\n      generatedDestinations.clear()\n      for (const destination of generatedFiles) {\n        generatedDestinations.add(destination.replace(/\\\\/g, '/'))\n      }\n    } catch (err) {\n      const duration = Date.now() - startTime\n      log(\n        `Compilation failed after ${duration}ms: ${errorMessage(err)}`,\n        'error',\n      )\n\n      // Reported, and then rethrown so the host stops. Swallowing it left\n      // every target exiting 0 with the previous run's tokens still on disk\n      // and in the bundle — a green build shipping stale values.\n      if (failsTheBuild(context)) throw err\n\n      // Explicit, now that the reporting below sits outside the `try`. This\n      // `catch` used to end the function by falling off the end of it; a\n      // failure that is not rethrown would otherwise carry on to announce a\n      // compile that did not happen.\n      return\n    }\n\n    // The `try` ends above, and everything from here down is reporting. Style\n    // Dictionary has finished writing by now and `generatedDestinations` is\n    // already replaced, so nothing below can put a file on disk in doubt —\n    // which is why a throw from it must not be caught as a compile failure.\n    // It used to be: a fault in the padding arithmetic printed `Compilation\n    // failed after 19ms` over a build whose every token file was correct, and\n    // with `failOnError` defaulting to `'build'` that stopped the bundler.\n    const duration = Date.now() - startTime\n\n    if (context) {\n      log(\n        `Rebuilt design tokens due to change in ${context} (${duration}ms)`,\n        'success',\n      )\n      return\n    }\n\n    if (!quiet && generatedFiles.size > 0) {\n      try {\n        reportSizes(generatedFiles)\n      } catch (err) {\n        // At `'error'`, so it is said at every level including `silent`,\n        // exactly as a compile failure is — and worded so it cannot be read\n        // as one. Not rethrown: the build succeeded.\n        log(\n          `Failed to report generated file sizes: ${errorMessage(err)}`,\n          'error',\n        )\n      }\n    }\n\n    log(`Compiled successfully! (${duration}ms)`, 'success')\n  }\n\n  // `runBuilds` for the first build of a process, with the compile shared\n  // between every plugin instance that wants the same one.\n  //\n  // An instance arriving while a compile for the same key is running waits on\n  // that compile instead of starting a second. It is the concurrent half that\n  // needs this: an up-to-date check compares what is on disk against the\n  // sources, and two instances that start together have nothing on disk to\n  // compare against yet, so only a shared promise can tell them apart from\n  // two genuinely separate builds.\n  //\n  // The entry is dropped as soon as the compile settles, so this coalesces\n  // rather than caches — a later `buildStart` still compiles. Skipping one\n  // whose output is already current is #212's up-to-date check, and belongs\n  // with it rather than as a second mechanism here.\n  //\n  // A rejection reaches every waiter, which is the point: an instance that\n  // waited on a failed compile must not carry on as though the tokens were\n  // written. Whether that rejection is thrown at all is `failOnError`'s\n  // decision, already made inside `runBuilds`.\n  const compileOnceAcrossInstances = async (\n    resolvedConfigs: ResolvedConfig[],\n  ): Promise<void> => {\n    const key = buildKey(root, resolvedConfigs)\n    if (key === null) {\n      await runBuilds(resolvedConfigs)\n      return\n    }\n\n    const running = compilesInFlight.get(key)\n    if (running) {\n      await running\n      return\n    }\n\n    const compile = runBuilds(resolvedConfigs)\n    compilesInFlight.set(key, compile)\n\n    try {\n      await compile\n    } finally {\n      compilesInFlight.delete(key)\n    }\n  }\n\n  // One rebuild per burst of watcher events, and never two at once.\n  //\n  // Two things went wrong without this. A single token edit under Vite's dev\n  // server reached both the `configureServer` listener and `watchChange` —\n  // Vite 6, 7 and 8 all invoke plugin `watchChange` while serving — and each\n  // started its own build, so one write produced two. And nothing serialised\n  // them: a four-file change started one build per file, all overlapping.\n  // `runBuilds` builds its configurations one after another precisely so two\n  // instances never write the same destination at once, and concurrent calls\n  // to it reintroduced that one level up.\n  //\n  // The trailing debounce collapses the burst; the in-flight chain means a\n  // trigger arriving mid-build queues exactly one follow-up rather than\n  // starting a second build beside it.\n  const REBUILD_DEBOUNCE_MS = 50\n\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n  let pendingReason: string | undefined\n  let inFlight: Promise<void> | undefined\n  let waiting: Array<(failure?: { error: unknown }) => void> = []\n\n  // Set by `configureServer`. A dev server's watcher is long-lived, so its\n  // list has to follow a configuration that changes; every other target\n  // re-registers on each build through `addWatchFile` instead.\n  let refreshServerWatchList:\n    | ((resolved: ResolvedConfig[]) => Promise<void>)\n    | undefined\n\n  const drain = async (): Promise<void> => {\n    // A loop rather than a single pass: anything scheduled while the build\n    // below is running is picked up here instead of starting a second one.\n    while (pendingReason !== undefined) {\n      const reason = pendingReason\n      pendingReason = undefined\n\n      // Captured before the await, so a trigger arriving mid-build waits for\n      // the next pass rather than being told this one covered it.\n      const resolvers = waiting\n      waiting = []\n\n      let failure: undefined | { error: unknown }\n      let compiling = false\n\n      try {\n        const resolved = await resolveConfigs()\n        if (resolved.length > 0) {\n          compiling = true\n          await runBuilds(resolved, reason)\n          compiling = false\n          hasCompiled = true\n          await refreshServerWatchList?.(resolved)\n        }\n      } catch (err) {\n        failure = { error: err }\n\n        // `runBuilds` reports its own failure before rethrowing, so only the\n        // other things that can throw here — a `config` function of the\n        // consumer's that raises, a watch list that cannot be rebuilt — need\n        // reporting.\n        if (!compiling) log(`Rebuild failed: ${errorMessage(err)}`, 'error')\n      }\n\n      // Handed on to whatever awaited this rebuild, which is `watchChange`\n      // and so the host under a watching bundler. Vite's dev-server listener\n      // has no build to fail and catches it.\n      for (const settle of resolvers) settle(failure)\n    }\n  }\n\n  // Resolves once a rebuild covering this trigger has finished.\n  const schedule = async (reason: string): Promise<void> => {\n    pendingReason = reason\n\n    const covered = new Promise<void>((resolve, reject) => {\n      waiting.push((failure) => {\n        if (failure) reject(asError(failure.error))\n        else resolve()\n      })\n    })\n\n    if (debounceTimer) clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      debounceTimer = undefined\n      inFlight = (inFlight ?? Promise.resolve()).then(drain)\n    }, REBUILD_DEBOUNCE_MS)\n\n    // A pending rebuild must not be what keeps a process alive; whatever is\n    // watching already is.\n    debounceTimer.unref()\n\n    return covered\n  }\n\n  return {\n    async buildStart() {\n      const resolved = await resolveConfigs()\n      if (resolved.length === 0) return\n\n      // Register token/config files with the host bundler's watch mode.\n      // Works out of the box wherever the host runs a persistent watcher\n      // (e.g. `rollup --watch`). Vite's dev server is additionally handled\n      // below via the `vite.configureServer` escape hatch — not because\n      // `watchChange` is missing there, which it is not on any Vite this\n      // package supports, but because the declared peer range is wider than\n      // what has been measured and the scheduler above makes a duplicate\n      // trigger free.\n      const { paths } = await getWatchTargets(resolved)\n      for (const file of paths) {\n        this.addWatchFile(file)\n      }\n\n      // Registering the watch list is all this hook does on webpack, and it\n      // has to happen here rather than beside the compile: `addWatchFile`\n      // reaches `compilation.fileDependencies`, and `beforeCompile` runs\n      // before there is a compilation to add to. Compiling here as well would\n      // put the race back, and run every webpack build twice.\n      if (isWebpack) return\n\n      // Every watch rebuild re-enters this hook, and compiling here as well as\n      // in `watchChange` is what closed the loop: consuming code imports the\n      // generated file, so writing it is itself a module-graph change, which\n      // re-enters `buildStart`, which writes it again. `watchChange` has\n      // already run for every file in this cycle and rebuilt if any of them\n      // was a source, so the only thing left for a re-entry to do is the\n      // re-registration above.\n      //\n      // `hasCompiled` is the floor under that: a host that fires\n      // `watchChange` without ever re-entering here would otherwise leave the\n      // flag standing, and no first compile of a process may ever be skipped —\n      // the tokens have to exist before the build that consumes them.\n      if (watchRebuild && hasCompiled) {\n        watchRebuild = false\n        return\n      }\n\n      await compileOnceAcrossInstances(resolved)\n      hasCompiled = true\n    },\n\n    name: 'unplugin-style-dictionary',\n\n    vite: {\n      configResolved(config) {\n        if (rootOption === undefined) root = config.root || process.cwd()\n      },\n\n      async configureServer(server: ViteDevServer) {\n        const resolved = await resolveConfigs()\n        if (resolved.length === 0) return\n\n        // Reassigned after every rebuild below, so a configuration that gains\n        // a source is matched against its new patterns rather than the ones\n        // read at start-up.\n        let targets = await getWatchTargets(resolved)\n\n        // Watch configuration files and token files\n        server.watcher.add(targets.paths)\n\n        // Runs once per rebuild rather than once per event, which is why it\n        // is handed to the scheduler rather than done in the listener.\n        refreshServerWatchList = async (rebuilt) => {\n          targets = await getWatchTargets(rebuilt)\n          server.watcher.add(targets.paths)\n        }\n\n        // chokidar types its listener as returning void and does not await\n        // what it is handed, so an async listener left every rejection\n        // floating. `schedule` owns the whole rebuild including its errors,\n        // so there is nothing here left to reject.\n        server.watcher.on('all', (_event, file) => {\n          if (!isWatchedSource(file, targets.patterns)) return\n\n          // A dev server has no build to fail, so a rebuild that throws is\n          // reported by the scheduler and the server keeps serving.\n          void schedule(path.basename(file)).catch(() => {})\n        })\n      },\n    },\n\n    // Rollup types `watchChange` as returning void, yet awaits it as a\n    // sequential hook — and the work here is inherently asynchronous. The\n    // signature is the thing that is wrong, so the rule is silenced rather\n    // than the hook made to lie about finishing.\n    // oxlint-disable-next-line typescript/no-misused-promises\n    async watchChange(id) {\n      // Raised before any decision about `id`, because whatever this change\n      // was, the host is now on its way back into `buildStart`.\n      watchRebuild = true\n\n      // The cheap half of the decision, taken before anything is resolved.\n      // Under Vite the scope this hook sees is the whole project root rather\n      // than the module graph, so most of what arrives here has nothing to do\n      // with tokens, and resolving every configuration only to discard the\n      // answer ran a consumer's `config` function once per unrelated file.\n      // Skipped until a build has derived a list to filter against.\n      if (cachedPatterns && !isWatchedSource(id, cachedPatterns)) return\n\n      const resolved = await resolveConfigs()\n      if (resolved.length === 0) return\n\n      // Derived again rather than trusted from the cache, because the cache\n      // is what decided this path was worth resolving and not what decides a\n      // rebuild. A config edit reaches here through its own filename and can\n      // have dropped the very source the cached list matched.\n      const { patterns } = await getWatchTargets(resolved)\n      // Without this check, watchChange fires for *any* changed file in the\n      // host bundler's module graph — including our own generated output,\n      // since consuming code imports it. Every regenerate is itself a\n      // \"change\", so skipping what is not a source here is what keeps this\n      // from rebuilding forever — both the files that match no pattern and\n      // the ones that match only because this plugin wrote them.\n      if (!isWatchedSource(id, patterns)) return\n\n      // Same division as `buildStart`: on webpack the compile belongs to\n      // `beforeCompile`, which has already run for this compilation, so all\n      // that is left is to re-register the watch list below.\n      if (!isWebpack) await schedule(path.basename(id))\n\n      // Expanded again after the build rather than reusing the list from\n      // before it, so a token file the build itself produced is registered.\n      for (const file of await expandPatterns(patterns)) {\n        this.addWatchFile(file)\n      }\n    },\n\n    // unplugin calls this inside `apply(compiler)`, one line before it taps\n    // `make`, so the root is in place before the first compile. Without it a\n    // webpack build whose `context` is not the working directory looked for\n    // the configuration in the wrong place and reported ENOENT.\n    webpack(compiler) {\n      if (rootOption === undefined) {\n        root = compiler.options.context ?? process.cwd()\n      }\n\n      // `beforeCompile` is awaited before the compilation exists, so the\n      // tokens are on disk before webpack resolves the module that imports\n      // them. Tapped on every compilation rather than only the first: a watch\n      // rebuild needs the same guarantee, and a compile that renders what is\n      // already there skips its own write.\n      compiler.hooks.beforeCompile.tapPromise(\n        'unplugin-style-dictionary',\n        async () => {\n          const resolved = await resolveConfigs()\n          if (resolved.length === 0) return\n\n          await compileOnceAcrossInstances(resolved)\n          hasCompiled = true\n        },\n      )\n    },\n  }\n}\n\nexport const unplugin = /* #__PURE__ */ createUnplugin(unpluginFactory)\n\nexport default unplugin\n"],"mappings":";;;;;;;;;;AAkDA,SAAgB,mBAAmB,MAAc,UAA6B;CAC5E,MAAM,iBAAiB,KAAK,QAAQ,OAAO,GAAG;CAE9C,OAAO,SAAS,MAAM,YAAY;EAChC,MAAM,oBAAoB,QAAQ,QAAQ,OAAO,GAAG;EAIpD,OACE,sBAAsB,kBACtB,UAAU,QAAQ,gBAAgB,iBAAiB;CAEvD,CAAC;AACH;AASA,SAAS,QAAQ,OAAuB;CACtC,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,aAAa,KAAK,CAAC;AACvE;AAIA,SAAS,qBAAqB,WAAyB;CACrD,IAAI;EACF,GAAG,OAAO,WAAW,EAAE,OAAO,KAAK,CAAC;CACtC,QAAQ,CAER;AACF;AAEA,SAAS,aAAa,OAAwB;CAC5C,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;AAOA,SAAS,SAAS,OAAiC;CACjD,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAKA,SAAS,cAAc,OAAyB;CAC9C,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,aAAa,QAC9D,MAAM,WAAW,QAClB;AACN;AA0BA,IAAI,uBAAuB;AAa3B,eAAe,0BACb,WACA,aACkB;CAClB,IAAI;EACF,MAAM,CAAC,UAAU,YAAY,MAAM,QAAQ,IAAI,CAC7C,GAAG,SAAS,SAAS,WAAW,GAChC,GAAG,SAAS,SAAS,SAAS,CAChC,CAAC;EAED,OAAO,SAAS,OAAO,QAAQ;CACjC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,8BACP,WACA,aACS;CACT,IAAI;EACF,OAAO,GAAG,aAAa,WAAW,CAAC,CAAC,OAAO,GAAG,aAAa,SAAS,CAAC;CACvE,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,iBAAiB,aAA6B;CACrD,MAAM,YAAY,KAAK,QAAQ,WAAW;CAE1C,OAAO,KAAK,KACV,KAAK,QAAQ,WAAW,GACxB,IAAI,KAAK,SAAS,aAAa,SAAS,EAAE,GAAG,QAAQ,IAAI,GAAG,uBAAuB,KACrF;AACF;AAEA,MAAM,kBAAgD,OACpD,MACA,MACA,YACG;CAGH,IAAI,OAAO,SAAS,UAClB,OAAO,GAAG,SAAS,UAAU,MAAM,MAAM,OAAO;CAGlD,MAAM,YAAY,iBAAiB,IAAI;CAEvC,IAAI;EACF,MAAM,GAAG,SAAS,UAAU,WAAW,MAAM,OAAO;EAMpD,IAAI,MAAM,0BAA0B,WAAW,IAAI,GAAG;GACpD,qBAAqB,SAAS;GAC9B;EACF;EAEA,MAAM,GAAG,SAAS,OAAO,WAAW,IAAI;CAC1C,SAAS,KAAK;EACZ,qBAAqB,SAAS;EAC9B,MAAM;CACR;AACF;AAEA,MAAM,uBAAgD,MAAM,MAAM,YAAY;CAC5E,IAAI,OAAO,SAAS,UAAU;EAC5B,GAAG,cAAc,MAAM,MAAM,OAAO;EACpC;CACF;CAEA,MAAM,YAAY,iBAAiB,IAAI;CAEvC,IAAI;EACF,GAAG,cAAc,WAAW,MAAM,OAAO;EAEzC,IAAI,8BAA8B,WAAW,IAAI,GAAG;GAClD,qBAAqB,SAAS;GAC9B;EACF;EAEA,GAAG,WAAW,WAAW,IAAI;CAC/B,SAAS,KAAK;EACZ,qBAAqB,SAAS;EAC9B,MAAM;CACR;AACF;AAkBA,MAAM,eAAe,OAAO,OAAO,IAAI;CACrC,UAAU,EACR,OAAO,OAAO,OAAO,GAAG,UAAU,EAChC,WAAW,EAAE,OAAO,gBAAgB,EACtC,CAAC,EACH;CACA,eAAe,EAAE,OAAO,oBAAoB;AAC9C,CAAC;AAOD,MAAM,kBAAkB;AAaxB,MAAM,6BAA6B;CAAC;CAAO;CAAQ;AAAK;AAWxD,SAAS,iBAAiB,MAAuB;CAC/C,OAAO,2BAA2B,MAAM,cACtC,KAAK,SAAS,SAAS,CACzB;AACF;AAOA,SAAS,eAAe,SAAyB;CAC/C,MAAM,WAAW,QAAQ,MAAM,GAAG;CAClC,MAAM,YAAY,SAAS,WAAW,YACpC,gBAAgB,KAAK,OAAO,CAC9B;CAEA,OAAO,cAAc,KACjB,KAAK,MAAM,QAAQ,OAAO,IAC1B,SAAS,MAAM,GAAG,SAAS,CAAC,CAAC,KAAK,GAAG;AAC3C;AAkBA,MAAM,mCAAmB,IAAI,IAA2B;AASxD,SAAS,SAAS,MAAc,UAA2C;CACzE,IAAI;EACF,OAAO,KAAK,UACV,CAAC,MAAM,SAAS,KAAK,SAAS,KAAK,QAAQ,KAAK,MAAM,CAAC,IACtD,MAAM,UACL,OAAO,UAAU,aAAa,OAAO,OAAO,KAAK,MAAM,KAC3D;CACF,QAAQ;EAIN,OAAO;CACT;AACF;AAEA,MAAa,mBAGR,UAAU,CAAC,GAAG,SAAS;CAM1B,MAAM,YAAY,KAAK,cAAc;CACrC,MAAM,EACJ,cAAc,SACd,UACA,MAAM,YACN,SAAS,UACP;CAIJ,MAAM,QAAQ,aAAa,SAAS,WAAW,KAAA;CAK/C,MAAM,QAAQ,UAAU,YAAY,UAAU;CAQ9C,MAAM,YACJ,UAAU,KAAA,IACN,KAAA,IACA,UAAU,YACR,YACA,UAAU,WACR,WACA;CAKV,MAAM,iBAAiB,YACrB,gBAAgB,SACf,YAAY,KAAA,IAAY,gBAAgB,UAAU,gBAAgB;CAIrE,IAAI,OAAO,aACP,KAAK,QAAQ,QAAQ,IAAI,GAAG,UAAU,IACtC,QAAQ,IAAI;CAQhB,MAAM,wCAAwB,IAAI,IAAY;CAc9C,IAAI;CAQJ,IAAI,eAAe;CACnB,IAAI,cAAc;CASlB,MAAM,iBAAiB,OAAO,aAA0C;EACtE,MAAM,wBAAQ,IAAI,IAAY;EAC9B,MAAM,QAAkB,CAAC;EAEzB,KAAK,MAAM,WAAW,UACpB,IAAI,gBAAgB,KAAK,OAAO,GAAG;GACjC,MAAM,KAAK,OAAO;GAKlB,MAAM,SAAS,eAAe,OAAO;GACrC,IAAI,UAAU,GAAG,WAAW,MAAM,GAAG,MAAM,IAAI,MAAM;EACvD,OACE,MAAM,IAAI,OAAO;EAIrB,IAAI,MAAM,SAAS,GACjB,IAAI;GAIF,KAAK,MAAM,SAAS,MAAM,KAAK,OAAO,EAAE,UAAU,KAAK,CAAC,GACtD,MAAM,IAAI,MAAM,QAAQ,OAAO,GAAG,CAAC;EAEvC,SAAS,KAAK;GACZ,IAAI,oCAAoC,aAAa,GAAG,KAAK,OAAO;EACtE;EAGF,OAAO,MAAM,KAAK,KAAK;CACzB;CAKA,MAAM,mBAAmB,MAAc,aACrC,CAAC,sBAAsB,IAAI,KAAK,QAAQ,OAAO,GAAG,CAAC,KACnD,mBAAmB,MAAM,QAAQ;CAGnC,MAAM,OACJ,SACA,OAAqC,WAClC;EACH,MAAM,SAAS;EAKf,IAAI,SAAS,SAAS;GACpB,QAAQ,MAAM,WAAW,OAAO,GAAG,QAAQ,QAAQ;GACnD;EACF;EAEA,IAAI,OAAO;EACX,IAAI,SAAS,WACX,QAAQ,IAAI,WAAW,OAAO,GAAG,QAAQ,QAAQ;OAEjD,QAAQ,IAAI,WAAW,OAAO,GAAG,QAAQ,QAAQ;CAErD;CAGA,MAAM,iBAAiB,YAAuC;EAC5D,IAAI,YAAY,QAAQ;EAGxB,IAAI,CAAC,WAOH,KAAK,MAAM,QAAQ;GALjB;GACA;GACA;GACA;EAEwB,GAAG;GAC3B,MAAM,WAAW,KAAK,QAAQ,MAAM,IAAI;GACxC,IAAI,GAAG,WAAW,QAAQ,GAAG;IAC3B,YAAY;IACZ;GACF;EACF;EAGF,IAAI,CAAC,WAAW;GACd,IACE,mGACA,OACF;GACA,OAAO,CAAC;EACV;EAGA,IAAI,OAAO,cAAc,YACvB,YAAY,MAAM,UAAU;EAK9B,QAFgB,MAAM,QAAQ,SAAS,IAAI,YAAY,CAAC,SAAS,EAAA,CAElD,KAAK,SAAS;GAC3B,IAAI,OAAO,SAAS,UAAU;IAC5B,MAAM,WAAW,KAAK,QAAQ,MAAM,IAAI;IACxC,OAAO;KAAE,QAAQ;KAAU,MAAM;IAAS;GAC5C,OACE,OAAO,EAAE,QAAQ,KAAK;EAE1B,CAAC;CACH;CAgBA,MAAM,qBAAqB,OAAO,SAAmC;EACnE,IAAI;EACJ,IAAI;GACF,UAAU,GAAG,SAAS,IAAI,CAAC,CAAC;EAC9B,QAAQ;GAGN,UAAU,KAAK,IAAI;EACrB;EAQA,MAAM,MAAM,OAAO,OAAO,CAAC,CAAC,QAAQ,KAAK,GAAG;EAM5C,OAAO,cAAc,MAAM,OAAO,GAAG,cAAc,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;CAC3E;CAOA,MAAM,mBAAmB,OACvB,MACA,WAC2B;EAC3B,IAAI,OAAO,KAAK,WAAW,UAAU,OAAO,KAAK;EAEjD,IAAI;GAKF,MAAM,SAAkB,iBAAiB,KAAK,MAAM,IAChD,MAAM,mBAAmB,KAAK,MAAM,IACpC,MAAM,MAAM,GAAG,aAAa,KAAK,QAAQ,OAAO,CAAC;GAErD,IAAI,SAAS,MAAM,GAAG,OAAO;GAE7B,IAAI,QACF,IACE,0DAA0D,KAAK,UAC/D,OACF;EAEJ,SAAS,KAAK;GACZ,IAAI,QACF,IACE,gCAAgC,KAAK,OAAO,WAAW,aAAa,GAAG,KACvE,OACF;EAEJ;EAEA,OAAO;CACT;CAGA,MAAM,kBAAkB,OACtB,oBACqD;EACrD,MAAM,+BAAe,IAAI,IAAY;EAErC,KAAK,MAAM,QAAQ,iBAAiB;GAClC,IAAI,KAAK,MACP,aAAa,IAAI,KAAK,KAAK,QAAQ,OAAO,GAAG,CAAC;GAGhD,MAAM,YAAY,MAAM,iBAAiB,MAAM,IAAI;GAEnD,IAAI,WAAW;IACb,MAAM,cAAc,YAAqB;KACvC,IAAI,OAAO,YAAY,UAAU;MAU/B,MAAM,cAHkB,KAAK,WAAW,OAAO,IAC3C,UACA,KAAK,QAAQ,QAAQ,IAAI,GAAG,OAAO,EAAA,CACJ,QAAQ,OAAO,GAAG;MACrD,aAAa,IAAI,UAAU;KAC7B;IACF;IAEA,IAAI,UAAU,QAAQ;KACpB,IAAI,MAAM,QAAQ,UAAU,MAAM,GAChC,UAAU,OAAO,QAAQ,UAAU;UAEnC,WAAW,UAAU,MAAM;IAE/B;IAEA,IAAI,UAAU,SAAS;KACrB,IAAI,MAAM,QAAQ,UAAU,OAAO,GACjC,UAAU,QAAQ,QAAQ,UAAU;UAEpC,WAAW,UAAU,OAAO;IAEhC;GACF;EACF;EAGA,IAAI,QAAQ,OAAO;GACjB,MAAM,eAAe,MAAM,QAAQ,QAAQ,KAAK,IAC5C,QAAQ,QACR,CAAC,QAAQ,KAAK;GAClB,KAAK,MAAM,WAAW,cAAc;IAClC,MAAM,kBAAkB,KAAK,WAAW,OAAO,IAC3C,UACA,KAAK,QAAQ,MAAM,OAAO;IAC9B,aAAa,IAAI,gBAAgB,QAAQ,OAAO,GAAG,CAAC;GACtD;EACF;EAEA,MAAM,WAAW,MAAM,KAAK,YAAY;EAIxC,iBAAiB;EAEjB,OAAO;GAAE,OAAO,MAAM,eAAe,QAAQ;GAAG;EAAS;CAC3D;CASA,MAAM,iBAAiB,OACrB,SAC6B;EAC7B,MAAM,EAAE,WAAW;EAEnB,IAAI,OAAO,WAAW,YAAY,CAAC,iBAAiB,MAAM,GAAG,OAAO;EAEpE,MAAM,SAAS,MAAM,iBAAiB,MAAM,KAAK;EAKjD,IAAI,CAAC,QAAQ,OAAO,KAAK;EAQzB,IAAI;GACF,OAAO,gBAAgB,MAAM;EAC/B,QAAQ;GACN,OAAO;EACT;CACF;CAMA,MAAM,eAAe,mBAAgC;EACnD,MAAM,YAKD,CAAC;EAEN,KAAK,MAAM,YAAY,gBACrB,IAAI,GAAG,WAAW,QAAQ,GAAG;GAC3B,MAAM,cAAc,KAAK,SAAS,MAAM,QAAQ,CAAC,CAAC,QAAQ,OAAO,GAAG;GACpE,MAAM,MAAM,KAAK,QAAQ,WAAW;GACpC,MAAM,OAAO,KAAK,SAAS,WAAW;GACtC,MAAM,cACJ,QAAQ,MACJ,WAAW,KAAK,WAChB,WAAW,IAAI,kBAAkB,KAAK;GAE5C,IAAI;IAGF,MAAM,UAAU,IAFF,GAAG,SAAS,QACR,CAAC,CAAC,OACQ,KAAA,CAAM,QAAQ,CAAC,EAAE;IAE7C,MAAM,UAAU,GAAG,aAAa,QAAQ;IAExC,MAAM,cAAc,IADF,KAAK,SAAS,OAAO,CAAC,CAAC,SACL,KAAA,CAAM,QAAQ,CAAC,EAAE;IAErD,UAAU,KAAK;KACb;KACA;KACA,qBAAqB;KACrB;IACF,CAAC;GACH,QAAQ,CAMR;EACF;EAGF,IAAI,UAAU,SAAS,GAAG;GACxB,MAAM,oBAAoB,KAAK,IAC7B,GAAG,UAAU,KAAK,MAAM,EAAE,oBAAoB,MAAM,GACpD,CACF;GACA,MAAM,oBAAoB,KAAK,IAC7B,GAAG,UAAU,KAAK,MAAM,EAAE,QAAQ,MAAM,GACxC,CACF;GAEA,KAAK,MAAM,QAAQ,WAAW;IAC5B,MAAM,cAAc,IAAI,OACtB,KAAK,IAAI,GAAG,oBAAoB,KAAK,oBAAoB,SAAS,CAAC,CACrE;IACA,MAAM,aAAa,KAAK,QAAQ,SAAS,iBAAiB;IAC1D,QAAQ,IACN,GAAG,KAAK,cAAc,YAAY,UAAU,WAAW,WAAW,KAAK,YAAY,QACrF;GACF;EACF;CACF;CAGA,MAAM,YAAY,OAChB,iBACA,YACG;EACH,MAAM,YAAY,KAAK,IAAI;EAI3B,MAAM,iCAAiB,IAAI,IAAY;EAEvC,IAAI;GACF,IAAI,CAAC,SACH,IAAI,8BAA8B,MAAM;GAQ1C,KAAK,MAAM,QAAQ,iBAAiB;IAiBlC,MAAM,KAAK,IAAI,gBAAgB,MAAM,eAAe,IAAI,GAAG,EACzD,MAAM,MACR,CAAC;IAgBD,MAAM,GAAG,OAAO,KAAA,GAAW;KAAE,gBAAgB;KAAM;IAAU,CAAC;IAK9D,GAAG,SAAS;IACZ,MAAM,GAAG,kBAAkB;IAO3B,KAAK,MAAM,YAAY,OAAO,OAAO,GAAG,SAAS,GAAG;KAClD,MAAM,YAAY,SAAS,aAAa;KACxC,KAAK,MAAM,QAAQ,SAAS,SAAS,CAAC,GACpC,IAAI,KAAK,aAAa;MACpB,MAAM,oBAAoB,KAAK,WAAW,SAAS,IAC/C,YACA,KAAK,QAAQ,MAAM,SAAS;MAChC,MAAM,sBAAsB,KAAK,WAAW,KAAK,WAAW,IACxD,KAAK,cACL,KAAK,QAAQ,mBAAmB,KAAK,WAAW;MACpD,eAAe,IAAI,mBAAmB;KACxC;IAEJ;GACF;GAOA,sBAAsB,MAAM;GAC5B,KAAK,MAAM,eAAe,gBACxB,sBAAsB,IAAI,YAAY,QAAQ,OAAO,GAAG,CAAC;EAE7D,SAAS,KAAK;GACZ,MAAM,WAAW,KAAK,IAAI,IAAI;GAC9B,IACE,4BAA4B,SAAS,MAAM,aAAa,GAAG,KAC3D,OACF;GAKA,IAAI,cAAc,OAAO,GAAG,MAAM;GAMlC;EACF;EASA,MAAM,WAAW,KAAK,IAAI,IAAI;EAE9B,IAAI,SAAS;GACX,IACE,0CAA0C,QAAQ,IAAI,SAAS,MAC/D,SACF;GACA;EACF;EAEA,IAAI,CAAC,SAAS,eAAe,OAAO,GAClC,IAAI;GACF,YAAY,cAAc;EAC5B,SAAS,KAAK;GAIZ,IACE,0CAA0C,aAAa,GAAG,KAC1D,OACF;EACF;EAGF,IAAI,2BAA2B,SAAS,MAAM,SAAS;CACzD;CAqBA,MAAM,6BAA6B,OACjC,oBACkB;EAClB,MAAM,MAAM,SAAS,MAAM,eAAe;EAC1C,IAAI,QAAQ,MAAM;GAChB,MAAM,UAAU,eAAe;GAC/B;EACF;EAEA,MAAM,UAAU,iBAAiB,IAAI,GAAG;EACxC,IAAI,SAAS;GACX,MAAM;GACN;EACF;EAEA,MAAM,UAAU,UAAU,eAAe;EACzC,iBAAiB,IAAI,KAAK,OAAO;EAEjC,IAAI;GACF,MAAM;EACR,UAAU;GACR,iBAAiB,OAAO,GAAG;EAC7B;CACF;CAgBA,MAAM,sBAAsB;CAE5B,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI,UAAyD,CAAC;CAK9D,IAAI;CAIJ,MAAM,QAAQ,YAA2B;EAGvC,OAAO,kBAAkB,KAAA,GAAW;GAClC,MAAM,SAAS;GACf,gBAAgB,KAAA;GAIhB,MAAM,YAAY;GAClB,UAAU,CAAC;GAEX,IAAI;GACJ,IAAI,YAAY;GAEhB,IAAI;IACF,MAAM,WAAW,MAAM,eAAe;IACtC,IAAI,SAAS,SAAS,GAAG;KACvB,YAAY;KACZ,MAAM,UAAU,UAAU,MAAM;KAChC,YAAY;KACZ,cAAc;KACd,MAAM,yBAAyB,QAAQ;IACzC;GACF,SAAS,KAAK;IACZ,UAAU,EAAE,OAAO,IAAI;IAMvB,IAAI,CAAC,WAAW,IAAI,mBAAmB,aAAa,GAAG,KAAK,OAAO;GACrE;GAKA,KAAK,MAAM,UAAU,WAAW,OAAO,OAAO;EAChD;CACF;CAGA,MAAM,WAAW,OAAO,WAAkC;EACxD,gBAAgB;EAEhB,MAAM,UAAU,IAAI,SAAe,SAAS,WAAW;GACrD,QAAQ,MAAM,YAAY;IACxB,IAAI,SAAS,OAAO,QAAQ,QAAQ,KAAK,CAAC;SACrC,QAAQ;GACf,CAAC;EACH,CAAC;EAED,IAAI,eAAe,aAAa,aAAa;EAC7C,gBAAgB,iBAAiB;GAC/B,gBAAgB,KAAA;GAChB,YAAY,YAAY,QAAQ,QAAQ,EAAA,CAAG,KAAK,KAAK;EACvD,GAAG,mBAAmB;EAItB,cAAc,MAAM;EAEpB,OAAO;CACT;CAEA,OAAO;EACL,MAAM,aAAa;GACjB,MAAM,WAAW,MAAM,eAAe;GACtC,IAAI,SAAS,WAAW,GAAG;GAU3B,MAAM,EAAE,UAAU,MAAM,gBAAgB,QAAQ;GAChD,KAAK,MAAM,QAAQ,OACjB,KAAK,aAAa,IAAI;GAQxB,IAAI,WAAW;GAcf,IAAI,gBAAgB,aAAa;IAC/B,eAAe;IACf;GACF;GAEA,MAAM,2BAA2B,QAAQ;GACzC,cAAc;EAChB;EAEA,MAAM;EAEN,MAAM;GACJ,eAAe,QAAQ;IACrB,IAAI,eAAe,KAAA,GAAW,OAAO,OAAO,QAAQ,QAAQ,IAAI;GAClE;GAEA,MAAM,gBAAgB,QAAuB;IAC3C,MAAM,WAAW,MAAM,eAAe;IACtC,IAAI,SAAS,WAAW,GAAG;IAK3B,IAAI,UAAU,MAAM,gBAAgB,QAAQ;IAG5C,OAAO,QAAQ,IAAI,QAAQ,KAAK;IAIhC,yBAAyB,OAAO,YAAY;KAC1C,UAAU,MAAM,gBAAgB,OAAO;KACvC,OAAO,QAAQ,IAAI,QAAQ,KAAK;IAClC;IAMA,OAAO,QAAQ,GAAG,QAAQ,QAAQ,SAAS;KACzC,IAAI,CAAC,gBAAgB,MAAM,QAAQ,QAAQ,GAAG;KAI9C,SAAc,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;GACH;EACF;EAOA,MAAM,YAAY,IAAI;GAGpB,eAAe;GAQf,IAAI,kBAAkB,CAAC,gBAAgB,IAAI,cAAc,GAAG;GAE5D,MAAM,WAAW,MAAM,eAAe;GACtC,IAAI,SAAS,WAAW,GAAG;GAM3B,MAAM,EAAE,aAAa,MAAM,gBAAgB,QAAQ;GAOnD,IAAI,CAAC,gBAAgB,IAAI,QAAQ,GAAG;GAKpC,IAAI,CAAC,WAAW,MAAM,SAAS,KAAK,SAAS,EAAE,CAAC;GAIhD,KAAK,MAAM,QAAQ,MAAM,eAAe,QAAQ,GAC9C,KAAK,aAAa,IAAI;EAE1B;EAMA,QAAQ,UAAU;GAChB,IAAI,eAAe,KAAA,GACjB,OAAO,SAAS,QAAQ,WAAW,QAAQ,IAAI;GAQjD,SAAS,MAAM,cAAc,WAC3B,6BACA,YAAY;IACV,MAAM,WAAW,MAAM,eAAe;IACtC,IAAI,SAAS,WAAW,GAAG;IAE3B,MAAM,2BAA2B,QAAQ;IACzC,cAAc;GAChB,CACF;EACF;CACF;AACF;AAEA,MAAa,WAA2B,+BAAe,eAAe"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Config } from 'style-dictionary'\nimport type { UnpluginFactory } from 'unplugin'\nimport type { ViteDevServer } from 'vite'\n\nimport JSON5 from 'json5'\nimport fs from 'node:fs'\nimport path from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport zlib from 'node:zlib'\nimport picomatch from 'picomatch'\nimport StyleDictionary from 'style-dictionary'\nimport { glob } from 'tinyglobby'\nimport { createUnplugin } from 'unplugin'\n\nimport type { UnpluginStyleDictionaryOptions } from './types.js'\n\nexport type * from './types.js'\n\n// Whether `file` matches one of the resolved config/token watch patterns.\n// Shared by the Vite-specific `configureServer` watcher and the universal\n// `watchChange` hook — both need it, and both must skip files that don't\n// match: without this filter, `watchChange` reacts to *any* changed\n// module-graph file, including this plugin's own generated output (since\n// consuming code imports it). Every regenerate is itself a \"change\", which\n// without filtering re-triggers a rebuild forever.\n//\n// Matching a pattern is only half of that, and this function is only the half\n// it can answer. A `buildPath` inside a `source` directory is a supported\n// layout, and under any correct matcher its output matches the very glob that\n// produced it — so the caller also subtracts what the last build wrote. See\n// `generatedDestinations` and `isWatchedSource` in the factory below.\n//\n// The patterns are Style Dictionary's own `source` and `include` globs, so the\n// filter has to admit exactly what the build reads — which is why the matching\n// is a real globber's rather than hand-rolled. The version this replaces was\n// wrong in both directions at once: it stripped `/**` out of a pattern and\n// prefix-matched the remainder, so `tokens/**/*.json` matched nothing sitting\n// directly in `tokens/` and `tokens/**` matched a `tokens-backup/` sibling,\n// while its regex branch mapped every `*` to `.*` — crossing `/` — and tested\n// it unanchored, so generated output under a watched directory matched its own\n// source glob and rebuilt forever.\n//\n// picomatch rather than `path.matchesGlob`, which would need no dependency at\n// all: that function is documented experimental, and on Node 20 — the floor\n// `engines` declares — it prints `ExperimentalWarning: glob is an experimental\n// feature and might change at any time` into the consumer's build output. The\n// dependency is free in practice, since `unplugin` depends on the same\n// picomatch and is already installed wherever this plugin is. Its `dot: false`\n// default is deliberate: it is what glob, and so Style Dictionary, reads\n// sources with, so a dotfile is invisible to the filter and to the build alike.\nexport function matchesWatchedFile(file: string, patterns: string[]): boolean {\n  const normalizedFile = file.replace(/\\\\/g, '/')\n\n  return patterns.some((pattern) => {\n    const normalizedPattern = pattern.replace(/\\\\/g, '/')\n\n    // A config file reaches this function as its own literal path, which is\n    // both the common case and the one shape that is not a glob at all.\n    return (\n      normalizedPattern === normalizedFile ||\n      picomatch.isMatch(normalizedFile, normalizedPattern)\n    )\n  })\n}\n\n// `catch` binds `unknown`, and a thrown non-Error — a string, a rejected\n// value out of a config module — carries no `.message`. The `as Error` casts\n// this replaces claimed otherwise and printed `undefined` for exactly those\n// cases, which is the least useful thing a failure log can say.\n// A rejected promise must carry an Error, and `catch` binds `unknown`. What\n// Style Dictionary throws is already one; anything else is wrapped rather than\n// handed on raw.\nfunction asError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(errorMessage(error))\n}\n\n// Best-effort cleanup of a temporary file whose write or rename failed. The\n// original failure is what the caller reports, so nothing here may throw.\nfunction discardTemporaryFile(temporary: string): void {\n  try {\n    fs.rmSync(temporary, { force: true })\n  } catch {\n    // Ignore: a leftover temporary file is not worth masking the real error.\n  }\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error)\n}\n\n// A config file is an untyped boundary: `JSON.parse` and a dynamic `import`\n// both hand back `any`, and an `any` assigned to `configObj` spreads through\n// every read of it downstream. These two narrow that boundary once, here.\n// They are type predicates rather than assertions on purpose — a predicate is\n// a check the compiler verifies, where a cast is only a claim.\nfunction isConfig(value: unknown): value is Config {\n  return typeof value === 'object' && value !== null\n}\n\n// A config module may expose its config as a `default` export or as the\n// namespace itself. `'default' in value` is what lets the compiler reach\n// `.default` without a cast.\nfunction unwrapDefault(value: unknown): unknown {\n  return typeof value === 'object' && value !== null && 'default' in value\n    ? (value.default ?? value)\n    : value\n}\n\n// Style Dictionary writes every generated file with a plain `writeFile` on the\n// volume it was handed, which truncates the destination and then streams the\n// new contents into it. Anything reading that file inside the window sees a\n// partial file: a consuming test run whose tokens are rebuilt mid-suite, or a\n// dev-server request landing on a rebuild, gets a truncated module and fails\n// to parse it. Writing a sibling temporary file and renaming it over the\n// destination closes the window — `rename` is atomic within a filesystem, so a\n// concurrent reader sees either the whole old file or the whole new one.\n\n// Temporary path for an atomic write of `destination`.\n//\n// It has to be a sibling of the destination, because `rename` is only atomic\n// within one filesystem and the system temp directory is often a different\n// mount. The final extension is dropped rather than kept, so the temporary\n// file cannot match a pattern written for the generated file's own extension.\n// That was load-bearing while `matchesWatchedFile` tested its globs\n// unanchored, where a leftover `vars.css.tmp` matched a `*.css` watch; it is\n// belt-and-braces now that the matcher anchors and, like the globber Style\n// Dictionary reads sources with, does not match the leading dot this name\n// already starts with. Both stay, because a temporary file only outlives its\n// rename when a write failed, and hiding one costs a string. The pid and\n// counter make the name unique, so two writes of the same destination —\n// parallel platforms in one build, or two builds overlapping — never share a\n// temporary file.\nlet temporaryFileCounter = 0\n\n// Whether the freshly rendered `temporary` holds exactly what `destination`\n// already holds. A rebuild whose inputs did not change renders byte-identical\n// output, and renaming that over the destination is a filesystem event the\n// host bundler reacts to — which is the whole of the rebuild loop, since\n// consuming code imports the generated file and every regenerate is therefore\n// a module-graph change. Comparing the two files rather than the `data`\n// argument keeps this indifferent to whether the caller passed a string, a\n// buffer or a stream, and to the encoding it passed with it.\n//\n// A destination that cannot be read is not identical, which covers the\n// ordinary case of it not existing yet.\nasync function rendersWhatIsAlreadyThere(\n  temporary: string,\n  destination: string,\n): Promise<boolean> {\n  try {\n    const [existing, rendered] = await Promise.all([\n      fs.promises.readFile(destination),\n      fs.promises.readFile(temporary),\n    ])\n\n    return existing.equals(rendered)\n  } catch {\n    return false\n  }\n}\n\nfunction rendersWhatIsAlreadyThereSync(\n  temporary: string,\n  destination: string,\n): boolean {\n  try {\n    return fs.readFileSync(destination).equals(fs.readFileSync(temporary))\n  } catch {\n    return false\n  }\n}\n\nfunction temporaryPathFor(destination: string): string {\n  const extension = path.extname(destination)\n\n  return path.join(\n    path.dirname(destination),\n    `.${path.basename(destination, extension)}.${process.pid}.${temporaryFileCounter++}.tmp`,\n  )\n}\n\nconst writeFileAtomic: typeof fs.promises.writeFile = async (\n  file,\n  data,\n  options,\n) => {\n  // A file handle or descriptor is already-open state that a rename cannot\n  // stand in for, so only a path is written atomically.\n  if (typeof file !== 'string') {\n    return fs.promises.writeFile(file, data, options)\n  }\n\n  const temporary = temporaryPathFor(file)\n\n  try {\n    await fs.promises.writeFile(temporary, data, options)\n\n    // The check sits in front of the rename rather than in place of it: the\n    // temporary file is still written, so a destination that does need\n    // replacing is still replaced in one atomic step and a concurrent reader\n    // still never sees a partial file.\n    if (await rendersWhatIsAlreadyThere(temporary, file)) {\n      discardTemporaryFile(temporary)\n      return\n    }\n\n    await fs.promises.rename(temporary, file)\n  } catch (err) {\n    discardTemporaryFile(temporary)\n    throw err\n  }\n}\n\nconst writeFileSyncAtomic: typeof fs.writeFileSync = (file, data, options) => {\n  if (typeof file !== 'string') {\n    fs.writeFileSync(file, data, options)\n    return\n  }\n\n  const temporary = temporaryPathFor(file)\n\n  try {\n    fs.writeFileSync(temporary, data, options)\n\n    if (rendersWhatIsAlreadyThereSync(temporary, file)) {\n      discardTemporaryFile(temporary)\n      return\n    }\n\n    fs.renameSync(temporary, file)\n  } catch (err) {\n    discardTemporaryFile(temporary)\n    throw err\n  }\n}\n\n// `node:fs` with both write entry points swapped for their atomic\n// equivalents, handed to Style Dictionary as the volume it builds through.\n// Everything else — reads, `mkdir`, `access`, the `promises` namespace — is\n// inherited from `node:fs` unchanged, so only the moment a file becomes\n// visible to readers changes. Custom actions receive this volume too, so\n// whatever they emit is written the same way.\n//\n// It is assigned onto the instance rather than passed as the `volume`\n// constructor option on purpose: that option marks the volume as a custom\n// filesystem shim, which switches Style Dictionary's path resolution off for\n// every read as well.\n// `Object.create` is declared as returning `any`, so pinning the result to\n// `typeof fs` is a claim no type guard can replace. The prototype link is the\n// whole point — see the note above — so rebuilding this with a spread, which\n// copies own properties and drops the chain, is not a substitute.\n/* oxlint-disable typescript/no-unsafe-type-assertion */\nconst atomicVolume = Object.create(fs, {\n  promises: {\n    value: Object.create(fs.promises, {\n      writeFile: { value: writeFileAtomic },\n    }) as typeof fs.promises,\n  },\n  writeFileSync: { value: writeFileSyncAtomic },\n}) as typeof fs\n/* oxlint-enable typescript/no-unsafe-type-assertion */\n\n// A pattern is a glob when any of these appear in it. Deliberately the set\n// picomatch and tinyglobby act on, since those two are what match and expand\n// here — a path containing one of these characters literally is not\n// distinguishable from a pattern, and would not be matchable either.\nconst GLOB_CHARACTERS = /[!*?[\\]{}]/\n\n// The config extensions Style Dictionary loads with `import` rather than by\n// parsing the file — the `case` list in its own `loadFile`. They are the only\n// ones Node's permanent module cache applies to, and so the only ones this\n// plugin has to read on the build's behalf.\n//\n// Everything else Style Dictionary parses as JSON5, including `.json`, and\n// this list is what makes the plugin split the same way. Reading the two\n// halves apart is what silently unwatched a whole family of configurations:\n// a `.json5` or `.jsonc` file went down the import branch and failed there\n// while the build succeeded, and a `.json` file carrying a comment or a\n// trailing comma failed strict `JSON.parse` for the same reason.\nconst IMPORTED_CONFIG_EXTENSIONS = ['.js', '.mjs', '.ts']\n\n// A configuration as `resolveConfigs` hands it on: either the object the\n// consumer passed or the path it was read from, plus the directory relative\n// paths inside it resolve against.\ninterface ResolvedConfig {\n  config: Config | string\n  file?: string\n}\n\n// Whether a config path is one Style Dictionary imports rather than parses.\nfunction isImportedConfig(file: string): boolean {\n  return IMPORTED_CONFIG_EXTENSIONS.some((extension) =>\n    file.endsWith(extension),\n  )\n}\n\n// The leading run of a pattern that contains no glob character —\n// `/p/tokens` for `/p/tokens/**/*.json`. Registering it alongside the files\n// that match today is what makes a token file created tomorrow visible:\n// watching only the current matches can never see a path that did not exist\n// when the watcher was built.\nfunction staticParentOf(pattern: string): string {\n  const segments = pattern.split('/')\n  const firstGlob = segments.findIndex((segment) =>\n    GLOB_CHARACTERS.test(segment),\n  )\n\n  return firstGlob === -1\n    ? path.posix.dirname(pattern)\n    : segments.slice(0, firstGlob).join('/')\n}\n\n// The fingerprints of configurations this process has compiled at least once.\n// It is what lets a configuration given as an object or a function be skipped\n// at all: such a configuration has no file to stat, so an edit to it inside\n// `vite.config.ts` moves no mtime and the filesystem cannot tell the two\n// apart. Having built it here, the plugin can — the fingerprint changes with\n// the configuration.\n//\n// Module scope rather than the factory's, for the same reason `compilesInFlight`\n// below is: the instances that would otherwise repeat the work are different\n// instances, so per-instance state cannot see them. A `vitest run` stands up\n// several, and a function configuration — the form the README recommends for\n// registering custom formats — would be the one form that never skipped.\n//\n// The fingerprint carries the root, so two projects in one process never share\n// one. A configuration given as a path needs none of this: its own file is one\n// of the sources the mtime comparison reads, so an edit to it is visible across\n// processes as well as within one.\nconst compiledFingerprints = new Set<string>()\n\n// A compile that is running right now, keyed by `buildKey`, so bundler\n// instances in one process wait on each other rather than each starting their\n// own.\n//\n// Generated token files are a side effect on the filesystem, not per-bundler\n// output, and one process routinely holds several instances of this plugin. A\n// single `vitest run` on a project with two test projects and browser mode\n// stands up five Vite servers — the root one, one per project, and one more\n// per project once its HTTP server listens — and every one of them runs\n// `buildStart`. `hasCompiled` cannot see any of that: it is closure state\n// inside the factory, so each instance has its own and each compiles.\n//\n// Module scope is the only place a shared answer can live, since the\n// instances know nothing about each other. It stays a claim about identical\n// work, never about identity: the key carries the root and the resolved\n// configurations, so one script building two packages shares nothing.\nconst compilesInFlight = new Map<string, Promise<void>>()\n\n// A stable identity for a set of resolved configurations, or `null` for one\n// that cannot have a stable identity at all.\n//\n// Functions are serialised by source rather than dropped, because a `format`\n// or `transform` written inline is exactly what distinguishes two otherwise\n// identical configurations — and `JSON.stringify` omits a function outright,\n// which would make two different builds look like one.\nfunction buildKey(root: string, resolved: ResolvedConfig[]): null | string {\n  try {\n    return JSON.stringify(\n      [root, resolved.map((item) => item.file ?? item.config)],\n      (_key, value: unknown) =>\n        typeof value === 'function' ? `[fn]${String(value)}` : value,\n    )\n  } catch {\n    // A configuration that will not serialise — a circular reference, a\n    // BigInt — takes no shared identity rather than a wrong one, and compiles\n    // exactly as it did before.\n    return null\n  }\n}\n\n// The patterns one configuration reads, resolved the way the build resolves\n// them. The same `source`/`include` walk `getWatchTargets` does, for one\n// item rather than the whole set — against the working directory, because\n// that is where Style Dictionary's own `combineJSON` globs them.\nfunction sourcePatternsOf(configObj: Config): string[] {\n  const patterns: string[] = []\n\n  const add = (pattern: unknown) => {\n    if (typeof pattern === 'string') {\n      patterns.push(\n        (path.isAbsolute(pattern)\n          ? pattern\n          : path.resolve(process.cwd(), pattern)\n        ).replace(/\\\\/g, '/'),\n      )\n    }\n  }\n\n  for (const value of [configObj.source, configObj.include]) {\n    if (Array.isArray(value)) value.forEach(add)\n    else add(value)\n  }\n\n  return patterns\n}\n\n// `fs.statSync` without the throw. A file that is missing, or that cannot be\n// read, is the same answer to every caller here: nothing to compare against.\nfunction statOrNull(file: string): fs.Stats | null {\n  try {\n    return fs.statSync(file)\n  } catch {\n    return null\n  }\n}\n\nexport const unpluginFactory: UnpluginFactory<\n  undefined | UnpluginStyleDictionaryOptions,\n  false\n> = (options = {}, meta) => {\n  // webpack is the one target whose `buildStart` does not run before the\n  // module graph is resolved: unplugin taps it on `make`, an\n  // `AsyncParallelHook` that `EntryPlugin` taps too. The `webpack` key below\n  // compiles on `beforeCompile` instead, which webpack awaits before the\n  // compilation exists.\n  const isWebpack = meta.framework === 'webpack'\n  const {\n    cache = true,\n    failOnError = 'build',\n    logLevel,\n    report = true,\n    root: rootOption,\n    silent = false,\n  } = options\n\n  // `silent` predates `logLevel` and names its quietest level, so it is read\n  // as one. `logLevel` wins when a consumer sets both.\n  const level = logLevel ?? (silent ? 'silent' : undefined)\n\n  // Whether the plugin keeps its own progress lines and size table to itself.\n  // A failure is reported at every level, which is why this gate is not on the\n  // error branch below.\n  const quiet = level === 'silent' || level === 'warn'\n\n  // What Style Dictionary is told, if anything. `undefined` is the point of\n  // this: it leaves whatever the consumer's own `log.verbosity` asked for\n  // standing, where the plugin used to overwrite it on every build. Style\n  // Dictionary has three levels to this option's four, so `'warn'` and\n  // `'info'` both map to its default — they differ in what the plugin itself\n  // says, not in what Style Dictionary does.\n  const verbosity =\n    level === undefined\n      ? undefined\n      : level === 'verbose'\n        ? 'verbose'\n        : level === 'silent'\n          ? 'silent'\n          : 'default'\n\n  // Whether a failure in this compile should be thrown rather than only\n  // reported. The two compiles are told apart by `runBuilds`'s `context`,\n  // which only the rebuild paths pass.\n  const failsTheBuild = (context: string | undefined): boolean =>\n    failOnError === true ||\n    (context === undefined ? failOnError === 'build' : failOnError === 'serve')\n  // Where a relative `config` path is looked up. The host sets it below\n  // unless the consumer named one, which is why an explicit option wins: a\n  // layout the host cannot describe is exactly what it is for.\n  let root = rootOption\n    ? path.resolve(process.cwd(), rootOption)\n    : process.cwd()\n\n  // Every absolute destination the last completed build wrote, spelled with\n  // forward slashes so it compares against a normalised watcher path. This is\n  // the half of the rebuild-loop guard that pattern matching cannot supply:\n  // output written under a watched directory matches the source glob that\n  // produced it, so without subtracting this set a supported layout rebuilds\n  // on its own writes for as long as the dev server runs.\n  const generatedDestinations = new Set<string>()\n\n  // The patterns the last `getWatchTargets` derived. `watchChange` tests a\n  // changed path against these before it resolves anything, so a file the\n  // plugin does not care about costs one glob match instead of a full config\n  // resolution — which, when `config` is a function, is the consumer's own\n  // code, and the place the README tells them to register custom formats.\n  //\n  // It is safe to filter on a list that may be one build out of date because\n  // the list always contains the config files themselves: an edit that adds a\n  // source matches as a config change, which re-resolves and re-derives. The\n  // one thing it cannot see is a `config` function that starts returning\n  // different sources with no file changing at all, and that was never\n  // observable without a rebuild to observe it in.\n  let cachedPatterns: string[] | undefined\n\n  // Whether `watchChange` has fired since the last `buildStart`, and whether\n  // anything has been compiled yet. Rollup, rolldown and webpack all run\n  // `watchChange` for every changed file and only then re-enter `buildStart`\n  // — unplugin's webpack adapter awaits both in one `make` tap — so a flag\n  // raised in the first is still standing in the second, and is what tells it\n  // this is a watch rebuild rather than the first build of the process.\n  let watchRebuild = false\n  let hasCompiled = false\n\n  // What a watcher is handed, and what a changed path is tested against, are\n  // not the same list, and conflating them is why a glob source was watched by\n  // nothing at all. Every watcher in play takes filenames rather than\n  // patterns: Vite's chokidar and rollup's `FileWatcher` are both constructed\n  // with `disableGlobbing: true`, Vite's `addWatchFile` drops anything that\n  // fails `fs.existsSync`, and webpack never globs `fileDependencies`. So the\n  // patterns stay for matching and the paths are expanded for registering.\n  const expandPatterns = async (patterns: string[]): Promise<string[]> => {\n    const paths = new Set<string>()\n    const globs: string[] = []\n\n    for (const pattern of patterns) {\n      if (GLOB_CHARACTERS.test(pattern)) {\n        globs.push(pattern)\n\n        // Watching the directory as well as its current contents. chokidar\n        // reports a creation inside a watched directory, which is the only\n        // way a token file added later is ever noticed.\n        const parent = staticParentOf(pattern)\n        if (parent && fs.existsSync(parent)) paths.add(parent)\n      } else {\n        paths.add(pattern)\n      }\n    }\n\n    if (globs.length > 0) {\n      try {\n        // tinyglobby matches with picomatch, which is what\n        // `matchesWatchedFile` tests with, so what is registered here and what\n        // is accepted there cannot disagree.\n        for (const match of await glob(globs, { absolute: true })) {\n          paths.add(match.replace(/\\\\/g, '/'))\n        }\n      } catch (err) {\n        log(`Failed to expand watch patterns: ${errorMessage(err)}`, 'error')\n      }\n    }\n\n    return Array.from(paths)\n  }\n\n  // Whether a changed file is a token or config source rather than something\n  // this plugin just wrote. Both watch entry points ask through here, so\n  // neither can react to its own output.\n  const isWatchedSource = (file: string, patterns: string[]): boolean =>\n    !generatedDestinations.has(file.replace(/\\\\/g, '/')) &&\n    matchesWatchedFile(file, patterns)\n\n  // Helper to log at the configured level\n  const log = (\n    message: string,\n    type: 'error' | 'info' | 'success' = 'info',\n  ) => {\n    const prefix = '[unplugin-style-dictionary]'\n\n    // Ahead of the `silent` gate on purpose. `silent` is about the progress\n    // lines and the size table; a compile that failed is not noise, and\n    // hiding it left a broken token set shipping with nothing said at all.\n    if (type === 'error') {\n      console.error(`\\x1b[31m${prefix} ${message}\\x1b[0m`)\n      return\n    }\n\n    if (quiet) return\n    if (type === 'success') {\n      console.log(`\\x1b[32m${prefix} ${message}\\x1b[0m`)\n    } else {\n      console.log(`\\x1b[36m${prefix} ${message}\\x1b[0m`)\n    }\n  }\n\n  // Resolve config file paths / objects\n  const resolveConfigs = async (): Promise<ResolvedConfig[]> => {\n    let rawConfig = options.config\n\n    // If config is not defined, look for default configuration files\n    if (!rawConfig) {\n      const defaults = [\n        'sd.config.json',\n        'config.json',\n        'sd.config.js',\n        'sd.config.mjs',\n      ]\n      for (const file of defaults) {\n        const fullPath = path.resolve(root, file)\n        if (fs.existsSync(fullPath)) {\n          rawConfig = file\n          break\n        }\n      }\n    }\n\n    if (!rawConfig) {\n      log(\n        'No configuration specified and no default config file found. Style Dictionary will not compile.',\n        'error',\n      )\n      return []\n    }\n\n    // Evaluate function if provided\n    if (typeof rawConfig === 'function') {\n      rawConfig = await rawConfig()\n    }\n\n    const configs = Array.isArray(rawConfig) ? rawConfig : [rawConfig]\n\n    return configs.map((conf) => {\n      if (typeof conf === 'string') {\n        const fullPath = path.resolve(root, conf)\n        return { config: fullPath, file: fullPath }\n      } else {\n        return { config: conf }\n      }\n    })\n  }\n\n  // Imports a config module, re-evaluating it only when the file itself has\n  // changed. The query string is what decides that, and it is not decoration:\n  // Node's ESM cache is permanent and keyed on the specifier, so a config\n  // imported without one is evaluated once and never read again — which is\n  // how an edited `.mjs` config went on building the platform map the process\n  // started with, for the rest of the session.\n  //\n  // `Date.now()` fixed that staleness and bought two problems. Every watcher\n  // event registered another module record in a map nothing prunes, re-running\n  // the config's own `registerFormat` side effects for a file nobody touched.\n  // And its millisecond granularity meant an edit landing inside the same\n  // millisecond as the previous import shared that import's key, and was\n  // served the old module anyway. `mtimeMs` carries sub-millisecond\n  // resolution and only moves when the file does.\n  const importConfigModule = async (file: string): Promise<unknown> => {\n    let version: number\n    try {\n      version = fs.statSync(file).mtimeMs\n    } catch {\n      // A config that cannot be stat'd is about to fail its import too. The\n      // old key is what keeps that failure the import's to report.\n      version = Date.now()\n    }\n\n    // The dot goes, and that is not cosmetic. `mtimeMs` is fractional, so the\n    // query it produces ends in something that reads as a file extension to\n    // anything deriving a loader from the specifier without stripping the\n    // query first — `sd.config.ts?t=1789565080284.6606` is then a `.6606`\n    // file, and a TypeScript config gets parsed as JavaScript. Replacing the\n    // one dot keeps every distinct mtime a distinct key.\n    const key = String(version).replace('.', '_')\n\n    // Sequential on purpose: a config module runs arbitrary code at import\n    // time — `registerFormat` and friends — and Style Dictionary's registries\n    // are global, so importing several at once would interleave those\n    // registrations.\n    return unwrapDefault(await import(`${pathToFileURL(file).href}?t=${key}`))\n  }\n\n  // What a configuration item says, as an object. `report` is what stops the\n  // two readers of this from saying the same thing twice: a bad config has\n  // nowhere else to surface when the watch list is being built, while a build\n  // falls back to handing Style Dictionary the path and lets its message\n  // through instead.\n  const readConfigObject = async (\n    item: ResolvedConfig,\n    reportErrors: boolean,\n  ): Promise<Config | null> => {\n    if (typeof item.config !== 'string') return item.config\n\n    try {\n      // JSON5 rather than `JSON.parse`, because that is what Style Dictionary\n      // reads these files with — it is a superset, so a plain `.json` config\n      // parses identically and one carrying a comment stops being a config\n      // the build understands and the watch list does not.\n      const loaded: unknown = isImportedConfig(item.config)\n        ? await importConfigModule(item.config)\n        : JSON5.parse(fs.readFileSync(item.config, 'utf-8'))\n\n      if (isConfig(loaded)) return loaded\n\n      if (reportErrors) {\n        log(\n          `Config file did not resolve to a configuration object: ${item.config}`,\n          'error',\n        )\n      }\n    } catch (err) {\n      if (reportErrors) {\n        log(\n          `Failed to parse config file: ${item.config}. Error: ${errorMessage(err)}`,\n          'error',\n        )\n      }\n    }\n\n    return null\n  }\n\n  // Parse token files to watch\n  const getWatchTargets = async (\n    resolvedConfigs: ResolvedConfig[],\n  ): Promise<{ paths: string[]; patterns: string[] }> => {\n    const filesToWatch = new Set<string>()\n\n    for (const item of resolvedConfigs) {\n      if (item.file) {\n        filesToWatch.add(item.file.replace(/\\\\/g, '/'))\n      }\n\n      const configObj = await readConfigObject(item, true)\n\n      if (configObj) {\n        const addPattern = (pattern: unknown) => {\n          if (typeof pattern === 'string') {\n            // Against the working directory, because that is where Style\n            // Dictionary resolves it: `combineJSON` globs each pattern with\n            // no `cwd` of its own. Resolving against the configuration file's\n            // directory instead is how the watch list came to name paths the\n            // build never reads — a configuration in a subdirectory built\n            // correctly and watched nothing at all.\n            const absolutePattern = path.isAbsolute(pattern)\n              ? pattern\n              : path.resolve(process.cwd(), pattern)\n            const normalized = absolutePattern.replace(/\\\\/g, '/')\n            filesToWatch.add(normalized)\n          }\n        }\n\n        if (configObj.source) {\n          if (Array.isArray(configObj.source)) {\n            configObj.source.forEach(addPattern)\n          } else {\n            addPattern(configObj.source)\n          }\n        }\n\n        if (configObj.include) {\n          if (Array.isArray(configObj.include)) {\n            configObj.include.forEach(addPattern)\n          } else {\n            addPattern(configObj.include)\n          }\n        }\n      }\n    }\n\n    // Add manually configured watch files\n    if (options.watch) {\n      const extraWatches = Array.isArray(options.watch)\n        ? options.watch\n        : [options.watch]\n      for (const pattern of extraWatches) {\n        const absolutePattern = path.isAbsolute(pattern)\n          ? pattern\n          : path.resolve(root, pattern)\n        filesToWatch.add(absolutePattern.replace(/\\\\/g, '/'))\n      }\n    }\n\n    const patterns = Array.from(filesToWatch)\n\n    // Recorded here rather than at each call site, so every path that derives\n    // a watch list refreshes the one `watchChange` filters against.\n    cachedPatterns = patterns\n\n    return { paths: await expandPatterns(patterns), patterns }\n  }\n\n  // What `new StyleDictionary` is handed for an item. Only a path in the JS\n  // family becomes an object, because those are exactly the extensions Style\n  // Dictionary's own `loadFile` reaches with `import` — the ones whose module\n  // record Node then caches forever, and so the only ones a build could read\n  // stale. The JSON5 family stays a path because there is nothing to gain:\n  // those are read from disk on every pass either way, so a build can never\n  // see one as it stood earlier in the process.\n  const configForBuild = async (\n    item: ResolvedConfig,\n  ): Promise<Config | string> => {\n    const { config } = item\n\n    if (typeof config !== 'string' || !isImportedConfig(config)) return config\n\n    const loaded = await readConfigObject(item, false)\n\n    // A config that could not be read falls back to the path, so the failure\n    // stays Style Dictionary's to report — it knows more about why an import\n    // failed than this does, a `.ts` config without type stripping especially.\n    if (!loaded) return item.config\n\n    // `loadFile` clones what it imports before handing it on, and passing an\n    // object skips that. It matters more here than it does there: the module\n    // record now outlives the build, and `extend` is called with\n    // `mutateOriginal`. Cloning throws on a config carrying functions — an\n    // inline transform — and Style Dictionary's own fallback in that case is\n    // to use the original, so this one matches it.\n    try {\n      return structuredClone(loaded)\n    } catch {\n      return loaded\n    }\n  }\n\n  // Every absolute destination a configuration declares, read off the\n  // configuration itself rather than off an extended Style Dictionary\n  // instance. Reading it here is the whole point: constructing the instance\n  // is what the skip exists to avoid.\n  //\n  // Resolved exactly as the build resolves it below, so the two name the same\n  // files — a relative `buildPath` against `root`, and a `destination`\n  // against that.\n  const declaredDestinations = (configObj: Config): string[] => {\n    const destinations: string[] = []\n\n    for (const platform of Object.values(configObj.platforms ?? {})) {\n      const buildPath = platform.buildPath ?? ''\n      const absoluteBuildPath = path.isAbsolute(buildPath)\n        ? buildPath\n        : path.resolve(root, buildPath)\n\n      for (const file of platform.files ?? []) {\n        if (file.destination) {\n          destinations.push(\n            path.isAbsolute(file.destination)\n              ? file.destination\n              : path.resolve(absoluteBuildPath, file.destination),\n          )\n        }\n      }\n    }\n\n    return destinations\n  }\n\n  // A stable identity for one resolved configuration, or `null` where it\n  // cannot have one. Functions are serialised by source rather than dropped,\n  // because an inline `format` or `transform` is exactly the edit a\n  // fingerprint has to notice, and `JSON.stringify` omits a function outright.\n  const configFingerprint = (item: ResolvedConfig): null | string => {\n    try {\n      return JSON.stringify(\n        [root, item.file ?? item.config],\n        (_key, value: unknown) =>\n          typeof value === 'function' ? `[fn]${String(value)}` : value,\n      )\n    } catch {\n      // Circular, or holding a BigInt. It takes no identity rather than a\n      // wrong one, so it compiles every time exactly as it did before.\n      return null\n    }\n  }\n\n  // Whether every file a configuration declares is already newer than every\n  // file it reads, so its compile can be skipped.\n  //\n  // Conservative in every direction it can be: anything it cannot establish —\n  // a destination that is missing, a source it cannot stat, a configuration\n  // declaring no destinations at all — is a reason to build rather than to\n  // skip.\n  const isUpToDate = async (\n    item: ResolvedConfig,\n    configObj: Config,\n  ): Promise<boolean> => {\n    // An action writes what no `destination` names, so there is nothing for\n    // the comparison below to check and skipping would leave its work undone.\n    const hasActions = Object.values(configObj.platforms ?? {}).some(\n      (platform) => (platform.actions?.length ?? 0) > 0,\n    )\n    if (hasActions) return false\n\n    const destinations = declaredDestinations(configObj)\n    if (destinations.length === 0) return false\n\n    // `options.watch` belongs in here as much as `source` does. A consumer\n    // names an extra file because something in the build reads it — a custom\n    // format's own data file, most obviously — and leaving it out let a change\n    // to it be skipped over while the watcher dutifully reported it.\n    const extraWatches = options.watch\n      ? Array.isArray(options.watch)\n        ? options.watch\n        : [options.watch]\n      : []\n\n    const sources = await expandPatterns([\n      ...sourcePatternsOf(configObj),\n      ...extraWatches.map((pattern) =>\n        (path.isAbsolute(pattern)\n          ? pattern\n          : path.resolve(root, pattern)\n        ).replace(/\\\\/g, '/'),\n      ),\n    ])\n    if (item.file) sources.push(item.file.replace(/\\\\/g, '/'))\n\n    if (sources.length === 0) return false\n\n    let newestSource = -Infinity\n    let sawFile = false\n\n    for (const source of sources) {\n      const stats = statOrNull(source)\n      if (!stats) return false\n\n      // Directories are in this list on purpose — `expandPatterns` registers\n      // each pattern's static parent so a token file created later is\n      // noticed — but their mtime cannot be read as an input signal here. A\n      // directory's mtime moves whenever an entry is added or renamed inside\n      // it, and the atomic write renames every generated file into place, so\n      // a `buildPath` inside a watched directory made the build itself the\n      // newest thing the comparison could see. Nothing was ever up to date.\n      if (stats.isDirectory()) continue\n\n      sawFile = true\n      newestSource = Math.max(newestSource, stats.mtimeMs)\n    }\n\n    // Every pattern expanded to directories alone, so nothing was actually\n    // read. Style Dictionary would build an empty dictionary from that, and a\n    // skip would present the empty result as current.\n    if (!sawFile) return false\n\n    let oldestDestination = Infinity\n    for (const destination of destinations) {\n      const stats = statOrNull(destination)\n      if (!stats) return false\n      oldestDestination = Math.min(oldestDestination, stats.mtimeMs)\n    }\n\n    if (oldestDestination <= newestSource) return false\n\n    // A configuration given as a path has its own file among the sources\n    // above, so an edit to it has already been accounted for and the skip\n    // holds across processes.\n    if (item.file) return true\n\n    // One given as an object or a function has not. Only this process knows\n    // what it looked like when those destinations were written, so the skip\n    // holds only against a fingerprint recorded here.\n    const fingerprint = configFingerprint(item)\n\n    return fingerprint !== null && compiledFingerprints.has(fingerprint)\n  }\n\n  // The size-and-gzip table, in a function of its own so that the compile\n  // `try` in `runBuilds` can stop before it. Everything here is presentation\n  // over files Style Dictionary has already finished writing, so a throw from\n  // it is a reporting bug and nothing more.\n  const reportSizes = (generatedFiles: Set<string>) => {\n    const fileInfos: Array<{\n      coloredPath: string\n      gzipSizeStr: string\n      relativeDisplayPath: string\n      sizeStr: string\n    }> = []\n\n    for (const filePath of generatedFiles) {\n      if (fs.existsSync(filePath)) {\n        const displayPath = path.relative(root, filePath).replace(/\\\\/g, '/')\n        const dir = path.dirname(displayPath)\n        const base = path.basename(displayPath)\n        const coloredPath =\n          dir === '.'\n            ? `\\x1b[32m${base}\\x1b[0m`\n            : `\\x1b[90m${dir}/\\x1b[0m\\x1b[32m${base}\\x1b[0m`\n\n        try {\n          const stats = fs.statSync(filePath)\n          const bytes = stats.size\n          const sizeStr = `${(bytes / 1024).toFixed(2)} kB`\n\n          const content = fs.readFileSync(filePath)\n          const gzipBytes = zlib.gzipSync(content).length\n          const gzipSizeStr = `${(gzipBytes / 1024).toFixed(2)} kB`\n\n          fileInfos.push({\n            coloredPath,\n            gzipSizeStr,\n            relativeDisplayPath: displayPath,\n            sizeStr,\n          })\n        } catch {\n          // One unreadable destination costs its row rather than the table.\n          // Deliberately narrower than the caller's `catch`: it covers the\n          // three filesystem and gzip calls above and not the arithmetic\n          // below, so a padding bug is reported rather than quietly printing\n          // short.\n        }\n      }\n    }\n\n    if (fileInfos.length > 0) {\n      const longestPathLength = Math.max(\n        ...fileInfos.map((f) => f.relativeDisplayPath.length),\n        0,\n      )\n      const longestSizeLength = Math.max(\n        ...fileInfos.map((f) => f.sizeStr.length),\n        0,\n      )\n\n      for (const info of fileInfos) {\n        const pathPadding = ' '.repeat(\n          Math.max(2, longestPathLength - info.relativeDisplayPath.length + 2),\n        )\n        const sizePadded = info.sizeStr.padStart(longestSizeLength)\n        console.log(\n          `${info.coloredPath}${pathPadding}\\x1b[90m${sizePadded} │ gzip: ${info.gzipSizeStr}\\x1b[0m`,\n        )\n      }\n    }\n  }\n\n  // Compile design tokens\n  const runBuilds = async (\n    resolvedConfigs: ResolvedConfig[],\n    context?: string,\n  ) => {\n    const startTime = Date.now()\n\n    // Ahead of the `try` rather than inside it, because the reporting below\n    // reads it and that reporting is deliberately outside.\n    const generatedFiles = new Set<string>()\n\n    // How many configurations were already up to date. Read by the reporting\n    // below, which is why it sits out here with `generatedFiles`.\n    let skipped = 0\n\n    try {\n      if (!context) {\n        log('Compiling design tokens...', 'info')\n      }\n\n      // Configurations are built one after another rather than with\n      // `Promise.all`, and that is load-bearing. Two configurations may name\n      // the same destination file, and each instance gets the atomic volume\n      // swapped onto it below — overlapping builds would interleave those\n      // writes and hand a reader a file assembled from both.\n      for (const item of resolvedConfigs) {\n        // Read ahead of the instance, because avoiding the instance is the\n        // point: construction plus `extend` is the 15-30% of a build that\n        // parses the token sources, and `buildAllPlatforms` is the rest.\n        //\n        // `false` so a configuration that will not parse says nothing here —\n        // the build below hands Style Dictionary the path and lets its own\n        // message through, which is more specific than anything this could\n        // say.\n        const declared = cache ? await readConfigObject(item, false) : null\n\n        if (declared && (await isUpToDate(item, declared))) {\n          // The destinations still have to be collected. They are what stops\n          // the plugin's own output being treated as a watched source, so a\n          // skipped configuration that contributed none would have its files\n          // rebuild the moment a watcher noticed them.\n          for (const destination of declaredDestinations(declared)) {\n            generatedFiles.add(destination)\n          }\n\n          skipped++\n          continue\n        }\n\n        // `{ init: false }` is the escape hatch Style Dictionary documents on\n        // this constructor, and it is what makes a bad configuration\n        // catchable. Left to itself the constructor ends in a call to\n        // `init()` whose promise it neither stores nor returns, so a config\n        // that fails to load rejects a promise nobody holds: the `catch`\n        // below never runs, and the host dies with a raw stack or — where an\n        // `unhandledRejection` handler suppresses it — hangs on a\n        // `buildStart` that never settles. `await sd.hasInitialized` cannot\n        // observe it either, since that promise is only ever resolved, at the\n        // tail of a successful extend.\n        //\n        // It is handed the configuration as an object rather than as a path\n        // for the same reason: Style Dictionary imports a path with no\n        // cache-busting query of its own, so under a long-lived dev server\n        // every rebuild after the first built the config the process started\n        // with while the watch list followed the edit.\n        const sd = new StyleDictionary(await configForBuild(item), {\n          init: false,\n        })\n\n        // One initialisation rather than two. `init()` is `extend()` with\n        // `mutateOriginal`, so the old pair loaded the configuration and\n        // combined every source twice — running a custom parser or\n        // preprocessor twice with it — and the first of the two ran at\n        // default verbosity, which is how Style Dictionary's own warnings\n        // escaped this plugin's `silent`. `config` defaults to the one the\n        // constructor was handed.\n        //\n        // `verbosity` is `undefined` unless a consumer asked for a level, and\n        // Style Dictionary falls through an unset one to the configuration's\n        // own `log.verbosity`. Overwriting it here is what silenced the one\n        // line explaining why a build wrote nothing. `log.warnings` is not\n        // touched either way: a consumer's `warnings: 'error'` turning a\n        // missing output file into a thrown build is their decision.\n        await sd.extend(undefined, { mutateOriginal: true, verbosity })\n\n        // Swap in the atomic volume only now that the instance has finished\n        // reading its configs and token sources, so every write below lands\n        // through `rename` while the read path stays exactly as it was.\n        sd.volume = atomicVolume\n        await sd.buildAllPlatforms()\n\n        // Collected on every build rather than only on the ones whose size\n        // report prints it below. The set is also what keeps a rebuild from\n        // being triggered by the write it just made, and a rebuild passes a\n        // `context` — so gating the collection on `!context` left it empty on\n        // exactly the builds a watcher is live for.\n        for (const platform of Object.values(sd.platforms)) {\n          const buildPath = platform.buildPath ?? ''\n          for (const file of platform.files ?? []) {\n            if (file.destination) {\n              const absoluteBuildPath = path.isAbsolute(buildPath)\n                ? buildPath\n                : path.resolve(root, buildPath)\n              const absoluteDestination = path.isAbsolute(file.destination)\n                ? file.destination\n                : path.resolve(absoluteBuildPath, file.destination)\n              generatedFiles.add(absoluteDestination)\n            }\n          }\n        }\n\n        // Recorded only now, so a configuration whose build threw is never\n        // treated as one this process has compiled.\n        const fingerprint = configFingerprint(item)\n        if (fingerprint !== null) compiledFingerprints.add(fingerprint)\n      }\n\n      // Replaced wholesale rather than added to, so a destination dropped from\n      // a configuration stops being treated as ours and becomes watchable\n      // again. A build that throws never reaches this and leaves the previous\n      // set standing, which is the safe direction: the files it wrote before\n      // failing are still ours.\n      generatedDestinations.clear()\n      for (const destination of generatedFiles) {\n        generatedDestinations.add(destination.replace(/\\\\/g, '/'))\n      }\n    } catch (err) {\n      const duration = Date.now() - startTime\n      log(\n        `Compilation failed after ${duration}ms: ${errorMessage(err)}`,\n        'error',\n      )\n\n      // Reported, and then rethrown so the host stops. Swallowing it left\n      // every target exiting 0 with the previous run's tokens still on disk\n      // and in the bundle — a green build shipping stale values.\n      if (failsTheBuild(context)) throw err\n\n      // Explicit, now that the reporting below sits outside the `try`. This\n      // `catch` used to end the function by falling off the end of it; a\n      // failure that is not rethrown would otherwise carry on to announce a\n      // compile that did not happen.\n      return\n    }\n\n    // The `try` ends above, and everything from here down is reporting. Style\n    // Dictionary has finished writing by now and `generatedDestinations` is\n    // already replaced, so nothing below can put a file on disk in doubt —\n    // which is why a throw from it must not be caught as a compile failure.\n    // It used to be: a fault in the padding arithmetic printed `Compilation\n    // failed after 19ms` over a build whose every token file was correct, and\n    // with `failOnError` defaulting to `'build'` that stopped the bundler.\n    const duration = Date.now() - startTime\n\n    // Every configuration was already current, so nothing was written. Said\n    // rather than left implied: a build that prints its opening line and then\n    // finishes in two milliseconds reads as one that silently did nothing.\n    const everythingSkipped = skipped === resolvedConfigs.length\n\n    if (context) {\n      log(\n        everythingSkipped\n          ? `Design tokens already up to date after change in ${context} (${duration}ms)`\n          : `Rebuilt design tokens due to change in ${context} (${duration}ms)`,\n        'success',\n      )\n      return\n    }\n\n    // The table is skipped when nothing was written, on top of `report` and\n    // `quiet`. It reads every generated file in full and gzips it, and\n    // reprinting the sizes of files this build did not touch is the one case\n    // where that cost buys nothing at all.\n    if (report && !quiet && !everythingSkipped && generatedFiles.size > 0) {\n      try {\n        reportSizes(generatedFiles)\n      } catch (err) {\n        // At `'error'`, so it is said at every level including `silent`,\n        // exactly as a compile failure is — and worded so it cannot be read\n        // as one. Not rethrown: the build succeeded.\n        log(\n          `Failed to report generated file sizes: ${errorMessage(err)}`,\n          'error',\n        )\n      }\n    }\n\n    if (everythingSkipped) {\n      log(`Design tokens are already up to date (${duration}ms)`, 'success')\n      return\n    }\n\n    log(\n      skipped > 0\n        ? `Compiled successfully! (${duration}ms, ${skipped} already up to date)`\n        : `Compiled successfully! (${duration}ms)`,\n      'success',\n    )\n  }\n\n  // `runBuilds` for the first build of a process, with the compile shared\n  // between every plugin instance that wants the same one.\n  //\n  // An instance arriving while a compile for the same key is running waits on\n  // that compile instead of starting a second. It is the concurrent half that\n  // needs this: an up-to-date check compares what is on disk against the\n  // sources, and two instances that start together have nothing on disk to\n  // compare against yet, so only a shared promise can tell them apart from\n  // two genuinely separate builds.\n  //\n  // The entry is dropped as soon as the compile settles, so this coalesces\n  // rather than caches — a later `buildStart` still compiles. Skipping one\n  // whose output is already current is #212's up-to-date check, and belongs\n  // with it rather than as a second mechanism here.\n  //\n  // A rejection reaches every waiter, which is the point: an instance that\n  // waited on a failed compile must not carry on as though the tokens were\n  // written. Whether that rejection is thrown at all is `failOnError`'s\n  // decision, already made inside `runBuilds`.\n  const compileOnceAcrossInstances = async (\n    resolvedConfigs: ResolvedConfig[],\n  ): Promise<void> => {\n    const key = buildKey(root, resolvedConfigs)\n    if (key === null) {\n      await runBuilds(resolvedConfigs)\n      return\n    }\n\n    const running = compilesInFlight.get(key)\n    if (running) {\n      await running\n      return\n    }\n\n    const compile = runBuilds(resolvedConfigs)\n    compilesInFlight.set(key, compile)\n\n    try {\n      await compile\n    } finally {\n      compilesInFlight.delete(key)\n    }\n  }\n\n  // One rebuild per burst of watcher events, and never two at once.\n  //\n  // Two things went wrong without this. A single token edit under Vite's dev\n  // server reached both the `configureServer` listener and `watchChange` —\n  // Vite 6, 7 and 8 all invoke plugin `watchChange` while serving — and each\n  // started its own build, so one write produced two. And nothing serialised\n  // them: a four-file change started one build per file, all overlapping.\n  // `runBuilds` builds its configurations one after another precisely so two\n  // instances never write the same destination at once, and concurrent calls\n  // to it reintroduced that one level up.\n  //\n  // The trailing debounce collapses the burst; the in-flight chain means a\n  // trigger arriving mid-build queues exactly one follow-up rather than\n  // starting a second build beside it.\n  const REBUILD_DEBOUNCE_MS = 50\n\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n  let pendingReason: string | undefined\n  let inFlight: Promise<void> | undefined\n  let waiting: Array<(failure?: { error: unknown }) => void> = []\n\n  // Set by `configureServer`. A dev server's watcher is long-lived, so its\n  // list has to follow a configuration that changes; every other target\n  // re-registers on each build through `addWatchFile` instead.\n  let refreshServerWatchList:\n    | ((resolved: ResolvedConfig[]) => Promise<void>)\n    | undefined\n\n  const drain = async (): Promise<void> => {\n    // A loop rather than a single pass: anything scheduled while the build\n    // below is running is picked up here instead of starting a second one.\n    while (pendingReason !== undefined) {\n      const reason = pendingReason\n      pendingReason = undefined\n\n      // Captured before the await, so a trigger arriving mid-build waits for\n      // the next pass rather than being told this one covered it.\n      const resolvers = waiting\n      waiting = []\n\n      let failure: undefined | { error: unknown }\n      let compiling = false\n\n      try {\n        const resolved = await resolveConfigs()\n        if (resolved.length > 0) {\n          compiling = true\n          await runBuilds(resolved, reason)\n          compiling = false\n          hasCompiled = true\n          await refreshServerWatchList?.(resolved)\n        }\n      } catch (err) {\n        failure = { error: err }\n\n        // `runBuilds` reports its own failure before rethrowing, so only the\n        // other things that can throw here — a `config` function of the\n        // consumer's that raises, a watch list that cannot be rebuilt — need\n        // reporting.\n        if (!compiling) log(`Rebuild failed: ${errorMessage(err)}`, 'error')\n      }\n\n      // Handed on to whatever awaited this rebuild, which is `watchChange`\n      // and so the host under a watching bundler. Vite's dev-server listener\n      // has no build to fail and catches it.\n      for (const settle of resolvers) settle(failure)\n    }\n  }\n\n  // Resolves once a rebuild covering this trigger has finished.\n  const schedule = async (reason: string): Promise<void> => {\n    pendingReason = reason\n\n    const covered = new Promise<void>((resolve, reject) => {\n      waiting.push((failure) => {\n        if (failure) reject(asError(failure.error))\n        else resolve()\n      })\n    })\n\n    if (debounceTimer) clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      debounceTimer = undefined\n      inFlight = (inFlight ?? Promise.resolve()).then(drain)\n    }, REBUILD_DEBOUNCE_MS)\n\n    // A pending rebuild must not be what keeps a process alive; whatever is\n    // watching already is.\n    debounceTimer.unref()\n\n    return covered\n  }\n\n  return {\n    async buildStart() {\n      const resolved = await resolveConfigs()\n      if (resolved.length === 0) return\n\n      // Register token/config files with the host bundler's watch mode.\n      // Works out of the box wherever the host runs a persistent watcher\n      // (e.g. `rollup --watch`). Vite's dev server is additionally handled\n      // below via the `vite.configureServer` escape hatch — not because\n      // `watchChange` is missing there, which it is not on any Vite this\n      // package supports, but because the declared peer range is wider than\n      // what has been measured and the scheduler above makes a duplicate\n      // trigger free.\n      const { paths } = await getWatchTargets(resolved)\n      for (const file of paths) {\n        this.addWatchFile(file)\n      }\n\n      // Registering the watch list is all this hook does on webpack, and it\n      // has to happen here rather than beside the compile: `addWatchFile`\n      // reaches `compilation.fileDependencies`, and `beforeCompile` runs\n      // before there is a compilation to add to. Compiling here as well would\n      // put the race back, and run every webpack build twice.\n      if (isWebpack) return\n\n      // Every watch rebuild re-enters this hook, and compiling here as well as\n      // in `watchChange` is what closed the loop: consuming code imports the\n      // generated file, so writing it is itself a module-graph change, which\n      // re-enters `buildStart`, which writes it again. `watchChange` has\n      // already run for every file in this cycle and rebuilt if any of them\n      // was a source, so the only thing left for a re-entry to do is the\n      // re-registration above.\n      //\n      // `hasCompiled` is the floor under that: a host that fires\n      // `watchChange` without ever re-entering here would otherwise leave the\n      // flag standing, and no first compile of a process may ever be skipped —\n      // the tokens have to exist before the build that consumes them.\n      if (watchRebuild && hasCompiled) {\n        watchRebuild = false\n        return\n      }\n\n      await compileOnceAcrossInstances(resolved)\n      hasCompiled = true\n    },\n\n    name: 'unplugin-style-dictionary',\n\n    vite: {\n      configResolved(config) {\n        if (rootOption === undefined) root = config.root || process.cwd()\n      },\n\n      async configureServer(server: ViteDevServer) {\n        const resolved = await resolveConfigs()\n        if (resolved.length === 0) return\n\n        // Reassigned after every rebuild below, so a configuration that gains\n        // a source is matched against its new patterns rather than the ones\n        // read at start-up.\n        let targets = await getWatchTargets(resolved)\n\n        // Watch configuration files and token files\n        server.watcher.add(targets.paths)\n\n        // Runs once per rebuild rather than once per event, which is why it\n        // is handed to the scheduler rather than done in the listener.\n        refreshServerWatchList = async (rebuilt) => {\n          targets = await getWatchTargets(rebuilt)\n          server.watcher.add(targets.paths)\n        }\n\n        // chokidar types its listener as returning void and does not await\n        // what it is handed, so an async listener left every rejection\n        // floating. `schedule` owns the whole rebuild including its errors,\n        // so there is nothing here left to reject.\n        server.watcher.on('all', (_event, file) => {\n          if (!isWatchedSource(file, targets.patterns)) return\n\n          // A dev server has no build to fail, so a rebuild that throws is\n          // reported by the scheduler and the server keeps serving.\n          void schedule(path.basename(file)).catch(() => {})\n        })\n      },\n    },\n\n    // Rollup types `watchChange` as returning void, yet awaits it as a\n    // sequential hook — and the work here is inherently asynchronous. The\n    // signature is the thing that is wrong, so the rule is silenced rather\n    // than the hook made to lie about finishing.\n    // oxlint-disable-next-line typescript/no-misused-promises\n    async watchChange(id) {\n      // Raised before any decision about `id`, because whatever this change\n      // was, the host is now on its way back into `buildStart`.\n      watchRebuild = true\n\n      // The cheap half of the decision, taken before anything is resolved.\n      // Under Vite the scope this hook sees is the whole project root rather\n      // than the module graph, so most of what arrives here has nothing to do\n      // with tokens, and resolving every configuration only to discard the\n      // answer ran a consumer's `config` function once per unrelated file.\n      // Skipped until a build has derived a list to filter against.\n      if (cachedPatterns && !isWatchedSource(id, cachedPatterns)) return\n\n      const resolved = await resolveConfigs()\n      if (resolved.length === 0) return\n\n      // Derived again rather than trusted from the cache, because the cache\n      // is what decided this path was worth resolving and not what decides a\n      // rebuild. A config edit reaches here through its own filename and can\n      // have dropped the very source the cached list matched.\n      const { patterns } = await getWatchTargets(resolved)\n      // Without this check, watchChange fires for *any* changed file in the\n      // host bundler's module graph — including our own generated output,\n      // since consuming code imports it. Every regenerate is itself a\n      // \"change\", so skipping what is not a source here is what keeps this\n      // from rebuilding forever — both the files that match no pattern and\n      // the ones that match only because this plugin wrote them.\n      if (!isWatchedSource(id, patterns)) return\n\n      // Same division as `buildStart`: on webpack the compile belongs to\n      // `beforeCompile`, which has already run for this compilation, so all\n      // that is left is to re-register the watch list below.\n      if (!isWebpack) await schedule(path.basename(id))\n\n      // Expanded again after the build rather than reusing the list from\n      // before it, so a token file the build itself produced is registered.\n      for (const file of await expandPatterns(patterns)) {\n        this.addWatchFile(file)\n      }\n    },\n\n    // unplugin calls this inside `apply(compiler)`, one line before it taps\n    // `make`, so the root is in place before the first compile. Without it a\n    // webpack build whose `context` is not the working directory looked for\n    // the configuration in the wrong place and reported ENOENT.\n    webpack(compiler) {\n      if (rootOption === undefined) {\n        root = compiler.options.context ?? process.cwd()\n      }\n\n      // `beforeCompile` is awaited before the compilation exists, so the\n      // tokens are on disk before webpack resolves the module that imports\n      // them. Tapped on every compilation rather than only the first: a watch\n      // rebuild needs the same guarantee, and a compile that renders what is\n      // already there skips its own write.\n      compiler.hooks.beforeCompile.tapPromise(\n        'unplugin-style-dictionary',\n        async () => {\n          const resolved = await resolveConfigs()\n          if (resolved.length === 0) return\n\n          await compileOnceAcrossInstances(resolved)\n          hasCompiled = true\n        },\n      )\n    },\n  }\n}\n\nexport const unplugin = /* #__PURE__ */ createUnplugin(unpluginFactory)\n\nexport default unplugin\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -18,6 +18,35 @@ import { Config } from "style-dictionary";
  * edit triggering a rebuild there.
  */
 export interface UnpluginStyleDictionaryOptions {
+  /**
+   * Whether a configuration whose output is already up to date may skip its
+   * compile.
+   *
+   * A build's expensive half is `buildAllPlatforms` — around 80% of it on a
+   * 4,000-token, two-platform configuration — and under Vite it runs inside
+   * `server.listen()`, so the dev server does not accept a connection until
+   * it finishes whether or not a token changed. A configuration is treated as
+   * up to date when every file it declares exists and is newer than every
+   * file it reads, its own config file included.
+   *
+   * Two things are never skipped, because neither can be told from the
+   * filesystem:
+   *
+   * - **The first compile of a process, for a configuration given as an
+   *   object or a function.** There is no config file to stat, so an edit to
+   *   the object inside `vite.config.ts` moves no mtime. Within one process
+   *   the resolved configuration is compared against the one that was last
+   *   built; across processes there is nothing to compare, so it builds.
+   * - **A platform declaring `actions`.** An action writes what no
+   *   `destination` names, so a skip would leave its work undone.
+   *
+   * A custom format that reads something off-disk — an environment variable,
+   * a network call — cannot be detected this way either, and is what this
+   * option exists to turn off.
+   *
+   * @default true
+   */
+  cache?: boolean;
   /**
    * Style Dictionary configuration(s).
    * Can be:
@@ -74,6 +103,26 @@ export interface UnpluginStyleDictionaryOptions {
    * configuration's `log.verbosity` alone
    */
   logLevel?: 'info' | 'silent' | 'verbose' | 'warn';
+  /**
+   * Whether the table of generated files and their sizes is produced.
+   *
+   * Every generated file is read in full and gzipped at level 6 to fill the
+   * `gzip:` column — 4.5ms for 515kB of output, and 21ms at 6MB. That is
+   * small beside the compile it follows, and it is pure cost to a project
+   * large enough to care.
+   *
+   * This is not `logLevel`'s job, and the two differ in what they leave
+   * standing. `logLevel: 'warn'` silences the plugin's progress lines along
+   * with the table; `report: false` keeps them and drops only the table,
+   * along with the read and the compression behind it.
+   *
+   * Dropping to gzip level 1 instead was measured and rejected: it reported a
+   * figure up to 8.7% off — 21.4kB against 19.7kB on the same JSON — and that
+   * number is one a consumer compares against their own bundler's report.
+   *
+   * @default true
+   */
+  report?: boolean;
   /**
    * The directory a relative `config` path is looked up in.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kanso-labs/unplugin-style-dictionary",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Compile Style Dictionary design tokens ahead of your bundler (Vite, Rolldown, Rollup, or Webpack) from a single unplugin-based plugin, with automatic watching and rebuilding under Vite",
   "keywords": [
     "unplugin",