npm - @mulmoclaude/shapescript-plugin - Versions diffs - 1.1.1 → 1.3.0 - Mend

@mulmoclaude/shapescript-plugin 1.1.1 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/README.md +1 -0
package/dist/core.cjs +1 -1
package/dist/core.js +3 -2
package/dist/index.cjs +1 -1
package/dist/index.js +3 -2
package/dist/render/index.d.ts +7 -0
package/dist/render/index.d.ts.map +1 -0
package/dist/render/page.d.ts +31 -0
package/dist/render/page.d.ts.map +1 -0
package/dist/render/renderer.d.ts +56 -0
package/dist/render/renderer.d.ts.map +1 -0
package/dist/render/tool.d.ts +118 -0
package/dist/render/tool.d.ts.map +1 -0
package/dist/render.cjs +82 -0
package/dist/render.js +291 -0
package/dist/samples-DHEKUNs5.cjs +186 -0
package/dist/samples-SaXsqbHJ.js +180 -0
package/dist/{samples-6f1sYMm7.js → toThreeJS-B5LiF110.js} +1865 -2046
package/dist/toThreeJS-BOBpx5Dc.cjs +10 -0
package/dist/vue.cjs +31 -31
package/dist/vue.js +2001 -2000
package/package.json +18 -4
package/dist/samples-B3VO3Mnc.cjs +0 -195

package/dist/render.js ADDED Viewed

@@ -0,0 +1,291 @@
+import { In as e, Pn as t, n } from "./toThreeJS-B5LiF110.js";
+import { readFile as r } from "node:fs/promises";
+import { createRequire as i } from "node:module";
+import { pathToFileURL as a } from "node:url";
+import o from "node:path";
+//#region src/render/page.ts
+function s(e) {
+	let t = Math.ceil(Math.sqrt(e));
+	return {
+		columns: t,
+		rows: Math.ceil(e / t)
+	};
+}
+function c(e, t, n) {
+	return `import { AmbientLight, Box3, DirectionalLight, GridHelper, MathUtils, ObjectLoader, OrthographicCamera, PerspectiveCamera, Scene, Sphere, Vector3, WebGLRenderer } from ${JSON.stringify(e)};
+const config = ${t};
+const { columns, rows } = ${n};
+const sheet = document.getElementById("sheet");
+const context = sheet.getContext("2d");
+sheet.width = config.width * columns;
+sheet.height = config.height * rows;
+context.fillStyle = "#ffffff";
+context.fillRect(0, 0, sheet.width, sheet.height);
+const model = new ObjectLoader().parse(config.scene);
+// Framing is derived from the model's own bounding sphere, so one zoom value
+// means the same thing for a 0.1-unit bead and a 500-unit building.
+const bounds = new Box3().setFromObject(model);
+const sphere = bounds.getBoundingSphere(new Sphere());
+const radius = sphere.radius > 0 && isFinite(sphere.radius) ? sphere.radius : 1;
+const renderer = new WebGLRenderer({ antialias: true, preserveDrawingBuffer: true });
+renderer.setPixelRatio(1);
+renderer.setSize(config.width, config.height, false);
+renderer.setClearColor(0xffffff, 1);
+const scene = new Scene();
+scene.add(model);
+// A headlight plus fill and ambient: a single light leaves faces pointing away
+// from it black, which reads as a hole rather than a surface.
+const headlight = new DirectionalLight(0xffffff, 2.2);
+const fill = new DirectionalLight(0xffffff, 0.8);
+fill.position.set(-1, 0.5, -1);
+scene.add(headlight, fill, new AmbientLight(0xffffff, 0.9));
+// A ground grid gives absolute orientation — without it a symmetric model
+// renders identically from several angles.
+const floor = new GridHelper(radius * 4, 12, 0xc0c0c0, 0xe4e4e4);
+floor.position.y = bounds.min.y;
+scene.add(floor);
+`;
+}
+function l() {
+	return "\nconst aspect = config.width / config.height;\nconst distance = (radius * 3.2) / Math.max(config.zoom, 0.01);\n\nfunction cameraFor(angle) {\n  const phi = MathUtils.degToRad(90 - angle.elevation);\n  const theta = MathUtils.degToRad(angle.azimuth);\n  const eye = new Vector3().setFromSphericalCoords(distance, phi, theta).add(sphere.center);\n  const far = distance + radius * 10;\n  let camera;\n  if (config.projection === \"orthographic\") {\n    const halfHeight = (radius * 1.3) / Math.max(config.zoom, 0.01);\n    camera = new OrthographicCamera(-halfHeight * aspect, halfHeight * aspect, halfHeight, -halfHeight, 0.01, far);\n  } else {\n    camera = new PerspectiveCamera(35, aspect, Math.max(distance / 100, 0.01), far);\n  }\n  camera.position.copy(eye);\n  camera.lookAt(sphere.center);\n  return camera;\n}\n\nconfig.views.forEach((angle, index) => {\n  const camera = cameraFor(angle);\n  headlight.position.copy(camera.position);\n  renderer.render(scene, camera);\n  const x = (index % columns) * config.width;\n  const y = Math.floor(index / columns) * config.height;\n  context.drawImage(renderer.domElement, x, y);\n  // Caption last, so it is never painted over by the next tile.\n  context.font = \"16px system-ui, sans-serif\";\n  context.fillStyle = \"#111111\";\n  context.fillText(angle.label, x + 12, y + config.height - 12);\n  context.strokeStyle = \"#d0d0d0\";\n  context.strokeRect(x + 0.5, y + 0.5, config.width - 1, config.height - 1);\n});\n\nrenderer.dispose();\nwindow.__shapeSheet = sheet.toDataURL(\"image/png\");";
+}
+function u(e) {
+	let { threeUrl: t, sceneJson: n, views: r, width: i, height: a, zoom: o, projection: u } = e;
+	return `<!doctype html>
+<meta charset="utf-8">
+<style>html,body{margin:0;background:#ffffff}</style>
+<canvas id="sheet"></canvas>
+<script type="module">
+${`${c(t, JSON.stringify({
+		views: r,
+		width: i,
+		height: a,
+		zoom: o,
+		projection: u,
+		scene: n
+	}), JSON.stringify(s(r.length)))}\n${l()}`}
+<\/script>`;
+}
+//#endregion
+//#region src/render/renderer.ts
+var d = 1e3;
+function f(e) {
+	return e instanceof Error ? e.message : String(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?.(t);
+	} catch {}
+}
+function y() {
+	let e = import.meta.url;
+	if (typeof e == "string" && e.length > 0) return e;
+	if (typeof __filename == "string") return a(__filename).href;
+	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";
+}
+async function S() {
+	try {
+		let t = await import("puppeteer");
+		return x(t) ? t : e(t) && x(t.default) ? t.default : null;
+	} catch {
+		return null;
+	}
+}
+function C() {
+	try {
+		return i(b.resolve("@mulmoclaude/shapescript-plugin/package.json"));
+	} catch {
+		return b;
+	}
+}
+function w() {
+	let e = C().resolve("three");
+	return e.endsWith("three.cjs") ? e.replace(/three\.cjs$/, "three.module.js") : e;
+}
+var T = "https://shapescript.invalid", E = `${T}/render.html`, D = "./three.module.js";
+async function O(e, t, n) {
+	let i;
+	try {
+		i = new URL(e);
+	} catch {
+		return null;
+	}
+	if (i.origin !== T) return null;
+	let a = o.posix.basename(i.pathname);
+	return a === "render.html" ? {
+		contentType: "text/html; charset=utf-8",
+		body: t
+	} : /^three[\w.-]*\.js$/.test(a) ? {
+		contentType: "text/javascript; charset=utf-8",
+		body: await r(o.join(n, a), "utf-8")
+	} : null;
+}
+async function k(e, t) {
+	let n = o.dirname(w());
+	await e.setRequestInterception(!0), e.on("request", (e) => {
+		(async () => {
+			try {
+				let r = await O(e.url(), t, n);
+				await (r ? e.respond({
+					status: 200,
+					...r
+				}) : e.abort());
+			} catch {}
+		})();
+	});
+}
+async function A(e) {
+	let r = await S();
+	if (!r) throw new _(g);
+	let i = n(t(e.script)).toJSON(), a = u({
+		...e,
+		threeUrl: D,
+		sceneJson: i
+	}), o;
+	try {
+		o = await r.launch({
+			headless: !0,
+			timeout: m,
+			args: ["--enable-unsafe-swiftshader", "--use-gl=swiftshader"]
+		});
+	} catch (e) {
+		throw new _(`${g} (launch failed: ${f(e)})`);
+	}
+	try {
+		let e = await o.newPage();
+		await e.setViewport({
+			width: 800,
+			height: 600
+		});
+		let t = [];
+		e.on("pageerror", (e) => t.push(e.message)), await k(e, a), await e.goto(E, { waitUntil: "load" });
+		try {
+			await e.waitForFunction("typeof window.__shapeSheet === 'string'", { timeout: p });
+		} catch (e) {
+			let n = t.length > 0 ? `the render page failed: ${t.join("; ")}` : f(e);
+			throw Error(n, { cause: e });
+		}
+		let n = await e.evaluate("window.__shapeSheet");
+		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.onWarning, `chromium close failed: ${f(t)}`));
+	}
+}
+//#endregion
+//#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 };

package/dist/samples-DHEKUNs5.cjs ADDED Viewed

@@ -0,0 +1,186 @@
+const e=require("./toThreeJS-BOBpx5Dc.cjs");let t=require("@mulmoclaude/core/artifacts");var n=`presentShapeScript`,r={type:`function`,name:n,description:"Display interactive 3D visualizations using ShapeScript with expressions, variables, control flow, and functions. A new `script` is saved to `artifacts/shapes/` and the returned `filePath` names it; pass `path` instead to present a source that already exists.",parameters:{type:`object`,properties:{title:{type:`string`,description:`Title for the 3D visualization`},script:{type:`string`,description:`ShapeScript code defining the 3D scene. Supported features and syntax are listed below. Syntax, evaluation, geometry and resource-limit errors are returned as diagnostics; correct the script and retry.
+## SYNTAX OVERVIEW:
+### Expressions & Operators:
+- Arithmetic: +, -, *, /, % with proper precedence
+- Comparison: =, <>, <, <=, >, >=
+- Boolean: and, or, not
+- Parentheses for grouping: (2 + 3) * 4
+### Variables:
+define radius 2
+define red (1 0 0)
+sphere { size radius color red }
+### Control Flow:
+For loops with variables:
+for i in 1 to 5 {
+    cube { position (i * 2) 0 0 size 1 }
+}
+For loops with step:
+for i in 0 to 10 step 2 {
+    sphere { position 0 i 0 }
+}
+If/else conditionals:
+define showSphere 1
+if showSphere {
+    sphere { size 2 }
+} else {
+    cube { size 2 }
+}
+Switch statements:
+define shape 2
+switch shape {
+case 1
+    cube
+case 2
+    sphere
+else
+    cone
+}
+### Built-in Functions:
+Math: round, floor, ceil, abs, sign, sqrt, pow, min, max
+Trig: sin, cos, tan, asin, acos, atan, atan2 (uses radians)
+Vector: dot, cross, length, normalize, sum
+IMPORTANT: Function calls require NO space between name and parenthesis:
+- sin(x) ✓ function call
+- sin (x) ✗ NOT a function call (identifier + parenthesized expression)
+Examples:
+for i in 1 to 8 {
+    define angle (i * 0.785)  // 45 degrees in radians
+    cube { position (cos(angle) * 3) 0 (sin(angle) * 3) }
+}
+### Primitives & Properties:
+Shapes: cube, sphere, cylinder, cone, torus, circle, square, polygon (sides 3–256)
+Properties: position X Y Z, rotation X Y Z, size X Y Z
+Materials: color R G B (0-1), opacity (0-1)
+### CSG Operations:
+union, difference, intersection, xor, stencil
+Example:
+difference {
+    sphere { size 2 color (1 0.5 0) }
+    cube { size 1.5 }
+}
+### Builders:
+- extrude: extrude { polygon { sides 3 } } or extrude path { point 0 0 point 1 0 point 0 1 }
+- fill: fill { square } or fill path { ... }
+- lathe: lathe path { point 1 0 curve 0 2 1 -1 } (revolves about Y)
+- loft: loft { square translate 0 0 2 circle } (closed planar sections joined with caps)
+- hull: hull { cube { position -1 0 0 } cube { position 1 0 0 } } (convex envelope)
+- stencil preserves the first shape and paints its surface with later shapes' materials.
+Loft sections must each have one perimeter and enclose an area; extrude/fill primitive profiles must lie in XY.
+### Additional Expressions:
+- Constants: pi, tau, true, false
+- Scientific notation and unary plus: 1e-3, +2
+- Tuple/vector members: vector.x, vector.y, vector.z; color.red/green/blue/alpha
+- Tuple/string length: value.count; zero-based indexing: values[0]
+- String literals, join(...), trim(...); min/max also accept tuples
+- Custom shapes with options:
+define post { option height 2 cylinder { size 0.2 height } }
+post { height 3 }
+### Compatibility:
+This plugin implements the documented modeling subset, not all upstream ShapeScript syntax.
+Function calls use name(...); trig functions and rotation/orientation properties use radians.
+Relative rotate/orientation commands and path rotate use turns (1 = 360 degrees).
+Path point/curve coordinates are relative steps. Curves accept optional control-point offsets.
+Imports, textures, text/fonts, arbitrary objects, and general user-defined functions are not supported.
+### Comments:
+// Single-line comment
+/* Multi-line
+   comment */
+## COMPLETE EXAMPLES:
+Linear arrangement with expressions:
+define spacing 1.5
+for i in 1 to 4 {
+    cylinder { position ((i - 2.5) * spacing) 0 0 size 0.4 1 }
+}
+Circular pattern:
+define count 12
+for i in 1 to count {
+    define angle ((i / count) * 6.283)  // 2 * PI
+    cube {
+        position (cos(angle) * 3) 0 (sin(angle) * 3)
+        color (i / count) 0.5 (1 - i / count)
+        size 0.5
+    }
+}
+Conditional geometry:
+define makeHollow 1
+if makeHollow {
+    difference {
+        sphere { size 2 color (1 0 0) }
+        sphere { size 1.7 }
+    }
+} else {
+    sphere { size 2 color (1 0 0) }
+}
+Mathematical visualization:
+for x in -5 to 5 {
+    for z in -5 to 5 {
+        define height (sin(x * 0.5) * cos(z * 0.5) * 2)
+        cube {
+            position (x * 0.3) height (z * 0.3)
+            size 0.25 (abs(height) + 0.1) 0.25
+            color (0.5 + height * 0.25) 0.3 (0.5 - height * 0.25)
+        }
+    }
+}`},path:{type:`string`,description:"Path to an EXISTING ShapeScript source to present in place, instead of `script` — a `.shape` file this tool saved earlier (`artifacts/shapes/…`) or any other on disk. Provide either `script` or `path`, never both. Edits the user makes in the view write back to that same file."}},required:[`title`]}},i=`shapes`,a=`shape`,o=[`.shape`];function s(){let e=globalThis.crypto;if(e?.getRandomValues){let t=e.getRandomValues(new Uint8Array(4));return Array.from(t,e=>e.toString(16).padStart(2,`0`)).join(``)}return Math.random().toString(16).slice(2,10).padEnd(8,`0`)}function c(e,n=new Date,r=s()){let o=(0,t.buildArtifactRelPath)({dir:i,title:e,ext:`.shape`,fallback:a,now:n,partitioned:!1,suffix:r});return{relPath:o,filePath:(0,t.toWorkspaceArtifactPath)(o)}}function l(e){return!e.startsWith(`${t.ARTIFACTS_ROOT}/${i}/`)||!e.endsWith(`.shape`)?!1:!(0,t.hasUnsafePathSegment)(e)}function u(e){return e.startsWith(`${t.ARTIFACTS_ROOT}/`)?e.slice(t.ARTIFACTS_ROOT.length+1):e}function d(e){return(0,t.classifyFilePath)(e,o)!==null}function f(e,t){if(l(t))return{files:e.files.artifacts,rel:u(t)};let n=e.files.byPath;return n&&d(t)?{files:n,rel:t}:null}async function p(e,t){if(typeof t?.path!=`string`)throw Error(`path must be an existing .shape file`);let n=f(e,t.path);if(!n)throw Error(`path must be an existing .shape file`);switch(t.kind){case`loadShape`:return{script:await n.files.read(n.rel)};case`saveShape`:if(typeof t.script!=`string`)throw Error("saveShape requires `script` as a string");if(!await n.files.exists(n.rel))throw Error(`No ShapeScript exists at ${t.path}`);return await n.files.write(n.rel,t.script),{path:t.path};default:throw Error(`shapescript plugin: unknown dispatch kind ${JSON.stringify(t)}`)}}var m=`Acknowledge that the 3D visualization has been created and is displayed to the user. They can rotate, zoom, and pan the camera.`,h=e=>typeof e==`string`&&e.trim()!==``;function g(t){e.r(e.n(e.Pn(t)))}async function _(e,t){let n=e.files;if(!n)throw Error("This host cannot open a ShapeScript by path — pass the source as `script` instead");let r=f({files:n},t);if(!r)throw Error("`path` must be a .shape file, without `.` / `..` segments");if(!await r.files.exists(r.rel))throw Error(`No ShapeScript exists at ${t}`);return r.files.read(r.rel)}var v=5;async function y(e,t,n){let r=e.files?.artifacts;if(r){for(let e=0;e<v;e++){let{relPath:e,filePath:i}=c(n);if(!await r.exists(e))return await r.write(e,t),i}throw Error(`Could not allocate a free path under artifacts/shapes — try again with a different title`)}}async function b(e,t){if(h(t.path)&&h(t.script))throw Error("Provide either `script` or `path`, not both");if(h(t.path))return{script:await _(e,t.path),filePath:t.path};if(!h(t.script))throw Error(`ShapeScript code is required but was not provided`);return{script:t.script}}var x=async(t,n)=>{let r=`INVALID_ARGUMENT`;try{if(!e.In(n))throw Error("presentShapeScript args must be an object with `script` or `path`");if(!h(n.title))throw Error(`A nonempty visualization title is required`);let i=await b(t??{},n);r=`EVALUATION_ERROR`,g(i.script);let a=i.filePath??await y(t??{},i.script,n.title);return{message:a?`Saved ShapeScript to ${a}`:`Created 3D visualization: ${n.title}`,title:n.title,data:a?{script:i.script,filePath:a}:{script:i.script},instructions:m}}catch(t){let n={code:t instanceof e.Fn?`PARSE_ERROR`:t instanceof e.t?`LIMIT_EXCEEDED`:r,message:t instanceof Error?t.message:String(t),...t instanceof e.Fn&&t.line!==void 0?{line:t.line}:{},...t instanceof e.Fn&&t.column!==void 0?{column:t.column}:{}};return{message:`ShapeScript error: ${n.message}`,error:n,jsonData:{error:n},instructions:`The visualization was not created. Correct the ShapeScript using the returned diagnostic and call presentShapeScript again.`}}},S={toolDefinition:r,execute:x,generatingMessage:`Creating 3D visualization...`,waitingMessage:`Tell the user that the 3D visualization was created and will be presented shortly.`,isEnabled:()=>!0},C=x,w=[{name:`Basic Shapes`,args:{title:`Basic 3D Shapes`,script:`// Basic shapes demonstration
+cube { position -2 0 0 size 1 color (1 0.3 0.3) }
+sphere { position 0 0 0 size 1 color (0.3 1 0.3) }
+cylinder { position 2 0 0 size 0.5 1 color (0.3 0.3 1) }`}},{name:`Circular Pattern`,args:{title:`Circular Pattern`,script:`// 12個の立方体を円形に配置
+define count 12
+define radius 3
+for i in 1 to count {
+    // 各立方体の角度を計算（2 * PI = 6.283ラジアン）
+    define angle ((i / count) * 6.283)
+    // 円形配置のためのX座標とZ座標を計算
+    define x (cos(angle) * radius)
+    define z (sin(angle) * radius)
+    // グラデーションカラーを作成
+    define colorValue (i / count)
+    cube {
+        position x 0 z
+        size 0.5
+        color colorValue 0.5 (1 - colorValue)
+    }
+}
+// 中心に参考用の球体を配置
+sphere {
+    position 0 0 0
+    size 0.3
+    color 1 1 0
+    opacity 0.5
+}`}},{name:`CSG Difference`,args:{title:`Hollow Sphere`,script:`// Create a hollow sphere using CSG difference
+difference {
+    sphere { size 2 color (1 0.5 0) }
+    sphere { size 1.7 color (1 1 1) }
+    cube { position 0 0 2 size 2 }
+}`}}];Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return c}});

package/dist/samples-SaXsqbHJ.js ADDED Viewed

@@ -0,0 +1,180 @@
+import { Fn as e, In as t, Pn as n, n as r, r as i, t as a } from "./toThreeJS-B5LiF110.js";
+import { ARTIFACTS_ROOT as o, buildArtifactRelPath as s, classifyFilePath as c, hasUnsafePathSegment as l, toWorkspaceArtifactPath as u } from "@mulmoclaude/core/artifacts";
+//#region src/core/definition.ts
+var d = "presentShapeScript", f = {
+	type: "function",
+	name: d,
+	description: "Display interactive 3D visualizations using ShapeScript with expressions, variables, control flow, and functions. A new `script` is saved to `artifacts/shapes/` and the returned `filePath` names it; pass `path` instead to present a source that already exists.",
+	parameters: {
+		type: "object",
+		properties: {
+			title: {
+				type: "string",
+				description: "Title for the 3D visualization"
+			},
+			script: {
+				type: "string",
+				description: "ShapeScript code defining the 3D scene. Supported features and syntax are listed below. Syntax, evaluation, geometry and resource-limit errors are returned as diagnostics; correct the script and retry.\n\n## SYNTAX OVERVIEW:\n\n### Expressions & Operators:\n- Arithmetic: +, -, *, /, % with proper precedence\n- Comparison: =, <>, <, <=, >, >=\n- Boolean: and, or, not\n- Parentheses for grouping: (2 + 3) * 4\n\n### Variables:\ndefine radius 2\ndefine red (1 0 0)\nsphere { size radius color red }\n\n### Control Flow:\n\nFor loops with variables:\nfor i in 1 to 5 {\n    cube { position (i * 2) 0 0 size 1 }\n}\n\nFor loops with step:\nfor i in 0 to 10 step 2 {\n    sphere { position 0 i 0 }\n}\n\nIf/else conditionals:\ndefine showSphere 1\nif showSphere {\n    sphere { size 2 }\n} else {\n    cube { size 2 }\n}\n\nSwitch statements:\ndefine shape 2\nswitch shape {\ncase 1\n    cube\ncase 2\n    sphere\nelse\n    cone\n}\n\n### Built-in Functions:\n\nMath: round, floor, ceil, abs, sign, sqrt, pow, min, max\nTrig: sin, cos, tan, asin, acos, atan, atan2 (uses radians)\nVector: dot, cross, length, normalize, sum\n\nIMPORTANT: Function calls require NO space between name and parenthesis:\n- sin(x) ✓ function call\n- sin (x) ✗ NOT a function call (identifier + parenthesized expression)\n\nExamples:\nfor i in 1 to 8 {\n    define angle (i * 0.785)  // 45 degrees in radians\n    cube { position (cos(angle) * 3) 0 (sin(angle) * 3) }\n}\n\n### Primitives & Properties:\n\nShapes: cube, sphere, cylinder, cone, torus, circle, square, polygon (sides 3–256)\nProperties: position X Y Z, rotation X Y Z, size X Y Z\nMaterials: color R G B (0-1), opacity (0-1)\n\n### CSG Operations:\nunion, difference, intersection, xor, stencil\n\nExample:\ndifference {\n    sphere { size 2 color (1 0.5 0) }\n    cube { size 1.5 }\n}\n\n### Builders:\n- extrude: extrude { polygon { sides 3 } } or extrude path { point 0 0 point 1 0 point 0 1 }\n- fill: fill { square } or fill path { ... }\n- lathe: lathe path { point 1 0 curve 0 2 1 -1 } (revolves about Y)\n- loft: loft { square translate 0 0 2 circle } (closed planar sections joined with caps)\n- hull: hull { cube { position -1 0 0 } cube { position 1 0 0 } } (convex envelope)\n- stencil preserves the first shape and paints its surface with later shapes' materials.\nLoft sections must each have one perimeter and enclose an area; extrude/fill primitive profiles must lie in XY.\n\n### Additional Expressions:\n- Constants: pi, tau, true, false\n- Scientific notation and unary plus: 1e-3, +2\n- Tuple/vector members: vector.x, vector.y, vector.z; color.red/green/blue/alpha\n- Tuple/string length: value.count; zero-based indexing: values[0]\n- String literals, join(...), trim(...); min/max also accept tuples\n- Custom shapes with options:\ndefine post { option height 2 cylinder { size 0.2 height } }\npost { height 3 }\n\n### Compatibility:\nThis plugin implements the documented modeling subset, not all upstream ShapeScript syntax.\nFunction calls use name(...); trig functions and rotation/orientation properties use radians.\nRelative rotate/orientation commands and path rotate use turns (1 = 360 degrees).\nPath point/curve coordinates are relative steps. Curves accept optional control-point offsets.\nImports, textures, text/fonts, arbitrary objects, and general user-defined functions are not supported.\n\n### Comments:\n// Single-line comment\n/* Multi-line\n   comment */\n\n## COMPLETE EXAMPLES:\n\nLinear arrangement with expressions:\ndefine spacing 1.5\nfor i in 1 to 4 {\n    cylinder { position ((i - 2.5) * spacing) 0 0 size 0.4 1 }\n}\n\nCircular pattern:\ndefine count 12\nfor i in 1 to count {\n    define angle ((i / count) * 6.283)  // 2 * PI\n    cube {\n        position (cos(angle) * 3) 0 (sin(angle) * 3)\n        color (i / count) 0.5 (1 - i / count)\n        size 0.5\n    }\n}\n\nConditional geometry:\ndefine makeHollow 1\nif makeHollow {\n    difference {\n        sphere { size 2 color (1 0 0) }\n        sphere { size 1.7 }\n    }\n} else {\n    sphere { size 2 color (1 0 0) }\n}\n\nMathematical visualization:\nfor x in -5 to 5 {\n    for z in -5 to 5 {\n        define height (sin(x * 0.5) * cos(z * 0.5) * 2)\n        cube {\n            position (x * 0.3) height (z * 0.3)\n            size 0.25 (abs(height) + 0.1) 0.25\n            color (0.5 + height * 0.25) 0.3 (0.5 - height * 0.25)\n        }\n    }\n}"
+			},
+			path: {
+				type: "string",
+				description: "Path to an EXISTING ShapeScript source to present in place, instead of `script` — a `.shape` file this tool saved earlier (`artifacts/shapes/…`) or any other on disk. Provide either `script` or `path`, never both. Edits the user makes in the view write back to that same file."
+			}
+		},
+		required: ["title"]
+	}
+}, p = "shapes", m = "shape", h = [".shape"];
+function g() {
+	let e = globalThis.crypto;
+	if (e?.getRandomValues) {
+		let t = e.getRandomValues(/* @__PURE__ */ new Uint8Array(4));
+		return Array.from(t, (e) => e.toString(16).padStart(2, "0")).join("");
+	}
+	return Math.random().toString(16).slice(2, 10).padEnd(8, "0");
+}
+function _(e, t = /* @__PURE__ */ new Date(), n = g()) {
+	let r = s({
+		dir: p,
+		title: e,
+		ext: ".shape",
+		fallback: m,
+		now: t,
+		partitioned: !1,
+		suffix: n
+	});
+	return {
+		relPath: r,
+		filePath: u(r)
+	};
+}
+function v(e) {
+	return !e.startsWith(`${o}/${p}/`) || !e.endsWith(".shape") ? !1 : !l(e);
+}
+function y(e) {
+	return e.startsWith(`${o}/`) ? e.slice(o.length + 1) : e;
+}
+function b(e) {
+	return c(e, h) !== null;
+}
+//#endregion
+//#region src/core/dispatch.ts
+function x(e, t) {
+	if (v(t)) return {
+		files: e.files.artifacts,
+		rel: y(t)
+	};
+	let n = e.files.byPath;
+	return n && b(t) ? {
+		files: n,
+		rel: t
+	} : null;
+}
+async function S(e, t) {
+	if (typeof t?.path != "string") throw Error("path must be an existing .shape file");
+	let n = x(e, t.path);
+	if (!n) throw Error("path must be an existing .shape file");
+	switch (t.kind) {
+		case "loadShape": return { script: await n.files.read(n.rel) };
+		case "saveShape":
+			if (typeof t.script != "string") throw Error("saveShape requires `script` as a string");
+			if (!await n.files.exists(n.rel)) throw Error(`No ShapeScript exists at ${t.path}`);
+			return await n.files.write(n.rel, t.script), { path: t.path };
+		default: throw Error(`shapescript plugin: unknown dispatch kind ${JSON.stringify(t)}`);
+	}
+}
+//#endregion
+//#region src/core/plugin.ts
+var C = "Acknowledge that the 3D visualization has been created and is displayed to the user. They can rotate, zoom, and pan the camera.", w = (e) => typeof e == "string" && e.trim() !== "";
+function T(e) {
+	i(r(n(e)));
+}
+async function E(e, t) {
+	let n = e.files;
+	if (!n) throw Error("This host cannot open a ShapeScript by path — pass the source as `script` instead");
+	let r = x({ files: n }, t);
+	if (!r) throw Error("`path` must be a .shape file, without `.` / `..` segments");
+	if (!await r.files.exists(r.rel)) throw Error(`No ShapeScript exists at ${t}`);
+	return r.files.read(r.rel);
+}
+var D = 5;
+async function O(e, t, n) {
+	let r = e.files?.artifacts;
+	if (r) {
+		for (let e = 0; e < D; e++) {
+			let { relPath: e, filePath: i } = _(n);
+			if (!await r.exists(e)) return await r.write(e, t), i;
+		}
+		throw Error("Could not allocate a free path under artifacts/shapes — try again with a different title");
+	}
+}
+async function k(e, t) {
+	if (w(t.path) && w(t.script)) throw Error("Provide either `script` or `path`, not both");
+	if (w(t.path)) return {
+		script: await E(e, t.path),
+		filePath: t.path
+	};
+	if (!w(t.script)) throw Error("ShapeScript code is required but was not provided");
+	return { script: t.script };
+}
+var A = async (n, r) => {
+	let i = "INVALID_ARGUMENT";
+	try {
+		if (!t(r)) throw Error("presentShapeScript args must be an object with `script` or `path`");
+		if (!w(r.title)) throw Error("A nonempty visualization title is required");
+		let e = await k(n ?? {}, r);
+		i = "EVALUATION_ERROR", T(e.script);
+		let a = e.filePath ?? await O(n ?? {}, e.script, r.title);
+		return {
+			message: a ? `Saved ShapeScript to ${a}` : `Created 3D visualization: ${r.title}`,
+			title: r.title,
+			data: a ? {
+				script: e.script,
+				filePath: a
+			} : { script: e.script },
+			instructions: C
+		};
+	} catch (t) {
+		let n = {
+			code: t instanceof e ? "PARSE_ERROR" : t instanceof a ? "LIMIT_EXCEEDED" : i,
+			message: t instanceof Error ? t.message : String(t),
+			...t instanceof e && t.line !== void 0 ? { line: t.line } : {},
+			...t instanceof e && t.column !== void 0 ? { column: t.column } : {}
+		};
+		return {
+			message: `ShapeScript error: ${n.message}`,
+			error: n,
+			jsonData: { error: n },
+			instructions: "The visualization was not created. Correct the ShapeScript using the returned diagnostic and call presentShapeScript again."
+		};
+	}
+}, j = {
+	toolDefinition: f,
+	execute: A,
+	generatingMessage: "Creating 3D visualization...",
+	waitingMessage: "Tell the user that the 3D visualization was created and will be presented shortly.",
+	isEnabled: () => !0
+}, M = A, N = [
+	{
+		name: "Basic Shapes",
+		args: {
+			title: "Basic 3D Shapes",
+			script: "// Basic shapes demonstration\ncube { position -2 0 0 size 1 color (1 0.3 0.3) }\nsphere { position 0 0 0 size 1 color (0.3 1 0.3) }\ncylinder { position 2 0 0 size 0.5 1 color (0.3 0.3 1) }"
+		}
+	},
+	{
+		name: "Circular Pattern",
+		args: {
+			title: "Circular Pattern",
+			script: "// 12個の立方体を円形に配置\n\ndefine count 12\ndefine radius 3\n\nfor i in 1 to count {\n    // 各立方体の角度を計算（2 * PI = 6.283ラジアン）\n    define angle ((i / count) * 6.283)\n\n    // 円形配置のためのX座標とZ座標を計算\n    define x (cos(angle) * radius)\n    define z (sin(angle) * radius)\n\n    // グラデーションカラーを作成\n    define colorValue (i / count)\n\n    cube {\n        position x 0 z\n        size 0.5\n        color colorValue 0.5 (1 - colorValue)\n    }\n}\n\n// 中心に参考用の球体を配置\nsphere {\n    position 0 0 0\n    size 0.3\n    color 1 1 0\n    opacity 0.5\n}"
+		}
+	},
+	{
+		name: "CSG Difference",
+		args: {
+			title: "Hollow Sphere",
+			script: "// Create a hollow sphere using CSG difference\ndifference {\n    sphere { size 2 color (1 0.5 0) }\n    sphere { size 1.7 color (1 1 1) }\n    cube { position 0 0 2 size 2 }\n}"
+		}
+	}
+];
+//#endregion
+export { S as a, b as c, y as d, f, A as i, v as l, M as n, x as o, d as p, j as r, h as s, N as t, _ as u };