@rohal12/twee-ts 1.8.0 → 1.10.0

package/dist/plugins/rollup.js

@@ -1,6 +1,6 @@
 import {
   compile
-} from "../chunk-N2OR5KHL.js";
+} from "../chunk-FSZ5FD3P.js";
 
 // src/plugins/rollup.ts
 function tweeTsPlugin(options) {

package/dist/plugins/vite.d.ts

@@ -2,7 +2,7 @@ import { C as CompileOptions } from '../types-BbEu2Szm.js';
 
 /**
  * Ready-made Vite plugin for twee-ts.
- * Watches .tw files and emits compiled HTML.
+ * Watches .tw files and emits compiled HTML via incremental compilation.
  */
 
 interface TweeTsVitePluginOptions {
@@ -34,7 +34,14 @@ declare function tweeTsPlugin(options: TweeTsVitePluginOptions): {
                 type: string;
             }) => void;
         };
-    }): void;
+        middlewares: {
+            use: (fn: (req: {
+                url?: string;
+            }, res: {
+                end: (data: string) => void;
+            }, next: () => void) => void) => void;
+        };
+    }): Promise<void>;
     handleHotUpdate(ctx: {
         file: string;
         server: {
@@ -44,7 +51,7 @@ declare function tweeTsPlugin(options: TweeTsVitePluginOptions): {
                 }) => void;
             };
         };
-    }): void;
+    }): Promise<void>;
 };
 
 export { type TweeTsVitePluginOptions, tweeTsPlugin };

package/dist/plugins/vite.js

@@ -1,42 +1,66 @@
 import {
-  compile
-} from "../chunk-N2OR5KHL.js";
+  compileIncremental
+} from "../chunk-FSZ5FD3P.js";
 
 // src/plugins/vite.ts
+function isTweeFile(file) {
+  return file.endsWith(".tw") || file.endsWith(".twee");
+}
+function getCompileOptions(options) {
+  return {
+    sources: options.sources,
+    formatId: options.format,
+    ...options.compileOptions
+  };
+}
+function logDiagnostics(diagnostics) {
+  for (const d of diagnostics) {
+    if (d.level === "warning") {
+      console.warn(`[twee-ts] ${d.message}`);
+    } else {
+      console.error(`[twee-ts] ${d.message}`);
+    }
+  }
+}
 function tweeTsPlugin(options) {
   const outputFilename = options.outputFilename ?? "index.html";
+  const cache = /* @__PURE__ */ new Map();
+  let compiledHtml = "";
   return {
     name: "twee-ts",
     async buildStart() {
     },
     async generateBundle() {
-      const result = await compile({
-        sources: options.sources,
-        formatId: options.format,
-        ...options.compileOptions
-      });
+      const result = await compileIncremental(getCompileOptions(options), cache);
       this.emitFile({
         type: "asset",
         fileName: outputFilename,
         source: result.output
       });
-      for (const d of result.diagnostics) {
-        if (d.level === "warning") {
-          console.warn(`[twee-ts] ${d.message}`);
-        } else {
-          console.error(`[twee-ts] ${d.message}`);
-        }
-      }
+      logDiagnostics(result.diagnostics);
     },
-    configureServer(server) {
+    async configureServer(server) {
       for (const source of options.sources) {
         server.watcher.add(source);
       }
+      const result = await compileIncremental(getCompileOptions(options), cache);
+      compiledHtml = result.output;
+      logDiagnostics(result.diagnostics);
+      const servePath = outputFilename === "index.html" ? "/" : `/${outputFilename}`;
+      server.middlewares.use((req, res, next) => {
+        if (req.url === servePath || servePath === "/" && req.url === "/index.html") {
+          res.end(compiledHtml);
+          return;
+        }
+        next();
+      });
     },
-    handleHotUpdate(ctx) {
-      if (ctx.file.endsWith(".tw") || ctx.file.endsWith(".twee")) {
-        ctx.server.ws.send({ type: "full-reload" });
-      }
+    async handleHotUpdate(ctx) {
+      if (!isTweeFile(ctx.file)) return;
+      const result = await compileIncremental(getCompileOptions(options), cache, /* @__PURE__ */ new Set([ctx.file]));
+      compiledHtml = result.output;
+      logDiagnostics(result.diagnostics);
+      ctx.server.ws.send({ type: "full-reload" });
     }
   };
 }

package/dist/plugins/vite.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/plugins/vite.ts"],"sourcesContent":["/**\n * Ready-made Vite plugin for twee-ts.\n * Watches .tw files and emits compiled HTML.\n */\nimport type { CompileOptions } from '../types.js';\nimport { compile } from '../compiler.js';\n\nexport interface TweeTsVitePluginOptions {\n  /** Source directories/files to compile. */\n  sources: string[];\n  /** Story format ID. */\n  format?: string;\n  /** Output filename in build output. Default: 'index.html'. */\n  outputFilename?: string;\n  /** Additional compile options. */\n  compileOptions?: Partial<CompileOptions>;\n}\n\nexport function tweeTsPlugin(options: TweeTsVitePluginOptions) {\n  const outputFilename = options.outputFilename ?? 'index.html';\n\n  return {\n    name: 'twee-ts',\n\n    async buildStart() {\n      // No-op: compilation happens in generateBundle\n    },\n\n    async generateBundle(this: { emitFile: (opts: { type: string; fileName: string; source: string }) => void }) {\n      const result = await compile({\n        sources: options.sources,\n        formatId: options.format,\n        ...options.compileOptions,\n      });\n\n      this.emitFile({\n        type: 'asset',\n        fileName: outputFilename,\n        source: result.output,\n      });\n\n      for (const d of result.diagnostics) {\n        if (d.level === 'warning') {\n          console.warn(`[twee-ts] ${d.message}`);\n        } else {\n          console.error(`[twee-ts] ${d.message}`);\n        }\n      }\n    },\n\n    configureServer(server: {\n      watcher: { add: (path: string) => void };\n      ws: { send: (data: { type: string }) => void };\n    }) {\n      for (const source of options.sources) {\n        server.watcher.add(source);\n      }\n    },\n\n    handleHotUpdate(ctx: { file: string; server: { ws: { send: (data: { type: string }) => void } } }) {\n      if (ctx.file.endsWith('.tw') || ctx.file.endsWith('.twee')) {\n        ctx.server.ws.send({ type: 'full-reload' });\n      }\n    },\n  };\n}\n"],"mappings":";;;;;AAkBO,SAAS,aAAa,SAAkC;AAC7D,QAAM,iBAAiB,QAAQ,kBAAkB;AAEjD,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,MAAM,aAAa;AAAA,IAEnB;AAAA,IAEA,MAAM,iBAAuG;AAC3G,YAAM,SAAS,MAAM,QAAQ;AAAA,QAC3B,SAAS,QAAQ;AAAA,QACjB,UAAU,QAAQ;AAAA,QAClB,GAAG,QAAQ;AAAA,MACb,CAAC;AAED,WAAK,SAAS;AAAA,QACZ,MAAM;AAAA,QACN,UAAU;AAAA,QACV,QAAQ,OAAO;AAAA,MACjB,CAAC;AAED,iBAAW,KAAK,OAAO,aAAa;AAClC,YAAI,EAAE,UAAU,WAAW;AACzB,kBAAQ,KAAK,aAAa,EAAE,OAAO,EAAE;AAAA,QACvC,OAAO;AACL,kBAAQ,MAAM,aAAa,EAAE,OAAO,EAAE;AAAA,QACxC;AAAA,MACF;AAAA,IACF;AAAA,IAEA,gBAAgB,QAGb;AACD,iBAAW,UAAU,QAAQ,SAAS;AACpC,eAAO,QAAQ,IAAI,MAAM;AAAA,MAC3B;AAAA,IACF;AAAA,IAEA,gBAAgB,KAAmF;AACjG,UAAI,IAAI,KAAK,SAAS,KAAK,KAAK,IAAI,KAAK,SAAS,OAAO,GAAG;AAC1D,YAAI,OAAO,GAAG,KAAK,EAAE,MAAM,cAAc,CAAC;AAAA,MAC5C;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/plugins/vite.ts"],"sourcesContent":["/**\n * Ready-made Vite plugin for twee-ts.\n * Watches .tw files and emits compiled HTML via incremental compilation.\n */\nimport type { CompileOptions, FileCacheEntry } from '../types.js';\nimport { compileIncremental } from '../compiler.js';\n\nexport interface TweeTsVitePluginOptions {\n  /** Source directories/files to compile. */\n  sources: string[];\n  /** Story format ID. */\n  format?: string;\n  /** Output filename in build output. Default: 'index.html'. */\n  outputFilename?: string;\n  /** Additional compile options. */\n  compileOptions?: Partial<CompileOptions>;\n}\n\nfunction isTweeFile(file: string): boolean {\n  return file.endsWith('.tw') || file.endsWith('.twee');\n}\n\nfunction getCompileOptions(options: TweeTsVitePluginOptions): CompileOptions {\n  return {\n    sources: options.sources,\n    formatId: options.format,\n    ...options.compileOptions,\n  };\n}\n\nfunction logDiagnostics(diagnostics: ReadonlyArray<{ level: string; message: string }>) {\n  for (const d of diagnostics) {\n    if (d.level === 'warning') {\n      console.warn(`[twee-ts] ${d.message}`);\n    } else {\n      console.error(`[twee-ts] ${d.message}`);\n    }\n  }\n}\n\nexport function tweeTsPlugin(options: TweeTsVitePluginOptions) {\n  const outputFilename = options.outputFilename ?? 'index.html';\n  const cache = new Map<string, FileCacheEntry>();\n  let compiledHtml = '';\n\n  return {\n    name: 'twee-ts',\n\n    async buildStart() {\n      // No-op: compilation happens in generateBundle (build) or configureServer (dev)\n    },\n\n    async generateBundle(this: { emitFile: (opts: { type: string; fileName: string; source: string }) => void }) {\n      const result = await compileIncremental(getCompileOptions(options), cache);\n\n      this.emitFile({\n        type: 'asset',\n        fileName: outputFilename,\n        source: result.output,\n      });\n\n      logDiagnostics(result.diagnostics);\n    },\n\n    async configureServer(server: {\n      watcher: { add: (path: string) => void };\n      ws: { send: (data: { type: string }) => void };\n      middlewares: {\n        use: (fn: (req: { url?: string }, res: { end: (data: string) => void }, next: () => void) => void) => void;\n      };\n    }) {\n      for (const source of options.sources) {\n        server.watcher.add(source);\n      }\n\n      // Initial compile\n      const result = await compileIncremental(getCompileOptions(options), cache);\n      compiledHtml = result.output;\n      logDiagnostics(result.diagnostics);\n\n      // Serve compiled HTML for requests to / or the output filename\n      const servePath = outputFilename === 'index.html' ? '/' : `/${outputFilename}`;\n      server.middlewares.use((req, res, next) => {\n        if (req.url === servePath || (servePath === '/' && req.url === '/index.html')) {\n          res.end(compiledHtml);\n          return;\n        }\n        next();\n      });\n    },\n\n    async handleHotUpdate(ctx: { file: string; server: { ws: { send: (data: { type: string }) => void } } }) {\n      if (!isTweeFile(ctx.file)) return;\n\n      const result = await compileIncremental(getCompileOptions(options), cache, new Set([ctx.file]));\n      compiledHtml = result.output;\n      logDiagnostics(result.diagnostics);\n\n      ctx.server.ws.send({ type: 'full-reload' });\n    },\n  };\n}\n"],"mappings":";;;;;AAkBA,SAAS,WAAW,MAAuB;AACzC,SAAO,KAAK,SAAS,KAAK,KAAK,KAAK,SAAS,OAAO;AACtD;AAEA,SAAS,kBAAkB,SAAkD;AAC3E,SAAO;AAAA,IACL,SAAS,QAAQ;AAAA,IACjB,UAAU,QAAQ;AAAA,IAClB,GAAG,QAAQ;AAAA,EACb;AACF;AAEA,SAAS,eAAe,aAAgE;AACtF,aAAW,KAAK,aAAa;AAC3B,QAAI,EAAE,UAAU,WAAW;AACzB,cAAQ,KAAK,aAAa,EAAE,OAAO,EAAE;AAAA,IACvC,OAAO;AACL,cAAQ,MAAM,aAAa,EAAE,OAAO,EAAE;AAAA,IACxC;AAAA,EACF;AACF;AAEO,SAAS,aAAa,SAAkC;AAC7D,QAAM,iBAAiB,QAAQ,kBAAkB;AACjD,QAAM,QAAQ,oBAAI,IAA4B;AAC9C,MAAI,eAAe;AAEnB,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,MAAM,aAAa;AAAA,IAEnB;AAAA,IAEA,MAAM,iBAAuG;AAC3G,YAAM,SAAS,MAAM,mBAAmB,kBAAkB,OAAO,GAAG,KAAK;AAEzE,WAAK,SAAS;AAAA,QACZ,MAAM;AAAA,QACN,UAAU;AAAA,QACV,QAAQ,OAAO;AAAA,MACjB,CAAC;AAED,qBAAe,OAAO,WAAW;AAAA,IACnC;AAAA,IAEA,MAAM,gBAAgB,QAMnB;AACD,iBAAW,UAAU,QAAQ,SAAS;AACpC,eAAO,QAAQ,IAAI,MAAM;AAAA,MAC3B;AAGA,YAAM,SAAS,MAAM,mBAAmB,kBAAkB,OAAO,GAAG,KAAK;AACzE,qBAAe,OAAO;AACtB,qBAAe,OAAO,WAAW;AAGjC,YAAM,YAAY,mBAAmB,eAAe,MAAM,IAAI,cAAc;AAC5E,aAAO,YAAY,IAAI,CAAC,KAAK,KAAK,SAAS;AACzC,YAAI,IAAI,QAAQ,aAAc,cAAc,OAAO,IAAI,QAAQ,eAAgB;AAC7E,cAAI,IAAI,YAAY;AACpB;AAAA,QACF;AACA,aAAK;AAAA,MACP,CAAC;AAAA,IACH;AAAA,IAEA,MAAM,gBAAgB,KAAmF;AACvG,UAAI,CAAC,WAAW,IAAI,IAAI,EAAG;AAE3B,YAAM,SAAS,MAAM,mBAAmB,kBAAkB,OAAO,GAAG,OAAO,oBAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;AAC9F,qBAAe,OAAO;AACtB,qBAAe,OAAO,WAAW;AAEjC,UAAI,OAAO,GAAG,KAAK,EAAE,MAAM,cAAc,CAAC;AAAA,IAC5C;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rohal12/twee-ts",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "description": "TypeScript Twee-to-HTML compiler — a complete reimplementation of Tweego",
   "type": "module",
   "license": "Unlicense",
@@ -43,11 +43,13 @@
     "twee-ts": "./dist/bin/twee-ts.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "schemas"
   ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "pnpm run typecheck && pnpm test && pnpm run build",
@@ -63,6 +65,7 @@
   },
   "devDependencies": {
     "@types/node": "^25.3.3",
+    "@vitest/coverage-v8": "^4.0.18",
     "prettier": "^3.8.1",
     "tsup": "^8.4.0",
     "tsx": "^4.21.0",

package/schemas/twee-ts.config.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://unpkg.com/@rohal12/twee-ts/schemas/twee-ts.config.schema.json",
+  "title": "twee-ts Configuration",
+  "description": "Configuration file for twee-ts, a TypeScript Twee-to-HTML compiler.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference for editor support."
+    },
+    "sources": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Files or directories to compile."
+    },
+    "output": {
+      "type": "string",
+      "description": "Output file path."
+    },
+    "outputMode": {
+      "type": "string",
+      "enum": ["html", "twee3", "twee1", "twine2-archive", "twine1-archive", "json"],
+      "default": "html",
+      "description": "Output mode."
+    },
+    "formatId": {
+      "type": "string",
+      "description": "Story format directory ID (e.g. 'sugarcube-2')."
+    },
+    "startPassage": {
+      "type": "string",
+      "description": "Name of the starting passage.",
+      "default": "Start"
+    },
+    "formatPaths": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Extra directories to search for story formats."
+    },
+    "formatIndices": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "URLs to SFA-compatible index.json files for remote format lookup."
+    },
+    "formatUrls": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Direct URLs to format.js files."
+    },
+    "useTweegoPath": {
+      "type": "boolean",
+      "default": true,
+      "description": "Also search TWEEGO_PATH env for formats."
+    },
+    "modules": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Module files to inject into <head>."
+    },
+    "headFile": {
+      "type": "string",
+      "description": "Raw HTML file to append to <head>."
+    },
+    "trim": {
+      "type": "boolean",
+      "default": true,
+      "description": "Trim passage whitespace."
+    },
+    "twee2Compat": {
+      "type": "boolean",
+      "default": false,
+      "description": "Twee2 compatibility mode."
+    },
+    "testMode": {
+      "type": "boolean",
+      "default": false,
+      "description": "Enable debug/test mode option."
+    },
+    "noRemote": {
+      "type": "boolean",
+      "default": false,
+      "description": "Disable remote format fetching."
+    },
+    "tagAliases": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Map alias tags to canonical special tags (e.g. { \"library\": \"script\" })."
+    },
+    "sourceInfo": {
+      "type": "boolean",
+      "default": false,
+      "description": "Emit source file and line as data- attributes on passage elements."
+    }
+  }
+}