@office-open/core 0.3.1 → 0.3.2

package/dist/_chunks/{index-3uVYzs32.d.mts → index-BV1I7g5r.d.mts}

@@ -64,6 +64,11 @@ declare abstract class XmlComponent extends BaseXmlComponent {
    * Prepares this component and its children for XML serialization.
    */
   prepForXml(context: IContext): IXmlableObject | undefined;
+  /**
+   * Direct XML serialization. Override in subclasses for zero-allocation output.
+   * Default falls back to prepForXml() + xml().
+   */
+  toXml(context: IContext): string;
   /**
    * @deprecated Internal use only.
    */
@@ -217,7 +222,10 @@ declare const convertToXmlComponent: (element: Element) => ImportedXmlComponent
  * XML component representing imported XML content.
  */
 declare class ImportedXmlComponent extends XmlComponent {
+  protected _sourceXml?: string;
   static fromXmlString(importedContent: string): ImportedXmlComponent;
+  get sourceXml(): string | undefined;
+  toXml(_context: IContext): string;
   constructor(rootKey: string, _attr?: any);
   push(xmlComponent: XmlComponent | string): void;
 }

package/dist/_chunks/{xml-components-DazgCiyL.mjs → xml-components-CN6syVNr.mjs}

@@ -1,5 +1,5 @@
 import { hpsMeasureValue } from "../values.mjs";
-import { xml2js } from "@office-open/xml";
+import { xml, xml2js } from "@office-open/xml";
 //#region src/xml-components/base.ts
 /**
 * Abstract base class for all XML components.
@@ -50,6 +50,14 @@ var XmlComponent = class extends BaseXmlComponent {
 		return { [this.rootKey]: children.length ? children.length === 1 && children[0] && typeof children[0] === "object" && "_attr" in children[0] ? children[0] : children : EMPTY_OBJECT };
 	}
 	/**
+	* Direct XML serialization. Override in subclasses for zero-allocation output.
+	* Default falls back to prepForXml() + xml().
+	*/
+	toXml(context) {
+		const obj = this.prepForXml(context);
+		return obj ? xml(obj) : "";
+	}
+	/**
 	* @deprecated Internal use only.
 	*/
 	addChildElement(child) {
@@ -320,9 +328,18 @@ var ImportedXmlComponentAttributes = class extends XmlAttributeComponent {};
 * XML component representing imported XML content.
 */
 var ImportedXmlComponent = class extends XmlComponent {
+	_sourceXml;
 	static fromXmlString(importedContent) {
 		const xmlObj = xml2js(importedContent, { compact: false });
-		return convertToXmlComponent(xmlObj.elements?.[0] ?? xmlObj);
+		const component = convertToXmlComponent(xmlObj.elements?.[0] ?? xmlObj);
+		component._sourceXml = importedContent;
+		return component;
+	}
+	get sourceXml() {
+		return this._sourceXml;
+	}
+	toXml(_context) {
+		return this._sourceXml ?? super.toXml(_context);
 	}
 	constructor(rootKey, _attr) {
 		super(rootKey);

package/dist/chart/index.d.mts

@@ -1,4 +1,4 @@
-import { O as XmlComponent } from "../_chunks/index-3uVYzs32.mjs";
+import { O as XmlComponent } from "../_chunks/index-BV1I7g5r.mjs";
 
 //#region src/chart/chart-collection.d.ts
 interface IChartData {
@@ -69,7 +69,7 @@ interface IChartTypeOptions {
   readonly series: readonly IChartSeriesData[];
   readonly categories: readonly string[];
 }
-declare const createChartType: (options: IChartTypeOptions) => BarChart | LineChart | PieChart | AreaChart | ScatterChart;
+declare const createChartType: (options: IChartTypeOptions) => ScatterChart | BarChart | LineChart | PieChart | AreaChart;
 //#endregion
 //#region src/chart/series/series-data.d.ts
 declare const createStrRef: (values: string | readonly string[]) => XmlComponent;

package/dist/chart/index.mjs

@@ -1,4 +1,4 @@
-import { T as XmlComponent, b as wrapEl, o as EmptyElement, p as chartAttr } from "../_chunks/xml-components-DazgCiyL.mjs";
+import { T as XmlComponent, b as wrapEl, o as EmptyElement, p as chartAttr } from "../_chunks/xml-components-CN6syVNr.mjs";
 //#region src/chart/chart-collection.ts
 var ChartCollection = class {
 	map;

package/dist/drawingml/index.d.mts

@@ -1,4 +1,4 @@
-import { O as XmlComponent, T as XmlAttributeComponent, a as BuilderElement } from "../_chunks/index-3uVYzs32.mjs";
+import { O as XmlComponent, T as XmlAttributeComponent, a as BuilderElement } from "../_chunks/index-BV1I7g5r.mjs";
 
 //#region src/drawingml/color/color-transform.d.ts
 /**

package/dist/drawingml/index.mjs

@@ -1,4 +1,4 @@
-import { S as XmlAttributeComponent, T as XmlComponent, a as BuilderElement } from "../_chunks/xml-components-DazgCiyL.mjs";
+import { S as XmlAttributeComponent, T as XmlComponent, a as BuilderElement } from "../_chunks/xml-components-CN6syVNr.mjs";
 import { d as convertPixelsToEmu, t as hashedId } from "../_chunks/id-generators-Ch07cHW1.mjs";
 //#region src/drawingml/color/color-transform.ts
 /**

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Relationship, elementToXml, findRel, findRelsByType, getImageType, listFiles, parseRels, readAllXmlParts, readBinaryFromZip, readTextFromZip, readXmlFromZip, uint8ToBase64, unzipToMap, zipToBuffer } from "./archive.mjs";
-import { A as IContext, C as AttributePayload, D as IgnoreIfEmptyXmlComponent, E as EMPTY_OBJECT, M as IXmlableObject, O as XmlComponent, S as AttributeMap, T as XmlAttributeComponent, _ as stringContainerObj, a as BuilderElement, b as wrapEl, c as NumberValueElement, d as StringEnumValueElement, f as StringValueElement, g as onOffObj, h as numberValObj, i as convertToXmlComponent, j as IXmlAttribute, k as BaseXmlComponent, l as OnOffElement, m as hpsMeasureObj, n as ImportedRootElementAttributes, o as EmptyElement, p as chartAttr, r as ImportedXmlComponent, s as HpsMeasureElement, t as InitializableXmlComponent, u as StringContainer, v as stringEnumValObj, w as NextAttributeComponent, x as AttributeData, y as stringValObj } from "./_chunks/index-3uVYzs32.mjs";
+import { A as IContext, C as AttributePayload, D as IgnoreIfEmptyXmlComponent, E as EMPTY_OBJECT, M as IXmlableObject, O as XmlComponent, S as AttributeMap, T as XmlAttributeComponent, _ as stringContainerObj, a as BuilderElement, b as wrapEl, c as NumberValueElement, d as StringEnumValueElement, f as StringValueElement, g as onOffObj, h as numberValObj, i as convertToXmlComponent, j as IXmlAttribute, k as BaseXmlComponent, l as OnOffElement, m as hpsMeasureObj, n as ImportedRootElementAttributes, o as EmptyElement, p as chartAttr, r as ImportedXmlComponent, s as HpsMeasureElement, t as InitializableXmlComponent, u as StringContainer, v as stringEnumValObj, w as NextAttributeComponent, x as AttributeData, y as stringValObj } from "./_chunks/index-BV1I7g5r.mjs";
 import { C as universalMeasureValue, S as uCharHexNumber, _ as positiveUniversalMeasureValue, a as ThemeColor, b as signedTwipsMeasureValue, c as dateTimeValue, d as hexColorValue, f as hpsMeasureValue, g as pointMeasureValue, h as percentageValue, i as RelativeMeasure, l as decimalNumber, m as measurementOrPercentValue, n as PositivePercentage, o as ThemeFont, p as longHexNumber, r as PositiveUniversalMeasure, s as UniversalMeasure, t as Percentage, u as eighthPointMeasureValue, v as shortHexNumber, w as unsignedDecimalNumber, x as twipsMeasureValue, y as signedHpsMeasureValue } from "./_chunks/values-BrGywpRh.mjs";
 import { COLOR_CATEGORIES, Connection, DataModel, ISmartArtData, ITreeNode, LAYOUT_CATEGORIES, Point, STYLE_CATEGORIES, SmartArtCollection, TransPoint, createDataModel } from "./smartart/index.mjs";
 import { Element } from "@office-open/xml";
@@ -108,6 +108,7 @@ declare class Relationships extends BaseXmlComponent {
  */
 declare class Formatter {
   format<T extends IContext = IContext>(input: BaseXmlComponent, context?: T): IXmlableObject;
+  formatToXml(input: XmlComponent, context: IContext, declaration?: boolean): string;
 }
 //#endregion
 //#region src/core-properties.d.ts
@@ -153,4 +154,28 @@ declare class RawPassthrough extends BaseXmlComponent {
   prepForXml(_context: IContext): IXmlableObject;
 }
 //#endregion
-export { AppProperties, AttributeData, AttributeMap, AttributePayload, BaseXmlComponent, BuilderElement, COLOR_CATEGORIES, Connection, CoreProperties, DataModel, EMPTY_OBJECT, EmptyElement, Formatter, HpsMeasureElement, IContext, ISmartArtData, ITreeNode, IXmlAttribute, IXmlableObject, IgnoreIfEmptyXmlComponent, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, LAYOUT_CATEGORIES, MixedChildren, NextAttributeComponent, NumberValueElement, OnOffElement, OutputByType, OutputType, Percentage, Point, PositivePercentage, PositiveUniversalMeasure, RawElement, RawPassthrough, Relationship, type RelationshipType, Relationships, RelativeMeasure, STYLE_CATEGORIES, SmartArtCollection, StringContainer, StringEnumValueElement, StringValueElement, TargetModeType, ThemeColor, ThemeFont, TransPoint, UniqueNumericIdCreator, UniversalMeasure, XmlAttributeComponent, XmlComponent, chartAttr, convertEmuToInches, convertEmuToPixels, convertEmuToPoints, convertInchesToEmu, convertInchesToTwip, convertMillimetersToTwip, convertPixelsToEmu, convertPointsToEmu, convertToXmlComponent, createDataModel, dateTimeValue, decimalNumber, eighthPointMeasureValue, elementToXml, findRel, findRelsByType, getImageType, hashedId, hexColorValue, hpsMeasureObj, hpsMeasureValue, isRaw, listFiles, longHexNumber, measurementOrPercentValue, numberValObj, onOffObj, parseCoreProperties, parseRels, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, readAllXmlParts, readBinaryFromZip, readTextFromZip, readXmlFromZip, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, stringContainerObj, stringEnumValObj, stringValObj, twipsMeasureValue, uCharHexNumber, uint8ToBase64, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber, unzipToMap, wrapEl, zipToBuffer };
+//#region src/placeholder.d.ts
+/**
+ * Placeholder detection utilities for compiler post-processing optimization.
+ *
+ * Both DOCX and PPTX compilers use placeholder tokens (e.g. `{chart:key}`)
+ * in XML strings to defer relationship ID assignment. This module provides
+ * fast pre-check utilities to avoid unnecessary regex scans when no placeholders exist.
+ */
+/**
+ * Check if an XML string contains any placeholder tokens.
+ * Uses a simple `{` character check which is O(n) but much cheaper
+ * than running multiple regex scans.
+ */
+declare function hasPlaceholders(xml: string): boolean;
+/**
+ * Collect all unique placeholder keys with a given prefix from an XML string.
+ * Single-pass scan using indexOf, avoiding RegExp overhead.
+ *
+ * @param xml - The XML string to scan
+ * @param prefix - The placeholder prefix (e.g. "chart:", "smartart:", "hlink:")
+ * @returns Array of unique keys found after the prefix
+ */
+declare function collectPlaceholderKeys(xml: string, prefix: string): string[];
+//#endregion
+export { AppProperties, AttributeData, AttributeMap, AttributePayload, BaseXmlComponent, BuilderElement, COLOR_CATEGORIES, Connection, CoreProperties, DataModel, EMPTY_OBJECT, EmptyElement, Formatter, HpsMeasureElement, IContext, ISmartArtData, ITreeNode, IXmlAttribute, IXmlableObject, IgnoreIfEmptyXmlComponent, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, LAYOUT_CATEGORIES, MixedChildren, NextAttributeComponent, NumberValueElement, OnOffElement, OutputByType, OutputType, Percentage, Point, PositivePercentage, PositiveUniversalMeasure, RawElement, RawPassthrough, Relationship, type RelationshipType, Relationships, RelativeMeasure, STYLE_CATEGORIES, SmartArtCollection, StringContainer, StringEnumValueElement, StringValueElement, TargetModeType, ThemeColor, ThemeFont, TransPoint, UniqueNumericIdCreator, UniversalMeasure, XmlAttributeComponent, XmlComponent, chartAttr, collectPlaceholderKeys, convertEmuToInches, convertEmuToPixels, convertEmuToPoints, convertInchesToEmu, convertInchesToTwip, convertMillimetersToTwip, convertPixelsToEmu, convertPointsToEmu, convertToXmlComponent, createDataModel, dateTimeValue, decimalNumber, eighthPointMeasureValue, elementToXml, findRel, findRelsByType, getImageType, hasPlaceholders, hashedId, hexColorValue, hpsMeasureObj, hpsMeasureValue, isRaw, listFiles, longHexNumber, measurementOrPercentValue, numberValObj, onOffObj, parseCoreProperties, parseRels, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, readAllXmlParts, readBinaryFromZip, readTextFromZip, readXmlFromZip, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, stringContainerObj, stringEnumValObj, stringValObj, twipsMeasureValue, uCharHexNumber, uint8ToBase64, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber, unzipToMap, wrapEl, zipToBuffer };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { C as EMPTY_OBJECT, E as BaseXmlComponent, S as XmlAttributeComponent, T as XmlComponent, _ as stringContainerObj, a as BuilderElement, b as wrapEl, c as NumberValueElement, d as StringEnumValueElement, f as StringValueElement, g as onOffObj, h as numberValObj, i as convertToXmlComponent, l as OnOffElement, m as hpsMeasureObj, n as ImportedRootElementAttributes, o as EmptyElement, p as chartAttr, r as ImportedXmlComponent, s as HpsMeasureElement, t as InitializableXmlComponent, u as StringContainer, v as stringEnumValObj, w as IgnoreIfEmptyXmlComponent, x as NextAttributeComponent, y as stringValObj } from "./_chunks/xml-components-DazgCiyL.mjs";
+import { C as EMPTY_OBJECT, E as BaseXmlComponent, S as XmlAttributeComponent, T as XmlComponent, _ as stringContainerObj, a as BuilderElement, b as wrapEl, c as NumberValueElement, d as StringEnumValueElement, f as StringValueElement, g as onOffObj, h as numberValObj, i as convertToXmlComponent, l as OnOffElement, m as hpsMeasureObj, n as ImportedRootElementAttributes, o as EmptyElement, p as chartAttr, r as ImportedXmlComponent, s as HpsMeasureElement, t as InitializableXmlComponent, u as StringContainer, v as stringEnumValObj, w as IgnoreIfEmptyXmlComponent, x as NextAttributeComponent, y as stringValObj } from "./_chunks/xml-components-CN6syVNr.mjs";
 import { ThemeColor, ThemeFont, dateTimeValue, decimalNumber, eighthPointMeasureValue, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, twipsMeasureValue, uCharHexNumber, universalMeasureValue, unsignedDecimalNumber } from "./values.mjs";
 import { a as convertEmuToInches, c as convertInchesToEmu, d as convertPixelsToEmu, f as convertPointsToEmu, i as uniqueUuid, l as convertInchesToTwip, n as uniqueId, o as convertEmuToPixels, r as uniqueNumericIdCreator, s as convertEmuToPoints, t as hashedId, u as convertMillimetersToTwip } from "./_chunks/id-generators-Ch07cHW1.mjs";
 import { COLOR_CATEGORIES, Connection, DataModel, LAYOUT_CATEGORIES, Point, STYLE_CATEGORIES, SmartArtCollection, TransPoint, createDataModel } from "./smartart/index.mjs";
@@ -57,6 +57,7 @@ var Relationships = class extends BaseXmlComponent {
 };
 //#endregion
 //#region src/formatter.ts
+const XML_DECL = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>";
 /**
 * Converts an XmlComponent tree into a serializable XML object.
 */
@@ -66,6 +67,10 @@ var Formatter = class {
 		if (output) return output;
 		throw new Error("XMLComponent did not format correctly");
 	}
+	formatToXml(input, context, declaration) {
+		const str = input.toXml(context);
+		return declaration ? XML_DECL + str : str;
+	}
 };
 //#endregion
 //#region src/core-properties.ts
@@ -157,4 +162,43 @@ var RawPassthrough = class extends BaseXmlComponent {
 	}
 };
 //#endregion
-export { AppProperties, BaseXmlComponent, BuilderElement, COLOR_CATEGORIES, Connection, DataModel, EMPTY_OBJECT, EmptyElement, Formatter, HpsMeasureElement, IgnoreIfEmptyXmlComponent, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, LAYOUT_CATEGORIES, NextAttributeComponent, NumberValueElement, OnOffElement, Point, RawPassthrough, Relationships, STYLE_CATEGORIES, SmartArtCollection, StringContainer, StringEnumValueElement, StringValueElement, TargetModeType, ThemeColor, ThemeFont, TransPoint, XmlAttributeComponent, XmlComponent, chartAttr, convertEmuToInches, convertEmuToPixels, convertEmuToPoints, convertInchesToEmu, convertInchesToTwip, convertMillimetersToTwip, convertPixelsToEmu, convertPointsToEmu, convertToXmlComponent, createDataModel, dateTimeValue, decimalNumber, eighthPointMeasureValue, elementToXml, findRel, findRelsByType, getImageType, hashedId, hexColorValue, hpsMeasureObj, hpsMeasureValue, isRaw, listFiles, longHexNumber, measurementOrPercentValue, numberValObj, onOffObj, parseCoreProperties, parseRels, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, readAllXmlParts, readBinaryFromZip, readTextFromZip, readXmlFromZip, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, stringContainerObj, stringEnumValObj, stringValObj, twipsMeasureValue, uCharHexNumber, uint8ToBase64, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber, unzipToMap, wrapEl, zipToBuffer };
+//#region src/placeholder.ts
+/**
+* Placeholder detection utilities for compiler post-processing optimization.
+*
+* Both DOCX and PPTX compilers use placeholder tokens (e.g. `{chart:key}`)
+* in XML strings to defer relationship ID assignment. This module provides
+* fast pre-check utilities to avoid unnecessary regex scans when no placeholders exist.
+*/
+/**
+* Check if an XML string contains any placeholder tokens.
+* Uses a simple `{` character check which is O(n) but much cheaper
+* than running multiple regex scans.
+*/
+function hasPlaceholders(xml) {
+	return xml.includes("{");
+}
+/**
+* Collect all unique placeholder keys with a given prefix from an XML string.
+* Single-pass scan using indexOf, avoiding RegExp overhead.
+*
+* @param xml - The XML string to scan
+* @param prefix - The placeholder prefix (e.g. "chart:", "smartart:", "hlink:")
+* @returns Array of unique keys found after the prefix
+*/
+function collectPlaceholderKeys(xml, prefix) {
+	const keys = [];
+	const search = `{${prefix}`;
+	let pos = 0;
+	while ((pos = xml.indexOf(search, pos)) !== -1) {
+		const keyStart = pos + search.length;
+		const keyEnd = xml.indexOf("}", keyStart);
+		if (keyEnd === -1) break;
+		const key = xml.substring(keyStart, keyEnd);
+		if (key.length > 0 && !keys.includes(key)) keys.push(key);
+		pos = keyEnd + 1;
+	}
+	return keys;
+}
+//#endregion
+export { AppProperties, BaseXmlComponent, BuilderElement, COLOR_CATEGORIES, Connection, DataModel, EMPTY_OBJECT, EmptyElement, Formatter, HpsMeasureElement, IgnoreIfEmptyXmlComponent, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, LAYOUT_CATEGORIES, NextAttributeComponent, NumberValueElement, OnOffElement, Point, RawPassthrough, Relationships, STYLE_CATEGORIES, SmartArtCollection, StringContainer, StringEnumValueElement, StringValueElement, TargetModeType, ThemeColor, ThemeFont, TransPoint, XmlAttributeComponent, XmlComponent, chartAttr, collectPlaceholderKeys, convertEmuToInches, convertEmuToPixels, convertEmuToPoints, convertInchesToEmu, convertInchesToTwip, convertMillimetersToTwip, convertPixelsToEmu, convertPointsToEmu, convertToXmlComponent, createDataModel, dateTimeValue, decimalNumber, eighthPointMeasureValue, elementToXml, findRel, findRelsByType, getImageType, hasPlaceholders, hashedId, hexColorValue, hpsMeasureObj, hpsMeasureValue, isRaw, listFiles, longHexNumber, measurementOrPercentValue, numberValObj, onOffObj, parseCoreProperties, parseRels, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, readAllXmlParts, readBinaryFromZip, readTextFromZip, readXmlFromZip, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, stringContainerObj, stringEnumValObj, stringValObj, twipsMeasureValue, uCharHexNumber, uint8ToBase64, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber, unzipToMap, wrapEl, zipToBuffer };

package/dist/smartart/index.d.mts

@@ -1,4 +1,4 @@
-import { O as XmlComponent } from "../_chunks/index-3uVYzs32.mjs";
+import { O as XmlComponent } from "../_chunks/index-BV1I7g5r.mjs";
 
 //#region src/smartart/categories.d.ts
 /** Layout ID → OOXML category type */

package/dist/smartart/index.mjs

@@ -1,4 +1,4 @@
-import { T as XmlComponent, p as chartAttr } from "../_chunks/xml-components-DazgCiyL.mjs";
+import { T as XmlComponent, p as chartAttr } from "../_chunks/xml-components-CN6syVNr.mjs";
 //#region src/smartart/categories.ts
 /** Layout ID → OOXML category type */
 const LAYOUT_CATEGORIES = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@office-open/core",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Shared OOXML infrastructure: XmlComponent, value validators, unit converters",
   "keywords": [
     "core",
@@ -59,7 +59,7 @@
     "fflate": "0.8.2",
     "hash.js": "1.1.7",
     "nanoid": "5.1.9",
-    "@office-open/xml": "0.3.1"
+    "@office-open/xml": "0.3.2"
   },
   "scripts": {
     "dev": "basis build --stub",