docx-plus 0.0.1 → 0.0.3

package/README.md

@@ -21,11 +21,12 @@
 
 ## What's Different from docx?
 
-|                       | docx                                      | docx-plus                            |
-| --------------------- | ----------------------------------------- | ------------------------------------ |
-| ZIP handling          | jszip                                     | **fflate** (faster, smaller)         |
-| Data conversion       | Manual env detection (`Buffer.from` etc.) | **undio** (universal `toUint8Array`) |
-| Test environment      | jsdom                                     | happy-dom                            |
+|                     | docx                                      | docx-plus                            |
+| ------------------- | ----------------------------------------- | ------------------------------------ |
+| ZIP handling        | jszip                                     | **fflate** (faster, smaller)         |
+| Data conversion     | Manual env detection (`Buffer.from` etc.) | **undio** (universal `toUint8Array`) |
+| `Packer.toStream()` | Removed (pseudo-streaming)                | **Restored** with real streaming ZIP |
+| Test environment    | jsdom                                     | happy-dom                            |
 
 ## Installation
 

package/dist/index.cjs

@@ -25,8 +25,9 @@ let xml_js = require("xml-js");
 let hash_js = require("hash.js");
 hash_js = __toESM(hash_js);
 let nanoid_non_secure = require("nanoid/non-secure");
-let fflate = require("fflate");
 let undio = require("undio");
+let stream = require("stream");
+let fflate = require("fflate");
 let xml = require("xml");
 xml = __toESM(xml);
 //#region \0@oxc-project+runtime@0.123.0/helpers/typeof.js
@@ -5776,29 +5777,20 @@ var Drawing = class extends XmlComponent {
 };
 //#endregion
 //#region src/file/paragraph/run/image-run.ts
-const convertDataURIToBinary = (dataURI) => {
-	const base64Index = dataURI.indexOf(";base64,");
-	const base64IndexWithOffset = base64Index === -1 ? 0 : base64Index + 8;
-	const binaryString = atob(dataURI.substring(base64IndexWithOffset));
-	const bytes = new Uint8Array(binaryString.length);
-	for (let i = 0; i < binaryString.length; i++) bytes[i] = binaryString.charCodeAt(i);
-	return bytes;
-};
-const standardizeData = (data) => typeof data === "string" ? convertDataURIToBinary(data) : data;
-const createImageData = (options, key) => ({
-	data: standardizeData(options.data),
+const createImageData = (data, transformation, key) => ({
+	data,
 	fileName: key,
 	transformation: {
 		emus: {
-			x: Math.round(options.transformation.width * 9525),
-			y: Math.round(options.transformation.height * 9525)
+			x: Math.round(transformation.width * 9525),
+			y: Math.round(transformation.height * 9525)
 		},
-		flip: options.transformation.flip,
+		flip: transformation.flip,
 		pixels: {
-			x: Math.round(options.transformation.width),
-			y: Math.round(options.transformation.height)
+			x: Math.round(transformation.width),
+			y: Math.round(transformation.height)
 		},
-		rotation: options.transformation.rotation ? options.transformation.rotation * 6e4 : void 0
+		rotation: transformation.rotation ? transformation.rotation * 6e4 : void 0
 	}
 });
 /**
@@ -5827,8 +5819,12 @@ var ImageRun = class extends Run {
 	constructor(options) {
 		super({});
 		_defineProperty(this, "imageData", void 0);
-		const key = `${hashedId(options.data)}.${options.type}`;
-		this.imageData = options.type === "svg" ? _objectSpread2(_objectSpread2({ type: options.type }, createImageData(options, key)), {}, { fallback: _objectSpread2({ type: options.fallback.type }, createImageData(_objectSpread2(_objectSpread2({}, options.fallback), {}, { transformation: options.transformation }), `${hashedId(options.fallback.data)}.${options.fallback.type}`)) }) : _objectSpread2({ type: options.type }, createImageData(options, key));
+		const rawData = (0, undio.toUint8Array)(options.data);
+		const key = `${hashedId(rawData)}.${options.type}`;
+		if (options.type === "svg") {
+			const fallbackData = (0, undio.toUint8Array)(options.fallback.data);
+			this.imageData = _objectSpread2(_objectSpread2({ type: options.type }, createImageData(rawData, options.transformation, key)), {}, { fallback: _objectSpread2({ type: options.fallback.type }, createImageData(fallbackData, options.transformation, `${hashedId(fallbackData)}.${options.fallback.type}`)) });
+		} else this.imageData = _objectSpread2({ type: options.type }, createImageData(rawData, options.transformation, key));
 		const drawing = new Drawing(this.imageData, {
 			docProperties: options.altText,
 			floating: options.floating,
@@ -18291,6 +18287,14 @@ var Textbox = class extends FileChild {
 //#endregion
 //#region src/util/output-type.ts
 /**
+* Output type definitions for document generation.
+*
+* This module defines the various output formats supported when generating
+* .docx files. These types correspond to fflate's output formats.
+*
+* @module
+*/
+/**
 * Converts a Uint8Array to the specified output type.
 *
 * This is used by both the Packer and patchDocument to convert fflate's
@@ -18302,10 +18306,10 @@ const convertOutput = (data, type) => {
 		case "blob": return new Blob([data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength)], { type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" });
 		case "arraybuffer": return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
 		case "uint8array": return data;
-		case "base64": return Buffer.from(data).toString("base64");
+		case "base64": return btoa((0, fflate.strFromU8)(data, true));
 		case "string":
-		case "text": return Buffer.from(data).toString("binary");
-		case "binarystring": return Buffer.from(data).toString("binary");
+		case "text":
+		case "binarystring": return (0, fflate.strFromU8)(data, true);
 		case "array": return [...data];
 		default: return data;
 	}
@@ -19019,6 +19023,50 @@ var Packer = class Packer {
 	static toArrayBuffer(file, prettify, overrides = []) {
 		return Packer.pack(file, "arraybuffer", prettify, overrides);
 	}
+	/**
+	* Exports a document to a Node.js Readable stream.
+	*
+	* Uses fflate's streaming Zip API to emit compressed chunks incrementally,
+	* avoiding buffering the entire archive in memory before the first byte
+	* is available to the consumer.
+	*
+	* @param file - The document to export
+	* @param prettify - Whether to prettify the XML output
+	* @param overrides - Optional array of file overrides
+	* @returns A readable stream containing the compressed .docx data
+	*
+	* @example
+	* ```typescript
+	* import { createWriteStream } from "fs";
+	* Packer.toStream(doc).pipe(createWriteStream("output.docx"));
+	* ```
+	*/
+	static toStream(file, prettify, overrides = []) {
+		const stream$1 = new stream.Readable({ read() {} });
+		try {
+			const files = this.compiler.compile(file, convertPrettifyType(prettify), overrides);
+			const zip = new fflate.Zip((err, chunk, final) => {
+				if (err) {
+					stream$1.destroy(err);
+					return;
+				}
+				if (!stream$1.destroyed) stream$1.push(chunk);
+				if (final) stream$1.push(null);
+			});
+			for (const [name, data] of Object.entries(files)) {
+				var _level;
+				const raw = Array.isArray(data) ? data[0] : data;
+				const level = Array.isArray(data) ? (_level = data[1].level) !== null && _level !== void 0 ? _level : 6 : 6;
+				const entry = level === 0 ? new fflate.ZipPassThrough(name) : new fflate.ZipDeflate(name, { level });
+				zip.add(entry);
+				entry.push(raw, true);
+			}
+			zip.end();
+		} catch (err) {
+			stream$1.destroy(err instanceof Error ? err : new Error(String(err)));
+		}
+		return stream$1;
+	}
 };
 _defineProperty(Packer, "compiler", new Compiler());
 //#endregion
@@ -20134,7 +20182,6 @@ exports.sectionPageSizeDefaults = sectionPageSizeDefaults;
 exports.shortHexNumber = shortHexNumber;
 exports.signedHpsMeasureValue = signedHpsMeasureValue;
 exports.signedTwipsMeasureValue = signedTwipsMeasureValue;
-exports.standardizeData = standardizeData;
 exports.twipsMeasureValue = twipsMeasureValue;
 exports.uCharHexNumber = uCharHexNumber;
 exports.uniqueId = uniqueId;

package/dist/index.d.cts

@@ -1,4 +1,6 @@
+import { DataType } from "undio";
 import { Element } from "xml-js";
+import { Readable } from "stream";
 //#region src/file/file-child.d.ts
 declare class FileChild extends XmlComponent {
   readonly fileChild: symbol;
@@ -699,7 +701,7 @@ interface IMediaDataTransformation {
 interface CoreMediaData {
   readonly fileName: string;
   readonly transformation: IMediaDataTransformation;
-  readonly data: Buffer | Uint8Array | ArrayBuffer;
+  readonly data: Uint8Array;
 }
 interface RegularMediaData {
   readonly type: "jpg" | "png" | "gif" | "bmp";
@@ -775,15 +777,14 @@ interface CoreImageOptions {
 }
 interface RegularImageOptions {
   readonly type: "jpg" | "png" | "gif" | "bmp";
-  readonly data: Buffer | string | Uint8Array | ArrayBuffer;
+  readonly data: DataType;
 }
 interface SvgMediaOptions {
   readonly type: "svg";
-  readonly data: Buffer | string | Uint8Array | ArrayBuffer;
+  readonly data: DataType;
   readonly fallback: RegularImageOptions;
 }
 type IImageOptions = (RegularImageOptions | SvgMediaOptions) & CoreImageOptions;
-declare const standardizeData: (data: string | Buffer | Uint8Array | ArrayBuffer) => Buffer | Uint8Array | ArrayBuffer;
 declare class ImageRun extends Run {
   private readonly imageData;
   constructor(options: IImageOptions);
@@ -3166,6 +3167,7 @@ declare class Packer {
   static toBase64String(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType], overrides?: readonly IXmlifyedFile[]): Promise<string>;
   static toBlob(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType], overrides?: readonly IXmlifyedFile[]): Promise<Blob>;
   static toArrayBuffer(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType], overrides?: readonly IXmlifyedFile[]): Promise<ArrayBuffer>;
+  static toStream(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType], overrides?: readonly IXmlifyedFile[]): Readable;
   private static readonly compiler;
 }
 //#endregion
@@ -3227,4 +3229,4 @@ declare const patchDetector: ({
   data
 }: PatchDetectorOptions) => Promise<readonly string[]>;
 //#endregion
-export { AbstractNumbering, AlignmentType, AnnotationReference, AttributeData, AttributeMap, AttributePayload, 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, DocumentAttributeNamespace, 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, IAlignmentFrameOptions, IBaseCharacterStyleOptions, IBaseParagraphStyleOptions, IBodyPropertiesOptions, IBookmarkOptions, IBorderOptions, IBordersOptions, ICellMergeAttributes, ICharacterStyleOptions, ICheckboxSymbolOptions, ICheckboxSymbolProperties, IColumnAttributes, IColumnsAttributes, ICommentOptions, ICommentsOptions, IConcreteNumberingOptions, IContext, IDistance, IDocGridAttributesProperties, IDocumentAttributesProperties, IDocumentBackgroundOptions, IDocumentDefaultsOptions, IDocumentFooter, IDocumentHeader, IDocumentOptions, IDrawingOptions, IExtendedMediaData, IExternalHyperlinkOptions, IFloating, IFontAttributesProperties, IFrameOptions, IGroupChildMediaData, IHeaderFooterGroup, IHeaderFooterOptions, IHeaderOptions, IHorizontalPositionOptions, IImageOptions, IIndentAttributesProperties, IInternalHyperlinkOptions, ILevelParagraphStylePropertiesOptions, ILevelsOptions, ILineNumberAttributes, IMargins, IMathFractionOptions, IMathFunctionOptions, IMathIntegralOptions, IMathLimitLowerOptions, IMathLimitUpperOptions, IMathOptions, IMathPreSubSuperScriptOptions, IMathRadicalOptions, IMathSubScriptOptions, IMathSubSuperScriptOptions, IMathSumOptions, IMathSuperScriptOptions, IMediaData, IMediaDataTransformation, IMediaTransformation, INumberedItemReferenceOptions, INumberingOptions, IPageBorderAttributes, IPageBordersOptions, IPageMarginAttributes, IPageNumberTypeAttributes, IPageReferenceOptions, IPageSizeAttributes, IParagraphOptions, IParagraphPropertiesChangeOptions, IParagraphPropertiesOptions, IParagraphPropertiesOptionsBase, IParagraphRunOptions, IParagraphRunPropertiesOptions, IParagraphStyleOptions, IParagraphStylePropertiesOptions, IPatch, type IPropertiesOptions, IRunOptions, IRunPropertiesChangeOptions, IRunPropertiesOptions, IRunStylePropertiesOptions, ISectionOptions, ISectionPropertiesChangeOptions, ISectionPropertiesOptions, ISectionPropertiesOptionsBase, IShadingAttributesProperties, ISpacingProperties, IStylesOptions, ISymbolRunOptions, ITableBordersOptions, ITableCellBorders, ITableCellOptions, ITableFloatOptions, ITableLookOptions, ITableOfContentsOptions, ITableOptions, ITablePropertiesChangeOptions, ITablePropertiesOptions, ITablePropertiesOptionsBase, ITableRowOptions, ITableRowPropertiesChangeOptions, ITableRowPropertiesOptions, ITableRowPropertiesOptionsBase, ITableWidthProperties, ITextWrapping, IVerticalPositionOptions, IWpgGroupOptions, IWpsShapeOptions, IXYFrameOptions, IXmlAttribute, IXmlableObject, IgnoreIfEmptyXmlComponent, ImageRun, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, InputDataType, InsertedTableCell, InsertedTableRow, InsertedTextRun, InternalHyperlink, LastRenderedPageBreak, LeaderType, Level, LevelBase, LevelForOverride, LevelFormat, LevelOverride, LevelSuffix, LineNumberRestartFormat, LineRuleType, Math, MathAngledBrackets, MathComponent, 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, OutputByType, OutputType, OverlapType, Packer, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageBorders, PageBreak, PageBreakBefore, PageNumber, PageNumberElement, PageNumberSeparator, PageOrientation, PageReference, PageTextDirection, PageTextDirectionType, Paragraph, ParagraphChild, ParagraphProperties, ParagraphPropertiesChange, ParagraphPropertiesDefaults, ParagraphRunProperties, PatchDocumentOptions, PatchDocumentOutputType, PatchType, Percentage, PositionalTab, PositionalTabAlignment, PositionalTabLeader, PositionalTabOptions, PositionalTabRelativeTo, PositivePercentage, PositiveUniversalMeasure, PrettifyType, RelativeHorizontalPosition, RelativeMeasure, RelativeVerticalPosition, Run, RunProperties, RunPropertiesChange, RunPropertiesDefaults, SectionProperties, SectionPropertiesChange, SectionType, SectionVerticalAlign, Separator, SequentialIdentifier, ShadingType, SimpleField, SimpleMailMergeField, SoftHyphen, SpaceType, StringContainer, StringEnumValueElement, StringValueElement, StyleForCharacter, StyleForParagraph, StyleLevel, Styles, SymbolRun, TDirection, Tab, TabStopDefinition, TabStopPosition, TabStopType, Table, TableAnchorType, TableBorders, TableCell, TableCellBorders, TableLayoutType, TableOfContents, TableProperties, TableRow, TableRowProperties, TableRowPropertiesChange, TableVerticalAlign, TextDirection, TextEffect, TextRun, TextWrappingSide, TextWrappingType, Textbox, ThematicBreak, UnderlineType, UniqueNumericIdCreator, UniversalMeasure, VerticalAlign, VerticalAlignSection, VerticalAlignTable, VerticalAnchor, VerticalMerge, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WORKAROUND2, WORKAROUND3, WORKAROUND4, WidthType, WpgCommonMediaData, WpgGroupRun, WpgMediaData, WpsMediaData, WpsShapeRun, XmlAttributeComponent, XmlComponent, YearLong, YearShort, abstractNumUniqueNumericIdGen, bookmarkUniqueNumericIdGen, concreteNumUniqueNumericIdGen, convertInchesToTwip, convertMillimetersToTwip, convertOutput, 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, encodeUtf8, hashedId, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, patchDetector, patchDocument, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, sectionMarginDefaults, sectionPageSizeDefaults, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, standardizeData, twipsMeasureValue, uCharHexNumber, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber };
+export { AbstractNumbering, AlignmentType, AnnotationReference, AttributeData, AttributeMap, AttributePayload, 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, DocumentAttributeNamespace, 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, IAlignmentFrameOptions, IBaseCharacterStyleOptions, IBaseParagraphStyleOptions, IBodyPropertiesOptions, IBookmarkOptions, IBorderOptions, IBordersOptions, ICellMergeAttributes, ICharacterStyleOptions, ICheckboxSymbolOptions, ICheckboxSymbolProperties, IColumnAttributes, IColumnsAttributes, ICommentOptions, ICommentsOptions, IConcreteNumberingOptions, IContext, IDistance, IDocGridAttributesProperties, IDocumentAttributesProperties, IDocumentBackgroundOptions, IDocumentDefaultsOptions, IDocumentFooter, IDocumentHeader, IDocumentOptions, IDrawingOptions, IExtendedMediaData, IExternalHyperlinkOptions, IFloating, IFontAttributesProperties, IFrameOptions, IGroupChildMediaData, IHeaderFooterGroup, IHeaderFooterOptions, IHeaderOptions, IHorizontalPositionOptions, IImageOptions, IIndentAttributesProperties, IInternalHyperlinkOptions, ILevelParagraphStylePropertiesOptions, ILevelsOptions, ILineNumberAttributes, IMargins, IMathFractionOptions, IMathFunctionOptions, IMathIntegralOptions, IMathLimitLowerOptions, IMathLimitUpperOptions, IMathOptions, IMathPreSubSuperScriptOptions, IMathRadicalOptions, IMathSubScriptOptions, IMathSubSuperScriptOptions, IMathSumOptions, IMathSuperScriptOptions, IMediaData, IMediaDataTransformation, IMediaTransformation, INumberedItemReferenceOptions, INumberingOptions, IPageBorderAttributes, IPageBordersOptions, IPageMarginAttributes, IPageNumberTypeAttributes, IPageReferenceOptions, IPageSizeAttributes, IParagraphOptions, IParagraphPropertiesChangeOptions, IParagraphPropertiesOptions, IParagraphPropertiesOptionsBase, IParagraphRunOptions, IParagraphRunPropertiesOptions, IParagraphStyleOptions, IParagraphStylePropertiesOptions, IPatch, type IPropertiesOptions, IRunOptions, IRunPropertiesChangeOptions, IRunPropertiesOptions, IRunStylePropertiesOptions, ISectionOptions, ISectionPropertiesChangeOptions, ISectionPropertiesOptions, ISectionPropertiesOptionsBase, IShadingAttributesProperties, ISpacingProperties, IStylesOptions, ISymbolRunOptions, ITableBordersOptions, ITableCellBorders, ITableCellOptions, ITableFloatOptions, ITableLookOptions, ITableOfContentsOptions, ITableOptions, ITablePropertiesChangeOptions, ITablePropertiesOptions, ITablePropertiesOptionsBase, ITableRowOptions, ITableRowPropertiesChangeOptions, ITableRowPropertiesOptions, ITableRowPropertiesOptionsBase, ITableWidthProperties, ITextWrapping, IVerticalPositionOptions, IWpgGroupOptions, IWpsShapeOptions, IXYFrameOptions, IXmlAttribute, IXmlableObject, IgnoreIfEmptyXmlComponent, ImageRun, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, InputDataType, InsertedTableCell, InsertedTableRow, InsertedTextRun, InternalHyperlink, LastRenderedPageBreak, LeaderType, Level, LevelBase, LevelForOverride, LevelFormat, LevelOverride, LevelSuffix, LineNumberRestartFormat, LineRuleType, Math, MathAngledBrackets, MathComponent, 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, OutputByType, OutputType, OverlapType, Packer, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageBorders, PageBreak, PageBreakBefore, PageNumber, PageNumberElement, PageNumberSeparator, PageOrientation, PageReference, PageTextDirection, PageTextDirectionType, Paragraph, ParagraphChild, ParagraphProperties, ParagraphPropertiesChange, ParagraphPropertiesDefaults, ParagraphRunProperties, PatchDocumentOptions, PatchDocumentOutputType, PatchType, Percentage, PositionalTab, PositionalTabAlignment, PositionalTabLeader, PositionalTabOptions, PositionalTabRelativeTo, PositivePercentage, PositiveUniversalMeasure, PrettifyType, RelativeHorizontalPosition, RelativeMeasure, RelativeVerticalPosition, Run, RunProperties, RunPropertiesChange, RunPropertiesDefaults, SectionProperties, SectionPropertiesChange, SectionType, SectionVerticalAlign, Separator, SequentialIdentifier, ShadingType, SimpleField, SimpleMailMergeField, SoftHyphen, SpaceType, StringContainer, StringEnumValueElement, StringValueElement, StyleForCharacter, StyleForParagraph, StyleLevel, Styles, SymbolRun, TDirection, Tab, TabStopDefinition, TabStopPosition, TabStopType, Table, TableAnchorType, TableBorders, TableCell, TableCellBorders, TableLayoutType, TableOfContents, TableProperties, TableRow, TableRowProperties, TableRowPropertiesChange, TableVerticalAlign, TextDirection, TextEffect, TextRun, TextWrappingSide, TextWrappingType, Textbox, ThematicBreak, UnderlineType, UniqueNumericIdCreator, UniversalMeasure, VerticalAlign, VerticalAlignSection, VerticalAlignTable, VerticalAnchor, VerticalMerge, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WORKAROUND2, WORKAROUND3, WORKAROUND4, WidthType, WpgCommonMediaData, WpgGroupRun, WpgMediaData, WpsMediaData, WpsShapeRun, XmlAttributeComponent, XmlComponent, YearLong, YearShort, abstractNumUniqueNumericIdGen, bookmarkUniqueNumericIdGen, concreteNumUniqueNumericIdGen, convertInchesToTwip, convertMillimetersToTwip, convertOutput, 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, encodeUtf8, hashedId, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, patchDetector, patchDocument, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, sectionMarginDefaults, sectionPageSizeDefaults, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, twipsMeasureValue, uCharHexNumber, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber };

package/dist/index.d.mts

@@ -1,4 +1,6 @@
 import { Element } from "xml-js";
+import { DataType } from "undio";
+import { Readable } from "stream";
 //#region src/file/file-child.d.ts
 declare class FileChild extends XmlComponent {
   readonly fileChild: symbol;
@@ -699,7 +701,7 @@ interface IMediaDataTransformation {
 interface CoreMediaData {
   readonly fileName: string;
   readonly transformation: IMediaDataTransformation;
-  readonly data: Buffer | Uint8Array | ArrayBuffer;
+  readonly data: Uint8Array;
 }
 interface RegularMediaData {
   readonly type: "jpg" | "png" | "gif" | "bmp";
@@ -775,15 +777,14 @@ interface CoreImageOptions {
 }
 interface RegularImageOptions {
   readonly type: "jpg" | "png" | "gif" | "bmp";
-  readonly data: Buffer | string | Uint8Array | ArrayBuffer;
+  readonly data: DataType;
 }
 interface SvgMediaOptions {
   readonly type: "svg";
-  readonly data: Buffer | string | Uint8Array | ArrayBuffer;
+  readonly data: DataType;
   readonly fallback: RegularImageOptions;
 }
 type IImageOptions = (RegularImageOptions | SvgMediaOptions) & CoreImageOptions;
-declare const standardizeData: (data: string | Buffer | Uint8Array | ArrayBuffer) => Buffer | Uint8Array | ArrayBuffer;
 declare class ImageRun extends Run {
   private readonly imageData;
   constructor(options: IImageOptions);
@@ -3166,6 +3167,7 @@ declare class Packer {
   static toBase64String(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType], overrides?: readonly IXmlifyedFile[]): Promise<string>;
   static toBlob(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType], overrides?: readonly IXmlifyedFile[]): Promise<Blob>;
   static toArrayBuffer(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType], overrides?: readonly IXmlifyedFile[]): Promise<ArrayBuffer>;
+  static toStream(file: File, prettify?: boolean | (typeof PrettifyType)[keyof typeof PrettifyType], overrides?: readonly IXmlifyedFile[]): Readable;
   private static readonly compiler;
 }
 //#endregion
@@ -3227,4 +3229,4 @@ declare const patchDetector: ({
   data
 }: PatchDetectorOptions) => Promise<readonly string[]>;
 //#endregion
-export { AbstractNumbering, AlignmentType, AnnotationReference, AttributeData, AttributeMap, AttributePayload, 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, DocumentAttributeNamespace, 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, IAlignmentFrameOptions, IBaseCharacterStyleOptions, IBaseParagraphStyleOptions, IBodyPropertiesOptions, IBookmarkOptions, IBorderOptions, IBordersOptions, ICellMergeAttributes, ICharacterStyleOptions, ICheckboxSymbolOptions, ICheckboxSymbolProperties, IColumnAttributes, IColumnsAttributes, ICommentOptions, ICommentsOptions, IConcreteNumberingOptions, IContext, IDistance, IDocGridAttributesProperties, IDocumentAttributesProperties, IDocumentBackgroundOptions, IDocumentDefaultsOptions, IDocumentFooter, IDocumentHeader, IDocumentOptions, IDrawingOptions, IExtendedMediaData, IExternalHyperlinkOptions, IFloating, IFontAttributesProperties, IFrameOptions, IGroupChildMediaData, IHeaderFooterGroup, IHeaderFooterOptions, IHeaderOptions, IHorizontalPositionOptions, IImageOptions, IIndentAttributesProperties, IInternalHyperlinkOptions, ILevelParagraphStylePropertiesOptions, ILevelsOptions, ILineNumberAttributes, IMargins, IMathFractionOptions, IMathFunctionOptions, IMathIntegralOptions, IMathLimitLowerOptions, IMathLimitUpperOptions, IMathOptions, IMathPreSubSuperScriptOptions, IMathRadicalOptions, IMathSubScriptOptions, IMathSubSuperScriptOptions, IMathSumOptions, IMathSuperScriptOptions, IMediaData, IMediaDataTransformation, IMediaTransformation, INumberedItemReferenceOptions, INumberingOptions, IPageBorderAttributes, IPageBordersOptions, IPageMarginAttributes, IPageNumberTypeAttributes, IPageReferenceOptions, IPageSizeAttributes, IParagraphOptions, IParagraphPropertiesChangeOptions, IParagraphPropertiesOptions, IParagraphPropertiesOptionsBase, IParagraphRunOptions, IParagraphRunPropertiesOptions, IParagraphStyleOptions, IParagraphStylePropertiesOptions, IPatch, type IPropertiesOptions, IRunOptions, IRunPropertiesChangeOptions, IRunPropertiesOptions, IRunStylePropertiesOptions, ISectionOptions, ISectionPropertiesChangeOptions, ISectionPropertiesOptions, ISectionPropertiesOptionsBase, IShadingAttributesProperties, ISpacingProperties, IStylesOptions, ISymbolRunOptions, ITableBordersOptions, ITableCellBorders, ITableCellOptions, ITableFloatOptions, ITableLookOptions, ITableOfContentsOptions, ITableOptions, ITablePropertiesChangeOptions, ITablePropertiesOptions, ITablePropertiesOptionsBase, ITableRowOptions, ITableRowPropertiesChangeOptions, ITableRowPropertiesOptions, ITableRowPropertiesOptionsBase, ITableWidthProperties, ITextWrapping, IVerticalPositionOptions, IWpgGroupOptions, IWpsShapeOptions, IXYFrameOptions, IXmlAttribute, IXmlableObject, IgnoreIfEmptyXmlComponent, ImageRun, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, InputDataType, InsertedTableCell, InsertedTableRow, InsertedTextRun, InternalHyperlink, LastRenderedPageBreak, LeaderType, Level, LevelBase, LevelForOverride, LevelFormat, LevelOverride, LevelSuffix, LineNumberRestartFormat, LineRuleType, Math, MathAngledBrackets, MathComponent, 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, OutputByType, OutputType, OverlapType, Packer, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageBorders, PageBreak, PageBreakBefore, PageNumber, PageNumberElement, PageNumberSeparator, PageOrientation, PageReference, PageTextDirection, PageTextDirectionType, Paragraph, ParagraphChild, ParagraphProperties, ParagraphPropertiesChange, ParagraphPropertiesDefaults, ParagraphRunProperties, PatchDocumentOptions, PatchDocumentOutputType, PatchType, Percentage, PositionalTab, PositionalTabAlignment, PositionalTabLeader, PositionalTabOptions, PositionalTabRelativeTo, PositivePercentage, PositiveUniversalMeasure, PrettifyType, RelativeHorizontalPosition, RelativeMeasure, RelativeVerticalPosition, Run, RunProperties, RunPropertiesChange, RunPropertiesDefaults, SectionProperties, SectionPropertiesChange, SectionType, SectionVerticalAlign, Separator, SequentialIdentifier, ShadingType, SimpleField, SimpleMailMergeField, SoftHyphen, SpaceType, StringContainer, StringEnumValueElement, StringValueElement, StyleForCharacter, StyleForParagraph, StyleLevel, Styles, SymbolRun, TDirection, Tab, TabStopDefinition, TabStopPosition, TabStopType, Table, TableAnchorType, TableBorders, TableCell, TableCellBorders, TableLayoutType, TableOfContents, TableProperties, TableRow, TableRowProperties, TableRowPropertiesChange, TableVerticalAlign, TextDirection, TextEffect, TextRun, TextWrappingSide, TextWrappingType, Textbox, ThematicBreak, UnderlineType, UniqueNumericIdCreator, UniversalMeasure, VerticalAlign, VerticalAlignSection, VerticalAlignTable, VerticalAnchor, VerticalMerge, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WORKAROUND2, WORKAROUND3, WORKAROUND4, WidthType, WpgCommonMediaData, WpgGroupRun, WpgMediaData, WpsMediaData, WpsShapeRun, XmlAttributeComponent, XmlComponent, YearLong, YearShort, abstractNumUniqueNumericIdGen, bookmarkUniqueNumericIdGen, concreteNumUniqueNumericIdGen, convertInchesToTwip, convertMillimetersToTwip, convertOutput, 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, encodeUtf8, hashedId, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, patchDetector, patchDocument, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, sectionMarginDefaults, sectionPageSizeDefaults, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, standardizeData, twipsMeasureValue, uCharHexNumber, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber };
+export { AbstractNumbering, AlignmentType, AnnotationReference, AttributeData, AttributeMap, AttributePayload, 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, DocumentAttributeNamespace, 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, IAlignmentFrameOptions, IBaseCharacterStyleOptions, IBaseParagraphStyleOptions, IBodyPropertiesOptions, IBookmarkOptions, IBorderOptions, IBordersOptions, ICellMergeAttributes, ICharacterStyleOptions, ICheckboxSymbolOptions, ICheckboxSymbolProperties, IColumnAttributes, IColumnsAttributes, ICommentOptions, ICommentsOptions, IConcreteNumberingOptions, IContext, IDistance, IDocGridAttributesProperties, IDocumentAttributesProperties, IDocumentBackgroundOptions, IDocumentDefaultsOptions, IDocumentFooter, IDocumentHeader, IDocumentOptions, IDrawingOptions, IExtendedMediaData, IExternalHyperlinkOptions, IFloating, IFontAttributesProperties, IFrameOptions, IGroupChildMediaData, IHeaderFooterGroup, IHeaderFooterOptions, IHeaderOptions, IHorizontalPositionOptions, IImageOptions, IIndentAttributesProperties, IInternalHyperlinkOptions, ILevelParagraphStylePropertiesOptions, ILevelsOptions, ILineNumberAttributes, IMargins, IMathFractionOptions, IMathFunctionOptions, IMathIntegralOptions, IMathLimitLowerOptions, IMathLimitUpperOptions, IMathOptions, IMathPreSubSuperScriptOptions, IMathRadicalOptions, IMathSubScriptOptions, IMathSubSuperScriptOptions, IMathSumOptions, IMathSuperScriptOptions, IMediaData, IMediaDataTransformation, IMediaTransformation, INumberedItemReferenceOptions, INumberingOptions, IPageBorderAttributes, IPageBordersOptions, IPageMarginAttributes, IPageNumberTypeAttributes, IPageReferenceOptions, IPageSizeAttributes, IParagraphOptions, IParagraphPropertiesChangeOptions, IParagraphPropertiesOptions, IParagraphPropertiesOptionsBase, IParagraphRunOptions, IParagraphRunPropertiesOptions, IParagraphStyleOptions, IParagraphStylePropertiesOptions, IPatch, type IPropertiesOptions, IRunOptions, IRunPropertiesChangeOptions, IRunPropertiesOptions, IRunStylePropertiesOptions, ISectionOptions, ISectionPropertiesChangeOptions, ISectionPropertiesOptions, ISectionPropertiesOptionsBase, IShadingAttributesProperties, ISpacingProperties, IStylesOptions, ISymbolRunOptions, ITableBordersOptions, ITableCellBorders, ITableCellOptions, ITableFloatOptions, ITableLookOptions, ITableOfContentsOptions, ITableOptions, ITablePropertiesChangeOptions, ITablePropertiesOptions, ITablePropertiesOptionsBase, ITableRowOptions, ITableRowPropertiesChangeOptions, ITableRowPropertiesOptions, ITableRowPropertiesOptionsBase, ITableWidthProperties, ITextWrapping, IVerticalPositionOptions, IWpgGroupOptions, IWpsShapeOptions, IXYFrameOptions, IXmlAttribute, IXmlableObject, IgnoreIfEmptyXmlComponent, ImageRun, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, InputDataType, InsertedTableCell, InsertedTableRow, InsertedTextRun, InternalHyperlink, LastRenderedPageBreak, LeaderType, Level, LevelBase, LevelForOverride, LevelFormat, LevelOverride, LevelSuffix, LineNumberRestartFormat, LineRuleType, Math, MathAngledBrackets, MathComponent, 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, OutputByType, OutputType, OverlapType, Packer, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageBorders, PageBreak, PageBreakBefore, PageNumber, PageNumberElement, PageNumberSeparator, PageOrientation, PageReference, PageTextDirection, PageTextDirectionType, Paragraph, ParagraphChild, ParagraphProperties, ParagraphPropertiesChange, ParagraphPropertiesDefaults, ParagraphRunProperties, PatchDocumentOptions, PatchDocumentOutputType, PatchType, Percentage, PositionalTab, PositionalTabAlignment, PositionalTabLeader, PositionalTabOptions, PositionalTabRelativeTo, PositivePercentage, PositiveUniversalMeasure, PrettifyType, RelativeHorizontalPosition, RelativeMeasure, RelativeVerticalPosition, Run, RunProperties, RunPropertiesChange, RunPropertiesDefaults, SectionProperties, SectionPropertiesChange, SectionType, SectionVerticalAlign, Separator, SequentialIdentifier, ShadingType, SimpleField, SimpleMailMergeField, SoftHyphen, SpaceType, StringContainer, StringEnumValueElement, StringValueElement, StyleForCharacter, StyleForParagraph, StyleLevel, Styles, SymbolRun, TDirection, Tab, TabStopDefinition, TabStopPosition, TabStopType, Table, TableAnchorType, TableBorders, TableCell, TableCellBorders, TableLayoutType, TableOfContents, TableProperties, TableRow, TableRowProperties, TableRowPropertiesChange, TableVerticalAlign, TextDirection, TextEffect, TextRun, TextWrappingSide, TextWrappingType, Textbox, ThematicBreak, UnderlineType, UniqueNumericIdCreator, UniversalMeasure, VerticalAlign, VerticalAlignSection, VerticalAlignTable, VerticalAnchor, VerticalMerge, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WORKAROUND2, WORKAROUND3, WORKAROUND4, WidthType, WpgCommonMediaData, WpgGroupRun, WpgMediaData, WpsMediaData, WpsShapeRun, XmlAttributeComponent, XmlComponent, YearLong, YearShort, abstractNumUniqueNumericIdGen, bookmarkUniqueNumericIdGen, concreteNumUniqueNumericIdGen, convertInchesToTwip, convertMillimetersToTwip, convertOutput, 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, encodeUtf8, hashedId, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, patchDetector, patchDocument, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, sectionMarginDefaults, sectionPageSizeDefaults, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, twipsMeasureValue, uCharHexNumber, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber };

package/dist/index.iife.js

@@ -1,4 +1,4 @@
-var docxPlus = (function(exports, xml_js, hash_js, nanoid_non_secure, fflate, undio, xml) {
+var docxPlus = (function(exports, xml_js, hash_js, nanoid_non_secure, undio, stream, fflate, xml) {
 	Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 	//#region \0rolldown/runtime.js
 	var __create = Object.create;
@@ -5771,29 +5771,20 @@ var docxPlus = (function(exports, xml_js, hash_js, nanoid_non_secure, fflate, un
 	};
 	//#endregion
 	//#region src/file/paragraph/run/image-run.ts
-	const convertDataURIToBinary = (dataURI) => {
-		const base64Index = dataURI.indexOf(";base64,");
-		const base64IndexWithOffset = base64Index === -1 ? 0 : base64Index + 8;
-		const binaryString = atob(dataURI.substring(base64IndexWithOffset));
-		const bytes = new Uint8Array(binaryString.length);
-		for (let i = 0; i < binaryString.length; i++) bytes[i] = binaryString.charCodeAt(i);
-		return bytes;
-	};
-	const standardizeData = (data) => typeof data === "string" ? convertDataURIToBinary(data) : data;
-	const createImageData = (options, key) => ({
-		data: standardizeData(options.data),
+	const createImageData = (data, transformation, key) => ({
+		data,
 		fileName: key,
 		transformation: {
 			emus: {
-				x: Math.round(options.transformation.width * 9525),
-				y: Math.round(options.transformation.height * 9525)
+				x: Math.round(transformation.width * 9525),
+				y: Math.round(transformation.height * 9525)
 			},
-			flip: options.transformation.flip,
+			flip: transformation.flip,
 			pixels: {
-				x: Math.round(options.transformation.width),
-				y: Math.round(options.transformation.height)
+				x: Math.round(transformation.width),
+				y: Math.round(transformation.height)
 			},
-			rotation: options.transformation.rotation ? options.transformation.rotation * 6e4 : void 0
+			rotation: transformation.rotation ? transformation.rotation * 6e4 : void 0
 		}
 	});
 	/**
@@ -5822,8 +5813,12 @@ var docxPlus = (function(exports, xml_js, hash_js, nanoid_non_secure, fflate, un
 		constructor(options) {
 			super({});
 			_defineProperty(this, "imageData", void 0);
-			const key = `${hashedId(options.data)}.${options.type}`;
-			this.imageData = options.type === "svg" ? _objectSpread2(_objectSpread2({ type: options.type }, createImageData(options, key)), {}, { fallback: _objectSpread2({ type: options.fallback.type }, createImageData(_objectSpread2(_objectSpread2({}, options.fallback), {}, { transformation: options.transformation }), `${hashedId(options.fallback.data)}.${options.fallback.type}`)) }) : _objectSpread2({ type: options.type }, createImageData(options, key));
+			const rawData = (0, undio.toUint8Array)(options.data);
+			const key = `${hashedId(rawData)}.${options.type}`;
+			if (options.type === "svg") {
+				const fallbackData = (0, undio.toUint8Array)(options.fallback.data);
+				this.imageData = _objectSpread2(_objectSpread2({ type: options.type }, createImageData(rawData, options.transformation, key)), {}, { fallback: _objectSpread2({ type: options.fallback.type }, createImageData(fallbackData, options.transformation, `${hashedId(fallbackData)}.${options.fallback.type}`)) });
+			} else this.imageData = _objectSpread2({ type: options.type }, createImageData(rawData, options.transformation, key));
 			const drawing = new Drawing(this.imageData, {
 				docProperties: options.altText,
 				floating: options.floating,
@@ -18286,6 +18281,14 @@ var docxPlus = (function(exports, xml_js, hash_js, nanoid_non_secure, fflate, un
 	//#endregion
 	//#region src/util/output-type.ts
 	/**
+	* Output type definitions for document generation.
+	*
+	* This module defines the various output formats supported when generating
+	* .docx files. These types correspond to fflate's output formats.
+	*
+	* @module
+	*/
+	/**
 	* Converts a Uint8Array to the specified output type.
 	*
 	* This is used by both the Packer and patchDocument to convert fflate's
@@ -18297,10 +18300,10 @@ var docxPlus = (function(exports, xml_js, hash_js, nanoid_non_secure, fflate, un
 			case "blob": return new Blob([data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength)], { type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" });
 			case "arraybuffer": return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
 			case "uint8array": return data;
-			case "base64": return Buffer.from(data).toString("base64");
+			case "base64": return btoa((0, fflate.strFromU8)(data, true));
 			case "string":
-			case "text": return Buffer.from(data).toString("binary");
-			case "binarystring": return Buffer.from(data).toString("binary");
+			case "text":
+			case "binarystring": return (0, fflate.strFromU8)(data, true);
 			case "array": return [...data];
 			default: return data;
 		}
@@ -19014,6 +19017,50 @@ var docxPlus = (function(exports, xml_js, hash_js, nanoid_non_secure, fflate, un
 		static toArrayBuffer(file, prettify, overrides = []) {
 			return Packer.pack(file, "arraybuffer", prettify, overrides);
 		}
+		/**
+		* Exports a document to a Node.js Readable stream.
+		*
+		* Uses fflate's streaming Zip API to emit compressed chunks incrementally,
+		* avoiding buffering the entire archive in memory before the first byte
+		* is available to the consumer.
+		*
+		* @param file - The document to export
+		* @param prettify - Whether to prettify the XML output
+		* @param overrides - Optional array of file overrides
+		* @returns A readable stream containing the compressed .docx data
+		*
+		* @example
+		* ```typescript
+		* import { createWriteStream } from "fs";
+		* Packer.toStream(doc).pipe(createWriteStream("output.docx"));
+		* ```
+		*/
+		static toStream(file, prettify, overrides = []) {
+			const stream$1 = new stream.Readable({ read() {} });
+			try {
+				const files = this.compiler.compile(file, convertPrettifyType(prettify), overrides);
+				const zip = new fflate.Zip((err, chunk, final) => {
+					if (err) {
+						stream$1.destroy(err);
+						return;
+					}
+					if (!stream$1.destroyed) stream$1.push(chunk);
+					if (final) stream$1.push(null);
+				});
+				for (const [name, data] of Object.entries(files)) {
+					var _level;
+					const raw = Array.isArray(data) ? data[0] : data;
+					const level = Array.isArray(data) ? (_level = data[1].level) !== null && _level !== void 0 ? _level : 6 : 6;
+					const entry = level === 0 ? new fflate.ZipPassThrough(name) : new fflate.ZipDeflate(name, { level });
+					zip.add(entry);
+					entry.push(raw, true);
+				}
+				zip.end();
+			} catch (err) {
+				stream$1.destroy(err instanceof Error ? err : new Error(String(err)));
+			}
+			return stream$1;
+		}
 	};
 	_defineProperty(Packer, "compiler", new Compiler());
 	//#endregion
@@ -20129,7 +20176,6 @@ var docxPlus = (function(exports, xml_js, hash_js, nanoid_non_secure, fflate, un
 	exports.shortHexNumber = shortHexNumber;
 	exports.signedHpsMeasureValue = signedHpsMeasureValue;
 	exports.signedTwipsMeasureValue = signedTwipsMeasureValue;
-	exports.standardizeData = standardizeData;
 	exports.twipsMeasureValue = twipsMeasureValue;
 	exports.uCharHexNumber = uCharHexNumber;
 	exports.uniqueId = uniqueId;
@@ -20138,4 +20184,4 @@ var docxPlus = (function(exports, xml_js, hash_js, nanoid_non_secure, fflate, un
 	exports.universalMeasureValue = universalMeasureValue;
 	exports.unsignedDecimalNumber = unsignedDecimalNumber;
 	return exports;
-})({}, xml_js, hash_js, nanoid_non_secure, fflate, undio, xml);
+})({}, xml_js, hash_js, nanoid_non_secure, undio, stream, fflate, xml);

package/dist/index.mjs

@@ -1,8 +1,9 @@
 import { js2xml, xml2js } from "xml-js";
 import hash from "hash.js";
 import { customAlphabet, nanoid } from "nanoid/non-secure";
-import { strFromU8, unzipSync, zipSync } from "fflate";
 import { textToUint8Array, toUint8Array } from "undio";
+import { Readable } from "stream";
+import { Zip, ZipDeflate, ZipPassThrough, strFromU8, unzipSync, zipSync } from "fflate";
 import xml from "xml";
 //#region \0@oxc-project+runtime@0.123.0/helpers/typeof.js
 function _typeof(o) {
@@ -5751,29 +5752,20 @@ var Drawing = class extends XmlComponent {
 };
 //#endregion
 //#region src/file/paragraph/run/image-run.ts
-const convertDataURIToBinary = (dataURI) => {
-	const base64Index = dataURI.indexOf(";base64,");
-	const base64IndexWithOffset = base64Index === -1 ? 0 : base64Index + 8;
-	const binaryString = atob(dataURI.substring(base64IndexWithOffset));
-	const bytes = new Uint8Array(binaryString.length);
-	for (let i = 0; i < binaryString.length; i++) bytes[i] = binaryString.charCodeAt(i);
-	return bytes;
-};
-const standardizeData = (data) => typeof data === "string" ? convertDataURIToBinary(data) : data;
-const createImageData = (options, key) => ({
-	data: standardizeData(options.data),
+const createImageData = (data, transformation, key) => ({
+	data,
 	fileName: key,
 	transformation: {
 		emus: {
-			x: Math.round(options.transformation.width * 9525),
-			y: Math.round(options.transformation.height * 9525)
+			x: Math.round(transformation.width * 9525),
+			y: Math.round(transformation.height * 9525)
 		},
-		flip: options.transformation.flip,
+		flip: transformation.flip,
 		pixels: {
-			x: Math.round(options.transformation.width),
-			y: Math.round(options.transformation.height)
+			x: Math.round(transformation.width),
+			y: Math.round(transformation.height)
 		},
-		rotation: options.transformation.rotation ? options.transformation.rotation * 6e4 : void 0
+		rotation: transformation.rotation ? transformation.rotation * 6e4 : void 0
 	}
 });
 /**
@@ -5802,8 +5794,12 @@ var ImageRun = class extends Run {
 	constructor(options) {
 		super({});
 		_defineProperty(this, "imageData", void 0);
-		const key = `${hashedId(options.data)}.${options.type}`;
-		this.imageData = options.type === "svg" ? _objectSpread2(_objectSpread2({ type: options.type }, createImageData(options, key)), {}, { fallback: _objectSpread2({ type: options.fallback.type }, createImageData(_objectSpread2(_objectSpread2({}, options.fallback), {}, { transformation: options.transformation }), `${hashedId(options.fallback.data)}.${options.fallback.type}`)) }) : _objectSpread2({ type: options.type }, createImageData(options, key));
+		const rawData = toUint8Array(options.data);
+		const key = `${hashedId(rawData)}.${options.type}`;
+		if (options.type === "svg") {
+			const fallbackData = toUint8Array(options.fallback.data);
+			this.imageData = _objectSpread2(_objectSpread2({ type: options.type }, createImageData(rawData, options.transformation, key)), {}, { fallback: _objectSpread2({ type: options.fallback.type }, createImageData(fallbackData, options.transformation, `${hashedId(fallbackData)}.${options.fallback.type}`)) });
+		} else this.imageData = _objectSpread2({ type: options.type }, createImageData(rawData, options.transformation, key));
 		const drawing = new Drawing(this.imageData, {
 			docProperties: options.altText,
 			floating: options.floating,
@@ -18266,6 +18262,14 @@ var Textbox = class extends FileChild {
 //#endregion
 //#region src/util/output-type.ts
 /**
+* Output type definitions for document generation.
+*
+* This module defines the various output formats supported when generating
+* .docx files. These types correspond to fflate's output formats.
+*
+* @module
+*/
+/**
 * Converts a Uint8Array to the specified output type.
 *
 * This is used by both the Packer and patchDocument to convert fflate's
@@ -18277,10 +18281,10 @@ const convertOutput = (data, type) => {
 		case "blob": return new Blob([data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength)], { type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" });
 		case "arraybuffer": return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
 		case "uint8array": return data;
-		case "base64": return Buffer.from(data).toString("base64");
+		case "base64": return btoa(strFromU8(data, true));
 		case "string":
-		case "text": return Buffer.from(data).toString("binary");
-		case "binarystring": return Buffer.from(data).toString("binary");
+		case "text":
+		case "binarystring": return strFromU8(data, true);
 		case "array": return [...data];
 		default: return data;
 	}
@@ -18994,6 +18998,50 @@ var Packer = class Packer {
 	static toArrayBuffer(file, prettify, overrides = []) {
 		return Packer.pack(file, "arraybuffer", prettify, overrides);
 	}
+	/**
+	* Exports a document to a Node.js Readable stream.
+	*
+	* Uses fflate's streaming Zip API to emit compressed chunks incrementally,
+	* avoiding buffering the entire archive in memory before the first byte
+	* is available to the consumer.
+	*
+	* @param file - The document to export
+	* @param prettify - Whether to prettify the XML output
+	* @param overrides - Optional array of file overrides
+	* @returns A readable stream containing the compressed .docx data
+	*
+	* @example
+	* ```typescript
+	* import { createWriteStream } from "fs";
+	* Packer.toStream(doc).pipe(createWriteStream("output.docx"));
+	* ```
+	*/
+	static toStream(file, prettify, overrides = []) {
+		const stream = new Readable({ read() {} });
+		try {
+			const files = this.compiler.compile(file, convertPrettifyType(prettify), overrides);
+			const zip = new Zip((err, chunk, final) => {
+				if (err) {
+					stream.destroy(err);
+					return;
+				}
+				if (!stream.destroyed) stream.push(chunk);
+				if (final) stream.push(null);
+			});
+			for (const [name, data] of Object.entries(files)) {
+				var _level;
+				const raw = Array.isArray(data) ? data[0] : data;
+				const level = Array.isArray(data) ? (_level = data[1].level) !== null && _level !== void 0 ? _level : 6 : 6;
+				const entry = level === 0 ? new ZipPassThrough(name) : new ZipDeflate(name, { level });
+				zip.add(entry);
+				entry.push(raw, true);
+			}
+			zip.end();
+		} catch (err) {
+			stream.destroy(err instanceof Error ? err : new Error(String(err)));
+		}
+		return stream;
+	}
 };
 _defineProperty(Packer, "compiler", new Compiler());
 //#endregion
@@ -19813,4 +19861,4 @@ const findPatchKeys = (text) => {
 	return (_text$match = text.match(pattern)) !== 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, TextDirection, TextEffect, TextRun, TextWrappingSide, TextWrappingType, Textbox, ThematicBreak, 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, encodeUtf8, hashedId, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, patchDetector, patchDocument, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, sectionMarginDefaults, sectionPageSizeDefaults, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, standardizeData, 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, TextDirection, TextEffect, TextRun, TextWrappingSide, TextWrappingType, Textbox, ThematicBreak, 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, encodeUtf8, hashedId, hexColorValue, hpsMeasureValue, longHexNumber, measurementOrPercentValue, patchDetector, patchDocument, percentageValue, pointMeasureValue, positiveUniversalMeasureValue, sectionMarginDefaults, sectionPageSizeDefaults, shortHexNumber, signedHpsMeasureValue, signedTwipsMeasureValue, twipsMeasureValue, uCharHexNumber, uniqueId, uniqueNumericIdCreator, uniqueUuid, universalMeasureValue, unsignedDecimalNumber };

package/dist/index.umd.js

@@ -1,14 +1,15 @@
 (function(global, factory) {
-	typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("xml-js"), require("hash.js"), require("nanoid/non-secure"), require("fflate"), require("undio"), require("xml")) : typeof define === "function" && define.amd ? define([
+	typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("xml-js"), require("hash.js"), require("nanoid/non-secure"), require("undio"), require("stream"), require("fflate"), require("xml")) : typeof define === "function" && define.amd ? define([
 		"exports",
 		"xml-js",
 		"hash.js",
 		"nanoid/non-secure",
-		"fflate",
 		"undio",
+		"stream",
+		"fflate",
 		"xml"
-	], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global.docxPlus = {}, global.xml_js, global.hash_js, global.nanoid_non_secure, global.fflate, global.undio, global.xml));
-})(this, function(exports, xml_js, hash_js, nanoid_non_secure, fflate, undio, xml) {
+	], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global.docxPlus = {}, global.xml_js, global.hash_js, global.nanoid_non_secure, global.undio, global.stream, global.fflate, global.xml));
+})(this, function(exports, xml_js, hash_js, nanoid_non_secure, undio, stream, fflate, xml) {
 	Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 	//#region \0rolldown/runtime.js
 	var __create = Object.create;
@@ -5781,29 +5782,20 @@
 	};
 	//#endregion
 	//#region src/file/paragraph/run/image-run.ts
-	const convertDataURIToBinary = (dataURI) => {
-		const base64Index = dataURI.indexOf(";base64,");
-		const base64IndexWithOffset = base64Index === -1 ? 0 : base64Index + 8;
-		const binaryString = atob(dataURI.substring(base64IndexWithOffset));
-		const bytes = new Uint8Array(binaryString.length);
-		for (let i = 0; i < binaryString.length; i++) bytes[i] = binaryString.charCodeAt(i);
-		return bytes;
-	};
-	const standardizeData = (data) => typeof data === "string" ? convertDataURIToBinary(data) : data;
-	const createImageData = (options, key) => ({
-		data: standardizeData(options.data),
+	const createImageData = (data, transformation, key) => ({
+		data,
 		fileName: key,
 		transformation: {
 			emus: {
-				x: Math.round(options.transformation.width * 9525),
-				y: Math.round(options.transformation.height * 9525)
+				x: Math.round(transformation.width * 9525),
+				y: Math.round(transformation.height * 9525)
 			},
-			flip: options.transformation.flip,
+			flip: transformation.flip,
 			pixels: {
-				x: Math.round(options.transformation.width),
-				y: Math.round(options.transformation.height)
+				x: Math.round(transformation.width),
+				y: Math.round(transformation.height)
 			},
-			rotation: options.transformation.rotation ? options.transformation.rotation * 6e4 : void 0
+			rotation: transformation.rotation ? transformation.rotation * 6e4 : void 0
 		}
 	});
 	/**
@@ -5832,8 +5824,12 @@
 		constructor(options) {
 			super({});
 			_defineProperty(this, "imageData", void 0);
-			const key = `${hashedId(options.data)}.${options.type}`;
-			this.imageData = options.type === "svg" ? _objectSpread2(_objectSpread2({ type: options.type }, createImageData(options, key)), {}, { fallback: _objectSpread2({ type: options.fallback.type }, createImageData(_objectSpread2(_objectSpread2({}, options.fallback), {}, { transformation: options.transformation }), `${hashedId(options.fallback.data)}.${options.fallback.type}`)) }) : _objectSpread2({ type: options.type }, createImageData(options, key));
+			const rawData = (0, undio.toUint8Array)(options.data);
+			const key = `${hashedId(rawData)}.${options.type}`;
+			if (options.type === "svg") {
+				const fallbackData = (0, undio.toUint8Array)(options.fallback.data);
+				this.imageData = _objectSpread2(_objectSpread2({ type: options.type }, createImageData(rawData, options.transformation, key)), {}, { fallback: _objectSpread2({ type: options.fallback.type }, createImageData(fallbackData, options.transformation, `${hashedId(fallbackData)}.${options.fallback.type}`)) });
+			} else this.imageData = _objectSpread2({ type: options.type }, createImageData(rawData, options.transformation, key));
 			const drawing = new Drawing(this.imageData, {
 				docProperties: options.altText,
 				floating: options.floating,
@@ -18296,6 +18292,14 @@
 	//#endregion
 	//#region src/util/output-type.ts
 	/**
+	* Output type definitions for document generation.
+	*
+	* This module defines the various output formats supported when generating
+	* .docx files. These types correspond to fflate's output formats.
+	*
+	* @module
+	*/
+	/**
 	* Converts a Uint8Array to the specified output type.
 	*
 	* This is used by both the Packer and patchDocument to convert fflate's
@@ -18307,10 +18311,10 @@
 			case "blob": return new Blob([data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength)], { type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" });
 			case "arraybuffer": return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
 			case "uint8array": return data;
-			case "base64": return Buffer.from(data).toString("base64");
+			case "base64": return btoa((0, fflate.strFromU8)(data, true));
 			case "string":
-			case "text": return Buffer.from(data).toString("binary");
-			case "binarystring": return Buffer.from(data).toString("binary");
+			case "text":
+			case "binarystring": return (0, fflate.strFromU8)(data, true);
 			case "array": return [...data];
 			default: return data;
 		}
@@ -19024,6 +19028,50 @@
 		static toArrayBuffer(file, prettify, overrides = []) {
 			return Packer.pack(file, "arraybuffer", prettify, overrides);
 		}
+		/**
+		* Exports a document to a Node.js Readable stream.
+		*
+		* Uses fflate's streaming Zip API to emit compressed chunks incrementally,
+		* avoiding buffering the entire archive in memory before the first byte
+		* is available to the consumer.
+		*
+		* @param file - The document to export
+		* @param prettify - Whether to prettify the XML output
+		* @param overrides - Optional array of file overrides
+		* @returns A readable stream containing the compressed .docx data
+		*
+		* @example
+		* ```typescript
+		* import { createWriteStream } from "fs";
+		* Packer.toStream(doc).pipe(createWriteStream("output.docx"));
+		* ```
+		*/
+		static toStream(file, prettify, overrides = []) {
+			const stream$1 = new stream.Readable({ read() {} });
+			try {
+				const files = this.compiler.compile(file, convertPrettifyType(prettify), overrides);
+				const zip = new fflate.Zip((err, chunk, final) => {
+					if (err) {
+						stream$1.destroy(err);
+						return;
+					}
+					if (!stream$1.destroyed) stream$1.push(chunk);
+					if (final) stream$1.push(null);
+				});
+				for (const [name, data] of Object.entries(files)) {
+					var _level;
+					const raw = Array.isArray(data) ? data[0] : data;
+					const level = Array.isArray(data) ? (_level = data[1].level) !== null && _level !== void 0 ? _level : 6 : 6;
+					const entry = level === 0 ? new fflate.ZipPassThrough(name) : new fflate.ZipDeflate(name, { level });
+					zip.add(entry);
+					entry.push(raw, true);
+				}
+				zip.end();
+			} catch (err) {
+				stream$1.destroy(err instanceof Error ? err : new Error(String(err)));
+			}
+			return stream$1;
+		}
 	};
 	_defineProperty(Packer, "compiler", new Compiler());
 	//#endregion
@@ -20139,7 +20187,6 @@
 	exports.shortHexNumber = shortHexNumber;
 	exports.signedHpsMeasureValue = signedHpsMeasureValue;
 	exports.signedTwipsMeasureValue = signedTwipsMeasureValue;
-	exports.standardizeData = standardizeData;
 	exports.twipsMeasureValue = twipsMeasureValue;
 	exports.uCharHexNumber = uCharHexNumber;
 	exports.uniqueId = uniqueId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docx-plus",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Easily generate .docx files with JS/TS with a nice declarative API. Works for Node and on the Browser.",
   "keywords": [
     "clippy",