ooxml-core 1.24.2 → 1.25.0

package/dist/diagram/edit/reflow-directional.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Directional/flow SmartArt reflow layout implementations.
+ *
+ * Contains reflow algorithms for layouts that use directional or
+ * sequential flow arrangements: timeline, relationship,
+ * chevron, and bending/snake.
+ *
+ * These are "visual reflow" layouts used after editing operations to
+ * reposition nodes without requiring the full layout engine.
+ *
+ * @module diagram/edit/reflow-directional
+ */
+import type { DiagramShapeView } from '../drawing-view.js';
+import type { DiagramNode } from '../model/node.js';
+import type { DiagramReflowBounds } from './types.js';
+/**
+ * Timeline layout reflow: nodes along a horizontal line with
+ * alternating above/below placement.
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowTimeline(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+/**
+ * Relationship layout reflow: nodes with bidirectional arrows.
+ * For 2 nodes: side-by-side with double-headed arrow.
+ * For 3+: arranged in a circle with connectors.
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowRelationship(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+/**
+ * Chevron layout reflow: arrow-shaped nodes flowing horizontally.
+ * Each node is a chevron/arrow shape pointing right.
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowChevron(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+/**
+ * Bending / Snake layout reflow: nodes in a serpentine path.
+ * Nodes flow left-to-right, then right-to-left on the next row, etc.
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowBending(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+//# sourceMappingURL=reflow-directional.d.ts.map

package/dist/diagram/edit/reflow-directional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflow-directional.d.ts","sourceRoot":"","sources":["../../../diagram/edit/reflow-directional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,mBAAmB,GACzB,gBAAgB,EAAE,CA4CpB;AAID;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,mBAAmB,GACzB,gBAAgB,EAAE,CAmEpB;AAID;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,mBAAmB,GACzB,gBAAgB,EAAE,CAsBpB;AAID;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,mBAAmB,GACzB,gBAAgB,EAAE,CA0EpB"}

package/dist/diagram/edit/reflow-geometric.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Geometric SmartArt reflow layout implementations.
+ *
+ * Contains reflow algorithms for layouts that use geometric or spatial
+ * arrangements: cycle (circular), matrix (grid), venn (overlapping circles),
+ * target (concentric rings), and gear (interlocking gears).
+ *
+ * These are "visual reflow" layouts used after editing operations to
+ * reposition nodes without requiring the full layout engine.
+ *
+ * @module diagram/edit/reflow-geometric
+ */
+import type { DiagramShapeView } from '../drawing-view.js';
+import type { DiagramNode } from '../model/node.js';
+import type { DiagramReflowBounds } from './types.js';
+/**
+ * Cycle layout reflow: distribute nodes around a circle.
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowCycle(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+/**
+ * Matrix layout reflow: place nodes in a grid pattern.
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowMatrix(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+/**
+ * Target / Bullseye layout reflow: concentric rings with nodes.
+ * Outermost ring is the first node, innermost is the last.
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowTarget(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+/**
+ * Gear layout reflow: interlocking gear shapes in a triangular arrangement.
+ * Up to 3 main gears with extra nodes listed to the side.
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowGear(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+/**
+ * Venn layout reflow: overlapping circles for 2-4 nodes,
+ * horizontal row for 5+.
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowVenn(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+//# sourceMappingURL=reflow-geometric.d.ts.map

package/dist/diagram/edit/reflow-geometric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflow-geometric.d.ts","sourceRoot":"","sources":["../../../diagram/edit/reflow-geometric.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,EAAE,CAwBjG;AAID;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,mBAAmB,GACzB,gBAAgB,EAAE,CAyBpB;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,mBAAmB,GACzB,gBAAgB,EAAE,CAuBpB;AAID;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,EAAE,CAmDhG;AAID;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,EAAE,CA0ChG"}

package/dist/diagram/edit/reflow-stacked.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Stacked SmartArt reflow layout implementations.
+ *
+ * Contains reflow algorithms for layouts that stack nodes vertically
+ * with varying widths: pyramid and funnel.
+ *
+ * These are "visual reflow" layouts used after editing operations to
+ * reposition nodes without requiring the full layout engine.
+ *
+ * @module diagram/edit/reflow-stacked
+ */
+import type { DiagramShapeView } from '../drawing-view.js';
+import type { DiagramNode } from '../model/node.js';
+import type { DiagramReflowBounds } from './types.js';
+/**
+ * Pyramid layout reflow: stacked bands from narrow (top) to wide (bottom).
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowPyramid(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+/**
+ * Funnel layout reflow: nodes stacked vertically with decreasing width
+ * (widest at top, narrowest at bottom).
+ *
+ * @param nodes - Content nodes to lay out.
+ * @param bounds - Container bounding box.
+ * @returns Array of positioned drawing shapes.
+ */
+export declare function reflowFunnel(nodes: DiagramNode[], bounds: DiagramReflowBounds): DiagramShapeView[];
+//# sourceMappingURL=reflow-stacked.d.ts.map

package/dist/diagram/edit/reflow-stacked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflow-stacked.d.ts","sourceRoot":"","sources":["../../../diagram/edit/reflow-stacked.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,mBAAmB,GACzB,gBAAgB,EAAE,CAyBpB;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,mBAAmB,GACzB,gBAAgB,EAAE,CAyBpB"}

package/dist/diagram/edit/reflow.d.ts

@@ -0,0 +1,48 @@
+/**
+ * SmartArt layout reflow dispatcher and basic layout implementations.
+ *
+ * Contains the main `reflowDiagramLayout` entry point which dispatches to
+ * the appropriate layout algorithm, plus the simpler layout implementations
+ * (list, process, hierarchy).
+ *
+ * @module diagram/edit/reflow
+ */
+import type { DiagramShapeView } from '../drawing-view.js';
+import type { DiagramData } from '../model/data.js';
+import type { DiagramNode } from '../model/node.js';
+import type { DiagramReflowBounds } from './types.js';
+/** The nodes that carry text: the content a reflow lays out (root `doc` points have none). */
+export declare function diagramContentNodes<N extends DiagramNode>(nodes: N[]): N[];
+/**
+ * Position data for a single node produced by the reflow engine.
+ */
+export interface ReflowedNodePosition {
+    /** Unique identifier of the SmartArt node. */
+    nodeId: string;
+    /** Horizontal position in pixels. */
+    x: number;
+    /** Vertical position in pixels. */
+    y: number;
+    /** Width of the node in pixels. */
+    width: number;
+    /** Height of the node in pixels. */
+    height: number;
+}
+/**
+ * Recalculate positions for all SmartArt nodes based on the current
+ * layout type and node structure.
+ *
+ * This function computes visually reasonable positions for the 5 most
+ * common layout types. It does not aim for pixel-perfect PowerPoint
+ * fidelity, but produces clean, well-spaced layouts.
+ *
+ * Returns an array of `DiagramShapeView` entries that can be
+ * set on `data.drawingShapes` to update the visual layout, or returns
+ * `undefined` if the layout type is not supported for reflow.
+ *
+ * @param data - SmartArt data model with nodes, connections, and layout type.
+ * @param bounds - Container bounding box on the slide.
+ * @returns Array of positioned drawing shapes, or undefined.
+ */
+export declare function reflowDiagramLayout(data: Pick<DiagramData, 'nodes' | 'resolvedLayoutType' | 'layoutType'>, bounds: DiagramReflowBounds): DiagramShapeView[] | undefined;
+//# sourceMappingURL=reflow.d.ts.map

package/dist/diagram/edit/reflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflow.d.ts","sourceRoot":"","sources":["../../../diagram/edit/reflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAiBjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAE1E;AAID;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,mCAAmC;IACnC,CAAC,EAAE,MAAM,CAAC;IACV,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CACf;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,oBAAoB,GAAG,YAAY,CAAC,EACtE,MAAM,EAAE,mBAAmB,GACzB,gBAAgB,EAAE,GAAG,SAAS,CA0ChC"}

package/dist/diagram/edit/shape-match.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Drawing-shape bookkeeping shared by the SmartArt node operations: which
+ * shape shows a node, and how an edit marks the shapes stale. Moved from
+ * `pptx/core/utils/smartart-editing-node-ops.ts` and
+ * `smartart-editing-node-style.ts`, which each kept a copy of the matcher.
+ *
+ * @module diagram/edit/shape-match
+ */
+import type { DiagramNode } from '../model/node.js';
+import type { DiagramEditShape } from './types.js';
+/**
+ * Mark drawing shapes as stale after a structural node edit.
+ *
+ * - If the element previously had drawing shapes (from file load or a prior
+ *   reflow), returns an empty array `[]` to signal that a rebuild is needed.
+ * - If the element never had drawing shapes (`undefined`), returns `undefined`
+ *   so the family renderer continues handling display without triggering
+ *   a lossy reflow (e.g. polygon-to-chevron downgrade for pyramid layouts).
+ */
+export declare function markDiagramShapesStale<S>(shapes: S[] | undefined): S[] | undefined;
+/**
+ * Find the drawing shape index that corresponds to a given node ID: a reflow
+ * shape's id suffix, else a 1:1 positional mapping when the counts align, else
+ * a unique non-empty text match. `-1` when none resolves (PowerPoint-generated
+ * shapes with opaque ids).
+ */
+export declare function findDiagramShapeIndex(shapes: readonly DiagramEditShape[], nodes: readonly DiagramNode[], nodeId: string): number;
+/**
+ * Replace the shape that shows `nodeId` with `patch(shape)` (immutable copy).
+ * Shapes that are absent or empty are returned unchanged; an unresolvable
+ * match returns `[]` so a full rebuild picks the change up.
+ */
+export declare function patchDiagramShape<S extends DiagramEditShape>(shapes: S[] | undefined, nodes: readonly DiagramNode[], nodeId: string, patch: (shape: S) => S): S[] | undefined;
+//# sourceMappingURL=shape-match.d.ts.map

package/dist/diagram/edit/shape-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-match.d.ts","sourceRoot":"","sources":["../../../diagram/edit/shape-match.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,GAAG,CAAC,EAAE,GAAG,SAAS,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,MAAM,EAAE,MAAM,GACZ,MAAM,CA8BR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,EAC3D,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,EACvB,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GACpB,CAAC,EAAE,GAAG,SAAS,CAWjB"}

package/dist/diagram/edit/types.d.ts

@@ -0,0 +1,31 @@
+import type { DiagramConnection } from '../types.js';
+import type { DiagramNode } from '../model/node.js';
+/** A drawing shape as the node operations see it: the id they match and the text they patch. */
+export interface DiagramEditShape {
+    id: string;
+    text?: string | undefined;
+}
+/** The parts of a parsed SmartArt graphic the node operations read and replace. */
+export interface DiagramEditableData<N extends DiagramNode = DiagramNode, S extends DiagramEditShape = DiagramEditShape> {
+    nodes: N[];
+    connections?: DiagramConnection[] | undefined;
+    /** Cached or reflowed drawing shapes; `[]` after an edit marks them stale. */
+    drawingShapes?: S[] | undefined;
+    /** Save hint: the cached drawing no longer matches the data model. */
+    drawingDirty?: boolean | undefined;
+}
+export interface DiagramEditOptions {
+    /**
+     * Mints the `modelId` of a new point. Defaults to a braced upper-case GUID, the form PowerPoint
+     * requires (`{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}`); PowerPoint rejects other ids as corrupt.
+     */
+    createModelId?: () => string;
+}
+/** The rectangle a reflow lays shapes out in, in the host's units (pixels for pptx). */
+export interface DiagramReflowBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/diagram/edit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../diagram/edit/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,gGAAgG;AAChG,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,mFAAmF;AACnF,MAAM,WAAW,mBAAmB,CACnC,CAAC,SAAS,WAAW,GAAG,WAAW,EACnC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAE7C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,WAAW,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IAC9C,8EAA8E;IAC9E,aAAa,CAAC,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC;IAChC,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IAClC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,wFAAwF;AACxF,MAAM,WAAW,mBAAmB;IACnC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf"}