specweave 1.0.459 → 1.0.461

package/plugins/specweave/lib/vendor/sync/config.js

@@ -0,0 +1,132 @@
+/**
+ * Sync Config — Permission Presets & Config Validation
+ *
+ * ADR-0236: Named presets replace 8+ booleans.
+ * 4 presets: read-only, push-only, bidirectional, full-control
+ * With optional per-flag overrides.
+ */
+// ---------------------------------------------------------------------------
+// Preset defaults
+// ---------------------------------------------------------------------------
+export const PRESET_DEFAULTS = {
+    'read-only': {
+        canRead: true,
+        canUpdateStatus: false,
+        canUpsert: false,
+        canDelete: false,
+    },
+    'push-only': {
+        canRead: false,
+        canUpdateStatus: true,
+        canUpsert: true,
+        canDelete: false,
+    },
+    bidirectional: {
+        canRead: true,
+        canUpdateStatus: true,
+        canUpsert: true,
+        canDelete: false,
+    },
+    'full-control': {
+        canRead: true,
+        canUpdateStatus: true,
+        canUpsert: true,
+        canDelete: true,
+    },
+};
+// ---------------------------------------------------------------------------
+// Permission resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve effective permissions from preset + overrides + legacy settings.
+ *
+ * Priority: preset → overrides → effective
+ * If no preset, falls back to legacy boolean settings.
+ */
+export function resolvePermissions(preset, overrides, legacySettings) {
+    let base;
+    if (preset && PRESET_DEFAULTS[preset]) {
+        base = { ...PRESET_DEFAULTS[preset] };
+    }
+    else if (legacySettings) {
+        // Backward compat: map old booleans to new permissions
+        base = {
+            canRead: legacySettings.canUpdateExternalItems ?? true,
+            canUpdateStatus: legacySettings.canUpdateStatus ?? true,
+            canUpsert: legacySettings.canUpsertInternalItems ?? true,
+            canDelete: false, // legacy system had no delete
+        };
+    }
+    else {
+        // Default to read-only
+        base = { ...PRESET_DEFAULTS['read-only'] };
+    }
+    if (overrides) {
+        if (overrides.canRead !== undefined)
+            base.canRead = overrides.canRead;
+        if (overrides.canUpdateStatus !== undefined)
+            base.canUpdateStatus = overrides.canUpdateStatus;
+        if (overrides.canUpsert !== undefined)
+            base.canUpsert = overrides.canUpsert;
+        if (overrides.canDelete !== undefined)
+            base.canDelete = overrides.canDelete;
+    }
+    return base;
+}
+/**
+ * Validate sync configuration for consistency and report issues.
+ */
+export function validateSyncConfigConsistency(config, syncMetadata) {
+    const issues = [];
+    // Check: enabled=false with write flags=true
+    if (config.enabled === false && config.settings) {
+        const { canUpsertInternalItems, canUpdateExternalItems, canUpdateStatus } = config.settings;
+        if (canUpsertInternalItems || canUpdateExternalItems || canUpdateStatus) {
+            issues.push({
+                type: 'contradiction',
+                message: 'Sync is disabled but write permissions are enabled. The effective behavior is disabled (sync.enabled=false overrides all).',
+                suggestedFix: 'Either set sync.enabled=true to use the permissions, or set all permission flags to false.',
+            });
+        }
+    }
+    // Check: provider enabled but incomplete config (legacy format only)
+    // Skip these checks when the provider is configured via profiles instead
+    if (config.enabled !== false) {
+        const profileProviders = new Set(Object.values(config.profiles ?? {}).map((p) => p.provider).filter(Boolean));
+        if (config.github?.enabled && !config.github.owner && !config.github.repo && !profileProviders.has('github')) {
+            issues.push({
+                type: 'warning',
+                message: 'GitHub sync enabled but github.owner and github.repo are not configured.',
+                suggestedFix: 'Set sync.github.owner and sync.github.repo in config.json, or run /sw:sync-setup.',
+            });
+        }
+        if (config.jira?.enabled && !config.jira.domain && !profileProviders.has('jira')) {
+            issues.push({
+                type: 'warning',
+                message: 'JIRA sync enabled but jira.domain is not configured.',
+                suggestedFix: 'Set sync.jira.domain and sync.jira.projectKey in config.json.',
+            });
+        }
+        if (config.ado?.enabled && !config.ado.organization && !profileProviders.has('ado')) {
+            issues.push({
+                type: 'warning',
+                message: 'ADO sync enabled but ado.organization is not configured.',
+                suggestedFix: 'Set sync.ado.organization and sync.ado.project in config.json.',
+            });
+        }
+    }
+    // Check sync metadata for failures
+    if (syncMetadata) {
+        for (const [platform, meta] of Object.entries(syncMetadata)) {
+            if (meta.lastSyncResult === 'failed') {
+                issues.push({
+                    type: 'failure',
+                    message: `${platform} sync last result was "failed" with ${meta.lastImportCount ?? 0} imports.`,
+                    suggestedFix: `Check ${platform} credentials and configuration. Run /sw:sync-setup to reconfigure.`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=config.js.map

package/plugins/specweave/lib/vendor/sync/config.js.map

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

package/plugins/specweave/lib/vendor/sync/provider-router.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Provider Router Service
+ *
+ * Routes sync operations to the correct external provider (GitHub, JIRA, ADO).
+ * Extracted from sync-coordinator.ts for better separation of concerns.
+ *
+ * @module sync/provider-router
+ * @since v1.0.115
+ */
+import { Logger } from '../utils/logger.js';
+import { StatusMapper, SyncProvider } from './status-mapper.js';
+import type { SpecWeaveConfig } from '../core/config/types.js';
+/**
+ * GitHub repository configuration
+ */
+export interface GitHubRepoConfig {
+    enabled?: boolean;
+    owner?: string;
+    repo?: string;
+}
+/**
+ * Repository information
+ */
+export interface RepoInfo {
+    owner: string;
+    repo: string;
+}
+/**
+ * Provider router options
+ */
+export interface ProviderRouterOptions {
+    projectRoot: string;
+    logger?: Logger;
+}
+/**
+ * Provider Router - Routes sync operations to the correct external provider
+ */
+export declare class ProviderRouter {
+    private projectRoot;
+    private logger;
+    constructor(options: ProviderRouterOptions);
+    /**
+     * Detect GitHub repository from config or git remote
+     *
+     * @param githubConfig - Optional GitHub config from config.json
+     * @returns Repository info or null if not detected
+     */
+    detectGitHubRepo(githubConfig?: GitHubRepoConfig): Promise<RepoInfo | null>;
+    /**
+     * Get the external provider for a user story
+     *
+     * Determines which external provider to use based on the user story's
+     * external_source field.
+     *
+     * @param externalSource - The external source from user story (github, jira, ado, azure-devops)
+     * @returns Normalized provider name
+     */
+    normalizeProvider(externalSource: string | undefined): SyncProvider | null;
+    /**
+     * Check which providers are available for sync
+     *
+     * @param config - Project configuration
+     * @returns Object with provider availability
+     */
+    getAvailableProviders(config: SpecWeaveConfig): Record<SyncProvider, boolean>;
+    /**
+     * Load project configuration
+     *
+     * @returns Project configuration or empty object
+     */
+    loadConfig(): Promise<SpecWeaveConfig>;
+    /**
+     * Get status mapper instance for the current config
+     *
+     * @param config - Project configuration
+     * @returns StatusMapper instance
+     */
+    getStatusMapper(config: SpecWeaveConfig): StatusMapper;
+    /**
+     * Log provider availability for debugging
+     *
+     * @param config - Project configuration
+     */
+    logProviderStatus(config: SpecWeaveConfig): void;
+}
+//# sourceMappingURL=provider-router.d.ts.map

package/plugins/specweave/lib/vendor/sync/provider-router.js

@@ -0,0 +1,147 @@
+/**
+ * Provider Router Service
+ *
+ * Routes sync operations to the correct external provider (GitHub, JIRA, ADO).
+ * Extracted from sync-coordinator.ts for better separation of concerns.
+ *
+ * @module sync/provider-router
+ * @since v1.0.115
+ */
+import { promises as fs, existsSync } from 'fs';
+import path from 'path';
+import { consoleLogger } from '../utils/logger.js';
+import { StatusMapper, isProviderEnabled } from './status-mapper.js';
+/**
+ * Provider Router - Routes sync operations to the correct external provider
+ */
+export class ProviderRouter {
+    constructor(options) {
+        this.projectRoot = options.projectRoot;
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Detect GitHub repository from config or git remote
+     *
+     * @param githubConfig - Optional GitHub config from config.json
+     * @returns Repository info or null if not detected
+     */
+    async detectGitHubRepo(githubConfig = {}) {
+        // Check config first
+        if (githubConfig.owner && githubConfig.repo) {
+            return { owner: githubConfig.owner, repo: githubConfig.repo };
+        }
+        // Try to detect from git remote
+        try {
+            const { execSync } = await import('child_process');
+            const remote = execSync('git remote get-url origin', {
+                cwd: this.projectRoot,
+                encoding: 'utf-8',
+                stdio: 'pipe'
+            }).trim();
+            // Parse GitHub URL: git@github.com:owner/repo.git or https://github.com/owner/repo.git
+            const match = remote.match(/github\.com[:/]([^/]+)\/([^.]+)/);
+            if (match) {
+                return { owner: match[1], repo: match[2].replace('.git', '') };
+            }
+        }
+        catch {
+            // Ignore git errors
+        }
+        return null;
+    }
+    /**
+     * Get the external provider for a user story
+     *
+     * Determines which external provider to use based on the user story's
+     * external_source field.
+     *
+     * @param externalSource - The external source from user story (github, jira, ado, azure-devops)
+     * @returns Normalized provider name
+     */
+    normalizeProvider(externalSource) {
+        if (!externalSource) {
+            return 'github'; // Default to GitHub
+        }
+        const source = externalSource.toLowerCase();
+        if (source === 'github') {
+            return 'github';
+        }
+        if (source === 'jira') {
+            return 'jira';
+        }
+        if (source === 'ado' || source === 'azure-devops' || source === 'azuredevops') {
+            return 'ado';
+        }
+        return null;
+    }
+    /**
+     * Check which providers are available for sync
+     *
+     * @param config - Project configuration
+     * @returns Object with provider availability
+     */
+    getAvailableProviders(config) {
+        return {
+            github: isProviderEnabled(config, 'github'),
+            jira: isProviderEnabled(config, 'jira'),
+            ado: isProviderEnabled(config, 'ado')
+        };
+    }
+    /**
+     * Load project configuration
+     *
+     * @returns Project configuration or empty object
+     */
+    async loadConfig() {
+        const configPath = path.join(this.projectRoot, '.specweave/config.json');
+        if (!existsSync(configPath)) {
+            return {};
+        }
+        const content = await fs.readFile(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    /**
+     * Get status mapper instance for the current config
+     *
+     * @param config - Project configuration
+     * @returns StatusMapper instance
+     */
+    getStatusMapper(config) {
+        return new StatusMapper(config);
+    }
+    /**
+     * Log provider availability for debugging
+     *
+     * @param config - Project configuration
+     */
+    logProviderStatus(config) {
+        const providers = this.getAvailableProviders(config);
+        const statusMapper = this.getStatusMapper(config);
+        this.logger.log('📊 Provider Status:');
+        if (providers.github) {
+            this.logger.log('  ✅ GitHub: enabled');
+        }
+        else {
+            this.logger.log('  ⬜ GitHub: disabled');
+        }
+        if (providers.jira) {
+            this.logger.log(`  ✅ JIRA: enabled (completion status: ${statusMapper.getJiraCompletedStatus()})`);
+        }
+        else {
+            this.logger.log('  ⬜ JIRA: disabled');
+        }
+        if (providers.ado) {
+            this.logger.log(`  ✅ ADO: enabled (completion state: ${statusMapper.getAdoCompletedState()})`);
+        }
+        else {
+            this.logger.log('  ⬜ ADO: disabled');
+        }
+        this.logger.log('');
+        this.logger.log('📋 Sync Settings:');
+        this.logger.log(`  canUpdateExternalItems: ${statusMapper.canUpdateExternal()}`);
+        this.logger.log(`  canUpdateStatus: ${statusMapper.canUpdateStatus()}`);
+        this.logger.log(`  autoSyncOnCompletion: ${statusMapper.isAutoSyncEnabled()}`);
+        this.logger.log(`  canUpsertInternalItems: ${statusMapper.canUpsertInternal()}`);
+    }
+}
+//# sourceMappingURL=provider-router.js.map

package/plugins/specweave/lib/vendor/sync/provider-router.js.map

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

package/plugins/specweave/lib/vendor/sync/status-mapper.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Status Mapper Service
+ *
+ * Handles status mapping between SpecWeave increment statuses and external tool statuses.
+ * Extracted from sync-coordinator.ts for better separation of concerns.
+ *
+ * @module sync/status-mapper
+ * @since v1.0.115
+ */
+import type { SpecWeaveConfig, SyncConfiguration } from '../core/config/types.js';
+/**
+ * Status sync mapping configuration (runtime config, not in core types)
+ */
+export interface StatusSyncMappings {
+    jira?: {
+        completed?: string;
+    };
+    ado?: {
+        completed?: string | {
+            state: string;
+        };
+    };
+}
+/**
+ * Extended sync configuration with runtime statusSync field
+ */
+export interface SyncConfigurationExtended extends SyncConfiguration {
+    statusSync?: {
+        mappings?: StatusSyncMappings;
+    };
+}
+/**
+ * Supported external providers
+ */
+export type SyncProvider = 'github' | 'jira' | 'ado';
+/**
+ * Provider configuration result
+ */
+export interface ProviderStatus {
+    enabled: boolean;
+    source: 'profile' | 'legacy' | 'none';
+    profileId?: string;
+}
+/**
+ * Check if a provider is enabled in config (supports BOTH formats)
+ *
+ * v1.0.46 FIX: Supports two config formats:
+ * 1. PROFILES format: sync.profiles[name].provider === provider
+ * 2. LEGACY format: sync.[provider].enabled === true
+ *
+ * @param config - Project config object
+ * @param provider - Provider to check ('github', 'jira', 'ado')
+ * @returns true if provider is enabled in either format
+ */
+export declare function isProviderEnabled(config: SpecWeaveConfig, provider: SyncProvider): boolean;
+/**
+ * Get detailed provider status including source of configuration
+ *
+ * @param config - Project config object
+ * @param provider - Provider to check
+ * @returns Detailed provider status
+ */
+export declare function getProviderStatus(config: SpecWeaveConfig, provider: SyncProvider): ProviderStatus;
+/**
+ * Get all enabled providers from config
+ *
+ * @param config - Project config object
+ * @returns Array of enabled providers
+ */
+export declare function getEnabledProviders(config: SpecWeaveConfig): SyncProvider[];
+/**
+ * Status Mapper class for handling status transitions
+ */
+export declare class StatusMapper {
+    private config;
+    constructor(config: SpecWeaveConfig);
+    /**
+     * Check if a provider is enabled
+     */
+    isProviderEnabled(provider: SyncProvider): boolean;
+    /**
+     * Get provider status details
+     */
+    getProviderStatus(provider: SyncProvider): ProviderStatus;
+    /**
+     * Get all enabled providers
+     */
+    getEnabledProviders(): SyncProvider[];
+    /**
+     * Get the target status for a completed increment in JIRA
+     *
+     * @returns Target JIRA status (default: 'Done')
+     */
+    getJiraCompletedStatus(): string;
+    /**
+     * Get the target state for a completed increment in ADO
+     *
+     * @returns Target ADO state (default: 'Closed')
+     */
+    getAdoCompletedState(): string;
+    /**
+     * Check if external sync is allowed.
+     * Aligns with SyncCoordinator: explicit setting wins, otherwise falls back
+     * to resolvePermissions(preset).canUpsert (not a hard-coded false).
+     */
+    canUpdateExternal(): boolean;
+    /**
+     * Check if status updates are allowed
+     */
+    canUpdateStatus(): boolean;
+    /**
+     * Check if auto sync on completion is enabled
+     */
+    isAutoSyncEnabled(): boolean;
+    /**
+     * Check if living docs sync is allowed
+     */
+    canUpsertInternal(): boolean;
+}
+//# sourceMappingURL=status-mapper.d.ts.map

package/plugins/specweave/lib/vendor/sync/status-mapper.js

@@ -0,0 +1,164 @@
+/**
+ * Status Mapper Service
+ *
+ * Handles status mapping between SpecWeave increment statuses and external tool statuses.
+ * Extracted from sync-coordinator.ts for better separation of concerns.
+ *
+ * @module sync/status-mapper
+ * @since v1.0.115
+ */
+import { resolvePermissions } from './config.js';
+/**
+ * Check if a provider is enabled in config (supports BOTH formats)
+ *
+ * v1.0.46 FIX: Supports two config formats:
+ * 1. PROFILES format: sync.profiles[name].provider === provider
+ * 2. LEGACY format: sync.[provider].enabled === true
+ *
+ * @param config - Project config object
+ * @param provider - Provider to check ('github', 'jira', 'ado')
+ * @returns true if provider is enabled in either format
+ */
+export function isProviderEnabled(config, provider) {
+    const syncConfig = config.sync;
+    if (!syncConfig) {
+        return false;
+    }
+    // Check LEGACY format first (sync.github.enabled, sync.jira.enabled, sync.ado.enabled)
+    const providerConfig = syncConfig[provider];
+    if (providerConfig?.enabled === true) {
+        return true;
+    }
+    // Check PROFILES format (sync.profiles with provider field)
+    if (syncConfig.profiles) {
+        for (const profile of Object.values(syncConfig.profiles)) {
+            if (profile?.provider === provider) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Get detailed provider status including source of configuration
+ *
+ * @param config - Project config object
+ * @param provider - Provider to check
+ * @returns Detailed provider status
+ */
+export function getProviderStatus(config, provider) {
+    const syncConfig = config.sync;
+    if (!syncConfig) {
+        return { enabled: false, source: 'none' };
+    }
+    // Check LEGACY format first
+    const providerConfig = syncConfig[provider];
+    if (providerConfig?.enabled === true) {
+        return { enabled: true, source: 'legacy' };
+    }
+    // Check PROFILES format
+    if (syncConfig.profiles) {
+        for (const [profileId, profile] of Object.entries(syncConfig.profiles)) {
+            if (profile?.provider === provider) {
+                return { enabled: true, source: 'profile', profileId };
+            }
+        }
+    }
+    return { enabled: false, source: 'none' };
+}
+/**
+ * Get all enabled providers from config
+ *
+ * @param config - Project config object
+ * @returns Array of enabled providers
+ */
+export function getEnabledProviders(config) {
+    const providers = [];
+    if (isProviderEnabled(config, 'github')) {
+        providers.push('github');
+    }
+    if (isProviderEnabled(config, 'jira')) {
+        providers.push('jira');
+    }
+    if (isProviderEnabled(config, 'ado')) {
+        providers.push('ado');
+    }
+    return providers;
+}
+/**
+ * Status Mapper class for handling status transitions
+ */
+export class StatusMapper {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Check if a provider is enabled
+     */
+    isProviderEnabled(provider) {
+        return isProviderEnabled(this.config, provider);
+    }
+    /**
+     * Get provider status details
+     */
+    getProviderStatus(provider) {
+        return getProviderStatus(this.config, provider);
+    }
+    /**
+     * Get all enabled providers
+     */
+    getEnabledProviders() {
+        return getEnabledProviders(this.config);
+    }
+    /**
+     * Get the target status for a completed increment in JIRA
+     *
+     * @returns Target JIRA status (default: 'Done')
+     */
+    getJiraCompletedStatus() {
+        const syncConfigExt = this.config.sync;
+        return syncConfigExt?.statusSync?.mappings?.jira?.completed || 'Done';
+    }
+    /**
+     * Get the target state for a completed increment in ADO
+     *
+     * @returns Target ADO state (default: 'Closed')
+     */
+    getAdoCompletedState() {
+        const syncConfigExt = this.config.sync;
+        const targetStateConfig = syncConfigExt?.statusSync?.mappings?.ado?.completed || { state: 'Closed' };
+        return typeof targetStateConfig === 'string' ? targetStateConfig : targetStateConfig.state;
+    }
+    /**
+     * Check if external sync is allowed.
+     * Aligns with SyncCoordinator: explicit setting wins, otherwise falls back
+     * to resolvePermissions(preset).canUpsert (not a hard-coded false).
+     */
+    canUpdateExternal() {
+        if (this.config.sync?.settings?.canUpdateExternalItems !== undefined) {
+            return this.config.sync.settings.canUpdateExternalItems;
+        }
+        const syncAny = this.config.sync;
+        const permissions = resolvePermissions(syncAny?.preset, undefined, this.config.sync?.settings);
+        return permissions.canUpsert;
+    }
+    /**
+     * Check if status updates are allowed
+     */
+    canUpdateStatus() {
+        return this.config.sync?.settings?.canUpdateStatus ?? false;
+    }
+    /**
+     * Check if auto sync on completion is enabled
+     */
+    isAutoSyncEnabled() {
+        return this.config.sync?.settings?.autoSyncOnCompletion ?? true;
+    }
+    /**
+     * Check if living docs sync is allowed
+     */
+    canUpsertInternal() {
+        return this.config.sync?.settings?.canUpsertInternalItems ?? true;
+    }
+}
+//# sourceMappingURL=status-mapper.js.map

package/plugins/specweave/lib/vendor/sync/status-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-mapper.js","sourceRoot":"","sources":["../../../src/sync/status-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,EAAE,kBAAkB,EAAmB,MAAM,aAAa,CAAC;AAiClE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAuB,EAAE,QAAsB;IAC/E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;IAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uFAAuF;IACvF,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAA8D,CAAC;IACzG,IAAI,cAAc,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4DAA4D;IAC5D,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzD,IAAI,OAAO,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAuB,EAAE,QAAsB;IAC/E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;IAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5C,CAAC;IAED,4BAA4B;IAC5B,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAA8D,CAAC;IACzG,IAAI,cAAc,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,wBAAwB;IACxB,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvE,IAAI,OAAO,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAuB;IACzD,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,IAAI,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QACxC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QACtC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;QACrC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAGvB,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,QAAsB;QACtC,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,QAAsB;QACtC,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,IAA6C,CAAC;QAChF,OAAO,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,IAAI,MAAM,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACH,oBAAoB;QAClB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,IAA6C,CAAC;QAChF,MAAM,iBAAiB,GAAG,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QACrG,OAAO,OAAO,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC;IAC7F,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,sBAAsB,KAAK,SAAS,EAAE,CAAC;YACrE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAC1D,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAA2C,CAAC;QACxE,MAAM,WAAW,GAAG,kBAAkB,CACpC,OAAO,EAAE,MAAgC,EACzC,SAAS,EACT,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAC3B,CAAC;QACF,OAAO,WAAW,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,IAAI,KAAK,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,oBAAoB,IAAI,IAAI,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,sBAAsB,IAAI,IAAI,CAAC;IACpE,CAAC;CACF"}