@rohal12/twee-ts 1.15.4 → 1.16.0

package/dist/bin/twee-ts.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import { parseArgs } from "node:util";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
-import { basename, dirname, extname, join, parse, relative, resolve } from "node:path";
+import * as nodePath from "node:path";
+import { basename, dirname, extname, join, parse, relative, resolve, sep } from "node:path";
 import { randomUUID } from "node:crypto";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
@@ -603,11 +604,25 @@ function fontFormatHint(ext) {
 * Ported from filesystem.go.
 */
 /**
+* Whether `filename` matches one of the `exclude` globs. The globs are matched
+* against the file's path relative to the working directory, the path
+* getFilenames reports; an absolute `filename` is made relative first. A leading
+* `./` in a glob is dropped. Matching is Node's `path.matchesGlob`.
+*/
+function isExcluded(filename, exclude) {
+	if (exclude.length === 0) return false;
+	const { matchesGlob } = nodePath;
+	if (typeof matchesGlob !== "function") throw new Error(`The exclude option needs Node.js 22.5 or newer (found ${process.version}).`);
+	const rel = relative(process.cwd(), resolve(filename)) || filename;
+	return exclude.some((pattern) => matchesGlob(rel, pattern.replace(/^\.\//, "")));
+}
+/**
 * Recursively walk directories, collecting regular file paths.
-* Filters out the output file to prevent circular compilation.
+* Filters out the output file to prevent circular compilation, and the files
+* that match an `exclude` glob (see isExcluded).
 * Like Tweego, a path that cannot be read is reported as a warning and skipped.
 */
-function getFilenames(pathnames, outFilename) {
+function getFilenames(pathnames, outFilename, exclude = []) {
 	const filenames = [];
 	const diagnostics = [];
 	const absOutFile = outFilename ? resolve(outFilename) : "";
@@ -629,6 +644,7 @@ function getFilenames(pathnames, outFilename) {
 			const abs = resolve(pathname);
 			if (abs === absOutFile) return;
 			const rel = relative(process.cwd(), abs);
+			if (isExcluded(rel || abs, exclude)) return;
 			filenames.push(rel || abs);
 		} else if (stat.isDirectory()) {
 			let entries;
@@ -649,9 +665,11 @@ function getFilenames(pathnames, outFilename) {
 }
 /**
 * Watch paths for changes, calling the build callback on known file type changes.
+* A change to a file `ignore` returns true for (given the path relative to the
+* working directory) schedules no build.
 * Uses debouncing to avoid rapid rebuilds.
 */
-function watchFilesystem(pathnames, outFilename, callback) {
+function watchFilesystem(pathnames, outFilename, callback, ignore = () => false) {
 	const absOutFile = resolve(outFilename);
 	const watchers = [];
 	let buildTimer = null;
@@ -672,7 +690,10 @@ function watchFilesystem(pathnames, outFilename, callback) {
 			if (!filename) return;
 			const abs = resolve(pathname, filename);
 			if (abs === absOutFile) return;
-			if (isKnownFileType(filename)) scheduleBuild(relative(process.cwd(), abs) || abs);
+			if (isKnownFileType(filename)) {
+				const rel = relative(process.cwd(), abs);
+				if (!ignore(rel || abs)) scheduleBuild(rel || abs);
+			}
 		});
 		watchers.push(watcher);
 	} catch {}
@@ -5110,14 +5131,22 @@ async function watch$1(options) {
 	const cache = /* @__PURE__ */ new Map();
 	const filePaths = options.sources.filter((s) => typeof s === "string");
 	const modulePaths = options.modules ?? [];
-	const handle = watchFilesystem([...filePaths, ...modulePaths], options.outFile, (changedFiles) => {
+	const allPaths = [...filePaths, ...modulePaths];
+	const exclude = options.exclude ?? [];
+	const moduleRoots = modulePaths.map((p) => resolve(p));
+	const ignore = (filename) => {
+		if (!isExcluded(filename, exclude)) return false;
+		const abs = resolve(filename);
+		return !moduleRoots.some((root) => abs === root || abs.startsWith(root + sep));
+	};
+	const handle = watchFilesystem(allPaths, options.outFile, (changedFiles) => {
 		buildOutput(options, cache, changedFiles).then((result) => {
 			writeFileSync(options.outFile, result.output, "utf-8");
 			options.onBuild?.(result);
 		}).catch((e) => {
 			options.onError?.(e instanceof Error ? e : new Error(String(e)));
 		});
-	});
+	}, ignore);
 	controller.signal.addEventListener("abort", () => handle.close());
 	return controller;
 }
@@ -5134,7 +5163,7 @@ async function buildOutput(options, cache, changedFiles) {
 	const inlineSources = [];
 	for (const source of options.sources) if (typeof source === "string") filePaths.push(source);
 	else inlineSources.push(source);
-	const { filenames: sourceFilenames, diagnostics: sourcePathDiagnostics } = getFilenames(filePaths);
+	const { filenames: sourceFilenames, diagnostics: sourcePathDiagnostics } = getFilenames(filePaths, void 0, options.exclude);
 	diagnostics.push(...sourcePathDiagnostics);
 	const story = createStory();
 	const processedFiles = /* @__PURE__ */ new Set();
@@ -6659,6 +6688,7 @@ function validateConfig(data) {
 	]) if (key in obj && typeof obj[key] !== "boolean") errors.push(`"${key}" must be a boolean.`);
 	for (const key of [
 		"sources",
+		"exclude",
 		"formatPaths",
 		"formatIndices",
 		"formatUrls",
@@ -6767,6 +6797,10 @@ const { values, positionals } = parseArgs({
 			type: "string",
 			multiple: true
 		},
+		exclude: {
+			type: "string",
+			multiple: true
+		},
 		"source-info": { type: "boolean" },
 		"word-count-method": { type: "string" },
 		config: {
@@ -6839,6 +6873,7 @@ async function main() {
 	if (values.lint) {
 		const lintResult = await lint({
 			sources,
+			exclude: values.exclude ?? config?.exclude,
 			formatId: values.format ?? config?.formatId,
 			startPassage: values.start ?? config?.startPassage,
 			formatPaths: config?.formatPaths,
@@ -6860,6 +6895,7 @@ async function main() {
 	}
 	const compileOptions = {
 		sources,
+		exclude: values.exclude ?? config?.exclude,
 		outputMode,
 		formatId: values.format ?? config?.formatId,
 		startPassage: values.start ?? config?.startPassage,
@@ -7033,6 +7069,7 @@ Options:
   --format-index <url>      SFA-compatible format index URL (repeatable)
   --format-url <url>        Direct format.js URL (repeatable)
   --tag-alias <alias=target> Map a tag to a special tag (repeatable)
+  --exclude <glob>          Leave out source files matching a glob (repeatable)
   --source-info             Emit source file/line as data- attributes on passages
   --word-count-method <m>   Word counting method: tweego (default), whitespace
   --no-remote               Disable remote format fetching