@epam/ai-dial-attachment-canvas 1.2.0-dev.2 → 1.2.0-dev.6

package/{renderer-module-contract-Cu-GKuPd-Bt0YZuzB.js → renderer-module-contract-D91rkYHH-BtfSKxb4.js}

@@ -10029,7 +10029,7 @@ function tl(e, t, n, r = p, i = 0, a, o, s, c) {
 	});
 }
 //#endregion
-//#region ../../node_modules/@silurus/ooxml/dist/renderer-module-contract-Cu-GKuPd.js
+//#region ../../node_modules/@silurus/ooxml/dist/renderer-module-contract-D91rkYHH.js
 var nl = "ooxml-worker-renderer-module/v1", rl = /* @__PURE__ */ new WeakMap();
 function il(e, t) {
 	if (e === "math") {

package/test-setup.d.ts

@@ -1,2 +1,11 @@
-export {};
+/**
+ * Delivers a synthetic resize entry to every mock `ResizeObserver` instance
+ * currently observing `target`, mirroring how a real observer fans a single
+ * size change out to each of its observers.
+ */
+export declare const deliverResizeObserverEntry: (target: Element, contentRect?: Partial<DOMRectReadOnly>) => void;
+/** Clears tracked mock `ResizeObserver` instances so they do not leak between test files. */
+export declare const resetResizeObserverMock: () => void;
+/** Whether any live mock `ResizeObserver` instance is currently observing `target`. */
+export declare const isElementObservedByResizeObserver: (target: Element) => boolean;
 //# sourceMappingURL=test-setup.d.ts.map

package/test-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":""}
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAwEA;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,QAAQ,OAAO,EACf,cAAa,OAAO,CAAC,eAAe,CAAM,SAM3C,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,uBAAuB,YAEnC,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,iCAAiC,GAAI,QAAQ,OAAO,KAAG,OACW,CAAC"}

package/types/attachment-canvas.d.ts

@@ -38,4 +38,21 @@ export declare enum AttachmentErrorType {
     /** The file request failed with HTTP `403` — the user lacks permission to access it. */
     Forbidden = "forbidden"
 }
+/**
+ * Outcome of one `OoxmlHighlightSurface.navigate` call.
+ *
+ * Declared here rather than alongside `OoxmlHighlightSurface` in
+ * `utils/ooxml-highlight-surfaces.ts` so `OoxmlContent.tsx` can compare
+ * against it as a real value without a static import pulling that
+ * dynamically-loaded module into the eager entry closure — see
+ * `tests/package-boundary/bundle-budgets.spec.ts`.
+ */
+export declare enum OoxmlNavigationOutcome {
+    /** A scroll (or page/slide/sheet change) was applied for this location. */
+    Navigated = "navigated",
+    /** A newer `navigate` call started before this one could apply its scroll, or the surface was disposed meanwhile. */
+    Superseded = "superseded",
+    /** The location could not be resolved to a page, slide, sheet, or cell at all. */
+    Unresolved = "unresolved"
+}
 //# sourceMappingURL=attachment-canvas.d.ts.map

package/types/attachment-canvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-canvas.d.ts","sourceRoot":"","sources":["../../src/types/attachment-canvas.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,oBAAY,qBAAqB;IAC/B,SAAS,eAAe;IACxB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,aAAa,mBAAmB;IAChC,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,MAAM,YAAY;IAClB,WAAW,gBAAgB;IAC3B,KAAK,UAAU;CAChB;AAED,mFAAmF;AACnF,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,GAAG,QAAQ;CACZ;AAED,iGAAiG;AACjG,oBAAY,kBAAkB;IAC5B,2FAA2F;IAC3F,aAAa,kBAAkB;IAC/B,iEAAiE;IACjE,aAAa,kBAAkB;IAC/B,4EAA4E;IAC5E,aAAa,kBAAkB;CAChC;AAED,iEAAiE;AACjE,oBAAY,mBAAmB;IAC7B,8EAA8E;IAC9E,UAAU,gBAAgB;IAC1B,wFAAwF;IACxF,SAAS,cAAc;CACxB"}
+{"version":3,"file":"attachment-canvas.d.ts","sourceRoot":"","sources":["../../src/types/attachment-canvas.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,oBAAY,qBAAqB;IAC/B,SAAS,eAAe;IACxB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,aAAa,mBAAmB;IAChC,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,MAAM,YAAY;IAClB,WAAW,gBAAgB;IAC3B,KAAK,UAAU;CAChB;AAED,mFAAmF;AACnF,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,GAAG,QAAQ;CACZ;AAED,iGAAiG;AACjG,oBAAY,kBAAkB;IAC5B,2FAA2F;IAC3F,aAAa,kBAAkB;IAC/B,iEAAiE;IACjE,aAAa,kBAAkB;IAC/B,4EAA4E;IAC5E,aAAa,kBAAkB;CAChC;AAED,iEAAiE;AACjE,oBAAY,mBAAmB;IAC7B,8EAA8E;IAC9E,UAAU,gBAAgB;IAC1B,wFAAwF;IACxF,SAAS,cAAc;CACxB;AAED;;;;;;;;GAQG;AACH,oBAAY,sBAAsB;IAChC,2EAA2E;IAC3E,SAAS,cAAc;IACvB,qHAAqH;IACrH,UAAU,eAAe;IACzB,kFAAkF;IAClF,UAAU,eAAe;CAC1B"}

package/utils/ooxml-highlight-geometry.d.ts

@@ -60,13 +60,37 @@ export interface OoxmlDocxPageRuns {
     pageIndex: number;
     /** The page's runs, in layout order. */
     runs: readonly DocxTextRunInfo[];
+    /**
+     * The page's box in the same reference-width CSS pixel space the runs were
+     * collected at — the page's scale-1 size, from `docxPageSizePx`. Used to
+     * normalise resolved rectangles into fractions of the page box.
+     */
+    pageBox: OoxmlSurfaceSize;
 }
-/** Rectangles resolved on one page, in that page's own CSS pixel space. */
+/**
+ * A resolved DOCX highlight rectangle, expressed as fractions of its page
+ * box rather than CSS pixels — each of `left`, `top`, `width`, and `height`
+ * is a ratio (0–1, barring a range that runs off the page) of the page's
+ * width or height. Kept distinct from `OoxmlHighlightRect` (the PPTX/XLSX
+ * absolute-pixel type) so their scale-free and scale-bound contracts cannot
+ * be confused at the type level; see `resolveDocxRects`.
+ */
+export interface OoxmlDocxNormalizedRect {
+    /** Left edge as a fraction of the page's width. */
+    left: number;
+    /** Top edge as a fraction of the page's height. */
+    top: number;
+    /** Width as a fraction of the page's width. */
+    width: number;
+    /** Height as a fraction of the page's height. */
+    height: number;
+}
+/** Rectangles resolved on one page, as fractions of that page's box. */
 export interface OoxmlDocxPageRects {
     /** 0-based page index the rectangles belong to. */
     pageIndex: number;
     /** Rectangles covering the part of the range that falls on this page. */
-    rects: OoxmlHighlightRect[];
+    rects: OoxmlDocxNormalizedRect[];
 }
 /** Inputs `resolveDocxRects` needs to place one DOCX range. */
 export interface OoxmlDocxResolveOptions {
@@ -119,6 +143,56 @@ export declare const pptxSlideSizePx: (slideWidthEmu: number, slideHeightEmu: nu
  * here means such an upgrade breaks one function and one test.
  */
 export declare const resolveSurfaceOffset: ({ index, sizeAt, hostClientWidth, layout, }: OoxmlSurfaceOffsetOptions) => OoxmlSurfaceOffset;
+/** The scroll host's current geometry, as read directly off the live element. */
+export interface OoxmlScrollHostBox {
+    /** Height of the host's visible (scrollable) area, in CSS pixels. */
+    clientHeight: number;
+    /** Width of the host's visible (scrollable) area, in CSS pixels. */
+    clientWidth: number;
+    /** Total scrollable height of the host's content, in CSS pixels. */
+    scrollHeight: number;
+    /** Total scrollable width of the host's content, in CSS pixels. */
+    scrollWidth: number;
+    /** The host's current horizontal scroll position, in CSS pixels. */
+    scrollLeft: number;
+}
+/** Inputs `resolveDocxScrollTarget` needs to place one resolved DOCX rectangle in the scroll host. */
+export interface OoxmlDocxScrollTargetOptions {
+    /** 0-based index of the page the rectangle was resolved on. */
+    pageIndex: number;
+    /** The resolved rectangle, as a fraction of its page's box (see `OoxmlDocxNormalizedRect`). */
+    rect: OoxmlDocxNormalizedRect;
+    /** Size, in CSS pixels at the current scale, of the page/slide at an index. */
+    sizeAt: (index: number) => OoxmlSurfaceSize;
+    /** The scroll host's current geometry. */
+    host: OoxmlScrollHostBox;
+    /** Scroll-layout options passed to the viewer. */
+    layout?: OoxmlScrollLayout;
+}
+/**
+ * Absolute scroll position, in the scroll host's own coordinate space, that
+ * brings a resolved DOCX rectangle into view.
+ *
+ * Composes `resolveSurfaceOffset` — which already owns the page-stacking
+ * arithmetic — with the rectangle's page-box fraction and the page's live
+ * pixel size, so a vendor layout change still breaks exactly one function and
+ * one test (see the version-coupling note on `resolveSurfaceOffset`).
+ *
+ * The result is physical canvas-coordinate geometry, the same space
+ * `resolveSurfaceOffset` and the overlay already use, and it SHALL NOT be
+ * converted to logical (start/end) properties — see the physical-geometry
+ * requirement in `office-annotation-highlighting`.
+ *
+ * `top` places the rectangle's start (its top edge) `DOCX_NAVIGATION_LEAD_FRACTION`
+ * of the host's visible height below the visible top, then clamps to
+ * `[0, scrollHeight - clientHeight]` so a passage near the document's start or
+ * end scrolls as far as it can rather than not at all. `left` is left at the
+ * host's current `scrollLeft` when the rectangle already falls inside the
+ * host's horizontal viewport — which keeps a fit-width preview at
+ * `scrollLeft: 0` — and is otherwise shifted by the smallest amount that
+ * brings the rectangle's left edge into view.
+ */
+export declare const resolveDocxScrollTarget: ({ pageIndex, rect, sizeAt, host, layout, }: OoxmlDocxScrollTargetOptions) => OoxmlSurfaceOffset;
 /**
  * Merges rectangles that sit on one visual line and touch or overlap.
  *
@@ -127,7 +201,17 @@ export declare const resolveSurfaceOffset: ({ index, sizeAt, hostClientWidth, la
  */
 export declare const mergeSameLineRects: (rects: readonly OoxmlHighlightRect[]) => OoxmlHighlightRect[];
 /**
- * Rectangles covering one DOCX range, grouped per page.
+ * Rectangles covering one DOCX range, grouped per page, as fractions of each
+ * page's box.
+ *
+ * Runs arrive already measured at a fixed reference width (the page's
+ * scale-1 CSS size — see `createDocxHighlightSurface`), so their `x`/`y`/`w`/`h`
+ * and the same-line merge tolerances are all in that one reference-width pixel
+ * space. Dividing the merged pixel rectangle by the page's reference box turns
+ * it into a fraction that is the same number at every render scale — the
+ * representation `@silurus/ooxml`'s own `buildDocxHighlightLayer` percent-of-page
+ * highlight layer uses, and the only way to avoid re-collecting runs on every
+ * zoom (root cause 1 of the drift this resolver used to produce).
  *
  * Returns an empty array whenever the range cannot be resolved with confidence —
  * no matching run, a resolved text that disagrees with the selector's own

package/utils/ooxml-highlight-geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ooxml-highlight-geometry.d.ts","sourceRoot":"","sources":["../../src/utils/ooxml-highlight-geometry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ooxml-highlight-geometry.d.ts","sourceRoot":"","sources":["../../src/utils/ooxml-highlight-geometry.ts"],"names":[],"mappings":"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"}

package/utils/ooxml-highlight-surfaces.d.ts

@@ -1,8 +1,10 @@
-import { DocxDocument } from '@silurus/ooxml/docx';
+import { DocxTextRunInfo } from '@silurus/ooxml/docx';
 import { PptxPresentation } from '@silurus/ooxml/pptx';
 import { XlsxViewer } from '@silurus/ooxml/xlsx';
 import { OoxmlHighlight, OoxmlHighlightLocation } from '../models/attachment-canvas';
+import { OoxmlNavigationOutcome } from '../types/attachment-canvas';
 import { OoxmlHighlightRect } from './ooxml-highlight-geometry';
+export { OoxmlNavigationOutcome };
 /**
  * One rectangle to draw, tagged with the highlight it belongs to. Kept in
  * this dynamically-loaded module (not `OoxmlContent.tsx`) alongside the
@@ -24,14 +26,39 @@ export interface TaggedHighlightRect extends OoxmlHighlightRect {
 export interface OoxmlHighlightSurface {
     /** Rectangles for every highlight that currently resolves. */
     measure(highlights: readonly OoxmlHighlight[]): Promise<TaggedHighlightRect[]>;
-    /** Brings one cited location into view, whether or not it resolves to a rectangle. */
-    navigate(location: OoxmlHighlightLocation): Promise<void>;
+    /**
+     * Brings one cited location into view, whether or not it resolves to a
+     * rectangle. See `OoxmlNavigationOutcome` for what each resolved value means.
+     */
+    navigate(location: OoxmlHighlightLocation): Promise<OoxmlNavigationOutcome>;
 }
-/** Creates the DOCX highlight surface over an already-loaded document. */
-export declare const createDocxHighlightSurface: (container: HTMLElement, docxDocument: DocxDocument, viewer: {
+/**
+ * The subset of `DocxDocument` the DOCX highlight surface reads, kept as a
+ * narrow structural type rather than the concrete vendor class so a test
+ * double only needs to implement what is actually used.
+ */
+interface DocxHighlightDocument {
+    /** Number of pages in the current layout. Only authoritative once `waitUntilLayoutComplete` resolves. */
+    readonly pageCount: number;
+    /** Page size in points, at scale 1. */
+    pageSize(pageIndex: number): {
+        widthPt: number;
+        heightPt: number;
+    };
+    /** Collects one page's text runs at the given reference width. */
+    collectPageRuns(pageIndex: number, opts: {
+        width: number;
+    }): Promise<DocxTextRunInfo[]>;
+    /** Resolves once layout has finished publishing pages; rejects if layout failed. */
+    waitUntilLayoutComplete(): Promise<void>;
+}
+/** The subset of `DocxScrollViewer` the DOCX highlight surface reads. */
+interface DocxHighlightViewer {
     getScale(): number;
     scrollToPage(index: number): void;
-}, isDisposed: () => boolean) => OoxmlHighlightSurface;
+}
+/** Creates the DOCX highlight surface over an already-loaded document. */
+export declare const createDocxHighlightSurface: (container: HTMLElement, docxDocument: DocxHighlightDocument, viewer: DocxHighlightViewer, isDisposed: () => boolean) => OoxmlHighlightSurface;
 /** Creates the PPTX highlight surface over an already-loaded presentation. */
 export declare const createPptxHighlightSurface: (container: HTMLElement, presentation: PptxPresentation, viewer: {
     getScale(): number;

package/utils/ooxml-highlight-surfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ooxml-highlight-surfaces.d.ts","sourceRoot":"","sources":["../../src/utils/ooxml-highlight-surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAEV,cAAc,EACd,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAIL,KAAK,kBAAkB,EAQxB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,OAAO,CACL,UAAU,EAAE,SAAS,cAAc,EAAE,GACpC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAClC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAsDD,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,GACrC,WAAW,WAAW,EACtB,cAAc,YAAY,EAC1B,QAAQ;IAAE,QAAQ,IAAI,MAAM,CAAC;IAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACjE,YAAY,MAAM,OAAO,KACxB,qBA0HF,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,GACrC,WAAW,WAAW,EACtB,cAAc,gBAAgB,EAC9B,QAAQ;IAAE,QAAQ,IAAI,MAAM,CAAC;IAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAClE,YAAY,MAAM,OAAO,KACxB,qBA8DF,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,GACrC,WAAW,WAAW,EACtB,QAAQ,UAAU,EAClB,YAAY,MAAM,OAAO,KACxB,qBAuDD,CAAC"}
+{"version":3,"file":"ooxml-highlight-surfaces.d.ts","sourceRoot":"","sources":["../../src/utils/ooxml-highlight-surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAEV,cAAc,EACd,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAIL,KAAK,kBAAkB,EASxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,OAAO,CACL,UAAU,EAAE,SAAS,cAAc,EAAE,GACpC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC7E;AAsDD;;;;GAIG;AACH,UAAU,qBAAqB;IAC7B,yGAAyG;IACzG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,kEAAkE;IAClE,eAAe,CACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC9B,oFAAoF;IACpF,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,yEAAyE;AACzE,UAAU,mBAAmB;IAC3B,QAAQ,IAAI,MAAM,CAAC;IACnB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,GACrC,WAAW,WAAW,EACtB,cAAc,qBAAqB,EACnC,QAAQ,mBAAmB,EAC3B,YAAY,MAAM,OAAO,KACxB,qBA0NF,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,GACrC,WAAW,WAAW,EACtB,cAAc,gBAAgB,EAC9B,QAAQ;IAAE,QAAQ,IAAI,MAAM,CAAC;IAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAClE,YAAY,MAAM,OAAO,KACxB,qBAiEF,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,GACrC,WAAW,WAAW,EACtB,QAAQ,UAAU,EAClB,YAAY,MAAM,OAAO,KACxB,qBA0DD,CAAC"}

package/{visible-index-DPoQYSDt-9lRc-2Ik.js → visible-index-BgiHEc1z-BOzE9X5U.js}

@@ -1,6 +1,6 @@
-import { $ as e, $t as t } from "./renderer-module-contract-Cu-GKuPd-Bt0YZuzB.js";
-import { En as n, Fn as r, In as i, Ln as a, en as o, fn as s } from "./bounded-raw-part-cache-BfbSxRIL-DD07NKh9.js";
-//#region ../../node_modules/@silurus/ooxml/dist/resource-measurement-CclArDRs.js
+import { $ as e, $t as t } from "./renderer-module-contract-D91rkYHH-BtfSKxb4.js";
+import { Bt as n, Dt as r, In as i, Vn as a, Xt as o, pt as s } from "./bounded-raw-part-cache-Cg1BsSZQ-DN8p45IK.js";
+//#region ../../node_modules/@silurus/ooxml/dist/resource-measurement-CJsgolre.js
 function c(e, t) {
 	return t ? `${e}|duo:${t.clr1}:${t.clr2}` : e;
 }
@@ -13,16 +13,16 @@ async function u(u, d, f, p, m = {}) {
 		...v,
 		targetWidthPx: void 0,
 		targetHeightPx: void 0
-	} : v, b = f ? i(p, l) : void 0, x = await r(u, d, p, y);
+	} : v, b = f ? r(p, l) : void 0, x = await i(u, d, p, y);
 	if (!f || !x) return x;
-	let S = await s(u, d, p, y, b, x), C = a(Number(x.width), Number(x.height), _.targetWidthPx, _.targetHeightPx), w = C ? `|resize:${C.resizeWidth}x${C.resizeHeight}` : "";
+	let S = await o(u, d, p, y, b, x), C = a(Number(x.width), Number(x.height), _.targetWidthPx, _.targetHeightPx), w = C ? `|resize:${C.resizeWidth}x${C.resizeHeight}` : "";
 	return n(l, `${c(S, f)}${w}${g ? "|strict" : ""}`, p, async () => {
 		let { w: t, h: n } = e(x);
 		if (t <= 0 || n <= 0) return {
 			bitmap: g ? null : x,
 			owned: !1
 		};
-		let r = await o(x, f, {
+		let r = await s(x, f, {
 			width: t,
 			height: n,
 			offscreenFactory: h,
@@ -143,7 +143,7 @@ function g(e, t = 2 ** 53 - 1, n = !1) {
 	};
 }
 //#endregion
-//#region ../../node_modules/@silurus/ooxml/dist/visible-index-DPoQYSDt.js
+//#region ../../node_modules/@silurus/ooxml/dist/visible-index-BgiHEc1z.js
 function _(e, t, n, r) {
 	for (let i = e + t; i >= 0 && i < r; i += t) if (!n(i)) return i;
 	return e;