@silurus/ooxml 0.1.0 → 0.3.0

package/dist/pptx.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./pptx-DrZBtOP1.cjs`);exports.PptxPresentation=e.r,exports.PptxViewer=e.n,exports.renderSlide=e.i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./autoResize-ggn4hzd8.cjs`),t=require(`./pptx-D-l5vpjt.cjs`);exports.PptxPresentation=t.r,exports.PptxViewer=t.n,exports.autoResize=e.t,exports.renderSlide=t.i;

package/dist/pptx.mjs

@@ -1,2 +1,3 @@
-import { i as e, n as t, r as n } from "./pptx-D3vSvVQ6.js";
-export { n as PptxPresentation, t as PptxViewer, e as renderSlide };
+import { t as e } from "./autoResize-U2-IRmNE.js";
+import { i as t, n, r } from "./pptx-BTI_RpCN.js";
+export { r as PptxPresentation, n as PptxViewer, e as autoResize, t as renderSlide };

package/dist/types/docx.d.ts

@@ -1,3 +1,28 @@
+/**
+ * Observe an element's size and invoke a render callback, coalescing bursts to
+ * one call per animation frame and serializing overlapping async renders.
+ *
+ * Framework-agnostic: call from any mount/setup hook and invoke the returned
+ * disposer in the corresponding teardown hook.
+ *
+ * @example
+ * const detach = autoResize(
+ *   (width) => pres.renderSlide(canvas, 0, { width }),
+ *   canvas,
+ * );
+ * // later
+ * detach();
+ */
+export declare function autoResize(render: (width: number, height: number) => void | Promise<void>, element: Element, opts?: AutoResizeOptions): () => void;
+
+export declare interface AutoResizeOptions {
+    /**
+     * Skip rendering while `document.hidden` is true and fire once with the latest
+     * observed size when the tab becomes visible again. Default: true.
+     */
+    pauseWhenHidden?: boolean;
+}
+
 declare type BodyElement = {
     type: 'paragraph';
 } & DocParagraph | {
@@ -53,7 +78,9 @@ export declare type DocRun = {
     breakType: 'line' | 'page' | 'column';
 } | {
     type: 'field';
-} & FieldRun;
+} & FieldRun | {
+    type: 'shape';
+} & ShapeRun;
 
 declare interface DocTable {
     colWidths: number[];
@@ -142,6 +169,13 @@ declare interface FieldRun {
     highlight?: string | null;
 }
 
+declare interface GradientStop {
+    /** 0.0–1.0 */
+    position: number;
+    /** hex 6-char */
+    color: string;
+}
+
 declare interface HeaderFooter {
     body: BodyElement[];
 }
@@ -227,6 +261,32 @@ declare interface ParagraphBorders {
     between: ParaBorderEdge | null;
 }
 
+declare type PathCmd = {
+    cmd: 'moveTo';
+    x: number;
+    y: number;
+} | {
+    cmd: 'lineTo';
+    x: number;
+    y: number;
+} | {
+    cmd: 'cubicBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+} | {
+    cmd: 'arcTo';
+    wr: number;
+    hr: number;
+    stAng: number;
+    swAng: number;
+} | {
+    cmd: 'close';
+};
+
 export declare interface RenderPageOptions {
     /** Canvas CSS width in px; height is auto-computed from page aspect ratio */
     width?: number;
@@ -247,6 +307,38 @@ export declare interface SectionProps {
     evenAndOddHeaders: boolean;
 }
 
+declare type ShapeFill = {
+    fillType: 'solid';
+    color: string;
+} | {
+    fillType: 'gradient';
+    stops: GradientStop[];
+    angle: number;
+    gradType: string;
+};
+
+declare interface ShapeRun {
+    widthPt: number;
+    heightPt: number;
+    /** X offset in pt */
+    anchorXPt: number;
+    /** Y offset in pt */
+    anchorYPt: number;
+    anchorXFromMargin: boolean;
+    anchorYFromPara: boolean;
+    /** Draw behind text when true (wp:anchor behindDoc="1"). */
+    behindDoc?: boolean;
+    /** Document-order index within a group; lower values render first. */
+    zOrder: number;
+    /** Normalized [0,1] custom-geometry sub-paths */
+    subpaths: PathCmd[][];
+    fill: ShapeFill | null;
+    stroke: string | null;
+    strokeWidth?: number;
+    rotation?: number;
+    wrapMode?: string | null;
+}
+
 declare interface TableBorders {
     top: BorderSpec | null;
     bottom: BorderSpec | null;

package/dist/types/index.d.ts

@@ -7,6 +7,31 @@ declare interface ArrowEnd {
     len: string;
 }
 
+/**
+ * Observe an element's size and invoke a render callback, coalescing bursts to
+ * one call per animation frame and serializing overlapping async renders.
+ *
+ * Framework-agnostic: call from any mount/setup hook and invoke the returned
+ * disposer in the corresponding teardown hook.
+ *
+ * @example
+ * const detach = autoResize(
+ *   (width) => pres.renderSlide(canvas, 0, { width }),
+ *   canvas,
+ * );
+ * // later
+ * detach();
+ */
+declare function autoResize(render: (width: number, height: number) => void | Promise<void>, element: Element, opts?: AutoResizeOptions): () => void;
+
+declare interface AutoResizeOptions {
+    /**
+     * Skip rendering while `document.hidden` is true and fire once with the latest
+     * observed size when the tab becomes visible again. Default: true.
+     */
+    pauseWhenHidden?: boolean;
+}
+
 declare type BodyElement = {
     type: 'paragraph';
 } & DocParagraph | {
@@ -282,7 +307,9 @@ declare type DocRun = {
     breakType: 'line' | 'page' | 'column';
 } | {
     type: 'field';
-} & FieldRun;
+} & FieldRun | {
+    type: 'shape';
+} & ShapeRun;
 
 declare interface DocTable {
     colWidths: number[];
@@ -321,6 +348,8 @@ export declare namespace docx {
     export {
         DocxDocument,
         DocxViewer,
+        autoResize,
+        AutoResizeOptions,
         Document_2 as Document,
         SectionProps,
         DocParagraph,
@@ -422,6 +451,13 @@ declare interface GradientStop {
     color: string;
 }
 
+declare interface GradientStop_2 {
+    /** 0.0–1.0 */
+    position: number;
+    /** hex 6-char */
+    color: string;
+}
+
 declare interface HeaderFooter {
     body: BodyElement[];
 }
@@ -508,6 +544,20 @@ declare interface LineSpacing {
     rule: 'auto' | 'exact' | 'atLeast';
 }
 
+/** Options for {@link PptxPresentation.load}. */
+declare interface LoadOptions {
+    /**
+     * Opt in to loading theme-declared webfonts from Google Fonts
+     * (`fonts.googleapis.com`). When enabled, end-user IP/User-Agent is sent to
+     * Google, which may have privacy/GDPR implications for your application.
+     *
+     * Default: `false` — the canvas falls back to locally available fonts. Host
+     * the required webfonts yourself and reference them via `@font-face` in your
+     * application CSS to match the document's theme fonts.
+     */
+    useGoogleFonts?: boolean;
+}
+
 declare interface MergeCell {
     top: number;
     left: number;
@@ -607,6 +657,32 @@ declare type PathCmd = {
     cmd: 'close';
 };
 
+declare type PathCmd_2 = {
+    cmd: 'moveTo';
+    x: number;
+    y: number;
+} | {
+    cmd: 'lineTo';
+    x: number;
+    y: number;
+} | {
+    cmd: 'cubicBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+} | {
+    cmd: 'arcTo';
+    wr: number;
+    hr: number;
+    stAng: number;
+    swAng: number;
+} | {
+    cmd: 'close';
+};
+
 declare interface PictureElement {
     type: 'picture';
     x: number;
@@ -630,6 +706,8 @@ declare interface PictureElement {
         r?: number;
         b?: number;
     };
+    /** a:blip > a:alphaModFix@amt as 0..1. Undefined = fully opaque. */
+    alpha?: number;
 }
 
 export declare namespace pptx {
@@ -637,9 +715,12 @@ export declare namespace pptx {
         PptxViewer,
         PptxViewerOptions,
         PptxPresentation,
+        LoadOptions,
         RenderSlideOptions,
         renderSlide,
         RenderOptions,
+        autoResize,
+        AutoResizeOptions,
         Presentation,
         Slide,
         SlideElement,
@@ -681,7 +762,7 @@ declare class PptxPresentation {
     private _workerReadyCallbacks;
     private constructor();
     /** Parse a PPTX from URL or ArrayBuffer. */
-    static load(source: string | ArrayBuffer): Promise<PptxPresentation>;
+    static load(source: string | ArrayBuffer, opts?: LoadOptions): Promise<PptxPresentation>;
     private _waitForWorker;
     private _parse;
     /** Total number of slides in the loaded presentation. */
@@ -730,6 +811,11 @@ declare interface PptxViewerOptions extends RenderOptions {
     onSlideChange?: (index: number, total: number) => void;
     /** Called on parse or render errors */
     onError?: (err: Error) => void;
+    /**
+     * Opt in to loading theme-declared webfonts from Google Fonts. Off by
+     * default — see {@link PptxPresentation.load} for privacy implications.
+     */
+    useGoogleFonts?: boolean;
 }
 
 declare interface Presentation {
@@ -866,6 +952,38 @@ declare interface ShapeElement {
     shadow: Shadow | null;
 }
 
+declare type ShapeFill = {
+    fillType: 'solid';
+    color: string;
+} | {
+    fillType: 'gradient';
+    stops: GradientStop_2[];
+    angle: number;
+    gradType: string;
+};
+
+declare interface ShapeRun {
+    widthPt: number;
+    heightPt: number;
+    /** X offset in pt */
+    anchorXPt: number;
+    /** Y offset in pt */
+    anchorYPt: number;
+    anchorXFromMargin: boolean;
+    anchorYFromPara: boolean;
+    /** Draw behind text when true (wp:anchor behindDoc="1"). */
+    behindDoc?: boolean;
+    /** Document-order index within a group; lower values render first. */
+    zOrder: number;
+    /** Normalized [0,1] custom-geometry sub-paths */
+    subpaths: PathCmd_2[][];
+    fill: ShapeFill | null;
+    stroke: string | null;
+    strokeWidth?: number;
+    rotation?: number;
+    wrapMode?: string | null;
+}
+
 declare interface SharedString {
     text: string;
     runs?: Run[];
@@ -1086,6 +1204,8 @@ export declare namespace xlsx {
         XlsxWorkbook,
         XlsxViewer,
         XlsxViewerOptions,
+        autoResize,
+        AutoResizeOptions,
         Workbook,
         SheetMeta,
         Worksheet,

package/dist/types/pptx.d.ts

@@ -7,6 +7,31 @@ declare interface ArrowEnd {
     len: string;
 }
 
+/**
+ * Observe an element's size and invoke a render callback, coalescing bursts to
+ * one call per animation frame and serializing overlapping async renders.
+ *
+ * Framework-agnostic: call from any mount/setup hook and invoke the returned
+ * disposer in the corresponding teardown hook.
+ *
+ * @example
+ * const detach = autoResize(
+ *   (width) => pres.renderSlide(canvas, 0, { width }),
+ *   canvas,
+ * );
+ * // later
+ * detach();
+ */
+export declare function autoResize(render: (width: number, height: number) => void | Promise<void>, element: Element, opts?: AutoResizeOptions): () => void;
+
+export declare interface AutoResizeOptions {
+    /**
+     * Skip rendering while `document.hidden` is true and fire once with the latest
+     * observed size when the tab becomes visible again. Default: true.
+     */
+    pauseWhenHidden?: boolean;
+}
+
 declare type Bullet = {
     type: 'none';
 } | {
@@ -90,6 +115,20 @@ export declare interface LineBreak {
     type: 'break';
 }
 
+/** Options for {@link PptxPresentation.load}. */
+export declare interface LoadOptions {
+    /**
+     * Opt in to loading theme-declared webfonts from Google Fonts
+     * (`fonts.googleapis.com`). When enabled, end-user IP/User-Agent is sent to
+     * Google, which may have privacy/GDPR implications for your application.
+     *
+     * Default: `false` — the canvas falls back to locally available fonts. Host
+     * the required webfonts yourself and reference them via `@font-face` in your
+     * application CSS to match the document's theme fonts.
+     */
+    useGoogleFonts?: boolean;
+}
+
 export declare interface NoFill {
     fillType: 'none';
 }
@@ -168,6 +207,8 @@ export declare interface PictureElement {
         r?: number;
         b?: number;
     };
+    /** a:blip > a:alphaModFix@amt as 0..1. Undefined = fully opaque. */
+    alpha?: number;
 }
 
 /**
@@ -194,7 +235,7 @@ export declare class PptxPresentation {
     private _workerReadyCallbacks;
     private constructor();
     /** Parse a PPTX from URL or ArrayBuffer. */
-    static load(source: string | ArrayBuffer): Promise<PptxPresentation>;
+    static load(source: string | ArrayBuffer, opts?: LoadOptions): Promise<PptxPresentation>;
     private _waitForWorker;
     private _parse;
     /** Total number of slides in the loaded presentation. */
@@ -243,6 +284,11 @@ export declare interface PptxViewerOptions extends RenderOptions {
     onSlideChange?: (index: number, total: number) => void;
     /** Called on parse or render errors */
     onError?: (err: Error) => void;
+    /**
+     * Opt in to loading theme-declared webfonts from Google Fonts. Off by
+     * default — see {@link PptxPresentation.load} for privacy implications.
+     */
+    useGoogleFonts?: boolean;
 }
 
 export declare interface Presentation {

package/dist/types/xlsx.d.ts

@@ -1,3 +1,28 @@
+/**
+ * Observe an element's size and invoke a render callback, coalescing bursts to
+ * one call per animation frame and serializing overlapping async renders.
+ *
+ * Framework-agnostic: call from any mount/setup hook and invoke the returned
+ * disposer in the corresponding teardown hook.
+ *
+ * @example
+ * const detach = autoResize(
+ *   (width) => pres.renderSlide(canvas, 0, { width }),
+ *   canvas,
+ * );
+ * // later
+ * detach();
+ */
+export declare function autoResize(render: (width: number, height: number) => void | Promise<void>, element: Element, opts?: AutoResizeOptions): () => void;
+
+export declare interface AutoResizeOptions {
+    /**
+     * Skip rendering while `document.hidden` is true and fire once with the latest
+     * observed size when the tab becomes visible again. Default: true.
+     */
+    pauseWhenHidden?: boolean;
+}
+
 export declare interface Border {
     left: BorderEdge | null;
     right: BorderEdge | null;