@mulmoclaude/shapescript-plugin 1.2.0 → 1.4.0

package/dist/render.js

@@ -1,4 +1,4 @@
-import { In as e, Pn as t, n } from "./toThreeJS-B5LiF110.js";
+import { In as e, Rn as t, r as n } from "./toThreeJS-BX_aeGdA.js";
 import { readFile as r } from "node:fs/promises";
 import { createRequire as i } from "node:module";
 import { pathToFileURL as a } from "node:url";
@@ -81,7 +81,7 @@ function f(e) {
 var p = 60 * d, m = 30 * d, h = 9e4, g = "renderShapeScript needs Puppeteer's headless Chromium, which this host does not have. Run `npx puppeteer browsers install chrome`, then retry. Everything else, including presentShapeScript, works without it.", _ = class extends Error {};
 function v(e, t) {
 	try {
-		e.onWarning?.(t);
+		e?.(t);
 	} catch {}
 }
 function y() {
@@ -91,13 +91,13 @@ function y() {
 	throw Error("shapescript render: cannot locate this module to resolve three from");
 }
 var b = i(y());
-function x(t) {
-	return e(t) && typeof t.launch == "function";
+function x(e) {
+	return t(e) && typeof e.launch == "function";
 }
 async function S() {
 	try {
-		let t = await import("puppeteer");
-		return x(t) ? t : e(t) && x(t.default) ? t.default : null;
+		let e = await import("puppeteer");
+		return x(e) ? e : t(e) && x(e.default) ? e.default : null;
 	} catch {
 		return null;
 	}
@@ -145,11 +145,11 @@ async function k(e, t) {
 		})();
 	});
 }
-async function A(e) {
+async function A(t) {
 	let r = await S();
 	if (!r) throw new _(g);
-	let i = n(t(e.script)).toJSON(), a = u({
-		...e,
+	let i = n(e(t.script)).toJSON(), a = u({
+		...t,
 		threeUrl: D,
 		sceneJson: i
 	}), o;
@@ -180,8 +180,112 @@ async function A(e) {
 		if (typeof n != "string" || !n.startsWith("data:image/png;base64,")) throw Error("the render page produced no image");
 		return n.slice(22);
 	} finally {
-		await o.close().catch((t) => v(e, `chromium close failed: ${f(t)}`));
+		await o.close().catch((e) => v(t.onWarning, `chromium close failed: ${f(e)}`));
 	}
 }
 //#endregion
-export { g as CHROMIUM_HINT, m as LAUNCH_TIMEOUT_MS, h as RENDER_BUDGET_MS, p as RENDER_TIMEOUT_MS, _ as RenderUnavailableError, u as buildRenderPage, s as gridFor, A as renderShapeScriptSheet };
+//#region src/render/tool.ts
+var j = 30, M = 25, N = 1, P = 480, F = 900, I = 160, L = 85, R = h + 3e4, z = "renderShapeScript", B = "Render a ShapeScript model to a PNG image and save it, so you can LOOK at the model you wrote and check it before showing it to the user. Returns the image path — read that file to see the result. By default it renders four camera angles onto one sheet, because a single view cannot settle what is in front of what. Takes the same source as presentShapeScript: inline `script`, or `path` to a saved .shape file.", V = "Use renderShapeScript to CHECK a 3D model you wrote before presenting it — it saves a PNG and returns the path, which you then read to see what the model actually looks like. Fix what you see and re-render. Rendering needs a local headless browser; if it reports one is missing, say so and continue with presentShapeScript rather than retrying.", H = {
+	type: "object",
+	properties: {
+		script: {
+			type: "string",
+			description: "ShapeScript source to render. Provide either this or `path`, not both."
+		},
+		path: {
+			type: "string",
+			description: "Path to an existing .shape file to render (e.g. one presentShapeScript saved under artifacts/shapes/)."
+		},
+		azimuth: {
+			type: "number",
+			description: `Camera rotation around the model in degrees, 0 = looking from +Z. Default ${j}. In the default four-view sheet this is the FIRST view's angle; the others are offset from it.`
+		},
+		elevation: {
+			type: "number",
+			description: `Camera height in degrees above the horizon, 90 = straight down. Default ${M}. Avoid 0 and 90 for the main view — an axis-aligned shot flattens depth.`
+		},
+		zoom: {
+			type: "number",
+			description: "Multiplier on the automatic framing, which fits the whole model. 1 = fit (default), 2 = twice as close, 0.5 = further out. Prefer this over guessing a camera distance: it means the same thing at any model scale."
+		},
+		views: {
+			type: "string",
+			enum: ["quad", "single"],
+			description: "`quad` (default) renders four angles on one sheet — use it to judge shape and layout. `single` renders only `azimuth`/`elevation`, for a close look at one detail."
+		},
+		projection: {
+			type: "string",
+			enum: ["perspective", "orthographic"],
+			description: "`perspective` (default) looks natural; `orthographic` keeps parallel edges parallel, which is better for comparing proportions."
+		},
+		width: {
+			type: "number",
+			description: `Pixel width of ONE view. Default ${P}, clamped to ${I}–${F}.`
+		},
+		height: {
+			type: "number",
+			description: `Pixel height of ONE view. Default ${P}, clamped to ${I}–${F}.`
+		}
+	},
+	required: []
+};
+function U(e, t) {
+	return typeof e != "number" || !Number.isFinite(e) ? t : Math.min(F, Math.max(I, Math.round(e)));
+}
+function W(e, t) {
+	return typeof e == "number" && Number.isFinite(e) ? e : t;
+}
+var G = (e) => `${Math.round(e)}°`;
+function K(e, t, n) {
+	let r = (e, t, n) => ({
+		azimuth: e,
+		elevation: t,
+		label: `${n} — az ${G(e)}, el ${G(t)}`
+	});
+	return n ? [r(e, t, "view")] : [
+		r(e, t, "front-right"),
+		r(e + 90, t, "back-right"),
+		r(e + 180, t, "back-left"),
+		r(e, L, "top")
+	];
+}
+async function q(e, t) {
+	let n = typeof t.script == "string" && t.script.trim() !== "" ? t.script : void 0, r = typeof t.path == "string" && t.path.trim() !== "" ? t.path : void 0;
+	if (n && r) throw Error("Provide either `script` or `path`, not both");
+	if (n) return n;
+	if (r) return e.readShape(r);
+	throw Error("Provide either `script` (inline source) or `path` (an existing .shape file)");
+}
+function J(e, t, n, r) {
+	return {
+		script: t,
+		views: n,
+		width: U(e.width, P),
+		height: U(e.height, P),
+		zoom: Math.max(W(e.zoom, N), .01),
+		projection: e.projection === "orthographic" ? "orthographic" : "perspective",
+		...r ? { onWarning: r } : {}
+	};
+}
+function Y(e, t) {
+	let n = t.map((e) => e.label).join("; ");
+	return `Saved render to ${e} (${t.length === 1 ? "1 view" : `${t.length} views`}: ${n}). Read that file to see the model.`;
+}
+async function X(e, t) {
+	let n = await q(e, t), r = K(W(t.azimuth, j), W(t.elevation, M), t.views === "single");
+	try {
+		let i = await A(J(t, n, r, e.onWarning));
+		return {
+			message: Y(await e.saveImage(i), r),
+			rendered: !0
+		};
+	} catch (t) {
+		if (t instanceof _) return v(e.onWarning, `renderShapeScript: unavailable — ${t.message}`), {
+			message: t.message,
+			rendered: !1
+		};
+		throw t;
+	}
+}
+//#endregion
+export { g as CHROMIUM_HINT, m as LAUNCH_TIMEOUT_MS, h as RENDER_BUDGET_MS, B as RENDER_SHAPE_SCRIPT_DESCRIPTION, V as RENDER_SHAPE_SCRIPT_PROMPT, H as RENDER_SHAPE_SCRIPT_SCHEMA, z as RENDER_SHAPE_SCRIPT_TOOL_NAME, p as RENDER_TIMEOUT_MS, R as RENDER_TOOL_TIMEOUT_MS, _ as RenderUnavailableError, u as buildRenderPage, X as executeRenderShapeScript, s as gridFor, J as renderOptionsFrom, A as renderShapeScriptSheet, Y as savedMessage, K as viewAngles };