@nindroidsystems/pluginator 2.3.0

package/dist/workflows/server-download.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Server Download Workflow
+ *
+ * Handles downloading Minecraft server JARs with verification and progress tracking
+ */
+import { type ServerJarDownloadResult, type ServerJarInfo, type ServerJarType } from '../core/server-jar/index.js';
+/**
+ * Server download progress event
+ */
+export interface ServerDownloadProgress {
+    serverType: ServerJarType;
+    version: string;
+    percent: number;
+    bytesDownloaded: number;
+    totalBytes: number;
+    status: 'fetching' | 'downloading' | 'verifying' | 'done' | 'error';
+    message?: string;
+}
+/**
+ * Server download workflow options
+ */
+export interface ServerDownloadOptions {
+    outputDir: string;
+    serverType: ServerJarType;
+    version: string;
+    backupExisting?: boolean;
+    backupDir?: string;
+    verifyChecksum?: boolean;
+    useStreaming?: boolean;
+    onProgress?: (progress: ServerDownloadProgress) => void;
+}
+/**
+ * Download the latest server JAR for a given type and version
+ */
+export declare function downloadServerJar(options: ServerDownloadOptions): Promise<ServerJarDownloadResult>;
+/**
+ * List available Minecraft versions for a server type
+ */
+export declare function listAvailableVersions(serverType: ServerJarType): Promise<string[]>;
+/**
+ * Check if a version is supported by a server type
+ */
+export declare function isVersionSupported(serverType: ServerJarType, version: string): Promise<boolean>;
+/**
+ * Get the latest build info without downloading
+ */
+export declare function getLatestBuildInfo(serverType: ServerJarType, version: string): Promise<ServerJarInfo>;
+//# sourceMappingURL=server-download.d.ts.map

package/dist/workflows/server-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-download.d.ts","sourceRoot":"","sources":["../../src/workflows/server-download.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,KAAK,uBAAuB,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAsB,MAAM,6BAA6B,CAAC;AAMvI;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACzD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAgIxG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGxF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGrG;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAG3G"}

package/dist/workflows/sync-types.d.ts

@@ -0,0 +1,295 @@
+/**
+ * Sync Workflow Types
+ *
+ * Enhanced type definitions for sync operations with per-file progress tracking.
+ *
+ * @since v1.38.0
+ */
+/**
+ * Sync direction
+ */
+export type SyncDirection = 'prod-to-test' | 'test-to-prod';
+/**
+ * Sync phases
+ */
+export type SyncPhase = 'scanning' | 'planning' | 'backup' | 'staging' | 'copying' | 'verifying' | 'committing' | 'rolling-back' | 'cleanup' | 'complete';
+/**
+ * Sync action for a plugin
+ */
+export interface SyncAction {
+    pluginName: string;
+    action: 'copy' | 'remove' | 'skip' | 'disable' | 'enable';
+    sourceFile?: string;
+    targetFile?: string;
+    reason?: string;
+    fileSize?: number;
+}
+/**
+ * File progress information
+ */
+export interface FileProgress {
+    /** File name */
+    name: string;
+    /** Total file size in bytes */
+    size: number;
+    /** Bytes transferred so far */
+    transferred: number;
+    /** Progress percentage (0-100) */
+    percent: number;
+}
+/**
+ * Enhanced sync progress event with per-file tracking
+ */
+export interface SyncProgress {
+    /** Current sync phase */
+    phase: SyncPhase;
+    /** Current action index (1-based) */
+    current: number;
+    /** Total number of actions */
+    total: number;
+    /** Current plugin being processed */
+    pluginName: string;
+    /** Current action type */
+    action: string;
+    /** Action status */
+    status: 'pending' | 'in_progress' | 'done' | 'error';
+    /** Optional status message */
+    message?: string;
+    /** Per-file progress for current file (for large file operations) */
+    currentFile?: FileProgress;
+    /** Overall progress percentage (0-100) */
+    overallProgress: number;
+    /** Bytes transferred in current operation */
+    bytesTransferred?: number;
+    /** Total bytes to transfer */
+    totalBytes?: number;
+}
+/**
+ * Legacy sync progress (for backward compatibility)
+ * @deprecated Use SyncProgress instead
+ */
+export interface LegacySyncProgress {
+    current: number;
+    total: number;
+    pluginName: string;
+    action: string;
+    status: 'pending' | 'in_progress' | 'done' | 'error';
+    message?: string;
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    direction: SyncDirection;
+    copied: string[];
+    removed: string[];
+    skipped: string[];
+    disabled: string[];
+    enabled: string[];
+    errors: Array<{
+        pluginName: string;
+        error: string;
+    }>;
+    duration: number;
+    backupPath?: string;
+    /** Total bytes transferred */
+    bytesTransferred?: number;
+    /** Total files processed */
+    filesProcessed?: number;
+}
+/**
+ * Sync options
+ */
+export interface SyncOptions {
+    /** Production server plugins directory */
+    prodDir: string;
+    /** Test server plugins directory */
+    testDir: string;
+    /** Plugins to disable on test server */
+    disableOnTest?: string[];
+    /** Plugins to skip when migrating to production (test-to-prod) */
+    skipMigrateToProd?: string[];
+    /** Whether to create backup before sync */
+    createBackup?: boolean;
+    /** Backup directory */
+    backupDir?: string;
+    /** Whether to remove extra plugins from target */
+    removeExtra?: boolean;
+    /** Dry run (don't make changes) */
+    dryRun?: boolean;
+    /** Progress callback (enhanced) */
+    onProgress?: (progress: SyncProgress) => void;
+    /** Legacy progress callback (for backward compatibility) */
+    onLegacyProgress?: (progress: LegacySyncProgress) => void;
+    /** Enable per-file byte progress for files larger than this (bytes) */
+    largeFileThreshold?: number;
+}
+/**
+ * Dry run result
+ */
+export interface DryRunResult {
+    /** Files that would be copied (new) */
+    filesToCopy: Array<{
+        path: string;
+        size: number;
+    }>;
+    /** Files that would be deleted */
+    filesToDelete: Array<{
+        path: string;
+        size: number;
+    }>;
+    /** Files that would be updated */
+    filesToUpdate: Array<{
+        path: string;
+        oldSize: number;
+        newSize: number;
+    }>;
+    /** Files that would be disabled */
+    filesToDisable: Array<{
+        path: string;
+        size: number;
+    }>;
+    /** Files that would be enabled */
+    filesToEnable: Array<{
+        path: string;
+        size: number;
+    }>;
+    /** Files that would be skipped */
+    filesToSkip: Array<{
+        path: string;
+        reason: string;
+    }>;
+    /** Total bytes that would be transferred */
+    totalBytesToTransfer: number;
+    /** Disk space required */
+    spaceRequired: number;
+}
+/**
+ * Sync conflict types
+ */
+export type ConflictType = 'newer-target' | 'different-content' | 'config-file' | 'size-mismatch';
+/**
+ * Sync conflict
+ */
+export interface SyncConflict {
+    type: ConflictType;
+    sourcePath: string;
+    targetPath: string;
+    sourceModified: Date;
+    targetModified: Date;
+    sourceSize: number;
+    targetSize: number;
+}
+/**
+ * Conflict resolution action
+ */
+export interface ConflictResolution {
+    action: 'overwrite' | 'skip' | 'rename' | 'backup-then-overwrite';
+    applyToAll?: boolean;
+}
+/**
+ * Conflict detection options
+ */
+export interface ConflictDetectionOptions {
+    /** Check for config file conflicts (plugin config folders) */
+    checkConfigFiles?: boolean;
+    /** Size difference threshold for size-mismatch conflict (percentage, default 50%) */
+    sizeMismatchThreshold?: number;
+    /** Time tolerance in milliseconds for considering files as same age (default 1000ms) */
+    timeTolerance?: number;
+    /** File extensions to check for config conflicts (default: ['.yml', '.yaml', '.json', '.properties']) */
+    configExtensions?: string[];
+}
+/**
+ * Conflict detection result
+ */
+export interface ConflictDetectionResult {
+    /** List of detected conflicts */
+    conflicts: SyncConflict[];
+    /** Total files checked */
+    filesChecked: number;
+    /** Files with no conflicts */
+    filesClean: number;
+    /** Whether any conflicts were found */
+    hasConflicts: boolean;
+}
+/**
+ * Resolution log entry
+ */
+export interface ConflictResolutionLog {
+    /** Timestamp of resolution */
+    timestamp: Date;
+    /** The conflict that was resolved */
+    conflict: SyncConflict;
+    /** The resolution applied */
+    resolution: ConflictResolution;
+    /** Result of applying resolution */
+    result: 'success' | 'failed';
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Batch conflict resolution options
+ */
+export interface BatchResolutionOptions {
+    /** Default action for all conflicts */
+    defaultAction?: ConflictResolution['action'];
+    /** Actions for specific conflict types */
+    typeActions?: Partial<Record<ConflictType, ConflictResolution['action']>>;
+    /** Create backups before overwriting */
+    backupBeforeOverwrite?: boolean;
+    /** Backup directory */
+    backupDir?: string;
+}
+/**
+ * Default large file threshold (1 MB)
+ */
+export declare const DEFAULT_LARGE_FILE_THRESHOLD: number;
+/**
+ * Atomic sync options (extends SyncOptions with two-phase commit support)
+ */
+export interface AtomicSyncOptions extends SyncOptions {
+    /** Enable atomic sync with staging directory */
+    atomic?: boolean;
+    /** Custom staging directory (defaults to .sync-staging-<timestamp>) */
+    stagingDir?: string;
+    /** Verify staging integrity before commit */
+    verifyStaging?: boolean;
+    /** Keep staging directory on failure for debugging */
+    keepStagingOnFailure?: boolean;
+}
+/**
+ * Atomic sync result (extends SyncResult with staging info)
+ */
+export interface AtomicSyncResult extends SyncResult {
+    /** Whether atomic mode was used */
+    atomic: boolean;
+    /** Staging directory used (if atomic) */
+    stagingPath?: string;
+    /** Whether verification passed (if atomic) */
+    verificationPassed?: boolean;
+    /** Whether rollback was performed */
+    rolledBack?: boolean;
+    /** Rollback reason if rolled back */
+    rollbackReason?: string;
+}
+/**
+ * Staging state for atomic sync
+ */
+export interface StagingState {
+    /** Staging directory path */
+    stagingDir: string;
+    /** Backup directory path (original target) */
+    backupDir: string;
+    /** Target directory path */
+    targetDir: string;
+    /** Timestamp of staging creation */
+    timestamp: number;
+    /** Whether staging is ready for commit */
+    readyToCommit: boolean;
+    /** Files staged */
+    stagedFiles: string[];
+    /** Verification hash (if verified) */
+    verificationHash?: string;
+}
+//# sourceMappingURL=sync-types.d.ts.map

package/dist/workflows/sync-types.d.ts.map

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

package/dist/workflows/sync-utils.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Sync Workflow Utilities
+ *
+ * Utility functions for sync operations including per-file progress tracking
+ * and atomic two-phase commit support.
+ *
+ * @since v1.38.0
+ * @updated v1.41.0 - Added atomic sync utilities
+ */
+import type { BatchResolutionOptions, ConflictDetectionOptions, ConflictDetectionResult, ConflictResolution, ConflictResolutionLog, ConflictType, DryRunResult, FileProgress, StagingState, SyncAction, SyncConflict, SyncDirection } from './sync-types.js';
+/**
+ * Copy a file with progress tracking
+ *
+ * Uses streams to report byte-level progress for large files.
+ */
+export declare function copyFileWithProgress(sourcePath: string, targetPath: string, onProgress?: (progress: FileProgress) => void): Promise<number>;
+/**
+ * Get file size
+ */
+export declare function getFileSize(filePath: string): Promise<number>;
+/**
+ * Calculate total bytes for a list of sync actions
+ */
+export declare function calculateTotalBytes(actions: SyncAction[]): Promise<number>;
+/**
+ * Enhance sync actions with file size information
+ */
+export declare function enhanceActionsWithSize(actions: SyncAction[]): Promise<SyncAction[]>;
+/**
+ * Generate dry run result from sync actions
+ */
+export declare function generateDryRunResult(actions: SyncAction[]): DryRunResult;
+/**
+ * Format bytes to human-readable string
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format transfer speed
+ */
+export declare function formatSpeed(bytesPerSecond: number): string;
+/**
+ * Calculate overall progress from current action and file progress
+ */
+export declare function calculateOverallProgress(currentAction: number, totalActions: number, currentFileProgress?: FileProgress): number;
+/**
+ * Create a staging directory for atomic sync
+ */
+export declare function createStagingDirectory(targetDir: string, customPath?: string): Promise<StagingState>;
+/**
+ * Copy a single file to staging directory
+ */
+export declare function stageFile(sourcePath: string, stagingDir: string, relativePath: string, onProgress?: (progress: FileProgress) => void): Promise<number>;
+/**
+ * Copy all files to staging directory
+ */
+export declare function copyToStaging(actions: SyncAction[], stagingDir: string, onProgress?: (current: number, total: number, fileName: string) => void): Promise<string[]>;
+/**
+ * Verify staging directory integrity by comparing hashes
+ */
+export declare function verifyStagingIntegrity(stagingState: StagingState, actions: SyncAction[]): Promise<{
+    valid: boolean;
+    hash?: string;
+    errors: string[];
+}>;
+/**
+ * Commit staging to target (atomic swap)
+ *
+ * This performs the "commit" phase of two-phase commit:
+ * 1. Rename current target to backup
+ * 2. Rename staging to target
+ *
+ * If Phase 2 fails, automatically rolls back by restoring the backup.
+ */
+export declare function commitStaging(stagingState: StagingState): Promise<void>;
+/**
+ * Rollback to previous state
+ *
+ * Restores the backup directory to the target location.
+ */
+export declare function rollbackStaging(stagingState: StagingState): Promise<void>;
+/**
+ * Clean up staging and backup directories after successful sync
+ */
+export declare function cleanupStaging(stagingState: StagingState, keepBackup?: boolean): Promise<void>;
+/**
+ * Check if a directory is a staging or backup directory from a previous failed sync
+ */
+export declare function isOrphanedSyncDirectory(dirName: string): boolean;
+/**
+ * Find and list orphaned staging/backup directories
+ */
+export declare function findOrphanedSyncDirectories(parentDir: string): Promise<string[]>;
+/**
+ * Clean up orphaned staging/backup directories from failed syncs
+ */
+export declare function cleanupOrphanedSyncDirectories(parentDir: string): Promise<number>;
+/**
+ * Scan file info for dry run comparison
+ */
+interface FileInfo {
+    path: string;
+    name: string;
+    size: number;
+    modified: Date;
+    checksum?: string;
+}
+/**
+ * Scan a plugins directory for dry run comparison
+ */
+export declare function scanPluginsDirectory(dir: string): Promise<Map<string, FileInfo>>;
+/**
+ * Compare source and target directories to generate dry run result
+ */
+export declare function compareDirsForDryRun(sourceDir: string, targetDir: string, options: {
+    direction: SyncDirection;
+    disableOnTarget?: string[];
+    removeExtra?: boolean;
+}): Promise<DryRunResult>;
+/**
+ * Format a dry run result for console output
+ */
+export declare function formatDryRunResult(result: DryRunResult, direction: SyncDirection): string;
+/**
+ * Get a summary of dry run changes for UI display
+ */
+export declare function getDryRunSummary(result: DryRunResult): {
+    totalChanges: number;
+    newFiles: number;
+    updatedFiles: number;
+    deletedFiles: number;
+    disabledFiles: number;
+    enabledFiles: number;
+    skippedFiles: number;
+    bytesToTransfer: number;
+    spaceRequired: number;
+};
+/**
+ * Default conflict detection options
+ */
+export declare const DEFAULT_CONFLICT_OPTIONS: Required<ConflictDetectionOptions>;
+/**
+ * Classify a conflict between source and target files
+ */
+export declare function classifyConflict(sourceInfo: FileInfo, targetInfo: FileInfo, options: Required<ConflictDetectionOptions>): ConflictType | null;
+/**
+ * Detect conflicts between source and target directories
+ */
+export declare function detectConflicts(sourceDir: string, targetDir: string, options?: ConflictDetectionOptions): Promise<ConflictDetectionResult>;
+/**
+ * Detect config file conflicts in plugin config directories
+ */
+export declare function detectConfigConflicts(sourceDir: string, targetDir: string, pluginName: string, options?: ConflictDetectionOptions): Promise<SyncConflict[]>;
+/**
+ * Get human-readable description for a conflict type
+ */
+export declare function getConflictTypeDescription(type: ConflictType): string;
+/**
+ * Get icon for a conflict type
+ */
+export declare function getConflictTypeIcon(type: ConflictType): string;
+/**
+ * Format conflicts for console output
+ */
+export declare function formatConflicts(conflicts: SyncConflict[]): string;
+/**
+ * Format a conflict for single-line display
+ */
+export declare function formatConflictShort(conflict: SyncConflict): string;
+/**
+ * Apply a resolution to a conflict
+ */
+export declare function applyResolution(conflict: SyncConflict, resolution: ConflictResolution, backupDir?: string): Promise<ConflictResolutionLog>;
+/**
+ * Apply batch resolutions to multiple conflicts
+ */
+export declare function applyBatchResolutions(conflicts: SyncConflict[], options: BatchResolutionOptions): Promise<ConflictResolutionLog[]>;
+/**
+ * Format resolution logs for display
+ */
+export declare function formatResolutionLogs(logs: ConflictResolutionLog[]): string;
+/**
+ * Filter conflicts by type
+ */
+export declare function filterConflictsByType(conflicts: SyncConflict[], types: ConflictType[]): SyncConflict[];
+/**
+ * Sort conflicts by severity (higher severity first)
+ */
+export declare function sortConflictsBySeverity(conflicts: SyncConflict[]): SyncConflict[];
+/**
+ * Get conflict statistics
+ */
+export declare function getConflictStats(conflicts: SyncConflict[]): {
+    total: number;
+    byType: Record<ConflictType, number>;
+    totalSourceBytes: number;
+    totalTargetBytes: number;
+};
+export {};
+//# sourceMappingURL=sync-utils.d.ts.map

package/dist/workflows/sync-utils.d.ts.map

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

package/dist/workflows/sync.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Sync Workflow
+ *
+ * Synchronizes plugins between production and test servers.
+ * Supports per-file progress tracking for large file operations.
+ *
+ * @since v1.0.0
+ * @updated v1.38.0 - Added per-file progress tracking
+ */
+import { EventEmitter } from 'node:events';
+import { type SyncAction, type SyncDirection, type SyncOptions, type SyncProgress, type SyncResult } from './sync-types.js';
+export type { SyncDirection, SyncAction, SyncProgress, SyncResult, SyncOptions } from './sync-types.js';
+/**
+ * Sync workflow class
+ */
+export declare class SyncWorkflow extends EventEmitter {
+    private options;
+    private currentPhase;
+    private totalBytes;
+    private bytesTransferred;
+    private largeFileThreshold;
+    constructor(options: SyncOptions);
+    /**
+     * Execute sync in the specified direction
+     */
+    sync(direction: SyncDirection): Promise<SyncResult>;
+    /**
+     * Report progress with enhanced tracking
+     */
+    private reportProgress;
+    /**
+     * Internal sync implementation (wrapped by sleep prevention)
+     */
+    private syncInternal;
+    /**
+     * Record action result
+     */
+    private recordAction;
+    /**
+     * Execute action with per-file progress tracking
+     */
+    private executeActionWithProgress;
+    /**
+     * Check if a filename is a disabled JAR file
+     */
+    private isDisabledJar;
+    /**
+     * Get the enabled filename from a disabled filename
+     * Converts .jarDIS, .jar.dis, .jar.disabled back to .jar
+     */
+    private getEnabledFilename;
+    /**
+     * Plan sync actions
+     */
+    private planSync;
+    /**
+     * Get sync preview (dry run)
+     */
+    preview(direction: SyncDirection): Promise<SyncAction[]>;
+}
+/**
+ * Create a sync workflow
+ */
+export declare function createSyncWorkflow(options: SyncOptions): SyncWorkflow;
+/**
+ * Quick sync from prod to test
+ */
+export declare function syncProdToTest(prodDir: string, testDir: string, disableOnTest?: string[], onProgress?: (progress: SyncProgress) => void): Promise<SyncResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/workflows/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/workflows/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAc3C,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAIzB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAExG;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAMhC,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,kBAAkB,CAAS;gBAEf,OAAO,EAAE,WAAW;IAKxC;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAOzD;;OAEG;IACH,OAAO,CAAC,cAAc;IAkCtB;;OAEG;YACW,YAAY;IAmH1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;YACW,yBAAyB;IAoEvC;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,QAAQ;IA2FhB;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAe/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAErE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,EAAO,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAWvK"}