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

package/src/bridge/react/usePlatformFileBinaryDataUrl.tsx

@@ -1,54 +1,54 @@
-import { useEffect, useState } from 'react'
-import { readPlatformFileBinaryDataUrl } from '../fs.mjs'
-
-export interface UsePlatformFileBinaryDataUrlResult {
-  src: string | null
-  loading: boolean
-  error: string | null
-}
-
-/** React binding for {@link readPlatformFileBinaryDataUrl}. */
-export function usePlatformFileBinaryDataUrl(
-  path: string | null,
-  enabled: boolean,
-  maxBytes?: number,
-): UsePlatformFileBinaryDataUrlResult {
-  const [src, setSrc] = useState<string | null>(null)
-  const [loading, setLoading] = useState(false)
-  const [error, setError] = useState<string | null>(null)
-
-  useEffect(() => {
-    if (!enabled || !path?.trim()) {
-      setSrc(null)
-      setLoading(false)
-      setError(null)
-      return
-    }
-
-    let cancelled = false
-    setLoading(true)
-    setError(null)
-    setSrc(null)
-
-    void readPlatformFileBinaryDataUrl(path, maxBytes)
-      .then(dataUrl => {
-        if (cancelled) return
-        setSrc(dataUrl)
-      })
-      .catch(cause => {
-        if (cancelled) return
-        setError(
-          cause instanceof Error ? cause.message : 'Failed to load preview.',
-        )
-      })
-      .finally(() => {
-        if (!cancelled) setLoading(false)
-      })
-
-    return () => {
-      cancelled = true
-    }
-  }, [enabled, maxBytes, path])
-
-  return { src, loading, error }
-}
+import { useEffect, useState } from 'react'
+import { readPlatformFileBinaryDataUrl } from '../fs.mjs'
+
+export interface UsePlatformFileBinaryDataUrlResult {
+  src: string | null
+  loading: boolean
+  error: string | null
+}
+
+/** React binding for {@link readPlatformFileBinaryDataUrl}. */
+export function usePlatformFileBinaryDataUrl(
+  path: string | null,
+  enabled: boolean,
+  maxBytes?: number,
+): UsePlatformFileBinaryDataUrlResult {
+  const [src, setSrc] = useState<string | null>(null)
+  const [loading, setLoading] = useState(false)
+  const [error, setError] = useState<string | null>(null)
+
+  useEffect(() => {
+    if (!enabled || !path?.trim()) {
+      setSrc(null)
+      setLoading(false)
+      setError(null)
+      return
+    }
+
+    let cancelled = false
+    setLoading(true)
+    setError(null)
+    setSrc(null)
+
+    void readPlatformFileBinaryDataUrl(path, maxBytes)
+      .then(dataUrl => {
+        if (cancelled) return
+        setSrc(dataUrl)
+      })
+      .catch(cause => {
+        if (cancelled) return
+        setError(
+          cause instanceof Error ? cause.message : 'Failed to load preview.',
+        )
+      })
+      .finally(() => {
+        if (!cancelled) setLoading(false)
+      })
+
+    return () => {
+      cancelled = true
+    }
+  }, [enabled, maxBytes, path])
+
+  return { src, loading, error }
+}

package/src/bridge/react/usePlatformFilePreview.tsx

@@ -1,92 +1,92 @@
-import { useEffect, useState } from 'react'
-import {
-  PLATFORM_FILE_TEXT_PREVIEW_MAX_BYTES,
-  readPlatformFilePreview,
-  readPlatformFilePreviewUrl,
-} from '../fs.mjs'
-import type { PlatformFilePreviewEntry } from '../types.js'
-import {
-  previewKindForEntry,
-  shouldFetchPreviewUrl,
-  shouldFetchTextPreview,
-  type FilePreviewKind,
-} from '../filePreviewKind.js'
-
-export interface UsePlatformFilePreviewResult {
-  previewKind: FilePreviewKind | null
-  textContent: string | null
-  textTruncated: boolean
-  mediaUrl: string | null
-  loading: boolean
-  error: string | null
-}
-
-/** Load inline file preview via shell bridge (text + streamed media URLs). */
-export function usePlatformFilePreview(
-  entry: PlatformFilePreviewEntry | null,
-): UsePlatformFilePreviewResult {
-  const [textContent, setTextContent] = useState<string | null>(null)
-  const [textTruncated, setTextTruncated] = useState(false)
-  const [mediaUrl, setMediaUrl] = useState<string | null>(null)
-  const [loading, setLoading] = useState(false)
-  const [error, setError] = useState<string | null>(null)
-
-  const previewKind = entry ? previewKindForEntry(entry) : null
-
-  useEffect(() => {
-    let cancelled = false
-
-    setTextContent(null)
-    setTextTruncated(false)
-    setMediaUrl(null)
-    setError(null)
-
-    if (!entry || entry.isDirectory) return
-
-    const fetchText = shouldFetchTextPreview(entry)
-    const fetchMedia = shouldFetchPreviewUrl(entry)
-    if (!fetchText && !fetchMedia) return
-
-    setLoading(true)
-
-    void (async () => {
-      try {
-        if (fetchText) {
-          const result = await readPlatformFilePreview(
-            entry.path,
-            PLATFORM_FILE_TEXT_PREVIEW_MAX_BYTES,
-          )
-          if (cancelled) return
-          setTextContent(result.content)
-          setTextTruncated(result.truncated)
-        }
-
-        if (fetchMedia) {
-          const result = await readPlatformFilePreviewUrl(entry.path)
-          if (cancelled) return
-          setMediaUrl(result.url)
-        }
-      } catch (err) {
-        if (cancelled) return
-        setTextContent(null)
-        setMediaUrl(null)
-        setError(err instanceof Error ? err.message : String(err))
-      } finally {
-        if (!cancelled) setLoading(false)
-      }
-    })()
-
-    return () => {
-      cancelled = true
-    }
-  }, [entry])
-
-  return {
-    previewKind,
-    textContent,
-    textTruncated,
-    mediaUrl,
-    loading,
-    error,
-  }
-}
+import { useEffect, useState } from 'react'
+import {
+  PLATFORM_FILE_TEXT_PREVIEW_MAX_BYTES,
+  readPlatformFilePreview,
+  readPlatformFilePreviewUrl,
+} from '../fs.mjs'
+import type { PlatformFilePreviewEntry } from '../types.js'
+import {
+  previewKindForEntry,
+  shouldFetchPreviewUrl,
+  shouldFetchTextPreview,
+  type FilePreviewKind,
+} from '../filePreviewKind.js'
+
+export interface UsePlatformFilePreviewResult {
+  previewKind: FilePreviewKind | null
+  textContent: string | null
+  textTruncated: boolean
+  mediaUrl: string | null
+  loading: boolean
+  error: string | null
+}
+
+/** Load inline file preview via shell bridge (text + streamed media URLs). */
+export function usePlatformFilePreview(
+  entry: PlatformFilePreviewEntry | null,
+): UsePlatformFilePreviewResult {
+  const [textContent, setTextContent] = useState<string | null>(null)
+  const [textTruncated, setTextTruncated] = useState(false)
+  const [mediaUrl, setMediaUrl] = useState<string | null>(null)
+  const [loading, setLoading] = useState(false)
+  const [error, setError] = useState<string | null>(null)
+
+  const previewKind = entry ? previewKindForEntry(entry) : null
+
+  useEffect(() => {
+    let cancelled = false
+
+    setTextContent(null)
+    setTextTruncated(false)
+    setMediaUrl(null)
+    setError(null)
+
+    if (!entry || entry.isDirectory) return
+
+    const fetchText = shouldFetchTextPreview(entry)
+    const fetchMedia = shouldFetchPreviewUrl(entry)
+    if (!fetchText && !fetchMedia) return
+
+    setLoading(true)
+
+    void (async () => {
+      try {
+        if (fetchText) {
+          const result = await readPlatformFilePreview(
+            entry.path,
+            PLATFORM_FILE_TEXT_PREVIEW_MAX_BYTES,
+          )
+          if (cancelled) return
+          setTextContent(result.content)
+          setTextTruncated(result.truncated)
+        }
+
+        if (fetchMedia) {
+          const result = await readPlatformFilePreviewUrl(entry.path)
+          if (cancelled) return
+          setMediaUrl(result.url)
+        }
+      } catch (err) {
+        if (cancelled) return
+        setTextContent(null)
+        setMediaUrl(null)
+        setError(err instanceof Error ? err.message : String(err))
+      } finally {
+        if (!cancelled) setLoading(false)
+      }
+    })()
+
+    return () => {
+      cancelled = true
+    }
+  }, [entry])
+
+  return {
+    previewKind,
+    textContent,
+    textTruncated,
+    mediaUrl,
+    loading,
+    error,
+  }
+}

package/src/bridge/react/usePlatformPreferences.tsx

@@ -1,77 +1,77 @@
-import { useCallback, useEffect, useState } from 'react'
-import {
-  getPlatformPreferences,
-  patchPlatformPreferences,
-} from '../preferences.mjs'
-import type { PlatformShellPreferences } from '../types.js'
-
-export interface UsePlatformPreferencesOptions {
-  /** Wait for bridge ready before loading (default true). */
-  enabled?: boolean
-}
-
-export interface UsePlatformPreferencesResult {
-  prefs: PlatformShellPreferences | null
-  loading: boolean
-  error: Error | null
-  /** Merge a partial patch via shell `settings.prefs.set`. */
-  updatePrefs: (
-    patch: Partial<PlatformShellPreferences>,
-  ) => Promise<PlatformShellPreferences>
-  reload: () => void
-}
-
-/**
- * Load and update shell preferences from a plugin iframe (`settings.prefs.*`).
- * Host renderer should use shell IPC helpers instead of this hook.
- */
-export function usePlatformPreferences(
-  options: UsePlatformPreferencesOptions = {},
-): UsePlatformPreferencesResult {
-  const enabled = options.enabled ?? true
-  const [prefs, setPrefs] = useState<PlatformShellPreferences | null>(null)
-  const [loading, setLoading] = useState(false)
-  const [error, setError] = useState<Error | null>(null)
-  const [reloadToken, setReloadToken] = useState(0)
-
-  const reload = useCallback(() => {
-    setReloadToken(token => token + 1)
-  }, [])
-
-  useEffect(() => {
-    if (!enabled) return
-
-    let cancelled = false
-    setLoading(true)
-    setError(null)
-
-    void getPlatformPreferences()
-      .then(next => {
-        if (!cancelled) setPrefs(next)
-      })
-      .catch((err: unknown) => {
-        if (!cancelled) {
-          setPrefs(null)
-          setError(err instanceof Error ? err : new Error(String(err)))
-        }
-      })
-      .finally(() => {
-        if (!cancelled) setLoading(false)
-      })
-
-    return () => {
-      cancelled = true
-    }
-  }, [enabled, reloadToken])
-
-  const updatePrefs = useCallback(
-    async (patch: Partial<PlatformShellPreferences>) => {
-      const next = await patchPlatformPreferences(patch)
-      setPrefs(next)
-      return next
-    },
-    [],
-  )
-
-  return { prefs, loading, error, updatePrefs, reload }
-}
+import { useCallback, useEffect, useState } from 'react'
+import {
+  getPlatformPreferences,
+  patchPlatformPreferences,
+} from '../preferences.mjs'
+import type { PlatformShellPreferences } from '../types.js'
+
+export interface UsePlatformPreferencesOptions {
+  /** Wait for bridge ready before loading (default true). */
+  enabled?: boolean
+}
+
+export interface UsePlatformPreferencesResult {
+  prefs: PlatformShellPreferences | null
+  loading: boolean
+  error: Error | null
+  /** Merge a partial patch via shell `settings.prefs.set`. */
+  updatePrefs: (
+    patch: Partial<PlatformShellPreferences>,
+  ) => Promise<PlatformShellPreferences>
+  reload: () => void
+}
+
+/**
+ * Load and update shell preferences from a plugin iframe (`settings.prefs.*`).
+ * Host renderer should use shell IPC helpers instead of this hook.
+ */
+export function usePlatformPreferences(
+  options: UsePlatformPreferencesOptions = {},
+): UsePlatformPreferencesResult {
+  const enabled = options.enabled ?? true
+  const [prefs, setPrefs] = useState<PlatformShellPreferences | null>(null)
+  const [loading, setLoading] = useState(false)
+  const [error, setError] = useState<Error | null>(null)
+  const [reloadToken, setReloadToken] = useState(0)
+
+  const reload = useCallback(() => {
+    setReloadToken(token => token + 1)
+  }, [])
+
+  useEffect(() => {
+    if (!enabled) return
+
+    let cancelled = false
+    setLoading(true)
+    setError(null)
+
+    void getPlatformPreferences()
+      .then(next => {
+        if (!cancelled) setPrefs(next)
+      })
+      .catch((err: unknown) => {
+        if (!cancelled) {
+          setPrefs(null)
+          setError(err instanceof Error ? err : new Error(String(err)))
+        }
+      })
+      .finally(() => {
+        if (!cancelled) setLoading(false)
+      })
+
+    return () => {
+      cancelled = true
+    }
+  }, [enabled, reloadToken])
+
+  const updatePrefs = useCallback(
+    async (patch: Partial<PlatformShellPreferences>) => {
+      const next = await patchPlatformPreferences(patch)
+      setPrefs(next)
+      return next
+    },
+    [],
+  )
+
+  return { prefs, loading, error, updatePrefs, reload }
+}

package/src/bridge/react/usePlatformThemeDocumentAttrs.ts

@@ -1,35 +1,35 @@
-import { useEffect, useState } from 'react'
-import { bridge } from '../client.mjs'
-import { PLATFORM_BRIDGE_EVENTS } from '../events.mjs'
-
-export interface PlatformThemeDocumentAttrs {
-  mode: string
-  surfacePalette: string
-}
-
-function readThemeDocumentAttrs(): PlatformThemeDocumentAttrs {
-  const root = document.documentElement
-  return {
-    mode: root.dataset.platformTheme ?? '',
-    surfacePalette: root.dataset.platformSurfacePalette ?? '',
-  }
-}
-
-/** Mirror shell-injected `data-platform-*` attrs for AppFrame styled selectors. */
-export function usePlatformThemeDocumentAttrs(
-  enabled = true,
-): PlatformThemeDocumentAttrs {
-  const [attrs, setAttrs] = useState<PlatformThemeDocumentAttrs>(() =>
-    enabled ? readThemeDocumentAttrs() : { mode: '', surfacePalette: '' },
-  )
-
-  useEffect(() => {
-    if (!enabled) return
-    setAttrs(readThemeDocumentAttrs())
-    return bridge.onEvent(PLATFORM_BRIDGE_EVENTS.THEME_CHANGED, () => {
-      setAttrs(readThemeDocumentAttrs())
-    })
-  }, [enabled])
-
-  return attrs
-}
+import { useEffect, useState } from 'react'
+import { bridge } from '../client.mjs'
+import { PLATFORM_BRIDGE_EVENTS } from '../events.mjs'
+
+export interface PlatformThemeDocumentAttrs {
+  mode: string
+  surfacePalette: string
+}
+
+function readThemeDocumentAttrs(): PlatformThemeDocumentAttrs {
+  const root = document.documentElement
+  return {
+    mode: root.dataset.platformTheme ?? '',
+    surfacePalette: root.dataset.platformSurfacePalette ?? '',
+  }
+}
+
+/** Mirror shell-injected `data-platform-*` attrs for AppFrame styled selectors. */
+export function usePlatformThemeDocumentAttrs(
+  enabled = true,
+): PlatformThemeDocumentAttrs {
+  const [attrs, setAttrs] = useState<PlatformThemeDocumentAttrs>(() =>
+    enabled ? readThemeDocumentAttrs() : { mode: '', surfacePalette: '' },
+  )
+
+  useEffect(() => {
+    if (!enabled) return
+    setAttrs(readThemeDocumentAttrs())
+    return bridge.onEvent(PLATFORM_BRIDGE_EVENTS.THEME_CHANGED, () => {
+      setAttrs(readThemeDocumentAttrs())
+    })
+  }, [enabled])
+
+  return attrs
+}

package/src/bridge/react/usePlatformThemeFromBridge.tsx

@@ -1,16 +1,16 @@
-import { useEffect } from 'react'
-import { applyThemeFromHost } from '../applyThemeFromHost.mjs'
-import { bridge } from '../client.mjs'
-import { PLATFORM_BRIDGE_EVENTS } from '../events.mjs'
-import type { PlatformThemeBridgePayload } from '../types.js'
-
-/** Subscribe to shell theme updates in a plugin iframe (cross-origin safe). */
-export function usePlatformThemeFromBridge(enabled = true): void {
-  useEffect(() => {
-    if (!enabled) return
-
-    return bridge.onEvent(PLATFORM_BRIDGE_EVENTS.THEME_CHANGED, payload => {
-      applyThemeFromHost(payload as PlatformThemeBridgePayload)
-    })
-  }, [enabled])
-}
+import { useEffect } from 'react'
+import { applyThemeFromHost } from '../applyThemeFromHost.mjs'
+import { bridge } from '../client.mjs'
+import { PLATFORM_BRIDGE_EVENTS } from '../events.mjs'
+import type { PlatformThemeBridgePayload } from '../types.js'
+
+/** Subscribe to shell theme updates in a plugin iframe (cross-origin safe). */
+export function usePlatformThemeFromBridge(enabled = true): void {
+  useEffect(() => {
+    if (!enabled) return
+
+    return bridge.onEvent(PLATFORM_BRIDGE_EVENTS.THEME_CHANGED, payload => {
+      applyThemeFromHost(payload as PlatformThemeBridgePayload)
+    })
+  }, [enabled])
+}