docxmlater 10.4.0 → 11.0.4

package/dist/esm/elements/Shape.js

@@ -0,0 +1,493 @@
+import { XMLBuilder } from '../xml/XMLBuilder.js';
+import { pointsToHalfPoints } from '../utils/units.js';
+export class Shape {
+    shapeType;
+    width;
+    height;
+    fill;
+    outline;
+    position;
+    anchor;
+    rotation = 0;
+    text;
+    textFormatting;
+    name;
+    description;
+    docPrId = 1;
+    constructor(properties) {
+        this.shapeType = properties.shapeType;
+        this.width = properties.width;
+        this.height = properties.height;
+        this.fill = properties.fill;
+        this.outline = properties.outline;
+        this.position = properties.position;
+        this.anchor = properties.anchor;
+        this.rotation = properties.rotation || 0;
+        this.text = properties.text;
+        this.textFormatting = properties.textFormatting;
+        this.name = properties.name || 'Shape';
+        this.description = properties.description || '';
+    }
+    static create(shapeType, width, height) {
+        return new Shape({ shapeType, width, height });
+    }
+    static createRectangle(width, height) {
+        return Shape.create('rect', width, height);
+    }
+    static createCircle(diameter) {
+        return Shape.create('ellipse', diameter, diameter);
+    }
+    static createEllipse(width, height) {
+        return Shape.create('ellipse', width, height);
+    }
+    static createArrow(direction, width, height) {
+        const shapeType = `${direction}Arrow`;
+        return Shape.create(shapeType, width, height);
+    }
+    static createLine(width) {
+        return Shape.create('straightConnector1', width, 12700);
+    }
+    getShapeType() {
+        return this.shapeType;
+    }
+    getWidth() {
+        return this.width;
+    }
+    getHeight() {
+        return this.height;
+    }
+    setFill(color, transparency) {
+        this.fill = { color, transparency };
+        return this;
+    }
+    getFill() {
+        return this.fill;
+    }
+    setOutline(color, width, style) {
+        this.outline = { color, width, style: style || 'solid' };
+        return this;
+    }
+    getOutline() {
+        return this.outline;
+    }
+    setPosition(horizontal, vertical) {
+        this.position = { horizontal, vertical };
+        return this;
+    }
+    getPosition() {
+        return this.position;
+    }
+    setAnchor(options) {
+        this.anchor = options;
+        return this;
+    }
+    getAnchor() {
+        return this.anchor;
+    }
+    setRotation(degrees) {
+        this.rotation = ((degrees % 360) + 360) % 360;
+        return this;
+    }
+    getRotation() {
+        return this.rotation;
+    }
+    setText(text, formatting) {
+        this.text = text;
+        if (formatting) {
+            this.textFormatting = formatting;
+        }
+        return this;
+    }
+    getText() {
+        return this.text;
+    }
+    setName(name) {
+        this.name = name;
+        return this;
+    }
+    getName() {
+        return this.name;
+    }
+    setDescription(description) {
+        this.description = description;
+        return this;
+    }
+    getDescription() {
+        return this.description;
+    }
+    setDocPrId(id) {
+        this.docPrId = id;
+        return this;
+    }
+    isFloating() {
+        return this.anchor !== undefined || this.position !== undefined;
+    }
+    toXML() {
+        const shapeElement = this.isFloating() ? this.createAnchor() : this.createInline();
+        return XMLBuilder.w('drawing', undefined, [shapeElement]);
+    }
+    createInline() {
+        const children = [];
+        children.push({
+            name: 'wp:extent',
+            attributes: {
+                cx: this.width.toString(),
+                cy: this.height.toString(),
+            },
+            selfClosing: true,
+        });
+        children.push({
+            name: 'wp:effectExtent',
+            attributes: {
+                l: '0',
+                t: '0',
+                r: '0',
+                b: '0',
+            },
+            selfClosing: true,
+        });
+        children.push({
+            name: 'wp:docPr',
+            attributes: {
+                id: this.docPrId.toString(),
+                name: this.name,
+                descr: this.description,
+            },
+            selfClosing: true,
+        });
+        children.push({
+            name: 'wp:cNvGraphicFramePr',
+            selfClosing: true,
+        });
+        children.push(this.createGraphic());
+        return {
+            name: 'wp:inline',
+            attributes: {
+                distT: '0',
+                distB: '0',
+                distL: '0',
+                distR: '0',
+            },
+            children,
+        };
+    }
+    createAnchor() {
+        const children = [];
+        const anchorConfig = this.anchor || {
+            behindDoc: false,
+            locked: false,
+            layoutInCell: true,
+            allowOverlap: false,
+            relativeHeight: 251658240,
+        };
+        children.push({
+            name: 'wp:simplePos',
+            attributes: { x: '0', y: '0' },
+            selfClosing: true,
+        });
+        if (this.position) {
+            const posH = this.position.horizontal;
+            const posHChildren = [];
+            if (posH.offset !== undefined) {
+                posHChildren.push({
+                    name: 'wp:posOffset',
+                    children: [posH.offset.toString()],
+                });
+            }
+            else if (posH.alignment) {
+                posHChildren.push({
+                    name: 'wp:align',
+                    children: [posH.alignment],
+                });
+            }
+            children.push({
+                name: 'wp:positionH',
+                attributes: {
+                    relativeFrom: posH.anchor,
+                },
+                children: posHChildren,
+            });
+        }
+        if (this.position) {
+            const posV = this.position.vertical;
+            const posVChildren = [];
+            if (posV.offset !== undefined) {
+                posVChildren.push({
+                    name: 'wp:posOffset',
+                    children: [posV.offset.toString()],
+                });
+            }
+            else if (posV.alignment) {
+                posVChildren.push({
+                    name: 'wp:align',
+                    children: [posV.alignment],
+                });
+            }
+            children.push({
+                name: 'wp:positionV',
+                attributes: {
+                    relativeFrom: posV.anchor,
+                },
+                children: posVChildren,
+            });
+        }
+        children.push({
+            name: 'wp:extent',
+            attributes: {
+                cx: this.width.toString(),
+                cy: this.height.toString(),
+            },
+            selfClosing: true,
+        });
+        children.push({
+            name: 'wp:effectExtent',
+            attributes: {
+                l: '0',
+                t: '0',
+                r: '0',
+                b: '0',
+            },
+            selfClosing: true,
+        });
+        children.push({
+            name: 'wp:wrapSquare',
+            attributes: {
+                wrapText: 'bothSides',
+            },
+            selfClosing: true,
+        });
+        children.push({
+            name: 'wp:docPr',
+            attributes: {
+                id: this.docPrId.toString(),
+                name: this.name,
+                descr: this.description,
+            },
+            selfClosing: true,
+        });
+        children.push({
+            name: 'wp:cNvGraphicFramePr',
+            selfClosing: true,
+        });
+        children.push(this.createGraphic());
+        return {
+            name: 'wp:anchor',
+            attributes: {
+                distT: '0',
+                distB: '0',
+                distL: '0',
+                distR: '0',
+                simplePos: '0',
+                relativeHeight: anchorConfig.relativeHeight.toString(),
+                behindDoc: anchorConfig.behindDoc ? '1' : '0',
+                locked: anchorConfig.locked ? '1' : '0',
+                layoutInCell: anchorConfig.layoutInCell ? '1' : '0',
+                allowOverlap: anchorConfig.allowOverlap ? '1' : '0',
+            },
+            children,
+        };
+    }
+    createGraphic() {
+        return {
+            name: 'a:graphic',
+            attributes: {
+                'xmlns:a': 'http://schemas.openxmlformats.org/drawingml/2006/main',
+            },
+            children: [
+                {
+                    name: 'a:graphicData',
+                    attributes: {
+                        uri: 'http://schemas.microsoft.com/office/word/2010/wordprocessingShape',
+                    },
+                    children: [this.createWps()],
+                },
+            ],
+        };
+    }
+    createWps() {
+        const children = [];
+        children.push({
+            name: 'wps:cNvSpPr',
+            attributes: {
+                'xmlns:wps': 'http://schemas.microsoft.com/office/word/2010/wordprocessingShape',
+            },
+            selfClosing: true,
+        });
+        children.push(this.createSpPr());
+        if (this.text) {
+            children.push(this.createTextBox());
+        }
+        children.push({
+            name: 'wps:bodyPr',
+            attributes: {
+                rot: '0',
+                vert: 'horz',
+                wrap: 'square',
+                lIns: '91440',
+                tIns: '45720',
+                rIns: '91440',
+                bIns: '45720',
+                anchor: 't',
+                anchorCtr: '0',
+                upright: '1',
+            },
+            selfClosing: true,
+        });
+        return {
+            name: 'wps:wsp',
+            attributes: {
+                'xmlns:wps': 'http://schemas.microsoft.com/office/word/2010/wordprocessingShape',
+            },
+            children,
+        };
+    }
+    createSpPr() {
+        const children = [];
+        const xfrmAttrs = this.rotation > 0 ? { rot: (this.rotation * 60000).toString() } : undefined;
+        children.push({
+            name: 'a:xfrm',
+            attributes: xfrmAttrs,
+            children: [
+                {
+                    name: 'a:off',
+                    attributes: { x: '0', y: '0' },
+                    selfClosing: true,
+                },
+                {
+                    name: 'a:ext',
+                    attributes: {
+                        cx: this.width.toString(),
+                        cy: this.height.toString(),
+                    },
+                    selfClosing: true,
+                },
+            ],
+        });
+        children.push({
+            name: 'a:prstGeom',
+            attributes: {
+                prst: this.shapeType,
+            },
+            children: [
+                {
+                    name: 'a:avLst',
+                    selfClosing: true,
+                },
+            ],
+        });
+        if (this.fill) {
+            const fillChildren = [];
+            const colorAttrs = {
+                val: this.fill.color.toUpperCase(),
+            };
+            if (this.fill.transparency !== undefined) {
+                const alpha = 100 - this.fill.transparency;
+                fillChildren.push({
+                    name: 'a:alpha',
+                    attributes: {
+                        val: Math.round(alpha * 1000).toString(),
+                    },
+                    selfClosing: true,
+                });
+            }
+            children.push({
+                name: 'a:solidFill',
+                children: [
+                    {
+                        name: 'a:srgbClr',
+                        attributes: colorAttrs,
+                        ...(fillChildren.length > 0 ? { children: fillChildren } : { selfClosing: true }),
+                    },
+                ],
+            });
+        }
+        if (this.outline) {
+            const lnAttrs = {
+                w: this.outline.width.toString(),
+            };
+            if (this.outline.cap)
+                lnAttrs.cap = this.outline.cap;
+            if (this.outline.compound)
+                lnAttrs.cmpd = this.outline.compound;
+            const lnChildren = [];
+            lnChildren.push({
+                name: 'a:solidFill',
+                children: [
+                    {
+                        name: 'a:srgbClr',
+                        attributes: {
+                            val: this.outline.color.toUpperCase(),
+                        },
+                        selfClosing: true,
+                    },
+                ],
+            });
+            if (this.outline.style && this.outline.style !== 'solid') {
+                lnChildren.push({
+                    name: 'a:prstDash',
+                    attributes: {
+                        val: this.outline.style,
+                    },
+                    selfClosing: true,
+                });
+            }
+            if (this.outline.join) {
+                const joinNames = { bevel: 'a:bevel', miter: 'a:miter', round: 'a:round' };
+                const joinName = joinNames[this.outline.join];
+                if (joinName) {
+                    lnChildren.push({
+                        name: joinName,
+                        selfClosing: true,
+                    });
+                }
+            }
+            children.push({
+                name: 'a:ln',
+                attributes: lnAttrs,
+                children: lnChildren,
+            });
+        }
+        return {
+            name: 'wps:spPr',
+            children,
+        };
+    }
+    createTextBox() {
+        if (!this.text) {
+            return { name: 'wps:txbx', selfClosing: true };
+        }
+        const rPrChildren = [];
+        if (this.textFormatting) {
+            if (this.textFormatting.bold) {
+                rPrChildren.push(XMLBuilder.wSelf('b'));
+            }
+            if (this.textFormatting.italic) {
+                rPrChildren.push(XMLBuilder.wSelf('i'));
+            }
+            if (this.textFormatting.color) {
+                rPrChildren.push(XMLBuilder.wSelf('color', { 'w:val': this.textFormatting.color }));
+            }
+            if (this.textFormatting.size) {
+                const halfPoints = pointsToHalfPoints(this.textFormatting.size);
+                rPrChildren.push(XMLBuilder.wSelf('sz', { 'w:val': halfPoints }));
+                rPrChildren.push(XMLBuilder.wSelf('szCs', { 'w:val': halfPoints }));
+            }
+        }
+        const runChildren = [];
+        if (rPrChildren.length > 0) {
+            runChildren.push(XMLBuilder.w('rPr', undefined, rPrChildren));
+        }
+        runChildren.push(XMLBuilder.w('t', { 'xml:space': 'preserve' }, [this.text]));
+        const paragraph = XMLBuilder.w('p', undefined, [XMLBuilder.w('r', undefined, runChildren)]);
+        return {
+            name: 'wps:txbx',
+            children: [
+                {
+                    name: 'w:txbxContent',
+                    children: [paragraph],
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=Shape.js.map

package/dist/esm/elements/Shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Shape.js","sourceRoot":"","sources":["../../../src/elements/Shape.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shape - Represents a drawing shape in a Word document\n *\n * Shapes use DrawingML (a:) and WordprocessingML Drawing (wp:) namespaces,\n * plus WordprocessingShape (wps:) namespace for Word 2010+ shape features.\n *\n * Per ECMA-376 Part 4 (Transitional) and Office Open XML extensions,\n * shapes in Word documents use the wps:wsp element structure.\n */\n\nimport { XMLBuilder, XMLElement } from '../xml/XMLBuilder.js';\nimport { pointsToHalfPoints } from '../utils/units.js';\nimport { RunFormatting } from './Run.js';\nimport {\n  ImagePosition,\n  ImageAnchor,\n  PositionAnchor,\n  HorizontalAlignment,\n  VerticalAlignment,\n} from './Image.js';\n\n/**\n * Preset shape types available in DrawingML\n * Based on ECMA-376 Part 1 §20.1.10.56 ST_ShapeType\n */\nexport type ShapeType =\n  | 'rect' // Rectangle\n  | 'ellipse' // Circle/Ellipse\n  | 'rightArrow' // Right arrow\n  | 'leftArrow' // Left arrow\n  | 'upArrow' // Up arrow\n  | 'downArrow' // Down arrow\n  | 'straightConnector1' // Straight line\n  | 'roundRect' // Rounded rectangle\n  | 'triangle' // Triangle\n  | 'diamond'; // Diamond\n\n/**\n * Shape fill configuration\n */\nexport interface ShapeFill {\n  /** Fill color in hex (e.g., 'FF0000' for red) */\n  color: string;\n  /** Transparency percentage (0-100, where 100 is fully transparent) */\n  transparency?: number;\n}\n\n/**\n * Shape outline/border configuration\n */\nexport interface ShapeOutline {\n  /** Outline color in hex */\n  color: string;\n  /** Outline width in EMUs */\n  width: number;\n  /** Line dash style */\n  style?:\n    | 'solid'\n    | 'dash'\n    | 'dot'\n    | 'dashDot'\n    | 'lgDash'\n    | 'lgDashDot'\n    | 'lgDashDotDot'\n    | 'sysDash'\n    | 'sysDot'\n    | 'sysDashDot'\n    | 'sysDashDotDot';\n  /** Line cap style (ECMA-376 §20.1.10.31) */\n  cap?: 'flat' | 'rnd' | 'sq';\n  /** Line join style (ECMA-376 §20.1.10.32) */\n  join?: 'bevel' | 'miter' | 'round';\n  /** Compound line type (ECMA-376 §20.1.10.15) */\n  compound?: 'sng' | 'dbl' | 'thickThin' | 'thinThick' | 'tri';\n}\n\n/**\n * Shape properties\n */\nexport interface ShapeProperties {\n  /** Shape type (preset geometry) */\n  shapeType: ShapeType;\n  /** Width in EMUs */\n  width: number;\n  /** Height in EMUs */\n  height: number;\n  /** Fill color and transparency */\n  fill?: ShapeFill;\n  /** Outline/border properties */\n  outline?: ShapeOutline;\n  /** Position configuration (reuses Image position types) */\n  position?: ImagePosition;\n  /** Anchor configuration (reuses Image anchor types) */\n  anchor?: ImageAnchor;\n  /** Rotation angle in degrees (0-360) */\n  rotation?: number;\n  /** Text content within the shape */\n  text?: string;\n  /** Text formatting */\n  textFormatting?: RunFormatting;\n  /** Shape name/title */\n  name?: string;\n  /** Shape description (for accessibility) */\n  description?: string;\n}\n\n/**\n * Represents a drawing shape\n */\nexport class Shape {\n  private shapeType: ShapeType;\n  private width: number;\n  private height: number;\n  private fill?: ShapeFill;\n  private outline?: ShapeOutline;\n  private position?: ImagePosition;\n  private anchor?: ImageAnchor;\n  private rotation = 0;\n  private text?: string;\n  private textFormatting?: RunFormatting;\n  private name: string;\n  private description: string;\n  private docPrId = 1;\n\n  /**\n   * Creates a new shape\n   * @param properties Shape properties\n   * @private Use static factory methods instead (create, createRectangle, etc.)\n   */\n  private constructor(properties: ShapeProperties) {\n    this.shapeType = properties.shapeType;\n    this.width = properties.width;\n    this.height = properties.height;\n    this.fill = properties.fill;\n    this.outline = properties.outline;\n    this.position = properties.position;\n    this.anchor = properties.anchor;\n    this.rotation = properties.rotation || 0;\n    this.text = properties.text;\n    this.textFormatting = properties.textFormatting;\n    this.name = properties.name || 'Shape';\n    this.description = properties.description || '';\n  }\n\n  /**\n   * Factory method for creating a shape\n   * @param shapeType Shape type\n   * @param width Width in EMUs (or use inchesToEmus)\n   * @param height Height in EMUs (or use inchesToEmus)\n   * @returns New Shape instance\n   * @example\n   * const rect = Shape.create('rect', inchesToEmus(2), inchesToEmus(1));\n   */\n  static create(shapeType: ShapeType, width: number, height: number): Shape {\n    return new Shape({ shapeType, width, height });\n  }\n\n  /**\n   * Creates a rectangle shape\n   * @param width Width in EMUs\n   * @param height Height in EMUs\n   * @returns New Shape instance\n   */\n  static createRectangle(width: number, height: number): Shape {\n    return Shape.create('rect', width, height);\n  }\n\n  /**\n   * Creates a circle shape\n   * @param diameter Diameter in EMUs\n   * @returns New Shape instance\n   */\n  static createCircle(diameter: number): Shape {\n    return Shape.create('ellipse', diameter, diameter);\n  }\n\n  /**\n   * Creates an ellipse shape\n   * @param width Width in EMUs\n   * @param height Height in EMUs\n   * @returns New Shape instance\n   */\n  static createEllipse(width: number, height: number): Shape {\n    return Shape.create('ellipse', width, height);\n  }\n\n  /**\n   * Creates an arrow shape\n   * @param direction Arrow direction\n   * @param width Width in EMUs\n   * @param height Height in EMUs\n   * @returns New Shape instance\n   */\n  static createArrow(\n    direction: 'right' | 'left' | 'up' | 'down',\n    width: number,\n    height: number\n  ): Shape {\n    const shapeType = `${direction}Arrow` as ShapeType;\n    return Shape.create(shapeType, width, height);\n  }\n\n  /**\n   * Creates a line shape\n   * @param width Line width in EMUs\n   * @returns New Shape instance\n   */\n  static createLine(width: number): Shape {\n    // Lines are typically very thin in height\n    return Shape.create('straightConnector1', width, 12700); // 12700 EMU ≈ 1pt height\n  }\n\n  /**\n   * Gets the shape type\n   * @returns Shape type\n   */\n  getShapeType(): ShapeType {\n    return this.shapeType;\n  }\n\n  /**\n   * Gets the shape width in EMUs\n   * @returns Width\n   */\n  getWidth(): number {\n    return this.width;\n  }\n\n  /**\n   * Gets the shape height in EMUs\n   * @returns Height\n   */\n  getHeight(): number {\n    return this.height;\n  }\n\n  /**\n   * Sets the shape fill color\n   * @param color Fill color in hex (e.g., 'FF0000')\n   * @param transparency Optional transparency percentage (0-100)\n   * @returns This shape for chaining\n   */\n  setFill(color: string, transparency?: number): this {\n    this.fill = { color, transparency };\n    return this;\n  }\n\n  /**\n   * Gets the fill configuration\n   * @returns Fill or undefined\n   */\n  getFill(): ShapeFill | undefined {\n    return this.fill;\n  }\n\n  /**\n   * Sets the shape outline\n   * @param color Outline color in hex\n   * @param width Outline width in EMUs\n   * @param style Line style\n   * @returns This shape for chaining\n   */\n  setOutline(color: string, width: number, style?: 'solid' | 'dash' | 'dot' | 'dashDot'): this {\n    this.outline = { color, width, style: style || 'solid' };\n    return this;\n  }\n\n  /**\n   * Gets the outline configuration\n   * @returns Outline or undefined\n   */\n  getOutline(): ShapeOutline | undefined {\n    return this.outline;\n  }\n\n  /**\n   * Sets shape position (for floating shapes)\n   * @param horizontal Horizontal positioning configuration\n   * @param vertical Vertical positioning configuration\n   * @returns This shape for chaining\n   */\n  setPosition(\n    horizontal: { anchor: PositionAnchor; offset?: number; alignment?: HorizontalAlignment },\n    vertical: { anchor: PositionAnchor; offset?: number; alignment?: VerticalAlignment }\n  ): this {\n    this.position = { horizontal, vertical };\n    return this;\n  }\n\n  /**\n   * Gets the position configuration\n   * @returns Position or undefined\n   */\n  getPosition(): ImagePosition | undefined {\n    return this.position;\n  }\n\n  /**\n   * Sets anchor configuration (converts shape to floating)\n   * @param options Anchor configuration\n   * @returns This shape for chaining\n   */\n  setAnchor(options: ImageAnchor): this {\n    this.anchor = options;\n    return this;\n  }\n\n  /**\n   * Gets the anchor configuration\n   * @returns Anchor configuration or undefined\n   */\n  getAnchor(): ImageAnchor | undefined {\n    return this.anchor;\n  }\n\n  /**\n   * Sets the rotation angle\n   * @param degrees Rotation in degrees (0-360)\n   * @returns This shape for chaining\n   */\n  setRotation(degrees: number): this {\n    this.rotation = ((degrees % 360) + 360) % 360;\n    return this;\n  }\n\n  /**\n   * Gets the rotation angle\n   * @returns Rotation in degrees\n   */\n  getRotation(): number {\n    return this.rotation;\n  }\n\n  /**\n   * Sets text content within the shape\n   * @param text Text content\n   * @param formatting Optional text formatting\n   * @returns This shape for chaining\n   */\n  setText(text: string, formatting?: RunFormatting): this {\n    this.text = text;\n    if (formatting) {\n      this.textFormatting = formatting;\n    }\n    return this;\n  }\n\n  /**\n   * Gets the text content\n   * @returns Text or undefined\n   */\n  getText(): string | undefined {\n    return this.text;\n  }\n\n  /**\n   * Sets the shape name\n   * @param name Shape name\n   * @returns This shape for chaining\n   */\n  setName(name: string): this {\n    this.name = name;\n    return this;\n  }\n\n  /**\n   * Gets the shape name\n   * @returns Shape name\n   */\n  getName(): string {\n    return this.name;\n  }\n\n  /**\n   * Sets the shape description (for accessibility)\n   * @param description Shape description\n   * @returns This shape for chaining\n   */\n  setDescription(description: string): this {\n    this.description = description;\n    return this;\n  }\n\n  /**\n   * Gets the shape description\n   * @returns Shape description\n   */\n  getDescription(): string {\n    return this.description;\n  }\n\n  /**\n   * Sets the docPr ID (drawing object ID)\n   * @param id Document property ID\n   * @returns This shape for chaining\n   */\n  setDocPrId(id: number): this {\n    this.docPrId = id;\n    return this;\n  }\n\n  /**\n   * Checks if this shape is floating (has anchor or position configuration)\n   * @returns True if floating, false if inline\n   */\n  isFloating(): boolean {\n    return this.anchor !== undefined || this.position !== undefined;\n  }\n\n  /**\n   * Generates DrawingML XML for the shape\n   * Creates either inline or floating (anchor) shape based on configuration\n   * @returns XML element representing the shape\n   */\n  toXML(): XMLElement {\n    // Choose between inline and anchor based on configuration\n    const shapeElement = this.isFloating() ? this.createAnchor() : this.createInline();\n\n    // Create the drawing structure\n    return XMLBuilder.w('drawing', undefined, [shapeElement]);\n  }\n\n  /**\n   * Creates the wp:inline element for inline shapes\n   * @private\n   */\n  private createInline(): XMLElement {\n    const children: XMLElement[] = [];\n\n    // Extent (size)\n    children.push({\n      name: 'wp:extent',\n      attributes: {\n        cx: this.width.toString(),\n        cy: this.height.toString(),\n      },\n      selfClosing: true,\n    });\n\n    // Effect extent (set to 0 for shapes)\n    children.push({\n      name: 'wp:effectExtent',\n      attributes: {\n        l: '0',\n        t: '0',\n        r: '0',\n        b: '0',\n      },\n      selfClosing: true,\n    });\n\n    // Document properties\n    children.push({\n      name: 'wp:docPr',\n      attributes: {\n        id: this.docPrId.toString(),\n        name: this.name,\n        descr: this.description,\n      },\n      selfClosing: true,\n    });\n\n    // Non-visual graphic frame properties\n    children.push({\n      name: 'wp:cNvGraphicFramePr',\n      selfClosing: true,\n    });\n\n    // Graphic data (the actual shape)\n    children.push(this.createGraphic());\n\n    return {\n      name: 'wp:inline',\n      attributes: {\n        distT: '0',\n        distB: '0',\n        distL: '0',\n        distR: '0',\n      },\n      children,\n    };\n  }\n\n  /**\n   * Creates the wp:anchor element for floating shapes\n   * @private\n   */\n  private createAnchor(): XMLElement {\n    const children: XMLElement[] = [];\n\n    const anchorConfig = this.anchor || {\n      behindDoc: false,\n      locked: false,\n      layoutInCell: true,\n      allowOverlap: false,\n      relativeHeight: 251658240,\n    };\n\n    // simplePos (required first child per CT_Anchor)\n    children.push({\n      name: 'wp:simplePos',\n      attributes: { x: '0', y: '0' },\n      selfClosing: true,\n    });\n\n    // Position H (horizontal)\n    if (this.position) {\n      const posH = this.position.horizontal;\n      const posHChildren: XMLElement[] = [];\n\n      if (posH.offset !== undefined) {\n        posHChildren.push({\n          name: 'wp:posOffset',\n          children: [posH.offset.toString()],\n        });\n      } else if (posH.alignment) {\n        posHChildren.push({\n          name: 'wp:align',\n          children: [posH.alignment],\n        });\n      }\n\n      children.push({\n        name: 'wp:positionH',\n        attributes: {\n          relativeFrom: posH.anchor,\n        },\n        children: posHChildren,\n      });\n    }\n\n    // Position V (vertical)\n    if (this.position) {\n      const posV = this.position.vertical;\n      const posVChildren: XMLElement[] = [];\n\n      if (posV.offset !== undefined) {\n        posVChildren.push({\n          name: 'wp:posOffset',\n          children: [posV.offset.toString()],\n        });\n      } else if (posV.alignment) {\n        posVChildren.push({\n          name: 'wp:align',\n          children: [posV.alignment],\n        });\n      }\n\n      children.push({\n        name: 'wp:positionV',\n        attributes: {\n          relativeFrom: posV.anchor,\n        },\n        children: posVChildren,\n      });\n    }\n\n    // Extent (size)\n    children.push({\n      name: 'wp:extent',\n      attributes: {\n        cx: this.width.toString(),\n        cy: this.height.toString(),\n      },\n      selfClosing: true,\n    });\n\n    // Effect extent\n    children.push({\n      name: 'wp:effectExtent',\n      attributes: {\n        l: '0',\n        t: '0',\n        r: '0',\n        b: '0',\n      },\n      selfClosing: true,\n    });\n\n    // Wrap square (default for shapes)\n    children.push({\n      name: 'wp:wrapSquare',\n      attributes: {\n        wrapText: 'bothSides',\n      },\n      selfClosing: true,\n    });\n\n    // Document properties\n    children.push({\n      name: 'wp:docPr',\n      attributes: {\n        id: this.docPrId.toString(),\n        name: this.name,\n        descr: this.description,\n      },\n      selfClosing: true,\n    });\n\n    // Non-visual graphic frame properties\n    children.push({\n      name: 'wp:cNvGraphicFramePr',\n      selfClosing: true,\n    });\n\n    // Graphic data (the actual shape)\n    children.push(this.createGraphic());\n\n    return {\n      name: 'wp:anchor',\n      attributes: {\n        distT: '0',\n        distB: '0',\n        distL: '0',\n        distR: '0',\n        simplePos: '0',\n        relativeHeight: anchorConfig.relativeHeight.toString(),\n        behindDoc: anchorConfig.behindDoc ? '1' : '0',\n        locked: anchorConfig.locked ? '1' : '0',\n        layoutInCell: anchorConfig.layoutInCell ? '1' : '0',\n        allowOverlap: anchorConfig.allowOverlap ? '1' : '0',\n      },\n      children,\n    };\n  }\n\n  /**\n   * Creates the a:graphic element containing the shape\n   * @private\n   */\n  private createGraphic(): XMLElement {\n    return {\n      name: 'a:graphic',\n      attributes: {\n        'xmlns:a': 'http://schemas.openxmlformats.org/drawingml/2006/main',\n      },\n      children: [\n        {\n          name: 'a:graphicData',\n          attributes: {\n            uri: 'http://schemas.microsoft.com/office/word/2010/wordprocessingShape',\n          },\n          children: [this.createWps()],\n        },\n      ],\n    };\n  }\n\n  /**\n   * Creates the wps:wsp element (WordprocessingShape)\n   * @private\n   */\n  private createWps(): XMLElement {\n    const children: XMLElement[] = [];\n\n    // Non-visual shape properties\n    children.push({\n      name: 'wps:cNvSpPr',\n      attributes: {\n        'xmlns:wps': 'http://schemas.microsoft.com/office/word/2010/wordprocessingShape',\n      },\n      selfClosing: true,\n    });\n\n    // Shape properties (geometry, fill, outline)\n    children.push(this.createSpPr());\n\n    // Text box (if text is present)\n    if (this.text) {\n      children.push(this.createTextBox());\n    }\n\n    // Body properties (required per CT_WordprocessingShape)\n    children.push({\n      name: 'wps:bodyPr',\n      attributes: {\n        rot: '0',\n        vert: 'horz',\n        wrap: 'square',\n        lIns: '91440',\n        tIns: '45720',\n        rIns: '91440',\n        bIns: '45720',\n        anchor: 't',\n        anchorCtr: '0',\n        upright: '1',\n      },\n      selfClosing: true,\n    });\n\n    return {\n      name: 'wps:wsp',\n      attributes: {\n        'xmlns:wps': 'http://schemas.microsoft.com/office/word/2010/wordprocessingShape',\n      },\n      children,\n    };\n  }\n\n  /**\n   * Creates the wps:spPr element (shape properties)\n   * @private\n   */\n  private createSpPr(): XMLElement {\n    const children: XMLElement[] = [];\n\n    // Transform (position and size)\n    const xfrmAttrs = this.rotation > 0 ? { rot: (this.rotation * 60000).toString() } : undefined;\n    children.push({\n      name: 'a:xfrm',\n      attributes: xfrmAttrs,\n      children: [\n        {\n          name: 'a:off',\n          attributes: { x: '0', y: '0' },\n          selfClosing: true,\n        },\n        {\n          name: 'a:ext',\n          attributes: {\n            cx: this.width.toString(),\n            cy: this.height.toString(),\n          },\n          selfClosing: true,\n        },\n      ],\n    });\n\n    // Preset geometry (shape type)\n    children.push({\n      name: 'a:prstGeom',\n      attributes: {\n        prst: this.shapeType,\n      },\n      children: [\n        {\n          name: 'a:avLst',\n          selfClosing: true,\n        },\n      ],\n    });\n\n    // Fill\n    if (this.fill) {\n      const fillChildren: XMLElement[] = [];\n\n      // Color\n      const colorAttrs: Record<string, string> = {\n        val: this.fill.color.toUpperCase(),\n      };\n\n      // Transparency (alpha percentage)\n      if (this.fill.transparency !== undefined) {\n        // Convert 0-100 to 0-100000 (percentage * 1000)\n        const alpha = 100 - this.fill.transparency; // Invert (0=transparent, 100=opaque)\n        fillChildren.push({\n          name: 'a:alpha',\n          attributes: {\n            val: Math.round(alpha * 1000).toString(),\n          },\n          selfClosing: true,\n        });\n      }\n\n      children.push({\n        name: 'a:solidFill',\n        children: [\n          {\n            name: 'a:srgbClr',\n            attributes: colorAttrs,\n            ...(fillChildren.length > 0 ? { children: fillChildren } : { selfClosing: true }),\n          },\n        ],\n      });\n    }\n\n    // Outline\n    if (this.outline) {\n      const lnAttrs: Record<string, string> = {\n        w: this.outline.width.toString(),\n      };\n      if (this.outline.cap) lnAttrs.cap = this.outline.cap;\n      if (this.outline.compound) lnAttrs.cmpd = this.outline.compound;\n\n      const lnChildren: XMLElement[] = [];\n\n      // Outline color\n      lnChildren.push({\n        name: 'a:solidFill',\n        children: [\n          {\n            name: 'a:srgbClr',\n            attributes: {\n              val: this.outline.color.toUpperCase(),\n            },\n            selfClosing: true,\n          },\n        ],\n      });\n\n      // Line style (prstDash)\n      if (this.outline.style && this.outline.style !== 'solid') {\n        lnChildren.push({\n          name: 'a:prstDash',\n          attributes: {\n            val: this.outline.style,\n          },\n          selfClosing: true,\n        });\n      }\n\n      // Line join style\n      if (this.outline.join) {\n        const joinNames = { bevel: 'a:bevel', miter: 'a:miter', round: 'a:round' } as const;\n        const joinName = joinNames[this.outline.join];\n        if (joinName) {\n          lnChildren.push({\n            name: joinName,\n            selfClosing: true,\n          });\n        }\n      }\n\n      children.push({\n        name: 'a:ln',\n        attributes: lnAttrs,\n        children: lnChildren,\n      });\n    }\n\n    return {\n      name: 'wps:spPr',\n      children,\n    };\n  }\n\n  /**\n   * Creates the wps:txbx element (text box within shape)\n   * @private\n   */\n  private createTextBox(): XMLElement {\n    if (!this.text) {\n      return { name: 'wps:txbx', selfClosing: true };\n    }\n\n    // Build run properties\n    const rPrChildren: XMLElement[] = [];\n    if (this.textFormatting) {\n      if (this.textFormatting.bold) {\n        rPrChildren.push(XMLBuilder.wSelf('b'));\n      }\n      if (this.textFormatting.italic) {\n        rPrChildren.push(XMLBuilder.wSelf('i'));\n      }\n      if (this.textFormatting.color) {\n        rPrChildren.push(XMLBuilder.wSelf('color', { 'w:val': this.textFormatting.color }));\n      }\n      if (this.textFormatting.size) {\n        const halfPoints = pointsToHalfPoints(this.textFormatting.size);\n        rPrChildren.push(XMLBuilder.wSelf('sz', { 'w:val': halfPoints }));\n        rPrChildren.push(XMLBuilder.wSelf('szCs', { 'w:val': halfPoints }));\n      }\n    }\n\n    // Build paragraph with run\n    const runChildren: XMLElement[] = [];\n    if (rPrChildren.length > 0) {\n      runChildren.push(XMLBuilder.w('rPr', undefined, rPrChildren));\n    }\n    runChildren.push(XMLBuilder.w('t', { 'xml:space': 'preserve' }, [this.text]));\n\n    const paragraph = XMLBuilder.w('p', undefined, [XMLBuilder.w('r', undefined, runChildren)]);\n\n    return {\n      name: 'wps:txbx',\n      children: [\n        {\n          name: 'w:txbxContent',\n          children: [paragraph],\n        },\n      ],\n    };\n  }\n}\n"]}