ukagaka-doc-mcp 0.1.0

package/dist/parser/satori-scraper.js

@@ -0,0 +1,272 @@
+/**
+ * 里々Wiki スクレイパー
+ *
+ * https://soliton.sub.jp/satori/ (PukiWiki 1.5.4)
+ *
+ * 里々Wikiのコンテンツ構造:
+ * - 資料系: 特殊記号一覧, 演算子一覧, 変数, 情報取得変数, 特殊変数, 関数一覧, ファイル構成
+ * - 独自イベント
+ * - TIPS: TIPS総合, ゴースト作りのTIPSまとめ, 困ったときの対処法 + 個別TIPSページ
+ * - 里々について: 里々の内部処理, 栞としての里々
+ * - SAORI: SAORI, SAORI/里々
+ */
+import { SCRAPE_RATE_LIMIT_MS } from '../constants.js';
+import * as cheerio from 'cheerio';
+const BASE_URL = 'https://soliton.sub.jp/satori/';
+const INVALID_PAGE_MARKERS = ['有効なWikiNameではありません'];
+/** 静的スクレイプ対象ページ */
+export const SATORI_STATIC_PAGES = [
+    // 資料
+    { pageName: '特殊記号一覧', category: 'satori_reference' },
+    { pageName: '演算子一覧', category: 'satori_reference' },
+    { pageName: '変数', category: 'satori_reference' },
+    { pageName: '情報取得変数', category: 'satori_reference' },
+    { pageName: '特殊変数', category: 'satori_reference' },
+    { pageName: '関数', category: 'satori_reference' },
+    { pageName: '関数一覧', category: 'satori_reference' },
+    { pageName: 'ファイル構成', category: 'satori_reference' },
+    // 独自イベント
+    { pageName: '独自イベント', category: 'satori_event' },
+    // TIPS
+    { pageName: 'TIPS総合', category: 'satori_tips' },
+    { pageName: 'ゴースト作りのTIPSまとめ', category: 'satori_tips' },
+    { pageName: '困ったときの対処法', category: 'satori_tips' },
+    // 里々について
+    { pageName: '里々の内部処理', category: 'satori_reference' },
+    { pageName: '栞としての里々', category: 'satori_reference' },
+    // SAORI
+    { pageName: 'SAORI', category: 'satori_saori' },
+    { pageName: 'SAORI/里々', category: 'satori_saori' },
+];
+// ============================================================
+// HTTP取得
+// ============================================================
+async function fetchPageHtml(pageName) {
+    const url = `${BASE_URL}?${encodeURIComponent(pageName)}`;
+    try {
+        const res = await fetch(url, {
+            headers: {
+                'User-Agent': 'ukagaka-doc-mcp/0.1 (index builder)',
+                'Accept': 'text/html',
+            },
+            signal: AbortSignal.timeout(15000),
+        });
+        if (!res.ok) {
+            console.error(`[satori-scraper] HTTP ${res.status} for ${url}`);
+            return null;
+        }
+        return await res.text();
+    }
+    catch (err) {
+        console.error(`[satori-scraper] Failed to fetch ${url}:`, err);
+        return null;
+    }
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+// ============================================================
+// HTMLパース
+// ============================================================
+/**
+ * 里々WikiページのHTMLをパースして DocEntry[] を返す。
+ */
+export function parseSatoriPage(html, pageName, category) {
+    const $ = cheerio.load(html);
+    const pageUrl = `${BASE_URL}?${encodeURIComponent(pageName)}`;
+    const usedAnchors = new Map();
+    // メタ要素・ナビゲーション除去
+    $('script, style').remove();
+    // PukiWiki のナビゲーション部分除去
+    // (#navi, .navi, #menubar, .menubar, #toolbar, .toolbar)
+    $('#navi, .navi, #menubar, .menubar, #toolbar, .toolbar').remove();
+    // フッター除去 (#lastmodified, #footer, .footer)
+    $('#lastmodified, #footer, .footer').remove();
+    // 編集リンク除去
+    $('a[href*="cmd=edit"], a[href*="cmd=freeze"]').remove();
+    const pageTitle = $('h1').first().text().trim() ||
+        $('#page-title').text().trim() ||
+        pageName;
+    // PukiWiki のコンテンツ領域
+    const $content = $('#content, #body, .body, .wiki').first();
+    const $root = $content.length ? $content : $('body');
+    if (isInvalidWikiPage(pageTitle, $root.text().replace(/\s+/g, ' ').trim())) {
+        return [];
+    }
+    const entries = [];
+    const headers = $root.find('h2, h3');
+    if (headers.length === 0) {
+        // セクションなし: ページ全体を1エントリ
+        const content = $root.text().replace(/\s+/g, ' ').trim();
+        if (content.length > 20) {
+            entries.push({
+                id: `satori:${pageName}`,
+                title: pageTitle,
+                source: 'satori_wiki',
+                category,
+                content,
+                url: pageUrl,
+            });
+        }
+        return entries;
+    }
+    // セクション単位で分割
+    headers.each((_, header) => {
+        const $header = $(header);
+        // PukiWiki の見出し末尾 † を除去
+        const sectionTitle = $header.text().replace(/†/g, '').trim();
+        if (!sectionTitle || sectionTitle.length < 2)
+            return;
+        const anchor = $header.find('a[id], a[name]').attr('id') ||
+            $header.find('a[id], a[name]').attr('name') ||
+            slugify(sectionTitle);
+        const uniqueAnchor = makeUniqueAnchor(anchor, usedAnchors);
+        const parts = [sectionTitle];
+        let $sibling = $header.next();
+        while ($sibling.length && !$sibling.is('h2, h3')) {
+            const text = $sibling.text().trim();
+            if (text)
+                parts.push(text);
+            $sibling = $sibling.next();
+        }
+        const content = parts.join('\n');
+        if (content.trim().length < 5)
+            return;
+        entries.push({
+            id: `satori:${pageName}#${uniqueAnchor}`,
+            title: `${pageTitle} - ${sectionTitle}`,
+            source: 'satori_wiki',
+            category,
+            content,
+            url: `${pageUrl}#${uniqueAnchor}`,
+        });
+    });
+    // セクションが取れなかった場合はページ全体
+    if (entries.length === 0) {
+        const content = $root.text().replace(/\s+/g, ' ').trim();
+        if (content.length > 20) {
+            entries.push({
+                id: `satori:${pageName}`,
+                title: pageTitle,
+                source: 'satori_wiki',
+                category,
+                content,
+                url: pageUrl,
+            });
+        }
+    }
+    return entries;
+}
+// ============================================================
+// 動的ページ一覧取得（個別Tipsページ）
+// ============================================================
+/**
+ * TIPS総合ページからリンクされている個別Tipsページを収集する。
+ */
+export async function fetchSatoriTipsPageList() {
+    const tipsPages = [];
+    const html = await fetchPageHtml('TIPS総合');
+    if (!html)
+        return tipsPages;
+    const $ = cheerio.load(html);
+    $('a[href]').each((_, a) => {
+        const href = normalizeSatoriWikiHref($(a).attr('href'));
+        try {
+            if (!href?.startsWith('?') || isMetaWikiHref(href)) {
+                return;
+            }
+            const pageName = decodeURIComponent(href.slice(1));
+            // TIPS一覧・注意書き等のメタページを除外
+            if (pageName &&
+                pageName !== 'TIPS総合' &&
+                pageName !== 'RecentChanges' &&
+                !pageName.startsWith('cmd=') &&
+                !pageName.startsWith('plugin=') &&
+                pageName.length > 1) {
+                tipsPages.push(pageName);
+            }
+        }
+        catch {
+            // ignore
+        }
+    });
+    await sleep(SCRAPE_RATE_LIMIT_MS);
+    return [...new Set(tipsPages)];
+}
+// ============================================================
+// メインスクレイプ関数
+// ============================================================
+/**
+ * 里々Wiki全体をスクレイプして DocEntry[] を返す。
+ */
+export async function scrapeSatoriWiki() {
+    const allEntries = [];
+    // 1. 静的ページ
+    console.error('[satori-scraper] Scraping static pages...');
+    for (const pageDef of SATORI_STATIC_PAGES) {
+        const html = await fetchPageHtml(pageDef.pageName);
+        if (html) {
+            const entries = parseSatoriPage(html, pageDef.pageName, pageDef.category);
+            allEntries.push(...entries);
+            console.error(`[satori-scraper] ${pageDef.pageName}: ${entries.length} entries`);
+        }
+        await sleep(SCRAPE_RATE_LIMIT_MS);
+    }
+    // 2. 個別Tipsページ（動的に一覧を取得）
+    console.error('[satori-scraper] Fetching Tips page list...');
+    const tipsPages = await fetchSatoriTipsPageList();
+    console.error(`[satori-scraper] Found ${tipsPages.length} Tips pages`);
+    for (const pageName of tipsPages) {
+        // すでにスクレイプ済みのページはスキップ
+        if (SATORI_STATIC_PAGES.some(p => p.pageName === pageName))
+            continue;
+        const html = await fetchPageHtml(pageName);
+        if (html) {
+            const entries = parseSatoriPage(html, pageName, 'satori_tips');
+            allEntries.push(...entries);
+        }
+        await sleep(SCRAPE_RATE_LIMIT_MS);
+    }
+    console.error(`[satori-scraper] Total: ${allEntries.length} entries`);
+    return allEntries;
+}
+// ============================================================
+// ユーティリティ
+// ============================================================
+function slugify(text) {
+    return text
+        .replace(/[^\w\u3040-\u9FFF]/g, '_')
+        .replace(/_+/g, '_')
+        .slice(0, 64);
+}
+function makeUniqueAnchor(anchor, usedAnchors) {
+    const seenCount = (usedAnchors.get(anchor) ?? 0) + 1;
+    usedAnchors.set(anchor, seenCount);
+    if (seenCount === 1) {
+        return anchor;
+    }
+    return `${anchor}:${seenCount}`;
+}
+export function normalizeSatoriWikiHref(href) {
+    if (!href) {
+        return null;
+    }
+    if (href.startsWith('#')) {
+        return null;
+    }
+    let normalized = href;
+    if (normalized.startsWith('./?')) {
+        normalized = normalized.slice(2);
+    }
+    if (!normalized.startsWith('?')) {
+        return null;
+    }
+    return normalized.split('#', 1)[0] || null;
+}
+function isMetaWikiHref(href) {
+    return href.startsWith('?cmd=') || href.startsWith('?plugin=');
+}
+function isInvalidWikiPage(pageTitle, bodyText) {
+    return INVALID_PAGE_MARKERS.some(marker => pageTitle.includes(marker) || bodyText.includes(marker));
+}
+//# sourceMappingURL=satori-scraper.js.map

package/dist/parser/satori-scraper.js.map

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

package/dist/parser/ukadoc-parser.d.ts

@@ -0,0 +1,21 @@
+/**
+ * UKADOCパーサー
+ *
+ * UKADOC の HTMLファイルを解析して DocEntry 配列を返す。
+ *
+ * HTML構造の観察:
+ * - list_sakura_script.html: section.category > dl > dt.entry が各タグ
+ * - list_shiori_event.html: section.category > dl > dt.entry が各イベント
+ * - descript_*.html: section > dl > dt.entry or セクション形式
+ * - spec_*.html: セクション形式（h2/h3 + 説明文）
+ */
+import type { DocEntry, Category } from '../types.js';
+/**
+ * UKADOC の manual/ ディレクトリ全体をパースして DocEntry[] を返す。
+ */
+export declare function parseUkadocManual(manualDir: string): DocEntry[];
+/**
+ * 単一のUKADOC HTMLファイルをパースして DocEntry[] を返す。
+ */
+export declare function parseUkadocFile(html: string, filename: string, category: Category): DocEntry[];
+//# sourceMappingURL=ukadoc-parser.d.ts.map

package/dist/parser/ukadoc-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ukadoc-parser.d.ts","sourceRoot":"","sources":["../../src/parser/ukadoc-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAoDtD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,CAyB/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,EAAE,CAsHZ"}

package/dist/parser/ukadoc-parser.js

@@ -0,0 +1,231 @@
+/**
+ * UKADOCパーサー
+ *
+ * UKADOC の HTMLファイルを解析して DocEntry 配列を返す。
+ *
+ * HTML構造の観察:
+ * - list_sakura_script.html: section.category > dl > dt.entry が各タグ
+ * - list_shiori_event.html: section.category > dl > dt.entry が各イベント
+ * - descript_*.html: section > dl > dt.entry or セクション形式
+ * - spec_*.html: セクション形式（h2/h3 + 説明文）
+ */
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import * as cheerio from 'cheerio';
+// ============================================================
+// ファイル → カテゴリ のマッピング
+// ============================================================
+/** filename (拡張子なし) → Category */
+const FILE_CATEGORY_MAP = {
+    list_sakura_script: 'sakurascript',
+    list_shiori_event: 'shiori_event',
+    list_shiori_event_ex: 'shiori_event',
+    list_shiori_resource: 'shiori_event',
+    list_plugin_event: 'shiori_event',
+    list_propertysystem: 'protocol',
+    descript_ghost: 'descript',
+    descript_shell: 'descript',
+    descript_shell_surfaces: 'descript',
+    descript_shell_surfacetable: 'descript',
+    descript_balloon: 'descript',
+    descript_install: 'descript',
+    descript_headline: 'descript',
+    descript_plugin: 'descript',
+    spec_shiori3: 'protocol',
+    spec_sstp: 'protocol',
+    spec_dll: 'protocol',
+    spec_plugin: 'protocol',
+    spec_fmo_mutex: 'protocol',
+    spec_headline: 'protocol',
+    spec_update_file: 'protocol',
+    spec_web: 'protocol',
+    manual_directory: 'file_structure',
+    manual_ghost: 'file_structure',
+    manual_shell: 'file_structure',
+    manual_balloon: 'file_structure',
+    manual_install: 'file_structure',
+    manual_update: 'file_structure',
+    manual_translator: 'file_structure',
+    manual_owner_draw_menu: 'file_structure',
+    dev_bind: 'dev_guide',
+    dev_nar: 'dev_guide',
+    dev_ownerdraw: 'dev_guide',
+    dev_shell: 'dev_guide',
+    dev_shell_error: 'dev_guide',
+    dev_update: 'dev_guide',
+    memo: 'dev_guide',
+    memo_shiorievent: 'shiori_event',
+};
+// ============================================================
+// パース関数
+// ============================================================
+/**
+ * UKADOC の manual/ ディレクトリ全体をパースして DocEntry[] を返す。
+ */
+export function parseUkadocManual(manualDir) {
+    if (!existsSync(manualDir)) {
+        throw new Error(`UKADOC manual directory not found: ${manualDir}\nRun: git submodule update --init --recursive`);
+    }
+    const htmlFiles = readdirSync(manualDir)
+        .filter(f => f.endsWith('.html') && !f.startsWith('index') && f !== 'base.css');
+    const entries = [];
+    for (const filename of htmlFiles) {
+        const stem = basename(filename, '.html');
+        const category = FILE_CATEGORY_MAP[stem];
+        if (!category) {
+            // マッピングにないファイルはスキップ
+            continue;
+        }
+        const filePath = join(manualDir, filename);
+        const html = readFileSync(filePath, 'utf-8');
+        const fileEntries = parseUkadocFile(html, filename, category);
+        entries.push(...fileEntries);
+    }
+    return entries;
+}
+/**
+ * 単一のUKADOC HTMLファイルをパースして DocEntry[] を返す。
+ */
+export function parseUkadocFile(html, filename, category) {
+    const $ = cheerio.load(html);
+    const stem = basename(filename, '.html');
+    const baseUrl = `https://ssp.shillest.net/ukadoc/manual/${filename}`;
+    const usedAnchors = new Map();
+    const fallbackAnchorCounts = new Map();
+    // まずナビゲーションを除去
+    $('nav').remove();
+    $('.navigation-bar').remove();
+    $('header').remove();
+    const pageTitle = $('h1#page-title').text().trim() || $('title').text().trim() || stem;
+    const entries = [];
+    // --------------------------------------------------------
+    // パターン1: dt.entry を持つ定義リスト形式
+    // (list_sakura_script, list_shiori_event, descript_* 等)
+    // --------------------------------------------------------
+    const dtEntries = $('dt.entry');
+    if (dtEntries.length > 0) {
+        dtEntries.each((_, dt) => {
+            const $dt = $(dt);
+            const entryName = $dt.text().trim();
+            if (!entryName)
+                return;
+            // id 属性または前のアンカーから anchor を取得
+            const anchor = createUkadocAnchor($dt.attr('id') || $dt.prev('a').attr('name'), entryName, fallbackAnchorCounts, usedAnchors);
+            // dd (説明) を取得
+            const $dd = $dt.next('dd');
+            const description = $dd.text().trim();
+            // セクション見出しを取得（親の section 内の最初の caption/h2 等）
+            const sectionTitle = getSectionTitle($, $dt);
+            const content = [
+                sectionTitle ? `[${sectionTitle}]` : '',
+                entryName,
+                description,
+            ].filter(Boolean).join('\n');
+            entries.push({
+                id: `ukadoc:${stem}:${anchor}`,
+                title: entryName,
+                source: 'ukadoc',
+                category,
+                content,
+                url: `${baseUrl}#${anchor}`,
+            });
+        });
+        return entries;
+    }
+    // --------------------------------------------------------
+    // パターン2: セクション形式 (spec_*, manual_*, dev_*)
+    // h2 または h3 でセクション分割
+    // --------------------------------------------------------
+    const sectionHeaders = $('h2, h3');
+    if (sectionHeaders.length > 0) {
+        sectionHeaders.each((_, header) => {
+            const $header = $(header);
+            const sectionTitle = $header.text().trim();
+            if (!sectionTitle)
+                return;
+            const anchor = createUkadocAnchor($header.attr('id'), sectionTitle, fallbackAnchorCounts, usedAnchors);
+            // セクションの本文: 次のh2/h3が来るまでのテキストを集める
+            const contentParts = [sectionTitle];
+            let $next = $header.next();
+            while ($next.length && !$next.is('h2, h3')) {
+                const text = $next.text().trim();
+                if (text)
+                    contentParts.push(text);
+                $next = $next.next();
+            }
+            const content = contentParts.join('\n');
+            if (content.length <= sectionTitle.length + 5)
+                return; // 本文がほぼ空ならスキップ
+            entries.push({
+                id: `ukadoc:${stem}:${anchor}`,
+                title: `${pageTitle} - ${sectionTitle}`,
+                source: 'ukadoc',
+                category,
+                content,
+                url: `${baseUrl}#${anchor}`,
+            });
+        });
+        if (entries.length > 0)
+            return entries;
+    }
+    // --------------------------------------------------------
+    // パターン3: フォールバック - ページ全体を1エントリとして扱う
+    // --------------------------------------------------------
+    const bodyText = $('body').text().replace(/\s+/g, ' ').trim();
+    entries.push({
+        id: `ukadoc:${stem}`,
+        title: pageTitle,
+        source: 'ukadoc',
+        category,
+        content: bodyText,
+        url: baseUrl,
+    });
+    return entries;
+}
+// ============================================================
+// ユーティリティ
+// ============================================================
+function getSectionTitle($, $el) {
+    // 親の section 内の caption または h2 を探す
+    const $section = $el.closest('section.category');
+    if ($section.length) {
+        const caption = $section.prev('section.caption').find('h2').first().text().trim();
+        if (caption)
+            return caption;
+        const h2 = $section.find('h2').first().text().trim();
+        if (h2)
+            return h2;
+    }
+    return '';
+}
+function createUkadocAnchor(explicitAnchor, rawTitle, fallbackAnchorCounts, usedAnchors) {
+    let anchor = explicitAnchor?.trim();
+    if (!anchor) {
+        const normalizedRawTitle = normalizeRawTitleForFallback(rawTitle);
+        const occurrenceIndex = (fallbackAnchorCounts.get(normalizedRawTitle) ?? 0) + 1;
+        fallbackAnchorCounts.set(normalizedRawTitle, occurrenceIndex);
+        anchor = `${normalizedRawTitle}:${occurrenceIndex}`;
+    }
+    const seenCount = (usedAnchors.get(anchor) ?? 0) + 1;
+    usedAnchors.set(anchor, seenCount);
+    if (seenCount === 1) {
+        return anchor;
+    }
+    return `${anchor}:${seenCount}`;
+}
+function normalizeRawTitleForFallback(text) {
+    return text
+        .trim()
+        .replace(/\s+/g, ' ')
+        .normalize('NFKC')
+        .split('')
+        .map(char => {
+        if (/^[A-Za-z0-9._-]$/.test(char)) {
+            return char;
+        }
+        return `_${char.codePointAt(0)?.toString(16) ?? '0'}`;
+    })
+        .join('')
+        .slice(0, 120);
+}
+//# sourceMappingURL=ukadoc-parser.js.map

package/dist/parser/ukadoc-parser.js.map

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

package/dist/parser/yaya-scraper.d.ts

@@ -0,0 +1,46 @@
+/**
+ * YAYA Wiki スクレイパー
+ *
+ * https://emily.shillest.net/ayaya/ (PukiWiki Plus!)
+ *
+ * 設計方針:
+ * - YAYA関数ページ（マニュアル/関数/*）は1ページ=1エントリ（情報断片化防止）
+ * - その他のページはセクション(h2/h3)単位で分割
+ * - レート制限: 500ms/リクエスト
+ */
+import type { DocEntry, Category } from '../types.js';
+interface YayaPageDef {
+    path: string;
+    category: Category;
+    onePageOneEntry?: boolean;
+}
+/** スクレイプ対象ページ一覧。ビルド時に動的取得するページのベース。 */
+export declare const YAYA_STATIC_PAGES: YayaPageDef[];
+/** 関数ページのプレフィックス */
+export declare const YAYA_FUNCTION_PAGE_PREFIX = "\u30DE\u30CB\u30E5\u30A2\u30EB/\u95A2\u6570/";
+/** Tipsページのプレフィックス */
+export declare const YAYA_TIPS_PAGE_PREFIX = "Tips/";
+/**
+ * PukiWiki のHTMLからコンテンツ本文を抽出し、DocEntry を生成する。
+ *
+ * @param html      取得したHTML
+ * @param pagePath  Wikiページパス（canonical_id生成に使用）
+ * @param category  カテゴリ
+ * @param onePageOneEntry  true の場合はセクション分割せず1エントリにする
+ */
+export declare function parseYayaPage(html: string, pagePath: string, category: Category, onePageOneEntry?: boolean): DocEntry[];
+/**
+ * YAYA Wiki の関数一覧ページから個別関数ページのリストを取得する。
+ */
+export declare function fetchYayaFunctionPageList(): Promise<string[]>;
+/**
+ * YAYA Wiki の Tips 一覧ページから個別Tipsページのリストを取得する。
+ */
+export declare function fetchYayaTipsPageList(): Promise<string[]>;
+/**
+ * YAYA Wiki全体をスクレイプして DocEntry[] を返す。
+ */
+export declare function scrapeYayaWiki(): Promise<DocEntry[]>;
+export declare function normalizeYayaWikiHref(href: string | undefined): string | null;
+export {};
+//# sourceMappingURL=yaya-scraper.d.ts.map

package/dist/parser/yaya-scraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaya-scraper.d.ts","sourceRoot":"","sources":["../../src/parser/yaya-scraper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAUtD,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,uCAAuC;AACvC,eAAO,MAAM,iBAAiB,EAAE,WAAW,EAgC1C,CAAC;AAEF,oBAAoB;AACpB,eAAO,MAAM,yBAAyB,iDAAc,CAAC;AACrD,sBAAsB;AACtB,eAAO,MAAM,qBAAqB,UAAU,CAAC;AA4C7C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,eAAe,UAAQ,GACtB,QAAQ,EAAE,CAgFZ;AAMD;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB/D;AAMD;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CA8C1D;AAiBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAoB7E"}