@epam/ai-dial-attachment-canvas 1.2.0-dev.1 → 1.2.0-dev.102

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-attachment-canvas",
   "description": "Canvas viewer for rendering attachment content — images, PDFs, Office documents, CSV, JSON, markdown, and plain text",
-  "version": "1.2.0-dev.1",
+  "version": "1.2.0-dev.102",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -17,11 +17,11 @@
     }
   },
   "dependencies": {
-    "@silurus/ooxml": "^0.86.1",
+    "@silurus/ooxml": "^0.87.0",
     "@tabler/icons-react": "^3.44.0",
     "react-json-view-lite": "^2.5.0",
     "react-syntax-highlighter": "^16.1.1",
-    "@epam/ai-dial-react-pdf-highlighter": "0.2.0",
+    "@epam/ai-dial-react-pdf-highlighter": "0.3.0-dev.1",
     "@epam/ai-dial-shared": "0.48.0",
     "@epam/ai-dial-visualizer-connector": "0.48.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",
@@ -29,11 +29,11 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@modelcontextprotocol/ext-apps": "1.7.5",
     "pdfjs-dist": "^5.4.149",
-    "@epam/ai-dial-sidebar": "1.2.0-dev.1"
+    "@epam/ai-dial-sidebar": "1.2.0-dev.102"
   },
   "peerDependencies": {
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.1",
-    "@epam/ai-dial-ui-kit": "^0.14.2",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.102",
+    "@epam/ai-dial-ui-kit": "^0.15.0-dev.12",
     "react": "^19.2.8"
   },
   "repository": {

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

@@ -11,11 +11,12 @@ export declare enum AttachmentContentType {
     Code = "code",
     Html = "html",
     Visualizer = "visualizer",
+    GroupedVisualizer = "grouped_visualizer",
     McpApp = "mcp_app",
     Unsupported = "unsupported",
     Error = "error"
 }
-/** Supported document formats rendered by the bundled `@silurus/ooxml` runtime. */
+/** Supported document formats rendered by the installed `@silurus/ooxml` runtime. */
 export declare enum OoxmlFileType {
     Docx = "docx",
     Xlsx = "xlsx",
@@ -28,6 +29,10 @@ export declare enum OoxmlHighlightKind {
     DocxTextRange = "docxTextRange",
     /** A character range inside a single PPTX shape on one slide. */
     PptxTextRange = "pptxTextRange",
+    /** A complete DOCX table row identified by its cell text. */
+    DocxTableRow = "docxTableRow",
+    /** A complete PPTX table row identified by its cell text on one slide. */
+    PptxTableRow = "pptxTableRow",
     /** One cell, or a contiguous same-row cell range, on a named XLSX sheet. */
     XlsxCellRange = "xlsxCellRange"
 }
@@ -38,4 +43,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,iBAAiB,uBAAuB;IACxC,MAAM,YAAY;IAClB,WAAW,gBAAgB;IAC3B,KAAK,UAAU;CAChB;AAED,qFAAqF;AACrF,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,6DAA6D;IAC7D,YAAY,iBAAiB;IAC7B,0EAA0E;IAC1E,YAAY,iBAAiB;IAC7B,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/content.d.ts

@@ -1,6 +1,6 @@
-import { ErrorCanvasContent, UnsupportedCanvasContent } from '../models/attachment-canvas';
+import { AttachmentCanvasContent, ErrorCanvasContent, UnsupportedCanvasContent } from '../models/attachment-canvas';
 import { OoxmlFileType } from '../types/attachment-canvas';
-/** Resolves a format supported by the bundled `@silurus/ooxml` renderer from a MIME type or file extension. */
+/** Resolves a format supported by the installed `@silurus/ooxml` renderer from a MIME type or file extension. */
 export declare const getOoxmlFileType: (name: string, mimeType?: string) => OoxmlFileType | undefined;
 /** Returns true when a file can be rendered by the built-in `@silurus/ooxml` viewer. */
 export declare const isOoxmlPreviewable: (name: string, mimeType?: string) => boolean;
@@ -18,4 +18,18 @@ export declare const createUnsupportedCanvasContent: (url?: string) => Unsupport
 export declare const createLoadErrorCanvasContent: (url?: string) => ErrorCanvasContent;
 /** Creates a content payload for a file the current user is not permitted to access (HTTP 403). */
 export declare const createForbiddenCanvasContent: (url?: string) => ErrorCanvasContent;
+/**
+ * Returns `content.url` when it is an object URL created by
+ * `URL.createObjectURL` (i.e. it should be revoked once no longer displayed),
+ * or `undefined` otherwise (a remote/data URL, or a content type with no
+ * `url` at all).
+ */
+export declare const getRevocableObjectUrl: (content: AttachmentCanvasContent) => string | undefined;
+/**
+ * Revokes `content`'s object URL, if it has one. Call this for content that
+ * was resolved but never displayed — the canvas revokes only what it actually
+ * held, so a payload discarded before it reached the canvas would otherwise
+ * leak its blob for the lifetime of the page.
+ */
+export declare const releaseCanvasContent: (content: AttachmentCanvasContent) => void;
 //# sourceMappingURL=content.d.ts.map

package/utils/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/utils/content.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,aAAa,EACd,MAAM,4BAA4B,CAAC;AAuBpC,+GAA+G;AAC/G,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,WAAW,MAAM,KAChB,aAAa,GAAG,SAUlB,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,KAAG,OAC3B,CAAC;AAE3C,uJAAuJ;AACvJ,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,WAAW,MAAM,KAChB,MAAM,GAAG,SAGX,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,OAIhD,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,OAIhD,CAAC;AAoDF,+JAA+J;AAC/J,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAC/B,CAAC;AAE7B,qDAAqD;AACrD,eAAO,MAAM,8BAA8B,GACzC,MAAM,MAAM,KACX,wBAGD,CAAC;AAEH,mGAAmG;AACnG,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,KACX,kBAID,CAAC;AAEH,mGAAmG;AACnG,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,KACX,kBAID,CAAC"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/utils/content.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,aAAa,EACd,MAAM,4BAA4B,CAAC;AAuBpC,iHAAiH;AACjH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,WAAW,MAAM,KAChB,aAAa,GAAG,SAUlB,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,KAAG,OAC3B,CAAC;AAE3C,uJAAuJ;AACvJ,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,WAAW,MAAM,KAChB,MAAM,GAAG,SAGX,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,OAIhD,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,OAIhD,CAAC;AAoDF,+JAA+J;AAC/J,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAC/B,CAAC;AAE7B,qDAAqD;AACrD,eAAO,MAAM,8BAA8B,GACzC,MAAM,MAAM,KACX,wBAGD,CAAC;AAEH,mGAAmG;AACnG,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,KACX,kBAID,CAAC;AAEH,mGAAmG;AACnG,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,KACX,kBAID,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,uBAAuB,KAC/B,MAAM,GAAG,SAUX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,uBAAuB,KAC/B,IAGF,CAAC"}

package/utils/download.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/utils/download.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAoB3E,kEAAkE;AAClE,eAAO,MAAM,cAAc,GAAI,SAAS,uBAAuB,KAAG,OA6BjE,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,IAAI,CAIhE,CAAC;AAuCF,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,GACpC,SAAS,uBAAuB,EAChC,WAAW,MAAM,KAChB,IA8DF,CAAC"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/utils/download.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAoB3E,kEAAkE;AAClE,eAAO,MAAM,cAAc,GAAI,SAAS,uBAAuB,KAAG,OA8BjE,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,IAAI,CAIhE,CAAC;AAuCF,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,GACpC,SAAS,uBAAuB,EAChC,WAAW,MAAM,KAChB,IA8DF,CAAC"}

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":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,6BAA6B,CAAC;AAErC,+FAA+F;AAC/F,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEvE,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0FAA0F;AAC1F,UAAU,iBAAiB;IACzB,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sEAAsE;AACtE,MAAM,WAAW,yBAAyB;IACxC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAC5C,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;CAClC;AAED,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,0EAA0E;IAC1E,QAAQ,EAAE,0BAA0B,CAAC;IACrC;;;;OAIG;IACH,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpC,mGAAmG;IACnG,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,4EAA4E;AAC5E,MAAM,WAAW,uBAAuB;IACtC,0EAA0E;IAC1E,QAAQ,EAAE,0BAA0B,CAAC;IACrC,wFAAwF;IACxF,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IACjC,mGAAmG;IACnG,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,QAAQ,EAAE,0BAA0B,CAAC;IACrC,iGAAiG;IACjG,mBAAmB,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,kBAAkB,GAAG,IAAI,CAAC;IAC3E,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA+BD,6FAA6F;AAC7F,eAAO,MAAM,uBAAuB,QAAO,iBAAiB,GAAG,SAQ9D,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,cAAc,GACzB,YAAY;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EACjD,OAAO,MAAM,KACZ,gBAGD,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,eAAe,GAC1B,eAAe,MAAM,EACrB,gBAAgB,MAAM,EACtB,OAAO,MAAM,KACZ,gBAGD,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,6CAKlC,yBAAyB,KAAG,kBAc9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,SAAS,kBAAkB,EAAE,KACnC,kBAAkB,EA8BpB,CAAC;AA0JF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,+BAI9B,uBAAuB,KAAG,kBAAkB,EA0D9C,CAAC;AAaF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,8BAI9B,uBAAuB,KAAG,kBAAkB,EA+C9C,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,YAAY,SAAS,MAAM,EAAE,KAC5B,MAAM,GAAG,IAMX,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,aAAa,GAAI,cAAc,gBAAgB,KAAG,MAS9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,mDAI9B,uBAAuB,KAAG,kBAAkB,EAuB9C,CAAC"}
+{"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,EAGV,cAAc,EACd,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAKL,KAAK,kBAAkB,EASxB,MAAM,4BAA4B,CAAC;AAMpC,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,qBA8PF,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,qBAwEF,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,GACrC,WAAW,WAAW,EACtB,QAAQ,UAAU,EAClB,YAAY,MAAM,OAAO,KACxB,qBA0DD,CAAC"}

package/utils/ooxml-table-row-highlight.d.ts

@@ -0,0 +1,8 @@
+import { PptxTextRunInfo } from '@silurus/ooxml/pptx';
+import { OoxmlDocxTableRowLocation, OoxmlPptxTableRowLocation } from '../models/attachment-canvas';
+import { OoxmlDocxPageRects, OoxmlDocxPageRuns, OoxmlHighlightRect } from './ooxml-highlight-geometry';
+/** Resolves a whole DOCX table row to scale-independent text rectangles. */
+export declare const resolveDocxTableRowRects: (location: OoxmlDocxTableRowLocation, pages: readonly OoxmlDocxPageRuns[]) => OoxmlDocxPageRects[];
+/** Resolves a whole table row from the runs of its specified PPTX slide. */
+export declare const resolvePptxTableRowRects: (location: OoxmlPptxTableRowLocation, runs: readonly PptxTextRunInfo[]) => OoxmlHighlightRect[];
+//# sourceMappingURL=ooxml-table-row-highlight.d.ts.map

package/utils/ooxml-table-row-highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ooxml-table-row-highlight.d.ts","sourceRoot":"","sources":["../../src/utils/ooxml-table-row-highlight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAGxB,MAAM,4BAA4B,CAAC;AAmEpC,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,GACnC,UAAU,yBAAyB,EACnC,OAAO,SAAS,iBAAiB,EAAE,KAClC,kBAAkB,EAuEpB,CAAC;AAcF,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,GACnC,UAAU,yBAAyB,EACnC,MAAM,SAAS,eAAe,EAAE,KAC/B,kBAAkB,EA4CpB,CAAC"}

package/utils/visualizer.d.ts

@@ -1,8 +1,36 @@
-import { CustomVisualizer } from '@epam/ai-dial-chat-shared';
+import { ApplicationVisualizer, ApplicationVisualizerRegistry, CustomVisualizer, DisplayAttachment } from '@epam/ai-dial-chat-shared';
 /**
  * Returns the first `CustomVisualizer` registry entry whose `contentType` list
  * (comma-separated, case-insensitive) includes `mimeType`, or `undefined` if
  * none match. First-match-wins when multiple entries cover the same MIME type.
  */
 export declare const findVisualizerForMime: (mimeType: string, visualizers: CustomVisualizer[]) => CustomVisualizer | undefined;
+/**
+ * Returns the `ApplicationVisualizer` registered for `applicationId`, or
+ * `undefined` when the id is absent, empty, or not a key of the registry.
+ * Keys are compared by exact string equality — deployment ids are opaque and
+ * are never trimmed or case-folded.
+ */
+export declare const findVisualizerForApplication: (applicationId: string | undefined, visualizers: ApplicationVisualizerRegistry) => ApplicationVisualizer | undefined;
+/**
+ * Returns the canvas-selection key identifying a message's grouped visualizer,
+ * so the host can tell whether that visualizer is the one currently open in
+ * the canvas and replace its inline frame with a placeholder.
+ */
+export declare const groupedVisualizerCanvasKey: (messageIndex: number) => string;
+/** Attachments split by whether an `ApplicationVisualizer` entry claims them. */
+export interface ApplicationVisualizerPartition {
+    /** Attachments the entry claims, to be sent as one grouped payload. In the input's order. */
+    claimed: DisplayAttachment[];
+    /** Attachments the entry does not claim, to be rendered as ordinary tiles. In the input's order. */
+    unclaimed: DisplayAttachment[];
+}
+/**
+ * Splits `attachments` into the ones `visualizer` claims and the ones it does
+ * not. An entry with a `contentType` claims the attachments whose own
+ * `contentType` appears in its comma-separated list (compared
+ * case-insensitively); an entry without one claims every attachment that
+ * carries a URL. Both sides keep the input order.
+ */
+export declare const partitionAttachmentsForApplicationVisualizer: (attachments: DisplayAttachment[], visualizer: ApplicationVisualizer) => ApplicationVisualizerPartition;
 //# sourceMappingURL=visualizer.d.ts.map

package/utils/visualizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visualizer.d.ts","sourceRoot":"","sources":["../../src/utils/visualizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,EAChB,aAAa,gBAAgB,EAAE,KAC9B,gBAAgB,GAAG,SASrB,CAAC"}
+{"version":3,"file":"visualizer.d.ts","sourceRoot":"","sources":["../../src/utils/visualizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,EAChB,aAAa,gBAAgB,EAAE,KAC9B,gBAAgB,GAAG,SASrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,eAAe,MAAM,GAAG,SAAS,EACjC,aAAa,6BAA6B,KACzC,qBAAqB,GAAG,SAO1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,cAAc,MAAM,KAAG,MAC5B,CAAC;AAEvC,iFAAiF;AACjF,MAAM,WAAW,8BAA8B;IAC7C,6FAA6F;IAC7F,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,oGAAoG;IACpG,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4CAA4C,GACvD,aAAa,iBAAiB,EAAE,EAChC,YAAY,qBAAqB,KAChC,8BA2BF,CAAC"}

package/utils/vite-external-matcher.d.ts

@@ -5,14 +5,14 @@
  * package), and either way the import stays external so consumers get one
  * shared copy rather than a second one inlined here.
  */
-export declare const EXTERNAL_PEER_NAMES: readonly ["react", "@epam/ai-dial-chat-shared", "@epam/ai-dial-shared", "@epam/ai-dial-sidebar", "@epam/ai-dial-ui-kit", "@epam/ai-dial-visualizer-connector", "@tabler/icons-react", "react-json-view-lite", "@epam/ai-dial-react-pdf-highlighter", "@epam/pdf-highlighter-kit", "react-syntax-highlighter", "@mcp-ui/client", "@modelcontextprotocol/sdk", "@modelcontextprotocol/ext-apps", "pdfjs-dist"];
+export declare const EXTERNAL_PACKAGE_NAMES: readonly ["react", "@silurus/ooxml", "@epam/ai-dial-chat-shared", "@epam/ai-dial-shared", "@epam/ai-dial-sidebar", "@epam/ai-dial-ui-kit", "@epam/ai-dial-visualizer-connector", "@tabler/icons-react", "react-json-view-lite", "@epam/ai-dial-react-pdf-highlighter", "@epam/pdf-highlighter-kit", "react-syntax-highlighter", "@mcp-ui/client", "@modelcontextprotocol/sdk", "@modelcontextprotocol/ext-apps", "pdfjs-dist"];
 /**
- * Returns true when `id` is a bare peer package name, or is prefixed by
- * `<peerName>/` (a deep subpath of that peer), for any name in
- * {@link EXTERNAL_PEER_NAMES} — except when `id` ends in `.css`, since a
+ * Returns true when `id` is a bare runtime package name, or is prefixed by
+ * `<packageName>/` (a deep subpath of that package), for any name in
+ * {@link EXTERNAL_PACKAGE_NAMES} — except when `id` ends in `.css`, since a
  * vendor stylesheet subpath must stay locally resolved (via `resolve.alias`)
  * so Vite can process and extract it, rather than being left as an
  * unresolvable raw `import "…css"` statement in the output JS.
  */
-export declare const isExternalPeerImport: (id: string) => boolean;
+export declare const isExternalPackageImport: (id: string) => boolean;
 //# sourceMappingURL=vite-external-matcher.d.ts.map

package/utils/vite-external-matcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-external-matcher.d.ts","sourceRoot":"","sources":["../../src/utils/vite-external-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,8YAgBtB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,MAAM,KAAG,OAKjD,CAAC"}
+{"version":3,"file":"vite-external-matcher.d.ts","sourceRoot":"","sources":["../../src/utils/vite-external-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,gaAiBzB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAAI,IAAI,MAAM,KAAG,OAKpD,CAAC"}