@mlightcad/data-model 1.7.28 → 1.7.30

package/lib/misc/pat/AcDbPatParser.js

@@ -0,0 +1,245 @@
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+/**
+ * Parser for AutoCAD PAT text content.
+ *
+ * This parser follows a best-effort strategy:
+ * - valid patterns are still returned when some rows are malformed;
+ * - non-fatal problems are collected into {@link AcDbPatDocument.issues};
+ * - PAT line numbers are preserved in parsed descriptors for diagnostics.
+ *
+ * Typical usage:
+ * - instantiate once and call {@link parse} for each PAT payload;
+ * - or call the convenience static {@link AcDbPatParser.parse} method.
+ */
+var AcDbPatParser = /** @class */ (function () {
+    function AcDbPatParser() {
+    }
+    /**
+     * Parse PAT file text into structured patterns and issues.
+     *
+     * The method accepts complete PAT file content (including comments, blank
+     * lines, and multiple pattern blocks). It normalizes line endings, parses
+     * headers and line descriptors, and records any recoverable errors.
+     *
+     * @param content - Raw PAT file text.
+     * @returns Parsed document containing both successful patterns and collected
+     * parse issues.
+     */
+    AcDbPatParser.prototype.parse = function (content) {
+        var _this = this;
+        var normalized = this.normalizeLineEndings(content);
+        var rawLines = normalized.split('\n');
+        var patterns = [];
+        var issues = [];
+        var currentPattern = null;
+        rawLines.forEach(function (rawLine, index) {
+            var lineNumber = index + 1;
+            var lineWithoutComment = _this.stripInlineComment(rawLine).trim();
+            if (!lineWithoutComment)
+                return;
+            if (lineWithoutComment.startsWith('*')) {
+                _this.flushCurrentPattern(currentPattern, patterns, issues);
+                var header = _this.parseHeader(lineWithoutComment.slice(1));
+                if (!header) {
+                    issues.push({
+                        line: lineNumber,
+                        message: 'Invalid pattern header.',
+                        source: rawLine
+                    });
+                    currentPattern = null;
+                    return;
+                }
+                currentPattern = {
+                    pattern: {
+                        name: header.name,
+                        description: header.description,
+                        lines: []
+                    },
+                    headerLine: lineNumber
+                };
+                return;
+            }
+            if (!currentPattern) {
+                issues.push({
+                    line: lineNumber,
+                    message: 'Line descriptor appears before any pattern header.',
+                    source: rawLine
+                });
+                return;
+            }
+            var descriptor = _this.parseLineDescriptor(lineWithoutComment, lineNumber);
+            if (!descriptor) {
+                issues.push({
+                    line: lineNumber,
+                    message: 'Invalid line descriptor. Expect: angle,x-origin,y-origin,delta-x,delta-y[,dash-1,...].',
+                    source: rawLine
+                });
+                return;
+            }
+            currentPattern.pattern.lines.push(descriptor);
+        });
+        this.flushCurrentPattern(currentPattern, patterns, issues);
+        return { patterns: patterns, issues: issues };
+    };
+    /**
+     * Parse PAT text without manually creating a parser instance.
+     *
+     * @param content - Raw PAT file text.
+     * @returns Parsed PAT document.
+     */
+    AcDbPatParser.parse = function (content) {
+        return new AcDbPatParser().parse(content);
+    };
+    /**
+     * Normalize line endings to Unix `\n` form.
+     *
+     * @param content - Raw text that may include `\r\n`, `\r`, or `\n`.
+     * @returns Text with all line endings converted to `\n`.
+     */
+    AcDbPatParser.prototype.normalizeLineEndings = function (content) {
+        return content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    };
+    /**
+     * Remove inline PAT comments from a source line.
+     *
+     * PAT comment syntax uses `;` and ignores everything after it.
+     *
+     * @param rawLine - Unprocessed source line from the PAT file.
+     * @returns Source line without trailing comment section.
+     */
+    AcDbPatParser.prototype.stripInlineComment = function (rawLine) {
+        var commentIndex = rawLine.indexOf(';');
+        if (commentIndex < 0)
+            return rawLine;
+        return rawLine.slice(0, commentIndex);
+    };
+    /**
+     * Parse a PAT header body after the leading `*`.
+     *
+     * Examples:
+     * - `ANSI31, 45 degree hatch`
+     * - `SOLID`
+     *
+     * @param body - Header content without the leading `*`.
+     * @returns Parsed `{ name, description }`, or `null` when header is invalid.
+     */
+    AcDbPatParser.prototype.parseHeader = function (body) {
+        var firstComma = body.indexOf(',');
+        if (firstComma < 0) {
+            var nameOnly = body.trim();
+            if (!nameOnly)
+                return null;
+            return { name: nameOnly, description: '' };
+        }
+        var name = body.slice(0, firstComma).trim();
+        var description = body.slice(firstComma + 1).trim();
+        if (!name)
+            return null;
+        return { name: name, description: description };
+    };
+    /**
+     * Parse a numeric token from PAT syntax.
+     *
+     * @param token - Numeric field text from a PAT row.
+     * @returns Finite number value, or `null` when token is not a valid number.
+     */
+    AcDbPatParser.prototype.parseNumber = function (token) {
+        var value = Number(token.trim());
+        return Number.isFinite(value) ? value : null;
+    };
+    /**
+     * Parse one PAT line descriptor row.
+     *
+     * Expected format:
+     * `angle,x-origin,y-origin,delta-x,delta-y[,dash-1,dash-2,...]`
+     *
+     * @param raw - Row text without inline comments.
+     * @param lineNumber - Original 1-based source line number.
+     * @returns Parsed line descriptor with source metadata, or `null` when row
+     * does not satisfy the expected numeric schema.
+     */
+    AcDbPatParser.prototype.parseLineDescriptor = function (raw, lineNumber) {
+        var e_1, _a;
+        var tokens = raw
+            .split(',')
+            .map(function (token) { return token.trim(); })
+            .filter(function (token) { return token.length > 0; });
+        if (tokens.length < 5)
+            return null;
+        var angle = this.parseNumber(tokens[0]);
+        var originX = this.parseNumber(tokens[1]);
+        var originY = this.parseNumber(tokens[2]);
+        var deltaX = this.parseNumber(tokens[3]);
+        var deltaY = this.parseNumber(tokens[4]);
+        if (angle == null ||
+            originX == null ||
+            originY == null ||
+            deltaX == null ||
+            deltaY == null) {
+            return null;
+        }
+        var dashTokens = tokens.slice(5);
+        var dashes = [];
+        try {
+            for (var dashTokens_1 = __values(dashTokens), dashTokens_1_1 = dashTokens_1.next(); !dashTokens_1_1.done; dashTokens_1_1 = dashTokens_1.next()) {
+                var token = dashTokens_1_1.value;
+                var value = this.parseNumber(token);
+                if (value == null)
+                    return null;
+                dashes.push(value);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (dashTokens_1_1 && !dashTokens_1_1.done && (_a = dashTokens_1.return)) _a.call(dashTokens_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return {
+            angle: angle,
+            originX: originX,
+            originY: originY,
+            deltaX: deltaX,
+            deltaY: deltaY,
+            dashes: dashes,
+            sourceLine: lineNumber
+        };
+    };
+    /**
+     * Finalize the current pattern and append it to output collections.
+     *
+     * If a pattern header was parsed but no line descriptor followed, this method
+     * records an issue and still emits the empty pattern to preserve source
+     * intent and ordering.
+     *
+     * @param currentPattern - Pattern currently being accumulated.
+     * @param patterns - Target array that receives completed patterns.
+     * @param issues - Target array that receives parse issues.
+     */
+    AcDbPatParser.prototype.flushCurrentPattern = function (currentPattern, patterns, issues) {
+        if (!currentPattern)
+            return;
+        if (currentPattern.pattern.lines.length === 0) {
+            issues.push({
+                line: currentPattern.headerLine,
+                message: "Pattern \"".concat(currentPattern.pattern.name, "\" has no line descriptor."),
+                source: ''
+            });
+        }
+        patterns.push(currentPattern.pattern);
+    };
+    return AcDbPatParser;
+}());
+export { AcDbPatParser };
+//# sourceMappingURL=AcDbPatParser.js.map

package/lib/misc/pat/AcDbPatParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbPatParser.js","sourceRoot":"","sources":["../../../src/misc/pat/AcDbPatParser.ts"],"names":[],"mappings":";;;;;;;;;;;AAsBA;;;;;;;;;;;GAWG;AACH;IAAA;IAwOA,CAAC;IAvOC;;;;;;;;;;OAUG;IACH,6BAAK,GAAL,UAAM,OAAe;QAArB,iBA+DC;QA9DC,IAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAA;QACrD,IAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACvC,IAAM,QAAQ,GAAqB,EAAE,CAAA;QACrC,IAAM,MAAM,GAAwB,EAAE,CAAA;QAEtC,IAAI,cAAc,GAAiC,IAAI,CAAA;QAEvD,QAAQ,CAAC,OAAO,CAAC,UAAC,OAAO,EAAE,KAAK;YAC9B,IAAM,UAAU,GAAG,KAAK,GAAG,CAAC,CAAA;YAC5B,IAAM,kBAAkB,GAAG,KAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;YAClE,IAAI,CAAC,kBAAkB;gBAAE,OAAM;YAE/B,IAAI,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvC,KAAI,CAAC,mBAAmB,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;gBAC1D,IAAM,MAAM,GAAG,KAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,UAAU;wBAChB,OAAO,EAAE,yBAAyB;wBAClC,MAAM,EAAE,OAAO;qBAChB,CAAC,CAAA;oBACF,cAAc,GAAG,IAAI,CAAA;oBACrB,OAAM;gBACR,CAAC;gBACD,cAAc,GAAG;oBACf,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,KAAK,EAAE,EAAE;qBACV;oBACD,UAAU,EAAE,UAAU;iBACvB,CAAA;gBACD,OAAM;YACR,CAAC;YAED,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE,oDAAoD;oBAC7D,MAAM,EAAE,OAAO;iBAChB,CAAC,CAAA;gBACF,OAAM;YACR,CAAC;YAED,IAAM,UAAU,GAAG,KAAI,CAAC,mBAAmB,CACzC,kBAAkB,EAClB,UAAU,CACX,CAAA;YACD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,UAAU;oBAChB,OAAO,EACL,wFAAwF;oBAC1F,MAAM,EAAE,OAAO;iBAChB,CAAC,CAAA;gBACF,OAAM;YACR,CAAC;YACD,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC/C,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,mBAAmB,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC1D,OAAO,EAAE,QAAQ,UAAA,EAAE,MAAM,QAAA,EAAE,CAAA;IAC7B,CAAC;IAED;;;;;OAKG;IACI,mBAAK,GAAZ,UAAa,OAAe;QAC1B,OAAO,IAAI,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED;;;;;OAKG;IACK,4CAAoB,GAA5B,UAA6B,OAAe;QAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC5D,CAAC;IAED;;;;;;;OAOG;IACK,0CAAkB,GAA1B,UAA2B,OAAe;QACxC,IAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACzC,IAAI,YAAY,GAAG,CAAC;YAAE,OAAO,OAAO,CAAA;QACpC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAA;IACvC,CAAC;IAED;;;;;;;;;OASG;IACK,mCAAW,GAAnB,UACE,IAAY;QAEZ,IAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACpC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,IAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;YAC5B,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAA;YAC1B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,CAAA;QAC5C,CAAC;QAED,IAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAA;QAC7C,IAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACrD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAA;QACtB,OAAO,EAAE,IAAI,MAAA,EAAE,WAAW,aAAA,EAAE,CAAA;IAC9B,CAAC;IAED;;;;;OAKG;IACK,mCAAW,GAAnB,UAAoB,KAAa;QAC/B,IAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IAC9C,CAAC;IAED;;;;;;;;;;OAUG;IACK,2CAAmB,GAA3B,UACE,GAAW,EACX,UAAkB;;QAElB,IAAM,MAAM,GAAG,GAAG;aACf,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,UAAA,KAAK,IAAI,OAAA,KAAK,CAAC,IAAI,EAAE,EAAZ,CAAY,CAAC;aAC1B,MAAM,CAAC,UAAA,KAAK,IAAI,OAAA,KAAK,CAAC,MAAM,GAAG,CAAC,EAAhB,CAAgB,CAAC,CAAA;QAEpC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QAElC,IAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QACzC,IAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3C,IAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3C,IAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,IAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,IACE,KAAK,IAAI,IAAI;YACb,OAAO,IAAI,IAAI;YACf,OAAO,IAAI,IAAI;YACf,MAAM,IAAI,IAAI;YACd,MAAM,IAAI,IAAI,EACd,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAClC,IAAM,MAAM,GAAa,EAAE,CAAA;;YAC3B,KAAoB,IAAA,eAAA,SAAA,UAAU,CAAA,sCAAA,8DAAE,CAAC;gBAA5B,IAAM,KAAK,uBAAA;gBACd,IAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;gBACrC,IAAI,KAAK,IAAI,IAAI;oBAAE,OAAO,IAAI,CAAA;gBAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACpB,CAAC;;;;;;;;;QAED,OAAO;YACL,KAAK,OAAA;YACL,OAAO,SAAA;YACP,OAAO,SAAA;YACP,MAAM,QAAA;YACN,MAAM,QAAA;YACN,MAAM,QAAA;YACN,UAAU,EAAE,UAAU;SACvB,CAAA;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACK,2CAAmB,GAA3B,UACE,cAA4C,EAC5C,QAA0B,EAC1B,MAA2B;QAE3B,IAAI,CAAC,cAAc;YAAE,OAAM;QAE3B,IAAI,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,cAAc,CAAC,UAAU;gBAC/B,OAAO,EAAE,oBAAY,cAAc,CAAC,OAAO,CAAC,IAAI,+BAA2B;gBAC3E,MAAM,EAAE,EAAE;aACX,CAAC,CAAA;QACJ,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IACH,oBAAC;AAAD,CAAC,AAxOD,IAwOC"}

package/lib/misc/pat/AcDbPatPredefined.d.ts

@@ -0,0 +1,10 @@
+import type { AcDbPatDocument } from './AcDbPatDefinition';
+/**
+ * Predefined hatch patterns from the classic `acad.pat` library.
+ */
+export declare const AcDbPredefinedAcadPat: AcDbPatDocument;
+/**
+ * Predefined hatch patterns from the ISO-oriented `acadiso.pat` library.
+ */
+export declare const AcDbPredefinedAcadIsoPat: AcDbPatDocument;
+//# sourceMappingURL=AcDbPatPredefined.d.ts.map

package/lib/misc/pat/AcDbPatPredefined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbPatPredefined.d.ts","sourceRoot":"","sources":["../../../src/misc/pat/AcDbPatPredefined.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,eA8wFnC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAijGtC,CAAA"}