@mantaq/inspect 0.3.0 → 0.5.0

package/dist/cli.mjs

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-import { a as targetsSource, d as vizDocument, o as inlineConfig, r as TARGETS_RESOLVED, s as inspectFile } from "./vite-BBW0CmYr.mjs";
-import { t as htmlPage } from "./page-CK7-IsLJ.mjs";
-import { serializeViz } from "@mantaq/viz";
-import { Either } from "@mantaq/utils";
-import { basename, resolve } from "node:path";
-import { SEED_ENV, parseSeed } from "@mantaq/pbt";
-import { writeFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { build } from "vite";
-import { spawn } from "node:child_process";
-import { parseArgs } from "node:util";
-// src/live-html.ts
-/**
-* The live page as one classic script: the viewer, the driver and every
-* exported factory of `files`, built with the project's Vite config.
-*/
-async function liveBundle(files, load) {
-	const entry = fileURLToPath(import.meta.resolve(import.meta.url.endsWith(".ts") ? "./live-embedded.ts" : "./live-embedded.mjs"));
-	const targets = {
-		name: "mantaq-live-targets",
-		resolveId: (id) => id === "virtual:mantaq/targets" ? TARGETS_RESOLVED : null,
-		load: (id) => id === "\0virtual:mantaq/targets" ? targetsSource(files) : null
-	};
-	const inline = await inlineConfig(load);
-	const output = await build({
-		...inline,
-		logLevel: "silent",
-		plugins: [...inline.plugins ?? [], targets],
-		build: {
-			write: false,
-			minify: true,
-			cssCodeSplit: false,
-			lib: {
-				entry,
-				formats: ["iife"],
-				name: "MantaqLive",
-				fileName: () => "live.js"
-			}
-		}
-	});
-	return (Array.isArray(output) ? output : [output]).flatMap((each) => "output" in each ? each.output : []).flatMap((file) => file.type === "chunk" ? [file.code] : []).join("\n");
-}
-// src/cli.ts
-/**
-* mantaq-inspect: draw the machines a file exports.
-*
-*   mantaq-inspect <file.ts>... [--out FILE] [--json] [--live] [--no-fuzz] [--iterations N] [--config FILE]
-*                  [--mode MODE] [--no-open] [--check]
-*
-* Finds every exported actor or actor factory from the file's types, reads
-* handler explanations and sample payloads from the source, fuzzes each
-* machine that runs on a VirtualClock, and writes one self-contained HTML page
-* (default `mantaq-viz.html`) that opens without a server. `--json` writes the
-* viz document instead. `--live` bundles the machine files into the page, so its
-* steps run the real actors (factories on a VirtualClock) with no server. `--config` loads the files with that Vite config (env,
-* aliases, plugins) and `--mode` picks its mode. `--check` exits 1 if any warning was printed or
-* fuzzing found a handler error (each printed as `error:`). Seed: MANTAQ_SEED (default from @mantaq/pbt).
-*/
-const USAGE = "usage: mantaq-inspect <file.ts>... [--out FILE] [--json] [--live] [--no-fuzz] [--iterations N] [--config FILE] [--mode MODE] [--no-open] [--check]\n";
-function loadOptions(config, mode) {
-	return {
-		...config === void 0 ? {} : { config: resolve(config) },
-		...mode === void 0 ? {} : { mode }
-	};
-}
-function fuzzSettings(iterationsArg, off) {
-	const iterations = Number(iterationsArg ?? 2e3);
-	if (!Number.isInteger(iterations) || iterations < 0) return Either.left("bad --iterations");
-	const seed = parseSeed(process.env[SEED_ENV]);
-	if (Either.isLeft(seed)) return Either.left(seed[0].message);
-	const settings = off ? false : {
-		seed: seed[1],
-		iterations
-	};
-	return Either.right(settings);
-}
-function parse() {
-	const parsed = Either.from(() => parseArgs({
-		allowPositionals: true,
-		options: {
-			out: { type: "string" },
-			json: { type: "boolean" },
-			live: { type: "boolean" },
-			iterations: { type: "string" },
-			config: { type: "string" },
-			mode: { type: "string" },
-			"no-fuzz": { type: "boolean" },
-			"no-open": { type: "boolean" },
-			check: { type: "boolean" }
-		}
-	}));
-	if (Either.isLeft(parsed)) return Either.left(String(parsed[0]));
-	const { positionals, values } = parsed[1];
-	if (positionals.length === 0) return Either.left("no file given");
-	const json = values.json === true;
-	const live = values.live === true;
-	if (live && json) return Either.left("--live and --json cannot be combined");
-	const fuzz = fuzzSettings(values.iterations, values["no-fuzz"] === true);
-	if (Either.isLeft(fuzz)) return Either.left(fuzz[0]);
-	return Either.right({
-		files: positionals.map((file) => resolve(file)),
-		out: resolve(values.out ?? (json ? "mantaq-viz.json" : "mantaq-viz.html")),
-		json,
-		live,
-		fuzz: fuzz[1],
-		check: values.check === true,
-		load: loadOptions(values.config, values.mode),
-		open: values["no-open"] !== true && !json && process.stdout.isTTY === true
-	});
-}
-function openInBrowser(path) {
-	const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "explorer" : "xdg-open";
-	spawn(command, [path], {
-		stdio: "ignore",
-		detached: true
-	}).on("error", () => {}).unref();
-}
-function checkFails(results, machines) {
-	const errors = machines.flatMap((machine) => (machine.fuzz?.errors ?? []).map((error) => `${machine.id}: ${error.from} -${error.event}-> ${error.message}`));
-	for (const error of errors) process.stderr.write(`error: ${error}\n`);
-	return errors.length > 0 || results.some((result) => result.warnings.length > 0);
-}
-async function main() {
-	const options = parse();
-	if (Either.isLeft(options)) {
-		process.stderr.write(`${options[0]}\n${USAGE}`);
-		process.exitCode = 1;
-		return;
-	}
-	const { files, out, json, live, fuzz, open, check, load } = options[1];
-	const results = [];
-	for (const file of files) results.push(await inspectFile(file, { fuzz }, load));
-	for (const warning of results.flatMap((result) => result.warnings)) process.stderr.write(`warning: ${warning}\n`);
-	const failed = results.some((result) => result.failed);
-	if (failed) process.exitCode = 1;
-	const machines = results.flatMap((result) => result.machines);
-	if (check && checkFails(results, machines)) process.exitCode = 1;
-	if (machines.length === 0) {
-		if (!failed) process.stderr.write("no machines found\n");
-		process.exitCode = 1;
-		return;
-	}
-	const document = vizDocument(machines);
-	const title = `${files.map((file) => basename(file)).join(", ")} · mantaq viz`;
-	const liveScript = live ? await liveBundle(files, load) : void 0;
-	writeFileSync(out, json ? serializeViz(document) : await htmlPage(document, title, liveScript));
-	process.stdout.write(`wrote ${out} (${machines.map((machine) => machine.id).join(", ")})\n`);
-	if (open) openInBrowser(out);
-}
-main();
-export {};

package/dist/live-embedded.d.mts

@@ -1 +0,0 @@
-export {}

package/dist/live-embedded.mjs

@@ -1,16 +0,0 @@
-import { t as mountDriven } from "./live-page-DEDl_Nio.mjs";
-import { DOCUMENT_ELEMENT_ID } from "@mantaq/viz";
-import { targets } from "virtual:mantaq/targets";
-// src/live-embedded.ts
-/**
-* Entry of the standalone live page `mantaq-inspect --live` writes: the viz
-* document sits in the page, the machines are bundled in, nothing is fetched.
-*/
-const root = document.querySelector("#app");
-const text = document.getElementById(DOCUMENT_ELEMENT_ID)?.textContent;
-if (root && text) mountDriven(root, {
-	source: "this page",
-	text,
-	targets
-});
-export {};

package/dist/live-page-DEDl_Nio.mjs

@@ -1,85 +0,0 @@
-import { createDriver } from "./drive.mjs";
-import { parseViz } from "@mantaq/viz";
-import { Either } from "@mantaq/utils";
-import { mountViewer, showIssues } from "@mantaq/viz/viewer";
-import { linkOptions } from "@mantaq/viz/page";
-// src/live-page.ts
-/**
-* The live page of the Vite plugin: the served document, with each machine
-* that has a target running for real behind the viewer. The walk lives in the
-* address bar (`?machine=&step=`), so a redraw after a save replays it on the
-* new code.
-*/
-/** A document holding only `machine`, so the viewer shows the machine its driver runs. */
-function only(viz, machine) {
-	const chosen = viz.machines.find((each) => each.id === machine) ?? viz.machines[0];
-	return {
-		...viz,
-		machines: chosen === void 0 ? [] : [chosen]
-	};
-}
-/** Mount the document at `text`; machines with a target run live, the rest stay static walks. */
-function mountDriven(root, context) {
-	const parsed = parseViz(context.text);
-	if (Either.isLeft(parsed)) {
-		showIssues(root, {
-			source: context.source,
-			issues: parsed[0]
-		});
-		return;
-	}
-	const options = linkOptions();
-	const viz = parsed[1];
-	const shown = only(viz, options.machine ?? null);
-	const id = shown.machines[0]?.id ?? "";
-	const target = context.targets[id];
-	const create = target !== void 0 && typeof Reflect.get(target().clock, "advance") === "function" ? target : void 0;
-	const picker = viz.machines.length > 1;
-	const select = (machine) => {
-		const next = new URLSearchParams(location.search);
-		next.set("machine", machine);
-		next.delete("step");
-		history.replaceState(null, "", `?${next.toString()}`);
-		mountDriven(root, context);
-	};
-	const doc = root.ownerDocument;
-	const bar = doc.createElement("nav");
-	bar.className = "machines";
-	if (picker) for (const machine of viz.machines) {
-		const button = doc.createElement("button");
-		button.type = "button";
-		button.textContent = machine.id;
-		button.disabled = machine.id === id;
-		button.addEventListener("click", () => select(machine.id));
-		bar.append(button);
-	}
-	const viewer = doc.createElement("div");
-	root.replaceChildren(...picker ? [bar] : [], viewer);
-	mountViewer(viewer, shown, {
-		...options,
-		...create === void 0 ? {} : { driver: createDriver({
-			id,
-			create
-		}) }
-	});
-}
-/** Fetch the document from `source` and mount it; call again to redraw, keeping the walk. */
-async function mountLiveDriven(root, context) {
-	const response = await fetch(context.source).catch(() => null);
-	if (response === null || !response.ok) {
-		const status = response === null ? "network error" : `HTTP ${response.status}`;
-		showIssues(root, {
-			source: context.source,
-			issues: [{
-				path: "$",
-				message: status
-			}]
-		});
-		return;
-	}
-	mountDriven(root, {
-		...context,
-		text: await response.text()
-	});
-}
-export { mountLiveDriven as n, mountDriven as t };

package/dist/page-CK7-IsLJ.mjs

@@ -1,41 +0,0 @@
-import { t as STYLESHEETS } from "./vite-BBW0CmYr.mjs";
-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`. */
-async function viewerScript() {
-	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 (Array.isArray(output) ? output : [output]).flatMap((each) => "output" in each ? each.output : []).flatMap((file) => file.type === "chunk" ? [file.code] : []).join("\n");
-}
-/**
-* A self-contained HTML page for `document`: open it from disk, attach it, commit it.
-* With `live` (a built script that drives the machines), that script replaces the static viewer.
-*/
-async function htmlPage(document, title, live) {
-	const css = STYLESHEETS.map((id) => readFileSync(fileURLToPath(import.meta.resolve(id)), "utf8")).join("\n");
-	const script = live ?? await viewerScript();
-	return standaloneHtml({
-		title,
-		script,
-		css,
-		document: serializeViz(document)
-	});
-}
-export { htmlPage as t };