ooxml-ui 0.30.1 → 1.0.0

package/dist/pptx/chunk-RQJOOXRG.mjs

@@ -0,0 +1,864 @@
+// src/pptx/render/visual-3d-camera-presets.ts
+var DEFAULT_CUSTOM_REF_PX = 800;
+var CAMERA_PRESET_MAP = {
+  orthographicFront: { rotateX: 0, rotateY: 0, rotateZ: 0 },
+  perspectiveFront: { perspectiveRefPx: 1e3, rotateX: 0, rotateY: 0, rotateZ: 0 },
+  perspectiveAbove: { perspectiveRefPx: 1e3, rotateX: 20, rotateY: 0, rotateZ: 0 },
+  perspectiveBelow: { perspectiveRefPx: 1e3, rotateX: -20, rotateY: 0, rotateZ: 0 },
+  perspectiveLeft: { perspectiveRefPx: 1e3, rotateX: 0, rotateY: -20, rotateZ: 0 },
+  perspectiveRight: { perspectiveRefPx: 1e3, rotateX: 0, rotateY: 20, rotateZ: 0 },
+  perspectiveAboveLeftFacing: { perspectiveRefPx: 1e3, rotateX: 20, rotateY: -25, rotateZ: 0 },
+  perspectiveAboveRightFacing: { perspectiveRefPx: 1e3, rotateX: 20, rotateY: 25, rotateZ: 0 },
+  perspectiveContrastingLeftFacing: {
+    perspectiveRefPx: 800,
+    rotateX: 15,
+    rotateY: -30,
+    rotateZ: 0,
+    perspectiveOriginXPct: 93,
+    perspectiveOriginYPct: 0
+  },
+  perspectiveContrastingRightFacing: {
+    perspectiveRefPx: 800,
+    rotateX: 15,
+    rotateY: 30,
+    rotateZ: 0,
+    perspectiveOriginXPct: 7,
+    perspectiveOriginYPct: 0
+  },
+  perspectiveHeroicLeftFacing: { perspectiveRefPx: 600, rotateX: 10, rotateY: -35, rotateZ: 0 },
+  perspectiveHeroicRightFacing: { perspectiveRefPx: 600, rotateX: 10, rotateY: 35, rotateZ: 0 },
+  perspectiveHeroicExtremeLeftFacing: {
+    perspectiveRefPx: 500,
+    rotateX: 8,
+    rotateY: -45,
+    rotateZ: 0,
+    perspectiveOriginXPct: 32,
+    perspectiveOriginYPct: 42
+  },
+  perspectiveHeroicExtremeRightFacing: {
+    perspectiveRefPx: 500,
+    rotateX: 8,
+    rotateY: 45,
+    rotateZ: 0,
+    perspectiveOriginXPct: 68,
+    perspectiveOriginYPct: 42
+  },
+  perspectiveRelaxed: { perspectiveRefPx: 1200, rotateX: 10, rotateY: 0, rotateZ: 0 },
+  perspectiveRelaxedModerately: { perspectiveRefPx: 1400, rotateX: 5, rotateY: 0, rotateZ: 0 },
+  // No `perspectiveRefPx` on any isometric* preset: COM-measured real
+  // PowerPoint output shows a true parallelogram (parallel projection, not
+  // perspective) for these, see `visual-3d-camera`'s module doc comment.
+  isometricLeftDown: { rotateX: -35, rotateY: 45, rotateZ: 0 },
+  isometricRightUp: { rotateX: -35, rotateY: -45, rotateZ: 0 },
+  isometricLeftUp: { rotateX: 35, rotateY: 45, rotateZ: 0 },
+  isometricRightDown: { rotateX: 35, rotateY: -45, rotateZ: 0 },
+  isometricTopUp: { rotateX: -55, rotateY: 0, rotateZ: 45 },
+  isometricTopDown: { rotateX: -55, rotateY: 0, rotateZ: -45 },
+  isometricBottomUp: { rotateX: 55, rotateY: 0, rotateZ: 45 },
+  isometricBottomDown: { rotateX: 55, rotateY: 0, rotateZ: -45 },
+  isometricOffAxis1Left: { rotateX: -30, rotateY: 30, rotateZ: 0 },
+  isometricOffAxis1Right: { rotateX: -30, rotateY: -30, rotateZ: 0 },
+  isometricOffAxis1Top: { rotateX: -45, rotateY: 0, rotateZ: 30 },
+  isometricOffAxis2Left: { rotateX: -30, rotateY: 20, rotateZ: 0 },
+  isometricOffAxis2Right: { rotateX: -30, rotateY: -20, rotateZ: 0 },
+  isometricOffAxis2Top: { rotateX: -45, rotateY: 0, rotateZ: -30 },
+  isometricOffAxis3Left: { rotateX: -25, rotateY: 35, rotateZ: 0 },
+  isometricOffAxis3Right: { rotateX: -25, rotateY: -35, rotateZ: 0 },
+  isometricOffAxis3Bottom: { rotateX: 45, rotateY: 0, rotateZ: 30 },
+  isometricOffAxis4Left: { rotateX: -25, rotateY: 25, rotateZ: 0 },
+  isometricOffAxis4Right: { rotateX: -25, rotateY: -25, rotateZ: 0 },
+  isometricOffAxis4Bottom: { rotateX: 45, rotateY: 0, rotateZ: -30 },
+  obliqueTopLeft: { perspectiveRefPx: 900, rotateX: -20, rotateY: 20, rotateZ: 0 },
+  obliqueTop: { perspectiveRefPx: 900, rotateX: -25, rotateY: 0, rotateZ: 0 },
+  obliqueTopRight: { perspectiveRefPx: 900, rotateX: -20, rotateY: -20, rotateZ: 0 },
+  obliqueLeft: { perspectiveRefPx: 900, rotateX: 0, rotateY: 25, rotateZ: 0 },
+  obliqueRight: { perspectiveRefPx: 900, rotateX: 0, rotateY: -25, rotateZ: 0 },
+  obliqueBottomLeft: { perspectiveRefPx: 900, rotateX: 20, rotateY: 20, rotateZ: 0 },
+  obliqueBottom: { perspectiveRefPx: 900, rotateX: 25, rotateY: 0, rotateZ: 0 },
+  obliqueBottomRight: { perspectiveRefPx: 900, rotateX: 20, rotateY: -20, rotateZ: 0 },
+  // Pre-2007 (legacy) WordArt/AutoShape 3-D camera names. Schema-legal but not
+  // exposed in the modern "3-D Rotation" gallery; they only surface via files
+  // round-tripped from legacy Office or hand-authored XML.
+  legacyObliqueTopLeft: { perspectiveRefPx: 900, rotateX: -20, rotateY: 20, rotateZ: 0 },
+  legacyObliqueTop: { perspectiveRefPx: 900, rotateX: -25, rotateY: 0, rotateZ: 0 },
+  legacyObliqueTopRight: { perspectiveRefPx: 900, rotateX: -20, rotateY: -20, rotateZ: 0 },
+  legacyObliqueLeft: { perspectiveRefPx: 900, rotateX: 0, rotateY: 25, rotateZ: 0 },
+  legacyObliqueFront: { perspectiveRefPx: 900, rotateX: 0, rotateY: 0, rotateZ: 0 },
+  legacyObliqueRight: { perspectiveRefPx: 900, rotateX: 0, rotateY: -25, rotateZ: 0 },
+  legacyObliqueBottomLeft: { perspectiveRefPx: 900, rotateX: 20, rotateY: 20, rotateZ: 0 },
+  legacyObliqueBottom: { perspectiveRefPx: 900, rotateX: 25, rotateY: 0, rotateZ: 0 },
+  legacyObliqueBottomRight: { perspectiveRefPx: 900, rotateX: 20, rotateY: -20, rotateZ: 0 },
+  legacyPerspectiveTopLeft: { perspectiveRefPx: 700, rotateX: -30, rotateY: 30, rotateZ: 0 },
+  legacyPerspectiveTop: { perspectiveRefPx: 700, rotateX: -35, rotateY: 0, rotateZ: 0 },
+  legacyPerspectiveTopRight: { perspectiveRefPx: 700, rotateX: -30, rotateY: -30, rotateZ: 0 },
+  legacyPerspectiveLeft: { perspectiveRefPx: 700, rotateX: 0, rotateY: 35, rotateZ: 0 },
+  legacyPerspectiveFront: { perspectiveRefPx: 700, rotateX: 0, rotateY: 0, rotateZ: 0 },
+  legacyPerspectiveRight: { perspectiveRefPx: 700, rotateX: 0, rotateY: -35, rotateZ: 0 },
+  legacyPerspectiveBottomLeft: { perspectiveRefPx: 700, rotateX: 30, rotateY: 30, rotateZ: 0 },
+  legacyPerspectiveBottom: { perspectiveRefPx: 700, rotateX: 35, rotateY: 0, rotateZ: 0 },
+  legacyPerspectiveBottomRight: { perspectiveRefPx: 700, rotateX: 30, rotateY: -30, rotateZ: 0 }
+};
+
+// src/pptx/render/smartart-3d-scene-camera.ts
+var DEFAULT_PERSPECTIVE_DISTANCE = 6;
+var MEASURED_SQUARE_PX = 192;
+var SCENE_CAMERA_PRESETS = {
+  orthographicFront: { lat: 0, lon: 0, rev: 0 },
+  perspectiveFront: { lat: 0, lon: 0, rev: 0, distance: 160 },
+  perspectiveLeft: { lat: 0, lon: 20.4, rev: 0, distance: 8.3 },
+  perspectiveRight: { lat: 0, lon: -20.4, rev: 0, distance: 8.3 },
+  perspectiveRelaxed: { lat: -50.8, lon: 0.3, rev: -0.2, distance: 7.8 },
+  perspectiveRelaxedModerately: { lat: -35.1, lon: 0, rev: 0, distance: 7.9 },
+  perspectiveHeroicExtremeRightFacing: { lat: 8, lon: -36.1, rev: 2.1, distance: 4.2 },
+  perspectiveHeroicExtremeLeftFacing: { lat: 8, lon: 36.1, rev: -2.1, distance: 4.2 },
+  isometricOffAxis2Left: { lat: 18, lon: 26, rev: 0 },
+  isometricOffAxis2Right: { lat: 18, lon: -26, rev: 0 }
+};
+var DEG_PER_UNIT = 6e4;
+function toDeg(value) {
+  return value ? value / DEG_PER_UNIT : 0;
+}
+function normalizeZoom(value) {
+  if (!value || value <= 0) {
+    return 1;
+  }
+  return value > 10 ? value / 1e5 : value;
+}
+function presetPose(preset) {
+  const fitted = SCENE_CAMERA_PRESETS[preset];
+  if (fitted) {
+    return fitted;
+  }
+  const legacy = CAMERA_PRESET_MAP[preset];
+  const perspective = preset.startsWith("perspective");
+  return {
+    lat: legacy?.rotateX ?? 0,
+    lon: legacy?.rotateY ?? 0,
+    rev: legacy?.rotateZ ?? 0,
+    ...perspective ? { distance: DEFAULT_PERSPECTIVE_DISTANCE } : {}
+  };
+}
+function resolveSmartArt3DCamera(scene) {
+  if (!scene) {
+    return void 0;
+  }
+  const preset = scene.cameraPreset ?? "orthographicFront";
+  const pose = presetPose(preset);
+  const hasRot = scene.cameraRotX !== void 0 || scene.cameraRotY !== void 0 || scene.cameraRotZ !== void 0;
+  const latDeg = hasRot ? toDeg(scene.cameraRotX) : pose.lat;
+  const lonDeg = hasRot ? toDeg(scene.cameraRotY) : pose.lon;
+  const revDeg = hasRot ? toDeg(scene.cameraRotZ) : pose.rev;
+  const distance = pose.distance === void 0 ? void 0 : pose.distance * MEASURED_SQUARE_PX;
+  const zoom = normalizeZoom(scene.cameraZoom);
+  if (latDeg === 0 && lonDeg === 0 && revDeg === 0 && distance === void 0 && zoom === 1) {
+    return void 0;
+  }
+  return {
+    projection: distance === void 0 ? "orthographic" : "perspective",
+    latDeg,
+    lonDeg,
+    revDeg,
+    distance: distance ?? 0,
+    zoom
+  };
+}
+function smartArt3DCameraMatrix(camera) {
+  const rad = Math.PI / 180;
+  const cl = Math.cos(camera.latDeg * rad);
+  const sl = Math.sin(camera.latDeg * rad);
+  const co = Math.cos(-camera.lonDeg * rad);
+  const so = Math.sin(-camera.lonDeg * rad);
+  const cr = Math.cos(camera.revDeg * rad);
+  const sr = Math.sin(camera.revDeg * rad);
+  const m = [co, 0, so, sl * so, cl, -sl * co, -cl * so, sl, cl * co];
+  return [
+    cr * m[0] - sr * m[3],
+    cr * m[1] - sr * m[4],
+    cr * m[2] - sr * m[5],
+    sr * m[0] + cr * m[3],
+    sr * m[1] + cr * m[4],
+    sr * m[2] + cr * m[5],
+    m[6],
+    m[7],
+    m[8]
+  ];
+}
+function smartArt3DEyeInDiagram(camera) {
+  if (camera.projection !== "perspective") {
+    return void 0;
+  }
+  const m = smartArt3DCameraMatrix(camera);
+  return { x: m[6] * camera.distance, y: m[7] * camera.distance, z: m[8] * camera.distance };
+}
+
+// src/pptx/render/smartart-3d-light-rig.ts
+var DEFAULT_HIGHLIGHT_ELEVATION_DEG = 60;
+var DEFAULT_HIGHLIGHT = [
+  { azimuthDeg: 0, elevationDeg: DEFAULT_HIGHLIGHT_ELEVATION_DEG, intensity: 1, sharpness: 1 }
+];
+var SMARTART_RIG_SPECULAR_LIGHTS = {
+  threePt: [{ azimuthDeg: 64, elevationDeg: 44, intensity: 4.6, sharpness: 3 }]
+};
+function smartArt3DRigSpecularLights(rig, perspective) {
+  const own = perspective && rig ? SMARTART_RIG_SPECULAR_LIGHTS[rig] : void 0;
+  return own ?? DEFAULT_HIGHLIGHT;
+}
+var SMARTART_RIG_SCENE_KEY_LIGHTS = {
+  flat: { azimuthDeg: 0, elevationDeg: 40 },
+  threePt: { azimuthDeg: 0, elevationDeg: 90 },
+  morning: { azimuthDeg: 0, elevationDeg: 60 },
+  soft: { azimuthDeg: 0, elevationDeg: 80 }
+};
+function smartArt3DRigKeyLight(rig, sceneCamera) {
+  return sceneCamera && rig ? SMARTART_RIG_SCENE_KEY_LIGHTS[rig] : void 0;
+}
+
+// src/pptx/render/visual-3d-bevel-light.ts
+var DIRECTION_ANGLE = {
+  t: 0,
+  tr: 45,
+  r: 90,
+  br: 135,
+  b: 180,
+  bl: 225,
+  l: 270,
+  tl: 315
+};
+var CARDINAL_VECTORS = {
+  0: { dx: 0, dy: -1 },
+  // t
+  90: { dx: 1, dy: 0 },
+  // r
+  180: { dx: 0, dy: 1 },
+  // b
+  270: { dx: -1, dy: 0 }
+  // l
+};
+function getBevelHighlightDirection(lightRigDirection) {
+  if (!lightRigDirection) {
+    return { dx: -1, dy: -1 };
+  }
+  const angle = DIRECTION_ANGLE[lightRigDirection];
+  if (angle === void 0) {
+    return { dx: -1, dy: -1 };
+  }
+  const bucket = Math.floor(angle / 90) * 90;
+  return CARDINAL_VECTORS[bucket] ?? { dx: -1, dy: -1 };
+}
+function isBevelProfileInverted(bevelType) {
+  return bevelType === "softRound";
+}
+
+// src/pptx/render/visual-3d-bevel-lighting-profile.ts
+var BEVEL_PROFILE_HEIGHT_MAP = {
+  circle: { blurFactor: 0.35, surfaceScaleFactor: 0.65, measuredUniform: false },
+  convex: {
+    blurFactor: 0.18,
+    morphologyFactor: 0.4,
+    surfaceScaleFactor: 0.2,
+    measuredUniform: false
+  },
+  softRound: {
+    blurFactor: 0.25,
+    morphologyFactor: 0.4,
+    surfaceScaleFactor: 0.65,
+    measuredUniform: false
+  },
+  relaxedInset: {
+    blurFactor: 0.35,
+    morphologyFactor: 0.5,
+    surfaceScaleFactor: 1.5,
+    measuredUniform: false,
+    // Normalised (0-1) directly from the pinned 24pt COM cross-section
+    // curve (`visual-3d-bevel-lighting-tables.test.ts`'s
+    // `MEASURED_24PT_CURVES.relaxedInset`, brightness 113.0/135.7/139.0/
+    // 137.0/60.0/85.3/126.3/133.0/133.0/133.0): peaks at stop 2, troughs at
+    // stop 4, recovers to flat by stop 6. See `heightTransferTable`'s doc
+    // comment.
+    heightTransferTable: [0.671, 0.958, 1, 0.975, 0, 0.32, 0.839, 0.924, 0.924, 0.924]
+  },
+  divot: { blurFactor: 0.18, surfaceScaleFactor: 0.5, measuredUniform: false },
+  angle: {
+    blurFactor: 0.35,
+    morphologyFactor: 0.4,
+    surfaceScaleFactor: 0.35,
+    measuredUniform: false
+  },
+  cross: {
+    blurFactor: 0.12,
+    morphologyFactor: 0.18,
+    surfaceScaleFactor: 0.2,
+    measuredUniform: false
+  },
+  coolSlant: {
+    blurFactor: 0.25,
+    morphologyFactor: 0.06,
+    surfaceScaleFactor: 0.5,
+    measuredUniform: false
+  },
+  riblet: {
+    blurFactor: 0.25,
+    surfaceScaleFactor: 0.5,
+    measuredUniform: false
+  },
+  artDeco: {
+    blurFactor: 0.18,
+    morphologyFactor: 0.32,
+    surfaceScaleFactor: 0.35,
+    measuredUniform: false
+  },
+  // `relaxedInset`/`slope`/`hardEdge` (see this table's doc comment): COM
+  // measured a genuine BRIGHT-BUMP-THEN-DARK-TROUGH double transition for
+  // all three, which the blur(+erode) ramp's ORIGINAL 3 factors alone cannot
+  // reproduce (its height field has one bell-shaped slope lobe, so the
+  // diffuse/specular response can only rise-then-settle, never
+  // rise-then-undershoot-then-settle). These 3 factors are kept as the
+  // closest achievable fit for the underlying ramp's width/crispness; each
+  // profile's `heightTransferTable` (see that field's doc comment) supplies
+  // the actual non-monotonic double transition on top of that ramp.
+  slope: {
+    blurFactor: 0.55,
+    morphologyFactor: 0.5,
+    surfaceScaleFactor: 1.5,
+    measuredUniform: true,
+    // Normalised from `MEASURED_24PT_CURVES.slope` (114.0/134.7/133.3/
+    // 133.0/91.7/110.0/96.0/133.0/133.0/133.0): peaks at stop 1, dips at
+    // stop 4, a second shallower dip at stop 6, recovers by stop 7.
+    heightTransferTable: [0.519, 1, 0.967, 0.96, 0, 0.426, 0.1, 0.96, 0.96, 0.96]
+  },
+  hardEdge: {
+    blurFactor: 0.55,
+    morphologyFactor: 0.5,
+    surfaceScaleFactor: 1.5,
+    measuredUniform: true,
+    // Normalised from `MEASURED_24PT_CURVES.hardEdge` (111.7/135.0/133.0/
+    // 133.0/102.7/104.0/128.3/133.0/133.0/133.0): peaks at stop 1, troughs
+    // at stop 4, recovers by stop 6.
+    heightTransferTable: [0.279, 1, 0.938, 0.938, 0, 0.04, 0.793, 0.938, 0.938, 0.938]
+  }
+};
+var DEFAULT_HEIGHT_MAP = {
+  blurFactor: 0.4,
+  surfaceScaleFactor: 0.8,
+  measuredUniform: false
+};
+function getBevelProfileHeightMap(bevelType) {
+  return BEVEL_PROFILE_HEIGHT_MAP[bevelType] ?? DEFAULT_HEIGHT_MAP;
+}
+
+// src/pptx/render/visual-3d-bevel-lighting-material.ts
+var white = "#ffffff";
+var MATERIAL_LIGHTING = {
+  matte: {
+    diffuseConstant: 0.9,
+    specularConstant: 0.02,
+    specularExponent: 4,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  warmMatte: {
+    diffuseConstant: 0.9,
+    specularConstant: 0.03,
+    specularExponent: 4,
+    lightingColor: "#fff4e6",
+    surfaceScaleMultiplier: 1
+  },
+  powder: {
+    diffuseConstant: 0.85,
+    specularConstant: 0.02,
+    specularExponent: 4,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  translucentPowder: {
+    diffuseConstant: 0.8,
+    specularConstant: 0.08,
+    specularExponent: 6,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  plastic: {
+    diffuseConstant: 0.85,
+    specularConstant: 0.35,
+    specularExponent: 12,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  clear: {
+    diffuseConstant: 0.7,
+    specularConstant: 0.45,
+    specularExponent: 16,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  softEdge: {
+    diffuseConstant: 0.85,
+    specularConstant: 0.15,
+    specularExponent: 8,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  dkEdge: {
+    diffuseConstant: 0.75,
+    specularConstant: 0.2,
+    specularExponent: 14,
+    lightingColor: "#f0f0f0",
+    surfaceScaleMultiplier: 1
+  },
+  softmetal: {
+    diffuseConstant: 0.65,
+    specularConstant: 0.6,
+    specularExponent: 16,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  // Re-calibrated (2026-09, manual coordinate search evaluated against the
+  // real render-vs-COM pipeline used throughout this module, all 4
+  // `a:lightRig/@dir` values): the previous (diffuseConstant 0.55,
+  // specularConstant 0.9, specularExponent 28, surfaceScaleMultiplier
+  // implicitly 1) combination regressed `circle` specifically (54.9 ->
+  // 80.1 mean error). This combination (surfaceScaleMultiplier 0.35,
+  // diffuseConstant raised to 0.75) VERIFIED to bring `angle`, `hardEdge`
+  // and `softRound` at or below the box-shadow baseline in EVERY direction
+  // (`angle`: baseline ~70, now ~19-27; `hardEdge`: baseline ~69.5, now 44;
+  // `softRound`: baseline ~50, now 6.5-19). `circle` alone could NOT be
+  // brought below baseline with any tested combination of these four
+  // MATERIAL parameters (tried down to `surfaceScaleMultiplier` 0.15 and up
+  // to 2.5) against the then-current (ECMA-376-reasoned) profile table, and
+  // was routed to the legacy `box-shadow` model instead of shipping a
+  // regression. SUPERSEDED 2026-09: re-fitting the PROFILE table's own
+  // `circle` entry against real COM data (a change orthogonal to these
+  // material constants) resolved it without touching the numbers below; see
+  // this file's module doc comment and `visual-3d-bevel-lighting-routing
+  // .ts`.
+  //
+  // A SEPARATE, more severe issue was found (2026-09, while attempting an
+  // ambient/wrap-term fix for the `circle` routing above) that this
+  // calibration was never tested against: `specularConstant: 0.9` combined
+  // with `specularExponent: 24` was tuned against `threePt` at its OLD
+  // (pre-COM-calibration) `elevationDeg` of 45. `LIGHT_RIG_LIGHTING`'s real
+  // per-rig COM campaign now measures `threePt` at `elevationDeg: 74`, and
+  // several other rigs (`contrasting`, the `flat`/`legacyFlat*` family) sit
+  // at 90. `feSpecularLighting`'s hot-spot brightness at a FLAT height-map
+  // region (i.e. the shape's plain, non-bevelled interior, not just the
+  // bevel band: N = (0,0,1) there regardless of `a:bevelT/@prst`, so this
+  // is independent of bevel PROFILE) is `specularConstant *
+  // max(0, N.H)^specularExponent`; solving that formula directly (not
+  // rendered, the closed form) gives 0.135 at elevation 45 (small, as the
+  // original calibration assumed) but 0.71 at elevation 74 and 0.9 (the
+  // full `specularConstant`, N.H=1 exactly) at elevation 90 - confirmed by
+  // actually rendering the real filter chain (a pure-SVG render matching
+  // `resolveLayer`'s output byte-for-byte): a `metal`/`circle` square under
+  // `threePt` now samples FULLY SATURATED (255,255,255) at its edge bands
+  // AND its flat center alike, not just a shadow-side clamp. This means the
+  // `circle`-only routing above no longer isolates the real defect for
+  // these rigs: the whole shape washes out, so an ambient/wrap term on the
+  // diffuse layer (which only helps the shadow-clamp problem) would not by
+  // itself bring metal back under the box-shadow baseline. This is a
+  // STRUCTURAL gap (this filter drives diffuse falloff and the specular
+  // hot-spot from the SAME `feDistantLight` elevation, but a coupling this
+  // codebase's simplified model never validated), not specific to `circle`
+  // or to this pass's elevation recalibration (`flat`'s elevationDeg was
+  // already ~90 before this campaign, so the same saturation already
+  // existed for `metal` under the `flat` rig family; the campaign only
+  // widened which rigs trigger it, by correcting `threePt`/`contrasting`
+  // toward their real measured values). Re-tuning `specularConstant`/
+  // `specularExponent` (or decoupling a separate specular elevation from
+  // the diffuse one) needs its own COM campaign and was NOT done here; see
+  // `docs/guide/limitations.md`.
+  // RESOLVED (2026-09-24): the structural "same feDistantLight elevation
+  // drives diffuse falloff AND the specular hot-spot" coupling described
+  // above is fixed by `specularElevationCapDeg` (see `MaterialLighting`'s
+  // doc comment): `Math.min(rigElevationDeg, 45)` bounds the SPECULAR
+  // light's own elevation, leaving diffuse shading (and every low-elevation
+  // rig, which is already below the cap) untouched. A joint coordinate
+  // search of `specularElevationCapDeg`/`specularConstant`/
+  // `specularExponent` (surfaceScaleMultiplier held fixed at 0.35, since
+  // lowering it flattens the DIFFUSE band too and was a different, already
+  // separately-calibrated defect) against real COM ground truth (`Slide
+  // .Export`, mid-grey square, 24pt bevel, headless-Chromium rasterisation
+  // of the ACTUAL filter chain, same pipeline as this module's other
+  // campaigns) - 134 conditions: all 8 `com-main`-campaign rigs x 12
+  // profiles, plus all 19 `com-rigs`-campaign rigs x `circle`/`angle`, all
+  // `dir="t"`, full 96-sample cross-section MAE (not just the 2-edge-point
+  // sample the earlier campaigns used, which cannot see this
+  // flat-interior defect) - found specularConstant 0.5/specularExponent
+  // 16/cap 45deg: mean absolute error (0-255) fell from 75.0 (the previous,
+  // coupled-elevation constants) to 36.4 on this set, driven mostly by the
+  // flat-interior term (centerAE 89.2 -> 20.4). The two previously-tried
+  // remediations documented in `visual-3d-bevel-lighting.ts`'s module doc
+  // (a FIXED specular elevation with the OLD specularConstant/Exponent, and
+  // specular-band masking) are superseded by this cap + re-fit; see that
+  // module's doc for their numbers. Every OTHER material is a structural
+  // no-op (no `specularElevationCapDeg`), so this cannot regress them.
+  metal: {
+    diffuseConstant: 0.75,
+    specularConstant: 0.5,
+    specularExponent: 16,
+    lightingColor: white,
+    surfaceScaleMultiplier: 0.35,
+    specularElevationCapDeg: 45
+  },
+  flat: {
+    diffuseConstant: 0.9,
+    specularConstant: 0,
+    specularExponent: 1,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  legacyMatte: {
+    diffuseConstant: 0.88,
+    specularConstant: 0.02,
+    specularExponent: 4,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  legacyPlastic: {
+    diffuseConstant: 0.82,
+    specularConstant: 0.3,
+    specularExponent: 10,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  },
+  // Not independently calibrated; positioned near the calibrated `metal`
+  // entry (same category) rather than the pre-calibration guess.
+  legacyMetal: {
+    diffuseConstant: 0.7,
+    specularConstant: 0.8,
+    specularExponent: 22,
+    lightingColor: white,
+    surfaceScaleMultiplier: 0.45
+  },
+  legacyWireframe: {
+    diffuseConstant: 0.9,
+    specularConstant: 0.05,
+    specularExponent: 6,
+    lightingColor: white,
+    surfaceScaleMultiplier: 1
+  }
+};
+var DEFAULT_MATERIAL = "warmMatte";
+function getMaterialLighting(material) {
+  const key = material ?? DEFAULT_MATERIAL;
+  return MATERIAL_LIGHTING[key] ?? MATERIAL_LIGHTING[DEFAULT_MATERIAL];
+}
+
+// src/pptx/render/visual-3d-bevel-lighting-tables.ts
+var LIGHT_RIG_LIGHTING = {
+  flat: { elevationDeg: 90, specularSharpness: 0.3 },
+  legacyFlat1: { elevationDeg: 90, specularSharpness: 0.3 },
+  legacyFlat2: { elevationDeg: 77, specularSharpness: 0.3 },
+  legacyFlat3: { elevationDeg: 90, specularSharpness: 0.3 },
+  legacyFlat4: { elevationDeg: 77, specularSharpness: 0.3, invertedDirection: true },
+  harsh: { elevationDeg: 89, specularSharpness: 1.6, invertedDirection: true },
+  contrasting: { elevationDeg: 90, specularSharpness: 1.5 },
+  legacyHarsh1: { elevationDeg: 90, specularSharpness: 1.5 },
+  legacyHarsh2: { elevationDeg: 73, specularSharpness: 1.4 },
+  legacyHarsh3: { elevationDeg: 90, specularSharpness: 1.5 },
+  legacyHarsh4: { elevationDeg: 73, specularSharpness: 1.4, invertedDirection: true },
+  soft: { elevationDeg: 77, specularSharpness: 0.6 },
+  flood: { elevationDeg: 85, specularSharpness: 0.7 },
+  glow: { elevationDeg: 90, specularSharpness: 0.5 },
+  brightRoom: { elevationDeg: 90, specularSharpness: 0.65 },
+  morning: { elevationDeg: 54, specularSharpness: 0.75, invertedDirection: true },
+  sunrise: { elevationDeg: 59, specularSharpness: 0.8, invertedDirection: true },
+  sunset: { elevationDeg: 64, specularSharpness: 0.8, invertedDirection: true },
+  chilly: { elevationDeg: 62, specularSharpness: 0.6, invertedDirection: true },
+  freezing: { elevationDeg: 62, specularSharpness: 0.6, invertedDirection: true },
+  threePt: { elevationDeg: 74, specularSharpness: 1 },
+  balanced: { elevationDeg: 88, specularSharpness: 0.95, invertedDirection: true },
+  twoPt: { elevationDeg: 79, specularSharpness: 1, invertedDirection: true },
+  legacyNormal1: { elevationDeg: 90, specularSharpness: 1 },
+  legacyNormal2: { elevationDeg: 75, specularSharpness: 1 },
+  legacyNormal3: { elevationDeg: 90, specularSharpness: 1 },
+  legacyNormal4: { elevationDeg: 75, specularSharpness: 1, invertedDirection: true }
+};
+var DEFAULT_LIGHT_RIG = { elevationDeg: 45, specularSharpness: 1 };
+function getLightRigLighting(rigType) {
+  if (!rigType) {
+    return DEFAULT_LIGHT_RIG;
+  }
+  return LIGHT_RIG_LIGHTING[rigType] ?? DEFAULT_LIGHT_RIG;
+}
+
+// src/pptx/render/smartart-3d-lighting.ts
+var KEY_ELEVATION_DEG = 5;
+var AMBIENT = 0.5;
+var SPECULAR_GAIN = 0.6;
+var VIEW = { x: 0, y: 0, z: 1 };
+var RIG_REFERENCE_GREY = 127;
+var RIG_FACE_READING = {
+  morning: [112, 108, 98],
+  soft: [121, 121, 121]
+};
+function srgbChannelToLinear(c) {
+  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+function rigTint(rig) {
+  const reading = rig ? RIG_FACE_READING[rig] : void 0;
+  if (!reading) {
+    return [1, 1, 1];
+  }
+  const reference = srgbChannelToLinear(RIG_REFERENCE_GREY / 255);
+  return reading.map((c) => srgbChannelToLinear(c / 255) / reference);
+}
+function dot(a, b) {
+  return a.x * b.x + a.y * b.y + a.z * b.z;
+}
+function normalize(v) {
+  const len = Math.hypot(v.x, v.y, v.z) || 1;
+  return { x: v.x / len, y: v.y / len, z: v.z / len };
+}
+function resolveSmartArt3DLightModel(lighting, material, perspective = false, sceneCamera = perspective) {
+  const snap = getBevelHighlightDirection(lighting?.direction ?? "t");
+  const rev = (lighting?.revDeg ?? 0) * Math.PI / 180;
+  const ax = snap.dx;
+  const ay = -snap.dy;
+  const az = Math.hypot(ax, ay) || 1;
+  const azX = (ax * Math.cos(rev) - ay * Math.sin(rev)) / az;
+  const azY = (ax * Math.sin(rev) + ay * Math.cos(rev)) / az;
+  const toward = (elevationDeg, azimuthDeg = 0) => {
+    const elevation = elevationDeg * Math.PI / 180;
+    const turn = azimuthDeg * Math.PI / 180;
+    const dx = azX * Math.cos(turn) - azY * Math.sin(turn);
+    const dy = azX * Math.sin(turn) + azY * Math.cos(turn);
+    return normalize({
+      x: dx * Math.cos(elevation),
+      y: dy * Math.cos(elevation),
+      z: Math.sin(elevation)
+    });
+  };
+  const response = getMaterialLighting(material);
+  const specular = response.specularConstant * SPECULAR_GAIN;
+  const key = smartArt3DRigKeyLight(lighting?.rig, sceneCamera);
+  return {
+    light: key ? toward(key.elevationDeg, key.azimuthDeg) : toward(KEY_ELEVATION_DEG),
+    highlights: smartArt3DRigSpecularLights(lighting?.rig, perspective).map((rigLight) => ({
+      direction: toward(rigLight.elevationDeg, rigLight.azimuthDeg),
+      weight: specular * rigLight.intensity,
+      exponent: response.specularExponent * rigLight.sharpness
+    })),
+    ambient: AMBIENT,
+    diffuse: response.diffuseConstant,
+    tint: rigTint(lighting?.rig)
+  };
+}
+function shadeSmartArt3DNormal(normal, model, eye) {
+  const lambert = (n) => model.ambient + model.diffuse * Math.max(0, dot(n, model.light));
+  const mul = lambert(normal) / lambert(VIEW);
+  const view = eye ?? VIEW;
+  let add = 0;
+  for (const highlight of model.highlights) {
+    const half = normalize({
+      x: highlight.direction.x + view.x,
+      y: highlight.direction.y + view.y,
+      z: highlight.direction.z + view.z
+    });
+    const peak = (n) => Math.max(0, dot(n, half)) ** highlight.exponent;
+    add += highlight.weight * Math.max(0, peak(normal) - (eye ? 0 : peak(VIEW)));
+  }
+  return { mul, add };
+}
+
+// src/pptx/render/visual-3d-constants.ts
+var EMU_PER_PX = 9525;
+var MAX_EXTRUSION_LAYERS = 40;
+
+// src/pptx/render/smartart-3d-vertex-shading.ts
+function srgbToLinear(c) {
+  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+function hexToRgb(hex) {
+  const match = /^#?([0-9a-f]{6})$/iu.exec(hex.trim());
+  if (!match) {
+    return [0, 0, 0];
+  }
+  const n = Number.parseInt(match[1], 16);
+  return [(n >> 16 & 255) / 255, (n >> 8 & 255) / 255, (n & 255) / 255];
+}
+function normalizeVec(v) {
+  const len = Math.hypot(v.x, v.y, v.z) || 1;
+  return { x: v.x / len, y: v.y / len, z: v.z / len };
+}
+var MIN_LINEAR = 1e-4;
+function shadeSmartArt3DVertices(positions, normals, baseAt, model, eye) {
+  const out = new Float32Array(positions.length);
+  for (let i = 0; i < positions.length; i += 3) {
+    const normal = { x: normals[i], y: normals[i + 1], z: normals[i + 2] };
+    const toEye = eye ? normalizeVec({
+      x: eye.x - positions[i],
+      y: eye.y - positions[i + 1],
+      z: eye.z - positions[i + 2]
+    }) : void 0;
+    const { mul, add } = shadeSmartArt3DNormal(normal, model, toEye);
+    const base = baseAt({ x: positions[i], y: positions[i + 1] });
+    for (let c = 0; c < 3; c++) {
+      const target = Math.min(1, Math.max(0, base[c] * mul + add));
+      const linBase = Math.max(MIN_LINEAR, srgbToLinear(base[c]));
+      out[i + c] = srgbToLinear(target) / linBase * model.tint[c];
+    }
+  }
+  return out;
+}
+
+// src/pptx/render/smartart-3d-style-path.ts
+function hasSmartArtShape3D(shape3d) {
+  if (!shape3d) {
+    return false;
+  }
+  return (shape3d.extrusionHeight ?? 0) > 0 || (shape3d.contourWidth ?? 0) > 0 || (shape3d.bevelTopWidth ?? 0) > 0 || (shape3d.bevelTopHeight ?? 0) > 0 || shape3d.bevelTopType !== void 0 || (shape3d.bevelBottomWidth ?? 0) > 0 || shape3d.bevelBottomType !== void 0;
+}
+function resolveSmartArt3DStylePath(shapes) {
+  if (shapes.some((shape) => shape.scene3d !== void 0)) {
+    return "bevel";
+  }
+  if (shapes.some((shape) => hasSmartArtShape3D(shape.shape3d))) {
+    return "scene";
+  }
+  return "flat";
+}
+
+// src/pptx/render/smartart-3d-solid.ts
+var DEFAULT_BEVEL_EMU = 76200;
+var MAX_BEVEL_FRACTION = 0.9;
+function resolveBevel(type, widthEmu, heightEmu, maxWidth) {
+  if (type === void 0 && widthEmu === void 0 && heightEmu === void 0) {
+    return void 0;
+  }
+  if (type === "none") {
+    return void 0;
+  }
+  const width = Math.min((widthEmu ?? DEFAULT_BEVEL_EMU) / EMU_PER_PX, maxWidth);
+  const height = (heightEmu ?? DEFAULT_BEVEL_EMU) / EMU_PER_PX;
+  if (width <= 0 || height <= 0) {
+    return void 0;
+  }
+  return { width, height, profile: type ?? "circle" };
+}
+function resolveSmartArt3DSolid(shape3d, halfExtent) {
+  if (!shape3d || !hasSmartArtShape3D(shape3d)) {
+    return void 0;
+  }
+  const maxWidth = Math.max(0, halfExtent * MAX_BEVEL_FRACTION);
+  const bevelTop = resolveBevel(
+    shape3d.bevelTopType,
+    shape3d.bevelTopWidth,
+    shape3d.bevelTopHeight,
+    maxWidth
+  );
+  const bevelBottom = resolveBevel(
+    shape3d.bevelBottomType,
+    shape3d.bevelBottomWidth,
+    shape3d.bevelBottomHeight,
+    maxWidth
+  );
+  return {
+    ...bevelTop ? { bevelTop } : {},
+    ...bevelBottom ? { bevelBottom } : {},
+    extrusion: Math.max(0, (shape3d.extrusionHeight ?? 0) / EMU_PER_PX),
+    ...shape3d.extrusionColor ? { extrusionColor: shape3d.extrusionColor } : {},
+    contourWidth: Math.max(0, (shape3d.contourWidth ?? 0) / EMU_PER_PX),
+    ...shape3d.contourColor ? { contourColor: shape3d.contourColor } : {},
+    material: shape3d.presetMaterial ?? "warmMatte"
+  };
+}
+
+// src/pptx/render/smartart-3d-drawing-solid.ts
+var DEG_PER_UNIT2 = 6e4;
+function percent(value, fallback) {
+  const parsed = value === void 0 ? Number.NaN : Number.parseFloat(value);
+  return Number.isFinite(parsed) ? parsed / 100 : fallback;
+}
+function buildSmartArt3DGradient(rendered, toLocal) {
+  const gradient = rendered.gradient;
+  if (!gradient || gradient.stops.length === 0) {
+    return void 0;
+  }
+  const at = (fx, fy) => toLocal({ x: rendered.x + fx * rendered.width, y: rendered.y + fy * rendered.height });
+  const stops = gradient.stops.map((stop) => ({
+    offset: Math.max(0, Math.min(1, percent(stop.offset, 0))),
+    color: stop.color
+  }));
+  if (gradient.kind === "radial") {
+    const cx = percent(gradient.cx, 0.5);
+    const cy = percent(gradient.cy, 0.5);
+    const r = percent(gradient.r, 0.5);
+    return { kind: "radial", from: at(cx, cy), to: at(cx + r, cy), stops };
+  }
+  return {
+    kind: "linear",
+    from: at(percent(gradient.x1, 0), percent(gradient.y1, 0)),
+    to: at(percent(gradient.x2, 1), percent(gradient.y2, 0)),
+    stops
+  };
+}
+function smartArt3DGradientCoordinate(p, gradient) {
+  const dx = gradient.to.x - gradient.from.x;
+  const dy = gradient.to.y - gradient.from.y;
+  const lengthSq = dx * dx + dy * dy;
+  if (lengthSq <= 0) {
+    return 0;
+  }
+  const u = gradient.kind === "radial" ? Math.hypot(p.x - gradient.from.x, p.y - gradient.from.y) / Math.sqrt(lengthSq) : ((p.x - gradient.from.x) * dx + (p.y - gradient.from.y) * dy) / lengthSq;
+  return Math.max(0, Math.min(1, u));
+}
+function smartArt3DGradientColor(gradient, p) {
+  const u = smartArt3DGradientCoordinate(p, gradient);
+  const stops = gradient.stops;
+  if (u <= stops[0].offset) {
+    return hexToRgb(stops[0].color);
+  }
+  for (let i = 1; i < stops.length; i++) {
+    const b = stops[i];
+    if (u <= b.offset) {
+      const a = stops[i - 1];
+      const span = b.offset - a.offset;
+      const f = span > 0 ? (u - a.offset) / span : 1;
+      const ca = hexToRgb(a.color);
+      const cb = hexToRgb(b.color);
+      return [
+        ca[0] + (cb[0] - ca[0]) * f,
+        ca[1] + (cb[1] - ca[1]) * f,
+        ca[2] + (cb[2] - ca[2]) * f
+      ];
+    }
+  }
+  return hexToRgb(stops[stops.length - 1].color);
+}
+function decorateSmartArt3DMesh(mesh, shape, rendered, toLocal) {
+  mesh.flat = false;
+  const solid = resolveSmartArt3DSolid(
+    shape.shape3d,
+    Math.min(rendered.width, rendered.height) / 2
+  );
+  if (solid) {
+    mesh.solid = solid;
+  }
+  const textExtrusion = (shape.text3d?.extrusionHeight ?? 0) / EMU_PER_PX;
+  if (mesh.textBlock && textExtrusion > 0) {
+    mesh.textBlock.extrusion = textExtrusion;
+    if (shape.text3d?.extrusionColor) {
+      mesh.textBlock.extrusionColor = shape.text3d.extrusionColor;
+    }
+  }
+  const gradient = buildSmartArt3DGradient(rendered, toLocal);
+  if (gradient) {
+    mesh.gradient = gradient;
+  }
+}
+function resolveSmartArt3DSceneSetup(data, category) {
+  if (category === "flat") {
+    return {};
+  }
+  const diagramScene = data.quickStyle?.scene3d;
+  const rigScene = category === "bevel" ? data.drawingShapes?.find((s) => s.scene3d?.lightRigType)?.scene3d ?? diagramScene : diagramScene;
+  const lighting = {
+    rig: rigScene?.lightRigType ?? "threePt",
+    direction: rigScene?.lightRigDirection ?? "t",
+    revDeg: (rigScene?.lightRigRotZ ?? 0) / DEG_PER_UNIT2
+  };
+  const camera = category === "scene" ? resolveSmartArt3DCamera(diagramScene) : void 0;
+  return { lighting, ...camera ? { camera } : {} };
+}
+
+export { CAMERA_PRESET_MAP, DEFAULT_CUSTOM_REF_PX, EMU_PER_PX, MAX_EXTRUSION_LAYERS, decorateSmartArt3DMesh, getBevelHighlightDirection, getBevelProfileHeightMap, getLightRigLighting, getMaterialLighting, hexToRgb, isBevelProfileInverted, resolveSmartArt3DLightModel, resolveSmartArt3DSceneSetup, resolveSmartArt3DStylePath, shadeSmartArt3DVertices, smartArt3DCameraMatrix, smartArt3DEyeInDiagram, smartArt3DGradientColor, smartArt3DGradientCoordinate };