@cj-tech-master/excelts 7.5.0 → 7.6.0

package/dist/types/modules/xml/index.d.ts

@@ -10,7 +10,7 @@
  * - Dual-mode: streaming (SAX parser + stream writer) and buffered (DOM parser + writer)
  * - Shared XmlSink interface lets rendering code target both modes transparently
  */
-export type { XmlAttributes, XmlNodeType, XmlElement, XmlText, XmlCData, XmlComment, XmlProcessingInstruction, XmlNode, XmlDocument, XmlSink, SaxTag, SaxEvent, SaxEventAny, SaxHandlers, SaxOptions, WritableTarget, XmlParseOptions, ToPlainObjectOptions, ParseXmlToObjectOptions } from "./types.js";
+export type { XmlAttributes, XmlNodeType, XmlElement, XmlText, XmlCData, XmlComment, XmlProcessingInstruction, XmlNode, XmlDocument, XmlSink, SaxTag, SaxEvent, SaxEventAny, SaxHandlers, SaxOptions, InvalidCharHandling, WritableTarget, XmlParseOptions, ToPlainObjectOptions, ParseXmlToObjectOptions } from "./types.js";
 export { xmlEncode, xmlDecode, xmlEncodeAttr, validateXmlName, encodeCData, validateCommentText } from "./encode.js";
 export { XmlWriter, StdDocAttributes } from "./writer.js";
 export { XmlStreamWriter } from "./stream-writer.js";

package/dist/types/modules/xml/sax.d.ts

@@ -37,6 +37,7 @@ declare class SaxParser {
     private xmlns;
     private maxDepth;
     private maxEntityExpansions;
+    private invalidCharHandling;
     private _entityExpansionCount;
     private _nsStack;
     private state;
@@ -81,6 +82,46 @@ declare class SaxParser {
     fail(message: string): this;
     write(chunk: string | null): this;
     close(): this;
+    /**
+     * Handle an invalid XML character according to the configured strategy.
+     *
+     * Used by `handleTextInRoot()` fast path which manages its own text accumulation
+     * and cannot use the `getCode()` loop approach.
+     *
+     * - `"error"`: call `fail()` and return the original code.
+     * - `"skip"`: return `REPLACEMENT_CHAR` as a sentinel (caller handles skip).
+     * - `"replace"`: return `REPLACEMENT_CHAR`.
+     *
+     * Note: For `getCode()`, invalid char handling is inlined to avoid recursion.
+     *
+     * @param code - The invalid character code point.
+     * @param kind - Optional description (e.g. "lone surrogate") for error messages.
+     * @returns The code point to use.
+     */
+    private handleInvalidChar;
+    /**
+     * Handle an invalid character inside the `handleTextInRoot()` fast loop.
+     *
+     * Unlike `handleInvalidChar()` (which returns a code point for `getCode()`),
+     * this method manages the text accumulation state (`this.text`, `start`) that
+     * the fast text loop relies on.
+     *
+     * - `"error"`: call `fail()`, leave text accumulation unchanged (char stays in output).
+     * - `"skip"`: flush text up to the invalid char, skip it, return new `start`.
+     * - `"replace"`: flush text up to the invalid char, append U+FFFD, return new `start`.
+     *
+     * @returns The updated `start` index for the text accumulation loop.
+     */
+    private handleInvalidCharInText;
+    /**
+     * Handle an invalid character inside `sAttribValueQuoted()`.
+     *
+     * Same pattern as `handleInvalidCharInText()` but for attribute value
+     * accumulation (always uses `this.text`, no conditional handler check).
+     *
+     * @returns The updated `start` index.
+     */
+    private handleInvalidCharInAttr;
     private getCode;
     private unget;
     private processState;

package/dist/types/modules/xml/types.d.ts

@@ -169,6 +169,15 @@ export interface SaxHandlers {
     pi?: (target: string, body: string) => void;
     error?: (err: Error) => void;
 }
+/**
+ * Strategy for handling invalid XML characters (control chars, lone surrogates,
+ * non-characters like U+FFFE/U+FFFF).
+ *
+ * - `"error"` — Report via error handler or throw (XML 1.0 strict). **Default.**
+ * - `"skip"` — Silently remove the invalid character from the output.
+ * - `"replace"` — Replace the invalid character with U+FFFD (REPLACEMENT CHARACTER).
+ */
+export type InvalidCharHandling = "error" | "skip" | "replace";
 /** SAX parser options. */
 export interface SaxOptions {
     /** Track position (line/column) for error messages. Default: true */
@@ -187,6 +196,17 @@ export interface SaxOptions {
      * Default: 10000. Set 0 to disable.
      */
     maxEntityExpansions?: number;
+    /**
+     * How to handle invalid XML characters (ASCII control chars, lone surrogates,
+     * non-characters U+FFFE/U+FFFF, DEL U+007F, etc.).
+     *
+     * - `"error"` — Report via error handler or throw. **(Default)**
+     * - `"skip"` — Silently discard the character.
+     * - `"replace"` — Replace with U+FFFD (REPLACEMENT CHARACTER).
+     *
+     * @default "error"
+     */
+    invalidCharHandling?: InvalidCharHandling;
 }
 /**
  * Minimal writable interface for XmlStreamWriter.
@@ -265,6 +285,8 @@ export interface ParseXmlToObjectOptions extends ToPlainObjectOptions {
     maxDepth?: number;
     /** Maximum total entity expansions. Default: 10000. */
     maxEntityExpansions?: number;
+    /** How to handle invalid XML characters. Default: "error". */
+    invalidCharHandling?: InvalidCharHandling;
 }
 /** Options for `parseXml()`. */
 export interface XmlParseOptions {
@@ -282,5 +304,7 @@ export interface XmlParseOptions {
     maxDepth?: number;
     /** Maximum total entity expansions. Default: 10000. */
     maxEntityExpansions?: number;
+    /** How to handle invalid XML characters. Default: "error". */
+    invalidCharHandling?: InvalidCharHandling;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "7.5.0",
+  "version": "7.6.0",
   "description": "TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.",
   "type": "module",
   "main": "./dist/cjs/index.js",