@typefm/react-markdown-viewer 0.1.0

package/dist/lib/highlighter.js

@@ -0,0 +1,421 @@
+/**
+ * Syntax highlighter using highlight.js with dynamic language loading
+ *
+ * Features:
+ * - Minimal core bundle (~8KB gzipped)
+ * - Dynamic language loading on demand with code-splitting
+ * - Event system for re-highlighting when languages load
+ * - LRU caching for performance
+ *
+ * @see https://highlightjs.org/
+ */
+import hljs from 'highlight.js/lib/core';
+import { cacheManager } from './cache-manager';
+// --------------------------------------------------------------------------
+// Bundled Languages (minimal set, always available)
+// --------------------------------------------------------------------------
+import plaintext from 'highlight.js/lib/languages/plaintext';
+hljs.registerLanguage('plaintext', plaintext);
+// --------------------------------------------------------------------------
+// Dynamic Language Import Map
+// Explicit imports enable bundler code-splitting and tree-shaking
+// --------------------------------------------------------------------------
+const LANGUAGE_LOADERS = {
+    // Web essentials
+    javascript: () => import('highlight.js/lib/languages/javascript'),
+    typescript: () => import('highlight.js/lib/languages/typescript'),
+    json: () => import('highlight.js/lib/languages/json'),
+    css: () => import('highlight.js/lib/languages/css'),
+    scss: () => import('highlight.js/lib/languages/scss'),
+    less: () => import('highlight.js/lib/languages/less'),
+    xml: () => import('highlight.js/lib/languages/xml'), // includes HTML
+    markdown: () => import('highlight.js/lib/languages/markdown'),
+    // Shell & config
+    bash: () => import('highlight.js/lib/languages/bash'),
+    shell: () => import('highlight.js/lib/languages/shell'),
+    yaml: () => import('highlight.js/lib/languages/yaml'),
+    ini: () => import('highlight.js/lib/languages/ini'),
+    dockerfile: () => import('highlight.js/lib/languages/dockerfile'),
+    nginx: () => import('highlight.js/lib/languages/nginx'),
+    makefile: () => import('highlight.js/lib/languages/makefile'),
+    // Data & query
+    sql: () => import('highlight.js/lib/languages/sql'),
+    graphql: () => import('highlight.js/lib/languages/graphql'),
+    // Systems programming
+    c: () => import('highlight.js/lib/languages/c'),
+    cpp: () => import('highlight.js/lib/languages/cpp'),
+    rust: () => import('highlight.js/lib/languages/rust'),
+    go: () => import('highlight.js/lib/languages/go'),
+    // JVM languages
+    java: () => import('highlight.js/lib/languages/java'),
+    kotlin: () => import('highlight.js/lib/languages/kotlin'),
+    scala: () => import('highlight.js/lib/languages/scala'),
+    // .NET
+    csharp: () => import('highlight.js/lib/languages/csharp'),
+    // Scripting languages
+    python: () => import('highlight.js/lib/languages/python'),
+    ruby: () => import('highlight.js/lib/languages/ruby'),
+    php: () => import('highlight.js/lib/languages/php'),
+    perl: () => import('highlight.js/lib/languages/perl'),
+    lua: () => import('highlight.js/lib/languages/lua'),
+    r: () => import('highlight.js/lib/languages/r'),
+    // Mobile
+    swift: () => import('highlight.js/lib/languages/swift'),
+    objectivec: () => import('highlight.js/lib/languages/objectivec'),
+    // Other
+    diff: () => import('highlight.js/lib/languages/diff'),
+    wasm: () => import('highlight.js/lib/languages/wasm'),
+    latex: () => import('highlight.js/lib/languages/latex'),
+    haskell: () => import('highlight.js/lib/languages/haskell'),
+    elixir: () => import('highlight.js/lib/languages/elixir'),
+    erlang: () => import('highlight.js/lib/languages/erlang'),
+    clojure: () => import('highlight.js/lib/languages/clojure'),
+    lisp: () => import('highlight.js/lib/languages/lisp'),
+    scheme: () => import('highlight.js/lib/languages/scheme'),
+    ocaml: () => import('highlight.js/lib/languages/ocaml'),
+    fsharp: () => import('highlight.js/lib/languages/fsharp'),
+    powershell: () => import('highlight.js/lib/languages/powershell'),
+    vim: () => import('highlight.js/lib/languages/vim'),
+    toml: () => import('highlight.js/lib/languages/ini'), // TOML uses ini grammar
+    delphi: () => import('highlight.js/lib/languages/delphi'), // Pascal/Delphi
+};
+// --------------------------------------------------------------------------
+// Language Aliases
+// --------------------------------------------------------------------------
+const LANGUAGE_ALIASES = {
+    // JavaScript
+    js: 'javascript',
+    jsx: 'javascript',
+    mjs: 'javascript',
+    cjs: 'javascript',
+    // TypeScript
+    ts: 'typescript',
+    tsx: 'typescript',
+    mts: 'typescript',
+    cts: 'typescript',
+    // Shell
+    sh: 'bash',
+    zsh: 'bash',
+    // Python
+    py: 'python',
+    py3: 'python',
+    python3: 'python',
+    // Ruby
+    rb: 'ruby',
+    // YAML
+    yml: 'yaml',
+    // Markup
+    htm: 'xml',
+    html: 'xml',
+    xhtml: 'xml',
+    svg: 'xml',
+    vue: 'xml',
+    // Config
+    jsonc: 'json',
+    json5: 'json',
+    // C family
+    h: 'c',
+    hpp: 'cpp',
+    cc: 'cpp',
+    cxx: 'cpp',
+    'c++': 'cpp',
+    // C#
+    cs: 'csharp',
+    // Dockerfile
+    docker: 'dockerfile',
+    // Makefile
+    mk: 'makefile',
+    // Objective-C
+    objc: 'objectivec',
+    'm': 'objectivec',
+    // F#
+    fs: 'fsharp',
+    // Pascal/Delphi
+    pascal: 'delphi',
+    pas: 'delphi',
+    // Text
+    text: 'plaintext',
+    txt: 'plaintext',
+    plain: 'plaintext',
+};
+function normalizeLanguage(lang) {
+    const lower = lang.toLowerCase();
+    return LANGUAGE_ALIASES[lower] ?? lower;
+}
+// --------------------------------------------------------------------------
+// State
+// --------------------------------------------------------------------------
+const registeredLanguages = new Set(['plaintext']);
+const loadingLanguages = new Map();
+const failedLanguages = new Set();
+const languageLoadListeners = new Set();
+// Batched notification state (avoids multiple re-renders when several languages load)
+let pendingNotifications = new Set();
+let notificationScheduled = false;
+// --------------------------------------------------------------------------
+// Dynamic Language Loading
+// --------------------------------------------------------------------------
+// Dev-only logging helper
+const isDev = process.env.NODE_ENV !== 'production';
+function devLog(message, ...args) {
+    if (isDev) {
+        console.log(`[hljs] ${message}`, ...args);
+    }
+}
+function devWarn(message, ...args) {
+    if (isDev) {
+        console.warn(`[hljs] ${message}`, ...args);
+    }
+}
+/**
+ * Load a language dynamically
+ * Returns a promise that resolves when the language is ready
+ */
+export async function loadLanguage(language) {
+    const normalized = normalizeLanguage(language);
+    // Already registered
+    if (registeredLanguages.has(normalized)) {
+        devLog(`✓ "${normalized}" already loaded`);
+        return true;
+    }
+    // Already failed
+    if (failedLanguages.has(normalized)) {
+        devLog(`✗ "${normalized}" previously failed, skipping`);
+        return false;
+    }
+    // Already loading - wait for it
+    const existing = loadingLanguages.get(normalized);
+    if (existing) {
+        devLog(`⏳ "${normalized}" already loading, waiting...`);
+        await existing;
+        return registeredLanguages.has(normalized);
+    }
+    // Check if we have a loader for this language
+    const loader = LANGUAGE_LOADERS[normalized];
+    if (!loader) {
+        devWarn(`✗ "${normalized}" not supported (no loader available)`);
+        failedLanguages.add(normalized);
+        return false;
+    }
+    // Start loading
+    devLog(`⏳ "${normalized}" loading...`);
+    const startTime = performance.now();
+    const loadPromise = (async () => {
+        try {
+            const module = await loader();
+            hljs.registerLanguage(normalized, module.default);
+            registeredLanguages.add(normalized);
+            const duration = (performance.now() - startTime).toFixed(1);
+            devLog(`✓ "${normalized}" loaded in ${duration}ms`);
+            // Notify listeners
+            notifyLanguageLoaded(normalized);
+        }
+        catch (error) {
+            failedLanguages.add(normalized);
+            devWarn(`✗ "${normalized}" failed to load:`, error);
+        }
+        finally {
+            loadingLanguages.delete(normalized);
+        }
+    })();
+    loadingLanguages.set(normalized, loadPromise);
+    await loadPromise;
+    return registeredLanguages.has(normalized);
+}
+/**
+ * Load multiple languages in parallel
+ */
+export async function loadLanguages(languages) {
+    const unique = [...new Set(languages.map(normalizeLanguage))];
+    const toLoad = unique.filter(lang => !registeredLanguages.has(lang) &&
+        !failedLanguages.has(lang) &&
+        LANGUAGE_LOADERS[lang]);
+    if (toLoad.length > 0) {
+        devLog(`⏳ Loading ${toLoad.length} languages in parallel: [${toLoad.join(', ')}]`);
+        const startTime = performance.now();
+        await Promise.all(toLoad.map(loadLanguage));
+        const duration = (performance.now() - startTime).toFixed(1);
+        devLog(`✓ Parallel load complete in ${duration}ms`);
+    }
+}
+/**
+ * Highlight code synchronously if language is available
+ * Triggers async language load if not available
+ *
+ * @param code - Source code to highlight
+ * @param language - Language identifier
+ * @returns Highlighted HTML and status
+ */
+export function highlightCode(code, language) {
+    if (!code) {
+        return { html: '', language: 'plaintext', isHighlighted: false };
+    }
+    if (!language) {
+        return { html: escapeHtml(code), language: 'plaintext', isHighlighted: false };
+    }
+    const normalized = normalizeLanguage(language);
+    if (normalized === 'plaintext') {
+        return { html: escapeHtml(code), language: 'plaintext', isHighlighted: true };
+    }
+    // Check cache
+    const cacheKey = `${normalized}:${code}`;
+    const cached = cacheManager.highlightCache.get(cacheKey);
+    if (cached !== undefined) {
+        return { html: cached, language: normalized, isHighlighted: true };
+    }
+    // Check if language is registered
+    if (!registeredLanguages.has(normalized)) {
+        // Trigger async load (non-blocking)
+        if (LANGUAGE_LOADERS[normalized] && !failedLanguages.has(normalized)) {
+            loadLanguage(normalized); // Fire and forget
+        }
+        else if (!failedLanguages.has(normalized)) {
+            // Unknown language - log warning and mark as failed
+            devWarn(`✗ "${normalized}" not supported (no loader available)`);
+            failedLanguages.add(normalized);
+        }
+        return { html: escapeHtml(code), language: normalized, isHighlighted: false };
+    }
+    // Highlight synchronously
+    try {
+        const result = hljs.highlight(code, {
+            language: normalized,
+            ignoreIllegals: true,
+        });
+        cacheManager.highlightCache.set(cacheKey, result.value);
+        return { html: result.value, language: normalized, isHighlighted: true };
+    }
+    catch {
+        return { html: escapeHtml(code), language: normalized, isHighlighted: false };
+    }
+}
+/**
+ * Simple highlight that returns just the HTML string
+ * For use in parser where we don't need status info
+ */
+export function highlight(code, language) {
+    return highlightCode(code, language).html;
+}
+// --------------------------------------------------------------------------
+// Event System
+// --------------------------------------------------------------------------
+/**
+ * Subscribe to language load events
+ */
+export function onLanguageLoaded(listener) {
+    languageLoadListeners.add(listener);
+}
+/**
+ * Unsubscribe from language load events
+ */
+export function offLanguageLoaded(listener) {
+    languageLoadListeners.delete(listener);
+}
+// Track the last notification generation so late subscribers can detect missed notifications
+let notificationGeneration = 0;
+function notifyLanguageLoaded(language) {
+    // Collect language and its aliases for notification
+    pendingNotifications.add(language);
+    for (const [alias, target] of Object.entries(LANGUAGE_ALIASES)) {
+        if (target === language) {
+            pendingNotifications.add(alias);
+        }
+    }
+    // Batch notifications using microtask to avoid multiple re-renders
+    // when several languages load in parallel
+    if (!notificationScheduled) {
+        notificationScheduled = true;
+        queueMicrotask(() => {
+            const languages = [...pendingNotifications];
+            pendingNotifications.clear();
+            notificationScheduled = false;
+            notificationGeneration++;
+            const listenerCount = languageLoadListeners.size;
+            if (listenerCount > 0) {
+                devLog(`📢 Notifying ${listenerCount} listener(s) for [${languages.join(', ')}]`);
+            }
+            // Notify once per listener (not per language)
+            // Listener receives first language but all are now available
+            languageLoadListeners.forEach(listener => {
+                try {
+                    listener(languages[0]);
+                }
+                catch (error) {
+                    console.error('[hljs] Error in language load listener:', error);
+                }
+            });
+        });
+    }
+}
+/**
+ * Get the current notification generation.
+ * Used by late subscribers to detect if they missed a notification
+ * (e.g., useEffect subscribes after paint, but languages loaded before paint).
+ */
+export function getNotificationGeneration() {
+    return notificationGeneration;
+}
+// --------------------------------------------------------------------------
+// Registration API
+// --------------------------------------------------------------------------
+/**
+ * Register a custom language not in the dynamic loader map
+ */
+export function registerLanguage(name, languageFn) {
+    const normalized = normalizeLanguage(name);
+    if (registeredLanguages.has(normalized)) {
+        devLog(`✓ "${normalized}" already registered`);
+        return;
+    }
+    hljs.registerLanguage(normalized, languageFn);
+    registeredLanguages.add(normalized);
+    failedLanguages.delete(normalized);
+    devLog(`✓ "${normalized}" registered (custom)`);
+    notifyLanguageLoaded(normalized);
+}
+// --------------------------------------------------------------------------
+// Utilities
+// --------------------------------------------------------------------------
+const HTML_ESCAPE_MAP = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+const HTML_ESCAPE_RE = /[&<>"']/g;
+function escapeHtml(text) {
+    return text.replace(HTML_ESCAPE_RE, char => HTML_ESCAPE_MAP[char]);
+}
+/**
+ * Check if a language is available (registered)
+ */
+export function isLanguageReady(language) {
+    return registeredLanguages.has(normalizeLanguage(language));
+}
+/**
+ * Check if a language can be loaded dynamically
+ */
+export function isLanguageSupported(language) {
+    const normalized = normalizeLanguage(language);
+    return registeredLanguages.has(normalized) || normalized in LANGUAGE_LOADERS;
+}
+/**
+ * Get all registered languages
+ */
+export function getRegisteredLanguages() {
+    return Array.from(registeredLanguages);
+}
+/**
+ * Get all supported languages (registered + loadable)
+ */
+export function getSupportedLanguages() {
+    return [...new Set([...registeredLanguages, ...Object.keys(LANGUAGE_LOADERS)])];
+}
+/**
+ * Clear highlight cache
+ */
+export function clearHighlightCache() {
+    cacheManager.highlightCache.clear();
+}
+//# sourceMappingURL=highlighter.js.map

package/dist/lib/highlighter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlighter.js","sourceRoot":"","sources":["../../src/lib/highlighter.ts"],"names":[],"mappings":"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"}

package/dist/lib/hook-utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Utilities for processing hook results.
+ *
+ * @module lib/hook-utils
+ */
+import type { HookResult } from "../types/hooks";
+/**
+ * Escape HTML special characters to prevent XSS.
+ *
+ * Use this when inserting user content into HTML strings in hooks.
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for HTML insertion
+ *
+ * @example
+ * import { escapeHtml } from '@typefm/react-markdown-viewer';
+ *
+ * const hooks: RenderHooks = {
+ *   onCodeBlock: ({ code, language }) =>
+ *     `<pre data-lang="${escapeHtml(language || '')}">${escapeHtml(code)}</pre>`,
+ * };
+ */
+export declare function escapeHtml(str: string): string;
+/**
+ * Resolve a hook result to a string or null.
+ *
+ * Hooks return `string | null`:
+ * - `string` → HTML to insert (direct, fast)
+ * - `null` → Use the default processor
+ */
+export declare function resolveHookResult(result: HookResult): string | null;
+//# sourceMappingURL=hook-utils.d.ts.map

package/dist/lib/hook-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-utils.d.ts","sourceRoot":"","sources":["../../src/lib/hook-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAGnE"}

package/dist/lib/hook-utils.js

@@ -0,0 +1,42 @@
+/**
+ * Utilities for processing hook results.
+ *
+ * @module lib/hook-utils
+ */
+/**
+ * Escape HTML special characters to prevent XSS.
+ *
+ * Use this when inserting user content into HTML strings in hooks.
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for HTML insertion
+ *
+ * @example
+ * import { escapeHtml } from '@typefm/react-markdown-viewer';
+ *
+ * const hooks: RenderHooks = {
+ *   onCodeBlock: ({ code, language }) =>
+ *     `<pre data-lang="${escapeHtml(language || '')}">${escapeHtml(code)}</pre>`,
+ * };
+ */
+export function escapeHtml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+/**
+ * Resolve a hook result to a string or null.
+ *
+ * Hooks return `string | null`:
+ * - `string` → HTML to insert (direct, fast)
+ * - `null` → Use the default processor
+ */
+export function resolveHookResult(result) {
+    if (typeof result === "string")
+        return result;
+    return null;
+}
+//# sourceMappingURL=hook-utils.js.map

package/dist/lib/hook-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-utils.js","sourceRoot":"","sources":["../../src/lib/hook-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACrC,OAAO,GAAG;SACR,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IACnD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/lib/html.d.ts

@@ -0,0 +1,2 @@
+export declare function decodeHtml(html: string): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/lib/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/lib/html.ts"],"names":[],"mappings":"AASA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/lib/html.js

@@ -0,0 +1,12 @@
+const HTML_ENTITY_MAP = {
+    '&lt;': '<',
+    '&gt;': '>',
+    '&quot;': '"',
+    '&#39;': "'",
+    '&amp;': '&'
+};
+const HTML_ENTITY_RE = /&lt;|&gt;|&quot;|&#39;|&amp;/g;
+export function decodeHtml(html) {
+    return html.replace(HTML_ENTITY_RE, (match) => HTML_ENTITY_MAP[match]);
+}
+//# sourceMappingURL=html.js.map

package/dist/lib/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/lib/html.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAA2B;IAC9C,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;CACb,CAAC;AACF,MAAM,cAAc,GAAG,+BAA+B,CAAC;AAEvD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/lib/morph.d.ts

@@ -0,0 +1,57 @@
+interface MorphStats {
+    updated: number;
+    skipped: number;
+    added: number;
+    removed: number;
+}
+/**
+ * Morph the content of an element using Idiomorph
+ * Uses requestAnimationFrame to batch updates and prevent jank
+ *
+ * @param element The container element to morph
+ * @param newHtml The new HTML content
+ */
+export declare function morphContent(element: Element, newHtml: string): void;
+/**
+ * Morph content synchronously (for testing or immediate updates)
+ *
+ * @param element The container element to morph
+ * @param newHtml The new HTML content
+ */
+export declare function morphContentSync(element: Element, newHtml: string): void;
+/**
+ * Reset morph state for a specific container, or clear all pending operations
+ *
+ * @param container Optional container to reset state for
+ */
+export declare function resetMorphCache(container?: Element): void;
+/**
+ * Get morph stats for a specific container
+ *
+ * @param container The container to get stats for
+ * @returns Stats from the last morph operation on this container
+ */
+export declare function getMorphStats(container?: Element): MorphStats;
+/**
+ * Optimized morph that skips unchanged elements
+ *
+ * Strategy:
+ * 1. Parse new HTML into temp container
+ * 2. Hash each top-level element
+ * 3. Compare with previous hashes for this container
+ * 4. Only morph elements that changed
+ *
+ * @param container The container element to morph
+ * @param newHtml The new HTML content
+ * @returns true if any elements were updated
+ */
+export declare function morphContentOptimized(container: Element, newHtml: string): boolean;
+/**
+ * Reset element-level morph state for a container
+ * Note: Usually not needed since WeakMap auto-cleans when element is GC'd
+ *
+ * @param container Optional container to reset (if omitted, does nothing - use resetMorphCache)
+ */
+export declare function resetElementMorphState(container?: Element): void;
+export {};
+//# sourceMappingURL=morph.d.ts.map

package/dist/lib/morph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morph.d.ts","sourceRoot":"","sources":["../../src/lib/morph.ts"],"names":[],"mappings":"AAoBA,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAsDD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA2BpE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CASxE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAazD;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,CAM7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAyDlF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAIhE"}