// Framework-neutral port of @antfu/design's `DisplayIconifyRemoteIcon`:
// https://github.com/antfu/design/blob/main/packages/design/components/Display/DisplayIconifyRemoteIcon.vue
//
// Resolves a devframe dock `icon` (an Iconify `collection:icon` id, e.g.
// `ph:git-branch-duotone`) to its live, sanitized SVG markup, fetched from the
// public `api.iconify.design` CDN. Unlike a UnoCSS `preset-icons` class, this
// needs no `@iconify-json/*` collection installed and no hand-maintained
// id -> class table, since any Iconify id just works, at the cost of a network
// round-trip on first render. We reuse @antfu/design's own fetcher, cache and
// sanitizer (`utils/iconify.ts`) rather than reimplementing them; only the id
// parsing and light/dark selection below are devframe-specific, mirroring the
// upstream Vue component's own `icon` prop parsing. Vue surfaces should render
// `DisplayIconifyRemoteIcon` directly instead of using this port.
import { getIconifySvg } from '@antfu/design/utils/iconify'
// Mirrors DisplayIconifyRemoteIcon.vue's own `collection:icon` parse (with an
// optional `i-` prefix tolerated so a UnoCSS-style id also works).
const ICONIFY_ID = /^(?:i-)?([\w-]+):([\w-]+)$/
/**
* Resolve a dock icon (a `collection:icon` string, or a `{ light, dark }`
* pair whose `light` variant is fetched) to its sanitized SVG markup.
*
* Returns `undefined` when the id doesn't parse or the fetch fails, so the
* caller can fall back to a text initial.
*
* @example
* await dockIconSvg('ph:git-branch-duotone') // → ''
*/
export async function dockIconSvg(name: string | { light: string, dark: string } | undefined): Promise {
const id = typeof name === 'string'
? name
: name?.light
if (!id)
return undefined
const match = id.match(ICONIFY_ID)
if (!match)
return undefined
try {
return await getIconifySvg(match[1]!, match[2]!)
}
catch {
// A failed fetch (offline / flaky CDN) degrades to the text-initial
// fallback, not a thrown error out of a render path.
return undefined
}
}