@office-open/xml 0.10.1 → 0.10.3

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { C as XmlAtom, D as XmlObject, E as XmlDescArray, O as XmlOption, S as Xml2JsOptions, T as XmlDesc, _ as Element, a as attrNum, b as IgnoreOptions, c as children, d as findChild, f as findDeep, g as DeclarationAttributes, h as Attributes, i as attrMeasure, l as collectText, m as textOf, n as attr, o as childCount, p as hasChild, r as attrBool, s as childText, t as allChildren, u as colorAttr, v as ElementCompact, w as XmlAttrs, x as Js2XmlOptions, y as ElementObject } from "./utils-DhRRTcbt.mjs";
+import { C as Xml2JsOptions, D as XmlDescArray, E as XmlDesc, O as XmlObject, S as Js2XmlOptions, T as XmlAttrs, _ as DeclarationAttributes, a as attrNum, b as ElementObject, c as children, d as findChild, f as findDeep, g as Attributes, h as textOf, i as attrMeasure, k as XmlOption, l as collectText, m as hasChild, n as attr, o as childCount, p as findFirst, r as attrBool, s as childText, t as allChildren, u as colorAttr, v as Element, w as XmlAtom, x as IgnoreOptions, y as ElementCompact } from "./utils-CDLayhwk.mjs";
 
 //#region src/serialize.d.ts
 /**
@@ -30,7 +30,7 @@ declare function json2xml(json: Element, options?: Js2XmlOptions): string;
  * Convert XmlObject (node-xml format) directly to Element (xml-js format).
  * Eliminates the redundant xml() → xml2js() bridge path.
  */
-declare function toElement(xmlObject: Record<string, any>): Element;
+declare function toElement(xmlObject: Record<string, unknown>): Element;
 //#endregion
 //#region src/escape.d.ts
 /** Escape text content for XML. Fast path returns original string when no special chars. */
@@ -84,4 +84,4 @@ declare function element(name: string, attrRecord?: Readonly<Record<string, stri
 /** Convert XML string to JSON string — xml-js compatible export */
 declare function xml2json(xml: string, options?: Xml2JsOptions): string;
 //#endregion
-export { type Attributes, type DeclarationAttributes, type Element, type ElementCompact, type ElementObject, type IgnoreOptions, type Js2XmlOptions, type Xml2JsOptions, type XmlAtom, type XmlAttrs, type XmlDesc, type XmlDescArray, type XmlObject, type XmlOption, allChildren, attr, attrBool, attrMeasure, attrNum, attrs, attrsRaw, childCount, childText, children, collectText, colorAttr, element, escapeXml, findChild, findDeep, hasChild, stringify as js2xml, stringify, json2xml, nativeTypeValue, parse, parse as xml2js, parseAttributes, selfCloseElement, textOf, toElement, unescapeXml, xml, xml2json };
+export { type Attributes, type DeclarationAttributes, type Element, type ElementCompact, type ElementObject, type IgnoreOptions, type Js2XmlOptions, type Xml2JsOptions, type XmlAtom, type XmlAttrs, type XmlDesc, type XmlDescArray, type XmlObject, type XmlOption, allChildren, attr, attrBool, attrMeasure, attrNum, attrs, attrsRaw, childCount, childText, children, collectText, colorAttr, element, escapeXml, findChild, findDeep, findFirst, hasChild, stringify as js2xml, stringify, json2xml, nativeTypeValue, parse, parse as xml2js, parseAttributes, selfCloseElement, textOf, toElement, unescapeXml, xml, xml2json };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { allChildren, attr, attrBool, attrMeasure, attrNum, childCount, childText, children, collectText, colorAttr, findChild, findDeep, hasChild, textOf } from "./utils.mjs";
+import { allChildren, attr, attrBool, attrMeasure, attrNum, childCount, childText, children, collectText, colorAttr, findChild, findDeep, findFirst, hasChild, textOf } from "./utils.mjs";
 //#region src/escape.ts
 /** Escape text content for XML. Fast path returns original string when no special chars. */
 function escapeXml(str) {
@@ -600,11 +600,12 @@ function toElement(xmlObject) {
 		if (children.length > 0) element.elements = children;
 		return element;
 	}
-	if (typeof value === "object") {
-		if (value._attr) element.attributes = value._attr;
-		if (value._cdata) element.elements = [{
+	if (typeof value === "object" && value !== null) {
+		const obj = value;
+		if (obj._attr) element.attributes = obj._attr;
+		if (obj._cdata) element.elements = [{
 			type: "cdata",
-			cdata: String(value._cdata)
+			cdata: String(obj._cdata)
 		}];
 	}
 	return element;
@@ -616,4 +617,4 @@ function xml2json(xml, options) {
 	return JSON.stringify(parse(xml, options));
 }
 //#endregion
-export { allChildren, attr, attrBool, attrMeasure, attrNum, attrs, attrsRaw, childCount, childText, children, collectText, colorAttr, element, escapeXml, findChild, findDeep, hasChild, stringify as js2xml, stringify, json2xml, nativeTypeValue, parse, parse as xml2js, parseAttributes, selfCloseElement, textOf, toElement, unescapeXml, xml, xml2json };
+export { allChildren, attr, attrBool, attrMeasure, attrNum, attrs, attrsRaw, childCount, childText, children, collectText, colorAttr, element, escapeXml, findChild, findDeep, findFirst, hasChild, stringify as js2xml, stringify, json2xml, nativeTypeValue, parse, parse as xml2js, parseAttributes, selfCloseElement, textOf, toElement, unescapeXml, xml, xml2json };

package/dist/{utils-DhRRTcbt.d.mts → utils-CDLayhwk.d.mts}

@@ -187,9 +187,15 @@ declare function hasChild(parent: Element | undefined, name: string): boolean;
  * Find deep descendant elements matching the given name.
  */
 declare function findDeep(parent: Element | undefined, name: string): Element[];
+/**
+ * Find the first descendant element with the given name (depth-first pre-order).
+ * Short-circuits at the first match — prefer this over `findDeep(parent, name)[0]`
+ * to avoid traversing the whole subtree and allocating the full results array.
+ */
+declare function findFirst(parent: Element | undefined, name: string): Element | undefined;
 /**
  * Get the number of direct child elements.
  */
 declare function childCount(parent: Element | undefined): number;
 //#endregion
-export { XmlAtom as C, XmlObject as D, XmlDescArray as E, XmlOption as O, Xml2JsOptions as S, XmlDesc as T, Element as _, attrNum as a, IgnoreOptions as b, children as c, findChild as d, findDeep as f, DeclarationAttributes as g, Attributes as h, attrMeasure as i, collectText as l, textOf as m, attr as n, childCount as o, hasChild as p, attrBool as r, childText as s, allChildren as t, colorAttr as u, ElementCompact as v, XmlAttrs as w, Js2XmlOptions as x, ElementObject as y };
+export { Xml2JsOptions as C, XmlDescArray as D, XmlDesc as E, XmlObject as O, Js2XmlOptions as S, XmlAttrs as T, DeclarationAttributes as _, attrNum as a, ElementObject as b, children as c, findChild as d, findDeep as f, Attributes as g, textOf as h, attrMeasure as i, XmlOption as k, collectText as l, hasChild as m, attr as n, childCount as o, findFirst as p, attrBool as r, childText as s, allChildren as t, colorAttr as u, Element as v, XmlAtom as w, IgnoreOptions as x, ElementCompact as y };

package/dist/utils.d.mts

@@ -1,2 +1,2 @@
-import { a as attrNum, c as children, d as findChild, f as findDeep, i as attrMeasure, l as collectText, m as textOf, n as attr, o as childCount, p as hasChild, r as attrBool, s as childText, t as allChildren, u as colorAttr } from "./utils-DhRRTcbt.mjs";
-export { allChildren, attr, attrBool, attrMeasure, attrNum, childCount, childText, children, collectText, colorAttr, findChild, findDeep, hasChild, textOf };
+import { a as attrNum, c as children, d as findChild, f as findDeep, h as textOf, i as attrMeasure, l as collectText, m as hasChild, n as attr, o as childCount, p as findFirst, r as attrBool, s as childText, t as allChildren, u as colorAttr } from "./utils-CDLayhwk.mjs";
+export { allChildren, attr, attrBool, attrMeasure, attrNum, childCount, childText, children, collectText, colorAttr, findChild, findDeep, findFirst, hasChild, textOf };

package/dist/utils.mjs

@@ -128,10 +128,23 @@ function findDeep(parent, name) {
 	return result;
 }
 /**
+* Find the first descendant element with the given name (depth-first pre-order).
+* Short-circuits at the first match — prefer this over `findDeep(parent, name)[0]`
+* to avoid traversing the whole subtree and allocating the full results array.
+*/
+function findFirst(parent, name) {
+	if (!parent) return void 0;
+	for (const child of parent.elements ?? []) {
+		if (child.name === name) return child;
+		const found = findFirst(child, name);
+		if (found) return found;
+	}
+}
+/**
 * Get the number of direct child elements.
 */
 function childCount(parent) {
 	return parent?.elements?.length ?? 0;
 }
 //#endregion
-export { allChildren, attr, attrBool, attrMeasure, attrNum, childCount, childText, children, collectText, colorAttr, findChild, findDeep, hasChild, textOf };
+export { allChildren, attr, attrBool, attrMeasure, attrNum, childCount, childText, children, collectText, colorAttr, findChild, findDeep, findFirst, hasChild, textOf };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@office-open/xml",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "description": "XML parsing and serialization for Office Open XML. Zero dependencies, drop-in replacement for xml + xml-js.",
   "keywords": [
     "office-open",