@syncfusion/ej2-docx 0.0.0-stage → 35.1.40

package/src/features/tables/paddings.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Table / cell padding facade over `TableCellMargins` (points).
+ *
+ * Wire units remain DXA twips via tbl-pr / tc-pr serializers.
+ *
+ * @public
+ */
+import { TableCellMargins } from './tbl-pr';
+/**
+ * Host that reads/writes a full cell-margins bag.
+ *
+ * @private
+ */
+export interface PaddingsHost {
+    read(): TableCellMargins | undefined;
+    write(value: TableCellMargins | undefined): void;
+}
+/**
+ * Four-sided padding values in points.
+ *
+ * @public
+ */
+export declare class Paddings {
+    private readonly host;
+    /**
+     * @private
+     */
+    constructor(host: PaddingsHost);
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+    /**
+     * Common value when all sides match; otherwise the top side.
+     */
+    /**
+    * Sets all four sides to the same point value.
+    */
+    all: number;
+    private writeSide;
+}

package/src/features/tables/paddings.js

@@ -0,0 +1,97 @@
+/**
+ * Four-sided padding values in points.
+ *
+ * @public
+ */
+var Paddings = /** @class */ (function () {
+    /**
+     * @private
+     */
+    function Paddings(host) {
+        this.host = host;
+    }
+    Object.defineProperty(Paddings.prototype, "left", {
+        get: function () {
+            var m = this.host.read();
+            return m !== undefined && m.left !== undefined ? m.left : 0;
+        },
+        set: function (value) {
+            this.writeSide('left', value);
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Object.defineProperty(Paddings.prototype, "right", {
+        get: function () {
+            var m = this.host.read();
+            return m !== undefined && m.right !== undefined ? m.right : 0;
+        },
+        set: function (value) {
+            this.writeSide('right', value);
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Object.defineProperty(Paddings.prototype, "top", {
+        get: function () {
+            var m = this.host.read();
+            return m !== undefined && m.top !== undefined ? m.top : 0;
+        },
+        set: function (value) {
+            this.writeSide('top', value);
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Object.defineProperty(Paddings.prototype, "bottom", {
+        get: function () {
+            var m = this.host.read();
+            return m !== undefined && m.bottom !== undefined ? m.bottom : 0;
+        },
+        set: function (value) {
+            this.writeSide('bottom', value);
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Object.defineProperty(Paddings.prototype, "all", {
+        /**
+         * Common value when all sides match; otherwise the top side.
+         */
+        get: function () {
+            var top = this.top;
+            if (this.bottom === top && this.left === top && this.right === top) {
+                return top;
+            }
+            return top;
+        },
+        /**
+         * Sets all four sides to the same point value.
+         */
+        set: function (value) {
+            this.host.write({
+                top: value,
+                bottom: value,
+                left: value,
+                right: value,
+            });
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Paddings.prototype.writeSide = function (side, value) {
+        var prev = this.host.read();
+        var top = side === 'top' ? value : (prev !== undefined ? prev.top : undefined);
+        var bottom = side === 'bottom' ? value : (prev !== undefined ? prev.bottom : undefined);
+        var left = side === 'left' ? value : (prev !== undefined ? prev.left : undefined);
+        var right = side === 'right' ? value : (prev !== undefined ? prev.right : undefined);
+        this.host.write({
+            top: top,
+            bottom: bottom,
+            left: left,
+            right: right,
+        });
+    };
+    return Paddings;
+}());
+export { Paddings };

package/src/features/tables/tbl-pr-positioning.d.ts

@@ -0,0 +1,27 @@
+import { OpenXmlElement, OpenXmlAttribute } from '../../core/xml/index';
+import { TableHorizontalOrigin, TableVerticalOrigin } from './format';
+/**
+ * Internal bag for floating table position (public units: points).
+ *
+ * @private
+ */
+export interface TablePositioningBag {
+    readonly horizontalPosition?: number;
+    readonly verticalPosition?: number;
+    readonly horizontalOrigin?: TableHorizontalOrigin;
+    readonly verticalOrigin?: TableVerticalOrigin;
+    readonly distanceFromTop?: number;
+    readonly distanceFromBottom?: number;
+    readonly distanceFromLeft?: number;
+    readonly distanceFromRight?: number;
+    /** Unmodeled attributes preserved on rewrite. */
+    readonly unknownAttributes?: ReadonlyArray<OpenXmlAttribute>;
+}
+/**
+ * @private
+ */
+export declare function readTablePositioning(tblPr: OpenXmlElement): TablePositioningBag | undefined;
+/**
+ * @private
+ */
+export declare function writeTablePositioning(tblPr: OpenXmlElement, bag: TablePositioningBag | undefined): OpenXmlElement;

package/src/features/tables/tbl-pr-positioning.js

@@ -0,0 +1,178 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __values = (this && this.__values) || function (o) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator], i = 0;
+    if (m) return m.call(o);
+    return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+};
+/**
+ * `w:tblpPr` read/write helpers for floating table position.
+ *
+ * Citations: ECMA-376 CT_TblPPr; Transitional wml.xsd.
+ *
+ * @private
+ */
+import { elementChildren, isWml, wmlAttr, wmlElement } from '../document/wml';
+import { emptyPropsToUndefined, parseDecimalVal, pointToTwips, twipsToPoint, upsertPropChild, wmlAttrVal, } from './tbl-pr';
+var KNOWN_ATTRS = {
+    leftFromText: true,
+    rightFromText: true,
+    topFromText: true,
+    bottomFromText: true,
+    vertAnchor: true,
+    horzAnchor: true,
+    tblpX: true,
+    tblpY: true,
+    tblpXSpec: true,
+    tblpYSpec: true,
+};
+function findWmlChild(parent, localName) {
+    var e_1, _a;
+    try {
+        for (var _b = __values(elementChildren(parent)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var child = _c.value;
+            if (isWml(child, localName)) {
+                return child;
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return undefined;
+}
+function parseHorzAnchor(raw) {
+    if (raw === 'margin') {
+        return 'margin';
+    }
+    if (raw === 'page') {
+        return 'page';
+    }
+    if (raw === 'column') {
+        return 'column';
+    }
+    return undefined;
+}
+function parseVertAnchor(raw) {
+    if (raw === 'margin') {
+        return 'margin';
+    }
+    if (raw === 'page') {
+        return 'page';
+    }
+    if (raw === 'paragraph') {
+        return 'paragraph';
+    }
+    return undefined;
+}
+function twipAttrPoints(el, localName) {
+    var raw = wmlAttrVal(el, localName);
+    var n = parseDecimalVal(raw);
+    return n !== undefined ? twipsToPoint(n) : undefined;
+}
+/**
+ * @private
+ */
+export function readTablePositioning(tblPr) {
+    var el = findWmlChild(tblPr, 'tblpPr');
+    if (el === undefined) {
+        return undefined;
+    }
+    var unknown = [];
+    for (var i = 0; i < el.attributes.length; i += 1) {
+        var a = el.attributes[i];
+        if (KNOWN_ATTRS[a.localName] !== true) {
+            unknown.push(a);
+        }
+    }
+    var bag = __assign({ horizontalPosition: twipAttrPoints(el, 'tblpX'), verticalPosition: twipAttrPoints(el, 'tblpY'), horizontalOrigin: parseHorzAnchor(wmlAttrVal(el, 'horzAnchor')), verticalOrigin: parseVertAnchor(wmlAttrVal(el, 'vertAnchor')), distanceFromTop: twipAttrPoints(el, 'topFromText'), distanceFromBottom: twipAttrPoints(el, 'bottomFromText'), distanceFromLeft: twipAttrPoints(el, 'leftFromText'), distanceFromRight: twipAttrPoints(el, 'rightFromText') }, (unknown.length > 0 ? { unknownAttributes: unknown } : {}));
+    return bag;
+}
+function pushTwip(attrs, localName, points) {
+    if (points === undefined) {
+        return;
+    }
+    attrs.push(wmlAttr(localName, String(pointToTwips(points))));
+}
+/**
+ * @private
+ */
+export function writeTablePositioning(tblPr, bag) {
+    if (bag === undefined) {
+        return upsertPropChild(tblPr, 'tblPr', 'tblpPr', undefined);
+    }
+    var existing = findWmlChild(tblPr, 'tblpPr');
+    var attrs = [];
+    pushTwip(attrs, 'leftFromText', bag.distanceFromLeft);
+    pushTwip(attrs, 'rightFromText', bag.distanceFromRight);
+    pushTwip(attrs, 'topFromText', bag.distanceFromTop);
+    pushTwip(attrs, 'bottomFromText', bag.distanceFromBottom);
+    if (bag.verticalOrigin !== undefined) {
+        attrs.push(wmlAttr('vertAnchor', bag.verticalOrigin));
+    }
+    if (bag.horizontalOrigin !== undefined) {
+        attrs.push(wmlAttr('horzAnchor', bag.horizontalOrigin));
+    }
+    pushTwip(attrs, 'tblpX', bag.horizontalPosition);
+    pushTwip(attrs, 'tblpY', bag.verticalPosition);
+    // Preserve unknown attributes from the existing element and bag.
+    var seen = {};
+    for (var i = 0; i < attrs.length; i += 1) {
+        seen[attrs[i].localName] = true;
+    }
+    var preserveFrom = bag.unknownAttributes !== undefined
+        ? bag.unknownAttributes
+        : existing !== undefined
+            ? existing.attributes
+            : [];
+    for (var i = 0; i < preserveFrom.length; i += 1) {
+        var a = preserveFrom[i];
+        if (KNOWN_ATTRS[a.localName] === true) {
+            continue;
+        }
+        if (seen[a.localName] === true) {
+            continue;
+        }
+        attrs.push(a);
+        seen[a.localName] = true;
+    }
+    // Also keep known attrs present on existing that we did not set (e.g. tblpXSpec).
+    if (existing !== undefined) {
+        for (var i = 0; i < existing.attributes.length; i += 1) {
+            var a = existing.attributes[i];
+            if (seen[a.localName] === true) {
+                continue;
+            }
+            // Only keep known alignment-spec style attrs we do not model yet.
+            if (a.localName === 'tblpXSpec' || a.localName === 'tblpYSpec') {
+                attrs.push(a);
+                seen[a.localName] = true;
+            }
+        }
+    }
+    var element = wmlElement('tblpPr', {
+        attributes: attrs,
+        namespaceDeclarations: existing !== undefined ? existing.namespaceDeclarations : undefined,
+        children: existing !== undefined ? elementChildren(existing) : undefined,
+    });
+    var next = upsertPropChild(tblPr, 'tblPr', 'tblpPr', element);
+    return emptyPropsToUndefined(next) !== undefined ? next : tblPr;
+}