diff --git a/packages/ui/lang/en.json b/packages/ui/lang/en.json
index 60ea507dbf..605923319e 100644
--- a/packages/ui/lang/en.json
+++ b/packages/ui/lang/en.json
@@ -111,6 +111,8 @@
"ThisYear": "This year",
"EmojiStyle": "Emoji Style",
"EmojiSystem": "System Default",
- "EmojiNoto": "Noto Color"
+ "EmojiNoto": "Noto Color",
+ "Download": "Download",
+ "FailedToLoadPdf": "Failed to load the document"
}
}
diff --git a/packages/ui/package.json b/packages/ui/package.json
index 790803bd6f..e923d0cb8c 100644
--- a/packages/ui/package.json
+++ b/packages/ui/package.json
@@ -52,7 +52,8 @@
"fast-equals": "^5.2.2",
"svelte": "^4.2.20",
"plyr": "3.7.8",
- "blurhash": "^2.0.5"
+ "blurhash": "^2.0.5",
+ "pdfjs-dist": "4.10.38"
},
"repository": {
"type": "git",
diff --git a/packages/ui/src/__tests__/pdf-embed-utils.test.ts b/packages/ui/src/__tests__/pdf-embed-utils.test.ts
new file mode 100644
index 0000000000..05f9d245ea
--- /dev/null
+++ b/packages/ui/src/__tests__/pdf-embed-utils.test.ts
@@ -0,0 +1,69 @@
+//
+// Copyright © 2026 Hardcore Engineering Inc.
+//
+// Licensed under the Eclipse Public License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License. You may
+// obtain a copy of the License at https://www.eclipse.org/legal/epl-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import { appendToken, computeRenderScale, getAssetBase } from '../pdf-embed-utils'
+
+describe('pdf-embed-utils', () => {
+ describe('computeRenderScale', () => {
+ it('returns 1 (native size) when fit is not requested', () => {
+ expect(computeRenderScale(false, 800, 400)).toBe(1)
+ })
+
+ it('scales the page to the container width when fit is requested', () => {
+ expect(computeRenderScale(true, 800, 400)).toBe(2)
+ expect(computeRenderScale(true, 400, 800)).toBe(0.5)
+ })
+
+ it('falls back to 1 when the container width is not yet known', () => {
+ expect(computeRenderScale(true, 0, 400)).toBe(1)
+ expect(computeRenderScale(true, -1, 400)).toBe(1)
+ })
+
+ it('falls back to 1 when the unscaled page width is degenerate', () => {
+ expect(computeRenderScale(true, 800, 0)).toBe(1)
+ })
+ })
+
+ describe('appendToken', () => {
+ it('returns the url unchanged when no token is provided', () => {
+ expect(appendToken('https://files.example/blob/ws/abc', undefined)).toBe('https://files.example/blob/ws/abc')
+ expect(appendToken('https://files.example/blob/ws/abc', '')).toBe('https://files.example/blob/ws/abc')
+ })
+
+ it('uses ? when the url has no existing query string', () => {
+ expect(appendToken('https://files.example/blob/ws/abc', 'jwt')).toBe(
+ 'https://files.example/blob/ws/abc?token=jwt'
+ )
+ })
+
+ it('uses & when the url already has a query string', () => {
+ expect(appendToken('https://files.example/files?file=abc&workspace=ws', 'jwt')).toBe(
+ 'https://files.example/files?file=abc&workspace=ws&token=jwt'
+ )
+ })
+
+ it('url-encodes the token', () => {
+ expect(appendToken('https://files.example/blob/ws/abc', 'a.b/c+d=')).toBe(
+ 'https://files.example/blob/ws/abc?token=a.b%2Fc%2Bd%3D'
+ )
+ })
+ })
+
+ describe('getAssetBase', () => {
+ it('falls back to / when webpack public path is not defined', () => {
+ expect(getAssetBase()).toBe('/')
+ })
+ })
+})
diff --git a/packages/ui/src/components/EmbeddedHTML.svelte b/packages/ui/src/components/EmbeddedHTML.svelte
index e8cd5adfb7..716a43031f 100644
--- a/packages/ui/src/components/EmbeddedHTML.svelte
+++ b/packages/ui/src/components/EmbeddedHTML.svelte
@@ -15,7 +15,6 @@
{#if iframeSrc}
-
+
{:else}
{/if}
+
+
diff --git a/packages/ui/src/components/EmbeddedPDF.svelte b/packages/ui/src/components/EmbeddedPDF.svelte
index db4c12cb6c..74386834c8 100644
--- a/packages/ui/src/components/EmbeddedPDF.svelte
+++ b/packages/ui/src/components/EmbeddedPDF.svelte
@@ -1,5 +1,5 @@
-
+
+ {#if loading}
+
+ {:else if error !== undefined}
+
+
+ {#if error !== ''}
+
{error}
+ {/if}
+
+
+
+
+ {:else}
+ {#each Array(pageCount) as _, i (i)}
+
+ {/each}
+ {/if}
+
diff --git a/packages/ui/src/pdf-embed-utils.ts b/packages/ui/src/pdf-embed-utils.ts
new file mode 100644
index 0000000000..13753a0c42
--- /dev/null
+++ b/packages/ui/src/pdf-embed-utils.ts
@@ -0,0 +1,75 @@
+//
+// Copyright © 2026 Hardcore Engineering Inc.
+//
+// Licensed under the Eclipse Public License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License. You may
+// obtain a copy of the License at https://www.eclipse.org/legal/epl-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+/**
+ * Computes the CSS-pixel render scale for a PDF page.
+ *
+ * When `fit` is requested the page is scaled to the available container
+ * width. Otherwise the page renders at its native (unscaled) size.
+ *
+ * @public
+ */
+export function computeRenderScale (fit: boolean, containerWidth: number, unscaledPageWidth: number): number {
+ if (!fit || containerWidth <= 0 || unscaledPageWidth <= 0) {
+ return 1
+ }
+ return containerWidth / unscaledPageWidth
+}
+
+// webpack replaces this identifier at build time with the bundle's public path.
+// eslint-disable-next-line @typescript-eslint/naming-convention
+declare const __webpack_public_path__: string
+
+/**
+ * Resolves the base URL for pdf.js's bundled assets (cmaps, standard fonts) and
+ * the fallback worker chunk. These are emitted by CopyPlugin/an explicit entry
+ * at the bundle's served root, so they must be addressed via webpack's public
+ * path rather than a route-relative or `document.baseURI`-relative path — the
+ * app uses path-based pushState routing, under which those would 404. Falls
+ * back to '/' outside a webpack bundle (e.g. under the unit-test transform).
+ *
+ * @public
+ */
+export function getAssetBase (): string {
+ return typeof __webpack_public_path__ !== 'undefined' ? __webpack_public_path__ : '/'
+}
+
+/**
+ * Appends an auth token to a file URL as a `token` query parameter.
+ *
+ * pdf.js fetches the file cross-origin (the desktop app front runs on a
+ * separate origin from the file server), where cookie/credentialed auth is
+ * rejected by CORS (the file server responds with `Access-Control-Allow-Origin: *`
+ * and no `Access-Control-Allow-Credentials`). The file server also accepts the
+ * token as a query parameter, which a plain non-credentialed cross-origin
+ * request can carry. Returns the url unchanged when no token is provided.
+ *
+ * @public
+ */
+export function appendToken (url: string, token: string | undefined): string {
+ if (token === undefined || token === '') {
+ return url
+ }
+ const separator = url.includes('?') ? '&' : '?'
+ return `${url}${separator}token=${encodeURIComponent(token)}`
+}
+
+// Note: the pdf.js worker construction (`new Worker(new URL(..., import.meta.url))`,
+// with its try/catch fallback) lives inline in EmbeddedPDF.svelte rather than here.
+// `import.meta.url` is ESM-only syntax that this package's ts-jest/CommonJS test
+// transform cannot parse, matching why the analogous recorder-worker helper
+// (plugins/recorder-resources/src/composer.ts createWorker()) is not unit tested
+// either — Svelte files are outside Jest's testMatch, so keeping it there avoids
+// breaking `rush test`.
diff --git a/packages/ui/src/plugin.ts b/packages/ui/src/plugin.ts
index 490c3ee5d4..b61f698990 100644
--- a/packages/ui/src/plugin.ts
+++ b/packages/ui/src/plugin.ts
@@ -160,7 +160,10 @@ export const uis = plugin(uiId, {
EmojiStyle: '' as IntlString,
EmojiSystem: '' as IntlString,
- EmojiNoto: '' as IntlString
+ EmojiNoto: '' as IntlString,
+
+ Download: '' as IntlString,
+ FailedToLoadPdf: '' as IntlString
},
metadata: {
DefaultApplication: '' as Metadata
,
diff --git a/plugins/view-resources/src/components/viewer/PDFViewer.svelte b/plugins/view-resources/src/components/viewer/PDFViewer.svelte
index 62bded043a..b88a3a02e0 100644
--- a/plugins/view-resources/src/components/viewer/PDFViewer.svelte
+++ b/plugins/view-resources/src/components/viewer/PDFViewer.svelte
@@ -14,12 +14,15 @@
-->
-
+