@rohal12/twee-ts 1.6.0 → 1.8.0

package/dist/bin/twee-ts.js

@@ -151,6 +151,9 @@ function hasInfoTags(p) {
 function hasInfoName(p) {
   return INFO_PASSAGE_NAMES.has(p.name);
 }
+function isInfoPassage(p) {
+  return hasInfoName(p) || hasInfoTags(p);
+}
 function isStoryPassage(p) {
   return !hasInfoName(p) && !hasInfoTags(p);
 }
@@ -1841,7 +1844,7 @@ function modifyHead(html, modulePaths, headFile, diagnostics) {
 }
 
 // src/remote-formats.ts
-import { mkdirSync, readFileSync as readFileSync3, writeFileSync, existsSync, readdirSync as readdirSync3, statSync as statSync4 } from "fs";
+import { mkdirSync, readFileSync as readFileSync3, writeFileSync, existsSync, readdirSync as readdirSync3, statSync as statSync4, rmSync } from "fs";
 import { join as join4 } from "path";
 import { homedir as homedir2 } from "os";
 var DEFAULT_SFA_INDICES = [
@@ -2072,6 +2075,75 @@ function discoverCachedFormats() {
   }
   return formats;
 }
+function listCachedFormats() {
+  const cacheDir = getCacheDir();
+  const entries = [];
+  try {
+    if (!existsSync(cacheDir)) return entries;
+  } catch {
+    return entries;
+  }
+  let names;
+  try {
+    names = readdirSync3(cacheDir);
+  } catch {
+    return entries;
+  }
+  for (const name of names) {
+    const nameDir = join4(cacheDir, name);
+    try {
+      if (!statSync4(nameDir).isDirectory()) continue;
+    } catch {
+      continue;
+    }
+    let versions;
+    try {
+      versions = readdirSync3(nameDir);
+    } catch {
+      continue;
+    }
+    for (const version of versions) {
+      const formatPath = join4(nameDir, version, "format.js");
+      try {
+        const stat = statSync4(formatPath);
+        entries.push({
+          name,
+          version,
+          sizeBytes: stat.size,
+          modifiedAt: stat.mtime
+        });
+      } catch {
+      }
+    }
+  }
+  return entries;
+}
+function clearCachedFormats(name) {
+  const cacheDir = getCacheDir();
+  if (!existsSync(cacheDir)) return 0;
+  if (!name) {
+    const entries = listCachedFormats();
+    const count2 = entries.length;
+    rmSync(cacheDir, { recursive: true, force: true });
+    return count2;
+  }
+  const nameDir = join4(cacheDir, name);
+  if (!existsSync(nameDir)) return 0;
+  let versions;
+  try {
+    versions = readdirSync3(nameDir);
+  } catch {
+    return 0;
+  }
+  const count = versions.length;
+  rmSync(nameDir, { recursive: true, force: true });
+  return count;
+}
+function getCacheSize() {
+  const entries = listCachedFormats();
+  const totalBytes = entries.reduce((sum, e) => sum + e.sizeBytes, 0);
+  return { totalBytes, count: entries.length };
+}
 
 // src/compiler.ts
 var CREATOR_NAME3 = "Twee-ts";
@@ -2272,6 +2344,171 @@ function storyToJSON(story) {
   return JSON.stringify(obj, null, 2);
 }
 
+// src/inspect.ts
+function extractLinksFromText(text) {
+  const targets = /* @__PURE__ */ new Set();
+  const wikiLinkRe = /\[\[([^\]]+)\]\]/g;
+  let m;
+  while ((m = wikiLinkRe.exec(text)) !== null) {
+    const content = m[1];
+    const arrowIdx = content.indexOf("->");
+    if (arrowIdx !== -1) {
+      targets.add(content.slice(arrowIdx + 2).trim());
+      continue;
+    }
+    const pipeIdx = content.indexOf("|");
+    if (pipeIdx !== -1) {
+      targets.add(content.slice(pipeIdx + 1).trim());
+      continue;
+    }
+    targets.add(content.trim());
+  }
+  const gotoRe = /<<goto\s+["']([^"']+)["']\s*>>/g;
+  while ((m = gotoRe.exec(text)) !== null) {
+    targets.add(m[1]);
+  }
+  const linkMacroRe = /<<link\s+["'][^"']*["']\s+["']([^"']+)["']\s*>>/g;
+  while ((m = linkMacroRe.exec(text)) !== null) {
+    targets.add(m[1]);
+  }
+  return [...targets];
+}
+function storyInspect(story) {
+  const allNames = new Set(story.passages.map((p) => p.name));
+  const passages = [];
+  const storyPassages = [];
+  const infoPassages = [];
+  const tagSet = /* @__PURE__ */ new Set();
+  const passagesByTag = /* @__PURE__ */ new Map();
+  const tagsByPassage = /* @__PURE__ */ new Map();
+  const links = /* @__PURE__ */ new Map();
+  for (const p of story.passages) {
+    passages.push(p.name);
+    if (isStoryPassage(p)) {
+      storyPassages.push(p.name);
+    }
+    if (isInfoPassage(p)) {
+      infoPassages.push(p.name);
+    }
+    tagsByPassage.set(p.name, [...p.tags]);
+    for (const tag of p.tags) {
+      tagSet.add(tag);
+      let list = passagesByTag.get(tag);
+      if (!list) {
+        list = [];
+        passagesByTag.set(tag, list);
+      }
+      list.push(p.name);
+    }
+    const targets = extractLinksFromText(p.text);
+    links.set(p.name, targets);
+  }
+  const brokenLinks = [];
+  for (const [from, targets] of links) {
+    for (const to of targets) {
+      if (!allNames.has(to)) {
+        brokenLinks.push({ from, to });
+      }
+    }
+  }
+  const deadEnds = [];
+  for (const name of storyPassages) {
+    const targets = links.get(name);
+    if (!targets || targets.length === 0) {
+      deadEnds.push(name);
+    }
+  }
+  const start = story.twine2.start || "Start";
+  const linkedTo = /* @__PURE__ */ new Set();
+  for (const targets of links.values()) {
+    for (const t of targets) {
+      linkedTo.add(t);
+    }
+  }
+  const orphans = [];
+  for (const name of storyPassages) {
+    if (name !== start && !linkedTo.has(name)) {
+      orphans.push(name);
+    }
+  }
+  return {
+    passages,
+    storyPassages,
+    infoPassages,
+    tags: [...tagSet].sort(),
+    passagesByTag,
+    tagsByPassage,
+    links,
+    brokenLinks,
+    deadEnds,
+    orphans,
+    start
+  };
+}
+
+// src/lint.ts
+async function lint(options) {
+  const result = await compile({ ...options, outputMode: "json" });
+  const map = storyInspect(result.story);
+  return {
+    diagnostics: result.diagnostics,
+    stats: result.stats,
+    formatName: result.story.twine2.format,
+    formatVersion: result.story.twine2.formatVersion,
+    start: map.start,
+    passages: map.passages.length,
+    storyPassages: map.storyPassages.length,
+    infoPassages: map.infoPassages.length,
+    brokenLinks: map.brokenLinks,
+    deadEnds: map.deadEnds,
+    orphans: map.orphans
+  };
+}
+function formatLintReport(result) {
+  const lines = [];
+  const formatStr = result.formatName ? `${result.formatName}${result.formatVersion ? " " + result.formatVersion : ""}` : "unknown";
+  lines.push(`Format: ${formatStr}`);
+  lines.push(
+    `Passages: ${result.passages} total (${result.storyPassages} story, ${result.infoPassages} info), ${result.stats.words.toLocaleString()} words, ${result.stats.files.length} files`
+  );
+  lines.push(`Start: ${result.start}`);
+  if (result.brokenLinks.length > 0) {
+    lines.push("");
+    lines.push(`Broken links (${result.brokenLinks.length}):`);
+    for (const link of result.brokenLinks) {
+      lines.push(`  ${link.from} -> ${link.to} (passage "${link.to}" does not exist)`);
+    }
+  }
+  if (result.deadEnds.length > 0) {
+    lines.push("");
+    lines.push(`Dead ends (${result.deadEnds.length}): ${result.deadEnds.join(", ")}`);
+  }
+  if (result.orphans.length > 0) {
+    lines.push("");
+    lines.push(`Orphans (${result.orphans.length}): ${result.orphans.join(", ")}`);
+  }
+  const errors = result.diagnostics.filter((d) => d.level === "error");
+  const warnings = result.diagnostics.filter((d) => d.level === "warning");
+  if (errors.length > 0 || warnings.length > 0) {
+    lines.push("");
+    lines.push(`Diagnostics: ${errors.length} error(s), ${warnings.length} warning(s)`);
+    for (const d of errors) {
+      lines.push(`  error: ${d.message}`);
+    }
+    for (const d of warnings) {
+      lines.push(`  warning: ${d.message}`);
+    }
+  }
+  lines.push("");
+  const hasErrors = errors.length > 0 || result.brokenLinks.length > 0;
+  if (hasErrors) {
+    lines.push("Lint failed.");
+  } else {
+    lines.push("Lint passed.");
+  }
+  return lines.join("\n");
+}
+
 // src/config.ts
 import { readFileSync as readFileSync4, existsSync as existsSync2 } from "fs";
 import { join as join5 } from "path";
@@ -2388,6 +2625,7 @@ var { values, positionals } = parseArgs({
     "archive-twine1": { type: "boolean" },
     "twee2-compat": { type: "boolean" },
     "no-trim": { type: "boolean" },
+    lint: { type: "boolean" },
     test: { type: "boolean", short: "t" },
     watch: { type: "boolean", short: "w" },
     "log-stats": { type: "boolean", short: "l" },
@@ -2424,6 +2662,10 @@ async function main() {
     runInit();
     return;
   }
+  if (positionals[0] === "cache") {
+    runCache(positionals.slice(1));
+    return;
+  }
   let config = null;
   if (!values["no-config"]) {
     if (values.config) {
@@ -2456,6 +2698,27 @@ async function main() {
       tagAliases[pair.slice(0, eq)] = pair.slice(eq + 1);
     }
   }
+  if (values.lint) {
+    const lintResult = await lint({
+      sources,
+      formatId: values.format ?? config?.formatId,
+      startPassage: values.start ?? config?.startPassage,
+      formatPaths: config?.formatPaths,
+      modules: values.module ?? config?.modules,
+      headFile: values.head ?? config?.headFile,
+      trim: values["no-trim"] ? false : config?.trim ?? true,
+      twee2Compat: values["twee2-compat"] ?? config?.twee2Compat ?? false,
+      testMode: values.test ?? config?.testMode ?? false,
+      formatIndices: values["format-index"] ?? config?.formatIndices,
+      formatUrls: values["format-url"] ?? config?.formatUrls,
+      noRemote: values["no-remote"] ?? config?.noRemote ?? false,
+      tagAliases,
+      sourceInfo: values["source-info"] ?? config?.sourceInfo ?? false
+    });
+    console.log(formatLintReport(lintResult));
+    const hasErrors = lintResult.brokenLinks.length > 0 || lintResult.diagnostics.some((d) => d.level === "error");
+    process.exit(hasErrors ? 1 : 0);
+  }
   const compileOptions = {
     sources,
     outputMode,
@@ -2571,6 +2834,63 @@ This is the starting passage. Edit this file to begin writing your story.
   console.log("  src/Start.tw");
   console.log("\nRun: npx @rohal12/twee-ts");
 }
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes}B`;
+  const kb = bytes / 1024;
+  if (kb < 1024) return `${Math.round(kb)}K`;
+  const mb = kb / 1024;
+  return `${mb.toFixed(1)}M`;
+}
+function runCache(args) {
+  const subcommand = args[0];
+  switch (subcommand) {
+    case "list": {
+      const entries = listCachedFormats();
+      if (entries.length === 0) {
+        console.log("No cached formats.");
+        return;
+      }
+      for (const e of entries) {
+        const date = e.modifiedAt.toISOString().slice(0, 10);
+        console.log(`${e.name.padEnd(16)} ${e.version.padEnd(10)} ${formatBytes(e.sizeBytes).padStart(6)}   ${date}`);
+      }
+      return;
+    }
+    case "clear": {
+      const name = args[1];
+      const count = clearCachedFormats(name);
+      if (count === 0) {
+        console.log(name ? `No cached formats matching "${name}".` : "Cache is already empty.");
+      } else {
+        console.log(`Cleared ${count} cached format${count === 1 ? "" : "s"}.`);
+      }
+      return;
+    }
+    case "size": {
+      const { totalBytes, count } = getCacheSize();
+      if (count === 0) {
+        console.log("Cache is empty.");
+      } else {
+        console.log(`Total: ${formatBytes(totalBytes)} (${count} format${count === 1 ? "" : "s"})`);
+      }
+      return;
+    }
+    case "path": {
+      console.log(getCacheDir());
+      return;
+    }
+    default: {
+      console.error(`Usage: twee-ts cache <list|clear|size|path>
+
+  list          List cached formats with name, version, size
+  clear         Delete all cached formats
+  clear <name>  Delete cached formats matching name
+  size          Show total cache size
+  path          Print cache directory path`);
+      process.exit(subcommand ? 1 : 0);
+    }
+  }
+}
 function printUsage() {
   console.log(`twee-ts v${VERSION} \u2014 TypeScript Twee-to-HTML compiler
 
@@ -2588,6 +2908,7 @@ Options:
   --archive-twine1          Output as Twine 1 archive
   --json                    Output as JSON
   --twee2-compat            Enable Twee2 syntax compatibility
+  --lint                    Lint story structure (broken links, dead ends, orphans)
   --no-trim                 Don't trim passage whitespace
   -t, --test                Enable test/debug mode
   -w, --watch               Watch for changes and rebuild
@@ -2603,7 +2924,13 @@ Options:
   -c, --config <file>       Config file path (default: ${CONFIG_FILENAME})
   --no-config               Skip config file loading
   -h, --help                Show this help
-  -v, --version             Show version`);
+  -v, --version             Show version
+
+Subcommands:
+  cache list                List cached remote formats
+  cache clear [name]        Clear cached formats (all or by name)
+  cache size                Show total cache size
+  cache path                Print cache directory path`);
 }
 main().catch((err) => {
   console.error(err instanceof Error ? err.message : String(err));