@mulmoclaude/shapescript-plugin 1.1.1 → 1.3.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,7 @@
+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";
+export { executeRenderShapeScript, viewAngles, RENDER_SHAPE_SCRIPT_TOOL_NAME, RENDER_SHAPE_SCRIPT_DESCRIPTION, RENDER_SHAPE_SCRIPT_PROMPT, RENDER_SHAPE_SCRIPT_SCHEMA, RENDER_TOOL_TIMEOUT_MS, renderOptionsFrom, savedMessage, } from "./tool";
+export type { RenderToolDeps, RenderToolResult } from "./tool";
+//# 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;AAC3D,OAAO,EACL,wBAAwB,EACxB,UAAU,EACV,6BAA6B,EAC7B,+BAA+B,EAC/B,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,GACb,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,cAAc,EAAE,gBAAgB,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,56 @@
+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 {
+}
+/** Report something the host should record, without letting the report become
+ *  the outcome. The callback is the HOST's code, and it is called from paths
+ *  whose whole purpose is to answer gracefully — the `finally` that releases the
+ *  browser after a finished render (CodeRabbit on #3059), and the
+ *  browser-unavailable branch that returns install guidance (codex on #3060). A
+ *  synchronous throw from a logger must not turn either into a rejection.
+ *
+ *  Exported because both callers need the same guarantee and one of them lives
+ *  in `./tool`; two copies of "wrap the host's logger" is exactly the kind of
+ *  thing that ends up guarded in one place and not the other. */
+export declare function safeWarn(onWarning: ((message: string) => void) | undefined, message: string): void;
+/**
+ * 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;AAEpD;;;;;;;;;iEASiE;AACjE,wBAAgB,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAMlG;AAkJD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD/F"}

package/dist/render/tool.d.ts

@@ -0,0 +1,118 @@
+import type { ViewAngle } from "./page";
+/** Milliseconds a host must allow this tool before its own transport gives up.
+ *  Covers launch plus render, plus room for the work either side — serialising
+ *  the scene and writing the PNG. A transport sized to the render alone aborts a
+ *  call that was about to succeed. */
+export declare const RENDER_TOOL_TIMEOUT_MS: number;
+export declare const RENDER_SHAPE_SCRIPT_TOOL_NAME = "renderShapeScript";
+export declare const RENDER_SHAPE_SCRIPT_DESCRIPTION = "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 \u2014 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.";
+export declare const RENDER_SHAPE_SCRIPT_PROMPT = "Use renderShapeScript to CHECK a 3D model you wrote before presenting it \u2014 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.";
+/** The tool's JSON schema, in the shape both a gui-chat-protocol `ToolDefinition`
+ *  (`parameters`) and an MCP tool (`inputSchema`) take. */
+export declare const RENDER_SHAPE_SCRIPT_SCHEMA: {
+    type: "object";
+    properties: {
+        script: {
+            type: string;
+            description: string;
+        };
+        path: {
+            type: string;
+            description: string;
+        };
+        azimuth: {
+            type: string;
+            description: string;
+        };
+        elevation: {
+            type: string;
+            description: string;
+        };
+        zoom: {
+            type: string;
+            description: string;
+        };
+        views: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        projection: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        width: {
+            type: string;
+            description: string;
+        };
+        height: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+};
+/**
+ * The angles one call renders.
+ *
+ * The default is FOUR views, not one, and that is the point of the tool: a
+ * single projection is ambiguous about depth and occlusion, and a model asked
+ * to judge one confidently gets "which of these is in front" wrong. Three
+ * quarters around the model plus a top-down resolves it.
+ */
+export declare function viewAngles(azimuth: number, elevation: number, single: boolean): ViewAngle[];
+/** What a host has to supply: the two things that are actually its own. */
+export interface RenderToolDeps {
+    /** Read the `.shape` a `path` argument names, through this host's file layer.
+     *  Throws — with a message the agent can act on — when the path is not one it
+     *  will open. */
+    readShape: (path: string) => Promise<string>;
+    /** Persist the PNG (base64) and answer with the path the AGENT should read.
+     *  Absolute or relative is the host's call: it depends on where its sessions
+     *  run, and only the host knows that. */
+    saveImage: (base64: string) => Promise<string>;
+    /** Optional host logger for anything the host should record but the model does
+     *  not need as an error — a browser that would not close, and the unavailable
+     *  browser below. */
+    onWarning?: (message: string) => void;
+}
+/** What one call did. `rendered: false` means the tool answered without an image
+ *  — today only a host with no usable browser.
+ *
+ *  The flag exists because the two outcomes look identical from the outside: both
+ *  return a sentence for the model. Before the extraction the host logged
+ *  `unavailable` on this path and `ok` on the other; collapsing them to a string
+ *  made a missing Chromium invisible to host monitoring while the host went on
+ *  logging success (codex on #3060). A host that ignores the flag still behaves
+ *  correctly — it just cannot tell the two apart, which is the caller's choice
+ *  to make rather than this function's. */
+export interface RenderToolResult {
+    /** The sentence the agent reads — the saved path, or why there is none. */
+    message: string;
+    rendered: boolean;
+}
+/**
+ * Run one `renderShapeScript` call.
+ *
+ * A missing browser comes back as a message rather than a throw: the model can
+ * do nothing about it, and the useful response is the install hint plus "carry
+ * on without me". Everything else throws, so a host's own error path reports it.
+ */
+/** The renderer's options for one call: every model-supplied number defaulted and
+ *  clamped, so nothing downstream has to wonder whether it was checked. */
+export declare function renderOptionsFrom(args: Record<string, unknown>, script: string, views: readonly ViewAngle[], onWarning?: (message: string) => void): {
+    onWarning?: (message: string) => void;
+    script: string;
+    views: readonly ViewAngle[];
+    width: number;
+    height: number;
+    zoom: number;
+    projection: "perspective" | "orthographic";
+};
+/** What the model is told about a sheet that WAS produced. The captions are
+ *  repeated here rather than left to the image alone: a model that has not opened
+ *  the file yet still knows which angles it is about to see. */
+export declare function savedMessage(imagePath: string, views: readonly ViewAngle[]): string;
+export declare function executeRenderShapeScript(deps: RenderToolDeps, args: Record<string, unknown>): Promise<RenderToolResult>;
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/render/tool.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAcxC;;;sCAGsC;AACtC,eAAO,MAAM,sBAAsB,QAA4B,CAAC;AAEhE,eAAO,MAAM,6BAA6B,sBAAsB,CAAC;AAEjE,eAAO,MAAM,+BAA+B,qaACmX,CAAC;AAEha,eAAO,MAAM,0BAA0B,kWACqT,CAAC;AAE7V;2DAC2D;AAC3D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2CrB,MAAM,EAAE;CACzB,CAAC;AAcF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,CAa3F;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B;;qBAEiB;IACjB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C;;6CAEyC;IACzC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C;;yBAEqB;IACrB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAWD;;;;;;;;;2CAS2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH;2EAC2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;0BAAf,MAAM,KAAK,IAAI;;;;;;;EAUlJ;AAED;;gEAEgE;AAChE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAInF;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiB7H"}

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?.(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 ee(){try{let e=await import(`puppeteer`);return D(e)?e:c.In(e)&&D(e.default)?e.default:null}catch{return null}}function te(){try{return(0,u.createRequire)(E.resolve(`@mulmoclaude/shapescript-plugin/package.json`))}catch{return E}}function O(){let e=te().resolve(`three`);return e.endsWith(`three.cjs`)?e.replace(/three\.cjs$/,`three.module.js`):e}var k=`https://shapescript.invalid`,A=`${k}/render.html`,j=`./three.module.js`;async function M(e,t,n){let r;try{r=new URL(e)}catch{return null}if(r.origin!==k)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 N(e,t){let n=f.default.dirname(O());await e.setRequestInterception(!0),e.on(`request`,e=>{(async()=>{try{let r=await M(e.url(),t,n);await(r?e.respond({status:200,...r}):e.abort())}catch{}})()})}async function P(e){let t=await ee();if(!t)throw new C(S);let n=c.n(c.Pn(e.script)).toJSON(),r=g({...e,threeUrl:j,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 N(e,r),await e.goto(A,{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.onWarning,`chromium close failed: ${v(t)}`))}}var F=30,I=25,L=1,R=480,z=900,B=160,V=85,H=x+3e4,U=`renderShapeScript`,W="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.",G=`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.`,K={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 ${F}. 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 ${I}. 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 ${R}, clamped to ${B}–${z}.`},height:{type:`number`,description:`Pixel height of ONE view. Default ${R}, clamped to ${B}–${z}.`}},required:[]};function q(e,t){return typeof e!=`number`||!Number.isFinite(e)?t:Math.min(z,Math.max(B,Math.round(e)))}function J(e,t){return typeof e==`number`&&Number.isFinite(e)?e:t}var Y=e=>`${Math.round(e)}°`;function X(e,t,n){let r=(e,t,n)=>({azimuth:e,elevation:t,label:`${n} — az ${Y(e)}, el ${Y(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,V,`top`)]}async function Z(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 Q(e,t,n,r){return{script:t,views:n,width:q(e.width,R),height:q(e.height,R),zoom:Math.max(J(e.zoom,L),.01),projection:e.projection===`orthographic`?`orthographic`:`perspective`,...r?{onWarning:r}:{}}}function $(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 ne(e,t){let n=await Z(e,t),r=X(J(t.azimuth,F),J(t.elevation,I),t.views===`single`);try{let i=await P(Q(t,n,r,e.onWarning));return{message:$(await e.saveImage(i),r),rendered:!0}}catch(t){if(t instanceof C)return w(e.onWarning,`renderShapeScript: unavailable — ${t.message}`),{message:t.message,rendered:!1};throw t}}exports.CHROMIUM_HINT=S,exports.LAUNCH_TIMEOUT_MS=b,exports.RENDER_BUDGET_MS=x,exports.RENDER_SHAPE_SCRIPT_DESCRIPTION=W,exports.RENDER_SHAPE_SCRIPT_PROMPT=G,exports.RENDER_SHAPE_SCRIPT_SCHEMA=K,exports.RENDER_SHAPE_SCRIPT_TOOL_NAME=U,exports.RENDER_TIMEOUT_MS=y,exports.RENDER_TOOL_TIMEOUT_MS=H,exports.RenderUnavailableError=C,exports.buildRenderPage=g,exports.executeRenderShapeScript=ne,exports.gridFor=p,exports.renderOptionsFrom=Q,exports.renderShapeScriptSheet=P,exports.savedMessage=$,exports.viewAngles=X;