@sondor-technology/sondor-components 1.0.1-develop.5 → 1.0.1-develop.8

package/dist/components/modal/modal.d.ts

@@ -8,10 +8,21 @@ export declare class StModal extends LitElement {
      * Title text displayed in the modal header.
      */
     heading: string;
+    /**
+     * Size of the modal (sm, md, lg, xl, xxl).
+     */
+    size: 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+    /**
+     * If true, the modal cannot be closed by clicking the backdrop or pressing Esc.
+     */
+    static: boolean;
     private dialogEl;
+    private isClosing;
     static styles: import("lit").CSSResult[];
     updated(changedProperties: PropertyValues): void;
+    private closeWithAnimation;
     private handleClose;
+    private handleCancel;
     private onDialogClose;
     private handleBackdropClick;
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/modal/modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../../../src/components/modal/modal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,cAAc,EAAE,MAAM,KAAK,CAAC;AAI5D,qBACa,OAAQ,SAAQ,UAAU;IACrC;;OAEG;IACyC,IAAI,UAAS;IAEzD;;OAEG;IACyB,OAAO,SAAM;IAExB,OAAO,CAAC,QAAQ,CAAqB;IAEtD,MAAM,CAAC,MAAM,4BAwEX;IAEF,OAAO,CAAC,iBAAiB,EAAE,cAAc,QAUxC;IAED,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,mBAAmB;IAY3B,MAAM,yCAuBL;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,OAAO,CAAC;KACrB;CACF"}
+{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../../../src/components/modal/modal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,cAAc,EAAW,MAAM,KAAK,CAAC;AAIrE,qBACa,OAAQ,SAAQ,UAAU;IACrC;;OAEG;IACyC,IAAI,UAAS;IAEzD;;OAEG;IACyB,OAAO,SAAM;IAEzC;;OAEG;IACyB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAQ;IAE3E;;OAEG;IAC0B,MAAM,UAAS;IAE3B,OAAO,CAAC,QAAQ,CAAqB;IAEtD,OAAO,CAAC,SAAS,CAAS;IAE1B,MAAM,CAAC,MAAM,4BAkHX;IAEF,OAAO,CAAC,iBAAiB,EAAE,cAAc,QAYxC;IAED,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,mBAAmB;IAe3B,MAAM,yCA4BL;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,OAAO,CAAC;KACrB;CACF"}

package/dist/components/modal/modal.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { LitElement, html, css } from 'lit';
+import { LitElement, html, css, nothing } from 'lit';
 import { customElement, property, query } from 'lit/decorators.js';
 import { resetStyles } from '../../styles/reset.js';
 let StModal = class StModal extends LitElement {
@@ -18,23 +18,55 @@ let StModal = class StModal extends LitElement {
          * Title text displayed in the modal header.
          */
         this.heading = '';
+        /**
+         * Size of the modal (sm, md, lg, xl, xxl).
+         */
+        this.size = 'md';
+        /**
+         * If true, the modal cannot be closed by clicking the backdrop or pressing Esc.
+         */
+        this.static = false;
+        this.isClosing = false;
     }
     updated(changedProperties) {
         if (changedProperties.has('open')) {
-            if (this.dialogEl) {
-                if (this.open && !this.dialogEl.open) {
+            if (this.open) {
+                this.dialogEl.classList.remove('closing');
+                this.isClosing = false;
+                if (!this.dialogEl.open) {
                     this.dialogEl.showModal();
                 }
-                else if (!this.open && this.dialogEl.open) {
-                    this.dialogEl.close();
-                }
+            }
+            else if (this.dialogEl.open && !this.isClosing) {
+                this.closeWithAnimation();
             }
         }
     }
+    closeWithAnimation() {
+        if (this.isClosing)
+            return;
+        this.isClosing = true;
+        this.dialogEl.classList.add('closing');
+        const onAnimationEnd = () => {
+            this.dialogEl.removeEventListener('animationend', onAnimationEnd);
+            this.dialogEl.classList.remove('closing');
+            this.isClosing = false;
+            if (!this.open) {
+                this.dialogEl.close();
+            }
+        };
+        this.dialogEl.addEventListener('animationend', onAnimationEnd);
+    }
     handleClose() {
         this.open = false;
         this.dispatchEvent(new CustomEvent('st-close', { bubbles: true, composed: true }));
     }
+    handleCancel(e) {
+        e.preventDefault();
+        if (!this.static) {
+            this.handleClose();
+        }
+    }
     onDialogClose() {
         if (this.open) {
             this.open = false;
@@ -42,28 +74,36 @@ let StModal = class StModal extends LitElement {
         }
     }
     handleBackdropClick(e) {
+        if (this.static)
+            return;
         const rect = this.dialogEl.getBoundingClientRect();
-        if (e.clientX < rect.left ||
+        const clickedOutside = e.clientX < rect.left ||
             e.clientX > rect.right ||
             e.clientY < rect.top ||
-            e.clientY > rect.bottom) {
+            e.clientY > rect.bottom;
+        if (clickedOutside) {
             this.handleClose();
         }
     }
     render() {
         return html `
       <dialog 
-        @cancel=${this.handleClose} 
+        class="size-${this.size}"
+        aria-labelledby=${this.heading ? 'modal-heading' : nothing}
+        @cancel=${this.handleCancel} 
         @click=${this.handleBackdropClick} 
         @close=${this.onDialogClose}
       >
         <div class="modal-header" @click=${(e) => e.stopPropagation()}>
           <slot name="header">
-            <h3 class="modal-title">${this.heading}</h3>
+            <h3 class="modal-title" id="modal-heading">${this.heading}</h3>
           </slot>
-          <button class="close-btn" @click=${this.handleClose} aria-label="Close modal">
-            <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
-          </button>
+          
+          ${!this.static ? html `
+            <button class="close-btn" @click=${this.handleClose} aria-label="Close modal">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
+            </button>
+          ` : nothing}
         </div>
         <div class="modal-body" @click=${(e) => e.stopPropagation()}>
           <slot></slot>
@@ -88,17 +128,59 @@ StModal.styles = [
         border-radius: var(--st-radius-lg, 0.5rem);
         background-color: var(--st-color-surface);
         color: var(--st-color-text);
-        width: 100%;
-        max-width: 500px;
+        
+        /* Responsive width calculation */
+        width: calc(100% - 2rem);
+        margin: auto;
+        
         box-shadow: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
         font-family: var(--st-font-family, inherit);
       }
 
+      /* Sizes */
+      dialog.size-sm { max-width: 400px; }
+      dialog.size-md { max-width: 500px; }
+      dialog.size-lg { max-width: 800px; }
+      dialog.size-xl { max-width: 1024px; }
+      dialog.size-xxl { max-width: 1280px; }
+
       dialog::backdrop {
         background-color: rgba(0, 0, 0, 0.5);
         backdrop-filter: blur(2px);
       }
 
+      /* Animations */
+      @keyframes fade-in {
+        from { opacity: 0; }
+        to { opacity: 1; }
+      }
+      @keyframes fade-out {
+        from { opacity: 1; }
+        to { opacity: 0; }
+      }
+      @keyframes slide-up {
+        from { opacity: 0; transform: translateY(20px) scale(0.95); }
+        to { opacity: 1; transform: translateY(0) scale(1); }
+      }
+      @keyframes slide-down {
+        from { opacity: 1; transform: translateY(0) scale(1); }
+        to { opacity: 0; transform: translateY(20px) scale(0.95); }
+      }
+
+      dialog[open] {
+        animation: slide-up 0.2s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+      }
+      dialog[open]::backdrop {
+        animation: fade-in 0.2s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+      }
+      
+      dialog.closing {
+        animation: slide-down 0.2s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+      }
+      dialog.closing::backdrop {
+        animation: fade-out 0.2s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+      }
+
       .modal-header {
         display: flex;
         align-items: center;
@@ -154,6 +236,12 @@ __decorate([
 __decorate([
     property({ type: String })
 ], StModal.prototype, "heading", void 0);
+__decorate([
+    property({ type: String })
+], StModal.prototype, "size", void 0);
+__decorate([
+    property({ type: Boolean })
+], StModal.prototype, "static", void 0);
 __decorate([
     query('dialog')
 ], StModal.prototype, "dialogEl", void 0);

package/dist/components/router/router.d.ts

@@ -1,7 +1,31 @@
-declare class AppRouter {
-    constructor();
+export interface RouteDefinition {
+    component: string;
+    [key: string]: unknown;
+}
+export type RouteConfig = Record<string, RouteDefinition>;
+export interface RouteMatch {
+    path: string;
+    component: string;
+    params: Record<string, string>;
+    definition: RouteDefinition;
+}
+export declare class AppRouter {
+    private _routes;
+    private _initialized;
+    constructor(routes?: RouteConfig);
+    /**
+     * Register or update the route configuration for this application.
+     */
+    setRoutes(routes: RouteConfig): void;
+    /**
+     * Programmatically navigate to an internal path.
+     */
+    navigate(path: string): void;
+    /**
+     * Matches a URL path against the registered routes.
+     */
+    matchRoute(currentPath: string): RouteMatch | null;
     private _notify;
 }
 export declare const router: AppRouter;
-export {};
 //# sourceMappingURL=router.d.ts.map

package/dist/components/router/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/components/router/router.ts"],"names":[],"mappings":"AAAA,cAAM,SAAS;IACb,cAoCC;IAED,OAAO,CAAC,OAAO;CAKhB;AAED,eAAO,MAAM,MAAM,WAAkB,CAAC"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/components/router/router.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,eAAe,CAAC;CAC7B;AASD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,YAAY,CAAS;IAE7B,YAAY,MAAM,CAAC,EAAE,WAAW,EA+B/B;IAED;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,WAAW,QAUnC;IAED;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,QAG3B;IAED;;OAEG;IACI,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA+BxD;IAED,OAAO,CAAC,OAAO;CAahB;AAGD,eAAO,MAAM,MAAM,WAAkB,CAAC"}

package/dist/components/router/router.js

@@ -1,37 +1,97 @@
-class AppRouter {
-    constructor() {
+function getRouteWeight(pattern) {
+    const segments = pattern.split('/').filter(Boolean);
+    return segments.reduce((weight, seg) => {
+        return weight + (seg.startsWith(':') ? 1 : 10);
+    }, 0);
+}
+export class AppRouter {
+    constructor(routes) {
+        this._routes = {};
+        this._initialized = false;
+        if (routes) {
+            this.setRoutes(routes);
+        }
         window.addEventListener('popstate', () => this._notify());
         document.addEventListener('click', (e) => {
-            // 1. Ignore modified clicks (Ctrl+Click, etc)
             if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) {
                 return;
             }
-            // 2. Safely traverse the path
             const path = e.composedPath();
             const link = path.find((el) => el && typeof el.hasAttribute === 'function' && el.hasAttribute('href'));
             if (!link)
                 return;
             const href = link.getAttribute('href');
             const target = link.getAttribute('target');
-            // 3. Ignore external links
             if (!href || href.startsWith('http') || href.startsWith('mailto:') || target === '_blank') {
                 return;
             }
-            // 4. Intercept internal links
             if (href.startsWith('/')) {
                 e.preventDefault();
-                window.history.pushState(null, '', href);
-                this._notify();
+                this.navigate(href);
             }
         });
-        // Broadcast initial route on load
-        // Use setTimeout to ensure all Lit components have registered first
-        setTimeout(() => this._notify(), 0);
+    }
+    /**
+     * Register or update the route configuration for this application.
+     */
+    setRoutes(routes) {
+        this._routes = routes;
+        // Trigger initial route resolution once routes are registered
+        if (!this._initialized) {
+            this._initialized = true;
+            setTimeout(() => this._notify(), 0);
+        }
+        else {
+            this._notify();
+        }
+    }
+    /**
+     * Programmatically navigate to an internal path.
+     */
+    navigate(path) {
+        window.history.pushState(null, '', path);
+        this._notify();
+    }
+    /**
+     * Matches a URL path against the registered routes.
+     */
+    matchRoute(currentPath) {
+        const sortedRoutes = Object.entries(this._routes).sort(([patternA], [patternB]) => getRouteWeight(patternB) - getRouteWeight(patternA));
+        for (const [pattern, routeDef] of sortedRoutes) {
+            const paramNames = [];
+            const regexPath = pattern.replace(/:([a-zA-Z0-9_]+)/g, (_, paramName) => {
+                paramNames.push(paramName);
+                return '([^/]+)';
+            });
+            const regex = new RegExp(`^${regexPath}$`);
+            const match = currentPath.match(regex);
+            if (match) {
+                const params = {};
+                paramNames.forEach((name, index) => {
+                    params[name] = decodeURIComponent(match[index + 1]);
+                });
+                return {
+                    path: currentPath,
+                    component: routeDef.component,
+                    params,
+                    definition: routeDef
+                };
+            }
+        }
+        return null;
     }
     _notify() {
+        const currentPath = window.location.pathname;
+        const match = this.matchRoute(currentPath);
         window.dispatchEvent(new CustomEvent('route-changed', {
-            detail: window.location.pathname
+            detail: {
+                path: currentPath,
+                component: match ? match.component : 'not-found-page',
+                params: match ? match.params : {},
+                definition: match ? match.definition : null
+            }
         }));
     }
 }
+// Export a singleton instance for standard app-wide use
 export const router = new AppRouter();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sondor-technology/sondor-components",
-  "version": "1.0.1-develop.5",
+  "version": "1.0.1-develop.8",
   "description": "",
   "main": "src/index.js",
   "types": "dist/index.d.ts",

package/src/components/modal/modal.ts

@@ -1,4 +1,4 @@
-import { LitElement, html, css, PropertyValues } from 'lit';
+import { LitElement, html, css, PropertyValues, nothing } from 'lit';
 import { customElement, property, query } from 'lit/decorators.js';
 import { resetStyles } from '../../styles/reset.js';
 
@@ -14,8 +14,20 @@ export class StModal extends LitElement {
    */
   @property({ type: String }) heading = '';
 
+  /**
+   * Size of the modal (sm, md, lg, xl, xxl).
+   */
+  @property({ type: String }) size: 'sm' | 'md' | 'lg' | 'xl' | 'xxl' = 'md';
+
+  /**
+   * If true, the modal cannot be closed by clicking the backdrop or pressing Esc.
+   */
+  @property({ type: Boolean }) static = false;
+
   @query('dialog') private dialogEl!: HTMLDialogElement;
 
+  private isClosing = false;
+
   static styles = [
     resetStyles,
     css`
@@ -29,17 +41,59 @@ export class StModal extends LitElement {
         border-radius: var(--st-radius-lg, 0.5rem);
         background-color: var(--st-color-surface);
         color: var(--st-color-text);
-        width: 100%;
-        max-width: 500px;
+        
+        /* Responsive width calculation */
+        width: calc(100% - 2rem);
+        margin: auto;
+        
         box-shadow: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
         font-family: var(--st-font-family, inherit);
       }
 
+      /* Sizes */
+      dialog.size-sm { max-width: 400px; }
+      dialog.size-md { max-width: 500px; }
+      dialog.size-lg { max-width: 800px; }
+      dialog.size-xl { max-width: 1024px; }
+      dialog.size-xxl { max-width: 1280px; }
+
       dialog::backdrop {
         background-color: rgba(0, 0, 0, 0.5);
         backdrop-filter: blur(2px);
       }
 
+      /* Animations */
+      @keyframes fade-in {
+        from { opacity: 0; }
+        to { opacity: 1; }
+      }
+      @keyframes fade-out {
+        from { opacity: 1; }
+        to { opacity: 0; }
+      }
+      @keyframes slide-up {
+        from { opacity: 0; transform: translateY(20px) scale(0.95); }
+        to { opacity: 1; transform: translateY(0) scale(1); }
+      }
+      @keyframes slide-down {
+        from { opacity: 1; transform: translateY(0) scale(1); }
+        to { opacity: 0; transform: translateY(20px) scale(0.95); }
+      }
+
+      dialog[open] {
+        animation: slide-up 0.2s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+      }
+      dialog[open]::backdrop {
+        animation: fade-in 0.2s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+      }
+      
+      dialog.closing {
+        animation: slide-down 0.2s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+      }
+      dialog.closing::backdrop {
+        animation: fade-out 0.2s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+      }
+
       .modal-header {
         display: flex;
         align-items: center;
@@ -92,21 +146,47 @@ export class StModal extends LitElement {
 
   updated(changedProperties: PropertyValues) {
     if (changedProperties.has('open')) {
-      if (this.dialogEl) {
-        if (this.open && !this.dialogEl.open) {
+      if (this.open) {
+        this.dialogEl.classList.remove('closing');
+        this.isClosing = false;
+        if (!this.dialogEl.open) {
           this.dialogEl.showModal();
-        } else if (!this.open && this.dialogEl.open) {
-          this.dialogEl.close();
         }
+      } else if (this.dialogEl.open && !this.isClosing) {
+        this.closeWithAnimation();
       }
     }
   }
 
+  private closeWithAnimation() {
+    if (this.isClosing) return;
+    this.isClosing = true;
+    this.dialogEl.classList.add('closing');
+    
+    const onAnimationEnd = () => {
+      this.dialogEl.removeEventListener('animationend', onAnimationEnd);
+      this.dialogEl.classList.remove('closing');
+      this.isClosing = false;
+      if (!this.open) {
+        this.dialogEl.close();
+      }
+    };
+    
+    this.dialogEl.addEventListener('animationend', onAnimationEnd);
+  }
+
   private handleClose() {
     this.open = false;
     this.dispatchEvent(new CustomEvent('st-close', { bubbles: true, composed: true }));
   }
 
+  private handleCancel(e: Event) {
+    e.preventDefault(); 
+    if (!this.static) {
+      this.handleClose();
+    }
+  }
+
   private onDialogClose() {
     if (this.open) {
       this.open = false;
@@ -115,13 +195,16 @@ export class StModal extends LitElement {
   }
 
   private handleBackdropClick(e: MouseEvent) {
+    if (this.static) return;
+
     const rect = this.dialogEl.getBoundingClientRect();
-    if (
+    const clickedOutside = 
       e.clientX < rect.left ||
       e.clientX > rect.right ||
       e.clientY < rect.top ||
-      e.clientY > rect.bottom
-    ) {
+      e.clientY > rect.bottom;
+
+    if (clickedOutside) {
       this.handleClose();
     }
   }
@@ -129,17 +212,22 @@ export class StModal extends LitElement {
   render() {
     return html`
       <dialog 
-        @cancel=${this.handleClose} 
+        class="size-${this.size}"
+        aria-labelledby=${this.heading ? 'modal-heading' : nothing}
+        @cancel=${this.handleCancel} 
         @click=${this.handleBackdropClick} 
         @close=${this.onDialogClose}
       >
         <div class="modal-header" @click=${(e: MouseEvent) => e.stopPropagation()}>
           <slot name="header">
-            <h3 class="modal-title">${this.heading}</h3>
+            <h3 class="modal-title" id="modal-heading">${this.heading}</h3>
           </slot>
-          <button class="close-btn" @click=${this.handleClose} aria-label="Close modal">
-            <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
-          </button>
+          
+          ${!this.static ? html`
+            <button class="close-btn" @click=${this.handleClose} aria-label="Close modal">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
+            </button>
+          ` : nothing}
         </div>
         <div class="modal-body" @click=${(e: MouseEvent) => e.stopPropagation()}>
           <slot></slot>

package/src/components/router/router.ts

@@ -1,14 +1,40 @@
-class AppRouter {
-  constructor() {
+export interface RouteDefinition {
+  component: string;
+  [key: string]: unknown; // Allows consuming apps to attach custom metadata (e.g., titles, auth roles)
+}
+
+export type RouteConfig = Record<string, RouteDefinition>;
+
+export interface RouteMatch {
+  path: string;
+  component: string;
+  params: Record<string, string>;
+  definition: RouteDefinition;
+}
+
+function getRouteWeight(pattern: string): number {
+  const segments = pattern.split('/').filter(Boolean);
+  return segments.reduce((weight, seg) => {
+    return weight + (seg.startsWith(':') ? 1 : 10);
+  }, 0);
+}
+
+export class AppRouter {
+  private _routes: RouteConfig = {};
+  private _initialized = false;
+
+  constructor(routes?: RouteConfig) {
+    if (routes) {
+      this.setRoutes(routes);
+    }
+
     window.addEventListener('popstate', () => this._notify());
     
     document.addEventListener('click', (e) => {
-      // 1. Ignore modified clicks (Ctrl+Click, etc)
       if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) {
         return;
       }
 
-      // 2. Safely traverse the path
       const path = e.composedPath();
       const link = path.find((el: any) => 
         el && typeof el.hasAttribute === 'function' && el.hasAttribute('href')
@@ -19,29 +45,90 @@ class AppRouter {
       const href = link.getAttribute('href');
       const target = link.getAttribute('target');
 
-      // 3. Ignore external links
       if (!href || href.startsWith('http') || href.startsWith('mailto:') || target === '_blank') {
         return;
       }
 
-      // 4. Intercept internal links
       if (href.startsWith('/')) {
         e.preventDefault(); 
-        window.history.pushState(null, '', href);
-        this._notify();
+        this.navigate(href);
       }
     });
+  }
+
+  /**
+   * Register or update the route configuration for this application.
+   */
+  public setRoutes(routes: RouteConfig) {
+    this._routes = routes;
 
-    // Broadcast initial route on load
-    // Use setTimeout to ensure all Lit components have registered first
-    setTimeout(() => this._notify(), 0);
+    // Trigger initial route resolution once routes are registered
+    if (!this._initialized) {
+      this._initialized = true;
+      setTimeout(() => this._notify(), 0);
+    } else {
+      this._notify();
+    }
+  }
+
+  /**
+   * Programmatically navigate to an internal path.
+   */
+  public navigate(path: string) {
+    window.history.pushState(null, '', path);
+    this._notify();
+  }
+
+  /**
+   * Matches a URL path against the registered routes.
+   */
+  public matchRoute(currentPath: string): RouteMatch | null {
+    const sortedRoutes = Object.entries(this._routes).sort(
+      ([patternA], [patternB]) => getRouteWeight(patternB) - getRouteWeight(patternA)
+    );
+
+    for (const [pattern, routeDef] of sortedRoutes) {
+      const paramNames: string[] = [];
+      const regexPath = pattern.replace(/:([a-zA-Z0-9_]+)/g, (_, paramName) => {
+        paramNames.push(paramName);
+        return '([^/]+)';
+      });
+
+      const regex = new RegExp(`^${regexPath}$`);
+      const match = currentPath.match(regex);
+
+      if (match) {
+        const params: Record<string, string> = {};
+        paramNames.forEach((name, index) => {
+          params[name] = decodeURIComponent(match[index + 1]);
+        });
+
+        return {
+          path: currentPath,
+          component: routeDef.component,
+          params,
+          definition: routeDef
+        };
+      }
+    }
+
+    return null;
   }
 
   private _notify() {
+    const currentPath = window.location.pathname;
+    const match = this.matchRoute(currentPath);
+
     window.dispatchEvent(new CustomEvent('route-changed', { 
-      detail: window.location.pathname 
+      detail: {
+        path: currentPath,
+        component: match ? match.component : 'not-found-page',
+        params: match ? match.params : {},
+        definition: match ? match.definition : null
+      }
     }));
   }
 }
 
+// Export a singleton instance for standard app-wide use
 export const router = new AppRouter();