ooxml-ui 0.30.1 → 1.0.0

package/dist/pptx/render/chart-text-defaults.d.ts

@@ -0,0 +1,21 @@
+/**
+ * chart-text-defaults.ts: resolves chart text styles field by field, starting
+ * from the chart-wide style (`c:chartSpace/c:txPr` over the theme's minor
+ * fonts, `PptxChartStyle.textStyle`).
+ *
+ * PowerPoint draws any chart text whose own `txPr` leaves a field unset with
+ * the value from the next level up, ending at the chart-wide style. Core keeps
+ * each level as authored, so a save never copies one level into another; the
+ * cascade is applied here, on what the view-model is built from.
+ *
+ * @module chart-text-defaults
+ */
+import type { PptxChartData, PptxChartLegendTextStyle } from 'ooxml-core/pptx';
+/**
+ * Merge `levels` (outermost first) over the chart-wide text style, field by
+ * field. Returns `undefined` when no level sets anything.
+ */
+export declare function resolveChartTextStyle(chartData: PptxChartData | undefined, ...levels: ReadonlyArray<PptxChartLegendTextStyle | undefined>): PptxChartLegendTextStyle | undefined;
+/** `chartData` with each axis's text resolved through the chart-wide style. */
+export declare function withChartTextDefaults(chartData: PptxChartData): PptxChartData;
+//# sourceMappingURL=chart-text-defaults.d.ts.map

package/dist/pptx/render/chart-text-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-text-defaults.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-text-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAI/E;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,aAAa,GAAG,SAAS,EACpC,GAAG,MAAM,EAAE,aAAa,CAAC,wBAAwB,GAAG,SAAS,CAAC,GAC5D,wBAAwB,GAAG,SAAS,CAUtC;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,CAyB7E"}

package/dist/pptx/render/chart-title-band.d.ts

@@ -0,0 +1,68 @@
+/**
+ * chart-title-band.ts: where a chart's title sits and how much room it takes
+ * at the top of the chart, derived from the title's own font size.
+ *
+ * Every chart family used to reserve a fixed 20 px band for the title and
+ * draw its baseline at y=12..14, which fits the viewer's 12 px default but
+ * clips anything larger: PowerPoint's own default title is 14 pt (18.67 px),
+ * and an 18 pt title lost its top to the chart's SVG edge, in 2D and in the
+ * 3D chrome overlay alike.
+ *
+ * PowerPoint lays the title out as a text box whose top sits a fixed inset
+ * below the chart area's top (about 7.2 pt of chart-area padding plus the
+ * title's own 3.6 pt text inset), so its first baseline is that inset plus
+ * the font's ascent. For a 14 pt title that puts the baseline 24 pt below the
+ * chart top, matching `gt/chart-01`'s measured title baseline (the
+ * oblique-3D chrome's `OBLIQUE_TITLE_BASELINE`). The plot area then starts
+ * below the title box, after the same 8 px inset the layout keeps at every
+ * other edge.
+ *
+ * `chartTitleBand` is the pure decision; `chartTitleBandFor` resolves the
+ * title font for a chart and returns `undefined` for a chart without a title
+ * (whose layout is unchanged); `withChartTitleBand` is the view-model
+ * post-pass that moves the title baseline and a top legend to match.
+ *
+ * @module chart-title-band
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type { ChartViewModel } from './chart-view-model-types.js';
+/** Chart-area padding (7.2 pt) plus the title box's top text inset (3.6 pt), in px. */
+export declare const CHART_TITLE_TOP_INSET_PX: number;
+/** The fixed title reservation every layout used before the band was font-sized. */
+export declare const LEGACY_CHART_TITLE_BAND_PX = 20;
+/** Where the title's first baseline sits and how far down its band reaches. */
+export interface ChartTitleBand {
+    /** The first line's baseline (`vm.titleY`), in px below the chart top. */
+    baselineY: number;
+    /**
+     * The title box's bottom edge, in px below the chart top. Layouts add this
+     * to their 8 px top inset, so the plot starts 8 px below the title box.
+     */
+    bandHeight: number;
+}
+/**
+ * The title band for a title drawn at `fontSizePx` over `lines` lines.
+ * Pure. Non-finite or non-positive inputs fall back to a single 12 px line.
+ */
+export declare function chartTitleBand(fontSizePx: number, lines?: number): ChartTitleBand;
+/** The largest font size the title draws with: its base style or any larger run. */
+export declare function chartTitleFontPx(chartData: PptxChartData | undefined): number;
+/**
+ * The title band for `chartData`, or `undefined` when the chart shows no
+ * title (`style.hasTitle` off), so a title-less chart's layout is untouched.
+ * The title renders as one SVG `<text>` line, so the band is one line tall.
+ */
+export declare function chartTitleBandFor(chartData: PptxChartData | undefined): ChartTitleBand | undefined;
+/**
+ * The height a layout reserves above its plot for the title: the band's
+ * height, or 0 without a title. Replaces the fixed `hasTitle ? 20 : 0`.
+ */
+export declare function chartTitleReservePx(chartData: PptxChartData | undefined): number;
+/**
+ * Put a finished view-model's title on the font-sized baseline, and move a
+ * top (`'t'`) legend down by however much the band grew past the legacy
+ * 20 px reservation, so it stays between the title and the plot. A chart
+ * without a title, or a view-model without one, is returned unchanged.
+ */
+export declare function withChartTitleBand(vm: ChartViewModel, chartData: PptxChartData): ChartViewModel;
+//# sourceMappingURL=chart-title-band.d.ts.map

package/dist/pptx/render/chart-title-band.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-title-band.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-title-band.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,QAAyB,CAAC;AAS/D,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC9B,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,cAAc,CAS5E;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,aAAa,GAAG,SAAS,GAClC,cAAc,GAAG,SAAS,CAK5B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,GAAG,cAAc,CAY/F"}

package/dist/pptx/render/chart-title-runs.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Chart title rich text: per-run render spans and the flat-text-edit
+ * collapse rule.
+ *
+ * `PptxChartData.titleRuns` (core) carries the title's per-run bold/italic/
+ * size/colour, parsed from `c:title/c:tx/c:rich`; until this module, no
+ * binding read it, so a title with several differently-styled runs rendered
+ * (and re-saved) as one flat string in a single style. `resolveChartTitleRunSpans`
+ * gives every binding a framework-neutral list of `<tspan>` descriptors to
+ * draw instead of the single flat `vm.title` text node.
+ * `collapseChartTitleRunsForEdit` is the companion write-side rule: when an
+ * inspector's flat title-text field is edited, a MULTI-run body collapses to
+ * ONE run in the title's dominant style (the run covering most of the
+ * text), rather than leaving other runs' stale text behind - see
+ * `chart-title-serializer.ts`'s `runsStale` doc for why an edited `title`
+ * and an untouched `titleRuns` must not silently disagree. A single-run
+ * title is left to the flat `title` patch alone: core's serializer already
+ * patches that one run's text in place, preserving whatever formatting this
+ * narrow typed model does not carry (e.g. a `schemeClr` reference).
+ *
+ * @module chart-title-runs
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+/** One resolved `<tspan>` for a chart title run. */
+export interface ChartTitleRunSpan {
+    /** This run's text (`a:t`). */
+    text: string;
+    /** `font-size`, in slide-px. */
+    fontSize: number;
+    /** `font-weight`. */
+    fontWeight: number;
+    /** `font-style`, only when the run is italic. */
+    fontStyle?: 'italic';
+    /** `fill`. */
+    fill: string;
+    /** `font-family`, only when the title names a typeface. */
+    fontFamily?: string;
+}
+/**
+ * Resolve `chartData.titleRuns` into per-run SVG `<tspan>` descriptors, each
+ * run's own bold/italic/size/colour falling back to the title's cascade
+ * (`resolveChartTitleTextStyle`) for whatever it does not override.
+ *
+ * Returns `undefined` when the title has no typed runs at all (an auto/plain
+ * title, or one authored as a linked-cell reference), so a binding should
+ * keep rendering the flat `vm.title` in `vm.titleStyle` unchanged. A single
+ * run still resolves to a one-element array: this lets a per-run override
+ * (e.g. italic on the title's only run) render even when
+ * `resolveChartTitleTextStyle`'s coarser `chartData.style.titleFont*` cascade
+ * does not carry it. Its text follows the flat title so single-run edits
+ * render immediately while core retains the original run for lossless save.
+ */
+export declare function resolveChartTitleRunSpans(chartData: PptxChartData | undefined): ChartTitleRunSpan[] | undefined;
+/**
+ * Compute the `{ title, titleRuns }` patch for an inspector's flat title-text
+ * field being edited to `newText`. Every binding's chart title input should
+ * call this instead of patching `title` alone.
+ *
+ * A title with zero or one run just gets the new flat text (`titleRuns`
+ * untouched, letting core's single-run patch path preserve that run's full
+ * authored formatting). A title with two or more runs collapses to ONE run
+ * carrying `newText` in the dominant style, so the edit does not leave a
+ * second, now-stale run's text trailing the new title.
+ */
+export declare function collapseChartTitleRunsForEdit(chartData: PptxChartData | undefined, newText: string): Pick<PptxChartData, 'title' | 'titleRuns'>;
+//# sourceMappingURL=chart-title-runs.d.ts.map

package/dist/pptx/render/chart-title-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-title-runs.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-title-runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,iBAAiB,CAAC;AAKxE,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IACjC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,aAAa,GAAG,SAAS,GAClC,iBAAiB,EAAE,GAAG,SAAS,CAcjC;AAuBD;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC5C,SAAS,EAAE,aAAa,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,GACb,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,WAAW,CAAC,CAM5C"}

package/dist/pptx/render/chart-title-style.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Chart title text style: the font every binding draws `vm.title` with.
+ *
+ * Cascade (highest wins): the title's own `c:tx/c:rich` / `c:txPr` run
+ * properties (`PptxChartStyle.titleFont*`), then the chart-style part's
+ * title entry, then this viewer's fixed defaults (12 px, semi-bold, slate).
+ * Returned as a framework-neutral descriptor the bindings map straight onto
+ * SVG `<text>` attributes, so a chart authored with a 24 pt red title reads
+ * the same in all five bindings.
+ *
+ * @module chart-title-style
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+/** Resolved SVG text attributes for the chart title. */
+export interface ChartTitleTextStyle {
+    /** `font-size`, in slide-px. */
+    fontSize: number;
+    /** `font-weight`. */
+    fontWeight: number;
+    /** `fill`. */
+    fill: string;
+    /** `font-family`, only when the title names a typeface. */
+    fontFamily?: string;
+}
+/**
+ * The lowest baseline that keeps a title of `fontSizePx` inside the chart:
+ * its ascent (about 0.8em) plus the chart's own 8px top margin.
+ */
+export declare function titleBaselineFor(fontSizePx: number): number;
+/**
+ * Lower an automatic title baseline that a large title font would push out of
+ * the chart (see {@link titleBaselineFor}), and move a top legend sitting in
+ * the title band down by the same amount so the two do not collide.
+ */
+export declare function fitTitleBand(vm: {
+    title: string | undefined;
+    titleY: number;
+    legendY: number;
+    legend: readonly unknown[];
+}, fontSizePx: number): {
+    titleY: number;
+    legendY: number;
+};
+/**
+ * Resolve the title font for `chartData`. Pure; safe to call for a chart with
+ * no title (the result is simply unused).
+ */
+export declare function resolveChartTitleTextStyle(chartData: PptxChartData | undefined): ChartTitleTextStyle;
+//# sourceMappingURL=chart-title-style.d.ts.map

package/dist/pptx/render/chart-title-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-title-style.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-title-style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAWrD,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IACnC,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,EAC9F,UAAU,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQrC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACzC,SAAS,EAAE,aAAa,GAAG,SAAS,GAClC,mBAAmB,CAoBrB"}

package/dist/pptx/render/chart-treemap-hierarchy.d.ts

@@ -0,0 +1,17 @@
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type { TreemapBox } from './chart-treemap-squarify.js';
+import type { SvgRect, SvgText } from './chart-view-model.js';
+export type TreemapPrimitive = SvgRect | SvgText;
+/**
+ * The top-level branch labels a treemap's legend should show, in the same
+ * order `buildHierarchicalTreemapPrimitives` assigns colour indexes to its
+ * roots: one label per authored `c:ser`/`cx:series` when there is more than
+ * one, else one per unique top ChartEx category level, else (a flat,
+ * non-hierarchical treemap) one per leaf category. A legend built from
+ * anything else would show swatches that do not match what a leaf's fill
+ * colour actually is.
+ */
+export declare function treemapBranchLabels(chartData: PptxChartData, categoryLabels: ReadonlyArray<string>): string[];
+/** Build nested treemap rectangles from ChartEx leaf-first category levels. */
+export declare function buildHierarchicalTreemapPrimitives(chartData: PptxChartData, categoryLabels: ReadonlyArray<string>, box: TreemapBox): TreemapPrimitive[];
+//# sourceMappingURL=chart-treemap-hierarchy.d.ts.map

package/dist/pptx/render/chart-treemap-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-treemap-hierarchy.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-treemap-hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAA+C,MAAM,iBAAiB,CAAC;AAGlG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAa3D,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC;AA4JjD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,GACnC,MAAM,EAAE,CAiBV;AAED,+EAA+E;AAC/E,wBAAgB,kCAAkC,CACjD,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,EACrC,GAAG,EAAE,UAAU,GACb,gBAAgB,EAAE,CA8CpB"}

package/dist/pptx/render/chart-treemap-squarify.d.ts

@@ -0,0 +1,4 @@
+/** Compatibility entry: the implementation lives in ooxml-core/chart (`treemap-squarify.ts`). */
+export { squarify } from 'ooxml-core/chart';
+export type { TreemapBox } from 'ooxml-core/chart';
+//# sourceMappingURL=chart-treemap-squarify.d.ts.map

package/dist/pptx/render/chart-treemap-squarify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-treemap-squarify.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-treemap-squarify.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/pptx/render/chart-treemap-view.d.ts

@@ -0,0 +1,23 @@
+/**
+ * View-model builder for the treemap chart kind.
+ *
+ * Split out of `chart-surface-treemap.ts` (which re-exports this) to keep
+ * that file's several chart-kind builders each under the repo's per-file
+ * line budget.
+ *
+ * Ported from:
+ *   packages/react/src/viewer/utils/chart-surface-treemap.tsx  (renderTreemapChart)
+ *
+ * @module chart-treemap-view
+ */
+import type { PptxChartData, PptxElement } from 'ooxml-core/pptx';
+import type { ChartViewModel } from './chart-view-model.js';
+/**
+ * Build the view-model for a treemap chart.
+ *
+ * Uses a slice-and-dice layout (alternate horizontal/vertical splits) with
+ * items sorted largest-first.  Inline labels are added when the cell is wide
+ * enough.  Mirrors `renderTreemapChart` in React's `chart-surface-treemap.tsx`.
+ */
+export declare function buildTreemapViewModel(element: PptxElement, chartData: PptxChartData, categoryLabels: ReadonlyArray<string>): ChartViewModel;
+//# sourceMappingURL=chart-treemap-view.d.ts.map

package/dist/pptx/render/chart-treemap-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-treemap-view.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-treemap-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKlE,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,oBAAoB,CAAC;AAGtE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,GACnC,cAAc,CA6ChB"}

package/dist/pptx/render/chart-trendline-defaults.d.ts

@@ -0,0 +1,15 @@
+/**
+ * chart-trendline-defaults.ts: PowerPoint's own default trendline stroke
+ * (1.5pt, dotted), applied when a trendline carries no `c:spPr`.
+ *
+ * Split into its own module (rather than living in `chart-overlays-trendline.ts`,
+ * which draws the trendline itself) so `chart-legend-build.ts` can share the
+ * exact same default for the trendline's legend swatch without importing the
+ * `chart-view-model` barrel that module pulls in, which would be circular
+ * (the barrel re-exports `chart-legend-build.ts` itself).
+ *
+ * @module chart-trendline-defaults
+ */
+export declare const DEFAULT_TRENDLINE_WIDTH = 1.5;
+export declare const DEFAULT_TRENDLINE_DASH = "sysDot";
+//# sourceMappingURL=chart-trendline-defaults.d.ts.map

package/dist/pptx/render/chart-trendline-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-trendline-defaults.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-trendline-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,sBAAsB,WAAW,CAAC"}

package/dist/pptx/render/chart-trendline-equation-format.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility entry: the implementation lives in ooxml-core/chart (`trendline-equation.ts`). */
+export { formatTrendlineCoefficient, formatLinearEquation, formatExponentialEquation, formatLogarithmicEquation, formatPowerEquation, formatPolynomialEquation, } from 'ooxml-core/chart';
+//# sourceMappingURL=chart-trendline-equation-format.d.ts.map

package/dist/pptx/render/chart-trendline-equation-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-trendline-equation-format.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-trendline-equation-format.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EACN,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/pptx/render/chart-trendlines.d.ts

@@ -0,0 +1,34 @@
+/**
+ * chart-trendlines.ts: framework-agnostic trendline regression maths.
+ *
+ * A port of the React `viewer/utils/chart-trendlines.tsx` regression engine,
+ * stripped of its JSX. `computeTrendlinePoints` fits one series' trendline
+ * and returns its polyline points plus an optional equation / R² label;
+ * `chart-overlays-trendline.ts` calls it per series and assembles the
+ * renderable SVG path/colour/label a binding actually draws (this module
+ * used to also export that assembly step, `computeChartTrendlines`, but it
+ * had no callers anywhere in the five bindings or shared and was removed).
+ *
+ * Supported regression types (per `PptxChartTrendlineType`):
+ * linear, exponential, logarithmic, power, polynomial, movingAvg.
+ */
+import type { PptxChartTrendline } from 'ooxml-core/pptx';
+import type { PlotLayout, ValueRange } from './chart-helpers.js';
+/** A single point on a computed trendline, in SVG pixel space. */
+export interface TrendlinePoint {
+    x: number;
+    y: number;
+}
+interface ComputedTrend {
+    points: TrendlinePoint[];
+    equation: string;
+    rSquared: number;
+}
+/**
+ * Compute the polyline points (and equation / R²) for one trendline over a
+ * series' values. Returns an empty point list when the type is unsupported or
+ * the data is too sparse to fit. Mirrors the React `computeTrendlinePoints`.
+ */
+export declare function computeTrendlinePoints(trendline: PptxChartTrendline, values: number[], catCount: number, layout: PlotLayout, range: ValueRange, mode: 'line' | 'bar'): ComputedTrend;
+export {};
+//# sourceMappingURL=chart-trendlines.d.ts.map

package/dist/pptx/render/chart-trendlines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-trendlines.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-trendlines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAO9D,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAqBD,UAAU,aAAa;IACtB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,GAAG,KAAK,GAClB,aAAa,CAqHf"}

package/dist/pptx/render/chart-user-shape-edit.d.ts

@@ -0,0 +1,3 @@
+export { listChartUserShapeDescriptors, createDefaultChartUserShape, pixelRectToRelAnchor, pixelRectToAbsAnchor, withChartUserShapeAdded, withChartUserShapeUpdated, withChartUserShapeRemoved, validateChartUserShapeAnchor, } from 'ooxml-core/pptx/editor/render/chart-user-shape-edit';
+export type { ChartUserShapeDescriptor } from 'ooxml-core/pptx/editor/render/chart-user-shape-edit';
+//# sourceMappingURL=chart-user-shape-edit.d.ts.map

package/dist/pptx/render/chart-user-shape-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-user-shape-edit.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-user-shape-edit.ts"],"names":[],"mappings":"AACA,OAAO,EACN,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,4BAA4B,GAC5B,MAAM,qDAAqD,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAC"}

package/dist/pptx/render/chart-user-shape-group-child.d.ts

@@ -0,0 +1,34 @@
+/**
+ * "Insert a new shape into an existing group" for a chart overlay
+ * (`c:userShapes`) `grpSp` row.
+ *
+ * Before this, the inspector's "Add text box" always appended a new
+ * top-level overlay shape (`chart-user-shape-edit.ts`'s
+ * `withChartUserShapeAdded`): a group row had no way to receive a new child
+ * at all. This mirrors that same default-shape styling, but expressed in the
+ * target group's own child coordinate space (`chOff`/`chExt`, see
+ * `chart-user-shape-row-frame.ts`'s doc) so the new shape lands inside the
+ * group's visible bounds instead of at the top level, and appends it via a
+ * path-based update mirroring core's `addChartUserShapeGroupChild` SDK op
+ * (`chart-user-shape-operations.ts`), operating directly on the array like
+ * this module's siblings so a binding's inspector never has to fabricate a
+ * throwaway `ChartPptxElement`.
+ *
+ * @module render/chart-user-shape-group-child
+ */
+import type { PptxChartUserShape, PptxChartUserShapeGroupChild, PptxChartUserShapeGroupTransform } from 'ooxml-core/pptx';
+/**
+ * A ready-to-insert text-box child sized to land inside a group's own
+ * visible bounds, matching `createDefaultChartUserShape`'s top-level default
+ * (a modest box centred over its container) but expressed in the group's
+ * own child coordinate space instead of chart-relative fractions.
+ */
+export declare function createDefaultChartUserShapeGroupChild(transform: PptxChartUserShapeGroupTransform): PptxChartUserShapeGroupChild;
+/**
+ * Append a new child into an existing group's `children`, at any nesting
+ * depth (`groupPath` addresses the `grpSp` row itself, top-level or nested).
+ * A no-op (returns the array unchanged) when `groupPath` does not resolve to
+ * a `grpSp` row.
+ */
+export declare function withChartUserShapeGroupChildAdded(userShapes: ReadonlyArray<PptxChartUserShape> | undefined, groupPath: readonly number[], child: PptxChartUserShapeGroupChild): PptxChartUserShape[];
+//# sourceMappingURL=chart-user-shape-group-child.d.ts.map

package/dist/pptx/render/chart-user-shape-group-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-user-shape-group-child.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-user-shape-group-child.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EACX,kBAAkB,EAClB,4BAA4B,EAC5B,gCAAgC,EAChC,MAAM,iBAAiB,CAAC;AAIzB;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACpD,SAAS,EAAE,gCAAgC,GACzC,4BAA4B,CAY9B;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAChD,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,SAAS,EACzD,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,KAAK,EAAE,4BAA4B,GACjC,kBAAkB,EAAE,CAQtB"}

package/dist/pptx/render/chart-user-shape-overlay.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Chart drawing-overlay projector (`c:userShapes`).
+ *
+ * Projects the parsed {@link PptxChartUserShape} model (resolved by core from
+ * the chart's separate `ppt/drawings/drawingN.xml` part) into `SvgPrimitive`
+ * descriptors positioned on top of the chart plot. Anchor geometry is
+ * chart-relative: `relSizeAnchor` corners are fractions of the chart area,
+ * `absSizeAnchor` extents are EMU converted to pixels. Rendered last so the
+ * overlay sits above the data marks.
+ *
+ * A `grpSp` entry (grouped annotation shapes with their own nested
+ * transform) is expanded into positioned leaves via core's
+ * `flattenChartUserShapes` before projecting, so this module never has to
+ * know about groups itself.
+ *
+ * @module chart-user-shape-overlay
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type { SvgPrimitive } from './chart-view-model.js';
+/** The raw, un-flattened overlay model as parsed/edited (may contain `grpSp` entries). */
+type RawUserShape = NonNullable<PptxChartData['userShapes']>[number];
+/**
+ * Build overlay primitives for all of a chart's user shapes.
+ *
+ * @param userShapes - Parsed overlay shapes from `chartData.userShapes`.
+ * @param svgWidth - View-model SVG width (chart area width in px).
+ * @param svgHeight - View-model SVG height (chart area height in px).
+ * @returns Overlay primitives, or an empty array when there are none.
+ */
+export declare function buildChartUserShapeOverlay(userShapes: ReadonlyArray<RawUserShape> | undefined, svgWidth: number, svgHeight: number): SvgPrimitive[];
+export {};
+//# sourceMappingURL=chart-user-shape-overlay.d.ts.map

package/dist/pptx/render/chart-user-shape-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-user-shape-overlay.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-user-shape-overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,OAAO,KAAK,EAAuB,YAAY,EAAW,MAAM,oBAAoB,CAAC;AAErF,0FAA0F;AAC1F,KAAK,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAwKrE;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,SAAS,EACnD,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GACf,YAAY,EAAE,CAchB"}

package/dist/pptx/render/chart-user-shape-row-frame.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Ancestor-frame helpers for a chart overlay row addressed by path.
+ *
+ * A row nested inside a `cdr:grpSp` has its own position/size as `off`/`ext`
+ * EMU in its immediate parent's child coordinate space (`a:chOff`/`a:chExt`),
+ * meaningless read as bare numbers. This composes the same ratio math core's
+ * `flattenChartUserShapes` (`chart-user-shapes-parser.ts`) uses for
+ * rendering, but stops at the row's own node instead of only leaves, so ANY
+ * row (including a nested `grpSp` group header) can be read/written as a
+ * `from`/`to` fraction pair, matching how a top-level `relSizeAnchor` row
+ * already edits (`chart-user-shape-tree.ts`'s `ChartUserShapeRow.from`/`to`).
+ *
+ * The fraction is exactly chart-relative when the row's outermost anchor is
+ * a `relSizeAnchor` (its `from`/`to` already span the whole chart, so
+ * composing through nested groups yields a further chart-wide fraction).
+ * Under an `absSizeAnchor` the fraction is relative to the anchor's own box
+ * instead: its `from` is chart-relative but `ext` is a fixed EMU size, so a
+ * group child's position within it cannot be re-expressed as a further
+ * chart-wide fraction without the chart's live pixel size (the same
+ * approximation `flattenChartUserShapes`'s `absGroupOffsetEmu` already makes
+ * for rendering).
+ *
+ * See the sibling `chart-user-shape-group-child.ts` for "insert a new shape
+ * into an existing group" (a separate file to stay under the repo's 300-LOC
+ * guideline).
+ *
+ * @module render/chart-user-shape-row-frame
+ */
+import type { PptxChartUserShape, PptxChartUserShapeGroupTransform } from 'ooxml-core/pptx';
+/** A nested row's position/size as a fraction pair, ready for the same `from`/`to` editor a top-level `relSizeAnchor` row uses. */
+export interface ChartUserShapeRowChartBox {
+    anchor: 'rel' | 'abs';
+    from: {
+        x: number;
+        y: number;
+    };
+    to: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Read a nested row's position/size as a `from`/`to` fraction pair (see this
+ * module's doc for what the fraction is relative to). `undefined` for a
+ * top-level row (which already carries its own `from`/`to`/`ext` directly,
+ * see `ChartUserShapeRow`) or an unresolvable path.
+ */
+export declare function getChartUserShapeRowChartBox(userShapes: ReadonlyArray<PptxChartUserShape> | undefined, path: readonly number[]): ChartUserShapeRowChartBox | undefined;
+/**
+ * Write a nested row's `from`/`to` fraction pair back as EMU `off`/`ext` in
+ * its immediate parent's child space, inverting {@link getChartUserShapeRowChartBox}'s
+ * composition. Every ancestor group above the target is left untouched (its
+ * own `off`/`ext`/`chOff`/`chExt` do not change); when the target itself is a
+ * `grpSp`, its `transform.off`/`.ext` are kept in sync with the top-level
+ * `off`/`ext` the serializer does not otherwise read (see
+ * `chart-user-shapes-serializer.ts`'s `buildGroupNode`, which reads
+ * `group.transform`, not the child-level convenience `off`/`ext` fields).
+ * Rounds to whole EMU so repeated edits do not accumulate float drift.
+ */
+export declare function withChartUserShapeRowChartBoxUpdated(userShapes: ReadonlyArray<PptxChartUserShape> | undefined, path: readonly number[], box: Pick<ChartUserShapeRowChartBox, 'from' | 'to'>): PptxChartUserShape[];
+/** A group's own `chOff`/`chExt` (its own child coordinate space), for sizing a new child that lands inside it. */
+export declare function getChartUserShapeGroupTransform(userShapes: ReadonlyArray<PptxChartUserShape> | undefined, groupPath: readonly number[]): PptxChartUserShapeGroupTransform | undefined;
+//# sourceMappingURL=chart-user-shape-row-frame.d.ts.map

package/dist/pptx/render/chart-user-shape-row-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-user-shape-row-frame.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-user-shape-row-frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EACX,kBAAkB,EAElB,gCAAgC,EAChC,MAAM,iBAAiB,CAAC;AAyGzB,mIAAmI;AACnI,MAAM,WAAW,yBAAyB;IACzC,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,EAAE,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC3C,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,SAAS,EACzD,IAAI,EAAE,SAAS,MAAM,EAAE,GACrB,yBAAyB,GAAG,SAAS,CAkCvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oCAAoC,CACnD,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,SAAS,EACzD,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,IAAI,CAAC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC,GACjD,kBAAkB,EAAE,CA8DtB;AAwBD,mHAAmH;AACnH,wBAAgB,+BAA+B,CAC9C,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,SAAS,EACzD,SAAS,EAAE,SAAS,MAAM,EAAE,GAC1B,gCAAgC,GAAG,SAAS,CAG9C"}

package/dist/pptx/render/chart-user-shape-row-transform.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Rotation/flip write helpers for one row of the chart overlay-shape tree
+ * (`c:userShapes`), split out of `chart-user-shape-tree.ts` to keep that
+ * module under this repo's file-size limit.
+ *
+ * Both a row's rotation and its flip flags live at `transform.rotation` /
+ * `transform.flipH` / `transform.flipV` on a `grpSp` row (they rotate/flip the
+ * whole group as a rigid body, see `chart-user-shapes-parser.ts`'s
+ * `flattenChartUserShapes` doc for how that composes onto every contained
+ * leaf), rather than as a flat field on the row's own node, so each needs its
+ * own small merge instead of `withChartUserShapeRowUpdated`'s generic
+ * `{...node, ...patch}` spread.
+ *
+ * @module render/chart-user-shape-row-transform
+ */
+import type { PptxChartUserShape } from 'ooxml-core/pptx';
+/**
+ * Patch one row's OWN rotation (degrees). `undefined` (or `0`) clears it.
+ */
+export declare function withChartUserShapeRowRotationUpdated(userShapes: ReadonlyArray<PptxChartUserShape> | undefined, path: readonly number[], rotation: number | undefined): PptxChartUserShape[];
+/**
+ * Patch one row's OWN flip flags. Only the keys present in `flip` are
+ * changed; the other axis is left as-is, so a caller toggling one checkbox
+ * never has to know the other's current value. `false` clears the flag
+ * (mirroring how the parser only ever sets `true`, never `false`, on these
+ * fields).
+ */
+export declare function withChartUserShapeRowFlipUpdated(userShapes: ReadonlyArray<PptxChartUserShape> | undefined, path: readonly number[], flip: {
+    flipH?: boolean;
+    flipV?: boolean;
+}): PptxChartUserShape[];
+//# sourceMappingURL=chart-user-shape-row-transform.d.ts.map

package/dist/pptx/render/chart-user-shape-row-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-user-shape-row-transform.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-user-shape-row-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D;;GAEG;AACH,wBAAgB,oCAAoC,CACnD,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,SAAS,EACzD,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC1B,kBAAkB,EAAE,CAsBtB;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC/C,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,SAAS,EACzD,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACxC,kBAAkB,EAAE,CA4BtB"}