@mulmoclaude/shapescript-plugin 1.4.0 → 2.0.0

package/dist/vue/index.d.ts

@@ -3,7 +3,7 @@ import type { ToolPlugin } from "gui-chat-protocol/vue";
 import type { PresentShapeScriptData, PresentShapeScriptArgs } from "../core/types";
 import View from "./View.vue";
 import Preview from "./Preview.vue";
-export declare const SYSTEM_PROMPT = "Use the presentShapeScript tool to create interactive 3D visualizations when the user requests:\n- 3D models or shapes\n- Mathematical visualizations (surfaces, functions, geometric patterns)\n- Molecular or atomic structures\n- Data visualization in 3D (scatter plots, surface plots)\n- Architectural layouts\n- Game boards or 3D game states\n- Any spatial or geometric concepts\n\n## Supported ShapeScript Features:\n\n### Variables & Expressions:\n- Define variables: define radius 2, define spacing 1.5\n- Use expressions: position (i * 2) 0 0, size (radius * 1.5)\n- Math operators: +, -, *, /, % with proper precedence\n- Parentheses for grouping: (2 + 3) * 4\n\n### Control Flow:\n\nFor loops with variables (use loop variable in calculations):\nfor i in 1 to 5 {\n    cube { position (i * 2 - 6) 0 0 size 1 }\n}\n\nFor loops with step:\nfor i in 0 to 10 step 2 {\n    sphere { position 0 i 0 }\n}\n\nIf/else conditionals:\nif x > 0 {\n    sphere\n} else {\n    cube\n}\n\nSwitch statements for multiple cases\n\n### Built-in Functions:\n- Math: round, floor, ceil, abs, sign, sqrt, pow, min, max\n- Trig: sin, cos, tan, asin, acos, atan, atan2 (radians!)\n- Vector: dot, cross, length, normalize, sum\n\nCRITICAL: Function calls require NO space between name and (\n- sin(x) \u2713 correct\n- sin (x) \u2717 wrong - this is NOT a function call!\n\n### Best Practices:\n1. Use variables for repeated values\n2. Use loop variables (i) for positioning and calculations\n3. Use trig functions for circular/spiral patterns\n4. Use conditionals for parametric designs\n5. Keep code readable with meaningful variable names\n\n### Common Patterns:\n\nLinear arrangement:\nfor i in 1 to 5 {\n    cube { position (i * 2) 0 0 }\n}\n\nCircular pattern:\ndefine count 12\nfor i in 1 to count {\n    define angle ((i / count) * 6.283)\n    cube { position (cos(angle) * 3) 0 (sin(angle) * 3) }\n}\n\nParametric surface:\nfor x in -5 to 5 {\n    for z in -5 to 5 {\n        define y (sin(x * 0.5) * cos(z * 0.5))\n        cube { position (x * 0.3) y (z * 0.3) size 0.2 }\n    }\n}\n\n### Primitives & CSG:\nShapes: cube, sphere, cylinder, cone, torus\nCSG: union, difference, intersection, xor, stencil\nProperties: position, rotation, size, color, opacity\n\nBuilders: extrude, fill, lathe, loft, hull. Example: loft { square translate 0 0 2 circle }.\nStencil preserves the first shape's volume and paints the intersecting surface.\nConstants: pi, tau, true, false. Tuple/string access: values[0], vector.x, value.count.\nPolygon supports sides (3\u2013256). String literals and join/trim are supported.\nUse the tool schema for exact syntax and builder limits. This is a modeling subset of upstream ShapeScript;\nimports, textures, text/fonts and general user-defined functions are not supported.\nIf presentShapeScript returns an error diagnostic, correct the script and retry; no visualization was created.\n\nKeep visualizations clear, well-organized, and use expressions and control flow.";
+export declare const SYSTEM_PROMPT = "Use the presentShapeScript tool to create interactive 3D visualizations when the user requests:\n- 3D models or shapes\n- Mathematical visualizations (surfaces, functions, geometric patterns)\n- Molecular or atomic structures\n- Data visualization in 3D (scatter plots, surface plots)\n- Architectural layouts\n- Game boards or 3D game states\n- Any spatial or geometric concepts\n\n## Supported ShapeScript Features:\n\n### Variables & Expressions:\n- Define variables: define radius 2, define spacing 1.5\n- Use expressions: position (i * 2) 0 0, size (radius * 1.5)\n- Math operators: +, -, *, /, % with proper precedence\n- Parentheses for grouping: (2 + 3) * 4\n\n### Control Flow:\n\nFor loops with variables (use loop variable in calculations):\nfor i in 1 to 5 {\n    cube {\n        position (i * 2 - 6) 0 0\n        size 1\n    }\n}\n\nFor loops with step:\nfor i in 0 to 10 step 2 {\n    sphere { position 0 i 0 }\n}\n\nIf/else conditionals:\nif x > 0 {\n    sphere\n} else {\n    cube\n}\n\nSwitch statements for multiple cases\n\n### Built-in Functions:\n- Math: round, floor, ceil, abs, sign, sqrt, pow, min, max\n- Trig: sin, cos, tan, asin, acos, atan, atan2 (radians!)\n- Vector: dot, cross, length, normalize, sum\n\nCRITICAL: Function calls require NO space between name and (\n- sin(x) \u2713 correct\n- sin (x) \u2717 wrong - this is NOT a function call!\nSeparate arguments with spaces, upstream style: max(0 (j - 1)). Commas work here but not in the upstream app.\nOne statement per line; the upstream app rejects two statements on one line.\n\n### Best Practices:\n1. Use variables for repeated values\n2. Use loop variables (i) for positioning and calculations\n3. Use trig functions for circular/spiral patterns\n4. Use conditionals for parametric designs\n5. Keep code readable with meaningful variable names\n\n### Common Patterns:\n\nLinear arrangement:\nfor i in 1 to 5 {\n    cube { position (i * 2) 0 0 }\n}\n\nCircular pattern:\ndefine count 12\nfor i in 1 to count {\n    define angle ((i / count) * 6.283)\n    cube { position (cos(angle) * 3) 0 (sin(angle) * 3) }\n}\n\nParametric surface:\nfor x in -5 to 5 {\n    for z in -5 to 5 {\n        define y (sin(x * 0.5) * cos(z * 0.5))\n        cube {\n            position (x * 0.3) y (z * 0.3)\n            size 0.2\n        }\n    }\n}\n\n### Primitives & CSG:\nShapes: cube, sphere, cylinder, cone, torus\nCSG: union, difference, intersection, xor, stencil\nProperties: position, orientation (alias rotation), size, color, opacity\n\n### Units (upstream ShapeScript conventions):\n- size = DIAMETER for sphere/cylinder/cone/circle/polygon/torus, edge length for cube/square. A bare sphere fits the unit cube.\n- orientation / rotate = HALF-TURNS as roll yaw pitch (Z, Y, X): 0.5 = 90\u00B0. A lone value is a roll. Trig functions still use radians.\n- Path point/curve coordinates are absolute; curve is a B\u00E9zier control point; rotate/translate/scale inside a path move the frame.\n- A path can carry its own position/orientation/size; give loft/extrude path children (not fill{}), as the upstream app requires.\n\nBuilders: extrude, fill, lathe, loft, hull. Example:\nloft {\n    square\n    translate 0 0 2\n    circle\n}\nStencil preserves the first shape's volume and paints the intersecting surface.\nConstants: pi, true, false (avoid tau, upstream lacks it; write 2 * pi). Tuple/string access: values[0], vector.x, value.count.\nPolygon supports sides (3\u2013256). String literals and join/trim are supported.\nUse the tool schema for exact syntax and builder limits. This is a modeling subset of upstream ShapeScript;\nimports, textures, text/fonts and general user-defined functions are not supported.\nIf presentShapeScript returns an error diagnostic, correct the script and retry; no visualization was created.\n\nKeep visualizations clear, well-organized, and use expressions and control flow.";
 export declare const plugin: ToolPlugin<PresentShapeScriptData, unknown, PresentShapeScriptArgs>;
 export type { PresentShapeScriptData, PresentShapeScriptArgs, PresentShapeScriptResult, PresentShapeScriptRenderedResult, PresentShapeScriptErrorResult, PresentShapeScriptExecutionResult, ShapeScriptDiagnostic, } from "../core/types";
 export { TOOL_NAME, TOOL_DEFINITION } from "../core/definition";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAIpF,OAAO,IAAI,MAAM,YAAY,CAAC;AAC9B,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC,eAAO,MAAM,aAAa,i7FAyFuD,CAAC;AAElF,eAAO,MAAM,MAAM,EAAE,UAAU,CAAC,sBAAsB,EAAE,OAAO,EAAE,sBAAsB,CAMtF,CAAC;AAEF,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvG,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAGzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;;;;AAEtD,wBAA0B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAIpF,OAAO,IAAI,MAAM,YAAY,CAAC;AAC9B,OAAO,OAAO,MAAM,eAAe,CAAC;AAEpC,eAAO,MAAM,aAAa,8zHA4GuD,CAAC;AAElF,eAAO,MAAM,MAAM,EAAE,UAAU,CAAC,sBAAsB,EAAE,OAAO,EAAE,sBAAsB,CAMtF,CAAC;AAEF,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvG,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAGzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;;;;AAEtD,wBAA0B"}

package/dist/vue.cjs

@@ -1,4 +1,4 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./samples-DZNAeuSZ.cjs"),t=require("./toThreeJS-XGDoVISb.cjs");let n=require("vue"),r=require("gui-chat-protocol/vue");function i(){let e=null,t=!1,n=null,r=null;function i(t,a){n(t,a),r=e.requestAnimationFrame(i)}return{start:function(){t!==!0&&n!==null&&e!==null&&(r=e.requestAnimationFrame(i),t=!0)},stop:function(){e!==null&&e.cancelAnimationFrame(r),t=!1},setAnimationLoop:function(e){n=e},setContext:function(t){e=t}}}function a(e){let t=new WeakMap;function n(t,n){let r=t.array,i=t.usage,a=r.byteLength,o=e.createBuffer();e.bindBuffer(n,o),e.bufferData(n,r,i),t.onUploadCallback();let s;if(r instanceof Float32Array)s=e.FLOAT;else if(typeof Float16Array<`u`&&r instanceof Float16Array)s=e.HALF_FLOAT;else if(r instanceof Uint16Array)s=t.isFloat16BufferAttribute?e.HALF_FLOAT:e.UNSIGNED_SHORT;else if(r instanceof Int16Array)s=e.SHORT;else if(r instanceof Uint32Array)s=e.UNSIGNED_INT;else if(r instanceof Int32Array)s=e.INT;else if(r instanceof Int8Array)s=e.BYTE;else if(r instanceof Uint8Array)s=e.UNSIGNED_BYTE;else if(r instanceof Uint8ClampedArray)s=e.UNSIGNED_BYTE;else throw Error(`THREE.WebGLAttributes: Unsupported buffer data format: `+r);return{buffer:o,type:s,bytesPerElement:r.BYTES_PER_ELEMENT,version:t.version,size:a}}function r(t,n,r){let i=n.array,a=n.updateRanges;if(e.bindBuffer(r,t),a.length===0)e.bufferSubData(r,0,i);else{a.sort((e,t)=>e.start-t.start);let t=0;for(let e=1;e<a.length;e++){let n=a[t],r=a[e];r.start<=n.start+n.count+1?n.count=Math.max(n.count,r.start+r.count-n.start):(++t,a[t]=r)}a.length=t+1;for(let t=0,n=a.length;t<n;t++){let n=a[t];e.bufferSubData(r,n.start*i.BYTES_PER_ELEMENT,i,n.start,n.count)}n.clearUpdateRanges()}n.onUploadCallback()}function i(e){return e.isInterleavedBufferAttribute&&(e=e.data),t.get(e)}function a(n){n.isInterleavedBufferAttribute&&(n=n.data);let r=t.get(n);r&&(e.deleteBuffer(r.buffer),t.delete(n))}function o(e,i){if(e.isInterleavedBufferAttribute&&(e=e.data),e.isGLBufferAttribute){let n=t.get(e);(!n||n.version<e.version)&&t.set(e,{buffer:e.buffer,type:e.type,bytesPerElement:e.elementSize,version:e.version});return}let a=t.get(e);if(a===void 0)t.set(e,n(e,i));else if(a.version<e.version){if(a.size!==e.array.byteLength)throw Error(`THREE.WebGLAttributes: The size of the buffer attribute's array buffer does not match the original size. Resizing buffer attributes is not supported.`);r(a.buffer,e,i),a.version=e.version}}return{get:i,remove:a,update:o}}var o={alphahash_fragment:`#ifdef USE_ALPHAHASH
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./samples-DGD0Kjwg.cjs"),t=require("./toThreeJS-MvllBF9e.cjs");let n=require("vue"),r=require("gui-chat-protocol/vue");function i(){let e=null,t=!1,n=null,r=null;function i(t,a){n(t,a),r=e.requestAnimationFrame(i)}return{start:function(){t!==!0&&n!==null&&e!==null&&(r=e.requestAnimationFrame(i),t=!0)},stop:function(){e!==null&&e.cancelAnimationFrame(r),t=!1},setAnimationLoop:function(e){n=e},setContext:function(t){e=t}}}function a(e){let t=new WeakMap;function n(t,n){let r=t.array,i=t.usage,a=r.byteLength,o=e.createBuffer();e.bindBuffer(n,o),e.bufferData(n,r,i),t.onUploadCallback();let s;if(r instanceof Float32Array)s=e.FLOAT;else if(typeof Float16Array<`u`&&r instanceof Float16Array)s=e.HALF_FLOAT;else if(r instanceof Uint16Array)s=t.isFloat16BufferAttribute?e.HALF_FLOAT:e.UNSIGNED_SHORT;else if(r instanceof Int16Array)s=e.SHORT;else if(r instanceof Uint32Array)s=e.UNSIGNED_INT;else if(r instanceof Int32Array)s=e.INT;else if(r instanceof Int8Array)s=e.BYTE;else if(r instanceof Uint8Array)s=e.UNSIGNED_BYTE;else if(r instanceof Uint8ClampedArray)s=e.UNSIGNED_BYTE;else throw Error(`THREE.WebGLAttributes: Unsupported buffer data format: `+r);return{buffer:o,type:s,bytesPerElement:r.BYTES_PER_ELEMENT,version:t.version,size:a}}function r(t,n,r){let i=n.array,a=n.updateRanges;if(e.bindBuffer(r,t),a.length===0)e.bufferSubData(r,0,i);else{a.sort((e,t)=>e.start-t.start);let t=0;for(let e=1;e<a.length;e++){let n=a[t],r=a[e];r.start<=n.start+n.count+1?n.count=Math.max(n.count,r.start+r.count-n.start):(++t,a[t]=r)}a.length=t+1;for(let t=0,n=a.length;t<n;t++){let n=a[t];e.bufferSubData(r,n.start*i.BYTES_PER_ELEMENT,i,n.start,n.count)}n.clearUpdateRanges()}n.onUploadCallback()}function i(e){return e.isInterleavedBufferAttribute&&(e=e.data),t.get(e)}function a(n){n.isInterleavedBufferAttribute&&(n=n.data);let r=t.get(n);r&&(e.deleteBuffer(r.buffer),t.delete(n))}function o(e,i){if(e.isInterleavedBufferAttribute&&(e=e.data),e.isGLBufferAttribute){let n=t.get(e);(!n||n.version<e.version)&&t.set(e,{buffer:e.buffer,type:e.type,bytesPerElement:e.elementSize,version:e.version});return}let a=t.get(e);if(a===void 0)t.set(e,n(e,i));else if(a.version<e.version){if(a.size!==e.array.byteLength)throw Error(`THREE.WebGLAttributes: The size of the buffer attribute's array buffer does not match the original size. Resizing buffer attributes is not supported.`);r(a.buffer,e,i),a.version=e.version}}return{get:i,remove:a,update:o}}var o={alphahash_fragment:`#ifdef USE_ALPHAHASH
 	if ( diffuseColor.a < getAlphaHashThreshold( vPosition ) ) discard;
 #endif`,alphahash_pars_fragment:`#ifdef USE_ALPHAHASH
 	const float ALPHA_HASH_SCALE = 0.05;
@@ -4122,7 +4122,10 @@ void main() {
 
 For loops with variables (use loop variable in calculations):
 for i in 1 to 5 {
-    cube { position (i * 2 - 6) 0 0 size 1 }
+    cube {
+        position (i * 2 - 6) 0 0
+        size 1
+    }
 }
 
 For loops with step:
@@ -4147,6 +4150,8 @@ Switch statements for multiple cases
 CRITICAL: Function calls require NO space between name and (
 - sin(x) ✓ correct
 - sin (x) ✗ wrong - this is NOT a function call!
+Separate arguments with spaces, upstream style: max(0 (j - 1)). Commas work here but not in the upstream app.
+One statement per line; the upstream app rejects two statements on one line.
 
 ### Best Practices:
 1. Use variables for repeated values
@@ -4173,18 +4178,32 @@ Parametric surface:
 for x in -5 to 5 {
     for z in -5 to 5 {
         define y (sin(x * 0.5) * cos(z * 0.5))
-        cube { position (x * 0.3) y (z * 0.3) size 0.2 }
+        cube {
+            position (x * 0.3) y (z * 0.3)
+            size 0.2
+        }
     }
 }
 
 ### Primitives & CSG:
 Shapes: cube, sphere, cylinder, cone, torus
 CSG: union, difference, intersection, xor, stencil
-Properties: position, rotation, size, color, opacity
-
-Builders: extrude, fill, lathe, loft, hull. Example: loft { square translate 0 0 2 circle }.
+Properties: position, orientation (alias rotation), size, color, opacity
+
+### Units (upstream ShapeScript conventions):
+- size = DIAMETER for sphere/cylinder/cone/circle/polygon/torus, edge length for cube/square. A bare sphere fits the unit cube.
+- orientation / rotate = HALF-TURNS as roll yaw pitch (Z, Y, X): 0.5 = 90°. A lone value is a roll. Trig functions still use radians.
+- Path point/curve coordinates are absolute; curve is a Bézier control point; rotate/translate/scale inside a path move the frame.
+- A path can carry its own position/orientation/size; give loft/extrude path children (not fill{}), as the upstream app requires.
+
+Builders: extrude, fill, lathe, loft, hull. Example:
+loft {
+    square
+    translate 0 0 2
+    circle
+}
 Stencil preserves the first shape's volume and paints the intersecting surface.
-Constants: pi, tau, true, false. Tuple/string access: values[0], vector.x, value.count.
+Constants: pi, true, false (avoid tau, upstream lacks it; write 2 * pi). Tuple/string access: values[0], vector.x, value.count.
 Polygon supports sides (3–256). String literals and join/trim are supported.
 Use the tool schema for exact syntax and builder limits. This is a modeling subset of upstream ShapeScript;
 imports, textures, text/fonts and general user-defined functions are not supported.

package/dist/vue.js

@@ -1,5 +1,5 @@
-import { a as e, h as t, n, o as r, r as i, s as a, t as o, v as s, y as c } from "./samples-DPOGWslc.js";
-import { $ as l, A as u, An as d, B as f, Bn as p, C as m, Cn as h, D as g, Dn as _, E as v, En as y, Fn as b, G as x, Gt as S, H as C, Ht as w, I as T, In as E, J as D, Jt as O, K as k, L as A, Mn as j, N as M, Nn as ee, O as te, On as N, P as ne, Pn as P, Q as re, R as ie, S as ae, Sn as oe, T as F, Tn as se, U as ce, Ut as I, V as L, Vn as le, W as R, Wt as ue, X as de, Y as z, Yt as fe, Z as B, _ as pe, _n as me, a as he, an as ge, at as _e, b as ve, bn as V, c as ye, cn as be, d as xe, dn as Se, dt as Ce, en as we, et as Te, ft as Ee, g as De, gn as Oe, h as H, hn as ke, i as Ae, j as je, jn as Me, k as Ne, kn as Pe, l as U, ln as Fe, m as W, nn as Ie, nt as Le, on as G, p as Re, pn as ze, q as K, qt as Be, r as q, rn as Ve, rt as He, s as Ue, sn as We, st as Ge, tn as Ke, tt as qe, u as Je, un as Ye, v as Xe, vn as Ze, w as Qe, wn as $e, x as et, xn as tt, y as nt, yn as J, z as rt, zn as it } from "./toThreeJS-BX_aeGdA.js";
+import { a as e, h as t, n, o as r, r as i, s as a, t as o, v as s, y as c } from "./samples-CXhuDdDd.js";
+import { $ as l, A as u, An as d, B as f, Bn as p, C as m, Cn as h, D as g, Dn as _, E as v, En as y, Fn as b, G as x, Gt as S, H as C, Ht as w, I as T, In as E, J as D, Jt as O, K as k, L as A, Mn as j, N as M, Nn as ee, O as te, On as N, P as ne, Pn as P, Q as re, R as ie, S as ae, Sn as oe, T as F, Tn as se, U as ce, Ut as I, V as L, Vn as le, W as R, Wt as ue, X as de, Y as z, Yt as fe, Z as B, _ as pe, _n as me, a as he, an as ge, at as _e, b as ve, bn as V, c as ye, cn as be, d as xe, dn as Se, dt as Ce, en as we, et as Te, ft as Ee, g as De, gn as Oe, h as H, hn as ke, i as Ae, j as je, jn as Me, k as Ne, kn as Pe, l as U, ln as Fe, m as W, nn as Ie, nt as Le, on as G, p as Re, pn as ze, q as K, qt as Be, r as q, rn as Ve, rt as He, s as Ue, sn as We, st as Ge, tn as Ke, tt as qe, u as Je, un as Ye, v as Xe, vn as Ze, w as Qe, wn as $e, x as et, xn as tt, y as nt, yn as J, z as rt, zn as it } from "./toThreeJS-FsP-Na75.js";
 import { computed as at, createCommentVNode as Y, createElementBlock as ot, createElementVNode as X, createTextVNode as st, defineComponent as ct, nextTick as lt, onMounted as ut, onUnmounted as dt, openBlock as ft, ref as pt, toDisplayString as mt, unref as ht, vModelText as gt, watch as _t, withDirectives as vt } from "vue";
 import { createUseT as yt, useRuntime as bt } from "gui-chat-protocol/vue";
 //#region ../../../node_modules/three/build/three.module.js
@@ -6769,7 +6769,10 @@ var oa = yt({
 
 For loops with variables (use loop variable in calculations):
 for i in 1 to 5 {
-    cube { position (i * 2 - 6) 0 0 size 1 }
+    cube {
+        position (i * 2 - 6) 0 0
+        size 1
+    }
 }
 
 For loops with step:
@@ -6794,6 +6797,8 @@ Switch statements for multiple cases
 CRITICAL: Function calls require NO space between name and (
 - sin(x) ✓ correct
 - sin (x) ✗ wrong - this is NOT a function call!
+Separate arguments with spaces, upstream style: max(0 (j - 1)). Commas work here but not in the upstream app.
+One statement per line; the upstream app rejects two statements on one line.
 
 ### Best Practices:
 1. Use variables for repeated values
@@ -6820,18 +6825,32 @@ Parametric surface:
 for x in -5 to 5 {
     for z in -5 to 5 {
         define y (sin(x * 0.5) * cos(z * 0.5))
-        cube { position (x * 0.3) y (z * 0.3) size 0.2 }
+        cube {
+            position (x * 0.3) y (z * 0.3)
+            size 0.2
+        }
     }
 }
 
 ### Primitives & CSG:
 Shapes: cube, sphere, cylinder, cone, torus
 CSG: union, difference, intersection, xor, stencil
-Properties: position, rotation, size, color, opacity
+Properties: position, orientation (alias rotation), size, color, opacity
+
+### Units (upstream ShapeScript conventions):
+- size = DIAMETER for sphere/cylinder/cone/circle/polygon/torus, edge length for cube/square. A bare sphere fits the unit cube.
+- orientation / rotate = HALF-TURNS as roll yaw pitch (Z, Y, X): 0.5 = 90°. A lone value is a roll. Trig functions still use radians.
+- Path point/curve coordinates are absolute; curve is a Bézier control point; rotate/translate/scale inside a path move the frame.
+- A path can carry its own position/orientation/size; give loft/extrude path children (not fill{}), as the upstream app requires.
 
-Builders: extrude, fill, lathe, loft, hull. Example: loft { square translate 0 0 2 circle }.
+Builders: extrude, fill, lathe, loft, hull. Example:
+loft {
+    square
+    translate 0 0 2
+    circle
+}
 Stencil preserves the first shape's volume and paints the intersecting surface.
-Constants: pi, tau, true, false. Tuple/string access: values[0], vector.x, value.count.
+Constants: pi, true, false (avoid tau, upstream lacks it; write 2 * pi). Tuple/string access: values[0], vector.x, value.count.
 Polygon supports sides (3–256). String literals and join/trim are supported.
 Use the tool schema for exact syntax and builder limits. This is a modeling subset of upstream ShapeScript;
 imports, textures, text/fonts and general user-defined functions are not supported.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mulmoclaude/shapescript-plugin",
-  "version": "1.4.0",
+  "version": "2.0.0",
   "description": "presentShapeScript \u2014 interactive 3D visualizations authored in the ShapeScript language (parser + Three.js renderer). Core (tool definition + execute) on `.`, Vue View/Preview on `./vue`.",
   "type": "module",
   "main": "./dist/index.js",