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

package/src/bridge/collectionImagePaste.ts

@@ -1,130 +1,130 @@
-import type { Editor } from '@tiptap/core'
-import { insertCollectionImage } from '@purescience/platform-editor'
-import { DEFAULT_COLLECTION_FIGURES_DIR } from './collectionAssets.js'
-import { absoluteCollectionAssetPath } from './collectionDocumentHtml.js'
-
-const SUPPORTED_MIME = new Set([
-  'image/png',
-  'image/jpeg',
-  'image/gif',
-  'image/webp',
-  'image/svg+xml',
-])
-
-const EXT_FOR_MIME: Record<string, string> = {
-  'image/png': 'png',
-  'image/jpeg': 'jpg',
-  'image/gif': 'gif',
-  'image/webp': 'webp',
-  'image/svg+xml': 'svg',
-}
-
-export interface CollectionImagePastePayload {
-  name: string
-  bytes: Uint8Array
-  mimeType: string
-}
-
-export interface CollectionImagePasteHandlerOptions {
-  collectionPath?: string
-  subdir?: string
-  onError?: (message: string) => void
-  getEditor: () => Editor | null | undefined
-  writeBinary: (absolutePath: string, bytes: Uint8Array) => Promise<void>
-}
-
-export function normalizeCollectionImageMimeType(
-  mimeType: string | undefined,
-  name: string,
-): string | undefined {
-  const trimmed = mimeType?.trim().toLowerCase()
-  if (trimmed && SUPPORTED_MIME.has(trimmed)) return trimmed
-  const ext = name.split('.').pop()?.toLowerCase()
-  if (ext === 'png') return 'image/png'
-  if (ext === 'jpg' || ext === 'jpeg') return 'image/jpeg'
-  if (ext === 'gif') return 'image/gif'
-  if (ext === 'webp') return 'image/webp'
-  if (ext === 'svg') return 'image/svg+xml'
-  return undefined
-}
-
-export function stemFromImageFileName(name: string): string {
-  const base = name.replace(/\\/g, '/').split('/').pop() ?? name
-  const dot = base.lastIndexOf('.')
-  const stem = dot > 0 ? base.slice(0, dot) : base
-  return stem.replace(/\s+/g, '-').replace(/[^\w.-]+/g, '') || 'image'
-}
-
-function extensionFromImageFileName(name: string): string | undefined {
-  const ext = name.split('.').pop()?.toLowerCase()
-  if (!ext) return undefined
-  if (['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg'].includes(ext)) {
-    return ext === 'jpeg' ? 'jpg' : ext
-  }
-  return undefined
-}
-
-export function buildPastedFigureRelativePath(
-  subdir: string,
-  name: string,
-  mimeType?: string,
-  now = Date.now(),
-): string {
-  const normalizedMime =
-    normalizeCollectionImageMimeType(mimeType, name) ?? 'image/png'
-  if (!SUPPORTED_MIME.has(normalizedMime)) {
-    throw new Error(
-      'Unsupported image type. Supported: PNG, JPEG, GIF, WebP, SVG.',
-    )
-  }
-  const ext =
-    EXT_FOR_MIME[normalizedMime] ?? extensionFromImageFileName(name) ?? 'png'
-  const stem = stemFromImageFileName(name) || 'image'
-  return `${subdir}/${stem}-${now}.${ext}`
-}
-
-/** Persist pasted bytes under the collection and insert into the active editor. */
-export function createCollectionImagePasteHandler(
-  options: CollectionImagePasteHandlerOptions,
-): (payload: CollectionImagePastePayload) => Promise<void> {
-  const {
-    collectionPath,
-    subdir = DEFAULT_COLLECTION_FIGURES_DIR,
-    onError,
-    getEditor,
-    writeBinary,
-  } = options
-
-  return async ({ name, bytes, mimeType }) => {
-    if (!collectionPath?.trim()) {
-      onError?.('Open a collection before inserting images.')
-      throw new Error('No collection path')
-    }
-
-    const normalizedMime =
-      normalizeCollectionImageMimeType(mimeType, name) ?? 'image/png'
-    const relativePath = buildPastedFigureRelativePath(
-      subdir,
-      name,
-      normalizedMime,
-    )
-    const absolutePath = absoluteCollectionAssetPath(
-      collectionPath,
-      relativePath,
-    )
-    await writeBinary(absolutePath, bytes)
-
-    const stem = stemFromImageFileName(name)
-    const editor = getEditor()
-    if (
-      !insertCollectionImage(editor, {
-        relativePath,
-        alt: stem,
-        bytes,
-        mimeType: normalizedMime,
-      })
-    ) {
-      onError?.('Image nodes are not available in this editor.')
-    }
-  }
-}
+import type { Editor } from '@tiptap/core'
+import { insertCollectionImage } from '@purescience/platform-editor'
+import { DEFAULT_COLLECTION_FIGURES_DIR } from './collectionAssets.js'
+import { absoluteCollectionAssetPath } from './collectionDocumentHtml.js'
+
+const SUPPORTED_MIME = new Set([
+  'image/png',
+  'image/jpeg',
+  'image/gif',
+  'image/webp',
+  'image/svg+xml',
+])
+
+const EXT_FOR_MIME: Record<string, string> = {
+  'image/png': 'png',
+  'image/jpeg': 'jpg',
+  'image/gif': 'gif',
+  'image/webp': 'webp',
+  'image/svg+xml': 'svg',
+}
+
+export interface CollectionImagePastePayload {
+  name: string
+  bytes: Uint8Array
+  mimeType: string
+}
+
+export interface CollectionImagePasteHandlerOptions {
+  collectionPath?: string
+  subdir?: string
+  onError?: (message: string) => void
+  getEditor: () => Editor | null | undefined
+  writeBinary: (absolutePath: string, bytes: Uint8Array) => Promise<void>
+}
+
+export function normalizeCollectionImageMimeType(
+  mimeType: string | undefined,
+  name: string,
+): string | undefined {
+  const trimmed = mimeType?.trim().toLowerCase()
+  if (trimmed && SUPPORTED_MIME.has(trimmed)) return trimmed
+  const ext = name.split('.').pop()?.toLowerCase()
+  if (ext === 'png') return 'image/png'
+  if (ext === 'jpg' || ext === 'jpeg') return 'image/jpeg'
+  if (ext === 'gif') return 'image/gif'
+  if (ext === 'webp') return 'image/webp'
+  if (ext === 'svg') return 'image/svg+xml'
+  return undefined
+}
+
+export function stemFromImageFileName(name: string): string {
+  const base = name.replace(/\\/g, '/').split('/').pop() ?? name
+  const dot = base.lastIndexOf('.')
+  const stem = dot > 0 ? base.slice(0, dot) : base
+  return stem.replace(/\s+/g, '-').replace(/[^\w.-]+/g, '') || 'image'
+}
+
+function extensionFromImageFileName(name: string): string | undefined {
+  const ext = name.split('.').pop()?.toLowerCase()
+  if (!ext) return undefined
+  if (['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg'].includes(ext)) {
+    return ext === 'jpeg' ? 'jpg' : ext
+  }
+  return undefined
+}
+
+export function buildPastedFigureRelativePath(
+  subdir: string,
+  name: string,
+  mimeType?: string,
+  now = Date.now(),
+): string {
+  const normalizedMime =
+    normalizeCollectionImageMimeType(mimeType, name) ?? 'image/png'
+  if (!SUPPORTED_MIME.has(normalizedMime)) {
+    throw new Error(
+      'Unsupported image type. Supported: PNG, JPEG, GIF, WebP, SVG.',
+    )
+  }
+  const ext =
+    EXT_FOR_MIME[normalizedMime] ?? extensionFromImageFileName(name) ?? 'png'
+  const stem = stemFromImageFileName(name) || 'image'
+  return `${subdir}/${stem}-${now}.${ext}`
+}
+
+/** Persist pasted bytes under the collection and insert into the active editor. */
+export function createCollectionImagePasteHandler(
+  options: CollectionImagePasteHandlerOptions,
+): (payload: CollectionImagePastePayload) => Promise<void> {
+  const {
+    collectionPath,
+    subdir = DEFAULT_COLLECTION_FIGURES_DIR,
+    onError,
+    getEditor,
+    writeBinary,
+  } = options
+
+  return async ({ name, bytes, mimeType }) => {
+    if (!collectionPath?.trim()) {
+      onError?.('Open a collection before inserting images.')
+      throw new Error('No collection path')
+    }
+
+    const normalizedMime =
+      normalizeCollectionImageMimeType(mimeType, name) ?? 'image/png'
+    const relativePath = buildPastedFigureRelativePath(
+      subdir,
+      name,
+      normalizedMime,
+    )
+    const absolutePath = absoluteCollectionAssetPath(
+      collectionPath,
+      relativePath,
+    )
+    await writeBinary(absolutePath, bytes)
+
+    const stem = stemFromImageFileName(name)
+    const editor = getEditor()
+    if (
+      !insertCollectionImage(editor, {
+        relativePath,
+        alt: stem,
+        bytes,
+        mimeType: normalizedMime,
+      })
+    ) {
+      onError?.('Image nodes are not available in this editor.')
+    }
+  }
+}

package/src/bridge/context.mjs

@@ -1,12 +1,12 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * Publish structured context from this tab for agent sessions.
- * Requires `agents` permission.
- *
- * @param {{ summary: string, label?: string }} request
- */
-export async function publishContext(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.CONTEXT_PUBLISH, [request])
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * Publish structured context from this tab for agent sessions.
+ * Requires `agents` permission.
+ *
+ * @param {{ summary: string, label?: string }} request
+ */
+export async function publishContext(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.CONTEXT_PUBLISH, [request])
+}

package/src/bridge/credentials.mjs

@@ -1,22 +1,22 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/** Credential vault bridge — status/list/set/delete only (no get). Requires `agents` permission. */
-
-export async function readCredentialStorageStatus() {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.CREDENTIALS_STORAGE_STATUS, [])
-}
-
-export async function listCredentials() {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.CREDENTIALS_LIST, [])
-}
-
-/** @param {{ id: string, value: string }} request */
-export async function setCredential(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.CREDENTIALS_SET, [request])
-}
-
-/** @param {{ id: string }} request */
-export async function deleteCredential(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.CREDENTIALS_DELETE, [request])
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/** Credential vault bridge — status/list/set/delete only (no get). Requires `agents` permission. */
+
+export async function readCredentialStorageStatus() {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.CREDENTIALS_STORAGE_STATUS, [])
+}
+
+export async function listCredentials() {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.CREDENTIALS_LIST, [])
+}
+
+/** @param {{ id: string, value: string }} request */
+export async function setCredential(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.CREDENTIALS_SET, [request])
+}
+
+/** @param {{ id: string }} request */
+export async function deleteCredential(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.CREDENTIALS_DELETE, [request])
+}

package/src/bridge/dialog.d.mts

@@ -1,5 +1,5 @@
-export interface PlatformDialogPathResult {
-  path: string | null
-}
-
-export declare function openPlatformImageDialog(): Promise<string | null>
+export interface PlatformDialogPathResult {
+  path: string | null
+}
+
+export declare function openPlatformImageDialog(): Promise<string | null>

package/src/bridge/dialog.mjs

@@ -1,13 +1,13 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * @returns {Promise<string | null>} Absolute path to the picked image, or null if cancelled.
- */
-export async function openPlatformImageDialog() {
-  const result = await bridge.call(
-    PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_IMAGE,
-    [],
-  )
-  return result?.path ?? null
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * @returns {Promise<string | null>} Absolute path to the picked image, or null if cancelled.
+ */
+export async function openPlatformImageDialog() {
+  const result = await bridge.call(
+    PLATFORM_BRIDGE_METHODS.DIALOG_OPEN_IMAGE,
+    [],
+  )
+  return result?.path ?? null
+}

package/src/bridge/events.d.mts

@@ -1,14 +1,14 @@
-export declare const PLATFORM_BRIDGE_EVENTS: {
-  readonly RESOURCE_OPEN: 'resource.open'
-  readonly THEME_CHANGED: 'theme.changed'
-  readonly RENDER_PROGRESS: 'render.progress'
-  readonly WATCH_CHANGE: 'watch.change'
-  readonly AGENT_RUN_EVENT: 'agents.run.event'
-  readonly AGENT_TOOL_INVOKE: 'agents.tool.invoke'
-  readonly DEBUG_TEST: 'debug.test'
-  readonly SCHEDULE_FIRE: 'schedule.fire'
-  readonly WINDOW_CAMERA_SHORTCUT: 'window.cameraShortcut'
-}
-
-export type PlatformBridgeEventName =
-  (typeof PLATFORM_BRIDGE_EVENTS)[keyof typeof PLATFORM_BRIDGE_EVENTS]
+export declare const PLATFORM_BRIDGE_EVENTS: {
+  readonly RESOURCE_OPEN: 'resource.open'
+  readonly THEME_CHANGED: 'theme.changed'
+  readonly RENDER_PROGRESS: 'render.progress'
+  readonly WATCH_CHANGE: 'watch.change'
+  readonly AGENT_RUN_EVENT: 'agents.run.event'
+  readonly AGENT_TOOL_INVOKE: 'agents.tool.invoke'
+  readonly DEBUG_TEST: 'debug.test'
+  readonly SCHEDULE_FIRE: 'schedule.fire'
+  readonly WINDOW_CAMERA_SHORTCUT: 'window.cameraShortcut'
+}
+
+export type PlatformBridgeEventName =
+  (typeof PLATFORM_BRIDGE_EVENTS)[keyof typeof PLATFORM_BRIDGE_EVENTS]

package/src/bridge/events.mjs

@@ -1,12 +1,12 @@
-/** Host → plugin bridge event names. Single source for shell + app SDK. */
-export const PLATFORM_BRIDGE_EVENTS = {
-  RESOURCE_OPEN: 'resource.open',
-  THEME_CHANGED: 'theme.changed',
-  RENDER_PROGRESS: 'render.progress',
-  WATCH_CHANGE: 'watch.change',
-  AGENT_RUN_EVENT: 'agents.run.event',
-  AGENT_TOOL_INVOKE: 'agents.tool.invoke',
-  DEBUG_TEST: 'debug.test',
-  SCHEDULE_FIRE: 'schedule.fire',
-  WINDOW_CAMERA_SHORTCUT: 'window.cameraShortcut',
-}
+/** Host → plugin bridge event names. Single source for shell + app SDK. */
+export const PLATFORM_BRIDGE_EVENTS = {
+  RESOURCE_OPEN: 'resource.open',
+  THEME_CHANGED: 'theme.changed',
+  RENDER_PROGRESS: 'render.progress',
+  WATCH_CHANGE: 'watch.change',
+  AGENT_RUN_EVENT: 'agents.run.event',
+  AGENT_TOOL_INVOKE: 'agents.tool.invoke',
+  DEBUG_TEST: 'debug.test',
+  SCHEDULE_FIRE: 'schedule.fire',
+  WINDOW_CAMERA_SHORTCUT: 'window.cameraShortcut',
+}

package/src/bridge/filePreviewKind.test.ts

@@ -1,43 +1,43 @@
-import { describe, expect, it } from 'vitest'
-import {
-  entrySupportsFilePreview,
-  isPluginExcludedPreviewKind,
-  previewKindForEntry,
-} from './filePreviewKind.js'
-
-describe('filePreviewKind', () => {
-  it('detects previewable entries', () => {
-    expect(
-      entrySupportsFilePreview({
-        path: '/tmp/a.png',
-        name: 'a.png',
-        extension: '.png',
-        kind: 'image',
-        isDirectory: false,
-      }),
-    ).toBe(true)
-    expect(
-      entrySupportsFilePreview({
-        path: '/tmp/a.bin',
-        name: 'a.bin',
-        extension: '.bin',
-        kind: 'other',
-        isDirectory: false,
-      }),
-    ).toBe(false)
-  })
-
-  it('excludes pdf from plugin inline preview', () => {
-    expect(isPluginExcludedPreviewKind('pdf')).toBe(true)
-    expect(isPluginExcludedPreviewKind('image')).toBe(false)
-    expect(
-      previewKindForEntry({
-        path: '/tmp/a.pdf',
-        name: 'a.pdf',
-        extension: '.pdf',
-        kind: 'pdf',
-        isDirectory: false,
-      }),
-    ).toBe('pdf')
-  })
-})
+import { describe, expect, it } from 'vitest'
+import {
+  entrySupportsFilePreview,
+  isPluginExcludedPreviewKind,
+  previewKindForEntry,
+} from './filePreviewKind.js'
+
+describe('filePreviewKind', () => {
+  it('detects previewable entries', () => {
+    expect(
+      entrySupportsFilePreview({
+        path: '/tmp/a.png',
+        name: 'a.png',
+        extension: '.png',
+        kind: 'image',
+        isDirectory: false,
+      }),
+    ).toBe(true)
+    expect(
+      entrySupportsFilePreview({
+        path: '/tmp/a.bin',
+        name: 'a.bin',
+        extension: '.bin',
+        kind: 'other',
+        isDirectory: false,
+      }),
+    ).toBe(false)
+  })
+
+  it('excludes pdf from plugin inline preview', () => {
+    expect(isPluginExcludedPreviewKind('pdf')).toBe(true)
+    expect(isPluginExcludedPreviewKind('image')).toBe(false)
+    expect(
+      previewKindForEntry({
+        path: '/tmp/a.pdf',
+        name: 'a.pdf',
+        extension: '.pdf',
+        kind: 'pdf',
+        isDirectory: false,
+      }),
+    ).toBe('pdf')
+  })
+})

package/src/bridge/filePreviewKind.ts

@@ -1,76 +1,76 @@
-import type { PlatformFileKind, PlatformFilePreviewEntry } from './types.js'
-
-const PREVIEWABLE_TEXT_KINDS = new Set<PlatformFileKind>([
-  'html',
-  'markdown',
-  'text',
-  'data',
-  'code',
-])
-
-const IMAGE_EXTENSIONS = new Set(['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg'])
-const VIDEO_EXTENSIONS = new Set(['mp4', 'mov', 'webm', 'ogv'])
-const AUDIO_EXTENSIONS = new Set(['mp3', 'm4a', 'wav', 'ogg'])
-const PDF_EXTENSIONS = new Set(['pdf'])
-
-export type FilePreviewKind =
-  | 'folder'
-  | 'image'
-  | 'video'
-  | 'audio'
-  | 'pdf'
-  | 'text'
-  | 'other'
-
-export function previewKindForEntry(
-  entry: PlatformFilePreviewEntry,
-): FilePreviewKind {
-  if (entry.isDirectory) return 'folder'
-
-  const extension = entry.extension.toLowerCase().replace(/^\./, '')
-  if (entry.kind === 'image' || IMAGE_EXTENSIONS.has(extension)) return 'image'
-  if (entry.kind === 'video' || VIDEO_EXTENSIONS.has(extension)) return 'video'
-  if (entry.kind === 'audio' || AUDIO_EXTENSIONS.has(extension)) return 'audio'
-  if (entry.kind === 'pdf' || PDF_EXTENSIONS.has(extension)) return 'pdf'
-  if (PREVIEWABLE_TEXT_KINDS.has(entry.kind)) return 'text'
-
-  return 'other'
-}
-
-export function shouldFetchTextPreview(
-  entry: PlatformFilePreviewEntry,
-): boolean {
-  return previewKindForEntry(entry) === 'text'
-}
-
-export function shouldFetchPreviewUrl(
-  entry: PlatformFilePreviewEntry,
-): boolean {
-  const kind = previewKindForEntry(entry)
-  return (
-    kind === 'image' || kind === 'video' || kind === 'audio' || kind === 'pdf'
-  )
-}
-
-/** Kinds with any inline preview surface in `PlatformFilePreview`. */
-export function isPlatformFilePreviewKind(kind: FilePreviewKind): boolean {
-  return kind !== 'folder' && kind !== 'other'
-}
-
-export function entrySupportsFilePreview(
-  entry: PlatformFilePreviewEntry,
-): boolean {
-  if (entry.isDirectory) return false
-  return isPlatformFilePreviewKind(previewKindForEntry(entry))
-}
-
-/**
- * PDF uses an iframe — blocked inside nested plugin iframes.
- * Inspector shows a hint; full PDF opens in a shell tab.
- */
-export const PLATFORM_FILE_PREVIEW_PLUGIN_EXCLUDE_KINDS: readonly FilePreviewKind[] =
-  ['pdf']
-
-export function isPluginExcludedPreviewKind(kind: FilePreviewKind): boolean {
-  return PLATFORM_FILE_PREVIEW_PLUGIN_EXCLUDE_KINDS.includes(kind)
-}
+import type { PlatformFileKind, PlatformFilePreviewEntry } from './types.js'
+
+const PREVIEWABLE_TEXT_KINDS = new Set<PlatformFileKind>([
+  'html',
+  'markdown',
+  'text',
+  'data',
+  'code',
+])
+
+const IMAGE_EXTENSIONS = new Set(['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg'])
+const VIDEO_EXTENSIONS = new Set(['mp4', 'mov', 'webm', 'ogv'])
+const AUDIO_EXTENSIONS = new Set(['mp3', 'm4a', 'wav', 'ogg'])
+const PDF_EXTENSIONS = new Set(['pdf'])
+
+export type FilePreviewKind =
+  | 'folder'
+  | 'image'
+  | 'video'
+  | 'audio'
+  | 'pdf'
+  | 'text'
+  | 'other'
+
+export function previewKindForEntry(
+  entry: PlatformFilePreviewEntry,
+): FilePreviewKind {
+  if (entry.isDirectory) return 'folder'
+
+  const extension = entry.extension.toLowerCase().replace(/^\./, '')
+  if (entry.kind === 'image' || IMAGE_EXTENSIONS.has(extension)) return 'image'
+  if (entry.kind === 'video' || VIDEO_EXTENSIONS.has(extension)) return 'video'
+  if (entry.kind === 'audio' || AUDIO_EXTENSIONS.has(extension)) return 'audio'
+  if (entry.kind === 'pdf' || PDF_EXTENSIONS.has(extension)) return 'pdf'
+  if (PREVIEWABLE_TEXT_KINDS.has(entry.kind)) return 'text'
+
+  return 'other'
+}
+
+export function shouldFetchTextPreview(
+  entry: PlatformFilePreviewEntry,
+): boolean {
+  return previewKindForEntry(entry) === 'text'
+}
+
+export function shouldFetchPreviewUrl(
+  entry: PlatformFilePreviewEntry,
+): boolean {
+  const kind = previewKindForEntry(entry)
+  return (
+    kind === 'image' || kind === 'video' || kind === 'audio' || kind === 'pdf'
+  )
+}
+
+/** Kinds with any inline preview surface in `PlatformFilePreview`. */
+export function isPlatformFilePreviewKind(kind: FilePreviewKind): boolean {
+  return kind !== 'folder' && kind !== 'other'
+}
+
+export function entrySupportsFilePreview(
+  entry: PlatformFilePreviewEntry,
+): boolean {
+  if (entry.isDirectory) return false
+  return isPlatformFilePreviewKind(previewKindForEntry(entry))
+}
+
+/**
+ * PDF uses an iframe — blocked inside nested plugin iframes.
+ * Inspector shows a hint; full PDF opens in a shell tab.
+ */
+export const PLATFORM_FILE_PREVIEW_PLUGIN_EXCLUDE_KINDS: readonly FilePreviewKind[] =
+  ['pdf']
+
+export function isPluginExcludedPreviewKind(kind: FilePreviewKind): boolean {
+  return PLATFORM_FILE_PREVIEW_PLUGIN_EXCLUDE_KINDS.includes(kind)
+}