@mulmoclaude/shapescript-plugin 1.0.0

package/README.md

@@ -0,0 +1,61 @@
+# @mulmoclaude/shapescript-plugin
+
+`presentShapeScript` — interactive 3D visualizations authored in the **ShapeScript** language.
+The plugin ships its own ShapeScript parser / evaluator and a Three.js renderer (CSG via
+`three-bvh-csg`), so a model is described as text and rendered in the chat canvas.
+
+Ported from [`@gui-chat-plugin/present3d`](https://github.com/receptron/GUIChatPluginPresent3D)
+(MIT, same authors). The tool is named `presentShapeScript` here — the upstream `present3D`
+name, and the `Present3D*` type names, are renamed throughout.
+
+## Exports
+
+| Entry         | Contents                                                                                                                 |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `.`           | `TOOL_NAME`, `TOOL_DEFINITION`, `executePresentShapeScript`, `pluginCore`, `samples`, `parseShapeScript`, `astToThreeJS` |
+| `./vue`       | the `ToolPlugin` (View + Preview + `SYSTEM_PROMPT`), plus everything on `.`                                              |
+| `./style.css` | the compiled component styles (Vite lib mode does not auto-inject them)                                                  |
+
+```ts
+import type { ToolContext } from "gui-chat-protocol";
+import { executePresentShapeScript } from "@mulmoclaude/shapescript-plugin";
+
+// The handler does not read the context; the host passes its own.
+const context = {} as ToolContext;
+
+const result = await executePresentShapeScript(context, {
+  title: "Circular Pattern",
+  script: `
+define count 12
+for i in 1 to count {
+    define angle ((i / count) * 6.283)
+    cube {
+        position (cos(angle) * 3) 0 (sin(angle) * 3)
+        color (i / count) 0.5 (1 - i / count)
+        size 0.5
+    }
+}`,
+});
+```
+
+## ShapeScript language
+
+- **Primitives**: `cube`, `sphere`, `cylinder`, `cone`, `torus`, `circle`, `square`, `polygon`
+- **Properties**: `position X Y Z`, `rotation X Y Z`, `size X Y Z`, `color R G B` (0–1), `opacity`
+- **CSG**: `union`, `difference`, `intersection`, `xor`, `stencil`
+- **Builders**: `extrude`, `loft`, `lathe`, `fill`, `hull`
+- **Variables & expressions**: `define`, arithmetic / comparison / boolean operators, parentheses
+- **Control flow**: `for … in … to … step`, `if` / `else`, `switch` / `case`
+- **Built-ins**: `round floor ceil abs sign sqrt pow min max`, `sin cos tan asin acos atan atan2`
+  (radians), `dot cross length normalize sum`
+
+A function call takes **no space** before its parenthesis: `sin(x)` is a call, `sin (x)` is not.
+
+## Scripts
+
+```bash
+yarn build      # vite build + d.ts emit
+yarn typecheck  # vue-tsc --noEmit
+yarn lint
+yarn test       # node:test — tool execute + parser + Three.js conversion
+```

package/dist/core/definition.d.ts

@@ -0,0 +1,21 @@
+export declare const TOOL_NAME = "presentShapeScript";
+export declare const TOOL_DEFINITION: {
+    type: "function";
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            title: {
+                type: string;
+                description: string;
+            };
+            script: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=definition.d.ts.map

package/dist/core/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/core/definition.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,uBAAuB,CAAC;AAE9C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CA4I3B,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+export type { PresentShapeScriptData, PresentShapeScriptArgs, PresentShapeScriptResult, PresentShapeScriptRenderedResult } from "./types";
+export { TOOL_NAME, TOOL_DEFINITION } from "./definition";
+export { pluginCore, presentShapeScript, executePresentShapeScript } from "./plugin";
+export { samples } from "./samples";
+export { parseShapeScript } from "../shapescript/parser";
+export { astToThreeJS } from "../shapescript/toThreeJS";
+export type { SceneNode } from "../shapescript/types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,SAAS,CAAC;AAC1I,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/plugin.d.ts

@@ -0,0 +1,8 @@
+import type { ToolContext, ToolPluginCore } from "gui-chat-protocol";
+import type { PresentShapeScriptArgs, PresentShapeScriptData, PresentShapeScriptRenderedResult } from "./types";
+import { TOOL_NAME, TOOL_DEFINITION } from "./definition";
+export declare const presentShapeScript: (_context: ToolContext, args: PresentShapeScriptArgs) => Promise<PresentShapeScriptRenderedResult>;
+export declare const pluginCore: ToolPluginCore<PresentShapeScriptData, unknown, PresentShapeScriptArgs>;
+export { TOOL_NAME, TOOL_DEFINITION };
+export declare const executePresentShapeScript: (_context: ToolContext, args: PresentShapeScriptArgs) => Promise<PresentShapeScriptRenderedResult>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/core/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/core/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,gCAAgC,EAAE,MAAM,SAAS,CAAC;AAChH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAK1D,eAAO,MAAM,kBAAkB,GAAU,UAAU,WAAW,EAAE,MAAM,sBAAsB,KAAG,OAAO,CAAC,gCAAgC,CAkBtI,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,sBAAsB,EAAE,OAAO,EAAE,sBAAsB,CAM9F,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACtC,eAAO,MAAM,yBAAyB,aA7Ba,WAAW,QAAQ,sBAAsB,KAAG,OAAO,CAAC,gCAAgC,CA6B5E,CAAC"}

package/dist/core/samples.d.ts

@@ -0,0 +1,3 @@
+import type { ToolSample } from "gui-chat-protocol";
+export declare const samples: ToolSample[];
+//# sourceMappingURL=samples.d.ts.map

package/dist/core/samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples.d.ts","sourceRoot":"","sources":["../../src/core/samples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,OAAO,EAAE,UAAU,EA2D/B,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,22 @@
+import type { ToolResult } from "gui-chat-protocol";
+export interface PresentShapeScriptData {
+    script: string;
+}
+export interface PresentShapeScriptArgs {
+    title: string;
+    script: string;
+}
+export type PresentShapeScriptResult = ToolResult<PresentShapeScriptData>;
+/** The success shape of `presentShapeScript`.
+ *
+ *  `data` is REQUIRED here, not optional as on `ToolResult`, because it is the
+ *  host's render-eligibility signal: MulmoClaude's MCP bridge only pushes a
+ *  tool result into the session — the event the canvas renders the View from —
+ *  when the handler set `data`. A result without it is a narrate-only call, so
+ *  the LLM would report success while the user saw no 3D view at all. Typing it
+ *  as required means dropping it cannot compile.
+ */
+export type PresentShapeScriptRenderedResult = PresentShapeScriptResult & {
+    data: PresentShapeScriptData;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,GAAG;IACxE,IAAI,EAAE,sBAAsB,CAAC;CAC9B,CAAC"}

package/dist/core.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./toThreeJS-CtWReTrz.cjs");exports.TOOL_DEFINITION=e.Ln,exports.TOOL_NAME=e.Rn,exports.astToThreeJS=e.t,exports.executePresentShapeScript=e.Pn,exports.parseShapeScript=e.Mn,exports.pluginCore=e.Fn,exports.presentShapeScript=e.In,exports.samples=e.Nn;

package/dist/core.js

@@ -0,0 +1,2 @@
+import { Fn as e, In as t, Ln as n, Mn as r, Nn as i, Pn as a, Rn as o, t as s } from "./toThreeJS-DjFysw4f.js";
+export { n as TOOL_DEFINITION, o as TOOL_NAME, s as astToThreeJS, a as executePresentShapeScript, r as parseShapeScript, e as pluginCore, t as presentShapeScript, i as samples };

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./toThreeJS-CtWReTrz.cjs");require("./core.cjs"),exports.TOOL_DEFINITION=e.Ln,exports.TOOL_NAME=e.Rn,exports.astToThreeJS=e.t,exports.executePresentShapeScript=e.Pn,exports.parseShapeScript=e.Mn,exports.pluginCore=e.Fn,exports.presentShapeScript=e.In,exports.samples=e.Nn;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/index";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+import { Fn as e, In as t, Ln as n, Mn as r, Nn as i, Pn as a, Rn as o, t as s } from "./toThreeJS-DjFysw4f.js";
+import "./core.js";
+export { n as TOOL_DEFINITION, o as TOOL_NAME, s as astToThreeJS, a as executePresentShapeScript, r as parseShapeScript, e as pluginCore, t as presentShapeScript, i as samples };

package/dist/lang/de.d.ts

@@ -0,0 +1,4 @@
+import type { Messages } from "./messages";
+declare const de: Messages;
+export default de;
+//# sourceMappingURL=de.d.ts.map

package/dist/lang/de.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../src/lang/de.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/en.d.ts

@@ -0,0 +1,4 @@
+import type { Messages } from "./messages";
+declare const en: Messages;
+export default en;
+//# sourceMappingURL=en.d.ts.map

package/dist/lang/en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/lang/en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/es.d.ts

@@ -0,0 +1,4 @@
+import type { Messages } from "./messages";
+declare const es: Messages;
+export default es;
+//# sourceMappingURL=es.d.ts.map

package/dist/lang/es.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/lang/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/fr.d.ts

@@ -0,0 +1,4 @@
+import type { Messages } from "./messages";
+declare const fr: Messages;
+export default fr;
+//# sourceMappingURL=fr.d.ts.map

package/dist/lang/fr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fr.d.ts","sourceRoot":"","sources":["../../src/lang/fr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/index.d.ts

@@ -0,0 +1,7 @@
+import type { Messages } from "./messages";
+/** Reactive message bundle for the active host locale. The plugin carries its
+ *  own translations (no host i18n dependency); it reads the locale off the
+ *  injected `BrowserPluginRuntime.locale` ref and falls back to English. */
+export declare const useT: () => import("vue").ComputedRef<Messages>;
+export type { Messages };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lang/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAY3C;;4EAE4E;AAC5E,eAAO,MAAM,IAAI,2CAAuB,CAAC;AAEzC,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/lang/ja.d.ts

@@ -0,0 +1,4 @@
+import type { Messages } from "./messages";
+declare const ja: Messages;
+export default ja;
+//# sourceMappingURL=ja.d.ts.map

package/dist/lang/ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ja.d.ts","sourceRoot":"","sources":["../../src/lang/ja.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/ko.d.ts

@@ -0,0 +1,4 @@
+import type { Messages } from "./messages";
+declare const ko: Messages;
+export default ko;
+//# sourceMappingURL=ko.d.ts.map

package/dist/lang/ko.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ko.d.ts","sourceRoot":"","sources":["../../src/lang/ko.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/messages.d.ts

@@ -0,0 +1,11 @@
+export interface Messages {
+    untitled: string;
+    resetCamera: string;
+    wireframe: string;
+    grid: string;
+    parseError: string;
+    editSource: string;
+    scriptEditorLabel: string;
+    applyChanges: string;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/lang/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/lang/messages.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/lang/ptBR.d.ts

@@ -0,0 +1,4 @@
+import type { Messages } from "./messages";
+declare const ptBR: Messages;
+export default ptBR;
+//# sourceMappingURL=ptBR.d.ts.map

package/dist/lang/ptBR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ptBR.d.ts","sourceRoot":"","sources":["../../src/lang/ptBR.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,IAAI,EAAE,QASX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/lang/zh.d.ts

@@ -0,0 +1,4 @@
+import type { Messages } from "./messages";
+declare const zh: Messages;
+export default zh;
+//# sourceMappingURL=zh.d.ts.map

package/dist/lang/zh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh.d.ts","sourceRoot":"","sources":["../../src/lang/zh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/shapescript/dispose.d.ts

@@ -0,0 +1,16 @@
+import * as THREE from "three";
+/** Release the GPU-side resources of `root` and everything under it. The object
+ *  must already be detached (or about to be) — this does not touch parents. */
+export declare function disposeObject3D(root: THREE.Object3D): void;
+/** Free every object in `scratch` except the resources `keep` still draws with.
+ *
+ *  For intermediates that never reach the scene — the cloned meshes and Brushes
+ *  a CSG block builds, and the operands each `evaluate()` consumes. Nothing
+ *  disposes those otherwise, since scene teardown only walks what was added to
+ *  the scene. `keep` is excluded by RESOURCE, not by identity, because the
+ *  survivor routinely shares a geometry or material with a discarded operand. */
+export declare function disposeScratch(scratch: readonly THREE.Object3D[], keep: THREE.Object3D): void;
+/** Detach `root` from `parent` and free it. Safe with a null/undefined root so
+ *  callers can hand over a ref that has not been filled in yet. */
+export declare function removeAndDispose(parent: THREE.Object3D | undefined, root: THREE.Object3D | null | undefined): void;
+//# sourceMappingURL=dispose.d.ts.map

package/dist/shapescript/dispose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispose.d.ts","sourceRoot":"","sources":["../../src/shapescript/dispose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAsD/B;+EAC+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAE1D;AAED;;;;;;iFAMiF;AACjF,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAQ7F;AAED;mEACmE;AACnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAIlH"}

package/dist/shapescript/evaluator.d.ts

@@ -0,0 +1,22 @@
+import { Expression, Vector3, Color } from "./types";
+export type Value = number | boolean | string | Value[];
+export declare class SymbolTable {
+    private scopes;
+    constructor();
+    pushScope(): void;
+    popScope(): void;
+    set(name: string, value: Value): void;
+    get(name: string): Value | undefined;
+    has(name: string): boolean;
+}
+export declare class Evaluator {
+    private symbols;
+    constructor(symbols?: SymbolTable);
+    getSymbols(): SymbolTable;
+    evaluate(expr: Expression | number | string | Vector3 | Color): Value;
+    evaluateToNumber(expr: Expression | number): number;
+    evaluateToBoolean(expr: Expression): boolean;
+    evaluateToVector3(expr: Expression | Vector3): Vector3;
+    evaluateToColor(expr: Expression | Color): Color;
+}
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/shapescript/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/shapescript/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC;AAExD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA4B;;IAM1C,SAAS,IAAI,IAAI;IAIjB,QAAQ,IAAI,IAAI;IAMhB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAMrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAWpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B;AAsHD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAc;gBAEjB,OAAO,CAAC,EAAE,WAAW;IAIjC,UAAU,IAAI,WAAW;IAIzB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK;IA0LrE,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM;IAKnD,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAK5C,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO;IAmBtD,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK;CAkBjD"}

package/dist/shapescript/parser.d.ts

@@ -0,0 +1,40 @@
+import { Token, SceneNode } from "./types";
+export declare class Parser {
+    private tokens;
+    private pos;
+    constructor(tokens: Token[]);
+    private at;
+    private current;
+    private peek;
+    private advance;
+    private expect;
+    private expectIdentifier;
+    private skipNewlines;
+    private parseExpression;
+    private parsePrimary;
+    private getPrecedence;
+    private tokenTypeToOperator;
+    private parseVectorOrExpression;
+    private parseProperties;
+    private parseBlockContents;
+    private parseBlock;
+    private parseShape;
+    private parseCSG;
+    private parseForLoop;
+    private parseIf;
+    private parseSwitch;
+    private parseDefine;
+    private parseDetail;
+    private parseBackground;
+    private parseTexture;
+    private parseGroup;
+    private parseBuilder;
+    private parsePathValue;
+    private isStartOfNewValue;
+    private parsePathPrimary;
+    private parsePath;
+    private parseNode;
+    parse(): SceneNode[];
+}
+export declare function parseShapeScript(script: string): SceneNode[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/shapescript/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/shapescript/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAEL,SAAS,EAsBV,MAAM,SAAS,CAAC;AAkejB,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,GAAG,CAAK;gBAEJ,MAAM,EAAE,KAAK,EAAE;IAO3B,OAAO,CAAC,EAAE;IAMV,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,YAAY;IAoIpB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,uBAAuB;IAuD/B,OAAO,CAAC,eAAe;IAsDvB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,YAAY;IA2EpB,OAAO,CAAC,OAAO;IA8Bf,OAAO,CAAC,WAAW;IA8EnB,OAAO,CAAC,WAAW;IA8DnB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,YAAY;IA8IpB,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,gBAAgB;IAoExB,OAAO,CAAC,SAAS;IA+NjB,OAAO,CAAC,SAAS;IA2JjB,KAAK,IAAI,SAAS,EAAE;CAarB;AAGD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAmB5D"}

package/dist/shapescript/toThreeJS.d.ts

@@ -0,0 +1,124 @@
+import * as THREE from "three";
+import { SceneNode } from "./types";
+export interface ConversionOptions {
+    wireframe?: boolean;
+    /** Hard ceiling on the objects one script may produce. See
+     *  `DEFAULT_MAX_NODES`. */
+    maxNodes?: number;
+    /** Hard ceiling on the iterations one `for` may run. See
+     *  `DEFAULT_MAX_LOOP_ITERATIONS`. */
+    maxLoopIterations?: number;
+    /** Hard ceiling on the vertices one script may allocate in total. See
+     *  `DEFAULT_MAX_VERTICES`. */
+    maxVertices?: number;
+}
+export declare const DEFAULT_MAX_NODES = 20000;
+export declare const DEFAULT_MAX_LOOP_ITERATIONS = 100000;
+export declare const MIN_DETAIL = 3;
+export declare const MAX_DETAIL = 256;
+export declare const DEFAULT_MAX_VERTICES = 2000000;
+/** Its own class so `convertCSG`'s fallback can rethrow it instead of swallowing
+ *  it: catching a budget error there would rebuild the same runaway children as
+ *  a plain group, which is the work the budget exists to refuse. */
+export declare class ShapeScriptLimitError extends Error {
+    constructor(message: string);
+}
+export declare class Converter {
+    private options;
+    private evaluator;
+    private symbols;
+    private detailLevel;
+    /** Objects produced so far, checked against `maxNodes` on every node. */
+    private nodeCount;
+    /** Vertices allocated so far, checked against `maxVertices` on every mesh. */
+    private vertexCount;
+    private transformStack;
+    constructor(options?: ConversionOptions);
+    convert(nodes: SceneNode[]): THREE.Group;
+    private get maxNodes();
+    private get maxLoopIterations();
+    private get maxVertices();
+    /** Charge an ESTIMATE before the allocation happens.
+     *
+     *  `makeMesh` charges what a geometry actually holds, which is too late for a
+     *  constructor whose inputs already predict something enormous:
+     *  `LatheGeometry` over a 100k-point profile at `detail 256` allocates ~25M
+     *  vertices — hundreds of MB on the UI thread — before there is anything to
+     *  measure. Where the count is predictable, refuse first. */
+    /** Pre-flight charge for a geometry built from a path.
+     *
+     *  `Shape.curves` is a plain array, so reading its length allocates nothing —
+     *  unlike `getPoints()`, which would build the very buffer we are trying to
+     *  refuse. A path may hold up to `maxLoopIterations` points, and at high
+     *  detail the constructor multiplies that again, so `ExtrudeGeometry` and
+     *  `ShapeGeometry` need the same treatment `LatheGeometry` got. */
+    private chargePathEstimate;
+    private chargeEstimate;
+    /** Every mesh in the scene is built here, so the AGGREGATE vertex count is
+     *  bounded and not merely the node count. Charged after the geometry exists —
+     *  one primitive is bounded by `MAX_DETAIL²`, so the allocation that trips the
+     *  limit is small, and it is freed before the refusal propagates. */
+    private makeMesh;
+    /** Expand a `for … from to to step` range without materialising it first.
+     *  The array used to be built up front, so an absurd bound exhausted memory
+     *  before a single node existed and the budget below never got a turn. */
+    private rangeIterations;
+    private convertNode;
+    /** Build `group` inside a fresh symbol + transform scope.
+     *
+     *  The `catch` is not tidiness: nothing downstream can reach a group that was
+     *  never returned. The CSG caller records a child only once conversion
+     *  returns, and the Vue callers assign the root only once `astToThreeJS`
+     *  returns — so a body that throws midway (a budget refusal, a bad
+     *  expression) strands whatever it had already built, with no owner to
+     *  dispose it. The `finally` is the other half: a throw must not leave the
+     *  scope frames behind for whatever runs next. */
+    private inScope;
+    /** The frame half on its own, for builders that return a single mesh rather
+     *  than a group: there is nothing to dispose (a geometry that trips the
+     *  budget is freed by `makeMesh`), but a throw must still not leave the
+     *  symbol and transform frames behind for whatever runs next. */
+    private inFrame;
+    /** Convert each child and add whatever it produced to `group`. Every block
+     *  form ends up doing exactly this, and jscpd was right that six copies of
+     *  the loop is five too many. */
+    private addChildren;
+    private convertBlock;
+    private convertShape;
+    private createGeometry;
+    private materialColor;
+    private createMaterial;
+    private convertCSG;
+    private convertForLoop;
+    private convertIf;
+    private convertSwitch;
+    private handleDefine;
+    private convertCustomShape;
+    private pushTransform;
+    private popTransform;
+    private currentTransform;
+    private applyCurrentTransform;
+    private applyExplicitTransforms;
+    private handleDetail;
+    private handleColorCommand;
+    private handleRotateCommand;
+    private handleOrientationCommand;
+    private handleTranslateCommand;
+    private handleScaleCommand;
+    private convertExtrude;
+    private buildPath;
+    private convertLathe;
+    private buildLathe;
+    private convertGroupBuilder;
+    private convertLoft;
+    private convertFill;
+    private convertHull;
+    private evaluateNumber;
+    private evaluateVector3;
+    private evaluateTranslateVector;
+    private evaluateColor;
+    private evaluateVector3OrColor;
+    private valuesEqual;
+}
+export declare function astToThreeJS(nodes: SceneNode[], options?: ConversionOptions): THREE.Group;
+//# sourceMappingURL=toThreeJS.d.ts.map

package/dist/shapescript/toThreeJS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toThreeJS.d.ts","sourceRoot":"","sources":["../../src/shapescript/toThreeJS.ts"],"names":[],"mappings":"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"}