@mulmoclaude/shapescript-plugin 1.1.1 → 1.2.0

package/README.md

@@ -13,6 +13,7 @@ name, and the `Present3D*` type names, are renamed throughout.
 | Entry         | Contents                                                                                                                 |
 | ------------- | ------------------------------------------------------------------------------------------------------------------------ |
 | `.`           | `TOOL_NAME`, `TOOL_DEFINITION`, `executePresentShapeScript`, `pluginCore`, `samples`, `parseShapeScript`, `astToThreeJS`, `executeShapeScriptDispatch` + the `artifacts/shapes` path rules |
+| `./render`    | **server-only** — `renderShapeScriptSheet` and the render page. Rasterises a model to a PNG with Puppeteer's headless Chromium (an OPTIONAL peer); a host without one gets `RenderUnavailableError` carrying the install hint. |
 | `./vue`       | the `ToolPlugin` (View + Preview + `SYSTEM_PROMPT`), plus everything on `.`                                              |
 | `./style.css` | the compiled component styles (Vite lib mode does not auto-inject them)                                                  |
 

package/dist/core.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./samples-B3VO3Mnc.cjs");exports.SHAPE_EXTENSIONS=e.Bn,exports.TOOL_DEFINITION=e.Jn,exports.TOOL_NAME=e.Yn,exports.astToThreeJS=e.a,exports.executePresentShapeScript=e.n,exports.executeShapeScriptDispatch=e.Rn,exports.isPresentableShapePath=e.Vn,exports.isShapeArtifactPath=e.Hn,exports.isShapeScriptDispatchArgs=e.Gn,exports.locateShape=e.zn,exports.parseShapeScript=e.Ln,exports.pluginCore=e.r,exports.presentShapeScript=e.i,exports.readLoadShapeResult=e.Kn,exports.readSaveShapeResult=e.qn,exports.samples=e.t,exports.shapeArtifactPath=e.Un,exports.toArtifactsRelative=e.Wn;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./samples-DHEKUNs5.cjs"),t=require("./toThreeJS-BOBpx5Dc.cjs");exports.SHAPE_EXTENSIONS=e.s,exports.TOOL_DEFINITION=e.f,exports.TOOL_NAME=e.p,exports.astToThreeJS=t.n,exports.executePresentShapeScript=e.n,exports.executeShapeScriptDispatch=e.a,exports.isPresentableShapePath=e.c,exports.isShapeArtifactPath=e.l,exports.isShapeScriptDispatchArgs=t.Ln,exports.locateShape=e.o,exports.parseShapeScript=t.Pn,exports.pluginCore=e.r,exports.presentShapeScript=e.i,exports.readLoadShapeResult=t.Rn,exports.readSaveShapeResult=t.zn,exports.samples=e.t,exports.shapeArtifactPath=e.u,exports.toArtifactsRelative=e.d;

package/dist/core.js

@@ -1,2 +1,3 @@
-import { Bn as e, Gn as t, Hn as n, Jn as r, Kn as i, Ln as a, Rn as o, Un as s, Vn as c, Wn as l, Yn as u, a as d, i as f, n as p, qn as m, r as h, t as g, zn as _ } from "./samples-6f1sYMm7.js";
-export { e as SHAPE_EXTENSIONS, r as TOOL_DEFINITION, u as TOOL_NAME, d as astToThreeJS, p as executePresentShapeScript, o as executeShapeScriptDispatch, c as isPresentableShapePath, n as isShapeArtifactPath, t as isShapeScriptDispatchArgs, _ as locateShape, a as parseShapeScript, h as pluginCore, f as presentShapeScript, i as readLoadShapeResult, m as readSaveShapeResult, g as samples, s as shapeArtifactPath, l as toArtifactsRelative };
+import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, p as c, r as l, s as u, t as d, u as f } from "./samples-SaXsqbHJ.js";
+import { Ln as p, Pn as m, Rn as h, n as g, zn as _ } from "./toThreeJS-B5LiF110.js";
+export { u as SHAPE_EXTENSIONS, r as TOOL_DEFINITION, c as TOOL_NAME, g as astToThreeJS, o as executePresentShapeScript, e as executeShapeScriptDispatch, t as isPresentableShapePath, a as isShapeArtifactPath, p as isShapeScriptDispatchArgs, s as locateShape, m as parseShapeScript, l as pluginCore, i as presentShapeScript, h as readLoadShapeResult, _ as readSaveShapeResult, d as samples, f as shapeArtifactPath, n as toArtifactsRelative };

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./samples-B3VO3Mnc.cjs");require("./core.cjs"),exports.SHAPE_EXTENSIONS=e.Bn,exports.TOOL_DEFINITION=e.Jn,exports.TOOL_NAME=e.Yn,exports.astToThreeJS=e.a,exports.executePresentShapeScript=e.n,exports.executeShapeScriptDispatch=e.Rn,exports.isPresentableShapePath=e.Vn,exports.isShapeArtifactPath=e.Hn,exports.isShapeScriptDispatchArgs=e.Gn,exports.locateShape=e.zn,exports.parseShapeScript=e.Ln,exports.pluginCore=e.r,exports.presentShapeScript=e.i,exports.readLoadShapeResult=e.Kn,exports.readSaveShapeResult=e.qn,exports.samples=e.t,exports.shapeArtifactPath=e.Un,exports.toArtifactsRelative=e.Wn;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./samples-DHEKUNs5.cjs"),t=require("./toThreeJS-BOBpx5Dc.cjs");require("./core.cjs"),exports.SHAPE_EXTENSIONS=e.s,exports.TOOL_DEFINITION=e.f,exports.TOOL_NAME=e.p,exports.astToThreeJS=t.n,exports.executePresentShapeScript=e.n,exports.executeShapeScriptDispatch=e.a,exports.isPresentableShapePath=e.c,exports.isShapeArtifactPath=e.l,exports.isShapeScriptDispatchArgs=t.Ln,exports.locateShape=e.o,exports.parseShapeScript=t.Pn,exports.pluginCore=e.r,exports.presentShapeScript=e.i,exports.readLoadShapeResult=t.Rn,exports.readSaveShapeResult=t.zn,exports.samples=e.t,exports.shapeArtifactPath=e.u,exports.toArtifactsRelative=e.d;

package/dist/index.js

@@ -1,3 +1,4 @@
-import { Bn as e, Gn as t, Hn as n, Jn as r, Kn as i, Ln as a, Rn as o, Un as s, Vn as c, Wn as l, Yn as u, a as d, i as f, n as p, qn as m, r as h, t as g, zn as _ } from "./samples-6f1sYMm7.js";
+import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, p as c, r as l, s as u, t as d, u as f } from "./samples-SaXsqbHJ.js";
+import { Ln as p, Pn as m, Rn as h, n as g, zn as _ } from "./toThreeJS-B5LiF110.js";
 import "./core.js";
-export { e as SHAPE_EXTENSIONS, r as TOOL_DEFINITION, u as TOOL_NAME, d as astToThreeJS, p as executePresentShapeScript, o as executeShapeScriptDispatch, c as isPresentableShapePath, n as isShapeArtifactPath, t as isShapeScriptDispatchArgs, _ as locateShape, a as parseShapeScript, h as pluginCore, f as presentShapeScript, i as readLoadShapeResult, m as readSaveShapeResult, g as samples, s as shapeArtifactPath, l as toArtifactsRelative };
+export { u as SHAPE_EXTENSIONS, r as TOOL_DEFINITION, c as TOOL_NAME, g as astToThreeJS, o as executePresentShapeScript, e as executeShapeScriptDispatch, t as isPresentableShapePath, a as isShapeArtifactPath, p as isShapeScriptDispatchArgs, s as locateShape, m as parseShapeScript, l as pluginCore, i as presentShapeScript, h as readLoadShapeResult, _ as readSaveShapeResult, d as samples, f as shapeArtifactPath, n as toArtifactsRelative };

package/dist/render/index.d.ts

@@ -0,0 +1,5 @@
+export { renderShapeScriptSheet, RenderUnavailableError, CHROMIUM_HINT, RENDER_TIMEOUT_MS, LAUNCH_TIMEOUT_MS, RENDER_BUDGET_MS } from "./renderer";
+export type { RenderShapeScriptOptions } from "./renderer";
+export { buildRenderPage, gridFor } from "./page";
+export type { ViewAngle, RenderPageOptions } from "./page";
+//# sourceMappingURL=index.d.ts.map

package/dist/render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnJ,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/render/page.d.ts

@@ -0,0 +1,31 @@
+/** One camera angle: where it sits on the sphere around the model, in degrees. */
+export interface ViewAngle {
+    /** Rotation around Y, from +Z toward +X. */
+    azimuth: number;
+    /** Rotation above the XZ plane. 90 looks straight down. */
+    elevation: number;
+    /** Caption drawn under the tile, so the reader knows which way they are looking. */
+    label: string;
+}
+export interface RenderPageOptions {
+    /** URL the driver serves `three.module.js` from. */
+    threeUrl: string;
+    /** `group.toJSON()` of the built model. */
+    sceneJson: unknown;
+    views: readonly ViewAngle[];
+    /** Pixel size of ONE tile. The sheet is tiled to fit every view. */
+    width: number;
+    height: number;
+    /** Multiplier on the auto-fit camera distance. >1 moves the camera closer. */
+    zoom: number;
+    projection: "perspective" | "orthographic";
+}
+/** Tile the views into the squarest grid that holds them (1→1x1, 2→2x1, 4→2x2). */
+export declare function gridFor(count: number): {
+    columns: number;
+    rows: number;
+};
+/** Assemble the page. `JSON.stringify` is the only interpolation into script
+ *  context — the caller's numbers and labels never reach the page as code. */
+export declare function buildRenderPage(options: RenderPageOptions): string;
+//# sourceMappingURL=page.d.ts.map

package/dist/render/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/render/page.ts"],"names":[],"mappings":"AAYA,kFAAkF;AAClF,MAAM,WAAW,SAAS;IACxB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,GAAG,cAAc,CAAC;CAC5C;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAGxE;AAyFD;8EAC8E;AAC9E,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAWlE"}

package/dist/render/renderer.d.ts

@@ -0,0 +1,45 @@
+import { type ViewAngle } from "./page";
+/** How long one contact sheet may take in the browser before we give up. The
+ *  geometry budget already bounds the model; this bounds the rasterisation. */
+export declare const RENDER_TIMEOUT_MS: number;
+/** How long the browser itself may take to start. Set explicitly rather than
+ *  left to Puppeteer's own 30 s default, so the total below is derived from
+ *  numbers this file controls instead of one it would silently inherit. */
+export declare const LAUNCH_TIMEOUT_MS: number;
+/** Worst case for one call, launch plus render. The MCP bridge must outlast
+ *  THIS, not just the render — a slow launch followed by a full render is
+ *  inside budget, and a bridge sized to the render alone aborts it in transit
+ *  while the server carries on and saves an image nobody is waiting for
+ *  (CodeRabbit on #3056). Callers add their own headroom for the work either
+ *  side of it: serialising the scene, and writing the PNG. */
+export declare const RENDER_BUDGET_MS: number;
+/** The install step a missing browser needs. Repeated verbatim in
+ *  `error-recovery.md` — the agent reads that file before asking the user. */
+export declare const CHROMIUM_HINT = "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.";
+export interface RenderShapeScriptOptions {
+    script: string;
+    views: readonly ViewAngle[];
+    width: number;
+    height: number;
+    zoom: number;
+    projection: "perspective" | "orthographic";
+    /** Reported for a fault that did not fail the render — currently only a browser
+     *  that would not close. Optional because this package has no logger of its own:
+     *  each host passes its own, and one that passes none loses the line rather than
+     *  the render. */
+    onWarning?: (message: string) => void;
+}
+/** Thrown when the host cannot rasterise at all — a missing browser, not a bad
+ *  model. Separated so the tool reports the install hint instead of implying
+ *  the script is at fault. */
+export declare class RenderUnavailableError extends Error {
+}
+/**
+ * Render `script` to a PNG contact sheet, returned base64-encoded.
+ *
+ * Throws `RenderUnavailableError` when no browser is installed, and a plain
+ * Error when the script itself fails to parse / build (the same diagnostics
+ * `presentShapeScript` returns) or the page never produces an image.
+ */
+export declare function renderShapeScriptSheet(options: RenderShapeScriptOptions): Promise<string>;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/render/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/render/renderer.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAUzD;+EAC+E;AAC/E,eAAO,MAAM,iBAAiB,QAAqB,CAAC;AAEpD;;2EAE2E;AAC3E,eAAO,MAAM,iBAAiB,QAAqB,CAAC;AAEpD;;;;;8DAK8D;AAC9D,eAAO,MAAM,gBAAgB,QAAwC,CAAC;AAEtE;8EAC8E;AAC9E,eAAO,MAAM,aAAa,oNACyL,CAAC;AAEpN,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,GAAG,cAAc,CAAC;IAC3C;;;sBAGkB;IAClB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED;;8BAE8B;AAC9B,qBAAa,sBAAuB,SAAQ,KAAK;CAAG;AA8JpD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD/F"}

package/dist/render.cjs

@@ -0,0 +1,82 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,s)=>(s=n==null?{}:e(i(n)),o(r||!n||!n.__esModule||!a.call(n,`default`)?t(s,`default`,{value:n,enumerable:!0}):s,n));const c=require("./toThreeJS-BOBpx5Dc.cjs");let l=require("node:fs/promises"),u=require("node:module"),d=require("node:url"),f=require("node:path");f=s(f,1);function p(e){let t=Math.ceil(Math.sqrt(e));return{columns:t,rows:Math.ceil(e/t)}}function m(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 h(){return`
+const aspect = config.width / config.height;
+const distance = (radius * 3.2) / Math.max(config.zoom, 0.01);
+
+function cameraFor(angle) {
+  const phi = MathUtils.degToRad(90 - angle.elevation);
+  const theta = MathUtils.degToRad(angle.azimuth);
+  const eye = new Vector3().setFromSphericalCoords(distance, phi, theta).add(sphere.center);
+  const far = distance + radius * 10;
+  let camera;
+  if (config.projection === "orthographic") {
+    const halfHeight = (radius * 1.3) / Math.max(config.zoom, 0.01);
+    camera = new OrthographicCamera(-halfHeight * aspect, halfHeight * aspect, halfHeight, -halfHeight, 0.01, far);
+  } else {
+    camera = new PerspectiveCamera(35, aspect, Math.max(distance / 100, 0.01), far);
+  }
+  camera.position.copy(eye);
+  camera.lookAt(sphere.center);
+  return camera;
+}
+
+config.views.forEach((angle, index) => {
+  const camera = cameraFor(angle);
+  headlight.position.copy(camera.position);
+  renderer.render(scene, camera);
+  const x = (index % columns) * config.width;
+  const y = Math.floor(index / columns) * config.height;
+  context.drawImage(renderer.domElement, x, y);
+  // Caption last, so it is never painted over by the next tile.
+  context.font = "16px system-ui, sans-serif";
+  context.fillStyle = "#111111";
+  context.fillText(angle.label, x + 12, y + config.height - 12);
+  context.strokeStyle = "#d0d0d0";
+  context.strokeRect(x + 0.5, y + 0.5, config.width - 1, config.height - 1);
+});
+
+renderer.dispose();
+window.__shapeSheet = sheet.toDataURL("image/png");`}function g(e){let{threeUrl:t,sceneJson:n,views:r,width:i,height:a,zoom:o,projection:s}=e;return`<!doctype html>
+<meta charset="utf-8">
+<style>html,body{margin:0;background:#ffffff}</style>
+<canvas id="sheet"></canvas>
+<script type="module">
+${`${m(t,JSON.stringify({views:r,width:i,height:a,zoom:o,projection:s,scene:n}),JSON.stringify(p(r.length)))}\n${h()}`}
+<\/script>`}var _=1e3;function v(e){return e instanceof Error?e.message:String(e)}var y=60*_,b=30*_,x=9e4,S="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.",C=class extends Error{};function w(e,t){try{e.onWarning?.(t)}catch{}}function T(){let e={}.url;if(typeof e==`string`&&e.length>0)return e;if(typeof __filename==`string`)return(0,d.pathToFileURL)(__filename).href;throw Error(`shapescript render: cannot locate this module to resolve three from`)}var E=(0,u.createRequire)(T());function D(e){return c.In(e)&&typeof e.launch==`function`}async function O(){try{let e=await import(`puppeteer`);return D(e)?e:c.In(e)&&D(e.default)?e.default:null}catch{return null}}function k(){try{return(0,u.createRequire)(E.resolve(`@mulmoclaude/shapescript-plugin/package.json`))}catch{return E}}function A(){let e=k().resolve(`three`);return e.endsWith(`three.cjs`)?e.replace(/three\.cjs$/,`three.module.js`):e}var j=`https://shapescript.invalid`,M=`${j}/render.html`,N=`./three.module.js`;async function P(e,t,n){let r;try{r=new URL(e)}catch{return null}if(r.origin!==j)return null;let i=f.default.posix.basename(r.pathname);return i===`render.html`?{contentType:`text/html; charset=utf-8`,body:t}:/^three[\w.-]*\.js$/.test(i)?{contentType:`text/javascript; charset=utf-8`,body:await(0,l.readFile)(f.default.join(n,i),`utf-8`)}:null}async function F(e,t){let n=f.default.dirname(A());await e.setRequestInterception(!0),e.on(`request`,e=>{(async()=>{try{let r=await P(e.url(),t,n);await(r?e.respond({status:200,...r}):e.abort())}catch{}})()})}async function I(e){let t=await O();if(!t)throw new C(S);let n=c.n(c.Pn(e.script)).toJSON(),r=g({...e,threeUrl:N,sceneJson:n}),i;try{i=await t.launch({headless:!0,timeout:b,args:[`--enable-unsafe-swiftshader`,`--use-gl=swiftshader`]})}catch(e){throw new C(`${S} (launch failed: ${v(e)})`)}try{let e=await i.newPage();await e.setViewport({width:800,height:600});let t=[];e.on(`pageerror`,e=>t.push(e.message)),await F(e,r),await e.goto(M,{waitUntil:`load`});try{await e.waitForFunction(`typeof window.__shapeSheet === 'string'`,{timeout:y})}catch(e){let n=t.length>0?`the render page failed: ${t.join(`; `)}`:v(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 i.close().catch(t=>w(e,`chromium close failed: ${v(t)}`))}}exports.CHROMIUM_HINT=S,exports.LAUNCH_TIMEOUT_MS=b,exports.RENDER_BUDGET_MS=x,exports.RENDER_TIMEOUT_MS=y,exports.RenderUnavailableError=C,exports.buildRenderPage=g,exports.gridFor=p,exports.renderShapeScriptSheet=I;

package/dist/render.js

@@ -0,0 +1,187 @@
+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.onWarning?.(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, `chromium close failed: ${f(t)}`));
+	}
+}
+//#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 };

package/dist/samples-DHEKUNs5.cjs

@@ -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}});