@speakeasy-api/docs-mcp-core 0.1.0

package/dist/manifest.js

@@ -0,0 +1,245 @@
+import matter from "gray-matter";
+import picomatch from "picomatch";
+const DEFAULT_STRATEGY = { chunk_by: "h2" };
+const HTML_HINT_REGEX = /<!--\s*mcp_chunking_hint:\s*(\{[^}]+\})\s*-->/;
+export function parseManifest(input) {
+    if (!input || typeof input !== "object") {
+        throw new Error("manifest must be an object");
+    }
+    const manifest = input;
+    const version = manifest.version;
+    if (version !== "1") {
+        throw new Error("manifest.version must be '1'");
+    }
+    const parsed = { version };
+    if (manifest.strategy) {
+        parsed.strategy = parseStrategy(manifest.strategy);
+    }
+    if (manifest.metadata) {
+        parsed.metadata = parseMetadata(manifest.metadata, "metadata");
+    }
+    if (manifest.overrides) {
+        parsed.overrides = parseOverrides(manifest.overrides);
+    }
+    return parsed;
+}
+export function parseManifestJson(contents) {
+    let parsed;
+    try {
+        parsed = JSON.parse(contents);
+    }
+    catch {
+        throw new Error("Manifest is not valid JSON");
+    }
+    return parseManifest(parsed);
+}
+export function resolveFileConfig(params) {
+    const defaults = {
+        strategy: params.defaults?.strategy ?? DEFAULT_STRATEGY,
+        metadata: params.defaults?.metadata ?? {}
+    };
+    const manifest = params.manifest;
+    let metadata = {
+        ...defaults.metadata,
+        ...(manifest?.metadata ?? {})
+    };
+    let strategy = manifest?.strategy ?? defaults.strategy;
+    const overrideMatchPath = toManifestRelativePath(params.relativeFilePath, params.manifestBaseDir);
+    if (manifest?.overrides) {
+        for (const override of manifest.overrides) {
+            const matcher = picomatch(override.pattern, { dot: true });
+            if (!matcher(overrideMatchPath)) {
+                continue;
+            }
+            if (override.metadata) {
+                metadata = {
+                    ...metadata,
+                    ...override.metadata
+                };
+            }
+            if (override.strategy) {
+                strategy = override.strategy;
+            }
+        }
+    }
+    if (params.markdown) {
+        // HTML comment hints: applied after manifest but before frontmatter
+        const htmlHint = parseHtmlChunkingHint(params.markdown);
+        if (htmlHint) {
+            strategy = { ...strategy, chunk_by: htmlHint.chunk_by };
+        }
+        // Frontmatter overrides: highest precedence
+        const frontmatterOverrides = parseFrontmatterOverrides(params.markdown);
+        if (frontmatterOverrides.metadata) {
+            metadata = {
+                ...metadata,
+                ...frontmatterOverrides.metadata
+            };
+        }
+        if (frontmatterOverrides.strategy) {
+            strategy = frontmatterOverrides.strategy;
+        }
+    }
+    return {
+        strategy,
+        metadata
+    };
+}
+function toManifestRelativePath(relativeFilePath, manifestBaseDir) {
+    const normalizedFile = toPosixPath(relativeFilePath);
+    if (!manifestBaseDir) {
+        return normalizedFile;
+    }
+    const normalizedBase = toPosixPath(manifestBaseDir).replace(/^\/+|\/+$/g, "");
+    if (!normalizedBase || normalizedBase === ".") {
+        return normalizedFile;
+    }
+    const basePrefix = `${normalizedBase}/`;
+    if (normalizedFile.startsWith(basePrefix)) {
+        return normalizedFile.slice(basePrefix.length);
+    }
+    return normalizedFile;
+}
+function toPosixPath(value) {
+    return value.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+function parseFrontmatterOverrides(markdown) {
+    const parsed = matter(markdown);
+    if (!parsed.data || typeof parsed.data !== "object") {
+        return {};
+    }
+    const data = parsed.data;
+    let strategy;
+    if (data.mcp_strategy) {
+        strategy = parseStrategy(data.mcp_strategy);
+    }
+    else if (data.mcp_chunking_hint) {
+        strategy = {
+            chunk_by: parseChunkBy(data.mcp_chunking_hint)
+        };
+    }
+    let metadata;
+    if (data.metadata) {
+        metadata = parseMetadata(data.metadata, "metadata");
+    }
+    if (data.mcp_metadata) {
+        metadata = {
+            ...(metadata ?? {}),
+            ...parseMetadata(data.mcp_metadata, "mcp_metadata")
+        };
+    }
+    const result = {};
+    if (strategy) {
+        result.strategy = strategy;
+    }
+    if (metadata) {
+        result.metadata = metadata;
+    }
+    return result;
+}
+/**
+ * Scans markdown for an HTML comment chunking hint of the form:
+ *   <!-- mcp_chunking_hint: {"chunk_by": "h3"} -->
+ *
+ * Returns a partial strategy override (just `chunk_by`) if found and valid,
+ * or undefined if no hint is present or parsing fails.
+ */
+export function parseHtmlChunkingHint(markdown) {
+    const match = HTML_HINT_REGEX.exec(markdown);
+    if (!match) {
+        return undefined;
+    }
+    const jsonStr = match[1];
+    if (!jsonStr) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(jsonStr);
+        if (parsed.chunk_by !== undefined) {
+            const chunkBy = parseChunkBy(parsed.chunk_by);
+            return { chunk_by: chunkBy };
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseOverrides(value) {
+    if (!Array.isArray(value)) {
+        throw new Error("manifest.overrides must be an array");
+    }
+    return value.map((entry, index) => {
+        if (!entry || typeof entry !== "object") {
+            throw new Error(`manifest.overrides[${index}] must be an object`);
+        }
+        const override = entry;
+        if (typeof override.pattern !== "string" || !override.pattern.trim()) {
+            throw new Error(`manifest.overrides[${index}].pattern must be a non-empty string`);
+        }
+        const parsed = {
+            pattern: override.pattern.trim()
+        };
+        if (override.strategy) {
+            parsed.strategy = parseStrategy(override.strategy);
+        }
+        if (override.metadata) {
+            parsed.metadata = parseMetadata(override.metadata, `manifest.overrides[${index}].metadata`);
+        }
+        return parsed;
+    });
+}
+function parseStrategy(value) {
+    if (!value || typeof value !== "object") {
+        throw new Error("strategy must be an object");
+    }
+    const strategy = value;
+    const chunkBy = parseChunkBy(strategy.chunk_by);
+    const maxChunkSize = strategy.max_chunk_size;
+    const minChunkSize = strategy.min_chunk_size;
+    const parsed = {
+        chunk_by: chunkBy
+    };
+    if (maxChunkSize !== undefined) {
+        parsed.max_chunk_size = asPositiveInteger(maxChunkSize, "max_chunk_size");
+    }
+    if (minChunkSize !== undefined) {
+        parsed.min_chunk_size = asPositiveInteger(minChunkSize, "min_chunk_size");
+    }
+    return parsed;
+}
+function parseChunkBy(value) {
+    if (value !== "h1" && value !== "h2" && value !== "h3" && value !== "file") {
+        throw new Error("chunk_by must be one of: h1, h2, h3, file");
+    }
+    return value;
+}
+function parseMetadata(value, fieldName) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${fieldName} must be an object`);
+    }
+    const metadata = value;
+    const normalized = {};
+    for (const [rawKey, rawValue] of Object.entries(metadata)) {
+        const key = rawKey.trim();
+        if (!key) {
+            throw new Error(`${fieldName} contains an empty key`);
+        }
+        if (typeof rawValue !== "string") {
+            throw new Error(`${fieldName}.${key} must be a string`);
+        }
+        const val = rawValue.trim();
+        if (!val) {
+            throw new Error(`${fieldName}.${key} cannot be empty`);
+        }
+        normalized[key] = val;
+    }
+    return normalized;
+}
+function asPositiveInteger(value, fieldName) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`${fieldName} must be a positive integer`);
+    }
+    return value;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/metadata.d.ts

@@ -0,0 +1,6 @@
+import type { CorpusMetadata } from "./types.js";
+export interface NormalizeMetadataOptions {
+    supportedMajor?: number;
+}
+export declare function normalizeMetadata(input: unknown, options?: NormalizeMetadataOptions): CorpusMetadata;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAoC,MAAM,YAAY,CAAC;AASnF,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACrC,cAAc,CAiChB"}

package/dist/metadata.js

@@ -0,0 +1,152 @@
+import semver from "semver";
+const LIMITS = {
+    maxKeys: 64,
+    maxKeyLength: 64,
+    maxValuesPerKey: 512,
+    maxValueLength: 128
+};
+export function normalizeMetadata(input, options = {}) {
+    if (!input || typeof input !== "object") {
+        throw new Error("metadata must be an object");
+    }
+    const metadata = input;
+    const supportedMajor = options.supportedMajor ?? 1;
+    const metadataVersion = asNonEmptyString(metadata.metadata_version, "metadata_version");
+    if (!semver.valid(metadataVersion)) {
+        throw new Error("metadata_version must be valid semver");
+    }
+    const parsed = semver.parse(metadataVersion);
+    if (!parsed || parsed.major !== supportedMajor) {
+        throw new Error(`Unsupported metadata_version major: expected ${supportedMajor}.x.x, got ${metadataVersion}`);
+    }
+    const corpusDescription = asNonEmptyString(metadata.corpus_description, "corpus_description");
+    const taxonomy = normalizeTaxonomy(metadata.taxonomy);
+    const stats = normalizeStats(metadata.stats);
+    const embedding = normalizeEmbedding(metadata.embedding);
+    return {
+        metadata_version: metadataVersion,
+        corpus_description: corpusDescription,
+        taxonomy,
+        stats,
+        embedding
+    };
+}
+function normalizeTaxonomy(value) {
+    if (!value || typeof value !== "object") {
+        throw new Error("taxonomy must be an object");
+    }
+    const raw = value;
+    const entries = Object.entries(raw);
+    if (entries.length > LIMITS.maxKeys) {
+        throw new Error(`taxonomy has too many keys (max ${LIMITS.maxKeys})`);
+    }
+    const normalized = {};
+    for (const [rawKey, rawField] of entries) {
+        const key = rawKey.trim();
+        if (!key) {
+            throw new Error("taxonomy keys cannot be empty");
+        }
+        if (key.length > LIMITS.maxKeyLength) {
+            throw new Error(`taxonomy key '${key}' exceeds max length ${LIMITS.maxKeyLength}`);
+        }
+        if (!rawField || typeof rawField !== "object") {
+            throw new Error(`taxonomy field '${key}' must be an object`);
+        }
+        const field = rawField;
+        const values = normalizeValues(field.values, key);
+        const description = field.description === undefined ? undefined : asTrimmedString(field.description);
+        normalized[key] = description
+            ? { description, values }
+            : { values };
+    }
+    return normalized;
+}
+function normalizeValues(value, key) {
+    if (!Array.isArray(value)) {
+        throw new Error(`taxonomy['${key}'].values must be an array`);
+    }
+    if (value.length > LIMITS.maxValuesPerKey) {
+        throw new Error(`taxonomy['${key}'].values exceeds max length ${LIMITS.maxValuesPerKey}`);
+    }
+    const deduped = new Set();
+    for (const raw of value) {
+        const normalized = asTrimmedString(raw);
+        if (!normalized) {
+            throw new Error(`taxonomy['${key}'].values cannot include empty strings`);
+        }
+        if (normalized.length > LIMITS.maxValueLength) {
+            throw new Error(`taxonomy['${key}'].value '${normalized}' exceeds max length ${LIMITS.maxValueLength}`);
+        }
+        deduped.add(normalized);
+    }
+    return [...deduped].sort((a, b) => a.localeCompare(b));
+}
+function normalizeStats(value) {
+    if (!value || typeof value !== "object") {
+        throw new Error("stats must be an object");
+    }
+    const stats = value;
+    const totalChunks = asPositiveInteger(stats.total_chunks, "stats.total_chunks", true);
+    const totalFiles = asPositiveInteger(stats.total_files, "stats.total_files", true);
+    const indexedAt = asNonEmptyString(stats.indexed_at, "stats.indexed_at");
+    const sourceCommitRaw = stats.source_commit;
+    let sourceCommit;
+    if (sourceCommitRaw === undefined) {
+        sourceCommit = undefined;
+    }
+    else if (sourceCommitRaw === null) {
+        sourceCommit = null;
+    }
+    else {
+        sourceCommit = asTrimmedString(sourceCommitRaw);
+        if (!/^[a-f0-9]{40}$/.test(sourceCommit)) {
+            throw new Error("stats.source_commit must be a 40-char lowercase SHA-1");
+        }
+    }
+    const result = {
+        total_chunks: totalChunks,
+        total_files: totalFiles,
+        indexed_at: indexedAt
+    };
+    if (sourceCommit !== undefined) {
+        result.source_commit = sourceCommit;
+    }
+    return result;
+}
+function normalizeEmbedding(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value !== "object") {
+        throw new Error("embedding must be null or an object");
+    }
+    const embedding = value;
+    const provider = asNonEmptyString(embedding.provider, "embedding.provider");
+    const model = asNonEmptyString(embedding.model, "embedding.model");
+    const dimensions = asPositiveInteger(embedding.dimensions, "embedding.dimensions", false);
+    return { provider, model, dimensions };
+}
+function asTrimmedString(value) {
+    if (typeof value !== "string") {
+        throw new Error("expected string");
+    }
+    return value.trim();
+}
+function asNonEmptyString(value, fieldName) {
+    const normalized = asTrimmedString(value);
+    if (!normalized) {
+        throw new Error(`${fieldName} must be a non-empty string`);
+    }
+    return normalized;
+}
+function asPositiveInteger(value, fieldName, allowZero) {
+    if (!Number.isInteger(value)) {
+        throw new Error(`${fieldName} must be an integer`);
+    }
+    const min = allowZero ? 0 : 1;
+    if (value < min) {
+        throw new Error(`${fieldName} must be >= ${min}`);
+    }
+    return value;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,6 @@
+import type { Root } from "mdast";
+/**
+ * Parse a markdown string into an mdast AST tree.
+ */
+export declare function parseMarkdown(content: string): Root;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAOlC;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD"}

package/dist/parser.js

@@ -0,0 +1,21 @@
+/**
+ * Markdown AST parser using unified + remark-parse + remark-frontmatter + remark-gfm.
+ *
+ * Supports YAML frontmatter and GitHub Flavored Markdown extensions
+ * (tables, task lists, strikethrough, autolinks).
+ */
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkGfm from "remark-gfm";
+const processor = unified()
+    .use(remarkParse)
+    .use(remarkFrontmatter, ["yaml"])
+    .use(remarkGfm);
+/**
+ * Parse a markdown string into an mdast AST tree.
+ */
+export function parseMarkdown(content) {
+    return processor.parse(content);
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,iBAAiB,MAAM,oBAAoB,CAAC;AACnD,OAAO,SAAS,MAAM,YAAY,CAAC;AAGnC,MAAM,SAAS,GAAG,OAAO,EAAE;KACxB,GAAG,CAAC,WAAW,CAAC;KAChB,GAAG,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC;KAChC,GAAG,CAAC,SAAS,CAAC,CAAC;AAElB;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/search-common.d.ts

@@ -0,0 +1,7 @@
+export declare function clampLimit(limit: number | undefined): number;
+export declare function isChunkIdFormat(value: string): boolean;
+export declare function normalizeSearchText(value: string): string;
+export declare function tokenizeSearchText(value: string): string[];
+export declare function makeSnippet(content: string, query: string): string;
+export declare function matchesMetadataFilters(metadata: Record<string, string>, filters: Record<string, string>, taxonomyKeys?: string[]): boolean;
+//# sourceMappingURL=search-common.d.ts.map

package/dist/search-common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-common.d.ts","sourceRoot":"","sources":["../src/search-common.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAK1D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBlE;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,OAAO,CA0CT"}

package/dist/search-common.js

@@ -0,0 +1,81 @@
+const DEFAULT_LIMIT = 10;
+const MAX_LIMIT = 50;
+export function clampLimit(limit) {
+    if (limit === undefined || !Number.isInteger(limit)) {
+        return DEFAULT_LIMIT;
+    }
+    return Math.max(1, Math.min(MAX_LIMIT, limit));
+}
+export function isChunkIdFormat(value) {
+    return /^(?!\s)([^#\s]+)(#[^#\s]+)?$/.test(value);
+}
+export function normalizeSearchText(value) {
+    return value.toLowerCase().replace(/\s+/g, " ").trim();
+}
+export function tokenizeSearchText(value) {
+    return value
+        .split(/[^a-z0-9]+/g)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}
+export function makeSnippet(content, query) {
+    const normalized = normalizeSearchText(content);
+    const terms = tokenizeSearchText(normalizeSearchText(query));
+    if (normalized.length <= 220) {
+        return normalized;
+    }
+    let anchor = 0;
+    for (const term of terms) {
+        const index = normalized.indexOf(term);
+        if (index >= 0) {
+            anchor = index;
+            break;
+        }
+    }
+    const start = Math.max(0, anchor - 60);
+    const end = Math.min(normalized.length, start + 220);
+    const prefix = start > 0 ? "..." : "";
+    const suffix = end < normalized.length ? "..." : "";
+    return `${prefix}${normalized.slice(start, end).trim()}${suffix}`;
+}
+export function matchesMetadataFilters(metadata, filters, taxonomyKeys) {
+    const language = filters.language;
+    const scope = filters.scope;
+    // Only apply the scope/language auto-include expansion when both keys exist
+    // in the taxonomy (or when taxonomyKeys is not provided, for backwards compatibility).
+    const hasScope = !taxonomyKeys || taxonomyKeys.includes("scope");
+    const hasLanguage = !taxonomyKeys || taxonomyKeys.includes("language");
+    if (hasScope && hasLanguage && language && !scope) {
+        const chunkScope = metadata.scope;
+        const chunkLanguage = metadata.language;
+        if (chunkScope === "sdk-specific") {
+            if (chunkLanguage !== language) {
+                return false;
+            }
+        }
+        else if (chunkScope === "global-guide") {
+            // Auto-include global guides.
+        }
+        else if (chunkLanguage && chunkLanguage !== language) {
+            return false;
+        }
+    }
+    else {
+        if (language && metadata.language !== language) {
+            return false;
+        }
+        if (scope && metadata.scope !== scope) {
+            return false;
+        }
+    }
+    for (const [key, value] of Object.entries(filters)) {
+        if (key === "language" || key === "scope") {
+            continue;
+        }
+        if (metadata[key] !== value) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=search-common.js.map

package/dist/search-common.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,13 @@
+import type { Chunk, DocsIndexOptions, GetDocRequest, GetDocResult, SearchEngine, SearchRequest, SearchResult } from "./types.js";
+export declare class InMemorySearchEngine implements SearchEngine {
+    private readonly chunks;
+    private readonly byId;
+    private readonly byFile;
+    private readonly proximityWeight;
+    constructor(chunks: Chunk[], options?: DocsIndexOptions);
+    search(request: SearchRequest): Promise<SearchResult>;
+    getDoc(request: GetDocRequest): Promise<GetDocResult>;
+}
+export declare class DocsIndex extends InMemorySearchEngine {
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,KAAK,EACL,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,EAGZ,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE,gBAAqB;IAiBrD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA4CrD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CA8C5D;AAGD,qBAAa,SAAU,SAAQ,oBAAoB;CAAG"}