@kanso-labs/unplugin-style-dictionary 0.10.11 → 0.10.13

package/dist/types.d.ts

@@ -66,8 +66,8 @@ export interface StyleDictionaryConfigContext {
   /**
    * Whether the host will keep rebuilding.
    *
-   * `true` under Vite's dev server, `rollup --watch`, `rolldown.watch()` and
-   * `webpack --watch`; `false` for a one-shot build. It is read from the
+   * `true` under Vite's dev server and `vite build --watch`, `rollup --watch`,
+   * `rolldown.watch()` and `webpack --watch`; `false` for a one-shot build. It is read from the
    * host — the plugin context's `meta.watchMode` on the three rollup-shaped
    * targets, and `compiler.watchMode` on webpack — rather than inferred from
    * `command`, because `rollup --watch` both watches and builds.
@@ -83,8 +83,28 @@ export interface UnpluginStyleDictionaryOptions {
    * 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.
+   * up to date when every file its last compile wrote exists and is as that
+   * compile left it, and nothing it reads, its own config file included, has
+   * changed since that compile read it. A file it declares and Style
+   * Dictionary declined to write — a filter matching no tokens — does not stop
+   * it being skipped, since that file was never going to be there.
+   *
+   * "Since" means since the moment that compile began reading, so a token
+   * saved while a rebuild is compiling is rebuilt rather than taken for part
+   * of the output the rebuild went on to write. What each compile read is
+   * kept in `node_modules/.cache/unplugin-style-dictionary` beside the nearest
+   * `package.json`, so a restart still knows it. Where nothing is recorded,
+   * the files a configuration reads are compared against the files it
+   * declares instead.
+   *
+   * A compile is also recorded against the configuration that ran it: its
+   * contents, the hooks it names as Style Dictionary's registry holds them —
+   * each `format`, `filter`, `fileHeader`, transform, transform group,
+   * parser and preprocessor it refers to by name — and the Style Dictionary
+   * version. A new body registered under a name it uses, or an upgrade,
+   * rebuilds even though no file moved. What a hook's code calls from another
+   * module is not part of that code, so an edit there is not seen; naming the
+   * module in `watch` makes the next start rebuild.
    *
    * Two things are never skipped, because neither can be told from the
    * filesystem:
@@ -93,7 +113,9 @@ export interface UnpluginStyleDictionaryOptions {
    *   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.
+   *   built. An earlier process's record is not trusted for it, because its
+   *   functions are compared by their source and what they close over can
+   *   differ from one process to the next, so it builds.
    * - **A platform declaring `actions`.** An action writes what no
    *   `destination` names, so a skip would leave its work undone.
    *
@@ -212,15 +234,17 @@ export interface UnpluginStyleDictionaryOptions {
    */
   logLevel?: 'info' | 'silent' | 'verbose' | 'warn';
   /**
-   * Called once a build has finished, with every file it declares and how long
-   * it took in milliseconds.
+   * Called once a build has finished, with every file it declares that is on
+   * disk and how long it took in milliseconds.
    *
    * The paths are absolute and platform-native, sorted so two runs of the same
    * configuration hand back the same order. They are what the build declares
    * rather than what it wrote this time: a configuration skipped by `cache`
    * contributes its destinations too, because they are on disk and current,
    * and a post-processing step that ignored them would leave half the output
-   * untouched on a rebuild that changed one file.
+   * untouched on a rebuild that changed one file. A declared file Style
+   * Dictionary declined to write — a filter matching no tokens — is left out,
+   * since there is nothing there to open.
    *
    * This is where formatting the generated files, type-checking them, or
    * telling something else they have landed belongs.

package/dist/up-to-date.js

@@ -1,13 +1,24 @@
-import { expandPatterns, sourcePatternsOf } from "./patterns.js";
+import { expandPatterns, sourcePatternsOf, watchOptionPatterns } from "./patterns.js";
 import fs from "node:fs";
 import path from "node:path";
+import StyleDictionary from "style-dictionary";
+import { createHash } from "node:crypto";
 //#region src/up-to-date.ts
-function configFingerprint(root, item) {
+const RECORDS_VERSION = 3;
+function configFingerprint(root, item, configObj) {
+	let serialised;
 	try {
-		return JSON.stringify([root, item.file ?? item.config], (_key, value) => typeof value === "function" ? `[fn]${String(value)}` : value);
+		serialised = JSON.stringify([
+			root,
+			item.file ?? null,
+			configObj,
+			namedHooksOf(configObj),
+			StyleDictionary.VERSION
+		], (_key, value) => typeof value === "function" ? `[fn]${String(value)}` : value);
 	} catch {
 		return null;
 	}
+	return createHash("sha256").update(serialised).digest("hex");
 }
 function declaredDestinations(configObj, only) {
 	const destinations = [];
@@ -16,38 +27,150 @@ function declaredDestinations(configObj, only) {
 	for (const [, platform] of selected) for (const file of platform.files ?? []) if (file.destination) destinations.push(writtenDestination(platform.buildPath, file.destination));
 	return destinations;
 }
-async function isUpToDate({ compiledFingerprints, log, root, watch }, item, configObj, only) {
+function isUpToDate({ destinationRecords, fingerprint, newestSource }, item, configObj, only) {
 	if (Object.values(configObj.platforms ?? {}).some((platform) => (platform.actions?.length ?? 0) > 0)) return false;
 	const destinations = declaredDestinations(configObj, only);
 	if (destinations.length === 0) return false;
-	const extraWatches = watch ? Array.isArray(watch) ? watch : [watch] : [];
-	const sources = await expandPatterns([...sourcePatternsOf(configObj), ...extraWatches.map((pattern) => (path.isAbsolute(pattern) ? pattern : path.resolve(root, pattern)).replace(/\\/g, "/"))], log);
+	if (newestSource === null) return false;
+	for (const destination of destinations) {
+		const record = destinationRecords.get(destination);
+		const writtenByThis = fingerprint !== null && record?.fingerprint === fingerprint;
+		if (record !== void 0 && !writtenByThis) return false;
+		if (!item.file && (!writtenByThis || record.persisted === true)) return false;
+		if (writtenByThis && record.written === null) {
+			if (record.newestSource === null || newestSource > record.newestSource) return false;
+			continue;
+		}
+		const stats = statOrNull(destination);
+		if (!stats) return false;
+		if (writtenByThis && record.written !== stats.mtimeMs) return false;
+		const lastRead = writtenByThis ? record.newestSource : null;
+		if (lastRead === null ? stats.mtimeMs <= newestSource : newestSource > lastRead) return false;
+	}
+	return true;
+}
+async function newestSourceOf({ log, root, watch }, item, configObj) {
+	const read = sourcePatternsOf(configObj);
+	const extra = watchOptionPatterns(root, watch);
+	const sources = await expandPatterns({
+		globs: [...read.globs, ...extra.globs],
+		literals: [...read.literals, ...extra.literals]
+	}, log);
 	if (item.file) sources.push(item.file.replace(/\\/g, "/"));
-	if (sources.length === 0) return false;
+	if (sources.length === 0) return null;
 	let newestSource = -Infinity;
 	let sawFile = false;
 	for (const source of sources) {
 		const stats = statOrNull(source);
-		if (!stats) return false;
+		if (!stats) return null;
 		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);
+	return sawFile ? newestSource : null;
+}
+function readPersistedRecords(file) {
+	const records = /* @__PURE__ */ new Map();
+	let parsed;
+	try {
+		parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+	} catch {
+		return records;
+	}
+	if (typeof parsed !== "object" || parsed === null || !("version" in parsed) || parsed.version !== RECORDS_VERSION || !("records" in parsed) || typeof parsed.records !== "object" || parsed.records === null) return records;
+	const stored = parsed.records;
+	for (const destination of Object.keys(stored)) {
+		const value = Reflect.get(stored, destination);
+		if (typeof value === "object" && value !== null && "fingerprint" in value && typeof value.fingerprint === "string" && "newestSource" in value && (value.newestSource === null || typeof value.newestSource === "number") && "written" in value && (value.written === null || typeof value.written === "number")) records.set(destination, {
+			fingerprint: value.fingerprint,
+			newestSource: value.newestSource,
+			persisted: true,
+			written: value.written
+		});
+	}
+	return records;
+}
+function recordOf(destination, fingerprint, newestSource, wrote) {
+	if (!wrote) return {
+		fingerprint,
+		newestSource,
+		written: null
+	};
+	const stats = statOrNull(destination);
+	return stats ? {
+		fingerprint,
+		newestSource,
+		written: stats.mtimeMs
+	} : null;
+}
+function recordsFileFor(root) {
+	let directory = root;
+	while (!fs.existsSync(path.join(directory, "package.json"))) {
+		const parent = path.dirname(directory);
+		if (parent === directory) {
+			directory = root;
+			break;
+		}
+		directory = parent;
+	}
+	return path.join(directory, "node_modules", ".cache", "unplugin-style-dictionary", "records");
+}
+function writePersistedRecords(file, recorded) {
+	const merged = readPersistedRecords(file);
+	for (const [destination, record] of recorded) merged.set(destination, record);
+	const records = {};
+	for (const [destination, { fingerprint, newestSource, written }] of merged) if (written === null ? statOrNull(path.dirname(destination)) : statOrNull(destination)) records[destination] = {
+		fingerprint,
+		newestSource,
+		written
+	};
+	const temporary = `${file}.${String(process.pid)}.tmp`;
+	try {
+		fs.mkdirSync(path.dirname(file), { recursive: true });
+		fs.writeFileSync(temporary, JSON.stringify({
+			records,
+			version: RECORDS_VERSION
+		}));
+		fs.renameSync(temporary, file);
+	} catch {
+		try {
+			fs.rmSync(temporary, { force: true });
+		} catch {}
 	}
-	if (oldestDestination <= newestSource) return false;
-	if (item.file) return true;
-	const fingerprint = configFingerprint(root, item);
-	return fingerprint !== null && compiledFingerprints.has(fingerprint);
 }
 function writtenDestination(buildPath, destination) {
 	return path.resolve(process.cwd(), buildPath ? path.join(buildPath, destination) : destination);
 }
+function namedHooksOf(configObj) {
+	const own = configObj.hooks ?? {};
+	const registry = StyleDictionary.hooks;
+	const named = {};
+	const add = (kind, name) => {
+		if (typeof name !== "string") return;
+		const hook = own[kind]?.[name] ?? registry[kind][name];
+		named[kind] ??= {};
+		named[kind][name] = hook ?? null;
+	};
+	for (const name of configObj.parsers ?? []) add("parsers", name);
+	for (const name of configObj.preprocessors ?? []) add("preprocessors", name);
+	for (const platform of Object.values(configObj.platforms ?? {})) {
+		for (const name of platform.preprocessors ?? []) add("preprocessors", name);
+		for (const transform of platform.transforms ?? []) add("transforms", transform);
+		const group = platform.transformGroup;
+		if (group !== void 0) {
+			add("transformGroups", group);
+			const members = own.transformGroups?.[group] ?? registry.transformGroups[group];
+			if (Array.isArray(members)) for (const name of members) add("transforms", name);
+		}
+		add("fileHeaders", platform.options?.fileHeader);
+		for (const file of platform.files ?? []) {
+			add("formats", file.format);
+			add("filters", file.filter);
+			add("fileHeaders", file.options?.fileHeader);
+		}
+	}
+	return named;
+}
 function statOrNull(file) {
 	try {
 		return fs.statSync(file);
@@ -56,6 +179,6 @@ function statOrNull(file) {
 	}
 }
 //#endregion
-export { configFingerprint, declaredDestinations, isUpToDate, writtenDestination };
+export { configFingerprint, declaredDestinations, isUpToDate, newestSourceOf, readPersistedRecords, recordOf, recordsFileFor, writePersistedRecords, writtenDestination };
 
 //# sourceMappingURL=up-to-date.js.map

package/dist/up-to-date.js.map

@@ -1 +1 @@
-{"version":3,"file":"up-to-date.js","names":[],"sources":["../src/up-to-date.ts"],"sourcesContent":["// Whether a configuration's compile can be skipped, and the destinations that\n// question is asked about.\n//\n// Nothing here holds state — not even the fingerprints of what this process\n// has compiled, which are process-wide and live in `index.ts` beside\n// `compilesInFlight`. What a plugin instance owns is handed in on each call.\n\nimport type { Config } from 'style-dictionary'\n\nimport fs from 'node:fs'\nimport path from 'node:path'\n\nimport type { Log, ResolvedConfig } from './config.js'\nimport type { UnpluginStyleDictionaryOptions } from './types.js'\n\nimport { expandPatterns, sourcePatternsOf } from './patterns.js'\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.\nexport function configFingerprint(\n  root: string,\n  item: ResolvedConfig,\n): 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// 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// Each one is named by `writtenDestination`, which `runBuilds` asks as well,\n// so the up-to-date check and the record of what was built name the same\n// files — the ones Style Dictionary actually wrote.\n//\n// `only` narrows this to named platforms, and exactly one caller wants that:\n// the up-to-date check, which asks whether the work *this* compile would do\n// is already done. Everywhere else the answer has to cover every declared\n// platform, because a file an unselected platform wrote earlier is still the\n// plugin's own output and has to stay out of the watch list.\nexport function declaredDestinations(\n  configObj: Config,\n  only?: string[],\n): string[] {\n  const destinations: string[] = []\n\n  const entries = Object.entries(configObj.platforms ?? {})\n  const selected = only\n    ? entries.filter(([name]) => only.includes(name))\n    : entries\n\n  for (const [, platform] of selected) {\n    for (const file of platform.files ?? []) {\n      if (file.destination) {\n        destinations.push(\n          writtenDestination(platform.buildPath, file.destination),\n        )\n      }\n    }\n  }\n\n  return destinations\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.\nexport async function isUpToDate(\n  {\n    compiledFingerprints,\n    log,\n    root,\n    watch,\n  }: {\n    compiledFingerprints: ReadonlySet<string>\n    log: Log\n    root: string\n    watch: UnpluginStyleDictionaryOptions['watch']\n  },\n  item: ResolvedConfig,\n  configObj: Config,\n  only?: string[],\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, only)\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 = watch ? (Array.isArray(watch) ? watch : [watch]) : []\n\n  const sources = await expandPatterns(\n    [\n      ...sourcePatternsOf(configObj),\n      ...extraWatches.map((pattern) =>\n        (path.isAbsolute(pattern)\n          ? pattern\n          : path.resolve(root, pattern)\n        ).replace(/\\\\/g, '/'),\n      ),\n    ],\n    log,\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(root, item)\n\n  return fingerprint !== null && compiledFingerprints.has(fingerprint)\n}\n\n// Where Style Dictionary writes one file, as an absolute path.\n//\n// It joins the destination onto the platform's `buildPath` when there is one\n// and writes the result relative to the working directory. **Joins, not\n// resolves**: an absolute destination lands under the build path rather than\n// replacing it. Measured with `buildPath: 'gen/'` and an absolute destination,\n// Style Dictionary wrote `gen/<that path>`, while the plugin had named the\n// absolute path on its own — a file that was never written.\n//\n// `root` has no say. It is where a relative `config` path is looked up and\n// nothing more, and reading `buildPath` against it named files that did not\n// exist whenever the two differed (#362). Style Dictionary joins with\n// `path-unified/posix`; the platform's own `join` names the same file, and\n// resolving the result is what normalises the separators either way.\nexport function writtenDestination(\n  buildPath: string | undefined,\n  destination: string,\n): string {\n  return path.resolve(\n    process.cwd(),\n    buildPath ? path.join(buildPath, destination) : destination,\n  )\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"],"mappings":";;;;AAqBA,SAAgB,kBACd,MACA,MACe;CACf,IAAI;EACF,OAAO,KAAK,UACV,CAAC,MAAM,KAAK,QAAQ,KAAK,MAAM,IAC9B,MAAM,UACL,OAAO,UAAU,aAAa,OAAO,OAAO,KAAK,MAAM,KAC3D;CACF,QAAQ;EAGN,OAAO;CACT;AACF;AAgBA,SAAgB,qBACd,WACA,MACU;CACV,MAAM,eAAyB,CAAC;CAEhC,MAAM,UAAU,OAAO,QAAQ,UAAU,aAAa,CAAC,CAAC;CACxD,MAAM,WAAW,OACb,QAAQ,QAAQ,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,IAC9C;CAEJ,KAAK,MAAM,GAAG,aAAa,UACzB,KAAK,MAAM,QAAQ,SAAS,SAAS,CAAC,GACpC,IAAI,KAAK,aACP,aAAa,KACX,mBAAmB,SAAS,WAAW,KAAK,WAAW,CACzD;CAKN,OAAO;AACT;AASA,eAAsB,WACpB,EACE,sBACA,KACA,MACA,SAOF,MACA,WACA,MACkB;CAMlB,IAHmB,OAAO,OAAO,UAAU,aAAa,CAAC,CAAC,CAAC,CAAC,MACzD,cAAc,SAAS,SAAS,UAAU,KAAK,CAErC,GAAG,OAAO;CAEvB,MAAM,eAAe,qBAAqB,WAAW,IAAI;CACzD,IAAI,aAAa,WAAW,GAAG,OAAO;CAMtC,MAAM,eAAe,QAAS,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,IAAK,CAAC;CAEzE,MAAM,UAAU,MAAM,eACpB,CACE,GAAG,iBAAiB,SAAS,GAC7B,GAAG,aAAa,KAAK,aAClB,KAAK,WAAW,OAAO,IACpB,UACA,KAAK,QAAQ,MAAM,OAAO,EAAA,CAC5B,QAAQ,OAAO,GAAG,CACtB,CACF,GACA,GACF;CACA,IAAI,KAAK,MAAM,QAAQ,KAAK,KAAK,KAAK,QAAQ,OAAO,GAAG,CAAC;CAEzD,IAAI,QAAQ,WAAW,GAAG,OAAO;CAEjC,IAAI,eAAe;CACnB,IAAI,UAAU;CAEd,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,QAAQ,WAAW,MAAM;EAC/B,IAAI,CAAC,OAAO,OAAO;EASnB,IAAI,MAAM,YAAY,GAAG;EAEzB,UAAU;EACV,eAAe,KAAK,IAAI,cAAc,MAAM,OAAO;CACrD;CAKA,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI,oBAAoB;CACxB,KAAK,MAAM,eAAe,cAAc;EACtC,MAAM,QAAQ,WAAW,WAAW;EACpC,IAAI,CAAC,OAAO,OAAO;EACnB,oBAAoB,KAAK,IAAI,mBAAmB,MAAM,OAAO;CAC/D;CAEA,IAAI,qBAAqB,cAAc,OAAO;CAK9C,IAAI,KAAK,MAAM,OAAO;CAKtB,MAAM,cAAc,kBAAkB,MAAM,IAAI;CAEhD,OAAO,gBAAgB,QAAQ,qBAAqB,IAAI,WAAW;AACrE;AAgBA,SAAgB,mBACd,WACA,aACQ;CACR,OAAO,KAAK,QACV,QAAQ,IAAI,GACZ,YAAY,KAAK,KAAK,WAAW,WAAW,IAAI,WAClD;AACF;AAIA,SAAS,WAAW,MAA+B;CACjD,IAAI;EACF,OAAO,GAAG,SAAS,IAAI;CACzB,QAAQ;EACN,OAAO;CACT;AACF"}
+{"version":3,"file":"up-to-date.js","names":[],"sources":["../src/up-to-date.ts"],"sourcesContent":["// Whether a configuration's compile can be skipped, and the destinations that\n// question is asked about.\n//\n// Nothing here holds state — not even the record of which configuration last\n// wrote each destination, which is process-wide and lives in `index.ts` beside\n// `compilesInFlight`. What a plugin instance owns is handed in on each call.\n// The functions that read and write the persisted copy of that record work on\n// a file they are handed and keep nothing.\n\nimport type { Config, Hooks } from 'style-dictionary/types'\n\nimport { createHash } from 'node:crypto'\nimport fs from 'node:fs'\nimport path from 'node:path'\nimport StyleDictionary from 'style-dictionary'\n\nimport type { Log, ResolvedConfig } from './config.js'\nimport type { UnpluginStyleDictionaryOptions } from './types.js'\n\nimport {\n  expandPatterns,\n  sourcePatternsOf,\n  watchOptionPatterns,\n} from './patterns.js'\n\n// What is known about the compile that last built one destination: which\n// configuration it was, the newest source it saw before it read any of them,\n// and the file's mtime once it was done. `newestSource` is `null` where that\n// compile did not look, which is when `cache` was off or the sources could not\n// be established. `written` is `null` where the compile declared the file and\n// Style Dictionary declined to write it — a filter matching no tokens — so\n// there is nothing on disk for it to vouch for. `persisted` marks a record an\n// earlier process left.\nexport interface DestinationRecord {\n  fingerprint: string\n  newestSource: null | number\n  persisted?: true\n  written: null | number\n}\n\n// Bumped whenever what a record or a fingerprint means changes, so a file an\n// older version of the plugin wrote is ignored rather than misread. 2 added\n// the hooks a configuration names and the Style Dictionary version to the\n// fingerprint, and started comparing it for a configuration given as a path.\n// 3 records a declared file the compile did not write, with `written: null`.\nconst RECORDS_VERSION = 3\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//\n// It carries more than the configuration: the hooks it names, as the registry\n// holds them now, and the Style Dictionary version. A hook named by a string is\n// only that string in the configuration, and its body lives in the registry,\n// which a `register*` call changes without anything on disk moving — the\n// README's own Custom Formats pattern registers inside the `config` function.\n// An upgrade changes the built-in hooks the same way. Neither is a file the\n// up-to-date check reads, so neither could be seen before this.\n//\n// A digest of that serialisation rather than the serialisation itself,\n// because it is held against every destination a build writes, and a\n// configuration carrying its tokens inline serialises to all of them.\nexport function configFingerprint(\n  root: string,\n  item: ResolvedConfig,\n  configObj: Config,\n): null | string {\n  let serialised: string\n  try {\n    serialised = JSON.stringify(\n      [\n        root,\n        item.file ?? null,\n        configObj,\n        namedHooksOf(configObj),\n        StyleDictionary.VERSION,\n      ],\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  return createHash('sha256').update(serialised).digest('hex')\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// Each one is named by `writtenDestination`, which `runBuilds` asks as well,\n// so the up-to-date check and the record of what was built name each file\n// where Style Dictionary writes it. Whether it did is the record's to say: a\n// file whose filter matches no tokens is declared and never written.\n//\n// `only` narrows this to named platforms, and exactly one caller wants that:\n// the up-to-date check, which asks whether the work *this* compile would do\n// is already done. Everywhere else the answer has to cover every declared\n// platform, because a file an unselected platform wrote earlier is still the\n// plugin's own output and has to stay out of the watch list.\nexport function declaredDestinations(\n  configObj: Config,\n  only?: string[],\n): string[] {\n  const destinations: string[] = []\n\n  const entries = Object.entries(configObj.platforms ?? {})\n  const selected = only\n    ? entries.filter(([name]) => only.includes(name))\n    : entries\n\n  for (const [, platform] of selected) {\n    for (const file of platform.files ?? []) {\n      if (file.destination) {\n        destinations.push(\n          writtenDestination(platform.buildPath, file.destination),\n        )\n      }\n    }\n  }\n\n  return destinations\n}\n\n// Whether a configuration's compile can be skipped: every file its last compile\n// wrote still exists as it was left, and nothing it reads has changed since\n// that compile read it. A declared file Style Dictionary declined to write is\n// not asked about, because it was never going to be on disk — asking made a\n// configuration with an empty filter compile on every build.\n//\n// \"Since\" is measured against what that compile read wherever it left a\n// record, in this process or persisted by an earlier one. The record holds the\n// newest source it saw before reading, and a source newer than that is one it\n// never read. Comparing against the output instead lost a save that landed\n// while a rebuild ran, because the rebuild wrote its output after the save.\n// It also never skipped again once an edit left one destination unchanged:\n// the atomic write keeps a byte-identical file's mtime, so the edited source\n// stayed newer than it for good. Only with no record at all is the output\n// compared.\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.\nexport function isUpToDate(\n  {\n    destinationRecords,\n    fingerprint,\n    newestSource,\n  }: {\n    destinationRecords: ReadonlyMap<string, DestinationRecord>\n    fingerprint: null | string\n    newestSource: null | number\n  },\n  item: ResolvedConfig,\n  configObj: Config,\n  only?: string[],\n): 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, only)\n  if (destinations.length === 0) return false\n\n  if (newestSource === null) return false\n\n  for (const destination of destinations) {\n    const record = destinationRecords.get(destination)\n    const writtenByThis =\n      fingerprint !== null && record?.fingerprint === fingerprint\n\n    // Recorded against something else: another configuration, or this one\n    // before a hook it names changed or Style Dictionary was upgraded. The\n    // file holds that compile's output, and nothing the comparison below\n    // reads can say so — which is why a configuration given as a path is\n    // held to this as much as one given as an object.\n    if (record !== undefined && !writtenByThis) return false\n\n    // A configuration given as a path has its own file among the sources, so\n    // an edit to it is accounted for and the skip holds across processes. One\n    // given as an object or a function has not, so it skips only over files\n    // this process wrote for it. Having built it at some point is not enough:\n    // an edit that was then undone left the edit's output standing, and so\n    // did a build of it that threw partway. An earlier process's record is not\n    // enough either, which is why the first compile of a process builds it:\n    // its functions are fingerprinted by their source, and what they close\n    // over can differ from one process to the next.\n    if (!item.file && (!writtenByThis || record.persisted === true)) {\n      return false\n    }\n\n    // Declared and left unwritten by this configuration's last compile. There\n    // is no file to stat, so all that can have changed is what it reads.\n    if (writtenByThis && record.written === null) {\n      if (record.newestSource === null || newestSource > record.newestSource) {\n        return false\n      }\n      continue\n    }\n\n    const stats = statOrNull(destination)\n    if (!stats) return false\n\n    // The file has moved since this configuration wrote it, so something\n    // wrote it afterwards and nothing here can say what it holds. Its mtime\n    // is no evidence either way: an edit to generated output is newer than\n    // every source, and would have been kept.\n    if (writtenByThis && record.written !== stats.mtimeMs) return false\n\n    const lastRead = writtenByThis ? record.newestSource : null\n\n    if (\n      lastRead === null\n        ? stats.mtimeMs <= newestSource\n        : newestSource > lastRead\n    ) {\n      return false\n    }\n  }\n\n  return true\n}\n\n// The newest mtime among the files a configuration reads, or `null` where that\n// cannot be established: a source that cannot be stat'ed, or patterns that\n// matched no file at all.\n//\n// Asked before a compile reads anything, and recorded against what it writes,\n// so that the next `isUpToDate` compares against what the compile actually\n// read. A save that lands afterwards is newer than this, however much newer\n// the compile's own output turns out to be. Both sides of that comparison are\n// mtimes of the files themselves, so no clock is involved and nothing depends\n// on how finely the filesystem stamps a write.\nexport async function newestSourceOf(\n  {\n    log,\n    root,\n    watch,\n  }: {\n    log: Log\n    root: string\n    watch: UnpluginStyleDictionaryOptions['watch']\n  },\n  item: ResolvedConfig,\n  configObj: Config,\n): Promise<null | number> {\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 read = sourcePatternsOf(configObj)\n  const extra = watchOptionPatterns(root, watch)\n\n  const sources = await expandPatterns(\n    {\n      globs: [...read.globs, ...extra.globs],\n      literals: [...read.literals, ...extra.literals],\n    },\n    log,\n  )\n  if (item.file) sources.push(item.file.replace(/\\\\/g, '/'))\n\n  if (sources.length === 0) return null\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 null\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  return sawFile ? newestSource : null\n}\n\n// The records an earlier process persisted, each marked as such. Anything\n// that does not read as this version's records — a missing file, one another\n// version wrote, one cut short — is no records at all, which costs a compile\n// and never a wrong skip.\nexport function readPersistedRecords(\n  file: string,\n): Map<string, DestinationRecord> {\n  const records = new Map<string, DestinationRecord>()\n\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(fs.readFileSync(file, 'utf8'))\n  } catch {\n    return records\n  }\n\n  if (\n    typeof parsed !== 'object' ||\n    parsed === null ||\n    !('version' in parsed) ||\n    parsed.version !== RECORDS_VERSION ||\n    !('records' in parsed) ||\n    typeof parsed.records !== 'object' ||\n    parsed.records === null\n  ) {\n    return records\n  }\n\n  const stored = parsed.records\n  for (const destination of Object.keys(stored)) {\n    const value: unknown = Reflect.get(stored, destination)\n    if (\n      typeof value === 'object' &&\n      value !== null &&\n      'fingerprint' in value &&\n      typeof value.fingerprint === 'string' &&\n      'newestSource' in value &&\n      (value.newestSource === null || typeof value.newestSource === 'number') &&\n      'written' in value &&\n      (value.written === null || typeof value.written === 'number')\n    ) {\n      records.set(destination, {\n        fingerprint: value.fingerprint,\n        newestSource: value.newestSource,\n        persisted: true,\n        written: value.written,\n      })\n    }\n  }\n\n  return records\n}\n\n// The record a compile leaves for one destination it declared. One it wrote\n// is recorded with the file's mtime, and one Style Dictionary declined to write\n// with `written: null`. `null` comes back where a file it wrote is not there\n// to vouch for, so nothing is recorded for it and the next build compiles.\nexport function recordOf(\n  destination: string,\n  fingerprint: string,\n  newestSource: null | number,\n  wrote: boolean,\n): DestinationRecord | null {\n  if (!wrote) return { fingerprint, newestSource, written: null }\n\n  const stats = statOrNull(destination)\n  return stats ? { fingerprint, newestSource, written: stats.mtimeMs } : null\n}\n\n// Where one project's records persist: under the nearest `package.json`'s\n// `node_modules/.cache`, the directory build tools share for this, and where\n// Vite keeps its own cache. The nearest package rather than `root`, because a\n// host's root can be a subdirectory — Vite's `root: 'src'` — and a cache\n// there would put a `node_modules` inside the consumer's sources. No `.json`\n// extension, so no `source` glob a consumer writes can read it as tokens.\nexport function recordsFileFor(root: string): string {\n  let directory = root\n  while (!fs.existsSync(path.join(directory, 'package.json'))) {\n    const parent = path.dirname(directory)\n    if (parent === directory) {\n      directory = root\n      break\n    }\n    directory = parent\n  }\n\n  return path.join(\n    directory,\n    'node_modules',\n    '.cache',\n    'unplugin-style-dictionary',\n    'records',\n  )\n}\n\n// Merges what one compile recorded into the persisted records.\n//\n// Read again right before the write rather than trusted from the load, so a\n// record another process added since is kept. Two processes writing at once\n// can still lose one's entries, and that only costs a compile on the next\n// start. An entry whose destination is gone is dropped, which bounds the file\n// by the files that exist — and for a file the compile left unwritten, which is\n// never there, by the directory it would have been written into. Written\n// through a temporary file and a rename, so a reader never sees half of it.\nexport function writePersistedRecords(\n  file: string,\n  recorded: ReadonlyMap<string, DestinationRecord>,\n): void {\n  const merged = readPersistedRecords(file)\n  for (const [destination, record] of recorded) merged.set(destination, record)\n\n  const records: Record<string, Omit<DestinationRecord, 'persisted'>> = {}\n  for (const [destination, { fingerprint, newestSource, written }] of merged) {\n    const stillThere =\n      written === null\n        ? statOrNull(path.dirname(destination))\n        : statOrNull(destination)\n    if (stillThere) {\n      records[destination] = { fingerprint, newestSource, written }\n    }\n  }\n\n  const temporary = `${file}.${String(process.pid)}.tmp`\n  try {\n    fs.mkdirSync(path.dirname(file), { recursive: true })\n    fs.writeFileSync(\n      temporary,\n      JSON.stringify({ records, version: RECORDS_VERSION }),\n    )\n    fs.renameSync(temporary, file)\n  } catch {\n    // Only a cache: failing to write it costs a compile on the next start,\n    // and never this build.\n    try {\n      fs.rmSync(temporary, { force: true })\n    } catch {\n      // Nothing more to do about a temporary file that cannot be removed.\n    }\n  }\n}\n\n// Where Style Dictionary writes one file, as an absolute path.\n//\n// It joins the destination onto the platform's `buildPath` when there is one\n// and writes the result relative to the working directory. **Joins, not\n// resolves**: an absolute destination lands under the build path rather than\n// replacing it. Measured with `buildPath: 'gen/'` and an absolute destination,\n// Style Dictionary wrote `gen/<that path>`, while the plugin had named the\n// absolute path on its own — a file that was never written.\n//\n// `root` has no say. It is where a relative `config` path is looked up and\n// nothing more, and reading `buildPath` against it named files that did not\n// exist whenever the two differed (#362). Style Dictionary joins with\n// `path-unified/posix`; the platform's own `join` names the same file, and\n// resolving the result is what normalises the separators either way.\nexport function writtenDestination(\n  buildPath: string | undefined,\n  destination: string,\n): string {\n  return path.resolve(\n    process.cwd(),\n    buildPath ? path.join(buildPath, destination) : destination,\n  )\n}\n\n// The hooks a configuration names by string, each as the registry holds it\n// now: the parsers and preprocessors it lists, each platform's transforms and\n// the transforms its `transformGroup` expands to, and each file's `format`,\n// `filter` and `fileHeader`. A hook given inline is part of the configuration\n// already. The configuration's own `hooks` win over the registry, as they do\n// when Style Dictionary builds.\n//\n// **Only the hooks it names, never the whole registry.** The registry is\n// shared by the whole process, so fingerprinting all of it would let one\n// configuration's `register*` call defeat every other configuration's skip.\nfunction namedHooksOf(\n  configObj: Config,\n): Record<string, Record<string, unknown>> {\n  const own: Hooks = configObj.hooks ?? {}\n  const registry = StyleDictionary.hooks\n  const named: Record<string, Record<string, unknown>> = {}\n\n  const add = (kind: keyof Hooks, name: unknown) => {\n    if (typeof name !== 'string') return\n    const hook: unknown = own[kind]?.[name] ?? registry[kind][name]\n    named[kind] ??= {}\n    named[kind][name] = hook ?? null\n  }\n\n  for (const name of configObj.parsers ?? []) add('parsers', name)\n  for (const name of configObj.preprocessors ?? []) add('preprocessors', name)\n\n  for (const platform of Object.values(configObj.platforms ?? {})) {\n    for (const name of platform.preprocessors ?? []) add('preprocessors', name)\n    for (const transform of platform.transforms ?? []) {\n      add('transforms', transform)\n    }\n\n    const group = platform.transformGroup\n    if (group !== undefined) {\n      add('transformGroups', group)\n\n      // `unknown`, because a group nobody registered is `undefined` here\n      // whatever the registry's type says.\n      const members: unknown =\n        own.transformGroups?.[group] ?? registry.transformGroups[group]\n      if (Array.isArray(members)) {\n        for (const name of members) add('transforms', name)\n      }\n    }\n\n    add('fileHeaders', platform.options?.fileHeader)\n    for (const file of platform.files ?? []) {\n      add('formats', file.format)\n      add('filters', file.filter)\n      add('fileHeaders', file.options?.fileHeader)\n    }\n  }\n\n  return named\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"],"mappings":"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"}

package/dist/watch-filter.js

@@ -1,14 +1,12 @@
 import picomatch from "picomatch";
 //#region src/watch-filter.ts
-function isWatchedSource(file, patterns, generatedDestinations) {
-	return !generatedDestinations.has(file.replace(/\\/g, "/")) && matchesWatchedFile(file, patterns);
+function isWatchedSource(file, { globs, literals }, generatedDestinations) {
+	const normalizedFile = file.replace(/\\/g, "/");
+	return !generatedDestinations.has(normalizedFile) && (literals.includes(normalizedFile) || matchesWatchedFile(normalizedFile, globs));
 }
 function matchesWatchedFile(file, patterns) {
 	const normalizedFile = file.replace(/\\/g, "/");
-	return patterns.some((pattern) => {
-		const normalizedPattern = pattern.replace(/\\/g, "/");
-		return normalizedPattern === normalizedFile || picomatch.isMatch(normalizedFile, normalizedPattern);
-	});
+	return patterns.some((pattern) => pattern === normalizedFile || picomatch.isMatch(normalizedFile, pattern));
 }
 //#endregion
 export { isWatchedSource, matchesWatchedFile };

package/dist/watch-filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch-filter.js","names":[],"sources":["../src/watch-filter.ts"],"sourcesContent":["import picomatch from 'picomatch'\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//\n// `generatedDestinations` is the plugin instance's own record of what it\n// wrote, so it is handed in rather than held: one module serves every\n// instance in the process, and each one's output is its own.\nexport function isWatchedSource(\n  file: string,\n  patterns: string[],\n  generatedDestinations: ReadonlySet<string>,\n): boolean {\n  return (\n    !generatedDestinations.has(file.replace(/\\\\/g, '/')) &&\n    matchesWatchedFile(file, patterns)\n  )\n}\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// `isWatchedSource` above, and `generatedDestinations` in the factory.\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"],"mappings":";;AASA,SAAgB,gBACd,MACA,UACA,uBACS;CACT,OACE,CAAC,sBAAsB,IAAI,KAAK,QAAQ,OAAO,GAAG,CAAC,KACnD,mBAAmB,MAAM,QAAQ;AAErC;AAkCA,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"}
+{"version":3,"file":"watch-filter.js","names":[],"sources":["../src/watch-filter.ts"],"sourcesContent":["import picomatch from 'picomatch'\n\nimport type { WatchPatterns } from './patterns.js'\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//\n// `generatedDestinations` is the plugin instance's own record of what it\n// wrote, so it is handed in rather than held: one module serves every\n// instance in the process, and each one's output is its own.\n//\n// A literal is a path, so it is compared as one. A config file reaches here\n// that way, and so does a token file named without a glob, and neither may be\n// read as a pattern: the project's own directory can hold characters a glob\n// treats as syntax.\nexport function isWatchedSource(\n  file: string,\n  { globs, literals }: WatchPatterns,\n  generatedDestinations: ReadonlySet<string>,\n): boolean {\n  const normalizedFile = file.replace(/\\\\/g, '/')\n\n  return (\n    !generatedDestinations.has(normalizedFile) &&\n    (literals.includes(normalizedFile) ||\n      matchesWatchedFile(normalizedFile, globs))\n  )\n}\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// `isWatchedSource` above, and `generatedDestinations` in the factory.\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.\n//\n// **The patterns are used exactly as given.** A backslash in one is an escape:\n// the part of a pattern the plugin prefixed is escaped, and every producer\n// already writes separators as `/`. Rewriting backslashes to slashes here\n// turned each escape into a separator, so a project in `Dropbox (Personal)`\n// matched none of its own token files.\nexport function matchesWatchedFile(file: string, patterns: string[]): boolean {\n  const normalizedFile = file.replace(/\\\\/g, '/')\n\n  return patterns.some(\n    (pattern) =>\n      // An absolute path a consumer wrote with a glob character in it is filed\n      // as a glob, and still names itself.\n      pattern === normalizedFile || picomatch.isMatch(normalizedFile, pattern),\n  )\n}\n"],"mappings":";;AAgBA,SAAgB,gBACd,MACA,EAAE,OAAO,YACT,uBACS;CACT,MAAM,iBAAiB,KAAK,QAAQ,OAAO,GAAG;CAE9C,OACE,CAAC,sBAAsB,IAAI,cAAc,MACxC,SAAS,SAAS,cAAc,KAC/B,mBAAmB,gBAAgB,KAAK;AAE9C;AAwCA,SAAgB,mBAAmB,MAAc,UAA6B;CAC5E,MAAM,iBAAiB,KAAK,QAAQ,OAAO,GAAG;CAE9C,OAAO,SAAS,MACb,YAGC,YAAY,kBAAkB,UAAU,QAAQ,gBAAgB,OAAO,CAC3E;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kanso-labs/unplugin-style-dictionary",
-  "version": "0.10.11",
+  "version": "0.10.13",
   "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",
@@ -84,30 +84,30 @@
     "@commitlint/config-conventional": "21.2.3",
     "@eslint/js": "10.0.1",
     "@rspack/core": "2.2.7",
-    "@types/node": "26.6.2",
+    "@types/node": "26.6.3",
     "@types/picomatch": "4.0.3",
     "@types/semver": "7.8.0",
-    "@vitest/coverage-v8": "5.0.1",
+    "@vitest/coverage-v8": "5.0.2",
     "eslint": "10.11.0",
     "eslint-plugin-oxlint": "1.85.0",
     "eslint-plugin-perfectionist": "5.12.1",
     "globals": "17.12.0",
     "husky": "9.1.7",
-    "lint-staged": "17.5.1",
+    "lint-staged": "17.6.0",
     "oxfmt": "0.70.0",
     "oxlint": "1.85.0",
-    "oxlint-tsgolint": "7.0.2002",
+    "oxlint-tsgolint": "7.0.2003",
     "publint": "0.3.24",
     "rimraf": "6.1.3",
-    "rolldown": "1.2.10",
-    "rollup": "4.63.4",
+    "rolldown": "1.2.11",
+    "rollup": "4.63.5",
     "semver": "7.8.5",
     "style-dictionary": "5.5.5",
     "tsdown": "0.23.0",
     "typescript": "6.0.3",
     "typescript-eslint": "8.70.1",
-    "vite": "8.3.0",
-    "vitest": "5.0.1",
+    "vite": "8.3.1",
+    "vitest": "5.0.2",
     "webpack": "5.111.1"
   },
   "peerDependencies": {