@tishlang/vite-plugin-tish 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# @tishlang/vite-plugin-tish
+
+Official [Vite](https://vitejs.dev) plugin for [Tish](https://tishlang.com). It compiles each
+`.tish` file directly into Vite's module graph, so editing a module hot-swaps in place (HMR) instead
+of triggering a full page reload, and dev builds carry source maps back to the original `.tish`.
+
+This replaces the common out-of-band shim that ran `tish build` over the whole program and sent
+`{ type: 'full-reload' }` on every change.
+
+## Requirements
+
+- Vite 5 or newer.
+- The `tish` CLI on your `PATH` (from `@tishlang/tish`), or pass `tishPath`.
+- Tish module output (`tish build --target js --format esm`) — the same per-module ESM emit the
+  plugin relies on. See [the JS target docs](https://tishlang.com/docs/reference/js-target).
+
+## Install
+
+```bash
+npm install -D @tishlang/vite-plugin-tish
+```
+
+## Usage
+
+```js
+// vite.config.js
+import { defineConfig } from "vite";
+import tish from "@tishlang/vite-plugin-tish";
+
+export default defineConfig({
+  plugins: [tish()],
+});
+```
+
+Import `.tish` modules as normal ES modules:
+
+```html
+<script type="module" src="/src/main.tish"></script>
+```
+
+```tish
+// src/main.tish
+import { makeCounter } from "./counter.tish"
+
+let next = makeCounter(0)
+console.log(next())
+```
+
+Editing `counter.tish` updates the running app without a full reload, and runtime errors point back
+to the `.tish` source in Vite's overlay and the browser debugger.
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `tishPath` | `string` | `$TISH_PATH` or `tish` | Path to the `tish` binary. |
+| `projectRoot` | `string` | Vite `root` | Root for resolving bare specifiers / `node_modules`. |
+| `mode` | `"hmr" \| "full-reload"` | `"hmr"` | `hmr` hot-swaps modules; `full-reload` reloads the whole page on any `.tish` change. |
+
+### When to use `full-reload`
+
+For apps compiled to `--target bytecode` (the wasm VM owns all engine state), per-module HMR does not
+apply — use `mode: "full-reload"` as the documented fallback.
+
+## How it works
+
+The plugin registers `resolveId` + `load` so each `.tish` import becomes one module in Vite's graph,
+compiled via `tish compile-module --target js --format esm --vite-dev`. Relative `.tish` specifiers
+are preserved so Vite resolves dependencies through the plugin per module; a self-accepting
+`import.meta.hot.accept()` boundary is injected so leaf edits hot-swap. `handleHotUpdate` returns the
+changed module node(s) to Vite for per-module invalidation instead of a full reload.
+
+## License
+
+[PIF](https://payitforwardlicense.com/)

package/index.js

@@ -0,0 +1,96 @@
+// Vite plugin for Tish (#284). Compiles each `.tish` file into Vite's module graph one module at a
+// time via `tish compile-module`, so editing a leaf module hot-swaps without a full page reload —
+// instead of the older out-of-band "compile the whole bundle and full-reload on every change" shim.
+//
+// Dev compiles request a source map (`tish compile-module --source-map`) so Vite's error overlay
+// and the browser debugger resolve back to the original `.tish`.
+
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+
+const TISH_EXT = ".tish";
+
+/**
+ * @param {object} [opts]
+ * @param {string} [opts.tishPath]   Path to the `tish` binary (default: $TISH_PATH or `tish` on PATH).
+ * @param {string} [opts.projectRoot] Root for resolving bare specifiers / node_modules (default: Vite root).
+ * @param {"hmr"|"full-reload"} [opts.mode] `hmr` (default) hot-swaps modules; `full-reload` reloads the
+ *        page on any `.tish` change (the documented fallback for `--target bytecode` apps).
+ */
+export default function tishPlugin(opts = {}) {
+  const tishPath = opts.tishPath ?? process.env.TISH_PATH ?? "tish";
+  const mode = opts.mode ?? "hmr";
+  let projectRoot = opts.projectRoot;
+
+  // Compile a single `.tish` file to one ES module. In `hmr` mode we request a source map and parse
+  // the `{ js, map }` envelope; otherwise we take raw JS on stdout.
+  function compileModule(file) {
+    const args = [
+      "compile-module",
+      file,
+      "--target",
+      "js",
+      "--format",
+      "esm",
+      "--vite-dev",
+    ];
+    args.push(mode === "hmr" ? "--source-map" : "--no-source-map");
+    if (projectRoot) args.push("--project-root", projectRoot);
+    const stdout = execFileSync(tishPath, args, {
+      encoding: "utf8",
+      maxBuffer: 64 * 1024 * 1024,
+    });
+    if (mode === "hmr") {
+      const { js, map } = JSON.parse(stdout);
+      return { code: js, map };
+    }
+    return { code: stdout, map: null };
+  }
+
+  return {
+    name: "vite-plugin-tish",
+    enforce: "pre",
+
+    configResolved(config) {
+      if (!projectRoot) projectRoot = config.root;
+    },
+
+    // Bring `.tish` imports into Vite's module graph: resolve relative `.tish` specifiers to absolute
+    // file paths so Vite addresses each module and can invalidate it individually. Root-relative URLs
+    // (`/src/x.tish`) and bare specifiers are left to Vite's resolver, which maps them to real files.
+    resolveId(source, importer) {
+      if (!source.endsWith(TISH_EXT)) return null;
+      if (source.startsWith(".") && importer) {
+        return path.resolve(path.dirname(importer.split("?")[0]), source);
+      }
+      if (path.isAbsolute(source) && existsSync(source)) {
+        return source;
+      }
+      return null;
+    },
+
+    load(id) {
+      const file = id.split("?")[0];
+      if (!file.endsWith(TISH_EXT)) return null;
+      const { code, map } = compileModule(file);
+      if (mode !== "hmr") return { code, map };
+      // Self-accepting boundary: editing this module re-runs it without reloading the page. Frameworks
+      // (e.g. Lattish) can register their own `import.meta.hot.accept` handlers on top.
+      const withBoundary = `${code}\nif (import.meta.hot) { import.meta.hot.accept(); }\n`;
+      return { code: withBoundary, map };
+    },
+
+    handleHotUpdate(ctx) {
+      const { file, server } = ctx;
+      if (!file.endsWith(TISH_EXT)) return;
+      if (mode === "full-reload") {
+        server.ws.send({ type: "full-reload" });
+        return [];
+      }
+      // Hand Vite the changed module node(s) so it performs per-module HMR rather than a full reload.
+      const mods = server.moduleGraph.getModulesByFile(file);
+      return mods ? [...mods] : undefined;
+    },
+  };
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@tishlang/vite-plugin-tish",
+  "version": "0.1.0",
+  "description": "Vite plugin for Tish: in-graph .tish compilation with HMR and source maps for dev.",
+  "license": "PIF",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tishlang/tish.git",
+    "directory": "npm/vite-plugin-tish"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run"
+  },
+  "files": ["index.js", "README.md"],
+  "peerDependencies": {
+    "vite": ">=5",
+    "@tishlang/tish": "*"
+  },
+  "peerDependenciesMeta": {
+    "@tishlang/tish": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "vite": "^7",
+    "vitest": "^3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": ["tish", "vite", "vite-plugin", "hmr", "lattish"]
+}