@office-open/core 0.6.8 → 0.6.10

package/dist/{smartart-BKz8xM1k.mjs → smartart-Cx1qa6k_.mjs}

@@ -1,4 +1,4 @@
-import { l as chartAttr, y as XmlComponent } from "./xml-components-Cfvn_mId.mjs";
+import { l as chartAttr, y as XmlComponent } from "./xml-components-xJkfJ6ff.mjs";
 //#region src/smartart/categories.ts
 /** Layout ID → OOXML category type */
 const LAYOUT_CATEGORIES = {
@@ -95,33 +95,29 @@ const COLOR_CATEGORIES = {
 };
 //#endregion
 //#region src/smartart/built-in-definitions.ts
-const DGM_NS = "http://schemas.openxmlformats.org/drawingml/2006/diagram";
-const XML_DECL = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>";
-/** Full default list layout (urn:microsoft.com/office/officeart/2005/8/layout/default) */
-const FULL_DEFAULT_LAYOUT_XML = "<dgm:layoutDef xmlns:dgm=\"" + DGM_NS + "\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" uniqueId=\"urn:microsoft.com/office/officeart/2005/8/layout/default\"><dgm:title val=\"\"/><dgm:desc val=\"\"/><dgm:catLst><dgm:cat type=\"list\" pri=\"400\"/></dgm:catLst><dgm:sampData><dgm:dataModel><dgm:ptLst><dgm:pt modelId=\"0\" type=\"doc\"/><dgm:pt modelId=\"1\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"2\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"3\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"4\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"5\"><dgm:prSet phldr=\"1\"/></dgm:pt></dgm:ptLst><dgm:cxnLst><dgm:cxn modelId=\"6\" srcId=\"0\" destId=\"1\" srcOrd=\"0\" destOrd=\"0\"/><dgm:cxn modelId=\"7\" srcId=\"0\" destId=\"2\" srcOrd=\"1\" destOrd=\"0\"/><dgm:cxn modelId=\"8\" srcId=\"0\" destId=\"3\" srcOrd=\"2\" destOrd=\"0\"/><dgm:cxn modelId=\"9\" srcId=\"0\" destId=\"4\" srcOrd=\"3\" destOrd=\"0\"/><dgm:cxn modelId=\"10\" srcId=\"0\" destId=\"5\" srcOrd=\"4\" destOrd=\"0\"/></dgm:cxnLst><dgm:bg/><dgm:whole/></dgm:dataModel></dgm:sampData><dgm:styleData><dgm:dataModel><dgm:ptLst><dgm:pt modelId=\"0\" type=\"doc\"/><dgm:pt modelId=\"1\"/><dgm:pt modelId=\"2\"/></dgm:ptLst><dgm:cxnLst><dgm:cxn modelId=\"3\" srcId=\"0\" destId=\"1\" srcOrd=\"0\" destOrd=\"0\"/><dgm:cxn modelId=\"4\" srcId=\"0\" destId=\"2\" srcOrd=\"1\" destOrd=\"0\"/></dgm:cxnLst><dgm:bg/><dgm:whole/></dgm:dataModel></dgm:styleData><dgm:clrData><dgm:dataModel><dgm:ptLst><dgm:pt modelId=\"0\" type=\"doc\"/><dgm:pt modelId=\"1\"/><dgm:pt modelId=\"2\"/><dgm:pt modelId=\"3\"/><dgm:pt modelId=\"4\"/><dgm:pt modelId=\"5\"/><dgm:pt modelId=\"6\"/></dgm:ptLst><dgm:cxnLst><dgm:cxn modelId=\"7\" srcId=\"0\" destId=\"1\" srcOrd=\"0\" destOrd=\"0\"/><dgm:cxn modelId=\"8\" srcId=\"0\" destId=\"2\" srcOrd=\"1\" destOrd=\"0\"/><dgm:cxn modelId=\"9\" srcId=\"0\" destId=\"3\" srcOrd=\"2\" destOrd=\"0\"/><dgm:cxn modelId=\"10\" srcId=\"0\" destId=\"4\" srcOrd=\"3\" destOrd=\"0\"/><dgm:cxn modelId=\"11\" srcId=\"0\" destId=\"5\" srcOrd=\"4\" destOrd=\"0\"/><dgm:cxn modelId=\"12\" srcId=\"0\" destId=\"6\" srcOrd=\"5\" destOrd=\"0\"/></dgm:cxnLst><dgm:bg/><dgm:whole/></dgm:dataModel></dgm:clrData><dgm:layoutNode name=\"diagram\"><dgm:varLst><dgm:dir/><dgm:resizeHandles val=\"exact\"/></dgm:varLst><dgm:choose name=\"Name0\"><dgm:if name=\"Name1\" func=\"var\" arg=\"dir\" op=\"equ\" val=\"norm\"><dgm:alg type=\"snake\"><dgm:param type=\"grDir\" val=\"tL\"/><dgm:param type=\"flowDir\" val=\"row\"/><dgm:param type=\"contDir\" val=\"sameDir\"/><dgm:param type=\"off\" val=\"ctr\"/></dgm:alg></dgm:if><dgm:else name=\"Name2\"><dgm:alg type=\"snake\"><dgm:param type=\"grDir\" val=\"tR\"/><dgm:param type=\"flowDir\" val=\"row\"/><dgm:param type=\"contDir\" val=\"sameDir\"/><dgm:param type=\"off\" val=\"ctr\"/></dgm:alg></dgm:else></dgm:choose><dgm:shape xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\" r:blip=\"\"><dgm:adjLst/></dgm:shape><dgm:presOf/><dgm:constrLst><dgm:constr type=\"w\" for=\"ch\" forName=\"node\" refType=\"w\"/><dgm:constr type=\"h\" for=\"ch\" forName=\"node\" refType=\"w\" refFor=\"ch\" refForName=\"node\" fact=\"0.6\"/><dgm:constr type=\"w\" for=\"ch\" forName=\"sibTrans\" refType=\"w\" refFor=\"ch\" refForName=\"node\" fact=\"0.1\"/><dgm:constr type=\"sp\" refType=\"w\" refFor=\"ch\" refForName=\"sibTrans\"/><dgm:constr type=\"primFontSz\" for=\"ch\" forName=\"node\" op=\"equ\" val=\"65\"/></dgm:constrLst><dgm:ruleLst/><dgm:forEach name=\"Name3\" axis=\"ch\" ptType=\"node\"><dgm:layoutNode name=\"node\"><dgm:varLst><dgm:bulletEnabled val=\"1\"/></dgm:varLst><dgm:alg type=\"tx\"/><dgm:shape type=\"rect\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\" r:blip=\"\"><dgm:adjLst/></dgm:shape><dgm:presOf axis=\"desOrSelf\" ptType=\"node\"/><dgm:constrLst><dgm:constr type=\"lMarg\" refType=\"primFontSz\" fact=\"0.3\"/><dgm:constr type=\"rMarg\" refType=\"primFontSz\" fact=\"0.3\"/><dgm:constr type=\"tMarg\" refType=\"primFontSz\" fact=\"0.3\"/><dgm:constr type=\"bMarg\" refType=\"primFontSz\" fact=\"0.3\"/></dgm:constrLst><dgm:ruleLst><dgm:rule type=\"primFontSz\" val=\"5\" fact=\"NaN\" max=\"NaN\"/></dgm:ruleLst></dgm:layoutNode><dgm:forEach name=\"Name4\" axis=\"followSib\" ptType=\"sibTrans\" cnt=\"1\"><dgm:layoutNode name=\"sibTrans\"><dgm:alg type=\"sp\"/><dgm:shape xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\" r:blip=\"\"><dgm:adjLst/></dgm:shape><dgm:presOf/><dgm:constrLst/><dgm:ruleLst/></dgm:layoutNode></dgm:forEach></dgm:layoutNode></dgm:layoutDef>";
 /**
 * Returns layout XML. Full XML for "default", minimal stub for others.
 * Stub has no layoutNode so PowerPoint falls back to built-in definitions
 * based on the uniqueId / loTypeId in the data model.
 */
 function getLayoutXml(layoutId) {
-	if (layoutId === "default") return XML_DECL + FULL_DEFAULT_LAYOUT_XML;
+	if (layoutId === "default") return "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><dgm:layoutDef xmlns:dgm=\"http://schemas.openxmlformats.org/drawingml/2006/diagram\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" uniqueId=\"urn:microsoft.com/office/officeart/2005/8/layout/default\"><dgm:title val=\"\"/><dgm:desc val=\"\"/><dgm:catLst><dgm:cat type=\"list\" pri=\"400\"/></dgm:catLst><dgm:sampData><dgm:dataModel><dgm:ptLst><dgm:pt modelId=\"0\" type=\"doc\"/><dgm:pt modelId=\"1\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"2\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"3\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"4\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"5\"><dgm:prSet phldr=\"1\"/></dgm:pt></dgm:ptLst><dgm:cxnLst><dgm:cxn modelId=\"6\" srcId=\"0\" destId=\"1\" srcOrd=\"0\" destOrd=\"0\"/><dgm:cxn modelId=\"7\" srcId=\"0\" destId=\"2\" srcOrd=\"1\" destOrd=\"0\"/><dgm:cxn modelId=\"8\" srcId=\"0\" destId=\"3\" srcOrd=\"2\" destOrd=\"0\"/><dgm:cxn modelId=\"9\" srcId=\"0\" destId=\"4\" srcOrd=\"3\" destOrd=\"0\"/><dgm:cxn modelId=\"10\" srcId=\"0\" destId=\"5\" srcOrd=\"4\" destOrd=\"0\"/></dgm:cxnLst><dgm:bg/><dgm:whole/></dgm:dataModel></dgm:sampData><dgm:styleData><dgm:dataModel><dgm:ptLst><dgm:pt modelId=\"0\" type=\"doc\"/><dgm:pt modelId=\"1\"/><dgm:pt modelId=\"2\"/></dgm:ptLst><dgm:cxnLst><dgm:cxn modelId=\"3\" srcId=\"0\" destId=\"1\" srcOrd=\"0\" destOrd=\"0\"/><dgm:cxn modelId=\"4\" srcId=\"0\" destId=\"2\" srcOrd=\"1\" destOrd=\"0\"/></dgm:cxnLst><dgm:bg/><dgm:whole/></dgm:dataModel></dgm:styleData><dgm:clrData><dgm:dataModel><dgm:ptLst><dgm:pt modelId=\"0\" type=\"doc\"/><dgm:pt modelId=\"1\"/><dgm:pt modelId=\"2\"/><dgm:pt modelId=\"3\"/><dgm:pt modelId=\"4\"/><dgm:pt modelId=\"5\"/><dgm:pt modelId=\"6\"/></dgm:ptLst><dgm:cxnLst><dgm:cxn modelId=\"7\" srcId=\"0\" destId=\"1\" srcOrd=\"0\" destOrd=\"0\"/><dgm:cxn modelId=\"8\" srcId=\"0\" destId=\"2\" srcOrd=\"1\" destOrd=\"0\"/><dgm:cxn modelId=\"9\" srcId=\"0\" destId=\"3\" srcOrd=\"2\" destOrd=\"0\"/><dgm:cxn modelId=\"10\" srcId=\"0\" destId=\"4\" srcOrd=\"3\" destOrd=\"0\"/><dgm:cxn modelId=\"11\" srcId=\"0\" destId=\"5\" srcOrd=\"4\" destOrd=\"0\"/><dgm:cxn modelId=\"12\" srcId=\"0\" destId=\"6\" srcOrd=\"5\" destOrd=\"0\"/></dgm:cxnLst><dgm:bg/><dgm:whole/></dgm:dataModel></dgm:clrData><dgm:layoutNode name=\"diagram\"><dgm:varLst><dgm:dir/><dgm:resizeHandles val=\"exact\"/></dgm:varLst><dgm:choose name=\"Name0\"><dgm:if name=\"Name1\" func=\"var\" arg=\"dir\" op=\"equ\" val=\"norm\"><dgm:alg type=\"snake\"><dgm:param type=\"grDir\" val=\"tL\"/><dgm:param type=\"flowDir\" val=\"row\"/><dgm:param type=\"contDir\" val=\"sameDir\"/><dgm:param type=\"off\" val=\"ctr\"/></dgm:alg></dgm:if><dgm:else name=\"Name2\"><dgm:alg type=\"snake\"><dgm:param type=\"grDir\" val=\"tR\"/><dgm:param type=\"flowDir\" val=\"row\"/><dgm:param type=\"contDir\" val=\"sameDir\"/><dgm:param type=\"off\" val=\"ctr\"/></dgm:alg></dgm:else></dgm:choose><dgm:shape xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\" r:blip=\"\"><dgm:adjLst/></dgm:shape><dgm:presOf/><dgm:constrLst><dgm:constr type=\"w\" for=\"ch\" forName=\"node\" refType=\"w\"/><dgm:constr type=\"h\" for=\"ch\" forName=\"node\" refType=\"w\" refFor=\"ch\" refForName=\"node\" fact=\"0.6\"/><dgm:constr type=\"w\" for=\"ch\" forName=\"sibTrans\" refType=\"w\" refFor=\"ch\" refForName=\"node\" fact=\"0.1\"/><dgm:constr type=\"sp\" refType=\"w\" refFor=\"ch\" refForName=\"sibTrans\"/><dgm:constr type=\"primFontSz\" for=\"ch\" forName=\"node\" op=\"equ\" val=\"65\"/></dgm:constrLst><dgm:ruleLst/><dgm:forEach name=\"Name3\" axis=\"ch\" ptType=\"node\"><dgm:layoutNode name=\"node\"><dgm:varLst><dgm:bulletEnabled val=\"1\"/></dgm:varLst><dgm:alg type=\"tx\"/><dgm:shape type=\"rect\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\" r:blip=\"\"><dgm:adjLst/></dgm:shape><dgm:presOf axis=\"desOrSelf\" ptType=\"node\"/><dgm:constrLst><dgm:constr type=\"lMarg\" refType=\"primFontSz\" fact=\"0.3\"/><dgm:constr type=\"rMarg\" refType=\"primFontSz\" fact=\"0.3\"/><dgm:constr type=\"tMarg\" refType=\"primFontSz\" fact=\"0.3\"/><dgm:constr type=\"bMarg\" refType=\"primFontSz\" fact=\"0.3\"/></dgm:constrLst><dgm:ruleLst><dgm:rule type=\"primFontSz\" val=\"5\" fact=\"NaN\" max=\"NaN\"/></dgm:ruleLst></dgm:layoutNode><dgm:forEach name=\"Name4\" axis=\"followSib\" ptType=\"sibTrans\" cnt=\"1\"><dgm:layoutNode name=\"sibTrans\"><dgm:alg type=\"sp\"/><dgm:shape xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\" r:blip=\"\"><dgm:adjLst/></dgm:shape><dgm:presOf/><dgm:constrLst/><dgm:ruleLst/></dgm:layoutNode></dgm:forEach></dgm:layoutNode></dgm:layoutDef>";
 	const cat = LAYOUT_CATEGORIES[layoutId] ?? "list";
-	return XML_DECL + "<dgm:layoutDef xmlns:dgm=\"http://schemas.openxmlformats.org/drawingml/2006/diagram\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" uniqueId=\"urn:microsoft.com/office/officeart/2005/8/layout/" + layoutId + "\"><dgm:title val=\"\"/><dgm:desc val=\"\"/><dgm:catLst><dgm:cat type=\"" + cat + "\" pri=\"400\"/></dgm:catLst><dgm:sampData><dgm:dataModel><dgm:ptLst><dgm:pt modelId=\"0\" type=\"doc\"/><dgm:pt modelId=\"1\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"2\"><dgm:prSet phldr=\"1\"/></dgm:pt></dgm:ptLst><dgm:cxnLst><dgm:cxn modelId=\"3\" srcId=\"0\" destId=\"1\" srcOrd=\"0\" destOrd=\"0\"/><dgm:cxn modelId=\"4\" srcId=\"0\" destId=\"2\" srcOrd=\"1\" destOrd=\"0\"/></dgm:cxnLst><dgm:bg/><dgm:whole/></dgm:dataModel></dgm:sampData></dgm:layoutDef>";
+	return "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><dgm:layoutDef xmlns:dgm=\"http://schemas.openxmlformats.org/drawingml/2006/diagram\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" uniqueId=\"urn:microsoft.com/office/officeart/2005/8/layout/" + layoutId + "\"><dgm:title val=\"\"/><dgm:desc val=\"\"/><dgm:catLst><dgm:cat type=\"" + cat + "\" pri=\"400\"/></dgm:catLst><dgm:sampData><dgm:dataModel><dgm:ptLst><dgm:pt modelId=\"0\" type=\"doc\"/><dgm:pt modelId=\"1\"><dgm:prSet phldr=\"1\"/></dgm:pt><dgm:pt modelId=\"2\"><dgm:prSet phldr=\"1\"/></dgm:pt></dgm:ptLst><dgm:cxnLst><dgm:cxn modelId=\"3\" srcId=\"0\" destId=\"1\" srcOrd=\"0\" destOrd=\"0\"/><dgm:cxn modelId=\"4\" srcId=\"0\" destId=\"2\" srcOrd=\"1\" destOrd=\"0\"/></dgm:cxnLst><dgm:bg/><dgm:whole/></dgm:dataModel></dgm:sampData></dgm:layoutDef>";
 }
 /**
 * Returns style stub XML with the given uniqueId.
 */
 function getStyleXml(styleId) {
 	const cat = STYLE_CATEGORIES[styleId] ?? "simple";
-	return XML_DECL + "<dgm:styleDef xmlns:dgm=\"http://schemas.openxmlformats.org/drawingml/2006/diagram\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" uniqueId=\"urn:microsoft.com/office/officeart/2005/8/quickstyle/" + styleId + "\"><dgm:title val=\"\"/><dgm:desc val=\"\"/><dgm:catLst><dgm:cat type=\"" + cat + "\" pri=\"10100\"/></dgm:catLst><dgm:scene3d><a:camera prst=\"orthographicFront\"/><a:lightRig rig=\"threePt\" dir=\"t\"/></dgm:scene3d></dgm:styleDef>";
+	return "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><dgm:styleDef xmlns:dgm=\"http://schemas.openxmlformats.org/drawingml/2006/diagram\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" uniqueId=\"urn:microsoft.com/office/officeart/2005/8/quickstyle/" + styleId + "\"><dgm:title val=\"\"/><dgm:desc val=\"\"/><dgm:catLst><dgm:cat type=\"" + cat + "\" pri=\"10100\"/></dgm:catLst><dgm:scene3d><a:camera prst=\"orthographicFront\"/><a:lightRig rig=\"threePt\" dir=\"t\"/></dgm:scene3d></dgm:styleDef>";
 }
 /**
 * Returns color stub XML with the given uniqueId.
 */
 function getColorXml(colorId) {
 	const cat = COLOR_CATEGORIES[colorId] ?? "accent1";
-	return XML_DECL + "<dgm:colorsDef xmlns:dgm=\"http://schemas.openxmlformats.org/drawingml/2006/diagram\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" uniqueId=\"urn:microsoft.com/office/officeart/2005/8/colors/" + colorId + "\"><dgm:title val=\"\"/><dgm:desc val=\"\"/><dgm:catLst><dgm:cat type=\"" + cat + "\" pri=\"11200\"/></dgm:catLst></dgm:colorsDef>";
+	return "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><dgm:colorsDef xmlns:dgm=\"http://schemas.openxmlformats.org/drawingml/2006/diagram\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" uniqueId=\"urn:microsoft.com/office/officeart/2005/8/colors/" + colorId + "\"><dgm:title val=\"\"/><dgm:desc val=\"\"/><dgm:catLst><dgm:cat type=\"" + cat + "\" pri=\"11200\"/></dgm:catLst></dgm:colorsDef>";
 }
 /** Minimal drawing cache for SmartArt (Office apps auto-regenerate this on open) */
 const DEFAULT_DRAWING_XML = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><dsp:drawing xmlns:dgm=\"http://schemas.openxmlformats.org/drawingml/2006/diagram\" xmlns:dsp=\"http://schemas.microsoft.com/office/drawing/2008/diagram\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\"><dsp:spTree><dsp:nvGrpSpPr><dsp:cNvPr id=\"0\" name=\"\"/><dsp:cNvGrpSpPr/></dsp:nvGrpSpPr><dsp:grpSpPr/></dsp:spTree></dsp:drawing>";

package/dist/values-zMCu5EoQ.mjs

@@ -0,0 +1,371 @@
+//#region src/values.ts
+/**
+* Validates and converts a number to an integer (decimal number).
+*
+* Reference: ST_DecimalNumber in OOXML specification
+*
+* @param val - The number to validate and convert
+* @returns The floored integer value
+* @throws Error if the value is NaN
+*
+* @example
+* ```typescript
+* const num = decimalNumber(10.7); // Returns 10
+* const negative = decimalNumber(-5.3); // Returns -5
+* ```
+*/
+const decimalNumber = (val) => {
+	if (isNaN(val)) throw new Error(`Invalid value '${val}' specified. Must be an integer.`);
+	return Math.floor(val);
+};
+/**
+* Validates and converts a number to a positive integer (unsigned decimal number).
+*
+* Reference: ST_UnsignedDecimalNumber in OOXML specification
+*
+* @param val - The number to validate and convert
+* @returns The floored positive integer value
+* @throws Error if the value is NaN or negative
+*
+* @example
+* ```typescript
+* const num = unsignedDecimalNumber(10.7); // Returns 10
+* const invalid = unsignedDecimalNumber(-5); // Throws Error
+* ```
+*/
+const unsignedDecimalNumber = (val) => {
+	const value = decimalNumber(val);
+	if (value < 0) throw new Error(`Invalid value '${val}' specified. Must be a positive integer.`);
+	return value;
+};
+/**
+* Validates and normalizes a hexadecimal binary value.
+*
+* The xsd:hexBinary type represents binary data as a sequence of binary octets
+* using hexadecimal encoding, where each binary octet is a two-character
+* hexadecimal number. Both lowercase and uppercase letters A-F are permitted.
+*
+* @param val - The hexadecimal string to validate
+* @param length - The expected length in bytes (not characters)
+* @returns The validated hexadecimal string
+* @throws Error if the value is not a valid hex string of the expected length
+*
+* @example
+* ```typescript
+* hexBinary("0FB8", 2); // Valid: 2 bytes = 4 characters
+* hexBinary("ABC", 2); // Invalid: wrong length
+* ```
+*/
+const hexBinary = (val, length) => {
+	const expectedLength = length * 2;
+	if (val.length !== expectedLength || isNaN(Number(`0x${val}`))) throw new Error(`Invalid hex value '${val}'. Expected ${expectedLength} digit hex value`);
+	return val;
+};
+/**
+* Validates a long hexadecimal number (4 bytes / 8 characters).
+*
+* Reference: ST_LongHexNumber in OOXML specification
+*
+* @param val - The hexadecimal string to validate
+* @returns The validated hexadecimal string
+* @throws Error if the value is not a valid 8-character hex string
+*
+* @example
+* ```typescript
+* const hex = longHexNumber("ABCD1234"); // Valid
+* ```
+*/
+const longHexNumber = (val) => hexBinary(val, 4);
+/**
+* Validates a short hexadecimal number (2 bytes / 4 characters).
+*
+* Reference: ST_ShortHexNumber in OOXML specification
+*
+* @param val - The hexadecimal string to validate
+* @returns The validated hexadecimal string
+* @throws Error if the value is not a valid 4-character hex string
+*
+* @example
+* ```typescript
+* const hex = shortHexNumber("AB12"); // Valid
+* ```
+*/
+const shortHexNumber = (val) => hexBinary(val, 2);
+/**
+* Validates a single-byte hexadecimal number (1 byte / 2 characters).
+*
+* Reference: ST_UcharHexNumber in OOXML specification
+*
+* @param val - The hexadecimal string to validate
+* @returns The validated hexadecimal string
+* @throws Error if the value is not a valid 2-character hex string
+*
+* @example
+* ```typescript
+* const hex = uCharHexNumber("FF"); // Valid
+* ```
+*/
+const uCharHexNumber = (val) => hexBinary(val, 1);
+/**
+* Normalizes a universal measure value by parsing and reformatting.
+*
+* Ensures the numeric portion is properly formatted while preserving the unit.
+*
+* Reference: ST_UniversalMeasure in OOXML specification
+*
+* @param val - The universal measure string to normalize
+* @returns The normalized universal measure
+*
+* @example
+* ```typescript
+* const measure = universalMeasureValue("10.500mm"); // Returns "10.5mm"
+* ```
+*/
+const universalMeasureValue = (val) => {
+	const unit = val.slice(-2);
+	const amount = val.substring(0, val.length - 2);
+	return `${Number(amount)}${unit}`;
+};
+/**
+* Validates and normalizes a positive universal measure value.
+*
+* Reference: ST_PositiveUniversalMeasure in OOXML specification
+*
+* @param val - The positive universal measure string to validate
+* @returns The normalized positive universal measure
+* @throws Error if the value is negative
+*
+* @example
+* ```typescript
+* const measure = positiveUniversalMeasureValue("10.5mm"); // Valid
+* const invalid = positiveUniversalMeasureValue("-5mm"); // Throws Error
+* ```
+*/
+const positiveUniversalMeasureValue = (val) => {
+	const value = universalMeasureValue(val);
+	if (parseFloat(value) < 0) throw new Error(`Invalid value '${value}' specified. Expected a positive number.`);
+	return value;
+};
+/**
+* Validates and normalizes a hexadecimal color value.
+*
+* Accepts either "auto" or a 6-character RGB hex value (with or without # prefix).
+* The # prefix is commonly used but technically invalid in OOXML, so it is stripped
+* for strict compliance.
+*
+* Reference: ST_HexColor in OOXML specification
+*
+* @param val - The color value to validate ("auto" or hex color)
+* @returns The normalized color value
+* @throws Error if the hex color is invalid
+*
+* @example
+* ```typescript
+* const color1 = hexColorValue("auto"); // Returns "auto"
+* const color2 = hexColorValue("FF0000"); // Returns "FF0000"
+* const color3 = hexColorValue("#00FF00"); // Returns "00FF00" (# stripped)
+* ```
+*/
+const hexColorValue = (val) => {
+	if (val === "auto") return val;
+	return hexBinary(val.charAt(0) === "#" ? val.substring(1) : val, 3);
+};
+/**
+* Validates a signed TWIP measurement value.
+*
+* Accepts either a universal measure string or a numeric TWIP value.
+*
+* Reference: ST_SignedTwipsMeasure in OOXML specification
+*
+* @param val - The measurement value (universal measure or number)
+* @returns The normalized measurement value
+*
+* @example
+* ```typescript
+* const measure1 = signedTwipsMeasureValue("10mm");
+* const measure2 = signedTwipsMeasureValue(1440); // 1 inch in TWIP
+* ```
+*/
+const signedTwipsMeasureValue = (val) => typeof val === "string" ? universalMeasureValue(val) : decimalNumber(val);
+/**
+* Validates a half-point (HPS) measurement value.
+*
+* Accepts either a positive universal measure string or a positive number.
+* HPS (half-points) are commonly used for font sizes.
+*
+* Reference: ST_HpsMeasure in OOXML specification
+*
+* @param val - The measurement value (positive universal measure or number)
+* @returns The normalized measurement value
+*
+* @example
+* ```typescript
+* const fontSize1 = hpsMeasureValue("12pt");
+* const fontSize2 = hpsMeasureValue(24); // 12pt in half-points
+* ```
+*/
+const hpsMeasureValue = (val) => typeof val === "string" ? positiveUniversalMeasureValue(val) : unsignedDecimalNumber(val);
+/**
+* Validates a signed half-point (HPS) measurement value.
+*
+* Accepts either a universal measure string or a numeric value.
+*
+* Reference: ST_SignedHpsMeasure in OOXML specification
+*
+* @param val - The measurement value (universal measure or number)
+* @returns The normalized measurement value
+*
+* @example
+* ```typescript
+* const spacing1 = signedHpsMeasureValue("6pt");
+* const spacing2 = signedHpsMeasureValue(-12); // Negative spacing
+* ```
+*/
+const signedHpsMeasureValue = (val) => typeof val === "string" ? universalMeasureValue(val) : decimalNumber(val);
+/**
+* Validates a positive TWIP measurement value.
+*
+* Accepts either a positive universal measure string or a positive number.
+*
+* Reference: ST_TwipsMeasure in OOXML specification
+*
+* @param val - The measurement value (positive universal measure or number)
+* @returns The normalized measurement value
+*
+* @example
+* ```typescript
+* const width1 = twipsMeasureValue("25.4mm");
+* const width2 = twipsMeasureValue(1440); // 1 inch in TWIP
+* ```
+*/
+const twipsMeasureValue = (val) => typeof val === "string" ? positiveUniversalMeasureValue(val) : unsignedDecimalNumber(val);
+/**
+* Normalizes a percentage value by parsing and reformatting.
+*
+* Reference: ST_Percentage in OOXML specification
+*
+* @param val - The percentage string to normalize
+* @returns The normalized percentage
+*
+* @example
+* ```typescript
+* const percent = percentageValue("50.000%"); // Returns "50%"
+* ```
+*/
+const percentageValue = (val) => {
+	const percent = val.substring(0, val.length - 1);
+	return `${Number(percent)}%`;
+};
+/**
+* Validates a measurement value that can be expressed as a number, percentage, or universal measure.
+*
+* Reference: ST_MeasurementOrPercent in OOXML specification
+*
+* @param val - The measurement value (number, percentage, or universal measure)
+* @returns The normalized measurement value
+*
+* @example
+* ```typescript
+* const measure1 = measurementOrPercentValue(100); // Unqualified number
+* const measure2 = measurementOrPercentValue("50%"); // Percentage
+* const measure3 = measurementOrPercentValue("10mm"); // Universal measure
+* ```
+*/
+const measurementOrPercentValue = (val) => {
+	if (typeof val === "number") return decimalNumber(val);
+	if (val.slice(-1) === "%") return percentageValue(val);
+	return universalMeasureValue(val);
+};
+/**
+* Validates an eighth-point measurement value.
+*
+* Eighth-points are used for fine-grained measurements in text formatting.
+*
+* Reference: ST_EighthPointMeasure in OOXML specification
+*
+* @param val - The measurement value in eighth-points
+* @returns The validated positive integer value
+*
+* @example
+* ```typescript
+* const measure = eighthPointMeasureValue(16); // 2 points
+* ```
+*/
+const eighthPointMeasureValue = unsignedDecimalNumber;
+/**
+* Validates a point measurement value.
+*
+* Reference: ST_PointMeasure in OOXML specification
+*
+* @param val - The measurement value in points
+* @returns The validated positive integer value
+*
+* @example
+* ```typescript
+* const fontSize = pointMeasureValue(12); // 12pt
+* ```
+*/
+const pointMeasureValue = unsignedDecimalNumber;
+/**
+* Converts a JavaScript Date object to an ISO 8601 date-time string.
+*
+* The format is CCYY-MM-DDThh:mm:ss.sssZ where T is a literal and Z indicates UTC.
+* This matches the xsd:dateTime format required by OOXML.
+*
+* Reference: ST_DateTime in OOXML specification
+*
+* @param val - The Date object to convert
+* @returns An ISO 8601 formatted date-time string
+*
+* @example
+* ```typescript
+* const now = new Date();
+* const timestamp = dateTimeValue(now); // Returns "2024-01-15T10:30:00.000Z"
+* ```
+*/
+const dateTimeValue = (val) => val.toISOString();
+/**
+* Theme color values used throughout OOXML for referencing document theme colors.
+*
+* Reference: ST_ThemeColor in OOXML specification
+*
+* @publicApi
+*/
+const ThemeColor = {
+	DARK1: "dark1",
+	LIGHT1: "light1",
+	DARK2: "dark2",
+	LIGHT2: "light2",
+	ACCENT1: "accent1",
+	ACCENT2: "accent2",
+	ACCENT3: "accent3",
+	ACCENT4: "accent4",
+	ACCENT5: "accent5",
+	ACCENT6: "accent6",
+	HYPERLINK: "hyperlink",
+	FOLLOWED_HYPERLINK: "followedHyperlink",
+	NONE: "none",
+	BACKGROUND1: "background1",
+	TEXT1: "text1",
+	BACKGROUND2: "background2",
+	TEXT2: "text2"
+};
+/**
+* Theme font values used for referencing document theme fonts.
+*
+* Reference: ST_Theme in OOXML specification
+*
+* @publicApi
+*/
+const ThemeFont = {
+	MAJOR_EAST_ASIA: "majorEastAsia",
+	MAJOR_BIDI: "majorBidi",
+	MAJOR_ASCII: "majorAscii",
+	MAJOR_H_ANSI: "majorHAnsi",
+	MINOR_EAST_ASIA: "minorEastAsia",
+	MINOR_BIDI: "minorBidi",
+	MINOR_ASCII: "minorAscii",
+	MINOR_H_ANSI: "minorHAnsi"
+};
+//#endregion
+export { twipsMeasureValue as _, eighthPointMeasureValue as a, unsignedDecimalNumber as b, hpsMeasureValue as c, percentageValue as d, pointMeasureValue as f, signedTwipsMeasureValue as g, signedHpsMeasureValue as h, decimalNumber as i, longHexNumber as l, shortHexNumber as m, ThemeFont as n, hexBinary as o, positiveUniversalMeasureValue as p, dateTimeValue as r, hexColorValue as s, ThemeColor as t, measurementOrPercentValue as u, uCharHexNumber as v, universalMeasureValue as y };

package/dist/values.d.mts

@@ -1,2 +1,2 @@
-import { C as uCharHexNumber, S as twipsMeasureValue, T as unsignedDecimalNumber, _ as pointMeasureValue, a as ThemeColor, b as signedHpsMeasureValue, c as dateTimeValue, d as hexBinary, f as hexColorValue, g as percentageValue, h as measurementOrPercentValue, i as RelativeMeasure, l as decimalNumber, m as longHexNumber, n as PositivePercentage, o as ThemeFont, p as hpsMeasureValue, r as PositiveUniversalMeasure, s as UniversalMeasure, t as Percentage, u as eighthPointMeasureValue, v as positiveUniversalMeasureValue, w as universalMeasureValue, x as signedTwipsMeasureValue, y as shortHexNumber } from "./values-QyWq4U4A.mjs";
+import { C as uCharHexNumber, S as twipsMeasureValue, T as unsignedDecimalNumber, _ as pointMeasureValue, a as ThemeColor, b as signedHpsMeasureValue, c as dateTimeValue, d as hexBinary, f as hexColorValue, g as percentageValue, h as measurementOrPercentValue, i as RelativeMeasure, l as decimalNumber, m as longHexNumber, n as PositivePercentage, o as ThemeFont, p as hpsMeasureValue, r as PositiveUniversalMeasure, s as UniversalMeasure, t as Percentage, u as eighthPointMeasureValue, v as positiveUniversalMeasureValue, w as universalMeasureValue, x as signedTwipsMeasureValue, y as shortHexNumber } from "./values-COjPGYkS.mjs";
 export { Percentage, PositivePercentage, PositiveUniversalMeasure, RelativeMeasure, ThemeColor, ThemeFont, UniversalMeasure, dateTimeValue, decimalNumber, eighthPointMeasureValue, hexBinary, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, twipsMeasureValue, uCharHexNumber, universalMeasureValue, unsignedDecimalNumber };