specweave 0.18.0 → 0.20.0

package/dist/src/core/increment-utils.js

@@ -0,0 +1,210 @@
+/**
+ * Increment Number Management Utility
+ *
+ * Provides centralized utilities for managing increment numbers across
+ * all SpecWeave directories (main, _archive, _abandoned, _paused).
+ *
+ * Prevents increment number reuse when increments are moved to subdirectories.
+ *
+ * @module increment-utils
+ * @since 0.18.3
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Centralized manager for increment number generation and validation.
+ *
+ * Scans ALL increment directories to ensure sequential numbering and
+ * prevent duplicate increment IDs.
+ *
+ * @example
+ * ```typescript
+ * // Get next increment number
+ * const nextId = IncrementNumberManager.getNextIncrementNumber();
+ * console.log(nextId); // "0033"
+ *
+ * // Check if increment exists
+ * const exists = IncrementNumberManager.incrementNumberExists("0032");
+ * console.log(exists); // true
+ *
+ * // Clear cache (if needed)
+ * IncrementNumberManager.clearCache();
+ * ```
+ */
+export class IncrementNumberManager {
+    /**
+     * Get the next available increment number across all directories.
+     *
+     * Scans main directory and all subdirectories (_archive, _abandoned, _paused)
+     * to find the highest increment number and returns the next sequential number.
+     *
+     * @param projectRoot - Project root directory (defaults to process.cwd())
+     * @param useCache - Whether to use cached value (defaults to true)
+     * @returns Next increment number as 4-digit string (e.g., "0033")
+     *
+     * @example
+     * ```typescript
+     * const nextId = IncrementNumberManager.getNextIncrementNumber();
+     * // "0033"
+     *
+     * const nextIdNoCache = IncrementNumberManager.getNextIncrementNumber(undefined, false);
+     * // "0033" (fresh scan)
+     * ```
+     */
+    static getNextIncrementNumber(projectRoot = process.cwd(), useCache = true) {
+        const incrementsDir = path.join(projectRoot, '.specweave', 'increments');
+        const cacheKey = incrementsDir;
+        // Check cache if enabled
+        if (useCache) {
+            const cached = this.cache.get(cacheKey);
+            if (cached && Date.now() - cached.timestamp < this.CACHE_TTL) {
+                return String(cached.number).padStart(4, '0');
+            }
+        }
+        // Scan all directories
+        const highestNumber = this.scanAllIncrementDirectories(incrementsDir);
+        const nextNumber = highestNumber + 1;
+        // Update cache
+        this.cache.set(cacheKey, {
+            number: nextNumber,
+            timestamp: Date.now()
+        });
+        // Auto-expire cache after TTL
+        setTimeout(() => {
+            this.cache.delete(cacheKey);
+        }, this.CACHE_TTL);
+        return String(nextNumber).padStart(4, '0');
+    }
+    /**
+     * Check if an increment number already exists in any directory.
+     *
+     * Scans all directories to determine if the given increment number
+     * has already been used. Normalizes 3-digit IDs to 4-digit for comparison.
+     *
+     * @param incrementNumber - Increment number to check (string or number)
+     * @param projectRoot - Project root directory (defaults to process.cwd())
+     * @returns true if increment exists, false otherwise
+     *
+     * @example
+     * ```typescript
+     * IncrementNumberManager.incrementNumberExists("0032"); // true
+     * IncrementNumberManager.incrementNumberExists(32);     // true
+     * IncrementNumberManager.incrementNumberExists("9999"); // false
+     * ```
+     */
+    static incrementNumberExists(incrementNumber, projectRoot = process.cwd()) {
+        const incrementsDir = path.join(projectRoot, '.specweave', 'increments');
+        // Normalize to 4-digit string
+        const normalizedNumber = String(incrementNumber).padStart(4, '0');
+        // Directories to check
+        const dirsToCheck = [
+            incrementsDir,
+            path.join(incrementsDir, '_archive'),
+            path.join(incrementsDir, '_abandoned'),
+            path.join(incrementsDir, '_paused')
+        ];
+        // Check each directory
+        for (const dir of dirsToCheck) {
+            if (!fs.existsSync(dir))
+                continue;
+            try {
+                const entries = fs.readdirSync(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isDirectory())
+                        continue;
+                    // Match pattern: 0032-name or 032-name
+                    const match = entry.name.match(/^(\d{3,4})-/);
+                    if (match) {
+                        const entryNumber = match[1].padStart(4, '0');
+                        if (entryNumber === normalizedNumber) {
+                            return true;
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                // Permission denied or other error - continue
+                continue;
+            }
+        }
+        return false;
+    }
+    /**
+     * Clear the increment number cache.
+     *
+     * Forces next call to getNextIncrementNumber() to perform a fresh
+     * filesystem scan instead of using cached value.
+     *
+     * Useful for testing or when you know the filesystem has changed.
+     *
+     * @example
+     * ```typescript
+     * IncrementNumberManager.clearCache();
+     * const freshId = IncrementNumberManager.getNextIncrementNumber();
+     * ```
+     */
+    static clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Scan all increment directories and return highest number found.
+     *
+     * Scans these directories (in order):
+     * 1. .specweave/increments/ (main)
+     * 2. .specweave/increments/_archive/
+     * 3. .specweave/increments/_abandoned/
+     * 4. .specweave/increments/_paused/
+     *
+     * @param incrementsDir - Path to .specweave/increments directory
+     * @returns Highest increment number found (0 if none exist)
+     * @private
+     */
+    static scanAllIncrementDirectories(incrementsDir) {
+        let highestNumber = 0;
+        // Directories to scan
+        const dirsToScan = [
+            { path: incrementsDir, label: 'main' },
+            { path: path.join(incrementsDir, '_archive'), label: '_archive' },
+            { path: path.join(incrementsDir, '_abandoned'), label: '_abandoned' },
+            { path: path.join(incrementsDir, '_paused'), label: '_paused' }
+        ];
+        // Scan each directory
+        for (const { path: dirPath, label } of dirsToScan) {
+            if (!fs.existsSync(dirPath))
+                continue;
+            try {
+                const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isDirectory())
+                        continue;
+                    // Match pattern: 0032-name or 032-name
+                    const match = entry.name.match(/^(\d{3,4})-/);
+                    if (match) {
+                        const number = parseInt(match[1], 10);
+                        if (number > highestNumber) {
+                            highestNumber = number;
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                // Permission denied or other error - log warning and continue
+                console.warn(`Warning: Could not scan directory ${dirPath}:`, error.message);
+                continue;
+            }
+        }
+        return highestNumber;
+    }
+}
+/**
+ * In-memory cache for increment numbers (performance optimization)
+ * Key: incrementsDir path, Value: highest increment number
+ * @private
+ */
+IncrementNumberManager.cache = new Map();
+/**
+ * Cache time-to-live in milliseconds (5 seconds)
+ * @private
+ */
+IncrementNumberManager.CACHE_TTL = 5000;
+//# sourceMappingURL=increment-utils.js.map

package/dist/src/core/increment-utils.js.map

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

package/dist/src/core/living-docs/ac-project-specific-generator.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Acceptance Criteria Project-Specific Generator
+ *
+ * Intelligently rewrites acceptance criteria based on project context.
+ *
+ * Architecture:
+ * - Generic AC (config schema, validation) → Keep unchanged
+ * - Backend AC (API, database) → Rewrite with backend context
+ * - Frontend AC (UI, component) → Rewrite with frontend context
+ * - Mobile AC (screen, gesture) → Rewrite with mobile context
+ *
+ * Example:
+ * - Original: "UI displays status configuration form"
+ * - Backend: "Backend service: API returns status configuration data"
+ * - Frontend: "UI: Component displays status configuration form"
+ * - Mobile: "Mobile app: Screen displays status configuration form"
+ *
+ * Related:
+ * - .specweave/increments/0034-github-ac-checkboxes-fix/reports/ULTRATHINK-AC-PROJECT-SPECIFIC-DESIGN.md
+ * - src/core/living-docs/spec-distributor.ts (uses this)
+ */
+export interface ProjectContext {
+    id: string;
+    name: string;
+    type: 'backend' | 'frontend' | 'mobile' | 'infrastructure' | 'generic';
+    techStack: string[];
+    keywords: string[];
+}
+export interface AcceptanceCriterion {
+    id: string;
+    description: string;
+    priority?: string;
+    testable: boolean;
+    completed: boolean;
+    projectSpecific?: boolean;
+}
+export declare class ACProjectSpecificGenerator {
+    /**
+     * Make acceptance criteria project-specific
+     *
+     * Strategy:
+     * 1. Detect if AC is generic (applies to all projects)
+     * 2. Detect if AC needs project-specific variant
+     * 3. Rewrite AC description based on project context
+     * 4. Add project suffix to AC ID
+     */
+    makeProjectSpecific(ac: AcceptanceCriterion[], userStoryId: string, projectContext: ProjectContext): AcceptanceCriterion[];
+    /**
+     * Detect if AC is generic (applies to all projects without changes)
+     */
+    private isGenericAC;
+    /**
+     * Detect if AC needs project-specific variant
+     */
+    private needsProjectVariant;
+    /**
+     * Rewrite AC description for specific project
+     */
+    private rewriteACForProject;
+    /**
+     * Get project suffix for AC ID
+     */
+    private getProjectSuffix;
+}
+//# sourceMappingURL=ac-project-specific-generator.d.ts.map

package/dist/src/core/living-docs/ac-project-specific-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-project-specific-generator.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/ac-project-specific-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACvE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,0BAA0B;IACrC;;;;;;;;OAQG;IACH,mBAAmB,CACjB,EAAE,EAAE,mBAAmB,EAAE,EACzB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,GAC7B,mBAAmB,EAAE;IA8BxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+E3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAWzB"}

package/dist/src/core/living-docs/ac-project-specific-generator.js

@@ -0,0 +1,175 @@
+/**
+ * Acceptance Criteria Project-Specific Generator
+ *
+ * Intelligently rewrites acceptance criteria based on project context.
+ *
+ * Architecture:
+ * - Generic AC (config schema, validation) → Keep unchanged
+ * - Backend AC (API, database) → Rewrite with backend context
+ * - Frontend AC (UI, component) → Rewrite with frontend context
+ * - Mobile AC (screen, gesture) → Rewrite with mobile context
+ *
+ * Example:
+ * - Original: "UI displays status configuration form"
+ * - Backend: "Backend service: API returns status configuration data"
+ * - Frontend: "UI: Component displays status configuration form"
+ * - Mobile: "Mobile app: Screen displays status configuration form"
+ *
+ * Related:
+ * - .specweave/increments/0034-github-ac-checkboxes-fix/reports/ULTRATHINK-AC-PROJECT-SPECIFIC-DESIGN.md
+ * - src/core/living-docs/spec-distributor.ts (uses this)
+ */
+export class ACProjectSpecificGenerator {
+    /**
+     * Make acceptance criteria project-specific
+     *
+     * Strategy:
+     * 1. Detect if AC is generic (applies to all projects)
+     * 2. Detect if AC needs project-specific variant
+     * 3. Rewrite AC description based on project context
+     * 4. Add project suffix to AC ID
+     */
+    makeProjectSpecific(ac, userStoryId, projectContext) {
+        return ac.map((criterion) => {
+            // Step 1: Detect if AC is generic
+            if (this.isGenericAC(criterion.description)) {
+                return criterion; // Keep as-is
+            }
+            // Step 2: Detect if AC needs project-specific variant
+            const needsProjectVariant = this.needsProjectVariant(criterion.description, projectContext);
+            if (!needsProjectVariant) {
+                return criterion; // Keep as-is
+            }
+            // Step 3: Rewrite AC for this project
+            const projectSpecificDesc = this.rewriteACForProject(criterion.description, projectContext);
+            // Step 4: Add project suffix to ID
+            const projectSuffix = this.getProjectSuffix(projectContext);
+            const projectSpecificId = `${criterion.id}-${projectSuffix}`;
+            return {
+                ...criterion,
+                id: projectSpecificId,
+                description: projectSpecificDesc,
+                projectSpecific: true,
+            };
+        });
+    }
+    /**
+     * Detect if AC is generic (applies to all projects without changes)
+     */
+    isGenericAC(description) {
+        const genericIndicators = [
+            /config\s+schema/i,
+            /default\s+(mappings|settings|configuration)/i,
+            /validation\s+prevents/i,
+            /error\s+handling/i,
+            /documentation\s+includes/i,
+            /logging/i,
+            /\btest\b.*\bcoverage\b/i, // "test coverage"
+            /\bunit\s+test/i,
+            /\bintegration\s+test/i,
+        ];
+        return genericIndicators.some((pattern) => pattern.test(description));
+    }
+    /**
+     * Detect if AC needs project-specific variant
+     */
+    needsProjectVariant(description, projectContext) {
+        // Backend-specific indicators
+        if (projectContext.type === 'backend') {
+            return /API|endpoint|database|service|server|request|response/i.test(description);
+        }
+        // Frontend-specific indicators
+        if (projectContext.type === 'frontend') {
+            return /UI|component|screen|form|display|render|button|click|input/i.test(description);
+        }
+        // Mobile-specific indicators
+        if (projectContext.type === 'mobile') {
+            return /screen|navigation|gesture|native|platform|tap|swipe/i.test(description);
+        }
+        // Infrastructure-specific indicators
+        if (projectContext.type === 'infrastructure') {
+            return /deployment|CI\/CD|pipeline|monitoring|scaling|cluster|container/i.test(description);
+        }
+        return false;
+    }
+    /**
+     * Rewrite AC description for specific project
+     */
+    rewriteACForProject(description, projectContext) {
+        let rewritten = description;
+        // Backend-specific rewrites
+        if (projectContext.type === 'backend') {
+            rewritten = rewritten
+                .replace(/UI\s+(displays|shows)/gi, 'API returns')
+                .replace(/form\s+validation/gi, 'request payload validation')
+                .replace(/\bscreen\b/gi, 'endpoint')
+                .replace(/button\s+click/gi, 'API call')
+                .replace(/user\s+sees/gi, 'API response includes')
+                .replace(/component/gi, 'service')
+                .replace(/\brender\b/gi, 'serialize');
+            // Add backend context prefix if not already present
+            if (!rewritten.includes('Backend') &&
+                !rewritten.includes('API') &&
+                !rewritten.includes('service')) {
+                rewritten = `Backend service: ${rewritten}`;
+            }
+        }
+        // Frontend-specific rewrites
+        if (projectContext.type === 'frontend') {
+            rewritten = rewritten
+                .replace(/API\s+endpoint/gi, 'UI component')
+                .replace(/database\s+schema/gi, 'state management')
+                .replace(/server\s+validates/gi, 'client-side validation')
+                .replace(/returns\s+response/gi, 'displays result')
+                .replace(/service/gi, 'component')
+                .replace(/\bserialize\b/gi, 'render');
+            // Add frontend context prefix if not already present
+            if (!rewritten.includes('UI') &&
+                !rewritten.includes('component') &&
+                !rewritten.includes('Frontend')) {
+                rewritten = `UI: ${rewritten}`;
+            }
+        }
+        // Mobile-specific rewrites
+        if (projectContext.type === 'mobile') {
+            rewritten = rewritten
+                .replace(/\bpage\b/gi, 'screen')
+                .replace(/\bclick\b/gi, 'tap')
+                .replace(/\bhover\b/gi, 'long press')
+                .replace(/component/gi, 'view')
+                .replace(/web/gi, 'mobile');
+            // Add mobile context prefix if not already present
+            if (!rewritten.includes('Mobile') && !rewritten.includes('screen')) {
+                rewritten = `Mobile app: ${rewritten}`;
+            }
+        }
+        // Infrastructure-specific rewrites
+        if (projectContext.type === 'infrastructure') {
+            rewritten = rewritten
+                .replace(/\bcode\b/gi, 'infrastructure code')
+                .replace(/application/gi, 'deployment')
+                .replace(/feature/gi, 'infrastructure change');
+            // Add infrastructure context if not present
+            if (!rewritten.includes('Infrastructure') &&
+                !rewritten.includes('deployment') &&
+                !rewritten.includes('pipeline')) {
+                rewritten = `Infrastructure: ${rewritten}`;
+            }
+        }
+        return rewritten;
+    }
+    /**
+     * Get project suffix for AC ID
+     */
+    getProjectSuffix(projectContext) {
+        const suffixMap = {
+            backend: 'BE',
+            frontend: 'FE',
+            mobile: 'MOB',
+            infrastructure: 'INFRA',
+            generic: 'GEN',
+        };
+        return suffixMap[projectContext.type] || projectContext.id.slice(0, 3).toUpperCase();
+    }
+}
+//# sourceMappingURL=ac-project-specific-generator.js.map

package/dist/src/core/living-docs/ac-project-specific-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-project-specific-generator.js","sourceRoot":"","sources":["../../../../src/core/living-docs/ac-project-specific-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/core/living-docs/feature-archiver.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Feature & Epic Archiver - Smart archiving system for features and epics
+ *
+ * Works in tandem with IncrementArchiver to maintain consistency between
+ * increments, features, and epics. When an increment is archived, its
+ * associated feature is automatically archived if all increments for
+ * that feature are archived.
+ */
+interface LinkUpdate {
+    file: string;
+    oldLink: string;
+    newLink: string;
+    lineNumber: number;
+}
+export interface FeatureArchiveOptions {
+    dryRun?: boolean;
+    updateLinks?: boolean;
+    preserveActiveFeatures?: boolean;
+    archiveOrphanedFeatures?: boolean;
+    archiveOrphanedEpics?: boolean;
+}
+export interface FeatureArchiveResult {
+    archivedFeatures: string[];
+    archivedEpics: string[];
+    updatedLinks: LinkUpdate[];
+    errors: string[];
+}
+export declare class FeatureArchiver {
+    private rootDir;
+    private specsDir;
+    private featuresDir;
+    private epicsDir;
+    private incrementArchiver;
+    private hierarchyMapper;
+    private featureIdManager;
+    constructor(rootDir: string);
+    /**
+     * Archive features and epics based on increment archive status
+     */
+    archiveFeatures(options?: FeatureArchiveOptions): Promise<FeatureArchiveResult>;
+    /**
+     * Identify features that should be archived
+     */
+    private identifyFeaturesToArchive;
+    /**
+     * Identify epics that should be archived
+     */
+    private identifyEpicsToArchive;
+    /**
+     * Execute an archive operation
+     */
+    private executeArchiveOperation;
+    /**
+     * Archive project-specific folders for a feature
+     */
+    private archiveProjectSpecificFolders;
+    /**
+     * Update all links to archived items
+     */
+    private updateAllLinks;
+    /**
+     * Update links in a single file
+     */
+    private updateLinksInFile;
+    /**
+     * Get all features
+     */
+    private getAllFeatures;
+    /**
+     * Get all epics
+     */
+    private getAllEpics;
+    /**
+     * Get increments linked to a feature
+     */
+    private getLinkedIncrements;
+    /**
+     * Get features linked to an epic
+     */
+    private getLinkedFeatures;
+    /**
+     * Check if all features are archived
+     */
+    private areAllFeaturesArchived;
+    /**
+     * Check if feature has active projects
+     */
+    private hasActiveProjects;
+    /**
+     * Ensure archive directories exist
+     */
+    private ensureArchiveDirectories;
+    /**
+     * Restore an epic from archive
+     */
+    restoreEpic(epicId: string): Promise<void>;
+    /**
+     * Update links for restored epic
+     */
+    private updateLinksForRestoredEpic;
+    /**
+     * Restore a feature from archive
+     */
+    restoreFeature(featureId: string): Promise<void>;
+    /**
+     * Update links for restored feature
+     */
+    private updateLinksForRestoredFeature;
+    /**
+     * Get archive statistics
+     */
+    getArchiveStats(): Promise<{
+        features: {
+            active: number;
+            archived: number;
+        };
+        epics: {
+            active: number;
+            archived: number;
+        };
+        projects: {
+            [key: string]: {
+                active: number;
+                archived: number;
+            };
+        };
+    }>;
+}
+export {};
+//# sourceMappingURL=feature-archiver.d.ts.map

package/dist/src/core/living-docs/feature-archiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-archiver.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/feature-archiver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,OAAO,EAAE,MAAM;IAU3B;;OAEG;IACG,eAAe,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0CzF;;OAEG;YACW,yBAAyB;IAkDvC;;OAEG;YACW,sBAAsB;IA4CpC;;OAEG;YACW,uBAAuB;IAsCrC;;OAEG;YACW,6BAA6B;IAkB3C;;OAEG;YACW,cAAc;IAwB5B;;OAEG;YACW,iBAAiB;IAwE/B;;OAEG;YACW,cAAc;IAmB5B;;OAEG;YACW,WAAW;IAmBzB;;OAEG;YACW,mBAAmB;IA8BjC;;OAEG;YACW,iBAAiB;IA+B/B;;OAEG;YACW,sBAAsB;IAkBpC;;OAEG;YACW,iBAAiB;IAwB/B;;OAEG;YACW,wBAAwB;IAiBtC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhD;;OAEG;YACW,0BAA0B;IAyBxC;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCtD;;OAEG;YACW,6BAA6B;IA4B3C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAC/B,QAAQ,EAAE;YACR,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,KAAK,EAAE;YACL,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,QAAQ,EAAE;YACR,CAAC,GAAG,EAAE,MAAM,GAAG;gBACb,MAAM,EAAE,MAAM,CAAC;gBACf,QAAQ,EAAE,MAAM,CAAC;aAClB,CAAC;SACH,CAAC;KACH,CAAC;CA6CH"}