@sigil-engine/core 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @sigil-engine/core@0.1.0 build /Users/riomyers/sigil/packages/core
+> tsc
+

package/dist/cache.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Incremental extraction cache — skip unchanged files on re-extraction.
+ *
+ * Saves file hashes after extraction. On re-extract, compares hashes
+ * and returns which files need re-parsing.
+ */
+export interface FileCache {
+    files: Record<string, {
+        hash: string;
+        mtime: number;
+    }>;
+    last_full_extract: string;
+}
+export interface ChangedFiles {
+    changed: string[];
+    unchanged: string[];
+    added: string[];
+    removed: string[];
+}
+export declare function readCache(projectPath: string): FileCache | null;
+export declare function writeCache(projectPath: string, cache: FileCache): void;
+export declare function buildCacheFromFiles(projectPath: string, files: string[]): FileCache;
+export declare function getChangedFiles(projectPath: string, currentFiles: string[], cache: FileCache): ChangedFiles;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAgBD,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQ/D;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAEtE;AAMD,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EAAE,GACd,SAAS,CAoBX;AAMD,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,KAAK,EAAE,SAAS,GACf,YAAY,CAwCd"}

package/dist/cache.js

@@ -0,0 +1,97 @@
+/**
+ * Incremental extraction cache — skip unchanged files on re-extraction.
+ *
+ * Saves file hashes after extraction. On re-extract, compares hashes
+ * and returns which files need re-parsing.
+ */
+import { resolve } from "path";
+import { readFileSync, writeFileSync, existsSync, statSync } from "fs";
+import { createHash } from "crypto";
+// ---------------------------------------------------------------------------
+// Cache file path
+// ---------------------------------------------------------------------------
+const CACHE_FILENAME = ".sigil-cache.json";
+function cachePath(projectPath) {
+    return resolve(projectPath, CACHE_FILENAME);
+}
+// ---------------------------------------------------------------------------
+// Read / Write
+// ---------------------------------------------------------------------------
+export function readCache(projectPath) {
+    const cp = cachePath(projectPath);
+    if (!existsSync(cp))
+        return null;
+    try {
+        return JSON.parse(readFileSync(cp, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function writeCache(projectPath, cache) {
+    writeFileSync(cachePath(projectPath), JSON.stringify(cache, null, 2), "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Build cache from current file state
+// ---------------------------------------------------------------------------
+export function buildCacheFromFiles(projectPath, files) {
+    const fileMap = {};
+    const absProject = resolve(projectPath);
+    for (const relFile of files) {
+        const absFile = resolve(absProject, relFile);
+        try {
+            const stat = statSync(absFile);
+            const content = readFileSync(absFile, "utf-8");
+            const hash = createHash("sha256").update(content).digest("hex").slice(0, 12);
+            fileMap[relFile] = { hash, mtime: stat.mtimeMs };
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return {
+        files: fileMap,
+        last_full_extract: new Date().toISOString(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Determine changed files
+// ---------------------------------------------------------------------------
+export function getChangedFiles(projectPath, currentFiles, cache) {
+    const absProject = resolve(projectPath);
+    const changed = [];
+    const unchanged = [];
+    const added = [];
+    const currentSet = new Set(currentFiles);
+    for (const relFile of currentFiles) {
+        const cached = cache.files[relFile];
+        if (!cached) {
+            added.push(relFile);
+            continue;
+        }
+        try {
+            const absFile = resolve(absProject, relFile);
+            const stat = statSync(absFile);
+            // Quick check: mtime unchanged = file unchanged
+            if (stat.mtimeMs === cached.mtime) {
+                unchanged.push(relFile);
+                continue;
+            }
+            // mtime changed — verify with hash
+            const content = readFileSync(absFile, "utf-8");
+            const hash = createHash("sha256").update(content).digest("hex").slice(0, 12);
+            if (hash === cached.hash) {
+                unchanged.push(relFile);
+            }
+            else {
+                changed.push(relFile);
+            }
+        }
+        catch {
+            changed.push(relFile);
+        }
+    }
+    const removed = Object.keys(cache.files).filter((f) => !currentSet.has(f));
+    return { changed, unchanged, added, removed };
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/diff.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Context diff engine — structural comparison of two context documents.
+ *
+ * Compares entities, components, routes, exports, patterns, conventions,
+ * stack, and dependencies. Outputs a structured DiffResult.
+ *
+ * PURE: No I/O. Takes two documents, returns a diff.
+ */
+import type { ContextDocument } from "./schema.js";
+export type ChangeType = "added" | "removed" | "modified" | "renamed";
+export type ChangeCategory = "entity" | "component" | "route" | "export" | "pattern" | "convention" | "stack" | "dependency";
+export interface Change<T = unknown> {
+    type: ChangeType;
+    name: string;
+    category: ChangeCategory;
+    old?: T;
+    new?: T;
+    details?: string[];
+}
+export interface DiffResult {
+    summary: {
+        total_changes: number;
+        added: number;
+        removed: number;
+        modified: number;
+    };
+    changes: Change[];
+    stack_changes: Change[];
+    pattern_changes: Change[];
+    convention_changes: Change[];
+}
+export declare function diffContexts(oldDoc: ContextDocument, newDoc: ContextDocument): DiffResult;
+export declare function formatDiff(result: DiffResult): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,aAAa,CAAC;AAMrB,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtE,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,OAAO,GACP,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,OAAO,GACP,YAAY,CAAC;AAEjB,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAMD,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,GAAG,UAAU,CAmCzF;AAqRD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAiDrD"}

package/dist/diff.js

@@ -0,0 +1,319 @@
+/**
+ * Context diff engine — structural comparison of two context documents.
+ *
+ * Compares entities, components, routes, exports, patterns, conventions,
+ * stack, and dependencies. Outputs a structured DiffResult.
+ *
+ * PURE: No I/O. Takes two documents, returns a diff.
+ */
+// ---------------------------------------------------------------------------
+// Main diff
+// ---------------------------------------------------------------------------
+export function diffContexts(oldDoc, newDoc) {
+    const changes = [];
+    changes.push(...diffNamedList(oldDoc.entities, newDoc.entities, "entity", diffEntity));
+    changes.push(...diffNamedList(oldDoc.components, newDoc.components, "component", diffComponent));
+    changes.push(...diffByKey(oldDoc.routes, newDoc.routes, "route", (r) => r.path, diffRoute));
+    changes.push(...diffNamedList(oldDoc.exports, newDoc.exports, "export", diffExport));
+    changes.push(...diffDependencies(oldDoc, newDoc));
+    const stack_changes = diffRecord(oldDoc.stack ?? {}, newDoc.stack ?? {}, "stack");
+    const pattern_changes = diffRecord(oldDoc.patterns, newDoc.patterns, "pattern");
+    const convention_changes = diffRecord(oldDoc.conventions, newDoc.conventions, "convention");
+    const allChanges = [...changes, ...stack_changes, ...pattern_changes, ...convention_changes];
+    return {
+        summary: {
+            total_changes: allChanges.length,
+            added: allChanges.filter((c) => c.type === "added").length,
+            removed: allChanges.filter((c) => c.type === "removed").length,
+            modified: allChanges.filter((c) => c.type === "modified").length,
+        },
+        changes,
+        stack_changes,
+        pattern_changes,
+        convention_changes,
+    };
+}
+function diffNamedList(oldList, newList, category, detailDiff) {
+    const changes = [];
+    const oldMap = new Map();
+    for (const item of oldList) {
+        const key = item._meta ? `${item._meta.file}::${item.name}` : item.name;
+        oldMap.set(key, item);
+    }
+    const newMap = new Map();
+    for (const item of newList) {
+        const key = item._meta ? `${item._meta.file}::${item.name}` : item.name;
+        newMap.set(key, item);
+    }
+    for (const [key, newItem] of newMap) {
+        const oldItem = oldMap.get(key);
+        if (!oldItem) {
+            const byName = oldList.find((o) => o.name === newItem.name);
+            if (byName) {
+                const details = detailDiff(byName, newItem);
+                if (details.length > 0 || byName._meta?.file !== newItem._meta?.file) {
+                    const allDetails = byName._meta?.file !== newItem._meta?.file
+                        ? [`moved: ${byName._meta?.file} → ${newItem._meta?.file}`, ...details]
+                        : details;
+                    changes.push({ type: "modified", name: newItem.name, category, old: byName, new: newItem, details: allDetails });
+                }
+            }
+            else {
+                changes.push({ type: "added", name: newItem.name, category, new: newItem });
+            }
+        }
+        else {
+            const details = detailDiff(oldItem, newItem);
+            if (details.length > 0) {
+                changes.push({ type: "modified", name: newItem.name, category, old: oldItem, new: newItem, details });
+            }
+        }
+    }
+    for (const [key, oldItem] of oldMap) {
+        if (!newMap.has(key)) {
+            const byName = newList.find((n) => n.name === oldItem.name);
+            if (!byName) {
+                changes.push({ type: "removed", name: oldItem.name, category, old: oldItem });
+            }
+        }
+    }
+    return changes;
+}
+// ---------------------------------------------------------------------------
+// Key-based diffing (routes)
+// ---------------------------------------------------------------------------
+function diffByKey(oldList, newList, category, keyFn, detailDiff) {
+    const changes = [];
+    const oldMap = new Map(oldList.map((item) => [keyFn(item), item]));
+    const newMap = new Map(newList.map((item) => [keyFn(item), item]));
+    for (const [key, newItem] of newMap) {
+        const oldItem = oldMap.get(key);
+        if (!oldItem) {
+            changes.push({ type: "added", name: key, category, new: newItem });
+        }
+        else {
+            const details = detailDiff(oldItem, newItem);
+            if (details.length > 0) {
+                changes.push({ type: "modified", name: key, category, old: oldItem, new: newItem, details });
+            }
+        }
+    }
+    for (const [key, oldItem] of oldMap) {
+        if (!newMap.has(key)) {
+            changes.push({ type: "removed", name: key, category, old: oldItem });
+        }
+    }
+    return changes;
+}
+// ---------------------------------------------------------------------------
+// Record diffing (stack, patterns, conventions)
+// ---------------------------------------------------------------------------
+function diffRecord(oldObj, newObj, category) {
+    const changes = [];
+    const allKeys = new Set([...Object.keys(oldObj), ...Object.keys(newObj)]);
+    for (const key of allKeys) {
+        const oldVal = oldObj[key];
+        const newVal = newObj[key];
+        if (oldVal === undefined && newVal !== undefined) {
+            changes.push({ type: "added", name: key, category, new: newVal });
+        }
+        else if (oldVal !== undefined && newVal === undefined) {
+            changes.push({ type: "removed", name: key, category, old: oldVal });
+        }
+        else if (!deepEqual(oldVal, newVal)) {
+            changes.push({
+                type: "modified",
+                name: key,
+                category,
+                old: oldVal,
+                new: newVal,
+                details: [`${JSON.stringify(oldVal)} → ${JSON.stringify(newVal)}`],
+            });
+        }
+    }
+    return changes;
+}
+// ---------------------------------------------------------------------------
+// Dependency diffing
+// ---------------------------------------------------------------------------
+function diffDependencies(oldDoc, newDoc) {
+    const changes = [];
+    const oldDeps = new Map((oldDoc.dependencies ?? []).map((d) => [d.name, d.version]));
+    const newDeps = new Map((newDoc.dependencies ?? []).map((d) => [d.name, d.version]));
+    for (const [name, version] of newDeps) {
+        if (!oldDeps.has(name)) {
+            changes.push({ type: "added", name, category: "dependency", new: version });
+        }
+        else if (oldDeps.get(name) !== version) {
+            changes.push({
+                type: "modified", name, category: "dependency",
+                old: oldDeps.get(name), new: version,
+                details: [`${oldDeps.get(name)} → ${version}`],
+            });
+        }
+    }
+    for (const [name] of oldDeps) {
+        if (!newDeps.has(name)) {
+            changes.push({ type: "removed", name, category: "dependency", old: oldDeps.get(name) });
+        }
+    }
+    return changes;
+}
+// ---------------------------------------------------------------------------
+// Detail diff functions
+// ---------------------------------------------------------------------------
+function diffEntity(old, neu) {
+    const details = [];
+    const oldFields = new Map(old.fields.map((f) => [f.name, f]));
+    const newFields = new Map(neu.fields.map((f) => [f.name, f]));
+    for (const [name, newField] of newFields) {
+        if (!oldFields.has(name)) {
+            details.push(`+ field: ${name} (${newField.type})`);
+        }
+        else {
+            const oldField = oldFields.get(name);
+            if (oldField.type !== newField.type)
+                details.push(`~ field ${name}: type ${oldField.type} → ${newField.type}`);
+            if (oldField.nullable !== newField.nullable)
+                details.push(`~ field ${name}: nullable ${oldField.nullable} → ${newField.nullable}`);
+            if (oldField.unique !== newField.unique)
+                details.push(`~ field ${name}: unique ${oldField.unique} → ${newField.unique}`);
+        }
+    }
+    for (const name of oldFields.keys()) {
+        if (!newFields.has(name))
+            details.push(`- field: ${name}`);
+    }
+    const oldRels = new Set(old.relations.map((r) => `${r.to}:${r.type}`));
+    const newRels = new Set(neu.relations.map((r) => `${r.to}:${r.type}`));
+    for (const rel of newRels)
+        if (!oldRels.has(rel))
+            details.push(`+ relation: ${rel}`);
+    for (const rel of oldRels)
+        if (!newRels.has(rel))
+            details.push(`- relation: ${rel}`);
+    return details;
+}
+function diffComponent(old, neu) {
+    const details = [];
+    const oldProps = new Map(old.props.map((p) => [p.name, p]));
+    const newProps = new Map(neu.props.map((p) => [p.name, p]));
+    for (const [name, newProp] of newProps) {
+        if (!oldProps.has(name)) {
+            details.push(`+ prop: ${name}: ${newProp.type}`);
+        }
+        else if (oldProps.get(name).type !== newProp.type) {
+            details.push(`~ prop ${name}: ${oldProps.get(name).type} → ${newProp.type}`);
+        }
+    }
+    for (const name of oldProps.keys()) {
+        if (!newProps.has(name))
+            details.push(`- prop: ${name}`);
+    }
+    const addedDeps = neu.dependencies.filter((d) => !old.dependencies.includes(d));
+    const removedDeps = old.dependencies.filter((d) => !neu.dependencies.includes(d));
+    for (const d of addedDeps)
+        details.push(`+ dep: ${d}`);
+    for (const d of removedDeps)
+        details.push(`- dep: ${d}`);
+    return details;
+}
+function diffRoute(old, neu) {
+    const details = [];
+    const allMethods = new Set([...Object.keys(old.methods), ...Object.keys(neu.methods)]);
+    for (const method of allMethods) {
+        if (!old.methods[method] && neu.methods[method]) {
+            details.push(`+ method: ${method}`);
+        }
+        else if (old.methods[method] && !neu.methods[method]) {
+            details.push(`- method: ${method}`);
+        }
+        else if (old.methods[method] && neu.methods[method]) {
+            if (old.methods[method].auth !== neu.methods[method].auth) {
+                details.push(`~ ${method} auth: ${old.methods[method].auth} → ${neu.methods[method].auth}`);
+            }
+        }
+    }
+    return details;
+}
+function diffExport(old, neu) {
+    const details = [];
+    if (old.kind !== neu.kind)
+        details.push(`~ kind: ${old.kind} → ${neu.kind}`);
+    if (old.signature !== neu.signature)
+        details.push(`~ signature changed`);
+    return details;
+}
+// ---------------------------------------------------------------------------
+// Deep equality (replaces JSON.stringify comparison)
+// ---------------------------------------------------------------------------
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((val, i) => deepEqual(val, b[i]));
+    }
+    if (typeof a === "object" && typeof b === "object") {
+        const aObj = a;
+        const bObj = b;
+        const aKeys = Object.keys(aObj);
+        const bKeys = Object.keys(bObj);
+        if (aKeys.length !== bKeys.length)
+            return false;
+        return aKeys.every((key) => deepEqual(aObj[key], bObj[key]));
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Format diff for terminal output
+// ---------------------------------------------------------------------------
+export function formatDiff(result) {
+    const lines = [];
+    lines.push(`\n  Context Diff Summary`);
+    lines.push(`  ${"─".repeat(20)}`);
+    lines.push(`  ${result.summary.total_changes} changes: +${result.summary.added} added, -${result.summary.removed} removed, ~${result.summary.modified} modified\n`);
+    const allChanges = [
+        ...result.stack_changes,
+        ...result.pattern_changes,
+        ...result.convention_changes,
+        ...result.changes,
+    ];
+    const grouped = new Map();
+    for (const change of allChanges) {
+        const list = grouped.get(change.category) ?? [];
+        list.push(change);
+        grouped.set(change.category, list);
+    }
+    const labels = {
+        stack: "Stack", pattern: "Patterns", convention: "Conventions",
+        entity: "Entities", component: "Components", route: "Routes",
+        export: "Exports", dependency: "Dependencies",
+    };
+    for (const [cat, label] of Object.entries(labels)) {
+        const changes = grouped.get(cat);
+        if (!changes || changes.length === 0)
+            continue;
+        lines.push(`  ${label}`);
+        for (const change of changes) {
+            const symbol = change.type === "added" ? "+" : change.type === "removed" ? "-" : "~";
+            lines.push(`    ${symbol} ${change.name}`);
+            if (change.details) {
+                for (const detail of change.details) {
+                    lines.push(`      ${detail}`);
+                }
+            }
+        }
+        lines.push("");
+    }
+    if (result.summary.total_changes === 0) {
+        lines.push("  No changes detected.\n");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/extract.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Extraction orchestrator — discovers plugins, runs them, merges results.
+ *
+ * PURE: This module returns a ContextDocument. It does NOT write to disk.
+ * I/O is handled by the CLI or calling code.
+ */
+import { type ContextDocument } from "./schema.js";
+import { type ProgressCallback } from "./plugin.js";
+export interface ExtractOptions {
+    /** Absolute path to the project root */
+    projectPath: string;
+    /** Specific plugins to run (by name). If empty, auto-detect. */
+    plugins?: string[];
+    /** Progress callback for reporting extraction status */
+    onProgress?: ProgressCallback;
+}
+/**
+ * Extract a ContextDocument from a project.
+ *
+ * This is the primary API — it discovers applicable plugins,
+ * runs them, and merges results into a unified document.
+ *
+ * Returns a ContextDocument. Does NOT write to disk.
+ */
+export declare function extractContext(opts: ExtractOptions): Promise<ContextDocument>;
+export declare function deduplicateExports(doc: ContextDocument): void;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAqFnF;AAiCD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAM7D"}