@office-open/core 0.12.1 → 0.12.3

package/README.md

@@ -85,10 +85,25 @@ gen(); // → 1, 2, 3, ...
 | `@office-open/core/util`       | Validators, converters, ID generators, mappings, crypto, base64           |
 | `@office-open/core/chart`      | Chart types, series data, chart collection, title                         |
 | `@office-open/core/smartart`   | SmartArt data model, tree-to-model, definitions                           |
-| `@office-open/core/drawingml`  | DrawingML fills, outlines, effects, geometry, text body                   |
+| `@office-open/core/drawing`    | DrawingML fills, outlines, effects, geometry, text body                   |
+| `@office-open/core/vector`     | Structured VML vocabulary (shapes, strokes, legacy anchors)               |
 | `@office-open/core/patch`      | Template patching utilities (replacer, traverser, token replacer)         |
 | `@office-open/core/theme`      | Theme definitions and color schemes                                       |
 
+## Documentation
+
+- [Documentation](https://www.office-open.com/en/core/) — guides, API reference, and examples
+- [Changelog](https://github.com/DemoMacro/office-open/releases) — release notes
+- [Report Issues](https://github.com/DemoMacro/office-open/issues) — bug reports and feature requests
+
+## Related Packages
+
+- [office-open](https://www.npmjs.com/package/office-open) — all formats + CLI + AI SDK tools in one install
+- [@office-open/docx](https://www.npmjs.com/package/@office-open/docx) — Word (.docx)
+- [@office-open/pptx](https://www.npmjs.com/package/@office-open/pptx) — PowerPoint (.pptx)
+- [@office-open/xlsx](https://www.npmjs.com/package/@office-open/xlsx) — Excel (.xlsx)
+- [@office-open/xml](https://www.npmjs.com/package/@office-open/xml) — XML parsing and serialization
+
 ## License
 
-- [MIT](LICENSE) © [Demo Macro](https://www.demomacro.com/)
+- [MIT](https://github.com/DemoMacro/office-open/blob/main/LICENSE) © [Demo Macro](https://www.demomacro.com/)

package/dist/chart/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as PivotSourceOptions, A as DataLabelOptions, B as ErrorValueType, C as ChartSeriesCommon, Ct as UserShapesOptions, D as ChartTitleOptions, Dt as ChartData, E as ChartStyle2010Options, Et as ChartCollection, F as DisplayBlanksAs, G as LegendPosition, H as LayoutMode, I as DisplayUnitsOptions, J as MarkerSymbol, K as ManualLayoutOptions, L as ErrorBarDirection, M as DataLabelsOptions, N as DataPointOptions, O as ChartType, P as DataTableOptions, Q as PictureOptionsOptions, R as ErrorBarOptions, S as ChartPivotFormatOptions, St as UserShapeShapeOptions, T as ChartSpaceOptions, Tt as userShapesDesc, U as LayoutTarget, V as ExternalDataOptions, W as LegendEntryOptions, X as PageSetupOrientation, Y as OfPieType, Z as PictureFormat, _ as ChartGrouping, _t as UserShapeGraphicFrameOptions, a as AxisLabelAlignment, at as SizeRepresents, b as ChartPageMarginsOptions, bt as UserShapeObjectOptions, c as AxisOrientation, ct as TimeUnit, d as AxisTickLabelPosition, dt as TrendlineType, et as PrintSettingsOptions, f as AxisTickMark, ft as View3DOptions, g as BuiltInDisplayUnit, gt as UserShapeExtentOptions, h as BubbleSeriesData, ht as UserShapeConnectorOptions, i as AxisKind, it as SecondaryChartGroupOptions, j as DataLabelPosition, k as ChartUserShapesOptions, l as AxisPosition, lt as TrendlineLabelOptions, m as BarShape, mt as RelativeSizeAnchorOptions, n as AxisCrossBetween, nt as RadarStyle, o as AxisNumberFormatOptions, ot as SplitType, p as BandFormatOptions, pt as AbsoluteSizeAnchorOptions, q as MarkerOptions, r as AxisCrosses, rt as ScatterSeriesData, s as AxisOptions, st as SurfaceOptions, t as chartSpaceDesc, tt as ProtectionOptions, u as AxisScalingOptions, ut as TrendlineOptions, v as ChartHeaderFooterOptions, vt as UserShapeGroupOptions, w as ChartSeriesData, wt as buildUserShapesData, x as ChartPageSetupOptions, xt as UserShapePictureOptions, y as ChartLinesOptions, yt as UserShapeMarkerOptions, z as ErrorBarType } from "../index-k1h_t946.mjs";
+import { $ as PivotSourceOptions, A as DataLabelOptions, B as ErrorValueType, C as ChartSeriesCommon, Ct as UserShapesOptions, D as ChartTitleOptions, Dt as ChartData, E as ChartStyle2010Options, Et as ChartCollection, F as DisplayBlanksAs, G as LegendPosition, H as LayoutMode, I as DisplayUnitsOptions, J as MarkerSymbol, K as ManualLayoutOptions, L as ErrorBarDirection, M as DataLabelsOptions, N as DataPointOptions, O as ChartType, P as DataTableOptions, Q as PictureOptionsOptions, R as ErrorBarOptions, S as ChartPivotFormatOptions, St as UserShapeShapeOptions, T as ChartSpaceOptions, Tt as userShapesDesc, U as LayoutTarget, V as ExternalDataOptions, W as LegendEntryOptions, X as PageSetupOrientation, Y as OfPieType, Z as PictureFormat, _ as ChartGrouping, _t as UserShapeGraphicFrameOptions, a as AxisLabelAlignment, at as SizeRepresents, b as ChartPageMarginsOptions, bt as UserShapeObjectOptions, c as AxisOrientation, ct as TimeUnit, d as AxisTickLabelPosition, dt as TrendlineType, et as PrintSettingsOptions, f as AxisTickMark, ft as View3DOptions, g as BuiltInDisplayUnit, gt as UserShapeExtentOptions, h as BubbleSeriesData, ht as UserShapeConnectorOptions, i as AxisKind, it as SecondaryChartGroupOptions, j as DataLabelPosition, k as ChartUserShapesOptions, l as AxisPosition, lt as TrendlineLabelOptions, m as BarShape, mt as RelativeSizeAnchorOptions, n as AxisCrossBetween, nt as RadarStyle, o as AxisNumberFormatOptions, ot as SplitType, p as BandFormatOptions, pt as AbsoluteSizeAnchorOptions, q as MarkerOptions, r as AxisCrosses, rt as ScatterSeriesData, s as AxisOptions, st as SurfaceOptions, t as chartSpaceDesc, tt as ProtectionOptions, u as AxisScalingOptions, ut as TrendlineOptions, v as ChartHeaderFooterOptions, vt as UserShapeGroupOptions, w as ChartSeriesData, wt as buildUserShapesData, x as ChartPageSetupOptions, xt as UserShapePictureOptions, y as ChartLinesOptions, yt as UserShapeMarkerOptions, z as ErrorBarType } from "../index-BwRtWyaP.mjs";
 export { AbsoluteSizeAnchorOptions, AxisCrossBetween, AxisCrosses, AxisKind, AxisLabelAlignment, AxisNumberFormatOptions, AxisOptions, AxisOrientation, AxisPosition, AxisScalingOptions, AxisTickLabelPosition, AxisTickMark, BandFormatOptions, BarShape, BubbleSeriesData, BuiltInDisplayUnit, ChartCollection, ChartData, ChartGrouping, ChartHeaderFooterOptions, ChartLinesOptions, ChartPageMarginsOptions, ChartPageSetupOptions, ChartPivotFormatOptions, ChartSeriesCommon, ChartSeriesData, ChartSpaceOptions, ChartStyle2010Options, ChartTitleOptions, ChartType, ChartUserShapesOptions, DataLabelOptions, DataLabelPosition, DataLabelsOptions, DataPointOptions, DataTableOptions, DisplayBlanksAs, DisplayUnitsOptions, ErrorBarDirection, ErrorBarOptions, ErrorBarType, ErrorValueType, ExternalDataOptions, LayoutMode, LayoutTarget, LegendEntryOptions, LegendPosition, ManualLayoutOptions, MarkerOptions, MarkerSymbol, OfPieType, PageSetupOrientation, PictureFormat, PictureOptionsOptions, PivotSourceOptions, PrintSettingsOptions, ProtectionOptions, RadarStyle, RelativeSizeAnchorOptions, ScatterSeriesData, SecondaryChartGroupOptions, SizeRepresents, SplitType, SurfaceOptions, TimeUnit, TrendlineLabelOptions, TrendlineOptions, TrendlineType, UserShapeConnectorOptions, UserShapeExtentOptions, UserShapeGraphicFrameOptions, UserShapeGroupOptions, UserShapeMarkerOptions, UserShapeObjectOptions, UserShapePictureOptions, UserShapeShapeOptions, UserShapesOptions, View3DOptions, buildUserShapesData, chartSpaceDesc, userShapesDesc };

package/dist/chart/index.mjs

@@ -1,2 +1,2 @@
-import { i as ChartCollection, n as userShapesDesc, r as chartSpaceDesc, t as buildUserShapesData } from "../chart-BAnjzVoe.mjs";
+import { i as ChartCollection, n as userShapesDesc, r as chartSpaceDesc, t as buildUserShapesData } from "../chart-DEIF3VZn.mjs";
 export { ChartCollection, buildUserShapesData, chartSpaceDesc, userShapesDesc };

package/dist/{chart-BAnjzVoe.mjs → chart-DEIF3VZn.mjs}

@@ -7,14 +7,18 @@ import { attr, children, escapeXml, findChild, findFirst, stringify, stringifyEl
 //#region src/chart/chart-collection.ts
 var ChartCollection = class {
 	map;
+	/** Cached `array` snapshot — invalidated on add. */
+	cachedArray;
 	constructor() {
 		this.map = /* @__PURE__ */ new Map();
 	}
 	addChart(key, chartData) {
 		this.map.set(key, chartData);
+		this.cachedArray = void 0;
 	}
 	get array() {
-		return [...this.map.values()];
+		if (this.cachedArray === void 0) this.cachedArray = [...this.map.values()];
+		return this.cachedArray;
 	}
 };
 //#endregion
@@ -124,23 +128,29 @@ function stringifyErrBars(opts) {
 	if (opts.value !== void 0) parts.push(valEl("c:val", opts.value));
 	return `<c:errBars>${parts.join("")}</c:errBars>`;
 }
+/** EG_DLblShared members — emitted identically by per-point c:dLbl and group c:dLbls. */
+function dataLabelSharedParts(opts, ctx) {
+	const parts = [];
+	if (opts.numberFormat !== void 0) parts.push(`<c:numFmt formatCode="${escapeXml(opts.numberFormat)}" sourceLinked="0"/>`);
+	parts.push(chartSpPr(opts.shapeProperties, ctx));
+	if (opts.textProperties) parts.push(`<c:txPr>${textBodyDesc.stringify(opts.textProperties, ctx) ?? ""}</c:txPr>`);
+	if (opts.position !== void 0) parts.push(valEl("c:dLblPos", xsdDataLabelPosition.to(opts.position)));
+	if (opts.showLegendKey !== void 0) parts.push(`<c:showLegendKey${boolVal(opts.showLegendKey)}/>`);
+	if (opts.showVal !== void 0) parts.push(`<c:showVal${boolVal(opts.showVal)}/>`);
+	if (opts.showCatName !== void 0) parts.push(`<c:showCatName${boolVal(opts.showCatName)}/>`);
+	if (opts.showSerName !== void 0) parts.push(`<c:showSerName${boolVal(opts.showSerName)}/>`);
+	if (opts.showPercent !== void 0) parts.push(`<c:showPercent${boolVal(opts.showPercent)}/>`);
+	if (opts.showBubbleSize !== void 0) parts.push(`<c:showBubbleSize${boolVal(opts.showBubbleSize)}/>`);
+	if (opts.separator !== void 0) parts.push(`<c:separator>${escapeXml(opts.separator)}</c:separator>`);
+	return parts;
+}
 function stringifyDataLabel(opts, ctx) {
 	if (opts.delete) return `<c:dLbl><c:idx val="${opts.index}"/><c:delete val="1"/></c:dLbl>`;
 	const inner = [];
 	if (opts.layout === true) inner.push("<c:layout/>");
 	else if (opts.layout) inner.push(stringifyLayout(opts.layout));
 	if (opts.text) inner.push(`<c:tx><c:rich>${textBodyDesc.stringify(opts.text, ctx) ?? ""}</c:rich></c:tx>`);
-	if (opts.numberFormat !== void 0) inner.push(`<c:numFmt formatCode="${escapeXml(opts.numberFormat)}" sourceLinked="0"/>`);
-	inner.push(chartSpPr(opts.shapeProperties, ctx));
-	if (opts.textProperties) inner.push(`<c:txPr>${textBodyDesc.stringify(opts.textProperties, ctx) ?? ""}</c:txPr>`);
-	if (opts.position !== void 0) inner.push(valEl("c:dLblPos", xsdDataLabelPosition.to(opts.position)));
-	if (opts.showLegendKey !== void 0) inner.push(`<c:showLegendKey${boolVal(opts.showLegendKey)}/>`);
-	if (opts.showVal !== void 0) inner.push(`<c:showVal${boolVal(opts.showVal)}/>`);
-	if (opts.showCatName !== void 0) inner.push(`<c:showCatName${boolVal(opts.showCatName)}/>`);
-	if (opts.showSerName !== void 0) inner.push(`<c:showSerName${boolVal(opts.showSerName)}/>`);
-	if (opts.showPercent !== void 0) inner.push(`<c:showPercent${boolVal(opts.showPercent)}/>`);
-	if (opts.showBubbleSize !== void 0) inner.push(`<c:showBubbleSize${boolVal(opts.showBubbleSize)}/>`);
-	if (opts.separator !== void 0) inner.push(`<c:separator>${escapeXml(opts.separator)}</c:separator>`);
+	inner.push(...dataLabelSharedParts(opts, ctx));
 	return `<c:dLbl><c:idx val="${opts.index}"/>${inner.join("")}</c:dLbl>`;
 }
 const DATA_LABELS_SHARED_KEYS = [
@@ -162,18 +172,7 @@ function stringifyDataLabels(opts, ctx) {
 	const head = opts.labels?.map((lbl) => stringifyDataLabel(lbl, ctx)).join("") ?? "";
 	const hasShared = DATA_LABELS_SHARED_KEYS.some((key) => opts[key] !== void 0);
 	if (opts.delete === true || opts.delete !== void 0 && !hasShared) return `<c:dLbls>${head}<c:delete val="${opts.delete ? 1 : 0}"/></c:dLbls>`;
-	const parts = [];
-	if (opts.numberFormat !== void 0) parts.push(`<c:numFmt formatCode="${escapeXml(opts.numberFormat)}" sourceLinked="0"/>`);
-	parts.push(chartSpPr(opts.shapeProperties, ctx));
-	if (opts.textProperties) parts.push(`<c:txPr>${textBodyDesc.stringify(opts.textProperties, ctx) ?? ""}</c:txPr>`);
-	if (opts.position !== void 0) parts.push(valEl("c:dLblPos", xsdDataLabelPosition.to(opts.position)));
-	if (opts.showLegendKey !== void 0) parts.push(`<c:showLegendKey${boolVal(opts.showLegendKey)}/>`);
-	if (opts.showVal !== void 0) parts.push(`<c:showVal${boolVal(opts.showVal)}/>`);
-	if (opts.showCatName !== void 0) parts.push(`<c:showCatName${boolVal(opts.showCatName)}/>`);
-	if (opts.showSerName !== void 0) parts.push(`<c:showSerName${boolVal(opts.showSerName)}/>`);
-	if (opts.showPercent !== void 0) parts.push(`<c:showPercent${boolVal(opts.showPercent)}/>`);
-	if (opts.showBubbleSize !== void 0) parts.push(`<c:showBubbleSize${boolVal(opts.showBubbleSize)}/>`);
-	if (opts.separator !== void 0) parts.push(`<c:separator>${escapeXml(opts.separator)}</c:separator>`);
+	const parts = dataLabelSharedParts(opts, ctx);
 	if (opts.showLeaderLines !== void 0) parts.push(`<c:showLeaderLines${boolVal(opts.showLeaderLines)}/>`);
 	if (opts.leaderLines) parts.push(emptyEl("c:leaderLines"));
 	return `<c:dLbls>${head}${parts.join("")}</c:dLbls>`;
@@ -309,10 +308,6 @@ function stringifyMultiLvlStrRef(levels, formula) {
 	}).join("");
 	return `<c:multiLvlStrRef>${refFormula(formula)}<c:multiLvlStrCache><c:ptCount ${attrVal("val", ptCount)}/>${lvls}</c:multiLvlStrCache></c:multiLvlStrRef>`;
 }
-function stringifyNumCatRef(values, formula, formatCode) {
-	const pts = values.map((v, i) => `<c:pt idx="${i}"><c:v>${escapeXml(v)}</c:v></c:pt>`).join("");
-	return `<c:numRef>${refFormula(formula)}<c:numCache><c:formatCode>${escapeXml(formatCode ?? "General")}</c:formatCode><c:ptCount ${attrVal("val", values.length)}/>${pts}</c:numCache></c:numRef>`;
-}
 /** Whether the chart carries category-source data (c:cat is optional in CT_Ser). */
 function hasCategoryData(opts) {
 	return opts.categories !== void 0 || opts.categoryLabels !== void 0 || opts.multiLevelCategories !== void 0 || opts.numericCategories === true;
@@ -320,11 +315,11 @@ function hasCategoryData(opts) {
 function stringifyCategorySource(opts) {
 	if (opts.multiLevelCategories) return stringifyMultiLvlStrRef(opts.multiLevelCategories, opts.categoryFormula);
 	if (opts.categoryLabels) return stringifyStrLit(opts.categoryLabels);
-	if (opts.numericCategories) return stringifyNumCatRef(opts.categories ?? [], opts.categoryFormula, opts.categoryFormatCode);
+	if (opts.numericCategories) return stringifyNumRef(opts.categories ?? [], opts.categoryFormula, opts.categoryFormatCode);
 	return stringifyStrRef(opts.categories ?? [], opts.categoryFormula);
 }
 function stringifyNumRef(values, formula, formatCode) {
-	const pts = values.map((v, i) => `<c:pt idx="${i}"><c:v>${v}</c:v></c:pt>`).join("");
+	const pts = values.map((v, i) => `<c:pt idx="${i}"><c:v>${typeof v === "number" ? v : escapeXml(v)}</c:v></c:pt>`).join("");
 	return `<c:numRef>${refFormula(formula)}<c:numCache><c:formatCode>${escapeXml(formatCode ?? "General")}</c:formatCode><c:ptCount ${attrVal("val", values.length)}/>${pts}</c:numCache></c:numRef>`;
 }
 function stringifyNumLitList(values, formatCode) {
@@ -350,11 +345,11 @@ function stringifyDataTable(opts, ctx) {
 }
 function stringifyProtection(opts) {
 	const parts = [];
-	if (opts.chartObject !== void 0) parts.push(`<c:chartObject val="${opts.chartObject ? 1 : 0}"/>`);
-	if (opts.data !== void 0) parts.push(`<c:data val="${opts.data ? 1 : 0}"/>`);
-	if (opts.formatting !== void 0) parts.push(`<c:formatting val="${opts.formatting ? 1 : 0}"/>`);
-	if (opts.selection !== void 0) parts.push(`<c:selection val="${opts.selection ? 1 : 0}"/>`);
-	if (opts.userInterface !== void 0) parts.push(`<c:userInterface val="${opts.userInterface ? 1 : 0}"/>`);
+	if (opts.chartObject !== void 0) parts.push(`<c:chartObject${boolVal(opts.chartObject)}/>`);
+	if (opts.data !== void 0) parts.push(`<c:data${boolVal(opts.data)}/>`);
+	if (opts.formatting !== void 0) parts.push(`<c:formatting${boolVal(opts.formatting)}/>`);
+	if (opts.selection !== void 0) parts.push(`<c:selection${boolVal(opts.selection)}/>`);
+	if (opts.userInterface !== void 0) parts.push(`<c:userInterface${boolVal(opts.userInterface)}/>`);
 	return `<c:protection>${parts.join("")}</c:protection>`;
 }
 function stringifyExternalData(opts) {
@@ -561,10 +556,10 @@ function stringifySeries(index, series, opts, ctx, groupType) {
 			parts.push(`<c:xVal>${stringifyCategorySource(opts)}</c:xVal>`);
 			parts.push(`<c:yVal>${stringifyNumRef(s.values, s.valueFormula, s.formatCode)}</c:yVal>`);
 		}
-	} else if (hasCategoryData(opts)) {
-		parts.push(`<c:cat>${stringifyCategorySource(opts)}</c:cat>`);
+	} else {
+		if (hasCategoryData(opts)) parts.push(`<c:cat>${stringifyCategorySource(opts)}</c:cat>`);
 		parts.push(`<c:val>${s.valueLiteral ? stringifyNumLitList(s.values, s.formatCode) : stringifyNumRef(s.values, s.valueFormula, s.formatCode)}</c:val>`);
-	} else parts.push(`<c:val>${s.valueLiteral ? stringifyNumLitList(s.values, s.formatCode) : stringifyNumRef(s.values, s.valueFormula, s.formatCode)}</c:val>`);
+	}
 	if ((chartType === "line" || chartType === "scatter") && s.smooth !== void 0) parts.push(`<c:smooth${boolVal(s.smooth)}/>`);
 	if ((chartType === "column" || chartType === "bar") && s.shape !== void 0) parts.push(valEl("c:shape", s.shape));
 	if (chartType === "bubble" && s.bubble3D !== void 0) parts.push(`<c:bubble3D${boolVal(s.bubble3D)}/>`);
@@ -691,16 +686,14 @@ function stringifySecondaryGroup(g, opts, ctx) {
 	return `${parts.join("")}</${CHART_TYPE_TAGS[g.type]}>`;
 }
 function stringifyTitle(title, ctx) {
-	if (typeof title !== "string") {
-		const parts = [];
-		if (title.text !== void 0) parts.push(typeof title.text === "string" ? `<c:tx><c:rich><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>${escapeXml(title.text)}</a:t></a:r></a:p></c:rich></c:tx>` : `<c:tx><c:rich>${textBodyDesc.stringify(title.text, ctx) ?? ""}</c:rich></c:tx>`);
-		if (title.layout !== void 0) parts.push(title.layout === true ? "<c:layout/>" : stringifyLayout(title.layout));
-		if (title.overlay !== void 0) parts.push(`<c:overlay${boolVal(title.overlay)}/>`);
-		if (title.shapeProperties) parts.push(chartSpPr(title.shapeProperties, ctx));
-		if (title.textProperties) parts.push(`<c:txPr>${textBodyDesc.stringify(title.textProperties, ctx) ?? ""}</c:txPr>`);
-		return `<c:title>${parts.join("")}</c:title>`;
-	}
-	return `<c:title><c:tx><c:rich><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>${escapeXml(title)}</a:t></a:r></a:p></c:rich></c:tx></c:title>`;
+	const opts = typeof title === "string" ? { text: title } : title;
+	const parts = [];
+	if (opts.text !== void 0) parts.push(typeof opts.text === "string" ? `<c:tx><c:rich><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>${escapeXml(opts.text)}</a:t></a:r></a:p></c:rich></c:tx>` : `<c:tx><c:rich>${textBodyDesc.stringify(opts.text, ctx) ?? ""}</c:rich></c:tx>`);
+	if (opts.layout !== void 0) parts.push(opts.layout === true ? "<c:layout/>" : stringifyLayout(opts.layout));
+	if (opts.overlay !== void 0) parts.push(`<c:overlay${boolVal(opts.overlay)}/>`);
+	if (opts.shapeProperties) parts.push(chartSpPr(opts.shapeProperties, ctx));
+	if (opts.textProperties) parts.push(`<c:txPr>${textBodyDesc.stringify(opts.textProperties, ctx) ?? ""}</c:txPr>`);
+	return `<c:title>${parts.join("")}</c:title>`;
 }
 function stringifyLegendEntry(entry, ctx) {
 	if (entry.delete) return `<c:legendEntry><c:idx val="${entry.index}"/><c:delete val="1"/></c:legendEntry>`;
@@ -2351,4 +2344,4 @@ function buildUserShapesData(userShapes) {
 //#endregion
 export { ChartCollection as i, userShapesDesc as n, chartSpaceDesc as r, buildUserShapesData as t };
 
-//# sourceMappingURL=chart-BAnjzVoe.mjs.map
+//# sourceMappingURL=chart-DEIF3VZn.mjs.map