@rohal12/twee-ts 1.2.0 → 1.4.0

package/dist/index.d.cts

@@ -76,6 +76,7 @@ interface CompileStats {
 interface PassageMetadata {
     position?: string;
     size?: string;
+    [key: string]: string | undefined;
 }
 interface Passage {
     name: string;
@@ -91,6 +92,7 @@ interface Twine2Metadata {
     formatVersion: string;
     options: Map<string, boolean>;
     start: string;
+    tags: string;
     tagColors: Map<string, string>;
     zoom: number;
 }
@@ -109,12 +111,22 @@ interface StoryFormatInfo {
     name: string;
     version: string;
     proofing: boolean;
+    author?: string;
+    description?: string;
+    image?: string;
+    url?: string;
+    license?: string;
 }
 interface Twine2FormatJSON {
     name: string;
     version: string;
     proofing?: boolean;
     source: string;
+    author?: string;
+    description?: string;
+    image?: string;
+    url?: string;
+    license?: string;
 }
 declare const enum ItemType {
     Error = 0,
@@ -301,10 +313,13 @@ declare function parseTwee(source: string, options?: ParseOptions): ParseResult;
 /**
  * Parse the Twine 2 format.js JSON chunk.
  * Handles Harlowe's malformed JSON by stripping the "setup" function property.
+ * Per spec, the name key is Optional.
  */
 declare function parseFormatJSON(source: string, formatId: string): Twine2FormatJSON | null;
 /**
  * Discover all story formats in the given search directories.
+ * Implements SemVer-based version pruning: within each (name, major) group,
+ * only the highest minor.patch survives.
  */
 declare function discoverFormats(searchDirs: string[]): Map<string, StoryFormatInfo>;
 /**

package/dist/index.d.ts

@@ -76,6 +76,7 @@ interface CompileStats {
 interface PassageMetadata {
     position?: string;
     size?: string;
+    [key: string]: string | undefined;
 }
 interface Passage {
     name: string;
@@ -91,6 +92,7 @@ interface Twine2Metadata {
     formatVersion: string;
     options: Map<string, boolean>;
     start: string;
+    tags: string;
     tagColors: Map<string, string>;
     zoom: number;
 }
@@ -109,12 +111,22 @@ interface StoryFormatInfo {
     name: string;
     version: string;
     proofing: boolean;
+    author?: string;
+    description?: string;
+    image?: string;
+    url?: string;
+    license?: string;
 }
 interface Twine2FormatJSON {
     name: string;
     version: string;
     proofing?: boolean;
     source: string;
+    author?: string;
+    description?: string;
+    image?: string;
+    url?: string;
+    license?: string;
 }
 declare const enum ItemType {
     Error = 0,
@@ -301,10 +313,13 @@ declare function parseTwee(source: string, options?: ParseOptions): ParseResult;
 /**
  * Parse the Twine 2 format.js JSON chunk.
  * Handles Harlowe's malformed JSON by stripping the "setup" function property.
+ * Per spec, the name key is Optional.
  */
 declare function parseFormatJSON(source: string, formatId: string): Twine2FormatJSON | null;
 /**
  * Discover all story formats in the given search directories.
+ * Implements SemVer-based version pruning: within each (name, major) group,
+ * only the highest minor.patch survives.
  */
 declare function discoverFormats(searchDirs: string[]): Map<string, StoryFormatInfo>;
 /**

package/dist/index.js

@@ -57,6 +57,10 @@ function attrEscape(s) {
   if (s.length === 0) return s;
   return s.replace(/&/g, "&").replace(/"/g, """).replace(/'/g, "'");
 }
+function fullAttrEscape(s) {
+  if (s.length === 0) return s;
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
 function htmlEscape(s) {
   if (s.length === 0) return s;
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
@@ -79,6 +83,13 @@ function commentSanitize(s) {
 function htmlCommentSanitize(s) {
   return s.replace(/-->/g, "-- >");
 }
+function rot13(s) {
+  if (s.length === 0) return s;
+  return s.replace(/[A-Za-z]/g, (ch) => {
+    const base = ch <= "Z" ? 65 : 97;
+    return String.fromCharCode((ch.charCodeAt(0) - base + 13) % 26 + base);
+  });
+}
 function tweeUnescape(s) {
   if (s.length === 0) return s;
   let result = "";
@@ -146,12 +157,14 @@ function hasMetadataSize(p) {
   return p.metadata != null && p.metadata.size != null && p.metadata.size !== "";
 }
 function hasAnyMetadata(p) {
-  return hasMetadataPosition(p) || hasMetadataSize(p);
+  if (!p.metadata) return false;
+  return Object.values(p.metadata).some((v) => v != null && v !== "");
 }
 function marshalMetadata(meta) {
   const obj = {};
-  if (meta.position) obj.position = meta.position;
-  if (meta.size) obj.size = meta.size;
+  for (const [key, value] of Object.entries(meta)) {
+    if (typeof value === "string" && value) obj[key] = value;
+  }
   return JSON.stringify(obj);
 }
 function passageToTwee(p, outMode) {
@@ -194,9 +207,9 @@ function passageToPassagedata(p, pid) {
   } else {
     size = "100,100";
   }
-  return `<tw-passagedata pid="${pid}" name=${quote(attrEscape(p.name))} tags=${quote(attrEscape(p.tags.join(" ")))} position=${quote(attrEscape(position))} size=${quote(attrEscape(size))}>${htmlEscape(p.text)}</tw-passagedata>`;
+  return `<tw-passagedata pid="${pid}" name=${quote(fullAttrEscape(p.name))} tags=${quote(attrEscape(p.tags.join(" ")))} position=${quote(attrEscape(position))} size=${quote(attrEscape(size))}>${htmlEscape(p.text)}</tw-passagedata>`;
 }
-function passageToTiddler(p, pid) {
+function passageToTiddler(p, pid, obfuscateRot13 = false) {
   let position;
   if (hasMetadataPosition(p)) {
     position = p.metadata?.position ?? "";
@@ -207,7 +220,10 @@ function passageToTiddler(p, pid) {
     const yp = x === 0 ? y : y + 1;
     position = `${xp * 140 - 130},${yp * 140 - 130}`;
   }
-  return `<div tiddler=${quote(attrEscape(p.name))} tags=${quote(attrEscape(p.tags.join(" ")))} twine-position=${quote(attrEscape(position))}>${tiddlerEscape(p.text)}</div>`;
+  const created = (/* @__PURE__ */ new Date()).toISOString().replace(/[-:T]/g, "").slice(0, 12);
+  const content = obfuscateRot13 && p.name !== "StorySettings" ? tiddlerEscape(rot13(p.text)) : tiddlerEscape(p.text);
+  const nameComment = obfuscateRot13 ? `<!-- ${commentSanitize(p.name)} -->` : "";
+  return `<div tiddler=${quote(attrEscape(p.name))} tags=${quote(attrEscape(p.tags.join(" ")))} created=${quote(created)} modifier=${quote("twee")} twine-position=${quote(attrEscape(position))}>${nameComment}${content}</div>`;
 }
 function countWords(p) {
   let text = p.text;
@@ -250,6 +266,7 @@ function createStory() {
       formatVersion: "",
       options: /* @__PURE__ */ new Map(),
       start: "",
+      tags: "",
       tagColors: /* @__PURE__ */ new Map(),
       zoom: 1
     }
@@ -296,6 +313,7 @@ function marshalStoryData(story) {
   }
   if (options.length > 0) data.options = options;
   if (story.twine2.start) data.start = story.twine2.start;
+  if (story.twine2.tags) data.tags = story.twine2.tags;
   if (story.twine2.tagColors.size > 0) {
     data["tag-colors"] = Object.fromEntries(story.twine2.tagColors);
   }
@@ -323,6 +341,7 @@ function unmarshalStoryData(story, json) {
     }
   }
   if (typeof data.start === "string" && data.start) story.twine2.start = data.start;
+  if (typeof data.tags === "string") story.twine2.tags = data.tags;
   if (typeof data["tag-colors"] === "object" && data["tag-colors"] !== null && !Array.isArray(data["tag-colors"])) {
     for (const [tag, color] of Object.entries(data["tag-colors"])) {
       if (typeof color === "string") story.twine2.tagColors.set(tag, color);
@@ -394,7 +413,7 @@ function storyAdd(story, p, diagnostics) {
         processed = { ...p, text: marshalStoryData(story) };
       } else {
         diagnostics.push({
-          level: "error",
+          level: "warning",
           message: `Cannot unmarshal "StoryData" compiler special passage; ${err}.`
         });
       }
@@ -617,17 +636,41 @@ function baseNameWithoutExt(filename) {
 }
 
 // src/formats.ts
+function relaxedJSONParse(json) {
+  try {
+    return JSON.parse(json);
+  } catch {
+  }
+  let fixed = json;
+  fixed = fixed.replace(/'([^'\\]*(?:\\.[^'\\]*)*)'/g, '"$1"');
+  fixed = fixed.replace(/(?<=^|[{,]\s*)([A-Za-z_$][A-Za-z0-9_$]*)\s*:/gm, '"$1":');
+  fixed = fixed.replace(/,\s*([}\]])/g, "$1");
+  return JSON.parse(fixed);
+}
 function parseFormatJSON(source, formatId) {
   const first = source.indexOf("{");
   const last = source.lastIndexOf("}");
   if (first === -1 || last === -1) return null;
   let chunk = source.slice(first, last + 1);
   const parse = (json) => {
-    const raw = JSON.parse(json);
+    const raw = relaxedJSONParse(json);
     if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return null;
     const obj = raw;
-    if (typeof obj.name !== "string" || typeof obj.version !== "string" || typeof obj.source !== "string") return null;
-    return { name: obj.name, version: obj.version, source: obj.source, proofing: obj.proofing === true };
+    if (typeof obj.version !== "string" || typeof obj.source !== "string") return null;
+    if (!parseSemver(obj.version)) return null;
+    const name = typeof obj.name === "string" ? obj.name : "Untitled Story Format";
+    const result = {
+      name,
+      version: obj.version,
+      source: obj.source,
+      proofing: obj.proofing === true
+    };
+    if (typeof obj.author === "string") result.author = obj.author;
+    if (typeof obj.description === "string") result.description = obj.description;
+    if (typeof obj.image === "string") result.image = obj.image;
+    if (typeof obj.url === "string") result.url = obj.url;
+    if (typeof obj.license === "string") result.license = obj.license;
+    return result;
   };
   try {
     return parse(chunk);
@@ -693,17 +736,55 @@ function discoverFormats(searchDirs) {
             format.name = data.name;
             format.version = data.version;
             format.proofing = data.proofing ?? false;
+            if (data.author) format.author = data.author;
+            if (data.description) format.description = data.description;
+            if (data.image) format.image = data.image;
+            if (data.url) format.url = data.url;
+            if (data.license) format.license = data.license;
           } catch {
             continue;
           }
+        } else {
+          format.name = entry;
         }
         formats.set(entry, format);
         break;
       }
     }
   }
+  pruneFormats(formats);
   return formats;
 }
+function pruneFormats(formats) {
+  const bestByNameMajor = /* @__PURE__ */ new Map();
+  const seenNameVersion = /* @__PURE__ */ new Set();
+  for (const [id, f] of formats) {
+    if (!f.isTwine2 || !f.name || !f.version) continue;
+    const v = parseSemver(f.version);
+    if (!v) continue;
+    const nameVersionKey = `${f.name}@${f.version}`;
+    if (seenNameVersion.has(nameVersionKey)) {
+      formats.delete(id);
+      continue;
+    }
+    seenNameVersion.add(nameVersionKey);
+    const groupKey = `${f.name}@${v[0]}`;
+    const existing = bestByNameMajor.get(groupKey);
+    if (!existing || semverCompare(v, existing.version) > 0) {
+      bestByNameMajor.set(groupKey, { id, version: v });
+    }
+  }
+  for (const [id, f] of [...formats]) {
+    if (!f.isTwine2 || !f.name || !f.version) continue;
+    const v = parseSemver(f.version);
+    if (!v) continue;
+    const groupKey = `${f.name}@${v[0]}`;
+    const best = bestByNameMajor.get(groupKey);
+    if (best && best.id !== id) {
+      formats.delete(id);
+    }
+  }
+}
 function getFormatSearchDirs(extraPaths = [], useTweegoPath = true) {
   const subdirNames = ["storyformats", ".storyformats", "story-formats", "storyFormats", "targets"];
   const basePaths = /* @__PURE__ */ new Set();
@@ -1156,8 +1237,11 @@ function parseTwee(source, options = {}) {
           }
           const parsed = raw;
           const meta = {};
-          if (typeof parsed.position === "string") meta.position = parsed.position;
-          if (typeof parsed.size === "string") meta.size = parsed.size;
+          for (const [key, value] of Object.entries(parsed)) {
+            if (typeof value === "string") {
+              meta[key] = value;
+            }
+          }
           current.metadata = meta;
         } catch (e) {
           diagnostics.push({
@@ -1171,7 +1255,11 @@ function parseTwee(source, options = {}) {
       }
       case 6 /* Content */: {
         if (!current) break;
-        current.text = trim ? item.val.trim() : item.val;
+        if (trim) {
+          current.text = item.val.trim();
+        } else {
+          current.text = item.val.replace(/\n\s*$/, "");
+        }
         break;
       }
       default: {
@@ -1399,8 +1487,12 @@ function getTwine2DataChunk(story, startName, diagnostics) {
     }
   }
   parts.push(`<script role="script" id="twine-user-script" type="text/twine-javascript">${scriptContent}</script>`);
+  const validTagColors = /* @__PURE__ */ new Set(["gray", "red", "orange", "yellow", "green", "blue", "purple"]);
+  const hexColorPattern = /^#[0-9a-fA-F]{3,8}$/;
   for (const [tag, color] of story.twine2.tagColors) {
-    parts.push(`<tw-tag name="${attrEscape(tag)}" color="${attrEscape(color)}"></tw-tag>`);
+    if (validTagColors.has(color) || hexColorPattern.test(color)) {
+      parts.push(`<tw-tag name="${attrEscape(tag)}" color="${attrEscape(color)}"></tw-tag>`);
+    }
   }
   pid = 1;
   for (const p of story.passages) {
@@ -1421,23 +1513,24 @@ function getTwine2DataChunk(story, startName, diagnostics) {
     if (val) opts.push(opt);
   }
   const options = opts.join(" ");
-  const zoom = story.twine2.zoom === Math.floor(story.twine2.zoom) ? story.twine2.zoom.toString() : story.twine2.zoom.toFixed(1);
-  const wrapper = `<!-- UUID://${htmlCommentSanitize(story.ifid)}// --><tw-storydata name="${attrEscape(story.name)}" startnode="${attrEscape(startID)}" creator="${attrEscape(CREATOR_NAME)}" creator-version="${attrEscape(VERSION)}" ifid="${attrEscape(story.ifid)}" zoom="${attrEscape(zoom)}" format="${attrEscape(story.twine2.format)}" format-version="${attrEscape(story.twine2.formatVersion)}" options="${attrEscape(options)}" hidden>`;
+  const zoom = String(story.twine2.zoom);
+  const wrapper = `<!-- UUID://${htmlCommentSanitize(story.ifid)}// --><tw-storydata name="${attrEscape(story.name)}" startnode="${attrEscape(startID)}" creator="${attrEscape(CREATOR_NAME)}" creator-version="${attrEscape(VERSION)}" ifid="${attrEscape(story.ifid)}" zoom="${attrEscape(zoom)}" format="${attrEscape(story.twine2.format)}" format-version="${attrEscape(story.twine2.formatVersion)}" options="${attrEscape(options)}" tags="${attrEscape(story.twine2.tags)}" hidden>`;
   return wrapper + parts.join("") + "</tw-storydata>";
 }
 function ensureIFID(story, diagnostics) {
   if (story.ifid !== "") return;
   if (story.legacyIFID !== "") {
+    story.ifid = story.legacyIFID;
     diagnostics.push({
       level: "warning",
       message: 'Story IFID not found; reusing "ifid" entry from the "StorySettings" special passage.'
     });
-    story.ifid = story.legacyIFID;
   } else {
-    story.ifid = generateIFID();
+    const ifid = generateIFID();
+    story.ifid = ifid;
     diagnostics.push({
-      level: "warning",
-      message: `Story IFID not found; generated ${story.ifid} for your project. Add it to a StoryData passage.`
+      level: "error",
+      message: `Story IFID not found. Add an IFID to your story: {"ifid":"${ifid}"}`
     });
   }
 }
@@ -1448,7 +1541,7 @@ import { join as join3, dirname } from "path";
 var CREATOR_NAME2 = "twee-ts";
 function toTwine1Archive(story, _startName) {
   const { data, count } = getTwine1PassageChunk(story);
-  return `<div id="storeArea" data-size="${count}" hidden>${data}</div>
+  return `<div id="storeArea" data-size="${count}">${data}</div>
 `;
 }
 function toTwine1HTML(story, format, startName, _diagnostics) {
@@ -1493,12 +1586,13 @@ function toTwine1HTML(story, format, startName, _diagnostics) {
   return template;
 }
 function getTwine1PassageChunk(story) {
+  const obfuscateRot13 = story.twine1.settings.get("obfuscate") === "rot13";
   let data = "";
   let count = 0;
   for (const p of story.passages) {
     if (hasTag(p, "Twine.private")) continue;
     count++;
-    data += passageToTiddler(p, count);
+    data += passageToTiddler(p, count, obfuscateRot13);
   }
   return { data, count };
 }
@@ -1834,6 +1928,7 @@ function discoverCachedFormats() {
 }
 
 // src/compiler.ts
+var CREATOR_NAME3 = "Twee-ts";
 var DEFAULT_FORMAT_ID = "sugarcube-2";
 var DEFAULT_START_NAME = "Start";
 var TweeTsError = class extends Error {
@@ -1980,28 +2075,49 @@ async function buildOutput(options) {
   return { output, story, format, diagnostics, stats };
 }
 function storyToJSON(story) {
-  return JSON.stringify(
-    {
-      name: story.name,
-      ifid: story.ifid,
-      passages: story.passages.map((p) => ({
+  const scripts = [];
+  const stylesheets = [];
+  const storyPassages = [];
+  for (const p of story.passages) {
+    if (p.name === "StoryTitle" || p.name === "StoryData") continue;
+    if (hasTag(p, "Twine.private")) continue;
+    if (hasTag(p, "script")) {
+      scripts.push(p.text);
+    } else if (hasTag(p, "stylesheet")) {
+      stylesheets.push(p.text);
+    } else {
+      const entry = {
         name: p.name,
         tags: p.tags,
-        text: p.text,
-        metadata: p.metadata ?? null
-      })),
-      twine2: {
-        format: story.twine2.format,
-        formatVersion: story.twine2.formatVersion,
-        start: story.twine2.start,
-        tagColors: Object.fromEntries(story.twine2.tagColors),
-        options: Object.fromEntries(story.twine2.options),
-        zoom: story.twine2.zoom
+        text: p.text
+      };
+      if (p.metadata) {
+        const meta = {};
+        for (const [key, value] of Object.entries(p.metadata)) {
+          if (typeof value === "string") meta[key] = value;
+        }
+        if (Object.keys(meta).length > 0) {
+          entry.metadata = meta;
+        }
       }
-    },
-    null,
-    2
-  );
+      storyPassages.push(entry);
+    }
+  }
+  const obj = {
+    name: story.name
+  };
+  if (story.ifid) obj.ifid = story.ifid;
+  if (story.twine2.format) obj.format = story.twine2.format;
+  if (story.twine2.formatVersion) obj["format-version"] = story.twine2.formatVersion;
+  if (story.twine2.start) obj.start = story.twine2.start;
+  if (story.twine2.tagColors.size > 0) obj["tag-colors"] = Object.fromEntries(story.twine2.tagColors);
+  if (story.twine2.zoom !== 1) obj.zoom = story.twine2.zoom;
+  obj.creator = CREATOR_NAME3;
+  obj["creator-version"] = VERSION;
+  obj.style = stylesheets.join("\n");
+  obj.script = scripts.join("\n");
+  obj.passages = storyPassages;
+  return JSON.stringify(obj, null, 2);
 }
 
 // src/inspect.ts