@prosopo/config 3.4.1 → 3.4.3

package/src/vite/translations.test.ts

@@ -1,164 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import type { Rollup } from "vite";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import VitePluginRemoveUnusedTranslations from "./vite-plugin-remove-unused-translations.js";
-
-let root: string;
-let cwd: string;
-
-beforeEach(() => {
-	root = fs.mkdtempSync(path.join(os.tmpdir(), "prosopo-translations-test-"));
-	cwd = process.cwd();
-	process.chdir(root);
-});
-
-afterEach(() => {
-	process.chdir(cwd);
-	fs.rmSync(root, { recursive: true, force: true });
-});
-
-/** Vite plugin hooks may be a bare function or an object with a `handler`. */
-type Hook<A extends unknown[], R> =
-	| ((...args: A) => R)
-	| { handler: (...args: A) => R }
-	| undefined;
-
-const callHook = <A extends unknown[], R>(hook: Hook<A, R>, ...args: A): R => {
-	if (!hook) {
-		throw new Error("plugin does not define the hook");
-	}
-	const handler = typeof hook === "function" ? hook : hook.handler;
-	return handler(...args);
-};
-
-const writeJson = (name: string, data: unknown): string => {
-	const filePath = path.join(root, name);
-	fs.writeFileSync(filePath, JSON.stringify(data));
-	return filePath;
-};
-
-const readJson = (filePath: string): unknown =>
-	JSON.parse(fs.readFileSync(filePath, "utf-8"));
-
-const run = async (
-	keys: string[],
-	sources: string[],
-	pattern: string,
-): Promise<void> => {
-	const plugin = VitePluginRemoveUnusedTranslations(keys, pattern);
-	for (const source of sources) {
-		callHook(plugin.transform, source, "id.ts");
-	}
-	await callHook(
-		plugin.writeBundle,
-		{} as Rollup.NormalizedOutputOptions,
-		{} as Rollup.OutputBundle,
-	);
-};
-
-describe("VitePluginRemoveUnusedTranslations", () => {
-	it("runs after the other plugins, once the code is final", () => {
-		expect(VitePluginRemoveUnusedTranslations([], "*.json").enforce).toBe(
-			"post",
-		);
-	});
-
-	it("returns the code it was given, unmodified", () => {
-		const plugin = VitePluginRemoveUnusedTranslations(["zz"], "*.json");
-		expect(callHook(plugin.transform, "uses zz", "id.ts")).toEqual({
-			code: "uses zz",
-		});
-	});
-
-	// The set of used keys lives at module scope, shared by every plugin
-	// instance in the process, so each test below uses key names of its own.
-
-	it("keeps only the keys the bundle actually references", async () => {
-		const file = writeJson("en.json", { kept: "yes", dropped: "no" });
-		await run(["kept", "dropped"], ["t('kept')"], `${root}/*.json`);
-		expect(readJson(file)).toEqual({ kept: "yes" });
-	});
-
-	it("restores the nesting of the keys it keeps", async () => {
-		const file = writeJson("en.json", {
-			widget: { label: "Verify", hint: "Click" },
-		});
-		await run(
-			["widget.label", "widget.hint"],
-			["t('widget.label')"],
-			`${root}/*.json`,
-		);
-		expect(readJson(file)).toEqual({ widget: { label: "Verify" } });
-	});
-
-	it("empties a file whose keys are all unused", async () => {
-		const file = writeJson("en.json", { solo: "1" });
-		await run(["solo"], ["nothing here"], `${root}/*.json`);
-		expect(readJson(file)).toEqual({});
-	});
-
-	it("prunes every matching file", async () => {
-		const en = writeJson("en.json", { pa: "en", pb: "en" });
-		const fr = writeJson("fr.json", { pa: "fr", pb: "fr" });
-		await run(["pa", "pb"], ["t('pa')"], `${root}/*.json`);
-		expect(readJson(en)).toEqual({ pa: "en" });
-		expect(readJson(fr)).toEqual({ pa: "fr" });
-	});
-
-	it("does nothing when the pattern matches no file", async () => {
-		await expect(
-			run(["nk"], ["t('nk')"], `${root}/none/*.json`),
-		).resolves.toBeUndefined();
-	});
-
-	it("leaves a malformed JSON file alone instead of failing the build", async () => {
-		// A translation file is not worth aborting a release for; the bundle is
-		// already written by the time this hook runs.
-		const broken = path.join(root, "en.json");
-		fs.writeFileSync(broken, "{ not json");
-		await expect(
-			run(["mk"], ["t('mk')"], `${root}/*.json`),
-		).resolves.toBeUndefined();
-		expect(fs.readFileSync(broken, "utf-8")).toBe("{ not json");
-	});
-
-	it("declares no key used when the key list is empty", async () => {
-		const file = writeJson("en.json", { ek: "1" });
-		await run([], ["t('ek')"], `${root}/*.json`);
-		expect(readJson(file)).toEqual({});
-	});
-
-	it("matches a key as a substring of the emitted code", async () => {
-		// The keys are looked for with `includes`, not as whole tokens, so a key
-		// that is a prefix of another is kept whenever the longer one is used.
-		const file = writeJson("en.json", { sa: "1", sab: "2" });
-		await run(["sa", "sab"], ["t('sab')"], `${root}/*.json`);
-		expect(readJson(file)).toEqual({ sa: "1", sab: "2" });
-	});
-
-	it("accumulates used keys across every transformed module", async () => {
-		const file = writeJson("en.json", { one: "1", two: "2", three: "3" });
-		await run(
-			["one", "two", "three"],
-			["t('one')", "t('two')"],
-			`${root}/*.json`,
-		);
-		expect(readJson(file)).toEqual({ one: "1", two: "2" });
-	});
-});

package/src/vite/types.ts

@@ -1,13 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.

package/src/vite/vite-plugin-close-and-copy.ts

@@ -1,76 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import fs from "node:fs";
-import path from "node:path";
-import type { Plugin } from "vite";
-
-export interface ClosePluginOptions {
-	srcDir: string;
-	destDir: string[];
-}
-
-/**
- *   description: Closes Vite after the bundle has been build. Optionally copies the bundle to a different directory.
- *   @param { ClosePluginOptions } options - The options object
- **/
-export default function VitePluginCloseAndCopy(
-	options?: ClosePluginOptions,
-): Plugin {
-	const __dirname = path.resolve();
-	return {
-		name: "close-plugin", // required, will show up in warnings and errors
-		buildStart() {
-			console.info("Bundle build started");
-		},
-		buildEnd(error) {
-			console.info("Build end");
-			if (error) {
-				console.log(error);
-				console.error(error);
-			}
-		},
-		closeBundle() {
-			if (options) {
-				for (const destDir of options.destDir) {
-					clearOutputDirJS(__dirname, destDir);
-					console.info(`Bundle cleared from ${options.destDir}`);
-					copyBundle(__dirname, options.srcDir, destDir);
-					console.info(`Bundle copied to ${options.destDir}`);
-				}
-				console.info("Bundle closed");
-			}
-		},
-	};
-}
-
-const clearOutputDirJS = (__dirname: string, destDir: string) =>
-	fs
-		.readdirSync(path.resolve(__dirname, destDir))
-		.filter((file) => file.endsWith("js"))
-		.map((file) => {
-			fs.rmSync(path.resolve(__dirname, destDir, file));
-		});
-
-const copyBundle = (__dirname: string, srcDir: string, destDir: string) => {
-	console.info(
-		"Copying",
-		path.resolve(__dirname, srcDir),
-		"to",
-		path.resolve(__dirname, destDir),
-	);
-	fs.cpSync(path.resolve(__dirname, srcDir), path.resolve(__dirname, destDir), {
-		recursive: true,
-	});
-};

package/src/vite/vite-plugin-copy.ts

@@ -1,67 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import fs from "node:fs";
-import path from "node:path";
-import fg from "fast-glob";
-import type { Plugin } from "vite";
-
-interface CopyPluginOptions {
-	srcDir: string;
-	destDir: string;
-	include?: string[]; // Optional: glob patterns for files to include
-	exclude?: string[]; // Optional: glob patterns for files to exclude
-}
-
-function ensureDirExists(filePath: string) {
-	const dir = path.dirname(filePath);
-	if (!fs.existsSync(dir)) {
-		fs.mkdirSync(dir, { recursive: true });
-	}
-}
-
-export default function VitePluginCopy(options: CopyPluginOptions): Plugin {
-	const __dirname = path.resolve();
-	return {
-		name: "copy-plugin",
-		async closeBundle() {
-			const srcAbs = path.resolve(__dirname, options.srcDir);
-			const destAbs = path.resolve(__dirname, options.destDir);
-			const include =
-				options.include && options.include.length > 0
-					? options.include
-					: undefined;
-			const exclude = options.exclude || [];
-			if (!include) {
-				console.info(
-					"[copy-plugin] No include globs specified, nothing to copy.",
-				);
-				return;
-			}
-			const files = await fg(include, {
-				cwd: srcAbs,
-				ignore: exclude,
-				onlyFiles: true,
-				absolute: false,
-			});
-			for (const relFile of files) {
-				const srcFile = path.join(srcAbs, relFile);
-				const destFile = path.join(destAbs, relFile);
-				ensureDirExists(destFile);
-				console.info(`[copy-plugin] copying ${srcFile} to ${destFile}`);
-				fs.copyFileSync(srcFile, destFile);
-			}
-		},
-	};
-}

package/src/vite/vite-plugin-externalize-obfuscator-deadcode.ts

@@ -1,43 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-import type { Plugin } from "vite";
-
-// js-confuser's `deadCode` transform injects a fixed set of fake `require()`
-// specifiers into obfuscated sources as unreachable dead code. Rollup (Vite 6)
-// left unresolved imports external with a warning, so these harmless specifiers
-// never broke the build. Rolldown (Vite 8) treats an unresolved import as a hard
-// error, so we restore the old behaviour by marking exactly these known
-// dead-code specifiers as external. They are never executed at runtime.
-const OBFUSCATOR_DEADCODE_SPECIFIERS: ReadonlySet<string> = new Set([
-	"../../package",
-	"../redacted.js",
-	"../utils/isStandaloneExecutable",
-	"./resolve-local-redacted-path",
-	"@redacted/components/package",
-	"@redacted/enterprise-plugin",
-	"@redacted/enterprise-plugin/package",
-]);
-
-export default function VitePluginExternalizeObfuscatorDeadCode(): Plugin {
-	return {
-		name: "externalize-obfuscator-deadcode",
-		enforce: "pre",
-		resolveId(source: string) {
-			if (OBFUSCATOR_DEADCODE_SPECIFIERS.has(source)) {
-				return { id: source, external: true };
-			}
-			return null;
-		},
-	};
-}

package/src/vite/vite-plugin-fix-absolute-imports.ts

@@ -1,40 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-import { builtinModules } from "node:module";
-import type { Plugin } from "vite";
-
-export default function VitePluginFixAbsoluteImports(): Plugin {
-	return {
-		name: "fix-absolute-imports",
-		transform(code: string, id: string) {
-			for (const module of builtinModules) {
-				const moduleImportRegex = new RegExp(
-					`from "(${module}(/.*)*/.*.js)";`,
-					"g",
-				);
-				// if matches, replace match with _module
-				const matches = code.match(moduleImportRegex);
-				if (matches) {
-					for (const match of matches) {
-						code = code.replace(match, `from "${module}";`);
-					}
-				}
-			}
-			return {
-				code,
-			};
-		},
-		enforce: "post",
-	};
-}

package/src/vite/vite-plugin-modify-exports-files.ts

@@ -1,64 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-import type { Plugin } from "vite";
-
-/**
- * Empties the generated `exports2.FILES` array in every emitted chunk so that
- * bundled file listings are not leaked into the output.
- */
-const ASSIGNMENT = "exports2.FILES = [";
-const TERMINATOR = "];";
-const REPLACEMENT = "exports2.FILES = [];\n";
-
-/**
- * Blank every `exports2.FILES = [...]` assignment in a chunk.
- *
- * Done with indexOf rather than a regex: `\[[\s\S]*?\];` backtracks
- * quadratically on a chunk holding many unterminated assignments, and chunk
- * contents are whatever the bundled sources happened to contain. Scanning
- * forward is linear regardless.
- */
-export const emptyExportsFiles = (code: string): string => {
-	let out = "";
-	let cursor = 0;
-	for (;;) {
-		const start = code.indexOf(ASSIGNMENT, cursor);
-		if (start === -1) {
-			break;
-		}
-		const end = code.indexOf(TERMINATOR, start + ASSIGNMENT.length);
-		if (end === -1) {
-			// Unterminated: leave it and everything after it alone rather than
-			// truncating the chunk.
-			break;
-		}
-		out += code.slice(cursor, start) + REPLACEMENT;
-		cursor = end + TERMINATOR.length;
-	}
-	return out + code.slice(cursor);
-};
-
-export default function modifyExportsFilesPlugin(): Plugin {
-	return {
-		name: "modify-exports-files",
-		generateBundle(_options, bundle) {
-			for (const fileName in bundle) {
-				const chunk = bundle[fileName];
-				if (chunk && chunk.type === "chunk") {
-					chunk.code = emptyExportsFiles(chunk.code);
-				}
-			}
-		},
-	};
-}

package/src/vite/vite-plugin-remove-unused-translations.ts

@@ -1,128 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-import fs from "node:fs/promises";
-import glob from "fast-glob";
-import type { Plugin } from "vite";
-
-const used = new Set<string>();
-
-export const flatten = (obj: object, prefix = ""): Record<string, string> => {
-	const flattenedObj: Record<string, string> = {};
-	for (const [key, value] of Object.entries(obj)) {
-		if (value instanceof Object) {
-			Object.assign(flattenedObj, flatten(value, `${prefix + key}.`));
-		} else {
-			flattenedObj[prefix + key] = value;
-		}
-	}
-	return flattenedObj;
-};
-
-type UnflattenObject =
-	| Record<string, string | number | boolean | undefined>
-	| string[]
-	| number[]
-	| boolean[];
-
-export const unflatten = (
-	obj: Record<string, string | number | boolean>,
-): Record<string, string | number | boolean | UnflattenObject> => {
-	const result: Record<string, string | number | boolean | UnflattenObject> =
-		{};
-
-	for (const [key, value] of Object.entries(obj)) {
-		const keys = key.split(".");
-		keys.reduce((acc, k, i) => {
-			if (i === keys.length - 1) {
-				(acc as Record<string, string | number | boolean | UnflattenObject>)[
-					k
-				] = value;
-			} else {
-				if (!acc[k]) {
-					acc[k] = Number.isNaN(Number(keys[i + 1])) ? {} : [];
-				}
-			}
-			return acc[k] as Record<
-				string,
-				string | number | boolean | UnflattenObject
-			>;
-		}, result);
-	}
-
-	return result;
-};
-
-export default function VitePluginRemoveUnusedTranslations(
-	translationKeys: string[],
-	jsonPattern: string,
-): Plugin {
-	return {
-		name: "remove-unused-translations",
-		transform(code: string) {
-			// Collect translation keys used in the source files
-			for (const key of translationKeys) {
-				if (code.includes(key) && !used.has(key)) {
-					console.info(`Found key: ${key}`);
-					used.add(key);
-				}
-			}
-			return { code };
-		},
-		enforce: "post",
-
-		async writeBundle() {
-			// Find all matching JSON files
-			const jsonFiles = await glob(jsonPattern, { absolute: true });
-
-			console.info(`Found ${jsonFiles.length} JSON files at ${jsonPattern}`);
-
-			const filePromises = [];
-			for (const filePath of jsonFiles) {
-				try {
-					const content = await fs.readFile(filePath, "utf-8");
-					const jsonData = JSON.parse(content);
-					const jsonDataFlattened = flatten(jsonData);
-
-					// Remove keys that are not in `used`
-					const filteredData = Object.fromEntries(
-						Object.entries(jsonDataFlattened).filter(([key]) => used.has(key)),
-					);
-
-					const unflattened = unflatten(filteredData);
-
-					// log.info(unflattened);
-
-					// Write back the filtered JSON
-					filePromises.push(
-						fs
-							.writeFile(
-								filePath,
-								JSON.stringify(unflattened, null, 2),
-								"utf-8",
-							)
-							.then(() => {
-								console.info(`Updated ${filePath}`);
-							})
-							.catch((e) => {
-								console.error(`Failed to update ${filePath}:`, e);
-							}),
-					);
-				} catch (error: unknown) {
-					console.error(`Failed to process ${filePath}:`, error);
-				}
-			}
-			await Promise.all(filePromises);
-		},
-	};
-}

package/src/vite/vite-plugin-sourcemap-exclude.ts

@@ -1,36 +0,0 @@
-// Copyright 2021-2026 Prosopo (UK) Ltd.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-import type { Plugin } from "vite";
-
-interface SourcemapExclude {
-	excludeNodeModules?: boolean;
-}
-// Taken from https://github.com/vitejs/vite/issues/2433#issuecomment-1487472995 to prevent memory leaks
-export default function VitePluginSourcemapExclude(
-	opts?: SourcemapExclude,
-): Plugin {
-	return {
-		name: "sourcemap-exclude",
-		transform(code: string, id: string) {
-			if (opts?.excludeNodeModules && id.includes("node_modules")) {
-				return {
-					code,
-					// https://github.com/rollup/rollup/blob/master/docs/plugin-development/index.md#source-code-transformations
-					map: { mappings: "" },
-				};
-			}
-			return;
-		},
-	};
-}