mcp-wordpress 1.1.7 → 1.2.2

package/dist/cache/CacheInvalidation.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Intelligent cache invalidation strategies for WordPress MCP Server
+ * Implements event-based and pattern-based invalidation
+ */
+import { HttpCacheWrapper } from './HttpCacheWrapper.js';
+export interface InvalidationRule {
+    trigger: string;
+    patterns: string[];
+    immediate?: boolean;
+    cascade?: boolean;
+}
+export interface InvalidationEvent {
+    type: 'create' | 'update' | 'delete';
+    resource: string;
+    id?: number | undefined;
+    siteId: string;
+    timestamp: number;
+    data?: any;
+}
+/**
+ * Cache invalidation manager that handles intelligent cache clearing
+ */
+export declare class CacheInvalidation {
+    private httpCache;
+    private invalidationRules;
+    private eventQueue;
+    private processing;
+    constructor(httpCache: HttpCacheWrapper);
+    /**
+     * Register invalidation rule
+     */
+    registerRule(resource: string, rule: InvalidationRule): void;
+    /**
+     * Trigger invalidation event
+     */
+    trigger(event: InvalidationEvent): Promise<void>;
+    /**
+     * Invalidate cache for specific resource
+     */
+    invalidateResource(resource: string, id?: number, type?: 'create' | 'update' | 'delete'): Promise<void>;
+    /**
+     * Setup default invalidation rules
+     */
+    private setupDefaultRules;
+    /**
+     * Process invalidation event queue
+     */
+    private processQueue;
+    /**
+     * Process single invalidation event
+     */
+    private processEvent;
+    /**
+     * Apply invalidation rule to cache
+     */
+    private applyInvalidationRule;
+    /**
+     * Get invalidation statistics
+     */
+    getStats(): {
+        queueSize: number;
+        rulesCount: number;
+        processing: boolean;
+    };
+    /**
+     * Clear all invalidation rules
+     */
+    clearRules(): void;
+    /**
+     * Get all registered rules
+     */
+    getRules(): Record<string, InvalidationRule[]>;
+}
+/**
+ * Cache invalidation patterns for common WordPress operations
+ */
+export declare class WordPressCachePatterns {
+    /**
+     * Invalidate all content-related caches
+     */
+    static invalidateContent(cache: HttpCacheWrapper): number;
+    /**
+     * Invalidate all taxonomy-related caches
+     */
+    static invalidateTaxonomies(cache: HttpCacheWrapper): number;
+    /**
+     * Invalidate all user-related caches
+     */
+    static invalidateUsers(cache: HttpCacheWrapper): number;
+    /**
+     * Invalidate search-related caches
+     */
+    static invalidateSearch(cache: HttpCacheWrapper): number;
+    /**
+     * Invalidate all caches (nuclear option)
+     */
+    static invalidateAll(cache: HttpCacheWrapper): number;
+}
+/**
+ * Cache warming strategies for common WordPress data
+ */
+export declare class CacheWarmer {
+    private httpCache;
+    constructor(httpCache: HttpCacheWrapper);
+    /**
+     * Warm cache with essential WordPress data
+     */
+    warmEssentials(): Promise<void>;
+    /**
+     * Warm cache with taxonomy data
+     */
+    warmTaxonomies(): Promise<void>;
+    /**
+     * Warm cache with user data
+     */
+    warmUsers(): Promise<void>;
+}
+//# sourceMappingURL=CacheInvalidation.d.ts.map

package/dist/cache/CacheInvalidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheInvalidation.d.ts","sourceRoot":"","sources":["../../src/cache/CacheInvalidation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAKhB,OAAO,CAAC,SAAS;IAJ7B,OAAO,CAAC,iBAAiB,CAA8C;IACvE,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,UAAU,CAAS;gBAEP,SAAS,EAAE,gBAAgB;IAI/C;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAO5D;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD;;OAEG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,MAAM,EACX,IAAI,GAAE,QAAQ,GAAG,QAAQ,GAAG,QAAmB,GAC9C,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuLzB;;OAEG;YACW,YAAY;IAiB1B;;OAEG;YACW,YAAY;IAU1B;;OAEG;YACW,qBAAqB;IAqBnC;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;KACnB;IAQH;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAO/C;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAIzD;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAI5D;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAIvD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAIxD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;CAGtD;AAED;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,gBAAgB;IAE/C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAGjC"}

package/dist/cache/CacheInvalidation.js

@@ -0,0 +1,349 @@
+/**
+ * Intelligent cache invalidation strategies for WordPress MCP Server
+ * Implements event-based and pattern-based invalidation
+ */
+/**
+ * Cache invalidation manager that handles intelligent cache clearing
+ */
+export class CacheInvalidation {
+    httpCache;
+    invalidationRules = new Map();
+    eventQueue = [];
+    processing = false;
+    constructor(httpCache) {
+        this.httpCache = httpCache;
+        this.setupDefaultRules();
+    }
+    /**
+     * Register invalidation rule
+     */
+    registerRule(resource, rule) {
+        if (!this.invalidationRules.has(resource)) {
+            this.invalidationRules.set(resource, []);
+        }
+        this.invalidationRules.get(resource).push(rule);
+    }
+    /**
+     * Trigger invalidation event
+     */
+    async trigger(event) {
+        this.eventQueue.push(event);
+        if (!this.processing) {
+            await this.processQueue();
+        }
+    }
+    /**
+     * Invalidate cache for specific resource
+     */
+    async invalidateResource(resource, id, type = 'update') {
+        const event = {
+            type,
+            resource,
+            id,
+            siteId: this.httpCache['siteId'], // Access private property
+            timestamp: Date.now()
+        };
+        await this.trigger(event);
+    }
+    /**
+     * Setup default invalidation rules
+     */
+    setupDefaultRules() {
+        // Post invalidation rules
+        this.registerRule('posts', {
+            trigger: 'create',
+            patterns: [
+                'posts', // All posts listings
+                'posts/\\d+', // Specific post
+                'categories', // Category listings (if post has categories)
+                'tags', // Tag listings (if post has tags)
+                'search' // Search results
+            ],
+            immediate: true,
+            cascade: true
+        });
+        this.registerRule('posts', {
+            trigger: 'update',
+            patterns: [
+                'posts/\\d+', // Specific post
+                'posts.*', // All posts with parameters
+                'search' // Search results
+            ],
+            immediate: true
+        });
+        this.registerRule('posts', {
+            trigger: 'delete',
+            patterns: [
+                'posts', // All posts listings
+                'posts/\\d+', // Specific post
+                'categories', // Category counts might change
+                'tags', // Tag counts might change
+                'search' // Search results
+            ],
+            immediate: true,
+            cascade: true
+        });
+        // Page invalidation rules
+        this.registerRule('pages', {
+            trigger: 'create',
+            patterns: ['pages', 'pages/\\d+'],
+            immediate: true
+        });
+        this.registerRule('pages', {
+            trigger: 'update',
+            patterns: ['pages/\\d+', 'pages.*'],
+            immediate: true
+        });
+        this.registerRule('pages', {
+            trigger: 'delete',
+            patterns: ['pages', 'pages/\\d+'],
+            immediate: true
+        });
+        // Comment invalidation rules
+        this.registerRule('comments', {
+            trigger: 'create',
+            patterns: [
+                'comments',
+                'comments.*',
+                'posts/\\d+.*' // Parent post cache
+            ],
+            immediate: true
+        });
+        this.registerRule('comments', {
+            trigger: 'update',
+            patterns: [
+                'comments/\\d+',
+                'comments.*',
+                'posts/\\d+.*' // Parent post cache
+            ],
+            immediate: true
+        });
+        this.registerRule('comments', {
+            trigger: 'delete',
+            patterns: [
+                'comments',
+                'comments/\\d+',
+                'posts/\\d+.*' // Parent post cache
+            ],
+            immediate: true
+        });
+        // Media invalidation rules
+        this.registerRule('media', {
+            trigger: 'create',
+            patterns: ['media', 'media.*'],
+            immediate: true
+        });
+        this.registerRule('media', {
+            trigger: 'update',
+            patterns: ['media/\\d+', 'media.*'],
+            immediate: true
+        });
+        this.registerRule('media', {
+            trigger: 'delete',
+            patterns: ['media', 'media/\\d+'],
+            immediate: true
+        });
+        // User invalidation rules
+        this.registerRule('users', {
+            trigger: 'create',
+            patterns: ['users', 'users.*'],
+            immediate: true
+        });
+        this.registerRule('users', {
+            trigger: 'update',
+            patterns: [
+                'users/\\d+',
+                'users.*',
+                'users/me' // Current user info
+            ],
+            immediate: true
+        });
+        this.registerRule('users', {
+            trigger: 'delete',
+            patterns: ['users', 'users/\\d+'],
+            immediate: true
+        });
+        // Category invalidation rules
+        this.registerRule('categories', {
+            trigger: 'create',
+            patterns: ['categories', 'categories.*', 'posts.*'],
+            immediate: true,
+            cascade: true
+        });
+        this.registerRule('categories', {
+            trigger: 'update',
+            patterns: ['categories/\\d+', 'categories.*', 'posts.*'],
+            immediate: true,
+            cascade: true
+        });
+        this.registerRule('categories', {
+            trigger: 'delete',
+            patterns: ['categories', 'categories/\\d+', 'posts.*'],
+            immediate: true,
+            cascade: true
+        });
+        // Tag invalidation rules
+        this.registerRule('tags', {
+            trigger: 'create',
+            patterns: ['tags', 'tags.*', 'posts.*'],
+            immediate: true,
+            cascade: true
+        });
+        this.registerRule('tags', {
+            trigger: 'update',
+            patterns: ['tags/\\d+', 'tags.*', 'posts.*'],
+            immediate: true,
+            cascade: true
+        });
+        this.registerRule('tags', {
+            trigger: 'delete',
+            patterns: ['tags', 'tags/\\d+', 'posts.*'],
+            immediate: true,
+            cascade: true
+        });
+        // Settings invalidation rules (rarely change)
+        this.registerRule('settings', {
+            trigger: 'update',
+            patterns: ['settings.*'],
+            immediate: true,
+            cascade: false
+        });
+    }
+    /**
+     * Process invalidation event queue
+     */
+    async processQueue() {
+        if (this.processing || this.eventQueue.length === 0) {
+            return;
+        }
+        this.processing = true;
+        try {
+            while (this.eventQueue.length > 0) {
+                const event = this.eventQueue.shift();
+                await this.processEvent(event);
+            }
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    /**
+     * Process single invalidation event
+     */
+    async processEvent(event) {
+        const rules = this.invalidationRules.get(event.resource) || [];
+        for (const rule of rules) {
+            if (rule.trigger === event.type || rule.trigger === '*') {
+                await this.applyInvalidationRule(event, rule);
+            }
+        }
+    }
+    /**
+     * Apply invalidation rule to cache
+     */
+    async applyInvalidationRule(event, rule) {
+        for (const pattern of rule.patterns) {
+            let invalidationPattern = pattern;
+            // Replace placeholders with actual values
+            if (event.id) {
+                invalidationPattern = invalidationPattern.replace('\\d+', event.id.toString());
+            }
+            // Invalidate matching cache entries
+            const invalidated = this.httpCache.invalidatePattern(invalidationPattern);
+            if (invalidated > 0) {
+                console.log(`Invalidated ${invalidated} cache entries for pattern: ${invalidationPattern}`);
+            }
+        }
+    }
+    /**
+     * Get invalidation statistics
+     */
+    getStats() {
+        return {
+            queueSize: this.eventQueue.length,
+            rulesCount: Array.from(this.invalidationRules.values()).reduce((acc, rules) => acc + rules.length, 0),
+            processing: this.processing
+        };
+    }
+    /**
+     * Clear all invalidation rules
+     */
+    clearRules() {
+        this.invalidationRules.clear();
+    }
+    /**
+     * Get all registered rules
+     */
+    getRules() {
+        const rules = {};
+        for (const [resource, ruleList] of this.invalidationRules.entries()) {
+            rules[resource] = [...ruleList];
+        }
+        return rules;
+    }
+}
+/**
+ * Cache invalidation patterns for common WordPress operations
+ */
+export class WordPressCachePatterns {
+    /**
+     * Invalidate all content-related caches
+     */
+    static invalidateContent(cache) {
+        return cache.invalidatePattern('(posts|pages|comments|media)');
+    }
+    /**
+     * Invalidate all taxonomy-related caches
+     */
+    static invalidateTaxonomies(cache) {
+        return cache.invalidatePattern('(categories|tags|taxonomies)');
+    }
+    /**
+     * Invalidate all user-related caches
+     */
+    static invalidateUsers(cache) {
+        return cache.invalidatePattern('users');
+    }
+    /**
+     * Invalidate search-related caches
+     */
+    static invalidateSearch(cache) {
+        return cache.invalidatePattern('search');
+    }
+    /**
+     * Invalidate all caches (nuclear option)
+     */
+    static invalidateAll(cache) {
+        return cache.invalidateAll();
+    }
+}
+/**
+ * Cache warming strategies for common WordPress data
+ */
+export class CacheWarmer {
+    httpCache;
+    constructor(httpCache) {
+        this.httpCache = httpCache;
+    }
+    /**
+     * Warm cache with essential WordPress data
+     */
+    async warmEssentials() {
+        // Implementation would depend on your specific WordPress client
+        // This is a placeholder for the structure
+        console.log('Warming essential caches...');
+    }
+    /**
+     * Warm cache with taxonomy data
+     */
+    async warmTaxonomies() {
+        console.log('Warming taxonomy caches...');
+    }
+    /**
+     * Warm cache with user data
+     */
+    async warmUsers() {
+        console.log('Warming user caches...');
+    }
+}
+//# sourceMappingURL=CacheInvalidation.js.map

package/dist/cache/CacheInvalidation.js.map

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

package/dist/cache/CacheManager.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Intelligent caching system for WordPress MCP Server
+ * Implements multi-layer caching with TTL, LRU eviction, and site-specific keys
+ */
+export interface CacheEntry<T = any> {
+    value: T;
+    timestamp: number;
+    ttl: number;
+    etag?: string | undefined;
+    lastModified?: string | undefined;
+    accessCount: number;
+    lastAccessed: number;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    totalSize: number;
+    hitRate: number;
+}
+export interface CacheConfig {
+    maxSize: number;
+    defaultTTL: number;
+    enableLRU: boolean;
+    enableStats: boolean;
+    sitePrefix?: string;
+}
+/**
+ * High-performance in-memory cache with TTL and LRU eviction
+ */
+export declare class CacheManager {
+    private config;
+    private cache;
+    private accessOrder;
+    private stats;
+    constructor(config: CacheConfig);
+    /**
+     * Generate cache key with site prefix and parameter hash
+     */
+    generateKey(siteId: string, endpoint: string, params?: any): string;
+    /**
+     * Get value from cache if not expired
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Set value in cache with TTL
+     */
+    set<T>(key: string, value: T, ttl?: number, etag?: string, lastModified?: string): void;
+    /**
+     * Check if cache entry exists and is valid
+     */
+    has(key: string): boolean;
+    /**
+     * Delete specific cache entry
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Clear cache entries for specific site
+     */
+    clearSite(siteId: string): number;
+    /**
+     * Clear cache entries matching pattern
+     */
+    clearPattern(pattern: RegExp): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Get cache entry with metadata
+     */
+    getEntry(key: string): CacheEntry | null;
+    /**
+     * Check if entry supports conditional requests
+     */
+    supportsConditionalRequest(key: string): boolean;
+    /**
+     * Get conditional request headers
+     */
+    getConditionalHeaders(key: string): Record<string, string>;
+    /**
+     * Check if entry is expired
+     */
+    private isExpired;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Update access order for LRU tracking
+     */
+    private updateAccessOrder;
+    /**
+     * Remove key from access order
+     */
+    private removeFromAccessOrder;
+    /**
+     * Normalize parameters for consistent hashing
+     */
+    private normalizeParams;
+    /**
+     * Update hit rate calculation
+     */
+    private updateHitRate;
+    /**
+     * Start periodic cleanup of expired entries
+     */
+    private startCleanupInterval;
+    /**
+     * Remove expired entries
+     */
+    private cleanupExpired;
+}
+/**
+ * Cache configuration presets for different data types
+ */
+export declare const CachePresets: {
+    STATIC: {
+        ttl: number;
+        cacheControl: string;
+    };
+    SEMI_STATIC: {
+        ttl: number;
+        cacheControl: string;
+    };
+    DYNAMIC: {
+        ttl: number;
+        cacheControl: string;
+    };
+    SESSION: {
+        ttl: number;
+        cacheControl: string;
+    };
+    REALTIME: {
+        ttl: number;
+        cacheControl: string;
+    };
+};
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/cache/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,GAAG;IACjC,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,YAAY;IAWX,OAAO,CAAC,MAAM;IAV1B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,KAAK,CAMX;gBAEkB,MAAM,EAAE,WAAW;IAKvC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,MAAM;IAiBnE;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IA6B7B;;OAEG;IACH,GAAG,CAAC,CAAC,EACH,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,GAAG,GAAE,MAA+B,EACpC,IAAI,CAAC,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI;IA0BP;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAS5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAkBjC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAkBrC;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAQxC;;OAEG;IACH,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKhD;;OAEG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAiB1D;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAUhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,cAAc;CAiBvB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;CA8BxB,CAAC"}