@cj-tech-master/excelts 9.4.2 → 9.5.0

package/dist/browser/modules/pdf/builder/document-builder.d.ts

@@ -47,6 +47,26 @@ export interface DrawTextOptions {
     maxWidth?: number;
     /** Line height multiplier. Default: 1.2. */
     lineHeight?: number;
+    /**
+     * Rotation in degrees, counter-clockwise in the PDF coordinate system
+     * (which has +Y pointing up, so visually clockwise on a page viewer).
+     * The rotation pivot is `(x, y)`. Default: `0` (no rotation).
+     *
+     * Incompatible with `maxWidth` (word-wrapping + rotation requires per-
+     * line matrix transforms that the current implementation does not
+     * support — supplying both leaves the wrap ignoring rotation so the
+     * text remains readable). If you need rotated wrapped text, break it
+     * into lines yourself and call `drawText` per line.
+     */
+    rotation?: number;
+    /**
+     * Horizontal alignment of the text around `x`. Default: `"start"`
+     * (the conventional PDF behaviour where `x` is the baseline left
+     * edge). Implemented by pre-shifting `x` using the chosen font's
+     * measured width — no deferred layout, so the computed position is
+     * stable across font subsetting.
+     */
+    anchor?: "start" | "middle" | "end";
 }
 /** Rectangle drawing options. */
 export interface DrawRectOptions {
@@ -158,6 +178,19 @@ export interface DrawImageOptions {
     /** Display height in points. */
     height: number;
 }
+/** Options for drawing a simple SVG document onto a PDF page. */
+export interface DrawSvgOptions {
+    /** Raw SVG markup. */
+    svg: string;
+    /** Destination X position in points. */
+    x: number;
+    /** Destination Y position in points. */
+    y: number;
+    /** Destination width in points. If omitted, uses the SVG width/viewBox width. */
+    width?: number;
+    /** Destination height in points. If omitted, uses the SVG height/viewBox height. */
+    height?: number;
+}
 /** Document metadata. */
 export interface DocumentMetadata {
     title?: string;
@@ -392,6 +425,13 @@ export declare class PdfPageBuilder {
      * @param options - Fill/stroke options
      */
     drawSvgPath(d: string, options?: DrawPathOptions): this;
+    /**
+     * Draw a simple SVG document onto this page.
+     *
+     * Supports the SVG primitives emitted by ExcelTS chart rendering:
+     * `rect`, `line`, `circle`, `polyline`, `polygon`, `path`, and `text`.
+     */
+    drawSvg(options: DrawSvgOptions): this;
     /**
      * Get the raw content stream for advanced operations.
      * Use this when the high-level API doesn't cover your use case.
@@ -413,6 +453,21 @@ export declare class PdfDocumentBuilder {
     private _embeddedFont;
     private _pdfA;
     private _signatureOptions;
+    /**
+     * Sink for non-fatal diagnostics produced during `build()`. Populated by
+     * {@link onWarning}; defaults to undefined so unaware consumers see
+     * pre-diagnostic behaviour unchanged. Fires for every warning in a
+     * single build, not just the first.
+     */
+    private _onWarning;
+    /**
+     * Set via {@link disableFontAutoDiscovery} — opts out of the system-font
+     * auto-embed path in `build()`. Authors who need byte-stable output
+     * across machines (golden tests, reproducible build pipelines) should
+     * enable this so a host-only CJK font doesn't sneak into one run but
+     * not another.
+     */
+    private _disableFontAutoDiscovery;
     /**
      * Add a new blank page to the document.
      *
@@ -434,6 +489,25 @@ export declare class PdfDocumentBuilder {
      * @param fontBytes - Raw .ttf file bytes
      */
     embedFont(fontBytes: Uint8Array): this;
+    /**
+     * Register a callback invoked once per non-fatal diagnostic during
+     * `build()`. Currently raised for:
+     *
+     * - auto-embedded system fonts (`'Auto-embedded system font ...'`)
+     * - non-WinAnsi characters with no covering font (`'...non-WinAnsi character(s) present...'`)
+     *
+     * The callback is synchronous and runs inside `build()`; throwing
+     * from it will abort the build. Return value is ignored.
+     */
+    onWarning(handler: (message: string) => void): this;
+    /**
+     * Opt out of the best-effort system-font auto-discovery that `build()`
+     * performs when the document contains non-WinAnsi characters and no
+     * font was explicitly embedded. Use this to keep output byte-stable
+     * across hosts: one machine may have SimSun installed while another
+     * does not.
+     */
+    disableFontAutoDiscovery(): this;
     /**
      * Enable PDF/A compliance output.
      *