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

package/src/components/assets/asset-library/hooks/useAssetLibraryVersions.ts

@@ -1,145 +1,145 @@
-import { useCallback, useMemo, useState } from 'react'
-import {
-  swapCollectionAssetReferences,
-  swapCollectionAssetReferencesScoped,
-} from '../../../../bridge/assets.mjs'
-import type { PlatformAssetSummary } from '../../../../bridge/types.js'
-import { isFileCollectionAsset, messageForError } from '../helpers.js'
-import type { AssetLibraryStatus, AssetLibraryVersionsModel } from '../types.js'
-
-/**
- * Version lineage + reference swap for file assets.
- *
- * Lineage is derived from the in-memory `assets` list (same filter as ps-book).
- * TODO: When agents add versions while the dialog stays open, refresh via an
- * explicit shell event or caller hook — not a background poll.
- */
-export interface UseAssetLibraryVersionsOptions {
-  collectionPath: string
-  /** When set, collection-wide swaps use `assets.swapReferencesScoped`. */
-  documentFiles?: string[]
-  assets: PlatformAssetSummary[]
-  selectedAsset: PlatformAssetSummary | null
-  currentDocumentFile?: string | null
-  collectionLabel: string
-  insertTargetLabel: string
-  selectAsset: (assetId: string) => void
-  refreshAssets: (preferredId?: string | null) => Promise<void>
-  setStatus: (status: AssetLibraryStatus | null) => void
-}
-
-export function useAssetLibraryVersions({
-  collectionPath,
-  documentFiles,
-  assets,
-  selectedAsset,
-  currentDocumentFile,
-  collectionLabel,
-  insertTargetLabel,
-  selectAsset,
-  refreshAssets,
-  setStatus,
-}: UseAssetLibraryVersionsOptions): AssetLibraryVersionsModel {
-  const [swapping, setSwapping] = useState(false)
-
-  const visible = Boolean(selectedAsset && isFileCollectionAsset(selectedAsset))
-
-  const versions = useMemo(() => {
-    if (!selectedAsset || !visible) return []
-    return assets
-      .filter(asset => asset.lineageId === selectedAsset.lineageId)
-      .sort((left, right) => left.versionNumber - right.versionNumber)
-  }, [assets, selectedAsset, visible])
-
-  const previewVersion = useCallback(
-    (assetId: string): void => {
-      selectAsset(assetId)
-      setStatus({
-        tone: 'info',
-        message: 'Previewing this version. Use insert or swap to apply it.',
-      })
-    },
-    [selectAsset, setStatus],
-  )
-
-  const swapToVersion = useCallback(
-    async (
-      target: PlatformAssetSummary,
-      scope: 'document' | 'collection',
-    ): Promise<void> => {
-      if (!selectedAsset || !visible) return
-      if (selectedAsset.relativePath === target.relativePath) return
-
-      if (scope === 'document' && !currentDocumentFile) {
-        setStatus({
-          tone: 'error',
-          message: `Open a ${insertTargetLabel} before swapping references in it only.`,
-        })
-        return
-      }
-
-      setSwapping(true)
-      setStatus(null)
-      try {
-        const swapRequest = {
-          collectionPath,
-          fromRelativePath: selectedAsset.relativePath,
-          toRelativePath: target.relativePath,
-          scope,
-          documentFile:
-            scope === 'document' ? currentDocumentFile ?? undefined : undefined,
-        }
-        const result =
-          scope === 'collection' && documentFiles?.length
-            ? await swapCollectionAssetReferencesScoped({
-                ...swapRequest,
-                documentFiles,
-              })
-            : await swapCollectionAssetReferences(swapRequest)
-        await refreshAssets(target.id)
-        setStatus({
-          tone: 'success',
-          message:
-            scope === 'document'
-              ? `Replaced ${result.updatedReferences} reference${
-                  result.updatedReferences === 1 ? '' : 's'
-                } in this ${insertTargetLabel} with ${target.label}.`
-              : `Replaced ${result.updatedReferences} reference${
-                  result.updatedReferences === 1 ? '' : 's'
-                } across ${result.updatedDocuments} ${
-                  result.updatedDocuments === 1
-                    ? insertTargetLabel
-                    : `${insertTargetLabel}s`
-                } in this ${collectionLabel} with ${target.label}.`,
-        })
-      } catch (error) {
-        setStatus({ tone: 'error', message: messageForError(error) })
-      } finally {
-        setSwapping(false)
-      }
-    },
-    [
-      collectionLabel,
-      collectionPath,
-      currentDocumentFile,
-      documentFiles,
-      insertTargetLabel,
-      refreshAssets,
-      selectedAsset,
-      setStatus,
-      visible,
-    ],
-  )
-
-  return {
-    visible,
-    versions,
-    selectedRelativePath: selectedAsset?.relativePath ?? null,
-    previewVersion,
-    swapToVersion,
-    busy: swapping,
-    canSwapInDocument: Boolean(currentDocumentFile),
-    collectionLabel,
-    insertTargetLabel,
-  }
-}
+import { useCallback, useMemo, useState } from 'react'
+import {
+  swapCollectionAssetReferences,
+  swapCollectionAssetReferencesScoped,
+} from '../../../../bridge/assets.mjs'
+import type { PlatformAssetSummary } from '../../../../bridge/types.js'
+import { isFileCollectionAsset, messageForError } from '../helpers.js'
+import type { AssetLibraryStatus, AssetLibraryVersionsModel } from '../types.js'
+
+/**
+ * Version lineage + reference swap for file assets.
+ *
+ * Lineage is derived from the in-memory `assets` list (same filter as ps-book).
+ * TODO: When agents add versions while the dialog stays open, refresh via an
+ * explicit shell event or caller hook — not a background poll.
+ */
+export interface UseAssetLibraryVersionsOptions {
+  collectionPath: string
+  /** When set, collection-wide swaps use `assets.swapReferencesScoped`. */
+  documentFiles?: string[]
+  assets: PlatformAssetSummary[]
+  selectedAsset: PlatformAssetSummary | null
+  currentDocumentFile?: string | null
+  collectionLabel: string
+  insertTargetLabel: string
+  selectAsset: (assetId: string) => void
+  refreshAssets: (preferredId?: string | null) => Promise<void>
+  setStatus: (status: AssetLibraryStatus | null) => void
+}
+
+export function useAssetLibraryVersions({
+  collectionPath,
+  documentFiles,
+  assets,
+  selectedAsset,
+  currentDocumentFile,
+  collectionLabel,
+  insertTargetLabel,
+  selectAsset,
+  refreshAssets,
+  setStatus,
+}: UseAssetLibraryVersionsOptions): AssetLibraryVersionsModel {
+  const [swapping, setSwapping] = useState(false)
+
+  const visible = Boolean(selectedAsset && isFileCollectionAsset(selectedAsset))
+
+  const versions = useMemo(() => {
+    if (!selectedAsset || !visible) return []
+    return assets
+      .filter(asset => asset.lineageId === selectedAsset.lineageId)
+      .sort((left, right) => left.versionNumber - right.versionNumber)
+  }, [assets, selectedAsset, visible])
+
+  const previewVersion = useCallback(
+    (assetId: string): void => {
+      selectAsset(assetId)
+      setStatus({
+        tone: 'info',
+        message: 'Previewing this version. Use insert or swap to apply it.',
+      })
+    },
+    [selectAsset, setStatus],
+  )
+
+  const swapToVersion = useCallback(
+    async (
+      target: PlatformAssetSummary,
+      scope: 'document' | 'collection',
+    ): Promise<void> => {
+      if (!selectedAsset || !visible) return
+      if (selectedAsset.relativePath === target.relativePath) return
+
+      if (scope === 'document' && !currentDocumentFile) {
+        setStatus({
+          tone: 'error',
+          message: `Open a ${insertTargetLabel} before swapping references in it only.`,
+        })
+        return
+      }
+
+      setSwapping(true)
+      setStatus(null)
+      try {
+        const swapRequest = {
+          collectionPath,
+          fromRelativePath: selectedAsset.relativePath,
+          toRelativePath: target.relativePath,
+          scope,
+          documentFile:
+            scope === 'document' ? currentDocumentFile ?? undefined : undefined,
+        }
+        const result =
+          scope === 'collection' && documentFiles?.length
+            ? await swapCollectionAssetReferencesScoped({
+                ...swapRequest,
+                documentFiles,
+              })
+            : await swapCollectionAssetReferences(swapRequest)
+        await refreshAssets(target.id)
+        setStatus({
+          tone: 'success',
+          message:
+            scope === 'document'
+              ? `Replaced ${result.updatedReferences} reference${
+                  result.updatedReferences === 1 ? '' : 's'
+                } in this ${insertTargetLabel} with ${target.label}.`
+              : `Replaced ${result.updatedReferences} reference${
+                  result.updatedReferences === 1 ? '' : 's'
+                } across ${result.updatedDocuments} ${
+                  result.updatedDocuments === 1
+                    ? insertTargetLabel
+                    : `${insertTargetLabel}s`
+                } in this ${collectionLabel} with ${target.label}.`,
+        })
+      } catch (error) {
+        setStatus({ tone: 'error', message: messageForError(error) })
+      } finally {
+        setSwapping(false)
+      }
+    },
+    [
+      collectionLabel,
+      collectionPath,
+      currentDocumentFile,
+      documentFiles,
+      insertTargetLabel,
+      refreshAssets,
+      selectedAsset,
+      setStatus,
+      visible,
+    ],
+  )
+
+  return {
+    visible,
+    versions,
+    selectedRelativePath: selectedAsset?.relativePath ?? null,
+    previewVersion,
+    swapToVersion,
+    busy: swapping,
+    canSwapInDocument: Boolean(currentDocumentFile),
+    collectionLabel,
+    insertTargetLabel,
+  }
+}

package/src/components/assets/asset-library/hooks/useInlineAssetPreview.ts

@@ -1,44 +1,44 @@
-import { useEffect, useState } from 'react'
-import type { InlineAssetKind } from '../helpers/assetKind.js'
-import {
-  renderInlineAssetPreview,
-  type InlineAssetPreviewResult,
-} from '../../../../bridge/inlinePreview.js'
-
-export interface UseInlineAssetPreviewResult {
-  preview: InlineAssetPreviewResult | null
-  loading: boolean
-}
-
-export function useInlineAssetPreview(
-  kind: InlineAssetKind | null,
-  sourceCode: string,
-): UseInlineAssetPreviewResult {
-  const [preview, setPreview] = useState<InlineAssetPreviewResult | null>(null)
-  const [loading, setLoading] = useState(false)
-
-  useEffect(() => {
-    if (!kind) {
-      setPreview(null)
-      setLoading(false)
-      return
-    }
-
-    let cancelled = false
-    setLoading(true)
-
-    void renderInlineAssetPreview(kind, sourceCode)
-      .then(result => {
-        if (!cancelled) setPreview(result)
-      })
-      .finally(() => {
-        if (!cancelled) setLoading(false)
-      })
-
-    return () => {
-      cancelled = true
-    }
-  }, [kind, sourceCode])
-
-  return { preview, loading }
-}
+import { useEffect, useState } from 'react'
+import type { InlineAssetKind } from '../helpers/assetKind.js'
+import {
+  renderInlineAssetPreview,
+  type InlineAssetPreviewResult,
+} from '../../../../bridge/inlinePreview.js'
+
+export interface UseInlineAssetPreviewResult {
+  preview: InlineAssetPreviewResult | null
+  loading: boolean
+}
+
+export function useInlineAssetPreview(
+  kind: InlineAssetKind | null,
+  sourceCode: string,
+): UseInlineAssetPreviewResult {
+  const [preview, setPreview] = useState<InlineAssetPreviewResult | null>(null)
+  const [loading, setLoading] = useState(false)
+
+  useEffect(() => {
+    if (!kind) {
+      setPreview(null)
+      setLoading(false)
+      return
+    }
+
+    let cancelled = false
+    setLoading(true)
+
+    void renderInlineAssetPreview(kind, sourceCode)
+      .then(result => {
+        if (!cancelled) setPreview(result)
+      })
+      .finally(() => {
+        if (!cancelled) setLoading(false)
+      })
+
+    return () => {
+      cancelled = true
+    }
+  }, [kind, sourceCode])
+
+  return { preview, loading }
+}

package/src/components/assets/asset-library/index.ts

@@ -1,19 +1,19 @@
-export { AssetLibraryDialog } from './AssetLibraryDialog.js'
-export { AssetLibraryWorkspace } from './AssetLibraryWorkspace.js'
-export type {
-  AssetLibraryDialogProps,
-  AssetLibraryWorkspaceProps,
-  CollectionAssetDocumentAdapter,
-} from './types.js'
-
-export { DEFAULT_COLLECTION_FIGURES_DIR } from '../../../bridge/collectionAssets.js'
-export { DEFAULT_UPLOAD_RELATIVE_DIR } from './utils/uploadCollectionAsset.js'
-
-export type {
-  AssetLibraryFilter,
-  AssetLibrarySection,
-  AssetLibrarySortMode,
-} from './utils/assetLibraryUtils.js'
-
-export { useAssetLibraryDialog } from './hooks/useAssetLibraryDialog.js'
-export type { UseAssetLibraryDialogOptions } from './hooks/useAssetLibraryDialog.js'
+export { AssetLibraryDialog } from './AssetLibraryDialog.js'
+export { AssetLibraryWorkspace } from './AssetLibraryWorkspace.js'
+export type {
+  AssetLibraryDialogProps,
+  AssetLibraryWorkspaceProps,
+  CollectionAssetDocumentAdapter,
+} from './types.js'
+
+export { DEFAULT_COLLECTION_FIGURES_DIR } from '../../../bridge/collectionAssets.js'
+export { DEFAULT_UPLOAD_RELATIVE_DIR } from './utils/uploadCollectionAsset.js'
+
+export type {
+  AssetLibraryFilter,
+  AssetLibrarySection,
+  AssetLibrarySortMode,
+} from './utils/assetLibraryUtils.js'
+
+export { useAssetLibraryDialog } from './hooks/useAssetLibraryDialog.js'
+export type { UseAssetLibraryDialogOptions } from './hooks/useAssetLibraryDialog.js'