uxinspect 0.2.0 → 0.11.0

package/dist/hreflang-audit.js

@@ -0,0 +1,273 @@
+const LANG_CODE_RE = /^(x-default|[a-z]{2,3}(-[A-Z]{2})?)$/;
+const LANG_CODE_CI_RE = /^(x-default|[a-z]{2,3}(-[a-zA-Z]{2})?)$/i;
+const KNOWN_ISO_639_1 = new Set([
+    'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'pl', 'ru', 'uk',
+    'ja', 'zh', 'ko', 'ar', 'he', 'tr', 'hi', 'bn', 'id', 'vi',
+    'th', 'sv', 'no', 'da', 'fi', 'cs', 'el', 'hu', 'ro', 'bg',
+    'sk', 'hr', 'sr', 'sl', 'lt', 'lv', 'et', 'ms', 'fa', 'ur',
+]);
+const KNOWN_ISO_3166 = new Set([
+    'US', 'GB', 'CA', 'AU', 'NZ', 'IE', 'IN', 'ZA',
+    'DE', 'AT', 'CH', 'FR', 'BE', 'LU', 'ES', 'MX', 'AR', 'BR',
+    'PT', 'IT', 'NL', 'PL', 'RU', 'UA', 'JP', 'CN', 'TW', 'HK',
+    'KR', 'SG', 'MY', 'ID', 'TH', 'VN', 'PH', 'TR', 'IL', 'AE',
+    'SA', 'EG', 'SE', 'NO', 'DK', 'FI', 'CZ', 'GR', 'HU', 'RO',
+]);
+async function readDom(page) {
+    return await page.evaluate(() => {
+        const nodes = Array.from(document.querySelectorAll('link[rel=alternate][hreflang]'));
+        const links = [];
+        for (const node of nodes) {
+            links.push({
+                lang: node.getAttribute('hreflang') ?? '',
+                href: node.getAttribute('href') ?? '',
+            });
+        }
+        const can = document.querySelector('link[rel=canonical]');
+        return { links, canonical: can?.getAttribute('href') ?? null };
+    });
+}
+function isAbsoluteUrl(href) {
+    return /^https?:\/\//i.test(href);
+}
+function normalizeUrl(raw, base) {
+    try {
+        const u = base ? new URL(raw, base) : new URL(raw);
+        u.protocol = u.protocol.toLowerCase();
+        u.hostname = u.hostname.toLowerCase();
+        u.hash = '';
+        const path = u.pathname.length > 1 && u.pathname.endsWith('/')
+            ? u.pathname.slice(0, -1)
+            : u.pathname;
+        u.pathname = path;
+        return u.toString();
+    }
+    catch {
+        return raw;
+    }
+}
+function validateLang(lang, href, issues) {
+    if (!lang) {
+        issues.push({
+            kind: 'invalid-lang-code',
+            lang,
+            href,
+            detail: 'empty hreflang attribute',
+        });
+        return { valid: false, base: '' };
+    }
+    if (!LANG_CODE_CI_RE.test(lang)) {
+        issues.push({
+            kind: 'invalid-lang-code',
+            lang,
+            href,
+            detail: `hreflang "${lang}" does not match ^(x-default|[a-z]{2,3}(-[A-Z]{2})?)$`,
+        });
+        return { valid: false, base: '' };
+    }
+    if (!LANG_CODE_RE.test(lang) && lang !== 'x-default') {
+        const parts = lang.split('-');
+        if (parts.length === 2) {
+            issues.push({
+                kind: 'wrong-region-format',
+                lang,
+                href,
+                detail: `region "${parts[1]}" must be uppercase ISO 3166 alpha-2 (e.g. "${parts[0]}-${parts[1].toUpperCase()}")`,
+            });
+        }
+        else {
+            issues.push({
+                kind: 'invalid-lang-code',
+                lang,
+                href,
+                detail: `hreflang "${lang}" has invalid casing`,
+            });
+        }
+        return { valid: false, base: '' };
+    }
+    if (lang === 'x-default')
+        return { valid: true, base: 'x-default' };
+    const [base, region] = lang.split('-');
+    if (!KNOWN_ISO_639_1.has(base)) {
+        issues.push({
+            kind: 'unknown-iso-code',
+            lang,
+            href,
+            detail: `language "${base}" is not in the known ISO 639-1 list`,
+        });
+    }
+    if (region && !KNOWN_ISO_3166.has(region)) {
+        issues.push({
+            kind: 'unknown-iso-code',
+            lang,
+            href,
+            detail: `region "${region}" is not in the known ISO 3166 alpha-2 list`,
+        });
+    }
+    return { valid: true, base };
+}
+function extractHreflangsFromHtml(html) {
+    const out = [];
+    const tagRe = /<link\b[^>]*\brel\s*=\s*["']?alternate["']?[^>]*>/gi;
+    let match;
+    while ((match = tagRe.exec(html)) !== null) {
+        const tag = match[0];
+        const langMatch = /\bhreflang\s*=\s*["']([^"']+)["']/i.exec(tag);
+        const hrefMatch = /\bhref\s*=\s*["']([^"']+)["']/i.exec(tag);
+        if (langMatch && hrefMatch) {
+            out.push({ lang: langMatch[1], href: hrefMatch[1] });
+        }
+    }
+    return out;
+}
+async function fetchHtml(url) {
+    try {
+        const res = await fetch(url, {
+            signal: AbortSignal.timeout(5000),
+            redirect: 'follow',
+        });
+        if (!res.ok)
+            return null;
+        return await res.text();
+    }
+    catch {
+        return null;
+    }
+}
+async function checkReciprocal(originHref, entries, issues, maxFollows) {
+    const originNorm = normalizeUrl(originHref);
+    const targets = entries.filter((e) => e.lang !== 'x-default').slice(0, maxFollows);
+    for (const target of targets) {
+        if (!isAbsoluteUrl(target.href))
+            continue;
+        if (normalizeUrl(target.href) === originNorm)
+            continue;
+        const html = await fetchHtml(target.href);
+        if (html === null) {
+            issues.push({
+                kind: 'reciprocal-missing',
+                lang: target.lang,
+                href: target.href,
+                detail: `could not fetch "${target.href}" to verify reciprocal hreflang`,
+            });
+            continue;
+        }
+        const remote = extractHreflangsFromHtml(html);
+        const hasBack = remote.some((r) => {
+            try {
+                return normalizeUrl(r.href, target.href) === originNorm;
+            }
+            catch {
+                return false;
+            }
+        });
+        if (!hasBack) {
+            issues.push({
+                kind: 'reciprocal-missing',
+                lang: target.lang,
+                href: target.href,
+                detail: `target "${target.href}" does not hreflang back to origin "${originHref}"`,
+            });
+        }
+    }
+}
+export async function auditHreflang(page, opts) {
+    const followUrls = opts?.followUrls ?? false;
+    const maxFollows = opts?.maxFollows ?? 10;
+    const pageUrl = page.url();
+    const issues = [];
+    const entries = [];
+    const dom = await readDom(page);
+    const seenLangs = new Map();
+    for (const link of dom.links) {
+        entries.push({ lang: link.lang, href: link.href, source: 'link' });
+        const validation = validateLang(link.lang, link.href, issues);
+        if (!link.href) {
+            issues.push({
+                kind: 'non-absolute-url',
+                lang: link.lang,
+                href: link.href,
+                detail: 'empty href attribute',
+            });
+        }
+        else if (!isAbsoluteUrl(link.href)) {
+            issues.push({
+                kind: 'non-absolute-url',
+                lang: link.lang,
+                href: link.href,
+                detail: `href "${link.href}" must be an absolute URL (http:// or https://)`,
+            });
+        }
+        if (validation.valid) {
+            const key = link.lang.toLowerCase();
+            seenLangs.set(key, (seenLangs.get(key) ?? 0) + 1);
+        }
+    }
+    for (const [lang, count] of seenLangs) {
+        if (count > 1) {
+            issues.push({
+                kind: 'duplicate-lang',
+                lang,
+                detail: `hreflang "${lang}" appears ${count} times`,
+            });
+        }
+    }
+    const hasXDefault = entries.some((e) => e.lang.toLowerCase() === 'x-default');
+    const langCount = entries.filter((e) => e.lang.toLowerCase() !== 'x-default').length;
+    if (langCount >= 2 && !hasXDefault) {
+        issues.push({
+            kind: 'missing-x-default',
+            detail: `found ${langCount} hreflang entries but no x-default`,
+        });
+    }
+    const canonicalAbs = dom.canonical
+        ? (() => { try {
+            return new URL(dom.canonical, pageUrl).toString();
+        }
+        catch {
+            return pageUrl;
+        } })()
+        : pageUrl;
+    const selfNorm = normalizeUrl(canonicalAbs);
+    const pageNorm = normalizeUrl(pageUrl);
+    const selfListed = entries.some((e) => {
+        if (!isAbsoluteUrl(e.href))
+            return false;
+        const n = normalizeUrl(e.href);
+        return n === selfNorm || n === pageNorm;
+    });
+    if (entries.length > 0 && !selfListed) {
+        issues.push({
+            kind: 'self-reference-missing',
+            detail: `current page "${pageUrl}" is not listed among hreflang entries`,
+        });
+    }
+    if (dom.canonical) {
+        const canonicalNorm = normalizeUrl(dom.canonical, pageUrl);
+        const anyCanonical = entries.some((e) => {
+            if (!isAbsoluteUrl(e.href))
+                return false;
+            return normalizeUrl(e.href) === canonicalNorm;
+        });
+        if (entries.length > 0 && !anyCanonical && canonicalNorm !== pageNorm) {
+            issues.push({
+                kind: 'non-canonical-url',
+                detail: `canonical "${dom.canonical}" does not match any hreflang href`,
+            });
+        }
+    }
+    let reciprocalChecked = false;
+    if (followUrls && entries.length > 0) {
+        reciprocalChecked = true;
+        await checkReciprocal(canonicalAbs, entries, issues, maxFollows);
+    }
+    return {
+        page: pageUrl,
+        entries,
+        issues,
+        hasXDefault,
+        reciprocalChecked,
+        passed: issues.length === 0,
+    };
+}
+//# sourceMappingURL=hreflang-audit.js.map

package/dist/hreflang-audit.js.map

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

package/dist/hydration-audit.d.ts

@@ -0,0 +1,21 @@
+import type { Page } from 'playwright';
+export interface HydrationIssue {
+    kind: 'framework-warning' | 'dom-mismatch' | 'hydration-failure' | 'suspense-boundary-error' | 'unexpected-reflow';
+    framework?: string;
+    message: string;
+    stack?: string;
+    selector?: string;
+}
+export interface HydrationAuditResult {
+    page: string;
+    frameworkDetected: string[];
+    issues: HydrationIssue[];
+    domSnapshotSize: {
+        serverBytes: number;
+        clientBytes: number;
+        deltaBytes: number;
+    };
+    passed: boolean;
+}
+export declare function auditHydration(page: Page): Promise<HydrationAuditResult>;
+//# sourceMappingURL=hydration-audit.d.ts.map

package/dist/hydration-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration-audit.d.ts","sourceRoot":"","sources":["../src/hydration-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,mBAAmB,GACnB,cAAc,GACd,mBAAmB,GACnB,yBAAyB,GACzB,mBAAmB,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,eAAe,EAAE;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,EAAE,OAAO,CAAC;CACjB;AA6MD,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4G9E"}

package/dist/hydration-audit.js

@@ -0,0 +1,277 @@
+const PATTERN_RULES = [
+    {
+        pattern: /Hydration failed because/i,
+        framework: 'react',
+        kind: 'hydration-failure',
+    },
+    {
+        pattern: /Text content does not match server-rendered HTML/i,
+        framework: 'react',
+        kind: 'dom-mismatch',
+    },
+    {
+        pattern: /did not match\.\s*Server:/i,
+        framework: 'react',
+        kind: 'dom-mismatch',
+    },
+    {
+        pattern: /Warning:\s*Expected server HTML/i,
+        framework: 'react',
+        kind: 'framework-warning',
+    },
+    {
+        pattern: /There was an error while hydrating/i,
+        framework: 'react',
+        kind: 'hydration-failure',
+    },
+    {
+        pattern: /while hydrating.*Suspense boundary/i,
+        framework: 'react',
+        kind: 'suspense-boundary-error',
+    },
+    {
+        pattern: /Text content did not match/i,
+        framework: 'next',
+        kind: 'dom-mismatch',
+    },
+    {
+        pattern: /An unhandled error occurred while hydrating/i,
+        framework: 'next',
+        kind: 'hydration-failure',
+    },
+    {
+        pattern: /Hydration completed but contains mismatches/i,
+        framework: 'vue',
+        kind: 'framework-warning',
+    },
+    {
+        pattern: /Hydration children mismatch/i,
+        framework: 'vue',
+        kind: 'dom-mismatch',
+    },
+    {
+        pattern: /Hydration node mismatch/i,
+        framework: 'vue',
+        kind: 'dom-mismatch',
+    },
+    {
+        pattern: /Svelte hydration failed/i,
+        framework: 'svelte',
+        kind: 'hydration-failure',
+    },
+    {
+        pattern: /Hydration mismatch/i,
+        framework: 'svelte',
+        kind: 'dom-mismatch',
+    },
+    {
+        pattern: /Hydration completed with errors/i,
+        framework: 'solid',
+        kind: 'hydration-failure',
+    },
+    {
+        pattern: /Astro\.createContext/i,
+        framework: 'astro',
+        kind: 'framework-warning',
+    },
+    {
+        pattern: /hydration failed/i,
+        framework: 'astro',
+        kind: 'hydration-failure',
+    },
+];
+function extractSelector(text) {
+    const tagMatch = text.match(/<([a-zA-Z][a-zA-Z0-9-]*)/);
+    if (tagMatch && tagMatch[1])
+        return tagMatch[1].toLowerCase();
+    const selMatch = text.match(/selector[:\s]+["']([^"']+)["']/i);
+    if (selMatch && selMatch[1])
+        return selMatch[1];
+    return undefined;
+}
+function matchRule(text) {
+    for (const rule of PATTERN_RULES) {
+        if (rule.pattern.test(text))
+            return rule;
+    }
+    return null;
+}
+async function probeFrameworks(page) {
+    try {
+        return await page.evaluate(() => {
+            const w = window;
+            const found = new Set();
+            if (w['__REACT_DEVTOOLS_GLOBAL_HOOK__'] !== undefined ||
+                document.querySelector('[data-reactroot]') !== null ||
+                document.querySelector('#__next') !== null ||
+                document.querySelector('#root') !== null) {
+                found.add('react');
+            }
+            if (w['__NEXT_DATA__'] !== undefined || document.querySelector('#__next') !== null) {
+                found.add('next');
+            }
+            if (w['__NUXT__'] !== undefined || document.querySelector('#__nuxt') !== null) {
+                found.add('nuxt');
+            }
+            const appEl = document.querySelector('[data-v-app], #app');
+            if (w['__VUE__'] !== undefined ||
+                (appEl !== null &&
+                    appEl.__vue__ !== undefined)) {
+                found.add('vue');
+            }
+            if (document.querySelector('[data-svelte-h]') !== null ||
+                w['__SvelteKit'] !== undefined ||
+                w['__sveltekit_dev'] !== undefined) {
+                found.add('svelte');
+            }
+            if (document.querySelector('astro-island') !== null) {
+                found.add('astro');
+            }
+            if (document.querySelector('[ng-version]') !== null ||
+                w['ng'] !== undefined) {
+                found.add('angular');
+            }
+            if (w['_$HY'] !== undefined) {
+                found.add('solid');
+            }
+            return { frameworks: [...found] };
+        });
+    }
+    catch {
+        return { frameworks: [] };
+    }
+}
+function toStack(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value instanceof Error)
+        return value.stack;
+    if (value && typeof value === 'object' && 'stack' in value) {
+        const s = value.stack;
+        return typeof s === 'string' ? s : undefined;
+    }
+    return undefined;
+}
+async function readConsoleArgsStack(msg) {
+    try {
+        const args = msg.args();
+        for (const arg of args) {
+            const handle = await arg.getProperty('stack').catch(() => null);
+            if (!handle)
+                continue;
+            const raw = await handle.jsonValue().catch(() => undefined);
+            const stack = toStack(raw);
+            if (stack)
+                return stack;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+function bytesOf(html) {
+    if (typeof TextEncoder !== 'undefined') {
+        return new TextEncoder().encode(html).length;
+    }
+    return Buffer.byteLength(html, 'utf8');
+}
+export async function auditHydration(page) {
+    const issues = [];
+    const seen = new Set();
+    const pushIssue = (issue) => {
+        const key = `${issue.kind}|${issue.framework ?? ''}|${issue.message}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        issues.push(issue);
+    };
+    const pendingStacks = [];
+    const onConsole = (msg) => {
+        const type = msg.type();
+        if (type !== 'error' && type !== 'warning')
+            return;
+        const text = msg.text();
+        const rule = matchRule(text);
+        if (!rule)
+            return;
+        const selector = extractSelector(text);
+        const framework = rule.framework;
+        const kind = rule.kind;
+        const base = {
+            kind,
+            framework,
+            message: text,
+            selector,
+        };
+        pendingStacks.push((async () => {
+            const stack = await readConsoleArgsStack(msg);
+            if (stack)
+                base.stack = stack;
+            pushIssue(base);
+        })());
+    };
+    const onPageError = (err) => {
+        const text = err.message || String(err);
+        const rule = matchRule(text);
+        if (!rule)
+            return;
+        pushIssue({
+            kind: rule.kind,
+            framework: rule.framework,
+            message: text,
+            stack: err.stack,
+            selector: extractSelector(text),
+        });
+    };
+    page.on('console', onConsole);
+    page.on('pageerror', onPageError);
+    let serverBytes = 0;
+    try {
+        await page.waitForLoadState('domcontentloaded');
+        const serverHtml = await page.content();
+        serverBytes = bytesOf(serverHtml);
+    }
+    catch {
+        serverBytes = 0;
+    }
+    try {
+        await page.waitForLoadState('networkidle', { timeout: 15000 });
+    }
+    catch {
+        /* continue even if networkidle times out */
+    }
+    let clientBytes = 0;
+    try {
+        const clientHtml = await page.content();
+        clientBytes = bytesOf(clientHtml);
+    }
+    catch {
+        clientBytes = 0;
+    }
+    const deltaBytes = clientBytes - serverBytes;
+    if (serverBytes > 0 &&
+        deltaBytes > 0 &&
+        deltaBytes / serverBytes > 0.2) {
+        pushIssue({
+            kind: 'unexpected-reflow',
+            message: `Client DOM grew by ${deltaBytes} bytes (${Math.round((deltaBytes / serverBytes) * 100)}%) after networkidle, indicating significant client-side re-render.`,
+        });
+    }
+    const probe = await probeFrameworks(page);
+    await Promise.all(pendingStacks);
+    page.off('console', onConsole);
+    page.off('pageerror', onPageError);
+    return {
+        page: page.url(),
+        frameworkDetected: probe.frameworks,
+        issues,
+        domSnapshotSize: {
+            serverBytes,
+            clientBytes,
+            deltaBytes,
+        },
+        passed: issues.length === 0,
+    };
+}
+//# sourceMappingURL=hydration-audit.js.map

package/dist/hydration-audit.js.map

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

package/dist/image-audit.d.ts

@@ -0,0 +1,41 @@
+import type { Page } from 'playwright';
+export type ImageFormat = 'jpg' | 'png' | 'webp' | 'avif' | 'gif' | 'svg' | 'other';
+export type ImageIssueType = 'missing-alt' | 'broken-image' | 'oversized-image' | 'no-modern-format' | 'no-lazy-loading' | 'missing-dimensions' | 'no-responsive-srcset';
+export interface ImageRecord {
+    src: string;
+    alt?: string;
+    hasAlt: boolean;
+    emptyAlt: boolean;
+    decorative: boolean;
+    loading?: string;
+    width?: number;
+    height?: number;
+    naturalWidth?: number;
+    naturalHeight?: number;
+    bytes?: number;
+    format?: ImageFormat;
+    oversized: boolean;
+    responsive: boolean;
+}
+export interface ImageIssue {
+    type: ImageIssueType;
+    target: string;
+    detail?: string;
+}
+export interface ImageAuditStats {
+    total: number;
+    withAlt: number;
+    broken: number;
+    oversized: number;
+    modernFormat: number;
+    lazyLoaded: number;
+}
+export interface ImageAuditResult {
+    page: string;
+    images: ImageRecord[];
+    issues: ImageIssue[];
+    stats: ImageAuditStats;
+    passed: boolean;
+}
+export declare function auditImages(page: Page): Promise<ImageAuditResult>;
+//# sourceMappingURL=image-audit.d.ts.map

package/dist/image-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-audit.d.ts","sourceRoot":"","sources":["../src/image-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAEpF,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,oBAAoB,GACpB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyQvE"}