phaibel 4.0.7

package/dist/entities/entity-index.js

@@ -0,0 +1,369 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// ENTITY INDEX & RELATIONSHIP GRAPH
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// In-memory index of all entities in the active project.
+// Stores lightweight node records (id, type, title, filepath) and a directed
+// edge list extracted from @slug (people) and type:slug (entity) references.
+// ─────────────────────────────────────────────────────────────────────────────
+import { promises as fs } from 'fs';
+import path from 'path';
+import { getVaultRoot } from '../state/manager.js';
+import { parseEntity } from './entity.js';
+import { loadEntityTypes } from './entity-type-config.js';
+import { extractPeopleMentions, extractEntityRefs } from '../context/mentions.js';
+import { debug } from '../utils/debug.js';
+// Entity type list and directory mapping are now loaded dynamically from
+// entity-type-config so that user-defined types are automatically indexed.
+/**
+ * Extract validated links from entity frontmatter `links` field.
+ */
+function extractFrontmatterLinks(meta) {
+    const raw = meta.links;
+    if (!Array.isArray(raw))
+        return [];
+    const links = [];
+    for (const item of raw) {
+        if (item && typeof item === 'object' && typeof item.target === 'string' && typeof item.label === 'string') {
+            links.push({ target: item.target, label: item.label });
+        }
+    }
+    return links;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// ENTITY INDEX
+// ─────────────────────────────────────────────────────────────────────────────
+export class EntityIndex {
+    nodes = new Map(); // key = "type:id"
+    edges = [];
+    _builtAt = null;
+    // ── Key helpers ─────────────────────────────────────────────────────
+    static key(type, id) {
+        return `${type}:${id}`;
+    }
+    // ── Build ───────────────────────────────────────────────────────────
+    /**
+     * Scan all entity directories, build node map and edge list.
+     */
+    async build() {
+        const vaultRoot = await getVaultRoot();
+        const entityTypes = await loadEntityTypes();
+        // Pass 1: collect all nodes
+        for (const typeConfig of entityTypes) {
+            const entityType = typeConfig.name;
+            const dir = path.join(vaultRoot, typeConfig.directory);
+            try {
+                const files = await fs.readdir(dir);
+                for (const file of files) {
+                    if (!file.endsWith('.md') || file.startsWith('.'))
+                        continue;
+                    const filepath = path.join(dir, file);
+                    try {
+                        const raw = await fs.readFile(filepath, 'utf-8');
+                        const { meta } = parseEntity(filepath, raw);
+                        const id = meta.id || path.basename(file, '.md');
+                        const key = EntityIndex.key(entityType, id);
+                        this.nodes.set(key, {
+                            id,
+                            type: entityType,
+                            title: meta.title || id,
+                            filepath,
+                            tags: Array.isArray(meta.tags) ? meta.tags : [],
+                            summary: meta.summary ?? '',
+                        });
+                    }
+                    catch (err) {
+                        debug('index', `Failed to parse ${filepath}: ${err}`);
+                    }
+                }
+            }
+            catch {
+                // Directory doesn't exist — skip
+            }
+        }
+        // Pass 2: extract edges from content and frontmatter links
+        const typeNames = entityTypes.map(t => t.name);
+        for (const typeConfig of entityTypes) {
+            const entityType = typeConfig.name;
+            const dir = path.join(vaultRoot, typeConfig.directory);
+            try {
+                const files = await fs.readdir(dir);
+                for (const file of files) {
+                    if (!file.endsWith('.md') || file.startsWith('.'))
+                        continue;
+                    const filepath = path.join(dir, file);
+                    try {
+                        const raw = await fs.readFile(filepath, 'utf-8');
+                        const { meta, content } = parseEntity(filepath, raw);
+                        const id = meta.id || path.basename(file, '.md');
+                        const sourceKey = EntityIndex.key(entityType, id);
+                        // @slug → person mention edges
+                        const peopleSlugs = extractPeopleMentions(content);
+                        for (const slug of peopleSlugs) {
+                            const targetKey = EntityIndex.key('person', slug);
+                            if (this.nodes.has(targetKey)) {
+                                this.edges.push({
+                                    source: sourceKey,
+                                    target: targetKey,
+                                    edgeType: 'mention',
+                                });
+                            }
+                        }
+                        // type:slug → entity reference edges
+                        const entityRefs = extractEntityRefs(content, typeNames);
+                        for (const ref of entityRefs) {
+                            const targetKey = EntityIndex.key(ref.type, ref.slug);
+                            if (this.nodes.has(targetKey)) {
+                                this.edges.push({
+                                    source: sourceKey,
+                                    target: targetKey,
+                                    edgeType: 'reference',
+                                });
+                            }
+                        }
+                        // frontmatter links → labeled link edges
+                        const fmLinks = extractFrontmatterLinks(meta);
+                        for (const link of fmLinks) {
+                            if (this.nodes.has(link.target)) {
+                                this.edges.push({
+                                    source: sourceKey,
+                                    target: link.target,
+                                    edgeType: 'link',
+                                    label: link.label,
+                                });
+                            }
+                        }
+                    }
+                    catch (err) {
+                        debug('index', `Failed to extract refs from ${filepath}: ${err}`);
+                    }
+                }
+            }
+            catch {
+                // Directory doesn't exist — skip
+            }
+        }
+        this._builtAt = new Date();
+        if (process.env.PHAIBEL_DEBUG === '1') {
+            console.debug(`[index] Built index: ${this.nodes.size} nodes, ${this.edges.length} edges`);
+        }
+    }
+    /**
+     * Clear and rebuild the index.
+     */
+    async rebuild() {
+        this.nodes.clear();
+        this.edges = [];
+        this._builtAt = null;
+        await this.build();
+    }
+    // ── Incremental mutations ────────────────────────────────────────────
+    get isBuilt() {
+        return this._builtAt !== null;
+    }
+    /**
+     * Add or update a single node and re-scan its content for edges.
+     * Avoids a full rebuild when a single entity is created or modified.
+     */
+    async addOrUpdate(type, id, title, filepath, tags, summary) {
+        const key = EntityIndex.key(type, id);
+        // Upsert node
+        this.nodes.set(key, { id, type, title, filepath, tags: tags ?? [], summary: summary ?? '' });
+        // Remove old outbound edges from this node
+        this.edges = this.edges.filter(e => e.source !== key);
+        // Re-scan content and frontmatter for new edges
+        try {
+            const raw = await fs.readFile(filepath, 'utf-8');
+            const { meta, content } = parseEntity(filepath, raw);
+            const peopleSlugs = extractPeopleMentions(content);
+            for (const slug of peopleSlugs) {
+                const targetKey = EntityIndex.key('person', slug);
+                if (this.nodes.has(targetKey)) {
+                    this.edges.push({ source: key, target: targetKey, edgeType: 'mention' });
+                }
+            }
+            const entityTypes = await loadEntityTypes();
+            const typeNames = entityTypes.map(t => t.name);
+            const entityRefs = extractEntityRefs(content, typeNames);
+            for (const ref of entityRefs) {
+                const targetKey = EntityIndex.key(ref.type, ref.slug);
+                if (this.nodes.has(targetKey)) {
+                    this.edges.push({ source: key, target: targetKey, edgeType: 'reference' });
+                }
+            }
+            const fmLinks = extractFrontmatterLinks(meta);
+            for (const link of fmLinks) {
+                if (this.nodes.has(link.target)) {
+                    this.edges.push({ source: key, target: link.target, edgeType: 'link', label: link.label });
+                }
+            }
+        }
+        catch (err) {
+            debug('index', `Failed to scan edges for ${filepath}: ${err}`);
+        }
+        debug('index', `Index updated: ${type}:${id} (${this.nodes.size} nodes, ${this.edges.length} edges)`);
+    }
+    /**
+     * Remove a node and all its inbound/outbound edges.
+     */
+    remove(type, id) {
+        const key = EntityIndex.key(type, id);
+        this.nodes.delete(key);
+        this.edges = this.edges.filter(e => e.source !== key && e.target !== key);
+        debug('index', `Index removed: ${type}:${id} (${this.nodes.size} nodes, ${this.edges.length} edges)`);
+    }
+    // ── Search ──────────────────────────────────────────────────────────
+    /**
+     * Search nodes by query against title, tags, and summary.
+     * Tokenizes query; scoring: title=3, tag=2, summary=1 per token.
+     * All tokens must match at least one field.
+     */
+    search(query, entityType) {
+        const rawTokens = query.toLowerCase().split(/\s+/).filter(Boolean);
+        // Separate tag:value tokens from regular search tokens
+        const tagTokens = [];
+        const searchTokens = [];
+        for (const token of rawTokens) {
+            if (token.startsWith('tag:') || token.startsWith('tags:')) {
+                const tagValue = token.slice(token.indexOf(':') + 1);
+                if (tagValue)
+                    tagTokens.push(tagValue);
+            }
+            else {
+                searchTokens.push(token);
+            }
+        }
+        if (searchTokens.length === 0 && tagTokens.length === 0)
+            return [];
+        const results = [];
+        for (const node of this.nodes.values()) {
+            if (entityType && node.type !== entityType)
+                continue;
+            const titleLower = node.title.toLowerCase();
+            const tagsLower = node.tags.map(t => t.toLowerCase());
+            const summaryLower = node.summary.toLowerCase();
+            // Pre-filter by tag tokens if present
+            if (tagTokens.length > 0) {
+                const hasMatchingTag = tagTokens.some(ft => tagsLower.includes(ft));
+                if (!hasMatchingTag)
+                    continue;
+            }
+            // If no search tokens, return all tag-matched nodes
+            if (searchTokens.length === 0) {
+                results.push({ node, score: 1 });
+                continue;
+            }
+            let score = 0;
+            let allMatched = true;
+            for (const token of searchTokens) {
+                let matched = false;
+                if (titleLower.includes(token)) {
+                    score += 3;
+                    matched = true;
+                }
+                if (tagsLower.some(tag => tag.includes(token))) {
+                    score += 2;
+                    matched = true;
+                }
+                if (summaryLower.includes(token)) {
+                    score += 1;
+                    matched = true;
+                }
+                if (!matched) {
+                    allMatched = false;
+                    break;
+                }
+            }
+            if (allMatched && score > 0) {
+                results.push({ node, score });
+            }
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results;
+    }
+    /**
+     * Find a single node by exact or partial title match.
+     * Exact match on id or title (case-insensitive), fallback to partial.
+     */
+    findByTitle(entityType, titleOrId) {
+        const needle = titleOrId.toLowerCase();
+        let partialMatch = null;
+        for (const node of this.nodes.values()) {
+            if (node.type !== entityType)
+                continue;
+            // Exact match on id or title
+            if (node.id === titleOrId || node.title.toLowerCase() === needle) {
+                return node;
+            }
+            // Partial match
+            if (!partialMatch) {
+                const titleLower = node.title.toLowerCase();
+                if (titleLower.includes(needle) || needle.includes(titleLower)) {
+                    partialMatch = node;
+                }
+            }
+        }
+        return partialMatch;
+    }
+    // ── Queries ──────────────────────────────────────────────────────────
+    getNode(key) {
+        return this.nodes.get(key);
+    }
+    getNodes(type) {
+        const all = [...this.nodes.values()];
+        return type ? all.filter(n => n.type === type) : all;
+    }
+    getEdgesFrom(key) {
+        return this.edges.filter(e => e.source === key);
+    }
+    getEdgesTo(key) {
+        return this.edges.filter(e => e.target === key);
+    }
+    getNeighbors(key) {
+        const results = [];
+        const seen = new Set();
+        for (const edge of this.edges) {
+            if (edge.source === key && !seen.has(`out:${edge.target}`)) {
+                const node = this.nodes.get(edge.target);
+                if (node) {
+                    results.push({ node, direction: 'out', edgeType: edge.edgeType, label: edge.label });
+                    seen.add(`out:${edge.target}`);
+                }
+            }
+            if (edge.target === key && !seen.has(`in:${edge.source}`)) {
+                const node = this.nodes.get(edge.source);
+                if (node) {
+                    results.push({ node, direction: 'in', edgeType: edge.edgeType, label: edge.label });
+                    seen.add(`in:${edge.source}`);
+                }
+            }
+        }
+        return results;
+    }
+    getAllEdges() {
+        return [...this.edges];
+    }
+    getStats() {
+        const byType = {};
+        for (const node of this.nodes.values()) {
+            byType[node.type] = (byType[node.type] || 0) + 1;
+        }
+        return {
+            nodeCount: this.nodes.size,
+            edgeCount: this.edges.length,
+            byType,
+            builtAt: this._builtAt?.toISOString() || 'never',
+        };
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// SINGLETON
+// ─────────────────────────────────────────────────────────────────────────────
+let _index = null;
+export function getEntityIndex() {
+    if (!_index) {
+        _index = new EntityIndex();
+    }
+    return _index;
+}
+//# sourceMappingURL=entity-index.js.map

package/dist/entities/entity-index.js.map

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

package/dist/entities/entity-summary.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate a short summary (max 150 chars) for an entity using the 'summarize' LLM capability.
+ * Falls back to the first 150 chars of body content on failure.
+ */
+export declare function generateEntitySummary(entityType: string, title: string, content: string, meta: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=entity-summary.d.ts.map

package/dist/entities/entity-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-summary.d.ts","sourceRoot":"","sources":["../../src/entities/entity-summary.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/entities/entity-summary.js

@@ -0,0 +1,36 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// ENTITY SUMMARY GENERATOR
+// Generates a one-sentence LLM summary for an entity, persisted in frontmatter.
+// ─────────────────────────────────────────────────────────────────────────────
+import { getModelForCapability } from '../llm/router.js';
+import { debug } from '../utils/debug.js';
+/**
+ * Generate a short summary (max 150 chars) for an entity using the 'summarize' LLM capability.
+ * Falls back to the first 150 chars of body content on failure.
+ */
+export async function generateEntitySummary(entityType, title, content, meta) {
+    try {
+        const llm = await getModelForCapability('summarize');
+        const metaSnippet = Object.entries(meta)
+            .filter(([k]) => !['id', '_filepath', 'created', 'updated', 'summary'].includes(k))
+            .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
+            .join('\n');
+        const prompt = `Summarize this ${entityType} in one sentence (max 150 chars). Return ONLY the summary, no quotes or prefix.
+
+Title: ${title}
+${metaSnippet ? `Metadata:\n${metaSnippet}\n` : ''}${content ? `Content:\n${content.slice(0, 500)}` : ''}`;
+        const summary = await llm.chat([{ role: 'user', content: prompt }], { maxTokens: 100, temperature: 0.3 });
+        const trimmed = summary.trim().slice(0, 150);
+        return trimmed || fallback(content);
+    }
+    catch (err) {
+        debug('summary', `LLM summary failed, using fallback: ${err}`);
+        return fallback(content);
+    }
+}
+function fallback(content) {
+    if (!content)
+        return '';
+    return content.replace(/\s+/g, ' ').trim().slice(0, 150);
+}
+//# sourceMappingURL=entity-summary.js.map

package/dist/entities/entity-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-summary.js","sourceRoot":"","sources":["../../src/entities/entity-summary.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAChF,gFAAgF;AAEhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,UAAkB,EAClB,KAAa,EACb,OAAe,EACf,IAA6B;IAE7B,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAErD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;aACnC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;aAClF,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhB,MAAM,MAAM,GAAG,kBAAkB,UAAU;;SAE1C,KAAK;EACZ,WAAW,CAAC,CAAC,CAAC,cAAc,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAEnG,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAC1B,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EACnC,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CACvC,CAAC;QAEF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7C,OAAO,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,KAAK,CAAC,SAAS,EAAE,uCAAuC,GAAG,EAAE,CAAC,CAAC;QAC/D,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC"}

package/dist/entities/entity-type-config.d.ts

@@ -0,0 +1,83 @@
+import { BUILT_IN_TYPE_NAMES } from './entity-types-defaults.js';
+export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'enum' | 'array' | 'object';
+export interface FieldDef {
+    key: string;
+    type: FieldType;
+    label?: string;
+    required?: boolean;
+    default?: unknown;
+    values?: string[];
+}
+/** Maps a field from the template entity to the spawned child entity */
+export interface FieldMapping {
+    from?: string;
+    to?: string;
+    target?: string;
+    value?: string;
+    default?: unknown;
+}
+export interface DateSeriesScheduling {
+    cadenceField: string;
+    cadenceDetailsField: string;
+    blackoutField: string;
+}
+export interface SpawnerConfig {
+    mode: 'date-series' | 'template';
+    targetTypeField?: string;
+    titlePattern?: string;
+    dedupeFields?: string[];
+    scheduling?: DateSeriesScheduling;
+    fieldMapping?: FieldMapping[];
+    childrenField?: string;
+}
+export interface EntityTypeConfig {
+    name: string;
+    plural: string;
+    directory: string;
+    description?: string;
+    defaultTags?: string[];
+    fields: FieldDef[];
+    completionField?: string;
+    completionValue?: string;
+    spawner?: SpawnerConfig;
+}
+/**
+ * Load entity type configs. Returns vault file contents if present,
+ * otherwise falls back to built-in defaults.
+ */
+export declare function loadEntityTypes(): Promise<EntityTypeConfig[]>;
+/**
+ * Save entity type configs to the vault file.
+ */
+export declare function saveEntityTypes(types: EntityTypeConfig[]): Promise<void>;
+/**
+ * Write entity-types.json with built-in defaults if it doesn't already exist.
+ * Called by `phaibel init`.
+ */
+export declare function initEntityTypes(): Promise<void>;
+/**
+ * Get the config for a specific entity type by name.
+ */
+export declare function getEntityType(name: string): Promise<EntityTypeConfig | null>;
+/**
+ * List all registered entity type names.
+ */
+export declare function listEntityTypeNames(): Promise<string[]>;
+/**
+ * Get all entity types that have a spawner config.
+ */
+export declare function getSpawnerTypes(): Promise<EntityTypeConfig[]>;
+/**
+ * Add a new entity type. Throws if name already exists.
+ */
+export declare function addEntityType(config: EntityTypeConfig): Promise<void>;
+/**
+ * Replace an entity type by name. Throws if not found.
+ */
+export declare function updateEntityType(name: string, config: EntityTypeConfig): Promise<void>;
+/**
+ * Remove an entity type by name. Throws if not found or is built-in.
+ */
+export declare function removeEntityType(name: string): Promise<void>;
+export { BUILT_IN_TYPE_NAMES };
+//# sourceMappingURL=entity-type-config.d.ts.map

package/dist/entities/entity-type-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-type-config.d.ts","sourceRoot":"","sources":["../../src/entities/entity-type-config.ts"],"names":[],"mappings":"AAQA,OAAO,EAAwB,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAQvF,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5G,MAAM,WAAW,QAAQ;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,aAAa,GAAG,UAAU,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B;AAqBD;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiBnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9E;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrD;AAMD;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGlF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAG7D;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAGnE;AAMD;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5F;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlE;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}