@mantaq/inspect 0.0.0 → 0.1.0

package/dist/page-rr9IQ-4k.mjs

@@ -0,0 +1,38 @@
+import { serializeViz, standaloneHtml } from "@mantaq/viz";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { build } from "vite";
+// src/page.ts
+/** The viewer as one classic script, built from `@mantaq/viz/standalone`, plus its stylesheets. */
+async function viewerBundle() {
+	const entry = fileURLToPath(import.meta.resolve("@mantaq/viz/standalone"));
+	const output = await build({
+		configFile: false,
+		logLevel: "silent",
+		build: {
+			write: false,
+			minify: true,
+			cssCodeSplit: false,
+			lib: {
+				entry,
+				formats: ["iife"],
+				name: "MantaqViz",
+				fileName: () => "viz.js"
+			}
+		}
+	});
+	return {
+		script: (Array.isArray(output) ? output : [output]).flatMap((each) => "output" in each ? each.output : []).flatMap((file) => file.type === "chunk" ? [file.code] : []).join("\n"),
+		css: ["@mantaq/viz/viewer.css", "@mantaq/viz/page.css"].map((id) => readFileSync(fileURLToPath(import.meta.resolve(id)), "utf8")).join("\n")
+	};
+}
+/** A self-contained HTML page for `document`: open it from disk, attach it, commit it. */
+async function htmlPage(document, title) {
+	const bundle = await viewerBundle();
+	return standaloneHtml({
+		title,
+		...bundle,
+		document: serializeViz(document)
+	});
+}
+export { htmlPage as t };

package/dist/vite.d.mts

@@ -0,0 +1,11 @@
+import { t as FuzzSettings } from "./inspect-DvQtAcwv.mjs";
+import { Plugin } from "vite";
+export interface MantaqVizOptions {
+  /** Files that export machines: paths or globs, relative to the Vite root. */
+  machines: string | string[];
+  /** Where the page is served. Default `/__mantaq/`. */
+  base?: string;
+  /** `false` = structure only. Default: 500 iterations, so a save redraws quickly. */
+  fuzz?: false | FuzzSettings;
+}
+export declare function mantaqViz(options: MantaqVizOptions): Plugin[];

package/dist/vite.mjs

@@ -0,0 +1,102 @@
+import { c as vizDocument, i as runOf, n as inspectEntry, t as entryId } from "./load-C4rGWmGU.mjs";
+import { UPDATE_EVENT, livePageHtml, serializeViz } from "@mantaq/viz";
+import { dirname, isAbsolute, resolve } from "node:path";
+import { globSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { searchForWorkspaceRoot } from "vite";
+// src/vite.ts
+/**
+* Vite plugin: a live page of your machines on your own dev server.
+*
+*   // vite.config.ts
+*   import { mantaqViz } from "@mantaq/inspect/vite";
+*   export default defineConfig({ plugins: [mantaqViz({ machines: "src/**\/*.machine.ts" })] });
+*
+* Open `/__mantaq/` while the dev server runs. Machines load through your own
+* Vite config (aliases, tsconfig paths), are inspected on the server, and the
+* page redraws, keeping the walk, when you save a file.
+*/
+const STYLESHEETS = ["@mantaq/viz/viewer.css", "@mantaq/viz/page.css"];
+const DEV_ITERATIONS = 500;
+function machineFiles(root, patterns) {
+	const files = patterns.flatMap((pattern) => globSync(pattern, { cwd: root }));
+	return [...new Set(files.map((file) => isAbsolute(file) ? file : resolve(root, file)))].sort();
+}
+async function documentText(server, context) {
+	const results = [];
+	for (const file of context.files) {
+		const run = runOf(await server.ssrLoadModule(entryId(file)));
+		results.push(run === null ? {
+			machines: [],
+			warnings: [`${file}: could not load the inspector`]
+		} : await run({ fuzz: context.fuzz }));
+	}
+	return {
+		text: serializeViz(vizDocument(results.flatMap((result) => result.machines))),
+		warnings: results.flatMap((result) => result.warnings)
+	};
+}
+function mantaqViz(options) {
+	const base = (options.base ?? "/__mantaq/").replace(/\/?$/, "/");
+	const patterns = Array.isArray(options.machines) ? options.machines : [options.machines];
+	const fuzz = options.fuzz ?? { iterations: DEV_ITERATIONS };
+	const live = fileURLToPath(import.meta.resolve("@mantaq/viz/live"));
+	return [inspectEntry(), {
+		name: "mantaq-viz",
+		apply: "serve",
+		config: (config) => ({ server: { fs: { allow: [searchForWorkspaceRoot(config.root ?? process.cwd()), dirname(dirname(live))] } } }),
+		configureServer(server) {
+			let cached = null;
+			const build = async () => {
+				const { text, warnings } = await documentText(server, {
+					files: machineFiles(server.config.root, patterns),
+					fuzz
+				});
+				for (const warning of warnings) server.config.logger.warn(`[mantaq-viz] ${warning}`);
+				return text;
+			};
+			server.watcher.on("all", (_event, path) => {
+				if (!/\.[cm]?[jt]sx?$/.test(path)) return;
+				cached = null;
+				server.environments.ssr.moduleGraph.invalidateAll();
+				server.ws.send({
+					type: "custom",
+					event: UPDATE_EVENT
+				});
+			});
+			server.middlewares.use((request, response, next) => {
+				const path = request.url?.split("?")[0];
+				if (path === `${base}viz.json`) {
+					cached ??= build();
+					cached.then((text) => {
+						response.setHeader("content-type", "application/json");
+						response.end(text);
+					}, (error) => {
+						cached = null;
+						response.statusCode = 500;
+						response.end(String(error));
+					});
+					return;
+				}
+				if (path !== base && path !== base.slice(0, -1)) {
+					next();
+					return;
+				}
+				const html = livePageHtml({
+					title: "mantaq viz",
+					source: `${base}viz.json`,
+					entry: `/@fs${live}`,
+					css: STYLESHEETS.map((id) => readFileSync(fileURLToPath(import.meta.resolve(id)), "utf8")).join("\n")
+				});
+				server.transformIndexHtml(request.url ?? base, html).then((page) => {
+					response.setHeader("content-type", "text/html");
+					response.end(page);
+				});
+			});
+			server.httpServer?.once("listening", () => {
+				server.config.logger.info(`  mantaq viz: ${base}`);
+			});
+		}
+	}];
+}
+export { mantaqViz };

package/package.json

@@ -1,7 +1,53 @@
 {
   "name": "@mantaq/inspect",
-  "version": "0.0.0",
-  "description": "Placeholder to enable npm trusted publishing.",
-  "repository": { "type": "git", "url": "git+https://github.com/AndersCan/mantaq.git" },
-  "license": "MIT"
-}
+  "version": "0.1.0",
+  "description": "Turn a Mantaq machine into a viz document: structure, handler explanations (AST), fuzz and test coverage. CLI and Vite plugin included.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AndersCan/mantaq",
+    "directory": "packages/inspect"
+  },
+  "bin": {
+    "mantaq-inspect": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./vite": "./dist/vite.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "typescript": "6.0.3",
+    "@mantaq/core": "0.5.0",
+    "@mantaq/pbt": "0.0.3",
+    "@mantaq/traversal": "0.3.0",
+    "@mantaq/utils": "0.0.4",
+    "@mantaq/viz": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "happy-dom": "^21.0.4",
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0",
+    "vite-plus": "1.4.0",
+    "@mantaq/sugar": "2.0.0"
+  },
+  "peerDependencies": {
+    "vite": "*"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check",
+    "viz:export": "node src/examples-cli.ts export",
+    "viz:compare": "node src/examples-cli.ts compare"
+  }
+}