AI-native design editor. Open-source Figma alternative.
import { computed, onScopeDispose, ref, watch, type Ref } from 'vue'
import type { EditorStore } from '@/app/editor/session'
import { notificationMessages } from '@/app/i18n/notifications'
import { createActiveStorageAdapter, storagePreferencesComplete } from '@/app/integrations/storage'
import { activeStorageProviderID } from '@/app/integrations/storage/preferences'
import {
readLibraryCatalogSource,
readLibraryPriority,
StorageLibraryCatalog,
type LibraryService
} from '@/app/libraries'
import type { LibraryAssetUpdateGroup } from '@/app/libraries/update-groups'
import { scopeLibraryUpdateGroups } from '@/app/libraries/update-groups'
import { toast } from '@/app/shell/ui'
function errorDetail(cause: unknown): string {
return cause instanceof Error ? cause.message : String(cause)
}
export function useLibraryManager(
open: Ref<boolean>,
editor: EditorStore,
service: LibraryService
) {
const section = ref<'browse' | 'updates'>('browse')
const loading = ref(false)
const showAllPages = ref(false)
const applying = ref<string | null>(null)
const updateGroups = ref<LibraryAssetUpdateGroup[]>([])
/**
* Whether this opening's first read has finished. The dialog shows once it has, so it never
* opens on the previous opening's updates, or on none, and then fills in.
*/
const ready = ref(false)
let requestId = 0
watch(
open,
(isOpen) => {
if (!isOpen) return
ready.value = false
// A read still running from before this opening must not mark it ready.
requestId++
},
{ flush: 'sync' }
)
const visibleUpdateGroups = computed(() =>
scopeLibraryUpdateGroups(editor, updateGroups.value, showAllPages.value)
)
async function refresh() {
const request = ++requestId
loading.value = true
let read = false
try {
await service.refresh(editor)
const groups = await service.getUpdateGroups(editor)
if (request === requestId) updateGroups.value = groups
read = true
} catch (cause) {
if (request === requestId) {
toast.error(notificationMessages.get().operationFailed({ error: errorDetail(cause) }))
}
} finally {
if (request === requestId) {
loading.value = false
// A first read that failed has nothing current to show, so the dialog does not open.
if (read || ready.value) ready.value = true
else open.value = false
}
}
}
async function runOperation(operation: () => Promise<void>): Promise<void> {
try {
await operation()
} catch (cause) {
toast.error(notificationMessages.get().operationFailed({ error: errorDetail(cause) }))
}
}
async function setSource(source: 'local' | 'storage') {
await runOperation(async () => {
if (source === 'local') service.useLocalCatalog()
else {
const providerId = activeStorageProviderID.value
if (!storagePreferencesComplete(providerId)) throw new Error('Storage is not configured')
const objects = createActiveStorageAdapter(providerId).libraryObjects
if (!objects) throw new Error('Storage libraries are unavailable')
service.useStorageCatalog(new StorageLibraryCatalog(objects))
}
await refresh()
})
}
async function toggleLibrary(libraryId: string) {
loading.value = true
try {
await runOperation(async () => {
if (editor.graph.enabledLibraries.get(libraryId)?.enabled)
await service.disable(editor, libraryId)
else await service.enable(editor, libraryId)
await refresh()
})
} finally {
loading.value = false
}
}
function preferLibrary(libraryId: string) {
const priority = Math.max(
0,
...service.summaries.value.map((item) => readLibraryPriority(item.libraryId))
)
service.setPriority(libraryId, priority + 1)
}
async function updateAsset(group: LibraryAssetUpdateGroup) {
applying.value = `${group.libraryId}:${group.assetKey}`
try {
await runOperation(async () => {
await service.applyUpdateGroups(editor, [group], `Update ${group.name}`)
await refresh()
})
} finally {
applying.value = null
}
}
async function updateAll() {
applying.value = 'all'
try {
await runOperation(async () => {
await service.applyUpdateGroups(
editor,
visibleUpdateGroups.value,
'Update all library assets'
)
await refresh()
})
} finally {
applying.value = null
}
}
watch(
() => [open.value, editor.state.currentPageId] as const,
([isOpen]) => {
if (isOpen) void refresh()
},
{ immediate: true }
)
// A collaborator's change to the document's libraries shows while the manager is open.
onScopeDispose(
editor.onEditorEvent('document:libraries-changed', () => {
if (open.value) void refresh()
})
)
const source = readLibraryCatalogSource()
if (source === 'storage' && !open.value) void setSource('storage')
return {
section,
loading,
ready,
showAllPages,
applying,
visibleUpdateGroups,
refresh,
setSource,
toggleLibrary,
preferLibrary,
updateAsset,
updateAll
}
}