@cj-tech-master/excelts 7.3.0 → 7.4.0

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

@@ -304,7 +304,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

@@ -10,6 +10,7 @@ export interface ResolvedOptions {
     readonly attrPrefix: string;
     readonly textKey: string;
     readonly alwaysArray: boolean;
+    readonly isArray: ((name: string) => boolean) | null;
     readonly preserveCData: boolean;
     readonly ignoreWS: boolean;
 }
@@ -26,4 +27,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

@@ -9,6 +9,7 @@ export function resolveOptions(options) {
         attrPrefix: options?.attributePrefix ?? "@_",
         textKey: options?.textKey ?? "#text",
         alwaysArray: options?.alwaysArray ?? false,
+        isArray: options?.isArray ?? null,
         preserveCData: options?.preserveCData ?? true,
         ignoreWS: options?.ignoreWhitespaceText ?? true
     };
@@ -64,7 +65,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 +76,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

@@ -113,9 +113,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

@@ -223,6 +223,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

@@ -313,7 +313,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

@@ -14,6 +14,7 @@ function resolveOptions(options) {
         attrPrefix: options?.attributePrefix ?? "@_",
         textKey: options?.textKey ?? "#text",
         alwaysArray: options?.alwaysArray ?? false,
+        isArray: options?.isArray ?? null,
         preserveCData: options?.preserveCData ?? true,
         ignoreWS: options?.ignoreWhitespaceText ?? true
     };
@@ -69,7 +70,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 +81,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

@@ -116,8 +116,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

@@ -304,7 +304,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

@@ -9,6 +9,7 @@ export function resolveOptions(options) {
         attrPrefix: options?.attributePrefix ?? "@_",
         textKey: options?.textKey ?? "#text",
         alwaysArray: options?.alwaysArray ?? false,
+        isArray: options?.isArray ?? null,
         preserveCData: options?.preserveCData ?? true,
         ignoreWS: options?.ignoreWhitespaceText ?? true
     };
@@ -64,7 +65,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 +76,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

@@ -113,9 +113,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
 * 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
 * TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.
 * (c) 2026 cjnoname
 * Released under the MIT License

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

@@ -10,6 +10,7 @@ export interface ResolvedOptions {
     readonly attrPrefix: string;
     readonly textKey: string;
     readonly alwaysArray: boolean;
+    readonly isArray: ((name: string) => boolean) | null;
     readonly preserveCData: boolean;
     readonly ignoreWS: boolean;
 }
@@ -26,4 +27,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

@@ -223,6 +223,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",
   "description": "TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.",
   "type": "module",
   "main": "./dist/cjs/index.js",