@sdd-method/sdd-cli 0.9.0 → 0.11.0

package/dist/lib/catalogue/builders/adrs.js

@@ -0,0 +1,191 @@
+// ADR discoverer — emits `adrs.csv` rows from every `adr/*.md` file
+// under `docs/`.
+//
+// Source paths discovered:
+//   - docs/platform/adr/ADR XXXX: Title.md   (platform-scoped)
+//   - docs/method/adr/ADR XXXX: Title.md     (method-scoped → domain_id=platform)
+//   - docs/domains/<domain>/architecture/adr/ADR XXXX: Title.md
+//
+// Per ADR 0136 the method-scope ADRs are owned by the platform-root in
+// the federation chain (the highest-up SDD that holds them via the seed-
+// file distribution). App and integration profile SDDs skip emission of
+// method-scope ADRs so the aggregated catalogue carries each method ADR
+// exactly once with an unambiguous source_sdd_id.
+//
+// File-content extraction (best-effort, no failure on missing fields):
+//   - **Status:** value
+//   - **Date:** YYYY-MM-DD
+//   - **Supersedes:** raw text (captured into supersedes_raw for the
+//     adr_supersedes builder to parse)
+//
+// ID canonicalisation: filename stem `ADR XXXX[: Title]` → `ADR-{0-padded}`.
+// Title = the portion after the colon when present, else the file stem
+// minus the prefix.
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+const PROFILES_THAT_OWN_METHOD_SCOPE = new Set([
+    "platform-profile",
+]);
+const FILENAME_RE = /^ADR[\s-]?(\d{3,4})(?:[:\s-]+(.*))?$/i;
+export async function buildAdrs(inputs) {
+    const docsDir = join(inputs.sddPath, "docs");
+    const files = await collectAdrFiles(docsDir);
+    const seen = new Set();
+    const parsed = [];
+    const ownsMethodScope = PROFILES_THAT_OWN_METHOD_SCOPE.has(inputs.profile);
+    let methodScopeSkipCount = 0;
+    for (const file of files.sort()) {
+        const stem = baseStem(file);
+        const m = FILENAME_RE.exec(stem);
+        if (!m || m[1] === undefined) {
+            // Template file (e.g. `ADR {0000}: ...`) or non-ADR markdown — skip silently.
+            continue;
+        }
+        const num = parseInt(m[1], 10);
+        if (!Number.isFinite(num))
+            continue;
+        const adrId = `ADR-${String(num).padStart(4, "0")}`;
+        if (seen.has(adrId)) {
+            inputs.findings.add("divergence", `${relative(inputs.sddPath, file)}: ADR id ${adrId} already emitted by an earlier file`);
+            continue;
+        }
+        const relPath = relative(inputs.sddPath, file);
+        const { domainId, scope } = scopeFromPath(relPath);
+        if ((scope === "method" || scope === "platform") && !ownsMethodScope) {
+            // Per ADR 0136: method- and platform-scope ADRs are emitted only by
+            // the SDD that owns the platform scope (platform-profile in
+            // adopting ecosystems). App and integration SDDs hold seed-file
+            // copies on disk but do not contribute them to the federated
+            // catalogue.
+            methodScopeSkipCount++;
+            continue;
+        }
+        seen.add(adrId);
+        const titleFromFilename = (m[2] ?? "").trim() || stem;
+        const text = await readFile(file, "utf-8");
+        const title = extractH1Title(text) || titleFromFilename;
+        const status = extractField(text, "Status") || "Accepted";
+        const decisionDate = extractField(text, "Date") || "";
+        const supersedesRaw = extractField(text, "Supersedes") || "";
+        if (scope === "domain" && !inputs.knownDomainIds.has(domainId)) {
+            inputs.findings.add("orphan", `${relPath}: ADR is in domain "${domainId}" but no docs/domains/${domainId}/ exists`);
+        }
+        if (scope === "method") {
+            // Method ADRs are method-cross-cutting; conventionally bound to the
+            // platform domain for FK resolution.
+            inputs.findings.add("inferred", `${relPath}: method-scoped ADR ${adrId} bound to domain_id=platform for FK resolution`);
+        }
+        parsed.push({
+            id: adrId,
+            title,
+            status,
+            domainId,
+            decisionDate,
+            docPath: relPath,
+            supersedesRaw,
+        });
+    }
+    if (methodScopeSkipCount > 0) {
+        inputs.findings.add("coverage", `${methodScopeSkipCount} method/platform-scope ADR(s) skipped — emitted by ecosystem root only per ADR 0136`);
+    }
+    const rows = parsed.map((a) => ({
+        id: a.id,
+        title: a.title,
+        status: a.status,
+        domain_id: a.domainId,
+        decision_date: a.decisionDate,
+        doc_path: a.docPath,
+        superseded_by_id: "", // populated in a backfill pass after adr_supersedes builds
+        inference_confidence: "",
+        supersedes_raw: a.supersedesRaw,
+        source_sdd_id: "",
+    }));
+    return { rows, parsed };
+}
+function baseStem(absPath) {
+    const base = absPath.split(sep).slice(-1)[0] ?? "";
+    return base.replace(/\.md$/i, "");
+}
+function scopeFromPath(relPath) {
+    const parts = relPath.split(sep);
+    const domainsIdx = parts.indexOf("domains");
+    if (domainsIdx !== -1 && domainsIdx + 1 < parts.length) {
+        return { domainId: parts[domainsIdx + 1] ?? "", scope: "domain" };
+    }
+    if (parts.includes("method")) {
+        return { domainId: "platform", scope: "method" };
+    }
+    return { domainId: "platform", scope: "platform" };
+}
+function extractH1Title(text) {
+    for (const line of text.split(/\r?\n/)) {
+        const t = line.trim();
+        if (t === "")
+            continue;
+        if (!t.startsWith("#"))
+            return "";
+        // `# ADR 0001: Title` → `Title`; otherwise return the heading text.
+        const stripped = t.replace(/^#+\s*/, "").trim();
+        const adrPrefix = /^ADR[\s-]?\d+(?:[:\s-]+(.*))?$/i.exec(stripped);
+        if (adrPrefix) {
+            return (adrPrefix[1] ?? "").trim();
+        }
+        return stripped;
+    }
+    return "";
+}
+/**
+ * Extract a value from a metadata bullet of the form:
+ *   * **Field:** value
+ *   - **Field:** value
+ *   **Field:** value
+ * Returns the trimmed value, or empty string if not found.
+ */
+function extractField(text, field) {
+    const re = new RegExp(`^\\s*[*\\-]?\\s*\\*\\*${escapeRegex(field)}:\\*\\*\\s*(.*?)\\s*$`, "im");
+    const m = re.exec(text);
+    if (!m || m[1] === undefined)
+        return "";
+    return m[1].trim();
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+async function collectAdrFiles(docsDir) {
+    const out = [];
+    let entries;
+    try {
+        entries = await readdir(docsDir, { withFileTypes: true });
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return [];
+        throw err;
+    }
+    for (const entry of entries) {
+        const full = join(docsDir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === "adr") {
+                // Walk all files in the adr/ directory (no nesting expected).
+                const inner = await readdir(full, { withFileTypes: true });
+                for (const f of inner) {
+                    if (f.isFile() && f.name.endsWith(".md") && !isTemplate(f.name)) {
+                        out.push(join(full, f.name));
+                    }
+                }
+            }
+            else {
+                out.push(...(await collectAdrFiles(full)));
+            }
+        }
+    }
+    return out;
+}
+function isTemplate(filename) {
+    // Excludes template files like `ADR {0000}: {Short, Descriptive Title}.md`.
+    return /[{}]/.test(filename);
+}
+/** Drop-in stat used during testing — unused at runtime but kept exported for symmetry. */
+export const _statForTest = stat;
+//# sourceMappingURL=adrs.js.map

package/dist/lib/catalogue/builders/adrs.js.map

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

package/dist/lib/catalogue/builders/c4-containers.d.ts

@@ -0,0 +1,16 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { SddManifest } from "../manifest-loader.js";
+export interface C4ContainersBuildInputs {
+    readonly sddPath: string;
+    readonly manifest: SddManifest;
+    readonly findings: FindingsLog;
+    /** known c4_systems ids — for single-system ecosystems, a one-element set. */
+    readonly knownSystemIds: ReadonlySet<string>;
+    /** known service ids — for opportunistic service_id matching. */
+    readonly knownServiceIds: ReadonlySet<string>;
+    /** known domain ids — guards the denormalised domain_id column. */
+    readonly knownDomainIds: ReadonlySet<string>;
+}
+export declare function buildC4Containers(inputs: C4ContainersBuildInputs): Promise<CatalogueRow[]>;
+//# sourceMappingURL=c4-containers.d.ts.map

package/dist/lib/catalogue/builders/c4-containers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"c4-containers.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/c4-containers.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9C;AA+BD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,YAAY,EAAE,CAAC,CAsDzB"}

package/dist/lib/catalogue/builders/c4-containers.js

@@ -0,0 +1,169 @@
+// C4 L2 containers discoverer — emits `c4_containers.csv` rows from
+// C4-PlantUML-style mermaid in:
+//   - docs/domains/<slug>/architecture/diagrams/c4-l2-container.mermaid.md
+//   - docs/platform/diagrams/c4-l2-container.mermaid.md
+//
+// Per schema 2.0.0:
+//   - system_id (required FK to c4_systems.id) — for single-system
+//     ecosystems we use {sddId}-system. Multi-system support (parsing a
+//     `**System:** <id>` metadata line) is a future hook.
+//   - domain_id (nullable, denormalised) derived from the L2 file path:
+//     docs/domains/<slug>/... → <slug>; platform-wide L2 → empty.
+//   - service_id (optional) — opportunistic match on the C4 entry's id
+//     or a slug of its display name to a known service id.
+//
+// We only consider entries inside System_Boundary or Container_Boundary
+// blocks — mirrors the python reference and excludes Person/System_Ext
+// declarations that decorate the diagram.
+//
+// Dedupe is by row id; first-seen wins (a container appearing in
+// multiple L2 files becomes one row).
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, sep } from "node:path";
+const L2_BASENAME = "c4-l2-container.mermaid.md";
+// Boundary opener: `System_Boundary(id, "name") {` or `Container_Boundary(...)`.
+const BOUNDARY_OPEN_RE = /^(System_Boundary|Container_Boundary)\s*\(\s*\w+/;
+// C4-PlantUML container entries inside boundaries.
+//   Container(id, "name", "tech", "desc")
+//   ContainerDb(id, "name", "tech", "desc")
+//   ContainerQueue(id, "name", "tech", "desc")
+//   Container_Ext(id, "name", "tech", "desc")
+const ENTRY_RE = /(Container|ContainerDb|ContainerQueue|Container_Ext)\s*\(\s*(\w+)\s*,\s*"([^"]+)"\s*(?:,\s*"([^"]*)")?\s*(?:,\s*"([^"]*)")?\s*\)/;
+const TYPE_BY_KIND = {
+    Container: "Application",
+    ContainerDb: "Data Store",
+    ContainerQueue: "Infrastructure",
+    Container_Ext: "External System",
+};
+export async function buildC4Containers(inputs) {
+    const systemId = `${inputs.manifest.sddId}-system`;
+    if (!inputs.knownSystemIds.has(systemId)) {
+        // Non-architectural SDD — c4-systems emitted no row, so no FK target
+        // exists. Skip silently; c4-systems already logged the situation.
+        return [];
+    }
+    const files = await collectL2Files(inputs.sddPath);
+    const rows = [];
+    const seen = new Set();
+    for (const file of files) {
+        const content = await readFile(file.absPath, "utf-8");
+        for (const entry of parseBoundaryEntries(content)) {
+            const slug = slugify(entry.name);
+            if (slug === "")
+                continue;
+            const id = `${systemId}-${slug}`;
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            const serviceId = inputs.knownServiceIds.has(entry.entryId)
+                ? entry.entryId
+                : inputs.knownServiceIds.has(slug)
+                    ? slug
+                    : "";
+            const domainId = file.domainId !== "" && inputs.knownDomainIds.has(file.domainId)
+                ? file.domainId
+                : "";
+            if (file.domainId !== "" && domainId === "") {
+                inputs.findings.add("orphan", `c4_containers: L2 file at ${file.relPath} references unknown domain "${file.domainId}" — domain_id left empty`);
+            }
+            rows.push({
+                id,
+                name: entry.name,
+                system_id: systemId,
+                domain_id: domainId,
+                service_id: serviceId,
+                type: TYPE_BY_KIND[entry.kind] ?? "",
+                technology: entry.technology,
+                description: entry.description,
+                source_sdd_id: "",
+            });
+        }
+    }
+    rows.sort((a, b) => String(a["id"]).localeCompare(String(b["id"])));
+    return rows;
+}
+async function collectL2Files(sddPath) {
+    const out = [];
+    // 1. Per-domain L2 files.
+    const domainsDir = join(sddPath, "docs", "domains");
+    let domainEntries;
+    try {
+        domainEntries = (await readdir(domainsDir, { withFileTypes: true }))
+            .filter((e) => e.isDirectory())
+            .map((e) => ({ name: e.name }));
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+        domainEntries = [];
+    }
+    for (const entry of domainEntries.sort((a, b) => a.name.localeCompare(b.name))) {
+        const rel = join("docs", "domains", entry.name, "architecture", "diagrams", L2_BASENAME);
+        const abs = join(sddPath, rel);
+        if (await isFile(abs)) {
+            out.push({
+                absPath: abs,
+                relPath: rel.split(sep).join("/"),
+                domainId: entry.name,
+            });
+        }
+    }
+    // 2. Platform-wide L2.
+    const platformRel = join("docs", "platform", "diagrams", L2_BASENAME);
+    const platformAbs = join(sddPath, platformRel);
+    if (await isFile(platformAbs)) {
+        out.push({
+            absPath: platformAbs,
+            relPath: platformRel.split(sep).join("/"),
+            domainId: "",
+        });
+    }
+    return out;
+}
+async function isFile(path) {
+    try {
+        const s = await stat(path);
+        return s.isFile();
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return false;
+        throw err;
+    }
+}
+function parseBoundaryEntries(content) {
+    const out = [];
+    const stack = [];
+    for (const raw of content.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (BOUNDARY_OPEN_RE.test(line) && line.includes("{")) {
+            stack.push("boundary");
+            continue;
+        }
+        if (line === "}" && stack.length > 0) {
+            stack.pop();
+            continue;
+        }
+        if (stack.length === 0)
+            continue;
+        const m = ENTRY_RE.exec(line);
+        if (!m)
+            continue;
+        out.push({
+            kind: m[1] ?? "",
+            entryId: m[2] ?? "",
+            name: m[3] ?? "",
+            technology: m[4] ?? "",
+            description: m[5] ?? "",
+        });
+    }
+    return out;
+}
+function slugify(s) {
+    return s
+        .toLowerCase()
+        .replace(/\s*\([^)]+\)/g, "")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+//# sourceMappingURL=c4-containers.js.map

package/dist/lib/catalogue/builders/c4-containers.js.map

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

package/dist/lib/catalogue/builders/c4-systems.d.ts

@@ -0,0 +1,10 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { SddManifest } from "../manifest-loader.js";
+export interface C4SystemsBuildInputs {
+    readonly sddPath: string;
+    readonly manifest: SddManifest;
+    readonly findings: FindingsLog;
+}
+export declare function buildC4Systems(inputs: C4SystemsBuildInputs): Promise<CatalogueRow[]>;
+//# sourceMappingURL=c4-systems.d.ts.map

package/dist/lib/catalogue/builders/c4-systems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"c4-systems.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/c4-systems.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC;AAqBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,YAAY,EAAE,CAAC,CAgCzB"}

package/dist/lib/catalogue/builders/c4-systems.js

@@ -0,0 +1,99 @@
+// C4 L1 systems discoverer — emits at most one `c4_systems.csv` row.
+//
+// Per ADR 0134's federation model, each SDD emits its OWN c4_systems
+// row when its manifest category is architectural. Categories map to
+// the c4_system_kind enum (catalogue-schema.yaml):
+//   platform-root        → platform
+//   application-product  → application
+//   integration-provider → integration
+// Non-architectural categories (platform-subsystem, integration-umbrella,
+// support-repo) emit zero rows.
+//
+// The id is `{sddId}-system` to match the products row's product_id FK.
+// Description is parsed from the L1 mermaid `System(...)` line when a
+// platform L1 file exists, otherwise left empty (visible coverage gap).
+import { readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+const KIND_BY_CATEGORY = {
+    "platform-root": "platform",
+    "application-product": "application",
+    "integration-provider": "integration",
+};
+// L1 candidate paths in priority order. First existing file wins.
+const L1_CANDIDATES = [
+    "docs/platform/diagrams/c4-l1-context.mermaid.md",
+    "docs/diagrams/c4-l1-context.mermaid.md",
+    "docs/application/c4-l1.md",
+    "docs/c4-l1.md",
+];
+// Match `System(id, "name", "description")` — the L1 root-system entry.
+// Permissive about whitespace and the optional description argument.
+const SYSTEM_RE = /^System\s*\(\s*\w+\s*,\s*"([^"]+)"\s*(?:,\s*"([^"]*)")?\s*\)/;
+export async function buildC4Systems(inputs) {
+    const kind = KIND_BY_CATEGORY[inputs.manifest.category];
+    if (kind === undefined) {
+        // Non-architectural — emit zero rows by design (no finding; the
+        // metamodel says these categories never have a system row).
+        return [];
+    }
+    const { diagramPath, name, description } = await findL1(inputs.sddPath, inputs.manifest.sddId);
+    if (diagramPath === "") {
+        inputs.findings.add("coverage", `c4_systems: no L1 diagram found for ${inputs.manifest.sddId} — diagram_path empty`);
+    }
+    const sddId = inputs.manifest.sddId;
+    return [
+        {
+            id: `${sddId}-system`,
+            name: name !== "" ? name : titleCase(sddId),
+            product_id: sddId,
+            kind,
+            diagram_path: diagramPath,
+            description,
+            source_sdd_id: "",
+        },
+    ];
+}
+async function findL1(sddPath, sddId) {
+    for (const rel of L1_CANDIDATES) {
+        const abs = join(sddPath, rel);
+        try {
+            const s = await stat(abs);
+            if (!s.isFile())
+                continue;
+            const content = await readFile(abs, "utf-8");
+            const parsed = parseSystemLine(content);
+            return {
+                diagramPath: rel,
+                name: parsed?.name ?? "",
+                description: parsed?.description ?? "",
+            };
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== "ENOENT")
+                throw err;
+        }
+    }
+    void sddId;
+    return { diagramPath: "", name: "", description: "" };
+}
+function parseSystemLine(content) {
+    for (const raw of content.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (line.startsWith("System_Ext") || line.startsWith("System_Boundary")) {
+            continue;
+        }
+        const m = SYSTEM_RE.exec(line);
+        if (m) {
+            return { name: m[1] ?? "", description: m[2] ?? "" };
+        }
+    }
+    return null;
+}
+function titleCase(slug) {
+    return slug
+        .split("-")
+        .map((p) => (p.length === 0 ? p : p[0].toUpperCase() + p.slice(1)))
+        .join(" ");
+}
+//# sourceMappingURL=c4-systems.js.map

package/dist/lib/catalogue/builders/c4-systems.js.map

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

package/dist/lib/catalogue/builders/capabilities.d.ts

@@ -0,0 +1,11 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { TraceabilityManifest } from "../traceability-loader.js";
+export interface CapabilitiesBuildInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    readonly manifests: readonly TraceabilityManifest[];
+    readonly knownDomainIds: ReadonlySet<string>;
+}
+export declare function buildCapabilities(inputs: CapabilitiesBuildInputs): Promise<CatalogueRow[]>;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/lib/catalogue/builders/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/capabilities.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9C;AAID,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,YAAY,EAAE,CAAC,CA8FzB"}