@silurus/ooxml 0.2.0 → 0.3.0

package/dist/pptx.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./pptx-E7x-tlbY.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-9gGaUMeA.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[];
 }
@@ -621,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;
@@ -644,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 {
@@ -655,6 +719,8 @@ export declare namespace pptx {
         RenderSlideOptions,
         renderSlide,
         RenderOptions,
+        autoResize,
+        AutoResizeOptions,
         Presentation,
         Slide,
         SlideElement,
@@ -886,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[];
@@ -1106,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';
 } | {
@@ -182,6 +207,8 @@ export declare interface PictureElement {
         r?: number;
         b?: number;
     };
+    /** a:blip > a:alphaModFix@amt as 0..1. Undefined = fully opaque. */
+    alpha?: number;
 }
 
 /**

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;