@silurus/ooxml 0.24.3 → 0.25.0

package/dist/pptx.cjs

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

package/dist/pptx.mjs

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

package/dist/types/docx.d.ts

@@ -124,6 +124,10 @@ declare interface Document_2 {
     body: BodyElement[];
     headers: HeadersFooters;
     footers: HeadersFooters;
+    /** Theme `<a:fontScheme><a:majorFont><a:latin@typeface>` (heading face). */
+    majorFont?: string;
+    /** Theme `<a:fontScheme><a:minorFont><a:latin@typeface>` (body face). */
+    minorFont?: string;
 }
 export { Document_2 as Document }
 
@@ -132,7 +136,7 @@ export declare class DocxDocument {
     private _pages;
     private _worker;
     private constructor();
-    static load(source: string | ArrayBuffer): Promise<DocxDocument>;
+    static load(source: string | ArrayBuffer, opts?: LoadOptions): Promise<DocxDocument>;
     private _parse;
     destroy(): void;
     get pageCount(): number;
@@ -176,7 +180,7 @@ export declare class DocxViewer {
     private _buildTextLayer;
 }
 
-declare interface DocxViewerOptions extends RenderPageOptions {
+export declare interface DocxViewerOptions extends RenderPageOptions, LoadOptions {
     container?: HTMLElement;
     /**
      * When true, adds a transparent text overlay div over the canvas so the
@@ -276,6 +280,32 @@ declare interface LineSpacing {
     explicit?: boolean;
 }
 
+/** Options for {@link DocxDocument.load}. Re-exports the shared
+ *  `LoadOptions` shape from `@silurus/ooxml-core`. */
+export declare type LoadOptions = LoadOptions_2;
+
+/**
+ * Common load-time options shared by the docx / pptx / xlsx viewer
+ * `load(source, opts)` methods.
+ *
+ * Each viewer narrows or extends this in its package-local `LoadOptions` if
+ * needed, but the names that overlap (currently `useGoogleFonts`) keep the
+ * same shape so application code can pass the same options object.
+ */
+declare interface LoadOptions_2 {
+    /**
+     * Opt in to loading webfont substitutes from Google Fonts
+     * (`fonts.googleapis.com`). Default `false` — the canvas falls back to
+     * locally available fonts.
+     *
+     * When enabled, end-user IP / User-Agent is sent to Google, which may
+     * have privacy / GDPR implications for your application. To avoid the
+     * third-party request, host the substitutes yourself and reference them
+     * via `@font-face` in your application CSS.
+     */
+    useGoogleFonts?: boolean;
+}
+
 declare interface NumberingInfo {
     numId: number;
     level: number;

package/dist/types/index.d.ts

@@ -619,12 +619,18 @@ declare interface Document_2 {
     body: BodyElement[];
     headers: HeadersFooters;
     footers: HeadersFooters;
+    /** Theme `<a:fontScheme><a:majorFont><a:latin@typeface>` (heading face). */
+    majorFont?: string;
+    /** Theme `<a:fontScheme><a:minorFont><a:latin@typeface>` (body face). */
+    minorFont?: string;
 }
 
 export declare namespace docx {
     export {
         DocxDocument,
+        LoadOptions_4 as LoadOptions,
         DocxViewer,
+        DocxViewerOptions,
         autoResize,
         AutoResizeOptions,
         Document_2 as Document,
@@ -643,7 +649,7 @@ declare class DocxDocument {
     private _pages;
     private _worker;
     private constructor();
-    static load(source: string | ArrayBuffer): Promise<DocxDocument>;
+    static load(source: string | ArrayBuffer, opts?: LoadOptions_4): Promise<DocxDocument>;
     private _parse;
     destroy(): void;
     get pageCount(): number;
@@ -687,7 +693,7 @@ declare class DocxViewer {
     private _buildTextLayer;
 }
 
-declare interface DocxViewerOptions extends RenderPageOptions {
+declare interface DocxViewerOptions extends RenderPageOptions, LoadOptions_4 {
     container?: HTMLElement;
     /**
      * When true, adds a transparent text overlay div over the canvas so the
@@ -898,36 +904,40 @@ declare interface LineSpacing {
     explicit?: boolean;
 }
 
-/** 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;
-}
+/** Options for {@link PptxPresentation.load}. Re-exports the shared
+ *  `LoadOptions` shape from `@silurus/ooxml-core`. */
+declare type LoadOptions = LoadOptions_2;
 
-/** Options for {@link XlsxWorkbook.load}. */
+/**
+ * Common load-time options shared by the docx / pptx / xlsx viewer
+ * `load(source, opts)` methods.
+ *
+ * Each viewer narrows or extends this in its package-local `LoadOptions` if
+ * needed, but the names that overlap (currently `useGoogleFonts`) keep the
+ * same shape so application code can pass the same options object.
+ */
 declare interface LoadOptions_2 {
     /**
-     * Opt in to loading Office-font metric substitutes (Carlito for Calibri,
-     * Caladea for Cambria) from Google Fonts (`fonts.googleapis.com`). Without
-     * these the canvas falls back to system Arial / Helvetica which is
-     * noticeably wider per character, so column layouts diverge from Excel.
+     * Opt in to loading webfont substitutes from Google Fonts
+     * (`fonts.googleapis.com`). Default `false` — the canvas falls back to
+     * locally available fonts.
      *
-     * When enabled, end-user IP / User-Agent is sent to Google, which may have
-     * privacy / GDPR implications for your application. Default `false` — host
-     * the substitute webfonts yourself and reference them via `@font-face` in
-     * your application CSS to avoid the third-party request.
+     * When enabled, end-user IP / User-Agent is sent to Google, which may
+     * have privacy / GDPR implications for your application. To avoid the
+     * third-party request, host the substitutes yourself and reference them
+     * via `@font-face` in your application CSS.
      */
     useGoogleFonts?: boolean;
 }
 
+/** Options for {@link XlsxWorkbook.load}. Re-exports the shared
+ *  `LoadOptions` shape from `@silurus/ooxml-core`. */
+declare type LoadOptions_3 = LoadOptions_2;
+
+/** Options for {@link DocxDocument.load}. Re-exports the shared
+ *  `LoadOptions` shape from `@silurus/ooxml-core`. */
+declare type LoadOptions_4 = LoadOptions_2;
+
 declare interface ManualLayout {
     xMode: string;
     yMode: string;
@@ -1236,8 +1246,10 @@ declare class PptxPresentation {
 /**
  * Opinionated single-canvas PPTX viewer.
  *
- * Creates a <canvas> element, appends it to the provided container, and manages
- * slide navigation.
+ * Accepts a caller-supplied `<canvas>` element and wraps it in a positioned
+ * container for the optional text-selection overlay.  The wrapper is inserted
+ * into the canvas's existing parent (reparent), so the canvas stays at its
+ * original position in the DOM.
  *
  * For custom layouts (multi-canvas, thumbnails, scroll view) use PptxPresentation directly.
  */
@@ -1249,7 +1261,7 @@ declare class PptxViewer {
     private readonly opts;
     private currentSlide;
     private handle;
-    constructor(container: HTMLElement, opts?: PptxViewerOptions);
+    constructor(canvas: HTMLCanvasElement, opts?: PptxViewerOptions);
     /** Load a PPTX from URL or ArrayBuffer and render the first slide. */
     load(source: string | ArrayBuffer): Promise<void>;
     /** Navigate to a specific slide (0-indexed). */
@@ -2135,7 +2147,7 @@ declare class XlsxWorkbook {
     private imageCache;
     private rawData;
     constructor();
-    load(source: string | ArrayBuffer, opts?: LoadOptions_2): Promise<void>;
+    load(source: string | ArrayBuffer, opts?: LoadOptions_3): Promise<void>;
     get sheetNames(): string[];
     get sheetCount(): number;
     getWorksheet(sheetIndex: number): Promise<Worksheet>;

package/dist/types/pptx.d.ts

@@ -242,16 +242,28 @@ export declare interface LineBreak {
     type: 'break';
 }
 
-/** Options for {@link PptxPresentation.load}. */
-export declare interface LoadOptions {
+/** Options for {@link PptxPresentation.load}. Re-exports the shared
+ *  `LoadOptions` shape from `@silurus/ooxml-core`. */
+export declare type LoadOptions = LoadOptions_2;
+
+/**
+ * Common load-time options shared by the docx / pptx / xlsx viewer
+ * `load(source, opts)` methods.
+ *
+ * Each viewer narrows or extends this in its package-local `LoadOptions` if
+ * needed, but the names that overlap (currently `useGoogleFonts`) keep the
+ * same shape so application code can pass the same options object.
+ */
+declare interface LoadOptions_2 {
     /**
-     * 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.
+     * Opt in to loading webfont substitutes from Google Fonts
+     * (`fonts.googleapis.com`). Default `false` — the canvas falls back to
+     * locally available fonts.
      *
-     * 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.
+     * When enabled, end-user IP / User-Agent is sent to Google, which may
+     * have privacy / GDPR implications for your application. To avoid the
+     * third-party request, host the substitutes yourself and reference them
+     * via `@font-face` in your application CSS.
      */
     useGoogleFonts?: boolean;
 }
@@ -413,8 +425,10 @@ export declare class PptxPresentation {
 /**
  * Opinionated single-canvas PPTX viewer.
  *
- * Creates a <canvas> element, appends it to the provided container, and manages
- * slide navigation.
+ * Accepts a caller-supplied `<canvas>` element and wraps it in a positioned
+ * container for the optional text-selection overlay.  The wrapper is inserted
+ * into the canvas's existing parent (reparent), so the canvas stays at its
+ * original position in the DOM.
  *
  * For custom layouts (multi-canvas, thumbnails, scroll view) use PptxPresentation directly.
  */
@@ -426,7 +440,7 @@ export declare class PptxViewer {
     private readonly opts;
     private currentSlide;
     private handle;
-    constructor(container: HTMLElement, opts?: PptxViewerOptions);
+    constructor(canvas: HTMLCanvasElement, opts?: PptxViewerOptions);
     /** Load a PPTX from URL or ArrayBuffer and render the first slide. */
     load(source: string | ArrayBuffer): Promise<void>;
     /** Navigate to a specific slide (0-indexed). */

package/dist/types/xlsx.d.ts

@@ -410,18 +410,28 @@ declare interface LegendManualLayout {
     h: number;
 }
 
-/** Options for {@link XlsxWorkbook.load}. */
-declare interface LoadOptions {
+/** Options for {@link XlsxWorkbook.load}. Re-exports the shared
+ *  `LoadOptions` shape from `@silurus/ooxml-core`. */
+declare type LoadOptions = LoadOptions_2;
+
+/**
+ * Common load-time options shared by the docx / pptx / xlsx viewer
+ * `load(source, opts)` methods.
+ *
+ * Each viewer narrows or extends this in its package-local `LoadOptions` if
+ * needed, but the names that overlap (currently `useGoogleFonts`) keep the
+ * same shape so application code can pass the same options object.
+ */
+declare interface LoadOptions_2 {
     /**
-     * Opt in to loading Office-font metric substitutes (Carlito for Calibri,
-     * Caladea for Cambria) from Google Fonts (`fonts.googleapis.com`). Without
-     * these the canvas falls back to system Arial / Helvetica which is
-     * noticeably wider per character, so column layouts diverge from Excel.
+     * Opt in to loading webfont substitutes from Google Fonts
+     * (`fonts.googleapis.com`). Default `false` — the canvas falls back to
+     * locally available fonts.
      *
-     * When enabled, end-user IP / User-Agent is sent to Google, which may have
-     * privacy / GDPR implications for your application. Default `false` — host
-     * the substitute webfonts yourself and reference them via `@font-face` in
-     * your application CSS to avoid the third-party request.
+     * When enabled, end-user IP / User-Agent is sent to Google, which may
+     * have privacy / GDPR implications for your application. To avoid the
+     * third-party request, host the substitutes yourself and reference them
+     * via `@font-face` in your application CSS.
      */
     useGoogleFonts?: boolean;
 }