@reliability-design/web 1.0.3 → 1.0.6

package/dist/components/rel-table/rel-table-head.ts

@@ -0,0 +1,33 @@
+import { LitElement, html, css } from "lit";
+import { customElement, property } from "lit/decorators.js";
+
+@customElement("rel-table-head")
+export class RelTableHead extends LitElement {
+  @property({ type: String, reflect: true }) align: "left" | "center" | "right" = "left";
+
+  static styles = css`
+    :host {
+      display: table-cell;
+      font-family: var(--rel-fontFamilies-primary);
+      padding: var(--rel-spacing-space-sm) var(--rel-spacing-space-md);
+      text-align: left;
+      font-weight: var(--rel-fontWeights-medium, 500);
+      font-size: var(--rel-fontSizes-sm);
+      color: var(--rel-colors-gray-placeholder);
+      vertical-align: middle;
+      height: 48px;
+    }
+
+    :host([align="center"]) {
+      text-align: center;
+    }
+
+    :host([align="right"]) {
+      text-align: right;
+    }
+  `;
+
+  render() {
+    return html`<slot></slot>`;
+  }
+}

package/dist/components/rel-table/rel-table-header.ts

@@ -0,0 +1,16 @@
+import { LitElement, html, css } from "lit";
+import { customElement } from "lit/decorators.js";
+
+@customElement("rel-table-header")
+export class RelTableHeader extends LitElement {
+  static styles = css`
+    :host {
+      display: table-header-group;
+      font-family: var(--rel-fontFamilies-primary);
+    }
+  `;
+
+  render() {
+    return html`<slot></slot>`;
+  }
+}

package/dist/components/rel-table/rel-table-row.ts

@@ -0,0 +1,32 @@
+import { LitElement, html, css } from "lit";
+import { customElement, property } from "lit/decorators.js";
+
+@customElement("rel-table-row")
+export class RelTableRow extends LitElement {
+  @property({ type: Boolean, reflect: true }) selected = false;
+
+  static styles = css`
+    :host {
+      display: table-row;
+      font-family: var(--rel-fontFamilies-primary);
+      border-bottom: var(--rel-borders-width-stroke-100) solid var(--rel-colors-gray-border);
+      transition: background-color 0.15s ease;
+    }
+
+    :host(:hover) {
+      background-color: var(--rel-colors-gray-light);
+    }
+
+    :host([selected]) {
+      background-color: var(--rel-colors-gray-surface);
+    }
+
+    :host([selected]:hover) {
+      background-color: var(--rel-colors-gray-warm);
+    }
+  `;
+
+  render() {
+    return html`<slot></slot>`;
+  }
+}

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

@@ -0,0 +1,47 @@
+import { LitElement, html, css } from "lit";
+import { customElement, property } from "lit/decorators.js";
+
+@customElement("rel-table")
+export class RelTable extends LitElement {
+  @property({ type: Boolean, reflect: true }) bordered = false;
+  @property({ type: Boolean, reflect: true }) compact = false;
+
+  static styles = css`
+    :host {
+      display: block;
+      font-family: var(--rel-fontFamilies-primary);
+      position: relative;
+      width: 100%;
+    }
+
+    .table-wrapper {
+      position: relative;
+      width: 100%;
+      overflow-x: auto;
+    }
+
+    :host([bordered]) .table-wrapper {
+      border: var(--rel-borders-width-stroke-100) solid var(--rel-colors-gray-border);
+      border-radius: var(--rel-borders-radius-border-radius-200);
+    }
+
+    table {
+      width: 100%;
+      caption-side: bottom;
+      border-collapse: collapse;
+      font-size: var(--rel-fontSizes-md);
+      color: var(--rel-colors-gray-primary);
+      font-family: var(--rel-fontFamilies-primary);
+    }
+  `;
+
+  render() {
+    return html`
+      <div class="table-wrapper">
+        <table>
+          <slot></slot>
+        </table>
+      </div>
+    `;
+  }
+}

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

@@ -0,0 +1,90 @@
+# rel-textfield
+
+## Overview
+
+A text input field component with support for labels, icons, validation states, and supporting text. Used for single-line text entry in forms and user interfaces.
+
+## Usage
+
+```html
+<!-- Basic usage -->
+<rel-textfield label="Email" placeholder="Enter your email"></rel-textfield>
+
+<!-- With icons and supporting text -->
+<rel-textfield
+  label="Password"
+  type="password"
+  leftIcon="🔒"
+  supportingText="Must be at least 8 characters">
+</rel-textfield>
+
+<!-- Setting value via JavaScript -->
+<rel-textfield id="myField" label="Username"></rel-textfield>
+<script>
+  const field = document.getElementById('myField');
+  field.value = 'john.doe';
+</script>
+```
+
+## API
+
+### Attributes/Properties
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `label` | `string` | - | Label text displayed above the input |
+| `placeholder` | `string` | `""` | Placeholder text |
+| `type` | `string` | `"text"` | Input type (text, email, password, etc.) |
+| `value` | `string` | `""` | Current input value |
+| `leftIcon` | `string` | - | Icon content on the left side |
+| `rightIcon` | `string` | - | Icon content on the right side |
+| `supportingText` | `string` | - | Helper or error text below input |
+| `state` | `"default" \| "focused" \| "error" \| "disabled"` | `"default"` | Visual state |
+| `size` | `"small" \| "medium" \| "large"` | `"medium"` | Size variant |
+
+## Events
+
+| Event | Detail | Description |
+|-------|--------|-------------|
+| `input-change` | `string` (the current value) | Fires when the input value changes through user interaction |
+
+## Slots
+
+Default slot not used. All content controlled via properties.
+
+## CSS Parts
+
+None exposed.
+
+## Tokens / CSS Variables
+
+- `--rel-fontFamilies-primary`: Font family
+- `--rel-fontSizes-sm`, `--rel-fontSizes-md`: Font sizes
+- `--rel-fontWeights-medium`: Font weight for label
+- `--rel-text-heading`: Label color
+- `--rel-text-primary`: Input text color
+- `--rel-text-placeholder`: Placeholder and icon color
+- `--rel-text-disabled`: Disabled text color
+- `--rel-border-default`: Default border color
+- `--rel-colors-primary-500`: Focus border color
+- `--rel-border-error`: Error state border color
+- `--rel-colors-white`: Input background (light mode)
+- `--rel-surface-surface`: Disabled background
+- `--rel-spacing-space-*`: Spacing tokens
+- `--rel-borders-radius-border-radius-200`: Border radius
+
+## Accessibility
+
+- Associates `<label>` with input via `for`/`id`
+- Supports native HTML5 input attributes (`required`, `disabled`, `readonly`, `maxlength`)
+- Focus ring visible on keyboard navigation (`:focus-visible`)
+- Error state communicated visually via border color
+- Supporting text can provide `aria-describedby` context
+
+## Notes / Edge Cases
+
+- The `state` prop overrides internal focus state if set explicitly
+- Icons are decorative (text content, not `<img>` elements)
+- Input type `password` does not auto-toggle visibility (use `rightIcon` for toggle button)
+- Error state must be set programmatically; no built-in validation
+- Disabled inputs cannot be focused or edited

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

@@ -21,22 +21,22 @@ export class RelTextfield extends LitElement {
   static styles = css`
     :host {
       display: block;
-      font-family: var(--rel-fontFamilies-primary);
+      font-family: var(--rel-fontFamilies-primary, sans-serif);
     }
 
     /* Wrapper */
     .textfield-wrapper {
       display: flex;
       flex-direction: column;
-      gap: 4px;
+      gap: var(--rel-spacing-space-2xs, 4px);
       width: 100%;
     }
 
     /* Label */
     .textfield-label {
-      font-size: 0.85rem;
-      font-weight: 500;
-      color: #111;
+      font-size: var(--rel-fontSizes-sm, 12px);
+      font-weight: var(--rel-fontWeights-medium, 500);
+      color: var(--rel-text-heading, #2b2b2b);
     }
 
     /* Container */
@@ -44,14 +44,14 @@ export class RelTextfield extends LitElement {
       display: flex;
       align-items: center;
       position: relative;
-      border: 1px solid #ccc;
-      border-radius: 6px;
-      background: white;
+      border: 1px solid var(--rel-border-default, #ddd);
+      border-radius: var(--rel-borders-radius-border-radius-200, 8px);
+      background: var(--rel-colors-white, #fff);
       transition: border 0.2s;
     }
 
     .textfield-container.disabled {
-      background: #f5f5f5;
+      background: var(--rel-surface-surface, #f5f5f5);
       cursor: not-allowed;
     }
 
@@ -60,22 +60,23 @@ export class RelTextfield extends LitElement {
       flex: 1;
       border: none;
       outline: none;
-      font-size: 0.9rem;
+      font-size: var(--rel-fontSizes-md, 14px);
       padding: 0.5rem 0.75rem;
       background: transparent;
-      font-family: var(--rel-fontFamilies-primary);
+      font-family: var(--rel-fontFamilies-primary, sans-serif);
+      color: var(--rel-text-primary, #333);
     }
 
     .textfield-input:disabled {
       cursor: not-allowed;
-      color: #999;
+      color: var(--rel-text-disabled, #9e9e9e);
     }
 
     .icon {
       position: absolute;
       display: flex;
       pointer-events: none;
-      color: #7e8186;
+      color: var(--rel-text-placeholder, #a9a9a9);
     }
 
     .icon.left {
@@ -112,25 +113,40 @@ export class RelTextfield extends LitElement {
 
     /* States */
     .textfield-wrapper.focused .textfield-container {
-      border-color: #111;
+      border-color: var(--rel-colors-primary-500, #0091ea);
+    }
+
+    .textfield-input:focus-visible {
+      outline: none;
+    }
+
+    .textfield-wrapper.focused .textfield-container,
+    .textfield-container:focus-within {
+      border-color: var(--rel-colors-primary-500, #0091ea);
+      box-shadow: 0 0 0 1px var(--rel-colors-primary-500, #0091ea);
     }
 
     .textfield-wrapper.error .textfield-container {
-      border-color: #d50000;
+      border-color: var(--rel-border-error, #cc0000);
     }
 
     .textfield-wrapper.disabled .textfield-container {
-      border-color: #d7d9db;
+      border-color: var(--rel-border-default, #ddd);
     }
 
     /* Supporting text */
     .textfield-support {
-      font-size: 0.75rem;
-      color: #666;
+      font-size: var(--rel-fontSizes-xs, 10px);
+      color: var(--rel-text-placeholder, #a9a9a9);
     }
 
     .textfield-support.error {
-      color: #d50000;
+      color: var(--rel-text-error, #cc0000);
+    }
+
+    /* Placeholder */
+    .textfield-input::placeholder {
+      color: var(--rel-text-placeholder, #a9a9a9);
     }
   `;
 

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

@@ -0,0 +1,148 @@
+# rel-toast
+
+## Overview
+A fixed-position toast notification component for brief feedback messages. Features default and error type variants, optional action buttons, auto-dismiss functionality, and slide-up animation. Positioned at the bottom-center of the viewport with `z-index: 1000`.
+
+## Usage
+```html
+<!-- Basic toast (must be shown programmatically) -->
+<rel-toast id="toast1" message="File saved successfully" type="default"></rel-toast>
+<script>
+  const toast = document.getElementById('toast1');
+  toast.show(); // Show the toast
+</script>
+
+<!-- Error toast -->
+<rel-toast id="errorToast" message="Failed to upload file" type="error"></rel-toast>
+<script>
+  document.getElementById('errorToast').show();
+</script>
+
+<!-- With action button -->
+<rel-toast
+  id="actionToast"
+  message="Connection lost"
+  actionLabel="RETRY"
+  type="default">
+</rel-toast>
+<script>
+  const actionToast = document.getElementById('actionToast');
+  actionToast.addEventListener('action', () => {
+    console.log('Retry clicked');
+    // Perform retry logic
+  });
+  actionToast.show();
+</script>
+
+<!-- Custom duration (7 seconds) -->
+<rel-toast
+  id="customDuration"
+  message="Download complete"
+  duration="7000">
+</rel-toast>
+<script>
+  document.getElementById('customDuration').show();
+</script>
+
+<!-- No auto-dismiss -->
+<rel-toast
+  id="persist"
+  message="Manual dismiss required"
+  duration="0">
+</rel-toast>
+<script>
+  const persist = document.getElementById('persist');
+  persist.show();
+  // Manually close later: persist.close();
+</script>
+
+<!-- Listen for dismiss -->
+<rel-toast id="notif" message="Update available"></rel-toast>
+<script>
+  const notif = document.getElementById('notif');
+  notif.addEventListener('dismissed', () => {
+    console.log('Toast was dismissed');
+  });
+  notif.show();
+</script>
+```
+
+## API
+
+### Attributes/Properties
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `message` | `string` | `""` | Toast message text |
+| `type` | `"default" \| "error"` | `"default"` | Visual style (default: dark gray, error: red) |
+| `actionLabel` | `string` | - | Optional action button label (e.g., "UNDO", "RETRY") |
+| `duration` | `number` | `4000` | Auto-dismiss duration in milliseconds (0 = no auto-dismiss) |
+
+### Methods
+| Method | Description |
+|--------|-------------|
+| `show()` | Display the toast and start auto-dismiss timer |
+| `close()` | Manually dismiss the toast and clear timer |
+
+## Events
+| Event | Detail | Description |
+|-------|--------|-------------|
+| `action` | None | Fired when the action button is clicked (toast auto-closes after) |
+| `dismissed` | None | Fired when toast is dismissed (via action, close button, or auto-dismiss) |
+
+## Slots
+Default slot not used.
+
+## CSS Parts
+None exposed.
+
+## Tokens / CSS Variables
+
+### Semantic Tokens
+- `--rel-fontFamilies-primary` - Font family
+- `--rel-fontSizes-md` - Font size
+
+### Spacing Tokens
+- `--rel-spacing-space-sm` - Gap between elements
+- `--rel-spacing-space-md` - Padding
+- `--rel-spacing-space-2xs` - Close button padding and margin
+
+### Color Tokens
+- `--rel-surface-toast` - Default background color (dark gray)
+- `--rel-colors-red-secondary` - Error background color
+- `--rel-colors-white` - Text and focus outline color
+- `--rel-colors-green-primary` - Action button text color
+
+### Shadow Tokens
+- `--rel-shadows-shadow-300` - Drop shadow
+
+### Border Tokens
+- `--rel-borders-radius-border-radius-200` - Border radius
+
+## Accessibility
+- Uses `role="status"` and `aria-live="polite"` for screen reader announcements
+- Focus styles on action and close buttons
+- Animation respects `prefers-reduced-motion` media query
+- Close button has `aria-label="Dismiss"`
+
+### Keyboard Interactions
+- `Tab` - Focus action button or close button
+- `Space/Enter` - Activate focused button
+
+### Focus Behavior
+- Buttons show 2px white outline with 2px offset when focused
+- Border radius applied to maintain visual consistency
+
+## Notes / Edge Cases
+- **Important:** Toasts are hidden by default; you must call `show()` to display them
+- The component uses `:host` with `position: fixed`, `bottom: 24px`, `left: 50%`, `transform: translateX(-50%)` for bottom-center positioning
+- `z-index: 1000` ensures toasts appear above most content
+- The toast container is `display: inline-flex` with `pointer-events: all` (while`:host` has `pointer-events: none`)
+- Auto-dismiss timer starts when `show()` is called
+- Calling `close()` sets `visible = false`, dispatches `dismissed`, and clears the timeout
+- Clicking the action button dispatches `action` then automatically calls `close()`
+- Setting `duration="0"` disables auto-dismiss
+- The component includes a `fadeInUp` animation (20px translateY → 0, opacity 0 → 1) on appearance
+- Animation disabled when `prefers-reduced-motion: reduce` is set
+- When `visible` is false, `hidden` class applies `display: none`
+- **Type variants**: `default` uses `--rel-surface-toast`, `error` uses `--rel-colors-red-secondary` 
+- The toast appears inline-flex, so it sizes to content width

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

@@ -31,20 +31,20 @@ export class RelToast extends LitElement {
     .toast {
       display: inline-flex;
       align-items: center;
-      gap: 12px;
-      background-color: #111;
-      color: #fff;
-      font-family: var(--rel-fontFamilies-primary);
-      font-size: 0.9rem;
-      border-radius: 8px;
-      padding: 1rem 1rem;
-      box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+      gap: var(--rel-spacing-space-sm, 12px);
+      background-color: var(--rel-surface-toast, #404040);
+      color: var(--rel-colors-white, #fff);
+      font-family: var(--rel-fontFamilies-primary, sans-serif);
+      font-size: var(--rel-fontSizes-md, 14px);
+      border-radius: var(--rel-borders-radius-border-radius-200, 8px);
+      padding: var(--rel-spacing-space-md, 16px);
+      box-shadow: var(--rel-shadows-shadow-300);
       pointer-events: all;
       animation: fadeInUp 0.25s ease;
     }
 
     .toast.error {
-      background-color: #d50000;
+      background-color: var(--rel-colors-red-secondary);
     }
 
     .toast.hidden {
@@ -60,7 +60,7 @@ export class RelToast extends LitElement {
     .toast-action {
       background: transparent;
       border: none;
-      color: #0edb90;
+      color: var(--rel-colors-green-primary);
       font-weight: 600;
       font-size: 0.85rem;
       cursor: pointer;
@@ -72,6 +72,12 @@ export class RelToast extends LitElement {
       opacity: 0.75;
     }
 
+    .toast-action:focus-visible {
+      outline: 2px solid var(--rel-colors-white, #fff);
+      outline-offset: 2px;
+      border-radius: 2px;
+    }
+
     /* Close button */
     .toast-close {
       background: transparent;
@@ -80,14 +86,26 @@ export class RelToast extends LitElement {
       font-size: 1rem;
       cursor: pointer;
       line-height: 1;
-      padding: 0;
-      margin-left: 4px;
+      padding: var(--rel-spacing-space-2xs, 4px);
+      margin-left: var(--rel-spacing-space-2xs, 4px);
     }
 
     .toast-close:hover {
       opacity: 0.75;
     }
 
+    .toast-close:focus-visible {
+      outline: 2px solid var(--rel-colors-white, #fff);
+      outline-offset: 2px;
+      border-radius: 2px;
+    }
+
+    @media (prefers-reduced-motion: reduce) {
+      .toast {
+        animation: none;
+      }
+    }
+
     /* Animations */
     @keyframes fadeInUp {
       from {
@@ -135,7 +153,7 @@ export class RelToast extends LitElement {
 
   render() {
     return html`
-      <div class="toast ${this.type} ${this.visible ? "" : "hidden"}">
+      <div class="toast ${this.type} ${this.visible ? "" : "hidden"}" role="status" aria-live="polite">
         <span class="toast-message">${this.message}</span>
 
         ${this.actionLabel
@@ -147,7 +165,7 @@ export class RelToast extends LitElement {
             </button>`
           : ""}
 
-        <button class="toast-close" @click="${this.close}">✕</button>
+        <button class="toast-close" @click="${this.close}" aria-label="Dismiss">✕</button>
       </div>
     `;
   }

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

@@ -0,0 +1,103 @@
+# rel-tooltip
+
+## Overview
+A simple tooltip component that displays contextual text on hover. Supports above/below positioning and optional tail (arrow pointer). Uses CSS opacity transitions for smooth fade-in/out effects. Content is provided via a `<slot>` for flexible trigger elements.
+
+## Usage
+```html
+<!-- Basic tooltip (above) -->
+<rel-tooltip text="This is a helpful tooltip">
+  <button>Hover me</button>
+</rel-tooltip>
+
+<!-- Tooltip positioned below -->
+<rel-tooltip text="Information appears below" position="below">
+  <span>Hover for info</span>
+</rel-tooltip>
+
+<!-- With tail/arrow -->
+<rel-tooltip text="Tooltip with pointer" position="above" showTail>
+  <button>Hover me</button>
+</rel-tooltip>
+
+<!-- Tooltip on icon -->
+<rel-tooltip text="Edit item" showTail>
+  <img src="edit-icon.svg" alt="Edit">
+</rel-tooltip>
+
+<!-- Multiple elements in trigger -->
+<rel-tooltip text="Profile options" position="below">
+  <div class="user-avatar">
+    <img src="avatar.jpg" alt="User">
+    <span>John Doe</span>
+  </div>
+</rel-tooltip>
+```
+
+## API
+
+### Attributes/Properties
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| `text` | `string` | `""` | Tooltip text content |
+| `position` | `"above" \| "below"` | `"above"` | Vertical position relative to trigger |
+| `showTail` | `boolean` | `false` | Whether to show the arrow/pointer |
+
+## Events
+None.
+
+## Slots
+| Slot | Description |
+|------|-------------|
+| (default) | Trigger element(s) that activate the tooltip on hover |
+
+## CSS Parts
+None exposed.
+
+## Tokens / CSS Variables
+
+### Semantic Tokens
+- `--rel-fontFamilies-primary` - Font family
+- `--rel-fontSizes-sm` - Font size
+
+### Spacing Tokens
+- `--rel-spacing-space-xs` - Vertical padding
+- `--rel-spacing-space-sm` - Horizontal padding
+
+### Color Tokens
+- `--rel-surface-toast` - Background color (dark gray)
+- `--rel-colors-white` - Text color
+
+### Border Tokens
+- `--rel-borders-radius-border-radius-200` - Border radius
+
+## Accessibility
+- Uses `role="tooltip"` on the tooltip bubble
+- `aria-hidden="true"` on tooltip (content is supplemental, not critical)
+- Tooltip does not receive focus (purely decorative on hover)
+- For critical information, consider alternative patterns (e.g., visible labels or expandable sections)
+
+### Keyboard Interactions
+- No keyboard interactions (hover-only)
+- For keyboard accessibility, ensure slotted content is focusable and consider showing tooltip on focus
+
+### Focus Behavior
+- Tooltip activation is hover-only by default
+- Does not interfere with focus on slotted content
+
+## Notes / Edge Cases
+- The tooltip appears on `:host(:hover)` via CSS `opacity: 1` transition
+- By default, tooltip has `opacity: 0` and `pointer-events: none`
+- **Position "above"**: tooltip is positioned at `bottom: calc(100% + 8px)` (8px gap above trigger)
+- **Position "below"**: tooltip is positioned at `top: calc(100% + 8px)` (8px gap below trigger)
+- The tooltip uses `left: 50%` and `transform: translateX(-50%)` for horizontal centering
+- `white-space: nowrap` prevents text wrapping (tooltip width adjusts to content)
+- **Tail/arrow** is a CSS triangle created with transparent borders:
+  - Above pointer: 6px border-top, positioned at `bottom: -6px`
+  - Below pointer: 6px border-bottom, positioned at `top: -6px`
+  - Tail uses `left: 50%` and `transform: translateX(-50%)` for centering
+- The tooltip has `z-index: 1000` to appear above most content
+- The tooltip is `position: absolute` relative to `:host` (which is `position: relative`)
+- `:host` is `display: inline-block` to size to slotted content
+- Transition duration is `0.2s ease` for opacity changes
+- For very long tooltip text, consider wrapping or alternative UI patterns (max-width not set by default)