docx-plus 0.1.1 → 0.1.3

package/dist/index.mjs

@@ -11457,27 +11457,27 @@ const createBlip = (mediaData, blipEffects) => {
 * @example
 * ```typescript
 * // Crop 10% from left and right
-* createSourceRectangle({ l: 10000, r: 10000 });
+* createSourceRectangle({ left: 10000, right: 10000 });
 * ```
 */
 const createSourceRectangle = (options) => {
 	if (!options) return new BuilderElement({ name: "a:srcRect" });
 	const attributes = {};
-	if (options.l !== void 0) attributes.l = {
+	if (options.left !== void 0) attributes.l = {
 		key: "l",
-		value: options.l
+		value: options.left
 	};
-	if (options.t !== void 0) attributes.t = {
+	if (options.top !== void 0) attributes.t = {
 		key: "t",
-		value: options.t
+		value: options.top
 	};
-	if (options.r !== void 0) attributes.r = {
+	if (options.right !== void 0) attributes.r = {
 		key: "r",
-		value: options.r
+		value: options.right
 	};
-	if (options.b !== void 0) attributes.b = {
+	if (options.bottom !== void 0) attributes.b = {
 		key: "b",
-		value: options.b
+		value: options.bottom
 	};
 	return new BuilderElement({
 		attributes,
@@ -12408,7 +12408,8 @@ const TextWrappingType = {
 	NONE: 0,
 	SQUARE: 1,
 	TIGHT: 2,
-	TOP_AND_BOTTOM: 3
+	TOP_AND_BOTTOM: 3,
+	THROUGH: 4
 };
 /**
 * Enumeration of text wrapping sides for floating drawings.
@@ -12523,10 +12524,101 @@ const createWrapSquare = (textWrapping, margins = {
 * @module
 */
 /**
+* Creates a default rectangular wrap polygon matching the image extent.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_WrapPath">
+*   <xsd:sequence>
+*     <xsd:element name="start" type="a:CT_Point2D" minOccurs="1" maxOccurs="1"/>
+*     <xsd:element name="lineTo" type="a:CT_Point2D" minOccurs="2" maxOccurs="unbounded"/>
+*   </xsd:sequence>
+*   <xsd:attribute name="edited" type="xsd:boolean" use="optional"/>
+* </xsd:complexType>
+* ```
+*/
+const createWrapPolygon$1 = (cx, cy) => new BuilderElement({
+	attributes: { edited: {
+		key: "edited",
+		value: "0"
+	} },
+	children: [
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: 0
+				},
+				y: {
+					key: "y",
+					value: 0
+				}
+			},
+			name: "wp:start"
+		}),
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: cx
+				},
+				y: {
+					key: "y",
+					value: 0
+				}
+			},
+			name: "wp:lineTo"
+		}),
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: cx
+				},
+				y: {
+					key: "y",
+					value: cy
+				}
+			},
+			name: "wp:lineTo"
+		}),
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: 0
+				},
+				y: {
+					key: "y",
+					value: cy
+				}
+			},
+			name: "wp:lineTo"
+		}),
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: 0
+				},
+				y: {
+					key: "y",
+					value: 0
+				}
+			},
+			name: "wp:lineTo"
+		})
+	],
+	name: "wp:wrapPolygon"
+});
+/**
 * Creates tight text wrapping for a floating drawing.
 *
 * WrapTight causes text to wrap closely around the contours
 * of the drawing rather than its rectangular bounding box.
+* A default rectangular wrap polygon matching the image extent is generated.
 *
 * Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
 *
@@ -12534,7 +12626,7 @@ const createWrapSquare = (textWrapping, margins = {
 * ```xml
 * <xsd:complexType name="CT_WrapTight">
 *   <xsd:sequence>
-*     <xsd:element name="wrapPolygon" type="CT_WrapPath"/>
+*     <xsd:element name="wrapPolygon" type="CT_WrapPath" minOccurs="1" maxOccurs="1"/>
 *   </xsd:sequence>
 *   <xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
 *   <xsd:attribute name="distL" type="ST_WrapDistance"/>
@@ -12542,23 +12634,176 @@ const createWrapSquare = (textWrapping, margins = {
 * </xsd:complexType>
 * ```
 */
-const createWrapTight = (margins = {
+const createWrapTight = (textWrapping, margins = {
 	bottom: 0,
+	left: 0,
+	right: 0,
 	top: 0
-}) => new BuilderElement({
+}, extent) => new BuilderElement({
 	attributes: {
-		distB: {
-			key: "distB",
-			value: margins.bottom
+		distL: {
+			key: "distL",
+			value: margins.left
 		},
-		distT: {
-			key: "distT",
-			value: margins.top
+		distR: {
+			key: "distR",
+			value: margins.right
+		},
+		wrapText: {
+			key: "wrapText",
+			value: textWrapping.side || TextWrappingSide.BOTH_SIDES
 		}
 	},
+	children: [createWrapPolygon$1(extent.x, extent.y)],
 	name: "wp:wrapTight"
 });
 //#endregion
+//#region src/file/drawing/text-wrap/wrap-through.ts
+/**
+* Wrap Through module for DrawingML text wrapping.
+*
+* This module provides "through" text wrapping for floating drawings
+* where text wraps through the image contours, filling any concave areas.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* @module
+*/
+/**
+* Creates a default rectangular wrap polygon matching the image extent.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_WrapPath">
+*   <xsd:sequence>
+*     <xsd:element name="start" type="a:CT_Point2D" minOccurs="1" maxOccurs="1"/>
+*     <xsd:element name="lineTo" type="a:CT_Point2D" minOccurs="2" maxOccurs="unbounded"/>
+*   </xsd:sequence>
+*   <xsd:attribute name="edited" type="xsd:boolean" use="optional"/>
+* </xsd:complexType>
+* ```
+*/
+const createWrapPolygon = (cx, cy) => new BuilderElement({
+	attributes: { edited: {
+		key: "edited",
+		value: "0"
+	} },
+	children: [
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: 0
+				},
+				y: {
+					key: "y",
+					value: 0
+				}
+			},
+			name: "wp:start"
+		}),
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: cx
+				},
+				y: {
+					key: "y",
+					value: 0
+				}
+			},
+			name: "wp:lineTo"
+		}),
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: cx
+				},
+				y: {
+					key: "y",
+					value: cy
+				}
+			},
+			name: "wp:lineTo"
+		}),
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: 0
+				},
+				y: {
+					key: "y",
+					value: cy
+				}
+			},
+			name: "wp:lineTo"
+		}),
+		new BuilderElement({
+			attributes: {
+				x: {
+					key: "x",
+					value: 0
+				},
+				y: {
+					key: "y",
+					value: 0
+				}
+			},
+			name: "wp:lineTo"
+		})
+	],
+	name: "wp:wrapPolygon"
+});
+/**
+* Creates "through" text wrapping for a floating drawing.
+*
+* WrapThrough is similar to WrapTight but allows text to wrap through
+* the concave portions of the drawing shape (e.g., the inside of the letter "O").
+* A default rectangular wrap polygon matching the image extent is generated.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_WrapThrough">
+*   <xsd:sequence>
+*     <xsd:element name="wrapPolygon" type="CT_WrapPath" minOccurs="1" maxOccurs="1"/>
+*   </xsd:sequence>
+*   <xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
+*   <xsd:attribute name="distL" type="ST_WrapDistance"/>
+*   <xsd:attribute name="distR" type="ST_WrapDistance"/>
+* </xsd:complexType>
+* ```
+*/
+const createWrapThrough = (textWrapping, margins = {
+	bottom: 0,
+	left: 0,
+	right: 0,
+	top: 0
+}, extent) => new BuilderElement({
+	attributes: {
+		distL: {
+			key: "distL",
+			value: margins.left
+		},
+		distR: {
+			key: "distR",
+			value: margins.right
+		},
+		wrapText: {
+			key: "wrapText",
+			value: textWrapping.side || TextWrappingSide.BOTH_SIDES
+		}
+	},
+	children: [createWrapPolygon(extent.x, extent.y)],
+	name: "wp:wrapThrough"
+});
+//#endregion
 //#region src/file/drawing/text-wrap/wrap-top-and-bottom.ts
 /**
 * Wrap Top and Bottom module for DrawingML text wrapping.
@@ -13008,7 +13253,16 @@ var Anchor = class extends XmlComponent {
 				this.root.push(createWrapSquare(drawingOptions.floating.wrap, drawingOptions.floating.margins));
 				break;
 			case TextWrappingType.TIGHT:
-				this.root.push(createWrapTight(drawingOptions.floating.margins));
+				this.root.push(createWrapTight(drawingOptions.floating.wrap, drawingOptions.floating.margins, {
+					x: transform.emus.x,
+					y: transform.emus.y
+				}));
+				break;
+			case TextWrappingType.THROUGH:
+				this.root.push(createWrapThrough(drawingOptions.floating.wrap, drawingOptions.floating.margins, {
+					x: transform.emus.x,
+					y: transform.emus.y
+				}));
 				break;
 			case TextWrappingType.TOP_AND_BOTTOM:
 				this.root.push(createWrapTopAndBottom(drawingOptions.floating.margins));
@@ -27633,4 +27887,4 @@ const findPatchKeys = (text) => {
 	return (_text$match = text.match(/(?<=\{\{).+?(?=\}\})/gs)) !== null && _text$match !== void 0 ? _text$match : [];
 };
 //#endregion
-export { AbstractNumbering, AlignmentType, AnnotationReference, Attributes, BaseXmlComponent, Body, Bookmark, BookmarkEnd, BookmarkStart, Border, BorderStyle, BuilderElement, CarriageReturn, CellMerge, CellMergeAttributes, CharacterSet, CheckBox, CheckBoxSymbolElement, CheckBoxUtil, Column, ColumnBreak, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, Comments, ConcreteHyperlink, ConcreteNumbering, ContinuationSeparator, DayLong, DayShort, DeletedTableCell, DeletedTableRow, DeletedTextRun, File as Document, File, DocumentAttributeNamespaces, DocumentAttributes, DocumentBackground, DocumentBackgroundAttributes, DocumentDefaults, DocumentGridType, Drawing, DropCapType, EMPTY_OBJECT, EmphasisMarkType, EmptyElement, EndnoteIdReference, EndnoteReference, EndnoteReferenceRun, EndnoteReferenceRunAttributes, Endnotes, ExternalHyperlink, FileChild, FootNoteReferenceRunAttributes, FootNotes, Footer, FooterWrapper, FootnoteReference, FootnoteReferenceElement, FootnoteReferenceRun, FrameAnchorType, FrameWrap, GridSpan, Header, HeaderFooterReferenceType, HeaderFooterType, HeaderWrapper, HeadingLevel, HeightRule, HighlightColor, HorizontalPositionAlign, HorizontalPositionRelativeFrom, HpsMeasureElement, HyperlinkType, IgnoreIfEmptyXmlComponent, ImageRun, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, InsertedTableCell, InsertedTableRow, InsertedTextRun, InternalHyperlink, LastRenderedPageBreak, LeaderType, Level, LevelBase, LevelForOverride, LevelFormat, LevelOverride, LevelSuffix, LineNumberRestartFormat, LineRuleType, Math$1 as Math, MathAngledBrackets, MathCurlyBrackets, MathDegree, MathDenominator, MathFraction, MathFunction, MathFunctionName, MathFunctionProperties, MathIntegral, MathLimit, MathLimitLower, MathLimitUpper, MathNumerator, MathPreSubSuperScript, MathRadical, MathRadicalProperties, MathRoundBrackets, MathRun, MathSquareBrackets, MathSubScript, MathSubSuperScript, MathSum, MathSuperScript, Media, MonthLong, MonthShort, NextAttributeComponent, NoBreakHyphen, NumberFormat, NumberProperties, NumberValueElement, NumberedItemReference, NumberedItemReferenceFormat, Numbering, OnOffElement, OverlapType, Packer, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageBorders, PageBreak, PageBreakBefore, PageNumber, PageNumberElement, PageNumberSeparator, PageOrientation, PageReference, PageTextDirection, PageTextDirectionType, Paragraph, ParagraphProperties, ParagraphPropertiesChange, ParagraphPropertiesDefaults, ParagraphRunProperties, PatchType, PositionalTab, PositionalTabAlignment, PositionalTabLeader, PositionalTabRelativeTo, PrettifyType, RelativeHorizontalPosition, RelativeVerticalPosition, Run, RunProperties, RunPropertiesChange, RunPropertiesDefaults, SectionProperties, SectionPropertiesChange, SectionType, Separator, SequentialIdentifier, ShadingType, SimpleField, SimpleMailMergeField, SoftHyphen, SpaceType, StringContainer, StringEnumValueElement, StringValueElement, StyleForCharacter, StyleForParagraph, StyleLevel, Styles, SymbolRun, TDirection, Tab, TabStopPosition, TabStopType, Table, TableAnchorType, TableBorders, TableCell, TableCellBorders, TableLayoutType, TableOfContents, TableProperties, TableRow, TableRowProperties, TableRowPropertiesChange, TextAlignmentType, TextDirection, TextEffect, TextRun, TextWrappingSide, TextWrappingType, Textbox, TextboxTightWrapType, ThematicBreak, ThemeColor, ThemeFont, UnderlineType, VerticalAlign, VerticalAlignSection, VerticalAlignTable, VerticalAnchor, VerticalMerge, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WORKAROUND2, WORKAROUND3, WORKAROUND4, WidthType, WpgGroupRun, WpsShapeRun, XmlAttributeComponent, XmlComponent, YearLong, YearShort, abstractNumUniqueNumericIdGen, bookmarkUniqueNumericIdGen, concreteNumUniqueNumericIdGen, convertInchesToTwip, convertMillimetersToTwip, convertToXmlComponent, createAlignment, createBodyProperties, createBorderElement, createColumns, createDocumentGrid, createDotEmphasisMark, createEmphasisMark, createFrameProperties, createHeaderFooterReference, createHorizontalPosition, createIndent, createLineNumberType, createMathAccentCharacter, createMathBase, createMathLimitLocation, createMathNAryProperties, createMathPreSubSuperScriptProperties, createMathSubScriptElement, createMathSubScriptProperties, createMathSubSuperScriptProperties, createMathSuperScriptElement, createMathSuperScriptProperties, createOutlineLevel, createPageMargin, createPageNumberType, createPageSize, createParagraphStyle, createRunFonts, createSectionType, createShading, createSimplePos, createSpacing, createStringElement, createTabStop, createTabStopItem, createTableFloatProperties, createTableLayout, createTableLook, createTableRowHeight, createTableWidthElement, createTransformation, createUnderline, createVerticalAlign, createVerticalPosition, createWrapNone, createWrapSquare, createWrapTight, createWrapTopAndBottom, dateTimeValue, decimalNumber, docPropertiesUniqueNumericIdGen, eighthPointMeasureValue, hashedId, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, patchDetector, patchDocument, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, sectionMarginDefaults, sectionPageSizeDefaults, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, twipsMeasureValue, uCharHexNumber, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber };
+export { AbstractNumbering, AlignmentType, AnnotationReference, Attributes, BaseXmlComponent, Body, Bookmark, BookmarkEnd, BookmarkStart, Border, BorderStyle, BuilderElement, CarriageReturn, CellMerge, CellMergeAttributes, CharacterSet, CheckBox, CheckBoxSymbolElement, CheckBoxUtil, Column, ColumnBreak, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, Comments, ConcreteHyperlink, ConcreteNumbering, ContinuationSeparator, DayLong, DayShort, DeletedTableCell, DeletedTableRow, DeletedTextRun, File as Document, File, DocumentAttributeNamespaces, DocumentAttributes, DocumentBackground, DocumentBackgroundAttributes, DocumentDefaults, DocumentGridType, Drawing, DropCapType, EMPTY_OBJECT, EmphasisMarkType, EmptyElement, EndnoteIdReference, EndnoteReference, EndnoteReferenceRun, EndnoteReferenceRunAttributes, Endnotes, ExternalHyperlink, FileChild, FootNoteReferenceRunAttributes, FootNotes, Footer, FooterWrapper, FootnoteReference, FootnoteReferenceElement, FootnoteReferenceRun, FrameAnchorType, FrameWrap, GridSpan, Header, HeaderFooterReferenceType, HeaderFooterType, HeaderWrapper, HeadingLevel, HeightRule, HighlightColor, HorizontalPositionAlign, HorizontalPositionRelativeFrom, HpsMeasureElement, HyperlinkType, IgnoreIfEmptyXmlComponent, ImageRun, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, InsertedTableCell, InsertedTableRow, InsertedTextRun, InternalHyperlink, LastRenderedPageBreak, LeaderType, Level, LevelBase, LevelForOverride, LevelFormat, LevelOverride, LevelSuffix, LineNumberRestartFormat, LineRuleType, Math$1 as Math, MathAngledBrackets, MathCurlyBrackets, MathDegree, MathDenominator, MathFraction, MathFunction, MathFunctionName, MathFunctionProperties, MathIntegral, MathLimit, MathLimitLower, MathLimitUpper, MathNumerator, MathPreSubSuperScript, MathRadical, MathRadicalProperties, MathRoundBrackets, MathRun, MathSquareBrackets, MathSubScript, MathSubSuperScript, MathSum, MathSuperScript, Media, MonthLong, MonthShort, NextAttributeComponent, NoBreakHyphen, NumberFormat, NumberProperties, NumberValueElement, NumberedItemReference, NumberedItemReferenceFormat, Numbering, OnOffElement, OverlapType, Packer, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageBorders, PageBreak, PageBreakBefore, PageNumber, PageNumberElement, PageNumberSeparator, PageOrientation, PageReference, PageTextDirection, PageTextDirectionType, Paragraph, ParagraphProperties, ParagraphPropertiesChange, ParagraphPropertiesDefaults, ParagraphRunProperties, PatchType, PositionalTab, PositionalTabAlignment, PositionalTabLeader, PositionalTabRelativeTo, PrettifyType, RelativeHorizontalPosition, RelativeVerticalPosition, Run, RunProperties, RunPropertiesChange, RunPropertiesDefaults, SectionProperties, SectionPropertiesChange, SectionType, Separator, SequentialIdentifier, ShadingType, SimpleField, SimpleMailMergeField, SoftHyphen, SpaceType, StringContainer, StringEnumValueElement, StringValueElement, StyleForCharacter, StyleForParagraph, StyleLevel, Styles, SymbolRun, TDirection, Tab, TabStopPosition, TabStopType, Table, TableAnchorType, TableBorders, TableCell, TableCellBorders, TableLayoutType, TableOfContents, TableProperties, TableRow, TableRowProperties, TableRowPropertiesChange, TextAlignmentType, TextDirection, TextEffect, TextRun, TextWrappingSide, TextWrappingType, Textbox, TextboxTightWrapType, ThematicBreak, ThemeColor, ThemeFont, UnderlineType, VerticalAlign, VerticalAlignSection, VerticalAlignTable, VerticalAnchor, VerticalMerge, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WORKAROUND2, WORKAROUND3, WORKAROUND4, WidthType, WpgGroupRun, WpsShapeRun, XmlAttributeComponent, XmlComponent, YearLong, YearShort, abstractNumUniqueNumericIdGen, bookmarkUniqueNumericIdGen, concreteNumUniqueNumericIdGen, convertInchesToTwip, convertMillimetersToTwip, convertToXmlComponent, createAlignment, createBodyProperties, createBorderElement, createColumns, createDocumentGrid, createDotEmphasisMark, createEmphasisMark, createFrameProperties, createHeaderFooterReference, createHorizontalPosition, createIndent, createLineNumberType, createMathAccentCharacter, createMathBase, createMathLimitLocation, createMathNAryProperties, createMathPreSubSuperScriptProperties, createMathSubScriptElement, createMathSubScriptProperties, createMathSubSuperScriptProperties, createMathSuperScriptElement, createMathSuperScriptProperties, createOutlineLevel, createPageMargin, createPageNumberType, createPageSize, createParagraphStyle, createRunFonts, createSectionType, createShading, createSimplePos, createSpacing, createStringElement, createTabStop, createTabStopItem, createTableFloatProperties, createTableLayout, createTableLook, createTableRowHeight, createTableWidthElement, createTransformation, createUnderline, createVerticalAlign, createVerticalPosition, createWrapNone, createWrapSquare, createWrapThrough, createWrapTight, createWrapTopAndBottom, dateTimeValue, decimalNumber, docPropertiesUniqueNumericIdGen, eighthPointMeasureValue, hashedId, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, patchDetector, patchDocument, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, sectionMarginDefaults, sectionPageSizeDefaults, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, twipsMeasureValue, uCharHexNumber, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber };