@mc1global/opencode-jarvis 0.1.0

package/dist/domain/vault/services.js

@@ -0,0 +1,249 @@
+/**
+ * Vault Domain Services
+ *
+ * Stateless services for markdown parsing and link graph analysis.
+ * MarkdownParserService extracts structure (sections, tables, checkboxes, links).
+ * LinkGraphService analyzes wikilink relationships across documents.
+ *
+ * DDD: Domain Services - logic that spans multiple value objects
+ * SOLID: SRP - parsing and graph analysis are separate concerns
+ * SOLID: DIP - no external dependencies (pure domain logic)
+ */
+import { HEADING_PATTERN, WIKILINK_PATTERN, CHECKBOX_PATTERN } from "./value-objects.js";
+import { Section } from "./section.js";
+import { MarkdownTable } from "./table.js";
+// ── MarkdownParserService ─────────────────────────────────────────────
+/**
+ * Parses markdown content into structural elements.
+ * Stateless — all methods are pure functions on input data.
+ */
+export class MarkdownParserService {
+    /**
+     * Parse body text (without frontmatter) into a section tree.
+     * Returns top-level sections; each may contain subsections.
+     */
+    parseSections(bodyLines) {
+        const headings = [];
+        for (let i = 0; i < bodyLines.length; i++) {
+            const line = bodyLines[i];
+            const match = line.match(HEADING_PATTERN);
+            if (match !== null) {
+                const level = match[1].length;
+                const text = match[2].trim();
+                headings.push({ text, level, lineIndex: i });
+            }
+        }
+        if (headings.length === 0)
+            return [];
+        return buildSectionTree(headings, bodyLines);
+    }
+    /** Extract all checkboxes from lines. */
+    extractCheckboxes(lines) {
+        const checkboxes = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const match = line.match(CHECKBOX_PATTERN);
+            if (match !== null) {
+                checkboxes.push({
+                    text: match[3],
+                    checked: match[2] === "x" || match[2] === "X",
+                    line: i,
+                    indentLevel: match[1].length,
+                });
+            }
+        }
+        return checkboxes;
+    }
+    /** Extract all wikilinks from content string. */
+    extractWikilinks(content) {
+        const lines = content.split("\n");
+        const wikilinks = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const regex = new RegExp(WIKILINK_PATTERN.source, WIKILINK_PATTERN.flags);
+            let match;
+            while ((match = regex.exec(line)) !== null) {
+                wikilinks.push({
+                    target: match[1],
+                    alias: match[2],
+                    line: i,
+                });
+            }
+        }
+        return wikilinks;
+    }
+    /** Extract all tables from lines. */
+    extractTables(lines) {
+        const tables = [];
+        let i = 0;
+        while (i < lines.length) {
+            const line = lines[i];
+            if (line.includes("|") && i + 1 < lines.length) {
+                const nextLine = lines[i + 1];
+                if (/^\s*\|?[\s:|-]+\|?\s*$/.test(nextLine)) {
+                    const tableLines = [];
+                    let j = i;
+                    while (j < lines.length && lines[j].includes("|")) {
+                        tableLines.push(lines[j]);
+                        j++;
+                    }
+                    const table = MarkdownTable.parse(tableLines, i);
+                    if (table !== null) {
+                        tables.push(table);
+                        i = j;
+                        continue;
+                    }
+                }
+            }
+            i++;
+        }
+        return tables;
+    }
+}
+// ── LinkGraphService ──────────────────────────────────────────────────
+/**
+ * Analyzes wikilink relationships across a collection of documents.
+ * All methods are pure — they receive document collections as parameters.
+ */
+export class LinkGraphService {
+    /** Get all outgoing wikilinks from a document. */
+    getOutgoingLinks(doc) {
+        return doc.getWikilinks();
+    }
+    /** Find all documents that link to a target path. */
+    getIncomingLinks(target, allDocs) {
+        const targetName = target.filename.toLowerCase();
+        const results = [];
+        for (const doc of allDocs) {
+            if (doc.path.equals(target))
+                continue;
+            const links = doc.getWikilinks();
+            for (const link of links) {
+                // Match by filename (Obsidian resolves [[Name]] to any matching file)
+                const linkTarget = link.target.toLowerCase();
+                // Check both exact path match and filename-only match
+                if (linkTarget === target.value.toLowerCase() ||
+                    linkTarget === targetName ||
+                    linkTarget.endsWith("/" + targetName)) {
+                    results.push({ source: doc.path, link });
+                }
+            }
+        }
+        return results;
+    }
+    /** Find documents with no incoming links (orphans). Excludes HOME.md. */
+    getOrphanDocuments(allDocs) {
+        // Build set of all link targets (lowercase filenames)
+        const linkedTargets = new Set();
+        for (const doc of allDocs) {
+            const links = doc.getWikilinks();
+            for (const link of links) {
+                linkedTargets.add(link.target.toLowerCase());
+            }
+        }
+        const orphans = [];
+        for (const doc of allDocs) {
+            // Skip HOME.md (always a root node)
+            if (doc.path.filename.toLowerCase() === "home")
+                continue;
+            if (doc.path.filename.toLowerCase() === "readme")
+                continue;
+            const filename = doc.path.filename.toLowerCase();
+            const fullPath = doc.path.value.toLowerCase();
+            // Check if any link target matches this document
+            let isLinked = false;
+            for (const target of linkedTargets) {
+                if (target === filename ||
+                    target === fullPath ||
+                    target.endsWith("/" + filename)) {
+                    isLinked = true;
+                    break;
+                }
+            }
+            if (!isLinked) {
+                orphans.push(doc.path);
+            }
+        }
+        return orphans;
+    }
+    /** Compute graph statistics across all documents. */
+    getGraphStats(allDocs) {
+        let totalLinks = 0;
+        const linkCounts = new Map();
+        for (const doc of allDocs) {
+            const links = doc.getWikilinks();
+            totalLinks += links.length;
+            for (const link of links) {
+                const target = link.target.toLowerCase();
+                linkCounts.set(target, (linkCounts.get(target) ?? 0) + 1);
+            }
+        }
+        const orphans = this.getOrphanDocuments(allDocs);
+        // Sort by count, take top 10
+        const sorted = [...linkCounts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([path, count]) => ({ path, count }));
+        return {
+            totalDocs: allDocs.length,
+            totalLinks,
+            orphans: orphans.length,
+            mostLinked: sorted,
+        };
+    }
+}
+// ── Private Helpers ───────────────────────────────────────────────────
+/**
+ * Build a hierarchical section tree from flat heading list.
+ * H1 sections contain H2 subsections, H2 contain H3, etc.
+ */
+function buildSectionTree(headings, allLines) {
+    if (headings.length === 0)
+        return [];
+    const topLevel = headings[0].level;
+    const sections = [];
+    let i = 0;
+    while (i < headings.length) {
+        const heading = headings[i];
+        // Only process headings at the top level for this call
+        if (heading.level !== topLevel) {
+            i++;
+            continue;
+        }
+        // Find the end of this section: next heading at same or higher level
+        let endLine;
+        const children = [];
+        let j = i + 1;
+        while (j < headings.length) {
+            if (headings[j].level <= topLevel)
+                break;
+            children.push(headings[j]);
+            j++;
+        }
+        // endLine is the line before the next same-level heading, or end of content
+        if (j < headings.length) {
+            endLine = headings[j].lineIndex - 1;
+        }
+        else {
+            endLine = allLines.length - 1;
+        }
+        // Extract content between heading line and endLine
+        const contentLines = allLines.slice(heading.lineIndex + 1, endLine + 1);
+        const content = contentLines.join("\n").trim();
+        // Recursively build subsections
+        const subsections = children.length > 0
+            ? buildSectionTree(children, allLines)
+            : [];
+        sections.push(Section.create({
+            heading: heading.text,
+            level: heading.level,
+            content,
+            startLine: heading.lineIndex,
+            endLine,
+            subsections,
+        }));
+        i = j;
+    }
+    return sections;
+}
+//# sourceMappingURL=services.js.map

package/dist/domain/vault/services.js.map

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

package/dist/domain/vault/table.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Vault Table and Inline Element Value Objects
+ *
+ * MarkdownTable: parses and manipulates pipe-delimited markdown tables.
+ * Checkbox: represents a markdown checkbox item (- [ ] / - [x]).
+ * Wikilink: represents an Obsidian [[wikilink]] or [[path|alias]].
+ *
+ * All value objects are immutable. Mutators return new instances.
+ *
+ * DDD: Value Objects - equality by content, no identity
+ * SOLID: SRP - each type handles one structural concern
+ */
+export interface Checkbox {
+    readonly text: string;
+    readonly checked: boolean;
+    readonly line: number;
+    readonly indentLevel: number;
+}
+export interface Wikilink {
+    readonly target: string;
+    readonly alias: string | undefined;
+    readonly line: number;
+}
+export type TableAlignment = "left" | "center" | "right" | "none";
+/**
+ * Immutable representation of a pipe-delimited markdown table.
+ * Supports parsing, querying, mutation (returns new), and re-serialization.
+ */
+export declare class MarkdownTable {
+    readonly headers: readonly string[];
+    readonly rows: readonly (readonly string[])[];
+    readonly alignments: readonly TableAlignment[];
+    readonly startLine: number;
+    readonly endLine: number;
+    private constructor();
+    /**
+     * Parse a markdown table from consecutive lines.
+     * Expects: header row, separator row, then data rows.
+     * Returns null if lines don't form a valid table.
+     */
+    static parse(lines: readonly string[], startLine: number): MarkdownTable | null;
+    /** Get all values in a column by header name. */
+    getColumn(name: string): readonly string[];
+    /** Get a row by zero-based index. */
+    getRow(index: number): readonly string[] | null;
+    /** Find rows where a column matches a value (exact match). */
+    findRows(column: string, value: string): readonly (readonly string[])[];
+    /** Return a new table with a row appended. */
+    withRowAppended(values: readonly string[]): MarkdownTable;
+    /**
+     * Return a new table with the first matching row updated.
+     * Matches by a specific column value, then applies updates by column name.
+     */
+    withRowUpdated(matchColumn: string, matchValue: string, updates: Record<string, string>): MarkdownTable;
+    /** Serialize back to aligned markdown table string. */
+    toMarkdown(): string;
+}
+//# sourceMappingURL=table.d.ts.map

package/dist/domain/vault/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/domain/vault/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAIlE;;;GAGG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO;IAcP;;;;OAIG;IACH,MAAM,CAAC,KAAK,CACV,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,IAAI;IAkCvB,iDAAiD;IACjD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAM1C,qCAAqC;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI;IAI/C,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE;IAMvE,8CAA8C;IAC9C,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa;IAWzD;;;OAGG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,aAAa;IA0BhB,uDAAuD;IACvD,UAAU,IAAI,MAAM;CA8CrB"}

package/dist/domain/vault/table.js

@@ -0,0 +1,204 @@
+/**
+ * Vault Table and Inline Element Value Objects
+ *
+ * MarkdownTable: parses and manipulates pipe-delimited markdown tables.
+ * Checkbox: represents a markdown checkbox item (- [ ] / - [x]).
+ * Wikilink: represents an Obsidian [[wikilink]] or [[path|alias]].
+ *
+ * All value objects are immutable. Mutators return new instances.
+ *
+ * DDD: Value Objects - equality by content, no identity
+ * SOLID: SRP - each type handles one structural concern
+ */
+// ── MarkdownTable ─────────────────────────────────────────────────────
+/**
+ * Immutable representation of a pipe-delimited markdown table.
+ * Supports parsing, querying, mutation (returns new), and re-serialization.
+ */
+export class MarkdownTable {
+    headers;
+    rows;
+    alignments;
+    startLine;
+    endLine;
+    constructor(params) {
+        this.headers = params.headers;
+        this.rows = params.rows;
+        this.alignments = params.alignments;
+        this.startLine = params.startLine;
+        this.endLine = params.endLine;
+    }
+    /**
+     * Parse a markdown table from consecutive lines.
+     * Expects: header row, separator row, then data rows.
+     * Returns null if lines don't form a valid table.
+     */
+    static parse(lines, startLine) {
+        if (lines.length < 2)
+            return null;
+        const headerLine = lines[0];
+        const separatorLine = lines[1];
+        if (headerLine === undefined || separatorLine === undefined)
+            return null;
+        // Validate separator row (must contain pipes and dashes)
+        if (!/^\s*\|?[\s:|-]+\|?\s*$/.test(separatorLine))
+            return null;
+        const headers = parsePipeRow(headerLine);
+        if (headers.length === 0)
+            return null;
+        const alignments = parseAlignments(separatorLine, headers.length);
+        const rows = [];
+        for (let i = 2; i < lines.length; i++) {
+            const line = lines[i];
+            if (line === undefined || !line.includes("|"))
+                break;
+            const cells = parsePipeRow(line);
+            // Pad or trim to match header count
+            const normalized = normalizeRow(cells, headers.length);
+            rows.push(normalized);
+        }
+        return new MarkdownTable({
+            headers,
+            rows,
+            alignments,
+            startLine,
+            endLine: startLine + 2 + rows.length - 1,
+        });
+    }
+    /** Get all values in a column by header name. */
+    getColumn(name) {
+        const idx = this.headers.indexOf(name);
+        if (idx === -1)
+            return [];
+        return this.rows.map((row) => row[idx] ?? "");
+    }
+    /** Get a row by zero-based index. */
+    getRow(index) {
+        return this.rows[index] ?? null;
+    }
+    /** Find rows where a column matches a value (exact match). */
+    findRows(column, value) {
+        const idx = this.headers.indexOf(column);
+        if (idx === -1)
+            return [];
+        return this.rows.filter((row) => (row[idx] ?? "") === value);
+    }
+    /** Return a new table with a row appended. */
+    withRowAppended(values) {
+        const normalized = normalizeRow([...values], this.headers.length);
+        return new MarkdownTable({
+            headers: this.headers,
+            rows: [...this.rows, normalized],
+            alignments: this.alignments,
+            startLine: this.startLine,
+            endLine: this.endLine + 1,
+        });
+    }
+    /**
+     * Return a new table with the first matching row updated.
+     * Matches by a specific column value, then applies updates by column name.
+     */
+    withRowUpdated(matchColumn, matchValue, updates) {
+        const matchIdx = this.headers.indexOf(matchColumn);
+        if (matchIdx === -1)
+            return this;
+        const newRows = this.rows.map((row) => {
+            if ((row[matchIdx] ?? "") !== matchValue)
+                return row;
+            const mutableRow = [...row];
+            for (const [col, val] of Object.entries(updates)) {
+                const colIdx = this.headers.indexOf(col);
+                if (colIdx !== -1) {
+                    mutableRow[colIdx] = val;
+                }
+            }
+            return mutableRow;
+        });
+        return new MarkdownTable({
+            headers: this.headers,
+            rows: newRows,
+            alignments: this.alignments,
+            startLine: this.startLine,
+            endLine: this.endLine,
+        });
+    }
+    /** Serialize back to aligned markdown table string. */
+    toMarkdown() {
+        const colWidths = this.headers.map((h, i) => {
+            let max = h.length;
+            for (const row of this.rows) {
+                const cell = row[i] ?? "";
+                if (cell.length > max)
+                    max = cell.length;
+            }
+            return max;
+        });
+        const pad = (text, width) => text + " ".repeat(Math.max(0, width - text.length));
+        const headerStr = "| " +
+            this.headers.map((h, i) => pad(h, colWidths[i])).join(" | ") +
+            " |";
+        const sepStr = "| " +
+            this.alignments
+                .map((align, i) => {
+                const width = colWidths[i];
+                switch (align) {
+                    case "left":
+                        return ":" + "-".repeat(Math.max(1, width - 1));
+                    case "right":
+                        return "-".repeat(Math.max(1, width - 1)) + ":";
+                    case "center":
+                        return ":" + "-".repeat(Math.max(1, width - 2)) + ":";
+                    case "none":
+                        return "-".repeat(width);
+                }
+            })
+                .join(" | ") +
+            " |";
+        const rowStrs = this.rows.map((row) => "| " +
+            row.map((cell, i) => pad(cell, colWidths[i])).join(" | ") +
+            " |");
+        return [headerStr, sepStr, ...rowStrs].join("\n");
+    }
+}
+// ── Private Helpers ───────────────────────────────────────────────────
+function parsePipeRow(line) {
+    const trimmed = line.trim();
+    // Remove leading/trailing pipe
+    const inner = trimmed.startsWith("|")
+        ? trimmed.slice(1)
+        : trimmed;
+    const cleaned = inner.endsWith("|")
+        ? inner.slice(0, -1)
+        : inner;
+    return cleaned.split("|").map((cell) => cell.trim());
+}
+function parseAlignments(separatorLine, count) {
+    const cells = parsePipeRow(separatorLine);
+    const alignments = [];
+    for (let i = 0; i < count; i++) {
+        const cell = (cells[i] ?? "").trim();
+        const left = cell.startsWith(":");
+        const right = cell.endsWith(":");
+        if (left && right) {
+            alignments.push("center");
+        }
+        else if (right) {
+            alignments.push("right");
+        }
+        else if (left) {
+            alignments.push("left");
+        }
+        else {
+            alignments.push("none");
+        }
+    }
+    return alignments;
+}
+function normalizeRow(cells, targetLength) {
+    const result = [];
+    for (let i = 0; i < targetLength; i++) {
+        result.push(cells[i] ?? "");
+    }
+    return result;
+}
+//# sourceMappingURL=table.js.map

package/dist/domain/vault/table.js.map

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

package/dist/domain/vault/timeline.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Vault Timeline Value Objects
+ *
+ * Models the Chronos Timeline plugin syntax for Obsidian.
+ * TimelineEntry represents a single timeline item (event, period, point, marker).
+ * TimelineBlock represents a complete ```chronos code block.
+ *
+ * DDD: Value Objects - immutable, equality by content
+ * SOLID: SRP - timeline serialization/parsing only
+ */
+export type ChronosItemType = "event" | "period" | "point" | "marker";
+export type ChronosColor = "red" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "cyan";
+export declare class TimelineEntry {
+    readonly type: ChronosItemType;
+    readonly startDate: string;
+    readonly endDate: string | undefined;
+    readonly name: string;
+    readonly description: string | undefined;
+    readonly color: ChronosColor | undefined;
+    readonly group: string | undefined;
+    private constructor();
+    static create(params: {
+        readonly type: ChronosItemType;
+        readonly startDate: string;
+        readonly endDate?: string;
+        readonly name: string;
+        readonly description?: string;
+        readonly color?: ChronosColor;
+        readonly group?: string;
+    }): TimelineEntry;
+    /**
+     * Serialize to a single Chronos timeline line.
+     * Format: `{prefix} [{date}] #color {Group} Name | Description`
+     */
+    toChronosLine(): string;
+}
+export declare class TimelineBlock {
+    readonly entries: readonly TimelineEntry[];
+    readonly flags: readonly string[];
+    private constructor();
+    static create(entries: readonly TimelineEntry[], flags?: readonly string[]): TimelineBlock;
+    /**
+     * Parse a Chronos code block body (content between ```chronos fences).
+     * Recognizes entry lines (- @ * =) and flag lines (>).
+     * Comments (#) are ignored.
+     */
+    static parse(blockContent: string): TimelineBlock;
+    /** Serialize to a complete ```chronos fenced code block. */
+    toChronosBlock(): string;
+    /** Return a new block with an entry appended. */
+    withEntry(entry: TimelineEntry): TimelineBlock;
+}
+//# sourceMappingURL=timeline.d.ts.map

package/dist/domain/vault/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../src/domain/vault/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,CAAC;AAWX,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC,OAAO;IAkBP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QACpB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;QAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;QAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,aAAa;IAwBjB;;;OAGG;IACH,aAAa,IAAI,MAAM;CAuBxB;AAID,qBAAa,aAAa;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC,OAAO;IAQP,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GACxB,aAAa;IAIhB;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa;IA0FjD,4DAA4D;IAC5D,cAAc,IAAI,MAAM;IAYxB,iDAAiD;IACjD,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa;CAG/C"}