woodml-parser 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,250 @@
+/**
+ * WoodML TypeScript Type Definitions
+ * Core types for the WoodML markup language
+ */
+export type UnitSystem = 'imperial' | 'metric';
+export interface Dimension {
+    /** Value in base units (inches for imperial, mm for metric) */
+    value: number;
+    /** Original unit system */
+    unit: UnitSystem;
+    /** Original string representation */
+    original: string;
+}
+export interface FractionalInches {
+    whole: number;
+    numerator: number;
+    denominator: number;
+}
+export interface WoodMLDocument {
+    woodml: string;
+    project?: Project;
+    imports?: string[];
+    materials?: Materials;
+    formulas?: Formulas;
+    parts?: Part[];
+    joinery?: Joint[];
+    cutlist?: CutList;
+    assembly?: AssemblyStep[];
+    finishing?: Finishing;
+    tools?: Tools;
+    notes?: string;
+}
+export interface Project {
+    name?: string;
+    author?: string;
+    version?: string;
+    units?: UnitSystem;
+    description?: string;
+}
+export interface Materials {
+    lumber?: Lumber[];
+    hardware?: Hardware[];
+    sheet_goods?: SheetGood[];
+}
+export interface Lumber {
+    id: string;
+    species?: string;
+    thickness?: string;
+    nominal?: string;
+    actual?: string;
+    length?: string;
+    width?: string;
+    board_feet?: number;
+    quantity?: number;
+    notes?: string;
+}
+export interface Hardware {
+    id: string;
+    type: 'screw' | 'nail' | 'bolt' | 'hinge' | 'knob' | 'pull' | 'slide' | 'adhesive' | 'dowel' | 'biscuit' | 'other';
+    name?: string;
+    size?: string;
+    quantity?: number;
+    notes?: string;
+}
+export interface SheetGood {
+    id: string;
+    type: 'plywood' | 'mdf' | 'particleboard' | 'hardboard' | 'melamine' | 'other';
+    thickness?: string;
+    grade?: string;
+    size?: string;
+    quantity?: number;
+    notes?: string;
+}
+export interface Formulas {
+    vars?: Record<string, string>;
+    computed?: Record<string, string>;
+    use_library?: string[];
+    custom?: Record<string, CustomFormula>;
+}
+export interface CustomFormula {
+    params: string[];
+    formula: string;
+}
+export interface Part {
+    id: string;
+    name?: string;
+    use?: string;
+    params?: Record<string, string>;
+    material?: string;
+    dimensions?: Dimensions;
+    grain?: 'long' | 'short' | 'any';
+    quantity?: number;
+    tapers?: Taper[];
+    profiles?: Profile[];
+    notes?: string;
+}
+export interface Dimensions {
+    length?: string;
+    width?: string;
+    thickness?: string;
+    depth?: string;
+}
+export interface Taper {
+    face?: 'inside' | 'outside' | 'front' | 'back' | 'all';
+    faces?: string[];
+    start?: string;
+    end_dimension?: string;
+    taper_per_foot?: string;
+}
+export interface Profile {
+    edge?: 'top' | 'bottom' | 'left' | 'right' | 'front' | 'back' | 'all';
+    type: 'roundover' | 'chamfer' | 'ogee' | 'cove' | 'bead' | 'ease' | 'bullnose' | 'custom';
+    radius?: string;
+    size?: string;
+}
+export type JointType = 'mortise_and_tenon' | 'dovetail' | 'box_joint' | 'dado' | 'rabbet' | 'groove' | 'tongue_and_groove' | 'biscuit' | 'dowel' | 'pocket_hole' | 'miter' | 'spline' | 'half_lap' | 'bridle' | 'finger_joint' | 'scarf' | 'butt';
+export interface Joint {
+    type: JointType;
+    parts?: string[];
+    mortise?: MortiseSpec;
+    tenon?: TenonSpec;
+    tails?: DovetailSpec;
+    pins?: DovetailSpec;
+    ratio?: string;
+    style?: string;
+    housing?: string | HousingSpec;
+    insert?: string | InsertSpec;
+    connections?: [string, string][];
+    width?: string;
+    depth?: string;
+    position?: string | PositionSpec;
+}
+export interface MortiseSpec {
+    part: string;
+    position?: string | PositionSpec;
+    dimensions?: {
+        width?: string;
+        height?: string;
+        depth?: string;
+    };
+}
+export interface TenonSpec {
+    part: string;
+    position?: string | PositionSpec;
+    dimensions?: {
+        width?: string;
+        height?: string;
+        length?: string;
+    };
+    shoulder?: string | ShoulderSpec;
+    haunch?: {
+        height?: string;
+        length?: string;
+    };
+}
+export interface DovetailSpec {
+    part: string;
+    count?: number;
+    spacing?: 'even' | 'graduated';
+    half_pin?: string;
+}
+export interface HousingSpec {
+    part: string;
+    position?: string;
+    width?: string;
+    depth?: string;
+}
+export interface InsertSpec {
+    part: string;
+}
+export interface PositionSpec {
+    from_top?: string;
+    from_bottom?: string;
+    from_left?: string;
+    from_right?: string;
+    from_front?: string;
+    from_back?: string;
+    from_outside?: string;
+    from_inside?: string;
+}
+export interface ShoulderSpec {
+    top?: string;
+    bottom?: string;
+    front?: string;
+    back?: string;
+    all?: string;
+}
+export interface CutList {
+    optimize?: boolean;
+    kerf?: string;
+    groups?: CutGroup[];
+}
+export interface CutGroup {
+    from: string;
+    stock_size?: string;
+    respect_grain?: boolean;
+    edge_allowance?: string;
+    rough_length_add?: string;
+    rough_width_add?: string;
+    cuts: CutSpec[];
+}
+export interface CutSpec {
+    part: string;
+    quantity?: number;
+    grain?: 'length' | 'width' | 'any';
+    priority?: number;
+}
+export interface AssemblyStep {
+    step: number;
+    title: string;
+    parts?: string[];
+    operations?: string[];
+    tools?: string[];
+    notes?: string;
+    subassemblies?: Subassembly[];
+}
+export interface Subassembly {
+    name: string;
+    parts: string[];
+    clamp_time?: string;
+}
+export interface Finishing {
+    steps: FinishStep[];
+}
+export interface FinishStep {
+    type: 'sand' | 'stain' | 'dye' | 'topcoat' | 'wax' | 'oil' | 'other';
+    grits?: number[];
+    product?: string;
+    coats?: number;
+    dry_time?: string;
+    sand_between?: number | string;
+    notes?: string;
+}
+export interface Tools {
+    required?: (string | Record<string, number>)[];
+    optional?: (string | Record<string, number>)[];
+}
+export interface ResolvedPart extends Omit<Part, 'dimensions'> {
+    dimensions: {
+        length: Dimension;
+        width: Dimension;
+        thickness: Dimension;
+    };
+    resolvedQuantity: number;
+}
+export interface ResolvedDocument extends Omit<WoodMLDocument, 'parts'> {
+    resolvedParts: ResolvedPart[];
+    resolvedVariables: Record<string, Dimension | number>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * WoodML TypeScript Type Definitions
+ * Core types for the WoodML markup language
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/units.d.ts

@@ -0,0 +1,53 @@
+/**
+ * WoodML Unit Parsing and Conversion
+ * Handles imperial (fractional inches) and metric measurements
+ */
+import { Dimension, FractionalInches, UnitSystem } from './types';
+/**
+ * Parse a dimension string into a Dimension object
+ */
+export declare function parseDimension(input: string, defaultUnit?: UnitSystem): Dimension;
+/**
+ * Convert dimension to inches
+ */
+export declare function toInches(dim: Dimension): number;
+/**
+ * Convert dimension to millimeters
+ */
+export declare function toMillimeters(dim: Dimension): number;
+/**
+ * Convert dimension to the specified unit system
+ */
+export declare function convertTo(dim: Dimension, targetUnit: UnitSystem): Dimension;
+/**
+ * Convert decimal inches to fractional representation
+ */
+export declare function decimalToFraction(decimal: number, maxDenominator?: number): FractionalInches;
+/**
+ * Format dimension as imperial string
+ */
+export declare function formatImperial(dim: Dimension, precision?: number): string;
+/**
+ * Format dimension as metric string
+ */
+export declare function formatMetric(dim: Dimension, decimals?: number): string;
+/**
+ * Format dimension in its native unit
+ */
+export declare function formatDimension(dim: Dimension): string;
+/**
+ * Parse dimensional lumber notation (e.g., "2x4")
+ */
+export declare function parseDimensionalLumber(notation: string): {
+    width: Dimension;
+    thickness: Dimension;
+} | null;
+/**
+ * Check if a string is a variable reference
+ */
+export declare function isVariableReference(input: string): boolean;
+/**
+ * Extract variable name from reference
+ */
+export declare function extractVariableName(input: string): string | null;
+//# sourceMappingURL=units.d.ts.map

package/dist/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../src/units.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAoElE;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,UAAuB,GAAG,SAAS,CAgH7F;AAiBD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAM/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,GAAG,SAAS,CAkB3E;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,GAAE,MAAW,GAAG,gBAAgB,CAyChG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAgC7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAUzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAKtD;AAUD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAa1G;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE"}

package/dist/units.js

@@ -0,0 +1,359 @@
+"use strict";
+/**
+ * WoodML Unit Parsing and Conversion
+ * Handles imperial (fractional inches) and metric measurements
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDimension = parseDimension;
+exports.toInches = toInches;
+exports.toMillimeters = toMillimeters;
+exports.convertTo = convertTo;
+exports.decimalToFraction = decimalToFraction;
+exports.formatImperial = formatImperial;
+exports.formatMetric = formatMetric;
+exports.formatDimension = formatDimension;
+exports.parseDimensionalLumber = parseDimensionalLumber;
+exports.isVariableReference = isVariableReference;
+exports.extractVariableName = extractVariableName;
+// ============================================
+// CONSTANTS
+// ============================================
+const INCHES_PER_FOOT = 12;
+const MM_PER_INCH = 25.4;
+const MM_PER_CM = 10;
+const MM_PER_METER = 1000;
+// Common denominators for fractions (must be powers of 2)
+const VALID_DENOMINATORS = [2, 4, 8, 16, 32, 64];
+// ============================================
+// PARSING REGULAR EXPRESSIONS
+// ============================================
+const PATTERNS = {
+    // Imperial patterns
+    wholeInches: /^(\d+)"$/, // 24"
+    fractionalInches: /^(\d+)\/(\d+)"$/, // 3/4"
+    mixedInches: /^(\d+)-(\d+)\/(\d+)"$/, // 3-1/2"
+    feetOnly: /^(\d+)'$/, // 6'
+    feetAndInches: /^(\d+)'(\d+)"$/, // 6'4"
+    feetAndMixed: /^(\d+)'(\d+)-(\d+)\/(\d+)"$/, // 6'4-1/2"
+    quarterNotation: /^(\d+)\/4$/, // 4/4, 8/4
+    // Metric patterns
+    millimeters: /^(\d+(?:\.\d+)?)mm$/i, // 610mm
+    centimeters: /^(\d+(?:\.\d+)?)cm$/i, // 61cm
+    meters: /^(\d+(?:\.\d+)?)m$/i, // 2.4m
+    // Variable reference
+    variable: /^\$([a-zA-Z_][a-zA-Z0-9_]*)$/, // $variable
+    // Dimensional lumber
+    dimensionalLumber: /^(\d+)x(\d+)$/, // 2x4
+};
+// ============================================
+// DIMENSIONAL LUMBER ACTUAL SIZES
+// ============================================
+const DIMENSIONAL_LUMBER = {
+    '1x2': { width: 1.5, thickness: 0.75 },
+    '1x3': { width: 2.5, thickness: 0.75 },
+    '1x4': { width: 3.5, thickness: 0.75 },
+    '1x6': { width: 5.5, thickness: 0.75 },
+    '1x8': { width: 7.25, thickness: 0.75 },
+    '1x10': { width: 9.25, thickness: 0.75 },
+    '1x12': { width: 11.25, thickness: 0.75 },
+    '2x2': { width: 1.5, thickness: 1.5 },
+    '2x3': { width: 2.5, thickness: 1.5 },
+    '2x4': { width: 3.5, thickness: 1.5 },
+    '2x6': { width: 5.5, thickness: 1.5 },
+    '2x8': { width: 7.25, thickness: 1.5 },
+    '2x10': { width: 9.25, thickness: 1.5 },
+    '2x12': { width: 11.25, thickness: 1.5 },
+    '4x4': { width: 3.5, thickness: 3.5 },
+    '4x6': { width: 5.5, thickness: 3.5 },
+    '6x6': { width: 5.5, thickness: 5.5 },
+};
+// ============================================
+// PARSING FUNCTIONS
+// ============================================
+/**
+ * Parse a dimension string into a Dimension object
+ */
+function parseDimension(input, defaultUnit = 'imperial') {
+    const trimmed = input.trim();
+    // Try each pattern
+    let match;
+    // Whole inches: 24"
+    if ((match = trimmed.match(PATTERNS.wholeInches))) {
+        return {
+            value: parseInt(match[1], 10),
+            unit: 'imperial',
+            original: trimmed,
+        };
+    }
+    // Fractional inches: 3/4"
+    if ((match = trimmed.match(PATTERNS.fractionalInches))) {
+        const num = parseInt(match[1], 10);
+        const denom = parseInt(match[2], 10);
+        validateDenominator(denom);
+        return {
+            value: num / denom,
+            unit: 'imperial',
+            original: trimmed,
+        };
+    }
+    // Mixed inches: 3-1/2"
+    if ((match = trimmed.match(PATTERNS.mixedInches))) {
+        const whole = parseInt(match[1], 10);
+        const num = parseInt(match[2], 10);
+        const denom = parseInt(match[3], 10);
+        validateDenominator(denom);
+        return {
+            value: whole + num / denom,
+            unit: 'imperial',
+            original: trimmed,
+        };
+    }
+    // Feet only: 6'
+    if ((match = trimmed.match(PATTERNS.feetOnly))) {
+        return {
+            value: parseInt(match[1], 10) * INCHES_PER_FOOT,
+            unit: 'imperial',
+            original: trimmed,
+        };
+    }
+    // Feet and inches: 6'4"
+    if ((match = trimmed.match(PATTERNS.feetAndInches))) {
+        const feet = parseInt(match[1], 10);
+        const inches = parseInt(match[2], 10);
+        return {
+            value: feet * INCHES_PER_FOOT + inches,
+            unit: 'imperial',
+            original: trimmed,
+        };
+    }
+    // Feet and mixed inches: 6'4-1/2"
+    if ((match = trimmed.match(PATTERNS.feetAndMixed))) {
+        const feet = parseInt(match[1], 10);
+        const inches = parseInt(match[2], 10);
+        const num = parseInt(match[3], 10);
+        const denom = parseInt(match[4], 10);
+        validateDenominator(denom);
+        return {
+            value: feet * INCHES_PER_FOOT + inches + num / denom,
+            unit: 'imperial',
+            original: trimmed,
+        };
+    }
+    // Quarter notation: 4/4
+    if ((match = trimmed.match(PATTERNS.quarterNotation))) {
+        const quarters = parseInt(match[1], 10);
+        return {
+            value: quarters / 4,
+            unit: 'imperial',
+            original: trimmed,
+        };
+    }
+    // Millimeters: 610mm
+    if ((match = trimmed.match(PATTERNS.millimeters))) {
+        return {
+            value: parseFloat(match[1]),
+            unit: 'metric',
+            original: trimmed,
+        };
+    }
+    // Centimeters: 61cm
+    if ((match = trimmed.match(PATTERNS.centimeters))) {
+        return {
+            value: parseFloat(match[1]) * MM_PER_CM,
+            unit: 'metric',
+            original: trimmed,
+        };
+    }
+    // Meters: 2.4m
+    if ((match = trimmed.match(PATTERNS.meters))) {
+        return {
+            value: parseFloat(match[1]) * MM_PER_METER,
+            unit: 'metric',
+            original: trimmed,
+        };
+    }
+    throw new Error(`Invalid dimension format: "${input}"`);
+}
+/**
+ * Validate that denominator is a power of 2
+ */
+function validateDenominator(denom) {
+    if (!VALID_DENOMINATORS.includes(denom)) {
+        throw new Error(`Invalid fraction denominator: ${denom}. Must be one of: ${VALID_DENOMINATORS.join(', ')}`);
+    }
+}
+// ============================================
+// CONVERSION FUNCTIONS
+// ============================================
+/**
+ * Convert dimension to inches
+ */
+function toInches(dim) {
+    if (dim.unit === 'imperial') {
+        return dim.value;
+    }
+    // Convert from mm to inches
+    return dim.value / MM_PER_INCH;
+}
+/**
+ * Convert dimension to millimeters
+ */
+function toMillimeters(dim) {
+    if (dim.unit === 'metric') {
+        return dim.value;
+    }
+    // Convert from inches to mm
+    return dim.value * MM_PER_INCH;
+}
+/**
+ * Convert dimension to the specified unit system
+ */
+function convertTo(dim, targetUnit) {
+    if (dim.unit === targetUnit) {
+        return dim;
+    }
+    if (targetUnit === 'imperial') {
+        return {
+            value: toInches(dim),
+            unit: 'imperial',
+            original: dim.original,
+        };
+    }
+    else {
+        return {
+            value: toMillimeters(dim),
+            unit: 'metric',
+            original: dim.original,
+        };
+    }
+}
+// ============================================
+// FORMATTING FUNCTIONS
+// ============================================
+/**
+ * Convert decimal inches to fractional representation
+ */
+function decimalToFraction(decimal, maxDenominator = 64) {
+    const whole = Math.floor(decimal);
+    let remainder = decimal - whole;
+    if (remainder < 0.001) {
+        return { whole, numerator: 0, denominator: 1 };
+    }
+    // Find closest fraction
+    let bestNumerator = 0;
+    let bestDenominator = 1;
+    let bestError = remainder;
+    for (const denom of VALID_DENOMINATORS) {
+        if (denom > maxDenominator)
+            break;
+        const num = Math.round(remainder * denom);
+        const error = Math.abs(remainder - num / denom);
+        if (error < bestError) {
+            bestError = error;
+            bestNumerator = num;
+            bestDenominator = denom;
+        }
+    }
+    // Simplify fraction
+    const gcd = greatestCommonDivisor(bestNumerator, bestDenominator);
+    bestNumerator /= gcd;
+    bestDenominator /= gcd;
+    // Handle case where fraction rounds to 1
+    if (bestNumerator === bestDenominator) {
+        return { whole: whole + 1, numerator: 0, denominator: 1 };
+    }
+    return {
+        whole,
+        numerator: bestNumerator,
+        denominator: bestDenominator,
+    };
+}
+/**
+ * Format dimension as imperial string
+ */
+function formatImperial(dim, precision = 64) {
+    const inches = toInches(dim);
+    // Check if we should use feet
+    if (inches >= 12) {
+        const feet = Math.floor(inches / 12);
+        const remainingInches = inches % 12;
+        if (remainingInches < 0.01) {
+            return `${feet}'`;
+        }
+        const frac = decimalToFraction(remainingInches, precision);
+        if (frac.numerator === 0) {
+            return `${feet}'${frac.whole}"`;
+        }
+        if (frac.whole === 0) {
+            return `${feet}'${frac.numerator}/${frac.denominator}"`;
+        }
+        return `${feet}'${frac.whole}-${frac.numerator}/${frac.denominator}"`;
+    }
+    // Format as inches
+    const frac = decimalToFraction(inches, precision);
+    if (frac.numerator === 0) {
+        return `${frac.whole}"`;
+    }
+    if (frac.whole === 0) {
+        return `${frac.numerator}/${frac.denominator}"`;
+    }
+    return `${frac.whole}-${frac.numerator}/${frac.denominator}"`;
+}
+/**
+ * Format dimension as metric string
+ */
+function formatMetric(dim, decimals = 1) {
+    const mm = toMillimeters(dim);
+    if (mm >= 1000) {
+        return `${(mm / 1000).toFixed(decimals)}m`;
+    }
+    if (mm >= 100 && mm % 10 === 0) {
+        return `${mm / 10}cm`;
+    }
+    return `${mm.toFixed(decimals)}mm`;
+}
+/**
+ * Format dimension in its native unit
+ */
+function formatDimension(dim) {
+    if (dim.unit === 'imperial') {
+        return formatImperial(dim);
+    }
+    return formatMetric(dim);
+}
+// ============================================
+// UTILITY FUNCTIONS
+// ============================================
+function greatestCommonDivisor(a, b) {
+    return b === 0 ? a : greatestCommonDivisor(b, a % b);
+}
+/**
+ * Parse dimensional lumber notation (e.g., "2x4")
+ */
+function parseDimensionalLumber(notation) {
+    const match = notation.match(PATTERNS.dimensionalLumber);
+    if (!match)
+        return null;
+    const key = `${match[1]}x${match[2]}`;
+    const actual = DIMENSIONAL_LUMBER[key];
+    if (!actual)
+        return null;
+    return {
+        width: { value: actual.width, unit: 'imperial', original: `${actual.width}"` },
+        thickness: { value: actual.thickness, unit: 'imperial', original: `${actual.thickness}"` },
+    };
+}
+/**
+ * Check if a string is a variable reference
+ */
+function isVariableReference(input) {
+    return PATTERNS.variable.test(input.trim());
+}
+/**
+ * Extract variable name from reference
+ */
+function extractVariableName(input) {
+    const match = input.trim().match(PATTERNS.variable);
+    return match ? match[1] : null;
+}
+//# sourceMappingURL=units.js.map