fluent-transpiler 0.4.0 → 0.5.0

package/README.md

@@ -35,12 +35,14 @@ npm i -D fluent-transpiler
 ## CLI
 
 ```bash
-Usage: ftl [options] <input>
+Usage: ftl [options] <inputs...>
 
 Compile Fluent (.ftl) files to JavaScript (.js or .mjs)
 
 Arguments:
-  input                                   Path to the Fluent file to compile
+  inputs                                  Paths to the Fluent file(s) to compile.
+                                          Multiple files are joined in order;
+                                          ids must be unique across the set.
 
 Options:
   --locale <locale...>                    What locale(s) to be used. Multiple can be set to allow for fallback. i.e. en-CA
@@ -79,3 +81,20 @@ const ftl = await readFile('./path/to/en.ftl', { encoding: 'utf8' })
 const js = fluentTranspiler(ftl, { locale: 'en-CA' })
 await writeFile('./path/to/en.mjs', js, 'utf8')
 ```
+
+### Joining multiple files
+
+`compile` also accepts an array of source strings, and `compileFiles` reads and
+joins files from disk. Sources are concatenated in the order supplied; top-level
+message and term ids must be unique across the set.
+
+```javascript
+import { writeFile } from 'node:fs/promises'
+import { compileFiles } from 'fluent-transpiler'
+
+const js = await compileFiles(
+  ['./common.ftl', './brand.ftl', './app.ftl'],
+  { locale: 'en-CA' },
+)
+await writeFile('./en.mjs', js, 'utf8')
+```

package/cli.js

@@ -2,9 +2,9 @@
 // Copyright 2026 will Farrell, and fluent-transpiler contributors.
 // SPDX-License-Identifier: MIT
 
-import { readFile, stat, writeFile } from "node:fs/promises";
+import { stat, writeFile } from "node:fs/promises";
 import { Command, Option } from "commander";
-import compile from "./index.js";
+import { compileFiles } from "./index.js";
 
 const fileExists = async (filepath) => {
 	const stats = await stat(filepath);
@@ -16,7 +16,10 @@ const fileExists = async (filepath) => {
 new Command()
 	.name("ftl")
 	.description("Compile Fluent (.ftl) files to JavaScript (.js or .mjs)")
-	.argument("<input>", "Path to the Fluent file to compile")
+	.argument(
+		"<inputs...>",
+		"Paths to the Fluent file(s) to compile. Multiple files are joined in order; ids must be unique across the set.",
+	)
 	.requiredOption(
 		"--locale <locale...>",
 		"What locale(s) to be used. Multiple can be set to allow for fallback. i.e. en-CA",
@@ -68,14 +71,14 @@ new Command()
 			"Path to store the resulting JavaScript file. Will be in ESM.",
 		),
 	)
-	.action(async (input, options) => {
+	.action(async (inputs, options) => {
 		options.comments = options.comments ?? false;
 		try {
-			await fileExists(input);
-
-			const ftl = await readFile(input, { encoding: "utf8" });
+			for (const input of inputs) {
+				await fileExists(input);
+			}
 
-			const js = compile(ftl, options);
+			const js = await compileFiles(inputs, options);
 			if (options.output) {
 				await writeFile(options.output, js, "utf8");
 			} else {

package/index.d.ts

@@ -28,7 +28,22 @@ export interface CompileOptions {
 
 /**
  * Compile Fluent (.ftl) source into a JavaScript ESM string.
+ * Pass an array of source strings to join multiple files into one module;
+ * top-level message/term ids must be unique across the set.
  */
-export declare function compile(src: string, opts?: CompileOptions): string;
+export declare function compile(
+	src: string | string[],
+	opts?: CompileOptions,
+): string;
+
+/**
+ * Read and compile one or more Fluent (.ftl) files into a single JavaScript
+ * ESM string. Files are joined in the order supplied. Top-level message/term
+ * ids must be unique across the set.
+ */
+export declare function compileFiles(
+	paths: string[],
+	opts?: CompileOptions,
+): Promise<string>;
 
 export default compile;

package/index.js

@@ -1,9 +1,42 @@
 // Copyright 2026 will Farrell, and fluent-transpiler contributors.
 // SPDX-License-Identifier: MIT
 
+import { readFile } from "node:fs/promises";
 import { parse } from "@fluent/syntax";
 import { camelCase, constantCase, pascalCase, snakeCase } from "change-case";
 
+const collectTopLevelIds = (src) => {
+	const { body } = parse(src);
+	const ids = [];
+	for (const node of body) {
+		if (node.type === "Message" || node.type === "Term") {
+			ids.push(node.id.name);
+		}
+	}
+	return ids;
+};
+
+const checkDuplicates = (sources) => {
+	const seen = new Map();
+	const duplicates = [];
+	for (const { label, src } of sources) {
+		for (const id of collectTopLevelIds(src)) {
+			const prior = seen.get(id);
+			if (prior !== undefined && prior !== label) {
+				duplicates.push({ id, a: prior, b: label });
+			} else if (prior === undefined) {
+				seen.set(id, label);
+			}
+		}
+	}
+	if (duplicates.length) {
+		const lines = duplicates.map(
+			(d) => `  - "${d.id}" defined in ${d.a} and ${d.b}`,
+		);
+		throw new Error(`Duplicate id(s) found:\n${lines.join("\n")}`);
+	}
+};
+
 const reservedWords = new Set([
 	"abstract",
 	"arguments",
@@ -81,6 +114,11 @@ const exportDefault = `(id, params) => {
 }
 `;
 export const compile = (src, opts) => {
+	if (Array.isArray(src)) {
+		const sources = src.map((s, i) => ({ label: `source[${i}]`, src: s }));
+		checkDuplicates(sources);
+		src = src.join("\n\n");
+	}
 	const options = {
 		comments: true,
 		errorOnJunk: true,
@@ -510,4 +548,15 @@ const variableNotation = {
 	constantCase,
 };
 
+export const compileFiles = async (paths, opts) => {
+	const sources = await Promise.all(
+		paths.map(async (path) => ({
+			label: path,
+			src: await readFile(path, { encoding: "utf8" }),
+		})),
+	);
+	checkDuplicates(sources);
+	return compile(sources.map((s) => s.src).join("\n\n"), opts);
+};
+
 export default compile;

package/package.json

@@ -3,7 +3,7 @@
 		".github"
 	],
 	"name": "fluent-transpiler",
-	"version": "0.4.0",
+	"version": "0.5.0",
 	"description": "Transpile Fluent (ftl) files into optimized, tree-shakable, JavaScript EcmaScript Modules (esm).",
 	"main": "index.js",
 	"types": "index.d.ts",
@@ -40,14 +40,21 @@
 		"test:unit": "node --test --test-force-exit --experimental-test-coverage --test-coverage-lines=100 --test-coverage-branches=100 --test-coverage-functions=100 ./**/*.test.js",
 		"test:types": "tstyche",
 		"test:perf": "node --test --test-concurrency=1 ./**/*.perf.js",
-		"test:sast": "npm run test:sast:license && npm run test:sast:lockfile && npm run test:sast:semgrep && npm run test:sast:trufflehog && npm run test:sast:trivy",
+		"test:sast": "npm run test:sast:license && npm run test:sast:lockfile && npm run test:sast:semgrep && npm run test:sast:trufflehog && npm run test:sast:gitleaks && npm run test:sast:actionlint && npm run test:sast:zizmor && npm run test:sast:trivy",
+		"test:sast:actionlint": "actionlint",
+		"test:sast:gitleaks": "gitleaks detect --source . --redact --no-banner",
 		"test:sast:license": "license-check-and-add check -f license.json",
 		"test:sast:lockfile": "lockfile-lint --path package-lock.json --type npm --allowed-schemes \"https:\" --allowed-hosts npm --validate-integrity --validate-package-names",
 		"test:sast:semgrep": "semgrep scan --config auto",
 		"test:sast:trivy": "trivy fs --scanners vuln,license --include-dev-deps --ignored-licenses 0BSD,Apache-2.0,BSD-1-Clause,BSD-2-Clause,BSD-3-Clause,CC0-1.0,CC-BY-4.0,ISC,MIT,Python-2.0 --exit-code 1 --disable-telemetry .",
 		"test:sast:trufflehog": "trufflehog filesystem --only-verified --log-level=-1 ./",
+		"test:sast:zizmor": "zizmor .github/workflows/",
 		"test:dast": "npm run test:dast:fuzz",
 		"test:dast:fuzz": "node --test ./**/*.fuzz.js",
+		"rm": "npm run rm:macos && npm run rm:node_modules && npm run rm:lock",
+		"rm:macos": "find . -name '.DS_Store' -type f -delete",
+		"rm:lock": "find . -name 'package-lock.json' -type f -delete",
+		"rm:node_modules": "find . -name 'node_modules' -type d -prune -exec rm -rf '{}' +",
 		"release:license:add": "license-check-and-add add -f license.json",
 		"release:license:remove": "license-check-and-add remove -f license.json"
 	},
@@ -80,14 +87,14 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.0.0",
-		"@commitlint/cli": "^20.0.0",
-		"@commitlint/config-conventional": "^20.0.0",
+		"@commitlint/cli": "^21.0.0",
+		"@commitlint/config-conventional": "^21.0.0",
 		"@fluent/bundle": "^0.19.0",
 		"fast-check": "^4.0.0",
 		"husky": "^9.0.0",
 		"license-check-and-add": "4.0.5",
 		"tinybench": "^6.0.0",
-		"tstyche": "^6.0.0"
+		"tstyche": "^7.0.0"
 	},
 	"funding": {
 		"type": "github",