pptx-angular-viewer 4.10.1 → 4.11.0

package/CHANGELOG.md

@@ -7,6 +7,13 @@ A release listed with no entries carried no Conventional Commit in this package'
 scope: scripts/release-plan.mjs re-releases a package whenever any of its files
 change, not only on conventional ones.
 
+## [4.10.1](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@4.10.1) - 2026-09-26
+
+### Bug Fixes
+
+- **shared:** Fit SmartArt light rigs' key light under a scene camera (by @claude) ([91394b0](https://github.com/ChristopherVR/pptx-viewer/commit/91394b03ee8f68536e8099e15997465b0d257a95))
+- **shared:** Keep a 3D view's scene across a move and a same-task re-attach (by @claude) ([5bc411c](https://github.com/ChristopherVR/pptx-viewer/commit/5bc411cb3ba2d0613bddb678be7c5eae3972d806))
+
 ## [4.10.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@4.10.0) - 2026-09-26
 
 ### Features

package/fesm2022/{pptx-angular-viewer-chart-3d-view-scene-CreE1jB0.mjs → pptx-angular-viewer-chart-3d-view-scene-Cfk7dMVK.mjs}

@@ -1,4 +1,4 @@
-import { s as shade, c as createSvgEl, a as appendChartLegendSvg, r as renderChartLineSvg, b as renderChartTextSvg, C as CHART_3D_DRAG_THRESHOLD_PX, d as buildBarChart3DHoverTooltip, i as isChartInteractionArmed, e as roundDragValue, o as obliqueBarTaper, p as perspBoxMatrix, D as DEFAULT_PALETTE, f as buildPerspCamera, g as perspToScreen, h as pieRimPoint, j as computePieChartLayout, k as perspScreenToPlaneY, l as resolvePieSliceShareValue, m as createSurfaceChart3DScene, n as createPieChart3DScene, q as createAreaChart3DScene, u as createLineChart3DScene, v as createBarChart3DScene, w as widenPieViewModel } from './pptx-angular-viewer-pptx-angular-viewer-DvjSjGWC.mjs';
+import { s as shade, c as createSvgEl, a as appendChartLegendSvg, r as renderChartLineSvg, b as renderChartTextSvg, d as buildBarChart3DHoverTooltip, i as isChartInteractionArmed, e as roundDragValue, o as obliqueBarTaper, p as perspBoxMatrix, D as DEFAULT_PALETTE, f as buildPerspCamera, g as perspToScreen, h as pieRimPoint, j as computePieChartLayout, k as perspScreenToPlaneY, l as resolvePieSliceShareValue, w as widenPieViewModel } from './pptx-angular-viewer-pptx-angular-viewer-Dy62s3Dt.mjs';
 
 /**
  * chart-3d-shading.ts: PowerPoint's flat chart-space shading for a 3D chart's
@@ -383,6 +383,70 @@ function appendBoxLabels(doc, svg, vm, labels) {
     }
 }
 
+/**
+ * Minimum pointer travel (px) before a mark press becomes a value drag,
+ * mirroring {@link CHART_DRAG_THRESHOLD_PX} (`chart-canvas-drag.ts`): without
+ * a threshold, every click on a mark would commit a (tiny) value change, so a
+ * user could never select a mark without editing it.
+ */
+const CHART_3D_DRAG_THRESHOLD_PX = 3;
+/** Emissive colour + intensity applied to a selected mark's material. */
+const CHART_3D_SELECTED_EMISSIVE = '#3b82f6';
+const CHART_3D_SELECTED_EMISSIVE_INTENSITY = 0.55;
+/**
+ * Map a 3D raycast hit (or none) to the same selection descriptor the 2D
+ * chart-interaction model uses.
+ */
+function chart3DHitToPartRef(hit) {
+    if (!hit) {
+        return null;
+    }
+    return { role: 'dataPoint', seriesIndex: hit.seriesIndex, pointIndex: hit.pointIndex };
+}
+/** Whether a mesh's own (series, point) reference is the currently-selected part. */
+function chart3DMarkMatchesPart(mark, part) {
+    return (part !== null &&
+        part !== undefined &&
+        part.role === 'dataPoint' &&
+        part.seriesIndex === mark.seriesIndex &&
+        part.pointIndex === mark.pointIndex);
+}
+/**
+ * Calibrate a value axis from two already-projected screen points known to
+ * correspond to two distinct data values on the same mark (e.g. its
+ * value-zero base and its current top). Returns `null` when the two values
+ * coincide or the two screen points are (near) coincident (camera looking
+ * straight down the axis), since no calibration is possible.
+ *
+ * Order-independent: swapping `(screenAtValue0, value0)` with
+ * `(screenAtValue1, value1)` yields the same {@link chart3DPointerDeltaToValueDelta}
+ * result, since the direction vector and `pixelsPerUnit` sign flip together.
+ */
+function calibrateChart3DValueAxis(screenAtValue0, value0, screenAtValue1, value1) {
+    const valueSpan = value1 - value0;
+    const dx = screenAtValue1.x - screenAtValue0.x;
+    const dy = screenAtValue1.y - screenAtValue0.y;
+    const pixelSpan = Math.hypot(dx, dy);
+    if (valueSpan === 0 || pixelSpan < 1e-6 || !Number.isFinite(valueSpan)) {
+        return null;
+    }
+    return {
+        directionScreen: { x: dx / pixelSpan, y: dy / pixelSpan },
+        pixelsPerUnit: pixelSpan / valueSpan,
+    };
+}
+/**
+ * Convert a screen-space pointer delta (current position minus drag-start
+ * position, in CSS px) into a value delta, using a calibration taken at drag
+ * start. Add the result to the mark's value at drag start to get the live
+ * (or committed) dragged value.
+ */
+function chart3DPointerDeltaToValueDelta(calibration, pointerDeltaScreen) {
+    const dot = pointerDeltaScreen.x * calibration.directionScreen.x +
+        pointerDeltaScreen.y * calibration.directionScreen.y;
+    return dot / calibration.pixelsPerUnit;
+}
+
 function partOf(point) {
     return point
         ? { role: 'dataPoint', seriesIndex: point.seriesIndex, pointIndex: point.pointIndex }
@@ -683,6 +747,7 @@ function buildPerspBarPrisms(chartData, layout, override) {
                     neg = to;
                 }
             }
+            const shape = chartData.series[s]?.shape ?? chartData.barShape ?? 'box';
             const slotIndex = layout.grouping === 'clustered' ? s : 0;
             const row = layout.grouping === 'standard' ? s : 0;
             const c0 = c * slot + (gapWidth * barW) / 2 + slotIndex * barW;
@@ -705,6 +770,9 @@ function buildPerspBarPrisms(chartData, layout, override) {
                 ],
                 z0,
                 z1: z0 + depth,
+                shape,
+                taper: obliqueBarTaper(shape, v0, v1, (layout.range.max - layout.range.min) * layout.valueScale, raw),
+                horizontal: layout.horizontal,
             });
         }
     }
@@ -797,6 +865,44 @@ function buildPerspPrisms(chartData, layout, override) {
     return prisms;
 }
 
+/** Whether a prism is drawn as a shaped solid rather than an extrusion. */
+function isShapedPerspPrism(prism) {
+    return prism.shape !== undefined && prism.shape !== 'box';
+}
+/** The prism's box-space bounding box: `[x0, x1, y0, y1]`. */
+function outlineBounds(prism) {
+    const xs = prism.outline.map(([x]) => x);
+    const ys = prism.outline.map(([, y]) => y);
+    return [Math.min(...xs), Math.max(...xs), Math.min(...ys), Math.max(...ys)];
+}
+/** A shaped bar's geometry in box space, with shading baked into vertex colours. */
+function buildShapedPrismGeometry(three, prism) {
+    const shape = prism.shape ?? 'box';
+    const unit = buildObliqueShapeGeometry(three, { shape, taper: prism.taper ?? { bottom: 1, top: 1 } }, Boolean(prism.horizontal));
+    const geometry = unit.index ? unit.toNonIndexed() : unit;
+    if (geometry !== unit) {
+        unit.dispose();
+    }
+    const [x0, x1, y0, y1] = outlineBounds(prism);
+    const sx = Math.max(x1 - x0, 1e-6);
+    const sy = Math.max(y1 - y0, 1e-6);
+    const sz = Math.max(prism.z1 - prism.z0, 1e-6);
+    geometry.scale(sx, sy, sz);
+    geometry.translate((x0 + x1) / 2, (y0 + y1) / 2, (prism.z0 + prism.z1) / 2);
+    geometry.computeVertexNormals();
+    const normals = geometry.getAttribute('normal');
+    const colors = new Float32Array(normals.count * 3);
+    const base = new three.Color(prism.color).getRGB(new three.Color(), three.SRGBColorSpace);
+    const out = new three.Color();
+    for (let i = 0; i < normals.count; i++) {
+        const f = chart3DNormalShade(shape, normals.getX(i), normals.getY(i), -normals.getZ(i));
+        out.setRGB(Math.min(1, base.r * f), Math.min(1, base.g * f), Math.min(1, base.b * f), three.SRGBColorSpace);
+        colors.set([out.r, out.g, out.b], i * 3);
+    }
+    geometry.setAttribute('color', new three.Float32BufferAttribute(colors, 3));
+    return geometry;
+}
+
 /** PowerPoint's default major gridline colour (tx1 at 15% tint, `#D9D9D9`). */
 const GRIDLINE_COLOR = 0xd9d9d9;
 /** Bake face shading into a geometry's vertex colours. */
@@ -817,6 +923,9 @@ function shadePerspGeometry(three, geometry, color) {
 }
 /** An extruded, shaded prism geometry in box space. */
 function buildPrismGeometry(three, prism) {
+    if (isShapedPerspPrism(prism)) {
+        return buildShapedPrismGeometry(three, prism);
+    }
     const shape = new three.Shape(prism.outline.map(([x, y]) => new three.Vector2(x, y)));
     const extruded = new three.ExtrudeGeometry(shape, {
         depth: Math.max(prism.z1 - prism.z0, 1e-6),
@@ -1612,25 +1721,6 @@ function buildObliqueCamera(three, svgWidth, svgHeight, shearX, shearY) {
     camera.projectionMatrixInverse.copy(camera.projectionMatrix).invert();
     return camera;
 }
-/** The hosted perspective scene for a spec whose oblique geometry is `null`. */
-function mountPerspectiveScene(perspective, ctx) {
-    switch (perspective.kind) {
-        case 'bar':
-            return createBarChart3DScene(ctx, perspective.options);
-        case 'line':
-            return createLineChart3DScene(ctx, perspective.options);
-        case 'area':
-            return createAreaChart3DScene(ctx, perspective.options);
-        case 'pie':
-            return createPieChart3DScene(ctx, perspective.options);
-        case 'surface':
-            return createSurfaceChart3DScene(ctx, perspective.options);
-        default: {
-            const exhaustive = perspective;
-            return exhaustive;
-        }
-    }
-}
 async function mountChart3DView(spec, ctx) {
     if (spec.geometry?.kind === 'pie') {
         const chartData = spec.element.chartData;
@@ -1653,9 +1743,6 @@ async function mountChart3DView(spec, ctx) {
         return mountPerspChartView({ vm: spec.vm, layout: spec.geometry.layout, chartData, categoryLabels: spec.categoryLabels }, ctx);
     }
     if (spec.projection.mode !== 'oblique' || spec.geometry?.kind !== 'oblique') {
-        if (spec.perspective) {
-            return mountPerspectiveScene(spec.perspective, ctx);
-        }
         throw new Error(`no 3D chart scene for chartType=${spec.chartType}`);
     }
     const three = ctx.three;
@@ -1714,4 +1801,4 @@ async function mountChart3DView(spec, ctx) {
 }
 
 export { buildObliqueCamera, mountChart3DView };
-//# sourceMappingURL=pptx-angular-viewer-chart-3d-view-scene-CreE1jB0.mjs.map
+//# sourceMappingURL=pptx-angular-viewer-chart-3d-view-scene-Cfk7dMVK.mjs.map