@mlightcad/data-model 1.14.11 → 1.14.12

package/lib/base/AcDbDxfPairReader.d.ts

@@ -31,6 +31,13 @@ export declare function acdbPeekDxfHeaderInfo(buffer: ArrayBuffer): AcDbDxfHeade
  * Scans with a character cursor (no full-file `string[]` of lines).
  */
 export declare function acdbMakeAsciiDxfPairReader(text: string): AcDbDxfPairReader;
+/**
+ * Bytes decoded per `TextDecoder` call in {@link acdbMakeUtf8AsciiDxfPairReader}.
+ *
+ * Sized as a compromise: large enough that a multi-MB DXF costs hundreds of
+ * decode calls rather than one per line, small enough that windows still holding
+ * a retained value slice do not pin much memory.
+ */
 /**
  * ASCII pair reader that decodes UTF-8 bytes one line-aligned window at a time,
  * instead of allocating a full-file decoded string (peak memory ≈ input bytes
@@ -53,11 +60,12 @@ export interface AcDbCreateDxfPairReaderOptions {
     /**
      * Override text encoding for ASCII DXF.
      *
-     * When omitted, the encoding is auto-detected from `$DWGCODEPAGE`
-     * (`'utf-8'` for R2007+ drawings). When provided, it wins over the detected
-     * value — use it to force e.g. `'cp949'` for Korean drawings whose header
-     * lies. Common non-WHATWG aliases such as `'cp949'` are normalized to a
-     * supported `TextDecoder` label (`'euc-kr'`).
+     * When omitted, the encoding is chosen automatically: bytes that validate
+     * as UTF-8 decode as UTF-8; otherwise a declared pre-2007 `$DWGCODEPAGE`
+     * is honored (see {@link acdbCreateDxfPairReader}). When provided, it wins
+     * over detection — use it to force e.g. `'cp949'` for Korean drawings whose
+     * header lies. Common non-WHATWG aliases such as `'cp949'` are normalized
+     * to a supported `TextDecoder` label (`'euc-kr'`).
      */
     encoding?: string;
     /** Force R12 1-byte group codes for binary DXF. */
@@ -66,9 +74,19 @@ export interface AcDbCreateDxfPairReaderOptions {
 /**
  * Create a pair reader from DXF bytes (ASCII or binary).
  *
- * ASCII path: peek HEADER for version/codepage when needed. UTF-8 drawings
- * decode one line-aligned window at a time (no full-file string). Legacy code
- * pages still decode once via `TextDecoder`, then scan with a character cursor.
+ * ASCII path encoding strategy (hybrid of byte-trust and header sniffing):
+ *
+ * 1. An explicit `options.encoding` always wins — the caller asserts the
+ *    encoding, no sniffing contradicts it.
+ * 2. Otherwise the bytes are strictly validated as UTF-8. Valid UTF-8
+ *    (including pure ASCII) decodes correctly regardless of any stale
+ *    `$DWGCODEPAGE`, so the header is never consulted — modern files skip
+ *    the header pre-scan entirely and stream straight from bytes.
+ * 3. Invalid UTF-8 means the file is not a spec-conformant modern DXF. The
+ *    HEADER is then peeked for `$ACADVER`/`$DWGCODEPAGE`: pre-2007 drawings
+ *    with a declared code page decode through it (matching AutoCAD), while
+ *    R2007+ or headerless files fall back to UTF-8 (replacement chars mark
+ *    the broken bytes).
  */
 export declare function acdbCreateDxfPairReader(data: ArrayBuffer | Uint8Array, options?: AcDbCreateDxfPairReaderOptions): AcDbDxfPairReader;
 //# sourceMappingURL=AcDbDxfPairReader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AcDbDxfPairReader.d.ts","sourceRoot":"","sources":["../../src/base/AcDbDxfPairReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAU3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAsBhD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;IACjC,IAAI,IAAI,WAAW,GAAG,SAAS,CAAA;IAC/B,IAAI,IAAI,WAAW,GAAG,SAAS,CAAA;IAC/B,QAAQ,IAAI;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAMzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CA0C5E;AAoDD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA+D1E;AAgBD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,UAAU,GAChB,iBAAiB,CAwGnB;AASD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,iBAAiB,CAoKnB;AAED,MAAM,WAAW,8BAA8B;IAC7C;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,GAAG,UAAU,EAC9B,OAAO,GAAE,8BAAmC,GAC3C,iBAAiB,CA0DnB"}
+{"version":3,"file":"AcDbDxfPairReader.d.ts","sourceRoot":"","sources":["../../src/base/AcDbDxfPairReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAU3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAwBhD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;IACjC,IAAI,IAAI,WAAW,GAAG,SAAS,CAAA;IAC/B,IAAI,IAAI,WAAW,GAAG,SAAS,CAAA;IAC/B,QAAQ,IAAI;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAMzD;AAkjBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CA0C5E;AAoDD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA+D1E;AAOD;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,UAAU,GAChB,iBAAiB,CAEnB;AASD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,iBAAiB,CAoKnB;AAED,MAAM,WAAW,8BAA8B;IAC7C;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAqDD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,GAAG,UAAU,EAC9B,OAAO,GAAE,8BAAmC,GAC3C,iBAAiB,CA4EnB"}