feat: Новый кросс платформенный вьювер

src/viewer/source.ts

@@ -0,0 +1,107 @@
+import type {
+  SpriteViewerManifest,
+  SpriteViewerManifestIcon,
+  SpriteViewerManifestLoader,
+  SpriteViewerRemoteSource,
+  SpriteViewerSource,
+  SpriteViewerSources,
+} from './types.js'
+
+const manifestLoaderCache = new WeakMap<SpriteViewerManifestLoader, Promise<SpriteViewerManifest>>()
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object'
+}
+
+function isManifestIcon(value: unknown): value is SpriteViewerManifestIcon {
+  if (!isRecord(value)) return false
+  return typeof value.name === 'string'
+    && typeof value.id === 'string'
+    && (value.viewBox === null || typeof value.viewBox === 'string')
+    && Array.isArray(value.colors)
+}
+
+export function isSpriteViewerManifest(value: unknown): value is SpriteViewerManifest {
+  if (!isRecord(value)) return false
+  return value.schemaVersion === 1
+    && value.generator === '@gromlab/svg-sprites'
+    && typeof value.name === 'string'
+    && typeof value.target === 'string'
+    && (value.format === 'stack' || value.format === 'symbol')
+    && typeof value.iconCount === 'number'
+    && typeof value.spriteUrl === 'string'
+    && Array.isArray(value.icons)
+    && value.icons.every(isManifestIcon)
+}
+
+function isManifestData(value: unknown): value is Omit<SpriteViewerManifest, 'spriteUrl'> {
+  return isRecord(value)
+    && value.schemaVersion === 1
+    && value.generator === '@gromlab/svg-sprites'
+    && typeof value.name === 'string'
+    && typeof value.target === 'string'
+    && (value.format === 'stack' || value.format === 'symbol')
+    && typeof value.iconCount === 'number'
+    && Array.isArray(value.icons)
+    && value.icons.every(isManifestIcon)
+}
+
+function manifestCandidate(value: unknown): unknown {
+  if (!isRecord(value)) return value
+  if (isSpriteViewerManifest(value) || isManifestData(value)) return value
+  return value.default ?? value.spriteManifest ?? value
+}
+
+export function normalizeSpriteViewerManifest(value: unknown, spriteUrl?: string): SpriteViewerManifest {
+  const candidate = manifestCandidate(value)
+  if (isSpriteViewerManifest(candidate)) return candidate
+  if (spriteUrl && isManifestData(candidate)) return { ...candidate, spriteUrl }
+  throw new Error('The loaded source does not contain a valid SVG sprite manifest.')
+}
+
+export function sourceArray(sources: SpriteViewerSources): readonly SpriteViewerSource[] {
+  return Array.isArray(sources)
+    ? sources
+    : Object.values(sources as Readonly<Record<string, SpriteViewerSource>>)
+}
+
+export function isRemoteSource(source: SpriteViewerSource): source is SpriteViewerRemoteSource {
+  if (!isRecord(source)) return false
+  const candidate = source as Record<string, unknown>
+  return typeof candidate.manifestUrl === 'string'
+    && typeof candidate.spriteUrl === 'string'
+}
+
+export function directManifests(sources: SpriteViewerSources): SpriteViewerManifest[] {
+  return sourceArray(sources)
+    .filter((source) => typeof source !== 'function' && !isRemoteSource(source))
+    .map((source) => normalizeSpriteViewerManifest(source))
+    .sort(compareManifests)
+}
+
+export function compareManifests(left: SpriteViewerManifest, right: SpriteViewerManifest): number {
+  return left.name < right.name ? -1 : left.name > right.name ? 1 : 0
+}
+
+async function loadRemoteSource(source: SpriteViewerRemoteSource): Promise<SpriteViewerManifest> {
+  const response = await fetch(source.manifestUrl)
+  if (!response.ok) {
+    throw new Error(`Cannot load SVG sprite manifest: ${response.status} ${response.statusText}`)
+  }
+  return normalizeSpriteViewerManifest(await response.json(), source.spriteUrl)
+}
+
+export async function resolveViewerSource(source: SpriteViewerSource): Promise<SpriteViewerManifest> {
+  if (isRemoteSource(source)) return loadRemoteSource(source)
+  if (typeof source !== 'function') return normalizeSpriteViewerManifest(source)
+
+  const cached = manifestLoaderCache.get(source)
+  if (cached) return cached
+
+  const pending = Promise.resolve().then(source).then((value) => normalizeSpriteViewerManifest(value))
+  manifestLoaderCache.set(source, pending)
+  void pending.catch(() => {
+    if (manifestLoaderCache.get(source) === pending) manifestLoaderCache.delete(source)
+  })
+  return pending
+}