specweave 0.23.18 → 0.24.0

package/dist/src/integrations/ado/area-path-mapper.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Azure DevOps Area Path Mapper
+ *
+ * Fetches, parses, and maps ADO area paths to SpecWeave project IDs.
+ * Supports hierarchical area paths with granularity selection:
+ * - Top-level only (e.g., Backend, Frontend)
+ * - Two-level (e.g., Backend-API, Backend-Database)
+ * - Full tree (all levels)
+ *
+ * NEW (v0.24.0): Enables multi-project organization in ADO
+ *
+ * @module integrations/ado/area-path-mapper
+ */
+import type { Logger } from '../../utils/logger.js';
+export interface AreaPathNode {
+    id: string;
+    name: string;
+    path: string;
+    level: number;
+    parentPath?: string;
+    children?: AreaPathNode[];
+    hasChildren: boolean;
+}
+export interface AdoCredentials {
+    organization: string;
+    pat: string;
+}
+export type AreaPathGranularity = 'top-level' | 'two-level' | 'full-tree';
+export interface AreaPathMapperOptions {
+    credentials: AdoCredentials;
+    project: string;
+    logger?: Logger;
+}
+/**
+ * Area Path Mapper for Azure DevOps
+ *
+ * Fetches hierarchical area path structures and maps them to SpecWeave project IDs.
+ */
+export declare class AreaPathMapper {
+    private credentials;
+    private project;
+    private logger;
+    private apiVersion;
+    constructor(options: AreaPathMapperOptions);
+    /**
+     * Fetch area path tree from ADO
+     *
+     * Fetches the full hierarchical area path structure for the project.
+     * Uses $depth=10 to get deep hierarchies.
+     *
+     * @returns Root area path node with children
+     */
+    fetchAreaPaths(): Promise<AreaPathNode>;
+    /**
+     * Parse area path tree recursively
+     *
+     * Converts ADO API response to normalized AreaPathNode tree structure.
+     *
+     * @param node - Raw ADO API node
+     * @param level - Current depth level (0 = root)
+     * @param parentPath - Parent area path
+     * @returns Parsed area path node
+     */
+    parseAreaPathTree(node: any, level: number, parentPath: string): AreaPathNode;
+    /**
+     * Map area path to SpecWeave project ID
+     *
+     * Converts hierarchical area path to kebab-case project ID.
+     * Excludes root project name.
+     *
+     * Examples:
+     * - "Platform/Backend/API" → "backend-api"
+     * - "Platform/Frontend" → "frontend"
+     * - "Platform" → "platform"
+     *
+     * @param areaPath - Full area path (e.g., "Platform/Backend/API")
+     * @returns Kebab-case project ID
+     */
+    mapToProjectId(areaPath: string): string;
+    /**
+     * Convert string to kebab-case
+     *
+     * @param str - Input string
+     * @returns Kebab-case string
+     */
+    private toKebabCase;
+    /**
+     * Flatten area paths with granularity selection
+     *
+     * Extracts nodes at specific level(s) from the tree.
+     *
+     * @param root - Root area path node
+     * @param granularity - Desired granularity level
+     * @returns Flattened array of nodes
+     */
+    flattenAreaPaths(root: AreaPathNode, granularity: AreaPathGranularity): AreaPathNode[];
+    /**
+     * Get nodes at specific level
+     *
+     * Recursively collects nodes at the target depth level.
+     * If a branch doesn't reach the target level, includes the deepest node in that branch.
+     *
+     * @param node - Current node
+     * @param targetLevel - Target depth level
+     * @returns Nodes at target level (or deepest available)
+     */
+    private getNodesByLevel;
+    /**
+     * Get all nodes (flatten entire tree)
+     *
+     * @param node - Root node
+     * @returns All nodes in tree
+     */
+    private getAllNodes;
+    /**
+     * Prompt user for granularity selection
+     *
+     * Interactive CLI prompt to select area path granularity.
+     *
+     * @param areaPathTree - Area path tree for preview
+     * @returns Selected granularity
+     */
+    promptAreaPathGranularity(areaPathTree: AreaPathNode): Promise<AreaPathGranularity>;
+    /**
+     * Get area path suggestions for project
+     *
+     * Analyzes area path tree and suggests best granularity based on structure.
+     *
+     * @param areaPathTree - Area path tree
+     * @returns Suggested granularity with reasoning
+     */
+    suggestGranularity(areaPathTree: AreaPathNode): {
+        suggested: AreaPathGranularity;
+        reasoning: string;
+    };
+}
+//# sourceMappingURL=area-path-mapper.d.ts.map

package/dist/src/integrations/ado/area-path-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-path-mapper.d.ts","sourceRoot":"","sources":["../../../../src/integrations/ado/area-path-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,qBAAqB;IAM1C;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;IA6B7C;;;;;;;;;OASG;IACH,iBAAiB,CACf,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,YAAY;IAsBf;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAaxC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;;;;;OAQG;IACH,gBAAgB,CACd,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,mBAAmB,GAC/B,YAAY,EAAE;IAgBjB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IA4BvB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAYnB;;;;;;;OAOG;IACG,yBAAyB,CAC7B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,mBAAmB,CAAC;IAkC/B;;;;;;;OAOG;IACH,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG;QAC9C,SAAS,EAAE,mBAAmB,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;KACnB;CAiCF"}

package/dist/src/integrations/ado/area-path-mapper.js

@@ -0,0 +1,267 @@
+/**
+ * Azure DevOps Area Path Mapper
+ *
+ * Fetches, parses, and maps ADO area paths to SpecWeave project IDs.
+ * Supports hierarchical area paths with granularity selection:
+ * - Top-level only (e.g., Backend, Frontend)
+ * - Two-level (e.g., Backend-API, Backend-Database)
+ * - Full tree (all levels)
+ *
+ * NEW (v0.24.0): Enables multi-project organization in ADO
+ *
+ * @module integrations/ado/area-path-mapper
+ */
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * Area Path Mapper for Azure DevOps
+ *
+ * Fetches hierarchical area path structures and maps them to SpecWeave project IDs.
+ */
+export class AreaPathMapper {
+    constructor(options) {
+        this.apiVersion = '7.0'; // ADO API version
+        this.credentials = options.credentials;
+        this.project = options.project;
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Fetch area path tree from ADO
+     *
+     * Fetches the full hierarchical area path structure for the project.
+     * Uses $depth=10 to get deep hierarchies.
+     *
+     * @returns Root area path node with children
+     */
+    async fetchAreaPaths() {
+        try {
+            const url = `https://dev.azure.com/${this.credentials.organization}/${this.project}/_apis/wit/classificationnodes/areas?$depth=10&api-version=${this.apiVersion}`;
+            const auth = Buffer.from(`:${this.credentials.pat}`).toString('base64');
+            const response = await fetch(url, {
+                headers: {
+                    'Authorization': `Basic ${auth}`,
+                    'Accept': 'application/json'
+                }
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`ADO API error (${response.status}): ${errorText}`);
+            }
+            const data = await response.json();
+            // Parse the tree structure
+            return this.parseAreaPathTree(data, 0, '');
+        }
+        catch (error) {
+            this.logger.error(`❌ Failed to fetch area paths: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Parse area path tree recursively
+     *
+     * Converts ADO API response to normalized AreaPathNode tree structure.
+     *
+     * @param node - Raw ADO API node
+     * @param level - Current depth level (0 = root)
+     * @param parentPath - Parent area path
+     * @returns Parsed area path node
+     */
+    parseAreaPathTree(node, level, parentPath) {
+        const path = parentPath ? `${parentPath}/${node.name}` : node.name;
+        const parsed = {
+            id: node.id?.toString() || '',
+            name: node.name,
+            path,
+            level,
+            parentPath: parentPath || undefined,
+            hasChildren: Boolean(node.hasChildren === true || (node.children && node.children.length > 0))
+        };
+        // Recursively parse children
+        if (node.children && Array.isArray(node.children) && node.children.length > 0) {
+            parsed.children = node.children.map((child) => this.parseAreaPathTree(child, level + 1, path));
+        }
+        return parsed;
+    }
+    /**
+     * Map area path to SpecWeave project ID
+     *
+     * Converts hierarchical area path to kebab-case project ID.
+     * Excludes root project name.
+     *
+     * Examples:
+     * - "Platform/Backend/API" → "backend-api"
+     * - "Platform/Frontend" → "frontend"
+     * - "Platform" → "platform"
+     *
+     * @param areaPath - Full area path (e.g., "Platform/Backend/API")
+     * @returns Kebab-case project ID
+     */
+    mapToProjectId(areaPath) {
+        const parts = areaPath.split('/').filter(Boolean);
+        // If root only, return root in kebab-case
+        if (parts.length === 1) {
+            return this.toKebabCase(parts[0]);
+        }
+        // Exclude root, join remaining parts with dash
+        const relevantParts = parts.slice(1);
+        return relevantParts.map(p => this.toKebabCase(p)).join('-');
+    }
+    /**
+     * Convert string to kebab-case
+     *
+     * @param str - Input string
+     * @returns Kebab-case string
+     */
+    toKebabCase(str) {
+        return str
+            .trim()
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-') // Replace non-alphanumeric with dash
+            .replace(/^-+|-+$/g, ''); // Trim leading/trailing dashes
+    }
+    /**
+     * Flatten area paths with granularity selection
+     *
+     * Extracts nodes at specific level(s) from the tree.
+     *
+     * @param root - Root area path node
+     * @param granularity - Desired granularity level
+     * @returns Flattened array of nodes
+     */
+    flattenAreaPaths(root, granularity) {
+        switch (granularity) {
+            case 'top-level':
+                return this.getNodesByLevel(root, 1);
+            case 'two-level':
+                return this.getNodesByLevel(root, 2);
+            case 'full-tree':
+                return this.getAllNodes(root);
+            default:
+                throw new Error(`Invalid granularity: ${granularity}`);
+        }
+    }
+    /**
+     * Get nodes at specific level
+     *
+     * Recursively collects nodes at the target depth level.
+     * If a branch doesn't reach the target level, includes the deepest node in that branch.
+     *
+     * @param node - Current node
+     * @param targetLevel - Target depth level
+     * @returns Nodes at target level (or deepest available)
+     */
+    getNodesByLevel(node, targetLevel) {
+        const results = [];
+        if (node.level === targetLevel) {
+            results.push(node);
+            return results;
+        }
+        // If node is at a level before target and has no children, include it
+        // (handles branches that don't reach target depth)
+        if (node.level < targetLevel && !node.children) {
+            results.push(node);
+            return results;
+        }
+        // Recurse into children
+        if (node.children) {
+            for (const child of node.children) {
+                results.push(...this.getNodesByLevel(child, targetLevel));
+            }
+        }
+        return results;
+    }
+    /**
+     * Get all nodes (flatten entire tree)
+     *
+     * @param node - Root node
+     * @returns All nodes in tree
+     */
+    getAllNodes(node) {
+        const results = [node];
+        if (node.children) {
+            for (const child of node.children) {
+                results.push(...this.getAllNodes(child));
+            }
+        }
+        return results;
+    }
+    /**
+     * Prompt user for granularity selection
+     *
+     * Interactive CLI prompt to select area path granularity.
+     *
+     * @param areaPathTree - Area path tree for preview
+     * @returns Selected granularity
+     */
+    async promptAreaPathGranularity(areaPathTree) {
+        const inquirer = (await import('inquirer')).default;
+        // Calculate counts for each granularity
+        const topLevelCount = this.getNodesByLevel(areaPathTree, 1).length;
+        const twoLevelCount = this.getNodesByLevel(areaPathTree, 2).length;
+        const fullTreeCount = this.getAllNodes(areaPathTree).length;
+        const { granularity } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'granularity',
+                message: 'Select area path granularity for project organization:',
+                choices: [
+                    {
+                        name: `Top-level only (${topLevelCount} projects) - e.g., Backend, Frontend`,
+                        value: 'top-level'
+                    },
+                    {
+                        name: `Two-level (${twoLevelCount} projects) - e.g., Backend-API, Backend-Database`,
+                        value: 'two-level'
+                    },
+                    {
+                        name: `Full tree (${fullTreeCount} projects) - All levels`,
+                        value: 'full-tree'
+                    }
+                ],
+                default: 'two-level' // Most common use case
+            }
+        ]);
+        return granularity;
+    }
+    /**
+     * Get area path suggestions for project
+     *
+     * Analyzes area path tree and suggests best granularity based on structure.
+     *
+     * @param areaPathTree - Area path tree
+     * @returns Suggested granularity with reasoning
+     */
+    suggestGranularity(areaPathTree) {
+        const topLevelCount = this.getNodesByLevel(areaPathTree, 1).length;
+        const twoLevelCount = this.getNodesByLevel(areaPathTree, 2).length;
+        const fullTreeCount = this.getAllNodes(areaPathTree).length;
+        // Decision logic
+        if (topLevelCount <= 5) {
+            // Small tree: use top-level
+            return {
+                suggested: 'top-level',
+                reasoning: `Small hierarchy (${topLevelCount} top-level areas). Top-level is sufficient.`
+            };
+        }
+        else if (twoLevelCount <= 20) {
+            // Medium tree: use two-level
+            return {
+                suggested: 'two-level',
+                reasoning: `Balanced hierarchy (${twoLevelCount} two-level areas). Recommended granularity.`
+            };
+        }
+        else {
+            // Large/deep tree: might need two-level or top-level
+            if (fullTreeCount > 50) {
+                return {
+                    suggested: 'top-level',
+                    reasoning: `Large hierarchy (${fullTreeCount} total areas). Top-level keeps projects manageable.`
+                };
+            }
+            return {
+                suggested: 'two-level',
+                reasoning: `Complex hierarchy (${twoLevelCount} two-level areas). Two-level balances detail and simplicity.`
+            };
+        }
+    }
+}
+//# sourceMappingURL=area-path-mapper.js.map

package/dist/src/integrations/ado/area-path-mapper.js.map

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

package/dist/src/integrations/jira/filter-processor.d.ts

@@ -0,0 +1,126 @@
+/**
+ * JIRA Filter Processor
+ *
+ * Smart filtering for JIRA projects with active/archived, type, lead, and JQL support.
+ *
+ * NEW (v0.24.0): Enables selective project imports with filter presets
+ *
+ * @module integrations/jira/filter-processor
+ */
+import { JiraClient } from './jira-client.js';
+import type { Logger } from '../../utils/logger.js';
+export interface FilterOptions {
+    active?: boolean;
+    types?: string[];
+    lead?: string;
+    jql?: string;
+    excludeArchived?: boolean;
+}
+export interface FilterPreset {
+    name: string;
+    description: string;
+    filters: FilterOptions;
+}
+export interface JiraProject {
+    id: string;
+    key: string;
+    name: string;
+    projectTypeKey?: string;
+    lead?: {
+        displayName: string;
+        emailAddress: string;
+    };
+    archived?: boolean;
+    [key: string]: any;
+}
+/**
+ * Filter processor for JIRA projects
+ */
+export declare class FilterProcessor {
+    private client;
+    private logger;
+    private presets;
+    constructor(client: JiraClient, options?: {
+        logger?: Logger;
+    });
+    /**
+     * Initialize default filter presets
+     */
+    private initializeDefaultPresets;
+    /**
+     * Add custom filter preset
+     */
+    addPreset(preset: FilterPreset): void;
+    /**
+     * Get filter preset by name
+     */
+    getPreset(name: string): FilterPreset | undefined;
+    /**
+     * List all available presets
+     */
+    listPresets(): FilterPreset[];
+    /**
+     * Apply filters to project list
+     *
+     * @param projects - List of JIRA projects
+     * @param options - Filter options
+     * @returns Filtered project list
+     */
+    applyFilters(projects: JiraProject[], options: FilterOptions): Promise<JiraProject[]>;
+    /**
+     * Filter active/archived projects
+     *
+     * @param projects - Project list
+     * @param activeOnly - If true, return only active projects
+     * @returns Filtered projects
+     */
+    filterActive(projects: JiraProject[], activeOnly?: boolean): JiraProject[];
+    /**
+     * Filter by project type
+     *
+     * @param projects - Project list
+     * @param types - Allowed types (e.g., 'software', 'business', 'service_desk')
+     * @returns Filtered projects
+     */
+    filterByType(projects: JiraProject[], types: string[]): JiraProject[];
+    /**
+     * Filter by project lead
+     *
+     * @param projects - Project list
+     * @param leadEmail - Lead email or display name
+     * @returns Filtered projects
+     */
+    filterByLead(projects: JiraProject[], leadEmail: string): JiraProject[];
+    /**
+     * Filter by custom JQL
+     *
+     * Uses JIRA Search API to execute JQL query
+     *
+     * @param projects - Original project list
+     * @param jql - JQL query string
+     * @returns Projects matching JQL
+     */
+    filterByJql(projects: JiraProject[], jql: string): Promise<JiraProject[]>;
+    /**
+     * Preview filter results
+     *
+     * @param projects - Project list
+     * @param options - Filter options
+     * @returns Preview summary
+     */
+    previewFilters(projects: JiraProject[], options: FilterOptions): Promise<{
+        original: number;
+        filtered: number;
+        reduction: number;
+        preview: string;
+    }>;
+    /**
+     * Load preset and apply filters
+     *
+     * @param projects - Project list
+     * @param presetName - Preset name
+     * @returns Filtered projects
+     */
+    applyPreset(projects: JiraProject[], presetName: string): Promise<JiraProject[]>;
+}
+//# sourceMappingURL=filter-processor.d.ts.map

package/dist/src/integrations/jira/filter-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-processor.d.ts","sourceRoot":"","sources":["../../../../src/integrations/jira/filter-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA4B;gBAE/B,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAOjE;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIrC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD;;OAEG;IACH,WAAW,IAAI,YAAY,EAAE;IAI7B;;;;;;OAMG;IACG,YAAY,CAChB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,WAAW,EAAE,CAAC;IAoCzB;;;;;;OAMG;IACH,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,UAAU,GAAE,OAAc,GAAG,WAAW,EAAE;IAOhF;;;;;;OAMG;IACH,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE;IASrE;;;;;;OAMG;IACH,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IAavE;;;;;;;;OAQG;IACG,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmB/E;;;;;;OAMG;IACG,cAAc,CAClB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAetF;;;;;;OAMG;IACG,WAAW,CACf,QAAQ,EAAE,WAAW,EAAE,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC;CAS1B"}