ooxml-core 1.24.2 → 1.25.0

package/dist/chart/ex/parse-util.d.ts

@@ -0,0 +1,36 @@
+import { type XmlElement } from '../../xml/index.js';
+import type { ChartLines, ChartNumberFormat, ChartShapeProperties, ChartTextBody } from '../model-series.js';
+import { type ChartParseContext } from '../parse-util.js';
+import type { ChartExAutoNumber, ChartExFormula } from './model.js';
+export { attribute, assignDefined, type ChartParseContext } from '../parse-util.js';
+/** The first chartex-namespace child (lenient: un-namespaced test XML matches too). */
+export declare const cxChild: (parent: ParentNode | null | undefined, local: string) => Element | undefined;
+/** Every chartex-namespace child named `local`. */
+export declare const cxChildren: (parent: ParentNode | null | undefined, local: string) => Element[];
+/** An `xsd:boolean` attribute; malformed values are reported and dropped. */
+export declare function boolAttribute(context: ChartParseContext, element: XmlElement | undefined, name: string): boolean | undefined;
+/** A numeric attribute; malformed values are reported and dropped. */
+export declare function numberAttribute(context: ChartParseContext, element: XmlElement | undefined, name: string): number | undefined;
+/** A non-negative integer attribute (`@idx`, `@id`); other values are reported and dropped. */
+export declare function indexAttribute(context: ChartParseContext, element: XmlElement | undefined, name: string): number | undefined;
+/** A double-or-`auto` attribute (`@gapWidth`, `@min`, `@underflow`...). */
+export declare function autoNumberAttribute(context: ChartParseContext, element: XmlElement | undefined, name: string): ChartExAutoNumber | undefined;
+/** `@val` of the chartex child `local`, as a number. */
+export declare const valNumber: (context: ChartParseContext, parent: XmlElement | undefined, local: string) => number | undefined;
+/** Reports every child of `element` whose local name is not in `handled`. */
+export declare function reportUnmodelled(context: ChartParseContext, element: XmlElement, handled: ReadonlySet<string>): void;
+/** A chartex child serialised as written (extension lists, caches), for round-trip. */
+export declare function rawChild(parent: XmlElement | undefined, local: string): string | undefined;
+/** `cx:extLst` as written. */
+export declare const extensionList: (parent: XmlElement | undefined) => string | undefined;
+/** `cx:spPr` through the `drawingml` fill, line and effect readers; present for an empty element. */
+export declare function shapeProperties(parent: XmlElement | undefined): ChartShapeProperties | undefined;
+/** `cx:txPr` as a DrawingML text body. */
+export declare const textProperties: (parent: XmlElement | undefined) => ChartTextBody | undefined;
+/** Gridlines (`cx:majorGridlines`): present when written, with their shape. */
+export declare function lines(parent: XmlElement | undefined, local: string): ChartLines | undefined;
+/** `cx:numFmt`. */
+export declare function numberFormat(parent: XmlElement | undefined): ChartNumberFormat | undefined;
+/** A formula element (`cx:f`, `cx:nf`). */
+export declare function formula(parent: XmlElement | undefined, local: string): ChartExFormula | undefined;
+//# sourceMappingURL=parse-util.d.ts.map

package/dist/chart/ex/parse-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-util.d.ts","sourceRoot":"","sources":["../../../chart/ex/parse-util.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,KAAK,EACX,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAA6C,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElG,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEjF,uFAAuF;AACvF,eAAO,MAAM,OAAO,WAAY,UAAU,GAAG,IAAI,GAAG,SAAS,SAAS,MAAM,wBAChD,CAAC;AAE7B,mDAAmD;AACnD,eAAO,MAAM,UAAU,WAAY,UAAU,GAAG,IAAI,GAAG,SAAS,SAAS,MAAM,cACG,CAAC;AAcnF,6EAA6E;AAC7E,wBAAgB,aAAa,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACV,OAAO,GAAG,SAAS,CAQrB;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAOpB;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAC7B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAKpB;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACV,iBAAiB,GAAG,SAAS,CAI/B;AAED,wDAAwD;AACxD,eAAO,MAAM,SAAS,YACZ,iBAAiB,UAClB,UAAU,GAAG,SAAS,SACvB,MAAM,KACX,MAAM,GAAG,SAAoE,CAAC;AAEjF,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC1B,IAAI,CAQN;AAED,uFAAuF;AACvF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1F;AAED,8BAA8B;AAC9B,eAAO,MAAM,aAAa,WAAY,UAAU,GAAG,SAAS,uBAA+B,CAAC;AAE5F,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,oBAAoB,GAAG,SAAS,CAOhG;AAED,0CAA0C;AAC1C,eAAO,MAAM,cAAc,WAAY,UAAU,GAAG,SAAS,KAAG,aAAa,GAAG,SACzC,CAAC;AAExC,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAK3F;AAED,mBAAmB;AACnB,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAU1F;AAED,2CAA2C;AAC3C,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAOjG"}

package/dist/chart/ex/parse.d.ts

@@ -0,0 +1,10 @@
+import { type XmlElement } from '../../xml/index.js';
+import type { ChartExSpaceParseResult } from './model.js';
+/** Whether a part root is an extended chart (`cx:chartSpace`). */
+export declare const isChartExRoot: (root: XmlElement) => boolean;
+/**
+ * Parses an extended chart part (`cx:chartSpace`) from its XML text or root element. Anything the
+ * model does not cover is listed in `issues`; the caller keeps the part itself for round-trip.
+ */
+export declare function parseChartExSpace(source: string | XmlElement): ChartExSpaceParseResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/chart/ex/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../chart/ex/parse.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAiC,uBAAuB,EAAE,MAAM,SAAS,CAAC;AA8DtF,kEAAkE;AAClE,eAAO,MAAM,aAAa,SAAU,UAAU,KAAG,OACc,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,uBAAuB,CA0CtF"}

package/dist/chart/ex/write-series.d.ts

@@ -0,0 +1,13 @@
+import type { ChartExAxis, ChartExChartData, ChartExSeries, ChartExText, ChartExTitle } from './model.js';
+import { type ChartWriteContext } from './write-util.js';
+/** `cx:chartData`. */
+export declare function chartDataXml(context: ChartWriteContext, chartData: ChartExChartData): string;
+/** `cx:tx`. */
+export declare function textXml(context: ChartWriteContext, text: ChartExText | undefined): string;
+/** A title (`cx:title`, `cx:unitsLabel` with `local`). */
+export declare function titleXml(context: ChartWriteContext, title: ChartExTitle | undefined, local?: string): string;
+/** `cx:series`. */
+export declare function seriesXml(context: ChartWriteContext, series: ChartExSeries): string;
+/** `cx:axis`. */
+export declare function axisXml(context: ChartWriteContext, axis: ChartExAxis): string;
+//# sourceMappingURL=write-series.d.ts.map

package/dist/chart/ex/write-series.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-series.d.ts","sourceRoot":"","sources":["../../../chart/ex/write-series.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,WAAW,EAEX,gBAAgB,EAKhB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAUN,KAAK,iBAAiB,EACtB,MAAM,cAAc,CAAC;AAiCtB,sBAAsB;AACtB,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAgB5F;AAED,eAAe;AACf,wBAAgB,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAOzF;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CACvB,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,KAAK,SAAU,GACb,MAAM,CAcR;AA4GD,mBAAmB;AACnB,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAgCnF;AAqBD,iBAAiB;AACjB,wBAAgB,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CA6B7E"}

package/dist/chart/ex/write-util.d.ts

@@ -0,0 +1,23 @@
+import type { ChartNumberFormat, ChartShapeProperties, ChartTextBody } from '../model-series.js';
+import { type ChartWriteContext } from '../write-util.js';
+import type { ChartExFormula } from './model.js';
+export { raw, type ChartWriteContext } from '../write-util.js';
+/** An attribute value: booleans as `1`/`0`, numbers canonical, `auto` and text as written. */
+export type AttributeValue = string | number | boolean | undefined;
+/** ` name="value"` for every defined entry, in the order given (the schema's). */
+export declare function attributes(entries: [string, AttributeValue][]): string;
+/** `<cx:local attrs>content</cx:local>`, or the empty element when there is no content. */
+export declare const cxElement: (local: string, content?: string, attrs?: string) => string;
+/** `<cx:local>text</cx:local>` with the text escaped, for a defined value. */
+export declare const cxText: (local: string, text: string | undefined, attrs?: string) => string;
+/** `<cx:local val="..."/>` for a defined value. */
+export declare const cxVal: (local: string, value: AttributeValue) => string;
+/** A formula element (`cx:f`, `cx:nf`). */
+export declare const formulaXml: (local: string, formula: ChartExFormula | undefined) => string;
+/** `cx:spPr`. */
+export declare const shapeXml: (context: ChartWriteContext, shape: ChartShapeProperties | undefined) => string;
+/** `cx:txPr`, or `cx:rich` with `local`. */
+export declare const textBodyXml: (context: ChartWriteContext, body: ChartTextBody | undefined, local?: string) => string;
+/** `cx:numFmt`. */
+export declare function numberFormatXml(format: ChartNumberFormat | undefined): string;
+//# sourceMappingURL=write-util.d.ts.map

package/dist/chart/ex/write-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-util.d.ts","sourceRoot":"","sources":["../../../chart/ex/write-util.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9F,OAAO,EAA4C,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAE,GAAG,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5D,8FAA8F;AAC9F,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnE,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,MAAM,CAetE;AAED,2FAA2F;AAC3F,eAAO,MAAM,SAAS,UAAW,MAAM,uCAA6B,MACiB,CAAC;AAEtF,8EAA8E;AAC9E,eAAO,MAAM,MAAM,UAAW,MAAM,QAAQ,MAAM,GAAG,SAAS,qBAAe,MACM,CAAC;AAEpF,mDAAmD;AACnD,eAAO,MAAM,KAAK,UAAW,MAAM,SAAS,cAAc,KAAG,MACc,CAAC;AAE5E,2CAA2C;AAC3C,eAAO,MAAM,UAAU,UAAW,MAAM,WAAW,cAAc,GAAG,SAAS,KAAG,MACQ,CAAC;AAEzF,iBAAiB;AACjB,eAAO,MAAM,QAAQ,YAAa,iBAAiB,SAAS,oBAAoB,GAAG,SAAS,WACpB,CAAC;AAEzE,4CAA4C;AAC5C,eAAO,MAAM,WAAW,YACd,iBAAiB,QACpB,aAAa,GAAG,SAAS,qBAE7B,MAAyE,CAAC;AAE7E,mBAAmB;AACnB,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAU7E"}

package/dist/chart/ex/write.d.ts

@@ -0,0 +1,24 @@
+import type { ChartExSpace } from './model.js';
+/** Options of {@link writeChartExSpace}. */
+export interface WriteChartExSpaceOptions {
+    /** What follows the XML declaration: Office writes nothing in chartex parts (the default). */
+    declarationBreak?: '' | '\n' | '\r\n';
+    /**
+     * Write empty elements as `<cx:x />` (with a space), as the .NET producers behind Word's and
+     * Excel's chartex parts do; the default is `<cx:x/>`.
+     */
+    emptyElementSpace?: boolean;
+}
+/** The declarations a chartex root makes when the model carries none. */
+export declare const CHART_EX_ROOT_DECLARATIONS: readonly {
+    prefix: string;
+    uri: string;
+}[];
+/** The writer options that reproduce how `xml` was written (declaration break, empty elements). */
+export declare function chartExWriteOptionsOf(xml: string): WriteChartExSpaceOptions;
+/**
+ * Writes an extended chart part (`cx:chartSpace`) from the neutral model. The root declares the
+ * model's namespaces in their order, plus `cx`, `a` and `r` (and `c` for user shapes) when missing.
+ */
+export declare function writeChartExSpace(space: ChartExSpace, options?: WriteChartExSpaceOptions): string;
+//# sourceMappingURL=write.d.ts.map

package/dist/chart/ex/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../chart/ex/write.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI5C,4CAA4C;AAC5C,MAAM,WAAW,wBAAwB;IACxC,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC;IACtC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAID,yEAAyE;AACzE,eAAO,MAAM,0BAA0B,EAAE,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAIhF,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAG3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,wBAA6B,GACpC,MAAM,CAkER"}