woodml-parser 1.0.0

package/dist/integration.test.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * Integration tests for WoodML parser
+ * Tests real-world example files end-to-end
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const parser_1 = require("./parser");
+const svg_1 = require("./svg");
+const EXAMPLES_DIR = path.join(__dirname, '..', '..', '..', 'examples');
+function readExample(name) {
+    return fs.readFileSync(path.join(EXAMPLES_DIR, name), 'utf-8');
+}
+(0, node_test_1.describe)('Integration Tests', () => {
+    (0, node_test_1.describe)('simple-box.woodml', () => {
+        (0, node_test_1.it)('should parse and resolve', () => {
+            const source = readExample('simple-box.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            node_assert_1.default.strictEqual(doc.woodml, '1.0');
+            node_assert_1.default.ok(doc.project);
+            node_assert_1.default.strictEqual(doc.project.name, 'Simple Storage Box');
+        });
+        (0, node_test_1.it)('should have 4 parts', () => {
+            const source = readExample('simple-box.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            // front, back, 2 sides (as 1 with qty 2), bottom = 4 part definitions
+            node_assert_1.default.strictEqual(doc.resolvedParts.length, 4);
+        });
+        (0, node_test_1.it)('should resolve formulas correctly', () => {
+            const source = readExample('simple-box.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            // Check computed inside_length: $box_length - (2 * $material_thickness)
+            // box_length = 12", material_thickness = 0.5"
+            // inside_length = 12 - 1 = 11"
+            const insideLength = doc.resolvedVariables['inside_length'];
+            node_assert_1.default.ok(insideLength);
+            if (typeof insideLength === 'number') {
+                node_assert_1.default.strictEqual(insideLength, 11);
+            }
+            else {
+                node_assert_1.default.strictEqual(insideLength.value, 11);
+            }
+        });
+        (0, node_test_1.it)('should validate successfully', () => {
+            const source = readExample('simple-box.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parse(source);
+            const errors = (0, parser_1.validateDocument)(doc);
+            const critical = errors.filter(e => e.severity === 'error');
+            node_assert_1.default.strictEqual(critical.length, 0);
+        });
+        (0, node_test_1.it)('should generate cut list', () => {
+            const source = readExample('simple-box.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            const cutList = (0, parser_1.generateCutList)(doc);
+            node_assert_1.default.ok(cutList.length > 0);
+            // Each cut item should have required properties
+            for (const item of cutList) {
+                node_assert_1.default.ok(item.partId);
+                node_assert_1.default.ok(item.length);
+                node_assert_1.default.ok(item.width);
+                node_assert_1.default.ok(item.thickness);
+                node_assert_1.default.ok(item.quantity > 0);
+            }
+        });
+        (0, node_test_1.it)('should calculate board feet', () => {
+            const source = readExample('simple-box.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            const boardFeet = (0, parser_1.calculateBoardFeet)(doc);
+            node_assert_1.default.ok(boardFeet > 0);
+            node_assert_1.default.ok(boardFeet < 10); // Reasonable for a small box
+        });
+        (0, node_test_1.it)('should generate SVG diagram', () => {
+            const source = readExample('simple-box.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            const svg = (0, svg_1.generateSVG)(doc, 'parts');
+            node_assert_1.default.ok(svg.includes('<svg'));
+            node_assert_1.default.ok(svg.includes('</svg>'));
+            // Should have parts
+            node_assert_1.default.ok(svg.includes('data-id='));
+        });
+    });
+    (0, node_test_1.describe)('shaker-table.woodml', () => {
+        (0, node_test_1.it)('should parse complex project', () => {
+            const source = readExample('shaker-table.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            node_assert_1.default.strictEqual(doc.woodml, '1.0');
+            node_assert_1.default.ok(doc.project);
+        });
+        (0, node_test_1.it)('should have multiple parts', () => {
+            const source = readExample('shaker-table.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            // Should have legs, aprons, top, etc.
+            node_assert_1.default.ok(doc.resolvedParts.length >= 4);
+        });
+        (0, node_test_1.it)('should handle joinery', () => {
+            const source = readExample('shaker-table.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parse(source);
+            node_assert_1.default.ok(doc.joinery);
+            node_assert_1.default.ok(doc.joinery.length > 0);
+        });
+        (0, node_test_1.it)('should generate exploded view', () => {
+            const source = readExample('shaker-table.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            const svg = (0, svg_1.generateSVG)(doc, 'exploded');
+            node_assert_1.default.ok(svg.includes('<svg'));
+            node_assert_1.default.ok(svg.includes('class="part-3d"'));
+        });
+    });
+    (0, node_test_1.describe)('formulas-library.woodml', () => {
+        (0, node_test_1.it)('should parse formula library', () => {
+            const source = readExample('formulas-library.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parse(source);
+            node_assert_1.default.strictEqual(doc.woodml, '1.0');
+            node_assert_1.default.ok(doc.formulas);
+        });
+    });
+    (0, node_test_1.describe)('SVG generation options', () => {
+        (0, node_test_1.it)('should generate all color schemes', () => {
+            const source = readExample('simple-box.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            const schemes = ['default', 'blueprint', 'monochrome'];
+            for (const scheme of schemes) {
+                const generator = new svg_1.SVGGenerator({ colorScheme: scheme });
+                const svg = generator.generatePartsDiagram(doc);
+                node_assert_1.default.ok(svg.includes('<svg'), `Failed for ${scheme}`);
+            }
+        });
+        (0, node_test_1.it)('should generate all diagram types', () => {
+            const source = readExample('simple-box.woodml');
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            const types = ['parts', 'exploded', 'cutlist'];
+            for (const type of types) {
+                const svg = (0, svg_1.generateSVG)(doc, type);
+                node_assert_1.default.ok(svg.includes('<svg'), `Failed for ${type}`);
+            }
+        });
+    });
+    (0, node_test_1.describe)('Template integration', () => {
+        (0, node_test_1.it)('should work with drawer template', () => {
+            const source = readExample('templates/drawer.woodml');
+            const parser = new parser_1.WoodMLParser();
+            // Template files are parsed but may not instantiate directly
+            // Just verify it parses without errors
+            const doc = parser.parse(source);
+            node_assert_1.default.ok(doc.woodml);
+        });
+    });
+    (0, node_test_1.describe)('Error handling', () => {
+        (0, node_test_1.it)('should handle invalid YAML gracefully', () => {
+            const parser = new parser_1.WoodMLParser();
+            node_assert_1.default.throws(() => {
+                parser.parse('this is not: valid: yaml: [');
+            });
+        });
+        (0, node_test_1.it)('should handle missing woodml version', () => {
+            const parser = new parser_1.WoodMLParser();
+            node_assert_1.default.throws(() => {
+                parser.parse('project:\n  name: test');
+            }, /Missing required "woodml"/);
+        });
+    });
+    (0, node_test_1.describe)('Unit conversion in formulas', () => {
+        (0, node_test_1.it)('should handle mixed units', () => {
+            const source = `
+woodml: "1.0"
+project:
+  name: Test
+  units: imperial
+
+formulas:
+  vars:
+    width_in: 24"
+    width_mm: 610mm
+
+parts:
+  - id: test
+    dimensions:
+      length: $width_in
+      width: $width_mm
+      thickness: 3/4"
+`;
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            node_assert_1.default.strictEqual(doc.resolvedParts.length, 1);
+            const part = doc.resolvedParts[0];
+            // Both should be resolved to values
+            node_assert_1.default.ok(part.dimensions.length.value > 0);
+            node_assert_1.default.ok(part.dimensions.width.value > 0);
+        });
+    });
+    (0, node_test_1.describe)('Cut list accuracy', () => {
+        (0, node_test_1.it)('should account for quantities', () => {
+            const source = `
+woodml: "1.0"
+project:
+  name: Test
+
+parts:
+  - id: shelf
+    dimensions:
+      length: 36"
+      width: 12"
+      thickness: 3/4"
+    quantity: 5
+`;
+            const parser = new parser_1.WoodMLParser();
+            const doc = parser.parseAndResolve(source);
+            const cutList = (0, parser_1.generateCutList)(doc);
+            node_assert_1.default.strictEqual(cutList.length, 1);
+            node_assert_1.default.strictEqual(cutList[0].quantity, 5);
+            // Board feet = (36 * 12 * 0.75 / 144) * 5 = 1.875 * 5 = 11.25
+            // With rounding, should be close
+            const totalBoardFeet = cutList[0].boardFeet;
+            node_assert_1.default.ok(totalBoardFeet > 10 && totalBoardFeet < 13);
+        });
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.js","sourceRoot":"","sources":["../src/integration.test.ts"],"names":[],"mappings":"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"}

package/dist/optimizer.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Cut list optimization for WoodML projects
+ * Uses First Fit Decreasing bin packing algorithm for sheet goods
+ * and 1D bin packing for dimensional lumber
+ */
+import { ResolvedDocument } from './types';
+/**
+ * Standard sheet sizes (in inches)
+ */
+export declare const STANDARD_SHEET_SIZES: {
+    '4x8': {
+        width: number;
+        length: number;
+    };
+    '4x4': {
+        width: number;
+        length: number;
+    };
+    '5x5': {
+        width: number;
+        length: number;
+    };
+    '4x10': {
+        width: number;
+        length: number;
+    };
+    '4x12': {
+        width: number;
+        length: number;
+    };
+};
+/**
+ * Standard board lengths (in inches)
+ */
+export declare const STANDARD_BOARD_LENGTHS: number[];
+/**
+ * Optimization options
+ */
+export interface OptimizationOptions {
+    /** Saw kerf width in inches (default: 1/8") */
+    kerf?: number;
+    /** Allow parts to be rotated for better fit (default: true for sheet goods) */
+    allowRotation?: boolean;
+    /** Minimum usable cutoff size in inches (default: 6") */
+    minCutoff?: number;
+    /** Standard sheet size key (default: '4x8') */
+    sheetSize?: keyof typeof STANDARD_SHEET_SIZES;
+    /** Available board lengths (default: STANDARD_BOARD_LENGTHS) */
+    boardLengths?: number[];
+    /** Edge allowance for rough cuts (default: 0) */
+    edgeAllowance?: number;
+}
+/**
+ * A placed part on a sheet or board
+ */
+export interface PlacedPart {
+    partId: string;
+    partName: string;
+    x: number;
+    y: number;
+    width: number;
+    length: number;
+    rotated: boolean;
+}
+/**
+ * A sheet with placed parts
+ */
+export interface OptimizedSheet {
+    sheetNumber: number;
+    sheetWidth: number;
+    sheetLength: number;
+    parts: PlacedPart[];
+    usedArea: number;
+    wasteArea: number;
+    efficiency: number;
+}
+/**
+ * A board with placed parts (1D cutting)
+ */
+export interface OptimizedBoard {
+    boardNumber: number;
+    boardLength: number;
+    boardWidth: number;
+    boardThickness: number;
+    parts: {
+        partId: string;
+        partName: string;
+        position: number;
+        length: number;
+    }[];
+    usedLength: number;
+    wasteLength: number;
+    efficiency: number;
+}
+/**
+ * Complete optimization result
+ */
+export interface OptimizationResult {
+    sheets: OptimizedSheet[];
+    boards: OptimizedBoard[];
+    totalSheets: number;
+    totalBoards: {
+        length: number;
+        count: number;
+    }[];
+    overallEfficiency: number;
+    wastePercentage: number;
+    unplacedParts: string[];
+    notes: string[];
+}
+/**
+ * Optimize cut list for a project
+ */
+export declare function optimizeCutList(doc: ResolvedDocument, options?: OptimizationOptions): OptimizationResult;
+/**
+ * Format optimization result as text
+ */
+export declare function formatOptimizationResult(result: OptimizationResult): string;
+//# sourceMappingURL=optimizer.d.ts.map

package/dist/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../src/optimizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAgB,MAAM,SAAS,CAAC;AAIzD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;CAMhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAA0B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,OAAO,oBAAoB,CAAC;IAC9C,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AA0WD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CA6EpB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA8E3E"}