smart-spec-kit-mcp 2.0.0

package/dist/utils/markdownGenerator.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Markdown Generator
+ *
+ * Utilities for generating and filling Markdown templates with data
+ */
+/**
+ * Work item data from Azure DevOps
+ */
+export interface WorkItemData {
+    id: number | string;
+    title: string;
+    description?: string;
+    acceptanceCriteria?: string;
+    type?: string;
+    state?: string;
+    assignedTo?: string;
+    tags?: string[];
+    parentId?: number;
+    childIds?: number[];
+    links?: Array<{
+        rel: string;
+        url: string;
+    }>;
+    customFields?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Template fill options
+ */
+export interface FillOptions {
+    /** Keep [TO FILL] placeholders for sections without data */
+    keepPlaceholders?: boolean;
+    /** Add a marker when data is auto-filled vs placeholder */
+    markAutoFilled?: boolean;
+    /** Custom date format */
+    dateFormat?: string;
+}
+/**
+ * Fill a template with work item data
+ *
+ * @param template - The Markdown template string
+ * @param workItem - Data from Azure DevOps work item
+ * @param options - Fill options
+ * @returns Filled template string
+ */
+export declare function fillTemplate(template: string, workItem: WorkItemData, options?: Partial<FillOptions>): string;
+/**
+ * Extract all placeholders from a template
+ */
+export declare function extractPlaceholders(template: string): Array<{
+    type: string;
+    value: string;
+    description?: string;
+}>;
+/**
+ * Generate frontmatter YAML from work item data
+ */
+export declare function generateFrontmatter(workItem: WorkItemData): string;
+/**
+ * Create a specification document from template and work item
+ */
+export declare function createSpecification(template: string, workItem: WorkItemData, options?: Partial<FillOptions>): string;
+/**
+ * Summary of unfilled placeholders
+ */
+export declare function getUnfilledSummary(content: string): {
+    count: number;
+    items: string[];
+};
+//# sourceMappingURL=markdownGenerator.d.ts.map

package/dist/utils/markdownGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/markdownGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8ED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GACjC,MAAM,CAiCR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBlH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CA+BlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GACjC,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAUtF"}

package/dist/utils/markdownGenerator.js

@@ -0,0 +1,206 @@
+/**
+ * Markdown Generator
+ *
+ * Utilities for generating and filling Markdown templates with data
+ */
+/**
+ * Placeholder pattern for template variables
+ * Matches: [TO FILL], [TO FILL: description], {variable_name}
+ */
+const PLACEHOLDER_PATTERNS = {
+    toFill: /\[TO FILL(?::\s*([^\]]+))?\]/g,
+    variable: /\{(\w+)\}/g,
+};
+const DEFAULT_OPTIONS = {
+    keepPlaceholders: true,
+    markAutoFilled: false,
+    dateFormat: "YYYY-MM-DD",
+};
+/**
+ * Format a date according to the specified format
+ */
+function formatDate(date, format) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return format
+        .replace("YYYY", String(year))
+        .replace("MM", month)
+        .replace("DD", day);
+}
+/**
+ * Extract a safe string value from potentially complex data
+ */
+function safeString(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map(safeString).join(", ");
+    }
+    // For any other object type
+    return JSON.stringify(value);
+}
+/**
+ * Build a data map from work item for template filling
+ */
+function buildDataMap(workItem, options) {
+    const now = new Date();
+    const dateStr = formatDate(now, options.dateFormat ?? "YYYY-MM-DD");
+    return {
+        // Work item fields
+        workitem_id: safeString(workItem.id),
+        id: safeString(workItem.id),
+        title: safeString(workItem.title),
+        "Feature Title": safeString(workItem.title),
+        description: safeString(workItem.description),
+        acceptance_criteria: safeString(workItem.acceptanceCriteria),
+        type: safeString(workItem.type),
+        state: safeString(workItem.state),
+        assigned_to: safeString(workItem.assignedTo),
+        tags: safeString(workItem.tags),
+        // Metadata
+        Date: dateStr,
+        date: dateStr,
+        created: dateStr,
+        last_updated: dateStr,
+        // Azure DevOps link
+        azure_devops_link: workItem.id
+            ? `[ADO #${workItem.id}](https://dev.azure.com/_workitems/edit/${workItem.id})`
+            : "[TO FILL: Link to ADO Work Item]",
+        // Context
+        context_id: safeString(workItem.id),
+    };
+}
+/**
+ * Fill a template with work item data
+ *
+ * @param template - The Markdown template string
+ * @param workItem - Data from Azure DevOps work item
+ * @param options - Fill options
+ * @returns Filled template string
+ */
+export function fillTemplate(template, workItem, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const dataMap = buildDataMap(workItem, opts);
+    let result = template;
+    // Replace {variable} placeholders
+    result = result.replaceAll(PLACEHOLDER_PATTERNS.variable, (match, varName) => {
+        const value = dataMap[varName];
+        if (value !== undefined && value !== "") {
+            return opts.markAutoFilled ? `${value} <!--auto-filled-->` : value;
+        }
+        return opts.keepPlaceholders ? match : "";
+    });
+    // Replace [TO FILL: description] placeholders with matching data
+    result = result.replaceAll(PLACEHOLDER_PATTERNS.toFill, (match, description) => {
+        if (!description) {
+            return opts.keepPlaceholders ? match : "";
+        }
+        // Try to match description to data map keys
+        const normalizedDesc = description.toLowerCase().replaceAll(/\s+/g, "_");
+        const value = dataMap[normalizedDesc] ?? dataMap[description];
+        if (value !== undefined && value !== "") {
+            return opts.markAutoFilled ? `${value} <!--auto-filled-->` : value;
+        }
+        return opts.keepPlaceholders ? match : "";
+    });
+    return result;
+}
+/**
+ * Extract all placeholders from a template
+ */
+export function extractPlaceholders(template) {
+    const placeholders = [];
+    // Find [TO FILL] placeholders
+    let match;
+    const toFillRegex = new RegExp(PLACEHOLDER_PATTERNS.toFill.source, "g");
+    while ((match = toFillRegex.exec(template)) !== null) {
+        placeholders.push({
+            type: "toFill",
+            value: match[0],
+            description: match[1],
+        });
+    }
+    // Find {variable} placeholders
+    const varRegex = new RegExp(PLACEHOLDER_PATTERNS.variable.source, "g");
+    while ((match = varRegex.exec(template)) !== null) {
+        placeholders.push({
+            type: "variable",
+            value: match[0],
+            description: match[1],
+        });
+    }
+    return placeholders;
+}
+/**
+ * Generate frontmatter YAML from work item data
+ */
+export function generateFrontmatter(workItem) {
+    const now = new Date();
+    const dateStr = formatDate(now, "YYYY-MM-DD");
+    const frontmatter = {
+        title: workItem.title,
+        workitem_id: workItem.id,
+        type: workItem.type ?? "Specification",
+        version: "1.0",
+        status: "Draft",
+        author: workItem.assignedTo ?? "[TO FILL]",
+        created: dateStr,
+        last_updated: dateStr,
+        azure_devops_link: `https://dev.azure.com/_workitems/edit/${workItem.id}`,
+        tags: workItem.tags ?? [],
+    };
+    const lines = ["---"];
+    for (const [key, value] of Object.entries(frontmatter)) {
+        if (Array.isArray(value)) {
+            lines.push(`${key}:`);
+            for (const item of value) {
+                lines.push(`  - ${item}`);
+            }
+        }
+        else {
+            lines.push(`${key}: "${value}"`);
+        }
+    }
+    lines.push("---");
+    return lines.join("\n");
+}
+/**
+ * Create a specification document from template and work item
+ */
+export function createSpecification(template, workItem, options = {}) {
+    // Update frontmatter if present
+    const hasFrontmatter = template.startsWith("---");
+    if (hasFrontmatter) {
+        // Replace existing frontmatter
+        const endIndex = template.indexOf("---", 3);
+        if (endIndex !== -1) {
+            const newFrontmatter = generateFrontmatter(workItem);
+            const body = template.slice(endIndex + 3);
+            return newFrontmatter + fillTemplate(body, workItem, options);
+        }
+    }
+    // No frontmatter, just fill the template
+    return fillTemplate(template, workItem, options);
+}
+/**
+ * Summary of unfilled placeholders
+ */
+export function getUnfilledSummary(content) {
+    const placeholders = extractPlaceholders(content);
+    const toFillItems = placeholders
+        .filter((p) => p.type === "toFill")
+        .map((p) => p.description ?? "Unspecified");
+    return {
+        count: toFillItems.length,
+        items: [...new Set(toFillItems)], // Deduplicate
+    };
+}
+//# sourceMappingURL=markdownGenerator.js.map

package/dist/utils/markdownGenerator.js.map

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

package/dist/utils/vsCodeConfigGenerator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * VS Code Configuration Generator
+ *
+ * Generates the MCP server configuration for VS Code settings.json
+ */
+interface McpServerConfig {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+interface VsCodeMcpConfig {
+    "mcp": {
+        servers: Record<string, McpServerConfig>;
+    };
+}
+/**
+ * Generate the VS Code MCP configuration for Spec-Kit server
+ * @param projectPath - Absolute path to the spec-kit-mcp project
+ * @returns Configuration object for VS Code settings.json
+ */
+export declare function generateSpecKitConfig(projectPath: string): VsCodeMcpConfig;
+/**
+ * Generate configuration snippet as a formatted JSON string
+ * Ready to be merged into VS Code settings.json
+ */
+export declare function generateConfigSnippet(projectPath: string): string;
+/**
+ * Print configuration instructions to console
+ */
+export declare function printSetupInstructions(projectPath: string): void;
+export {};
+//# sourceMappingURL=vsCodeConfigGenerator.d.ts.map

package/dist/utils/vsCodeConfigGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsCodeConfigGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/vsCodeConfigGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,UAAU,eAAe;IACvB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAC1C,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAa1E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA+ChE"}

package/dist/utils/vsCodeConfigGenerator.js

@@ -0,0 +1,88 @@
+/**
+ * VS Code Configuration Generator
+ *
+ * Generates the MCP server configuration for VS Code settings.json
+ */
+import * as path from "node:path";
+/**
+ * Generate the VS Code MCP configuration for Spec-Kit server
+ * @param projectPath - Absolute path to the spec-kit-mcp project
+ * @returns Configuration object for VS Code settings.json
+ */
+export function generateSpecKitConfig(projectPath) {
+    const normalizedPath = path.resolve(projectPath);
+    return {
+        "mcp": {
+            servers: {
+                "spec-kit": {
+                    command: "node",
+                    args: [path.join(normalizedPath, "dist", "index.js")],
+                },
+            },
+        },
+    };
+}
+/**
+ * Generate configuration snippet as a formatted JSON string
+ * Ready to be merged into VS Code settings.json
+ */
+export function generateConfigSnippet(projectPath) {
+    const config = generateSpecKitConfig(projectPath);
+    return JSON.stringify(config, null, 2);
+}
+/**
+ * Print configuration instructions to console
+ */
+export function printSetupInstructions(projectPath) {
+    const normalizedPath = path.resolve(projectPath);
+    console.log(`
+╔══════════════════════════════════════════════════════════════════╗
+║           SPEC-KIT MCP SERVER - VS CODE CONFIGURATION            ║
+╚══════════════════════════════════════════════════════════════════╝
+
+Add the following to your VS Code settings.json (User or Workspace):
+
+─────────────────────────────────────────────────────────────────────
+{
+  "mcp": {
+    "servers": {
+      "spec-kit": {
+        "command": "node",
+        "args": ["${normalizedPath.replaceAll("\\", "\\\\")}\\\\dist\\\\index.js"]
+      }
+    }
+  }
+}
+─────────────────────────────────────────────────────────────────────
+
+📋 Quick Setup Steps:
+  1. Build the project:  npm run build
+  2. Open VS Code Settings (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)")
+  3. Add the "spec-kit" server config to your existing "mcp.servers" object
+  4. Reload VS Code window (Ctrl+Shift+P → "Developer: Reload Window")
+  5. Test in Copilot Chat: Ask to use the "ping" tool
+
+💡 If you already have Azure DevOps MCP configured, your final config should look like:
+
+{
+  "mcp": {
+    "servers": {
+      "azure-devops": {
+        // ... your existing Azure DevOps config ...
+      },
+      "spec-kit": {
+        "command": "node",
+        "args": ["${normalizedPath.replaceAll("\\", "\\\\")}\\\\dist\\\\index.js"]
+      }
+    }
+  }
+}
+
+`);
+}
+// CLI execution
+if (process.argv[1]?.includes("vsCodeConfigGenerator")) {
+    const projectPath = process.argv[2] || process.cwd();
+    printSetupInstructions(projectPath);
+}
+//# sourceMappingURL=vsCodeConfigGenerator.js.map

package/dist/utils/vsCodeConfigGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsCodeConfigGenerator.js","sourceRoot":"","sources":["../../src/utils/vsCodeConfigGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAclC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjD,OAAO;QACL,KAAK,EAAE;YACL,OAAO,EAAE;gBACP,UAAU,EAAE;oBACV,OAAO,EAAE,MAAM;oBACf,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;iBACtD;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,MAAM,MAAM,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;oBAaM,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;oBAwBvC,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;;;;;;CAM1D,CAAC,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;IACvD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACrD,sBAAsB,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC"}

package/dist/utils/workflowLoader.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Workflow Loader v2
+ *
+ * Loads workflows and templates with local override support.
+ *
+ * Resolution order:
+ * 1. Local project: .spec-kit/workflows/ and .spec-kit/templates/
+ * 2. Package defaults: /workflows and /templates
+ *
+ * This allows any project to customize workflows while using defaults.
+ */
+import { type Workflow } from "../schemas/workflowSchema.js";
+export type { Workflow } from "../schemas/workflowSchema.js";
+/**
+ * List all available workflows (local + package defaults)
+ */
+export declare function listWorkflows(): Promise<string[]>;
+/**
+ * List workflows with source information
+ */
+export declare function listWorkflowsDetailed(): Promise<{
+    name: string;
+    source: "local" | "package";
+    path: string;
+}[]>;
+/**
+ * Load and validate a workflow by name
+ */
+export declare function loadWorkflow(workflowName: string): Promise<Workflow>;
+/**
+ * Load a template file by name
+ */
+export declare function loadTemplate(templateName: string): Promise<string>;
+/**
+ * List all available templates (local + package defaults)
+ */
+export declare function listTemplates(): Promise<string[]>;
+/**
+ * Load a workflow with its associated template
+ */
+export declare function loadWorkflowWithTemplate(workflowName: string): Promise<{
+    workflow: Workflow;
+    template: string;
+}>;
+/**
+ * Get workflow step by ID
+ */
+export declare function getWorkflowStep(workflow: Workflow, stepId: string): {
+    id: string;
+    name: string;
+    action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent";
+    description: string;
+    agent?: string | undefined;
+    inputs?: Record<string, string> | undefined;
+    outputs?: string[] | undefined;
+    next?: string | undefined;
+} | undefined;
+/**
+ * Get the first step of a workflow
+ */
+export declare function getFirstStep(workflow: Workflow): {
+    id: string;
+    name: string;
+    action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent";
+    description: string;
+    agent?: string | undefined;
+    inputs?: Record<string, string> | undefined;
+    outputs?: string[] | undefined;
+    next?: string | undefined;
+} | undefined;
+/**
+ * Get the next step in a workflow
+ */
+export declare function getNextStep(workflow: Workflow, currentStepId: string): {
+    id: string;
+    name: string;
+    action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent";
+    description: string;
+    agent?: string | undefined;
+    inputs?: Record<string, string> | undefined;
+    outputs?: string[] | undefined;
+    next?: string | undefined;
+} | null | undefined;
+/**
+ * Initialize local spec-kit directory with example files
+ */
+export declare function initLocalConfig(): Promise<void>;
+/**
+ * Get configuration info for debugging
+ */
+export declare function getConfigInfo(): {
+    packageRoot: string;
+    projectRoot: string;
+    searchPaths: {
+        workflows: string[];
+        templates: string[];
+    };
+};
+//# sourceMappingURL=workflowLoader.d.ts.map

package/dist/utils/workflowLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowLoader.d.ts","sourceRoot":"","sources":["../../src/utils/workflowLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAG7E,YAAY,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAmH7D;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CACpD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAC9D,CAEA;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8B1E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAKnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;;;;;;;;;cAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ;;;;;;;;;cAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM;;;;;;;;;qBAepE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAiErD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC3D,CASA"}