@mlightcad/data-model 1.11.2 → 1.12.0

package/lib/acis/AcDbAcisDecrypt.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Decrypts obfuscated ACIS SAT text stored in DXF group codes 1 and 3.
+ *
+ * AutoCAD applies `chr(159 - ord(c))` to every character above ASCII space.
+ * See LibreDWG `dec_sat.pl` and the DXF reference for 3DSOLID/REGION/BODY.
+ *
+ * Ported from `@mlightcad/dxf-json` `parser/acis/decrypt.ts`.
+ */
+/**
+ * Decrypts an obfuscated SAT fragment from a DXF group 1 or 3 value.
+ *
+ * @param encrypted - Obfuscated SAT fragment.
+ */
+export declare function acdbDecryptAcisData(encrypted: string): string;
+/**
+ * Returns true when `data` looks like encrypted ACIS rather than plain SAT/ASM
+ * text (which typically starts with a version number or "ACIS"/"ASM").
+ *
+ * @param data - Raw group 1/3 value before decryption.
+ */
+export declare function acdbIsEncryptedAcisData(data: string): boolean;
+/**
+ * Decrypts ACIS data when it is still in the DXF obfuscated form; otherwise
+ * returns the input unchanged.
+ *
+ * @param data - Raw or already-decrypted SAT fragment.
+ */
+export declare function acdbNormalizeAcisData(data: string): string;
+/**
+ * Decrypts each SAT line and joins them with `\n`.
+ *
+ * @param lines - One logical SAT line per group-code 1 (group 3 fragments are
+ *   already stitched onto the preceding line).
+ */
+export declare function acdbJoinAcisPayloadLines(lines: readonly string[]): string;
+/**
+ * Stitches group-code 1/3 SAT fragments: group 1 starts a new SAT line and
+ * group 3 continues the previous line (255-character splits).
+ *
+ * @param lines - Mutable accumulator for logical SAT lines.
+ * @param code - DXF group code (1 or 3).
+ * @param value - Raw group value to append.
+ */
+export declare function acdbAppendAcisPayloadFragment(lines: string[], code: 1 | 3, value: string): void;
+/**
+ * Joins encrypted ACSH OBJECT group-1 chunks (no newlines between chunks).
+ *
+ * @param chunks - Ordered group 1/3 fragments from an ACSH OBJECT entry.
+ */
+export declare function acdbJoinAcisObjectChunks(chunks: readonly string[]): string;
+//# sourceMappingURL=AcDbAcisDecrypt.d.ts.map

package/lib/acis/AcDbAcisDecrypt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbAcisDecrypt.d.ts","sourceRoot":"","sources":["../../src/acis/AcDbAcisDecrypt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmB7D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKzE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,CAAC,GAAG,CAAC,EACX,KAAK,EAAE,MAAM,GACZ,IAAI,CAUN;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAK1E"}

package/lib/acis/AcDbAcisDecrypt.js

@@ -0,0 +1,98 @@
+/**
+ * Decrypts obfuscated ACIS SAT text stored in DXF group codes 1 and 3.
+ *
+ * AutoCAD applies `chr(159 - ord(c))` to every character above ASCII space.
+ * See LibreDWG `dec_sat.pl` and the DXF reference for 3DSOLID/REGION/BODY.
+ *
+ * Ported from `@mlightcad/dxf-json` `parser/acis/decrypt.ts`.
+ */
+/**
+ * Decrypts an obfuscated SAT fragment from a DXF group 1 or 3 value.
+ *
+ * @param encrypted - Obfuscated SAT fragment.
+ */
+export function acdbDecryptAcisData(encrypted) {
+    var decrypted = '';
+    for (var i = 0; i < encrypted.length; i++) {
+        var code = encrypted.charCodeAt(i);
+        decrypted += code <= 32 ? encrypted[i] : String.fromCharCode(159 - code);
+    }
+    return decrypted;
+}
+/**
+ * Returns true when `data` looks like encrypted ACIS rather than plain SAT/ASM
+ * text (which typically starts with a version number or "ACIS"/"ASM").
+ *
+ * @param data - Raw group 1/3 value before decryption.
+ */
+export function acdbIsEncryptedAcisData(data) {
+    var trimmed = data.trimStart();
+    if (!trimmed) {
+        return false;
+    }
+    if (/^\d/.test(trimmed) || /^ACIS/i.test(trimmed) || /^ASM/i.test(trimmed)) {
+        return false;
+    }
+    if (/^(body|point|plane|cone|cylinder|sphere|torus|lump|shell|face|edge|wire|transform)\b/i.test(trimmed)) {
+        return false;
+    }
+    if (/\b(body|point|straight-curve|ellipse-curve)\s+\$/.test(trimmed)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Decrypts ACIS data when it is still in the DXF obfuscated form; otherwise
+ * returns the input unchanged.
+ *
+ * @param data - Raw or already-decrypted SAT fragment.
+ */
+export function acdbNormalizeAcisData(data) {
+    if (!data || !acdbIsEncryptedAcisData(data)) {
+        return data;
+    }
+    return acdbDecryptAcisData(data);
+}
+/**
+ * Decrypts each SAT line and joins them with `\n`.
+ *
+ * @param lines - One logical SAT line per group-code 1 (group 3 fragments are
+ *   already stitched onto the preceding line).
+ */
+export function acdbJoinAcisPayloadLines(lines) {
+    if (lines.length === 0) {
+        return '';
+    }
+    return lines.map(function (line) { return acdbNormalizeAcisData(line); }).join('\n');
+}
+/**
+ * Stitches group-code 1/3 SAT fragments: group 1 starts a new SAT line and
+ * group 3 continues the previous line (255-character splits).
+ *
+ * @param lines - Mutable accumulator for logical SAT lines.
+ * @param code - DXF group code (1 or 3).
+ * @param value - Raw group value to append.
+ */
+export function acdbAppendAcisPayloadFragment(lines, code, value) {
+    if (code === 1) {
+        lines.push(value);
+        return;
+    }
+    if (lines.length === 0) {
+        lines.push(value);
+        return;
+    }
+    lines[lines.length - 1] += value;
+}
+/**
+ * Joins encrypted ACSH OBJECT group-1 chunks (no newlines between chunks).
+ *
+ * @param chunks - Ordered group 1/3 fragments from an ACSH OBJECT entry.
+ */
+export function acdbJoinAcisObjectChunks(chunks) {
+    if (chunks.length === 0) {
+        return '';
+    }
+    return acdbNormalizeAcisData(chunks.join(''));
+}
+//# sourceMappingURL=AcDbAcisDecrypt.js.map

package/lib/acis/AcDbAcisDecrypt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcDbAcisDecrypt.js","sourceRoot":"","sources":["../../src/acis/AcDbAcisDecrypt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,IAAI,SAAS,GAAG,EAAE,CAAA;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QACpC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;IAC3E,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,IAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IACE,uFAAuF,CAAC,IAAI,CAC1F,OAAO,CACR,EACD,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,kDAAkD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACrE,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,IAAI,CAAC,IAAI,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAwB;IAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,UAAA,IAAI,IAAI,OAAA,qBAAqB,CAAC,IAAI,CAAC,EAA3B,CAA2B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAe,EACf,IAAW,EACX,KAAa;IAEb,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjB,OAAM;IACR,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjB,OAAM;IACR,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,CAAA;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAyB;IAChE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,OAAO,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AAC/C,CAAC"}

package/lib/acis/index.d.ts

@@ -3,6 +3,7 @@
  *
  * @packageDocumentation
  */
+export { acdbAppendAcisPayloadFragment, acdbDecryptAcisData, acdbIsEncryptedAcisData, acdbJoinAcisObjectChunks, acdbJoinAcisPayloadLines, acdbNormalizeAcisData } from './AcDbAcisDecrypt';
 export { acdbParseAcisSab, AcDbAcisSabTag } from './AcDbAcisSab';
 export type { AcDbAcisSabData, AcDbAcisSabHeader, AcDbAcisSabRecord, AcDbAcisSabToken, AcDbAcisSabTokenValue, AcDbAcisSabVector, } from './AcDbAcisSab';
 export { acdbBuildAcisModel } from './AcDbAcisEntities';

package/lib/acis/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acis/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAChE,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,0BAA0B,EAC1B,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,qCAAqC,EACrC,gCAAgC,GACjC,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acis/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAChE,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,0BAA0B,EAC1B,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,qCAAqC,EACrC,gCAAgC,GACjC,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAA"}

package/lib/acis/index.js

@@ -3,6 +3,7 @@
  *
  * @packageDocumentation
  */
+export { acdbAppendAcisPayloadFragment, acdbDecryptAcisData, acdbIsEncryptedAcisData, acdbJoinAcisObjectChunks, acdbJoinAcisPayloadLines, acdbNormalizeAcisData } from './AcDbAcisDecrypt';
 export { acdbParseAcisSab, AcDbAcisSabTag } from './AcDbAcisSab';
 export { acdbBuildAcisModel } from './AcDbAcisEntities';
 export { acdbDecodeAcisModel, acdbFindAcisSabSignatureOffset, acdbIsAcisSabPayload, } from './AcDbAcisDecode';

package/lib/acis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acis/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAShE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAA;AAyB3B,OAAO,EACL,qCAAqC,EACrC,gCAAgC,GACjC,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acis/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAShE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAA;AAyB3B,OAAO,EACL,qCAAqC,EACrC,gCAAgC,GACjC,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAA"}

package/lib/base/AcDbDxfFiler.d.ts

@@ -1,41 +1,164 @@
 import { AcCmColor, AcCmTransparency } from '@mlightcad/common';
-import { AcGePoint2dLike, AcGePoint3dLike, AcGeVector3dLike } from '@mlightcad/geometry-engine';
+import { AcGePoint2d, AcGePoint2dLike, AcGePoint3d, AcGePoint3dLike, AcGeVector3d, AcGeVector3dLike } from '@mlightcad/geometry-engine';
 import type { AcDbDatabase } from '../database/AcDbDatabase';
 import { AcDbDwgVersion } from '../database/AcDbDwgVersion';
+import type { AcDbDxfPair } from './AcDbDxfPair';
+import { type AcDbDxfPairReader } from './AcDbDxfPairReader';
 import { AcDbResultBuffer } from './AcDbResultBuffer';
+import type { AcDbTypedValue } from './AcDbTypedValue';
+/** Filer direction, mirroring ObjectARX usage of AcDbDxfFiler for in vs out. */
+export type AcDbDxfFilerMode = 'read' | 'write';
+/** DXF text vs binary output for write-mode filers. */
+export type AcDbDxfOutputFormat = 'ascii' | 'binary';
+/**
+ * Lightweight status codes for DXF filing (ObjectARX-inspired).
+ */
+export declare enum AcDbDxfFilerStatus {
+    Ok = 0,
+    EndOfFile = 1,
+    EndOfObject = 2,
+    InvalidDxfCode = 3,
+    BadDxfSequence = 4,
+    NotThatKindOfClass = 5,
+    WrongMode = 6
+}
 export interface AcDbDxfFilerOptions {
     database?: AcDbDatabase;
     precision?: number;
     version?: string | number | AcDbDwgVersion;
+    /** When set, constructs a read-mode filer over this pair stream. */
+    reader?: AcDbDxfPairReader;
+    /** Write-mode output format (default ASCII). */
+    outputFormat?: AcDbDxfOutputFormat;
 }
 /**
- * ASCII DXF writer that loosely mirrors the ObjectARX AcDbDxfFiler API.
+ * DXF filer that mirrors the ObjectARX {@link AcDbDxfFiler} API.
  *
- * This implementation focuses on export scenarios in the web data model and
- * writes classic group-code based DXF text.
+ * - **Write mode** (default): accumulates classic group-code ASCII DXF text,
+ *   or binary DXF bytes when `outputFormat` is `'binary'`.
+ * - **Read mode**: pulls typed pairs from an {@link AcDbDxfPairReader} with
+ *   `readItem` / `pushBackItem` / `atEndOfObject` / `atSubclassData`.
  */
 export declare class AcDbDxfFiler {
     private _database?;
     private _precision;
     private _version?;
+    private readonly _mode;
+    private readonly _outputFormat;
     private readonly _lines;
+    private readonly _binaryChunks;
+    private _binaryLength;
     private readonly _handleMap;
     private _nextHandle;
+    private _reader?;
+    /**
+     * Pushback stack for read mode (ObjectARX `pushBackItem`).
+     * LIFO: nested pushBacks are supported so a second push does not clobber
+     * the first.
+     */
+    private _pushed;
+    private _status;
+    private _errorMessage;
+    private _lastRead;
     constructor(options?: AcDbDxfFilerOptions);
+    /** Create a read-mode filer from an existing pair reader. */
+    static forReading(reader: AcDbDxfPairReader, options?: Omit<AcDbDxfFilerOptions, 'reader'>): AcDbDxfFiler;
+    /** Create a read-mode filer from DXF bytes (ASCII or binary). */
+    static fromBuffer(data: ArrayBuffer | Uint8Array, options?: Omit<AcDbDxfFilerOptions, 'reader'>): AcDbDxfFiler;
+    /** Create a read-mode filer from an already-decoded ASCII DXF string. */
+    static fromString(text: string, options?: Omit<AcDbDxfFilerOptions, 'reader'>): AcDbDxfFiler;
+    get mode(): AcDbDxfFilerMode;
     get database(): AcDbDatabase | undefined;
     set database(value: AcDbDatabase | undefined);
     get precision(): number;
     setPrecision(value: number): this;
     get version(): AcDbDwgVersion | undefined;
     get nextHandle(): number;
+    get filerStatus(): AcDbDxfFilerStatus;
+    get errorMessage(): string;
     setVersion(value: string | number | AcDbDwgVersion): this;
+    setError(status: AcDbDxfFilerStatus, message?: string): this;
+    resetStatus(): this;
     toString(): string;
+    /** Finalize binary DXF bytes (includes magic prefix). */
+    toBinary(): Uint8Array;
     registerHandle(key: string): string;
     resolveHandle(key?: string): string | undefined;
+    /** True if no more pairs are available. */
+    get atEof(): boolean;
+    /**
+     * Current read position in the underlying pair stream.
+     * Useful for byte-based parse progress while streaming a DXF.
+     */
+    position(): {
+        line?: number;
+        byteOffset: number;
+    };
+    /**
+     * True if the next pair starts a new object (group code 0) or EOF.
+     * Does not consume the pair.
+     */
+    get atEndOfObject(): boolean;
+    /** True if the next pair is XDATA start (1001) or similar extended data. */
+    get atExtendedData(): boolean;
+    /**
+     * Advance past subclass marker (100, name) if present.
+     * Returns true when positioned at the named subclass data.
+     */
+    atSubclassData(name: string): boolean;
+    /** Peek the next pair without consuming it. */
+    peekItem(): AcDbTypedValue | undefined;
+    /**
+     * Read one DXF item into a typed value (ObjectARX `readItem`).
+     * Returns undefined at EOF and sets {@link filerStatus} to EndOfFile.
+     */
+    readItem(): AcDbTypedValue | undefined;
+    /**
+     * Push the last-read (or provided) pair back so the next read returns it.
+     * Multiple pushbacks form a LIFO stack (nested readers can push without
+     * overwriting a prior push).
+     */
+    pushBackItem(item?: AcDbTypedValue | AcDbDxfPair): void;
+    /** Skip pairs until the next object boundary (code 0) without consuming it. */
+    skipToEndOfObject(): void;
+    readString(expectedCode?: number): string | undefined;
+    readInt16(expectedCode?: number): number | undefined;
+    readInt32(expectedCode?: number): number | undefined;
+    readInt64(expectedCode?: number): number | bigint | undefined;
+    readDouble(expectedCode?: number): number | undefined;
+    readBoolean(expectedCode?: number): boolean | undefined;
+    readHandle(expectedCode?: number): string | undefined;
+    readObjectId(expectedCode?: number): string | undefined;
+    /**
+     * Read a 2D point starting at `code` (x), then `code+10` (y).
+     * Tolerates missing Y (defaults to 0) when the next code is not code+10.
+     */
+    readPoint2d(code: number): AcGePoint2d | undefined;
+    /**
+     * Read a 3D point starting at `code` (x), then `code+10` / `code+20`.
+     * Missing Y/Z default to 0 when those group codes are absent.
+     */
+    readPoint3d(code: number): AcGePoint3d | undefined;
+    readVector3d(code: number): AcGeVector3d | undefined;
+    /**
+     * Apply color group codes (62 ACI / 420 true color) onto `color` when the
+     * current pair matches. Returns true if a color code was consumed.
+     */
+    readCmColorInto(color: AcCmColor, aciCode?: number, trueColorCode?: number): boolean;
     writeGroup(code: number, value: unknown): this;
     writeStart(value: string): this;
+    /**
+     * DXF dialect capabilities for the target write version.
+     * When version is unset (ad-hoc writers / unit tests), treat as latest.
+     */
+    get capabilities(): import("../database/AcDbDwgVersion").AcDbDxfVersionCapabilities;
     writeSubclassMarker(value: string): this;
     writeString(code: number, value?: string): this;
+    /**
+     * Write MTEXT (or embedded-MTEXT) contents using AutoCAD's group 3 / group 1
+     * 250-character chunking rules.
+     */
+    writeMTextContents(text: string): this;
     writeInt8(code: number, value?: number): this;
     writeInt16(code: number, value?: number): this;
     writeInt32(code: number, value?: number): this;
@@ -48,6 +171,8 @@ export declare class AcDbDxfFiler {
     writeAngle(code: number, radians?: number): this;
     writeHandle(code: number, key?: string): this;
     writeObjectId(code: number, objectId?: string): this;
+    /** Lineweight (group 370). Omitted for DXF targets before AutoCAD 2000. */
+    writeLineWeight(code: number, value?: number): this;
     writePoint2d(code: number, point?: AcGePoint2dLike): this;
     writePoint3d(code: number, point?: AcGePoint3dLike): this;
     writeVector3d(code: number, vector?: AcGeVector3dLike): this;
@@ -58,6 +183,17 @@ export declare class AcDbDxfFiler {
     endSection(): this;
     startTable(name: string): this;
     endTable(): this;
+    private assertWriteMode;
+    private appendBinary;
+    private writeBinaryCode;
+    private writeBinaryGroup;
+    private assertReadMode;
+    private peekPair;
+    private readPair;
+    private pushBackPair;
+    private readNumber;
+    private pairToTypedValue;
+    private typedValueToPair;
     private formatValue;
     /** Removes characters that must not appear on a single DXF value line. */
     private sanitizeStringForDxfLine;

package/lib/base/AcDbDxfFiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcDbDxfFiler.d.ts","sourceRoot":"","sources":["../../src/base/AcDbDxfFiler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,gBAAgB,EAEjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAA;CAC3C;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAC,CAAc;IAChC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,WAAW,CAAQ;gBAEf,OAAO,GAAE,mBAAwB;IAc7C,IAAI,QAAQ,IAIQ,YAAY,GAAG,SAAS,CAF3C;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAE3C;IAED,IAAI,SAAS,WAEZ;IAED,YAAY,CAAC,KAAK,EAAE,MAAM;IAK1B,IAAI,OAAO,+BAEV;IAED,IAAI,UAAU,WAEb;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc;IAMlD,QAAQ;IAIR,cAAc,CAAC,GAAG,EAAE,MAAM;IAa1B,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM;IAK1B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IAUvC,UAAU,CAAC,KAAK,EAAE,MAAM;IAIxB,mBAAmB,CAAC,KAAK,EAAE,MAAM;IAIjC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAKxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAItC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAIvC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAIvC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAIvC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAIxC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAIxC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;IAI1C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;IAIvC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAMxC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAKzC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAKtC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAI7C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe;IAOlD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe;IAQlD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB;IAQrD,YAAY,CACV,KAAK,CAAC,EAAE,SAAS,EACjB,OAAO,GAAE,MAAW,EACpB,aAAa,GAAE,MAAY;IAc7B,iBAAiB,CAAC,YAAY,CAAC,EAAE,gBAAgB,EAAE,IAAI,GAAE,MAAY;IAUrE,iBAAiB,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAQhD,YAAY,CAAC,IAAI,EAAE,MAAM;IAMzB,UAAU;IAKV,UAAU,CAAC,IAAI,EAAE,MAAM;IAMvB,QAAQ;IAKR,OAAO,CAAC,WAAW;IAmBnB,0EAA0E;IAC1E,OAAO,CAAC,wBAAwB;CAQjC"}
+{"version":3,"file":"AcDbDxfFiler.d.ts","sourceRoot":"","sources":["../../src/base/AcDbDxfFiler.ts"],"names":[],"mappings":"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"}