@genart-dev/plugin-construction 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -10,8 +10,6 @@ declare const envelopeLayerType: LayerTypeDefinition;
 
 declare const intersectionLayerType: LayerTypeDefinition;
 
-declare const constructionMcpTools: McpToolDefinition[];
-
 /** 3D vector. */
 interface Vec3 {
     x: number;
@@ -72,6 +70,32 @@ declare function dot3(a: Vec3, b: Vec3): number;
 /** Cross product of two Vec3. */
 declare function cross3(a: Vec3, b: Vec3): Vec3;
 
+type FormType = "box" | "cylinder" | "sphere" | "cone" | "wedge" | "egg";
+interface FormDefinition {
+    type: FormType;
+    position: Vec3;
+    size: Vec3;
+    rotation: Vec3;
+}
+
+/** A single component in a compound form. */
+interface CompoundComponent {
+    type: FormType;
+    /** Offset from parent center (in form-size units). */
+    offsetX: number;
+    offsetY: number;
+    offsetZ: number;
+    /** Scale relative to parent form size. */
+    scaleX: number;
+    scaleY: number;
+    scaleZ: number;
+}
+/** Named compound form presets. */
+declare const COMPOUND_PRESETS: Record<string, CompoundComponent[]>;
+declare const compoundFormLayerType: LayerTypeDefinition;
+
+declare const constructionMcpTools: McpToolDefinition[];
+
 interface EllipseParams {
     cx: number;
     cy: number;
@@ -190,14 +214,6 @@ declare function comparativeMeasure(segment1: [Vec2, Vec2], segment2: [Vec2, Vec
     label: string;
 };
 
-type FormType = "box" | "cylinder" | "sphere" | "cone" | "wedge" | "egg";
-interface FormDefinition {
-    type: FormType;
-    position: Vec3;
-    size: Vec3;
-    rotation: Vec3;
-}
-
 /**
  * Approximate form intersection by sampling both surfaces and finding
  * points where they are equidistant from the camera (same Z depth).
@@ -208,4 +224,4 @@ declare function approximateIntersection(form1: FormDefinition, form2: FormDefin
 
 declare const constructionPlugin: DesignPlugin;
 
-export { approximateIntersection, castShadow, clamp, comparativeMeasure, computeEnvelope, constructionMcpTools, cross3, crossContourLayerType, constructionPlugin as default, dot3, drawEllipse, drawEllipseWithHidden, ellipsePoints, envelopeAngles, envelopeLayerType, formLayerType, identityMatrix, intersectionLayerType, levelLine, lightDirection, lightDirection2D, multiplyMat3, normalize3, plumbLine, project, projectedEllipse, rotate3D, rotationMatrix, sphereTerminator, sphereValueZones, transformPoint, transformedNormalZ, valueShapesLayerType };
+export { COMPOUND_PRESETS, type CompoundComponent, approximateIntersection, castShadow, clamp, comparativeMeasure, compoundFormLayerType, computeEnvelope, constructionMcpTools, cross3, crossContourLayerType, constructionPlugin as default, dot3, drawEllipse, drawEllipseWithHidden, ellipsePoints, envelopeAngles, envelopeLayerType, formLayerType, identityMatrix, intersectionLayerType, levelLine, lightDirection, lightDirection2D, multiplyMat3, normalize3, plumbLine, project, projectedEllipse, rotate3D, rotationMatrix, sphereTerminator, sphereValueZones, transformPoint, transformedNormalZ, valueShapesLayerType };

package/dist/index.d.ts

@@ -10,8 +10,6 @@ declare const envelopeLayerType: LayerTypeDefinition;
 
 declare const intersectionLayerType: LayerTypeDefinition;
 
-declare const constructionMcpTools: McpToolDefinition[];
-
 /** 3D vector. */
 interface Vec3 {
     x: number;
@@ -72,6 +70,32 @@ declare function dot3(a: Vec3, b: Vec3): number;
 /** Cross product of two Vec3. */
 declare function cross3(a: Vec3, b: Vec3): Vec3;
 
+type FormType = "box" | "cylinder" | "sphere" | "cone" | "wedge" | "egg";
+interface FormDefinition {
+    type: FormType;
+    position: Vec3;
+    size: Vec3;
+    rotation: Vec3;
+}
+
+/** A single component in a compound form. */
+interface CompoundComponent {
+    type: FormType;
+    /** Offset from parent center (in form-size units). */
+    offsetX: number;
+    offsetY: number;
+    offsetZ: number;
+    /** Scale relative to parent form size. */
+    scaleX: number;
+    scaleY: number;
+    scaleZ: number;
+}
+/** Named compound form presets. */
+declare const COMPOUND_PRESETS: Record<string, CompoundComponent[]>;
+declare const compoundFormLayerType: LayerTypeDefinition;
+
+declare const constructionMcpTools: McpToolDefinition[];
+
 interface EllipseParams {
     cx: number;
     cy: number;
@@ -190,14 +214,6 @@ declare function comparativeMeasure(segment1: [Vec2, Vec2], segment2: [Vec2, Vec
     label: string;
 };
 
-type FormType = "box" | "cylinder" | "sphere" | "cone" | "wedge" | "egg";
-interface FormDefinition {
-    type: FormType;
-    position: Vec3;
-    size: Vec3;
-    rotation: Vec3;
-}
-
 /**
  * Approximate form intersection by sampling both surfaces and finding
  * points where they are equidistant from the camera (same Z depth).
@@ -208,4 +224,4 @@ declare function approximateIntersection(form1: FormDefinition, form2: FormDefin
 
 declare const constructionPlugin: DesignPlugin;
 
-export { approximateIntersection, castShadow, clamp, comparativeMeasure, computeEnvelope, constructionMcpTools, cross3, crossContourLayerType, constructionPlugin as default, dot3, drawEllipse, drawEllipseWithHidden, ellipsePoints, envelopeAngles, envelopeLayerType, formLayerType, identityMatrix, intersectionLayerType, levelLine, lightDirection, lightDirection2D, multiplyMat3, normalize3, plumbLine, project, projectedEllipse, rotate3D, rotationMatrix, sphereTerminator, sphereValueZones, transformPoint, transformedNormalZ, valueShapesLayerType };
+export { COMPOUND_PRESETS, type CompoundComponent, approximateIntersection, castShadow, clamp, comparativeMeasure, compoundFormLayerType, computeEnvelope, constructionMcpTools, cross3, crossContourLayerType, constructionPlugin as default, dot3, drawEllipse, drawEllipseWithHidden, ellipsePoints, envelopeAngles, envelopeLayerType, formLayerType, identityMatrix, intersectionLayerType, levelLine, lightDirection, lightDirection2D, multiplyMat3, normalize3, plumbLine, project, projectedEllipse, rotate3D, rotationMatrix, sphereTerminator, sphereValueZones, transformPoint, transformedNormalZ, valueShapesLayerType };

package/dist/index.js

@@ -2346,6 +2346,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 }] };
@@ -2785,7 +2948,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: [
@@ -2793,7 +2956,8 @@ var constructionPlugin = {
     crossContourLayerType,
     valueShapesLayerType,
     envelopeLayerType,
-    intersectionLayerType
+    intersectionLayerType,
+    compoundFormLayerType
   ],
   tools: [],
   exportHandlers: [],
@@ -2805,10 +2969,12 @@ var constructionPlugin = {
 };
 var index_default = constructionPlugin;
 export {
+  COMPOUND_PRESETS,
   approximateIntersection,
   castShadow,
   clamp,
   comparativeMeasure,
+  compoundFormLayerType,
   computeEnvelope,
   constructionMcpTools,
   cross3,