pulseed 0.4.3 → 0.4.6

package/dist/platform/soil/doctor.js

@@ -0,0 +1,380 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createSoilConfig } from "./config.js";
+import { computeSoilChecksum } from "./checksum.js";
+import { parseSoilMarkdownLoose } from "./io.js";
+import { loadSoilIndexSnapshot } from "./index-store.js";
+import { normalizeSoilId, normalizeSoilRelativePath, resolveSoilPageRelativePath, soilIdToRelativePath, soilPageRelativePathFromAbsolute, } from "./paths.js";
+import { SoilPageFrontmatterSchema } from "./types.js";
+export class SoilDoctor {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    static create(configInput = {}) {
+        return new SoilDoctor(createSoilConfig(configInput));
+    }
+    async inspect() {
+        const pages = await this.scanPages();
+        const findings = [];
+        const bySoilId = new Map();
+        const indexablePages = pages.filter((page) => page.parseError === null && page.frontmatter !== null);
+        const indexSnapshot = await loadSoilIndexSnapshot(this.config);
+        if (indexSnapshot === null) {
+            findings.push({
+                code: "missing-index",
+                severity: "error",
+                relativePath: path.relative(this.config.rootDir, this.config.indexPath) || this.config.indexPath,
+                absolutePath: this.config.indexPath,
+                message: "Soil index snapshot is missing",
+            });
+        }
+        else {
+            if (indexSnapshot.page_count !== indexablePages.length) {
+                findings.push({
+                    code: "index-page-count-mismatch",
+                    severity: "warn",
+                    relativePath: path.relative(this.config.rootDir, this.config.indexPath) || this.config.indexPath,
+                    absolutePath: this.config.indexPath,
+                    message: "Indexed page count does not match the current Soil manifest",
+                    details: {
+                        indexed_page_count: indexSnapshot.page_count,
+                        actual_page_count: indexablePages.length,
+                    },
+                });
+            }
+            const indexedByPath = new Map(indexSnapshot.pages.map((page) => [page.relative_path, page]));
+            for (const page of indexablePages) {
+                const frontmatter = page.frontmatter;
+                if (frontmatter === null) {
+                    continue;
+                }
+                const indexedPage = indexedByPath.get(page.relativePath);
+                const actualChecksum = computeSoilChecksum({
+                    frontmatter: this.withoutVolatileFields(frontmatter),
+                    body: parseSoilMarkdownLoose(page.content).body,
+                });
+                if (indexedPage === undefined) {
+                    findings.push({
+                        code: "index-checksum-mismatch",
+                        severity: "warn",
+                        soilId: frontmatter.soil_id,
+                        relativePath: page.relativePath,
+                        absolutePath: page.absolutePath,
+                        message: "Indexed page is missing from the Soil index snapshot",
+                        details: {
+                            indexedChecksum: null,
+                            actualChecksum,
+                        },
+                    });
+                    continue;
+                }
+                if (indexedPage.checksum !== actualChecksum) {
+                    findings.push({
+                        code: "index-checksum-mismatch",
+                        severity: "warn",
+                        soilId: frontmatter.soil_id,
+                        relativePath: page.relativePath,
+                        absolutePath: page.absolutePath,
+                        message: "Indexed checksum does not match the current page checksum",
+                        details: {
+                            indexedChecksum: indexedPage.checksum,
+                            actualChecksum,
+                        },
+                    });
+                }
+            }
+        }
+        for (const page of pages) {
+            const frontmatter = page.frontmatter;
+            if (page.parseError || frontmatter === null) {
+                findings.push({
+                    code: "invalid-frontmatter",
+                    severity: "error",
+                    relativePath: page.relativePath,
+                    absolutePath: page.absolutePath,
+                    message: page.parseError ?? "Soil frontmatter is invalid",
+                });
+                continue;
+            }
+            let soilId;
+            try {
+                soilId = normalizeSoilId(frontmatter.soil_id);
+            }
+            catch (error) {
+                findings.push({
+                    code: "unsafe-path",
+                    severity: "warn",
+                    relativePath: page.relativePath,
+                    absolutePath: page.absolutePath,
+                    message: `Unsafe soil_id path: ${frontmatter.soil_id}`,
+                    details: {
+                        soil_id: frontmatter.soil_id,
+                        error: error instanceof Error ? error.message : String(error),
+                    },
+                });
+                continue;
+            }
+            const records = bySoilId.get(soilId) ?? [];
+            records.push(page);
+            bySoilId.set(soilId, records);
+            if (!this.isCanonicalPath(page.relativePath, soilId)) {
+                findings.push({
+                    code: "unsafe-path",
+                    severity: "warn",
+                    soilId,
+                    relativePath: page.relativePath,
+                    absolutePath: page.absolutePath,
+                    message: `Page path does not match canonical soil_id path: ${soilIdToRelativePath(soilId)}`,
+                    details: { canonicalPath: soilIdToRelativePath(soilId) },
+                });
+            }
+            const checksumMismatch = this.checkChecksumMismatch(page.content, frontmatter);
+            if (checksumMismatch !== null) {
+                findings.push({
+                    code: "checksum-mismatch",
+                    severity: "warn",
+                    soilId,
+                    relativePath: page.relativePath,
+                    absolutePath: page.absolutePath,
+                    message: checksumMismatch.message,
+                    details: checksumMismatch.details,
+                });
+            }
+            const watermarkMismatch = await this.checkWatermarkMismatch(page, frontmatter);
+            if (watermarkMismatch !== null) {
+                findings.push({
+                    code: "watermark-mismatch",
+                    severity: "warn",
+                    soilId,
+                    relativePath: page.relativePath,
+                    absolutePath: page.absolutePath,
+                    message: watermarkMismatch.message,
+                    details: watermarkMismatch.details,
+                });
+            }
+            findings.push(...(await this.checkSourcePaths(page, frontmatter)));
+        }
+        for (const [soilId, records] of bySoilId.entries()) {
+            if (records.length < 2) {
+                continue;
+            }
+            for (const record of records) {
+                findings.push({
+                    code: "duplicate-soil-id",
+                    severity: "warn",
+                    soilId,
+                    relativePath: record.relativePath,
+                    absolutePath: record.absolutePath,
+                    message: `Duplicate soil_id detected: ${soilId}`,
+                    details: {
+                        duplicates: records.map((item) => item.relativePath),
+                    },
+                });
+            }
+        }
+        findings.push(...(await this.checkRequiredPages(pages)));
+        return {
+            rootDir: this.config.rootDir,
+            totalPages: pages.length,
+            findings,
+        };
+    }
+    async scanPages() {
+        const pages = [];
+        await this.walk(this.config.rootDir, pages);
+        return pages;
+    }
+    async checkRequiredPages(pages) {
+        const findings = [];
+        const existing = new Set(pages.map((page) => page.relativePath));
+        const requiredPages = [
+            { relativePath: "index.md", severity: "error", message: "Required Soil entry page is missing: index.md" },
+            {
+                relativePath: "schedule/active.md",
+                severity: "warn",
+                message: "Required active schedule page is missing: schedule/active.md",
+            },
+        ];
+        for (const page of requiredPages) {
+            if (existing.has(page.relativePath)) {
+                continue;
+            }
+            const absolutePath = path.join(this.config.rootDir, page.relativePath);
+            findings.push({
+                code: "missing-required-page",
+                severity: page.severity,
+                relativePath: page.relativePath,
+                absolutePath,
+                message: page.message,
+            });
+        }
+        return findings;
+    }
+    async walk(dir, pages) {
+        const entries = await fsp.readdir(dir, { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            if (entry.name.startsWith(".")) {
+                continue;
+            }
+            const absolutePath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await this.walk(absolutePath, pages);
+                continue;
+            }
+            if (!entry.isFile() || !entry.name.endsWith(".md")) {
+                continue;
+            }
+            const content = await fsp.readFile(absolutePath, "utf-8").catch(() => "");
+            const relativePath = soilPageRelativePathFromAbsolute(this.config.rootDir, absolutePath);
+            const parsed = parseSoilMarkdownLoose(content);
+            const frontmatter = parsed.hasFrontmatter ? SoilPageFrontmatterSchema.safeParse(parsed.frontmatter) : null;
+            pages.push({
+                relativePath,
+                absolutePath,
+                content,
+                frontmatter: frontmatter && frontmatter.success ? frontmatter.data : null,
+                parseError: frontmatter && frontmatter.success ? null : this.describeParseError(content, frontmatter),
+            });
+        }
+    }
+    describeParseError(content, parsed) {
+        if (!content.trim()) {
+            return "Soil page is empty";
+        }
+        if (parsed === null || !("success" in parsed) || !parsed.success) {
+            return "Soil frontmatter is invalid";
+        }
+        return "Soil frontmatter is invalid";
+    }
+    isCanonicalPath(relativePath, soilId) {
+        try {
+            return normalizeSoilRelativePath(relativePath) === resolveSoilPageRelativePath(soilId);
+        }
+        catch {
+            return false;
+        }
+    }
+    checkChecksumMismatch(content, frontmatter) {
+        if (!frontmatter.checksum) {
+            return null;
+        }
+        const computed = computeSoilChecksum({
+            frontmatter: this.withoutVolatileFields(frontmatter),
+            body: parseSoilMarkdownLoose(content).body,
+        });
+        if (computed === frontmatter.checksum) {
+            return null;
+        }
+        return {
+            message: "Stored checksum does not match page contents",
+            details: { expected: frontmatter.checksum, actual: computed },
+        };
+    }
+    async checkWatermarkMismatch(page, frontmatter) {
+        const watermark = frontmatter.generation_watermark;
+        if (!watermark) {
+            return null;
+        }
+        const sourcePaths = new Set();
+        if (watermark.source_path) {
+            sourcePaths.add(watermark.source_path);
+        }
+        for (const sourcePath of watermark.source_paths ?? []) {
+            sourcePaths.add(sourcePath);
+        }
+        const mismatches = [];
+        for (const sourcePath of sourcePaths) {
+            const resolved = await this.resolveLocalSourcePath(page.absolutePath, sourcePath);
+            if (resolved === null) {
+                continue;
+            }
+            const expected = watermark.input_checksums?.[sourcePath] ?? watermark.source_hash ?? null;
+            if (!expected) {
+                continue;
+            }
+            const actual = await this.computeFileChecksum(resolved);
+            if (actual !== expected) {
+                mismatches.push({ sourcePath, expected, actual });
+            }
+        }
+        if (mismatches.length === 0) {
+            return null;
+        }
+        return {
+            message: "Generation watermark source checksum mismatch",
+            details: { mismatches },
+        };
+    }
+    async checkSourcePaths(page, frontmatter) {
+        const findings = [];
+        const sourcePaths = new Set();
+        for (const sourceRef of frontmatter.source_refs ?? []) {
+            sourcePaths.add(sourceRef.source_path);
+            if (sourceRef.source_uri?.startsWith("file://")) {
+                sourcePaths.add(fileURLToPath(sourceRef.source_uri));
+            }
+        }
+        if (frontmatter.generation_watermark?.source_path) {
+            sourcePaths.add(frontmatter.generation_watermark.source_path);
+        }
+        for (const sourcePath of frontmatter.generation_watermark?.source_paths ?? []) {
+            sourcePaths.add(sourcePath);
+        }
+        for (const sourcePath of sourcePaths) {
+            const resolved = await this.resolveLocalSourcePath(page.absolutePath, sourcePath);
+            if (resolved === null) {
+                continue;
+            }
+            const exists = await fsp.access(resolved).then(() => true, () => false);
+            if (!exists) {
+                findings.push({
+                    code: "missing-source-path",
+                    severity: "warn",
+                    soilId: frontmatter.soil_id,
+                    relativePath: page.relativePath,
+                    absolutePath: page.absolutePath,
+                    message: `Missing local source path: ${sourcePath}`,
+                    details: { sourcePath, resolvedPath: resolved },
+                });
+            }
+        }
+        return findings;
+    }
+    async resolveLocalSourcePath(pagePath, sourcePath) {
+        if (!sourcePath) {
+            return null;
+        }
+        if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(sourcePath) && !sourcePath.startsWith("file://")) {
+            return null;
+        }
+        if (sourcePath.startsWith("file://")) {
+            return fileURLToPath(sourcePath);
+        }
+        if (path.isAbsolute(sourcePath)) {
+            return path.resolve(sourcePath);
+        }
+        return path.resolve(path.dirname(pagePath), sourcePath);
+    }
+    async computeFileChecksum(filePath) {
+        const content = await fsp.readFile(filePath, "utf-8");
+        return computeSoilChecksum(content);
+    }
+    withoutVolatileFields(frontmatter) {
+        return SoilPageFrontmatterSchema.parse({
+            ...frontmatter,
+            checksum: undefined,
+            generated_at: "1970-01-01T00:00:00.000Z",
+            updated_at: "1970-01-01T00:00:00.000Z",
+            generation_watermark: {
+                ...frontmatter.generation_watermark,
+                generated_at: "1970-01-01T00:00:00.000Z",
+            },
+        });
+    }
+}
+export async function inspectSoilRoot(configInput = {}) {
+    return SoilDoctor.create(configInput).inspect();
+}
+//# sourceMappingURL=doctor.js.map

package/dist/platform/soil/doctor.js.map

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

package/dist/platform/soil/frontmatter.d.ts

@@ -0,0 +1,15 @@
+import { type SoilPageFrontmatter } from "./types.js";
+export interface SoilMarkdownSplit {
+    frontmatter: Record<string, unknown>;
+    body: string;
+    hasFrontmatter: boolean;
+}
+export declare function splitSoilFrontmatter(content: string): SoilMarkdownSplit;
+export declare function parseSoilFrontmatter(content: string): SoilPageFrontmatter;
+export declare function parseSoilMarkdown(content: string): {
+    frontmatter: SoilPageFrontmatter;
+    body: string;
+};
+export declare function serializeSoilFrontmatter(frontmatter: SoilPageFrontmatter): string;
+export declare function serializeSoilMarkdown(frontmatter: SoilPageFrontmatter, body?: string): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/platform/soil/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/platform/soil/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;CACzB;AA0BD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA0BvE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAOzE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAUrG;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,mBAAmB,GAAG,MAAM,CAQjF;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,mBAAmB,EAAE,IAAI,SAAK,GAAG,MAAM,CAQzF"}

package/dist/platform/soil/frontmatter.js

@@ -0,0 +1,82 @@
+import * as yaml from "js-yaml";
+import { SoilPageFrontmatterSchema, } from "./types.js";
+function stripUndefined(value) {
+    if (Array.isArray(value)) {
+        return value
+            .map((item) => stripUndefined(item))
+            .filter((item) => item !== undefined);
+    }
+    if (value && typeof value === "object") {
+        const result = {};
+        for (const [key, entry] of Object.entries(value)) {
+            if (entry === undefined) {
+                continue;
+            }
+            const normalized = stripUndefined(entry);
+            if (normalized !== undefined) {
+                result[key] = normalized;
+            }
+        }
+        return result;
+    }
+    return value;
+}
+export function splitSoilFrontmatter(content) {
+    const lines = content.split("\n");
+    if (lines[0]?.trim() !== "---") {
+        return { frontmatter: {}, body: content, hasFrontmatter: false };
+    }
+    const closeIdx = lines.findIndex((line, index) => index > 0 && line.trim() === "---");
+    if (closeIdx === -1) {
+        return { frontmatter: {}, body: content, hasFrontmatter: false };
+    }
+    const yamlLines = lines.slice(1, closeIdx).join("\n");
+    const body = lines.slice(closeIdx + 1).join("\n");
+    let frontmatter = {};
+    try {
+        const parsed = yaml.load(yamlLines);
+        if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+            frontmatter = parsed;
+        }
+    }
+    catch {
+        frontmatter = {};
+    }
+    return { frontmatter, body, hasFrontmatter: true };
+}
+export function parseSoilFrontmatter(content) {
+    const split = splitSoilFrontmatter(content);
+    if (!split.hasFrontmatter) {
+        throw new Error("Soil frontmatter block is missing");
+    }
+    return SoilPageFrontmatterSchema.parse(split.frontmatter);
+}
+export function parseSoilMarkdown(content) {
+    const split = splitSoilFrontmatter(content);
+    if (!split.hasFrontmatter) {
+        throw new Error("Soil frontmatter block is missing");
+    }
+    return {
+        frontmatter: SoilPageFrontmatterSchema.parse(split.frontmatter),
+        body: split.body,
+    };
+}
+export function serializeSoilFrontmatter(frontmatter) {
+    const normalized = SoilPageFrontmatterSchema.parse(frontmatter);
+    const yamlText = yaml.dump(stripUndefined(normalized), {
+        noRefs: true,
+        lineWidth: -1,
+        sortKeys: false,
+    });
+    return `---\n${yamlText}---\n`;
+}
+export function serializeSoilMarkdown(frontmatter, body = "") {
+    const normalized = SoilPageFrontmatterSchema.parse(frontmatter);
+    const yamlText = yaml.dump(stripUndefined(normalized), {
+        noRefs: true,
+        lineWidth: -1,
+        sortKeys: false,
+    });
+    return `---\n${yamlText}---\n${body}`;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/platform/soil/frontmatter.js.map

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

package/dist/platform/soil/importer.d.ts

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import { type SoilConfigInput } from "./config.js";
+export declare const SoilOverlayStatusSchema: z.ZodEnum<["candidate", "approved", "rejected", "superseded"]>;
+export type SoilOverlayStatus = z.infer<typeof SoilOverlayStatusSchema>;
+export declare const SoilOverlayCandidateSchema: z.ZodObject<{
+    overlay_id: z.ZodString;
+    status: z.ZodEnum<["candidate", "approved", "rejected", "superseded"]>;
+    soil_id: z.ZodString;
+    relative_path: z.ZodString;
+    target_ref: z.ZodString;
+    content: z.ZodString;
+    content_hash: z.ZodString;
+    detected_at: z.ZodString;
+    updated_at: z.ZodString;
+    decision_note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "candidate" | "superseded" | "rejected" | "approved";
+    updated_at: string;
+    content: string;
+    detected_at: string;
+    overlay_id: string;
+    target_ref: string;
+    soil_id: string;
+    relative_path: string;
+    content_hash: string;
+    decision_note?: string | undefined;
+}, {
+    status: "candidate" | "superseded" | "rejected" | "approved";
+    updated_at: string;
+    content: string;
+    detected_at: string;
+    overlay_id: string;
+    target_ref: string;
+    soil_id: string;
+    relative_path: string;
+    content_hash: string;
+    decision_note?: string | undefined;
+}>;
+export type SoilOverlayCandidate = z.infer<typeof SoilOverlayCandidateSchema>;
+export declare const SoilOverlayQueueSchema: z.ZodObject<{
+    version: z.ZodLiteral<"soil-overlay-queue-v1">;
+    updated_at: z.ZodString;
+    overlays: z.ZodArray<z.ZodObject<{
+        overlay_id: z.ZodString;
+        status: z.ZodEnum<["candidate", "approved", "rejected", "superseded"]>;
+        soil_id: z.ZodString;
+        relative_path: z.ZodString;
+        target_ref: z.ZodString;
+        content: z.ZodString;
+        content_hash: z.ZodString;
+        detected_at: z.ZodString;
+        updated_at: z.ZodString;
+        decision_note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "candidate" | "superseded" | "rejected" | "approved";
+        updated_at: string;
+        content: string;
+        detected_at: string;
+        overlay_id: string;
+        target_ref: string;
+        soil_id: string;
+        relative_path: string;
+        content_hash: string;
+        decision_note?: string | undefined;
+    }, {
+        status: "candidate" | "superseded" | "rejected" | "approved";
+        updated_at: string;
+        content: string;
+        detected_at: string;
+        overlay_id: string;
+        target_ref: string;
+        soil_id: string;
+        relative_path: string;
+        content_hash: string;
+        decision_note?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    updated_at: string;
+    version: "soil-overlay-queue-v1";
+    overlays: {
+        status: "candidate" | "superseded" | "rejected" | "approved";
+        updated_at: string;
+        content: string;
+        detected_at: string;
+        overlay_id: string;
+        target_ref: string;
+        soil_id: string;
+        relative_path: string;
+        content_hash: string;
+        decision_note?: string | undefined;
+    }[];
+}, {
+    updated_at: string;
+    version: "soil-overlay-queue-v1";
+    overlays: {
+        status: "candidate" | "superseded" | "rejected" | "approved";
+        updated_at: string;
+        content: string;
+        detected_at: string;
+        overlay_id: string;
+        target_ref: string;
+        soil_id: string;
+        relative_path: string;
+        content_hash: string;
+        decision_note?: string | undefined;
+    }[];
+}>;
+export type SoilOverlayQueue = z.infer<typeof SoilOverlayQueueSchema>;
+export interface SoilImportOptions {
+    clock?: () => Date;
+}
+export declare function loadSoilOverlayQueue(configInput?: SoilConfigInput): Promise<SoilOverlayQueue>;
+export declare function scanSoilOverlays(configInput?: SoilConfigInput, options?: SoilImportOptions): Promise<SoilOverlayCandidate[]>;
+export declare function scanAndStoreSoilOverlays(configInput?: SoilConfigInput, options?: SoilImportOptions): Promise<SoilOverlayQueue>;
+export declare function updateSoilOverlayStatus(overlayId: string, status: SoilOverlayStatus, configInput?: SoilConfigInput, options?: SoilImportOptions & {
+    decisionNote?: string;
+}): Promise<SoilOverlayQueue>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/platform/soil/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../src/platform/soil/importer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAQrE,eAAO,MAAM,uBAAuB,gEAA8D,CAAC;AACnG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAoCD,wBAAsB,oBAAoB,CAAC,WAAW,GAAE,eAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAOvG;AAED,wBAAsB,gBAAgB,CACpC,WAAW,GAAE,eAAoB,EACjC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAuBjC;AAED,wBAAsB,wBAAwB,CAC5C,WAAW,GAAE,eAAoB,EACjC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA0B3B;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,iBAAiB,EACzB,WAAW,GAAE,eAAoB,EACjC,OAAO,GAAE,iBAAiB,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1D,OAAO,CAAC,gBAAgB,CAAC,CA2B3B"}