@puredesktop/puredesktop-ui-bridge 1.0.0-beta.1 → 2.1.0

package/src/bridge/methods.mjs

@@ -1,132 +1,143 @@
-/** Plugin ↔ shell bridge method names. Single source for shell + app SDK. */
-export const PLATFORM_BRIDGE_METHODS = {
-  PING: 'ping',
-
-  RUNTIME_VERSION: 'runtime.version',
-  RUNTIME_PLATFORM: 'runtime.platform',
-
-  CATALOG_MANIFEST: 'catalog.manifest',
-  CATALOG_MATCH_APPS: 'catalog.matchApps',
-  CATALOG_OPEN: 'catalog.open',
-  WORKSPACE_OPEN_APP: 'workspace.openApp',
-  WORKSPACE_OPEN_PALETTE: 'workspace.openPalette',
-  SCHEDULER_REGISTER: 'scheduler.register',
-  SCHEDULER_UNREGISTER: 'scheduler.unregister',
-  CATALOG_CONSUME_PENDING_OPEN: 'catalog.consumePendingOpen',
-
-  THEME_SET_SURFACE_PALETTE: 'theme.setSurfacePalette',
-
-  WINDOW_START_SCREEN_CAPTURE: 'window.startScreenCapture',
-
-  SETTINGS_PREFS_GET: 'settings.prefs.get',
-  SETTINGS_PREFS_SET: 'settings.prefs.set',
-  SETTINGS_APP_GET: 'settings.app.get',
-  SETTINGS_APP_UPDATE: 'settings.app.update',
-
-  STORAGE_READ_JSON: 'storage.readJson',
-  STORAGE_WRITE_JSON: 'storage.writeJson',
-
-  FS_LIST: 'fs.list',
-  FS_READ_PREVIEW: 'fs.readPreview',
-  FS_READ_BINARY: 'fs.readBinary',
-  FS_PREVIEW_URL: 'fs.previewUrl',
-  FS_CREATE_FOLDER: 'fs.createFolder',
-  FS_RENAME: 'fs.rename',
-  FS_DELETE: 'fs.delete',
-  FS_READ: 'fs.read',
-  FS_WRITE: 'fs.write',
-  FS_WRITE_BINARY: 'fs.writeBinary',
-
-  DIALOG_OPEN_FOLDER: 'dialog.openFolder',
-  DIALOG_SAVE_FOLDER: 'dialog.saveFolder',
-  DIALOG_OPEN_IMAGE: 'dialog.openImage',
-  DIALOG_OPEN_FILE: 'dialog.openFile',
-
-  OS_REVEAL: 'os.reveal',
-  OS_OPEN_PATH: 'os.openPath',
-  OS_TRASH: 'os.trash',
-
-  RENDER_PRINT_HTML: 'render.printHtml',
-  RENDER_PREPARE_PAGED_PREVIEW: 'render.preparePagedPreview',
-  RENDER_CAPTURE_PAGED_SNAPSHOT: 'render.capturePagedSnapshot',
-  RENDER_GET_PRINT_STYLESHEET: 'render.getPrintStylesheet',
-  RENDER_CANCEL: 'render.cancel',
-
-  WATCH_START: 'watch.start',
-  WATCH_STOP: 'watch.stop',
-
-  ASSETS_LIST: 'assets.list',
-  ASSETS_LIST_SCOPED: 'assets.listScoped',
-  ASSETS_DELETE: 'assets.delete',
-  ASSETS_UPDATE: 'assets.update',
-  ASSETS_UPDATE_SOURCE: 'assets.updateSource',
-  ASSETS_UPDATE_SOURCE_SCOPED: 'assets.updateSourceScoped',
-  ASSETS_GET_SELECTED: 'assets.getSelected',
-  ASSETS_SET_SELECTED: 'assets.setSelected',
-  ASSETS_CREATE_VERSION: 'assets.createVersion',
-  ASSETS_SWAP_REFERENCES: 'assets.swapReferences',
-  ASSETS_SWAP_REFERENCES_SCOPED: 'assets.swapReferencesScoped',
-  ASSETS_TRANSFORM: 'assets.transform',
-  ASSETS_GET_CONTEXT: 'assets.getContext',
-
-  NETWORK_FETCH: 'network.fetch',
-  OAUTH_LOOPBACK_AUTHORIZE: 'oauth.loopbackAuthorize',
-  SECRETS_GET: 'secrets.get',
-  SECRETS_SET: 'secrets.set',
-  SECRETS_DELETE: 'secrets.delete',
-  SECRETS_STATUS: 'secrets.status',
-
-  DEBUG_EMIT_EVENT: 'debug.emitEvent',
-
-  PLUGINS_INSTALL: 'plugins.install',
-  CONTEXT_PUBLISH: 'context.publish',
-  PEOPLE_SUGGEST: 'people.suggest',
-  PEOPLE_RESEARCH: 'people.research',
-
-  CREDENTIALS_STORAGE_STATUS: 'credentials.storageStatus',
-  CREDENTIALS_LIST: 'credentials.list',
-  CREDENTIALS_SET: 'credentials.set',
-  CREDENTIALS_DELETE: 'credentials.delete',
-
-  AGENTS_SESSIONS_CREATE: 'agents.sessions.create',
-  AGENTS_SESSIONS_LIST: 'agents.sessions.list',
-  AGENTS_SESSIONS_READ: 'agents.sessions.read',
-  AGENTS_SESSIONS_UPDATE: 'agents.sessions.update',
-  AGENTS_SESSIONS_DELETE: 'agents.sessions.delete',
-
-  AGENTS_SESSION_SEND_MESSAGE: 'agents.session.sendMessage',
-  AGENTS_SESSION_APPROVE_TOOLS: 'agents.session.approveTools',
-  AGENTS_SESSION_REJECT_TOOLS: 'agents.session.rejectTools',
-  AGENTS_SESSION_ADVANCE_PENDING: 'agents.session.advancePending',
-  AGENTS_SESSION_INTERRUPT: 'agents.session.interrupt',
-
-  AGENTS_RUN_START: 'agents.run.start',
-  AGENTS_RUN_SEND: 'agents.run.send',
-  AGENTS_RUN_CALL_MODEL: 'agents.run.callModel',
-  AGENTS_RUN_RESOLVE_TOOL_CALLS: 'agents.run.resolveToolCalls',
-  AGENTS_RUN_READ_CONTEXT: 'agents.run.readContext',
-  AGENTS_LLM_MENU_OPTIONS: 'agents.llm.menuOptions',
-  AGENTS_LOCAL_MODELS_STATUS: 'agents.localModels.status',
-  AGENTS_TOOLS_REGISTER: 'agents.tools.register',
-  AGENTS_TOOLS_COMPLETE: 'agents.tools.complete',
-}
-
-export const PLATFORM_BRIDGE_METHOD_PREFIXES = {
-  RUNTIME: 'runtime.',
-  THEME: 'theme.',
-  WINDOW: 'window.',
-  SETTINGS: 'settings.',
-  STORAGE: 'storage.',
-  FS: 'fs.',
-  DIALOG: 'dialog.',
-  OS: 'os.',
-  RENDER: 'render.',
-  WATCH: 'watch.',
-  ASSETS: 'assets.',
-  NETWORK: 'network.',
-  OAUTH: 'oauth.',
-  SECRETS: 'secrets.',
-  AGENTS: 'agents.',
-  PEOPLE: 'people.',
-  DEBUG: 'debug.',
-}
+/** Plugin ↔ shell bridge method names. Single source for shell + app SDK. */
+export const PLATFORM_BRIDGE_METHODS = {
+  PING: 'ping',
+
+  RUNTIME_VERSION: 'runtime.version',
+  RUNTIME_PLATFORM: 'runtime.platform',
+
+  CATALOG_MANIFEST: 'catalog.manifest',
+  CATALOG_MATCH_APPS: 'catalog.matchApps',
+  CATALOG_OPEN: 'catalog.open',
+  WORKSPACE_OPEN_APP: 'workspace.openApp',
+  WORKSPACE_OPEN_PALETTE: 'workspace.openPalette',
+  SCHEDULER_REGISTER: 'scheduler.register',
+  SCHEDULER_UNREGISTER: 'scheduler.unregister',
+  CATALOG_CONSUME_PENDING_OPEN: 'catalog.consumePendingOpen',
+
+  THEME_SET_SURFACE_PALETTE: 'theme.setSurfacePalette',
+
+  WINDOW_START_SCREEN_CAPTURE: 'window.startScreenCapture',
+
+  SETTINGS_PREFS_GET: 'settings.prefs.get',
+  SETTINGS_PREFS_SET: 'settings.prefs.set',
+  SETTINGS_APP_GET: 'settings.app.get',
+  SETTINGS_APP_UPDATE: 'settings.app.update',
+
+  STORAGE_READ_JSON: 'storage.readJson',
+  STORAGE_WRITE_JSON: 'storage.writeJson',
+
+  FS_LIST: 'fs.list',
+  FS_READ_PREVIEW: 'fs.readPreview',
+  FS_READ_BINARY: 'fs.readBinary',
+  FS_PREVIEW_URL: 'fs.previewUrl',
+  FS_CREATE_FOLDER: 'fs.createFolder',
+  FS_RENAME: 'fs.rename',
+  FS_DELETE: 'fs.delete',
+  FS_READ: 'fs.read',
+  FS_WRITE: 'fs.write',
+  FS_WRITE_BINARY: 'fs.writeBinary',
+
+  DIALOG_OPEN_FOLDER: 'dialog.openFolder',
+  DIALOG_SAVE_FOLDER: 'dialog.saveFolder',
+  DIALOG_OPEN_IMAGE: 'dialog.openImage',
+  DIALOG_OPEN_FILE: 'dialog.openFile',
+
+  OS_REVEAL: 'os.reveal',
+  OS_OPEN_PATH: 'os.openPath',
+  OS_TRASH: 'os.trash',
+
+  RENDER_PRINT_HTML: 'render.printHtml',
+  RENDER_PREPARE_PAGED_PREVIEW: 'render.preparePagedPreview',
+  RENDER_CAPTURE_PAGED_SNAPSHOT: 'render.capturePagedSnapshot',
+  RENDER_GET_PRINT_STYLESHEET: 'render.getPrintStylesheet',
+  RENDER_CANCEL: 'render.cancel',
+
+  WATCH_START: 'watch.start',
+  WATCH_STOP: 'watch.stop',
+
+  ASSETS_LIST: 'assets.list',
+  ASSETS_LIST_SCOPED: 'assets.listScoped',
+  ASSETS_DELETE: 'assets.delete',
+  ASSETS_UPDATE: 'assets.update',
+  ASSETS_UPDATE_SOURCE: 'assets.updateSource',
+  ASSETS_UPDATE_SOURCE_SCOPED: 'assets.updateSourceScoped',
+  ASSETS_GET_SELECTED: 'assets.getSelected',
+  ASSETS_SET_SELECTED: 'assets.setSelected',
+  ASSETS_CREATE_VERSION: 'assets.createVersion',
+  ASSETS_SWAP_REFERENCES: 'assets.swapReferences',
+  ASSETS_SWAP_REFERENCES_SCOPED: 'assets.swapReferencesScoped',
+  ASSETS_TRANSFORM: 'assets.transform',
+  ASSETS_GET_CONTEXT: 'assets.getContext',
+
+  NETWORK_FETCH: 'network.fetch',
+  VISION_GENERATE_IMAGE: 'vision.generateImage',
+  OAUTH_LOOPBACK_AUTHORIZE: 'oauth.loopbackAuthorize',
+  SECRETS_GET: 'secrets.get',
+  SECRETS_SET: 'secrets.set',
+  SECRETS_DELETE: 'secrets.delete',
+  SECRETS_STATUS: 'secrets.status',
+
+  DEBUG_EMIT_EVENT: 'debug.emitEvent',
+
+  PLUGINS_INSTALL: 'plugins.install',
+  PLUGINS_EVALUATE_BUILD: 'plugins.evaluateBuild',
+  PLUGINS_PREPARE_REGISTRATION: 'plugins.prepareRegistration',
+  CONTEXT_PUBLISH: 'context.publish',
+  PEOPLE_SUGGEST: 'people.suggest',
+  PEOPLE_RESEARCH: 'people.research',
+
+  CREDENTIALS_STORAGE_STATUS: 'credentials.storageStatus',
+  CREDENTIALS_LIST: 'credentials.list',
+  CREDENTIALS_SET: 'credentials.set',
+  CREDENTIALS_DELETE: 'credentials.delete',
+
+  AGENTS_SESSIONS_CREATE: 'agents.sessions.create',
+  AGENTS_SESSIONS_LIST: 'agents.sessions.list',
+  AGENTS_SESSIONS_READ: 'agents.sessions.read',
+  AGENTS_SESSIONS_UPDATE: 'agents.sessions.update',
+  AGENTS_SESSIONS_DELETE: 'agents.sessions.delete',
+
+  AGENTS_JOBS_CREATE: 'agents.jobs.create',
+  AGENTS_JOBS_LIST: 'agents.jobs.list',
+  AGENTS_JOBS_READ: 'agents.jobs.read',
+  AGENTS_JOBS_CANCEL: 'agents.jobs.cancel',
+  AGENTS_JOBS_RUN_NOW: 'agents.jobs.runNow',
+
+  AGENTS_SESSION_SEND_MESSAGE: 'agents.session.sendMessage',
+  AGENTS_SESSION_APPROVE_TOOLS: 'agents.session.approveTools',
+  AGENTS_SESSION_REJECT_TOOLS: 'agents.session.rejectTools',
+  AGENTS_SESSION_ADVANCE_PENDING: 'agents.session.advancePending',
+  AGENTS_SESSION_INTERRUPT: 'agents.session.interrupt',
+
+  AGENTS_RUN_START: 'agents.run.start',
+  AGENTS_RUN_SEND: 'agents.run.send',
+  AGENTS_RUN_CALL_MODEL: 'agents.run.callModel',
+  AGENTS_RUN_RESOLVE_TOOL_CALLS: 'agents.run.resolveToolCalls',
+  AGENTS_RUN_READ_CONTEXT: 'agents.run.readContext',
+  AGENTS_LOW_MODEL_JSON: 'agents.lowModel.json',
+  AGENTS_LLM_MENU_OPTIONS: 'agents.llm.menuOptions',
+  AGENTS_LOCAL_MODELS_STATUS: 'agents.localModels.status',
+  AGENTS_TOOLS_REGISTER: 'agents.tools.register',
+  AGENTS_TOOLS_COMPLETE: 'agents.tools.complete',
+}
+
+export const PLATFORM_BRIDGE_METHOD_PREFIXES = {
+  RUNTIME: 'runtime.',
+  THEME: 'theme.',
+  WINDOW: 'window.',
+  SETTINGS: 'settings.',
+  STORAGE: 'storage.',
+  FS: 'fs.',
+  DIALOG: 'dialog.',
+  OS: 'os.',
+  RENDER: 'render.',
+  WATCH: 'watch.',
+  ASSETS: 'assets.',
+  NETWORK: 'network.',
+  VISION: 'vision.',
+  OAUTH: 'oauth.',
+  SECRETS: 'secrets.',
+  AGENTS: 'agents.',
+  PEOPLE: 'people.',
+  DEBUG: 'debug.',
+}

package/src/bridge/os.d.mts

@@ -1,11 +1,11 @@
-export declare function revealPlatformPath(
-  targetPath: string,
-): Promise<{ ok: true }>
-
-export declare function openPlatformPath(
-  targetPath: string,
-): Promise<{ ok: true }>
-
-export declare function trashPlatformPath(
-  targetPath: string,
-): Promise<{ ok: true }>
+export declare function revealPlatformPath(
+  targetPath: string,
+): Promise<{ ok: true }>
+
+export declare function openPlatformPath(
+  targetPath: string,
+): Promise<{ ok: true }>
+
+export declare function trashPlatformPath(
+  targetPath: string,
+): Promise<{ ok: true }>

package/src/bridge/os.mjs

@@ -1,26 +1,26 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * @param {string} targetPath Absolute file or folder path to reveal in the OS file manager.
- * @returns {Promise<{ ok: true }>}
- */
-export async function revealPlatformPath(targetPath) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.OS_REVEAL, [targetPath])
-}
-
-/**
- * @param {string} targetPath Absolute file or folder path to open with the OS default handler.
- * @returns {Promise<{ ok: true }>}
- */
-export async function openPlatformPath(targetPath) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.OS_OPEN_PATH, [targetPath])
-}
-
-/**
- * @param {string} targetPath Absolute file or folder path to move to the OS trash.
- * @returns {Promise<{ ok: true }>}
- */
-export async function trashPlatformPath(targetPath) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.OS_TRASH, [targetPath])
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * @param {string} targetPath Absolute file or folder path to reveal in the OS file manager.
+ * @returns {Promise<{ ok: true }>}
+ */
+export async function revealPlatformPath(targetPath) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.OS_REVEAL, [targetPath])
+}
+
+/**
+ * @param {string} targetPath Absolute file or folder path to open with the OS default handler.
+ * @returns {Promise<{ ok: true }>}
+ */
+export async function openPlatformPath(targetPath) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.OS_OPEN_PATH, [targetPath])
+}
+
+/**
+ * @param {string} targetPath Absolute file or folder path to move to the OS trash.
+ * @returns {Promise<{ ok: true }>}
+ */
+export async function trashPlatformPath(targetPath) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.OS_TRASH, [targetPath])
+}

package/src/bridge/plugins.d.mts

@@ -1,9 +1,9 @@
-import type { PlatformPluginInstallResult } from './types.js'
-
-export function installPluginPackage(
-  packagePath: string,
-): Promise<PlatformPluginInstallResult>
-
-export function openPluginInstallFolderDialog(): Promise<string | null>
-
-export function pickAndInstallPluginPackage(): Promise<PlatformPluginInstallResult | null>
+import type { PlatformPluginInstallResult } from './types.js'
+
+export function installPluginPackage(
+  packagePath: string,
+): Promise<PlatformPluginInstallResult>
+
+export function openPluginInstallFolderDialog(): Promise<string | null>
+
+export function pickAndInstallPluginPackage(): Promise<PlatformPluginInstallResult | null>

package/src/bridge/plugins.mjs

@@ -1,31 +1,31 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * @param {string} packagePath
- * @returns {Promise<import('./types.ts').PlatformPluginInstallResult>}
- */
-export async function installPluginPackage(packagePath) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.PLUGINS_INSTALL, [
-    { path: packagePath },
-  ])
-}
-
-/**
- * @returns {Promise<string | null>}
- */
-export async function openPluginInstallFolderDialog() {
-  const result = await bridge.call(PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FOLDER)
-  return result?.path ?? null
-}
-
-/**
- * Pick a plugin folder (dev tree or `.pure.app` package) and install via shell.
- *
- * @returns {Promise<import('./types.ts').PlatformPluginInstallResult | null>}
- */
-export async function pickAndInstallPluginPackage() {
-  const picked = await openPluginInstallFolderDialog()
-  if (!picked) return null
-  return installPluginPackage(picked)
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * @param {string} packagePath
+ * @returns {Promise<import('./types.ts').PlatformPluginInstallResult>}
+ */
+export async function installPluginPackage(packagePath) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.PLUGINS_INSTALL, [
+    { path: packagePath },
+  ])
+}
+
+/**
+ * @returns {Promise<string | null>}
+ */
+export async function openPluginInstallFolderDialog() {
+  const result = await bridge.call(PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_FOLDER)
+  return result?.path ?? null
+}
+
+/**
+ * Pick a plugin folder (dev tree or `.pure.app` package) and install via shell.
+ *
+ * @returns {Promise<import('./types.ts').PlatformPluginInstallResult | null>}
+ */
+export async function pickAndInstallPluginPackage() {
+  const picked = await openPluginInstallFolderDialog()
+  if (!picked) return null
+  return installPluginPackage(picked)
+}

package/src/bridge/plugins.ts

@@ -1,5 +1,5 @@
-export {
-  installPluginPackage,
-  openPluginInstallFolderDialog,
-  pickAndInstallPluginPackage,
-} from './plugins.mjs'
+export {
+  installPluginPackage,
+  openPluginInstallFolderDialog,
+  pickAndInstallPluginPackage,
+} from './plugins.mjs'

package/src/bridge/preferences.d.mts

@@ -1,7 +1,7 @@
-import type { PlatformShellPreferences } from './types.js'
-
-export function getPlatformPreferences(): Promise<PlatformShellPreferences>
-
-export function patchPlatformPreferences(
-  patch: Partial<PlatformShellPreferences>,
-): Promise<PlatformShellPreferences>
+import type { PlatformShellPreferences } from './types.js'
+
+export function getPlatformPreferences(): Promise<PlatformShellPreferences>
+
+export function patchPlatformPreferences(
+  patch: Partial<PlatformShellPreferences>,
+): Promise<PlatformShellPreferences>

package/src/bridge/preferences.mjs

@@ -1,17 +1,17 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * @returns {Promise<import('./types.ts').PlatformShellPreferences>}
- */
-export async function getPlatformPreferences() {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.SETTINGS_PREFS_GET)
-}
-
-/**
- * @param {Partial<import('./types.ts').PlatformShellPreferences>} patch
- * @returns {Promise<import('./types.ts').PlatformShellPreferences>}
- */
-export async function patchPlatformPreferences(patch) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.SETTINGS_PREFS_SET, [patch])
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * @returns {Promise<import('./types.ts').PlatformShellPreferences>}
+ */
+export async function getPlatformPreferences() {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.SETTINGS_PREFS_GET)
+}
+
+/**
+ * @param {Partial<import('./types.ts').PlatformShellPreferences>} patch
+ * @returns {Promise<import('./types.ts').PlatformShellPreferences>}
+ */
+export async function patchPlatformPreferences(patch) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.SETTINGS_PREFS_SET, [patch])
+}

package/src/bridge/preferences.ts

@@ -1,13 +1,13 @@
-export {
-  getPlatformPreferences,
-  patchPlatformPreferences,
-} from './preferences.mjs'
-export {
-  AGENT_AUTO_MODEL_ID,
-  AGENT_AUTO_MODEL_LABEL,
-  DEFAULT_AGENT_HIGH_LEVEL_MODEL_ID,
-  DEFAULT_AGENT_LOW_LEVEL_MODEL_ID,
-  isAgentAutoModelId,
-  resolveAgentModelTiersFromPrefs,
-  type PlatformAgentModelTiers,
-} from './agentModelTiers.js'
+export {
+  getPlatformPreferences,
+  patchPlatformPreferences,
+} from './preferences.mjs'
+export {
+  AGENT_AUTO_MODEL_ID,
+  AGENT_AUTO_MODEL_LABEL,
+  DEFAULT_AGENT_HIGH_LEVEL_MODEL_ID,
+  DEFAULT_AGENT_LOW_LEVEL_MODEL_ID,
+  isAgentAutoModelId,
+  resolveAgentModelTiersFromPrefs,
+  type PlatformAgentModelTiers,
+} from './agentModelTiers.js'

package/src/bridge/printDocument.test.ts

@@ -1,47 +1,47 @@
-import { describe, expect, it } from 'vitest'
-import {
-  buildPrintHtmlDocument,
-  escapeHtml,
-  fileBaseHref,
-  pdfExportPath,
-  printHtmlExportPath,
-  slugifyPrintTitle,
-} from './printDocument.js'
-
-describe('printDocument', () => {
-  it('builds export paths under the collection root', () => {
-    expect(printHtmlExportPath('/tmp/ws')).toBe('/tmp/ws/print/export.html')
-    expect(pdfExportPath('/tmp/ws', 'My Draft')).toBe(
-      '/tmp/ws/dist/my-draft.pdf',
-    )
-    expect(slugifyPrintTitle('Hello, World!')).toBe('hello-world')
-  })
-
-  it('escapes HTML in document titles', () => {
-    const html = buildPrintHtmlDocument({
-      rootPath: '/tmp/ws',
-      title: 'A & B <script>',
-      bodyHtml: '<main>x</main>',
-      stylesheet: '@page { size: A5; }',
-    })
-    expect(html).toContain('<title>A &amp; B &lt;script&gt;</title>')
-    expect(html).not.toContain('<script>')
-  })
-
-  it('sets base href for print asset resolution', () => {
-    expect(fileBaseHref('/tmp/ws')).toBe('file:///tmp/ws/')
-    const html = buildPrintHtmlDocument({
-      rootPath: '/tmp/ws',
-      title: 'T',
-      bodyHtml: '<p>Hi</p>',
-      stylesheet: 'body {}',
-      bodyClass: 'writer-document',
-    })
-    expect(html).toContain('<base href="file:///tmp/ws/">')
-    expect(html).toContain('class="writer-document"')
-  })
-
-  it('escapeHtml leaves normal text unchanged', () => {
-    expect(escapeHtml('plain')).toBe('plain')
-  })
-})
+import { describe, expect, it } from 'vitest'
+import {
+  buildPrintHtmlDocument,
+  escapeHtml,
+  fileBaseHref,
+  pdfExportPath,
+  printHtmlExportPath,
+  slugifyPrintTitle,
+} from './printDocument.js'
+
+describe('printDocument', () => {
+  it('builds export paths under the collection root', () => {
+    expect(printHtmlExportPath('/tmp/ws')).toBe('/tmp/ws/print/export.html')
+    expect(pdfExportPath('/tmp/ws', 'My Draft')).toBe(
+      '/tmp/ws/dist/my-draft.pdf',
+    )
+    expect(slugifyPrintTitle('Hello, World!')).toBe('hello-world')
+  })
+
+  it('escapes HTML in document titles', () => {
+    const html = buildPrintHtmlDocument({
+      rootPath: '/tmp/ws',
+      title: 'A & B <script>',
+      bodyHtml: '<main>x</main>',
+      stylesheet: '@page { size: A5; }',
+    })
+    expect(html).toContain('<title>A &amp; B &lt;script&gt;</title>')
+    expect(html).not.toContain('<script>')
+  })
+
+  it('sets base href for print asset resolution', () => {
+    expect(fileBaseHref('/tmp/ws')).toBe('file:///tmp/ws/')
+    const html = buildPrintHtmlDocument({
+      rootPath: '/tmp/ws',
+      title: 'T',
+      bodyHtml: '<p>Hi</p>',
+      stylesheet: 'body {}',
+      bodyClass: 'writer-document',
+    })
+    expect(html).toContain('<base href="file:///tmp/ws/">')
+    expect(html).toContain('class="writer-document"')
+  })
+
+  it('escapeHtml leaves normal text unchanged', () => {
+    expect(escapeHtml('plain')).toBe('plain')
+  })
+})