@reliability-design/web 1.0.2 → 1.0.6

package/dist/components/rel-alert/rel-alert.ts

@@ -3,12 +3,8 @@ import { customElement, property } from "lit/decorators.js";
 
 @customElement("rel-alert")
 export class RelAlert extends LitElement {
-  @property({ type: String }) type:
-    | "info"
-    | "success"
-    | "warning"
-    | "error"
-    | "neutral" = "neutral";
+  @property({ type: String })
+  type: "info" | "success" | "warning" | "error" | "neutral" = "neutral";
 
   @property({ type: String }) message1 = "";
   @property({ type: String }) message2?: string;
@@ -17,7 +13,7 @@ export class RelAlert extends LitElement {
   @property({ type: String }) urlHref?: string;
 
   @property({ type: Boolean }) dismissible = true;
-  @property({ type: Boolean }) dismissed = false;
+  @property({ type: Boolean, reflect: true }) dismissed = false;
 
   static styles = css`
     :host {
@@ -25,14 +21,16 @@ export class RelAlert extends LitElement {
       font-family: var(--rel-fontFamilies-primary);
     }
 
+    :host([dismissed]) {
+      display: none;
+    }
+
     .rel-alert {
       display: flex;
       align-items: center;
-      gap: var(--rel-spacing-space-xs); /* 8px */
+      gap: var(--rel-spacing-space-xs);
       padding: var(--rel-spacing-space-sm) var(--rel-spacing-space-md);
-      /* 12px vertical, 16px horizontal */
-      border-radius: var(--rel-borders-radius-border-radius-200); /* 8px */
-      width: fit-content;
+      border-radius: var(--rel-borders-radius-border-radius-200);
       min-width: 360px;
       box-sizing: border-box;
     }
@@ -44,8 +42,6 @@ export class RelAlert extends LitElement {
     }
 
     .rel-message1 {
-      display: flex;
-      align-items: center;
       margin: 0;
       font-size: var(--rel-fontSizes-md);
       font-weight: var(--rel-fontWeights-medium);
@@ -54,16 +50,9 @@ export class RelAlert extends LitElement {
     .rel-message2 {
       margin: 0;
       font-size: var(--rel-fontSizes-sm);
-      font-weight: var(--rel-fontWeights-regular);
       opacity: 0.9;
     }
 
-    .rel-icon {
-      display: flex;
-      align-items: center;
-      justify-content: center;
-    }
-
     .rel-icon svg {
       width: 16px;
       height: 16px;
@@ -73,8 +62,8 @@ export class RelAlert extends LitElement {
       font-size: var(--rel-fontSizes-sm);
       font-weight: var(--rel-fontWeights-medium);
       text-decoration: underline;
-      margin-top: 2px;
       color: inherit;
+      margin-top: 2px;
     }
 
     .rel-close {
@@ -82,21 +71,25 @@ export class RelAlert extends LitElement {
       background: none;
       border: none;
       cursor: pointer;
-      width: 16px;
-      height: 16px;
       opacity: 0.6;
-      padding: 0;
-      display: flex;
-      align-items: center;
-      justify-content: center;
+      color: inherit;
+      font-size: 16px;
+      padding: var(--rel-spacing-space-2xs);
+      line-height: 1;
+      border-radius: var(--rel-borders-radius-border-radius-100, 4px);
     }
 
     .rel-close:hover {
       opacity: 1;
     }
 
-    /* COLORS — using token system */
+    .rel-close:focus-visible {
+      outline: 2px solid currentColor;
+      outline-offset: 2px;
+      opacity: 1;
+    }
 
+    /* COLORS */
     .alert-info {
       background: var(--rel-background-info);
       color: var(--rel-text-info);
@@ -124,50 +117,100 @@ export class RelAlert extends LitElement {
     }
   `;
 
+  private dismissAlert() {
+    this.dismissed = true;
+
+    this.dispatchEvent(
+      new CustomEvent("dismiss", {
+        bubbles: true,
+        composed: true,
+      })
+    );
+  }
+
   private get iconSvg() {
     switch (this.type) {
       case "info":
-        return html`<svg viewBox="0 0 18 18" fill="none">
-          <path
-            d="M9 4.75c-.24 0-.44.08-.61.25-.16.16-.24.36-.24.6 0 .24.08.44.24.61.17.17.37.25.61.25.24 0 .44-.08.61-.25.17-.16.24-.36.24-.61 0-.24-.08-.44-.24-.6-.17-.17-.37-.25-.61-.25Zm.85 3.4h-1.7v5.1h1.7V8.15ZM9 .5c1.18 0 2.29.22 3.32.67 1.03.45 1.93 1.05 2.69 1.81.75.76 1.35 1.66 1.8 2.69.46 1.03.68 2.14.68 3.33 0 1.18-.22 2.29-.68 3.32-.45 1.04-1.05 1.93-1.8 2.69-.76.75-1.66 1.35-2.69 1.8-1.04.46-2.15.68-3.32.68-1.18 0-2.29-.22-3.32-.68-1.04-.45-1.93-1.05-2.69-1.8-.75-.76-1.35-1.66-1.8-2.69C1.92 11.28 1.7 10.17 1.7 9c0-1.18.22-2.29.68-3.32.45-1.04 1.05-1.93 1.8-2.69.76-.75 1.66-1.35 2.69-1.8C6.71.73 7.82.5 9 .5Z"
-            fill="#4A90E2"
-          />
-        </svg>`;
+        return html`
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="18"
+            height="18"
+            viewBox="0 0 18 18"
+            fill="none"
+          >
+            <path
+              d="M9 4.75C8.75917 4.75 8.55715 4.8316 8.39395 4.9948C8.23132 5.15743 8.15 5.35917 8.15 5.6C8.15 5.84083 8.23132 6.04285 8.39395 6.20605C8.55715 6.36868 8.75917 6.45 9 6.45C9.24083 6.45 9.44257 6.36868 9.6052 6.20605C9.7684 6.04285 9.85 5.84083 9.85 5.6C9.85 5.35917 9.7684 5.15743 9.6052 4.9948C9.44257 4.8316 9.24083 4.75 9 4.75ZM9.85 8.15L8.15 8.15L8.15 13.25L9.85 13.25L9.85 8.15ZM9 0.499999C10.1758 0.499999 11.2808 0.723266 12.315 1.1698C13.3492 1.61633 14.2488 2.22182 15.0138 2.98625C15.7788 3.75068 16.3842 4.65027 16.8302 5.685C17.2762 6.71973 17.4994 7.82473 17.5 9C17.5006 10.1753 17.2773 11.2803 16.8302 12.315C16.3842 13.3492 15.7787 14.2487 15.0137 15.0137C14.2487 15.7787 13.3492 16.3845 12.315 16.831C11.2808 17.2776 10.1758 17.5006 9 17.5C7.82417 17.4994 6.71917 17.2764 5.685 16.831C4.65083 16.3845 3.75125 15.7787 2.98625 15.0137C2.22125 14.2487 1.61577 13.3492 1.1698 12.315C0.723834 11.2808 0.500567 10.1758 0.500001 9C0.499434 7.82417 0.722701 6.71917 1.1698 5.685C1.61577 4.65083 2.22125 3.75125 2.98625 2.98625C3.75125 2.22125 4.65084 1.61577 5.685 1.1698C6.71917 0.723832 7.82417 0.500566 9 0.499999ZM9 2.2C7.10167 2.2 5.49375 2.85875 4.17625 4.17625C2.85875 5.49375 2.2 7.10167 2.2 9C2.2 10.8983 2.85875 12.5062 4.17625 13.8237C5.49375 15.1412 7.10167 15.8 9 15.8C10.8983 15.8 12.5062 15.1412 13.8237 13.8237C15.1412 12.5062 15.8 10.8983 15.8 9C15.8 7.10167 15.1413 5.49375 13.8238 4.17625C12.5063 2.85875 10.8983 2.2 9 2.2Z"
+              fill="var(--rel-icon-info)"
+            />
+          </svg>
+        `;
       case "success":
-        return html`<svg viewBox="0 0 18 18" fill="none">
-          <path
-            d="M7.81 12.91 13.8 6.92l-1.19-1.19L7.81 10.53 5.39 8.11 4.2 9.3l3.61 3.61ZM9 17.5a8.49 8.49 0 1 1 0-17 8.49 8.49 0 0 1 0 17Z"
-            fill="#4CAA47"
-          />
-        </svg>`;
+        return html`
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="18"
+            height="18"
+            viewBox="0 0 18 18"
+            fill="none"
+          >
+            <path
+              d="M7.81 12.91L13.8025 6.9175L12.6125 5.7275L7.81 10.53L5.3875 8.1075L4.1975 9.2975L7.81 12.91ZM9 17.5C7.82417 17.5 6.71917 17.2767 5.685 16.8302C4.65083 16.3837 3.75125 15.7782 2.98625 15.0138C2.22125 14.2493 1.61577 13.3497 1.1698 12.315C0.723834 11.2803 0.500568 10.1753 0.500001 9C0.499434 7.82473 0.722701 6.71973 1.1698 5.685C1.61577 4.65083 2.22125 3.75125 2.98625 2.98625C3.75125 2.22125 4.65083 1.61548 5.685 1.16895C6.71917 0.722418 7.82417 0.499434 9 0.500001C10.1758 0.500568 11.2808 0.723551 12.315 1.16895C13.3492 1.61548 14.2488 2.22125 15.0138 2.98625C15.7788 3.75125 16.3842 4.65083 16.8302 5.685C17.2762 6.71917 17.4994 7.82417 17.5 9C17.5006 10.1758 17.2773 11.2808 16.8302 12.315C16.3842 13.3492 15.7788 14.2488 15.0138 15.0138C14.2488 15.7788 13.3492 16.3842 12.315 16.8302C11.2808 17.2762 10.1758 17.4994 9 17.5ZM9 15.8C10.8983 15.8 12.5062 15.1412 13.8237 13.8237C15.1412 12.5062 15.8 10.8983 15.8 9C15.8 7.10167 15.1412 5.49375 13.8237 4.17625C12.5062 2.85875 10.8983 2.2 9 2.2C7.10167 2.2 5.49375 2.85875 4.17625 4.17625C2.85875 5.49375 2.2 7.10167 2.2 9C2.2 10.8983 2.85875 12.5062 4.17625 13.8237C5.49375 15.1412 7.10167 15.8 9 15.8Z"
+              fill="var(--rel-icon-success)"
+            />
+          </svg>
+        `;
       case "warning":
-        return html`<svg viewBox="0 0 16 14" fill="none">
-          <path
-            d="M0 14 8 0l8 14H0Zm2.51-1.47h10.98L8 2.95 2.51 12.53ZM8 11.79c.21 0 .38-.07.52-.21.14-.14.21-.31.21-.52 0-.21-.07-.38-.21-.52A.7.7 0 0 0 8 10.32a.7.7 0 0 0-.52.21c-.14.14-.21.31-.21.52 0 .21.07.38.21.52.14.14.31.21.52.21Zm-.73-2.21h1.46V5.89H7.27v3.69Z"
-            fill="#FF6D00"
-          />
-        </svg>`;
+        return html`
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="16"
+            height="14"
+            viewBox="0 0 16 14"
+            fill="none"
+          >
+            <path
+              d="M0 14L8 0L16 14H0ZM2.50909 12.5263H13.4909L8 2.94737L2.50909 12.5263ZM8 11.7895C8.20606 11.7895 8.37891 11.7187 8.51855 11.5773C8.6577 11.4363 8.72727 11.2614 8.72727 11.0526C8.72727 10.8439 8.6577 10.669 8.51855 10.528C8.37891 10.3865 8.20606 10.3158 8 10.3158C7.79394 10.3158 7.62133 10.3865 7.48218 10.528C7.34255 10.669 7.27273 10.8439 7.27273 11.0526C7.27273 11.2614 7.34255 11.4363 7.48218 11.5773C7.62133 11.7187 7.79394 11.7895 8 11.7895ZM7.27273 9.57895H8.72727V5.89474H7.27273V9.57895Z"
+              fill="var(--rel-icon-warning)"
+            />
+          </svg>
+        `;
       case "error":
-        return html`<svg viewBox="0 0 18 18" fill="none">
-          <path
-            d="M9 13.25c.24 0 .44-.08.61-.24.17-.17.24-.38.24-.61 0-.24-.08-.44-.24-.61-.17-.16-.37-.24-.61-.24-.24 0-.44.08-.61.24-.17.17-.24.37-.24.61 0 .24.08.44.24.61.17.16.37.24.61.24Zm-.85-3.4h1.7V4.75h-1.7v5.1ZM9 17.5c-1.18 0-2.29-.23-3.32-.68C4.64 16.37 3.74 15.77 2.99 15.02c-.75-.75-1.35-1.65-1.8-2.69C.73 11.29.5 10.18.5 9c0-1.18.23-2.29.68-3.32.45-1.03 1.05-1.93 1.8-2.69C5.03 1.23 5.94.63 6.97.18 8 .72 9.12.5 10.3.5c1.17 0 2.28.23 3.32.68 1.03.45 1.93 1.05 2.68 1.8.75.76 1.35 1.66 1.8 2.69.46 1.03.68 2.14.68 3.33 0 1.18-.22 2.29-.68 3.32-.45 1.04-1.05 1.93-1.8 2.69-.76.75-1.66 1.35-2.69 1.8-1.04.46-2.15.68-3.32.68Z"
-            fill="#C62828"
-          />
-        </svg>`;
+        return html`
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="18"
+            height="18"
+            viewBox="0 0 18 18"
+            fill="none"
+          >
+            <path
+              d="M9 13.25C9.24083 13.25 9.44285 13.1684 9.60605 13.0052C9.76868 12.8426 9.85 12.6408 9.85 12.4C9.85 12.1592 9.76868 11.9571 9.60605 11.7939C9.44285 11.6313 9.24083 11.55 9 11.55C8.75917 11.55 8.55743 11.6313 8.3948 11.7939C8.2316 11.9571 8.15 12.1592 8.15 12.4C8.15 12.6408 8.2316 12.8426 8.3948 13.0052C8.55743 13.1684 8.75917 13.25 9 13.25ZM8.15 9.85H9.85V4.75H8.15V9.85ZM9 17.5C7.82417 17.5 6.71917 17.2767 5.685 16.8302C4.65083 16.3837 3.75125 15.7782 2.98625 15.0138C2.22125 14.2493 1.61577 13.3497 1.1698 12.315C0.723834 11.2803 0.500568 10.1753 0.500001 9C0.499434 7.82473 0.722701 6.71973 1.1698 5.685C1.61577 4.65083 2.22125 3.75125 2.98625 2.98625C3.75125 2.22125 4.65083 1.61548 5.685 1.16895C6.71917 0.722418 7.82417 0.499434 9 0.500001C10.1758 0.500568 11.2808 0.723551 12.315 1.16895C13.3492 1.61548 14.2488 2.22125 15.0138 2.98625C15.7788 3.75125 16.3842 4.65083 16.8302 5.685C17.2762 6.71917 17.4994 7.82417 17.5 9C17.5006 10.1758 17.2773 11.2808 16.8302 12.315C16.3842 13.3492 15.7788 14.2488 15.0138 15.0138C14.2488 15.7788 13.3492 16.3842 12.315 16.8302C11.2808 17.2762 10.1758 17.4994 9 17.5ZM9 15.8C10.8983 15.8 12.5062 15.1412 13.8237 13.8237C15.1412 12.5062 15.8 10.8983 15.8 9C15.8 7.10167 15.1412 5.49375 13.8237 4.17625C12.5062 2.85875 10.8983 2.2 9 2.2C7.10167 2.2 5.49375 2.85875 4.17625 4.17625C2.85875 5.49375 2.2 7.10167 2.2 9C2.2 10.8983 2.85875 12.5062 4.17625 13.8237C5.49375 15.1412 7.10167 15.8 9 15.8Z"
+              fill="var(--rel-icon-error)"
+            />
+          </svg>
+        `;
       default:
-        return html``;
+        return html`
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            width="18"
+            height="18"
+            viewBox="0 0 18 18"
+            fill="none"
+          >
+            <path
+              d="M9 4.75C8.75917 4.75 8.55715 4.8316 8.39395 4.9948C8.23132 5.15743 8.15 5.35917 8.15 5.6C8.15 5.84083 8.23132 6.04285 8.39395 6.20605C8.55715 6.36868 8.75917 6.45 9 6.45C9.24083 6.45 9.44257 6.36868 9.6052 6.20605C9.7684 6.04285 9.85 5.84083 9.85 5.6C9.85 5.35917 9.7684 5.15743 9.6052 4.9948C9.44257 4.8316 9.24083 4.75 9 4.75ZM9.85 8.15L8.15 8.15L8.15 13.25L9.85 13.25L9.85 8.15ZM9 0.499999C10.1758 0.499999 11.2808 0.723266 12.315 1.1698C13.3492 1.61633 14.2488 2.22182 15.0138 2.98625C15.7788 3.75068 16.3842 4.65027 16.8302 5.685C17.2762 6.71973 17.4994 7.82473 17.5 9C17.5006 10.1753 17.2773 11.2803 16.8302 12.315C16.3842 13.3492 15.7787 14.2487 15.0137 15.0137C14.2487 15.7787 13.3492 16.3845 12.315 16.831C11.2808 17.2776 10.1758 17.5006 9 17.5C7.82417 17.4994 6.71917 17.2764 5.685 16.831C4.65083 16.3845 3.75125 15.7787 2.98625 15.0137C2.22125 14.2487 1.61577 13.3492 1.1698 12.315C0.723834 11.2808 0.500567 10.1758 0.500001 9C0.499434 7.82417 0.722701 6.71917 1.1698 5.685C1.61577 4.65083 2.22125 3.75125 2.98625 2.98625C3.75125 2.22125 4.65084 1.61577 5.685 1.1698C6.71917 0.723832 7.82417 0.500566 9 0.499999ZM9 2.2C7.10167 2.2 5.49375 2.85875 4.17625 4.17625C2.85875 5.49375 2.2 7.10167 2.2 9C2.2 10.8983 2.85875 12.5062 4.17625 13.8237C5.49375 15.1412 7.10167 15.8 9 15.8C10.8983 15.8 12.5062 15.1412 13.8237 13.8237C15.1412 12.5062 15.8 10.8983 15.8 9C15.8 7.10167 15.1413 5.49375 13.8238 4.17625C12.5063 2.85875 10.8983 2.2 9 2.2Z"
+              fill="var(--rel-colors-black)"
+            />
+          </svg>
+        `;
     }
   }
 
-  private dismissAlert() {
-    this.dismissed = true;
-  }
-
   render() {
-    if (this.dismissed) return null;
-
     return html`
-      <div class="rel-alert alert-${this.type}">
+      <div class="rel-alert alert-${this.type}" role="alert">
         <div class="rel-icon">${this.iconSvg}</div>
 
         <div class="rel-content">
@@ -175,19 +218,19 @@ export class RelAlert extends LitElement {
 
           ${this.message2
             ? html`<p class="rel-message2">${this.message2}</p>`
-            : ""}
+            : null}
           ${this.urlText && this.urlHref
-            ? html`<a class="rel-link" href="${this.urlHref}"
-                >${this.urlText}</a
-              >`
-            : ""}
+            ? html`<a class="rel-link" href=${this.urlHref}>
+                ${this.urlText}
+              </a>`
+            : null}
         </div>
 
         ${this.dismissible
-          ? html`<button class="rel-close" @click=${this.dismissAlert}>
+          ? html`<button class="rel-close" @click=${this.dismissAlert} aria-label="Dismiss">
               ✕
             </button>`
-          : ""}
+          : null}
       </div>
     `;
   }

package/dist/components/rel-avatar/README.md

@@ -0,0 +1,119 @@
+# rel-avatar
+
+## Overview
+A circular avatar component supporting three display types: image, text initials, or custom icon content. Provides four size variants with automatic text transformation and SVG sizing for icons.
+
+## Usage
+```html
+<!-- Image avatar -->
+<rel-avatar
+  type="image"
+  src="./user-photo.jpg"
+  alt="John Doe">
+</rel-avatar>
+
+<!-- Text initials avatar -->
+<rel-avatar
+  type="text"
+  text="JD">
+</rel-avatar>
+
+<!-- Icon avatar with slotted SVG -->
+<rel-avatar type="icon">
+  <svg viewBox="0 0 24 24" fill="currentColor">
+    <path d="M12 12c2.21 0 4-1.79 4-4s-1.79-4-4-4-4 1.79-4 4 1.79 4 4 4zm0 2c-2.67 0-8 1.34-8 4v2h16v-2c0-2.66-5.33-4-8-4z"/>
+  </svg>
+</rel-avatar>
+
+<!-- Different sizes -->
+<rel-avatar type="text" text="XS" size="xs"></rel-avatar>
+<rel-avatar type="text" text="SM" size="sm"></rel-avatar>
+<rel-avatar type="text" text="MD" size="md"></rel-avatar>
+<rel-avatar type="text" text="LG" size="lg"></rel-avatar>
+
+<!-- User list with avatars -->
+<div style="display: flex; gap: 8px; align-items: center;">
+  <rel-avatar type="image" src="user1.jpg" size="sm"></rel-avatar>
+  <span>John Doe</span>
+</div>
+
+<!-- Avatar group -->
+<div style="display: flex; margin-left: -8px;">
+  <rel-avatar type="text" text="A" size="md" style="margin-left: -8px;"></rel-avatar>
+  <rel-avatar type="text" text="B" size="md" style="margin-left: -8px;"></rel-avatar>
+  <rel-avatar type="text" text="C" size="md" style="margin-left: -8px;"></rel-avatar>
+</div>
+```
+
+## API
+
+### Attributes/Properties
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `size` (reflected) | `"lg" \| "md" \| "sm" \| "xs"` | `"md"` | Avatar size variant |
+| `type` (reflected) | `"image" \| "text" \| "icon"` | `"image"` | Display type |
+| `src` | `string` | `""` | Image URL (for `type="image"`) |
+| `text` | `string` | `""` | Text content (for `type="text"`, usually initials) |
+| `alt` | `string` | `"Avatar"` | Alt text for the image |
+
+## Events
+None.
+
+## Slots
+| Slot | Description |
+|------|-------------|
+| (default) | Custom icon content (for `type="icon"`, typically an SVG) |
+
+## CSS Parts
+None exposed.
+
+## Tokens / CSS Variables
+
+### Semantic Tokens
+- `--rel-fontFamilies-primary` - Font family
+
+### Font Tokens
+- `--rel-fontSizes-xl` - Large avatar text size
+- `--rel-fontSizes-lg` - Medium avatar text size
+- `--rel-fontSizes-md` - Small avatar text size
+- `--rel-fontSizes-xs` - Extra small avatar text size
+- `--rel-fontWeights-bold` - Text font weight
+
+### Color Tokens
+- `--rel-colors-gray-heading` - Avatar background color
+- `--rel-colors-white` - Text/icon color
+
+## Accessibility
+- Image avatars include `alt` attribute for screen readers
+- Text is automatically uppercased for consistency
+- Ensure meaningful `alt` text is provided for image avatars
+
+### Keyboard Interactions
+- None (purely presentational)
+
+### Focus Behavior
+- Does not receive focus
+
+## Notes / Edge Cases
+- **Size variants**:
+  - **lg**: 40px × 40px, font-size: `--rel-fontSizes-xl`
+  - **md**: 32px × 32px, font-size: `--rel-fontSizes-lg`
+  - **sm**: 24px × 24px, font-size: `--rel-fontSizes-md`
+  - **xs**: 18px × 18px, font-size: `--rel-fontSizes-xs`
+
+- **Display types**:
+  - **image**: Displays an `<img>` with `src` and `alt`
+    - Uses `object-fit: cover` for proper image scaling
+    - Image is `width: 100%`, `height: 100%`
+  - **text**: Displays the `text` property in a `<span>`
+    - Text is automatically uppercased via `text-transform: uppercase`
+  - **icon**: Displays slotted content (typically SVG)
+    - Slotted SVGs are automatically sized to 50% of the avatar size
+
+- The avatar is always circular via `border-radius: 50%`
+- The avatar uses `overflow: hidden` to clip images to circle shape
+- Text and icons are centered using flexbox
+- The avatar is `inline-flex` for easy inline usage with text
+- The `size` and `type` attributes are reflected in HTML
+- The component uses `user-select: none` to prevent text selection
+- If `type` is `image` but `src` is empty, nothing is displayed (no fallback)

package/dist/components/rel-avatar/rel-avatar.ts

@@ -3,8 +3,11 @@ import { customElement, property } from "lit/decorators.js";
 
 @customElement("rel-avatar")
 export class RelAvatar extends LitElement {
-  @property({ type: String }) size: "lg" | "md" | "sm" | "xs" = "md";
-  @property({ type: String }) type: "image" | "text" | "icon" = "image";
+  @property({ type: String, reflect: true })
+  size: "lg" | "md" | "sm" | "xs" = "md";
+
+  @property({ type: String, reflect: true })
+  type: "image" | "text" | "icon" = "image";
 
   @property({ type: String }) src = "";
   @property({ type: String }) text = "";
@@ -31,35 +34,29 @@ export class RelAvatar extends LitElement {
       text-transform: uppercase;
     }
 
-    /* -------------------------
-        CORRECTED SIZE CLASSES
-    ------------------------- */
+    /* Sizes */
     .avatar-lg {
       width: 40px;
       height: 40px;
       font-size: var(--rel-fontSizes-xl);
-      line-height: 38px;
     }
 
     .avatar-md {
       width: 32px;
       height: 32px;
       font-size: var(--rel-fontSizes-lg);
-      line-height: 32px;
     }
 
     .avatar-sm {
       width: 24px;
       height: 24px;
       font-size: var(--rel-fontSizes-md);
-      line-height: 24px;
     }
 
     .avatar-xs {
       width: 18px;
       height: 18px;
       font-size: var(--rel-fontSizes-xs);
-      line-height: 18px;
     }
 
     img {
@@ -76,10 +73,6 @@ export class RelAvatar extends LitElement {
       justify-content: center;
     }
 
-    .icon-slot ::slotted(*) {
-      font-size: var(--rel-fontSizes-md);
-    }
-
     .icon-slot ::slotted(svg) {
       width: 50%;
       height: 50%;
@@ -89,8 +82,8 @@ export class RelAvatar extends LitElement {
   render() {
     return html`
       <div class="avatar avatar-${this.size}">
-        ${this.type === "image"
-          ? html`<img src=${this.src!} alt=${this.alt} />`
+        ${this.type === "image" && this.src
+          ? html`<img src=${this.src} alt=${this.alt} />`
           : this.type === "text"
           ? html`<span>${this.text}</span>`
           : html`<span class="icon-slot"><slot></slot></span>`}

package/dist/components/rel-badge/README.md

@@ -0,0 +1,86 @@
+# rel-badge
+
+## Overview
+A simple notification badge component displaying numeric counts or dot indicators. Supports three sizes (sm, md, lg) and two variants (number, dot). Ideal for indicating counts, status, or notifications in UI elements.
+
+## Usage
+```html
+<!-- Number badges -->
+<rel-badge number="5"></rel-badge>
+<rel-badge number="12" size="md"></rel-badge>
+<rel-badge number="99+" size="lg"></rel-badge>
+
+<!-- Dot badges (no number shown) -->
+<rel-badge variant="dot" size="sm"></rel-badge>
+<rel-badge variant="dot" size="md"></rel-badge>
+<rel-badge variant="dot" size="lg"></rel-badge>
+
+<!-- Common use case: Badge on icon/button -->
+<div style="position: relative; display: inline-block;">
+  <button>🔔 Notifications</button>
+  <rel-badge number="3" size="sm" style="position: absolute; top: -8px; right: -8px;"></rel-badge>
+</div>
+
+<!-- Sizes comparison -->
+<rel-badge number="1" size="sm"></rel-badge>
+<rel-badge number="2" size="md"></rel-badge>
+<rel-badge number="3" size="lg"></rel-badge>
+```
+
+## API
+
+### Attributes/Properties
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `number` | `string` | `""` | Text to display in number variant (can be numeric or text like "99+") |
+| `size` | `"sm" \| "md" \| "lg"` (reflected) | `"md"` | Size variant |
+| `variant` | `"dot" \| "number"` (reflected) | `"number"` | Display mode (number shows text, dot shows indicator only) |
+
+## Events
+None.
+
+## Slots
+Default slot not used.
+
+## CSS Parts
+None exposed.
+
+## Tokens / CSS Variables
+
+### Semantic Tokens
+- `--rel-fontFamilies-primary` - Font family
+- `--rel-fontWeights-semibold` - Font weight (number variant)
+- `--rel-fontSizes-xs`, `--rel-fontSizes-sm`, `--rel-fontSizes-lg` - Font sizes for number variant sizes
+
+### Color Tokens
+- `--rel-colors-red-primary` - Background color
+- `--rel-colors-white` - Text color
+
+## Accessibility
+- Purely visual indicator (no ARIA roles)
+- For critical information, ensure accompanying text or ARIA labels on parent elements
+- Screen readers will not announce badge content unless used with proper labeling
+
+### Keyboard Interactions
+- None (not focusable)
+
+### Focus Behavior
+- Not focusable
+
+## Notes / Edge Cases
+- **Number variant sizes**:
+  - **sm**: 20px × 20px, 12px font
+  - **md**: 28px × 28px, 14px font
+  - **lg**: 40px × 40px, 20px font
+- **Dot variant sizes**:
+  - **sm**: 8px × 8px
+  - **md**: 10px × 10px
+  - **lg**: 12px × 12px
+- All badges are circular (`border-radius: 50%`)
+- The `number` property accepts any string (e.g., "99+", "NEW", or numeric values)
+- In dot variant, the `number` property is ignored and nothing is rendered inside
+- The component is `display: inline-flex` for easy positioning
+- Badges use `justify-content: center` and `align-items: center` for centering content
+- `size` and `variant` are reflected attributes (appear in HTML when set)
+- Common pattern: position badges absolutely over parent elements (e.g., icons, avatar images)
+- For very large numbers, consider truncating or using "99+" format to avoid overflow

package/dist/components/rel-badge/rel-badge.ts

@@ -4,8 +4,12 @@ import { customElement, property } from "lit/decorators.js";
 @customElement("rel-badge")
 export class RelBadge extends LitElement {
   @property({ type: String }) number = "";
-  @property({ type: String }) size: "sm" | "md" | "lg" = "md";
-  @property({ type: String }) variant: "dot" | "number" = "number";
+
+  @property({ type: String, reflect: true })
+  size: "sm" | "md" | "lg" = "md";
+
+  @property({ type: String, reflect: true })
+  variant: "dot" | "number" = "number";
 
   static styles = css`
     :host {
@@ -16,43 +20,46 @@ export class RelBadge extends LitElement {
       display: inline-flex;
       align-items: center;
       justify-content: center;
-      font-family: "Poppins", sans-serif;
-      font-weight: 600;
+      font-family: var(--rel-fontFamilies-primary, sans-serif);
+      font-weight: var(--rel-fontWeights-semibold, 600);
       background-color: var(--rel-colors-red-primary);
-      color: var(--rel-colors-white);
+      color: var(--rel-colors-white, #fff);
       border-radius: 50%;
     }
 
-    /* PERFECT CIRCLES — FIXED SIZES */
+    /* NUMBER BADGES */
     .badge-sm {
       width: 20px;
       height: 20px;
-      font-size: 12px;
+      font-size: var(--rel-fontSizes-xs, 12px);
     }
 
     .badge-md {
       width: 28px;
       height: 28px;
-      font-size: 14px;
+      font-size: var(--rel-fontSizes-sm, 14px);
     }
 
     .badge-lg {
       width: 40px;
       height: 40px;
-      font-size: 20px;
+      font-size: var(--rel-fontSizes-lg, 20px);
     }
 
-    /* DOT — smaller circle */
-    .badge-dot {
-      width: 10px !important;
-      height: 10px !important;
-      padding: 0 !important;
+    /* DOT BADGES */
+    .badge-dot.badge-sm {
+      width: 8px;
+      height: 8px;
     }
 
-    .badge-number {
-      display: flex;
-      align-items: center;
-      justify-content: center;
+    .badge-dot.badge-md {
+      width: 10px;
+      height: 10px;
+    }
+
+    .badge-dot.badge-lg {
+      width: 12px;
+      height: 12px;
     }
   `;
 
@@ -61,10 +68,10 @@ export class RelBadge extends LitElement {
   }
 
   render() {
-    const isDot = this.variant === "dot";
-
     return html`
-      <span class="${this.classes}">${isDot ? "" : this.number}</span>
+      <span class="${this.classes}">
+        ${this.variant === "number" ? this.number : null}
+      </span>
     `;
   }
 }