ooxml-ui 0.30.0 → 0.31.0

package/dist/pptx/render/chart-3d-oblique-labels.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Axis labels for the right-angle-axes 3D bar chart
+ * (`chart-3d-oblique-layout.ts`), placed where PowerPoint puts them: off the
+ * FRONT edges of the box, not off the back wall.
+ *
+ * - Value labels: along the front edge of the wall that carries the value
+ *   gridlines (left edge for columns, bottom edge for a horizontal chart).
+ * - Category labels: centred on each category along the other front edge.
+ * - `standard` grouping: one series label per depth row, off the right end of
+ *   the floor (columns only; PowerPoint's horizontal standard bar has no row
+ *   axis labels in its default layout).
+ *
+ * @module chart-3d-oblique-labels
+ */
+import type { ObliqueChartLayout } from './chart-3d-oblique-layout.js';
+/** Gap between a value label and the box edge it labels. */
+export declare const OBLIQUE_VALUE_LABEL_GAP: number;
+/** Gap between a category or series label and the box edge it labels. */
+export declare const OBLIQUE_CATEGORY_LABEL_GAP: number;
+/** One label, in chart px. */
+export interface ObliqueLabel {
+    role: 'value' | 'category' | 'series';
+    text: string;
+    x: number;
+    y: number;
+    anchor: 'start' | 'middle' | 'end';
+    /** `central` centres the text on `y`. */
+    baseline: 'central' | 'hanging';
+    fontSize: number;
+}
+export interface ObliqueLabelInput {
+    fontSize: number;
+    categories: readonly string[];
+    seriesNames: readonly string[];
+    valueText: (value: number) => string;
+}
+type LayoutCore = Pick<ObliqueChartLayout, 'horizontal' | 'grouping' | 'origin' | 'shear' | 'box' | 'range' | 'valueScale'>;
+/** Every axis label for a laid-out oblique bar chart. */
+export declare function buildObliqueLabels(layout: LayoutCore, input: ObliqueLabelInput): ObliqueLabel[];
+export {};
+//# sourceMappingURL=chart-3d-oblique-labels.d.ts.map

package/dist/pptx/render/chart-3d-oblique-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-oblique-labels.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-oblique-labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAKpE,4DAA4D;AAC5D,eAAO,MAAM,uBAAuB,QAAY,CAAC;AACjD,yEAAyE;AACzE,eAAO,MAAM,0BAA0B,QAAU,CAAC;AAIlD,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC,yCAAyC;IACzC,QAAQ,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED,KAAK,UAAU,GAAG,IAAI,CACrB,kBAAkB,EAClB,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,CAC/E,CAAC;AASF,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,GAAG,YAAY,EAAE,CA2E/F"}

package/dist/pptx/render/chart-3d-oblique-layout.d.ts

@@ -0,0 +1,42 @@
+/**
+ * PowerPoint's right-angle-axes (`c:view3D/@rAngAx=1`) 3D bar chart, laid out
+ * as a real box in world space and drawn with an oblique projection.
+ *
+ * Measured against PowerPoint's own COM export of the ground-truth deck
+ * (`e2e/fixtures/three-d-parity/gt/chart-01..06.webp`):
+ *
+ * - The plot is a box `W x H x D`: X along the category axis (value axis for a
+ *   horizontal `c:barDir="bar"` chart), Y up, Z receding from the front edge
+ *   of the floor. A world point `(x, y, z)` lands on screen at
+ *   `(ox + x + z sin(rotY), oy - y - z sin(rotX))`: the front plane is drawn
+ *   flat, depth shears up and to the right.
+ * - A bar's depth equals its width, and each depth ROW is
+ *   `barWidth * (1 + gapDepth / 100)` deep with the bar centred in it. Clustered
+ *   and stacked charts have one row; `standard` puts each series on its own
+ *   row, series 1 at the front.
+ * - Gridlines run along the back wall and along the wall or floor that holds
+ *   the value axis; there are no wall fills or outlines.
+ * - Value labels sit 13.5pt off the front edge of the value axis; category
+ *   (and `standard` series) labels 14pt off theirs.
+ * - The value axis has NO headroom: data topping out at exactly 5 gets a 0..5
+ *   axis (a 2D chart would get 0..6).
+ *
+ * The box fills a plot region calibrated from the same exports and is
+ * centred in it where it does not fill it (a multi-row `standard` box, whose
+ * height follows its width).
+ *
+ * @module chart-3d-oblique-layout
+ */
+import type { PptxElement } from 'ooxml-core/pptx';
+import type { ObliqueChartLayout } from './chart-3d-oblique-types.js';
+import type { ChartViewModel } from './chart-view-model-types.js';
+export type { ObliqueLabel } from './chart-3d-oblique-labels.js';
+export type { ObliqueBar, ObliqueChartLayout, ObliqueGridline, ObliqueTaper, } from './chart-3d-oblique-types.js';
+/** Chart px of a world point. */
+export declare function obliqueToScreen(layout: Pick<ObliqueChartLayout, 'origin' | 'shear'>, p: readonly [number, number, number]): {
+    x: number;
+    y: number;
+};
+/** The resolved oblique layout for a `bar3D` chart element, or `null`. */
+export declare function computeObliqueBarLayout(element: PptxElement, vm: ChartViewModel): ObliqueChartLayout | null;
+//# sourceMappingURL=chart-3d-oblique-layout.d.ts.map

package/dist/pptx/render/chart-3d-oblique-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-oblique-layout.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-oblique-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAQlE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAwB9D,YAAY,EACX,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,GACZ,MAAM,0BAA0B,CAAC;AAElC,iCAAiC;AACjC,wBAAgB,eAAe,CAC9B,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,OAAO,CAAC,EACpD,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAClC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B;AA2DD,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,cAAc,GAChB,kBAAkB,GAAG,IAAI,CA4H3B"}

package/dist/pptx/render/chart-3d-oblique-shape-mesh.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Round and pointed bars (`c:shape` cylinder / cone / pyramid and the
+ * `coneToMax` / `pyramidToMax` frustums) for the right-angle-axes 3D bar chart
+ * (`chart-3d-oblique-layout.ts`).
+ *
+ * Measured on `gt/chart-07..09.webp`: every shape sits in the SAME footprint
+ * as a box bar (a round shape is inscribed in the `w x d` base, a pyramid
+ * fills it), so the layout is unchanged and only the mesh differs.
+ *
+ * Geometry is unit-sized (-0.5..0.5 on every axis, like `BoxGeometry(1,1,1)`)
+ * so the caller places it with `position` + `scale` exactly as it does a box.
+ * Shading is baked into vertex colours from each vertex's WORLD normal (the
+ * unit normal corrected for the mesh's non-uniform scale), with
+ * `chart-3d-shading.ts`'s per-shape quadratic form, so the drag preview
+ * re-shades a bar whose proportions change. A round surface is shaded
+ * relative to the oblique VIEW direction (yawed `atan(sin rotY)` off the
+ * front normal), which is why PowerPoint's highlight sits at the middle of
+ * the silhouette rather than left of it; flat facets keep the box table.
+ *
+ * @module chart-3d-oblique-shape-mesh
+ */
+import type * as THREE from 'three';
+import type { ObliqueBar } from './chart-3d-oblique-layout.js';
+type ThreeModule = typeof THREE;
+/** Whether a bar is drawn with this module rather than as a box. */
+export declare function isShapedObliqueBar(bar: Pick<ObliqueBar, 'shape'>): boolean;
+/** Cache key of a bar's unit geometry (shape, taper and orientation). */
+export declare function obliqueShapeKey(bar: ObliqueBar, horizontal: boolean): string;
+/**
+ * The unit geometry of a shaped bar, its axis along +Y (or +X for a
+ * horizontal chart, the base at the value-axis baseline end).
+ */
+export declare function buildObliqueShapeGeometry(three: ThreeModule, bar: ObliqueBar, horizontal: boolean): THREE.BufferGeometry;
+/**
+ * (Re)write a shaped bar's vertex colours for its current world `scale`, so
+ * each vertex gets the shade of its world-space normal.
+ */
+export declare function shadeObliqueShapeGeometry(three: ThreeModule, geometry: THREE.BufferGeometry, bar: Pick<ObliqueBar, 'shape' | 'color'>, scale: {
+    x: number;
+    y: number;
+    z: number;
+}, viewYaw: number): void;
+export {};
+//# sourceMappingURL=chart-3d-oblique-shape-mesh.d.ts.map

package/dist/pptx/render/chart-3d-oblique-shape-mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-oblique-shape-mesh.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-oblique-shape-mesh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAKhC,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,OAAO,CAE1E;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAE5E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,OAAO,GACjB,KAAK,CAAC,cAAc,CA4BtB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,EACxC,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,OAAO,EAAE,MAAM,GACb,IAAI,CAiCN"}

package/dist/pptx/render/chart-3d-oblique-types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * World-space types of the right-angle-axes 3D bar chart layout
+ * (`chart-3d-oblique-layout.ts`).
+ *
+ * @module chart-3d-oblique-types
+ */
+import type { PptxBar3DShape } from 'ooxml-core/pptx';
+import type { ObliqueLabel } from './chart-3d-oblique-labels.js';
+/** One bar as a world-space box. */
+export interface ObliqueBar {
+    x: number;
+    y: number;
+    z: number;
+    /** Extent along world X / Y / Z. */
+    w: number;
+    h: number;
+    d: number;
+    color: string;
+    seriesIndex: number;
+    categoryIndex: number;
+    value: number;
+    /** Resolved `c:shape` (per-series `c:ser/c:shape`, else the chart's). */
+    shape: PptxBar3DShape;
+    /** Cross-section radius at the bar's baseline / value end, as a fraction of the full footprint. */
+    taper: ObliqueTaper;
+}
+/** How a shaped bar narrows along the value axis (1 = full footprint, 0 = a point). */
+export interface ObliqueTaper {
+    bottom: number;
+    top: number;
+}
+/** A gridline segment in world space. */
+export interface ObliqueGridline {
+    from: readonly [number, number, number];
+    to: readonly [number, number, number];
+}
+export interface ObliqueChartLayout {
+    horizontal: boolean;
+    grouping: 'clustered' | 'stacked' | 'percentStacked' | 'standard';
+    /** Chart px of world (0, 0, 0): the front-bottom-left corner of the floor. */
+    origin: {
+        x: number;
+        y: number;
+    };
+    /** Screen shift per world unit of depth: `(sin rotY, -sin rotX)`. */
+    shear: {
+        x: number;
+        y: number;
+    };
+    box: {
+        w: number;
+        h: number;
+        d: number;
+    };
+    range: {
+        min: number;
+        max: number;
+        majorUnit: number;
+    };
+    /** Chart px per value unit along the value axis. */
+    valueScale: number;
+    bars: ObliqueBar[];
+    gridlines: ObliqueGridline[];
+    labels: ObliqueLabel[];
+}
+//# sourceMappingURL=chart-3d-oblique-types.d.ts.map

package/dist/pptx/render/chart-3d-oblique-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-oblique-types.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-oblique-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,oCAAoC;AACpC,MAAM,WAAW,UAAU;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,oCAAoC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,cAAc,CAAC;IACtB,mGAAmG;IACnG,KAAK,EAAE,YAAY,CAAC;CACpB;AAED,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,gBAAgB,GAAG,UAAU,CAAC;IAClE,8EAA8E;IAC9E,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,qEAAqE;IACrE,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,MAAM,EAAE,YAAY,EAAE,CAAC;CACvB"}

package/dist/pptx/render/chart-3d-persp-bars.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Bars of a `bar3D` chart WITHOUT right-angle axes (`c:view3D/@rAngAx=0`):
+ * columns, or horizontal bars for `c:barDir="bar"`, on the perspective box (`chart-3d-persp-layout.ts`),
+ * as box-space prisms. The bar sizing follows the right-angle-axes layout
+ * (`chart-3d-oblique-bars.ts`), whose conventions PowerPoint shares: a bar's
+ * depth equals its width, `clustered` series sit side by side in one row,
+ * `stacked` ones share a bar, and `standard` gives each series its own row.
+ *
+ * @module chart-3d-persp-bars
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type { PerspChartLayout } from './chart-3d-persp-layout.js';
+import type { PerspPrism } from './chart-3d-persp-marks.js';
+type LayoutCore = Pick<PerspChartLayout, 'grouping' | 'range' | 'valueScale' | 'categoryX' | 'rowDepth' | 'colors' | 'horizontal' | 'view'>;
+/** One prism per bar; `override` replaces one point's value (a drag preview). */
+export declare function buildPerspBarPrisms(chartData: PptxChartData, layout: LayoutCore, override?: {
+    seriesIndex: number;
+    pointIndex: number;
+    value: number;
+}): PerspPrism[];
+export {};
+//# sourceMappingURL=chart-3d-persp-bars.d.ts.map

package/dist/pptx/render/chart-3d-persp-bars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-bars.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-bars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIzD,KAAK,UAAU,GAAG,IAAI,CACrB,gBAAgB,EAChB,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,CACjG,CAAC;AAOF,iFAAiF;AACjF,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,UAAU,EAClB,QAAQ,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnE,UAAU,EAAE,CA0Ed"}

package/dist/pptx/render/chart-3d-persp-gridlines.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Wall and floor gridlines of the perspective 3D chart box
+ * (`chart-3d-persp-layout.ts`), in box space.
+ *
+ * A column-style box (values up the y axis) draws each value tick on the
+ * left wall and the back wall; a horizontal bar box (values along x, as
+ * PowerPoint's `c:barDir="bar"` draws them) draws them on the floor and the
+ * back wall. Both keep the floor's front and right outer edges.
+ *
+ * @module chart-3d-persp-gridlines
+ */
+import type { PerspGridline } from './chart-3d-persp-layout.js';
+import type { PerspBox } from './chart-3d-persp-view.js';
+export declare function buildPerspGridlines(box: PerspBox, range: {
+    min: number;
+    max: number;
+    majorUnit: number;
+}, horizontal: boolean): PerspGridline[];
+//# sourceMappingURL=chart-3d-persp-gridlines.d.ts.map

package/dist/pptx/render/chart-3d-persp-gridlines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-gridlines.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-gridlines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACtD,UAAU,EAAE,OAAO,GACjB,aAAa,EAAE,CAkBjB"}

package/dist/pptx/render/chart-3d-persp-labels.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Axis labels for the perspective 3D chart layout (`chart-3d-persp-layout.ts`),
+ * placed where PowerPoint puts them (offsets measured on `gt/chart-10,11`):
+ *
+ * - Value labels: right-aligned 8pt left of the box's front-left edge.
+ * - Category labels: centred below the front floor edge, 9pt left and 17pt
+ *   down from their point on it.
+ * - A horizontal bar box (values along x) swaps the first two: value labels
+ *   under the front floor edge, category labels left of the front-left edge.
+ * - Series (depth-row) labels: left-aligned off the right floor edge, 9pt right
+ *   and 4pt up from their row's centre on it.
+ *
+ * @module chart-3d-persp-labels
+ */
+import type { PptxChartAxisFormatting } from 'ooxml-core/pptx';
+import type { PerspChartLayout } from './chart-3d-persp-layout.js';
+/** One label, in chart px. */
+export interface PerspLabel {
+    role: 'value' | 'category' | 'series';
+    text: string;
+    x: number;
+    y: number;
+    anchor: 'start' | 'middle' | 'end';
+    fontSize: number;
+}
+export interface PerspLabelInput {
+    fontSize: number;
+    categories: readonly string[];
+    /** Depth-row labels; empty when the chart has one row. */
+    seriesNames: readonly string[];
+    valueAxis: PptxChartAxisFormatting | undefined;
+    percent: boolean;
+}
+type LayoutCore = Pick<PerspChartLayout, 'view' | 'range' | 'categoryX' | 'rows' | 'kind' | 'horizontal'>;
+/** Every axis label for a laid-out perspective chart. */
+export declare function buildPerspLabels(layout: LayoutCore, input: PerspLabelInput): PerspLabel[];
+export {};
+//# sourceMappingURL=chart-3d-persp-labels.d.ts.map

package/dist/pptx/render/chart-3d-persp-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-labels.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAahE,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,0DAA0D;IAC1D,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,KAAK,UAAU,GAAG,IAAI,CACrB,gBAAgB,EAChB,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAC/D,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,UAAU,EAAE,CA0EzF"}

package/dist/pptx/render/chart-3d-persp-layout.d.ts

@@ -0,0 +1,71 @@
+/**
+ * PowerPoint's perspective 3D chart layout (`c:view3D/@rAngAx=0`) for the
+ * cartesian families (line3D, area3D, surface3D): the plot box, the camera
+ * that frames it (`chart-3d-persp-view.ts`), the value axis, where each
+ * category and depth row sits, and the wall gridlines.
+ *
+ * Calibrated against `gt/chart-10..13,16`:
+ *
+ * - The box is 1 unit wide (categories), `boxHeight` tall and one category
+ *   slot deep per depth row: a mark (area slab, line ribbon) is
+ *   `slot / (1 + gapWidth)` deep and each row `mark * (1 + gapDepth)`, which
+ *   with the 150/150 defaults is exactly one slot (fitted: 0.94-1.04).
+ *   `standard` grouping (and line3D) gives each series a row, series 1 in
+ *   front; stacked groupings share one row. A surface spans the whole floor.
+ * - Categories sit at the slot centres (`c:crossBetween="between"`) or on the
+ *   slot edges, first and last on the walls (`midCat`, area and surface's
+ *   default).
+ * - The value axis has no headroom (data topping out at 35 gets 0..35).
+ * - The box fills a plot rect calibrated from the same exports, centred and
+ *   floor-aligned; walls carry gridlines only, the floor its two outer edges.
+ *
+ * @module chart-3d-persp-layout
+ */
+import type { PptxChartData, PptxElement } from 'ooxml-core/pptx';
+import type { PerspLabel } from './chart-3d-persp-labels.js';
+import type { PerspView } from './chart-3d-persp-view.js';
+import type { ChartViewModel } from './chart-view-model-types.js';
+export type { PerspLabel } from './chart-3d-persp-labels.js';
+export type PerspKind = 'line' | 'area' | 'surface' | 'bar';
+export type PerspGrouping = 'standard' | 'clustered' | 'stacked' | 'percentStacked';
+/** A gridline segment in box space. */
+export interface PerspGridline {
+    from: readonly [number, number, number];
+    to: readonly [number, number, number];
+}
+export interface PerspChartLayout {
+    kind: PerspKind;
+    grouping: PerspGrouping;
+    view: PerspView;
+    range: {
+        min: number;
+        max: number;
+        majorUnit: number;
+    };
+    /** Values run along box x and categories up box y (a `c:barDir="bar"` bar chart). */
+    horizontal: boolean;
+    /** Box units per value unit, along the value axis. */
+    valueScale: number;
+    /** Position of each category along the category axis (box x, or box y when `horizontal`). */
+    categoryX: number[];
+    /** Number of depth rows and each row's depth. */
+    rows: number;
+    rowDepth: number;
+    /** Depth of a slab or ribbon, centred in its row. */
+    markDepth: number;
+    /** Series colours, by series index. */
+    colors: string[];
+    gridlines: PerspGridline[];
+    labels: PerspLabel[];
+}
+/** Series colours as the flat chart resolved them (legend swatches carry them). */
+export declare function perspSeriesColors(chartData: PptxChartData, vm: ChartViewModel): string[];
+/**
+ * The perspective layout of a line3D / area3D / surface chart (or a bar3D
+ * chart without right-angle axes), or `null`; `oblique` draws the same box
+ * with a right-angle-axes projection.
+ */
+export declare function computePerspChartLayout(element: PptxElement, vm: ChartViewModel, options?: {
+    oblique?: boolean;
+}): PerspChartLayout | null;
+//# sourceMappingURL=chart-3d-persp-layout.d.ts.map

package/dist/pptx/render/chart-3d-persp-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-layout.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAIlE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA+B1D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAEpF,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,qFAAqF;IACrF,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,MAAM,EAAE,UAAU,EAAE,CAAC;CACrB;AAsDD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,GAAG,MAAM,EAAE,CAKxF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,gBAAgB,GAAG,IAAI,CAyFzB"}

package/dist/pptx/render/chart-3d-persp-mark-set.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The marks of a perspective 3D chart scene (`chart-3d-persp-scene.ts`)
+ * behind one interface, so the scene, its picking and its drag preview do
+ * not care whether they draw line / area prisms or a banded surface.
+ *
+ * @module chart-3d-persp-mark-set
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type * as THREE from 'three';
+import type { Chart3DPoint } from './chart-3d-mark-interaction.js';
+import type { PerspChartLayout } from './chart-3d-persp-layout.js';
+type ThreeModule = typeof THREE;
+export interface PerspMarkSet {
+    /** Box-space root (its matrix is the box placement). */
+    group: THREE.Group;
+    /** Objects rays are cast against. */
+    targets: THREE.Object3D[];
+    /** The data point at a box-space hit on `object`. */
+    pointAt: (object: THREE.Object3D, local: THREE.Vector3) => Chart3DPoint | null;
+    /** Box-space anchor of a point drawn at `value` (selection marker, drag scale). */
+    anchor: (point: Chart3DPoint, value: number) => [number, number, number];
+    /** Whether a point's value can be dragged. */
+    draggable: boolean;
+    /** Redraw with one point at `value` (a drag preview). */
+    preview: (point: Chart3DPoint, value: number) => void;
+    dispose: () => void;
+}
+/** Build the mark set for a laid-out perspective chart. */
+export declare function buildPerspMarkSet(three: ThreeModule, chartData: PptxChartData, layout: PerspChartLayout, palette: readonly string[]): PerspMarkSet;
+export {};
+//# sourceMappingURL=chart-3d-persp-mark-set.d.ts.map

package/dist/pptx/render/chart-3d-persp-mark-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-mark-set.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-mark-set.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAMhE,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC5B,wDAAwD;IACxD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,qDAAqD;IACrD,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,KAAK,YAAY,GAAG,IAAI,CAAC;IAC/E,mFAAmF;IACnF,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzE,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,yDAAyD;IACzD,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB;AAYD,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,SAAS,MAAM,EAAE,GACxB,YAAY,CAiDd"}

package/dist/pptx/render/chart-3d-persp-marks.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Marks of the perspective 3D line / area charts (`chart-3d-persp-layout.ts`)
+ * as box-space prisms: a polygon in the category/value (x/y) plane extruded
+ * through a depth range, which is how PowerPoint draws both families
+ * (`gt/chart-10..13`):
+ *
+ * - 3-D Area: one slab per series, the area polygon down to the baseline,
+ *   `markDepth` deep and centred in its row. Stacked groupings share one row
+ *   and stack each series on the running sum (`percentStacked` normalised).
+ * - 3-D Line: one ribbon per series in its own row, the polyline thickened
+ *   by a hairline so the tape has an edge to see.
+ *
+ * @module chart-3d-persp-marks
+ */
+import type { PptxBar3DShape, PptxChartData } from 'ooxml-core/pptx';
+import type { ObliqueTaper } from './chart-3d-oblique-types.js';
+import type { PerspChartLayout } from './chart-3d-persp-layout.js';
+export interface PerspPrism {
+    seriesIndex: number;
+    /** The bar's category, for a per-point mark (a bar); absent for a whole-series slab or ribbon. */
+    pointIndex?: number;
+    color: string;
+    /** Polygon in box x/y, counter-clockwise. */
+    outline: Array<[number, number]>;
+    z0: number;
+    z1: number;
+    /**
+     * A bar's `c:shape` (cylinder / cone / pyramid and the `...ToMax` slices);
+     * absent or `box` extrudes the outline. The shape is inscribed in the
+     * outline's bounding box, as with right-angle axes.
+     */
+    shape?: PptxBar3DShape;
+    /** Width of a shaped bar at its baseline / value end, 0-1 (see `obliqueBarTaper`). */
+    taper?: ObliqueTaper;
+    /** The bar runs along box x (a horizontal bar chart) rather than y. */
+    horizontal?: boolean;
+}
+type LayoutCore = Pick<PerspChartLayout, 'kind' | 'grouping' | 'view' | 'range' | 'valueScale' | 'categoryX' | 'rowDepth' | 'markDepth' | 'colors' | 'horizontal'>;
+/** Position of a value along the value axis (box y, or box x for horizontal bars), clipped to the axis. */
+export declare function perspValueY(layout: Pick<LayoutCore, 'range' | 'valueScale'>, v: number): number;
+/** Depth range of a row's mark. */
+export declare function perspRowSpan(layout: Pick<LayoutCore, 'rowDepth' | 'markDepth'>, row: number): [number, number];
+/**
+ * The prisms for a line or area chart; `override` replaces one point's value
+ * (a live drag preview).
+ */
+export declare function buildPerspPrisms(chartData: PptxChartData, layout: LayoutCore, override?: {
+    seriesIndex: number;
+    pointIndex: number;
+    value: number;
+}): PerspPrism[];
+export {};
+//# sourceMappingURL=chart-3d-persp-marks.d.ts.map

package/dist/pptx/render/chart-3d-persp-marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-marks.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-marks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,MAAM,WAAW,UAAU;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,sFAAsF;IACtF,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,KAAK,UAAU,GAAG,IAAI,CACrB,gBAAgB,EACd,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,YAAY,GACZ,WAAW,GACX,UAAU,GACV,WAAW,GACX,QAAQ,GACR,YAAY,CACd,CAAC;AAEF,2GAA2G;AAC3G,wBAAgB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/F;AAED,mCAAmC;AACnC,wBAAgB,YAAY,CAC3B,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAAC,EAClD,GAAG,EAAE,MAAM,GACT,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlB;AAoBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,UAAU,EAClB,QAAQ,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnE,UAAU,EAAE,CAwDd"}

package/dist/pptx/render/chart-3d-persp-mesh.d.ts

@@ -0,0 +1,36 @@
+/**
+ * WebGL geometry for the perspective 3D chart layout
+ * (`chart-3d-persp-layout.ts`): the wall gridlines and one extruded, flat-
+ * shaded mesh per mark prism (`chart-3d-persp-marks.ts`), in a group whose
+ * matrix maps box space onto `buildPerspCamera`'s view space.
+ *
+ * Faces are shaded per vertex from their box-space normal with the same
+ * quadratic form as the bar chart (`chart3DNormalShade`), the box's front
+ * (-z, toward the viewer) as the lit face. Box space (x right, y up, z away)
+ * is left-handed, so the box matrix mirrors; materials are two-sided.
+ *
+ * @module chart-3d-persp-mesh
+ */
+import type * as THREE from 'three';
+import type { PerspChartLayout } from './chart-3d-persp-layout.js';
+import type { PerspPrism } from './chart-3d-persp-marks.js';
+type ThreeModule = typeof THREE;
+export interface PerspMeshResult {
+    /** Box-space root (its matrix is the box placement). */
+    group: THREE.Group;
+    /** One mesh per prism, same order; `userData` names its series (and a bar's point). */
+    meshes: THREE.Mesh[];
+    /** Replace mesh `i`'s geometry with `prism` (a drag preview). */
+    setPrism: (i: number, prism: PerspPrism) => void;
+    dispose: () => void;
+}
+/** Bake face shading into a geometry's vertex colours. */
+export declare function shadePerspGeometry(three: ThreeModule, geometry: THREE.BufferGeometry, color: string): void;
+/** An extruded, shaded prism geometry in box space. */
+export declare function buildPrismGeometry(three: ThreeModule, prism: PerspPrism): THREE.BufferGeometry;
+/** The wall gridlines and floor edges of a perspective layout, in box space. */
+export declare function buildPerspGridlines(three: ThreeModule, layout: Pick<PerspChartLayout, 'gridlines'>): THREE.LineSegments;
+/** Build the gridlines and prism meshes of a perspective layout. */
+export declare function buildPerspMeshes(three: ThreeModule, layout: Pick<PerspChartLayout, 'view' | 'gridlines'>, prisms: ReadonlyArray<PerspPrism>): PerspMeshResult;
+export {};
+//# sourceMappingURL=chart-3d-persp-mesh.d.ts.map

package/dist/pptx/render/chart-3d-persp-mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-mesh.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-mesh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKzD,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAKhC,MAAM,WAAW,eAAe;IAC/B,wDAAwD;IACxD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,uFAAuF;IACvF,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,iEAAiE;IACjE,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,KAAK,EAAE,MAAM,GACX,IAAI,CAmBN;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,KAAK,CAAC,cAAc,CAkB9F;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GACzC,KAAK,CAAC,YAAY,CAQpB;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,WAAW,CAAC,EACpD,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAC/B,eAAe,CAqCjB"}

package/dist/pptx/render/chart-3d-persp-oblique.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The right-angle-axes (`c:view3D/@rAngAx=1`) variant of the perspective
+ * chart camera (`chart-3d-persp-view.ts`), for the line / area / surface box:
+ * PowerPoint draws such a chart as an oblique projection, like the bar chart
+ * (`chart-3d-oblique-layout.ts`): the front plane is flat and each unit of
+ * depth shifts `sin(rotY)` right and `sin(rotX)` up.
+ *
+ * The oblique camera plugs into the same `PerspView` pipeline: its "camera
+ * space" is the box-centred point with depth folded in (`Z = 1`), so
+ * `perspToScreen`, the rect fit and the labels work unchanged.
+ *
+ * @module chart-3d-persp-oblique
+ */
+import type * as THREE from 'three';
+import type { PerspBox, PerspCamera, PerspView } from './chart-3d-persp-view.js';
+type ThreeModule = typeof THREE;
+/** An oblique camera's depth shear, screen units per unit of depth. */
+export interface PerspOblique {
+    /** Rightward shift per unit of depth, `sin(rotY)`. */
+    shearX: number;
+    /** Upward shift per unit of depth, `sin(rotX)`. */
+    shearY: number;
+}
+/** The oblique camera for a box and its `c:view3D` angles (degrees). */
+export declare function perspObliqueCameraFor(box: PerspBox, rotXDeg: number, rotYDeg: number): PerspCamera;
+/** Oblique "camera space": box-centred, depth sheared in, `Z = 1`. */
+export declare function perspObliqueToCamera(box: PerspBox, oblique: PerspOblique, p: readonly [number, number, number]): [number, number, number];
+/**
+ * A three.js camera for an oblique view: an affine projection of the
+ * box-centred space of {@link perspObliqueBoxMatrix}, nearer depth drawn in
+ * front. Its inverse unprojects to straight rays, so picking works as for the
+ * perspective camera.
+ */
+export declare function buildPerspObliqueCamera(three: ThreeModule, view: PerspView, oblique: PerspOblique, svgWidth: number, svgHeight: number): THREE.Camera;
+/** Box space to the box-centred space of {@link buildPerspObliqueCamera}. */
+export declare function perspObliqueBoxMatrix(three: ThreeModule, box: PerspBox): THREE.Matrix4;
+export {};
+//# sourceMappingURL=chart-3d-persp-oblique.d.ts.map

package/dist/pptx/render/chart-3d-persp-oblique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-oblique.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-oblique.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE9E,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAEhC,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC5B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACb,WAAW,CAWb;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,YAAY,EACrB,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAClC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAK1B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GACf,KAAK,CAAC,MAAM,CAyBd;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,GAAG,KAAK,CAAC,OAAO,CAEtF"}

package/dist/pptx/render/chart-3d-persp-scene.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `<pptx-three-view>` scene for the perspective 3D line / area / surface
+ * charts (`chart-3d-persp-layout.ts`): the box's gridlines and marks in WebGL
+ * through PowerPoint's fitted camera, its labels, title and legend in the SVG
+ * overlay, and hover / select / drag on the shared mark interaction.
+ *
+ * A pick resolves to the nearest data point on the hit mark; a vertical drag
+ * moves that point's value (not a stacked area's, as in the 2D chart), at the
+ * screen scale of the value axis at that point. A surface's legend lists its
+ * value bands, as PowerPoint's does.
+ *
+ * @module chart-3d-persp-scene
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type { ThreeViewContext, ThreeViewScene } from '../three-view/types.js';
+import type { PerspChartLayout } from './chart-3d-persp-layout.js';
+import type { ChartViewModel } from './chart-view-model-types.js';
+export interface PerspSceneInput {
+    vm: ChartViewModel;
+    layout: PerspChartLayout;
+    chartData: PptxChartData;
+    categoryLabels: ReadonlyArray<string>;
+}
+export declare function mountPerspChartView(input: PerspSceneInput, ctx: ThreeViewContext): ThreeViewScene;
+//# sourceMappingURL=chart-3d-persp-scene.d.ts.map

package/dist/pptx/render/chart-3d-persp-scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-scene.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAMhE,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,0BAA0B,CAAC;AAK5E,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,cAAc,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACtC;AA2BD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,GAAG,cAAc,CAyHjG"}

package/dist/pptx/render/chart-3d-persp-shape-mesh.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Round and pointed bars (`c:shape` cylinder / cone / pyramid and the
+ * `...ToMax` slices) on the perspective box (`chart-3d-persp-layout.ts`), for
+ * a `bar3D` chart without right-angle axes.
+ *
+ * The right-angle-axes chart already builds these solids
+ * (`chart-3d-oblique-shape-mesh.ts`): a unit shape inscribed in the bar's
+ * footprint. Here the same unit geometry is scaled into the prism's box-space
+ * bounding box and shaded from its box-space normals with the shape's own
+ * form (`chart-3d-shading.ts`); box-space `-z` faces the viewer. Without
+ * right-angle axes PowerPoint has no export of this setting in the parity
+ * deck, so the shading follows the box convention unverified.
+ *
+ * @module chart-3d-persp-shape-mesh
+ */
+import type * as THREE from 'three';
+import type { PerspPrism } from './chart-3d-persp-marks.js';
+type ThreeModule = typeof THREE;
+/** Whether a prism is drawn as a shaped solid rather than an extrusion. */
+export declare function isShapedPerspPrism(prism: PerspPrism): boolean;
+/** A shaped bar's geometry in box space, with shading baked into vertex colours. */
+export declare function buildShapedPrismGeometry(three: ThreeModule, prism: PerspPrism): THREE.BufferGeometry;
+export {};
+//# sourceMappingURL=chart-3d-persp-shape-mesh.d.ts.map

package/dist/pptx/render/chart-3d-persp-shape-mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-shape-mesh.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-shape-mesh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAEhC,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE7D;AASD,oFAAoF;AACpF,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,UAAU,GACf,KAAK,CAAC,cAAc,CAmCtB"}