@pithyjs/router 0.1.0-beta.0

package/dist/router/features/prefetch/index.js

@@ -0,0 +1,345 @@
+/** @codex
+{
+  "id": "pithy.router.prefetch",
+  "title": "Enhanced Prefetch System with Intelligent Heuristics",
+  "category": "runtime"
+}
+*/
+import { PREFETCH_DEFAULTS } from '../../core/constants';
+import { DEFAULT_VISIBILITY_MARGIN, observeVisibilityOnce, } from '@pithyjs/shared';
+/** @codexApi {"parent":"pithy.router.prefetch","name":"PREFETCH_STRATEGIES","stability":"stable","signature":"readonly PrefetchStrategy[]","description":"Runtime list of valid PrefetchStrategy values for enum validation"} */
+export const PREFETCH_STRATEGIES = [
+    'none',
+    'hover',
+    'visible',
+    'intent',
+];
+/** @codexApi {"parent":"pithy.router.prefetch","name":"PrefetchManager","stability":"stable","signature":"class PrefetchManager","description":"Intelligent resource prefetching with enhanced heuristics"} */
+/**
+ * Prefetch manager for intelligent resource prefetching
+ * Implements enhanced prefetch policy & cache layer from architectural improvements
+ */
+export class PrefetchManager {
+    constructor(config = {}) {
+        this.activeRequests = new Map();
+        this.hoverTimers = new Map();
+        this.intentTracking = new Map();
+        /** Track when each route was last prefetched with its TTL to avoid repeated prefetches */
+        this.prefetchedAt = new Map();
+        this.config = {
+            hoverDelay: config.hoverDelay ?? PREFETCH_DEFAULTS.HOVER_DELAY,
+            visibleMargin: config.visibleMargin ?? DEFAULT_VISIBILITY_MARGIN,
+            cacheTTL: config.cacheTTL ?? PREFETCH_DEFAULTS.CACHE_TTL,
+            intentVelocityThreshold: config.intentVelocityThreshold ??
+                PREFETCH_DEFAULTS.INTENT_VELOCITY_THRESHOLD,
+            intentDirectionSamples: config.intentDirectionSamples ??
+                PREFETCH_DEFAULTS.INTENT_DIRECTION_SAMPLES,
+        };
+    }
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"registerLink","stability":"stable","signature":"(element: HTMLElement, strategy: PrefetchStrategy) => void","description":"Register a link element for prefetching with a given strategy"} */
+    /**
+     * Register a link for prefetching with specified strategy
+     */
+    registerLink(element, strategy) {
+        const href = element.getAttribute('href');
+        if (!href || strategy === 'none') {
+            return;
+        }
+        switch (strategy) {
+            case 'hover':
+                this.setupHoverPrefetch(element, href);
+                break;
+            case 'visible':
+                this.setupVisiblePrefetch(element);
+                break;
+            case 'intent':
+                this.setupIntentPrefetch(element, href);
+                break;
+        }
+    }
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"unregisterLink","stability":"stable","signature":"(element: HTMLElement) => void","description":"Unregister a link and clean up its prefetch listeners"} */
+    /**
+     * Unregister a link from prefetching
+     */
+    unregisterLink(element) {
+        const href = element.getAttribute('href');
+        if (href) {
+            this.cancelPrefetch(href);
+        }
+        // Clean up hover timer
+        const timer = this.hoverTimers.get(element);
+        if (timer) {
+            clearTimeout(timer);
+            this.hoverTimers.delete(element);
+        }
+        // Clean up intent tracking
+        this.intentTracking.delete(element);
+        // Call element-specific cleanup (removes event listeners and visibility observer)
+        const target = element;
+        const cleanup = target.__prefetchCleanup;
+        if (cleanup) {
+            cleanup();
+            delete target.__prefetchCleanup;
+        }
+    }
+    /**
+     * Setup hover-based prefetching with intent delay
+     */
+    setupHoverPrefetch(element, href) {
+        const handleMouseEnter = () => {
+            const timer = setTimeout(() => {
+                this.prefetchRoute(href, 'hover');
+                this.hoverTimers.delete(element);
+            }, this.config.hoverDelay);
+            this.hoverTimers.set(element, timer);
+        };
+        const handleMouseLeave = () => {
+            // Only clear the hover timer, but DON'T cancel in-flight prefetch requests
+            // This is important because mouseleave fires before click, so canceling
+            // would abort requests that navigation needs
+            const timer = this.hoverTimers.get(element);
+            if (timer) {
+                clearTimeout(timer);
+                this.hoverTimers.delete(element);
+            }
+        };
+        element.addEventListener('mouseenter', handleMouseEnter);
+        element.addEventListener('mouseleave', handleMouseLeave);
+        // Store cleanup functions
+        element.__prefetchCleanup = () => {
+            element.removeEventListener('mouseenter', handleMouseEnter);
+            element.removeEventListener('mouseleave', handleMouseLeave);
+        };
+    }
+    /**
+     * Setup visibility-based prefetching using shared observer pool from @pithyjs/shared
+     */
+    setupVisiblePrefetch(element) {
+        const href = element.getAttribute('href');
+        if (!href)
+            return;
+        // Use shared IntersectionObserver pool
+        const cleanup = observeVisibilityOnce(element, () => this.prefetchRoute(href, 'visible'), { rootMargin: this.config.visibleMargin });
+        // Store cleanup for unregisterLink
+        element.__prefetchCleanup = cleanup;
+    }
+    /**
+     * Setup intent-based prefetching with pointer tracking
+     */
+    setupIntentPrefetch(element, href) {
+        const tracker = new PointerTracker(this.config.intentVelocityThreshold, this.config.intentDirectionSamples);
+        // Define proximity threshold (distance from link to start tracking)
+        const proximityThreshold = 200; // pixels
+        const handleMouseMove = (event) => {
+            const rect = element.getBoundingClientRect();
+            const centerX = rect.left + rect.width / 2;
+            const centerY = rect.top + rect.height / 2;
+            // Calculate distance from cursor to link center
+            const distanceToLink = Math.sqrt(Math.pow(event.clientX - centerX, 2) +
+                Math.pow(event.clientY - centerY, 2));
+            // Only track intent if cursor is within proximity threshold
+            if (distanceToLink > proximityThreshold) {
+                return; // Too far away, ignore
+            }
+            const isMovingToward = tracker.update(event.clientX, event.clientY, centerX, centerY);
+            if (isMovingToward) {
+                this.prefetchRoute(href, 'intent');
+                // Remove listener after successful prefetch to avoid repeated triggers
+                document.removeEventListener('mousemove', handleMouseMove);
+            }
+        };
+        // Listen on document for global mouse movement
+        document.addEventListener('mousemove', handleMouseMove);
+        this.intentTracking.set(element, tracker);
+        // Store cleanup function
+        element.__prefetchCleanup = () => {
+            document.removeEventListener('mousemove', handleMouseMove);
+        };
+    }
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"prefetchRoute","stability":"stable","signature":"(href: string, strategy: PrefetchStrategy) => Promise<void>","description":"Prefetch a route with priority handling and deduplication"} */
+    /**
+     * Prefetch a route with priority handling
+     */
+    async prefetchRoute(href, _strategy) {
+        // Don't prefetch if already in progress
+        if (this.activeRequests.has(href)) {
+            return;
+        }
+        // Don't prefetch if we're already on this route
+        const router = globalThis.router;
+        if (router) {
+            const currentPath = router.state?.()?.path || window.location.pathname;
+            const targetPath = new URL(href, window.location.origin).pathname;
+            if (currentPath === targetPath) {
+                return;
+            }
+        }
+        // Don't prefetch if we've recently prefetched this route (within its cache TTL)
+        const lastPrefetch = this.prefetchedAt.get(href);
+        if (lastPrefetch &&
+            Date.now() - lastPrefetch.timestamp < lastPrefetch.ttl) {
+            return;
+        }
+        try {
+            const controller = new AbortController();
+            this.activeRequests.set(href, controller);
+            // Prefetch module code and loader data in parallel for faster loading
+            await Promise.all([
+                this.prefetchModuleCode(href, controller.signal),
+                this.prefetchLoaderData(href, controller.signal),
+            ]);
+            // Record successful prefetch time with route-specific TTL
+            if (!controller.signal.aborted) {
+                // Get route's cache TTL if available, otherwise use default
+                let ttl = this.config.cacheTTL;
+                const router = globalThis.router;
+                if (router?.getRouteCacheTTL) {
+                    const routeTTL = await router.getRouteCacheTTL(href);
+                    if (routeTTL !== undefined) {
+                        ttl = routeTTL;
+                    }
+                }
+                this.prefetchedAt.set(href, { timestamp: Date.now(), ttl });
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && error.name !== 'AbortError') {
+                console.warn('[Router] Prefetch failed:', error);
+            }
+        }
+        finally {
+            this.activeRequests.delete(href);
+        }
+    }
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"cancelPrefetch","stability":"stable","signature":"(href: string) => void","description":"Cancel an in-flight prefetch for a specific route"} */
+    /**
+     * Cancel prefetch for a specific route
+     */
+    cancelPrefetch(href) {
+        const controller = this.activeRequests.get(href);
+        if (controller) {
+            controller.abort();
+            this.activeRequests.delete(href);
+        }
+    }
+    /**
+     * Prefetch module code (dynamic imports)
+     */
+    async prefetchModuleCode(href, signal) {
+        if (signal.aborted)
+            return;
+        // Get the global router instance to access route manifest
+        const router = globalThis.router;
+        if (!router || !router.prefetchRoute) {
+            return; // No router or prefetch method available
+        }
+        try {
+            await router.prefetchRoute(href, signal);
+        }
+        catch {
+            // Silently fail - not critical
+        }
+    }
+    /**
+     * Prefetch loader data
+     */
+    async prefetchLoaderData(href, signal) {
+        if (signal.aborted)
+            return;
+        // Get the global router instance to access loader system
+        const router = globalThis.router;
+        if (!router || !router.prefetchLoader) {
+            return; // No router or prefetch loader method available
+        }
+        try {
+            await router.prefetchLoader(href, signal);
+        }
+        catch {
+            // Silently fail - not critical
+        }
+    }
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"dispose","stability":"stable","signature":"() => void","description":"Clean up all prefetch resources, requests, and timers"} */
+    /**
+     * Cleanup all prefetch resources
+     */
+    dispose() {
+        // Cancel all active requests
+        for (const controller of this.activeRequests.values()) {
+            controller.abort();
+        }
+        this.activeRequests.clear();
+        // Clear all timers
+        for (const timer of this.hoverTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.hoverTimers.clear();
+        // Clear intent tracking
+        this.intentTracking.clear();
+        // Clear prefetch timestamps
+        this.prefetchedAt.clear();
+        // Note: Visibility observers are cleaned up via __prefetchCleanup when elements are unregistered
+        // The shared observer pool in @pithyjs/core handles its own lifecycle
+    }
+}
+/**
+ * Pointer tracker for intent-based prefetching
+ */
+class PointerTracker {
+    constructor(velocityThreshold, sampleCount) {
+        this.positions = [];
+        this.velocityThreshold = velocityThreshold;
+        this.sampleCount = sampleCount;
+    }
+    /**
+     * Update pointer position and check if moving toward target
+     */
+    update(x, y, targetX, targetY) {
+        const now = Date.now();
+        // Add current position
+        this.positions.push({ x, y, time: now });
+        // Keep only recent samples
+        if (this.positions.length > this.sampleCount) {
+            this.positions.shift();
+        }
+        // Need at least 2 positions to calculate velocity
+        if (this.positions.length < 2) {
+            return false;
+        }
+        // Calculate velocity and direction
+        const recent = this.positions[this.positions.length - 1];
+        const previous = this.positions[this.positions.length - 2];
+        if (!recent || !previous)
+            return false;
+        const deltaTime = recent.time - previous.time;
+        if (deltaTime === 0)
+            return false;
+        const deltaX = recent.x - previous.x;
+        const deltaY = recent.y - previous.y;
+        const velocity = (Math.sqrt(deltaX * deltaX + deltaY * deltaY) / deltaTime) * 1000; // px/second
+        // Check if velocity meets threshold
+        if (velocity < this.velocityThreshold) {
+            return false;
+        }
+        // Check if moving toward target
+        const toTargetX = targetX - recent.x;
+        const toTargetY = targetY - recent.y;
+        const dotProduct = deltaX * toTargetX + deltaY * toTargetY;
+        return dotProduct > 0; // Moving toward target
+    }
+}
+/**
+ * Global prefetch manager instance (lazy-initialized to avoid TDZ issues
+ * with cross-chunk constants during bundled module evaluation).
+ */
+let globalPrefetchManager = null;
+/** @codexApi {"parent":"pithy.router.prefetch","name":"getPrefetchManager","stability":"stable","signature":"() => PrefetchManager","description":"Get the lazy-initialized global prefetch manager"} */
+/**
+ * Get the global prefetch manager
+ */
+export function getPrefetchManager() {
+    if (!globalPrefetchManager) {
+        globalPrefetchManager = new PrefetchManager();
+    }
+    return globalPrefetchManager;
+}
+//# sourceMappingURL=index.js.map

package/dist/router/features/prefetch/index.js.map

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

package/dist/router/features/ux/focus.d.ts

@@ -0,0 +1,62 @@
+/** @codex
+{
+  "id": "pithy.router.ux.focus",
+  "title": "A11y Focus Management",
+  "category": "runtime"
+}
+*/
+/**
+ * Focus management configuration
+ */
+export interface FocusConfig {
+    /** Focus selector priority (highest to lowest) */
+    focusSelectors?: string[];
+    /** Whether to manage focus automatically */
+    autoFocus?: boolean;
+    /** Fallback element for focus when no targets found */
+    focusFallback?: string;
+}
+/**
+ * Required version of focus configuration
+ */
+export type RequiredFocusConfig = Required<FocusConfig>;
+/**
+ * Focus manager for enhanced accessibility
+ */
+export declare class FocusManager {
+    private config;
+    constructor(config?: FocusConfig);
+    /**
+     * Manage focus after navigation
+     */
+    manageFocus(options?: {
+        preventScroll?: boolean;
+    }): void;
+    /**
+     * Ensure element is programmatically focusable
+     */
+    private ensureFocusable;
+    /**
+     * Check if element is visible
+     */
+    private isVisible;
+    /**
+     * Check if user is currently focused on an interactive element
+     * Prevents focus stealing during navigation
+     */
+    private isUserOnInteractiveElement;
+    /**
+     * Update focus configuration
+     */
+    updateConfig(config: Partial<FocusConfig>): void;
+}
+/**
+ * Global focus manager instance
+ */
+export declare const focusManager: FocusManager;
+/** @codexApi {"parent":"pithy.router.ux.focus","name":"useFocus","stability":"stable","signature":"(config?: FocusConfig) => FocusManager"} */
+/**
+ * Focus utilities
+ */
+export declare function useFocus(config?: FocusConfig): FocusManager;
+//# sourceMappingURL=focus.d.ts.map

package/dist/router/features/ux/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../../../src/router/features/ux/focus.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;AAExD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,GAAE,WAAgB;IAgBpC;;OAEG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAqCxD;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAmClC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;CAGjD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C,+IAA+I;AAC/I;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY,CAK3D"}

package/dist/router/features/ux/focus.js

@@ -0,0 +1,136 @@
+/** @codex
+{
+  "id": "pithy.router.ux.focus",
+  "title": "A11y Focus Management",
+  "category": "runtime"
+}
+*/
+/**
+ * Focus manager for enhanced accessibility
+ */
+export class FocusManager {
+    constructor(config = {}) {
+        this.config = {
+            focusSelectors: [
+                '[data-focus-target]',
+                '[autofocus]',
+                '[tabindex]',
+                'h1',
+                '[role=heading]',
+                'main',
+            ],
+            autoFocus: true,
+            focusFallback: '[data-router-outlet]',
+            ...config,
+        };
+    }
+    /**
+     * Manage focus after navigation
+     */
+    manageFocus(options) {
+        if (!this.config.autoFocus)
+            return;
+        // Don't steal focus if user is already on an interactive element
+        if (this.isUserOnInteractiveElement()) {
+            return;
+        }
+        // Find the best focus target
+        let target = null;
+        for (const selector of this.config.focusSelectors) {
+            target = document.querySelector(selector);
+            if (target && this.isVisible(target)) {
+                break;
+            }
+        }
+        // Focus the target if found
+        if (target) {
+            const el = this.ensureFocusable(target);
+            const focusOptions = { preventScroll: true, ...(options ?? {}) };
+            el.focus(focusOptions);
+            return;
+        }
+        // Fallback to outlet if no targets found
+        if (!target) {
+            const outlet = document.querySelector(this.config.focusFallback);
+            if (outlet) {
+                const el = this.ensureFocusable(outlet);
+                el.focus({ preventScroll: true });
+                return;
+            }
+        }
+    }
+    /**
+     * Ensure element is programmatically focusable
+     */
+    ensureFocusable(el) {
+        const node = el;
+        const isNaturallyFocusable = typeof node.focus === 'function' && node.tabIndex >= 0;
+        if (!isNaturallyFocusable && !node.hasAttribute('tabindex')) {
+            node.setAttribute('tabindex', '-1');
+            node.setAttribute('data-router-tmp-tabindex', '');
+        }
+        return node;
+    }
+    /**
+     * Check if element is visible
+     */
+    isVisible(element) {
+        const rect = element.getBoundingClientRect();
+        return (rect.width > 0 &&
+            rect.height > 0 &&
+            rect.top < window.innerHeight &&
+            rect.bottom > 0);
+    }
+    /**
+     * Check if user is currently focused on an interactive element
+     * Prevents focus stealing during navigation
+     */
+    isUserOnInteractiveElement() {
+        const activeEl = document.activeElement;
+        if (!activeEl || activeEl === document.body) {
+            return false;
+        }
+        // Check if the active element is an interactive element
+        const tagName = activeEl.tagName.toLowerCase();
+        const interactiveTags = ['input', 'textarea', 'select', 'button', 'a'];
+        // Check tag name
+        if (interactiveTags.includes(tagName)) {
+            return true;
+        }
+        // Check if element has tabindex (is focusable)
+        if (activeEl.hasAttribute('tabindex')) {
+            const tabindex = activeEl.getAttribute('tabindex');
+            // tabindex >= 0 means it's in the tab order (interactive)
+            if (tabindex !== null && parseInt(tabindex, 10) >= 0) {
+                return true;
+            }
+        }
+        // Check for contenteditable
+        if (activeEl.hasAttribute('contenteditable') &&
+            activeEl.getAttribute('contenteditable') !== 'false') {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Update focus configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+/**
+ * Global focus manager instance
+ */
+export const focusManager = new FocusManager();
+/** @codexApi {"parent":"pithy.router.ux.focus","name":"useFocus","stability":"stable","signature":"(config?: FocusConfig) => FocusManager"} */
+/**
+ * Focus utilities
+ */
+export function useFocus(config) {
+    if (config) {
+        focusManager.updateConfig(config);
+    }
+    return focusManager;
+}
+//# sourceMappingURL=focus.js.map

package/dist/router/features/ux/focus.js.map

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

package/dist/router/features/ux/live-region.d.ts

@@ -0,0 +1,81 @@
+/** @codex
+{
+  "id": "pithy.router.ux.live-region",
+  "title": "ARIA Live Region Announcements",
+  "category": "runtime"
+}
+*/
+/**
+ * Live region configuration
+ */
+export interface LiveRegionConfig {
+    /** Enable accessibility announcements (default: true) */
+    enabled?: boolean;
+    /** Whether to announce route changes (default: true) */
+    announceChanges?: boolean;
+    /** Politeness level for announcements */
+    politeness?: 'polite' | 'assertive';
+    /** Duration to keep announcement visible (ms) */
+    clearDelay?: number;
+}
+/**
+ * Required version of live region configuration
+ */
+export type RequiredLiveRegionConfig = Required<LiveRegionConfig>;
+/**
+ * Live region manager for screen reader announcements
+ */
+export declare class LiveRegionManager {
+    private announcer;
+    private config;
+    constructor(config?: LiveRegionConfig);
+    /**
+     * Announce route change for screen readers
+     */
+    announceRouteChange(path?: string): void;
+    /**
+     * Announce custom message
+     */
+    announce(message: string, options?: {
+        clearDelay?: number;
+    }): void;
+    /**
+     * Announce loading state
+     */
+    announceLoading(message?: string): void;
+    /**
+     * Announce navigation error
+     */
+    announceError(message: string): void;
+    /**
+     * Announce guard denial
+     */
+    announceGuardDenied(message?: string): void;
+    /**
+     * Setup screen reader announcer element
+     */
+    private setupAnnouncer;
+    /**
+     * Update live region configuration
+     */
+    updateConfig(config: Partial<LiveRegionConfig>): void;
+    /**
+     * Destroy announcer element
+     */
+    destroy(): void;
+}
+/**
+ * Global live region manager instance
+ */
+export declare const liveRegionManager: LiveRegionManager;
+/** @codexApi {"parent":"pithy.router.ux.live-region","name":"useLiveRegion","stability":"stable","signature":"(config?: LiveRegionConfig) => LiveRegionManager"} */
+/**
+ * Live region utilities
+ */
+export declare function useLiveRegion(config?: LiveRegionConfig): LiveRegionManager;
+/** @codexApi {"parent":"pithy.router.ux.live-region","name":"announce","stability":"stable","signature":"(message: string) => void"} */
+/**
+ * Announce navigation change
+ */
+export declare function announce(message: string): void;
+//# sourceMappingURL=live-region.d.ts.map

package/dist/router/features/ux/live-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-region.d.ts","sourceRoot":"","sources":["../../../../src/router/features/ux/live-region.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAIF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yCAAyC;IACzC,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IACpC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AAElE;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,GAAE,gBAAqB;IAezC;;OAEG;IACH,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBxC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAclE;;OAEG;IACH,eAAe,CAAC,OAAO,GAAE,MAAqB,GAAG,IAAI;IAKrD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAYpC;;OAEG;IACH,mBAAmB,CAAC,OAAO,GAAE,MAA6B,GAAG,IAAI;IAYjE;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IA0BrD;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAEzD,oKAAoK;AACpK;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAK1E;AAED,wIAAwI;AACxI;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9C"}