ooxml-ui 0.30.0 → 0.31.0

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

@@ -0,0 +1,26 @@
+/**
+ * WebGL objects for the banded 3-D Surface (`chart-3d-persp-surface.ts`):
+ * flat-shaded band triangles, or coloured band lines for a wireframe, plus an
+ * invisible unclipped grid mesh for picking (a wireframe's hairlines are too
+ * thin to hit).
+ *
+ * @module chart-3d-persp-surface-mesh
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type * as THREE from 'three';
+import type { PerspChartLayout } from './chart-3d-persp-layout.js';
+type ThreeModule = typeof THREE;
+export interface SurfaceMarks {
+    group: THREE.Group;
+    pickTarget: THREE.Mesh;
+    rebuild: (override?: {
+        seriesIndex: number;
+        pointIndex: number;
+        value: number;
+    }) => void;
+    dispose: () => void;
+}
+/** Build the surface's objects into a box-space group. */
+export declare function buildSurfaceMarks(three: ThreeModule, chartData: PptxChartData, layout: PerspChartLayout, palette: readonly string[]): SurfaceMarks;
+export {};
+//# sourceMappingURL=chart-3d-persp-surface-mesh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-surface-mesh.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-surface-mesh.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAOhE,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC;IACvB,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACzF,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB;AA8FD,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,SAAS,MAAM,EAAE,GACxB,YAAY,CA2Bd"}

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

@@ -0,0 +1,57 @@
+/**
+ * The 3-D Surface chart (`c:surface3DChart`, and `c:surfaceChart` under the
+ * 3D opt-in) on the perspective box (`chart-3d-persp-layout.ts`), as pure
+ * geometry: PowerPoint colours a surface by VALUE BAND, one band per major
+ * unit of the value axis (`gt/chart-16,17`: bands 0-0.5, 0.5-1, ... each in
+ * its own colour, listed in the legend in place of the series).
+ *
+ * - The surface is a grid over categories (x) and series (z), series 1 on the
+ *   front edge and the last on the back wall. Each grid cell is split into two
+ *   triangles and each triangle clipped into the bands it crosses.
+ * - Band colours come from `c:bandFmts` (fill, or the line colour of a
+ *   wireframe), else the chart palette cycle PowerPoint uses (accents 1-6,
+ *   then the same at 60% luminance).
+ * - `c:wireframe` draws, for every band, the grid of the surface clamped
+ *   into that band in the band's colour (so a band the surface rises through
+ *   shows as a flat grid at its top edge), instead of fills.
+ *
+ * @module chart-3d-persp-surface
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type { PerspChartLayout } from './chart-3d-persp-layout.js';
+type Vec3 = [number, number, number];
+export interface SurfaceBand {
+    /** Legend text, e.g. `0-0.5`. */
+    label: string;
+    color: string;
+}
+export interface SurfaceGeometry {
+    bands: SurfaceBand[];
+    /** Filled triangles as box-space vertex triples, with each triangle's band. */
+    triangles: Array<{
+        points: [Vec3, Vec3, Vec3];
+        band: number;
+    }>;
+    /** Wireframe segments with each piece's band. */
+    segments: Array<{
+        from: Vec3;
+        to: Vec3;
+        band: number;
+    }>;
+}
+type LayoutCore = Pick<PerspChartLayout, 'view' | 'range' | 'valueScale' | 'categoryX'>;
+/** Box z of series row `s` of `n` (front edge to back wall). */
+export declare function surfaceRowZ(layout: Pick<LayoutCore, 'view'>, s: number, n: number): number;
+/** Colours and legend labels for each band. */
+export declare function surfaceBands(chartData: PptxChartData, range: LayoutCore['range'], palette: readonly string[]): SurfaceBand[];
+/**
+ * The surface's triangles (filled) or segments (wireframe) in box space;
+ * `override` replaces one point's value (a drag preview).
+ */
+export declare function buildSurfaceGeometry(chartData: PptxChartData, layout: LayoutCore, palette: readonly string[], override?: {
+    seriesIndex: number;
+    pointIndex: number;
+    value: number;
+}): SurfaceGeometry;
+export {};
+//# sourceMappingURL=chart-3d-persp-surface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-surface.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErC,MAAM,WAAW,WAAW;IAC3B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,+EAA+E;IAC/E,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,iDAAiD;IACjD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,KAAK,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC,CAAC;AAExF,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1F;AAiBD,+CAA+C;AAC/C,wBAAgB,YAAY,CAC3B,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAC1B,OAAO,EAAE,SAAS,MAAM,EAAE,GACxB,WAAW,EAAE,CAYf;AAgFD;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnE,eAAe,CAwCjB"}

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

@@ -0,0 +1,101 @@
+/**
+ * PowerPoint's perspective 3D chart camera (`c:view3D/@rAngAx=0`: line3D,
+ * area3D, surface3D), as a pure projection plus its three.js camera.
+ *
+ * Fitted to PowerPoint's own exports of the three-d-parity deck: the ends and
+ * corners of every wall gridline in `gt/chart-10..12,16` were traced and a
+ * camera fitted to them (0.4-2pt RMS per chart):
+ *
+ * - The plot is a box `w x h x d` (x categories, y values, z depth away from
+ *   the viewer). It is yawed by `rotY` about its vertical centre line, then
+ *   pitched toward the viewer by `0.92 * rotX` (the fitted pitch was
+ *   13.6-14.0 degrees for every `rotX = 15` chart).
+ * - The camera looks at the box centre from `diagonal / (2 tan(fov / 2))`
+ *   away, `fov` being `c:view3D/c:perspective` in degrees (default 30): the
+ *   box's bounding sphere just fills the field of view. The fitted distances
+ *   were 1.8-1.9 box diagonals.
+ *
+ * A box point `(x, y, z)` (origin at the front-bottom-left corner) lands at
+ * chart px `(cx + f X / Z, cy - f Y / Z)`, `(X, Y, Z)` being the point in
+ * camera space; {@link fitPerspView} picks `f`, `cx`, `cy` so the box fills a
+ * target rect.
+ *
+ * @module chart-3d-persp-view
+ */
+import type * as THREE from 'three';
+import type { PerspOblique } from './chart-3d-persp-oblique.js';
+type ThreeModule = typeof THREE;
+/** Fitted pitch per degree of `rotX`. */
+export declare const PERSP_PITCH_PER_ROTX = 0.92;
+/** `c:perspective` default: the field of view in degrees. */
+export declare const PERSP_DEFAULT_FOV = 30;
+export interface PerspBox {
+    w: number;
+    h: number;
+    d: number;
+}
+export interface PerspCamera {
+    box: PerspBox;
+    /** Yaw (`rotY`) in radians: positive brings the box's right end toward the viewer. */
+    yaw: number;
+    /** Pitch in radians: positive tips the top of the box away (the viewer looks down). */
+    pitch: number;
+    /** Camera distance from the box centre, world units. */
+    dist: number;
+    /** Set for a right-angle-axes chart: an oblique projection instead (`chart-3d-persp-oblique.ts`). */
+    oblique?: PerspOblique;
+}
+export interface PerspView extends PerspCamera {
+    /** Focal length: chart px per world unit at unit depth. */
+    focal: number;
+    /** Chart px of the box centre. */
+    cx: number;
+    cy: number;
+}
+/** Camera-space coordinates `(X, Y, Z)` of a box point; `Z` is the depth ahead of the camera. */
+export declare function perspToCamera(camera: PerspCamera, p: readonly [number, number, number]): [number, number, number];
+/** Chart px of a box point. */
+export declare function perspToScreen(view: PerspView, p: readonly [number, number, number]): {
+    x: number;
+    y: number;
+};
+/** The camera for a box and its `c:view3D` angles (degrees), before scale and placement. */
+export declare function perspCameraFor(box: PerspBox, rotXDeg: number, rotYDeg: number, fovDeg?: number): PerspCamera;
+/** Bounds of the projection of `points` (default: the box corners) at focal 1, box centre at (0, 0). */
+export declare function perspUnitBounds(camera: PerspCamera, points?: ReadonlyArray<readonly [number, number, number]>): {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+};
+/**
+ * Scale and place a camera so the projection of `points` (default: the box
+ * corners) fits inside `rect` (chart px) as large as it can, centred in it
+ * (`gt/chart-11`, a box too wide for its rect, sits midway down it).
+ */
+export declare function fitPerspView(camera: PerspCamera, rect: {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}, points?: ReadonlyArray<readonly [number, number, number]>): PerspView;
+/**
+ * Where the view ray through chart px `(sx, sy)` meets the horizontal box
+ * plane at height `y`, as box `(x, z)`; `null` when the ray runs parallel to
+ * it or meets it behind the camera.
+ */
+export declare function perspScreenToPlaneY(view: PerspView, sx: number, sy: number, y: number): {
+    x: number;
+    z: number;
+} | null;
+/**
+ * A three.js camera that renders box-space geometry exactly where
+ * {@link perspToScreen} puts it, on a canvas of `svgWidth x svgHeight` chart
+ * px. It sits at the origin looking down -Z with an off-centre projection;
+ * place the box group with {@link perspBoxMatrix}.
+ */
+export declare function buildPerspCamera(three: ThreeModule, view: PerspView, svgWidth: number, svgHeight: number): THREE.Camera;
+/** The matrix taking box space to the view space of {@link buildPerspCamera}. */
+export declare function perspBoxMatrix(three: ThreeModule, view: PerspCamera): THREE.Matrix4;
+export {};
+//# sourceMappingURL=chart-3d-persp-view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-persp-view.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-persp-view.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,60 @@
+/**
+ * PowerPoint's 3-D Pie (`c:pie3DChart`) as a disc in the perspective chart
+ * camera (`chart-3d-persp-view.ts`), fitted to `gt/chart-14,15`:
+ *
+ * - The pie is a puck of radius 1 and thickness `0.23` (box `2 x 0.23 x 2`,
+ *   scaled by `c:view3D/@hPercent`), pitched `0.91 * rotX` toward the viewer
+ *   (27.2 degrees fitted for rotX 30) and seen from `1.38` box diagonals: a
+ *   closer camera than the cartesian charts use, so the front of the pie is
+ *   visibly larger than the back.
+ * - The first slice starts at 12 o'clock (plus `c:firstSliceAng`) and slices
+ *   run clockwise seen from above.
+ * - The unexploded puck fits the plot rect; exploding shrinks the radius by
+ *   `1 / (1 + explosion)` and moves each slice out along its bisector by its
+ *   own explosion, so an exploded pie keeps the same footprint.
+ *
+ * @module chart-3d-pie-layout
+ */
+import type { PptxElement } from 'ooxml-core/pptx';
+import type { PerspView } from './chart-3d-persp-view.js';
+import type { ChartViewModel } from './chart-view-model-types.js';
+export interface PieSlice {
+    pointIndex: number;
+    value: number;
+    color: string;
+    /** Clockwise from 12 o'clock, radians. */
+    startAngle: number;
+    endAngle: number;
+    /** Box-space offset of the exploded slice. */
+    offset: {
+        x: number;
+        z: number;
+    };
+}
+export interface PieChartLayout {
+    view: PerspView;
+    /** Box-space centre of the pie's top face (its bottom face sits on y = 0). */
+    center: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    radius: number;
+    thickness: number;
+    slices: PieSlice[];
+}
+/** Box (x, z) of the rim at `angle` (clockwise from 12 o'clock) for a pie centred at (cx, cz). */
+export declare function pieRimPoint(cx: number, cz: number, radius: number, angle: number): {
+    x: number;
+    z: number;
+};
+/**
+ * The flat pie's view model is square (its 2D render letterboxes a square
+ * viewBox into the frame); the 3D scene draws across the whole frame, so
+ * widen it to the element's own aspect, keeping the centred title and legend
+ * centred.
+ */
+export declare function widenPieViewModel(vm: ChartViewModel, element: PptxElement): ChartViewModel;
+/** The 3-D pie layout of a `pie3D` chart element, or `null`. */
+export declare function computePieChartLayout(element: PptxElement, vm: ChartViewModel): PieChartLayout | null;
+//# sourceMappingURL=chart-3d-pie-layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-pie-layout.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-pie-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAkB/D,MAAM,WAAW,QAAQ;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,8EAA8E;IAC9E,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACX;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAE1B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,GAAG,cAAc,CAY1F;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,cAAc,GAChB,cAAc,GAAG,IAAI,CAkEvB"}

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

@@ -0,0 +1,30 @@
+/**
+ * WebGL geometry for the 3-D Pie (`chart-3d-pie-layout.ts`): one mesh per
+ * slice (top, rim, the two cut faces, bottom) with baked vertex colours, and
+ * the white slice seams PowerPoint draws (`a:ln` in `lt1`).
+ *
+ * Shading, fitted to `gt/chart-14,15`: the top face keeps the slice colour;
+ * the rim darkens from the left toward the right, `max(0.385, 0.57 - 0.275
+ * phi)` with `phi` the rim normal's angle to the right of straight toward the
+ * viewer (radians). The flat cut faces of an exploded pie follow their own
+ * rule, lighter turned right: `0.5 + 0.2 sin(phi)` (0.70 at +59 degrees,
+ * 0.42 at -23, 0.39 at -59, 0.3 at -90 on `gt/chart-15`).
+ *
+ * @module chart-3d-pie-marks
+ */
+import type * as THREE from 'three';
+import type { PieChartLayout, PieSlice } from './chart-3d-pie-layout.js';
+type ThreeModule = typeof THREE;
+/** Shade multiplier for a box-space normal (box -z faces the viewer); `cut` for a slice's flat cut face. */
+export declare function pieFaceShade(nx: number, ny: number, nz: number, cut?: boolean): number;
+export interface PieMarks {
+    group: THREE.Group;
+    meshes: THREE.Mesh[];
+    /** Rebuild the slices (a drag preview). */
+    setSlices: (slices: ReadonlyArray<PieSlice>) => void;
+    dispose: () => void;
+}
+/** Build the slice meshes and seams of a pie layout. */
+export declare function buildPieMarks(three: ThreeModule, layout: PieChartLayout): PieMarks;
+export {};
+//# sourceMappingURL=chart-3d-pie-marks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-pie-marks.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-pie-marks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtE,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAOhC,4GAA4G;AAC5G,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,MAAM,CAYpF;AAED,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,2CAA2C;IAC3C,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB;AA6ED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,GAAG,QAAQ,CAwDlF"}

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

@@ -0,0 +1,24 @@
+/**
+ * `<pptx-three-view>` scene for the 3-D Pie (`chart-3d-pie-layout.ts`): the
+ * slices in WebGL through the fitted perspective camera, title and legend in
+ * the SVG overlay, and hover / select / drag on the shared mark interaction.
+ *
+ * A slice drag sweeps its trailing edge around the pie like the flat pie
+ * (`resolvePieSliceShareValue`): the pointer is unprojected onto the pie's top
+ * plane and its angle there sets the slice's share.
+ *
+ * @module chart-3d-pie-scene
+ */
+import type { PptxChartData, PptxElement } from 'ooxml-core/pptx';
+import type { ThreeViewContext, ThreeViewScene } from '../three-view/types.js';
+import type { PieChartLayout } from './chart-3d-pie-layout.js';
+import type { ChartViewModel } from './chart-view-model-types.js';
+export interface PieSceneInput {
+    element: PptxElement;
+    vm: ChartViewModel;
+    layout: PieChartLayout;
+    chartData: PptxChartData;
+    categoryLabels: ReadonlyArray<string>;
+}
+export declare function mountPieChartView(input: PieSceneInput, ctx: ThreeViewContext): ThreeViewScene;
+//# sourceMappingURL=chart-3d-pie-scene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-pie-scene.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-pie-scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,EAAE,EAAE,cAAc,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACtC;AAcD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,gBAAgB,GAAG,cAAc,CA4G7F"}

package/dist/pptx/render/chart-3d-projection.d.ts

@@ -0,0 +1,60 @@
+/**
+ * chart-3d-projection.ts: resolve a chart's `c:view3D` into the projection
+ * PowerPoint actually draws it with.
+ *
+ * PowerPoint's 3D charts use ONE of two fundamentally different projections,
+ * picked by `c:view3D/@rAngAx` ("right angle axes"):
+ *
+ * - `rAngAx=1` (bar3D's own default, verified against `gt/chart-01.webp`):
+ *   an OBLIQUE (cavalier-style) parallel projection. The front-facing plot
+ *   (axes, gridlines, front face of every mark) is drawn perfectly flat and
+ *   undistorted, exactly like the 2D chart; only each mark's own depth
+ *   ("thickness") recedes along a fixed screen-space direction set by
+ *   `rotX`/`rotY`. This is the SAME depth vector the flat 2D fallback already
+ *   computes (`chart-3d-depth.ts#computeDepthVector`); this module exposes it
+ *   as a unitless per-world-Z shear so a true WebGL scene's camera can
+ *   reproduce it exactly instead of hand-drawn 2D parallelograms.
+ * - `rAngAx=0` (line3D/area3D/pie3D/surface's own default, verified against
+ *   `gt/chart-10.webp` and `gt/chart-16.webp`, which both show a genuine
+ *   receding 3-axis box: category/series gridlines converge, unlike the
+ *   orthogonal bar3D case): a real PERSPECTIVE camera, elevation `rotX`,
+ *   azimuth `rotY`, field of view from `c:view3D/c:perspective`.
+ *
+ * Absent `rAngAx` defaults to PowerPoint's own per-chart-type default:
+ * `true` for `bar3D`, `false` for everything else. `pie3D`'s own rotX/rotY
+ * defaults (30/0, "tilt" with no azimuth) differ from every other 3D chart
+ * type's (15/20), matching PowerPoint's Insert Chart gallery defaults.
+ *
+ * @module chart-3d-projection
+ */
+import type { PptxChartView3D } from 'ooxml-core/pptx';
+/** `rAngAx=1`: flat front faces, marks recede along a fixed screen-space shear. */
+export interface Chart3DObliqueProjection {
+    mode: 'oblique';
+    /** World-X screen shift per world unit of depth (receding into the scene). */
+    shearX: number;
+    /** World-Y screen shift per world unit of depth. */
+    shearY: number;
+    rotXDeg: number;
+    rotYDeg: number;
+}
+/** `rAngAx=0`: a real perspective camera framing the whole 3D grid. */
+export interface Chart3DPerspectiveProjection {
+    mode: 'perspective';
+    /** Elevation in degrees (`c:view3D/@rotX`, -90..90). */
+    rotXDeg: number;
+    /** Azimuth in degrees (`c:view3D/@rotY`, 0..360). */
+    rotYDeg: number;
+    /** Resolved vertical field of view in degrees. */
+    fovDeg: number;
+}
+export type Chart3DProjection = Chart3DObliqueProjection | Chart3DPerspectiveProjection;
+/**
+ * Resolve a chart's actual projection from its type and `c:view3D`. Every 3D
+ * chart type this module is consulted for (`bar3D`, `line3D`, `area3D`,
+ * `pie3D`, and a `surface`/`surface3D` chart whose `chartData.view3D` is
+ * present) always has SOME projection; there is no "no 3D" case here, that
+ * gate belongs to the caller (`chart-3d-spec.ts#buildChart3DSpecForElement`).
+ */
+export declare function resolveChart3DProjection(chartType: string, view3D: PptxChartView3D | undefined): Chart3DProjection;
+//# sourceMappingURL=chart-3d-projection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-projection.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,SAAS,CAAC;IAChB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,uEAAuE;AACvE,MAAM,WAAW,4BAA4B;IAC5C,IAAI,EAAE,aAAa,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG,4BAA4B,CAAC;AAuBxF;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,eAAe,GAAG,SAAS,GACjC,iBAAiB,CAwBnB"}

package/dist/pptx/render/chart-3d-shading.d.ts

@@ -0,0 +1,21 @@
+/** A box mesh's six face orientations, in the chart's own (unrotated) local frame. */
+export type Chart3DFace = 'front' | 'back' | 'top' | 'bottom' | 'left' | 'right';
+/** Apply PowerPoint's measured per-face flat shading to a mark's base colour. */
+export declare function shadeChart3DFace(baseColor: string, face: Chart3DFace): string;
+/**
+ * The six face colours for a box mesh, in the order three.js `BoxGeometry`
+ * expects its `material` array (`[+x, -x, +y, -y, +z, -z]`): right, left,
+ * top, bottom, front, back. `front`/`back` name whichever world axis the
+ * scene treats as the camera-facing depth axis; the caller picks that
+ * mapping (see `chart-3d-view-scene.ts`).
+ */
+export declare function buildChart3DBoxFaceColors(baseColor: string): readonly [string, string, string, string, string, string];
+/**
+ * PowerPoint's flat chart-space shade for a surface of a `c:shape` bar with
+ * unit world normal `(nx, ny, nz)` (x right, y up, z toward the viewer), as
+ * a multiplier of the base colour: the quadratic form
+ * `cx nx^2 + cy ny^2 + cz nz^2`, which for a box's axis-aligned faces is
+ * exactly the per-face table above.
+ */
+export declare function chart3DNormalShade(shape: string | undefined, nx: number, ny: number, nz: number): number;
+//# sourceMappingURL=chart-3d-shading.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-shading.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-shading.ts"],"names":[],"mappings":"AAoBA,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAejF,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAG7E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,MAAM,GACf,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAS3D;AAqCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACR,MAAM,CAGR"}

package/dist/pptx/render/chart-3d-spec.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The pure, three-free description of a 3D chart that `<pptx-three-view>`
+ * mounts (`kind: 'chart'`). Built from a chart element by
+ * `buildChart3DSpecForElement`; consumed by `chart-3d-view-scene.ts`.
+ *
+ * The spec is deliberately built ON TOP of the existing flat 2D chart engine
+ * (`buildChartViewModel`) rather than beside it: for a `bar3D` chart with
+ * PowerPoint's own default `c:view3D/@rAngAx=1` (an oblique, not perspective,
+ * projection - see `chart-3d-projection.ts`), the flat 2D fallback's plot
+ * (gridlines, axis ticks, title, legend) is ALREADY pixel-correct and
+ * perfectly undistorted (verified against `gt/chart-01.webp`), and its
+ * `bar` cartesian layout already gets category/series positioning, gap
+ * width and stacking exactly right. This spec reuses that chrome and those
+ * front-face rectangles directly; `chart-3d-view-scene.ts` only has to draw
+ * REAL boxes (instead of flat 2D parallelograms) behind the SAME chrome.
+ *
+ * @module chart-3d-spec
+ */
+import type { PptxElement } from 'ooxml-core/pptx';
+import type { ObliqueChartLayout } from './chart-3d-oblique-layout.js';
+import type { PerspChartLayout } from './chart-3d-persp-layout.js';
+import type { PieChartLayout } from './chart-3d-pie-layout.js';
+import type { Chart3DProjection } from './chart-3d-projection.js';
+import type { ChartViewModel } from './chart-view-model-types.js';
+/** The chart types the 3D chart scene renders (`surface` covers the 2D and 3D surface charts; see below). */
+export declare const CHART_3D_TYPES: ReadonlySet<string>;
+/**
+ * A right-angle-axes `bar3D` chart laid out as a real box in world space
+ * (walls, gridlines, bars, axis labels); see `chart-3d-oblique-layout.ts`.
+ */
+export interface Chart3DObliqueGeometry {
+    kind: 'oblique';
+    layout: ObliqueChartLayout;
+}
+/** A perspective (`rAngAx=0`) line / area chart on PowerPoint's box (`chart-3d-persp-layout.ts`). */
+export interface Chart3DPerspGeometry {
+    kind: 'perspective';
+    layout: PerspChartLayout;
+}
+/** A 3-D Pie on PowerPoint's fitted perspective camera (`chart-3d-pie-layout.ts`). */
+export interface Chart3DPieGeometry {
+    kind: 'pie';
+    layout: PieChartLayout;
+}
+/** A chart's 3D geometry; `null` when it has nothing to draw (no series or categories). */
+export type Chart3DGeometry = Chart3DObliqueGeometry | Chart3DPerspGeometry | Chart3DPieGeometry | null;
+export interface Chart3DSpec {
+    /** The chart element the spec was built from (identity drives remounts). */
+    element: PptxElement;
+    width: number;
+    height: number;
+    chartType: string;
+    projection: Chart3DProjection;
+    /**
+     * The full flat 2D view-model, reused for chrome (title, legend, axis
+     * ticks, gridlines, area/plot fill). The scene draws these via
+     * `chart-view-model-dom.ts`'s piece renderers and skips `vm.primitives`/
+     * `vm.dataLabels` (the flat oblique bars/extrusion), replacing them with
+     * real WebGL geometry from `geometry`.
+     */
+    vm: ChartViewModel;
+    geometry: Chart3DGeometry;
+    /** Category labels (authored, or 1..n when the chart has none). */
+    categoryLabels: readonly string[];
+}
+/** Build the 3D spec for a chart element, or `null` when it is not a 3D chart. */
+export declare function buildChart3DSpecForElement(element: PptxElement): Chart3DSpec | null;
+//# sourceMappingURL=chart-3d-spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-spec.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAoB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,6GAA6G;AAC7G,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAM7C,CAAC;AAEH;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;CAC3B;AAED,qGAAqG;AACrG,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;CACzB;AAED,sFAAsF;AACtF,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,cAAc,CAAC;CACvB;AAED,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GACxB,sBAAsB,GACtB,oBAAoB,GACpB,kBAAkB,GAClB,IAAI,CAAC;AAER,MAAM,WAAW,WAAW;IAC3B,4EAA4E;IAC5E,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,iBAAiB,CAAC;IAC9B;;;;;;OAMG;IACH,EAAE,EAAE,cAAc,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,mEAAmE;IACnE,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAsCD,kFAAkF;AAClF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI,CAwCnF"}

package/dist/pptx/render/chart-3d-surfaces.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Background wall/floor panels for the 3D bar/line/area oblique-depth pass.
+ *
+ * `c:floor`, `c:sideWall`, and `c:backWall` (CT_Surface) are parsed onto
+ * `PptxChartData.floor` / `.sideWall` / `.backWall` but, until this module,
+ * never painted: a 3D cartesian chart authored with coloured walls rendered
+ * with no walls at all. Each panel is a flat quadrilateral swept from the
+ * plot's front bounding box to its back bounding box by the same oblique
+ * depth vector ({@link ../chart-3d-depth.ts}) that offsets bar/line/area
+ * extrusion, so the walls sit in the same illusion of depth as the marks
+ * they frame.
+ *
+ * Deliberately additive and silent: a chart with no authored fill on a given
+ * surface renders no panel for it, so an untouched chart's appearance is
+ * unchanged. Only cartesian 3D kinds (bar3D/line3D/area3D) call this; pie3D
+ * has no plot rectangle to wall in, matching PowerPoint's own behaviour.
+ *
+ * @module chart-3d-surfaces
+ */
+import type { PptxChart3DSurface } from 'ooxml-core/pptx';
+import type { DepthVector } from './chart-3d-depth.js';
+import type { SvgPolygon, SvgPrimitive } from './chart-view-model.js';
+import type { SurfaceWallColors } from './surface-chart-3d-walls.js';
+/** The three `c:chart`-level 3D surfaces this module can paint. */
+export interface Chart3DSurfaces {
+    floor?: PptxChart3DSurface;
+    sideWall?: PptxChart3DSurface;
+    backWall?: PptxChart3DSurface;
+}
+/**
+ * Resolve `c:floor`/`c:sideWall`/`c:backWall` fill colours into the shape the
+ * WebGL scenes' wall-panel builder ({@link ../surface-chart-3d-walls.ts},
+ * `buildSurfaceWallMeshes`) needs, or `undefined` when none of the three is
+ * authored. Single parsing/resolution point for BOTH the flat oblique-depth
+ * 2D wall panels ({@link build3DSurfacePanels}) and every interactive WebGL
+ * chart scene (surface, bar3D, and future line3D/area3D), so a chart's walls
+ * read identically across every presentation instead of each caller
+ * re-reading `chartData.floor?.spPr?.fillColor` its own way.
+ */
+export declare function resolveChart3DWallColors(surfaces: Chart3DSurfaces): SurfaceWallColors | undefined;
+interface Bounds {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+}
+/** Bounding box of the primitive kinds that carry plottable geometry (rect, polygon, polyline). */
+export declare function primitivesBounds(prims: readonly SvgPrimitive[]): Bounds | undefined;
+/**
+ * Build the floor/back-wall/side-wall background panels, furthest-back first
+ * so callers can prepend them ahead of the per-mark extrusion. Returns an
+ * empty array when none of the three surfaces has an authored fill colour,
+ * or when there is no plottable geometry to frame.
+ */
+export declare function build3DSurfacePanels(prims: readonly SvgPrimitive[], surfaces: Chart3DSurfaces, depth: DepthVector): SvgPolygon[];
+export {};
+//# sourceMappingURL=chart-3d-surfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-surfaces.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,iBAAiB,GAAG,SAAS,CAQjG;AAED,UAAU,MAAM;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,GAAG,SAAS,CA8BnF;AAmBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,WAAW,GAChB,UAAU,EAAE,CAqCd"}

package/dist/pptx/render/chart-3d-three-loader.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `chart-3d-three-loader`: the guarded dynamic import of `three` (an OPTIONAL
+ * peer dependency; a missing one resolves to `null`). `<pptx-three-view>`'s controller
+ * (`three-view/view-controller.ts`) is the one caller: a `null` `three` puts
+ * the view in its `unavailable` state, showing the slotted 2D fallback.
+ *
+ * @module chart-3d-three-loader
+ */
+import type * as THREE from 'three';
+/** Dynamically load `three`; resolves to `null` when the package is not installed. */
+export declare function loadChart3DThree(): Promise<typeof THREE | null>;
+//# sourceMappingURL=chart-3d-three-loader.d.ts.map

package/dist/pptx/render/chart-3d-three-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-three-loader.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-three-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,sFAAsF;AACtF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,KAAK,GAAG,IAAI,CAAC,CAMrE"}

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

@@ -0,0 +1,32 @@
+/**
+ * `<pptx-three-view>` scene module for 3D charts.
+ *
+ * Mounts a chart spec by its geometry: a 3-D Pie on its fitted camera
+ * (`chart-3d-pie-scene.ts`), the line / area / surface box and a bar3D chart
+ * without right-angle axes on the perspective box (`chart-3d-persp-scene.ts`),
+ * and the right-angle-axes `bar3D` (`c:view3D/@rAngAx=1`, its own default;
+ * verified against `gt/chart-01.webp`) here. A chart with nothing to draw has
+ * no spec at all, so its 2D chart stays.
+ *
+ * The oblique projection is built as a plain `OrthographicCamera` (1 world
+ * unit = 1 authored chart px, matching `chart-3d-chrome-overlay.ts`'s
+ * overlay `<svg>` viewBox exactly) with a SHEAR term hand-inserted into its
+ * projection matrix, rather than tilting the camera or shearing the scene
+ * graph: only the camera carries the projection, which keeps every box's world
+ * position/size meaningful on its own instead of encoding the illusion into
+ * mesh transforms.
+ *
+ * @module chart-3d-view-scene
+ */
+import type * as THREE from 'three';
+import type { ThreeViewContext, ThreeViewScene } from '../three-view/types.js';
+import type { Chart3DSpec } from './chart-3d-spec.js';
+/**
+ * The oblique chart camera. Camera distance is chosen so `NEAR`/`FAR` stay
+ * tight around the scene's own (tiny) depth extent. Exported for tests.
+ */
+export declare function buildObliqueCamera(three: ThreeModule, svgWidth: number, svgHeight: number, shearX: number, shearY: number): THREE.OrthographicCamera;
+type ThreeModule = typeof THREE;
+export declare function mountChart3DView(spec: Chart3DSpec, ctx: ThreeViewContext): Promise<ThreeViewScene>;
+export {};
+//# sourceMappingURL=chart-3d-view-scene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-3d-view-scene.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/chart-3d-view-scene.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,KAAK,CAAC,kBAAkB,CA0B1B;AAED,KAAK,WAAW,GAAG,OAAO,KAAK,CAAC;AAEhC,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,gBAAgB,GACnB,OAAO,CAAC,cAAc,CAAC,CA8FzB"}