@office-open/xml 0.9.8 → 0.10.1

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { C as XmlAttrs, D as XmlOption, E as XmlObject, S as XmlAtom, T as XmlDescArray, _ as ElementCompact, a as childCount, b as Js2XmlOptions, c as collectText, d as findDeep, f as hasChild, g as Element, h as DeclarationAttributes, i as attrNum, l as colorAttr, m as Attributes, n as attr, o as childText, p as textOf, r as attrBool, s as children, t as allChildren, u as findChild, v as ElementObject, w as XmlDesc, x as Xml2JsOptions, y as IgnoreOptions } from "./utils-DJSm61Ws.mjs";
+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";
 
 //#region src/serialize.d.ts
 /**
@@ -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, 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, 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, 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, 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) {
@@ -616,4 +616,4 @@ function xml2json(xml, options) {
 	return JSON.stringify(parse(xml, options));
 }
 //#endregion
-export { allChildren, attr, attrBool, 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, hasChild, stringify as js2xml, stringify, json2xml, nativeTypeValue, parse, parse as xml2js, parseAttributes, selfCloseElement, textOf, toElement, unescapeXml, xml, xml2json };

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

@@ -155,6 +155,20 @@ declare function attr(element: Element | undefined, name: string): string | unde
  * Get an attribute value as a number.
  */
 declare function attrNum(element: Element | undefined, name: string): number | undefined;
+/**
+ * Get a measurement attribute as a number or a verbatim measure/percent string.
+ *
+ * Counterpart to {@link attrNum} for XSD attribute unions of a decimal number
+ * and UniversalMeasure/Percentage (ST_TwipsMeasure, ST_MeasurementOrPercent,
+ * CT_TblWidth/@w, CT_Height/@val): a plain numeric token yields a number, while
+ * UniversalMeasure ("5mm") and Percentage ("50%") stay verbatim so they
+ * round-trip with the stringify-side value helpers in @office-open/core.
+ *
+ * Pass the sibling @type for CT_TblWidth with type="pct" — its fiftieths token
+ * ("5000") must stay a string, since converting it to 5000 would make a later
+ * stringify re-emit "5000%", changing the value.
+ */
+declare function attrMeasure(element: Element | undefined, name: string, type?: string): number | string | undefined;
 /**
  * Get an attribute value as a boolean.
  */
@@ -178,4 +192,4 @@ declare function findDeep(parent: Element | undefined, name: string): Element[];
  */
 declare function childCount(parent: Element | undefined): number;
 //#endregion
-export { XmlAttrs as C, XmlOption as D, XmlObject as E, XmlAtom as S, XmlDescArray as T, ElementCompact as _, childCount as a, Js2XmlOptions as b, collectText as c, findDeep as d, hasChild as f, Element as g, DeclarationAttributes as h, attrNum as i, colorAttr as l, Attributes as m, attr as n, childText as o, textOf as p, attrBool as r, children as s, allChildren as t, findChild as u, ElementObject as v, XmlDesc as w, Xml2JsOptions as x, IgnoreOptions as y };
+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 };

package/dist/utils.d.mts

@@ -1,2 +1,2 @@
-import { a as childCount, c as collectText, d as findDeep, f as hasChild, i as attrNum, l as colorAttr, n as attr, o as childText, p as textOf, r as attrBool, s as children, t as allChildren, u as findChild } from "./utils-DJSm61Ws.mjs";
-export { allChildren, attr, attrBool, attrNum, childCount, childText, children, collectText, colorAttr, findChild, findDeep, hasChild, textOf };
+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 };

package/dist/utils.mjs

@@ -64,6 +64,27 @@ function attrNum(element, name) {
 	return isNaN(n) ? void 0 : n;
 }
 /**
+* Get a measurement attribute as a number or a verbatim measure/percent string.
+*
+* Counterpart to {@link attrNum} for XSD attribute unions of a decimal number
+* and UniversalMeasure/Percentage (ST_TwipsMeasure, ST_MeasurementOrPercent,
+* CT_TblWidth/@w, CT_Height/@val): a plain numeric token yields a number, while
+* UniversalMeasure ("5mm") and Percentage ("50%") stay verbatim so they
+* round-trip with the stringify-side value helpers in @office-open/core.
+*
+* Pass the sibling @type for CT_TblWidth with type="pct" — its fiftieths token
+* ("5000") must stay a string, since converting it to 5000 would make a later
+* stringify re-emit "5000%", changing the value.
+*/
+function attrMeasure(element, name, type) {
+	const v = element?.attributes?.[name];
+	if (v === void 0) return void 0;
+	const raw = String(v);
+	if (type === "pct") return raw;
+	const n = Number(raw);
+	return Number.isNaN(n) ? raw : n;
+}
+/**
 * Get an attribute value as a boolean.
 */
 function attrBool(element, name) {
@@ -113,4 +134,4 @@ function childCount(parent) {
 	return parent?.elements?.length ?? 0;
 }
 //#endregion
-export { allChildren, attr, attrBool, attrNum, childCount, childText, children, collectText, colorAttr, findChild, findDeep, hasChild, textOf };
+export { allChildren, attr, attrBool, attrMeasure, attrNum, childCount, childText, children, collectText, colorAttr, findChild, findDeep, hasChild, textOf };

package/package.json

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