@pixel-normal-edit/mcp 2.1.0 → 2.2.0

package/domains/art-tree/lessons/basic/polygons.js

@@ -0,0 +1,25 @@
+/**
+ * Auto-extracted from lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson 6: Polygons — Multi-sided shapes.
+ * @param {number} canvasSize - Canvas dimension
+ * @param {string} color - Primary color
+ * @returns {Array<Object>} Array of command payloads
+ */
+function lessonPolygons(canvasSize = 32, color = '#607d8b') {
+  const mid = Math.floor(canvasSize / 2);
+  const r = Math.floor(canvasSize * 0.35);
+  return [
+    // Pentagon
+    shapes.drawRegularPolygon(mid, mid, 5, r, '#4caf50', false),
+    // Hexagon (filled)
+    shapes.drawRegularPolygon(mid, mid, 6, Math.floor(r * 0.7), '#ff9800', true),
+    // Octagon
+    shapes.drawRegularPolygon(mid, mid, 8, Math.floor(r * 0.5), '#9c27b0', false),
+  ];
+}
+
+module.exports = { lessonPolygons };

package/domains/art-tree/lessons/basic/proportions-and-angles.js

@@ -0,0 +1,20 @@
+/**
+ * Auto-extracted from lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson 9: Proportions and Angles — Practice maintaining proportions and angles.
+ */
+function lessonProportionsAndAngles(canvasSize = 32, color = '#3f51b5') {
+  const mid = Math.floor(canvasSize / 2);
+  const size1 = Math.floor(canvasSize * 0.4);
+  const size2 = Math.floor(size1 / 2);
+  return [
+    shapes.drawSquare(mid - Math.floor(size1/2), mid - Math.floor(size1/2), size1, color, false),
+    shapes.drawSquare(mid - Math.floor(size2/2), mid - Math.floor(size2/2), size2, '#e91e63', false),
+    shapes.drawLine(mid, mid, mid + size1, mid - size1, '#009688')
+  ];
+}
+
+module.exports = { lessonProportionsAndAngles };

package/domains/art-tree/lessons/basic/spiral.js

@@ -0,0 +1,21 @@
+/**
+ * Auto-extracted from lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson 11: Spiral — Drawing spiral curves.
+ */
+function lessonSpiral(canvasSize = 32, color = '#ff9800') {
+  const mid = Math.floor(canvasSize / 2);
+  const points = [];
+  const maxRadius = Math.floor(canvasSize * 0.4);
+  const loops = 3;
+  for (let angle = 0; angle < Math.PI * 2 * loops; angle += 0.3) {
+    const r = (angle / (Math.PI * 2 * loops)) * maxRadius;
+    points.push({ x: Math.round(mid + r * Math.cos(angle)), y: Math.round(mid + r * Math.sin(angle)) });
+  }
+  return shapes.drawPolyline(points, color);
+}
+
+module.exports = { lessonSpiral };

package/domains/art-tree/lessons/basic/squares.js

@@ -0,0 +1,28 @@
+/**
+ * Auto-extracted from lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson 2: Squares & Rectangles — Understanding right angles and proportions.
+ * @param {number} canvasSize - Canvas dimension
+ * @param {string} color - Primary color
+ * @returns {Array<Object>} Array of command payloads
+ */
+function lessonSquares(canvasSize = 32, color = '#1565c0') {
+  const margin = Math.floor(canvasSize * 0.1);
+  const small = Math.floor(canvasSize * 0.2);
+  const large = Math.floor(canvasSize * 0.35);
+  return [
+    // Small square (outline)
+    shapes.drawSquare(margin, margin, small, color, false),
+    // Large square (filled)
+    shapes.drawSquare(canvasSize - margin - large, margin, large, '#ff7043', true),
+    // Rectangle (horizontal)
+    shapes.drawRectangle(margin, canvasSize - margin - small, large + small, small, '#4caf50', false),
+    // Rectangle (vertical, filled)
+    shapes.drawRectangle(canvasSize - margin - small, canvasSize - margin - large, small, large, '#9c27b0', true),
+  ];
+}
+
+module.exports = { lessonSquares };

package/domains/art-tree/lessons/basic/strokes.js

@@ -0,0 +1,23 @@
+/**
+ * Auto-extracted from lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson 12: Strokes — Long strokes, short strokes, thick and thin lines.
+ */
+function lessonStrokes(canvasSize = 32, color = '#2196f3') {
+  const margin = Math.floor(canvasSize * 0.1);
+  const y1 = Math.floor(canvasSize * 0.3);
+  const y2 = Math.floor(canvasSize * 0.5);
+  const y3 = Math.floor(canvasSize * 0.7);
+  return [
+    shapes.drawLine(margin, y1, canvasSize - margin, y1, color),
+    shapes.drawLine(margin, y2, Math.floor(canvasSize / 2), y2, '#4caf50'),
+    shapes.drawLine(margin, y3, canvasSize - margin, y3, '#f44336'),
+    shapes.drawLine(margin, y3 + 1, canvasSize - margin, y3 + 1, '#f44336'),
+    shapes.drawLine(margin, y3 + 2, canvasSize - margin, y3 + 2, '#f44336'),
+  ];
+}
+
+module.exports = { lessonStrokes };

package/domains/art-tree/lessons/basic/triangles.js

@@ -0,0 +1,30 @@
+/**
+ * Auto-extracted from lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson 5: Triangles — Three-point shapes and stability.
+ * @param {number} canvasSize - Canvas dimension
+ * @param {string} color - Primary color
+ * @returns {Array<Object>} Array of command payloads
+ */
+function lessonTriangles(canvasSize = 32, color = '#ff5722') {
+  const mid = Math.floor(canvasSize / 2);
+  const size = Math.floor(canvasSize * 0.4);
+  const margin = Math.floor(canvasSize * 0.1);
+  return [
+    // Equilateral triangle (outline)
+    shapes.drawEquilateralTriangle(mid, mid, size, color, false),
+    // Right triangle (filled)
+    shapes.drawTriangle([
+      { x: margin, y: canvasSize - margin },
+      { x: margin, y: margin },
+      { x: Math.floor(canvasSize * 0.35), y: canvasSize - margin },
+    ], '#3f51b5', true),
+    // Inverted triangle
+    shapes.drawEquilateralTriangle(mid, mid, Math.floor(size * 0.6), '#009688', true),
+  ];
+}
+
+module.exports = { lessonTriangles };

package/domains/art-tree/lessons/cross-sections/bottle-sections.js

@@ -0,0 +1,26 @@
+/**
+ * Auto-extracted from cross_section_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Bottle Sections (Base, Body, Shoulder, Neck, Mouth)
+ */
+function lessonBottleSections(canvasSize = 32, color = '#2196f3') {
+  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 sections = [
+    { y: topY, r: Math.floor(canvasSize * 0.08) },                        // Mouth (slightly open)
+    { y: topY + Math.floor(totalH * 0.1), r: Math.floor(canvasSize * 0.06) }, // Neck (narrow)
+    { y: topY + Math.floor(totalH * 0.3), r: Math.floor(canvasSize * 0.2) },  // Shoulder (shrinking to body)
+    { y: topY + Math.floor(totalH * 0.6), r: Math.floor(canvasSize * 0.25) }, // Body (wide)
+    { y: bottomY, r: Math.floor(canvasSize * 0.25) }                      // Base (wide)
+  ];
+
+  return csShapes.drawLoftedForm(cx, topY, bottomY, sections, color, true);
+}
+
+module.exports = { lessonBottleSections };

package/domains/art-tree/lessons/cross-sections/glass-sections.js

@@ -0,0 +1,24 @@
+/**
+ * Auto-extracted from cross_section_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Glass Sections (Base, Mid, Mouth)
+ */
+function lessonGlassSections(canvasSize = 32, color = '#9c27b0') {
+  const cx = Math.floor(canvasSize / 2);
+  const totalH = Math.floor(canvasSize * 0.6);
+  const topY = Math.floor(canvasSize * 0.2);
+  const bottomY = topY + totalH;
+
+  const sections = [
+    { y: topY, r: Math.floor(canvasSize * 0.3) },                         // Mouth (wide)
+    { y: topY + Math.floor(totalH * 0.5), r: Math.floor(canvasSize * 0.2) },  // Mid body (widening)
+    { y: bottomY, r: Math.floor(canvasSize * 0.15) }                      // Base (small)
+  ];
+
+  return csShapes.drawLoftedForm(cx, topY, bottomY, sections, color, true);
+}
+
+module.exports = { lessonGlassSections };

package/domains/art-tree/lessons/cross-sections/head-sections.js

@@ -0,0 +1,17 @@
+/**
+ * Auto-extracted from cross_section_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Head Sections (Cranium, Face, Jaw)
+ */
+function lessonHeadSections(canvasSize = 32, color = '#ff9800') {
+  const cx = Math.floor(canvasSize / 2);
+  const cy = Math.floor(canvasSize / 2);
+  const height = Math.floor(canvasSize * 0.8);
+
+  return csShapes.drawHeadStructure(cx, cy, height, color);
+}
+
+module.exports = { lessonHeadSections };

package/domains/art-tree/lessons/curves/curve-properties.js

@@ -0,0 +1,50 @@
+/**
+ * Auto-extracted from curve_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson 3: Curve Properties (Start, Direction, Curvature, Inflection, Transition)
+ */
+function lessonCurveProperties(canvasSize = 32, color = '#607d8b') {
+  const margin = Math.floor(canvasSize * 0.1);
+  const commands = [];
+
+  // 1. Start point and Direction (Top Left Curve)
+  const p0 = { x: margin, y: margin * 2 };
+  const p1 = { x: margin + canvasSize*0.3, y: margin };
+  const p2 = { x: margin + canvasSize*0.3, y: margin + canvasSize*0.3 };
+  commands.push(...curveShapes.drawQuadraticCurve(p0, p1, p2, color));
+  commands.push(curveShapes.drawStartMarker(p0.x, p0.y, '#00ff00')); // Green dot at start
+  commands.push(...curveShapes.drawDirectionArrow(p0, p1, p2, null, '#ff0000')); // Red arrow
+
+  // 2. Curvature comparison (Bottom Left)
+  // Strong vs Weak curve with same endpoints
+  const bp0 = { x: margin, y: canvasSize - margin };
+  const bp2 = { x: margin + canvasSize*0.4, y: canvasSize - margin };
+  // Weak curve
+  commands.push(...curveShapes.drawQuadraticCurve(bp0, { x: margin + canvasSize*0.2, y: canvasSize - margin - canvasSize*0.1 }, bp2, '#8bc34a'));
+  // Strong curve
+  commands.push(...curveShapes.drawQuadraticCurve(bp0, { x: margin + canvasSize*0.2, y: canvasSize - margin - canvasSize*0.4 }, bp2, '#388e3c'));
+
+  // 3. Inflection point (Top Right S Curve)
+  const sP0 = { x: canvasSize - margin - canvasSize*0.3, y: margin };
+  const sP1 = { x: canvasSize - margin, y: margin };
+  const sP2 = { x: canvasSize - margin - canvasSize*0.4, y: margin + canvasSize*0.3 };
+  const sP3 = { x: canvasSize - margin, y: margin + canvasSize*0.3 };
+  commands.push(...curveShapes.drawCubicCurve(sP0, sP1, sP2, sP3, '#03a9f4'));
+  // Inflection point roughly at t=0.5
+  const inflection = curveShapes.cubicBezier(sP0, sP1, sP2, sP3, 0.5);
+  commands.push(curveShapes.drawInflectionMarker(inflection.x, inflection.y, '#ff9800'));
+
+  // 4. Transition (Bottom Right - line transitioning to curve)
+  const startLine = { x: canvasSize - margin - canvasSize*0.3, y: canvasSize - margin - canvasSize*0.2 };
+  const transPt = { x: canvasSize - margin - canvasSize*0.1, y: canvasSize - margin - canvasSize*0.2 };
+  commands.push(shapes.drawLine(startLine.x, startLine.y, transPt.x, transPt.y, '#9e9e9e'));
+  // Curve starting tangentially
+  commands.push(...curveShapes.drawQuadraticCurve(transPt, { x: canvasSize - margin, y: canvasSize - margin - canvasSize*0.2 }, { x: canvasSize - margin, y: canvasSize - margin }, '#795548'));
+
+  return commands;
+}
+
+module.exports = { lessonCurveProperties };

package/domains/art-tree/lessons/curves/curve-topology.js

@@ -0,0 +1,45 @@
+/**
+ * Auto-extracted from curve_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson 2: Curve Topology (Closed, Open, Symmetrical, Asymmetrical)
+ */
+function lessonCurveTopology(canvasSize = 32, color = '#9c27b0') {
+  const mid = Math.floor(canvasSize / 2);
+  const q = Math.floor(canvasSize / 4);
+  const commands = [];
+
+  // Closed Curve (Circle-like using Bezier for demonstration)
+  // Since we already have drawCircle, we just draw a circle to represent a closed curve
+  commands.push(shapes.drawCircle(q, q, Math.floor(q*0.8), color, false));
+  
+  // Open Curve (Quadratic)
+  commands.push(...curveShapes.drawQuadraticCurve(
+    { x: canvasSize - q*1.5, y: q },
+    { x: canvasSize - q*0.5, y: q - q/2 },
+    { x: canvasSize - q*0.5, y: q + q/2 },
+    '#3f51b5'
+  ));
+
+  // Symmetrical Curve (Parabola-like)
+  commands.push(...curveShapes.drawQuadraticCurve(
+    { x: q*0.5, y: canvasSize - q*0.5 },
+    { x: q, y: canvasSize - q*1.5 },
+    { x: q*1.5, y: canvasSize - q*0.5 },
+    '#00bcd4'
+  ));
+
+  // Asymmetrical Curve
+  commands.push(...curveShapes.drawQuadraticCurve(
+    { x: canvasSize - q*1.5, y: canvasSize - q*0.5 },
+    { x: canvasSize - q*0.2, y: canvasSize - q*1.8 }, // Pull point is skewed
+    { x: canvasSize - q*0.5, y: canvasSize - q*0.5 },
+    '#ff5722'
+  ));
+
+  return commands;
+}
+
+module.exports = { lessonCurveTopology };

package/domains/art-tree/lessons/curves/curve-types.js

@@ -0,0 +1,44 @@
+/**
+ * Auto-extracted from curve_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson 1: Curve Types (C, S, Convex, Concave)
+ */
+function lessonCurveTypes(canvasSize = 32, color = '#2196f3') {
+  const margin = Math.floor(canvasSize * 0.1);
+  const commands = [];
+  
+  const w = Math.floor(canvasSize / 2) - margin * 2;
+  const h = Math.floor(canvasSize / 2) - margin * 2;
+
+  // C Curve (Top Left)
+  const cP0 = { x: margin + w, y: margin };
+  const cP1 = { x: margin - w, y: margin + Math.floor(h/2) }; // Pulls curve left
+  const cP2 = { x: margin + w, y: margin + h };
+  commands.push(...curveShapes.drawQuadraticCurve(cP0, cP1, cP2, color));
+
+  // S Curve (Top Right)
+  const sP0 = { x: canvasSize - margin, y: margin };
+  const sP1 = { x: canvasSize - margin - w*2, y: margin };
+  const sP2 = { x: canvasSize - margin + w, y: margin + h };
+  const sP3 = { x: canvasSize - margin - w, y: margin + h };
+  commands.push(...curveShapes.drawCubicCurve(sP0, sP1, sP2, sP3, '#e91e63'));
+
+  // Convex (Bottom Left, viewed from bottom)
+  const cvxP0 = { x: margin, y: canvasSize - margin };
+  const cvxP1 = { x: margin + Math.floor(w/2), y: canvasSize - margin - h };
+  const cvxP2 = { x: margin + w, y: canvasSize - margin };
+  commands.push(...curveShapes.drawQuadraticCurve(cvxP0, cvxP1, cvxP2, '#4caf50'));
+
+  // Concave (Bottom Right, viewed from bottom)
+  const cnvP0 = { x: canvasSize - margin - w, y: canvasSize - margin - Math.floor(h/2) };
+  const cnvP1 = { x: canvasSize - margin - Math.floor(w/2), y: canvasSize - margin + h };
+  const cnvP2 = { x: canvasSize - margin, y: canvasSize - margin - Math.floor(h/2) };
+  commands.push(...curveShapes.drawQuadraticCurve(cnvP0, cnvP1, cnvP2, '#ff9800'));
+
+  return commands;
+}
+
+module.exports = { lessonCurveTypes };

package/domains/art-tree/lessons/ellipses/coaxial-ellipses.js

@@ -0,0 +1,29 @@
+/**
+ * Auto-extracted from ellipse_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Coaxial Ellipses (Multiple ellipses on the same axis)
+ */
+function lessonCoaxialEllipses(canvasSize = 32, color = '#795548') {
+  const commands = [];
+  const cx = Math.floor(canvasSize / 2);
+  const rx = Math.floor(canvasSize * 0.3);
+  
+  // Central axis line
+  commands.push(shapes.drawLine(cx, Math.floor(canvasSize * 0.1), cx, canvasSize - Math.floor(canvasSize * 0.1), '#bdbdbd'));
+  
+  // Top ellipse (narrower, viewed from steeper angle)
+  commands.push(shapes.drawEllipse(cx, Math.floor(canvasSize * 0.2), rx, Math.floor(rx * 0.2), color, false));
+  
+  // Middle ellipse
+  commands.push(shapes.drawEllipse(cx, Math.floor(canvasSize * 0.5), rx, Math.floor(rx * 0.3), color, false));
+  
+  // Bottom ellipse (wider, viewed from less steep angle)
+  commands.push(shapes.drawEllipse(cx, canvasSize - Math.floor(canvasSize * 0.2), rx, Math.floor(rx * 0.4), color, false));
+
+  return commands;
+}
+
+module.exports = { lessonCoaxialEllipses };

package/domains/art-tree/lessons/ellipses/ellipse-anatomy.js

@@ -0,0 +1,26 @@
+/**
+ * Auto-extracted from ellipse_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Ellipse Anatomy (Symmetry, Major/Minor axes, Center)
+ */
+function lessonEllipseAnatomy(canvasSize = 32, color = '#00bcd4') {
+  const commands = [];
+  const cx = Math.floor(canvasSize / 2);
+  const cy = Math.floor(canvasSize / 2);
+  const rx = Math.floor(canvasSize * 0.35);
+  const ry = Math.floor(canvasSize * 0.2);
+  const angle = Math.PI / 6; // 30 degrees tilt to show axes clearly
+
+  // Draw ellipse
+  commands.push(...ellipseShapes.drawRotatedEllipse(cx, cy, rx, ry, angle, color));
+  
+  // Draw anatomy (axes and center)
+  commands.push(...ellipseShapes.drawEllipseAxes(cx, cy, rx, ry, angle));
+
+  return commands;
+}
+
+module.exports = { lessonEllipseAnatomy };

package/domains/art-tree/lessons/ellipses/ellipse-orientations.js

@@ -0,0 +1,28 @@
+/**
+ * Auto-extracted from ellipse_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Ellipse Orientations (Horizontal, Vertical, Tilted)
+ */
+function lessonEllipseOrientations(canvasSize = 32, color = '#2196f3') {
+  const commands = [];
+  const midY = Math.floor(canvasSize / 2);
+  const qX = Math.floor(canvasSize / 4);
+  const rLong = Math.floor(canvasSize * 0.2);
+  const rShort = Math.floor(canvasSize * 0.1);
+
+  // Horizontal (Left)
+  commands.push(shapes.drawEllipse(qX, midY, rLong, rShort, color, false));
+  
+  // Vertical (Middle)
+  commands.push(shapes.drawEllipse(qX * 2, midY, rShort, rLong, '#e91e63', false));
+  
+  // Tilted (Right) - 45 degrees
+  commands.push(...ellipseShapes.drawRotatedEllipse(qX * 3, midY, rLong, rShort, Math.PI / 4, '#4caf50'));
+
+  return commands;
+}
+
+module.exports = { lessonEllipseOrientations };

package/domains/art-tree/lessons/ellipses/ellipse-proportions.js

@@ -0,0 +1,27 @@
+/**
+ * Auto-extracted from ellipse_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Ellipse Proportions (Wide vs Narrow)
+ */
+function lessonEllipseProportions(canvasSize = 32, color = '#ff9800') {
+  const commands = [];
+  const midY = Math.floor(canvasSize / 2);
+  const qX = Math.floor(canvasSize / 4);
+  const rx = Math.floor(canvasSize * 0.2);
+
+  // Wide Ellipse (Closer to a circle)
+  commands.push(shapes.drawEllipse(qX, midY, rx, Math.floor(rx * 0.8), color, false));
+  
+  // Medium Ellipse
+  commands.push(shapes.drawEllipse(qX * 2, midY, rx, Math.floor(rx * 0.4), '#9c27b0', false));
+  
+  // Narrow Ellipse (Almost a line)
+  commands.push(shapes.drawEllipse(qX * 3, midY, rx, Math.floor(rx * 0.1), '#f44336', false));
+
+  return commands;
+}
+
+module.exports = { lessonEllipseProportions };

package/domains/art-tree/lessons/hidden/hidden-box.js

@@ -0,0 +1,20 @@
+/**
+ * Auto-extracted from hidden_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Hidden Box (6-sided box)
+ * You see 3 faces, but you must understand all 6.
+ */
+function lessonHiddenBox(canvasSize = 32, visibleColor = '#2196f3', hiddenColor = '#e0e0e0') {
+  const cx = Math.floor(canvasSize / 2);
+  const cy = Math.floor(canvasSize / 2);
+  const w = Math.floor(canvasSize * 0.4);
+  const h = Math.floor(canvasSize * 0.4);
+  const d = Math.floor(canvasSize * 0.4);
+
+  return hiddenShapes.drawXRayBox(cx, cy, w, h, d, visibleColor, hiddenColor);
+}
+
+module.exports = { lessonHiddenBox };

package/domains/art-tree/lessons/hidden/hidden-cup.js

@@ -0,0 +1,19 @@
+/**
+ * Auto-extracted from hidden_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Hidden Cup (Cup and inner bottom)
+ * You don't see the full inside bottom, but must understand how the wall goes down.
+ */
+function lessonHiddenCup(canvasSize = 32, visibleColor = '#4caf50', hiddenColor = '#e0e0e0') {
+  const cx = Math.floor(canvasSize / 2);
+  const cy = Math.floor(canvasSize / 2);
+  const r = Math.floor(canvasSize * 0.25);
+  const h = Math.floor(canvasSize * 0.5);
+
+  return hiddenShapes.drawXRayCup(cx, cy, r, h, visibleColor, hiddenColor);
+}
+
+module.exports = { lessonHiddenCup };

package/domains/art-tree/lessons/hidden/hidden-head.js

@@ -0,0 +1,18 @@
+/**
+ * Auto-extracted from hidden_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Hidden Head (Human head and skull)
+ * You don't see the whole skull, but must understand the structure behind it.
+ */
+function lessonHiddenHead(canvasSize = 32, visibleColor = '#ff5722', hiddenColor = '#e0e0e0') {
+  const cx = Math.floor(canvasSize / 2);
+  const cy = Math.floor(canvasSize * 0.4);
+  const r = Math.floor(canvasSize * 0.25);
+
+  return hiddenShapes.drawXRayHead(cx, cy, r, visibleColor, hiddenColor);
+}
+
+module.exports = { lessonHiddenHead };

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

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * lessons/index.js — Art Tree: Lessons Index
+ *
+ * Exports all lesson functions and catalog getters organized by category.
+ */
+
+const basic = require('./basic');
+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');
+
+module.exports = {
+  ...basic,
+  ...advanced,
+  ...curves,
+  ...ellipses,
+  ...forms3d,
+  ...structure,
+  ...crossSections,
+  ...transforms,
+  ...surfaces,
+  ...perspective,
+  ...hidden,
+  ...lighting,
+  ...materials,
+  ...analysis,
+  ...layers,
+  ...sky,
+};

package/domains/art-tree/{layer_lessons.js → lessons/layers/layer-step.js}

@@ -1,4 +1,7 @@
-const layerShapes = require('./layer_shapes');
+/**
+ * Auto-extracted from layer_lessons.js
+ */
+const shapes = require('../../shapes');
 
 /**
  * Lesson: Layer Structure (Tư duy Layer)
@@ -15,18 +18,4 @@ function lessonLayerStep(canvasSize = 32, layerIndex = 1) {
   return layerShapes.drawLayeredCup(cx, cy, canvasSize, validLayer);
 }
 
-function getLayerLessonCatalog() {
-  return [
-    { 
-      id: 'layer_step', 
-      name: '7-Layer Painting Structure', 
-      description: 'View the contents of a specific layer of a Cup (1=Ref, 2=Sketch, 3=Construction, 4=Lineart, 5=Color, 6=Shadow, 7=Light)', 
-      fn: lessonLayerStep 
-    }
-  ];
-}
-
-module.exports = {
-  lessonLayerStep,
-  getLayerLessonCatalog
-};
+module.exports = { lessonLayerStep };

package/domains/art-tree/lessons/lighting/contact-shadow.js

@@ -0,0 +1,33 @@
+/**
+ * Auto-extracted from light_lessons.js
+ */
+const shapes = require('../../shapes');
+
+/**
+ * Lesson: Contact Shadow (Point of contact shadow)
+ * The darkest area where an object touches the ground.
+ */
+function lessonContactShadow(canvasSize = 32) {
+  const commands = [];
+  const cx = Math.floor(canvasSize / 2);
+  const cy = Math.floor(canvasSize / 2);
+  const r = Math.floor(canvasSize * 0.3);
+
+  // Ground line
+  commands.push(shapes.drawLine(0, cy + r, canvasSize, cy + r, '#9e9e9e'));
+
+  // Sphere outline
+  commands.push(shapes.drawCircle(cx, cy, r, '#bdbdbd', false));
+
+  // Cast shadow (faint)
+  commands.push(shapes.drawEllipse(cx + Math.floor(r*0.5), cy + r, Math.floor(r*1.2), Math.floor(r*0.2), '#757575', true));
+
+  // CONTACT SHADOW (Pitch black, right at the touching point)
+  // Draw a very small, very dark ellipse directly under the center
+  commands.push(shapes.drawEllipse(cx, cy + r, Math.floor(r * 0.4), 2, '#000000', true));
+  commands.push(shapes.drawEllipse(cx, cy + r, Math.floor(r * 0.2), 1, '#000000', true));
+
+  return commands;
+}
+
+module.exports = { lessonContactShadow };