@rohal12/twee-ts 1.17.0 → 1.17.1

package/dist/index.cjs

@@ -36,11 +36,27 @@ let node_url = require("node:url");
 function generateIFID() {
 	return (0, node_crypto.randomUUID)().toUpperCase();
 }
-/** Validate and brand an IFID string. Throws on invalid input. */
+/**
+* Validate and brand an IFID string. Throws on invalid input.
+* Returns the IFID in its stored form (see `normalizeIFID`).
+*/
 function createIFID(value) {
 	const err = validateIFID(value);
 	if (err) throw new Error(`Invalid IFID: ${err}`);
-	return value.toUpperCase();
+	return normalizeIFID(value);
+}
+/** Length of the `UUID://...//` wrapper around a 36-character UUID. */
+const WRAPPED_LENGTH = 45;
+/**
+* Bring an IFID into the form the story model stores and every output writes: the uppercase
+* bare UUID. A valid `UUID://...//` wrapped IFID loses its wrapper; outputs that need the wrapper
+* (the Treaty of Babel comment) add exactly one. Twine 2 IFIDs use only capital letters, so the
+* value is uppercased, as Tweego does. An invalid value is only uppercased, so that validation
+* reports it as written.
+*/
+function normalizeIFID(value) {
+	const upper = value.toUpperCase();
+	return upper.length === WRAPPED_LENGTH && validateIFID(upper) === null ? upper.slice(7, 43) : upper;
 }
 /**
 * Validate an IFID string.
@@ -470,7 +486,7 @@ function unmarshalStoryData(story, json) {
 	}
 	if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return "Cannot unmarshal \"StoryData\"; expected a JSON object";
 	const data = raw;
-	if (typeof data.ifid === "string" && data.ifid) story.ifid = data.ifid.toUpperCase();
+	if (typeof data.ifid === "string" && data.ifid) story.ifid = normalizeIFID(data.ifid);
 	if (typeof data.format === "string" && data.format) story.twine2.format = data.format;
 	if (typeof data["format-version"] === "string" && data["format-version"]) story.twine2.formatVersion = data["format-version"];
 	if (Array.isArray(data.options)) {
@@ -501,7 +517,7 @@ function unmarshalStorySettings(story, text, diagnostics) {
 		const val = line.slice(colonIdx + 1).trim().toLowerCase();
 		switch (key) {
 			case "ifid":
-				if (validateIFID(val) === null) story.legacyIFID = val.toUpperCase();
+				if (validateIFID(val) === null) story.legacyIFID = normalizeIFID(val);
 				obsolete.push("\"ifid\"");
 				continue;
 			case "zoom":
@@ -4763,7 +4779,7 @@ function decompileTwine2(storyData, story, passageText, diagnostics) {
 		});
 		else startnode = parsed;
 	}
-	if (attrs["ifid"]) story.ifid = attrs["ifid"].toUpperCase();
+	if (attrs["ifid"]) story.ifid = normalizeIFID(attrs["ifid"]);
 	if (attrs["zoom"]) {
 		const parsed = parseFloat(attrs["zoom"]);
 		if (Number.isNaN(parsed)) diagnostics.push({
@@ -4776,7 +4792,9 @@ function decompileTwine2(storyData, story, passageText, diagnostics) {
 	if (attrs["format"]) story.twine2.format = attrs["format"];
 	if (attrs["format-version"]) story.twine2.formatVersion = attrs["format-version"];
 	if (attrs["options"]) for (const opt of attrs["options"].split(/\s+/).filter((s) => s.length > 0)) story.twine2.options.set(opt, true);
-	for (const node of storyData.children ?? []) {
+	const children = storyData.children ?? [];
+	const takenNames = new Set(children.filter((node) => node.type === "tag" && node.name === "tw-passagedata").map(passageDataName));
+	for (const node of children) {
 		if (node.type !== "tag" && node.type !== "style" && node.type !== "script") continue;
 		switch (node.name) {
 			case "style":
@@ -4784,8 +4802,10 @@ function decompileTwine2(storyData, story, passageText, diagnostics) {
 				const content = getTextContent(node);
 				if (content.trim().length === 0) continue;
 				const text = passageText(content);
+				const name = freeName(node.name === "style" ? "Story Stylesheet" : "Story JavaScript", takenNames);
+				takenNames.add(name);
 				storyAdd(story, {
-					name: node.name === "style" ? "Story Stylesheet" : "Story JavaScript",
+					name,
 					tags: node.name === "style" ? ["stylesheet"] : ["script"],
 					text
 				}, diagnostics);
@@ -4801,7 +4821,7 @@ function decompileTwine2(storyData, story, passageText, diagnostics) {
 			case "tw-passagedata": {
 				let pid = 0;
 				const pAttrs = node.attribs ?? {};
-				const name = pAttrs["name"] ?? "";
+				const name = passageDataName(node);
 				const tags = pAttrs["tags"] ? pAttrs["tags"].split(/\s+/).filter((s) => s.length > 0) : [];
 				const metadata = {};
 				if (pAttrs["pid"]) {
@@ -4832,6 +4852,17 @@ function decompileTwine2(storyData, story, passageText, diagnostics) {
 		text: marshalStoryData(story)
 	}, diagnostics);
 }
+function passageDataName(node) {
+	return node.attribs?.["name"] ?? "";
+}
+/** The first of `base`, `base 2`, `base 3`, … that is not in `taken`. */
+function freeName(base, taken) {
+	if (!taken.has(base)) return base;
+	for (let n = 2;; n++) {
+		const candidate = `${base} ${n}`;
+		if (!taken.has(candidate)) return candidate;
+	}
+}
 function decompileTwine1(storeArea, story, passageText, diagnostics) {
 	const passages = (storeArea.children ?? []).filter(isTiddler).map((node) => tiddlerToPassage(node, passageText));
 	const obfuscated = isRot13Obfuscated(passages);
@@ -5224,6 +5255,121 @@ function loadSourcesCached(story, filenames, opts, diagnostics, processedFiles,
 	}, diagnostics);
 }
 //#endregion
+//#region src/template.ts
+/**
+* An HTML closing head tag: `</head` in any letter case, followed by whitespace, `/` or `>`, up to the next `>`.
+* This is how the HTML tokenizer reads an end tag; it ignores whatever sits between the tag name and the `>`.
+*/
+const CLOSING_HEAD_TAG = "<\\/[Hh][Ee][Aa][Dd](?=[\\t\\n\\f\\r />])[^>]*>";
+/** The regular expression source matching exactly `text`. */
+function literal(text) {
+	return text.replace(/[.*+?^${}()|[\]\\/]/g, "\\$&");
+}
+/** Replace the `slots` placeholders found in `template`, without scanning inserted text. */
+function fillTemplate(template, slots) {
+	return fillTemplateParts([{
+		kind: "scan",
+		text: template,
+		slots
+	}]);
+}
+/**
+* Fill the parts of a template in order, joined. A `'first'` slot replaced in one part is not replaced again in a
+* later part that lists the same slot object.
+*/
+function fillTemplateParts(parts) {
+	const filled = /* @__PURE__ */ new Set();
+	return parts.map((part) => {
+		if (part.kind === "verbatim" || part.slots.length === 0) return part.text;
+		const { slots } = part;
+		const pattern = new RegExp(slots.map((slot) => `(${slot.pattern})`).join("|"), "g");
+		return part.text.replace(pattern, (match, ...groups) => {
+			const slot = slots.find((_, i) => groups[i] !== void 0);
+			if (slot === void 0 || slot.occurrences === "first" && filled.has(slot)) return match;
+			filled.add(slot);
+			return slot.replacement(match);
+		});
+	}).join("");
+}
+//#endregion
+//#region src/modules.ts
+/**
+* Load modules and return HTML tags to inject before the closing head tag.
+*/
+function loadModules(filenames) {
+	const processed = /* @__PURE__ */ new Set();
+	const headTags = [];
+	for (const filename of filenames) {
+		if (processed.has(filename)) continue;
+		const ext = normalizedFileExt(filename);
+		let tag = null;
+		switch (ext) {
+			case "css":
+				tag = loadModuleTagged("style", filename);
+				break;
+			case "js":
+				tag = loadModuleTagged("script", filename);
+				break;
+			case "otf":
+			case "ttf":
+			case "woff":
+			case "woff2":
+				tag = loadModuleFont(filename);
+				break;
+			default: continue;
+		}
+		if (tag) headTags.push(tag);
+		processed.add(filename);
+	}
+	return headTags.join("\n");
+}
+function loadModuleTagged(tag, filename) {
+	const source = readUTF8(filename).trim();
+	if (source.length === 0) return null;
+	return `<${tag} id="${`${tag}-module-${slugify(baseNameWithoutExt(filename))}`}" type="${tag === "script" ? "text/javascript" : "text/css"}">${tag === "script" ? scriptContentEscape(source) : styleContentEscape(source)}</${tag}>`;
+}
+function loadModuleFont(filename) {
+	const source = readBase64(filename);
+	const family = baseNameWithoutExt(filename);
+	const idSlug = `style-module-${slugify(family)}`;
+	const ext = normalizedFileExt(filename);
+	return `<style id="${idSlug}" type="text/css">@font-face {\n\tfont-family: "${family}";\n\tsrc: url("data:${mediaTypeFromExt(ext)};base64,${source}") format("${fontFormatHint(ext)}");\n}</style>`;
+}
+/**
+* Load the module tags and head file content to inject before the closing head tag, joined by newlines,
+* or `''` when there is nothing to inject.
+*/
+function loadHeadContent(modulePaths, headFile, diagnostics) {
+	const parts = [];
+	if (modulePaths.length > 0) {
+		const modules = loadModules(modulePaths).trim();
+		if (modules.length > 0) parts.push(modules);
+	}
+	if (headFile) try {
+		const source = readUTF8(headFile).trim();
+		if (source.length > 0) parts.push(source);
+	} catch (e) {
+		diagnostics?.push({
+			level: "warning",
+			message: `Failed to read head file "${headFile}": ${e instanceof Error ? e.message : String(e)}`
+		});
+	}
+	return parts.join("\n");
+}
+/**
+* The template slot that inserts `content` on its own line before the first closing head tag (as Tweego does),
+* or `undefined` when `content` is empty. The tag may use any letter case and whitespace before its `>`, and is
+* kept as written.
+*/
+function headSlot(content) {
+	if (content.length === 0) return void 0;
+	return {
+		pattern: CLOSING_HEAD_TAG,
+		occurrences: "first",
+		replacement: (tag) => `${content}\n${tag}`
+	};
+}
+//#endregion
 //#region src/version.ts
 /**
 * The twee-ts version, read at runtime from the package's own package.json.
@@ -5257,24 +5403,38 @@ const CREATOR_NAME$2 = "Twee-ts";
 function toTwine2Archive(story, startName, options) {
 	return getTwine2DataChunk(story, startName, options) + "\n";
 }
+/**
+* Fill the Twine 2 format template: every `{{STORY_NAME}}` gets the escaped story name and the first
+* `{{STORY_DATA}}` the story data (as Tweego does), and `head` goes before the first closing head tag. All three are
+* found in the template in one pass, so a story name, passage text or head content holding a placeholder or a
+* closing head tag stays literal.
+*/
 function toTwine2HTML(story, format, startName, options) {
-	let template = readFormatSource(format);
-	if (template.includes("{{STORY_NAME}}")) {
-		const name = htmlEscape(story.name);
-		template = template.replaceAll("{{STORY_NAME}}", () => name);
-	}
-	if (template.includes("{{STORY_DATA}}")) {
-		const data = getTwine2DataChunk({
-			...story,
-			twine2: {
-				...story.twine2,
-				format: format.name,
-				formatVersion: format.version
+	const name = htmlEscape(story.name);
+	const head = headSlot(options?.head ?? "");
+	const slots = [
+		{
+			pattern: literal("{{STORY_NAME}}"),
+			occurrences: "all",
+			replacement: () => name
+		},
+		{
+			pattern: literal("{{STORY_DATA}}"),
+			occurrences: "first",
+			replacement: () => {
+				return getTwine2DataChunk({
+					...story,
+					twine2: {
+						...story.twine2,
+						format: format.name,
+						formatVersion: format.version
+					}
+				}, startName, options);
 			}
-		}, startName, options);
-		template = template.replace("{{STORY_DATA}}", () => data);
-	}
-	return template;
+		},
+		...head === void 0 ? [] : [head]
+	];
+	return fillTemplate(readFormatSource(format), slots);
 }
 const OMITTING_TAGS = [
 	"Twine.private",
@@ -5367,7 +5527,13 @@ function toTwine1Archive(story, _startName) {
 	const { data, count } = getTwine1PassageChunk(story);
 	return `<div id="storeArea" data-size="${count}">${data}</div>\n`;
 }
-function toTwine1HTML(story, format, startName) {
+/**
+* Fill the Twine 1 format template. The format's components are inserted first, one after another, as Tweego and
+* Twine 1 do. Then the first of each story placeholder (`"VERSION"`, `"TIME"`, `"START_AT"`, `"STORY_SIZE"`,
+* `"STORY"`), the IFID comment and `head` (before the first closing head tag) are found in one pass, so a start
+* passage name or story data holding a placeholder or a closing head tag stays literal.
+*/
+function toTwine1HTML(story, format, startName, options) {
 	const formatDir = (0, node_path.dirname)(format.filename);
 	const parentDir = (0, node_path.dirname)(formatDir);
 	let template = readFormatSource(format);
@@ -5378,28 +5544,60 @@ function toTwine1HTML(story, format, startName) {
 	template = tryReplaceComponent(template, "\"JONAH\"", (0, node_path.join)(formatDir, "code.js"), true);
 	if (story.twine1.settings.get("jquery") === "on") template = tryReplaceComponent(template, "\"JQUERY\"", (0, node_path.join)(parentDir, "jquery.js"), true);
 	if (story.twine1.settings.get("modernizr") === "on") template = tryReplaceComponent(template, "\"MODERNIZR\"", (0, node_path.join)(parentDir, "modernizr.js"), true);
+	const isPre14 = !template.includes("\"STORY\"");
+	const footer = isPre14 ? readFooter(formatDir) : "";
+	const storeArea = (template + footer).includes("<div id=\"store-area\"") ? "<div id=\"store-area\"" : "<div id=\"storeArea\"";
+	const safeIfid = htmlCommentSanitize(story.ifid);
+	const late = [story.ifid ? {
+		pattern: literal(storeArea),
+		occurrences: "first",
+		replacement: (div) => `<!-- UUID://${safeIfid}// -->${div}`
+	} : void 0, headSlot(options?.head ?? "")].filter((slot) => slot !== void 0);
 	const displayStart = startName === "Start" ? "" : startName;
-	template = template.replace("\"VERSION\"", `Compiled with ${CREATOR_NAME$1}, ${VERSION}`);
-	template = template.replace("\"TIME\"", `Built on ${(/* @__PURE__ */ new Date()).toUTCString()}`);
-	const startAtValue = `"${jsStringEscape(displayStart)}"`;
-	template = template.replace("\"START_AT\"", () => startAtValue);
-	template = template.replace("\"STORY_SIZE\"", `"${count}"`);
-	if (template.includes("\"STORY\"")) template = template.replace("\"STORY\"", () => data);
-	else {
-		let footer;
-		try {
-			footer = (0, node_fs.readFileSync)((0, node_path.join)(formatDir, "footer.html"), "utf-8");
-		} catch {
-			footer = "</div>\n</body>\n</html>\n";
-		}
-		template += data + footer;
-	}
-	if (story.ifid) {
-		const safeIfid = htmlCommentSanitize(story.ifid);
-		if (template.includes("<div id=\"store-area\"")) template = template.replace("<div id=\"store-area\"", `<!-- UUID://${safeIfid}// --><div id="store-area"`);
-		else template = template.replace("<div id=\"storeArea\"", `<!-- UUID://${safeIfid}// --><div id="storeArea"`);
+	const slots = [
+		firstSlot("\"VERSION\"", `Compiled with ${CREATOR_NAME$1}, ${VERSION}`),
+		firstSlot("\"TIME\"", `Built on ${(/* @__PURE__ */ new Date()).toUTCString()}`),
+		firstSlot("\"START_AT\"", `"${jsStringEscape(displayStart)}"`),
+		firstSlot("\"STORY_SIZE\"", `"${count}"`),
+		firstSlot("\"STORY\"", data),
+		...late
+	];
+	return fillTemplateParts(isPre14 ? [
+		{
+			kind: "scan",
+			text: template,
+			slots
+		},
+		{
+			kind: "verbatim",
+			text: data
+		},
+		{
+			kind: "scan",
+			text: footer,
+			slots: late
+		}
+	] : [{
+		kind: "scan",
+		text: template,
+		slots
+	}]);
+}
+/** A slot replacing the first `token` with `value`. */
+function firstSlot(token, value) {
+	return {
+		pattern: literal(token),
+		occurrences: "first",
+		replacement: () => value
+	};
+}
+/** The footer of a pre-1.4 format, or the default one when the format has none. */
+function readFooter(formatDir) {
+	try {
+		return (0, node_fs.readFileSync)((0, node_path.join)(formatDir, "footer.html"), "utf-8");
+	} catch {
+		return "</div>\n</body>\n</html>\n";
 	}
-	return template;
 }
 /**
 * Why Twine 1 output leaves a passage out of its tiddlers, or `undefined` when the passage is emitted.
@@ -5472,75 +5670,6 @@ function isStoryDataJSON(text) {
 	return unmarshalStoryData(createStory(), text) === null;
 }
 //#endregion
-//#region src/modules.ts
-/**
-* Load modules and return HTML tags to inject before </head>.
-*/
-function loadModules(filenames) {
-	const processed = /* @__PURE__ */ new Set();
-	const headTags = [];
-	for (const filename of filenames) {
-		if (processed.has(filename)) continue;
-		const ext = normalizedFileExt(filename);
-		let tag = null;
-		switch (ext) {
-			case "css":
-				tag = loadModuleTagged("style", filename);
-				break;
-			case "js":
-				tag = loadModuleTagged("script", filename);
-				break;
-			case "otf":
-			case "ttf":
-			case "woff":
-			case "woff2":
-				tag = loadModuleFont(filename);
-				break;
-			default: continue;
-		}
-		if (tag) headTags.push(tag);
-		processed.add(filename);
-	}
-	return headTags.join("\n");
-}
-function loadModuleTagged(tag, filename) {
-	const source = readUTF8(filename).trim();
-	if (source.length === 0) return null;
-	return `<${tag} id="${`${tag}-module-${slugify(baseNameWithoutExt(filename))}`}" type="${tag === "script" ? "text/javascript" : "text/css"}">${tag === "script" ? scriptContentEscape(source) : styleContentEscape(source)}</${tag}>`;
-}
-function loadModuleFont(filename) {
-	const source = readBase64(filename);
-	const family = baseNameWithoutExt(filename);
-	const idSlug = `style-module-${slugify(family)}`;
-	const ext = normalizedFileExt(filename);
-	return `<style id="${idSlug}" type="text/css">@font-face {\n\tfont-family: "${family}";\n\tsrc: url("data:${mediaTypeFromExt(ext)};base64,${source}") format("${fontFormatHint(ext)}");\n}</style>`;
-}
-/**
-* Inject modules and head file content before </head>.
-*/
-function modifyHead(html, modulePaths, headFile, diagnostics) {
-	const parts = [];
-	if (modulePaths.length > 0) {
-		const modules = loadModules(modulePaths).trim();
-		if (modules.length > 0) parts.push(modules);
-	}
-	if (headFile) try {
-		const source = readUTF8(headFile).trim();
-		if (source.length > 0) parts.push(source);
-	} catch (e) {
-		diagnostics?.push({
-			level: "warning",
-			message: `Failed to read head file "${headFile}": ${e instanceof Error ? e.message : String(e)}`
-		});
-	}
-	if (parts.length > 0) {
-		parts.push("</head>");
-		const replacement = parts.join("\n");
-		return html.replace("</head>", () => replacement);
-	}
-	return html;
-}
-//#endregion
 //#region src/passage-omission.ts
 /**
 * Why the `target` output leaves `passage` out of its passage elements, or `undefined` when it
@@ -5617,12 +5746,13 @@ async function compileToFile(options) {
 * Builds as compileToFile() does for `outFile`, without writing it: the output may sit
 * inside a source folder, so its last build is left out of the sources and modules and
 * never read back. The caller decides whether the result is written. With no `outFile`
-* (output to stdout, or none), this is compile().
+* (output to stdout, or none), this is compile(). With `cache`, files are cached as
+* compileIncremental() caches them.
 *
-* Internal, for the CLI; not part of the public API.
+* Internal, for the CLI and the bundler plugins; not part of the public API.
 */
-async function compileForOutputFile(options, outFile) {
-	return buildOutput(options, void 0, void 0, outFile);
+async function compileForOutputFile(options, outFile, cache) {
+	return buildOutput(options, cache, void 0, outFile);
 }
 /**
 * Compile with incremental caching support.
@@ -5638,7 +5768,9 @@ async function compileIncremental(options, cache, changedFiles) {
 }
 /**
 * Watch for file changes and recompile. Every build is written to `outFile`, including
-* one whose diagnostics report errors.
+* one whose diagnostics report errors. Builds run one at a time: changes made during a
+* build go into one follow-up build after it, and the superseded build is neither
+* written nor reported.
 */
 async function watch(options) {
 	return watchWithWriteFilter(options, () => true);
@@ -5668,17 +5800,62 @@ async function watchWithWriteFilter(options, shouldWrite) {
 		const abs = (0, node_path.resolve)(filename);
 		return !notExcludable.some((root) => abs === root || abs.startsWith(root + node_path.sep));
 	};
+	let building = false;
+	let queued;
+	const deliver = (outcome) => {
+		try {
+			if (!outcome.ok) throw outcome.error;
+			if (shouldWrite(outcome.result)) (0, node_fs.writeFileSync)(options.outFile, outcome.result.output, "utf-8");
+			options.onBuild?.(outcome.result);
+		} catch (e) {
+			options.onError?.(toError(e));
+		}
+	};
+	const drain = async (first) => {
+		building = true;
+		try {
+			let request = first;
+			while (request !== void 0) {
+				const current = request;
+				const outcome = await buildOutput(options, cache, current.changedFiles, options.outFile).then((result) => ({
+					ok: true,
+					result
+				}), (e) => ({
+					ok: false,
+					error: toError(e)
+				}));
+				if (controller.signal.aborted) return;
+				request = queued === void 0 ? void 0 : mergeBuildRequests(current, queued);
+				queued = void 0;
+				if (request === void 0) deliver(outcome);
+			}
+		} finally {
+			building = false;
+		}
+	};
 	const handle = watchFilesystem(allPaths, options.outFile, (changedFiles) => {
-		buildOutput(options, cache, changedFiles, options.outFile).then((result) => {
-			if (shouldWrite(result)) (0, node_fs.writeFileSync)(options.outFile, result.output, "utf-8");
-			options.onBuild?.(result);
-		}).catch((e) => {
-			options.onError?.(e instanceof Error ? e : new Error(String(e)));
-		});
+		if (controller.signal.aborted) return;
+		const request = { changedFiles };
+		if (building) {
+			queued = queued === void 0 ? request : mergeBuildRequests(queued, request);
+			return;
+		}
+		drain(request);
 	}, ignore);
-	controller.signal.addEventListener("abort", () => handle.close());
+	controller.signal.addEventListener("abort", () => {
+		queued = void 0;
+		handle.close();
+	});
 	return controller;
 }
+/** One build covering both requests: a full build if either is one, else every changed file. */
+function mergeBuildRequests(a, b) {
+	if (a.changedFiles === void 0 || b.changedFiles === void 0) return { changedFiles: void 0 };
+	return { changedFiles: /* @__PURE__ */ new Set([...a.changedFiles, ...b.changedFiles]) };
+}
+function toError(e) {
+	return e instanceof Error ? e : new Error(String(e));
+}
 /**
 * `outFile`: the file the build is written to, which source and module discovery
 * skip (as Tweego does), so an output inside a source folder is never loaded back.
@@ -5740,17 +5917,17 @@ async function buildOutput(options, cache, changedFiles, outFile) {
 		case "html": {
 			diagnostics.push(...startPassageDiagnostics(story, startName, format?.isTwine2 === false ? "twine1" : "twine2"));
 			if (!format) throw new TweeTsError("No story format available for HTML output.", diagnostics);
-			if (format.isTwine2) output = toTwine2HTML(story, format, startName, { sourceInfo });
-			else {
-				if (story.name === "" && !storyHas(story, "StoryTitle")) diagnostics.push({
-					level: "error",
-					message: "Special passage \"StoryTitle\" not found."
-				});
-				output = toTwine1HTML(story, format, startName);
-			}
+			if (!format.isTwine2 && story.name === "" && !storyHas(story, "StoryTitle")) diagnostics.push({
+				level: "error",
+				message: "Special passage \"StoryTitle\" not found."
+			});
 			const modules = getFilenames(options.modules ?? [], outFile);
 			diagnostics.push(...modules.diagnostics);
-			output = modifyHead(output, modules.filenames, options.headFile, diagnostics);
+			const head = loadHeadContent(modules.filenames, options.headFile, diagnostics);
+			output = format.isTwine2 ? toTwine2HTML(story, format, startName, {
+				sourceInfo,
+				head
+			}) : toTwine1HTML(story, format, startName, { head });
 			break;
 		}
 		default: throw new TweeTsError(`Unhandled output mode: ${outputMode}`, diagnostics);
@@ -7251,6 +7428,16 @@ function passageLinks(p) {
 	return extractLinksFromText(textAsRead(p), false);
 }
 /**
+* Whether the `target` output keeps the links in `p`: always without a target, which describes
+* every source passage. With one, a passage the output leaves out never reaches the player, so it
+* links nowhere, except a script passage, which Twine 2 output leaves out as a passage but runs.
+*/
+function readsLinks(story, p, { target }) {
+	if (target === void 0) return true;
+	const omission = passageOmission(story, p, target);
+	return omission === void 0 || omission.kind === "tag" && omission.tag === "script";
+}
+/**
 * Each passage name, mapped to why the `target` output leaves that passage out, or to `undefined`
 * when a link can reach it: always without a target, and otherwise when the output emits a
 * passage of that name.
@@ -7308,7 +7495,9 @@ function joinLines(text) {
 * By default, a link is broken only when no passage has its name. Pass a `target` to check links
 * against what that output emits: `storyInspect(result.story, { target: 'twine2' })` also reports
 * links to passages Twine 2 output leaves out, such as script, stylesheet and `Twine.private`
-* passages.
+* passages. With a target, passages that output leaves out also give no links (script passages
+* excepted, as Twine 2 output runs them), so they report no broken links and keep no passage from
+* being an orphan.
 */
 function storyInspect(story, options = {}) {
 	const destinations = destinationOmissions(story, options);
@@ -7333,7 +7522,7 @@ function storyInspect(story, options = {}) {
 			}
 			list.push(p.name);
 		}
-		links.set(p.name, passageLinks(p));
+		links.set(p.name, readsLinks(story, p, options) ? passageLinks(p) : []);
 	}
 	const brokenLinks = [];
 	for (const [from, targets] of links) for (const to of targets) {
@@ -7382,7 +7571,8 @@ function storyInspect(story, options = {}) {
 * Uses JSON output mode internally to avoid format resolution, so it checks
 * the starting passage itself, against the Twine 2 passage rules. Link
 * destinations are checked against the same rules: a link to a passage that
-* Twine 2 output leaves out is broken.
+* Twine 2 output leaves out is broken, and a passage it leaves out (other than
+* a script passage) gives no links.
 */
 async function lint(options) {
 	return lintForOutputFile(options, void 0);