@rohal12/twee-ts 1.16.1 → 1.17.1

package/dist/{compiler-Bmpbelqj.js → paths-w4ulhCFb.js}

@@ -13,6 +13,19 @@ import { fileURLToPath } from "node:url";
 function generateIFID() {
 	return randomUUID().toUpperCase();
 }
+/** 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.
 * Accepts both bare UUIDs and UUID://...// wrapped format.
@@ -438,7 +451,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)) {
@@ -469,7 +482,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":
@@ -1018,7 +1031,7 @@ function isSafeSegment(segment) {
 	return segment !== "" && segment !== "." && segment !== ".." && !/[/\\\0]/.test(segment);
 }
 /** Whether absolute path `target` lies strictly inside absolute path `root`. */
-function isInside(root, target) {
+function isInside$1(root, target) {
 	const rel = relative(root, target);
 	return rel !== "" && !isAbsolute(rel) && rel.split(sep)[0] !== "..";
 }
@@ -1028,7 +1041,7 @@ function cachedFormatDir(name, version) {
 	if (!isSafeSegment(version) || !parseSemver(version)) throw new Error(`Refusing to cache story format "${name}" with an unsafe version: ${JSON.stringify(version)}`);
 	const root = resolve(getCacheDir());
 	const dir = resolve(root, name, version);
-	if (!isInside(root, dir)) throw new Error(`Refusing to cache a story format outside the cache directory ${root}: ${dir}`);
+	if (!isInside$1(root, dir)) throw new Error(`Refusing to cache a story format outside the cache directory ${root}: ${dir}`);
 	return dir;
 }
 /** Create `dir` as a plain directory, or check that it already is one (a symlink could lead out of the cache). */
@@ -4419,14 +4432,16 @@ function parseDocument(data, options) {
 */
 /**
 * Parse a Twine 2 or Twine 1 compiled HTML file back into a Story model.
+* Tweego always trims passage text; here `trim: false` keeps it exactly, as for Twee sources.
 */
-function decompileHTML(html) {
+function decompileHTML(html, options = {}) {
 	const diagnostics = [];
 	const story = createStory();
+	const passageText = options.trim === false ? (text) => text : (text) => text.trim();
 	const doc = parseDocument(html);
 	const twine2Data = findElement(doc, "tw-storydata");
 	if (twine2Data) {
-		decompileTwine2(twine2Data, story, diagnostics);
+		decompileTwine2(twine2Data, story, passageText, diagnostics);
 		return {
 			story,
 			diagnostics
@@ -4434,7 +4449,7 @@ function decompileHTML(html) {
 	}
 	const twine1Data = findElementByIdPattern(doc, /^store(?:-a|A)rea$/);
 	if (twine1Data) {
-		decompileTwine1(twine1Data, story, diagnostics);
+		decompileTwine1(twine1Data, story, passageText, diagnostics);
 		return {
 			story,
 			diagnostics
@@ -4449,7 +4464,7 @@ function decompileHTML(html) {
 		diagnostics
 	};
 }
-function decompileTwine2(storyData, story, diagnostics) {
+function decompileTwine2(storyData, story, passageText, diagnostics) {
 	let startnode = 0;
 	const attrs = storyData.attribs ?? {};
 	if (attrs["name"]) story.name = attrs["name"];
@@ -4461,7 +4476,7 @@ function decompileTwine2(storyData, story, 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({
@@ -4474,15 +4489,20 @@ function decompileTwine2(storyData, story, 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":
 			case "script": {
-				const text = getTextContent(node).trim();
-				if (text.length === 0) continue;
+				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);
@@ -4498,7 +4518,7 @@ function decompileTwine2(storyData, story, 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"]) {
@@ -4515,7 +4535,7 @@ function decompileTwine2(storyData, story, diagnostics) {
 				const passage = {
 					name,
 					tags,
-					text: getTextContent(node).trim()
+					text: passageText(getTextContent(node))
 				};
 				if (metadata.position || metadata.size) passage.metadata = metadata;
 				storyAdd(story, passage, diagnostics);
@@ -4529,8 +4549,19 @@ function decompileTwine2(storyData, story, diagnostics) {
 		text: marshalStoryData(story)
 	}, diagnostics);
 }
-function decompileTwine1(storeArea, story, diagnostics) {
-	const passages = (storeArea.children ?? []).filter(isTiddler).map(tiddlerToPassage);
+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);
 	for (const p of passages) storyAdd(story, obfuscated && p.name !== "StorySettings" ? {
 		...p,
@@ -4540,12 +4571,12 @@ function decompileTwine1(storeArea, story, diagnostics) {
 function isTiddler(node) {
 	return node.type === "tag" && node.name === "div" && node.attribs !== void 0 && "tiddler" in node.attribs;
 }
-function tiddlerToPassage(node) {
+function tiddlerToPassage(node, passageText) {
 	const nodeAttrs = node.attribs ?? {};
 	const passage = {
 		name: nodeAttrs["tiddler"] ?? "",
 		tags: nodeAttrs["tags"] ? nodeAttrs["tags"].split(/\s+/).filter((s) => s.length > 0) : [],
-		text: tiddlerUnescape(getTextContent(node)).trim()
+		text: passageText(tiddlerUnescape(getTextContent(node)))
 	};
 	const position = nodeAttrs["twine-position"];
 	if (position) passage.metadata = { position };
@@ -4610,7 +4641,7 @@ function loadSources(story, filenames, opts, diagnostics, processedFiles) {
 					break;
 				case "htm":
 				case "html":
-					loadHTML(story, filename, diagnostics);
+					loadHTML(story, filename, opts, diagnostics);
 					break;
 				case "css":
 					loadTagged(story, "stylesheet", filename, diagnostics);
@@ -4764,8 +4795,8 @@ function parseFontFile(filename) {
 		diagnostics: []
 	};
 }
-function parseHTMLFile(filename) {
-	const { story, diagnostics } = decompileHTML(readUTF8(filename));
+function parseHTMLFile(filename, opts) {
+	const { story, diagnostics } = decompileHTML(readUTF8(filename), { trim: opts.trim ?? true });
 	return {
 		passages: story.name !== "" && !storyHas(story, "StoryTitle") ? [{
 			name: "StoryTitle",
@@ -4777,14 +4808,17 @@ function parseHTMLFile(filename) {
 }
 /**
 * Identity of the options that affect how a file parses, stored on its cache entry.
-* Only Twee files depend on them; every other file type yields the same key for all options.
+* Twee files depend on `trim` and `twee2Compat`, HTML files on `trim`; every other file type
+* yields the same key for all options.
 */
 function parseOptionsKey(filename, opts) {
 	const ext = normalizedFileExt(filename);
+	const trim = opts.trim ?? true;
+	if (ext === "htm" || ext === "html") return JSON.stringify({ trim });
 	const twee2File = ext === "tw2" || ext === "twee2";
 	if (!twee2File && ext !== "tw" && ext !== "twee") return "";
 	return JSON.stringify({
-		trim: opts.trim ?? true,
+		trim,
 		twee2Compat: twee2File || (opts.twee2Compat ?? false)
 	});
 }
@@ -4798,7 +4832,7 @@ function parseFile(filename, opts) {
 			twee2Compat: true
 		});
 		case "htm":
-		case "html": return parseHTMLFile(filename);
+		case "html": return parseHTMLFile(filename, opts);
 		case "css": return parseTaggedFile("stylesheet", filename);
 		case "js": return parseTaggedFile("script", filename);
 		case "otf":
@@ -4830,8 +4864,8 @@ function parseFile(filename, opts) {
 		default: return;
 	}
 }
-function loadHTML(story, filename, diagnostics) {
-	const result = parseHTMLFile(filename);
+function loadHTML(story, filename, opts, diagnostics) {
+	const result = parseHTMLFile(filename, opts);
 	diagnostics.push(...result.diagnostics);
 	for (const p of result.passages) storyAdd(story, p, diagnostics);
 }
@@ -4870,7 +4904,8 @@ function loadSourcesCached(story, filenames, opts, diagnostics, processedFiles,
 		const optionsKey = parseOptionsKey(filename, opts);
 		const entry = cache.get(filename);
 		const cached = entry?.parseOptionsKey === optionsKey ? entry : void 0;
-		if (changedFiles && cached && !changedFiles.has(filename)) {
+		const changed = changedFiles?.has(filename) ?? false;
+		if (changedFiles && cached && !changed) {
 			diagnostics.push(...cached.diagnostics);
 			for (const p of cached.passages) storyAdd(story, p, diagnostics);
 			processedFiles.add(filename);
@@ -4882,7 +4917,7 @@ function loadSourcesCached(story, filenames, opts, diagnostics, processedFiles,
 		} catch {
 			continue;
 		}
-		if (cached && cached.mtimeMs === mtimeMs) {
+		if (cached && !changed && cached.mtimeMs === mtimeMs) {
 			diagnostics.push(...cached.diagnostics);
 			for (const p of cached.passages) storyAdd(story, p, diagnostics);
 			processedFiles.add(filename);
@@ -4917,6 +4952,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.
@@ -4950,24 +5100,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",
@@ -5060,7 +5224,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 = dirname(format.filename);
 	const parentDir = dirname(formatDir);
 	let template = readFormatSource(format);
@@ -5071,28 +5241,60 @@ function toTwine1HTML(story, format, startName) {
 	template = tryReplaceComponent(template, "\"JONAH\"", join(formatDir, "code.js"), true);
 	if (story.twine1.settings.get("jquery") === "on") template = tryReplaceComponent(template, "\"JQUERY\"", join(parentDir, "jquery.js"), true);
 	if (story.twine1.settings.get("modernizr") === "on") template = tryReplaceComponent(template, "\"MODERNIZR\"", 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 = readFileSync(join(formatDir, "footer.html"), "utf-8");
-		} catch {
-			footer = "</div>\n</body>\n</html>\n";
+	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
 		}
-		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"`);
+	] : [{
+		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 readFileSync(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.
@@ -5130,82 +5332,54 @@ function tryReplaceComponent(template, placeholder, componentPath, required) {
 }
 //#endregion
 //#region src/output-twee.ts
-function toTwee(story, outMode) {
-	let data = "";
-	for (const p of story.passages) data += passageToTwee(p, outMode);
-	return data;
-}
-//#endregion
-//#region src/modules.ts
 /**
-* Load modules and return HTML tags to inject before </head>.
+* Serialize the story as Twee. The StoryData passage is written from the story model rather than
+* from its loaded text, so changes made after loading (a start passage override, test mode) are kept.
+* Tweego writes the loaded text; its own normalization makes the two the same for an unchanged story.
+*
+* `addStoryData`: add a StoryData passage when the story has none, so that StoryData fields the
+* compile options set are recorded. Default: false.
 */
-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 toTwee(story, outMode, options = {}) {
+	return withEffectiveStoryData(story, options.addStoryData ?? false).map((p) => passageToTwee(p, outMode)).join("");
 }
-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 withEffectiveStoryData(story, addStoryData) {
+	const storyData = {
+		name: "StoryData",
+		tags: [],
+		text: marshalStoryData(story)
+	};
+	const index = story.passages.findIndex((p) => p.name === "StoryData");
+	if (index !== -1) return story.passages.map((p, i) => i === index && isStoryDataJSON(p.text) ? {
+		...p,
+		text: storyData.text
+	} : p);
+	if (!addStoryData) return story.passages;
+	const at = story.passages[0]?.name === "StoryTitle" ? 1 : 0;
+	return [
+		...story.passages.slice(0, at),
+		storyData,
+		...story.passages.slice(at)
+	];
 }
-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>`;
+/** Whether the text loaded as StoryData. Text that did not is kept as written, for the author to fix. */
+function isStoryDataJSON(text) {
+	return unmarshalStoryData(createStory(), text) === null;
 }
+//#endregion
+//#region src/passage-omission.ts
 /**
-* Inject modules and head file content before </head>.
+* Why the `target` output leaves `passage` out of its passage elements, or `undefined` when it
+* emits the passage (and so a link or the start can name it).
 */
-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);
+function passageOmission(story, passage, target) {
+	switch (target) {
+		case "twine2": return twine2PassageOmission(story, passage);
+		case "twine1": return twine1PassageOmission(passage);
+		default: throw new Error(`unhandled passage output target: ${String(target)}`);
 	}
-	return html;
 }
-//#endregion
-//#region src/start-passage.ts
+/** Why a passage is left out, as a predicate: `Passage "X" ${describeOmission(o)}`. */
 function describeOmission(omission) {
 	switch (omission.kind) {
 		case "special-name": return `is the special "${omission.name}" passage`;
@@ -5214,13 +5388,8 @@ function describeOmission(omission) {
 		default: throw new Error(`unhandled passage omission: ${JSON.stringify(omission)}`);
 	}
 }
-function omissionFor(story, passage, target) {
-	switch (target) {
-		case "twine2": return twine2PassageOmission(story, passage);
-		case "twine1": return twine1PassageOmission(passage);
-		default: throw new Error(`unhandled start passage target: ${String(target)}`);
-	}
-}
+//#endregion
+//#region src/start-passage.ts
 /**
 * Check that `startName` names a passage the `target` output emits.
 * Returns the error diagnostics to report (empty when the start is usable).
@@ -5231,7 +5400,7 @@ function startPassageDiagnostics(story, startName, target) {
 		level: "error",
 		message: `Starting passage "${startName}" not found.`
 	}];
-	const omission = omissionFor(story, passage, target);
+	const omission = passageOmission(story, passage, target);
 	if (omission === void 0) return [];
 	return [{
 		level: "error",
@@ -5252,17 +5421,16 @@ var TweeTsError = class extends Error {
 	}
 };
 /**
-* Compile Twee sources to HTML, Twee, or JSON.
-*/
-async function compile(options) {
-	return buildOutput(options);
-}
-/**
-* Compile with incremental caching support.
-* Plugins and advanced users can manage their own cache and changed-file tracking.
+* 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(). With `cache`, files are cached as
+* compileIncremental() caches them.
+*
+* Internal, for the CLI and the bundler plugins; not part of the public API.
 */
-async function compileIncremental(options, cache, changedFiles) {
-	return buildOutput(options, cache, changedFiles);
+async function compileForOutputFile(options, outFile, cache) {
+	return buildOutput(options, cache, void 0, outFile);
 }
 /**
 * `outFile`: the file the build is written to, which source and module discovery
@@ -5311,7 +5479,7 @@ async function buildOutput(options, cache, changedFiles, outFile) {
 	switch (outputMode) {
 		case "twee3":
 		case "twee1":
-			output = toTwee(story, outputMode);
+			output = toTwee(story, outputMode, { addStoryData: Boolean(options.startPassage) || testMode });
 			break;
 		case "twine2-archive":
 			output = toTwine2Archive(story, startName, { sourceInfo });
@@ -5325,17 +5493,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);
@@ -5411,6 +5579,68 @@ function storyToJSON(story) {
 	return JSON.stringify(obj, null, 2);
 }
 //#endregion
-export { isExcluded as a, getFilenames as i, compile as n, mediaTypeFromFilename as o, compileIncremental as r, TweeTsError as t };
+//#region src/plugins/diagnostics.ts
+function formatDiagnostic(d) {
+	return `${d.file ? `${d.file}${d.line ? `:${d.line}` : ""}: ` : ""}${d.file && d.line ? d.message.replace(/^line \d+: /, "") : d.message}`;
+}
+/** Returns the warnings; throws a LocatedError when the compile reported errors. */
+function splitDiagnostics(result) {
+	const errors = result.diagnostics.filter((d) => d.level === "error");
+	if (errors.length === 0) return result.diagnostics.filter((d) => d.level === "warning");
+	const error = new Error(errors.map(formatDiagnostic).join("\n"));
+	const [first] = errors;
+	if (first?.file) {
+		error.id = first.file;
+		error.loc = {
+			file: first.file,
+			line: first.line ?? 1,
+			column: 1
+		};
+	}
+	throw error;
+}
+/** An error thrown by the compiler or bundler, with a TweeTsError's error diagnostics folded into its message. */
+function fatalError(e) {
+	if (e instanceof TweeTsError) {
+		const errors = e.diagnostics.filter((d) => d.level === "error").map(formatDiagnostic);
+		return new Error([...errors, e.message].join("\n"));
+	}
+	return e instanceof Error ? e : new Error(String(e));
+}
+//#endregion
+//#region src/plugins/paths.ts
+/**
+* Path helpers for the bundler plugins. Vite reports module ids with forward
+* slashes on every platform, while node:path gives backslashes on Windows, so
+* the Vite plugin compares paths in forward-slash form only.
+*/
+/**
+* The absolute path a bundle writes the file it emits as `fileName` to: inside
+* `output.dir`, or next to `output.file`, either resolved against the working
+* directory, as the bundler resolves them. Undefined when the output names
+* neither, as for a bundle only generated in memory.
+*/
+function emittedFilePath(output, fileName) {
+	const dir = output.dir ?? (output.file === void 0 ? void 0 : dirname(output.file));
+	return dir === void 0 ? void 0 : resolve(dir, fileName);
+}
+/** The path with Windows separators turned into forward slashes. */
+function toPosix(path) {
+	return path.replace(/\\/g, "/");
+}
+/** Whether `file` is one of `dirs` or inside one of them. All paths in forward-slash form. */
+function isInside(file, dirs) {
+	return dirs.some((dir) => file === dir || file.startsWith(dir.endsWith("/") ? dir : `${dir}/`));
+}
+/**
+* Whether `file` is a temporary copy of a Vite config file. Vite writes one next
+* to the config file each time it loads it (when no node_modules folder is
+* above the config, and always under Deno), then deletes it.
+*/
+function isViteConfigTemp(file) {
+	return /\.timestamp-\d+-[0-9a-f]*\.mjs$/.test(file);
+}
+//#endregion
+export { fatalError as a, compileForOutputFile as c, mediaTypeFromFilename as d, toPosix as i, getFilenames as l, isInside as n, formatDiagnostic as o, isViteConfigTemp as r, splitDiagnostics as s, emittedFilePath as t, isExcluded as u };
 
-//# sourceMappingURL=compiler-Bmpbelqj.js.map
+//# sourceMappingURL=paths-w4ulhCFb.js.map