ooxml-ui 0.30.0 → 0.31.0

package/dist/pptx/render/smartart-3d-types.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Three.js SmartArt renderer - pure model types (phase 1: extruded layouts).
+ *
+ * These describe a framework-agnostic, three.js-agnostic 3D scene derived from
+ * the 2D {@link SmartArtLayoutResult}. The pure model is built by
+ * `buildSmartArt3DModel` (no `three` import, fully testable) and consumed by the
+ * vanilla-three scene builder under `pptx-viewer-shared/smartart-3d`, which is
+ * shared verbatim by the React, Vue, and Angular bindings.
+ *
+ * Coordinate convention: world space is y-up, centred on the origin, with the
+ * front face of every extruded block facing +z. Layout (SVG) space is y-down
+ * with the origin at the top-left; the model builder performs the flip.
+ */
+import type { SmartArt3DCamera, SmartArt3DGradient, SmartArt3DLighting, SmartArt3DSolid } from './smartart-3d-solid-types.js';
+export type * from './smartart-3d-solid-types.js';
+/** A point in the world's XZ-agnostic 2D outline space (y-up). */
+export interface Point2 {
+    x: number;
+    y: number;
+}
+/** A world-space position (y-up). */
+export interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * A single extruded shape (one SmartArt node) in the 3D scene.
+ *
+ * The {@link outline} is a closed polygon centred on the mesh's own origin
+ * (y-up); the scene builder extrudes it by {@link depth} along +z and positions
+ * the result at {@link position}.
+ */
+export interface SmartArt3DMesh {
+    id: string;
+    /** Closed 2D outline to extrude, centred on the mesh origin (y-up). */
+    outline: Point2[];
+    /**
+     * Additional closed loops cut out of {@link outline} as holes (e.g. a
+     * compound custom-geometry shape), in the same mesh-local space. Empty for
+     * the common single-loop case.
+     */
+    holes?: Point2[][];
+    /** Hint that the outline approximates a circle (drives tessellation). */
+    rounded: boolean;
+    /** Extrusion depth along +z, in layout pixels. */
+    depth: number;
+    /** Bevel size; 0 disables bevelling. */
+    bevel: number;
+    /**
+     * True when this mesh should render as a flat, unlit, zero-depth face
+     * (`ShapeGeometry`) rather than an extruded/bevelled solid
+     * (`ExtrudeGeometry`), matching a PowerPoint flat SmartArt quick style.
+     */
+    flat?: boolean;
+    /** Fill colour, `#rrggbb`. Ignored (nothing painted) when {@link fillNone}. */
+    fill: string;
+    /**
+     * The source shape declared `a:noFill`: paint nothing, but the mesh may
+     * still carry a {@link textBlock} (SmartArt commonly stacks an unfilled
+     * label shape over a painted one).
+     */
+    fillNone?: boolean;
+    /** Resolved data-URI/URL of a picture fill, when the source shape has one (not yet textured). */
+    imageUrl?: string;
+    /** Edge/stroke colour, `#rrggbb`. */
+    stroke: string;
+    /** Stroke width in layout pixels (0 = no visible edge line). */
+    strokeWidth: number;
+    /** Mesh opacity, 0..1. */
+    opacity: number;
+    /** World-space centre of the mesh (y-up, z = 0 base plane). */
+    position: Vec3;
+    /**
+     * Euler rotation (radians, XYZ order) applied to the mesh. `{0,0,0}` for the
+     * extruded (phase 1) layout and the flat drawing-shape model (rotation is
+     * baked into {@link outline} there); spatial layouts (e.g. the cycle
+     * carousel) rotate blocks to face along the arrangement.
+     */
+    rotation: Vec3;
+    /** Text label drawn on the front (+z) face (single string; legacy consumers). */
+    text: string;
+    /**
+     * Pre-laid-out multi-line text matching the 2D SVG projection. Preferred
+     * over {@link text} when present.
+     */
+    textBlock?: SmartArt3DTextBlock;
+    /** Text colour, `#rrggbb`. */
+    textColor: string;
+    /** Font size in layout pixels. */
+    fontSize: number;
+    /** Half-width of the footprint (for sizing the text plane). */
+    halfWidth: number;
+    /** Half-height of the footprint. */
+    halfHeight: number;
+    /**
+     * Lit solid (bevel / extrusion / contour) from the cached shape's `a:sp3d`,
+     * for the `'bevel'` and `'scene'` style categories. Absent: a flat face.
+     */
+    solid?: SmartArt3DSolid;
+    /** Gradient fill to paint instead of {@link fill}, when the shape has one. */
+    gradient?: SmartArt3DGradient;
+}
+/**
+ * A multi-line text label, pre-laid-out to match the 2D SVG projection
+ * (`centeredSvgTextLines`), for the renderer to draw onto a texture/plane
+ * rather than re-wrapping text itself.
+ */
+export interface SmartArt3DTextBlock {
+    /** One entry per line; `dy` is the line's offset from the block centre (y-up, layout px). */
+    lines: Array<{
+        text: string;
+        dy: number;
+    }>;
+    /** World-space centre of the text block. */
+    x: number;
+    y: number;
+    z: number;
+    /** Available width/height for the block, in layout pixels. */
+    maxWidth: number;
+    maxHeight: number;
+    /** Text colour, `#rrggbb`. */
+    color: string;
+    /** Font size in layout pixels. */
+    fontSize: number;
+    fontFamily?: string;
+    fontWeight?: number;
+    fontStyle?: 'normal' | 'italic';
+    /**
+     * The label's own extrusion (`a:bodyPr/a:sp3d`, e.g. Bird's Eye Scene),
+     * in layout px toward the viewer: the letters stand this far off the
+     * shape face, and their sides are drawn in {@link extrusionColor} (the
+     * text colour when absent).
+     */
+    extrusion?: number;
+    extrusionColor?: string;
+}
+/** A connector poly-line drawn between meshes on the base plane. */
+export interface SmartArt3DConnector {
+    id: string;
+    /** World-space points (y-up). */
+    points: Vec3[];
+    /** Line colour, `#rrggbb`. */
+    color: string;
+    /** Line width in layout pixels. */
+    width: number;
+}
+/** Camera-framing bounds of the whole model, in layout pixels. */
+export interface SmartArt3DBounds {
+    width: number;
+    height: number;
+}
+/** The layout family the model was built from (drives the spatial transform). */
+export type SmartArt3DFamily = 'list' | 'process' | 'cycle' | 'hierarchy' | 'matrix' | 'radial' | 'pyramid' | 'venn' | 'funnel' | 'target';
+/**
+ * Which PowerPoint quick-style family this model was built for, so the scene
+ * builder can pick the right camera/shading/geometry pipeline: `'flat'`
+ * (unlit, zero-depth, orthographic matching the 2D viewBox), `'bevel'`
+ * (per-shape `orthographicFront` camera + lit `a:sp3d` bevel/material), or
+ * `'scene'` (one whole-diagram camera from the quick style, lit extruded
+ * solids). See `resolveSmartArt3DStylePath`. Undefined for the legacy
+ * layout-engine model (`buildSmartArt3DModel`), which predates this
+ * distinction.
+ */
+export type SmartArt3DStyleCategory = 'flat' | 'bevel' | 'scene';
+/** The complete pure 3D model for one SmartArt element. */
+export interface SmartArt3DModel {
+    meshes: SmartArt3DMesh[];
+    connectors: SmartArt3DConnector[];
+    bounds: SmartArt3DBounds;
+    /** Layout family, used to choose a spatial arrangement. */
+    family?: SmartArt3DFamily;
+    /** Optional background chrome colour, `#rrggbb`. */
+    background?: string;
+    /** See {@link SmartArt3DStyleCategory}. */
+    styleCategory?: SmartArt3DStyleCategory;
+    /** Whole-diagram camera (`'scene'` only). */
+    camera?: SmartArt3DCamera;
+    /** Light rig the lit solids are shaded with (`'bevel'` / `'scene'`). */
+    lighting?: SmartArt3DLighting;
+}
+/** Tunables for {@link buildSmartArt3DModel}. */
+export interface SmartArt3DModelOptions {
+    /**
+     * Extrusion depth as a fraction of each node's smaller footprint dimension.
+     * Ignored when {@link depth} is set. Default `0.35`.
+     */
+    depthRatio?: number;
+    /** Fixed extrusion depth in layout pixels; overrides {@link depthRatio}. */
+    depth?: number;
+    /** Bevel size as a fraction of the extrusion depth. Default `0.2`. */
+    bevelRatio?: number;
+    /** Background chrome colour, `#rrggbb`. */
+    background?: string;
+    /**
+     * Arrange nodes in genuine 3D space per layout family (cycle -> carousel
+     * ring, hierarchy -> layered tree, pyramid -> stacked tiers) instead of the
+     * flat extruded layout. Families without a spatial form keep the flat
+     * layout. Default `false` (phase 1 extruded behaviour).
+     */
+    spatial?: boolean;
+    /**
+     * `PptxSmartArtNode.id`s carrying `dgm:prSet/@coherent3DOff="1"` (a per-node
+     * opt-out of PowerPoint's "no two identical" bevel variation a 3-D SmartArt
+     * quick style applies). A mesh whose `RenderedNode.nodeId` is in this set
+     * always gets the plain, un-varied bevel; every other mesh gets a small,
+     * deterministic (hash-of-id) bevel variation so identical shapes do not
+     * render pixel-identical, matching PowerPoint's "coherent 3-D" behaviour.
+     * Absent/empty set: no variation at all (pre-existing behaviour).
+     */
+    coherent3DOffNodeIds?: ReadonlySet<string>;
+}
+//# sourceMappingURL=smartart-3d-types.d.ts.map

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

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

package/dist/pptx/render/smartart-3d-vertex-shading.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Per-vertex colour factors for a lit SmartArt 3D solid (framework-agnostic,
+ * pure).
+ *
+ * The three.js layer paints a solid with `MeshBasicMaterial` (base colour or
+ * gradient map) times a per-vertex colour. This module computes that vertex
+ * colour so the displayed (sRGB) result is `base * mul + add` from
+ * `shadeSmartArt3DNormal`, with the division done in linear space because
+ * three multiplies linear values.
+ *
+ * @module render/smartart-3d-vertex-shading
+ */
+import type { SmartArt3DLightModel } from './smartart-3d-lighting.js';
+import type { Point2, Vec3 } from './smartart-3d-types.js';
+/** An sRGB colour, channels 0..1. */
+export type Rgb = [number, number, number];
+/** sRGB channel (0..1) -> linear. */
+export declare function srgbToLinear(c: number): number;
+/** `#rrggbb` -> sRGB channels 0..1 (black when unparsable). */
+export declare function hexToRgb(hex: string): Rgb;
+/**
+ * Vertex colours (3 floats per vertex, linear factors) for a triangle list.
+ *
+ * @param positions - mesh-local xyz per vertex.
+ * @param normals - mesh-local unit normals per vertex.
+ * @param baseAt - the sRGB base colour painted at a mesh-local point.
+ * @param eye - camera position in mesh-local space, for a perspective scene
+ *   camera; omitted for a parallel view.
+ *
+ * The light is fixed to the diagram, not the camera: a scene camera turning
+ * the diagram does not relight its faces (the scene-style exports keep every
+ * face at the same colour however far it is turned).
+ */
+export declare function shadeSmartArt3DVertices(positions: readonly number[], normals: readonly number[], baseAt: (p: Point2) => Rgb, model: SmartArt3DLightModel, eye?: Vec3): Float32Array;
+//# sourceMappingURL=smartart-3d-vertex-shading.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smartart-3d-vertex-shading.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/smartart-3d-vertex-shading.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAExD,qCAAqC;AACrC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,qCAAqC;AACrC,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAOzC;AAUD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,GAAG,EAC1B,KAAK,EAAE,oBAAoB,EAC3B,GAAG,CAAC,EAAE,IAAI,GACR,YAAY,CAoBd"}

package/dist/pptx/render/smartart-accessibility.d.ts

@@ -0,0 +1,52 @@
+/**
+ * smartart-accessibility.ts: framework-agnostic accessibility metadata for the
+ * SmartArt renderer, shared across the React, Vue, and Angular bindings.
+ *
+ * The generated SmartArt SVG is otherwise opaque to assistive technology. These
+ * pure helpers derive a screen-reader description of the whole diagram, a label
+ * for each node, and a small `SmartArtA11y` view-model that a binding maps onto
+ * `role="img"` + `aria-label` on the container and a `<title>` / `aria-label`
+ * per node. No DOM, no framework imports.
+ */
+import type { PptxSmartArtData, SmartArtLayoutType } from 'ooxml-core/pptx';
+/** Resolve a SmartArt diagram's layout family to a friendly label. */
+export declare function smartArtLayoutLabel(type: SmartArtLayoutType | undefined): string;
+/**
+ * Build a concise screen-reader description of an entire SmartArt diagram, e.g.
+ * `"Hierarchy SmartArt diagram with 5 nodes: CEO; VP Marketing; ..."`.
+ *
+ * Node texts are listed up to {@link MAX_LISTED_NODES}; the remainder is
+ * summarised as `"and N more"`. An empty diagram yields a node-free sentence.
+ */
+export declare function describeSmartArtDiagram(data: PptxSmartArtData): string;
+/**
+ * Build the ARIA label for a single SmartArt node, e.g.
+ * `"Node 2 of 5: VP Marketing"`. `index` is zero-based; `total` is the node
+ * count. An empty node text yields `"Node 2 of 5"` (no trailing colon).
+ */
+export declare function smartArtNodeAriaLabel(text: string, index: number, total: number): string;
+/** Accessibility view-model for one SmartArt node. */
+export interface SmartArtNodeA11y {
+    /** Stable node id (for keying). */
+    id: string;
+    /** `aria-label` / `<title>` text for the node. */
+    label: string;
+}
+/**
+ * Accessibility view-model for a whole SmartArt diagram. A binding maps this
+ * onto `role="img"` + `aria-label` on the container and a per-node label.
+ */
+export interface SmartArtA11y {
+    /** ARIA role for the container element. Always `"img"`. */
+    role: 'img';
+    /** Container `aria-label` (the full diagram description). */
+    label: string;
+    /** Per-node labels in flattened, depth-first order. */
+    nodes: SmartArtNodeA11y[];
+}
+/**
+ * Build the complete {@link SmartArtA11y} view-model for a diagram: the
+ * container description plus a per-node label for every content node.
+ */
+export declare function buildSmartArtA11y(data: PptxSmartArtData): SmartArtA11y;
+//# sourceMappingURL=smartart-accessibility.d.ts.map

package/dist/pptx/render/smartart-accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartart-accessibility.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/smartart-accessibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAoB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAwB9F,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,GAAG,MAAM,CAEhF;AAwBD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAetE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxF;AAED,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAChC,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,2DAA2D;IAC3D,IAAI,EAAE,KAAK,CAAC;IACZ,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAYtE"}

package/dist/pptx/render/smartart-builtin-layouts.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Lazy access to PowerPoint's built-in SmartArt layout definitions.
+ *
+ * The library (`ooxml-core/pptx/smartart-layouts`, about 350 KB gzipped) is a separate chunk
+ * loaded the first time a SmartArt is selected, so a viewer that never shows one never fetches it.
+ * Until it has loaded, callers get `undefined` and keep the family-renderer behaviour; the layout
+ * gallery and the switch patch both re-check on every call, so they pick it up as soon as it lands.
+ *
+ * @module render/smartart-builtin-layouts
+ */
+import type { PptxSmartArtData } from 'ooxml-core/pptx';
+type BuiltinLayouts = typeof import('ooxml-core/pptx/smartart-layouts');
+/** Start loading the library (once); resolves with it, or `undefined` when it cannot load. */
+export declare function preloadSmartArtBuiltinLayouts(): Promise<BuiltinLayouts | undefined>;
+/** The library when it has finished loading, else `undefined` (and a load is started). */
+export declare function smartArtBuiltinLayouts(): BuiltinLayouts | undefined;
+/** The data fields a built-in layout swap changes, as a patch (see `smartArtLayoutSwitchPatch`). */
+export declare function builtinLayoutPatch(data: PptxSmartArtData, layoutId: string): Partial<PptxSmartArtData> | undefined;
+export {};
+//# sourceMappingURL=smartart-builtin-layouts.d.ts.map

package/dist/pptx/render/smartart-builtin-layouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartart-builtin-layouts.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/smartart-builtin-layouts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,cAAc,GAAG,cAAc,kCAAkC,CAAC,CAAC;AAKxE,8FAA8F;AAC9F,wBAAgB,6BAA6B,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAMnF;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,IAAI,cAAc,GAAG,SAAS,CAKnE;AAED,oGAAoG;AACpG,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAiBvC"}

package/dist/pptx/render/smartart-drawing-gradient.d.ts

@@ -0,0 +1,46 @@
+/**
+ * SVG gradient paint servers for cached SmartArt drawing shapes (`a:gradFill`).
+ * Split out of `smartart-drawing.ts`.
+ *
+ * @module render/smartart-drawing-gradient
+ */
+import type { PptxSmartArtDrawingShape } from 'ooxml-core/pptx';
+/** One stop of a cached shape's gradient fill, ready to place as an SVG `<stop>`. */
+export interface RenderedGradientStop {
+    /** Percentage offset, e.g. `"37%"`. */
+    offset: string;
+    color: string;
+    opacity?: number;
+}
+/**
+ * A gradient paint server for a cached shape, in SVG terms.
+ *
+ * The OOXML angle is already converted to the axis endpoints here, because a
+ * gradient is not expressible as a plain `fill` string: the binding has to emit
+ * a `<defs>` entry and reference it. Keeping the geometry on this side means the
+ * conversion happens once instead of once per binding.
+ */
+export interface RenderedGradient {
+    /** Element id to emit and reference; unique within the diagram. */
+    id: string;
+    kind: 'linear' | 'radial';
+    /** Axis endpoints as percentages (`kind === 'linear'`). */
+    x1?: string;
+    y1?: string;
+    x2?: string;
+    y2?: string;
+    /** Centre and radius as percentages (`kind === 'radial'`). */
+    cx?: string;
+    cy?: string;
+    r?: string;
+    stops: RenderedGradientStop[];
+}
+/**
+ * Build the SVG gradient for a cached shape's `a:gradFill`, or `undefined` when
+ * it has none.
+ *
+ * The OOXML angle is clockwise from +x with y pointing down, which is also the
+ * SVG convention, so sin/cos map straight onto the axis endpoints.
+ */
+export declare function resolveDrawingShapeGradient(shape: PptxSmartArtDrawingShape, id: string): RenderedGradient | undefined;
+//# sourceMappingURL=smartart-drawing-gradient.d.ts.map

package/dist/pptx/render/smartart-drawing-gradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartart-drawing-gradient.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/smartart-drawing-gradient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACpC,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAChC,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,2DAA2D;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,GACR,gBAAgB,GAAG,SAAS,CAyB9B"}

package/dist/pptx/render/smartart-drawing-label-color.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Label colour for a cached SmartArt drawing shape whose runs declare none,
+ * and the fill opacity it (and the renderers) read. Split out of
+ * `smartart-drawing.ts`, which projects the shapes.
+ *
+ * @module render/smartart-drawing-label-color
+ */
+import type { PptxSmartArtDrawingShape } from 'ooxml-core/pptx';
+/**
+ * The opacity to paint a cached shape's solid fill at, or `undefined` when it
+ * is opaque (or the fill is not a solid colour). Basic Venn caches its circles
+ * as `accent1` at `a:alpha 50000`, and PowerPoint blends the overlaps.
+ */
+export declare function drawingShapeFillOpacity(shape: PptxSmartArtDrawingShape): number | undefined;
+/**
+ * Pick a label colour for a cached shape whose runs declare none.
+ *
+ * PowerPoint leaves the colour implicit far more often than not, and resolves it
+ * against the shape's own fill. Defaulting to white instead makes every label on
+ * a light content panel invisible. A semi-transparent fill is read as it shows
+ * on the slide (blended onto white), so a 50% Venn circle gets dark text.
+ */
+export declare function drawingShapeLabelColor(shape: PptxSmartArtDrawingShape, shapes: PptxSmartArtDrawingShape[], index: number, resolvedFill: string): string;
+/**
+ * The opacity a 3D mesh paints a cached shape at: its solid fill alpha, or a
+ * gradient whose every stop shares one alpha (the bevel Venn styles cache
+ * `a:gradFill` stops at `a:alpha 50000`). Per-stop alpha that varies is not
+ * representable on one material, so it stays opaque.
+ */
+export declare function drawingShapeMeshOpacity(shape: PptxSmartArtDrawingShape): number;
+//# sourceMappingURL=smartart-drawing-label-color.d.ts.map

package/dist/pptx/render/smartart-drawing-label-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartart-drawing-label-color.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/smartart-drawing-label-color.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAIhE;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,GAAG,SAAS,CAS3F;AA8CD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,wBAAwB,EAC/B,MAAM,EAAE,wBAAwB,EAAE,EAClC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GAClB,MAAM,CAoBR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAgB/E"}

package/dist/pptx/render/smartart-drawing-viewbox.d.ts

@@ -0,0 +1,6 @@
+import type { DiagramDrawingBounds } from 'ooxml-core/diagram';
+import type { PptxSmartArtDrawingShape } from 'ooxml-core/pptx';
+export type DrawingViewBox = DiagramDrawingBounds;
+/** Preserve the per-field fallback of PowerPoint's independent text rectangle. */
+export declare function computeDrawingViewBox(shapes: readonly PptxSmartArtDrawingShape[]): DrawingViewBox;
+//# sourceMappingURL=smartart-drawing-viewbox.d.ts.map

package/dist/pptx/render/smartart-drawing-viewbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartart-drawing-viewbox.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/smartart-drawing-viewbox.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAElD,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAAG,cAAc,CAYjG"}

package/dist/pptx/render/smartart-drawing.d.ts

@@ -0,0 +1,107 @@
+/**
+ * smartart-drawing.ts: Drawing-shape view-model helpers for the SmartArt
+ * renderer, shared across the React, Vue, and Angular bindings.
+ *
+ * These back the **pre-computed drawing-shapes** path
+ * (`smartArtData.drawingShapes`), which the core engine extracts from
+ * `ppt/diagrams/drawing*.xml`. That path is preferred when present and is
+ * independent of the SVG-fallback layout engine (`computeSmartArtLayout` in
+ * `smartart-layout`), which only runs when no drawing shapes exist.
+ *
+ * Pure TypeScript (no framework imports). Style helpers (`styleStroke`,
+ * `styleShadow`) are reused from `smartart-layout-helpers`.
+ */
+import type { PptxSmartArtChrome, PptxSmartArtData, PptxSmartArtDrawingShape, SmartArtColorScheme, SmartArtStyle } from 'ooxml-core/pptx';
+import type { CssStyleMap } from './element-style-transform.js';
+import type { RenderedGradient } from './smartart-drawing-gradient.js';
+import { drawingShapeFillOpacity, drawingShapeLabelColor } from './smartart-drawing-label-color.js';
+import type { DrawingViewBox } from './smartart-drawing-viewbox.js';
+import type { SvgTextLine } from './svg-text-lines.js';
+/** Built-in named colour palettes (mirrors the Vue/React `PALETTES`). */
+export declare const PALETTES: Record<SmartArtColorScheme, string[]>;
+export { drawingShapeFillOpacity, drawingShapeLabelColor };
+export { computeDrawingViewBox } from './smartart-drawing-viewbox.js';
+export type { DrawingViewBox } from './smartart-drawing-viewbox.js';
+export type { RenderedGradient, RenderedGradientStop } from './smartart-drawing-gradient.js';
+export declare const DEFAULT_PALETTE: string[];
+/** Pick a colour from `palette`, wrapping `index` around its length. */
+export declare function paletteColour(index: number, palette: string[]): string;
+/**
+ * Resolve the active colour palette for a SmartArt diagram.
+ *
+ * Priority: colorTransform fill colours → named scheme → default (colorful1).
+ */
+export declare function resolvePalette(data: PptxSmartArtData | undefined): string[];
+/**
+ * CSS style map for the chrome wrapper `<div>`. Applies background colour
+ * and/or outline border when `chrome` is present.
+ */
+export declare function buildChromeStyle(chrome: PptxSmartArtChrome | undefined): CssStyleMap;
+/**
+ * Which SVG primitive paints a cached shape's body. One discriminant rather than
+ * a set of booleans, so a binding's template is a single switch and adding a
+ * primitive cannot leave four bindings behind.
+ */
+export type RenderedShapeKind = 'image' | 'ellipse' | 'path' | 'rect';
+/** Projected view-model for a single pre-computed drawing shape. */
+export interface RenderedShape {
+    key: string;
+    /** Which primitive paints the body; see {@link RenderedShapeKind}. */
+    kind: RenderedShapeKind;
+    /** Preset path and placement transform, set when `kind === 'path'`. */
+    pathData?: string;
+    pathTransform?: string;
+    /**
+     * Gradient to emit in `<defs>` and reference from {@link fill}, when the
+     * cached shape carries `a:gradFill`.
+     */
+    gradient?: RenderedGradient;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rx: number;
+    cx: number;
+    cy: number;
+    /** Paint for the body, or `'none'` when the shape declares `a:noFill`. */
+    fill: string;
+    /**
+     * Opacity (0..1) to paint a solid {@link fill} at, from the cached colour's
+     * `a:alpha`; absent when opaque. Maps onto SVG `fill-opacity`.
+     */
+    fillOpacity?: number;
+    stroke: string;
+    strokeWidth: number;
+    transform: string | undefined;
+    /**
+     * Picture fill to draw in place of the body, when the cached shape carries a
+     * resolved `a:blipFill`. SmartArt icon layouts are built from these, and a
+     * renderer that only paints `fill` turns each icon into a coloured box.
+     */
+    imageUrl: string | undefined;
+    /**
+     * The shape's authored text, wrapped to its own width and vertically centred
+     * on {@link textY}. Cached SmartArt text is real sentence content, so it is
+     * wrapped rather than cut: dropping the tail of a sentence loses information
+     * the deck was written to carry. Each entry is ready to place as one
+     * `<tspan>` at `textX` / its own `y`.
+     */
+    textLines: SvgTextLine[];
+    textX: number;
+    textY: number;
+    textWidth: number;
+    textHeight: number;
+    fontColor: string;
+    fontSize: number;
+    fontFamily?: string;
+    fontWeight?: number;
+    fontStyle?: 'normal' | 'italic';
+}
+/**
+ * Project raw `PptxSmartArtDrawingShape`s into `RenderedShape` view-models,
+ * rebasing positions relative to the viewBox origin.
+ */
+export declare function projectDrawingShapes(elementId: string, shapes: PptxSmartArtDrawingShape[], viewBox: DrawingViewBox, palette: string[], style: SmartArtStyle): RenderedShape[];
+/** Drop-shadow filter string for the given style intensity. */
+export declare function styleShadowFilter(style: SmartArtStyle): string | undefined;
+//# sourceMappingURL=smartart-drawing.d.ts.map

package/dist/pptx/render/smartart-drawing.d.ts.map

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

package/dist/pptx/render/smartart-inline-edit.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Framework-agnostic helpers for inline (on-canvas) SmartArt node text editing.
+ *
+ * The actual text mutation lives in `ooxml-core/pptx`
+ * (`updateSmartArtNodeText`); these helpers cover the pure, binding-independent
+ * concerns around it:
+ *
+ * - `findSmartArtNodeText`: look up a node's current text by id.
+ * - `shouldCommitSmartArtNodeText`: decide whether a new value differs from the
+ *   current one (so a no-op blur does not push a history entry).
+ * - `measureSvgViewportRect`: measure SVG geometry in local coordinates so an
+ *   HTML overlay inherits the diagram's outer transform exactly once.
+ *
+ * @module smartart-inline-edit
+ */
+import type { PptxSmartArtData, PptxSmartArtDrawingShape, PptxSmartArtNode } from 'ooxml-core/pptx';
+/** A minimal rectangle (DOMRect-compatible) used for overlay positioning. */
+export interface InlineEditRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/**
+ * Return the current text of the SmartArt node with the given id, or
+ * `undefined` when no such node exists.
+ */
+export declare function findSmartArtNodeText(data: PptxSmartArtData, nodeId: string): string | undefined;
+/**
+ * Whether committing `nextText` to `nodeId` is a real change.
+ *
+ * Returns `false` when the node is missing or the text is identical, allowing
+ * callers to skip a redundant update + history entry on blur / Enter.
+ */
+export declare function shouldCommitSmartArtNodeText(data: PptxSmartArtData, nodeId: string, nextText: string): boolean;
+/**
+ * Resolve which SmartArt model node a pre-computed drawing shape represents, so
+ * a clicked drawing shape can be edited inline.
+ *
+ * Drawing shapes do not carry the model node id directly, so this applies a
+ * cascade of progressively weaker heuristics:
+ *
+ * 1. Reflow-generated shapes embed the node id in their `id`
+ *    (`reflow-<layout>-<nodeId>`); match the suffix against a known node id.
+ * 2. When the shape count equals the node count, map by position (the common
+ *    1:1 document-order case).
+ * 3. Fall back to a unique, non-empty text match.
+ *
+ * Returns the resolved node id, or `undefined` when no confident match exists
+ * (in which case the shape is not made editable).
+ *
+ * Arrow/connector shapes (preset geometry names that end with `"Arrow"`, e.g.
+ * `rightArrow`, `leftRightArrow`, `downArrow`) that carry no text are always
+ * structural decorators in SmartArt - never editable node content. They are
+ * excluded before any heuristic runs so that reflow connector shapes with ids
+ * like `reflow-bending-arrow-n1` (which end with `-n1` and would otherwise
+ * match node `n1` via heuristic 1) are correctly left untagged.
+ *
+ * Arrow shapes that DO carry text (e.g. content nodes in an "Opposing Arrows"
+ * layout) are intentional content and are allowed through.
+ */
+export declare function resolveDrawingShapeNodeId(shape: PptxSmartArtDrawingShape, shapeIndex: number, shapes: readonly PptxSmartArtDrawingShape[], nodes: readonly PptxSmartArtNode[]): string | undefined;
+/**
+ * Subtract a container origin from a node rectangle in the same coordinate space.
+ *
+ * Both rectangles must already use the overlay's local coordinate space.
+ * Screen rectangles are unsuitable when the overlay inherits a transform;
+ * use `measureSvgViewportRect` for the SVG-backed SmartArt overlays.
+ */
+export declare function computeInlineEditorRect(nodeRect: InlineEditRect, containerRect: InlineEditRect): InlineEditRect;
+/**
+ * Measure an SVG graphic in its outermost SVG viewport's local CSS pixels.
+ *
+ * The viewport and the HTML overlay must share an origin. This accounts for
+ * SVG viewBox/letterboxing and internal transforms, but deliberately excludes
+ * outer HTML transforms that the overlay will inherit itself.
+ */
+export declare function measureSvgViewportRect(source: Element): InlineEditRect | null;
+/**
+ * Project a zero-origin SVG viewBox rectangle into an untransformed CSS viewport
+ * using `xMidYMid meet`. The editor and SVG can then inherit the same outer
+ * zoom, rotation and flip without applying those transforms twice.
+ */
+export declare function projectSmartArtViewBoxRect(nodeRect: InlineEditRect, viewBox: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+}): InlineEditRect | null;
+//# sourceMappingURL=smartart-inline-edit.d.ts.map

package/dist/pptx/render/smartart-inline-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartart-inline-edit.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/smartart-inline-edit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpG,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC3C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACd,OAAO,CAMT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,wBAAwB,EAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,wBAAwB,EAAE,EAC3C,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAChC,MAAM,GAAG,SAAS,CA+BpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,cAAc,EACxB,aAAa,EAAE,cAAc,GAC3B,cAAc,CAOhB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAyD7E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC1C,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC,cAAc,GAAG,IAAI,CA4BvB"}