@anselmdk/feature-spec-md 0.1.1 → 0.2.1

package/dist/specDocuments.js

@@ -0,0 +1,351 @@
+/**
+ * Cross-document parsing, validation, graph checks, and coverage aggregation
+ * for model, feature, stack, and design spec documents.
+ */
+import { readFile } from "node:fs/promises";
+import { expandFilePatterns } from "./filePatterns.js";
+import { buildCoverageSummary, parseFeatureSpec, parseTestReferences, validateCoverage, validateFeatureSpec, } from "./featureSpecs.js";
+import { dedupeTestReferences, lineForOffset, modelIdPattern, parseMarkdownDocument, parseRuleItems, sectionBounds, sectionText, trimBlankLines, } from "./specMarkdown.js";
+export function parseSpecDocument(source, options = {}) {
+    const filePath = options.filePath ?? "<inline>";
+    const kind = options.kind ?? kindFromPath(filePath);
+    if (kind === "model")
+        return parseModelSpec(source, { filePath });
+    if (kind === "stack")
+        return parseStackSpec(source, { filePath });
+    if (kind === "design")
+        return parseDesignSpec(source, { filePath });
+    return { ...parseFeatureSpec(source, { filePath }), kind: "feature" };
+}
+export function parseModelSpec(source, options = {}) {
+    const filePath = options.filePath ?? "<inline>";
+    const parsed = parseMarkdownDocument(source);
+    return {
+        kind: "model",
+        filePath,
+        frontmatter: parsed.frontmatter,
+        title: parsed.title,
+        purpose: parsed.purpose,
+        modelItems: parseModelItems(parsed.lines, parsed.bodyStartLine),
+        rules: parseRuleItems(parsed.lines, parsed.bodyStartLine),
+        source,
+    };
+}
+export function parseStackSpec(source, options = {}) {
+    const filePath = options.filePath ?? "<inline>";
+    const parsed = parseMarkdownDocument(source);
+    return {
+        kind: "stack",
+        filePath,
+        frontmatter: parsed.frontmatter,
+        title: parsed.title,
+        purpose: parsed.purpose,
+        stack: sectionText(parsed.lines, "Stack").trim(),
+        context: sectionText(parsed.lines, "Context").trim(),
+        rationale: sectionText(parsed.lines, "Rationale").trim(),
+        consequences: sectionText(parsed.lines, "Consequences").trim(),
+        rules: parseRuleItems(parsed.lines, parsed.bodyStartLine),
+        source,
+    };
+}
+export function parseDesignSpec(source, options = {}) {
+    const filePath = options.filePath ?? "<inline>";
+    const parsed = parseMarkdownDocument(source);
+    return {
+        kind: "design",
+        filePath,
+        frontmatter: parsed.frontmatter,
+        title: parsed.title,
+        purpose: parsed.purpose,
+        design: sectionText(parsed.lines, "Design").trim(),
+        principles: sectionText(parsed.lines, "Principles").trim(),
+        layout: sectionText(parsed.lines, "Layout").trim(),
+        interaction: sectionText(parsed.lines, "Interaction").trim(),
+        visualStyle: sectionText(parsed.lines, "Visual style").trim(),
+        rules: parseRuleItems(parsed.lines, parsed.bodyStartLine),
+        source,
+    };
+}
+export async function loadSpecDocuments(patterns) {
+    const documents = [];
+    for (const file of await expandFilePatterns(patterns)) {
+        documents.push(parseSpecDocument(await readFile(file, "utf8"), { filePath: file }));
+    }
+    return documents;
+}
+export function parseSpecTestReferences(source, filePath = "<inline>") {
+    const lines = source.split(/\r?\n/);
+    const modelRefs = Array.from(source.matchAll(modelIdPattern)).map((match) => ({
+        id: match[0],
+        filePath,
+        line: lineForOffset(lines, match.index ?? 0),
+        kind: "model",
+        source: "free-text",
+    }));
+    return dedupeTestReferences([
+        ...parseTestReferences(source, filePath),
+        ...modelRefs,
+    ]);
+}
+export async function collectSpecTestReferences(patterns) {
+    const refs = [];
+    for (const file of await expandFilePatterns(patterns)) {
+        refs.push(...parseSpecTestReferences(await readFile(file, "utf8"), file));
+    }
+    return refs;
+}
+export function validateModelSpec(spec) {
+    const issues = [];
+    validateCommonSpec(spec, issues);
+    if (!spec.modelItems.length) {
+        issues.push(issue(spec, "missing-model-items", "error", "Model spec must include at least one -M001 model item."));
+    }
+    for (const item of spec.modelItems) {
+        if (!item.id.startsWith(`${spec.frontmatter.id}-`)) {
+            issues.push(issue(spec, "wrong-model-prefix", "error", `Model item id "${item.id}" must start with ${spec.frontmatter.id}-.`, item.line));
+        }
+    }
+    return issues;
+}
+export function validateStackSpec(spec) {
+    const issues = [];
+    validateCommonSpec(spec, issues);
+    if (!spec.stack) {
+        issues.push(issue(spec, "missing-stack", "error", "Stack spec must include a non-empty ## Stack section."));
+    }
+    return issues;
+}
+export function validateDesignSpec(spec) {
+    const issues = [];
+    validateCommonSpec(spec, issues);
+    if (!spec.design) {
+        issues.push(issue(spec, "missing-design", "error", "Design spec must include a non-empty ## Design section."));
+    }
+    return issues;
+}
+export function validateSpecDocument(spec) {
+    if (spec.kind === "model")
+        return validateModelSpec(spec);
+    if (spec.kind === "stack")
+        return validateStackSpec(spec);
+    if (spec.kind === "design")
+        return validateDesignSpec(spec);
+    return validateFeatureSpec(spec);
+}
+export function validateSpecGraph(documents) {
+    const issues = [];
+    const modelIds = new Set(documents.filter(isModelSpec).map((model) => model.frontmatter.id));
+    const seen = new Map();
+    for (const doc of documents) {
+        for (const entry of documentIds(doc)) {
+            const first = seen.get(entry.id);
+            if (first) {
+                issues.push({
+                    code: "duplicate-id",
+                    severity: "error",
+                    message: `Duplicate id "${entry.id}".`,
+                    filePath: entry.filePath,
+                    line: entry.line,
+                });
+            }
+            seen.set(entry.id, entry);
+        }
+        if (isModelReferencingSpec(doc)) {
+            for (const modelId of referencedModelIds(doc)) {
+                if (!modelIds.has(modelId)) {
+                    issues.push({
+                        code: "unknown-model-reference",
+                        severity: "error",
+                        message: `Spec references unknown model "${modelId}".`,
+                        filePath: doc.filePath,
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}
+export function buildSpecCoverageSummary(documents, references) {
+    const baseCoverage = buildCoverageSummary(documents.filter(isFeatureSpec), references);
+    const modelRefs = references.filter((ref) => ref.kind === "model");
+    const ruleRefs = references.filter((ref) => ref.kind === "rule");
+    const rules = documents.flatMap((doc) => doc.rules.map((rule) => ({ doc, rule })));
+    const modelItems = documents.flatMap((doc) => doc.kind === "model"
+        ? doc.modelItems.map((modelItem) => ({ doc, modelItem }))
+        : []);
+    return {
+        ...baseCoverage,
+        ruleCoverage: rules.map(({ doc, rule }) => coverageItem(rule.id, rule.text, doc.filePath, rule.line, ruleRefs)),
+        orphanRuleReferences: ruleRefs.filter((ref) => !rules.some(({ rule }) => rule.id === ref.id)),
+        modelCoverage: modelItems.map(({ doc, modelItem }) => ({
+            id: modelItem.id,
+            title: modelItem.title,
+            filePath: doc.filePath,
+            line: modelItem.line,
+            references: modelRefs.filter((ref) => ref.id === modelItem.id),
+            covered: modelRefs.some((ref) => ref.id === modelItem.id),
+        })),
+        orphanModelReferences: modelRefs.filter((ref) => !modelItems.some(({ modelItem }) => modelItem.id === ref.id)),
+    };
+}
+function coverageItem(id, title, filePath, line, references) {
+    const matchingReferences = references.filter((ref) => ref.id === id);
+    return {
+        id,
+        title,
+        filePath,
+        line,
+        references: matchingReferences,
+        covered: matchingReferences.length > 0,
+    };
+}
+export async function checkSpecDocuments(options) {
+    const documents = await loadSpecDocuments(options.specs);
+    const references = options.tests?.length
+        ? await collectSpecTestReferences(options.tests)
+        : [];
+    const coverage = options.tests?.length
+        ? buildSpecCoverageSummary(documents, references)
+        : undefined;
+    const validationIssues = [
+        ...documents.flatMap(validateSpecDocument),
+        ...validateSpecGraph(documents),
+    ];
+    const coverageIssues = coverage
+        ? [
+            ...validateCoverage(coverage, options),
+            ...validateModelCoverage(coverage, options.requireModelCoverage),
+        ]
+        : [];
+    const models = documents.filter(isModelSpec);
+    const features = documents.filter(isFeatureSpec);
+    const stacks = documents.filter(isStackSpec);
+    const designs = documents.filter(isDesignSpec);
+    return {
+        documents,
+        models,
+        features,
+        stacks,
+        designs,
+        specs: features,
+        validationIssues,
+        coverage,
+        coverageIssues,
+        ok: ![...validationIssues, ...coverageIssues].some((issue) => issue.severity === "error"),
+    };
+}
+function validateModelCoverage(coverage, required = false) {
+    const issues = [];
+    if (required) {
+        for (const item of coverage.modelCoverage?.filter((item) => !item.covered) ?? []) {
+            issues.push({
+                code: "missing-model-coverage",
+                severity: "error",
+                message: `Model item "${item.id}" has no matching test reference.`,
+                filePath: item.filePath,
+                line: item.line,
+            });
+        }
+    }
+    for (const ref of coverage.orphanModelReferences ?? []) {
+        issues.push({
+            code: "orphan-model-reference",
+            severity: "error",
+            message: `Test references unknown model item "${ref.id}".`,
+            filePath: ref.filePath,
+            line: ref.line,
+        });
+    }
+    return issues;
+}
+function parseModelItems(lines, bodyStartLine) {
+    const bounds = sectionBounds(lines, "Model");
+    if (!bounds)
+        return [];
+    const items = [];
+    for (let i = bounds.start; i < bounds.end; i += 1) {
+        const match = lines[i].match(/^###\s+([A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-M\d{3}):\s+(.+)$/);
+        if (match) {
+            const bodyStart = i + 1;
+            let bodyEnd = bounds.end;
+            for (let j = bodyStart; j < bounds.end; j += 1) {
+                if (/^###\s+([A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-M\d{3}):\s+(.+)$/.test(lines[j])) {
+                    bodyEnd = j;
+                    break;
+                }
+            }
+            items.push({
+                id: match[1],
+                title: match[2].trim(),
+                body: trimBlankLines(lines.slice(bodyStart, bodyEnd)).join("\n"),
+                line: bodyStartLine + i,
+            });
+            i = bodyEnd - 1;
+        }
+    }
+    return items;
+}
+function validateCommonSpec(spec, issues) {
+    if (!spec.purpose) {
+        issues.push(issue(spec, "missing-purpose", "error", "Spec document must include a non-empty ## Purpose section."));
+    }
+}
+function issue(spec, code, severity, message, line) {
+    return { code, severity, message, filePath: spec.filePath, line };
+}
+function referencedModelIds(spec) {
+    const models = typeof spec.frontmatter.models === "string"
+        ? spec.frontmatter.models.split(",")
+        : (spec.frontmatter.models ?? []);
+    return [spec.frontmatter.model, ...models]
+        .map((model) => model?.trim())
+        .filter((model) => Boolean(model));
+}
+function kindFromPath(filePath) {
+    if (filePath.endsWith(".model.md"))
+        return "model";
+    if (filePath.endsWith(".stack.md"))
+        return "stack";
+    if (filePath.endsWith(".design.md"))
+        return "design";
+    return "feature";
+}
+function isModelSpec(doc) {
+    return doc.kind === "model";
+}
+function isFeatureSpec(doc) {
+    return doc.kind === "feature" || doc.kind === undefined;
+}
+function isStackSpec(doc) {
+    return doc.kind === "stack";
+}
+function isDesignSpec(doc) {
+    return doc.kind === "design";
+}
+function isModelReferencingSpec(doc) {
+    return isFeatureSpec(doc) || isDesignSpec(doc);
+}
+function documentIds(doc) {
+    return [
+        { id: doc.frontmatter.id, filePath: doc.filePath },
+        ...doc.rules.map((rule) => ({
+            id: rule.id,
+            filePath: doc.filePath,
+            line: rule.line,
+        })),
+        ...(doc.kind === "model"
+            ? doc.modelItems.map((item) => ({
+                id: item.id,
+                filePath: doc.filePath,
+                line: item.line,
+            }))
+            : isFeatureSpec(doc)
+                ? doc.scenarios.map((scenario) => ({
+                    id: scenario.id,
+                    filePath: doc.filePath,
+                    line: scenario.line,
+                }))
+                : []),
+    ];
+}
+//# sourceMappingURL=specDocuments.js.map

package/dist/specDocuments.js.map

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

package/dist/specMarkdown.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared Markdown parsing primitives for frontmatter, sections, rules, stable
+ * IDs, line numbers, and test-reference deduplication.
+ */
+import type { FeatureRule, TestReference } from "./types.js";
+export declare const modelIdPattern: RegExp;
+export declare const ruleIdPattern: RegExp;
+export declare const scenarioIdPattern: RegExp;
+export type ParsedMarkdownDocument = {
+    frontmatter: Record<string, string>;
+    lines: string[];
+    bodyStartLine: number;
+    title: string;
+    purpose: string;
+};
+export declare function parseMarkdownDocument(source: string, documentName?: string): ParsedMarkdownDocument;
+export declare function sectionBounds(lines: string[], heading: string): {
+    start: number;
+    end: number;
+} | null;
+export declare function sectionText(lines: string[], heading: string): string;
+export declare function parseRuleItems(lines: string[], bodyStartLine: number): FeatureRule[];
+export declare function trimBlankLines(lines: string[]): string[];
+export declare function lineForOffset(lines: string[], offset: number): number;
+export declare function dedupeTestReferences(refs: TestReference[]): TestReference[];
+//# sourceMappingURL=specMarkdown.d.ts.map

package/dist/specMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specMarkdown.d.ts","sourceRoot":"","sources":["../src/specMarkdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAe,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1E,eAAO,MAAM,cAAc,QAA8C,CAAC;AAC1E,eAAO,MAAM,aAAa,QAA8C,CAAC;AACzE,eAAO,MAAM,iBAAiB,QAA8C,CAAC;AAW7E,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,YAAY,SAAkB,GAC7B,sBAAsB,CAmCxB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM;;;SAW7D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,UAG3D;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,aAAa,EAAE,MAAM,GACpB,WAAW,EAAE,CAwBf;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,YAM7C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,UAO5D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,mBAQzD"}

package/dist/specMarkdown.js

@@ -0,0 +1,126 @@
+export const modelIdPattern = /\b[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-M\d{3}\b/g;
+export const ruleIdPattern = /\b[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-R\d{3}\b/g;
+export const scenarioIdPattern = /\b[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-S\d{3}\b/g;
+const ruleKeywords = [
+    "MUST NOT",
+    "SHOULD NOT",
+    "MUST",
+    "SHOULD",
+    "MAY",
+    "OPTIONAL",
+];
+export function parseMarkdownDocument(source, documentName = "Spec document") {
+    const normalized = source.replace(/\r\n/g, "\n");
+    if (!normalized.startsWith("---\n")) {
+        throw new Error(`${documentName} must start with frontmatter delimited by ---. `);
+    }
+    const endIndex = normalized.indexOf("\n---\n", 4);
+    if (endIndex === -1) {
+        throw new Error(`${documentName} frontmatter must end with a second --- delimiter.`);
+    }
+    const frontmatter = parseFrontmatter(normalized.slice(4, endIndex));
+    if (!frontmatter.id || !frontmatter.title) {
+        throw new Error(`${documentName} frontmatter must contain id and title.`);
+    }
+    const body = normalized.slice(endIndex + 5);
+    const lines = body.split("\n");
+    const bodyStartLine = normalized.slice(0, endIndex + 5).split("\n").length;
+    return {
+        frontmatter,
+        lines,
+        bodyStartLine,
+        title: lines
+            .find((line) => line.startsWith("# "))
+            ?.replace(/^#\s+/, "")
+            .trim() ?? frontmatter.title,
+        purpose: sectionText(lines, "Purpose").trim(),
+    };
+}
+export function sectionBounds(lines, heading) {
+    const start = lines.findIndex((line) => line.trim() === `## ${heading}`);
+    if (start === -1)
+        return null;
+    let end = lines.length;
+    for (let i = start + 1; i < lines.length; i += 1) {
+        if (/^##\s+/.test(lines[i])) {
+            end = i;
+            break;
+        }
+    }
+    return { start: start + 1, end };
+}
+export function sectionText(lines, heading) {
+    const bounds = sectionBounds(lines, heading);
+    return bounds ? lines.slice(bounds.start, bounds.end).join("\n") : "";
+}
+export function parseRuleItems(lines, bodyStartLine) {
+    const bounds = sectionBounds(lines, "Rules");
+    if (!bounds)
+        return [];
+    const rules = [];
+    for (let i = bounds.start; i < bounds.end; i += 1) {
+        const match = lines[i].match(/^\s*-\s+([A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-R\d{3}):\s+(.+)$/);
+        if (!match)
+            continue;
+        const keyword = ruleKeywords.find((kw) => match[2].toUpperCase().includes(kw));
+        rules.push({
+            id: match[1],
+            text: match[2].trim(),
+            keyword,
+            strength: ruleStrength(keyword),
+            line: bodyStartLine + i,
+        });
+    }
+    return rules;
+}
+export function trimBlankLines(lines) {
+    let start = 0;
+    let end = lines.length;
+    while (start < end && !lines[start].trim())
+        start += 1;
+    while (end > start && !lines[end - 1].trim())
+        end -= 1;
+    return lines.slice(start, end);
+}
+export function lineForOffset(lines, offset) {
+    let consumed = 0;
+    for (const [index, line] of lines.entries()) {
+        consumed += line.length + 1;
+        if (consumed > offset)
+            return index + 1;
+    }
+    return lines.length;
+}
+export function dedupeTestReferences(refs) {
+    const seen = new Set();
+    return refs.filter((ref) => {
+        const key = `${ref.kind}:${ref.id}:${ref.filePath}:${ref.line}:${ref.source}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+function parseFrontmatter(source) {
+    const data = {};
+    for (const line of source.split("\n")) {
+        const match = line.match(/^([A-Za-z][A-Za-z0-9_-]*):\s*(.*)$/);
+        if (match) {
+            data[match[1]] = match[2]
+                .replace(/^[']|[']$/g, "")
+                .replace(/^["]|["]$/g, "")
+                .trim();
+        }
+    }
+    return data;
+}
+function ruleStrength(keyword) {
+    if (keyword === "MUST" || keyword === "MUST NOT")
+        return "required";
+    if (keyword === "SHOULD" || keyword === "SHOULD NOT")
+        return "recommended";
+    if (keyword === "MAY" || keyword === "OPTIONAL")
+        return "optional";
+    return "unspecified";
+}
+//# sourceMappingURL=specMarkdown.js.map

package/dist/specMarkdown.js.map

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

package/dist/testImplementationReport.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Terminal report builder and formatter for summarizing which specs, model
+ * items, rules, and scenarios have executable test coverage.
+ */
+import type { CoverageItem, CoverageSummary, FeatureSpec, ModelSpec } from "./types.js";
+export type SpecImplementationStatus = "implemented" | "partial" | "missing";
+export type SpecImplementationItem = {
+    id: string;
+    title: string;
+    filePath: string;
+    totalScenarios: number;
+    coveredScenarios: number;
+    totalRules: number;
+    coveredRules: number;
+    missingScenarios: CoverageItem[];
+    coveredRuleItems: CoverageItem[];
+    missingRules: CoverageItem[];
+    status: SpecImplementationStatus;
+};
+export type ModelImplementationItem = {
+    id: string;
+    title: string;
+    filePath: string;
+    totalItems: number;
+    coveredItems: number;
+    totalRules: number;
+    coveredRules: number;
+    coveredModelItems: CoverageItem[];
+    missingModelItems: CoverageItem[];
+    coveredRuleItems: CoverageItem[];
+    missingRules: CoverageItem[];
+};
+export type SpecImplementationReport = {
+    models: ModelImplementationItem[];
+    specs: SpecImplementationItem[];
+    implemented: SpecImplementationItem[];
+    partial: SpecImplementationItem[];
+    missing: SpecImplementationItem[];
+    totalModels: number;
+    totalModelItems: number;
+    coveredModelItems: number;
+    missingModelItems: number;
+    totalSpecs: number;
+    totalScenarios: number;
+    coveredScenarios: number;
+    missingScenarios: number;
+    totalRules: number;
+    coveredRules: number;
+    missingRules: number;
+};
+export declare function buildSpecImplementationReport(specs: FeatureSpec[], coverage: CoverageSummary, models?: ModelSpec[]): SpecImplementationReport;
+export declare function formatSpecImplementationReport(report: SpecImplementationReport): string;
+//# sourceMappingURL=testImplementationReport.d.ts.map

package/dist/testImplementationReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testImplementationReport.d.ts","sourceRoot":"","sources":["../src/testImplementationReport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,wBAAwB,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,MAAM,EAAE,wBAAwB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,YAAY,EAAE,CAAC;IAClC,iBAAiB,EAAE,YAAY,EAAE,CAAC;IAClC,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAClC,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,WAAW,EAAE,sBAAsB,EAAE,CAAC;IACtC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,WAAW,EAAE,EACpB,QAAQ,EAAE,eAAe,EACzB,MAAM,GAAE,SAAS,EAAO,GACvB,wBAAwB,CA+H1B;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,wBAAwB,UAuBjC"}