@cj-tech-master/excelts 7.3.0 → 7.4.0-canary.20260402030331.3ae7f67

package/dist/browser/modules/xml/dom.d.ts

@@ -52,7 +52,7 @@ declare function walk(element: XmlElement, visitor: (el: XmlElement) => void): v
 /**
  * Convert an {@link XmlElement} DOM tree to a plain JavaScript object.
  *
- * Produces output similar to fast-xml-parser: element names become object keys,
+ * Produces a plain JavaScript object where element names become object keys,
  * attributes are prefixed (default `@_`), text-only elements collapse to their
  * string value, and repeated sibling names merge into arrays.
  *

package/dist/browser/modules/xml/dom.js

@@ -256,7 +256,7 @@ function walk(element, visitor) {
 /**
  * Convert an {@link XmlElement} DOM tree to a plain JavaScript object.
  *
- * Produces output similar to fast-xml-parser: element names become object keys,
+ * Produces a plain JavaScript object where element names become object keys,
  * attributes are prefixed (default `@_`), text-only elements collapse to their
  * string value, and repeated sibling names merge into arrays.
  *
@@ -285,9 +285,11 @@ function toPlainObject(element, options) {
         // Add attributes — el.attributes is created via Object.create(null)
         // by safeAttributes(), so no prototype keys to guard against.
         let hasAttributes = false;
-        for (const key in el.attributes) {
-            obj[opts.attrPrefix + key] = el.attributes[key];
-            hasAttributes = true;
+        if (!opts.ignoreAttributes) {
+            for (const key in el.attributes) {
+                obj[opts.attrPrefix + key] = el.attributes[key];
+                hasAttributes = true;
+            }
         }
         // Collect text and child elements in a single pass.
         let text = "";
@@ -304,7 +306,7 @@ function toPlainObject(element, options) {
                     break;
                 case "element": {
                     const value = convertElement(child);
-                    addChildValue(obj, child.name, value, opts.alwaysArray);
+                    addChildValue(obj, child.name, value, opts.alwaysArray, opts.isArray);
                     hasChildren = true;
                     break;
                 }

package/dist/browser/modules/xml/to-object-shared.d.ts

@@ -7,9 +7,11 @@
 import type { ToPlainObjectOptions } from "./types.js";
 /** Options with all defaults resolved — no more `??` checks at hot-path call sites. */
 export interface ResolvedOptions {
+    readonly ignoreAttributes: boolean;
     readonly attrPrefix: string;
     readonly textKey: string;
     readonly alwaysArray: boolean;
+    readonly isArray: ((name: string) => boolean) | null;
     readonly preserveCData: boolean;
     readonly ignoreWS: boolean;
 }
@@ -26,4 +28,4 @@ export declare function resolveValue(obj: Record<string, unknown>, text: string,
  * Add a resolved child value into a parent object, merging repeated names
  * into arrays.
  */
-export declare function addChildValue(parent: Record<string, unknown>, name: string, value: unknown, alwaysArray: boolean): void;
+export declare function addChildValue(parent: Record<string, unknown>, name: string, value: unknown, alwaysArray: boolean, isArray: ((name: string) => boolean) | null): void;

package/dist/browser/modules/xml/to-object-shared.js

@@ -6,9 +6,11 @@
  */
 export function resolveOptions(options) {
     return {
+        ignoreAttributes: options?.ignoreAttributes ?? false,
         attrPrefix: options?.attributePrefix ?? "@_",
         textKey: options?.textKey ?? "#text",
         alwaysArray: options?.alwaysArray ?? false,
+        isArray: options?.isArray ?? null,
         preserveCData: options?.preserveCData ?? true,
         ignoreWS: options?.ignoreWhitespaceText ?? true
     };
@@ -51,7 +53,7 @@ export function resolveValue(obj, text, hasAttributes, hasChildren, opts) {
     if (hasText) {
         obj[opts.textKey] = text;
     }
-    // Empty element with no attributes → empty string (like fast-xml-parser)
+    // Empty element with no attributes → empty string
     if (!hasAttributes && !hasChildren && !hasText) {
         return "";
     }
@@ -64,7 +66,7 @@ export function resolveValue(obj, text, hasAttributes, hasChildren, opts) {
  * Add a resolved child value into a parent object, merging repeated names
  * into arrays.
  */
-export function addChildValue(parent, name, value, alwaysArray) {
+export function addChildValue(parent, name, value, alwaysArray, isArray) {
     const existing = parent[name];
     if (existing !== undefined) {
         if (Array.isArray(existing)) {
@@ -75,6 +77,7 @@ export function addChildValue(parent, name, value, alwaysArray) {
         }
     }
     else {
-        parent[name] = alwaysArray ? [value] : value;
+        const wrap = alwaysArray || (isArray !== null && isArray(name));
+        parent[name] = wrap ? [value] : value;
     }
 }

package/dist/browser/modules/xml/to-object.js

@@ -64,9 +64,11 @@ function parseXmlToObject(xml, options) {
             name: tag.name
         };
         // Write attributes directly into frame.obj
-        for (const key in tag.attributes) {
-            frame.obj[opts.attrPrefix + key] = tag.attributes[key];
-            frame.hasAttributes = true;
+        if (!opts.ignoreAttributes) {
+            for (const key in tag.attributes) {
+                frame.obj[opts.attrPrefix + key] = tag.attributes[key];
+                frame.hasAttributes = true;
+            }
         }
         // Mark parent as having children
         stack[stack.length - 1].hasChildren = true;
@@ -113,9 +115,7 @@ function parseXmlToObject(xml, options) {
  */
 function finishFrame(frame, parent, opts) {
     const value = resolveValue(frame.obj, frame.text, frame.hasAttributes, frame.hasChildren, opts);
-    // The document root element (child of synthetic root) should never be
-    // wrapped in an array by alwaysArray — it's always a direct value.
     const isDocRoot = parent.name === "";
-    addChildValue(parent.obj, frame.name, value, isDocRoot ? false : opts.alwaysArray);
+    addChildValue(parent.obj, frame.name, value, isDocRoot ? false : opts.alwaysArray, isDocRoot ? null : opts.isArray);
 }
 export { parseXmlToObject };

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

@@ -202,12 +202,20 @@ export interface WritableTarget {
  * Options for `toPlainObject()`.
  *
  * Controls how an {@link XmlElement} DOM tree is converted to a plain
- * JavaScript object (similar to fast-xml-parser output format).
+ * JavaScript object.
  */
 export interface ToPlainObjectOptions {
+    /**
+     * When true, discard all attributes entirely. Takes precedence over
+     * `attributePrefix` — when `ignoreAttributes` is true, no attribute keys
+     * appear in the output regardless of prefix settings.
+     * @default false
+     */
+    ignoreAttributes?: boolean;
     /**
      * Prefix for attribute keys.
      * Set to `""` to use bare attribute names.
+     * Ignored when `ignoreAttributes` is true.
      * @default "@_"
      */
     attributePrefix?: string;
@@ -223,6 +231,13 @@ export interface ToPlainObjectOptions {
      * @default false
      */
     alwaysArray?: boolean;
+    /**
+     * Callback to determine whether a specific tag name should always be wrapped
+     * in an array, even if only a single element exists. Takes precedence over
+     * `alwaysArray` for matching names. When both `isArray` and `alwaysArray` are
+     * set, a tag is wrapped if either returns/is true.
+     */
+    isArray?: (name: string) => boolean;
     /**
      * When true, include CDATA node values (already merged to text by default
      * in `parseXml`, only relevant with `cdataAsNodes`).

package/dist/cjs/modules/xml/dom.js

@@ -265,7 +265,7 @@ function walk(element, visitor) {
 /**
  * Convert an {@link XmlElement} DOM tree to a plain JavaScript object.
  *
- * Produces output similar to fast-xml-parser: element names become object keys,
+ * Produces a plain JavaScript object where element names become object keys,
  * attributes are prefixed (default `@_`), text-only elements collapse to their
  * string value, and repeated sibling names merge into arrays.
  *
@@ -294,9 +294,11 @@ function toPlainObject(element, options) {
         // Add attributes — el.attributes is created via Object.create(null)
         // by safeAttributes(), so no prototype keys to guard against.
         let hasAttributes = false;
-        for (const key in el.attributes) {
-            obj[opts.attrPrefix + key] = el.attributes[key];
-            hasAttributes = true;
+        if (!opts.ignoreAttributes) {
+            for (const key in el.attributes) {
+                obj[opts.attrPrefix + key] = el.attributes[key];
+                hasAttributes = true;
+            }
         }
         // Collect text and child elements in a single pass.
         let text = "";
@@ -313,7 +315,7 @@ function toPlainObject(element, options) {
                     break;
                 case "element": {
                     const value = convertElement(child);
-                    (0, to_object_shared_1.addChildValue)(obj, child.name, value, opts.alwaysArray);
+                    (0, to_object_shared_1.addChildValue)(obj, child.name, value, opts.alwaysArray, opts.isArray);
                     hasChildren = true;
                     break;
                 }

package/dist/cjs/modules/xml/to-object-shared.js

@@ -11,9 +11,11 @@ exports.resolveValue = resolveValue;
 exports.addChildValue = addChildValue;
 function resolveOptions(options) {
     return {
+        ignoreAttributes: options?.ignoreAttributes ?? false,
         attrPrefix: options?.attributePrefix ?? "@_",
         textKey: options?.textKey ?? "#text",
         alwaysArray: options?.alwaysArray ?? false,
+        isArray: options?.isArray ?? null,
         preserveCData: options?.preserveCData ?? true,
         ignoreWS: options?.ignoreWhitespaceText ?? true
     };
@@ -56,7 +58,7 @@ function resolveValue(obj, text, hasAttributes, hasChildren, opts) {
     if (hasText) {
         obj[opts.textKey] = text;
     }
-    // Empty element with no attributes → empty string (like fast-xml-parser)
+    // Empty element with no attributes → empty string
     if (!hasAttributes && !hasChildren && !hasText) {
         return "";
     }
@@ -69,7 +71,7 @@ function resolveValue(obj, text, hasAttributes, hasChildren, opts) {
  * Add a resolved child value into a parent object, merging repeated names
  * into arrays.
  */
-function addChildValue(parent, name, value, alwaysArray) {
+function addChildValue(parent, name, value, alwaysArray, isArray) {
     const existing = parent[name];
     if (existing !== undefined) {
         if (Array.isArray(existing)) {
@@ -80,6 +82,7 @@ function addChildValue(parent, name, value, alwaysArray) {
         }
     }
     else {
-        parent[name] = alwaysArray ? [value] : value;
+        const wrap = alwaysArray || (isArray !== null && isArray(name));
+        parent[name] = wrap ? [value] : value;
     }
 }

package/dist/cjs/modules/xml/to-object.js

@@ -67,9 +67,11 @@ function parseXmlToObject(xml, options) {
             name: tag.name
         };
         // Write attributes directly into frame.obj
-        for (const key in tag.attributes) {
-            frame.obj[opts.attrPrefix + key] = tag.attributes[key];
-            frame.hasAttributes = true;
+        if (!opts.ignoreAttributes) {
+            for (const key in tag.attributes) {
+                frame.obj[opts.attrPrefix + key] = tag.attributes[key];
+                frame.hasAttributes = true;
+            }
         }
         // Mark parent as having children
         stack[stack.length - 1].hasChildren = true;
@@ -116,8 +118,6 @@ function parseXmlToObject(xml, options) {
  */
 function finishFrame(frame, parent, opts) {
     const value = (0, to_object_shared_1.resolveValue)(frame.obj, frame.text, frame.hasAttributes, frame.hasChildren, opts);
-    // The document root element (child of synthetic root) should never be
-    // wrapped in an array by alwaysArray — it's always a direct value.
     const isDocRoot = parent.name === "";
-    (0, to_object_shared_1.addChildValue)(parent.obj, frame.name, value, isDocRoot ? false : opts.alwaysArray);
+    (0, to_object_shared_1.addChildValue)(parent.obj, frame.name, value, isDocRoot ? false : opts.alwaysArray, isDocRoot ? null : opts.isArray);
 }

package/dist/esm/modules/xml/dom.js

@@ -256,7 +256,7 @@ function walk(element, visitor) {
 /**
  * Convert an {@link XmlElement} DOM tree to a plain JavaScript object.
  *
- * Produces output similar to fast-xml-parser: element names become object keys,
+ * Produces a plain JavaScript object where element names become object keys,
  * attributes are prefixed (default `@_`), text-only elements collapse to their
  * string value, and repeated sibling names merge into arrays.
  *
@@ -285,9 +285,11 @@ function toPlainObject(element, options) {
         // Add attributes — el.attributes is created via Object.create(null)
         // by safeAttributes(), so no prototype keys to guard against.
         let hasAttributes = false;
-        for (const key in el.attributes) {
-            obj[opts.attrPrefix + key] = el.attributes[key];
-            hasAttributes = true;
+        if (!opts.ignoreAttributes) {
+            for (const key in el.attributes) {
+                obj[opts.attrPrefix + key] = el.attributes[key];
+                hasAttributes = true;
+            }
         }
         // Collect text and child elements in a single pass.
         let text = "";
@@ -304,7 +306,7 @@ function toPlainObject(element, options) {
                     break;
                 case "element": {
                     const value = convertElement(child);
-                    addChildValue(obj, child.name, value, opts.alwaysArray);
+                    addChildValue(obj, child.name, value, opts.alwaysArray, opts.isArray);
                     hasChildren = true;
                     break;
                 }

package/dist/esm/modules/xml/to-object-shared.js

@@ -6,9 +6,11 @@
  */
 export function resolveOptions(options) {
     return {
+        ignoreAttributes: options?.ignoreAttributes ?? false,
         attrPrefix: options?.attributePrefix ?? "@_",
         textKey: options?.textKey ?? "#text",
         alwaysArray: options?.alwaysArray ?? false,
+        isArray: options?.isArray ?? null,
         preserveCData: options?.preserveCData ?? true,
         ignoreWS: options?.ignoreWhitespaceText ?? true
     };
@@ -51,7 +53,7 @@ export function resolveValue(obj, text, hasAttributes, hasChildren, opts) {
     if (hasText) {
         obj[opts.textKey] = text;
     }
-    // Empty element with no attributes → empty string (like fast-xml-parser)
+    // Empty element with no attributes → empty string
     if (!hasAttributes && !hasChildren && !hasText) {
         return "";
     }
@@ -64,7 +66,7 @@ export function resolveValue(obj, text, hasAttributes, hasChildren, opts) {
  * Add a resolved child value into a parent object, merging repeated names
  * into arrays.
  */
-export function addChildValue(parent, name, value, alwaysArray) {
+export function addChildValue(parent, name, value, alwaysArray, isArray) {
     const existing = parent[name];
     if (existing !== undefined) {
         if (Array.isArray(existing)) {
@@ -75,6 +77,7 @@ export function addChildValue(parent, name, value, alwaysArray) {
         }
     }
     else {
-        parent[name] = alwaysArray ? [value] : value;
+        const wrap = alwaysArray || (isArray !== null && isArray(name));
+        parent[name] = wrap ? [value] : value;
     }
 }

package/dist/esm/modules/xml/to-object.js

@@ -64,9 +64,11 @@ function parseXmlToObject(xml, options) {
             name: tag.name
         };
         // Write attributes directly into frame.obj
-        for (const key in tag.attributes) {
-            frame.obj[opts.attrPrefix + key] = tag.attributes[key];
-            frame.hasAttributes = true;
+        if (!opts.ignoreAttributes) {
+            for (const key in tag.attributes) {
+                frame.obj[opts.attrPrefix + key] = tag.attributes[key];
+                frame.hasAttributes = true;
+            }
         }
         // Mark parent as having children
         stack[stack.length - 1].hasChildren = true;
@@ -113,9 +115,7 @@ function parseXmlToObject(xml, options) {
  */
 function finishFrame(frame, parent, opts) {
     const value = resolveValue(frame.obj, frame.text, frame.hasAttributes, frame.hasChildren, opts);
-    // The document root element (child of synthetic root) should never be
-    // wrapped in an array by alwaysArray — it's always a direct value.
     const isDocRoot = parent.name === "";
-    addChildValue(parent.obj, frame.name, value, isDocRoot ? false : opts.alwaysArray);
+    addChildValue(parent.obj, frame.name, value, isDocRoot ? false : opts.alwaysArray, isDocRoot ? null : opts.isArray);
 }
 export { parseXmlToObject };

package/dist/iife/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
-* @cj-tech-master/excelts v7.3.0
+* @cj-tech-master/excelts v7.4.0-canary.20260402030331.3ae7f67
 * TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.
 * (c) 2026 cjnoname
 * Released under the MIT License

package/dist/iife/excelts.iife.min.js

@@ -1,5 +1,5 @@
 /*!
-* @cj-tech-master/excelts v7.3.0
+* @cj-tech-master/excelts v7.4.0-canary.20260402030331.3ae7f67
 * TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.
 * (c) 2026 cjnoname
 * Released under the MIT License

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

@@ -52,7 +52,7 @@ declare function walk(element: XmlElement, visitor: (el: XmlElement) => void): v
 /**
  * Convert an {@link XmlElement} DOM tree to a plain JavaScript object.
  *
- * Produces output similar to fast-xml-parser: element names become object keys,
+ * Produces a plain JavaScript object where element names become object keys,
  * attributes are prefixed (default `@_`), text-only elements collapse to their
  * string value, and repeated sibling names merge into arrays.
  *

package/dist/types/modules/xml/to-object-shared.d.ts

@@ -7,9 +7,11 @@
 import type { ToPlainObjectOptions } from "./types.js";
 /** Options with all defaults resolved — no more `??` checks at hot-path call sites. */
 export interface ResolvedOptions {
+    readonly ignoreAttributes: boolean;
     readonly attrPrefix: string;
     readonly textKey: string;
     readonly alwaysArray: boolean;
+    readonly isArray: ((name: string) => boolean) | null;
     readonly preserveCData: boolean;
     readonly ignoreWS: boolean;
 }
@@ -26,4 +28,4 @@ export declare function resolveValue(obj: Record<string, unknown>, text: string,
  * Add a resolved child value into a parent object, merging repeated names
  * into arrays.
  */
-export declare function addChildValue(parent: Record<string, unknown>, name: string, value: unknown, alwaysArray: boolean): void;
+export declare function addChildValue(parent: Record<string, unknown>, name: string, value: unknown, alwaysArray: boolean, isArray: ((name: string) => boolean) | null): void;

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

@@ -202,12 +202,20 @@ export interface WritableTarget {
  * Options for `toPlainObject()`.
  *
  * Controls how an {@link XmlElement} DOM tree is converted to a plain
- * JavaScript object (similar to fast-xml-parser output format).
+ * JavaScript object.
  */
 export interface ToPlainObjectOptions {
+    /**
+     * When true, discard all attributes entirely. Takes precedence over
+     * `attributePrefix` — when `ignoreAttributes` is true, no attribute keys
+     * appear in the output regardless of prefix settings.
+     * @default false
+     */
+    ignoreAttributes?: boolean;
     /**
      * Prefix for attribute keys.
      * Set to `""` to use bare attribute names.
+     * Ignored when `ignoreAttributes` is true.
      * @default "@_"
      */
     attributePrefix?: string;
@@ -223,6 +231,13 @@ export interface ToPlainObjectOptions {
      * @default false
      */
     alwaysArray?: boolean;
+    /**
+     * Callback to determine whether a specific tag name should always be wrapped
+     * in an array, even if only a single element exists. Takes precedence over
+     * `alwaysArray` for matching names. When both `isArray` and `alwaysArray` are
+     * set, a tag is wrapped if either returns/is true.
+     */
+    isArray?: (name: string) => boolean;
     /**
      * When true, include CDATA node values (already merged to text by default
      * in `parseXml`, only relevant with `cdataAsNodes`).

package/package.json

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