@rohal12/twee-ts 1.6.0 → 1.8.0

package/dist/index.cjs

@@ -24,15 +24,20 @@ __export(src_exports, {
   TweeLexer: () => TweeLexer,
   TweeTsError: () => TweeTsError,
   applyTagAliases: () => applyTagAliases,
+  clearCachedFormats: () => clearCachedFormats,
   compile: () => compile,
   compileToFile: () => compileToFile,
   discoverCachedFormats: () => discoverCachedFormats,
   discoverFormats: () => discoverFormats,
   fetchAndCacheFormat: () => fetchAndCacheFormat,
   fetchDirectFormat: () => fetchDirectFormat,
+  formatLintReport: () => formatLintReport,
   generateIFID: () => generateIFID,
   getCacheDir: () => getCacheDir,
+  getCacheSize: () => getCacheSize,
   getFormatSearchDirs: () => getFormatSearchDirs,
+  lint: () => lint,
+  listCachedFormats: () => listCachedFormats,
   loadConfig: () => loadConfig,
   loadConfigFile: () => loadConfigFile,
   parseFormatJSON: () => parseFormatJSON,
@@ -2135,6 +2140,75 @@ function discoverCachedFormats() {
   }
   return formats;
 }
+function listCachedFormats() {
+  const cacheDir = getCacheDir();
+  const entries = [];
+  try {
+    if (!(0, import_node_fs6.existsSync)(cacheDir)) return entries;
+  } catch {
+    return entries;
+  }
+  let names;
+  try {
+    names = (0, import_node_fs6.readdirSync)(cacheDir);
+  } catch {
+    return entries;
+  }
+  for (const name of names) {
+    const nameDir = (0, import_node_path7.join)(cacheDir, name);
+    try {
+      if (!(0, import_node_fs6.statSync)(nameDir).isDirectory()) continue;
+    } catch {
+      continue;
+    }
+    let versions;
+    try {
+      versions = (0, import_node_fs6.readdirSync)(nameDir);
+    } catch {
+      continue;
+    }
+    for (const version of versions) {
+      const formatPath = (0, import_node_path7.join)(nameDir, version, "format.js");
+      try {
+        const stat = (0, import_node_fs6.statSync)(formatPath);
+        entries.push({
+          name,
+          version,
+          sizeBytes: stat.size,
+          modifiedAt: stat.mtime
+        });
+      } catch {
+      }
+    }
+  }
+  return entries;
+}
+function clearCachedFormats(name) {
+  const cacheDir = getCacheDir();
+  if (!(0, import_node_fs6.existsSync)(cacheDir)) return 0;
+  if (!name) {
+    const entries = listCachedFormats();
+    const count2 = entries.length;
+    (0, import_node_fs6.rmSync)(cacheDir, { recursive: true, force: true });
+    return count2;
+  }
+  const nameDir = (0, import_node_path7.join)(cacheDir, name);
+  if (!(0, import_node_fs6.existsSync)(nameDir)) return 0;
+  let versions;
+  try {
+    versions = (0, import_node_fs6.readdirSync)(nameDir);
+  } catch {
+    return 0;
+  }
+  const count = versions.length;
+  (0, import_node_fs6.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";
@@ -2437,6 +2511,69 @@ function storyInspect(story) {
   };
 }
 
+// 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
 var import_node_fs8 = require("fs");
 var import_node_path8 = require("path");
@@ -2543,15 +2680,20 @@ function scaffoldConfig() {
   TweeLexer,
   TweeTsError,
   applyTagAliases,
+  clearCachedFormats,
   compile,
   compileToFile,
   discoverCachedFormats,
   discoverFormats,
   fetchAndCacheFormat,
   fetchDirectFormat,
+  formatLintReport,
   generateIFID,
   getCacheDir,
+  getCacheSize,
   getFormatSearchDirs,
+  lint,
+  listCachedFormats,
   loadConfig,
   loadConfigFile,
   parseFormatJSON,