@pixel-normal-edit/mcp 2.1.0 → 2.2.0

package/domains/art-tree/{transform_lessons_2.js → lessons/transforms/combine.js}

@@ -1,53 +1,7 @@
-const shapes = require('./shapes');
-const transformShapes = require('./transform_shapes');
-const structureLessons = require('./structure_lessons');
-
-/**
- * Lesson: Rotate (Rotation)
- * Analyzing how objects change when rotated around X, Y, Z axes.
- * We can reuse the Axis Orientation lesson as it perfectly demonstrates rotation.
- */
-function lessonRotate(canvasSize = 32, color = '#ff5722') {
-  // Reusing the axis orientation lesson which draws cylinders rotated along X, Y, Z
-  return structureLessons.lessonAxisOrientation(canvasSize, color);
-}
-
 /**
- * Lesson: Cut (Slice a form)
- * Sphere -> Truncated Sphere (exposing internal cross-section)
+ * Auto-extracted from transform_lessons_2.js
  */
-function lessonCut(canvasSize = 32, color = '#8bc34a') {
-  const commands = [];
-  const cx = Math.floor(canvasSize / 2);
-  const cy = Math.floor(canvasSize / 2);
-  const r = Math.floor(canvasSize * 0.35);
-
-  // Original sphere (ghost)
-  commands.push(shapes.drawCircle(cx, cy, r, '#bdbdbd', false));
-  
-  // Cut sphere
-  commands.push(...transformShapes.drawTruncatedSphere(cx, cy, r, color));
-
-  return commands;
-}
-
-/**
- * Lesson: Hollow (Carve interior)
- * Cylinder -> Pipe/Hole
- */
-function lessonHollow(canvasSize = 32, color = '#3f51b5') {
-  const commands = [];
-  const cx = Math.floor(canvasSize / 2);
-  const cy = Math.floor(canvasSize / 2);
-  const outerR = Math.floor(canvasSize * 0.35);
-  const innerR = Math.floor(canvasSize * 0.25);
-  const h = Math.floor(canvasSize * 0.6);
-
-  // Hollow cylinder
-  commands.push(...transformShapes.drawHollowCylinder(cx, cy, outerR, innerR, h, color));
-
-  return commands;
-}
+const shapes = require('../../shapes');
 
 /**
  * Lesson: Combine (Merge forms)
@@ -94,9 +48,4 @@ function lessonCombine(canvasSize = 32, color = '#607d8b') {
   return commands;
 }
 
-module.exports = {
-  lessonRotate,
-  lessonCut,
-  lessonHollow,
-  lessonCombine
-};
+module.exports = { lessonCombine };

package/domains/art-tree/lessons/transforms/cut.js

@@ -0,0 +1,25 @@
+/**
+ * Auto-extracted from transform_lessons_2.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Cut (Slice a form)
+ * Sphere -> Truncated Sphere (exposing internal cross-section)
+ */
+function lessonCut(canvasSize = 32, color = '#8bc34a') {
+  const commands = [];
+  const cx = Math.floor(canvasSize / 2);
+  const cy = Math.floor(canvasSize / 2);
+  const r = Math.floor(canvasSize * 0.35);
+
+  // Original sphere (ghost)
+  commands.push(shapes.drawCircle(cx, cy, r, '#bdbdbd', false));
+  
+  // Cut sphere
+  commands.push(...transformShapes.drawTruncatedSphere(cx, cy, r, color));
+
+  return commands;
+}
+
+module.exports = { lessonCut };

package/domains/art-tree/lessons/transforms/hollow.js

@@ -0,0 +1,24 @@
+/**
+ * Auto-extracted from transform_lessons_2.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Hollow (Carve interior)
+ * Cylinder -> Pipe/Hole
+ */
+function lessonHollow(canvasSize = 32, color = '#3f51b5') {
+  const commands = [];
+  const cx = Math.floor(canvasSize / 2);
+  const cy = Math.floor(canvasSize / 2);
+  const outerR = Math.floor(canvasSize * 0.35);
+  const innerR = Math.floor(canvasSize * 0.25);
+  const h = Math.floor(canvasSize * 0.6);
+
+  // Hollow cylinder
+  commands.push(...transformShapes.drawHollowCylinder(cx, cy, outerR, innerR, h, color));
+
+  return commands;
+}
+
+module.exports = { lessonHollow };

package/domains/art-tree/lessons/transforms/rotate.js

@@ -0,0 +1,16 @@
+/**
+ * Auto-extracted from transform_lessons_2.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Rotate (Rotation)
+ * Analyzing how objects change when rotated around X, Y, Z axes.
+ * We can reuse the Axis Orientation lesson as it perfectly demonstrates rotation.
+ */
+function lessonRotate(canvasSize = 32, color = '#ff5722') {
+  // Reusing the axis orientation lesson which draws cylinders rotated along X, Y, Z
+  return structureLessons.lessonAxisOrientation(canvasSize, color);
+}
+
+module.exports = { lessonRotate };

package/domains/art-tree/lessons/transforms/squash.js

@@ -0,0 +1,31 @@
+/**
+ * Auto-extracted from transform_lessons_1.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Squash (Compress)
+ * Sphere -> Disk, Box -> Plate
+ */
+function lessonSquash(canvasSize = 32, color = '#ff9800') {
+  const commands = [];
+  const qX1 = Math.floor(canvasSize * 0.25);
+  const qX2 = Math.floor(canvasSize * 0.75);
+  const cy = Math.floor(canvasSize / 2);
+  const r = Math.floor(canvasSize * 0.15);
+
+  // 1. Squash: Sphere -> Disk
+  commands.push(shapes.drawCircle(qX1, cy, r, '#bdbdbd', false)); // Original
+  // Squashed into a flat ellipse/disk
+  commands.push(shapes.drawEllipse(qX1, cy, r * 1.2, Math.floor(r * 0.3), color, false)); 
+
+  // 2. Squash: Box -> Plate
+  const w = Math.floor(canvasSize * 0.2);
+  commands.push(shapes.drawRectangle(qX2 - w/2, cy - w/2, w, w, '#bdbdbd', false)); // Original
+  // Squashed into plate
+  commands.push(shapes.drawRectangle(qX2 - w, cy - Math.floor(w*0.2), w * 2, Math.floor(w*0.4), '#4caf50', false));
+
+  return commands;
+}
+
+module.exports = { lessonSquash };

package/domains/art-tree/lessons/transforms/stretch.js

@@ -0,0 +1,31 @@
+/**
+ * Auto-extracted from transform_lessons_1.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Stretch (Elongate)
+ * Sphere -> Egg, Box -> Bar
+ */
+function lessonStretch(canvasSize = 32, color = '#2196f3') {
+  const commands = [];
+  const qX1 = Math.floor(canvasSize * 0.25);
+  const qX2 = Math.floor(canvasSize * 0.75);
+  const cy = Math.floor(canvasSize / 2);
+  const r = Math.floor(canvasSize * 0.15);
+
+  // 1. Stretch: Sphere -> Egg
+  commands.push(shapes.drawCircle(qX1, cy, r, '#bdbdbd', false)); // Original sphere (ghost)
+  commands.push(...transformShapes.drawEgg(qX1, cy, r, color)); // Stretched into egg
+
+  // 2. Stretch: Box -> Bar (Tall)
+  const w = Math.floor(canvasSize * 0.15);
+  // Original box (ghost)
+  commands.push(shapes.drawRectangle(qX2 - w/2, cy - w/2, w, w, '#bdbdbd', false));
+  // Stretched bar
+  commands.push(shapes.drawRectangle(qX2 - w/2, cy - w * 1.5, w, w * 3, '#9c27b0', false));
+
+  return commands;
+}
+
+module.exports = { lessonStretch };

package/domains/art-tree/lessons/transforms/taper-swell.js

@@ -0,0 +1,33 @@
+/**
+ * Auto-extracted from transform_lessons_1.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Taper & Swell (Narrow or bulge)
+ * Cylinder -> Bottle
+ */
+function lessonTaperSwell(canvasSize = 32, color = '#00bcd4') {
+  const commands = [];
+  const cx = Math.floor(canvasSize / 2);
+  const totalH = Math.floor(canvasSize * 0.8);
+  const topY = Math.floor(canvasSize * 0.1);
+  const bottomY = topY + totalH;
+  const r = Math.floor(canvasSize * 0.25);
+
+  // Original Cylinder (ghost)
+  commands.push(shapes.drawLine(cx - r, topY, cx - r, bottomY, '#bdbdbd'));
+  commands.push(shapes.drawLine(cx + r, topY, cx + r, bottomY, '#bdbdbd'));
+
+  // Tapered and Swelled form (Bottle)
+  const sections = [
+    { y: topY, r: Math.floor(r * 0.3) },         // Neck (Tapered)
+    { y: topY + Math.floor(totalH * 0.4), r: r },// Body (Swelled back to original radius)
+    { y: bottomY, r: Math.floor(r * 0.8) }       // Base (Slightly tapered)
+  ];
+  commands.push(...csShapes.drawLoftedForm(cx, topY, bottomY, sections, color, true));
+
+  return commands;
+}
+
+module.exports = { lessonTaperSwell };

package/domains/art-tree/{vocab_lessons.js → lessons/vocab/vocab-house.js}

@@ -1,4 +1,7 @@
-const vocabShapes = require('./vocab_shapes');
+/**
+ * Auto-extracted from vocab_lessons.js
+ */
+const shapes = require('../../shapes');
 
 /**
  * Lesson: Visual Vocabulary - House Breakdown
@@ -15,18 +18,4 @@ function lessonVocabHouse(canvasSize = 64, step = 1) {
   return vocabShapes.drawHouseBreakdown(cx, cy, canvasSize, validStep);
 }
 
-function getVocabLessonCatalog() {
-  return [
-    { 
-      id: 'vocab_house', 
-      name: 'House Breakdown (5 Steps)', 
-      description: 'Break down a house: Masses -> Structural -> Functional -> Identity -> Materials. Supply step=1..5', 
-      fn: lessonVocabHouse 
-    }
-  ];
-}
-
-module.exports = {
-  lessonVocabHouse,
-  getVocabLessonCatalog
-};
+module.exports = { lessonVocabHouse };

package/domains/art-tree/lib/tool-register.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * tool-register.js — Art Tree: Tool Registration Helpers
+ *
+ * Provides helper functions to reduce boilerplate when registering
+ * Art Tree MCP tools. Common patterns are abstracted here.
+ */
+
+const { z } = require('zod');
+const { registerTool, sendCommand } = require('../../core/server');
+const { hexColor, canvasSize } = require('./validators');
+
+/**
+ * Register a lesson tool with standard pattern
+ * @param {McpServer} server - MCP server instance
+ * @param {string} name - Tool name
+ * @param {string} description - Tool description
+ * @param {Function} lessonFn - Function that returns array of commands
+ * @param {Object} [options] - Optional configuration
+ * @param {number} [options.canvasSizeMax=64] - Max canvas size
+ * @param {string} [options.defaultColor] - Default color (uses hexColor default if not provided)
+ */
+function registerLessonTool(server, name, description, lessonFn, options = {}) {
+  const { canvasSizeMax = 64, defaultColor } = options;
+  
+  const schema = {
+    canvasSize: canvasSize.max(canvasSizeMax),
+  };
+  
+  if (defaultColor) {
+    schema.color = hexColor.default(defaultColor);
+  }
+  
+  registerTool(server, name, description, schema, async (params) => {
+    const commands = lessonFn(params.canvasSize, params.color || defaultColor);
+    await Promise.all(commands.map(cmd => sendCommand(cmd)));
+    return { 
+      content: [{ 
+        type: 'text', 
+        text: `✓ ${description.split(' — ')[0]} completed (${commands.length} strokes)` 
+      }] 
+    };
+  });
+}
+
+/**
+ * Register a catalog tool that returns a list of available lessons
+ * @param {McpServer} server - MCP server instance
+ * @param {string} name - Tool name
+ * @param {string} description - Tool description
+ * @param {Function} getCatalogFn - Function that returns catalog array
+ * @param {string} catalogTitle - Title for the catalog output
+ */
+function registerCatalogTool(server, name, description, getCatalogFn, catalogTitle) {
+  registerTool(server, name, description, {}, () => {
+    const catalog = getCatalogFn();
+    const text = catalog.map(l =>
+      `  • ${l.id}: ${l.name} — ${l.description}`
+    ).join('\n');
+    return { content: [{ type: 'text', text: `📚 ${catalogTitle}:\n\n${text}` }] };
+  });
+}
+
+/**
+ * Register a tool that executes a specific lesson step
+ * @param {McpServer} server - MCP server instance
+ * @param {string} name - Tool name
+ * @param {string} description - Tool description
+ * @param {Function} lessonStepFn - Function that takes step number and returns commands
+ * @param {Object} [options] - Optional configuration
+ * @param {number} [options.minStep=1] - Minimum step number
+ * @param {number} [options.maxStep=10] - Maximum step number
+ * @param {number} [options.canvasSizeMax=64] - Max canvas size
+ * @param {string} [options.defaultColor] - Default color
+ */
+function registerStepTool(server, name, description, lessonStepFn, options = {}) {
+  const { minStep = 1, maxStep = 10, canvasSizeMax = 64, defaultColor } = options;
+  
+  const schema = {
+    canvasSize: canvasSize.max(canvasSizeMax),
+    step: z.number().int().min(minStep).max(maxStep).describe('Step number'),
+  };
+  
+  if (defaultColor) {
+    schema.color = hexColor.default(defaultColor);
+  }
+  
+  registerTool(server, name, description, schema, async (params) => {
+    const commands = lessonStepFn(params.canvasSize, params.step, params.color || defaultColor);
+    await Promise.all(commands.map(cmd => sendCommand(cmd)));
+    return { 
+      content: [{ 
+        type: 'text', 
+        text: `✓ ${description.split(' — ')[0]} - Step ${params.step} completed` 
+      }] 
+    };
+  });
+}
+
+module.exports = {
+  registerLessonTool,
+  registerCatalogTool,
+  registerStepTool,
+};

package/domains/art-tree/lib/validators.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ * validators.js — Art Tree: Shared Zod Validators
+ *
+ * Common validation schemas used across all Art Tree tools.
+ * Centralizes repeated patterns to reduce code duplication.
+ */
+
+const { z } = require('zod');
+
+/**
+ * Hex color validator - ensures valid 6-character hex color codes
+ */
+const hexColor = z.string()
+  .regex(/^#[0-9a-fA-F]{6}$/)
+  .describe('Hex color e.g. #ff0000');
+
+/**
+ * Canvas size validator - ensures reasonable canvas dimensions
+ */
+const canvasSize = z.number()
+  .int()
+  .min(16)
+  .max(128)
+  .default(32)
+  .describe('Canvas dimension (16-128, default 32)');
+
+/**
+ * Coordinate validator - ensures integer coordinates
+ */
+const coordinate = z.number()
+  .int()
+  .describe('Integer coordinate');
+
+/**
+ * Positive integer validator - for sizes, counts, etc.
+ */
+const positiveInt = z.number()
+  .int()
+  .min(1)
+  .describe('Positive integer (min 1)');
+
+/**
+ * Radius validator - ensures positive radius
+ */
+const radius = z.number()
+  .int()
+  .min(1)
+  .describe('Radius (min 1)');
+
+/**
+ * Boolean with default false
+ */
+const booleanFalse = z.boolean()
+  .default(false)
+  .describe('Boolean flag (default false)');
+
+/**
+ * Common tool parameter schemas
+ */
+const schemas = {
+  hexColor,
+  canvasSize,
+  coordinate,
+  positiveInt,
+  radius,
+  booleanFalse,
+};
+
+module.exports = {
+  hexColor,
+  canvasSize,
+  coordinate,
+  positiveInt,
+  radius,
+  booleanFalse,
+  schemas,
+};

package/domains/art-tree/shapes/grid.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * shapes/grid.js — Art Tree: Grid Shape Primitives
+ *
+ * Grid-related shape drawing functions.
+ */
+
+const { drawLine } = require('./basic');
+
+/**
+ * Draw a grid of squares (useful for pixel art foundation lessons).
+ * @param {number} startX - Top-left X
+ * @param {number} startY - Top-left Y
+ * @param {number} cols - Number of columns
+ * @param {number} rows - Number of rows
+ * @param {number} cellSize - Size of each cell
+ * @param {string} color - Grid line color
+ * @returns {Array<Object>} Array of command payloads
+ */
+function drawGrid(startX, startY, cols, rows, cellSize, color) {
+  const commands = [];
+  // Horizontal lines
+  for (let r = 0; r <= rows; r++) {
+    const y = startY + r * cellSize;
+    commands.push(drawLine(startX, y, startX + cols * cellSize, y, color));
+  }
+  // Vertical lines
+  for (let c = 0; c <= cols; c++) {
+    const x = startX + c * cellSize;
+    commands.push(drawLine(x, startY, x, startY + rows * cellSize, color));
+  }
+  return commands;
+}
+
+module.exports = {
+  drawGrid,
+};

package/domains/art-tree/shapes/polyline.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * shapes/polyline.js — Art Tree: Polyline Shape Primitives
+ *
+ * Polyline-related shape drawing functions.
+ */
+
+const { drawLine } = require('./basic');
+
+/**
+ * Draw a continuous polyline from a list of points.
+ * @param {Array<{x: number, y: number}>} points - Array of vertices
+ * @param {string} color - Hex color
+ * @returns {Array<Object>} Array of command payloads
+ */
+function drawPolyline(points, color) {
+  const commands = [];
+  for (let i = 0; i < points.length - 1; i++) {
+    commands.push(drawLine(points[i].x, points[i].y, points[i+1].x, points[i+1].y, color));
+  }
+  return commands;
+}
+
+module.exports = {
+  drawPolyline,
+};

package/domains/art-tree/{3d_tools.js → tools/3d.js}

@@ -1,6 +1,6 @@
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const lessons3d = require('./3d_lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const lessons3d = require('../lessons/3d');
 
 const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/).describe('Hex color e.g. #ff0000');
 

package/domains/art-tree/{advanced_tools.js → tools/advanced.js}

@@ -1,6 +1,6 @@
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const advLessons = require('./advanced_lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const advLessons = require('../lessons/advanced');
 
 const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/).describe('Hex color e.g. #ff0000');
 

package/domains/art-tree/{analysis_tools.js → tools/analysis.js}

@@ -1,6 +1,6 @@
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const analysisLessons = require('./analysis_lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const analysisLessons = require('../lessons/analysis');
 
 const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/).describe('Hex color e.g. #ff0000');
 

package/domains/art-tree/{tools.js → tools/basic.js}

@@ -9,9 +9,9 @@
  * sendCommand — they do NOT create their own drawing system.
  */
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const shapes = require('./shapes');
-const lessons = require('./lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const shapes = require('../shapes/basic');
+const lessons = require('../lessons/basic');
 
 const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/).describe('Hex color e.g. #ff0000');
 

package/domains/art-tree/{cross_section_tools.js → tools/cross-sections.js}

@@ -1,6 +1,6 @@
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const csLessons = require('./cross_section_lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const csLessons = require('../lessons/cross_section');
 
 const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/).describe('Hex color e.g. #ff0000');
 

package/domains/art-tree/{curve_tools.js → tools/curves.js}

@@ -1,6 +1,6 @@
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const curveLessons = require('./curve_lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const curveLessons = require('../lessons/curve');
 
 const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/).describe('Hex color e.g. #ff0000');
 

package/domains/art-tree/{ellipse_tools.js → tools/ellipses.js}

@@ -1,6 +1,6 @@
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const ellipseLessons = require('./ellipse_lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const ellipseLessons = require('../lessons/ellipse');
 
 const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/).describe('Hex color e.g. #ff0000');
 

package/domains/art-tree/{hidden_tools.js → tools/hidden.js}

@@ -1,6 +1,6 @@
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const hiddenLessons = require('./hidden_lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const hiddenLessons = require('../lessons/hidden');
 
 const hexColor = z.string().regex(/^#[0-9a-fA-F]{6}$/).describe('Hex color e.g. #ff0000');
 

package/domains/art-tree/tools/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * tools/index.js — Art Tree: MCP Tools Index
+ *
+ * Main entry point for registering all Art Tree MCP tools.
+ * Imports and registers all tool categories.
+ */
+
+const basic = require('./basic');
+const lessons = require('./lessons');
+const advanced = require('./advanced');
+const curves = require('./curves');
+const ellipses = require('./ellipses');
+const forms3d = require('./3d');
+const structure = require('./structure');
+const crossSections = require('./cross-sections');
+const transforms = require('./transforms');
+const surfaces = require('./surfaces');
+const perspective = require('./perspective');
+const hidden = require('./hidden');
+const lighting = require('./lighting');
+const materials = require('./materials');
+const analysis = require('./analysis');
+const layers = require('./layers');
+const sky = require('./sky');
+
+/**
+ * Register all Art Tree MCP tools on the server
+ * @param {McpServer} server
+ */
+function registerAll(server) {
+  basic.register(server);
+  lessons.register(server);
+  advanced.register(server);
+  curves.register(server);
+  ellipses.register(server);
+  forms3d.register(server);
+  structure.register(server);
+  crossSections.register(server);
+  transforms.register(server);
+  surfaces.register(server);
+  perspective.register(server);
+  hidden.register(server);
+  lighting.register(server);
+  materials.register(server);
+  analysis.register(server);
+  layers.register(server);
+  sky.register(server);
+}
+
+module.exports = {
+  registerAll,
+};

package/domains/art-tree/{layer_tools.js → tools/layers.js}

@@ -1,6 +1,6 @@
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const layerLessons = require('./layer_lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const layerLessons = require('../lessons/layer');
 
 /**
  * Register all layer tools on the MCP server.

package/domains/art-tree/{light_tools.js → tools/lighting.js}

@@ -1,6 +1,6 @@
 const { z } = require('zod');
-const { registerTool, sendCommand } = require('../../core/server');
-const lightLessons = require('./light_lessons');
+const { registerTool, sendCommand } = require('../../../core/server');
+const lightLessons = require('../lessons/light');
 
 /**
  * Register all lighting & shading tools on the MCP server.