@syncfusion/ej2-docx 0.0.0-stage → 35.1.39

package/src/features/drawing/encode-builders.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Author encode input builders for dual-AC DrawingML hosts.
+ *
+ * @private
+ */
+import { Emus } from '../document/length';
+import { OpenXmlElement } from '../../core/xml/index';
+import { HorizontalAlignment as HorizontalAlignmentType, HorizontalOrigin as HorizontalOriginType, TextWrappingStyle as TextWrappingStyleType, VerticalAlignment as VerticalAlignmentType, VerticalOrigin as VerticalOriginType } from '../images/layout-types';
+import { DrawingHostPlacement, EncodeGroupInput, encodeAuthoredDrawingShape } from './host-codec';
+import { LineCap, LineEndSize, LineEndType, LineDashing, ShapeFill, ShapeLine } from './sp-pr';
+import { DrawingEncoding } from './types';
+import { DrawingShape, DirtyMode, DrawingShapeInit } from './drawing-shape';
+/** Encode-input fill slice (author solid/none only). */
+declare type EncodeDrawingShapeFill = {
+    readonly kind: 'solid';
+    readonly srgb: string;
+    readonly alpha?: number | undefined;
+} | {
+    readonly kind: 'none';
+};
+/** Encode-input line slice (author solid/none only; matches host-codec). */
+declare type EncodeDrawingShapeLine = {
+    readonly kind: 'solid';
+    readonly widthEmu?: Emus | undefined;
+    readonly srgb: string;
+    readonly dash?: LineDashing | undefined;
+    readonly cap?: LineCap | undefined;
+    readonly beginArrowType?: LineEndType | undefined;
+    readonly beginArrowSize?: LineEndSize | undefined;
+    readonly endArrowType?: LineEndType | undefined;
+    readonly endArrowSize?: LineEndSize | undefined;
+} | {
+    readonly kind: 'none';
+    readonly widthEmu?: Emus | undefined;
+    readonly cap?: LineCap | undefined;
+};
+/**
+ * Build encode input without writing `undefined` into optional fields
+ * (`exactOptionalPropertyTypes`).
+ *
+ * TS 3.3: nested conditional object spreads explode the checker (OOM). Assign
+ * optional keys only when defined — same exactOptionalPropertyTypes semantics.
+ */
+export declare function encodeDrawingShapeInput(parts: {
+    readonly placement: DrawingHostPlacement;
+    readonly widthEmu: Emus;
+    readonly heightEmu: Emus;
+    readonly presetGeometry: string;
+    readonly docPrId: number;
+    readonly name: string;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly rotation?: number | undefined;
+    readonly flipHorizontal?: boolean | undefined;
+    readonly flipVertical?: boolean | undefined;
+    readonly lockAspectRatio?: boolean | undefined;
+    readonly wrapping?: TextWrappingStyleType | undefined;
+    readonly wrapType?: import('../images/layout-types').TextWrappingType | undefined;
+    readonly distanceTopEmu?: Emus | undefined;
+    readonly distanceBottomEmu?: Emus | undefined;
+    readonly distanceLeftEmu?: Emus | undefined;
+    readonly distanceRightEmu?: Emus | undefined;
+    readonly behindDocument?: boolean | undefined;
+    readonly horizontalOrigin?: HorizontalOriginType | undefined;
+    readonly verticalOrigin?: VerticalOriginType | undefined;
+    readonly horizontalPositionEmu?: Emus | undefined;
+    readonly verticalPositionEmu?: Emus | undefined;
+    readonly horizontalAlignment?: HorizontalAlignmentType | undefined;
+    readonly verticalAlignment?: VerticalAlignmentType | undefined;
+    readonly lockAnchor?: boolean | undefined;
+    readonly allowOverlap?: boolean | undefined;
+    readonly layoutInCell?: boolean | undefined;
+    readonly horizontalModeled?: boolean | undefined;
+    readonly verticalModeled?: boolean | undefined;
+    readonly preservedHost?: OpenXmlElement | undefined;
+    readonly layoutDirty?: boolean | undefined;
+    readonly txbxContent?: ReadonlyArray<OpenXmlElement> | undefined;
+    readonly bodyPr?: OpenXmlElement | undefined;
+    readonly fill?: EncodeDrawingShapeFill | undefined;
+    readonly line?: EncodeDrawingShapeLine | undefined;
+}): Parameters<typeof encodeAuthoredDrawingShape>[0];
+/**
+ * Build {@link EncodeGroupInput} without writing `undefined` into optional
+ * fields (`exactOptionalPropertyTypes`). Nested children are required (may be []).
+ *
+ * TS 3.3: nested conditional object spreads explode the checker (OOM).
+ */
+export declare function encodeGroupInput(parts: {
+    readonly placement: DrawingHostPlacement;
+    readonly widthEmu: Emus;
+    readonly heightEmu: Emus;
+    readonly docPrId: number;
+    readonly name: string;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly rotation?: number | undefined;
+    readonly flipHorizontal?: boolean | undefined;
+    readonly flipVertical?: boolean | undefined;
+    readonly lockAspectRatio?: boolean | undefined;
+    readonly wrapping?: TextWrappingStyleType | undefined;
+    readonly distanceTopEmu?: Emus | undefined;
+    readonly distanceBottomEmu?: Emus | undefined;
+    readonly distanceLeftEmu?: Emus | undefined;
+    readonly distanceRightEmu?: Emus | undefined;
+    readonly behindDocument?: boolean | undefined;
+    readonly horizontalOrigin?: HorizontalOriginType | undefined;
+    readonly verticalOrigin?: VerticalOriginType | undefined;
+    readonly horizontalPositionEmu?: Emus | undefined;
+    readonly verticalPositionEmu?: Emus | undefined;
+    readonly horizontalAlignment?: HorizontalAlignmentType | undefined;
+    readonly verticalAlignment?: VerticalAlignmentType | undefined;
+    readonly lockAnchor?: boolean | undefined;
+    readonly allowOverlap?: boolean | undefined;
+    readonly layoutInCell?: boolean | undefined;
+    readonly horizontalModeled?: boolean | undefined;
+    readonly verticalModeled?: boolean | undefined;
+    readonly preservedHost?: OpenXmlElement | undefined;
+    readonly layoutDirty?: boolean | undefined;
+    readonly children: ReadonlyArray<OpenXmlElement>;
+}): EncodeGroupInput;
+/**
+ * Build {@link DrawingShapeInit} without writing `undefined` into optional
+ * fields (`exactOptionalPropertyTypes`).
+ *
+ * TS 3.3: nested conditional object spreads explode the checker (OOM).
+ */
+export declare function drawingShapeInit(parts: {
+    readonly encoding: DrawingEncoding;
+    readonly residual: OpenXmlElement;
+    readonly dirty: DirtyMode;
+    readonly name?: string | undefined;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly docPrId?: number | undefined;
+    readonly placement?: DrawingHostPlacement | undefined;
+    readonly width?: number | undefined;
+    readonly height?: number | undefined;
+    readonly presetGeometry?: string | undefined;
+    readonly rotation?: number | undefined;
+    readonly lockAspectRatio?: boolean | undefined;
+    readonly flipHorizontal?: boolean | undefined;
+    readonly flipVertical?: boolean | undefined;
+    readonly wrapping?: TextWrappingStyleType | undefined;
+    readonly wrapType?: import('../images/layout-types').TextWrappingType | undefined;
+    readonly distanceTop?: number | undefined;
+    readonly distanceBottom?: number | undefined;
+    readonly distanceLeft?: number | undefined;
+    readonly distanceRight?: number | undefined;
+    readonly behindDocument?: boolean | undefined;
+    readonly horizontalOrigin?: HorizontalOriginType | undefined;
+    readonly verticalOrigin?: VerticalOriginType | undefined;
+    readonly horizontalPosition?: number | undefined;
+    readonly verticalPosition?: number | undefined;
+    readonly horizontalAlignment?: HorizontalAlignmentType | undefined;
+    readonly verticalAlignment?: VerticalAlignmentType | undefined;
+    readonly lockAnchor?: boolean | undefined;
+    readonly allowOverlap?: boolean | undefined;
+    readonly layoutInCell?: boolean | undefined;
+    readonly txbxContent?: ReadonlyArray<OpenXmlElement> | undefined;
+    readonly bodyPrElement?: OpenXmlElement | undefined;
+    readonly fill?: ShapeFill | undefined;
+    readonly line?: ShapeLine | undefined;
+    readonly children?: ReadonlyArray<DrawingShape> | undefined;
+}): DrawingShapeInit;
+/**
+ * Map modeled {@link ShapeFill} to encode input. Only solid/none are serializable;
+ * other kinds throw (public setters already reject them).
+ */
+export declare function modeledFillForEncode(fill: ShapeFill | undefined): EncodeDrawingShapeFill | undefined;
+/**
+ * Map modeled {@link ShapeLine} to encode input. Only solid/none are serializable.
+ *
+ * TS 3.3: nested conditional object spreads explode the checker (OOM).
+ */
+export declare function modeledLineForEncode(line: ShapeLine | undefined): EncodeDrawingShapeLine | undefined;
+export {};

package/src/features/drawing/encode-builders.js

@@ -0,0 +1,390 @@
+/**
+ * Build encode input without writing `undefined` into optional fields
+ * (`exactOptionalPropertyTypes`).
+ *
+ * TS 3.3: nested conditional object spreads explode the checker (OOM). Assign
+ * optional keys only when defined — same exactOptionalPropertyTypes semantics.
+ */
+export function encodeDrawingShapeInput(parts) {
+    // title/description are required keys on EncodeDrawingShapeInput (may be undefined).
+    var out = {
+        placement: parts.placement,
+        widthEmu: parts.widthEmu,
+        heightEmu: parts.heightEmu,
+        presetGeometry: parts.presetGeometry,
+        docPrId: parts.docPrId,
+        name: parts.name,
+        title: parts.title,
+        description: parts.description,
+    };
+    if (parts.rotation !== undefined) {
+        out.rotation = parts.rotation;
+    }
+    if (parts.flipHorizontal !== undefined) {
+        out.flipHorizontal = parts.flipHorizontal;
+    }
+    if (parts.flipVertical !== undefined) {
+        out.flipVertical = parts.flipVertical;
+    }
+    if (parts.lockAspectRatio !== undefined) {
+        out.lockAspectRatio = parts.lockAspectRatio;
+    }
+    if (parts.wrapping !== undefined) {
+        out.wrapping = parts.wrapping;
+    }
+    if (parts.wrapType !== undefined) {
+        out.wrapType = parts.wrapType;
+    }
+    if (parts.distanceTopEmu !== undefined) {
+        out.distanceTopEmu = parts.distanceTopEmu;
+    }
+    if (parts.distanceBottomEmu !== undefined) {
+        out.distanceBottomEmu = parts.distanceBottomEmu;
+    }
+    if (parts.distanceLeftEmu !== undefined) {
+        out.distanceLeftEmu = parts.distanceLeftEmu;
+    }
+    if (parts.distanceRightEmu !== undefined) {
+        out.distanceRightEmu = parts.distanceRightEmu;
+    }
+    if (parts.behindDocument !== undefined) {
+        out.behindDocument = parts.behindDocument;
+    }
+    if (parts.horizontalOrigin !== undefined) {
+        out.horizontalOrigin = parts.horizontalOrigin;
+    }
+    if (parts.verticalOrigin !== undefined) {
+        out.verticalOrigin = parts.verticalOrigin;
+    }
+    if (parts.horizontalPositionEmu !== undefined) {
+        out.horizontalPositionEmu = parts.horizontalPositionEmu;
+    }
+    if (parts.verticalPositionEmu !== undefined) {
+        out.verticalPositionEmu = parts.verticalPositionEmu;
+    }
+    if (parts.horizontalAlignment !== undefined) {
+        out.horizontalAlignment = parts.horizontalAlignment;
+    }
+    if (parts.verticalAlignment !== undefined) {
+        out.verticalAlignment = parts.verticalAlignment;
+    }
+    if (parts.lockAnchor !== undefined) {
+        out.lockAnchor = parts.lockAnchor;
+    }
+    if (parts.horizontalModeled !== undefined) {
+        out.horizontalModeled = parts.horizontalModeled;
+    }
+    if (parts.verticalModeled !== undefined) {
+        out.verticalModeled = parts.verticalModeled;
+    }
+    if (parts.allowOverlap !== undefined) {
+        out.allowOverlap = parts.allowOverlap;
+    }
+    if (parts.layoutInCell !== undefined) {
+        out.layoutInCell = parts.layoutInCell;
+    }
+    if (parts.preservedHost !== undefined) {
+        out.preservedHost = parts.preservedHost;
+    }
+    if (parts.layoutDirty !== undefined) {
+        out.layoutDirty = parts.layoutDirty;
+    }
+    if (parts.txbxContent !== undefined) {
+        out.txbxContent = parts.txbxContent;
+    }
+    if (parts.bodyPr !== undefined) {
+        out.bodyPr = parts.bodyPr;
+    }
+    if (parts.fill !== undefined) {
+        out.fill = parts.fill;
+    }
+    if (parts.line !== undefined) {
+        out.line = parts.line;
+    }
+    return out;
+}
+/**
+ * Build {@link EncodeGroupInput} without writing `undefined` into optional
+ * fields (`exactOptionalPropertyTypes`). Nested children are required (may be []).
+ *
+ * TS 3.3: nested conditional object spreads explode the checker (OOM).
+ */
+export function encodeGroupInput(parts) {
+    var out = {
+        placement: parts.placement,
+        widthEmu: parts.widthEmu,
+        heightEmu: parts.heightEmu,
+        docPrId: parts.docPrId,
+        name: parts.name,
+        children: parts.children,
+    };
+    if (parts.title !== undefined) {
+        out.title = parts.title;
+    }
+    if (parts.description !== undefined) {
+        out.description = parts.description;
+    }
+    if (parts.rotation !== undefined) {
+        out.rotation = parts.rotation;
+    }
+    if (parts.flipHorizontal !== undefined) {
+        out.flipHorizontal = parts.flipHorizontal;
+    }
+    if (parts.flipVertical !== undefined) {
+        out.flipVertical = parts.flipVertical;
+    }
+    if (parts.lockAspectRatio !== undefined) {
+        out.lockAspectRatio = parts.lockAspectRatio;
+    }
+    if (parts.wrapping !== undefined) {
+        out.wrapping = parts.wrapping;
+    }
+    if (parts.distanceTopEmu !== undefined) {
+        out.distanceTopEmu = parts.distanceTopEmu;
+    }
+    if (parts.distanceBottomEmu !== undefined) {
+        out.distanceBottomEmu = parts.distanceBottomEmu;
+    }
+    if (parts.distanceLeftEmu !== undefined) {
+        out.distanceLeftEmu = parts.distanceLeftEmu;
+    }
+    if (parts.distanceRightEmu !== undefined) {
+        out.distanceRightEmu = parts.distanceRightEmu;
+    }
+    if (parts.behindDocument !== undefined) {
+        out.behindDocument = parts.behindDocument;
+    }
+    if (parts.horizontalOrigin !== undefined) {
+        out.horizontalOrigin = parts.horizontalOrigin;
+    }
+    if (parts.verticalOrigin !== undefined) {
+        out.verticalOrigin = parts.verticalOrigin;
+    }
+    if (parts.horizontalPositionEmu !== undefined) {
+        out.horizontalPositionEmu = parts.horizontalPositionEmu;
+    }
+    if (parts.verticalPositionEmu !== undefined) {
+        out.verticalPositionEmu = parts.verticalPositionEmu;
+    }
+    if (parts.horizontalAlignment !== undefined) {
+        out.horizontalAlignment = parts.horizontalAlignment;
+    }
+    if (parts.verticalAlignment !== undefined) {
+        out.verticalAlignment = parts.verticalAlignment;
+    }
+    if (parts.lockAnchor !== undefined) {
+        out.lockAnchor = parts.lockAnchor;
+    }
+    if (parts.horizontalModeled !== undefined) {
+        out.horizontalModeled = parts.horizontalModeled;
+    }
+    if (parts.verticalModeled !== undefined) {
+        out.verticalModeled = parts.verticalModeled;
+    }
+    if (parts.allowOverlap !== undefined) {
+        out.allowOverlap = parts.allowOverlap;
+    }
+    if (parts.layoutInCell !== undefined) {
+        out.layoutInCell = parts.layoutInCell;
+    }
+    if (parts.preservedHost !== undefined) {
+        out.preservedHost = parts.preservedHost;
+    }
+    if (parts.layoutDirty !== undefined) {
+        out.layoutDirty = parts.layoutDirty;
+    }
+    return out;
+}
+/**
+ * Build {@link DrawingShapeInit} without writing `undefined` into optional
+ * fields (`exactOptionalPropertyTypes`).
+ *
+ * TS 3.3: nested conditional object spreads explode the checker (OOM).
+ */
+export function drawingShapeInit(parts) {
+    var out = {
+        encoding: parts.encoding,
+        residual: parts.residual,
+        dirty: parts.dirty,
+    };
+    if (parts.name !== undefined) {
+        out.name = parts.name;
+    }
+    if (parts.title !== undefined) {
+        out.title = parts.title;
+    }
+    if (parts.description !== undefined) {
+        out.description = parts.description;
+    }
+    if (parts.docPrId !== undefined) {
+        out.docPrId = parts.docPrId;
+    }
+    if (parts.placement !== undefined) {
+        out.placement = parts.placement;
+    }
+    if (parts.width !== undefined) {
+        out.width = parts.width;
+    }
+    if (parts.height !== undefined) {
+        out.height = parts.height;
+    }
+    if (parts.presetGeometry !== undefined) {
+        out.presetGeometry = parts.presetGeometry;
+    }
+    if (parts.rotation !== undefined) {
+        out.rotation = parts.rotation;
+    }
+    if (parts.lockAspectRatio !== undefined) {
+        out.lockAspectRatio = parts.lockAspectRatio;
+    }
+    if (parts.flipHorizontal !== undefined) {
+        out.flipHorizontal = parts.flipHorizontal;
+    }
+    if (parts.flipVertical !== undefined) {
+        out.flipVertical = parts.flipVertical;
+    }
+    if (parts.wrapping !== undefined) {
+        out.wrapping = parts.wrapping;
+    }
+    if (parts.wrapType !== undefined) {
+        out.wrapType = parts.wrapType;
+    }
+    if (parts.distanceTop !== undefined) {
+        out.distanceTop = parts.distanceTop;
+    }
+    if (parts.distanceBottom !== undefined) {
+        out.distanceBottom = parts.distanceBottom;
+    }
+    if (parts.distanceLeft !== undefined) {
+        out.distanceLeft = parts.distanceLeft;
+    }
+    if (parts.distanceRight !== undefined) {
+        out.distanceRight = parts.distanceRight;
+    }
+    if (parts.behindDocument !== undefined) {
+        out.behindDocument = parts.behindDocument;
+    }
+    if (parts.horizontalOrigin !== undefined) {
+        out.horizontalOrigin = parts.horizontalOrigin;
+    }
+    if (parts.verticalOrigin !== undefined) {
+        out.verticalOrigin = parts.verticalOrigin;
+    }
+    if (parts.horizontalPosition !== undefined) {
+        out.horizontalPosition = parts.horizontalPosition;
+    }
+    if (parts.verticalPosition !== undefined) {
+        out.verticalPosition = parts.verticalPosition;
+    }
+    if (parts.horizontalAlignment !== undefined) {
+        out.horizontalAlignment = parts.horizontalAlignment;
+    }
+    if (parts.verticalAlignment !== undefined) {
+        out.verticalAlignment = parts.verticalAlignment;
+    }
+    if (parts.lockAnchor !== undefined) {
+        out.lockAnchor = parts.lockAnchor;
+    }
+    if (parts.allowOverlap !== undefined) {
+        out.allowOverlap = parts.allowOverlap;
+    }
+    if (parts.layoutInCell !== undefined) {
+        out.layoutInCell = parts.layoutInCell;
+    }
+    if (parts.txbxContent !== undefined) {
+        out.txbxContent = parts.txbxContent;
+    }
+    if (parts.bodyPrElement !== undefined) {
+        out.bodyPrElement = parts.bodyPrElement;
+    }
+    if (parts.fill !== undefined) {
+        out.fill = parts.fill;
+    }
+    if (parts.line !== undefined) {
+        out.line = parts.line;
+    }
+    if (parts.children !== undefined) {
+        out.children = parts.children;
+    }
+    return out;
+}
+/**
+ * Map modeled {@link ShapeFill} to encode input. Only solid/none are serializable;
+ * other kinds throw (public setters already reject them).
+ */
+export function modeledFillForEncode(fill) {
+    if (fill === undefined) {
+        return undefined;
+    }
+    if (fill.kind === 'none') {
+        return { kind: 'none' };
+    }
+    if (fill.kind === 'solid') {
+        var out = {
+            kind: 'solid',
+            srgb: fill.srgb,
+        };
+        if (fill.alpha !== undefined) {
+            out.alpha = fill.alpha;
+        }
+        return out;
+    }
+    throw new RangeError('Fill kind "' + String(fill.kind) + '" cannot be authored; use solid or none');
+}
+/**
+ * Map modeled {@link ShapeLine} to encode input. Only solid/none are serializable.
+ *
+ * TS 3.3: nested conditional object spreads explode the checker (OOM).
+ */
+export function modeledLineForEncode(line) {
+    if (line === undefined) {
+        return undefined;
+    }
+    if (line.kind === 'none') {
+        var out = {
+            kind: 'none',
+        };
+        if (line.widthEmu !== undefined) {
+            out.widthEmu = line.widthEmu;
+        }
+        if (line.cap !== undefined) {
+            out.cap = line.cap;
+        }
+        return out;
+    }
+    if (line.kind === 'solid') {
+        if (line.srgbColor === undefined) {
+            throw new RangeError('Solid line requires an sRGB color');
+        }
+        var out = {
+            kind: 'solid',
+            srgb: line.srgbColor,
+        };
+        if (line.widthEmu !== undefined) {
+            out.widthEmu = line.widthEmu;
+        }
+        if (line.dash !== undefined) {
+            out.dash = line.dash;
+        }
+        if (line.cap !== undefined) {
+            out.cap = line.cap;
+        }
+        if (line.beginArrowType !== undefined) {
+            out.beginArrowType = line.beginArrowType;
+        }
+        if (line.beginArrowSize !== undefined) {
+            out.beginArrowSize = line.beginArrowSize;
+        }
+        if (line.endArrowType !== undefined) {
+            out.endArrowType = line.endArrowType;
+        }
+        if (line.endArrowSize !== undefined) {
+            out.endArrowSize = line.endArrowSize;
+        }
+        if (line.alpha !== undefined) {
+            out.alpha = line.alpha;
+        }
+        return out;
+    }
+    throw new RangeError('Line kind "' + String(line.kind) + '" cannot be authored; use solid or none');
+}

package/src/features/drawing/fill-format.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Public FillFormat owned by Shape (Shape.md §6).
+ * @packageDocumentation
+ */
+import { Color } from '../document/color';
+import { ShapeFill } from './sp-pr';
+/** Default fill enabled for newly authored shapes. @public */
+export declare const DEFAULT_SHAPE_FILL_ENABLED: boolean;
+/** Default solid fill color for newly authored shapes. @public */
+export declare const DEFAULT_SHAPE_FILL_COLOR: Color;
+/** Default fill transparency percent (0 = opaque). @public */
+export declare const DEFAULT_SHAPE_FILL_TRANSPARENCY: number;
+/** @private */
+export declare function defaultAuthoredShapeFill(): {
+    readonly kind: 'solid';
+    readonly srgb: string;
+};
+/**
+ * Owner hooks for {@link FillFormat} (avoids circular import on Shape).
+ * @private
+ */
+export interface FillFormatOwner {
+    /** @private */
+    readShapeFillState(): ShapeFill | undefined;
+    /** @private */
+    writeShapeFillState(value: ShapeFill | undefined): void;
+}
+/**
+ * Shape fill formatting surface (`a:noFill` / `a:solidFill`).
+ * @public
+ */
+export declare class FillFormat {
+    private readonly owner;
+    /** @private */
+    constructor(owner: FillFormatOwner);
+    /**
+     * Whether an explicit fill is present (`true`) or `a:noFill` (`false`).
+     * Theme/unsupported residual fills report `true` without inventing a color.
+     * @public
+     */
+    fill: boolean;
+    /**
+     * Solid fill color. Unresolved theme/pattern/gradient returns {@link Color.Transparent}.
+     * @public
+     */
+    color: Color;
+    /**
+     * Transparency percent 0–100 (0 = opaque, 100 = fully transparent).
+     * @public
+     */
+    transparency: number;
+}