@cj-tech-master/excelts 8.1.2 → 9.0.0-canary.20260409073829.a0d72ec

package/README.md

@@ -100,14 +100,14 @@ wb.getWorksheet(1).eachRow((row, n) => console.log(n, row.values));
 
 // PDF — generate from data, no Workbook needed
 import { pdf } from "@cj-tech-master/excelts/pdf";
-const pdfBytes = pdf([
+const pdfBytes = await pdf([
   ["Product", "Revenue"],
   ["Widget", 1000]
 ]);
 
 // PDF — read text, images, and metadata from any PDF
 import { readPdf } from "@cj-tech-master/excelts/pdf";
-const result = readPdf(pdfBytes);
+const result = await readPdf(pdfBytes);
 console.log(result.text); // extracted text
 console.log(result.metadata); // title, author, etc.
 

package/README_zh.md

@@ -100,14 +100,14 @@ wb.getWorksheet(1).eachRow((row, n) => console.log(n, row.values));
 
 // PDF — 直接从数据生成，无需 Workbook
 import { pdf } from "@cj-tech-master/excelts/pdf";
-const pdfBytes = pdf([
+const pdfBytes = await pdf([
   ["产品", "收入"],
   ["小工具", 1000]
 ]);
 
 // PDF — 读取任意 PDF 的文本、图片和元数据
 import { readPdf } from "@cj-tech-master/excelts/pdf";
-const result = readPdf(pdfBytes);
+const result = await readPdf(pdfBytes);
 console.log(result.text); // 提取的文本
 console.log(result.metadata); // 标题、作者等
 

package/dist/browser/index.browser.d.ts

@@ -15,6 +15,8 @@ export { DataValidations } from "./modules/excel/data-validations.js";
 export { FormCheckbox } from "./modules/excel/form-control.js";
 export * from "./modules/excel/enums.js";
 export * from "./modules/excel/types.js";
+export { createTextWatermarkImage } from "./modules/excel/utils/watermark-image.js";
+export type { TextWatermarkImageOptions } from "./modules/excel/utils/watermark-image.js";
 export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "./modules/excel/pivot-table.js";
 export type { FormCheckboxModel, FormCheckboxOptions, FormControlRange, FormControlAnchor } from "./modules/excel/form-control.js";
 export { WorkbookWriter } from "./modules/excel/stream/workbook-writer.browser.js";

package/dist/browser/index.browser.js

@@ -25,6 +25,8 @@ export * from "./modules/excel/enums.js";
 // =============================================================================
 // Export all type definitions from types.ts
 export * from "./modules/excel/types.js";
+// Watermark image generator utility
+export { createTextWatermarkImage } from "./modules/excel/utils/watermark-image.js";
 // =============================================================================
 // Streaming Writer (Browser-compatible)
 // Uses cross-platform base implementation without Node.js fs

package/dist/browser/index.d.ts

@@ -15,6 +15,8 @@ export { WorksheetWriter } from "./modules/excel/stream/worksheet-writer.js";
 export { WorksheetReader } from "./modules/excel/stream/worksheet-reader.js";
 export * from "./modules/excel/enums.js";
 export * from "./modules/excel/types.js";
+export { createTextWatermarkImage } from "./modules/excel/utils/watermark-image.js";
+export type { TextWatermarkImageOptions } from "./modules/excel/utils/watermark-image.js";
 export type { PivotTable, PivotTableModel, PivotTableValue, PivotTableSource, CacheField, SharedItemValue, DataField, PivotTableSubtotal, RecordValue, ParsedCacheDefinition, ParsedCacheRecords } from "./modules/excel/pivot-table.js";
 export type { FormCheckboxModel, FormCheckboxOptions, FormControlRange, FormControlAnchor } from "./modules/excel/form-control.js";
 export type { WorkbookReaderOptions, ParseEvent, SharedStringEvent, WorksheetReadyEvent, HyperlinksEvent } from "./modules/excel/stream/workbook-reader.js";

package/dist/browser/index.js

@@ -29,6 +29,8 @@ export * from "./modules/excel/enums.js";
 // =============================================================================
 // Export all type definitions from types.ts
 export * from "./modules/excel/types.js";
+// Watermark image generator utility
+export { createTextWatermarkImage } from "./modules/excel/utils/watermark-image.js";
 export { CsvParserStream, CsvFormatterStream, createCsvParserStream, createCsvFormatterStream } from "./modules/csv/stream/index.js";
 // =============================================================================
 // Additional Classes & Types

package/dist/browser/modules/excel/cell.js

@@ -3,6 +3,7 @@ import { Enums } from "./enums.js";
 import { Note } from "./note.js";
 import { escapeHtml } from "./utils/under-dash.js";
 import { slideFormula } from "./utils/shared-formula.js";
+import { copyStyle } from "./utils/copy-style.js";
 import { ExcelError, InvalidValueTypeError } from "./errors.js";
 // Returns true if the value is a non-empty object (has at least one own key),
 // or any truthy non-object value. Returns false for undefined, null, false, 0,
@@ -87,27 +88,27 @@ class Cell {
         const font = (rowStyle && hasOwnKeys(rowStyle.font) && rowStyle.font) ||
             (colStyle && hasOwnKeys(colStyle.font) && colStyle.font);
         if (font) {
-            style.font = font;
+            style.font = structuredClone(font);
         }
         const alignment = (rowStyle && hasOwnKeys(rowStyle.alignment) && rowStyle.alignment) ||
             (colStyle && hasOwnKeys(colStyle.alignment) && colStyle.alignment);
         if (alignment) {
-            style.alignment = alignment;
+            style.alignment = structuredClone(alignment);
         }
         const border = (rowStyle && hasOwnKeys(rowStyle.border) && rowStyle.border) ||
             (colStyle && hasOwnKeys(colStyle.border) && colStyle.border);
         if (border) {
-            style.border = border;
+            style.border = structuredClone(border);
         }
         const fill = (rowStyle && hasOwnKeys(rowStyle.fill) && rowStyle.fill) ||
             (colStyle && hasOwnKeys(colStyle.fill) && colStyle.fill);
         if (fill) {
-            style.fill = fill;
+            style.fill = structuredClone(fill);
         }
         const protection = (rowStyle && hasOwnKeys(rowStyle.protection) && rowStyle.protection) ||
             (colStyle && hasOwnKeys(colStyle.protection) && colStyle.protection);
         if (protection) {
-            style.protection = protection;
+            style.protection = structuredClone(protection);
         }
         return style;
     }
@@ -151,7 +152,10 @@ class Cell {
         this._value.release();
         this._value = Value.create(Cell.Types.Merge, this, master);
         if (!ignoreStyle) {
-            this.style = master.style;
+            // Deep-copy so each cell has an independent style object.
+            // Without this, all cells in the merge share the same reference,
+            // and setting a property (e.g. border) on any cell mutates all of them.
+            this.style = copyStyle(master.style) ?? {};
         }
     }
     unmerge() {
@@ -318,7 +322,7 @@ class Cell {
             }
         }
         if (value.style) {
-            this.style = value.style;
+            this.style = copyStyle(value.style) ?? {};
         }
         else {
             this.style = {};

package/dist/browser/modules/excel/column.js

@@ -1,5 +1,6 @@
 import { colCache } from "./utils/col-cache.js";
 import { isEqual } from "./utils/under-dash.js";
+import { copyStyle } from "./utils/copy-style.js";
 import { Enums } from "./enums.js";
 const DEFAULT_COLUMN_WIDTH = 9;
 /**
@@ -48,7 +49,7 @@ class Column {
             this.width = value.width !== undefined ? value.width : DEFAULT_COLUMN_WIDTH;
             this.outlineLevel = value.outlineLevel;
             if (value.style) {
-                this.style = value.style;
+                this.style = copyStyle(value.style) ?? {};
             }
             else {
                 this.style = {};
@@ -259,7 +260,7 @@ class Column {
     set font(value) {
         this.style.font = value;
         this.eachCell(cell => {
-            cell.font = value;
+            cell.font = value ? structuredClone(value) : value;
         });
     }
     get alignment() {
@@ -268,7 +269,7 @@ class Column {
     set alignment(value) {
         this.style.alignment = value;
         this.eachCell(cell => {
-            cell.alignment = value;
+            cell.alignment = value ? structuredClone(value) : value;
         });
     }
     get protection() {
@@ -277,7 +278,7 @@ class Column {
     set protection(value) {
         this.style.protection = value;
         this.eachCell(cell => {
-            cell.protection = value;
+            cell.protection = value ? structuredClone(value) : value;
         });
     }
     get border() {
@@ -286,7 +287,7 @@ class Column {
     set border(value) {
         this.style.border = value;
         this.eachCell(cell => {
-            cell.border = value;
+            cell.border = value ? structuredClone(value) : value;
         });
     }
     get fill() {
@@ -295,7 +296,7 @@ class Column {
     set fill(value) {
         this.style.fill = value;
         this.eachCell(cell => {
-            cell.fill = value;
+            cell.fill = value ? structuredClone(value) : value;
         });
     }
     // =============================================================================

package/dist/browser/modules/excel/image.d.ts

@@ -19,6 +19,19 @@ interface BackgroundModel {
     type: "background";
     imageId: string;
 }
+interface WatermarkModel {
+    type: "watermark";
+    imageId: string;
+    /** Opacity 0-1 for overlay mode */
+    opacity?: number;
+}
+interface HeaderImageModel {
+    type: "headerImage";
+    imageId: string;
+    headerWidth?: number;
+    headerHeight?: number;
+    applyTo?: "all" | "odd" | "even" | "first";
+}
 interface ImageRangeModel {
     tl: AnchorModel;
     br?: AnchorModel;
@@ -31,7 +44,7 @@ interface ImageModel {
     hyperlinks?: ImageHyperlinks;
     range: ImageRangeModel;
 }
-type Model = BackgroundModel | ImageModel;
+type Model = BackgroundModel | ImageModel | WatermarkModel | HeaderImageModel;
 type ImageModelInput = ModelInput;
 interface RangeInput {
     tl?: AnchorModel | {
@@ -51,15 +64,27 @@ interface ModelInput {
     imageId: string;
     range?: string | RangeInput | ImageRangeModel;
     hyperlinks?: ImageHyperlinks;
+    opacity?: number;
+    headerWidth?: number;
+    headerHeight?: number;
+    applyTo?: "all" | "odd" | "even" | "first";
 }
 declare class Image {
     readonly worksheet: Worksheet;
     type?: string;
     imageId?: string;
     range?: ImageRange;
+    /** Opacity for watermark overlay mode (0-1). */
+    opacity?: number;
+    /** Header image width in points. */
+    headerWidth?: number;
+    /** Header image height in points. */
+    headerHeight?: number;
+    /** Header watermark applyTo setting. */
+    applyTo?: "all" | "odd" | "even" | "first";
     constructor(worksheet: Worksheet, model?: ModelInput);
     get model(): Model;
-    set model({ type, imageId, range, hyperlinks }: ModelInput);
+    set model({ type, imageId, range, hyperlinks, opacity, headerWidth, headerHeight, applyTo }: ModelInput);
     clone(worksheet?: Worksheet): Image;
 }
 export { Image, type Model as ImageModel, type ImageModelInput };

package/dist/browser/modules/excel/image.js

@@ -15,6 +15,20 @@ class Image {
                     type: this.type,
                     imageId: this.imageId ?? ""
                 };
+            case "watermark":
+                return {
+                    type: this.type,
+                    imageId: this.imageId ?? "",
+                    opacity: this.opacity
+                };
+            case "headerImage":
+                return {
+                    type: this.type,
+                    imageId: this.imageId ?? "",
+                    headerWidth: this.headerWidth,
+                    headerHeight: this.headerHeight,
+                    applyTo: this.applyTo
+                };
             case "image": {
                 const range = this.range;
                 if (!range) {
@@ -36,9 +50,13 @@ class Image {
                 throw new ImageError("Invalid Image Type");
         }
     }
-    set model({ type, imageId, range, hyperlinks }) {
+    set model({ type, imageId, range, hyperlinks, opacity, headerWidth, headerHeight, applyTo }) {
         this.type = type;
         this.imageId = imageId;
+        this.opacity = opacity;
+        this.headerWidth = headerWidth;
+        this.headerHeight = headerHeight;
+        this.applyTo = applyTo;
         if (type === "image") {
             if (typeof range === "string") {
                 const decoded = colCache.decode(range);
@@ -67,6 +85,10 @@ class Image {
         const cloned = new Image(target);
         cloned.type = this.type;
         cloned.imageId = this.imageId;
+        cloned.opacity = this.opacity;
+        cloned.headerWidth = this.headerWidth;
+        cloned.headerHeight = this.headerHeight;
+        cloned.applyTo = this.applyTo;
         if (this.range) {
             cloned.range = {
                 tl: this.range.tl.clone(target),

package/dist/browser/modules/excel/row.js

@@ -297,7 +297,11 @@ class Row {
         this.style[name] = value;
         this._cells.forEach(cell => {
             if (cell) {
-                cell.style[name] = value;
+                // Clone object values so each cell gets an independent copy.
+                // Without this, mutating a sub-property (e.g. cell.border.top = ...)
+                // would leak to every other cell that received the same reference.
+                cell.style[name] =
+                    typeof value === "object" && value !== null ? structuredClone(value) : value;
             }
         });
     }

package/dist/browser/modules/excel/stream/worksheet-reader.js

@@ -7,6 +7,7 @@ import { EventEmitter } from "../../../utils/event-emitter.js";
 import { SaxParser } from "../../xml/sax.js";
 import { ExcelStreamStateError } from "../errors.js";
 import { isDateFmt, excelToDate, decodeOoxmlEscape } from "../../../utils/utils.browser.js";
+import { copyStyle } from "../utils/copy-style.js";
 import { colCache } from "../utils/col-cache.js";
 import { Dimensions } from "../range.js";
 import { Row } from "../row.js";
@@ -178,7 +179,7 @@ class WorksheetReader extends EventEmitter {
                                 const styleId = parseInt(node.attributes.s, 10);
                                 const style = styles.getStyleModel(styleId);
                                 if (style) {
-                                    row.style = style;
+                                    row.style = copyStyle(style) ?? {};
                                 }
                             }
                         }
@@ -279,7 +280,7 @@ class WorksheetReader extends EventEmitter {
                             if (c.s !== undefined) {
                                 const style = styles.getStyleModel(c.s);
                                 if (style) {
-                                    cell.style = style;
+                                    cell.style = copyStyle(style) ?? {};
                                 }
                             }
                             if (c.f) {

package/dist/browser/modules/excel/stream/worksheet-writer.d.ts

@@ -3,7 +3,7 @@ import { Row } from "../row.js";
 import type { Cell } from "../cell.js";
 import { Column } from "../column.js";
 import { DataValidations } from "../data-validations.js";
-import type { RowBreak, ColBreak, PageSetup, HeaderFooter, WorksheetProperties, WorksheetView, WorksheetState, AutoFilter, WorksheetProtection, ConditionalFormattingOptions, AddImageRange } from "../types.js";
+import type { RowBreak, ColBreak, PageSetup, HeaderFooter, WorksheetProperties, WorksheetView, WorksheetState, AutoFilter, WorksheetProtection, ConditionalFormattingOptions, AddImageRange, WatermarkOptions } from "../types.js";
 interface WorksheetWriterOptions {
     id: number;
     name?: string;
@@ -97,6 +97,8 @@ declare class WorksheetWriter {
     startedData: boolean;
     private _background?;
     private _headerRowCount?;
+    /** Watermark configuration */
+    private _watermark;
     /** Drawing model — populated during commit if images were added */
     private _drawing?;
     /** Relationship Id - assigned by WorkbookWriter */
@@ -141,6 +143,19 @@ declare class WorksheetWriter {
      * Each entry contains imageId and the normalised range (with native anchors).
      */
     getImages(): ReadonlyArray<WriterImageModel>;
+    /**
+     * Add a watermark to the worksheet using an image from `WorkbookWriter.addImage()`.
+     * Supports overlay mode (DrawingML with transparency) and header mode (VML behind content).
+     */
+    addWatermark(options: WatermarkOptions): void;
+    /**
+     * Get the current watermark configuration.
+     */
+    getWatermark(): WatermarkOptions | null;
+    /**
+     * Remove the watermark from the worksheet.
+     */
+    removeWatermark(): void;
     /**
      * Parse the user-supplied range into a normalised internal model
      * mirroring what the regular Worksheet / Image class does.

package/dist/browser/modules/excel/stream/worksheet-writer.js

@@ -151,6 +151,8 @@ class WorksheetWriter {
         // auto filter
         this.autoFilter = options.autoFilter ?? null;
         this._media = [];
+        // watermark
+        this._watermark = null;
         // worksheet protection
         this.sheetProtection = null;
         // start writing to stream now
@@ -448,6 +450,57 @@ class WorksheetWriter {
     getImages() {
         return this._media;
     }
+    // =========================================================================
+    // Watermark
+    /**
+     * Add a watermark to the worksheet using an image from `WorkbookWriter.addImage()`.
+     * Supports overlay mode (DrawingML with transparency) and header mode (VML behind content).
+     */
+    addWatermark(options) {
+        // Remove existing watermark entries (both stored type tags)
+        this._media = this._media.filter(m => m._watermarkTag !== true);
+        const opacity = options.opacity !== undefined ? Math.max(0, Math.min(1, options.opacity)) : 0.15;
+        this._watermark = {
+            imageId: String(options.imageId),
+            mode: options.mode ?? "overlay",
+            opacity,
+            headerWidth: options.headerWidth,
+            headerHeight: options.headerHeight,
+            applyTo: options.applyTo
+        };
+        if (this._watermark.mode === "overlay") {
+            // Coverage range is computed lazily during commit() via _resolveWatermarkRange()
+            const entry = {
+                type: "image",
+                imageId: String(options.imageId),
+                range: {
+                    tl: { nativeCol: 0, nativeColOff: 0, nativeRow: 0, nativeRowOff: 0 },
+                    br: { nativeCol: 100, nativeColOff: 0, nativeRow: 200, nativeRowOff: 0 },
+                    editAs: "absolute"
+                },
+                // Internal tag for dedup — not part of the WriterImageModel type
+                _watermarkTag: true,
+                opacity
+            };
+            this._media.push(entry);
+        }
+        // Note: header mode for streaming writer is limited — the VML file generation
+        // happens in WorkbookWriter.addWorksheets(), which handles worksheet.headerImage.
+        // We store the config in _watermark and it's picked up by the commit path.
+    }
+    /**
+     * Get the current watermark configuration.
+     */
+    getWatermark() {
+        return this._watermark;
+    }
+    /**
+     * Remove the watermark from the worksheet.
+     */
+    removeWatermark() {
+        this._watermark = null;
+        this._media = this._media.filter(m => m._watermarkTag !== true);
+    }
     /**
      * Parse the user-supplied range into a normalised internal model
      * mirroring what the regular Worksheet / Image class does.
@@ -626,6 +679,21 @@ class WorksheetWriter {
         if (this._media.length === 0) {
             return;
         }
+        // Resolve watermark coverage range from actual worksheet dimensions
+        // (at commit time, all rows have been flushed so _dimensions is accurate)
+        for (const entry of this._media) {
+            if (entry._watermarkTag) {
+                const dims = this._dimensions.model;
+                const maxCol = dims ? Math.max(dims.right ?? 100, 100) : 100;
+                const maxRow = dims ? Math.max(dims.bottom ?? 200, 200) : 200;
+                entry.range.br = {
+                    nativeCol: maxCol,
+                    nativeColOff: 0,
+                    nativeRow: maxRow,
+                    nativeRowOff: 0
+                };
+            }
+        }
         // Build the drawing model from the stored images.
         // The drawing XML will be generated later by WorkbookWriterBase.addDrawings().
         const drawingName = `drawing${this.id}`;

package/dist/browser/modules/excel/types.d.ts

@@ -368,6 +368,78 @@ export interface ImageHyperlinkValue {
     hyperlink: string;
     tooltip?: string;
 }
+/**
+ * Watermark placement mode in the Excel worksheet.
+ *
+ * - `"overlay"` — Places the watermark image as a DrawingML picture on top of cells.
+ *   Visible on screen AND when printed. Supports transparency via `<a:alphaModFix>`.
+ *   Users can move/delete the watermark unless the sheet is protected.
+ *
+ * - `"header"` — Places the watermark image in the page header using VML.
+ *   Renders behind cell content. Visible in Page Layout view and Print Preview.
+ *   Cannot be accidentally moved/deleted. The standard "true watermark" approach.
+ */
+export type WatermarkMode = "overlay" | "header";
+/**
+ * Options for adding a watermark to a worksheet.
+ *
+ * @example Overlay watermark (visible on screen + prints):
+ * ```typescript
+ * const imgId = workbook.addImage({ buffer: pngData, extension: "png" });
+ * worksheet.addWatermark({
+ *   imageId: imgId,
+ *   mode: "overlay",
+ *   opacity: 0.15
+ * });
+ * ```
+ *
+ * @example Header watermark (behind content, prints correctly):
+ * ```typescript
+ * const imgId = workbook.addImage({ buffer: pngData, extension: "png" });
+ * worksheet.addWatermark({
+ *   imageId: imgId,
+ *   mode: "header"
+ * });
+ * ```
+ */
+export interface WatermarkOptions {
+    /** Image ID obtained from `workbook.addImage()`. */
+    imageId: string | number;
+    /**
+     * Watermark placement mode.
+     * @default "overlay"
+     */
+    mode?: WatermarkMode;
+    /**
+     * Opacity for overlay mode (0 = fully transparent, 1 = fully opaque).
+     * Expressed as a percentage in OOXML (e.g. 0.15 = 15000 out of 100000).
+     * Only applies to `"overlay"` mode. In `"header"` mode, transparency
+     * must be baked into the image itself (use a PNG with alpha channel).
+     * @default 0.15
+     */
+    opacity?: number;
+    /**
+     * Image width in points (for "header" mode VML rendering).
+     * @default 467.25
+     */
+    headerWidth?: number;
+    /**
+     * Image height in points (for "header" mode VML rendering).
+     * @default 311.25
+     */
+    headerHeight?: number;
+    /**
+     * Which header sections to apply the watermark to (only for "header" mode).
+     *
+     * - `"all"` — applies to oddHeader, evenHeader, and firstHeader
+     * - `"odd"` — applies only to oddHeader (standard pages)
+     * - `"even"` — applies only to evenHeader
+     * - `"first"` — applies only to firstHeader
+     *
+     * @default "all"
+     */
+    applyTo?: "all" | "odd" | "even" | "first";
+}
 export type Location = {
     top: number;
     left: number;

package/dist/browser/modules/excel/utils/cell-format.js

@@ -513,6 +513,35 @@ function formatNumberPattern(val, fmt) {
     const decimalPlaces = decFmt.replace(/[^0#?]/g, "").length;
     // Round the value
     const roundedVal = roundTo(scaledVal, decimalPlaces);
+    // When value is zero and the format has no required '0' digit placeholders,
+    // '?' placeholders become spaces and '#' placeholders produce nothing.
+    // This handles accounting format zero sections like "-"?? → "- " (dash + spaces).
+    if (roundedVal === 0 && !intFmt.includes("0") && !decFmt.includes("0")) {
+        let result = "";
+        for (const ch of intFmt) {
+            if (ch === "?") {
+                result += " ";
+            }
+            else if (ch !== "#" && ch !== ",") {
+                // Preserve literal characters (already unquoted at this point)
+                result += ch;
+            }
+        }
+        if (decimalPlaces > 0) {
+            // Only emit the decimal point if the decimal format has '?' or '0' placeholders.
+            // Pure '#' decimal digits produce nothing for zero values.
+            const hasDecContent = /[0?]/.test(decFmt);
+            if (hasDecContent) {
+                result += ".";
+                for (const ch of decFmt) {
+                    if (ch === "?") {
+                        result += " ";
+                    }
+                }
+            }
+        }
+        return sign + result;
+    }
     // Split into integer and decimal parts
     const [intPart, decPart = ""] = roundedVal.toString().split(".");
     // Check if format has literal characters mixed with digit placeholders (like "0-0", "000-0000")
@@ -552,16 +581,49 @@ function formatNumberPattern(val, fmt) {
         if (intFmt.includes(",")) {
             formattedInt = commaify(intPart);
         }
-        // Pad integer with leading zeros if needed
+        // Pad integer with leading zeros/spaces if needed
+        // '0' placeholder → pad with "0", '?' placeholder → pad with " "
         const minIntDigits = (intFmt.match(/0/g) ?? []).length;
+        const totalIntSlots = (intFmt.match(/[0?]/g) ?? []).length;
         if (formattedInt.length < minIntDigits) {
             formattedInt = "0".repeat(minIntDigits - formattedInt.length) + formattedInt;
         }
+        if (formattedInt.length < totalIntSlots) {
+            formattedInt = " ".repeat(totalIntSlots - formattedInt.length) + formattedInt;
+        }
+        // '#' integer placeholder: suppress "0" when there are no required '0' or '?' digits
+        // and the integer value is zero (e.g. "#" format with value 0 → empty)
+        if (formattedInt === "0" && minIntDigits === 0 && totalIntSlots === 0) {
+            formattedInt = "";
+        }
     }
     // Format decimal part
     let formattedDec = "";
     if (decimalPlaces > 0) {
-        formattedDec = "." + (decPart + "0".repeat(decimalPlaces)).substring(0, decimalPlaces);
+        const rawDec = (decPart + "0".repeat(decimalPlaces)).substring(0, decimalPlaces);
+        // Process each decimal digit position according to its placeholder:
+        // '0' → always show digit, '?' → show digit or space, '#' → show digit or nothing (trim trailing)
+        const decChars = rawDec.split("");
+        // Walk from the end: '#' trailing zeros are removed, '?' trailing zeros become spaces
+        for (let i = decFmt.length - 1; i >= 0; i--) {
+            if (i >= decChars.length) {
+                continue;
+            }
+            if (decFmt[i] === "#" && decChars[i] === "0") {
+                decChars[i] = "";
+            }
+            else if (decFmt[i] === "?" && decChars[i] === "0") {
+                decChars[i] = " ";
+            }
+            else {
+                break; // stop at first non-zero or '0' placeholder
+            }
+        }
+        const decStr = decChars.join("");
+        // Only emit decimal point if there is content after it
+        if (decStr.length > 0) {
+            formattedDec = "." + decStr;
+        }
     }
     return sign + formattedInt + formattedDec;
 }

package/dist/browser/modules/excel/utils/drawing-utils.d.ts

@@ -12,6 +12,8 @@ interface DrawingAnchor {
             tooltip?: string;
             rId: string;
         };
+        /** Alpha modulation for transparency (OOXML percentage, e.g. 15000 = 15%). */
+        alphaModFix?: number;
     };
     range: any;
 }
@@ -32,6 +34,8 @@ interface ImageMedium {
         hyperlink?: string;
         tooltip?: string;
     };
+    /** Opacity 0-1 for watermark overlay mode. */
+    opacity?: number;
 }
 /**
  * Resolves a media filename into the drawing-level relative target path.