@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/smartart/ooxml-engine-types.d.ts.map

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

package/dist/smartart/ooxml-layout-types.d.ts

@@ -0,0 +1,405 @@
+/**
+ * OOXML SmartArt Layout Definition Types
+ *
+ * Type definitions for SmartArt layout definitions (layout#.xml) as defined in
+ * ECMA-376 Part 1, Section 21.4 (DrawingML - Diagrams).
+ *
+ * A layout definition describes HOW a diagram should be arranged. It contains:
+ * - A tree of layout nodes, each with an algorithm, shape, constraints, and rules
+ * - ForEach loops that iterate over data model points
+ * - Choose/If/Else conditionals for data-driven branching
+ * - Constraint lists that define spatial relationships between nodes
+ * - Rule lists for adaptive fallback behavior
+ * - Variable lists for parameterizing the layout
+ *
+ * The layout engine interprets these definitions to produce positioned shapes.
+ * Each of Excel's 185+ SmartArt layouts is represented as a LayoutDefinition.
+ *
+ * NOTE: Iteration types (ForEach, Choose, IfClause, ElseClause, LayoutNodeChild,
+ * VariableList) are defined in ooxml-engine-types.ts and re-exported here for
+ * convenience. Layout-specific types (LayoutNode, LayoutDefinition, Algorithm,
+ * Shape, PresOf) are defined in this file.
+ *
+ * XML namespace: `dgm` (http://schemas.openxmlformats.org/drawingml/2006/diagram)
+ * File: `diagrams/layout#.xml` within the XLSX package
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3 (Diagram Layout Definition)
+ * @see ECMA-376 Part 1, Section 21.4.3.9 (dgm:layoutDef)
+ */
+import type { DataModel } from './ooxml-data-model-types';
+import type { LayoutNodeChild as EngineLayoutNodeChild, OoxmlConstraint, OoxmlRule, VariableList } from './ooxml-engine-types';
+/**
+ * SmartArt layout algorithm types.
+ *
+ * Each algorithm defines a different positioning strategy for child nodes.
+ * Maps to OOXML `ST_AlgorithmType`.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.7.1 (ST_AlgorithmType)
+ */
+export declare const AlgorithmType: {
+    /**
+     * Composite algorithm.
+     * Positions children using absolute constraints (l, t, w, h pairs).
+     * The most common top-level algorithm; used as a container.
+     */
+    readonly composite: "composite";
+    /**
+     * Linear algorithm.
+     * Arranges children in a straight line (horizontal or vertical).
+     * Supports direction, alignment, and node/transition alternation.
+     */
+    readonly lin: "lin";
+    /**
+     * Snake algorithm.
+     * Multi-row/column wrapping flow layout. Children wrap to the next
+     * row or column when they reach the edge. Supports boustrophedon
+     * (alternating direction per row).
+     */
+    readonly snake: "snake";
+    /**
+     * Cycle algorithm.
+     * Circular/radial arrangement of children around a center point.
+     * Uses start angle, span angle, and optional center shape mapping.
+     */
+    readonly cycle: "cycle";
+    /**
+     * Hierarchy root algorithm.
+     * Positions the root node of a hierarchy relative to its children.
+     * Used with hierChild for complete hierarchy layouts.
+     */
+    readonly hierRoot: "hierRoot";
+    /**
+     * Hierarchy child algorithm.
+     * Positions child nodes in a hierarchy underneath their parent.
+     * Used in combination with hierRoot.
+     */
+    readonly hierChild: "hierChild";
+    /**
+     * Pyramid algorithm.
+     * Vertical arrangement with trapezoid shape modification.
+     * Each level gets proportional width (wider at base or top).
+     */
+    readonly pyra: "pyra";
+    /**
+     * Connector algorithm.
+     * Routes connection lines between named source and destination nodes.
+     * Supports straight, bend, curve, and long curve routing styles.
+     */
+    readonly conn: "conn";
+    /**
+     * Text algorithm.
+     * Auto-sizes and positions text within a shape's bounds.
+     * Handles alignment, anchoring, bullet levels, and auto-rotation.
+     */
+    readonly tx: "tx";
+    /**
+     * Space algorithm.
+     * Invisible spacing placeholder. Allocates space but renders nothing.
+     * Used for uniform gap distribution between visible nodes.
+     */
+    readonly sp: "sp";
+};
+/** Union type of all valid algorithm type values. */
+export type AlgorithmTypeValue = (typeof AlgorithmType)[keyof typeof AlgorithmType];
+/**
+ * A layout algorithm with its type and parameter map.
+ *
+ * Corresponds to the `dgm:alg` element in a layout definition.
+ * The params map contains algorithm-specific parameters keyed by
+ * `ST_ParameterId` names with string values.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3.1 (dgm:alg)
+ */
+export interface Algorithm {
+    /** The algorithm type. */
+    type: AlgorithmTypeValue;
+    /**
+     * Algorithm parameters.
+     * Keys are ST_ParameterId names (e.g., "linDir", "horzAlign").
+     * Values are string representations parsed by the algorithm at runtime.
+     * Different algorithms accept different parameter sets.
+     */
+    params: Record<string, string>;
+}
+/**
+ * Shape definition for a layout node.
+ *
+ * Corresponds to the `dgm:shape` element. Defines the visual shape
+ * used to render this layout node.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3.14 (dgm:shape)
+ */
+export interface LayoutShape {
+    /**
+     * Shape type from ST_LayoutShapeType.
+     *
+     * Can be any DrawingML preset geometry name (e.g., "rect", "roundRect",
+     * "ellipse", "diamond", "chevron", etc.) or special values:
+     * - "none": No shape is rendered
+     * - "conn": Connector shape (for connection algorithm)
+     *
+     * @see ECMA-376 Part 1, Section 21.4.7.34 (ST_LayoutShapeType)
+     */
+    type?: string;
+    /**
+     * Rotation angle in degrees.
+     * Applied after positioning.
+     */
+    rot?: number;
+    /**
+     * Z-order offset.
+     * Adjusts the z-order of this shape relative to its siblings.
+     * Positive values bring the shape forward; negative push it back.
+     */
+    zOrderOff?: number;
+    /**
+     * Whether to hide the shape's geometry.
+     * When true, the shape outline is not drawn (but text may still render).
+     */
+    hideGeom?: boolean;
+    /**
+     * Lock text entry flag.
+     * When true, text is locked to this shape (cannot be moved to another).
+     */
+    lkTxEntry?: boolean;
+    /**
+     * Blip (image) placeholder flag.
+     * When true, this shape acts as an image placeholder in picture layouts.
+     */
+    blipPhldr?: boolean;
+    /**
+     * Shape adjustment values.
+     * Override the default adjustment handles for the preset geometry.
+     * Maps adjustment name (e.g., "adj", "adj1", "adj2") to a value.
+     */
+    adjustments?: Record<string, number>;
+}
+/**
+ * Presentation-of mapping for a layout node.
+ *
+ * Defines which data model points are presented by this layout node.
+ * Uses axis navigation to find the relevant data points from the
+ * current iteration context.
+ *
+ * Corresponds to the `dgm:presOf` element.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3.12 (dgm:presOf)
+ */
+export interface PresOf {
+    /**
+     * Axis to navigate for finding the presented point.
+     * Space-separated for chained navigation (e.g., "ch ch" = grandchildren).
+     *
+     * @see ST_AxisTypes (Section 21.4.7.7)
+     */
+    axis?: string;
+    /**
+     * Point type filter.
+     * Space-separated list of point types to include.
+     * Navigation results are filtered to only include these types.
+     */
+    ptType?: string;
+    /**
+     * Count of items to include.
+     * Limits the number of navigation results.
+     */
+    cnt?: number;
+    /**
+     * Start index (1-based).
+     * Skips this many results before including.
+     */
+    st?: number;
+    /**
+     * Step increment.
+     * Include every Nth result (e.g., step=2 includes every other item).
+     */
+    step?: number;
+    /**
+     * Whether to hide the last transition in the sequence.
+     * Used to suppress trailing connector shapes.
+     */
+    hideLastTrans?: boolean;
+}
+/**
+ * A category tag for a layout definition.
+ *
+ * Layout definitions can belong to multiple categories, each with a
+ * type identifier and a priority for sorting within the category.
+ *
+ * Corresponds to `dgm:cat` elements within `dgm:catLst`.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3.2 (dgm:cat)
+ */
+export interface LayoutCategory {
+    /** Category type URI (e.g., "urn:microsoft.com/office/officeart/2005/8/layout/list"). */
+    type: string;
+    /** Priority within this category (lower = higher priority, shown first). */
+    priority: number;
+}
+/**
+ * A layout constraint definition as it appears in layout#.xml.
+ *
+ * This is an alias for OoxmlConstraint from ooxml-engine-types.ts.
+ * All constraint types (65 ST_ConstraintType values, operators, scoping)
+ * are defined there.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3.4 (dgm:constr)
+ */
+export type LayoutConstraint = OoxmlConstraint;
+/**
+ * A layout rule definition as it appears in layout#.xml.
+ *
+ * This is an alias for OoxmlRule from ooxml-engine-types.ts.
+ * Rules define adaptive fallback ranges for constraints.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3.13 (dgm:rule)
+ */
+export type LayoutRule = OoxmlRule;
+/**
+ * A layout node in the layout definition tree.
+ *
+ * Layout nodes are the primary building blocks of a layout definition.
+ * Each node defines:
+ * - An algorithm for positioning its children
+ * - A shape for visual rendering
+ * - Constraints for spatial relationships
+ * - Rules for adaptive fallback
+ * - PresOf mapping to connect to data model points
+ * - A variable list for parameterization
+ *
+ * Corresponds to the `dgm:layoutNode` element.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3.10 (dgm:layoutNode)
+ */
+export interface LayoutNode {
+    /** Discriminant for LayoutNodeChild union. */
+    readonly kind: 'layoutNode';
+    /**
+     * Unique name within the layout definition.
+     * Used for constraint references (forName/refForName) and moveWith.
+     */
+    name?: string;
+    /**
+     * Style label for color and style resolution.
+     * Maps to entries in the colors and style definitions.
+     * Examples: "node1", "sibTrans2D1", "bgShp", "revTx"
+     *
+     * @see ECMA-376 Part 1, Section 21.4.5 (Style Label System)
+     */
+    styleLbl?: string;
+    /**
+     * Move-with reference.
+     * When set, this node moves together with the named node.
+     * Used for decorative elements that should track another node's position.
+     */
+    moveWith?: string;
+    /** The algorithm used to position this node's children. */
+    algorithm?: Algorithm;
+    /** The shape rendered for this node. */
+    shape?: LayoutShape;
+    /** Presentation-of mapping to data model points. */
+    presOf?: PresOf;
+    /**
+     * Constraint list defining spatial relationships.
+     * Constraints set positions, sizes, and spacing for this node and its children.
+     */
+    constraints?: LayoutConstraint[];
+    /**
+     * Rule list defining adaptive fallback behavior.
+     * Rules modify constraints when content doesn't fit.
+     */
+    rules?: LayoutRule[];
+    /**
+     * Variable list for parameterizing this node and its descendants.
+     * Variables are accessible via choose/if evaluations.
+     */
+    varLst?: VariableList;
+    /**
+     * Child elements (layout nodes, forEach loops, or choose conditionals).
+     * Processed in order during layout computation.
+     */
+    children: EngineLayoutNodeChild[];
+}
+/**
+ * Sample data for layout preview in galleries.
+ *
+ * Layout definitions can include sample data models that are used
+ * when rendering previews (before the user provides their own data).
+ *
+ * Corresponds to `dgm:sampData`, `dgm:styleData`, and `dgm:clrData`.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3.14 (dgm:sampData)
+ */
+export interface SampleData {
+    /**
+     * Inline data model for preview rendering.
+     * If undefined, a default 3-node data model is used.
+     */
+    dataModel?: DataModel;
+    /**
+     * Whether to use the default sample data instead.
+     * When true, the layout engine generates a standard sample.
+     */
+    useDefault?: boolean;
+}
+/**
+ * Complete SmartArt layout definition (dgm:layoutDef).
+ *
+ * The top-level container for a layout#.xml file. Describes how a
+ * SmartArt diagram should be arranged, including the full tree of
+ * layout nodes, constraints, algorithms, and conditional logic.
+ *
+ * Each of Excel's 185+ SmartArt layouts corresponds to one LayoutDefinition.
+ * Custom layouts (.glox files) also parse into this type.
+ *
+ * @see ECMA-376 Part 1, Section 21.4.3.9 (dgm:layoutDef)
+ */
+export interface LayoutDefinition {
+    /**
+     * Unique identifier URI for this layout.
+     * Format: "urn:microsoft.com/office/officeart/2005/8/layout/{name}"
+     * Example: "urn:microsoft.com/office/officeart/2005/8/layout/orgChart1"
+     */
+    uniqueId: string;
+    /** Display title shown in the layout gallery. */
+    title?: string;
+    /** Description text shown in the layout gallery tooltip. */
+    desc?: string;
+    /**
+     * Categories this layout belongs to.
+     * A layout can appear in multiple gallery categories.
+     */
+    categories: LayoutCategory[];
+    /**
+     * Sample data model for gallery preview rendering.
+     * Used when the user hasn't provided their own data yet.
+     */
+    sampData?: SampleData;
+    /**
+     * Style data model for style preview rendering.
+     * Typically simpler than sampData (fewer nodes).
+     */
+    styleData?: SampleData;
+    /**
+     * Color data model for color preview rendering.
+     * Typically simpler than sampData (fewer nodes).
+     */
+    clrData?: SampleData;
+    /**
+     * The root layout node of the definition tree.
+     * This is the top-level composite node that contains all other nodes.
+     * Layout computation starts from this node.
+     */
+    rootLayoutNode: LayoutNode;
+    /**
+     * Default minimum version required to render this layout.
+     * Used for backward compatibility with older applications.
+     */
+    minVer?: string;
+    /**
+     * Default style label for the definition level.
+     * Applies to all nodes that don't specify their own styleLbl.
+     */
+    defStyle?: string;
+}
+//# sourceMappingURL=ooxml-layout-types.d.ts.map

package/dist/smartart/ooxml-layout-types.d.ts.map

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