docx 7.8.2 → 8.0.1

package/src/file/paragraph/run/image-run.ts

@@ -1,73 +0,0 @@
-import { uniqueId } from "@util/convenience-functions";
-
-import { IContext, IXmlableObject } from "@file/xml-components";
-import { DocPropertiesOptions } from "@file/drawing/doc-properties/doc-properties";
-
-import { Drawing, IFloating } from "../../drawing";
-import { IMediaTransformation } from "../../media";
-import { IMediaData } from "../../media/data";
-import { Run } from "../run";
-
-export interface IImageOptions {
-    readonly data: Buffer | string | Uint8Array | ArrayBuffer;
-    readonly transformation: IMediaTransformation;
-    readonly floating?: IFloating;
-    readonly altText?: DocPropertiesOptions;
-}
-
-export class ImageRun extends Run {
-    private readonly key = `${uniqueId()}.png`;
-    private readonly imageData: IMediaData;
-
-    public constructor(options: IImageOptions) {
-        super({});
-        const newData = typeof options.data === "string" ? this.convertDataURIToBinary(options.data) : options.data;
-
-        this.imageData = {
-            stream: newData,
-            fileName: this.key,
-            transformation: {
-                pixels: {
-                    x: Math.round(options.transformation.width),
-                    y: Math.round(options.transformation.height),
-                },
-                emus: {
-                    x: Math.round(options.transformation.width * 9525),
-                    y: Math.round(options.transformation.height * 9525),
-                },
-                flip: options.transformation.flip,
-                rotation: options.transformation.rotation ? options.transformation.rotation * 60000 : undefined,
-            },
-        };
-        const drawing = new Drawing(this.imageData, { floating: options.floating, docProperties: options.altText });
-
-        this.root.push(drawing);
-    }
-
-    public prepForXml(context: IContext): IXmlableObject | undefined {
-        context.file.Media.addImage(this.key, this.imageData);
-
-        return super.prepForXml(context);
-    }
-
-    private convertDataURIToBinary(dataURI: string): Uint8Array {
-        if (typeof atob === "function") {
-            // https://gist.github.com/borismus/1032746
-            // https://github.com/mafintosh/base64-to-uint8array
-            const BASE64_MARKER = ";base64,";
-            const base64Index = dataURI.indexOf(BASE64_MARKER);
-
-            const base64IndexWithOffset = base64Index === -1 ? 0 : base64Index + BASE64_MARKER.length;
-
-            return new Uint8Array(
-                atob(dataURI.substring(base64IndexWithOffset))
-                    .split("")
-                    .map((c) => c.charCodeAt(0)),
-            );
-        } else {
-            // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
-            const b = require("buf" + "fer");
-            return new b.Buffer(dataURI, "base64");
-        }
-    }
-}

package/src/file/paragraph/run/index.ts

@@ -1,12 +0,0 @@
-export * from "./run";
-export * from "./properties";
-export * from "./text-run";
-export * from "./symbol-run";
-export * from "./image-run";
-export * from "./run-fonts";
-export * from "./sequential-identifier";
-export * from "./underline";
-export * from "./emphasis-mark";
-export * from "./tab";
-export * from "./simple-field";
-export * from "./comment-run";

package/src/file/paragraph/run/page-number.spec.ts

@@ -1,32 +0,0 @@
-import { expect } from "chai";
-
-import { Formatter } from "@export/formatter";
-
-import { NumberOfPages, NumberOfPagesSection, Page } from "./page-number";
-
-describe("Page", () => {
-    describe("#constructor()", () => {
-        it("uses the font name for both ascii and hAnsi", () => {
-            const tree = new Formatter().format(new Page());
-            expect(tree).to.deep.equal({ "w:instrText": [{ _attr: { "xml:space": "preserve" } }, "PAGE"] });
-        });
-    });
-});
-
-describe("NumberOfPages", () => {
-    describe("#constructor()", () => {
-        it("uses the font name for both ascii and hAnsi", () => {
-            const tree = new Formatter().format(new NumberOfPages());
-            expect(tree).to.deep.equal({ "w:instrText": [{ _attr: { "xml:space": "preserve" } }, "NUMPAGES"] });
-        });
-    });
-});
-
-describe("NumberOfPagesSection", () => {
-    describe("#constructor()", () => {
-        it("uses the font name for both ascii and hAnsi", () => {
-            const tree = new Formatter().format(new NumberOfPagesSection());
-            expect(tree).to.deep.equal({ "w:instrText": [{ _attr: { "xml:space": "preserve" } }, "SECTIONPAGES"] });
-        });
-    });
-});

package/src/file/paragraph/run/page-number.ts

@@ -1,28 +0,0 @@
-import { SpaceType } from "@file/shared";
-import { XmlComponent } from "@file/xml-components";
-
-import { TextAttributes } from "./text-attributes";
-
-export class Page extends XmlComponent {
-    public constructor() {
-        super("w:instrText");
-        this.root.push(new TextAttributes({ space: SpaceType.PRESERVE }));
-        this.root.push("PAGE");
-    }
-}
-
-export class NumberOfPages extends XmlComponent {
-    public constructor() {
-        super("w:instrText");
-        this.root.push(new TextAttributes({ space: SpaceType.PRESERVE }));
-        this.root.push("NUMPAGES");
-    }
-}
-
-export class NumberOfPagesSection extends XmlComponent {
-    public constructor() {
-        super("w:instrText");
-        this.root.push(new TextAttributes({ space: SpaceType.PRESERVE }));
-        this.root.push("SECTIONPAGES");
-    }
-}

package/src/file/paragraph/run/properties.ts

@@ -1,262 +0,0 @@
-import { BorderElement, IBorderOptions } from "@file/border";
-import { IShadingAttributesProperties, Shading } from "@file/shading";
-import { ChangeAttributes, IChangedAttributesProperties } from "@file/track-revision/track-revision";
-import {
-    HpsMeasureElement,
-    IgnoreIfEmptyXmlComponent,
-    NumberValueElement,
-    OnOffElement,
-    StringValueElement,
-    XmlComponent,
-} from "@file/xml-components";
-
-import { EmphasisMark, EmphasisMarkType } from "./emphasis-mark";
-import { CharacterSpacing, Color, Highlight, HighlightComplexScript } from "./formatting";
-import { IFontAttributesProperties, RunFonts } from "./run-fonts";
-import { SubScript, SuperScript } from "./script";
-import { Underline, UnderlineType } from "./underline";
-
-interface IFontOptions {
-    readonly name: string;
-    readonly hint?: string;
-}
-
-export interface IRunStylePropertiesOptions {
-    readonly bold?: boolean;
-    readonly boldComplexScript?: boolean;
-    readonly italics?: boolean;
-    readonly italicsComplexScript?: boolean;
-    readonly underline?: {
-        readonly color?: string;
-        readonly type?: UnderlineType;
-    };
-    readonly emphasisMark?: {
-        readonly type?: EmphasisMarkType;
-    };
-    readonly color?: string;
-    readonly size?: number | string;
-    readonly sizeComplexScript?: boolean | number | string;
-    readonly rightToLeft?: boolean;
-    readonly smallCaps?: boolean;
-    readonly allCaps?: boolean;
-    readonly strike?: boolean;
-    readonly doubleStrike?: boolean;
-    readonly subScript?: boolean;
-    readonly superScript?: boolean;
-    readonly font?: string | IFontOptions | IFontAttributesProperties;
-    readonly highlight?: string;
-    readonly highlightComplexScript?: boolean | string;
-    readonly characterSpacing?: number;
-    readonly shading?: IShadingAttributesProperties;
-    readonly emboss?: boolean;
-    readonly imprint?: boolean;
-    readonly revision?: IRunPropertiesChangeOptions;
-    readonly border?: IBorderOptions;
-    readonly vanish?: boolean;
-    readonly specVanish?: boolean;
-    readonly scale?: number;
-}
-
-export interface IRunPropertiesOptions extends IRunStylePropertiesOptions {
-    readonly style?: string;
-}
-
-export interface IRunPropertiesChangeOptions extends IRunPropertiesOptions, IChangedAttributesProperties {}
-
-// <xsd:group name="EG_RPrBase">
-//     <xsd:choice>
-//     <xsd:element name="rStyle" type="CT_String"/>
-//     <xsd:element name="rFonts" type="CT_Fonts"/>
-//     <xsd:element name="b" type="CT_OnOff"/>
-//     <xsd:element name="bCs" type="CT_OnOff"/>
-//     <xsd:element name="i" type="CT_OnOff"/>
-//     <xsd:element name="iCs" type="CT_OnOff"/>
-//     <xsd:element name="caps" type="CT_OnOff"/>
-//     <xsd:element name="smallCaps" type="CT_OnOff"/>
-//     <xsd:element name="strike" type="CT_OnOff"/>
-//     <xsd:element name="dstrike" type="CT_OnOff"/>
-//     <xsd:element name="outline" type="CT_OnOff"/>
-//     <xsd:element name="shadow" type="CT_OnOff"/>
-//     <xsd:element name="emboss" type="CT_OnOff"/>
-//     <xsd:element name="imprint" type="CT_OnOff"/>
-//     <xsd:element name="noProof" type="CT_OnOff"/>
-//     <xsd:element name="snapToGrid" type="CT_OnOff"/>
-//     <xsd:element name="vanish" type="CT_OnOff"/>
-//     <xsd:element name="webHidden" type="CT_OnOff"/>
-//     <xsd:element name="color" type="CT_Color"/>
-//     <xsd:element name="spacing" type="CT_SignedTwipsMeasure"/>
-//     <xsd:element name="w" type="CT_TextScale"/>
-//     <xsd:element name="kern" type="CT_HpsMeasure"/>
-//     <xsd:element name="position" type="CT_SignedHpsMeasure"/>
-//     <xsd:element name="sz" type="CT_HpsMeasure"/>
-//     <xsd:element name="szCs" type="CT_HpsMeasure"/>
-//     <xsd:element name="highlight" type="CT_Highlight"/>
-//     <xsd:element name="u" type="CT_Underline"/>
-//     <xsd:element name="effect" type="CT_TextEffect"/>
-//     <xsd:element name="bdr" type="CT_Border"/>
-//     <xsd:element name="shd" type="CT_Shd"/>
-//     <xsd:element name="fitText" type="CT_FitText"/>
-//     <xsd:element name="vertAlign" type="CT_VerticalAlignRun"/>
-//     <xsd:element name="rtl" type="CT_OnOff"/>
-//     <xsd:element name="cs" type="CT_OnOff"/>
-//     <xsd:element name="em" type="CT_Em"/>
-//     <xsd:element name="lang" type="CT_Language"/>
-//     <xsd:element name="eastAsianLayout" type="CT_EastAsianLayout"/>
-//     <xsd:element name="specVanish" type="CT_OnOff"/>
-//     <xsd:element name="oMath" type="CT_OnOff"/>
-//     </xsd:choice>
-// </xsd:group>
-export class RunProperties extends IgnoreIfEmptyXmlComponent {
-    public constructor(options?: IRunPropertiesOptions) {
-        super("w:rPr");
-
-        if (!options) {
-            return;
-        }
-
-        if (options.bold !== undefined) {
-            this.push(new OnOffElement("w:b", options.bold));
-        }
-        if ((options.boldComplexScript === undefined && options.bold !== undefined) || options.boldComplexScript) {
-            this.push(new OnOffElement("w:bCs", options.boldComplexScript ?? options.bold));
-        }
-
-        if (options.italics !== undefined) {
-            this.push(new OnOffElement("w:i", options.italics));
-        }
-
-        if ((options.italicsComplexScript === undefined && options.italics !== undefined) || options.italicsComplexScript) {
-            this.push(new OnOffElement("w:iCs", options.italicsComplexScript ?? options.italics));
-        }
-
-        if (options.underline) {
-            this.push(new Underline(options.underline.type, options.underline.color));
-        }
-
-        if (options.emphasisMark) {
-            this.push(new EmphasisMark(options.emphasisMark.type));
-        }
-
-        if (options.color) {
-            this.push(new Color(options.color));
-        }
-
-        if (options.size !== undefined) {
-            this.push(new HpsMeasureElement("w:sz", options.size));
-        }
-        const szCs =
-            options.sizeComplexScript === undefined || options.sizeComplexScript === true ? options.size : options.sizeComplexScript;
-        if (szCs) {
-            this.push(new HpsMeasureElement("w:szCs", szCs));
-        }
-
-        if (options.rightToLeft !== undefined) {
-            this.push(new OnOffElement("w:rtl", options.rightToLeft));
-        }
-
-        // These two are mutually exclusive
-        if (options.smallCaps !== undefined) {
-            this.push(new OnOffElement("w:smallCaps", options.smallCaps));
-        } else if (options.allCaps !== undefined) {
-            this.push(new OnOffElement("w:caps", options.allCaps));
-        }
-
-        if (options.strike !== undefined) {
-            this.push(new OnOffElement("w:strike", options.strike));
-        }
-
-        if (options.doubleStrike !== undefined) {
-            this.push(new OnOffElement("w:dstrike", options.doubleStrike));
-        }
-
-        if (options.subScript) {
-            this.push(new SubScript());
-        }
-
-        if (options.superScript) {
-            this.push(new SuperScript());
-        }
-
-        if (options.style) {
-            this.push(new StringValueElement("w:rStyle", options.style));
-        }
-
-        if (options.font) {
-            if (typeof options.font === "string") {
-                this.push(new RunFonts(options.font));
-            } else if ("name" in options.font) {
-                this.push(new RunFonts(options.font.name, options.font.hint));
-            } else {
-                this.push(new RunFonts(options.font));
-            }
-        }
-
-        if (options.highlight) {
-            this.push(new Highlight(options.highlight));
-        }
-        const highlightCs =
-            options.highlightComplexScript === undefined || options.highlightComplexScript === true
-                ? options.highlight
-                : options.highlightComplexScript;
-        if (highlightCs) {
-            this.push(new HighlightComplexScript(highlightCs));
-        }
-
-        if (options.characterSpacing) {
-            this.push(new CharacterSpacing(options.characterSpacing));
-        }
-
-        if (options.emboss !== undefined) {
-            this.push(new OnOffElement("w:emboss", options.emboss));
-        }
-
-        if (options.imprint !== undefined) {
-            this.push(new OnOffElement("w:imprint", options.imprint));
-        }
-
-        if (options.shading) {
-            this.push(new Shading(options.shading));
-        }
-
-        if (options.revision) {
-            this.push(new RunPropertiesChange(options.revision));
-        }
-
-        if (options.border) {
-            this.push(new BorderElement("w:bdr", options.border));
-        }
-
-        if (options.vanish) {
-            // https://c-rex.net/projects/samples/ooxml/e1/Part4/OOXML_P4_DOCX_vanish_topic_ID0E6W3O.html
-            // http://www.datypic.com/sc/ooxml/e-w_vanish-1.html
-            this.push(new OnOffElement("w:vanish", options.vanish));
-        }
-
-        if (options.specVanish) {
-            // https://c-rex.net/projects/samples/ooxml/e1/Part4/OOXML_P4_DOCX_specVanish_topic_ID0EIE1O.html
-            this.push(new OnOffElement("w:specVanish", options.vanish));
-        }
-
-        if (options.scale !== undefined) {
-            this.push(new NumberValueElement("w:w", options.scale));
-        }
-    }
-
-    public push(item: XmlComponent): void {
-        this.root.push(item);
-    }
-}
-
-export class RunPropertiesChange extends XmlComponent {
-    public constructor(options: IRunPropertiesChangeOptions) {
-        super("w:rPrChange");
-        this.root.push(
-            new ChangeAttributes({
-                id: options.id,
-                author: options.author,
-                date: options.date,
-            }),
-        );
-        this.addChildElement(new RunProperties(options as IRunPropertiesOptions));
-    }
-}

package/src/file/paragraph/run/run-components/symbol.spec.ts

@@ -1,28 +0,0 @@
-import { expect } from "chai";
-
-import { Formatter } from "@export/formatter";
-
-import { Symbol } from "./symbol";
-
-describe("Symbol", () => {
-    describe("#constructor", () => {
-        // Note: if no character is given, the output is a MS Windows logo
-        it("creates an empty symbol run if no character is given", () => {
-            const s = new Symbol();
-            const f = new Formatter().format(s);
-            expect(f).to.deep.equal({ "w:sym": { _attr: { "w:char": "", "w:font": "Wingdings" } } });
-        });
-
-        it("creates the provided symbol with default font", () => {
-            const s = new Symbol("F071");
-            const f = new Formatter().format(s);
-            expect(f).to.deep.equal({ "w:sym": { _attr: { "w:char": "F071", "w:font": "Wingdings" } } });
-        });
-
-        it("creates the provided symbol with the provided font", () => {
-            const s = new Symbol("F071", "Arial");
-            const f = new Formatter().format(s);
-            expect(f).to.deep.equal({ "w:sym": { _attr: { "w:char": "F071", "w:font": "Arial" } } });
-        });
-    });
-});

package/src/file/paragraph/run/run-components/symbol.ts

@@ -1,18 +0,0 @@
-import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
-
-class SymbolAttributes extends XmlAttributeComponent<{
-    readonly char: string;
-    readonly symbolfont?: string;
-}> {
-    protected readonly xmlKeys = {
-        char: "w:char",
-        symbolfont: "w:font",
-    };
-}
-
-export class Symbol extends XmlComponent {
-    public constructor(char: string = "", symbolfont: string = "Wingdings") {
-        super("w:sym");
-        this.root.push(new SymbolAttributes({ char: char, symbolfont: symbolfont }));
-    }
-}

package/src/file/paragraph/run/run-components/text.spec.ts

@@ -1,39 +0,0 @@
-import { expect } from "chai";
-
-import { Formatter } from "@export/formatter";
-import { SpaceType } from "@file/shared";
-
-import { Text } from "./text";
-
-describe("Text", () => {
-    describe("#constructor", () => {
-        it("adds the passed in text to the component", () => {
-            const t = new Text(" this is\n text");
-            const f = new Formatter().format(t);
-            expect(f).to.deep.equal({
-                "w:t": [{ _attr: { "xml:space": "preserve" } }, " this is\n text"],
-            });
-        });
-
-        it("adds the passed in text to the component with options", () => {
-            const t = new Text({
-                text: " this is\n text",
-                space: SpaceType.PRESERVE,
-            });
-            const f = new Formatter().format(t);
-            expect(f).to.deep.equal({
-                "w:t": [{ _attr: { "xml:space": "preserve" } }, " this is\n text"],
-            });
-        });
-
-        it("adds the passed in text to the component with options and sets default space type", () => {
-            const t = new Text({
-                text: " this is\n text",
-            });
-            const f = new Formatter().format(t);
-            expect(f).to.deep.equal({
-                "w:t": [{ _attr: { "xml:space": "default" } }, " this is\n text"],
-            });
-        });
-    });
-});

package/src/file/paragraph/run/run-components/text.ts

@@ -1,33 +0,0 @@
-import { SpaceType } from "@file/shared";
-import { XmlComponent } from "@file/xml-components";
-
-import { TextAttributes } from "../text-attributes";
-
-// <xsd:complexType name="CT_Text">
-//     <xsd:simpleContent>
-//         <xsd:extension base="s:ST_String">
-//             <xsd:attribute ref="xml:space" use="optional" />
-//         </xsd:extension>
-//     </xsd:simpleContent>
-// </xsd:complexType>
-
-interface ITextOptions {
-    readonly space?: SpaceType;
-    readonly text?: string;
-}
-
-export class Text extends XmlComponent {
-    public constructor(options: string | ITextOptions) {
-        super("w:t");
-
-        if (typeof options === "string") {
-            this.root.push(new TextAttributes({ space: SpaceType.PRESERVE }));
-            this.root.push(options);
-            return this;
-        } else {
-            this.root.push(new TextAttributes({ space: options.space ?? SpaceType.DEFAULT }));
-            this.root.push(options.text);
-            return this;
-        }
-    }
-}

package/src/file/paragraph/run/run-fonts.spec.ts

@@ -1,32 +0,0 @@
-import { expect } from "chai";
-
-import { Formatter } from "@export/formatter";
-
-import { RunFonts } from "./run-fonts";
-
-describe("RunFonts", () => {
-    describe("#constructor()", () => {
-        it("uses the font name for both ascii and hAnsi", () => {
-            const tree = new Formatter().format(new RunFonts("Times"));
-            expect(tree).to.deep.equal({
-                "w:rFonts": { _attr: { "w:ascii": "Times", "w:cs": "Times", "w:eastAsia": "Times", "w:hAnsi": "Times" } },
-            });
-        });
-
-        it("uses hint if given", () => {
-            const tree = new Formatter().format(new RunFonts("Times", "default"));
-            expect(tree).to.deep.equal({
-                "w:rFonts": {
-                    _attr: { "w:ascii": "Times", "w:cs": "Times", "w:eastAsia": "Times", "w:hAnsi": "Times", "w:hint": "default" },
-                },
-            });
-        });
-
-        it("uses the font attrs for ascii and eastAsia", () => {
-            const tree = new Formatter().format(new RunFonts({ ascii: "Times", eastAsia: "KaiTi" }));
-            expect(tree).to.deep.equal({
-                "w:rFonts": { _attr: { "w:ascii": "Times", "w:eastAsia": "KaiTi" } },
-            });
-        });
-    });
-});

package/src/file/paragraph/run/run-fonts.ts

@@ -1,44 +0,0 @@
-import { XmlAttributeComponent, XmlComponent } from "@file/xml-components";
-
-export interface IFontAttributesProperties {
-    readonly ascii?: string;
-    readonly cs?: string;
-    readonly eastAsia?: string;
-    readonly hAnsi?: string;
-    readonly hint?: string;
-}
-
-class RunFontAttributes extends XmlAttributeComponent<IFontAttributesProperties> {
-    protected readonly xmlKeys = {
-        ascii: "w:ascii",
-        cs: "w:cs",
-        eastAsia: "w:eastAsia",
-        hAnsi: "w:hAnsi",
-        hint: "w:hint",
-    };
-}
-
-export class RunFonts extends XmlComponent {
-    public constructor(name: string, hint?: string);
-    public constructor(attrs: string | IFontAttributesProperties);
-    public constructor(nameOrAttrs: string | IFontAttributesProperties, hint?: string) {
-        super("w:rFonts");
-        if (typeof nameOrAttrs === "string") {
-            // use public constructor(name: string, hint?: string);
-            const name = nameOrAttrs;
-            this.root.push(
-                new RunFontAttributes({
-                    ascii: name,
-                    cs: name,
-                    eastAsia: name,
-                    hAnsi: name,
-                    hint: hint,
-                }),
-            );
-        } else {
-            // use public constructor(attrs: IRunFontAttributesProperties);
-            const attrs = nameOrAttrs;
-            this.root.push(new RunFontAttributes(attrs));
-        }
-    }
-}