@relax.js/core 1.0.0

package/dist/routing/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/routing/types.ts", "../../src/routing/NavigateRouteEvent.ts", "../../src/errors.ts", "../../src/routing/routeTargetRegistry.ts", "../../src/routing/routeMatching.ts", "../../src/routing/RouteLink.ts", "../../src/routing/RoutingTarget.ts", "../../src/routing/navigation.ts"],
+  "sourcesContent": ["type WebComponentConstructor = new (...args: any[]) => HTMLElement;\r\n\r\nexport enum GuardResult {\r\n    /**\r\n     * Handle route without checking more guards.\r\n     */\r\n    Allow,\r\n\r\n    /**\r\n     * Throw a RouteGuardError.\r\n     */\r\n    Deny,\r\n\r\n    /**\r\n     * Resume and check other guards.\r\n     */\r\n    Continue,\r\n\r\n    /**\r\n     * Do not invoke the rooute nor other guards.\r\n     */\r\n    Stop\r\n}\r\n\r\nexport interface RouteGuard {\r\n    check(route: RouteMatchResult): GuardResult;\r\n}\r\n\r\nexport interface Route {\r\n    name?: string;\r\n    target?: string;\r\n    path: string;\r\n\r\n    /**\r\n     * HTML file name (without extension).\r\n     *\r\n     * Define for instance if you have a route that requires a more limited layout. The library\r\n     * will automatically load that HTML file and rewrite URL history so that the correct url is displayed.\r\n     */\r\n    layout?: string;\r\n\r\n    /**\r\n     * Name of the tag for your web component.\r\n     */\r\n    componentTagName?: string;\r\n\r\n    /**\r\n     * Guards used to check if this route can be visited.\r\n     */\r\n    guards?: RouteGuard[];\r\n\r\n    component?: WebComponentConstructor;\r\n}\r\n\r\nexport type RouteParamType = string | number;\r\nexport type RouteData = Record<string, RouteParamType>;\r\n\r\n/**\r\n * Implement to receive typed route parameters via a `routeData` property.\r\n * RouteTarget assigns `routeData` after element creation but before DOM insertion.\r\n * Optional since it's not available at construction time.\r\n *\r\n * For convention-based usage without undefined checks, skip the interface\r\n * and declare `routeData` directly on your component.\r\n *\r\n * @example\r\n * class UserProfile extends HTMLElement implements Routable<{ userName: string }> {\r\n *     routeData?: { userName: string };\r\n * }\r\n */\r\nexport interface Routable<T extends RouteData = RouteData> {\r\n    routeData?: T;\r\n}\r\n\r\n/**\r\n * Implement to run async initialization before the component is added to the DOM.\r\n * RouteTarget calls `loadRoute()` and awaits it before inserting the element.\r\n *\r\n * @example\r\n * class OrderDetail extends HTMLElement implements LoadRoute<{ orderId: number }> {\r\n *     async loadRoute(data: { orderId: number }) {\r\n *         this.order = await fetchOrder(data.orderId);\r\n *     }\r\n * }\r\n */\r\nexport interface LoadRoute<T extends RouteData = RouteData> {\r\n    loadRoute(data: T): void | Promise<void>;\r\n}\r\n\r\n/**\r\n * Result from route matching operations.\r\n * Contains all information needed for navigation and rendering.\r\n */\r\nexport type RouteMatchResult = {\r\n    /**\r\n     * Matched route configuration\r\n     */\r\n    route: Route;\r\n\r\n    /**\r\n     * URL segments used for history state\r\n     */\r\n    urlSegments: string[];\r\n\r\n    /**\r\n     * Extracted and type-converted parameters\r\n     */\r\n    params: RouteData;\r\n};\r\n\r\n/**\r\n * Supported types of route segments\r\n */\r\nexport type RouteSegmentType = 'string' | 'number' | 'path' | 'regex';\r\n\r\n/**\r\n * Strongly typed route segment value\r\n */\r\nexport interface RouteValue {\r\n    /**\r\n     * Type of parameter for validation\r\n     */\r\n    type: RouteSegmentType;\r\n\r\n    /**\r\n     * Actual parameter value\r\n     */\r\n    value: any;\r\n}\r\n\r\nexport class RouteError extends Error {}\r\nexport class RouteGuardError extends RouteError {\r\n    isGuard;\r\n}\r\n\r\nexport interface NavigateOptions {\r\n    /**\r\n     * Optional parameters when using route name\r\n     */\r\n    params?: Record<string, string | number>;\r\n\r\n    /**\r\n     * override for route's default target\r\n     */\r\n    target?: string;\r\n\r\n    /**\r\n     * When you want to override routes from the globally registered ones.\r\n     */\r\n    routes?: Route[];\r\n}\r\n", "import type { Route, RouteData } from './types';\r\n\r\n/**\r\n * Event sent to routing targets when a new route should be displayed.\r\n */\r\nexport class NavigateRouteEvent extends Event {\r\n    static NAME: string = 'rlx.navigateRoute';\r\n    constructor(\r\n        /**\r\n         * Matched route.\r\n         */\r\n        public route: Route,\r\n\r\n        /**\r\n         * The generated url sements which can be used to push the url into the browser history.\r\n         */\r\n        public urlSegments: string[],\r\n\r\n        /**\r\n         * Data supplied to the route.\r\n         */\r\n        public routeData?: RouteData,\r\n\r\n        /**\r\n         * The target can differ from the default target that is defined in the route.\r\n         *\r\n         * undefined means that the default (unnamed) target should be used.\r\n         */\r\n        public routeTarget?: string,\r\n\r\n        eventInit?: EventInit\r\n    ) {\r\n        super(NavigateRouteEvent.NAME, eventInit);\r\n    }\r\n}\r\n\r\ndeclare global {\r\n    interface HTMLElementEventMap {\r\n        'rlx.navigateRoute': NavigateRouteEvent;\r\n    }\r\n    interface DocumentEventMap {\r\n        'rlx.navigateRoute': NavigateRouteEvent;\r\n    }\r\n}\r\n", "/**\r\n * Global error handling for Relaxjs.\r\n * Register a handler with `onError()` to intercept errors before they throw.\r\n * Call `ctx.suppress()` in the handler to prevent the error from being thrown.\r\n *\r\n * @example\r\n * import { onError } from 'relaxjs';\r\n *\r\n * onError((error, ctx) => {\r\n *     logToService(error.message, error.context);\r\n *     showToast(error.message);\r\n *     ctx.suppress();\r\n * });\r\n */\r\n\r\n/**\r\n * Passed to error handlers to control error behavior.\r\n * Call `suppress()` to prevent the error from being thrown.\r\n */\r\nexport interface ErrorContext {\r\n    suppress(): void;\r\n}\r\n\r\n/**\r\n * Error with structured context for debugging.\r\n * The `context` record contains details like route name, component tag, route data.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     console.log(error.context.route);\r\n *     console.log(error.context.componentTagName);\r\n * });\r\n */\r\nexport class RelaxError extends Error {\r\n    constructor(\r\n        message: string,\r\n        public context: Record<string, unknown>,\r\n    ) {\r\n        super(message);\r\n    }\r\n}\r\n\r\ntype ErrorHandler = (error: RelaxError, ctx: ErrorContext) => void;\r\n\r\nlet handler: ErrorHandler | null = null;\r\n\r\n/**\r\n * Registers a global error handler for Relaxjs errors.\r\n * The handler receives the error and an `ErrorContext`.\r\n * Call `ctx.suppress()` to prevent the error from being thrown.\r\n * Only one handler can be active at a time; subsequent calls replace the previous handler.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     if (error.context.route === 'optional-panel') {\r\n *         ctx.suppress();\r\n *         return;\r\n *     }\r\n *     showErrorDialog(error.message);\r\n * });\r\n */\r\nexport function onError(fn: ErrorHandler) {\r\n    handler = fn;\r\n}\r\n\r\n/**\r\n * Reports an error through the global handler.\r\n * Returns the `RelaxError` if it should be thrown, or `null` if the handler suppressed it.\r\n * The caller is responsible for throwing the returned error.\r\n *\r\n * @param message - Human-readable error description\r\n * @param context - Structured data for debugging (route, component, params, cause, etc.)\r\n * @returns The error to throw, or `null` if suppressed\r\n *\r\n * @example\r\n * const error = reportError('Failed to load route component', {\r\n *     route: 'user',\r\n *     componentTagName: 'user-profile',\r\n *     routeData: { id: 123 },\r\n * });\r\n * if (error) throw error;\r\n */\r\nexport function reportError(message: string, context: Record<string, unknown>): RelaxError | null {\r\n    const error = new RelaxError(message, context);\r\n    if (handler) {\r\n        let suppressed = false;\r\n        const ctx: ErrorContext = {\r\n            suppress() { suppressed = true; },\r\n        };\r\n        handler(error, ctx);\r\n        if (suppressed) {\r\n            return null;\r\n        }\r\n    }\r\n    return error;\r\n}\r\n", "import { reportError } from '../errors';\r\nimport { NavigateRouteEvent } from './NavigateRouteEvent';\r\n\r\ntype RouteTargetHandler = (evt: NavigateRouteEvent) => void;\r\nconst targetHandlers = new Map<string | undefined, RouteTargetHandler>();\r\nconst pendingEvents = new Map<string | undefined, NavigateRouteEvent>();\r\n\r\n/**\r\n * Registers a route target handler.\r\n * When a navigation event targets this name, the handler is called directly.\r\n * If a pending event exists for this target, it is replayed immediately.\r\n *\r\n * @param name - Target name, or `undefined` for the default (unnamed) target\r\n * @param handler - Callback that receives the `NavigateRouteEvent`\r\n *\r\n * @example\r\n * registerRouteTarget('sidebar', (evt) => renderComponent(evt));\r\n */\r\nexport function registerRouteTarget(\r\n    name: string | undefined,\r\n    handler: RouteTargetHandler,\r\n) {\r\n    initRouteTargetListener();\r\n    if (targetHandlers.has(name)) {\r\n        const error = reportError('Duplicate route target', {\r\n            target: name ?? 'default',\r\n        });\r\n        if (error) throw error;\r\n        return;\r\n    }\r\n    targetHandlers.set(name, handler);\r\n\r\n    const pending = pendingEvents.get(name);\r\n    if (pending) {\r\n        pendingEvents.delete(name);\r\n        handler(pending);\r\n    }\r\n}\r\n\r\n/**\r\n * Unregisters a previously registered route target handler.\r\n *\r\n * @param name - Target name that was passed to `registerRouteTarget`\r\n */\r\nexport function unregisterRouteTarget(name: string | undefined) {\r\n    targetHandlers.delete(name);\r\n}\r\n\r\nexport function clearPendingNavigations() {\r\n    pendingEvents.clear();\r\n    targetHandlers.clear();\r\n}\r\n\r\nfunction dispatchToTarget(evt: NavigateRouteEvent) {\r\n    const handler = targetHandlers.get(evt.routeTarget);\r\n    if (handler) {\r\n        handler(evt);\r\n    } else {\r\n        pendingEvents.set(evt.routeTarget, evt);\r\n    }\r\n}\r\n\r\nlet listenerAttached = false;\r\n\r\nexport function initRouteTargetListener() {\r\n    if (listenerAttached) return;\r\n    listenerAttached = true;\r\n    document.addEventListener(NavigateRouteEvent.NAME, (evt) => {\r\n        dispatchToTarget(evt as NavigateRouteEvent);\r\n    });\r\n}\r\n", "import type { Route, RouteData, RouteParamType, RouteMatchResult } from './types';\r\n\r\n/**\r\n * Route segment matcher interface.\r\n * Each segment type (string, number, path) implements this\r\n * for parameter extraction and validation.\r\n */\r\ninterface RouteSegment {\r\n    /**\r\n     * Parameter name when segment is dynamic (:name or ;id)\r\n     */\r\n    paramName?: string;\r\n\r\n    /**\r\n     * Validates if URL segment matches pattern\r\n     * @param value Segment from URL to validate\r\n     */\r\n    isMatch(value: string): boolean;\r\n\r\n    /**\r\n     * Converts URL segment to typed parameter\r\n     * @param pathValue Raw value from URL\r\n     */\r\n    getValue(pathValue: string): RouteParamType;\r\n}\r\n\r\n/**\r\n * Number parameter segment matcher.\r\n * Used for ;id style parameters that must be numbers.\r\n */\r\nclass NumberRouteSegment implements RouteSegment {\r\n    constructor(public paramName: string) {}\r\n    isMatch(value: string): boolean {\r\n        if (/^\\d+$/.test(value)) {\r\n            return true;\r\n        }\r\n        return false;\r\n    }\r\n\r\n    getValue(pathValue: string): RouteParamType {\r\n        if (/^\\d+$/.test(pathValue) === false) {\r\n            throw new Error(\r\n                `Path is not a number, parameter name '${this.paramName}', value: '${pathValue}'.`\r\n            );\r\n        }\r\n        return parseInt(pathValue);\r\n    }\r\n}\r\n\r\n/**\r\n * String parameter segment matcher.\r\n * Used for :name style parameters.\r\n */\r\nclass StringRouteSegment implements RouteSegment {\r\n    constructor(public paramName: string) {}\r\n    isMatch(value: string): boolean {\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     *\r\n     * @param pathValue the route data (for route by name) or segment extracted from the url (for url routing).\r\n     * @returns\r\n     */\r\n    getValue(pathValue: string): RouteParamType {\r\n        return pathValue;\r\n    }\r\n}\r\n\r\n/**\r\n * Static path segment matcher.\r\n * Used for fixed URL parts like 'users' in /users/:id\r\n */\r\nclass PathRouteSegment implements RouteSegment {\r\n    constructor(public value: string) {}\r\n    isMatch(value: string): boolean {\r\n        return value == this.value;\r\n    }\r\n\r\n    getValue(_pathValue: string): RouteParamType {\r\n        return this.value;\r\n    }\r\n}\r\n\r\n/**\r\n * Internal route implementation that handles segment matching\r\n * and parameter extraction.\r\n */\r\nclass RouteImp {\r\n    constructor(public route: Route, private segments: RouteSegment[]) {}\r\n\r\n    /**\r\n     * Attempts to match URL segments against route pattern\r\n     * @param segments URL parts to match\r\n     * @returns Match result with parameters if successful\r\n     */\r\n    match(segments: string[]): RouteMatchResult | null {\r\n        if (segments.length != this.segments.length) {\r\n            return null;\r\n        }\r\n\r\n        const generatedSegments: string[] = [];\r\n        var params: RouteData = {};\r\n        for (let index = 0; index < segments.length; index++) {\r\n            const urlSegment = segments[index];\r\n            const ourSegment = this.segments[index];\r\n\r\n            if (!ourSegment.isMatch(urlSegment)) {\r\n                return null;\r\n            }\r\n\r\n            if (ourSegment.paramName) {\r\n                const value = ourSegment.getValue(urlSegment);\r\n                params[ourSegment.paramName] = value;\r\n                generatedSegments.push(value.toString());\r\n            } else {\r\n                generatedSegments.push(urlSegment);\r\n            }\r\n        }\r\n\r\n        return { route: this.route, params, urlSegments: generatedSegments };\r\n    }\r\n\r\n    /**\r\n     * Routing by name and route data, so generate the url segments.\r\n     * @param routeData Data to use in the URL.\r\n     * @returns Match result with parameters if successful\r\n     */\r\n    buildUrl(routeData: RouteData): RouteMatchResult | null {\r\n        const urlSegments: string[] = [];\r\n        for (let index = 0; index < this.segments.length; index++) {\r\n            const ourSegment = this.segments[index];\r\n            if (ourSegment.paramName) {\r\n                var value = routeData[ourSegment.paramName];\r\n                if (!value) {\r\n                    throw new Error(\r\n                        `Route \"${\r\n                            this.route.name\r\n                        }\" did not get value for parameter \"${\r\n                            ourSegment.paramName\r\n                        } from the provided routeData: \"${JSON.stringify(\r\n                            routeData\r\n                        )}\".`\r\n                    );\r\n                }\r\n\r\n                urlSegments.push(value.toString());\r\n            } else {\r\n                urlSegments.push(ourSegment.getValue('').toString());\r\n            }\r\n        }\r\n\r\n        return { route: this.route, params: routeData, urlSegments };\r\n    }\r\n\r\n    /**\r\n     * Converts string parameters to proper types\r\n     * @param routeParams Raw string parameters to convert\r\n     */\r\n    parseParameters(routeParams: Record<string, string>): RouteData {\r\n        const d: Record<string, any> = {};\r\n\r\n        this.segments.forEach((segment) => {\r\n            if (!segment.paramName) {\r\n                return;\r\n            }\r\n\r\n            if (!segment.isMatch(providedValue)) {\r\n                throw new Error(\r\n                    `Failed to convert parameter ${segment.paramName}, or missing value: ${providedValue}, route: ${this.route.name}.`\r\n                );\r\n            }\r\n\r\n            var providedValue = routeParams[segment.paramName];\r\n            if (!providedValue) {\r\n                throw new Error(\r\n                    `Parameter  ${segment.paramName} was not provided, route: ${this.route.name}.`\r\n                );\r\n            }\r\n\r\n            var convertedValue = segment.getValue(providedValue);\r\n            d[segment.paramName] = convertedValue;\r\n        });\r\n\r\n        return d;\r\n    }\r\n}\r\n\r\n/**\r\n * Match route by either name or URL pattern\r\n * @param routes Available routes\r\n * @param routeNameOrUrl Route name or URL to match\r\n * @param routeData Optional parameters for named routes\r\n */\r\nexport function matchRoute(\r\n    routes: Route[],\r\n    routeNameOrUrl: string,\r\n    routeData?: Record<string, string | any>\r\n): RouteMatchResult | null {\r\n    if (routeNameOrUrl === '' || routeNameOrUrl.indexOf('/') >= 0) {\r\n        return findRouteByUrl(routes, routeNameOrUrl || '/');\r\n    } else {\r\n        return findRouteByName(routes, routeNameOrUrl, routeData!);\r\n    }\r\n}\r\n\r\n/**\r\n * Find route by name and apply parameters\r\n * @param routes Available routes\r\n * @param name Route name to find\r\n * @param routeData Parameters to apply\r\n */\r\nexport function findRouteByName(\r\n    routes: Route[],\r\n    name: string,\r\n    routeData?: Record<string, string | any>\r\n): RouteMatchResult | null {\r\n    var route = routes.find((x) => x.name === name);\r\n    if (!route) {\r\n        return null;\r\n    }\r\n\r\n    var imp = generateRouteImp(route);\r\n    var result = imp.buildUrl(routeData);\r\n    return result;\r\n}\r\n\r\n/**\r\n * Find route matching URL pattern\r\n * @param routes Available routes\r\n * @param path URL to match\r\n */\r\nexport function findRouteByUrl(\r\n    routes: Route[],\r\n    path: string\r\n): RouteMatchResult | null {\r\n    const urlSegments = path.replace(/^\\/|\\/$/g, '').split('/');\r\n    const routeImps = generateRouteImps(routes);\r\n\r\n    for (let index = 0; index < routeImps.length; index++) {\r\n        const element = routeImps[index];\r\n        const m = element.match(urlSegments);\r\n        if (m) {\r\n            return m;\r\n        }\r\n    }\r\n    return null;\r\n}\r\n\r\n/**\r\n * Generate implementations for all routes\r\n */\r\nfunction generateRouteImps(routes: Route[]) {\r\n    const routeImps: RouteImp[] = [];\r\n    routes.forEach((route) => {\r\n        var imp = generateRouteImp(route);\r\n        routeImps.push(imp);\r\n    });\r\n\r\n    return routeImps;\r\n}\r\n\r\n/**\r\n * Generate implementation for single route\r\n * Parses URL pattern into segment matchers\r\n */\r\nfunction generateRouteImp(route: Route): RouteImp {\r\n    var impSegments = [];\r\n    const segments = route.path.replace(/^\\/|\\/$/g, '').split('/');\r\n    segments.forEach((segment) => {\r\n        if (segment.substring(0, 1) == ':') {\r\n            impSegments.push(new StringRouteSegment(segment.substring(1)));\r\n        } else if (segment.substring(0, 1) === ';') {\r\n            impSegments.push(new NumberRouteSegment(segment.substring(1)));\r\n        } else if (segment.substring(0, 1) === '{') {\r\n        } else {\r\n            impSegments.push(new PathRouteSegment(segment));\r\n        }\r\n    });\r\n\r\n    var imp = new RouteImp(route, impSegments);\r\n    return imp;\r\n}\r\n", "import { navigate, printRoutes } from './navigation';\r\nimport { RelaxError, reportError } from '../errors';\r\n\r\nexport class RouteLink extends HTMLElement {\r\n    static get observedAttributes() {\r\n        return ['name', 'target', 'params'];\r\n    }\r\n\r\n    constructor() {\r\n        super();\r\n        this.addEventListener('click', e => this.handleClick(e));\r\n    }\r\n\r\n    private handleClick(e: MouseEvent)  {\r\n        e.preventDefault();\r\n        \r\n        const name = this.getAttribute('name');\r\n        if (!name) return;\r\n\r\n        console.log('Calling printRoutes from RouteLink in relaxjs/components');\r\n        printRoutes();\r\n        \r\n        const params: Record<string, string> = {};\r\n        for (const attr of Array.from(this.attributes)) {\r\n            if (attr.name.startsWith('param-')) {\r\n                const paramName = attr.name.substring(6);\r\n                params[paramName] = attr.value;\r\n            }\r\n        }\r\n\r\n        const paramsAttr = this.getAttribute('params');\r\n        let additionalParams: Record<string, string | number> | undefined;\r\n        if (paramsAttr) {\r\n            try {\r\n                const parsed = JSON.parse(paramsAttr);\r\n                additionalParams = parsed as Record<string, string | number>;\r\n            } catch (error) {\r\n                const err = reportError('Failed to parse route params', {\r\n                    element: 'r-link',\r\n                    params: paramsAttr,\r\n                    cause: error,\r\n                });\r\n                if (err) throw err;\r\n            }\r\n        }\r\n\r\n        const target = this.getAttribute('target');\r\n        if (additionalParams){\r\n            Object.assign(params, additionalParams);\r\n        }\r\n\r\n        try {\r\n            navigate(name, { params, target: target || undefined });\r\n        } catch (error) {\r\n            if (error instanceof RelaxError) throw error;\r\n            const reported = reportError('Navigation failed', {\r\n                element: 'r-link',\r\n                route: name,\r\n                params,\r\n                target,\r\n                cause: error,\r\n            });\r\n            if (reported) throw reported;\r\n        }\r\n    }\r\n\r\n    connectedCallback() {\r\n        if (!this.hasAttribute('tabindex')) {\r\n            this.setAttribute('tabindex', '0');\r\n        }\r\n        \r\n        this.style.cursor = 'pointer';\r\n        this.role = 'link';\r\n    }\r\n\r\n    disconnectedCallback() {\r\n        this.removeEventListener('click', this.handleClick);\r\n    }\r\n}", "import { registerRouteTarget, unregisterRouteTarget } from './routeTargetRegistry';\r\nimport type { NavigateRouteEvent } from './NavigateRouteEvent';\r\nimport type { RouteData, LoadRoute } from './types';\r\nimport { RelaxError, reportError } from '../errors';\r\n\r\n/**\r\n * WebComponent that listens on the `NavigateRouteEvent` event to be able to switch route.\r\n *\r\n * Use the \"name\" attribute to make this non-default target.\r\n * Use the \"dialog\" attribute to render routes inside a native `<dialog>` element\r\n * with built-in focus trapping, backdrop, and Escape-to-close.\r\n *\r\n * @example\r\n * <r-route-target></r-route-target>\r\n * <r-route-target name=\"modal\" dialog></r-route-target>\r\n */\r\nexport class RouteTarget extends HTMLElement {\r\n    name?: string = undefined;\r\n    private dialog?: HTMLDialogElement;\r\n\r\n    connectedCallback() {\r\n        this.name = this.getAttribute('name') ?? undefined;\r\n\r\n        if (this.hasAttribute('dialog')) {\r\n            this.dialog = document.createElement('dialog');\r\n            this.dialog.addEventListener('close', () => {\r\n                this.dialog!.replaceChildren();\r\n            });\r\n            this.appendChild(this.dialog);\r\n        }\r\n\r\n        registerRouteTarget(this.name, (evt) => this.onNavigate(evt));\r\n        console.log('registered');\r\n    }\r\n\r\n    disconnectedCallback() {\r\n        unregisterRouteTarget(this.name);\r\n    }\r\n\r\n    private onNavigate(evt: NavigateRouteEvent) {\r\n        console.log('got nav', evt);\r\n        this.loadComponent(evt).catch((error) => {\r\n            if (!(error instanceof RelaxError)) {\r\n                error = reportError('Route navigation failed', {\r\n                    route: evt.route.name,\r\n                    routeTarget: evt.routeTarget,\r\n                    cause: error,\r\n                });\r\n            }\r\n            if (error) {\r\n                console.error(error);\r\n            }\r\n        });\r\n    }\r\n\r\n    private async loadComponent(evt: NavigateRouteEvent) {\r\n        const tagName = evt.route.componentTagName\r\n            ?? customElements.getName(evt.route.component);\r\n\r\n        if (!tagName) {\r\n            const error = reportError('Failed to find component for route', {\r\n                route: evt.route.name,\r\n                componentTagName: evt.route.componentTagName,\r\n                component: evt.route.component?.name,\r\n                routeData: evt.routeData,\r\n            });\r\n            if (error) throw error;\r\n            return;\r\n        }\r\n\r\n        await customElements.whenDefined(tagName);\r\n        const element = document.createElement(tagName);\r\n\r\n        await this.applyRouteData(element, evt.routeData);\r\n\r\n        if (this.dialog) {\r\n            this.dialog.replaceChildren(element);\r\n            if (!this.dialog.open) {\r\n                this.dialog.showModal();\r\n            }\r\n        } else if (document.startViewTransition) {\r\n            document.startViewTransition(() => this.replaceChildren(element));\r\n        } else {\r\n            this.replaceChildren(element);\r\n        }\r\n    }\r\n\r\n    /** Closes the dialog (only applies to dialog targets). */\r\n    close() {\r\n        this.dialog?.close();\r\n    }\r\n\r\n    private async applyRouteData(element: Element, data?: RouteData) {\r\n        if ('loadRoute' in element) {\r\n            const routeData = data\r\n                ?? { error: 'loadRoute function without mapped route data in the routes' };\r\n            await (element as unknown as LoadRoute).loadRoute(routeData);\r\n        }\r\n\r\n        if (data) {\r\n            (element as any).routeData = data;\r\n        }\r\n    }\r\n}\r\n", "/**\r\n * Single Page Application routing system with multiple target support.\r\n * Designed for scenarios where you need:\r\n * - Multiple navigation targets (main content, modals, sidebars)\r\n * - Strongly typed route parameters\r\n * - History management with back/forward support\r\n *\r\n * @example\r\n * // Configure routes\r\n * const routes = [\r\n *   { name: 'user', path: '/users/:id' },          // String parameter\r\n *   { name: 'order', path: '/orders/;orderId' },   // Number parameter\r\n *   { name: 'modal', path: '/detail/:id', target: 'modal' }  // Custom target\r\n * ];\r\n */\r\n\r\nimport { reportError } from '../errors';\r\nimport {\r\n    GuardResult,\r\n    RouteError,\r\n    RouteGuardError,\r\n    type Route,\r\n    type RouteData,\r\n    type RouteParamType,\r\n    type RouteMatchResult,\r\n    type NavigateOptions,\r\n} from './types';\r\nimport { NavigateRouteEvent } from './NavigateRouteEvent';\r\nimport { matchRoute } from './routeMatching';\r\nimport { initRouteTargetListener } from './routeTargetRegistry';\r\nimport { RouteLink } from './RouteLink';\r\nimport { RouteTarget } from './RoutingTarget';\r\n\r\n/**\r\n * Used to keep track of current main HTML file,\r\n * used when different layouts are supported.\r\n *\r\n * The default page is ALWAYS loaded initially,\r\n * which means that we need to switch layout page\r\n * if someone else is configured for the route.\r\n */\r\nvar currentLayout = getLayout() ?? 'default';\r\nfunction getLayout() {\r\n    const path = window.location.pathname;\r\n    if (path == '/index.html') {\r\n        return 'default';\r\n    }\r\n\r\n    return path.endsWith('.html') ? path.slice(1, -5) : null;\r\n}\r\n\r\nexport const internalRoutes: Route[] = [];\r\n\r\nexport const MyData = {\r\n    routes: []\r\n};\r\n\r\n/**\r\n * Debug helper to print all registered routes to console.\r\n */\r\nexport function printRoutes() {\r\n    console.log(internalRoutes);\r\n}\r\n\r\n/**\r\n * Registers application routes with the router.\r\n * Call this at application startup before routing begins.\r\n *\r\n * @param appRoutes - Array of route configurations\r\n * @throws Error if referenced components are not registered\r\n *\r\n * @example\r\n * const routes: Route[] = [\r\n *     { name: 'home', path: '/', componentTagName: 'app-home' },\r\n *     { name: 'user', path: '/users/:id', componentTagName: 'user-profile' },\r\n *     { name: 'login', path: '/auth/', componentTagName: 'login-form', layout: 'noauth' }\r\n * ];\r\n * defineRoutes(routes);\r\n */\r\nexport function defineRoutes(appRoutes: Route[]) {\r\n    console.log('defining routes1', appRoutes);\r\n    initRouteTargetListener();\r\n    if (!customElements.get('r-route-target')) {\r\n        customElements.define('r-route-target', RouteTarget);\r\n    }\r\n    if (!customElements.get('r-link')) {\r\n        customElements.define('r-link', RouteLink);\r\n    }\r\n    console.log('defining routes', appRoutes);\r\n    internalRoutes.length = 0;\r\n    internalRoutes.push(...appRoutes);\r\n\r\n    var errs = [];\r\n    appRoutes.forEach((route) => {\r\n        if (\r\n            route.componentTagName &&\r\n            !customElements.get(route.componentTagName)\r\n        ) {\r\n            errs.push(\r\n                `Component with tagName '${route.componentTagName}' is not defined in customElements.`\r\n            );\r\n        }\r\n        if (route.component && !customElements.getName(route.component)) {\r\n            errs.push(\r\n                `Component '${route.component.name}' is not defined in customElements. Used in route '${JSON.stringify(route)}'.`\r\n            );\r\n        }\r\n        if (route.layout === '') {\r\n            console.log('should not use empty string layout.', route);\r\n            route.layout = undefined;\r\n        }\r\n    });\r\n\r\n    if (errs.length > 0) {\r\n        throw new Error(errs.join('\\n'));\r\n    }\r\n}\r\n\r\n/**\r\n * Initializes routing and navigates to the current URL.\r\n * Call this after DOM is ready and routes are defined.\r\n *\r\n * @example\r\n * // In your main application component\r\n * connectedCallback() {\r\n *     defineRoutes(routes);\r\n *     startRouting();\r\n * }\r\n */\r\nexport function startRouting() {\r\n    let newPage = false;\r\n    if (currentLayout == '') {\r\n        const path = window.location.pathname;\r\n        const match = path.match(/\\/([^\\/]+)\\.html$/);\r\n        if (match && match[1] !== '') {\r\n            console.log('setting current layut', match[1]);\r\n            currentLayout = match[1];\r\n            newPage = true;\r\n        } else {\r\n            console.log('Setting default layout name');\r\n            currentLayout = 'default';\r\n        }\r\n    }\r\n\r\n    if (tryLoadRouteFromLayoutNavigation()) {\r\n        return;\r\n    }\r\n\r\n    const currentUrl = window.location.pathname.replace(/^\\/|\\/$/g, '') || '/';\r\n    const routeResult = findRoute(currentUrl, {});\r\n\r\n    const searchParams = new URLSearchParams(window.location.search);\r\n    if (searchParams.size > 0) {\r\n        routeResult.params ??= {};\r\n        searchParams.forEach((value, key) => {\r\n            routeResult.params[key] = value;\r\n        });\r\n    }\r\n\r\n    if (navigateToLayout(routeResult)) {\r\n        return;\r\n    }\r\n\r\n    history.replaceState(\r\n        routeResult.urlSegments,\r\n        '',\r\n        '/' + routeResult.urlSegments.join('/')\r\n    );\r\n\r\n    const e = new NavigateRouteEvent(\r\n        routeResult.route,\r\n        routeResult.urlSegments,\r\n        routeResult.params,\r\n        routeResult.route.target\r\n    );\r\n    document.dispatchEvent(e);\r\n}\r\n\r\n/**\r\n * Navigates to a route by name or URL.\r\n * Updates browser history and dispatches navigation events.\r\n *\r\n * @param routeNameOrUrl - Route name or URL path to navigate to\r\n * @param options - Navigation options including params and target\r\n *\r\n * @example\r\n * // Navigate by route name\r\n * navigate('user', { params: { id: '123' } });\r\n *\r\n * // Navigate by URL\r\n * navigate('/users/123');\r\n *\r\n * // Navigate to specific target\r\n * navigate('detail', { params: { id: '42' }, target: 'modal' });\r\n */\r\nexport function navigate(routeNameOrUrl: string, options?: NavigateOptions) {\r\n    console.log('navigating to ', routeNameOrUrl, options);\r\n    const routeResult = findRoute(routeNameOrUrl, options);\r\n    if (navigateToLayout(routeResult)) {\r\n        return;\r\n    }\r\n\r\n    const target = options?.target ?? routeResult.route.target;\r\n    const ourUrl = routeResult.urlSegments.join('/');\r\n    const currentUrl = window.location.pathname.replace(/^\\/|\\/$/g, '');\r\n    if (currentUrl != ourUrl) {\r\n        history.pushState(\r\n            routeResult.urlSegments,\r\n            '',\r\n            '/' + routeResult.urlSegments.join('/')\r\n        );\r\n    }\r\n    const e = new NavigateRouteEvent(\r\n        routeResult.route,\r\n        routeResult.urlSegments,\r\n        routeResult.params,\r\n        target\r\n    );\r\n    document.dispatchEvent(e);\r\n}\r\n\r\nfunction findRoute(routeNameOrUrl: string, options?: NavigateOptions) {\r\n    const theRoutes = options?.routes ?? internalRoutes;\r\n    const params = options?.params;\r\n\r\n    const routeResult = matchRoute(theRoutes, routeNameOrUrl, params);\r\n    if (!routeResult) {\r\n        const errorMsg = generateErrorMessage(\r\n            routeNameOrUrl,\r\n            params,\r\n            theRoutes\r\n        );\r\n        console.error(errorMsg);\r\n        throw new RouteError(errorMsg);\r\n    }\r\n\r\n    if (!checkRouteGuards(routeResult)) {\r\n        throw new RouteGuardError('Route guards stopped navigation for route ' + routeNameOrUrl);\r\n    }\r\n\r\n    return routeResult;\r\n}\r\n\r\nfunction navigateToLayout(routeResult: RouteMatchResult): boolean {\r\n    if (!routeResult) {\r\n        console.error('Route result is null, cannot navigate to layout.');\r\n    }\r\n\r\n    const wantedLayout = (routeResult.route.layout ?? 'default').replace(\r\n        /\\.html?$/,\r\n        ''\r\n    );\r\n    if (wantedLayout === currentLayout) {\r\n        return false;\r\n    }\r\n\r\n    console.log(\r\n        'Current layout: ' + currentLayout,\r\n        'Wanted layout: ' + wantedLayout\r\n    );\r\n\r\n    // The hash means that we attempted to redirect to the same layout once,\r\n    // so if it's there and another redirect is requsted, something is wrong.\r\n    //\r\n    // Because the push history should remove it if everything worked out.\r\n    if (window.location.hash) {\r\n        throw Error(\r\n            'A redirect failed, does the requsted layout exist? \"' +\r\n                wantedLayout +\r\n                '\"?'\r\n        );\r\n    }\r\n\r\n    console.log(\r\n        `requires layout switch from ${currentLayout} to ${wantedLayout}`\r\n    );\r\n    const navigationState = {\r\n        routeName: routeResult.route.name,\r\n        params: routeResult.params || {}\r\n    };\r\n\r\n    sessionStorage.setItem('layoutNavigation', JSON.stringify(navigationState));\r\n    const layoutUrl =\r\n        wantedLayout.indexOf('.htm') > -1\r\n            ? `/${wantedLayout}#layout`\r\n            : `/${wantedLayout}.html#layout`;\r\n    console.log('redirecting to ', layoutUrl);\r\n    window.location.href = layoutUrl;\r\n    return true;\r\n}\r\n/**\r\n * Checks session storage for route information and initiates proper navigation\r\n * Should be called when page loads to handle layout transitions\r\n *\r\n * @returns Whether navigation was initiated from session storage\r\n *\r\n * @example\r\n * // Call on page load\r\n * document.addEventListener('DOMContentLoaded', () => {\r\n *   if (handleLayoutNavigation()) {\r\n *     console.log('Navigation handled from session storage');\r\n *   }\r\n * });\r\n */\r\nfunction tryLoadRouteFromLayoutNavigation(): boolean {\r\n    try {\r\n        const navigationStateJson = sessionStorage.getItem('layoutNavigation');\r\n        if (!navigationStateJson) {\r\n            return false;\r\n        }\r\n\r\n        const navigationState = JSON.parse(navigationStateJson);\r\n        sessionStorage.removeItem('layoutNavigation');\r\n        console.log('session store navigation ', navigationState);\r\n        navigate(navigationState.routeName, {\r\n            params: navigationState.params\r\n        });\r\n\r\n        return true;\r\n    } catch (error) {\r\n        sessionStorage.removeItem('layoutNavigation');\r\n        reportError('Failed to navigate from session storage', {\r\n            cause: error,\r\n        });\r\n        return false;\r\n    }\r\n}\r\n\r\nfunction generateErrorMessage(\r\n    routeNameOrUrl: string,\r\n    routeParams: Record<string, RouteParamType>,\r\n    allRoutes: Route[]\r\n): string {\r\n    var routeData = '';\r\n    if (routeParams) {\r\n        routeData += Object.entries(routeParams)\r\n            .map(([key, value]) => `${key}=${value}`)\r\n            .join(', ');\r\n    } else {\r\n        routeData = '.';\r\n    }\r\n\r\n    var routesStr = allRoutes.map(\r\n        (x) =>\r\n            ` * Name: '${x.name}', path: '${x.path}', target: ${\r\n                x.target ?? 'default'\r\n            }\\n`\r\n    );\r\n    return `No route matched '${routeNameOrUrl}${routeData}'. Available routes:\\n${routesStr}`;\r\n}\r\n\r\nfunction checkRouteGuards(routeResult: RouteMatchResult): boolean {\r\n    if (\r\n        !routeResult ||\r\n        !routeResult.route.guards ||\r\n        routeResult.route.guards.length == 0\r\n    ) {\r\n        return true;\r\n    }\r\n\r\n    for (let index = 0; index < routeResult.route.guards.length; index++) {\r\n        const element = routeResult.route.guards[index];\r\n        var result = element.check(routeResult);\r\n        if (result == GuardResult.Allow) {\r\n            return true;\r\n        }\r\n\r\n        if (result == GuardResult.Stop) {\r\n            return false;\r\n        }\r\n\r\n        if (result == GuardResult.Deny) {\r\n            throw new RouteGuardError(\r\n                `Guard ${element.constructor.name} said 'Deny' for ${routeResult.route.name}`\r\n            );\r\n        }\r\n    }\r\n\r\n    return true;\r\n}\r\n"],
+  "mappings": "AAEO,IAAKA,OAIRA,IAAA,iBAKAA,IAAA,eAKAA,IAAA,uBAKAA,IAAA,eAnBQA,OAAA,IAgICC,EAAN,cAAyB,KAAM,CAAC,EAC1BC,EAAN,cAA8BD,CAAW,CAEhD,EChIO,IAAME,EAAN,MAAMC,UAA2B,KAAM,CAE1C,YAIWC,EAKAC,EAKAC,EAOAC,EAEPC,EACF,CACE,MAAML,EAAmB,KAAMK,CAAS,EArBjC,WAAAJ,EAKA,iBAAAC,EAKA,eAAAC,EAOA,iBAAAC,CAKX,CA3BA,YAAO,KAAe,oBA4B1B,ECDO,IAAME,EAAN,cAAyB,KAAM,CAClC,YACIC,EACOC,EACT,CACE,MAAMD,CAAO,EAFN,aAAAC,CAGX,CACJ,EAIIC,EAA+B,KAsC5B,SAASC,EAAYC,EAAiBC,EAAqD,CAC9F,IAAMC,EAAQ,IAAIC,EAAWH,EAASC,CAAO,EAC7C,GAAIG,EAAS,CACT,IAAIC,EAAa,GAKjB,GADAD,EAAQF,EAHkB,CACtB,UAAW,CAAEG,EAAa,EAAM,CACpC,CACkB,EACdA,EACA,OAAO,IAEf,CACA,OAAOH,CACX,CC3FA,IAAMI,EAAiB,IAAI,IACrBC,EAAgB,IAAI,IAanB,SAASC,EACZC,EACAC,EACF,CAEE,GADAC,EAAwB,EACpBL,EAAe,IAAIG,CAAI,EAAG,CAC1B,IAAMG,EAAQC,EAAY,yBAA0B,CAChD,OAAQJ,GAAQ,SACpB,CAAC,EACD,GAAIG,EAAO,MAAMA,EACjB,MACJ,CACAN,EAAe,IAAIG,EAAMC,CAAO,EAEhC,IAAMI,EAAUP,EAAc,IAAIE,CAAI,EAClCK,IACAP,EAAc,OAAOE,CAAI,EACzBC,EAAQI,CAAO,EAEvB,CAOO,SAASC,EAAsBN,EAA0B,CAC5DH,EAAe,OAAOG,CAAI,CAC9B,CAEO,SAASO,GAA0B,CACtCT,EAAc,MAAM,EACpBD,EAAe,MAAM,CACzB,CAEA,SAASW,EAAiBC,EAAyB,CAC/C,IAAMR,EAAUJ,EAAe,IAAIY,EAAI,WAAW,EAC9CR,EACAA,EAAQQ,CAAG,EAEXX,EAAc,IAAIW,EAAI,YAAaA,CAAG,CAE9C,CAEA,IAAIC,EAAmB,GAEhB,SAASR,GAA0B,CAClCQ,IACJA,EAAmB,GACnB,SAAS,iBAAiBC,EAAmB,KAAOF,GAAQ,CACxDD,EAAiBC,CAAyB,CAC9C,CAAC,EACL,CCxCA,IAAMG,EAAN,KAAiD,CAC7C,YAAmBC,EAAmB,CAAnB,eAAAA,CAAoB,CACvC,QAAQC,EAAwB,CAC5B,MAAI,UAAQ,KAAKA,CAAK,CAI1B,CAEA,SAASC,EAAmC,CACxC,GAAI,QAAQ,KAAKA,CAAS,IAAM,GAC5B,MAAM,IAAI,MACN,yCAAyC,KAAK,SAAS,cAAcA,CAAS,IAClF,EAEJ,OAAO,SAASA,CAAS,CAC7B,CACJ,EAMMC,EAAN,KAAiD,CAC7C,YAAmBH,EAAmB,CAAnB,eAAAA,CAAoB,CACvC,QAAQC,EAAwB,CAC5B,MAAO,EACX,CAOA,SAASC,EAAmC,CACxC,OAAOA,CACX,CACJ,EAMME,EAAN,KAA+C,CAC3C,YAAmBH,EAAe,CAAf,WAAAA,CAAgB,CACnC,QAAQA,EAAwB,CAC5B,OAAOA,GAAS,KAAK,KACzB,CAEA,SAASI,EAAoC,CACzC,OAAO,KAAK,KAChB,CACJ,EAMMC,EAAN,KAAe,CACX,YAAmBC,EAAsBC,EAA0B,CAAhD,WAAAD,EAAsB,cAAAC,CAA2B,CAOpE,MAAMA,EAA6C,CAC/C,GAAIA,EAAS,QAAU,KAAK,SAAS,OACjC,OAAO,KAGX,IAAMC,EAA8B,CAAC,EACrC,IAAIC,EAAoB,CAAC,EACzB,QAASC,EAAQ,EAAGA,EAAQH,EAAS,OAAQG,IAAS,CAClD,IAAMC,EAAaJ,EAASG,CAAK,EAC3BE,EAAa,KAAK,SAASF,CAAK,EAEtC,GAAI,CAACE,EAAW,QAAQD,CAAU,EAC9B,OAAO,KAGX,GAAIC,EAAW,UAAW,CACtB,IAAMZ,EAAQY,EAAW,SAASD,CAAU,EAC5CF,EAAOG,EAAW,SAAS,EAAIZ,EAC/BQ,EAAkB,KAAKR,EAAM,SAAS,CAAC,CAC3C,MACIQ,EAAkB,KAAKG,CAAU,CAEzC,CAEA,MAAO,CAAE,MAAO,KAAK,MAAO,OAAAF,EAAQ,YAAaD,CAAkB,CACvE,CAOA,SAASK,EAA+C,CACpD,IAAMC,EAAwB,CAAC,EAC/B,QAASJ,EAAQ,EAAGA,EAAQ,KAAK,SAAS,OAAQA,IAAS,CACvD,IAAME,EAAa,KAAK,SAASF,CAAK,EACtC,GAAIE,EAAW,UAAW,CACtB,IAAIZ,EAAQa,EAAUD,EAAW,SAAS,EAC1C,GAAI,CAACZ,EACD,MAAM,IAAI,MACN,UACI,KAAK,MAAM,IACf,sCACIY,EAAW,SACf,kCAAkC,KAAK,UACnCC,CACJ,CAAC,IACL,EAGJC,EAAY,KAAKd,EAAM,SAAS,CAAC,CACrC,MACIc,EAAY,KAAKF,EAAW,SAAS,EAAE,EAAE,SAAS,CAAC,CAE3D,CAEA,MAAO,CAAE,MAAO,KAAK,MAAO,OAAQC,EAAW,YAAAC,CAAY,CAC/D,CAMA,gBAAgBC,EAAgD,CAC5D,IAAMC,EAAyB,CAAC,EAEhC,YAAK,SAAS,QAASC,GAAY,CAC/B,GAAKA,EAAQ,UAIb,IAAI,CAACA,EAAQ,QAAQC,CAAa,EAC9B,MAAM,IAAI,MACN,+BAA+BD,EAAQ,SAAS,uBAAuBC,CAAa,YAAY,KAAK,MAAM,IAAI,GACnH,EAGJ,IAAIA,EAAgBH,EAAYE,EAAQ,SAAS,EACjD,GAAI,CAACC,EACD,MAAM,IAAI,MACN,cAAcD,EAAQ,SAAS,6BAA6B,KAAK,MAAM,IAAI,GAC/E,EAGJ,IAAIE,EAAiBF,EAAQ,SAASC,CAAa,EACnDF,EAAEC,EAAQ,SAAS,EAAIE,EAC3B,CAAC,EAEMH,CACX,CACJ,EAQO,SAASI,EACZC,EACAC,EACAT,EACuB,CACvB,OAAIS,IAAmB,IAAMA,EAAe,QAAQ,GAAG,GAAK,EACjDC,EAAeF,EAAQC,GAAkB,GAAG,EAE5CE,EAAgBH,EAAQC,EAAgBT,CAAU,CAEjE,CAQO,SAASW,EACZH,EACAI,EACAZ,EACuB,CACvB,IAAIP,EAAQe,EAAO,KAAMK,GAAMA,EAAE,OAASD,CAAI,EAC9C,GAAI,CAACnB,EACD,OAAO,KAGX,IAAIqB,EAAMC,EAAiBtB,CAAK,EAC5BuB,EAASF,EAAI,SAASd,CAAS,EACnC,OAAOgB,CACX,CAOO,SAASN,EACZF,EACAS,EACuB,CACvB,IAAMhB,EAAcgB,EAAK,QAAQ,WAAY,EAAE,EAAE,MAAM,GAAG,EACpDC,EAAYC,EAAkBX,CAAM,EAE1C,QAASX,EAAQ,EAAGA,EAAQqB,EAAU,OAAQrB,IAAS,CAEnD,IAAMuB,EADUF,EAAUrB,CAAK,EACb,MAAMI,CAAW,EACnC,GAAImB,EACA,OAAOA,CAEf,CACA,OAAO,IACX,CAKA,SAASD,EAAkBX,EAAiB,CACxC,IAAMU,EAAwB,CAAC,EAC/B,OAAAV,EAAO,QAASf,GAAU,CACtB,IAAIqB,EAAMC,EAAiBtB,CAAK,EAChCyB,EAAU,KAAKJ,CAAG,CACtB,CAAC,EAEMI,CACX,CAMA,SAASH,EAAiBtB,EAAwB,CAC9C,IAAI4B,EAAc,CAAC,EACF5B,EAAM,KAAK,QAAQ,WAAY,EAAE,EAAE,MAAM,GAAG,EACpD,QAASW,GAAY,CACtBA,EAAQ,UAAU,EAAG,CAAC,GAAK,IAC3BiB,EAAY,KAAK,IAAIhC,EAAmBe,EAAQ,UAAU,CAAC,CAAC,CAAC,EACtDA,EAAQ,UAAU,EAAG,CAAC,IAAM,IACnCiB,EAAY,KAAK,IAAIpC,EAAmBmB,EAAQ,UAAU,CAAC,CAAC,CAAC,EACtDA,EAAQ,UAAU,EAAG,CAAC,IAAM,KAEnCiB,EAAY,KAAK,IAAI/B,EAAiBc,CAAO,CAAC,CAEtD,CAAC,EAED,IAAIU,EAAM,IAAItB,EAASC,EAAO4B,CAAW,EACzC,OAAOP,CACX,CCvRO,IAAMQ,EAAN,cAAwB,WAAY,CACvC,WAAW,oBAAqB,CAC5B,MAAO,CAAC,OAAQ,SAAU,QAAQ,CACtC,CAEA,aAAc,CACV,MAAM,EACN,KAAK,iBAAiB,QAAS,GAAK,KAAK,YAAY,CAAC,CAAC,CAC3D,CAEQ,YAAY,EAAgB,CAChC,EAAE,eAAe,EAEjB,IAAMC,EAAO,KAAK,aAAa,MAAM,EACrC,GAAI,CAACA,EAAM,OAEX,QAAQ,IAAI,0DAA0D,EACtEC,EAAY,EAEZ,IAAMC,EAAiC,CAAC,EACxC,QAAWC,KAAQ,MAAM,KAAK,KAAK,UAAU,EACzC,GAAIA,EAAK,KAAK,WAAW,QAAQ,EAAG,CAChC,IAAMC,EAAYD,EAAK,KAAK,UAAU,CAAC,EACvCD,EAAOE,CAAS,EAAID,EAAK,KAC7B,CAGJ,IAAME,EAAa,KAAK,aAAa,QAAQ,EACzCC,EACJ,GAAID,EACA,GAAI,CAEAC,EADe,KAAK,MAAMD,CAAU,CAExC,OAASE,EAAO,CACZ,IAAMC,EAAMC,EAAY,+BAAgC,CACpD,QAAS,SACT,OAAQJ,EACR,MAAOE,CACX,CAAC,EACD,GAAIC,EAAK,MAAMA,CACnB,CAGJ,IAAME,EAAS,KAAK,aAAa,QAAQ,EACrCJ,GACA,OAAO,OAAOJ,EAAQI,CAAgB,EAG1C,GAAI,CACAK,EAASX,EAAM,CAAE,OAAAE,EAAQ,OAAQQ,GAAU,MAAU,CAAC,CAC1D,OAASH,EAAO,CACZ,GAAIA,aAAiBK,EAAY,MAAML,EACvC,IAAMM,EAAWJ,EAAY,oBAAqB,CAC9C,QAAS,SACT,MAAOT,EACP,OAAAE,EACA,OAAAQ,EACA,MAAOH,CACX,CAAC,EACD,GAAIM,EAAU,MAAMA,CACxB,CACJ,CAEA,mBAAoB,CACX,KAAK,aAAa,UAAU,GAC7B,KAAK,aAAa,WAAY,GAAG,EAGrC,KAAK,MAAM,OAAS,UACpB,KAAK,KAAO,MAChB,CAEA,sBAAuB,CACnB,KAAK,oBAAoB,QAAS,KAAK,WAAW,CACtD,CACJ,EC9DO,IAAMC,EAAN,cAA0B,WAAY,CAAtC,kCACH,UAAgB,OAGhB,mBAAoB,CAChB,KAAK,KAAO,KAAK,aAAa,MAAM,GAAK,OAErC,KAAK,aAAa,QAAQ,IAC1B,KAAK,OAAS,SAAS,cAAc,QAAQ,EAC7C,KAAK,OAAO,iBAAiB,QAAS,IAAM,CACxC,KAAK,OAAQ,gBAAgB,CACjC,CAAC,EACD,KAAK,YAAY,KAAK,MAAM,GAGhCC,EAAoB,KAAK,KAAOC,GAAQ,KAAK,WAAWA,CAAG,CAAC,EAC5D,QAAQ,IAAI,YAAY,CAC5B,CAEA,sBAAuB,CACnBC,EAAsB,KAAK,IAAI,CACnC,CAEQ,WAAWD,EAAyB,CACxC,QAAQ,IAAI,UAAWA,CAAG,EAC1B,KAAK,cAAcA,CAAG,EAAE,MAAOE,GAAU,CAC/BA,aAAiBC,IACnBD,EAAQE,EAAY,0BAA2B,CAC3C,MAAOJ,EAAI,MAAM,KACjB,YAAaA,EAAI,YACjB,MAAOE,CACX,CAAC,GAEDA,GACA,QAAQ,MAAMA,CAAK,CAE3B,CAAC,CACL,CAEA,MAAc,cAAcF,EAAyB,CACjD,IAAMK,EAAUL,EAAI,MAAM,kBACnB,eAAe,QAAQA,EAAI,MAAM,SAAS,EAEjD,GAAI,CAACK,EAAS,CACV,IAAMH,EAAQE,EAAY,qCAAsC,CAC5D,MAAOJ,EAAI,MAAM,KACjB,iBAAkBA,EAAI,MAAM,iBAC5B,UAAWA,EAAI,MAAM,WAAW,KAChC,UAAWA,EAAI,SACnB,CAAC,EACD,GAAIE,EAAO,MAAMA,EACjB,MACJ,CAEA,MAAM,eAAe,YAAYG,CAAO,EACxC,IAAMC,EAAU,SAAS,cAAcD,CAAO,EAE9C,MAAM,KAAK,eAAeC,EAASN,EAAI,SAAS,EAE5C,KAAK,QACL,KAAK,OAAO,gBAAgBM,CAAO,EAC9B,KAAK,OAAO,MACb,KAAK,OAAO,UAAU,GAEnB,SAAS,oBAChB,SAAS,oBAAoB,IAAM,KAAK,gBAAgBA,CAAO,CAAC,EAEhE,KAAK,gBAAgBA,CAAO,CAEpC,CAGA,OAAQ,CACJ,KAAK,QAAQ,MAAM,CACvB,CAEA,MAAc,eAAeA,EAAkBC,EAAkB,CAC7D,GAAI,cAAeD,EAAS,CACxB,IAAME,EAAYD,GACX,CAAE,MAAO,4DAA6D,EAC7E,MAAOD,EAAiC,UAAUE,CAAS,CAC/D,CAEID,IACCD,EAAgB,UAAYC,EAErC,CACJ,EC9DA,IAAIE,EAAgBC,EAAU,GAAK,UACnC,SAASA,GAAY,CACjB,IAAMC,EAAO,OAAO,SAAS,SAC7B,OAAIA,GAAQ,cACD,UAGJA,EAAK,SAAS,OAAO,EAAIA,EAAK,MAAM,EAAG,EAAE,EAAI,IACxD,CAEO,IAAMC,EAA0B,CAAC,EASjC,SAASC,GAAc,CAC1B,QAAQ,IAAIC,CAAc,CAC9B,CAiBO,SAASC,EAAaC,EAAoB,CAC7C,QAAQ,IAAI,mBAAoBA,CAAS,EACzCC,EAAwB,EACnB,eAAe,IAAI,gBAAgB,GACpC,eAAe,OAAO,iBAAkBC,CAAW,EAElD,eAAe,IAAI,QAAQ,GAC5B,eAAe,OAAO,SAAUC,CAAS,EAE7C,QAAQ,IAAI,kBAAmBH,CAAS,EACxCF,EAAe,OAAS,EACxBA,EAAe,KAAK,GAAGE,CAAS,EAEhC,IAAII,EAAO,CAAC,EAqBZ,GApBAJ,EAAU,QAASK,GAAU,CAErBA,EAAM,kBACN,CAAC,eAAe,IAAIA,EAAM,gBAAgB,GAE1CD,EAAK,KACD,2BAA2BC,EAAM,gBAAgB,qCACrD,EAEAA,EAAM,WAAa,CAAC,eAAe,QAAQA,EAAM,SAAS,GAC1DD,EAAK,KACD,cAAcC,EAAM,UAAU,IAAI,sDAAsD,KAAK,UAAUA,CAAK,CAAC,IACjH,EAEAA,EAAM,SAAW,KACjB,QAAQ,IAAI,sCAAuCA,CAAK,EACxDA,EAAM,OAAS,OAEvB,CAAC,EAEGD,EAAK,OAAS,EACd,MAAM,IAAI,MAAMA,EAAK,KAAK;AAAA,CAAI,CAAC,CAEvC,CAaO,SAASE,GAAe,CAC3B,IAAIC,EAAU,GACd,GAAIC,GAAiB,GAAI,CAErB,IAAMC,EADO,OAAO,SAAS,SACV,MAAM,mBAAmB,EACxCA,GAASA,EAAM,CAAC,IAAM,IACtB,QAAQ,IAAI,wBAAyBA,EAAM,CAAC,CAAC,EAC7CD,EAAgBC,EAAM,CAAC,EACvBF,EAAU,KAEV,QAAQ,IAAI,6BAA6B,EACzCC,EAAgB,UAExB,CAEA,GAAIE,EAAiC,EACjC,OAGJ,IAAMC,EAAa,OAAO,SAAS,SAAS,QAAQ,WAAY,EAAE,GAAK,IACjEC,EAAcC,EAAUF,EAAY,CAAC,CAAC,EAEtCG,EAAe,IAAI,gBAAgB,OAAO,SAAS,MAAM,EAQ/D,GAPIA,EAAa,KAAO,IACpBF,EAAY,SAAW,CAAC,EACxBE,EAAa,QAAQ,CAACC,EAAOC,IAAQ,CACjCJ,EAAY,OAAOI,CAAG,EAAID,CAC9B,CAAC,GAGDE,EAAiBL,CAAW,EAC5B,OAGJ,QAAQ,aACJA,EAAY,YACZ,GACA,IAAMA,EAAY,YAAY,KAAK,GAAG,CAC1C,EAEA,IAAMM,EAAI,IAAIC,EACVP,EAAY,MACZA,EAAY,YACZA,EAAY,OACZA,EAAY,MAAM,MACtB,EACA,SAAS,cAAcM,CAAC,CAC5B,CAmBO,SAASE,EAASC,EAAwBC,EAA2B,CACxE,QAAQ,IAAI,iBAAkBD,EAAgBC,CAAO,EACrD,IAAMV,EAAcC,EAAUQ,EAAgBC,CAAO,EACrD,GAAIL,EAAiBL,CAAW,EAC5B,OAGJ,IAAMW,EAASD,GAAS,QAAUV,EAAY,MAAM,OAC9CY,EAASZ,EAAY,YAAY,KAAK,GAAG,EAC5B,OAAO,SAAS,SAAS,QAAQ,WAAY,EAAE,GAChDY,GACd,QAAQ,UACJZ,EAAY,YACZ,GACA,IAAMA,EAAY,YAAY,KAAK,GAAG,CAC1C,EAEJ,IAAMM,EAAI,IAAIC,EACVP,EAAY,MACZA,EAAY,YACZA,EAAY,OACZW,CACJ,EACA,SAAS,cAAcL,CAAC,CAC5B,CAEA,SAASL,EAAUQ,EAAwBC,EAA2B,CAClE,IAAMG,EAAYH,GAAS,QAAUxB,EAC/B4B,EAASJ,GAAS,OAElBV,EAAce,EAAWF,EAAWJ,EAAgBK,CAAM,EAChE,GAAI,CAACd,EAAa,CACd,IAAMgB,EAAWC,EACbR,EACAK,EACAD,CACJ,EACA,cAAQ,MAAMG,CAAQ,EAChB,IAAIE,EAAWF,CAAQ,CACjC,CAEA,GAAI,CAACG,EAAiBnB,CAAW,EAC7B,MAAM,IAAIoB,EAAgB,6CAA+CX,CAAc,EAG3F,OAAOT,CACX,CAEA,SAASK,EAAiBL,EAAwC,CACzDA,GACD,QAAQ,MAAM,kDAAkD,EAGpE,IAAMqB,GAAgBrB,EAAY,MAAM,QAAU,WAAW,QACzD,WACA,EACJ,EACA,GAAIqB,IAAiBzB,EACjB,MAAO,GAYX,GATA,QAAQ,IACJ,mBAAqBA,EACrB,kBAAoByB,CACxB,EAMI,OAAO,SAAS,KAChB,MAAM,MACF,uDACIA,EACA,IACR,EAGJ,QAAQ,IACJ,+BAA+BzB,CAAa,OAAOyB,CAAY,EACnE,EACA,IAAMC,EAAkB,CACpB,UAAWtB,EAAY,MAAM,KAC7B,OAAQA,EAAY,QAAU,CAAC,CACnC,EAEA,eAAe,QAAQ,mBAAoB,KAAK,UAAUsB,CAAe,CAAC,EAC1E,IAAMC,EACFF,EAAa,QAAQ,MAAM,EAAI,GACzB,IAAIA,CAAY,UAChB,IAAIA,CAAY,eAC1B,eAAQ,IAAI,kBAAmBE,CAAS,EACxC,OAAO,SAAS,KAAOA,EAChB,EACX,CAeA,SAASzB,GAA4C,CACjD,GAAI,CACA,IAAM0B,EAAsB,eAAe,QAAQ,kBAAkB,EACrE,GAAI,CAACA,EACD,MAAO,GAGX,IAAMF,EAAkB,KAAK,MAAME,CAAmB,EACtD,sBAAe,WAAW,kBAAkB,EAC5C,QAAQ,IAAI,4BAA6BF,CAAe,EACxDd,EAASc,EAAgB,UAAW,CAChC,OAAQA,EAAgB,MAC5B,CAAC,EAEM,EACX,OAASG,EAAO,CACZ,sBAAe,WAAW,kBAAkB,EAC5CC,EAAY,0CAA2C,CACnD,MAAOD,CACX,CAAC,EACM,EACX,CACJ,CAEA,SAASR,EACLR,EACAkB,EACAC,EACM,CACN,IAAIC,EAAY,GACZF,EACAE,GAAa,OAAO,QAAQF,CAAW,EAClC,IAAI,CAAC,CAACvB,EAAKD,CAAK,IAAM,GAAGC,CAAG,IAAID,CAAK,EAAE,EACvC,KAAK,IAAI,EAEd0B,EAAY,IAGhB,IAAIC,EAAYF,EAAU,IACrBG,GACG,aAAaA,EAAE,IAAI,aAAaA,EAAE,IAAI,cAClCA,EAAE,QAAU,SAChB;AAAA,CACR,EACA,MAAO,qBAAqBtB,CAAc,GAAGoB,CAAS;AAAA,EAAyBC,CAAS,EAC5F,CAEA,SAASX,EAAiBnB,EAAwC,CAC9D,GACI,CAACA,GACD,CAACA,EAAY,MAAM,QACnBA,EAAY,MAAM,OAAO,QAAU,EAEnC,MAAO,GAGX,QAASgC,EAAQ,EAAGA,EAAQhC,EAAY,MAAM,OAAO,OAAQgC,IAAS,CAClE,IAAMC,EAAUjC,EAAY,MAAM,OAAOgC,CAAK,EAC9C,IAAIE,EAASD,EAAQ,MAAMjC,CAAW,EACtC,GAAIkC,GAAU,EACV,MAAO,GAGX,GAAIA,GAAU,EACV,MAAO,GAGX,GAAIA,GAAU,EACV,MAAM,IAAId,EACN,SAASa,EAAQ,YAAY,IAAI,oBAAoBjC,EAAY,MAAM,IAAI,EAC/E,CAER,CAEA,MAAO,EACX",
+  "names": ["GuardResult", "RouteError", "RouteGuardError", "NavigateRouteEvent", "_NavigateRouteEvent", "route", "urlSegments", "routeData", "routeTarget", "eventInit", "RelaxError", "message", "context", "handler", "reportError", "message", "context", "error", "RelaxError", "handler", "suppressed", "targetHandlers", "pendingEvents", "registerRouteTarget", "name", "handler", "initRouteTargetListener", "error", "reportError", "pending", "unregisterRouteTarget", "clearPendingNavigations", "dispatchToTarget", "evt", "listenerAttached", "NavigateRouteEvent", "NumberRouteSegment", "paramName", "value", "pathValue", "StringRouteSegment", "PathRouteSegment", "_pathValue", "RouteImp", "route", "segments", "generatedSegments", "params", "index", "urlSegment", "ourSegment", "routeData", "urlSegments", "routeParams", "d", "segment", "providedValue", "convertedValue", "matchRoute", "routes", "routeNameOrUrl", "findRouteByUrl", "findRouteByName", "name", "x", "imp", "generateRouteImp", "result", "path", "routeImps", "generateRouteImps", "m", "impSegments", "RouteLink", "name", "printRoutes", "params", "attr", "paramName", "paramsAttr", "additionalParams", "error", "err", "reportError", "target", "navigate", "RelaxError", "reported", "RouteTarget", "registerRouteTarget", "evt", "unregisterRouteTarget", "error", "RelaxError", "reportError", "tagName", "element", "data", "routeData", "currentLayout", "getLayout", "path", "internalRoutes", "printRoutes", "internalRoutes", "defineRoutes", "appRoutes", "initRouteTargetListener", "RouteTarget", "RouteLink", "errs", "route", "startRouting", "newPage", "currentLayout", "match", "tryLoadRouteFromLayoutNavigation", "currentUrl", "routeResult", "findRoute", "searchParams", "value", "key", "navigateToLayout", "e", "NavigateRouteEvent", "navigate", "routeNameOrUrl", "options", "target", "ourUrl", "theRoutes", "params", "matchRoute", "errorMsg", "generateErrorMessage", "RouteError", "checkRouteGuards", "RouteGuardError", "wantedLayout", "navigationState", "layoutUrl", "navigationStateJson", "error", "reportError", "routeParams", "allRoutes", "routeData", "routesStr", "x", "index", "element", "result"]
+}

package/dist/routing/navigation.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Single Page Application routing system with multiple target support.
+ * Designed for scenarios where you need:
+ * - Multiple navigation targets (main content, modals, sidebars)
+ * - Strongly typed route parameters
+ * - History management with back/forward support
+ *
+ * @example
+ * // Configure routes
+ * const routes = [
+ *   { name: 'user', path: '/users/:id' },          // String parameter
+ *   { name: 'order', path: '/orders/;orderId' },   // Number parameter
+ *   { name: 'modal', path: '/detail/:id', target: 'modal' }  // Custom target
+ * ];
+ */
+import { type Route, type NavigateOptions } from './types';
+export declare const internalRoutes: Route[];
+export declare const MyData: {
+    routes: any[];
+};
+/**
+ * Debug helper to print all registered routes to console.
+ */
+export declare function printRoutes(): void;
+/**
+ * Registers application routes with the router.
+ * Call this at application startup before routing begins.
+ *
+ * @param appRoutes - Array of route configurations
+ * @throws Error if referenced components are not registered
+ *
+ * @example
+ * const routes: Route[] = [
+ *     { name: 'home', path: '/', componentTagName: 'app-home' },
+ *     { name: 'user', path: '/users/:id', componentTagName: 'user-profile' },
+ *     { name: 'login', path: '/auth/', componentTagName: 'login-form', layout: 'noauth' }
+ * ];
+ * defineRoutes(routes);
+ */
+export declare function defineRoutes(appRoutes: Route[]): void;
+/**
+ * Initializes routing and navigates to the current URL.
+ * Call this after DOM is ready and routes are defined.
+ *
+ * @example
+ * // In your main application component
+ * connectedCallback() {
+ *     defineRoutes(routes);
+ *     startRouting();
+ * }
+ */
+export declare function startRouting(): void;
+/**
+ * Navigates to a route by name or URL.
+ * Updates browser history and dispatches navigation events.
+ *
+ * @param routeNameOrUrl - Route name or URL path to navigate to
+ * @param options - Navigation options including params and target
+ *
+ * @example
+ * // Navigate by route name
+ * navigate('user', { params: { id: '123' } });
+ *
+ * // Navigate by URL
+ * navigate('/users/123');
+ *
+ * // Navigate to specific target
+ * navigate('detail', { params: { id: '42' }, target: 'modal' });
+ */
+export declare function navigate(routeNameOrUrl: string, options?: NavigateOptions): void;

package/dist/routing/routeMatching.d.ts

@@ -0,0 +1,21 @@
+import type { Route, RouteMatchResult } from './types';
+/**
+ * Match route by either name or URL pattern
+ * @param routes Available routes
+ * @param routeNameOrUrl Route name or URL to match
+ * @param routeData Optional parameters for named routes
+ */
+export declare function matchRoute(routes: Route[], routeNameOrUrl: string, routeData?: Record<string, string | any>): RouteMatchResult | null;
+/**
+ * Find route by name and apply parameters
+ * @param routes Available routes
+ * @param name Route name to find
+ * @param routeData Parameters to apply
+ */
+export declare function findRouteByName(routes: Route[], name: string, routeData?: Record<string, string | any>): RouteMatchResult | null;
+/**
+ * Find route matching URL pattern
+ * @param routes Available routes
+ * @param path URL to match
+ */
+export declare function findRouteByUrl(routes: Route[], path: string): RouteMatchResult | null;

package/dist/routing/routeTargetRegistry.d.ts

@@ -0,0 +1,23 @@
+import { NavigateRouteEvent } from './NavigateRouteEvent';
+type RouteTargetHandler = (evt: NavigateRouteEvent) => void;
+/**
+ * Registers a route target handler.
+ * When a navigation event targets this name, the handler is called directly.
+ * If a pending event exists for this target, it is replayed immediately.
+ *
+ * @param name - Target name, or `undefined` for the default (unnamed) target
+ * @param handler - Callback that receives the `NavigateRouteEvent`
+ *
+ * @example
+ * registerRouteTarget('sidebar', (evt) => renderComponent(evt));
+ */
+export declare function registerRouteTarget(name: string | undefined, handler: RouteTargetHandler): void;
+/**
+ * Unregisters a previously registered route target handler.
+ *
+ * @param name - Target name that was passed to `registerRouteTarget`
+ */
+export declare function unregisterRouteTarget(name: string | undefined): void;
+export declare function clearPendingNavigations(): void;
+export declare function initRouteTargetListener(): void;
+export {};

package/dist/routing/types.d.ts

@@ -0,0 +1,130 @@
+type WebComponentConstructor = new (...args: any[]) => HTMLElement;
+export declare enum GuardResult {
+    /**
+     * Handle route without checking more guards.
+     */
+    Allow = 0,
+    /**
+     * Throw a RouteGuardError.
+     */
+    Deny = 1,
+    /**
+     * Resume and check other guards.
+     */
+    Continue = 2,
+    /**
+     * Do not invoke the rooute nor other guards.
+     */
+    Stop = 3
+}
+export interface RouteGuard {
+    check(route: RouteMatchResult): GuardResult;
+}
+export interface Route {
+    name?: string;
+    target?: string;
+    path: string;
+    /**
+     * HTML file name (without extension).
+     *
+     * Define for instance if you have a route that requires a more limited layout. The library
+     * will automatically load that HTML file and rewrite URL history so that the correct url is displayed.
+     */
+    layout?: string;
+    /**
+     * Name of the tag for your web component.
+     */
+    componentTagName?: string;
+    /**
+     * Guards used to check if this route can be visited.
+     */
+    guards?: RouteGuard[];
+    component?: WebComponentConstructor;
+}
+export type RouteParamType = string | number;
+export type RouteData = Record<string, RouteParamType>;
+/**
+ * Implement to receive typed route parameters via a `routeData` property.
+ * RouteTarget assigns `routeData` after element creation but before DOM insertion.
+ * Optional since it's not available at construction time.
+ *
+ * For convention-based usage without undefined checks, skip the interface
+ * and declare `routeData` directly on your component.
+ *
+ * @example
+ * class UserProfile extends HTMLElement implements Routable<{ userName: string }> {
+ *     routeData?: { userName: string };
+ * }
+ */
+export interface Routable<T extends RouteData = RouteData> {
+    routeData?: T;
+}
+/**
+ * Implement to run async initialization before the component is added to the DOM.
+ * RouteTarget calls `loadRoute()` and awaits it before inserting the element.
+ *
+ * @example
+ * class OrderDetail extends HTMLElement implements LoadRoute<{ orderId: number }> {
+ *     async loadRoute(data: { orderId: number }) {
+ *         this.order = await fetchOrder(data.orderId);
+ *     }
+ * }
+ */
+export interface LoadRoute<T extends RouteData = RouteData> {
+    loadRoute(data: T): void | Promise<void>;
+}
+/**
+ * Result from route matching operations.
+ * Contains all information needed for navigation and rendering.
+ */
+export type RouteMatchResult = {
+    /**
+     * Matched route configuration
+     */
+    route: Route;
+    /**
+     * URL segments used for history state
+     */
+    urlSegments: string[];
+    /**
+     * Extracted and type-converted parameters
+     */
+    params: RouteData;
+};
+/**
+ * Supported types of route segments
+ */
+export type RouteSegmentType = 'string' | 'number' | 'path' | 'regex';
+/**
+ * Strongly typed route segment value
+ */
+export interface RouteValue {
+    /**
+     * Type of parameter for validation
+     */
+    type: RouteSegmentType;
+    /**
+     * Actual parameter value
+     */
+    value: any;
+}
+export declare class RouteError extends Error {
+}
+export declare class RouteGuardError extends RouteError {
+    isGuard: any;
+}
+export interface NavigateOptions {
+    /**
+     * Optional parameters when using route name
+     */
+    params?: Record<string, string | number>;
+    /**
+     * override for route's default target
+     */
+    target?: string;
+    /**
+     * When you want to override routes from the globally registered ones.
+     */
+    routes?: Route[];
+}
+export {};

package/dist/templates/NodeTemplate.d.ts

@@ -0,0 +1,38 @@
+import { ArgToken } from "./tokenizer";
+type ClickBinding = {
+    path: number[];
+    methodName: string;
+    argTokens: ArgToken[];
+};
+type BoundBinding = {
+    type: 'text';
+    node: Node;
+    func: (context: Record<string, any>, node: Node) => void;
+} | {
+    type: 'attribute';
+    element: HTMLElement;
+    name: string;
+    func: (context: Record<string, any>, element: HTMLElement) => void;
+};
+export declare class BoundNode {
+    private readonly root;
+    private readonly bindings;
+    private readonly clickBindings;
+    private readonly component?;
+    constructor(root: HTMLElement, bindings: BoundBinding[], clickBindings: ClickBinding[], component?: Record<string, any>);
+    render(data: Record<string, any>): HTMLElement;
+    private getNodeAtPath;
+}
+export declare function createBluePrint(html: string): Blueprint;
+export declare class Blueprint {
+    private readonly template;
+    private readonly bindings;
+    private readonly clickBindings;
+    constructor(htmlOrTemplate: string | HTMLTemplateElement);
+    createInstance(component?: Record<string, any>): BoundNode;
+    private getRootElement;
+    private collectBindings;
+    private collectClickBindings;
+    private getNodeAtPath;
+}
+export {};

package/dist/templates/accessorParser.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Represents a single step in a property access path
+ * Can be either a property name or an array index access
+ * @example { type: "property", key: "user" }
+ * @example { type: "index", key: "0" }
+ */
+type PathSegment = {
+    type: "property" | "index";
+    key: string;
+};
+/**
+ * Represents the result of parsing a dot-notation string into path segments
+ * Used internally by the parser to break down property access chains including arrays
+ * @example [{ type: "property", key: "users" }, { type: "index", key: "0" }, { type: "property", key: "name" }] for "users[0].name"
+ */
+type PropertyPath = PathSegment[];
+/**
+ * Function type that accesses nested properties safely from a record
+ * Returns undefined if any property in the chain is missing or null/undefined
+ * @example
+ * const accessor = createAccessor("user.name");
+ * const result = accessor(data); // string | undefined
+ */
+type PropertyAccessor<T = unknown> = (record: Record<string, any>) => T | undefined;
+/**
+ * Parser configuration options for customizing dot-notation parsing behavior
+ * Used to modify how the parser handles property paths and edge cases
+ * @example { delimiter: ".", escapeChar: "\\" }
+ */
+interface ParserOptions {
+    delimiter?: string;
+    escapeChar?: string;
+}
+/**
+ * Parses a dot-notation string with array support into path segments
+ * Handles escaped delimiters, array indices, and validates input format
+ * @param notation - Notation string with dots and brackets (e.g., "users[0].profile.name")
+ * @param options - Parser configuration options
+ * @returns Array of path segments for property and array access
+ * @example
+ * parsePath("user.profile.name") // [{ type: "property", key: "user" }, { type: "property", key: "profile" }, { type: "property", key: "name" }]
+ * parsePath("users[0].name") // [{ type: "property", key: "users" }, { type: "index", key: "0" }, { type: "property", key: "name" }]
+ * parsePath("data\\.file[1]", { escapeChar: "\\" }) // [{ type: "property", key: "data.file" }, { type: "index", key: "1" }]
+ */
+declare function parsePath(notation: string, options?: ParserOptions): PropertyPath;
+/**
+ * Creates an accessor function from a parsed property path with array support
+ * The returned function safely navigates nested objects and arrays using the parsed path
+ * @param path - Array of path segments to access in sequence
+ * @returns Function that takes a record and returns the nested value or undefined
+ * @example
+ * const path = [{ type: "property", key: "users" }, { type: "index", key: "0" }, { type: "property", key: "name" }];
+ * const accessor = createAccessorFromPath(path);
+ * accessor({ users: [{ name: "John" }] }) // "John"
+ */
+declare function createAccessorFromPath<T = unknown>(path: PropertyPath): PropertyAccessor<T>;
+/**
+ * Main parser function that creates an accessor from notation string with array support
+ * Combines path parsing and accessor creation into a single operation
+ * @param notation - Notation string with dots and brackets (e.g., "users[0].profile.name")
+ * @param options - Parser configuration options
+ * @returns Accessor function for the specified property path
+ * @example
+ * const accessor = createAccessor("user.profile.name");
+ * const name = accessor(userData); // safely gets nested property
+ *
+ * const arrayAccessor = createAccessor("users[0].name");
+ * const userName = arrayAccessor(data); // safely accesses array elements
+ *
+ * const complexAccessor = createAccessor("items[2].meta\\.data.values[1]", { escapeChar: "\\" });
+ * const value = complexAccessor(response); // handles escaped dots and nested arrays
+ */
+declare function createAccessor<T = unknown>(notation: string, options?: ParserOptions): PropertyAccessor<T>;
+/**
+ * Utility function to test if a property path exists in a record (with array support)
+ * Useful for validation before attempting to access nested properties or array elements
+ * @param notation - Notation string with dots and brackets to test
+ * @param record - Record to test against
+ * @param options - Parser configuration options
+ * @returns Boolean indicating if the complete path exists
+ * @example
+ * hasProperty("user.name", data) // true if data.user.name exists
+ * hasProperty("users[0].name", data) // true if data.users[0].name exists
+ * hasProperty("missing.path", data) // false if any part is undefined
+ */
+declare function hasProperty(notation: string, record: Record<string, any>, options?: ParserOptions): boolean;
+export { createAccessor, createAccessorFromPath, parsePath, hasProperty, type PropertyAccessor, type PropertyPath, type PathSegment, type ParserOptions, };

package/dist/templates/parseTemplate.d.ts

@@ -0,0 +1,6 @@
+import { PipeRegistry } from "../pipes";
+export type RenderTemplate = (data: Record<string, any>, component?: any) => string;
+export interface TemplateParserOptions {
+    pipeRegistry?: PipeRegistry;
+}
+export declare function compileMustard(template: string, options?: TemplateParserOptions): RenderTemplate;

package/dist/templates/tokenizer.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Represents different token types that can be identified by the tokenizer
+ * @example
+ * // Use to classify what kind of syntax element was found
+ * const tokenType = TokenType.Constant;
+ */
+export declare enum TokenType {
+    Constant = 0,
+    FunctionCall = 1,
+    Variable = 2,
+    Pipe = 3
+}
+/**
+ * Represents a token with its type and value
+ * @example
+ * // Creating a token for a number constant
+ * const token: Token = { type: TokenType.Constant, value: '42' };
+ */
+export interface Token {
+    type: TokenType;
+    value: string;
+}
+/**
+ * Tokenizes an input string into constants, function calls, and variables
+ * @example
+ * // Basic usage
+ * const tokens = tokenize('myVar.property + func(42)');
+ *
+ * @example
+ * // Handling complex expressions
+ * const tokens = tokenize('math.sin(angle) + "hello".length');
+ *
+ * @example
+ * // Handling pipes
+ * const tokens = tokenize('input | transform | display');
+ */
+export declare function tokenize(input: string): Token[];
+/** Functions */
+export type ArgToken = {
+    type: 'number';
+    value: number;
+} | {
+    type: 'string';
+    value: string;
+} | {
+    type: 'identifier';
+    value: string;
+};
+export declare function tokenizeArgs(input: string): ArgToken[];
+/** For STRING/MUSTACHE */
+export type MustacheTokenType = 'string' | 'mustache';
+/**
+ * Represents a token extracted from a template string
+ * @typedef {Object} MustahceToken
+ * @property {MustacheTokenType} type - Either 'string' for plain text or 'mustache' for mustache expressions
+ * @property {string} value - The actual content of the token
+ */
+export interface MustacheToken {
+    type: MustacheTokenType;
+    value: string;
+}
+/**
+ * Tokenizes a template string into an array of string and mustache tokens
+ * @param {string} template - The template string containing text and mustache expressions
+ * @returns {MustacheToken[]} An array of tokens representing the parsed template
+ *
+ * @example
+ * // Returns tokens for a simple greeting template
+ * tokenizeTemplate("Hello, {{name}}!");
+ * // [
+ * //   { type: 'string', value: 'Hello, ' },
+ * //   { type: 'mustache', value: '{{name}}' },
+ * //   { type: 'string', value: '!' }
+ * // ]
+ */
+export declare function tokenizeMustache(template: string): MustacheToken[];

package/dist/tools.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Resolves a deeply nested value from an object using a path array.
+ * Safely navigates through the object tree, returning undefined if any
+ * segment in the path is null or undefined.
+ *
+ * Used internally by template engines to access data properties,
+ * but also useful for general-purpose deep property access.
+ *
+ * @param path - Array of property names forming the path to the value
+ * @param context - The object to resolve the value from
+ * @returns The resolved value, or undefined if path cannot be resolved
+ *
+ * @example
+ * // Access nested property
+ * const user = { address: { city: 'Stockholm' } };
+ * const city = resolveValue(['address', 'city'], user);
+ * // Returns: 'Stockholm'
+ *
+ * @example
+ * // Safe access with missing properties
+ * const data = { user: null };
+ * const name = resolveValue(['user', 'name'], data);
+ * // Returns: undefined (doesn't throw)
+ *
+ * @example
+ * // Use with template expression paths
+ * const path = 'user.profile.avatar'.split('.');
+ * const avatar = resolveValue(path, context);
+ */
+export declare function resolveValue(path: string[], context: Record<string, any>): any | undefined;

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from '../pipes';
+export * from '../tools';
+export { generateSequentialId } from '../SequentialId';
+export { onError, reportError, RelaxError } from '../errors';

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+var ee=Object.create;var d=Object.defineProperty;var te=Object.getOwnPropertyDescriptor;var re=Object.getOwnPropertyNames;var ne=Object.getPrototypeOf,oe=Object.prototype.hasOwnProperty;var w=e=>t=>{var r=e[t];if(r)return r();throw new Error("Module not found in bundle: "+t)};var c=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),se=(e,t)=>{for(var r in t)d(e,r,{get:t[r],enumerable:!0})},T=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of re(t))!oe.call(e,o)&&o!==r&&d(e,o,{get:()=>t[o],enumerable:!(n=te(t,o))||n.enumerable});return e};var u=(e,t,r)=>(r=e!=null?ee(ne(e)):{},T(t||!e||!e.__esModule?d(r,"default",{value:e,enumerable:!0}):r,e)),ie=e=>T(d({},"__esModule",{value:!0}),e);var A=c((Pe,ue)=>{ue.exports={greeting:"Hello, {name}!",items:"{count, plural, one {# item} other {# items}}"}});var M=c((Ie,le)=>{le.exports={today:"today",yesterday:"yesterday",daysAgo:"{count, plural, one {# day ago} other {# days ago}}",pieces:"{count, plural, =0 {none} one {one} other {# pcs}}"}});var R=c((Ae,pe)=>{pe.exports={required:"This field is required.",range:"Number must be between {min} and {max}, was {actual}.",digits:"Please enter only digits."}});var b=c((Me,ge)=>{ge.exports={greeting:"Hej, {name}!",items:"{count, plural, one {# sak} other {# saker}}"}});var D=c((Re,de)=>{de.exports={today:"idag",yesterday:"ig\xE5r",daysAgo:"{count, plural, one {# dag sedan} other {# dagar sedan}}",pieces:"{count, plural, =0 {inga} one {en} other {# st}}"}});var B=c((be,fe)=>{fe.exports={required:"Detta f\xE4lt \xE4r obligatoriskt.",range:"Talet m\xE5ste vara mellan {min} och {max}, var {actual}.",digits:"Ange endast siffror."}});var Se={};se(Se,{RelaxError:()=>p,applyPipes:()=>xe,capitalizePipe:()=>L,createPipeRegistry:()=>Z,currencyPipe:()=>H,datePipe:()=>F,daysAgoPipe:()=>U,defaultPipe:()=>z,defaultPipes:()=>G,firstPipe:()=>X,generateSequentialId:()=>Q,joinPipe:()=>O,keysPipe:()=>q,lastPipe:()=>v,lowercasePipe:()=>_,onError:()=>W,piecesPipe:()=>j,reportError:()=>Y,resolveValue:()=>he,shortenPipe:()=>k,ternaryPipe:()=>V,trimPipe:()=>N,uppercasePipe:()=>$});module.exports=ie(Se);var y=new Map;function ae(e){return y.has(e)||y.set(e,new Intl.PluralRules(e)),y.get(e)}function P(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function ce(e,t,r="en"){return e.replace(/\{(\w+)(?:, (plural|select),((?:[^{}]*\{[^{}]*\})+))?\}/g,(n,o,i,a)=>{let s=t[o];if(i==="plural"){let g=new RegExp(`=${P(String(s))}\\s*\\{([^{}]*)\\}`).exec(a);if(g)return g[1].replace(`{${o}}`,String(s)).replace("#",String(s));let K=ae(r).select(s),S=new RegExp(`${K}\\s*\\{([^{}]*)\\}`).exec(a)||new RegExp("other\\s*\\{([^{}]*)\\}").exec(a);return S?S[1].replace(`{${o}}`,String(s)).replace("#",String(s)):String(s)}if(i==="select"){let g=P(String(s)),m=new RegExp(`\\b${g}\\s*\\{([^{}]*)\\}`).exec(a)||new RegExp("\\bother\\s*\\{([^{}]*)\\}").exec(a);return m?m[1]:String(s)}return s!==void 0?String(s):`{${o}}`})}var I=ce;var Ce=w({"./locales/en/r-common.json":()=>Promise.resolve().then(()=>u(A())),"./locales/en/r-pipes.json":()=>Promise.resolve().then(()=>u(M())),"./locales/en/r-validation.json":()=>Promise.resolve().then(()=>u(R())),"./locales/sv/r-common.json":()=>Promise.resolve().then(()=>u(b())),"./locales/sv/r-pipes.json":()=>Promise.resolve().then(()=>u(D())),"./locales/sv/r-validation.json":()=>Promise.resolve().then(()=>u(B()))});var me="en",x=me;var ye={},C=null;function l(e,t){let[r,n]=e.includes(":")?e.split(":"):["r-common",e],o=ye[r]?.[n];if(!o)return C&&C(n,r,x),e;try{return I(o,t,x)}catch{return e}}function h(){return x}function $(e){return String(e).toUpperCase()}function N(e){return String(e).trimEnd().trimStart()}function _(e){return String(e).toLowerCase()}function L(e){let t=String(e);return t.charAt(0).toUpperCase()+t.slice(1)}function k(e,t){let r=String(e),n=parseInt(t,10);return r.length>n?r.substring(0,n-3)+"...":r}function H(e,t="USD"){let r=h();return new Intl.NumberFormat(r,{style:"currency",currency:t}).format(e)}function F(e,t){let r=new Date(e),n=h();return t==="short"?r.toLocaleDateString(n):t==="long"?r.toLocaleDateString(n,{weekday:"long",year:"numeric",month:"long",day:"numeric"}):r.toISOString()}function U(e){if(!e)return"n/a";let t=new Date(e),r=new Date;t.setHours(0,0,0,0),r.setHours(0,0,0,0);let n=r.getTime()-t.getTime(),o=Math.round(n/(1e3*60*60*24));return o===0?l("r-pipes:today"):o===1?l("r-pipes:yesterday"):l("r-pipes:daysAgo",{count:o})}function j(e){if(e==null)return"n/a";let t=Number(e);return l("r-pipes:pieces",{count:t})}function O(e,t=","){return Array.isArray(e)?e.join(t):e}function X(e){return!Array.isArray(e)||e.length===0?"":e[0]}function v(e){return!Array.isArray(e)||e.length===0?"":e[e.length-1]}function q(e){return typeof e!="object"||e===null?[]:Object.keys(e)}function z(e,t){return e||t}function V(e,t,r){return e?t:r}function Z(){let e=new Map;return e.set("uppercase",$),e.set("lowercase",_),e.set("capitalize",L),e.set("trim",N),e.set("shorten",k),e.set("currency",H),e.set("date",F),e.set("daysAgo",U),e.set("pieces",j),e.set("join",O),e.set("first",X),e.set("last",v),e.set("keys",q),e.set("default",z),e.set("ternary",V),{lookup(t){return e.get(t)},get(t){var r=e.get(t);if(!r)throw Error("Pipe '"+t+"' not found.");return r},has(t){return e.has(t)}}}var G=Z();function xe(e,t,r=G){return t.reduce((n,o)=>{let[i,...a]=o.split(":").map(s=>s.trim());if(!r.has(i))return`[Pipe ${i} not found]`;try{return r.get(i)(n,...a)}catch(s){return`[Pipe ${i}, value: ${e}, error: ${s}]`}},e)}function he(e,t){let r=t;for(let n of e){if(r==null)return;r=r[n]}return r??void 0}var Ee=Math.floor(new Date("2025-01-01T00:00:00Z").getTime()/1e3),J=0,f=0;function Q(e){if(e<0||e>1048575)throw new Error("baseId must be between 0 and 1048575");let t=Math.floor(Date.now()/1e3);if(t===J){if(f++,f>255)throw new Error("Too many IDs generated in one second")}else J=t,f=0;let r=t-Ee;if(r>1073741823)throw new Error("Timestamp exceeds allowed range (beyond 2045-01-01)");let n=BigInt(r),o=BigInt(f),i=BigInt(e);return(n<<BigInt(28)|o<<BigInt(20)|i).toString(36).toLowerCase()}var p=class extends Error{constructor(r,n){super(r);this.context=n}},E=null;function W(e){E=e}function Y(e,t){let r=new p(e,t);if(E){let n=!1;if(E(r,{suppress(){n=!0}}),n)return null}return r}
+//# sourceMappingURL=index.js.map