@sondor-technology/sondor-components 1.0.0-1165-initial-setup.11 → 1.0.1-develop.10

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();

package/src/components/select/select.ts

@@ -1,6 +1,6 @@
 import { LitElement, html, css } from 'lit';
 import { customElement, property } from 'lit/decorators.js';
-import { resetStyles } from '../../styles/reset';
+import { resetStyles } from '../../styles/reset.js';
 
 @customElement('st-select')
 export class StSelect extends LitElement {

package/src/components/skeleton/skeleton.ts

@@ -4,26 +4,69 @@ import { resetStyles } from '../../styles/reset.js';
 
 @customElement('st-skeleton')
 export class StSkeleton extends LitElement {
-  /** Variant shape: 'text' | 'circular' | 'rectangular' */
-  @property({ type: String }) variant: 'text' | 'circular' | 'rectangular' = 'text';
-
-  /** Custom width override (e.g., '200px', '50%') */
+  @property({ type: String, reflect: true }) variant: 'text' | 'circular' | 'rectangular' = 'text';
+  @property({ type: String, reflect: true }) animation: 'shimmer' | 'pulse' | 'none' = 'shimmer';
   @property({ type: String }) width = '';
-
-  /** Custom height override (e.g., '40px', '1rem') */
   @property({ type: String }) height = '';
 
+  // Apply properties directly to the :host as CSS variables when they change
+  updated(changedProperties: Map<string | number | symbol, unknown>) {
+    super.updated(changedProperties);
+    
+    if (changedProperties.has('width')) {
+      if (this.width) {
+        this.style.setProperty('--st-skeleton-width', this.width);
+      } else {
+        this.style.removeProperty('--st-skeleton-width');
+      }
+    }
+    
+    if (changedProperties.has('height')) {
+      if (this.height) {
+        this.style.setProperty('--st-skeleton-height', this.height);
+      } else {
+        this.style.removeProperty('--st-skeleton-height');
+      }
+    }
+  }
+
   static styles = [
     resetStyles,
     css`
       :host {
         display: block;
-        width: 100%;
+        
+        /* Define base sizing variables that can be overridden by props */
+        --_width: var(--st-skeleton-width, 100%);
+        --_height: var(--st-skeleton-height, 1em);
+        
+        /* 
+          CRITICAL FIX: Apply sizing directly to the host. 
+          This allows external classes and styles (like margin: auto) to work perfectly.
+        */
+        width: var(--_width);
+        height: var(--_height);
+        
+        /* Expose radius as a token for external theme overrides */
+        --st-skeleton-radius: var(--st-radius-sm, 0.25rem);
+      }
+
+      /* Shape Variants adjust the host's sizing variables */
+      :host([variant="circular"]) {
+        --_width: var(--st-skeleton-width, 2.5rem);
+        --_height: var(--st-skeleton-height, 2.5rem);
+      }
+
+      :host([variant="rectangular"]) {
+        --_height: var(--st-skeleton-height, 8rem);
       }
 
       .skeleton {
-        width: var(--st-skeleton-width, 100%);
-        height: var(--st-skeleton-height, 1em);
+        /* The inner element simply fills the host */
+        display: block;
+        width: 100%;
+        height: 100%;
+        
         background: linear-gradient(
           90deg,
           var(--st-color-surface-muted, #f1f5f9) 25%,
@@ -31,33 +74,57 @@ export class StSkeleton extends LitElement {
           var(--st-color-surface-muted, #f1f5f9) 63%
         );
         background-size: 400% 100%;
-        animation: st-shimmer 1.4s ease infinite;
-        border-radius: var(--st-radius-sm, 0.25rem);
+        border-radius: var(--st-skeleton-radius);
+        
+        /* Prevent accidental selection */
+        user-select: none;
+        pointer-events: none;
       }
 
       :host([variant="circular"]) .skeleton {
         border-radius: 50%;
-        height: var(--st-skeleton-height, 2.5rem);
-        width: var(--st-skeleton-width, 2.5rem);
       }
 
-      :host([variant="rectangular"]) .skeleton {
-        height: var(--st-skeleton-height, 8rem);
+      /* Animations */
+      :host([animation="shimmer"]) .skeleton {
+        animation: st-shimmer 1.4s ease infinite;
+      }
+
+      :host([animation="pulse"]) .skeleton {
+        background: var(--st-color-surface-muted, #f1f5f9);
+        animation: st-pulse 1.5s ease-in-out infinite;
+      }
+
+      :host([animation="none"]) .skeleton {
+        background: var(--st-color-surface-muted, #f1f5f9);
+        animation: none;
+      }
+
+      /* Accessibility: Respect OS reduced motion settings */
+      @media (prefers-reduced-motion: reduce) {
+        .skeleton {
+          animation: none !important;
+          background: var(--st-color-surface-muted, #f1f5f9) !important;
+        }
       }
 
       @keyframes st-shimmer {
         0% { background-position: 100% 0; }
-        100% { background-position: 0 0; }
+        100% { background-position: -100% 0; }
+      }
+
+      @keyframes st-pulse {
+        0% { opacity: 1; }
+        50% { opacity: 0.4; }
+        100% { opacity: 1; }
       }
     `
   ];
 
   render() {
-    const style = `
-      ${this.width ? `--st-skeleton-width: ${this.width};` : ''}
-      ${this.height ? `--st-skeleton-height: ${this.height};` : ''}
+    return html`
+      <div class="skeleton" aria-hidden="true" part="base"></div>
     `;
-    return html`<div class="skeleton" style=${style}></div>`;
   }
 }
 

package/src/components/vertical-nav/vertical-nav-group.ts

@@ -6,38 +6,58 @@ import { resetStyles } from '../../styles/reset.js';
 export class StNavGroup extends LitElement {
   @property({ type: String }) label = '';
   @property({ type: Boolean, reflect: true }) open = false;
+  @property({ type: Number }) depth = 0;
 
   static styles = [
     resetStyles,
     css`
       :host {
         display: block;
-        margin-bottom: var(--st-spacing-sm);
+        margin-bottom: 2px;
+        overflow: hidden;
       }
 
       button {
         display: flex;
         align-items: center;
-        justify-content: space-between;
+        gap: var(--st-spacing-sm, 8px);
         width: 100%;
+        box-sizing: border-box;
         background: transparent;
         border: none;
-        padding: var(--st-spacing-xs) var(--st-spacing-lg);
+        padding: var(--st-spacing-sm) var(--st-spacing-xl);
+        padding-left: calc(var(--st-spacing-xl, 24px) + (var(--nav-depth, 0) * 16px));
         color: var(--st-color-text);
         font-size: var(--st-font-size-sm);
-        font-weight: var(--st-font-weight-bold);
+        font-weight: var(--st-font-weight-semibold);
         cursor: pointer;
-        text-align: left;
-        transition: color 0.2s ease;
+        transition: background-color 0.2s ease, color 0.2s ease;
       }
 
       button:hover {
-        color: var(--st-color-primary);
+        background-color: var(--st-color-surface-hover, rgba(0,0,0,0.03));
+      }
+
+      /* Styles for slotted icons */
+      ::slotted([slot="icon"]) {
+        width: 1rem;
+        height: 1rem;
+        flex-shrink: 0;
+        color: var(--st-color-text-muted);
       }
 
-      svg {
+      .label {
+        flex: 1;
+        white-space: nowrap;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        text-align: left;
+      }
+
+      svg.chevron {
         width: 1rem;
         height: 1rem;
+        flex-shrink: 0;
         fill: none;
         stroke: currentColor;
         stroke-width: 2;
@@ -46,12 +66,10 @@ export class StNavGroup extends LitElement {
         transition: transform 0.2s ease;
       }
 
-      /* Rotate Chevron when open */
-      :host([open]) svg {
+      :host([open]) svg.chevron {
         transform: rotate(180deg);
       }
 
-      /* Modern CSS Grid Animation trick for accordion height */
       .drawer {
         display: grid;
         grid-template-rows: 0fr;
@@ -66,7 +84,6 @@ export class StNavGroup extends LitElement {
         overflow: hidden;
         display: flex;
         flex-direction: column;
-        gap: 2px;
       }
     `
   ];
@@ -77,21 +94,23 @@ export class StNavGroup extends LitElement {
 
   render() {
     return html`
-      <button @click=${this._toggle} aria-expanded=${this.open}>
-        ${this.label}
-        <svg viewBox="0 0 24 24">
-          <path d="M6 9l6 6 6-6"></path>
-        </svg>
+      <button @click=${this._toggle} aria-expanded=${this.open} style="--nav-depth: ${this.depth}">
+        <slot name="icon"></slot>
+        <span class="label">${this.label}</span>
+        <svg class="chevron" viewBox="0 0 24 24"><path d="M6 9l6 6 6-6"></path></svg>
       </button>
       
       <div class="drawer">
         <div class="drawer-content">
-          <!-- We add slight padding top/bottom so the inner links breathe -->
-          <div style="padding: 4px 0;">
-            <slot></slot>
-          </div>
+          <slot></slot>
         </div>
       </div>
     `;
   }
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'st-vertical-nav-group': StNavGroup;
+  }
 }

package/src/components/vertical-nav/vertical-nav-item.ts

@@ -6,45 +6,68 @@ import { resetStyles } from '../../styles/reset.js';
 export class StNavItem extends LitElement {
   @property({ type: String }) href = '#';
   @property({ type: Boolean, reflect: true }) active = false;
+  @property({ type: Number }) depth = 0;
 
   static styles = [
     resetStyles,
     css`
       :host {
         display: block;
+        overflow: hidden;
       }
 
       a {
         display: flex;
         align-items: center;
-        padding: 6px var(--st-spacing-lg);
+        gap: var(--st-spacing-sm, 8px);
+        width: 100%;
+        box-sizing: border-box;
+        padding: 8px var(--st-spacing-xl);
+        padding-left: calc(var(--st-spacing-xl, 24px) + (var(--nav-depth, 0) * 16px));
         color: var(--st-color-text-muted);
         font-size: var(--st-font-size-sm);
         text-decoration: none;
-        border-left: 2px solid transparent;
+        border-left: 3px solid transparent;
         transition: all 0.15s ease;
+
+        white-space: nowrap;
+        overflow: hidden;
+        text-overflow: ellipsis;
       }
 
       a:hover {
         color: var(--st-color-text);
-        background-color: var(--st-color-surface);
+        background-color: var(--st-color-surface-hover, rgba(0,0,0,0.03));
+      }
+
+      ::slotted([slot="icon"]) {
+        width: 1rem;
+        height: 1rem;
+        flex-shrink: 0;
+        color: inherit;
       }
 
-      /* Active state: Purple text with a left border indicator */
       :host([active]) a {
         color: var(--st-color-primary);
         border-left-color: var(--st-color-primary);
-        font-weight: var(--st-font-weight-medium);
-        background-color: transparent;
+        font-weight: var(--st-font-weight-bold);
+        background-color: var(--st-color-primary-light, rgba(98, 0, 238, 0.05));
       }
     `
   ];
 
   render() {
     return html`
-      <a href=${this.href} part="link">
+      <a href=${this.href} part="link" style="--nav-depth: ${this.depth}">
+        <slot name="icon"></slot>
         <slot></slot>
       </a>
     `;
   }
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'st-vertical-nav-item': StNavItem;
+  }
 }