@liteforge/router 0.1.0

package/dist/guards.js

@@ -0,0 +1,268 @@
+import { emitGuardRun } from '@liteforge/core';
+// =============================================================================
+// Guard Definition
+// =============================================================================
+/**
+ * Define a named route guard
+ *
+ * @example
+ * ```ts
+ * const authGuard = defineGuard('auth', ({ to, from, use }) => {
+ *   const auth = use('auth');
+ *   if (!auth.isAuthenticated()) {
+ *     return `/login?redirect=${encodeURIComponent(to.path)}`;
+ *   }
+ *   return true;
+ * });
+ *
+ * // Parameterized guard
+ * const roleGuard = defineGuard('role', ({ use, param }) => {
+ *   return use('auth').hasRole(param) || '/unauthorized';
+ * });
+ * ```
+ */
+export function defineGuard(name, handler) {
+    return { name, handler };
+}
+// =============================================================================
+// Guard Registry
+// =============================================================================
+/**
+ * Guard registry for managing named guards
+ */
+export class GuardRegistry {
+    constructor() {
+        this.guards = new Map();
+    }
+    /**
+     * Register a guard
+     */
+    register(guard) {
+        if (this.guards.has(guard.name)) {
+            console.warn(`Guard "${guard.name}" is being overwritten`);
+        }
+        this.guards.set(guard.name, guard);
+    }
+    /**
+     * Register multiple guards
+     */
+    registerAll(guards) {
+        for (const guard of guards) {
+            this.register(guard);
+        }
+    }
+    /**
+     * Get a guard by name
+     */
+    get(name) {
+        return this.guards.get(name);
+    }
+    /**
+     * Check if a guard exists
+     */
+    has(name) {
+        return this.guards.has(name);
+    }
+    /**
+     * Unregister a guard
+     */
+    unregister(name) {
+        return this.guards.delete(name);
+    }
+    /**
+     * Get all guard names
+     */
+    names() {
+        return Array.from(this.guards.keys());
+    }
+    /**
+     * Clear all guards
+     */
+    clear() {
+        this.guards.clear();
+    }
+    /**
+     * Get the internal map (for route compilation)
+     */
+    getMap() {
+        return this.guards;
+    }
+}
+// =============================================================================
+// Guard Execution
+// =============================================================================
+/**
+ * Execute a single guard and normalize the result
+ */
+async function executeGuard(guard, context) {
+    const startTime = performance.now();
+    try {
+        const result = await guard.handler(context);
+        const normalized = normalizeGuardResult(result);
+        const duration = performance.now() - startTime;
+        // Emit guard run event (zero cost if debug not enabled)
+        emitGuardRun(guard.name, context.to.path, normalized.allowed, duration);
+        return normalized;
+    }
+    catch (error) {
+        const duration = performance.now() - startTime;
+        // Emit guard run event with failure (zero cost if debug not enabled)
+        emitGuardRun(guard.name, context.to.path, false, duration);
+        console.error(`Guard "${guard.name}" threw an error:`, error);
+        // Treat errors as blocking navigation
+        return { allowed: false };
+    }
+}
+/**
+ * Normalize guard result to a consistent format
+ */
+export function normalizeGuardResult(result) {
+    if (result === true) {
+        return { allowed: true };
+    }
+    if (result === false) {
+        return { allowed: false };
+    }
+    // String or NavigationTarget - redirect
+    return { allowed: false, redirect: result };
+}
+/**
+ * Run all guards for a route match
+ * Guards are run in order; first failing guard stops execution
+ */
+export async function runGuards(guards, context) {
+    for (const guard of guards) {
+        const result = await executeGuard(guard, context);
+        if (!result.allowed) {
+            return result;
+        }
+    }
+    return { allowed: true };
+}
+/**
+ * Resolve guards from guard specification using the registry
+ * This is called at navigation time to support dynamic guard registration
+ */
+export function resolveGuardsFromSpec(guardSpec, registry) {
+    if (!guardSpec)
+        return [];
+    const guards = [];
+    const guardList = Array.isArray(guardSpec) ? guardSpec : [guardSpec];
+    for (const g of guardList) {
+        if (typeof g === 'string') {
+            // Parse parameterized guard (e.g., 'role:admin')
+            const colonIndex = g.indexOf(':');
+            const guardName = colonIndex >= 0 ? g.slice(0, colonIndex) : g;
+            const param = colonIndex >= 0 ? g.slice(colonIndex + 1) : undefined;
+            const registered = registry.get(guardName);
+            if (registered) {
+                // Create a wrapper that passes the param
+                if (param !== undefined) {
+                    guards.push({
+                        name: g,
+                        handler: (ctx) => registered.handler({ ...ctx, param }),
+                    });
+                }
+                else {
+                    guards.push(registered);
+                }
+            }
+            // If guard not found, skip it (allows dynamic registration)
+        }
+        else {
+            // Direct guard object
+            guards.push(g);
+        }
+    }
+    return guards;
+}
+/**
+ * Collect all guards for a matched route chain
+ * (including parent route guards for nested routes)
+ * Resolves string guards from the registry at runtime
+ */
+export function collectRouteGuards(route, registry) {
+    const guards = [];
+    // Walk up the parent chain and collect guards (parents first)
+    let current = route;
+    const chain = [];
+    while (current) {
+        chain.unshift(current);
+        current = current.parent;
+    }
+    // Add guards from each route in the chain
+    for (const r of chain) {
+        // First add inline guards (RouteGuard objects defined directly)
+        guards.push(...r.guards);
+        // Then resolve string guards from the registry (if registry provided)
+        if (registry && r.guardSpec) {
+            const resolvedGuards = resolveGuardsFromSpec(r.guardSpec, registry);
+            // Filter out guards that are already in the inline guards (by reference comparison)
+            // and filter out object guards since those are already in r.guards
+            for (const g of resolvedGuards) {
+                // Only add if it's not already present (comparing by name for string-resolved guards)
+                if (!r.guards.some(existing => existing === g || existing.name === g.name)) {
+                    guards.push(g);
+                }
+            }
+        }
+    }
+    return guards;
+}
+// =============================================================================
+// Built-in Guards
+// =============================================================================
+/**
+ * Create a simple authentication guard
+ */
+export function createAuthGuard(isAuthenticated, loginPath = '/login') {
+    return defineGuard('auth', ({ to }) => {
+        if (isAuthenticated()) {
+            return true;
+        }
+        // Redirect to login with return URL
+        const redirectTo = encodeURIComponent(to.path + to.search);
+        return `${loginPath}?redirect=${redirectTo}`;
+    });
+}
+/**
+ * Create a role-based guard
+ * Usage: guard: 'role:admin' or guard: 'role:editor'
+ */
+export function createRoleGuard(hasRole, unauthorizedPath = '/unauthorized') {
+    return defineGuard('role', ({ param }) => {
+        if (!param) {
+            console.warn('Role guard requires a role parameter (e.g., "role:admin")');
+            return false;
+        }
+        return hasRole(param) || unauthorizedPath;
+    });
+}
+/**
+ * Create a confirmation guard that can be used for unsaved changes
+ */
+export function createConfirmGuard(shouldConfirm, message = 'You have unsaved changes. Are you sure you want to leave?') {
+    return defineGuard('confirm', () => {
+        if (!shouldConfirm()) {
+            return true;
+        }
+        // In browser environment, use confirm dialog
+        if (typeof window !== 'undefined' && window.confirm) {
+            return window.confirm(message);
+        }
+        // In non-browser environment, allow navigation
+        return true;
+    });
+}
+/**
+ * Create a guest-only guard (redirects authenticated users)
+ */
+export function createGuestGuard(isAuthenticated, homePath = '/') {
+    return defineGuard('guest', () => {
+        if (!isAuthenticated()) {
+            return true;
+        }
+        return homePath;
+    });
+}
+//# sourceMappingURL=guards.js.map

package/dist/guards.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,33 @@
+import type { History, NavigationTarget } from './types.js';
+/**
+ * Convert NavigationTarget to a href string
+ */
+export declare function targetToHref(target: NavigationTarget, base?: string): string;
+export interface MemoryHistoryOptions {
+    /** Initial entries (defaults to ['/']) */
+    initialEntries?: string[];
+    /** Initial index (defaults to last entry) */
+    initialIndex?: number;
+}
+/**
+ * Create a memory-based history for testing and SSR
+ */
+export declare function createMemoryHistory(options?: MemoryHistoryOptions): History;
+export interface BrowserHistoryOptions {
+    /** Base path for all routes (e.g., '/app') */
+    base?: string;
+}
+/**
+ * Create a browser-based history using the History API
+ */
+export declare function createBrowserHistory(options?: BrowserHistoryOptions): History;
+export interface HashHistoryOptions {
+    /** Hash prefix (defaults to '#') */
+    hashPrefix?: string;
+}
+/**
+ * Create a hash-based history using the URL hash
+ * Useful for environments where you can't configure the server
+ */
+export declare function createHashHistory(options?: HashHistoryOptions): History;
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAIP,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAcpB;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,CAkBhF;AAMD,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CA2I/E;AAQD,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAoGjF;AAMD,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAiG3E"}

package/dist/history.js

@@ -0,0 +1,315 @@
+import { createLocation, normalizePath, stringifyQuery } from './route-matcher.js';
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Generate a unique key for history entries
+ */
+function createKey() {
+    return Math.random().toString(36).substring(2, 10);
+}
+/**
+ * Convert NavigationTarget to a href string
+ */
+export function targetToHref(target, base = '') {
+    if (typeof target === 'string') {
+        // If already absolute, return as is
+        if (target.startsWith('/')) {
+            return target;
+        }
+        // Relative path - join with base
+        return normalizePath(base + '/' + target);
+    }
+    let href = target.path;
+    if (target.query && Object.keys(target.query).length > 0) {
+        href += '?' + stringifyQuery(target.query);
+    }
+    if (target.hash) {
+        href += '#' + target.hash;
+    }
+    return href;
+}
+/**
+ * Create a memory-based history for testing and SSR
+ */
+export function createMemoryHistory(options = {}) {
+    const { initialEntries = ['/'], initialIndex } = options;
+    // Initialize entries
+    const entries = initialEntries.map((path) => {
+        const questionIndex = path.indexOf('?');
+        const hashIndex = path.indexOf('#');
+        let pathname = path;
+        let search = '';
+        let hash = '';
+        if (hashIndex >= 0) {
+            hash = path.slice(hashIndex + 1);
+            pathname = path.slice(0, hashIndex);
+        }
+        if (questionIndex >= 0 && (hashIndex < 0 || questionIndex < hashIndex)) {
+            const searchEnd = hashIndex >= 0 ? hashIndex : path.length;
+            search = path.slice(questionIndex + 1, searchEnd);
+            pathname = path.slice(0, questionIndex);
+        }
+        return {
+            path: normalizePath(pathname),
+            search,
+            hash,
+            state: null,
+            key: createKey(),
+        };
+    });
+    // Current index in the history stack
+    let index = initialIndex ?? entries.length - 1;
+    // Listeners for location changes
+    const listeners = new Set();
+    // Get current location from entry
+    function getLocation() {
+        const entry = entries[index];
+        let href = entry.path;
+        if (entry.search)
+            href += '?' + entry.search;
+        if (entry.hash)
+            href += '#' + entry.hash;
+        return createLocation(href, entry.state);
+    }
+    // Notify all listeners
+    function notifyListeners(action) {
+        const location = getLocation();
+        for (const listener of listeners) {
+            listener(location, action);
+        }
+    }
+    // Parse target into entry components
+    function parseTarget(target) {
+        const location = createLocation(target);
+        return {
+            path: location.path,
+            search: location.search,
+            hash: location.hash,
+            state: location.state,
+        };
+    }
+    const history = {
+        get location() {
+            return getLocation();
+        },
+        push(target) {
+            const parsed = parseTarget(target);
+            const entry = {
+                ...parsed,
+                key: createKey(),
+            };
+            // Remove any forward entries
+            entries.splice(index + 1);
+            // Add new entry
+            entries.push(entry);
+            index = entries.length - 1;
+            notifyListeners('push');
+        },
+        replace(target) {
+            const parsed = parseTarget(target);
+            const entry = {
+                ...parsed,
+                key: createKey(),
+            };
+            // Replace current entry
+            entries[index] = entry;
+            notifyListeners('replace');
+        },
+        back() {
+            this.go(-1);
+        },
+        forward() {
+            this.go(1);
+        },
+        go(delta) {
+            const newIndex = index + delta;
+            // Bounds check
+            if (newIndex < 0 || newIndex >= entries.length) {
+                return;
+            }
+            index = newIndex;
+            notifyListeners('pop');
+        },
+        listen(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        createHref(target) {
+            return targetToHref(target);
+        },
+        destroy() {
+            listeners.clear();
+        },
+    };
+    return history;
+}
+/**
+ * Create a browser-based history using the History API
+ */
+export function createBrowserHistory(options = {}) {
+    const { base = '' } = options;
+    const normalizedBase = base ? normalizePath(base) : '';
+    // Listeners for location changes
+    const listeners = new Set();
+    // Get current location from window.location
+    function getLocation() {
+        let path = window.location.pathname;
+        // Remove base from path
+        if (normalizedBase && path.startsWith(normalizedBase)) {
+            path = path.slice(normalizedBase.length) || '/';
+        }
+        const href = path + window.location.search + window.location.hash;
+        return createLocation(href, window.history.state);
+    }
+    // Notify all listeners
+    function notifyListeners(action) {
+        const location = getLocation();
+        for (const listener of listeners) {
+            listener(location, action);
+        }
+    }
+    // Handle popstate events (back/forward navigation)
+    function handlePopState() {
+        notifyListeners('pop');
+    }
+    // Add popstate listener
+    window.addEventListener('popstate', handlePopState);
+    // Build full URL with base
+    function buildUrl(target) {
+        const href = targetToHref(target);
+        if (normalizedBase) {
+            // Don't double-add base
+            if (href.startsWith(normalizedBase)) {
+                return href;
+            }
+            return normalizedBase + (href.startsWith('/') ? href : '/' + href);
+        }
+        return href;
+    }
+    const history = {
+        get location() {
+            return getLocation();
+        },
+        push(target) {
+            const url = buildUrl(target);
+            const state = typeof target === 'object' ? target.state : undefined;
+            window.history.pushState(state ?? null, '', url);
+            notifyListeners('push');
+        },
+        replace(target) {
+            const url = buildUrl(target);
+            const state = typeof target === 'object' ? target.state : undefined;
+            window.history.replaceState(state ?? null, '', url);
+            notifyListeners('replace');
+        },
+        back() {
+            window.history.back();
+        },
+        forward() {
+            window.history.forward();
+        },
+        go(delta) {
+            window.history.go(delta);
+        },
+        listen(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        createHref(target) {
+            return buildUrl(target);
+        },
+        destroy() {
+            window.removeEventListener('popstate', handlePopState);
+            listeners.clear();
+        },
+    };
+    return history;
+}
+/**
+ * Create a hash-based history using the URL hash
+ * Useful for environments where you can't configure the server
+ */
+export function createHashHistory(options = {}) {
+    const { hashPrefix = '#' } = options;
+    // Listeners for location changes
+    const listeners = new Set();
+    // Get current location from hash
+    function getLocation() {
+        let hash = window.location.hash;
+        // Remove hash prefix
+        if (hash.startsWith(hashPrefix)) {
+            hash = hash.slice(hashPrefix.length);
+        }
+        // Ensure leading slash
+        if (!hash.startsWith('/')) {
+            hash = '/' + hash;
+        }
+        return createLocation(hash, window.history.state);
+    }
+    // Notify all listeners
+    function notifyListeners(action) {
+        const location = getLocation();
+        for (const listener of listeners) {
+            listener(location, action);
+        }
+    }
+    // Handle hashchange events
+    function handleHashChange() {
+        notifyListeners('pop');
+    }
+    // Add hashchange listener
+    window.addEventListener('hashchange', handleHashChange);
+    // Build hash URL
+    function buildHashUrl(target) {
+        const href = targetToHref(target);
+        return hashPrefix + href;
+    }
+    const history = {
+        get location() {
+            return getLocation();
+        },
+        push(target) {
+            const url = buildHashUrl(target);
+            const state = typeof target === 'object' ? target.state : undefined;
+            // Use pushState to enable state while still using hash
+            window.history.pushState(state ?? null, '', url);
+            notifyListeners('push');
+        },
+        replace(target) {
+            const url = buildHashUrl(target);
+            const state = typeof target === 'object' ? target.state : undefined;
+            window.history.replaceState(state ?? null, '', url);
+            notifyListeners('replace');
+        },
+        back() {
+            window.history.back();
+        },
+        forward() {
+            window.history.forward();
+        },
+        go(delta) {
+            window.history.go(delta);
+        },
+        listen(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        createHref(target) {
+            return buildHashUrl(target);
+        },
+        destroy() {
+            window.removeEventListener('hashchange', handleHashChange);
+            listeners.clear();
+        },
+    };
+    return history;
+}
+/* v8 ignore stop */
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export type { Location, QueryParams, RouteParams, NavigationTarget, RouteDefinition, RouteComponent, LazyComponent, LazyImportFn, RouteLazyConfig, RouteMeta, CompiledRoute, MatchedRoute, RouteMatch, GuardContext, GuardResult, GuardFunction, RouteGuard, MiddlewareContext, MiddlewareFunction, RouteMiddleware, PreloadContext, PreloadFunction, TransitionContext, TransitionHooks, History, HistoryEntry, HistoryListener, RouterOptions, NavigateOptions, Router, ScrollBehavior, LazyDefaults, LinkProps, RouterOutletProps, ExtractParams, TypedParams, } from './types.js';
+export { parsePath, parseQuery, stringifyQuery, createLocation, normalizePath, joinPaths, compilePath, compileRoute, compileRoutes, matchRoute, matchRoutes, findRouteByName, generatePath, isPathActive, flattenRoutes, } from './route-matcher.js';
+export { createMemoryHistory, createBrowserHistory, createHashHistory, targetToHref, } from './history.js';
+export type { MemoryHistoryOptions, BrowserHistoryOptions, HashHistoryOptions, } from './history.js';
+export { defineGuard, GuardRegistry, runGuards, collectRouteGuards, normalizeGuardResult, createAuthGuard, createRoleGuard, createConfirmGuard, createGuestGuard, } from './guards.js';
+export { defineMiddleware, composeMiddleware, runMiddleware, createLoggerMiddleware, createScrollMiddleware, createTitleMiddleware, createAnalyticsMiddleware, createLoadingMiddleware, } from './middleware.js';
+export { createRouter, setActiveRouter, getActiveRouter, getActiveRouterOrNull, } from './router.js';
+export type { RouterInternal } from './router.js';
+export { RouterOutlet, Link, NavLink } from './components.js';
+export type { RouterOutletConfig, LinkConfig } from './components.js';
+export { lazy, prefetchAll, isLazyComponent, getLazyDelay, getLazyLoading, getLazyError, createPreloadOnHover, createPreloadOnVisible, resolveModuleExport, isWrappedLazyComponent, detectInlineLazyImport, wrapInlineLazy, processRouteComponent, } from './lazy.js';
+export type { LazyOptions, LazyComponentWithMethods } from './lazy.js';
+export type { CompileRouteOptions } from './route-matcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAEV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,gBAAgB,EAGhB,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,SAAS,EACT,aAAa,EACb,YAAY,EACZ,UAAU,EAGV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EAGV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EAGf,cAAc,EACd,eAAe,EAGf,iBAAiB,EACjB,eAAe,EAGf,OAAO,EACP,YAAY,EACZ,eAAe,EAGf,aAAa,EACb,eAAe,EACf,MAAM,EACN,cAAc,EACd,YAAY,EAGZ,SAAS,EACT,iBAAiB,EAGjB,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AAMpB,OAAO,EAEL,SAAS,EACT,UAAU,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,SAAS,EAGT,WAAW,EACX,YAAY,EACZ,aAAa,EAGb,UAAU,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EAGpB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAGb,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE9D,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMtE,OAAO,EACL,IAAI,EACJ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EAEtB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAEvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}