@genart-dev/plugin-construction 0.1.0 → 0.2.0

package/README.md

@@ -4,6 +4,12 @@ Drawing construction guides plugin for [genart.dev](https://genart.dev) — 3D f
 
 Part of [genart.dev](https://genart.dev) — a generative art platform with an MCP server, desktop app, and IDE extensions.
 
+## Examples
+
+![Construction guides montage](test-renders/construction-guides.png)
+
+Source file: [construction-guides.genart](test-renders/construction-guides.genart)
+
 ## Install
 
 ```bash
@@ -152,18 +158,6 @@ Intersection lines between two or more overlapping 3D forms, computed by surface
 | `showFormLabels` | boolean | `false` | Show A/B/C labels |
 | `transitionType` | select | `"hard"` | hard / soft / mixed |
 
-## Test Render
-
-![Construction guides montage](test-renders/construction-guides.png)
-
-16-panel montage showing all layer types with variations:
-- **Row 1**: Box, cylinder, sphere, cone — default rotations with cross-contours and axes
-- **Row 2**: Wedge, egg/ovoid, box (extreme rotation), cylinder (weak-perspective foreshortening)
-- **Row 3**: Cross-contour lines on organic shape, 3-value study, 5-value study (full shadow anatomy), envelope block-in with angles and plumb line
-- **Row 4**: Box+sphere intersection, cylinder+cone intersection (soft), multi-form scene, construction exercise
-
-Regenerate with `node render-test-construction.cjs` (requires `canvas` dev dependency).
-
 ## MCP Tools (8)
 
 | Tool | Description |

package/dist/index.cjs

@@ -20,10 +20,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  COMPOUND_PRESETS: () => COMPOUND_PRESETS,
   approximateIntersection: () => approximateIntersection,
   castShadow: () => castShadow,
   clamp: () => clamp,
   comparativeMeasure: () => comparativeMeasure,
+  compoundFormLayerType: () => compoundFormLayerType,
   computeEnvelope: () => computeEnvelope,
   constructionMcpTools: () => constructionMcpTools,
   cross3: () => cross3,
@@ -2404,6 +2406,169 @@ var intersectionLayerType = {
   }
 };
 
+// src/compound-form-layer.ts
+var COMPOUND_PRESETS = {
+  snowman: [
+    { type: "sphere", offsetX: 0, offsetY: 0.35, offsetZ: 0, scaleX: 1, scaleY: 1, scaleZ: 1 },
+    { type: "sphere", offsetX: 0, offsetY: -0.05, offsetZ: 0, scaleX: 0.75, scaleY: 0.75, scaleZ: 0.75 },
+    { type: "sphere", offsetX: 0, offsetY: -0.35, offsetZ: 0, scaleX: 0.5, scaleY: 0.5, scaleZ: 0.5 }
+  ],
+  bottle: [
+    { type: "cylinder", offsetX: 0, offsetY: 0.15, offsetZ: 0, scaleX: 1, scaleY: 0.7, scaleZ: 1 },
+    { type: "cone", offsetX: 0, offsetY: -0.25, offsetZ: 0, scaleX: 0.6, scaleY: 0.3, scaleZ: 0.6 },
+    { type: "cylinder", offsetX: 0, offsetY: -0.42, offsetZ: 0, scaleX: 0.3, scaleY: 0.15, scaleZ: 0.3 }
+  ],
+  mushroom: [
+    { type: "sphere", offsetX: 0, offsetY: -0.2, offsetZ: 0, scaleX: 1.2, scaleY: 0.5, scaleZ: 1.2 },
+    { type: "cylinder", offsetX: 0, offsetY: 0.2, offsetZ: 0, scaleX: 0.3, scaleY: 0.5, scaleZ: 0.3 }
+  ],
+  lamp: [
+    { type: "cone", offsetX: 0, offsetY: -0.25, offsetZ: 0, scaleX: 1, scaleY: 0.5, scaleZ: 1 },
+    { type: "cylinder", offsetX: 0, offsetY: 0.1, offsetZ: 0, scaleX: 0.15, scaleY: 0.5, scaleZ: 0.15 },
+    { type: "cylinder", offsetX: 0, offsetY: 0.4, offsetZ: 0, scaleX: 0.5, scaleY: 0.05, scaleZ: 0.5 }
+  ],
+  tree: [
+    { type: "cylinder", offsetX: 0, offsetY: 0.25, offsetZ: 0, scaleX: 0.2, scaleY: 0.5, scaleZ: 0.2 },
+    { type: "egg", offsetX: 0, offsetY: -0.2, offsetZ: 0, scaleX: 0.8, scaleY: 0.6, scaleZ: 0.8 }
+  ]
+};
+var COMPOUND_PROPERTIES = [
+  {
+    key: "preset",
+    label: "Preset",
+    type: "select",
+    default: "snowman",
+    options: Object.keys(COMPOUND_PRESETS).map((k) => ({ value: k, label: k.charAt(0).toUpperCase() + k.slice(1) })),
+    group: "compound"
+  },
+  {
+    key: "components",
+    label: "Components (JSON)",
+    type: "string",
+    default: "",
+    group: "compound"
+  },
+  {
+    key: "position",
+    label: "Position",
+    type: "point",
+    default: { x: 0.5, y: 0.5 },
+    group: "compound"
+  },
+  {
+    key: "formSize",
+    label: "Size",
+    type: "number",
+    default: 0.25,
+    min: 0.05,
+    max: 0.6,
+    step: 0.01,
+    group: "compound"
+  },
+  {
+    key: "rotX",
+    label: "Rotation X (deg)",
+    type: "number",
+    default: 15,
+    min: -90,
+    max: 90,
+    step: 5,
+    group: "compound"
+  },
+  {
+    key: "rotY",
+    label: "Rotation Y (deg)",
+    type: "number",
+    default: 25,
+    min: -180,
+    max: 180,
+    step: 5,
+    group: "compound"
+  },
+  ...COMMON_GUIDE_PROPERTIES
+];
+var compoundFormLayerType = {
+  typeId: "construction:compound-form",
+  displayName: "Compound Form",
+  icon: "compound",
+  category: "guide",
+  properties: COMPOUND_PROPERTIES,
+  propertyEditorId: "construction:compound-form-editor",
+  createDefault() {
+    const props = {};
+    for (const schema of COMPOUND_PROPERTIES) {
+      props[schema.key] = schema.default;
+    }
+    return props;
+  },
+  render(properties, ctx, bounds, _resources) {
+    const preset = properties.preset ?? "snowman";
+    const componentsJson = properties.components ?? "";
+    const position = properties.position ?? { x: 0.5, y: 0.5 };
+    const formSize = properties.formSize ?? 0.25;
+    const rotX = properties.rotX ?? 15;
+    const rotY = properties.rotY ?? 25;
+    let components;
+    if (componentsJson.trim()) {
+      try {
+        components = JSON.parse(componentsJson);
+      } catch {
+        components = COMPOUND_PRESETS[preset] ?? COMPOUND_PRESETS["snowman"];
+      }
+    } else {
+      components = COMPOUND_PRESETS[preset] ?? COMPOUND_PRESETS["snowman"];
+    }
+    if (components.length === 0) return;
+    const w = bounds.width;
+    const h = bounds.height;
+    const baseSize = Math.min(w, h) * formSize;
+    const cx = bounds.x + w * position.x;
+    const cy = bounds.y + h * position.y;
+    ctx.save();
+    const guideColor = properties.guideColor ?? "rgba(0,200,255,0.5)";
+    const lineWidth = properties.lineWidth ?? 1;
+    const dashPattern = properties.dashPattern ?? "";
+    setupGuideStyle(ctx, guideColor, lineWidth, dashPattern);
+    const mat = rotationMatrix(rotX, rotY, 0);
+    const sorted = components.map((comp, i) => {
+      const p3d = rotate3D({ x: comp.offsetX * baseSize, y: comp.offsetY * baseSize, z: comp.offsetZ * baseSize }, mat);
+      return { comp, z: p3d.z, index: i };
+    }).sort((a, b) => b.z - a.z);
+    for (const { comp } of sorted) {
+      const offset = rotate3D(
+        { x: comp.offsetX * baseSize, y: comp.offsetY * baseSize, z: comp.offsetZ * baseSize },
+        mat
+      );
+      const compCx = cx + offset.x;
+      const compCy = cy + offset.y;
+      const compSize = baseSize * Math.max(comp.scaleX, comp.scaleY);
+      ctx.beginPath();
+      const rx = compSize * comp.scaleX * 0.5;
+      const ry = compSize * comp.scaleY * 0.5;
+      ctx.ellipse(compCx, compCy, Math.max(1, rx), Math.max(1, ry), 0, 0, Math.PI * 2);
+      ctx.stroke();
+      ctx.beginPath();
+      ctx.arc(compCx, compCy, 2, 0, Math.PI * 2);
+      ctx.fill();
+    }
+    ctx.restore();
+  },
+  validate(properties) {
+    const componentsJson = properties.components;
+    if (componentsJson && componentsJson.trim()) {
+      try {
+        const parsed = JSON.parse(componentsJson);
+        if (!Array.isArray(parsed)) {
+          return [{ property: "components", message: "Components must be a JSON array" }];
+        }
+      } catch {
+        return [{ property: "components", message: "Invalid JSON for components" }];
+      }
+    }
+    return null;
+  }
+};
+
 // src/construction-tools.ts
 function textResult(text) {
   return { content: [{ type: "text", text }] };
@@ -2843,7 +3008,7 @@ var constructionMcpTools = [
 var constructionPlugin = {
   id: "construction",
   name: "Construction Guides",
-  version: "0.1.0",
+  version: "0.2.0",
   tier: "free",
   description: "Drawing construction guides: 3D form primitives, cross-contour lines, value/shadow studies, envelope block-ins, and form intersections.",
   layerTypes: [
@@ -2851,7 +3016,8 @@ var constructionPlugin = {
     crossContourLayerType,
     valueShapesLayerType,
     envelopeLayerType,
-    intersectionLayerType
+    intersectionLayerType,
+    compoundFormLayerType
   ],
   tools: [],
   exportHandlers: [],
@@ -2864,10 +3030,12 @@ var constructionPlugin = {
 var index_default = constructionPlugin;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  COMPOUND_PRESETS,
   approximateIntersection,
   castShadow,
   clamp,
   comparativeMeasure,
+  compoundFormLayerType,
   computeEnvelope,
   constructionMcpTools,
   cross3,