@rohal12/twee-ts 1.18.2 → 2.1.0

package/dist/plugins/rollup.d.cts

@@ -0,0 +1,52 @@
+
+import { n as SharedPluginOptions, t as PluginCompileOptions } from "../options-DuBkFyqi.cjs";
+//#region src/plugins/diagnostics.d.ts
+/** An error carrying the file and line the bundler reports (and Vite shows in its overlay). */
+interface LocatedError extends Error {
+  id?: string;
+  loc?: {
+    file: string;
+    line: number;
+    column: number;
+  };
+}
+//#endregion
+//#region src/plugins/paths.d.ts
+/** The output settings that say where a bundle is written, as Rollup and Vite pass them to generateBundle. */
+interface OutputLocation {
+  readonly dir?: string | undefined;
+  readonly file?: string | undefined;
+}
+//#endregion
+//#region src/plugins/rollup.d.ts
+export type TweeTsRollupPluginOptions = SharedPluginOptions;
+export declare function tweeTsPlugin(options: TweeTsRollupPluginOptions): {
+  name: string;
+  options(inputOptions: object): undefined;
+  buildStart(this: {
+    addWatchFile: (id: string) => void;
+    warn: (message: string) => void;
+    meta: {
+      watchMode: boolean;
+    };
+  }): void;
+  closeWatcher(): void;
+  renderStart(outputOptions: OutputLocation): void;
+  generateBundle(this: {
+    emitFile: (opts: {
+      type: 'asset';
+      fileName: string;
+      source: string;
+    }) => void;
+    error: (error: LocatedError | string) => never;
+    warn: (message: string) => void;
+  }, outputOptions: OutputLocation, bundle: Readonly<Record<string, unknown>>): Promise<void>;
+  writeBundle(outputOptions: OutputLocation, bundle: Readonly<Record<string, {
+    readonly type: 'asset';
+    readonly source: string | Uint8Array;
+  } | {
+    readonly type: 'chunk';
+  }>>): void;
+};
+//#endregion
+export type { PluginCompileOptions };

package/dist/plugins/rollup.d.ts

@@ -1,4 +1,5 @@
-import { t as CompileOptions } from "../types-D8Xfe0l8.js";
+
+import { n as SharedPluginOptions, t as PluginCompileOptions } from "../options-nc5NpnSc.js";
 //#region src/plugins/diagnostics.d.ts
 /** An error carrying the file and line the bundler reports (and Vite shows in its overlay). */
 interface LocatedError extends Error {
@@ -18,25 +19,18 @@ interface OutputLocation {
 }
 //#endregion
 //#region src/plugins/rollup.d.ts
-export interface TweeTsRollupPluginOptions {
-  /** Source directories/files to compile. */
-  sources: string[];
-  /** Story format ID. */
-  format?: string;
-  /** Output filename. Default: 'index.html'. */
-  outputFilename?: string;
-  /** Additional compile options. */
-  compileOptions?: Partial<CompileOptions>;
-}
+export type TweeTsRollupPluginOptions = SharedPluginOptions;
 export declare function tweeTsPlugin(options: TweeTsRollupPluginOptions): {
   name: string;
   options(inputOptions: object): undefined;
   buildStart(this: {
     addWatchFile: (id: string) => void;
+    warn: (message: string) => void;
     meta: {
       watchMode: boolean;
     };
   }): void;
+  closeWatcher(): void;
   renderStart(outputOptions: OutputLocation): void;
   generateBundle(this: {
     emitFile: (opts: {
@@ -44,8 +38,15 @@ export declare function tweeTsPlugin(options: TweeTsRollupPluginOptions): {
       fileName: string;
       source: string;
     }) => void;
-    error: (error: LocatedError) => never;
+    error: (error: LocatedError | string) => never;
     warn: (message: string) => void;
   }, outputOptions: OutputLocation, bundle: Readonly<Record<string, unknown>>): Promise<void>;
+  writeBundle(outputOptions: OutputLocation, bundle: Readonly<Record<string, {
+    readonly type: 'asset';
+    readonly source: string | Uint8Array;
+  } | {
+    readonly type: 'chunk';
+  }>>): void;
 };
 //#endregion
+export type { PluginCompileOptions };

package/dist/plugins/rollup.js

@@ -1,102 +1,172 @@
-import { c as splitDiagnostics, h as walkedEntry, i as outputLocations, l as compileForOutputFile, m as realPathOf, o as fatalError, p as outputPaths, s as formatDiagnostic, t as createOutputRecord } from "../paths-BuTAg2av.js";
-import { readdirSync, statSync } from "node:fs";
-import { join, resolve } from "node:path";
-//#region src/plugins/rollup.ts
-/**
-* Ready-made Rollup plugin for twee-ts.
-* Compiles .tw files and emits HTML as an asset. Compile errors fail the build
-* and emit nothing; warnings go through Rollup's warnings.
-*/
+/*! @rohal12/twee-ts (Unlicense). Bundles third-party code under its own licence: see THIRD_PARTY_NOTICES. */
+import { G as recordOwnOutput, at as outputPaths, lt as identify } from "../diagnostic-text-DMVZfBh9.js";
+import { c as createOutputRecord, g as fatalError, h as compileStory, l as emittedFilePath, o as resolvePluginOptions, p as outputLocations, r as watchPlan } from "../watch-targets-DzvPyWDo.js";
+import { dirname, join, resolve, sep } from "node:path";
+import { mkdtempSync, readlinkSync, rmSync, utimesSync, watch, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+//#region src/plugins/link-watch.ts
 /**
-* What `rollup --watch` watches for the input at `path`, whose real path is
-* `real`. `isRoot`: the input itself, which is followed wherever it leads.
-*
-* Rollup watches a folder recursively and follows the links in it. So a folder
-* is registered whole only when nothing under it is left out of the story: no
-* file or folder the build writes (`outputs`), and no link to a folder, which
-* source discovery doesn't follow and which may lead to the output. Any other
-* folder is replaced by what it contains, minus those, so writing the outputs
-* starts no build. A file added straight to such a folder is found at the next
-* build. A path the build writes to is never registered itself: Rollup fails a
-* watch build whose watched files include its `output.dir` or `output.file`.
+* Tells a bundler's build watch that a link the story's inputs are reached through was pointed elsewhere, when the
+* bundler's own watcher can't. Rollup's watcher (chokidar) follows a registered link and watches the file it leads to,
+* so replacing the link, or a hop of a chain of links, raises nothing. The link's folder is watched here instead (not
+* recursively, so what the build writes below it is not reported), and a change of any link starts a build the way an
+* edit of a registered file does: by touching a file the plugin has registered with the bundler.
 */
-function watchTargets(path, real, outputs, isRoot) {
-	if (outputs.isFile(real) || !isRoot && outputs.isDir(real)) return [];
-	let entry;
+/** How long a burst of file system events settles before the links are read again (a link is replaced in two steps). */
+const SETTLE_MS = 30;
+/** Where a link leads (as written), or nothing when it is no link or does not exist. */
+function destination(link) {
 	try {
-		entry = isRoot ? {
-			stat: statSync(path),
-			real
-		} : walkedEntry(path, real);
+		return readlinkSync(link);
 	} catch {
-		return isRoot && !outputs.isDir(real) ? [path] : [];
+		return;
 	}
-	if (entry === void 0) return [];
-	if (outputs.isFile(entry.real)) return [];
-	if (!entry.stat.isDirectory()) return [path];
-	let names;
+}
+/**
+* A watch of links that touches its signal file when one of them leads elsewhere, or appears or disappears. The watch
+* is a refinement of the build watch: without a temporary folder to write the signal file in (a missing or read-only
+* TMPDIR), there is none, and a retargeted link is read with the next build something else starts.
+*/
+function createLinkWatch() {
+	let folder;
+	let signal;
 	try {
-		names = readdirSync(path);
+		folder = mkdtempSync(join(tmpdir(), "twee-ts-links-"));
+		signal = join(folder, "changed");
+		writeFileSync(signal, "");
 	} catch {
-		return isRoot && !outputs.isDir(real) ? [path] : [];
+		if (folder !== void 0) rmSync(folder, {
+			recursive: true,
+			force: true
+		});
+		return;
 	}
-	const children = names.map((name) => {
-		const child = join(path, name);
-		return {
-			path: child,
-			targets: watchTargets(child, join(entry.real, name), outputs, false)
-		};
-	});
-	return !outputs.holds(entry.real) && children.every(({ path: child, targets }) => targets.length === 1 && targets[0] === child) ? [path] : children.flatMap(({ targets }) => targets);
+	const signalFolder = folder;
+	let touches = 0;
+	const watchers = [];
+	let timer;
+	let known = /* @__PURE__ */ new Map();
+	const touch = () => {
+		touches += 1;
+		const at = new Date(Date.now() + touches * 1e3);
+		try {
+			writeFileSync(signal, String(touches));
+			utimesSync(signal, at, at);
+		} catch {}
+	};
+	const check = () => {
+		timer = void 0;
+		if ([...known].filter(([link, was]) => destination(link) !== was).length === 0) return;
+		known = new Map([...known.keys()].map((link) => [link, destination(link)]));
+		touch();
+	};
+	/** Reads the links again once the events that come together have come. */
+	const schedule = () => {
+		clearTimeout(timer);
+		timer = setTimeout(check, SETTLE_MS);
+	};
+	const stopWatching = () => {
+		for (const watcher of watchers.splice(0)) watcher.close();
+		clearTimeout(timer);
+		timer = void 0;
+	};
+	const onExit = () => {
+		rmSync(signalFolder, {
+			recursive: true,
+			force: true
+		});
+	};
+	process.once("exit", onExit);
+	return {
+		signal,
+		watch(links) {
+			stopWatching();
+			known = new Map(links.map((link) => [link, destination(link)]));
+			for (const parent of new Set(links.map((link) => dirname(link)))) try {
+				const watcher = watch(parent, schedule);
+				watcher.on("error", schedule);
+				watchers.push(watcher);
+			} catch {}
+		},
+		close() {
+			stopWatching();
+			process.removeListener("exit", onExit);
+			onExit();
+		}
+	};
 }
+//#endregion
+//#region src/plugins/rollup.ts
+/**
+* Ready-made Rollup plugin for twee-ts.
+* Compiles .tw files and emits HTML as an asset. Compile errors fail the build
+* and emit nothing; warnings go through Rollup's warnings.
+*/
 function tweeTsPlugin(options) {
-	const outputFilename = options.outputFilename ?? "index.html";
+	const resolved = resolvePluginOptions("rollup", options);
+	const { outputFilename } = resolved;
 	const record = createOutputRecord(outputFilename);
+	let linkWatch;
+	let linkWatchUnavailable = false;
+	const followed = /* @__PURE__ */ new Map();
 	return {
 		name: "twee-ts",
 		options(inputOptions) {
-			const { output } = inputOptions;
+			const output = Reflect.get(inputOptions, "output");
 			for (const location of outputLocations(output)) record.addLocation(location);
 		},
 		buildStart() {
 			if (!this.meta.watchMode) return;
-			const outputs = outputPaths(record.outputs());
-			const extra = options.compileOptions;
-			const inputs = [
-				...options.sources,
-				...extra?.headFile ? [extra.headFile] : [],
-				...extra?.modules ?? []
-			];
-			for (const input of inputs) for (const target of watchTargets(resolve(input), realPathOf(input), outputs, true)) this.addWatchFile(target);
+			const outputs = outputPaths(record.outputs(), "snapshot");
+			const plan = watchPlan(resolved.inputs, resolved.excluded, outputs, "given");
+			const targets = plan.targets.map((target) => identify(target).absolute);
+			for (const target of targets) this.addWatchFile(target);
+			for (const [path, real] of plan.reals) {
+				const first = followed.get(path) ?? real;
+				followed.set(path, first);
+				if (first !== real) this.addWatchFile(resolve(real));
+			}
+			if (plan.links.length > 0 && !linkWatchUnavailable) {
+				linkWatch ??= createLinkWatch();
+				if (linkWatch === void 0) {
+					linkWatchUnavailable = true;
+					this.warn("[twee-ts] The link watch is unavailable because no temporary folder can be written (check TMPDIR); a link pointed at another target is read with the next build something else starts.");
+				} else {
+					linkWatch.watch(plan.links);
+					this.addWatchFile(linkWatch.signal);
+				}
+			}
+			const unwatchable = sep === "/" ? targets.filter((target) => target.includes("\\")) : [];
+			if (unwatchable.length > 0) this.warn(`[twee-ts] Rollup's watch mode cannot watch ${unwatchable.map((target) => JSON.stringify(target)).join(", ")} because the name contains a backslash; edits to it will not rebuild the story.`);
+		},
+		closeWatcher() {
+			linkWatch?.close();
+			linkWatch = void 0;
 		},
 		renderStart(outputOptions) {
 			record.addLocation(outputOptions);
 		},
 		async generateBundle(outputOptions, bundle) {
+			if (Object.hasOwn(bundle, outputFilename)) return this.error(`twee-ts: the bundle already holds a file named ${outputFilename}; set the plugin's outputFilename to another name.`);
 			record.addLocation(outputOptions);
 			record.addFiles(outputOptions, Object.keys(bundle));
-			let result;
+			let story;
 			try {
-				result = await compileForOutputFile({
-					sources: options.sources,
-					formatId: options.format,
-					...options.compileOptions
-				}, record.outputs());
+				story = await compileStory(resolved.compile(), record.outputs(), void 0, true);
 			} catch (e) {
 				return this.error(fatalError(e));
 			}
-			let warnings;
-			try {
-				warnings = splitDiagnostics(result);
-			} catch (e) {
-				return this.error(e);
-			}
-			for (const w of warnings) this.warn(formatDiagnostic(w));
+			for (const warning of story.warnings) this.warn(warning);
 			this.emitFile({
 				type: "asset",
 				fileName: outputFilename,
-				source: result.output
+				source: story.output
 			});
+		},
+		writeBundle(outputOptions, bundle) {
+			const asset = bundle[outputFilename];
+			const destination = emittedFilePath(outputOptions, outputFilename);
+			if (asset?.type === "asset" && destination !== void 0) recordOwnOutput(destination, asset.source);
 		}
 	};
 }

package/dist/plugins/rollup.js.map

@@ -1 +1 @@
-{"version":3,"file":"rollup.js","names":[],"sources":["../../src/plugins/rollup.ts"],"sourcesContent":["/**\n * Ready-made Rollup plugin for twee-ts.\n * Compiles .tw files and emits HTML as an asset. Compile errors fail the build\n * and emit nothing; warnings go through Rollup's warnings.\n */\nimport { readdirSync, statSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\nimport type { CompileOptions, CompileResult, Diagnostic } from '../types.js';\nimport { compileForOutputFile } from '../compiler.js';\nimport { outputPaths, realPathOf, walkedEntry } from '../filesystem.js';\nimport type { OutputPaths } from '../filesystem.js';\nimport { fatalError, formatDiagnostic, splitDiagnostics } from './diagnostics.js';\nimport type { LocatedError } from './diagnostics.js';\nimport { createOutputRecord, outputLocations } from './paths.js';\nimport type { OutputLocation } from './paths.js';\n\nexport interface TweeTsRollupPluginOptions {\n  /** Source directories/files to compile. */\n  sources: string[];\n  /** Story format ID. */\n  format?: string;\n  /** Output filename. Default: 'index.html'. */\n  outputFilename?: string;\n  /** Additional compile options. */\n  compileOptions?: Partial<CompileOptions>;\n}\n\n/**\n * What `rollup --watch` watches for the input at `path`, whose real path is\n * `real`. `isRoot`: the input itself, which is followed wherever it leads.\n *\n * Rollup watches a folder recursively and follows the links in it. So a folder\n * is registered whole only when nothing under it is left out of the story: no\n * file or folder the build writes (`outputs`), and no link to a folder, which\n * source discovery doesn't follow and which may lead to the output. Any other\n * folder is replaced by what it contains, minus those, so writing the outputs\n * starts no build. A file added straight to such a folder is found at the next\n * build. A path the build writes to is never registered itself: Rollup fails a\n * watch build whose watched files include its `output.dir` or `output.file`.\n */\nfunction watchTargets(path: string, real: string, outputs: OutputPaths, isRoot: boolean): string[] {\n  if (outputs.isFile(real) || (!isRoot && outputs.isDir(real))) return [];\n  let entry;\n  try {\n    entry = isRoot ? { stat: statSync(path), real } : walkedEntry(path, real);\n  } catch {\n    // An input Rollup's watcher reports, unless it is an output location. Below an\n    // input, what source discovery can't read (a link to nothing, say) is skipped.\n    return isRoot && !outputs.isDir(real) ? [path] : [];\n  }\n  if (entry === undefined) return []; // A link to a folder, not followed.\n  if (outputs.isFile(entry.real)) return [];\n  if (!entry.stat.isDirectory()) return [path];\n  let names: string[];\n  try {\n    names = readdirSync(path);\n  } catch {\n    return isRoot && !outputs.isDir(real) ? [path] : [];\n  }\n  const children = names.map((name) => {\n    const child = join(path, name);\n    return { path: child, targets: watchTargets(child, join(entry.real, name), outputs, false) };\n  });\n  const whole =\n    !outputs.holds(entry.real) &&\n    children.every(({ path: child, targets }) => targets.length === 1 && targets[0] === child);\n  return whole ? [path] : children.flatMap(({ targets }) => targets);\n}\n\nexport function tweeTsPlugin(options: TweeTsRollupPluginOptions) {\n  const outputFilename = options.outputFilename ?? 'index.html';\n  // Every path this plugin's builds write: each output's folder or file, its story,\n  // and the files of each bundle. A source folder may hold any of them, and none\n  // may be read back as a source or rebuild under watch.\n  const record = createOutputRecord(outputFilename);\n\n  return {\n    name: 'twee-ts',\n\n    // Rollup's watch mode and CLI pass the whole config here, outputs included, so\n    // they are known before the first build starts and before any is written.\n    // Typed `object`: a type with only optional properties would share none with\n    // Rollup's InputOptions, and the plugin would no longer be assignable to Plugin.\n    options(inputOptions: object): undefined {\n      const { output } = inputOptions as { readonly output?: unknown };\n      for (const location of outputLocations(output)) record.addLocation(location);\n      return undefined;\n    },\n\n    // `rollup --watch` rebuilds for the files the build registers. The story's\n    // inputs are read in generateBundle, outside the module graph, so they are\n    // registered here. Rollup's watcher watches a folder recursively, files added\n    // to it included.\n    buildStart(this: { addWatchFile: (id: string) => void; meta: { watchMode: boolean } }) {\n      if (!this.meta.watchMode) return;\n      const outputs = outputPaths(record.outputs());\n      const extra = options.compileOptions;\n      const inputs = [...options.sources, ...(extra?.headFile ? [extra.headFile] : []), ...(extra?.modules ?? [])];\n      for (const input of inputs) {\n        for (const target of watchTargets(resolve(input), realPathOf(input), outputs, true)) this.addWatchFile(target);\n      }\n    },\n\n    // Runs for every output before any of them generates its bundle, when the\n    // outputs are written together (as the CLI and watch mode write them).\n    renderStart(outputOptions: OutputLocation): void {\n      record.addLocation(outputOptions);\n    },\n\n    async generateBundle(\n      this: {\n        emitFile: (opts: { type: 'asset'; fileName: string; source: string }) => void;\n        error: (error: LocatedError) => never;\n        warn: (message: string) => void;\n      },\n      outputOptions: OutputLocation,\n      bundle: Readonly<Record<string, unknown>>,\n    ): Promise<void> {\n      // Where this output writes the story and the bundle. A source folder may hold\n      // them, or another output's, and no last build of them may be read back.\n      record.addLocation(outputOptions);\n      record.addFiles(outputOptions, Object.keys(bundle));\n      let result: CompileResult;\n      try {\n        result = await compileForOutputFile(\n          { sources: options.sources, formatId: options.format, ...options.compileOptions },\n          record.outputs(),\n        );\n      } catch (e) {\n        return this.error(fatalError(e));\n      }\n      let warnings: Diagnostic[];\n      try {\n        warnings = splitDiagnostics(result);\n      } catch (e) {\n        return this.error(e as LocatedError);\n      }\n      for (const w of warnings) this.warn(formatDiagnostic(w));\n      this.emitFile({ type: 'asset', fileName: outputFilename, source: result.output });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAwCA,SAAS,aAAa,MAAc,MAAc,SAAsB,QAA2B;CACjG,IAAI,QAAQ,OAAO,IAAI,KAAM,CAAC,UAAU,QAAQ,MAAM,IAAI,GAAI,OAAO,CAAC;CACtE,IAAI;CACJ,IAAI;EACF,QAAQ,SAAS;GAAE,MAAM,SAAS,IAAI;GAAG;EAAK,IAAI,YAAY,MAAM,IAAI;CAC1E,QAAQ;EAGN,OAAO,UAAU,CAAC,QAAQ,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;CACpD;CACA,IAAI,UAAU,KAAA,GAAW,OAAO,CAAC;CACjC,IAAI,QAAQ,OAAO,MAAM,IAAI,GAAG,OAAO,CAAC;CACxC,IAAI,CAAC,MAAM,KAAK,YAAY,GAAG,OAAO,CAAC,IAAI;CAC3C,IAAI;CACJ,IAAI;EACF,QAAQ,YAAY,IAAI;CAC1B,QAAQ;EACN,OAAO,UAAU,CAAC,QAAQ,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;CACpD;CACA,MAAM,WAAW,MAAM,KAAK,SAAS;EACnC,MAAM,QAAQ,KAAK,MAAM,IAAI;EAC7B,OAAO;GAAE,MAAM;GAAO,SAAS,aAAa,OAAO,KAAK,MAAM,MAAM,IAAI,GAAG,SAAS,KAAK;EAAE;CAC7F,CAAC;CAID,OAFE,CAAC,QAAQ,MAAM,MAAM,IAAI,KACzB,SAAS,OAAO,EAAE,MAAM,OAAO,cAAc,QAAQ,WAAW,KAAK,QAAQ,OAAO,KAAK,IAC5E,CAAC,IAAI,IAAI,SAAS,SAAS,EAAE,cAAc,OAAO;AACnE;AAEA,SAAgB,aAAa,SAAoC;CAC/D,MAAM,iBAAiB,QAAQ,kBAAkB;CAIjD,MAAM,SAAS,mBAAmB,cAAc;CAEhD,OAAO;EACL,MAAM;EAMN,QAAQ,cAAiC;GACvC,MAAM,EAAE,WAAW;GACnB,KAAK,MAAM,YAAY,gBAAgB,MAAM,GAAG,OAAO,YAAY,QAAQ;EAE7E;EAMA,aAAuF;GACrF,IAAI,CAAC,KAAK,KAAK,WAAW;GAC1B,MAAM,UAAU,YAAY,OAAO,QAAQ,CAAC;GAC5C,MAAM,QAAQ,QAAQ;GACtB,MAAM,SAAS;IAAC,GAAG,QAAQ;IAAS,GAAI,OAAO,WAAW,CAAC,MAAM,QAAQ,IAAI,CAAC;IAAI,GAAI,OAAO,WAAW,CAAC;GAAE;GAC3G,KAAK,MAAM,SAAS,QAClB,KAAK,MAAM,UAAU,aAAa,QAAQ,KAAK,GAAG,WAAW,KAAK,GAAG,SAAS,IAAI,GAAG,KAAK,aAAa,MAAM;EAEjH;EAIA,YAAY,eAAqC;GAC/C,OAAO,YAAY,aAAa;EAClC;EAEA,MAAM,eAMJ,eACA,QACe;GAGf,OAAO,YAAY,aAAa;GAChC,OAAO,SAAS,eAAe,OAAO,KAAK,MAAM,CAAC;GAClD,IAAI;GACJ,IAAI;IACF,SAAS,MAAM,qBACb;KAAE,SAAS,QAAQ;KAAS,UAAU,QAAQ;KAAQ,GAAG,QAAQ;IAAe,GAChF,OAAO,QAAQ,CACjB;GACF,SAAS,GAAG;IACV,OAAO,KAAK,MAAM,WAAW,CAAC,CAAC;GACjC;GACA,IAAI;GACJ,IAAI;IACF,WAAW,iBAAiB,MAAM;GACpC,SAAS,GAAG;IACV,OAAO,KAAK,MAAM,CAAiB;GACrC;GACA,KAAK,MAAM,KAAK,UAAU,KAAK,KAAK,iBAAiB,CAAC,CAAC;GACvD,KAAK,SAAS;IAAE,MAAM;IAAS,UAAU;IAAgB,QAAQ,OAAO;GAAO,CAAC;EAClF;CACF;AACF"}
+{"version":3,"file":"rollup.js","names":[],"sources":["../../src/plugins/link-watch.ts","../../src/plugins/rollup.ts"],"sourcesContent":["/**\n * Tells a bundler's build watch that a link the story's inputs are reached through was pointed elsewhere, when the\n * bundler's own watcher can't. Rollup's watcher (chokidar) follows a registered link and watches the file it leads to,\n * so replacing the link, or a hop of a chain of links, raises nothing. The link's folder is watched here instead (not\n * recursively, so what the build writes below it is not reported), and a change of any link starts a build the way an\n * edit of a registered file does: by touching a file the plugin has registered with the bundler.\n */\nimport { mkdtempSync, readlinkSync, rmSync, utimesSync, watch, writeFileSync } from 'node:fs';\nimport type { FSWatcher } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { dirname, join } from 'node:path';\n\n/** How long a burst of file system events settles before the links are read again (a link is replaced in two steps). */\nconst SETTLE_MS = 30;\n\nexport interface LinkWatch {\n  /** The file to register with the bundler's watcher: written when a link changed, with the number of changes so far. */\n  readonly signal: string;\n  /** Watches `links` (platform paths) from now on, instead of the links watched before. */\n  watch(links: readonly string[]): void;\n  /** Stops watching and removes the signal file. */\n  close(): void;\n}\n\n/** Where a link leads (as written), or nothing when it is no link or does not exist. */\nfunction destination(link: string): string | undefined {\n  try {\n    return readlinkSync(link);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * A watch of links that touches its signal file when one of them leads elsewhere, or appears or disappears. The watch\n * is a refinement of the build watch: without a temporary folder to write the signal file in (a missing or read-only\n * TMPDIR), there is none, and a retargeted link is read with the next build something else starts.\n */\nexport function createLinkWatch(): LinkWatch | undefined {\n  let folder: string | undefined;\n  let signal: string;\n  try {\n    folder = mkdtempSync(join(tmpdir(), 'twee-ts-links-'));\n    signal = join(folder, 'changed');\n    writeFileSync(signal, '');\n  } catch {\n    if (folder !== undefined) rmSync(folder, { recursive: true, force: true });\n    return undefined;\n  }\n  const signalFolder = folder;\n  let touches = 0;\n  const watchers: FSWatcher[] = [];\n  let timer: NodeJS.Timeout | undefined;\n  let known = new Map<string, string | undefined>();\n\n  const touch = (): void => {\n    touches += 1;\n    // A modification time that differs from every earlier one, whatever the clock's resolution.\n    const at = new Date(Date.now() + touches * 1000);\n    try {\n      writeFileSync(signal, String(touches));\n      utimesSync(signal, at, at);\n    } catch {\n      // The watch is closed.\n    }\n  };\n  const check = (): void => {\n    timer = undefined;\n    const changed = [...known].filter(([link, was]) => destination(link) !== was);\n    if (changed.length === 0) return;\n    known = new Map([...known.keys()].map((link) => [link, destination(link)]));\n    touch();\n  };\n  /** Reads the links again once the events that come together have come. */\n  const schedule = (): void => {\n    clearTimeout(timer);\n    timer = setTimeout(check, SETTLE_MS);\n  };\n  const stopWatching = (): void => {\n    for (const watcher of watchers.splice(0)) watcher.close();\n    clearTimeout(timer);\n    timer = undefined;\n  };\n  const onExit = (): void => {\n    rmSync(signalFolder, { recursive: true, force: true });\n  };\n  process.once('exit', onExit);\n\n  return {\n    signal,\n    watch(links) {\n      stopWatching();\n      known = new Map(links.map((link) => [link, destination(link)]));\n      for (const parent of new Set(links.map((link) => dirname(link)))) {\n        try {\n          const watcher = watch(parent, schedule);\n          // A folder that goes away, or a limit of the system: the links in it are read again.\n          watcher.on('error', schedule);\n          watchers.push(watcher);\n        } catch {\n          // The folder can't be watched; the links in it are read again with the next build.\n        }\n      }\n    },\n    close() {\n      stopWatching();\n      process.removeListener('exit', onExit);\n      onExit();\n    },\n  };\n}\n","/**\n * Ready-made Rollup plugin for twee-ts.\n * Compiles .tw files and emits HTML as an asset. Compile errors fail the build\n * and emit nothing; warnings go through Rollup's warnings.\n */\nimport { resolve, sep } from 'node:path';\nimport { outputPaths } from '../filesystem.js';\nimport { recordOwnOutput } from '../atomic-write.js';\nimport { compileStory, fatalError } from './diagnostics.js';\nimport type { CompiledStory, LocatedError } from './diagnostics.js';\nimport { resolvePluginOptions } from './options.js';\nimport type { SharedPluginOptions } from './options.js';\nimport { createOutputRecord, emittedFilePath, outputLocations } from './paths.js';\nimport type { OutputLocation } from './paths.js';\nimport { createLinkWatch } from './link-watch.js';\nimport type { LinkWatch } from './link-watch.js';\nimport { watchPlan } from './watch-targets.js';\nimport { identify } from '../path-identity.js';\n\nexport type { PluginCompileOptions } from './options.js';\n\nexport type TweeTsRollupPluginOptions = SharedPluginOptions;\n\nexport function tweeTsPlugin(options: TweeTsRollupPluginOptions) {\n  const resolved = resolvePluginOptions('rollup', options);\n  const { outputFilename } = resolved;\n  // Every path this plugin's builds write: each output's folder or file, its story,\n  // and the files of each bundle. A source folder may hold any of them, and none\n  // may be read back as a source or rebuild under watch.\n  const record = createOutputRecord(outputFilename);\n  // Tells the watch that a link the inputs are reached through was pointed elsewhere (see link-watch.ts).\n  let linkWatch: LinkWatch | undefined;\n  // The link watch could not be set up (no temporary folder); said once, and not tried again.\n  let linkWatchUnavailable = false;\n  // Where each registered path led when Rollup's watcher first followed it.\n  const followed = new Map<string, string>();\n\n  return {\n    name: 'twee-ts',\n\n    // Rollup's watch mode and CLI pass the whole config here, outputs included, so\n    // they are known before the first build starts and before any is written.\n    // Typed `object`: a type with only optional properties would share none with\n    // Rollup's InputOptions, and the plugin would no longer be assignable to Plugin.\n    options(inputOptions: object): undefined {\n      const output: unknown = Reflect.get(inputOptions, 'output');\n      for (const location of outputLocations(output)) record.addLocation(location);\n      return undefined;\n    },\n\n    // `rollup --watch` rebuilds for the files the build registers. The story's\n    // inputs are read in generateBundle, outside the module graph, so they are\n    // registered here: the sources, the head file and the modules, without the\n    // files `exclude` leaves out (see watchTargets). Rollup's watcher follows a link and watches what it leads to, so\n    // it doesn't see a link, or a hop of a chain of links, pointed elsewhere; the plugin watches the links itself.\n    buildStart(this: {\n      addWatchFile: (id: string) => void;\n      warn: (message: string) => void;\n      meta: { watchMode: boolean };\n    }) {\n      if (!this.meta.watchMode) return;\n      const outputs = outputPaths(record.outputs(), 'snapshot');\n      // In the platform's own form, as Rollup reports its module ids.\n      const plan = watchPlan(resolved.inputs, resolved.excluded, outputs, 'given');\n      const targets = plan.targets.map((target) => identify(target).absolute);\n      for (const target of targets) this.addWatchFile(target);\n      // Rollup's watcher keeps watching what a path led to when it was registered, so a path that leads elsewhere now\n      // (a link was pointed at another file or folder) is watched from its new location as well.\n      for (const [path, real] of plan.reals) {\n        const first = followed.get(path) ?? real;\n        followed.set(path, first);\n        if (first !== real) this.addWatchFile(resolve(real));\n      }\n      if (plan.links.length > 0 && !linkWatchUnavailable) {\n        linkWatch ??= createLinkWatch();\n        if (linkWatch === undefined) {\n          // The links are a refinement: the build goes on, and says once what the watch cannot do.\n          linkWatchUnavailable = true;\n          this.warn(\n            '[twee-ts] The link watch is unavailable because no temporary folder can be written (check TMPDIR); ' +\n              'a link pointed at another target is read with the next build something else starts.',\n          );\n        } else {\n          linkWatch.watch(plan.links);\n          this.addWatchFile(linkWatch.signal);\n        }\n      }\n      // Rollup's file watcher (chokidar) reads every backslash as a separator, also on POSIX, where it is a\n      // filename character: such a file is read by each build, but an edit to it starts none.\n      const unwatchable = sep === '/' ? targets.filter((target) => target.includes('\\\\')) : [];\n      if (unwatchable.length > 0) {\n        this.warn(\n          `[twee-ts] Rollup's watch mode cannot watch ${unwatchable.map((target) => JSON.stringify(target)).join(', ')} ` +\n            'because the name contains a backslash; edits to it will not rebuild the story.',\n        );\n      }\n    },\n\n    // The watcher is closed: the links are no longer watched.\n    closeWatcher(): void {\n      linkWatch?.close();\n      linkWatch = undefined;\n    },\n\n    // Runs for every output before any of them generates its bundle, when the\n    // outputs are written together (as the CLI and watch mode write them).\n    renderStart(outputOptions: OutputLocation): void {\n      record.addLocation(outputOptions);\n    },\n\n    async generateBundle(\n      this: {\n        emitFile: (opts: { type: 'asset'; fileName: string; source: string }) => void;\n        error: (error: LocatedError | string) => never;\n        warn: (message: string) => void;\n      },\n      outputOptions: OutputLocation,\n      bundle: Readonly<Record<string, unknown>>,\n    ): Promise<void> {\n      if (Object.hasOwn(bundle, outputFilename)) {\n        return this.error(\n          `twee-ts: the bundle already holds a file named ${outputFilename}; set the plugin's outputFilename to another name.`,\n        );\n      }\n      // Where this output writes the story and the bundle. A source folder may hold\n      // them, or another output's, and no last build of them may be read back.\n      record.addLocation(outputOptions);\n      record.addFiles(outputOptions, Object.keys(bundle));\n      let story: CompiledStory;\n      try {\n        story = await compileStory(resolved.compile(), record.outputs(), undefined, true);\n      } catch (e) {\n        return this.error(fatalError(e));\n      }\n      for (const warning of story.warnings) this.warn(warning);\n      this.emitFile({ type: 'asset', fileName: outputFilename, source: story.output });\n    },\n\n    writeBundle(\n      outputOptions: OutputLocation,\n      bundle: Readonly<\n        Record<string, { readonly type: 'asset'; readonly source: string | Uint8Array } | { readonly type: 'chunk' }>\n      >,\n    ): void {\n      const asset = bundle[outputFilename];\n      const destination = emittedFilePath(outputOptions, outputFilename);\n      // Rollup writes the asset itself. Only a completed write establishes ownership, including for output\n      // modes without creator markers; generate() must leave the ownership of existing disk bytes unchanged.\n      if (asset?.type === 'asset' && destination !== undefined) recordOwnOutput(destination, asset.source);\n    },\n  };\n}\n"],"mappings":"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"}