@duskmoon-dev/core 1.3.2 → 1.5.0

package/dist/components/index.css

@@ -4144,7 +4144,8 @@
     border-color: var(--color-on-surface);
   }
 
-  .checkbox:checked:hover:not(:disabled) {
+  .checkbox:checked:hover:not(:disabled),
+  .checkbox:indeterminate:hover:not(:disabled) {
     background-color: color-mix(in oklch, var(--checkbox-color), black 10%);
     border-color: color-mix(in oklch, var(--checkbox-color), black 10%);
   }
@@ -7929,7 +7930,84 @@
  */
 
 @layer components {
-  /* Base Textarea */
+  /* ============================================
+   * TEXTAREA CONTAINER
+   * ============================================ */
+
+  .textarea-container {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+    width: 100%;
+  }
+
+  /* ============================================
+   * TEXTAREA LABEL
+   * ============================================ */
+
+  .textarea-label {
+    display: block;
+    font-size: 0.875rem;
+    font-weight: 500;
+    line-height: 1.25rem;
+    color: var(--color-on-surface);
+    margin-bottom: 0.25rem;
+  }
+
+  /* Floating Label */
+  .textarea-label-floating {
+    position: absolute;
+    top: 0.75rem;
+    left: 1rem;
+    font-size: 1rem;
+    font-weight: 400;
+    color: var(--color-on-surface-variant);
+    pointer-events: none;
+    transition: all 150ms ease-in-out;
+    transform-origin: left top;
+    z-index: 1;
+  }
+
+  /* Floating label active state - when textarea has content or focus */
+  .textarea:focus ~ .textarea-label-floating,
+  .textarea:not(:placeholder-shown) ~ .textarea-label-floating {
+    top: -0.5rem;
+    left: 0.75rem;
+    font-size: 0.75rem;
+    font-weight: 500;
+    color: var(--color-primary);
+    background-color: var(--color-surface);
+    padding: 0 0.25rem;
+  }
+
+  /* Floating label for filled variant */
+  .textarea-filled ~ .textarea-label-floating {
+    background-color: transparent;
+  }
+
+  .textarea-filled:focus ~ .textarea-label-floating,
+  .textarea-filled:not(:placeholder-shown) ~ .textarea-label-floating {
+    top: 0.25rem;
+    left: 0.75rem;
+    background-color: transparent;
+  }
+
+  /* ============================================
+   * HELPER TEXT
+   * ============================================ */
+
+  .textarea-helper {
+    font-size: 0.75rem;
+    line-height: 1rem;
+    color: var(--color-on-surface-variant);
+    margin-top: 0.25rem;
+  }
+
+  /* ============================================
+   * BASE TEXTAREA
+   * ============================================ */
+
   .textarea {
     display: block;
     width: 100%;
@@ -7977,6 +8055,15 @@
     cursor: default;
   }
 
+  /* Full Width */
+  .textarea-full {
+    width: 100%;
+  }
+
+  /* ============================================
+   * VARIANTS
+   * ============================================ */
+
   /* Filled Variant */
   .textarea-filled {
     background-color: var(--color-surface-container);
@@ -8019,23 +8106,68 @@
     box-shadow: none;
   }
 
-  /* Color Variants */
+  /* ============================================
+   * COLOR VARIANTS
+   * ============================================ */
+
+  /* Primary */
+  .textarea-primary {
+    border-color: var(--color-primary);
+  }
+
   .textarea-primary:focus-visible {
     border-color: var(--color-primary);
     box-shadow: 0 0 0 3px color-mix(in oklch, var(--color-primary) 10%, transparent);
   }
 
+  .textarea-filled.textarea-primary {
+    border-bottom-color: var(--color-primary);
+  }
+
+  .textarea-filled.textarea-primary:focus-visible {
+    border-bottom-color: var(--color-primary);
+  }
+
+  /* Secondary */
+  .textarea-secondary {
+    border-color: var(--color-secondary);
+  }
+
   .textarea-secondary:focus-visible {
     border-color: var(--color-secondary);
     box-shadow: 0 0 0 3px color-mix(in oklch, var(--color-secondary) 10%, transparent);
   }
 
+  .textarea-filled.textarea-secondary {
+    border-bottom-color: var(--color-secondary);
+  }
+
+  .textarea-filled.textarea-secondary:focus-visible {
+    border-bottom-color: var(--color-secondary);
+  }
+
+  /* Tertiary */
+  .textarea-tertiary {
+    border-color: var(--color-tertiary);
+  }
+
   .textarea-tertiary:focus-visible {
     border-color: var(--color-tertiary);
     box-shadow: 0 0 0 3px color-mix(in oklch, var(--color-tertiary) 10%, transparent);
   }
 
-  /* Semantic Colors */
+  .textarea-filled.textarea-tertiary {
+    border-bottom-color: var(--color-tertiary);
+  }
+
+  .textarea-filled.textarea-tertiary:focus-visible {
+    border-bottom-color: var(--color-tertiary);
+  }
+
+  /* ============================================
+   * SEMANTIC COLORS
+   * ============================================ */
+
   .textarea-error {
     border-color: var(--color-error);
   }
@@ -8045,6 +8177,10 @@
     box-shadow: 0 0 0 3px color-mix(in oklch, var(--color-error) 10%, transparent);
   }
 
+  .textarea-filled.textarea-error {
+    border-bottom-color: var(--color-error);
+  }
+
   .textarea-success {
     border-color: var(--color-success);
   }
@@ -8054,6 +8190,10 @@
     box-shadow: 0 0 0 3px color-mix(in oklch, var(--color-success) 10%, transparent);
   }
 
+  .textarea-filled.textarea-success {
+    border-bottom-color: var(--color-success);
+  }
+
   .textarea-warning {
     border-color: var(--color-warning);
   }
@@ -8063,7 +8203,14 @@
     box-shadow: 0 0 0 3px color-mix(in oklch, var(--color-warning) 10%, transparent);
   }
 
-  /* Size Variants */
+  .textarea-filled.textarea-warning {
+    border-bottom-color: var(--color-warning);
+  }
+
+  /* ============================================
+   * SIZE VARIANTS
+   * ============================================ */
+
   .textarea-sm {
     min-height: 4rem;
     padding: 0.5rem 0.75rem;
@@ -8080,11 +8227,18 @@
     border-radius: 0.625rem;
   }
 
-  /* Resize Options */
+  /* ============================================
+   * RESIZE OPTIONS
+   * ============================================ */
+
   .textarea-resize-none {
     resize: none;
   }
 
+  .textarea-resize-vertical {
+    resize: vertical;
+  }
+
   .textarea-resize-horizontal {
     resize: horizontal;
   }
@@ -8093,19 +8247,21 @@
     resize: both;
   }
 
-  /* Auto-resize (requires JS) */
+  /* ============================================
+   * AUTO-RESIZE (requires JS)
+   * ============================================ */
+
+  .textarea-auto-resize,
   .textarea-autosize {
     resize: none;
     overflow: hidden;
+    min-height: 3rem;
+    field-sizing: content; /* Modern CSS - auto-grows without JS in supported browsers */
   }
 
-  /* Character Counter */
-  .textarea-wrapper {
-    position: relative;
-    display: flex;
-    flex-direction: column;
-    gap: 0.25rem;
-  }
+  /* ============================================
+   * CHARACTER COUNTER
+   * ============================================ */
 
   .textarea-counter {
     font-size: 0.75rem;
@@ -8114,15 +8270,331 @@
     text-align: right;
   }
 
-  .textarea-counter-error {
+  .textarea-counter-error,
+  .textarea-counter-exceeded {
+    color: var(--color-error);
+  }
+
+  /* ============================================
+   * CONTAINER STATES
+   * ============================================ */
+
+  .textarea-container-error .textarea-label {
+    color: var(--color-error);
+  }
+
+  .textarea-container-error .textarea-helper {
     color: var(--color-error);
   }
 
+  .textarea-container-error .textarea-label-floating {
+    color: var(--color-error);
+  }
+
+  .textarea-container-error .textarea:focus ~ .textarea-label-floating {
+    color: var(--color-error);
+  }
+
+  .textarea-container-success .textarea-label {
+    color: var(--color-success);
+  }
+
+  .textarea-container-success .textarea-helper {
+    color: var(--color-success);
+  }
+
+  .textarea-container-success .textarea-label-floating {
+    color: var(--color-success);
+  }
+
+  .textarea-container-success .textarea:focus ~ .textarea-label-floating {
+    color: var(--color-success);
+  }
+
+  /* ============================================
+   * REDUCE MOTION
+   * ============================================ */
+
+  @media (prefers-reduced-motion: reduce) {
+    .textarea,
+    .textarea-label-floating {
+      transition: none;
+    }
+  }
+}
+
+/**
+ * Toggle Button Component Styles
+ * DuskMoonUI - Material Design 3 inspired toggle button
+ * Used for selecting between multiple options or toggling states
+ */
+
+@layer components {
+  /* Base toggle button */
+  .toggle-btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: 0.5rem;
+    padding: 0.625rem 1rem;
+    font-size: 0.875rem;
+    font-weight: 500;
+    line-height: 1.25rem;
+    color: var(--color-on-surface-variant);
+    background-color: transparent;
+    border: 1px solid var(--color-outline);
+    border-radius: 0.5rem;
+    cursor: pointer;
+    transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+    user-select: none;
+  }
+
+  /* Hover state */
+  .toggle-btn:hover:not(:disabled) {
+    background-color: color-mix(in oklch, var(--color-surface-variant) 50%, transparent);
+    border-color: var(--color-outline-variant);
+  }
+
+  /* Active/Selected state */
+  .toggle-btn-active,
+  .toggle-btn.active {
+    color: var(--color-on-primary-container);
+    background-color: var(--color-primary-container);
+    border-color: var(--color-primary);
+  }
+
+  .toggle-btn-active:hover:not(:disabled),
+  .toggle-btn.active:hover:not(:disabled) {
+    background-color: color-mix(in oklch, var(--color-primary-container) 90%, transparent);
+  }
+
+  /* Secondary variant */
+  .toggle-btn-secondary.toggle-btn-active,
+  .toggle-btn-secondary.active {
+    color: var(--color-on-secondary-container);
+    background-color: var(--color-secondary-container);
+    border-color: var(--color-secondary);
+  }
+
+  /* Tertiary variant */
+  .toggle-btn-tertiary.toggle-btn-active,
+  .toggle-btn-tertiary.active {
+    color: var(--color-on-tertiary-container);
+    background-color: var(--color-tertiary-container);
+    border-color: var(--color-tertiary);
+  }
+
+  /* Focus state */
+  .toggle-btn:focus-visible {
+    outline: 2px solid var(--color-primary);
+    outline-offset: 2px;
+  }
+
+  /* Disabled state */
+  .toggle-btn:disabled,
+  .toggle-btn-disabled {
+    opacity: 0.38;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+
+  /* Size variants */
+  .toggle-btn-sm {
+    padding: 0.375rem 0.75rem;
+    font-size: 0.8125rem;
+    gap: 0.375rem;
+  }
+
+  .toggle-btn-lg {
+    padding: 0.75rem 1.25rem;
+    font-size: 1rem;
+    gap: 0.625rem;
+  }
+
+  /* Toggle button group */
+  .toggle-group {
+    display: inline-flex;
+    align-items: center;
+    gap: 0;
+    border: 1px solid var(--color-outline);
+    border-radius: 0.5rem;
+    padding: 0.25rem;
+    background-color: color-mix(in oklch, var(--color-surface-variant) 30%, transparent);
+  }
+
+  /* Toggle buttons in group */
+  .toggle-group .toggle-btn {
+    border: none;
+    border-radius: 0.375rem;
+    margin: 0;
+  }
+
+  .toggle-group .toggle-btn:not(:last-child) {
+    margin-right: 0.125rem;
+  }
+
+  /* Vertical group */
+  .toggle-group-vertical {
+    flex-direction: column;
+  }
+
+  .toggle-group-vertical .toggle-btn:not(:last-child) {
+    margin-right: 0;
+    margin-bottom: 0.125rem;
+  }
+
+  /* Exclusive selection (radio-like behavior) */
+  .toggle-group-exclusive .toggle-btn {
+    flex: 1;
+  }
+
+  /* Icon-only toggle */
+  .toggle-btn-icon-only {
+    padding: 0.625rem;
+    aspect-ratio: 1;
+  }
+
+  .toggle-btn-icon-only.toggle-btn-sm {
+    padding: 0.5rem;
+  }
+
+  .toggle-btn-icon-only.toggle-btn-lg {
+    padding: 0.875rem;
+  }
+
+  /* With icon */
+  .toggle-icon {
+    width: 1.125rem;
+    height: 1.125rem;
+    flex-shrink: 0;
+  }
+
+  /* Segmented control style */
+  .toggle-segmented {
+    display: inline-flex;
+    align-items: center;
+    gap: 0;
+    background-color: var(--color-surface);
+    border: 1px solid var(--color-outline-variant);
+    border-radius: 0.5rem;
+    padding: 0.25rem;
+  }
+
+  .toggle-segmented .toggle-btn {
+    border: none;
+    background-color: transparent;
+    border-radius: 0.375rem;
+  }
+
+  .toggle-segmented .toggle-btn.toggle-btn-active,
+  .toggle-segmented .toggle-btn.active {
+    background-color: var(--color-surface-variant);
+    border-color: transparent;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
+  }
+
+  /* Chip-like toggle */
+  .toggle-chip {
+    border-radius: 1rem;
+    padding: 0.5rem 1rem;
+  }
+
+  .toggle-chip.toggle-btn-active,
+  .toggle-chip.active {
+    background-color: var(--color-primary-container);
+    border-color: var(--color-primary-container);
+  }
+
+  /* Outlined variant */
+  .toggle-outlined {
+    background-color: transparent;
+  }
+
+  .toggle-outlined.toggle-btn-active,
+  .toggle-outlined.active {
+    background-color: color-mix(in oklch, var(--color-primary) 10%, transparent);
+  }
+
+  /* Filled variant */
+  .toggle-filled {
+    background-color: var(--color-surface-variant);
+    border: none;
+  }
+
+  .toggle-filled.toggle-btn-active,
+  .toggle-filled.active {
+    background-color: var(--color-primary);
+    color: var(--color-on-primary);
+  }
+
+  /* With badge/indicator */
+  .toggle-badge {
+    position: relative;
+  }
+
+  .toggle-badge::after {
+    content: "";
+    position: absolute;
+    top: 0.25rem;
+    right: 0.25rem;
+    width: 0.5rem;
+    height: 0.5rem;
+    background-color: var(--color-error);
+    border-radius: 50%;
+    border: 2px solid var(--color-surface);
+  }
+
+  /* Full width */
+  .toggle-full {
+    width: 100%;
+  }
+
+  .toggle-group-full {
+    width: 100%;
+  }
+
+  .toggle-group-full .toggle-btn {
+    flex: 1;
+  }
+
+  /* Loading state */
+  .toggle-loading {
+    position: relative;
+    pointer-events: none;
+  }
+
+  .toggle-loading::after {
+    content: "";
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    width: 1rem;
+    height: 1rem;
+    margin-top: -0.5rem;
+    margin-left: -0.5rem;
+    border: 2px solid currentColor;
+    border-top-color: transparent;
+    border-radius: 50%;
+    animation: toggle-spin 0.6s linear infinite;
+  }
+
+  @keyframes toggle-spin {
+    0% {
+      transform: rotate(0deg);
+    }
+    100% {
+      transform: rotate(360deg);
+    }
+  }
+
   /* Reduce Motion */
   @media (prefers-reduced-motion: reduce) {
-    .textarea {
+    .toggle-btn {
       transition: none;
     }
+    .toggle-loading::after {
+      animation: none;
+    }
   }
 }
 
@@ -8420,12 +8892,24 @@
     box-shadow: 0 0 0 3px color-mix(in oklch, var(--color-primary) 10%, transparent);
   }
 
-  .tree-select-trigger:disabled {
+  .tree-select-trigger:disabled,
+  .tree-select-trigger[aria-disabled="true"] {
     cursor: not-allowed;
     opacity: 0.5;
     background-color: var(--color-surface-container);
   }
 
+  /* Support for div-based trigger (when using clear button) */
+  div.tree-select-trigger {
+    user-select: none;
+  }
+
+  div.tree-select-trigger:focus-visible {
+    outline: none;
+    border-color: var(--color-primary);
+    box-shadow: 0 0 0 3px color-mix(in oklch, var(--color-primary) 10%, transparent);
+  }
+
   /* Value Display */
   .tree-select-value {
     flex: 1;
@@ -8486,6 +8970,11 @@
     background-color: var(--color-surface-container-high);
   }
 
+  .tree-select-clear svg {
+    width: 1rem;
+    height: 1rem;
+  }
+
   /* Tree Select Dropdown */
   .tree-select-dropdown {
     position: absolute;
@@ -8508,9 +8997,10 @@
     display: block;
   }
 
-  /* Popover API Support - Browser handles visibility, JS handles positioning */
+  /* Popover API Support */
   .tree-select-dropdown[popover] {
-    /* Reset browser defaults - positioning handled by JavaScript */
+    /* Reset browser defaults for proper positioning */
+    position: absolute;
     inset: unset;
     margin: 0;
     border: 1px solid var(--color-outline-variant);
@@ -8520,6 +9010,21 @@
     display: block;
   }
 
+  /* CSS Anchor Positioning for modern browsers */
+  @supports (anchor-name: --tree-select) {
+    .tree-select {
+      anchor-name: --tree-select;
+    }
+
+    .tree-select-dropdown[popover] {
+      position-anchor: --tree-select;
+      top: anchor(bottom);
+      left: anchor(left);
+      right: anchor(right);
+      position-try-fallbacks: flip-block;
+    }
+  }
+
   /* Search Input in Dropdown */
   .tree-select-search {
     display: flex;
@@ -10524,6 +11029,12 @@
     padding: 0 1rem;
     background-color: var(--color-surface);
     color: var(--color-on-surface);
+    box-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
+  }
+
+  /* Static App Bar (default) */
+  .appbar-static {
+    position: static;
   }
 
   /* Fixed App Bar */
@@ -10542,19 +11053,47 @@
     z-index: 1000;
   }
 
-  /* App Bar with Shadow */
+  /* Top App Bar (default) */
+  .appbar-top {
+    top: 0;
+  }
+
+  /* Bottom App Bar */
+  .appbar-bottom {
+    position: fixed;
+    bottom: 0;
+    left: 0;
+    right: 0;
+    top: auto;
+    z-index: 1000;
+  }
+
+  /* App Bar with Shadow (elevated) */
   .appbar-elevated {
     box-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
   }
 
+  /* Flat App Bar (no shadow) */
+  .appbar-flat {
+    box-shadow: none;
+  }
+
   /* App Bar with Border */
   .appbar-bordered {
     border-bottom: 1px solid var(--color-outline-variant);
+    box-shadow: none;
   }
 
   /* Transparent App Bar */
   .appbar-transparent {
     background-color: transparent;
+    box-shadow: none;
+  }
+
+  /* Backdrop Blur */
+  .appbar-blur {
+    backdrop-filter: blur(8px);
+    -webkit-backdrop-filter: blur(8px);
   }
 
   /* App Bar Navigation Icon */
@@ -10664,17 +11203,125 @@
     padding: 0 0.75rem;
   }
 
-  .appbar-sm .appbar-title {
-    font-size: 1rem;
+  .appbar-sm .appbar-title {
+    font-size: 1rem;
+  }
+
+  .appbar-lg {
+    min-height: 5rem;
+    padding: 0 1.5rem;
+  }
+
+  .appbar-lg .appbar-title {
+    font-size: 1.5rem;
+  }
+
+  /* Compact Size */
+  .appbar-compact {
+    min-height: 3rem;
+    padding: 0 0.75rem;
+  }
+
+  .appbar-compact .appbar-title,
+  .appbar-compact .appbar-heading {
+    font-size: 1rem;
+    line-height: 1.5rem;
+  }
+
+  .appbar-compact .appbar-nav,
+  .appbar-compact .appbar-action,
+  .appbar-compact .appbar-back {
+    width: 2rem;
+    height: 2rem;
+  }
+
+  /* Comfortable Size */
+  .appbar-comfortable {
+    min-height: 5rem;
+    padding: 0 1.5rem;
+  }
+
+  .appbar-comfortable .appbar-title,
+  .appbar-comfortable .appbar-heading {
+    font-size: 1.5rem;
+    line-height: 2rem;
+  }
+
+  /* Section Classes */
+  .appbar-leading {
+    display: flex;
+    align-items: center;
+    gap: 0.25rem;
+    flex-shrink: 0;
+  }
+
+  .appbar-trailing {
+    display: flex;
+    align-items: center;
+    gap: 0.25rem;
+    flex-shrink: 0;
+    margin-left: auto;
+  }
+
+  /* Heading Text */
+  .appbar-heading {
+    font-size: 1.25rem;
+    font-weight: 500;
+    line-height: 1.75rem;
+    margin: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  /* Back Button */
+  .appbar-back {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 2.5rem;
+    height: 2.5rem;
+    color: var(--color-on-surface);
+    background-color: transparent;
+    border: none;
+    border-radius: 50%;
+    cursor: pointer;
+    transition: background-color 150ms ease-in-out;
+    flex-shrink: 0;
+  }
+
+  .appbar-back:hover {
+    background-color: var(--color-surface-container);
+  }
+
+  .appbar-back:focus-visible {
+    outline: 2px solid var(--color-primary);
+    outline-offset: 2px;
+  }
+
+  /* Search Input (direct on element) */
+  .appbar .appbar-search,
+  input.appbar-search {
+    flex: 1;
+    max-width: 32rem;
+    padding: 0.5rem 1rem;
+    font-size: 0.875rem;
+    color: var(--color-on-surface);
+    background-color: var(--color-surface-container);
+    border: none;
+    border-radius: 9999px;
+    transition: background-color 150ms ease-in-out;
   }
 
-  .appbar-lg {
-    min-height: 5rem;
-    padding: 0 1.5rem;
+  .appbar .appbar-search:focus,
+  input.appbar-search:focus {
+    outline: none;
+    background-color: var(--color-surface-container-high);
   }
 
-  .appbar-lg .appbar-title {
-    font-size: 1.5rem;
+  .appbar .appbar-search::placeholder,
+  input.appbar-search::placeholder {
+    color: var(--color-on-surface-variant);
   }
 
   /* Color Variants */
@@ -10715,10 +11362,53 @@
     color: var(--color-on-secondary-container);
   }
 
+  .appbar-secondary .appbar-subtitle {
+    color: var(--color-on-secondary);
+    opacity: 0.8;
+  }
+
+  .appbar-tertiary {
+    background-color: var(--color-tertiary);
+    color: var(--color-on-tertiary);
+  }
+
+  .appbar-tertiary .appbar-nav,
+  .appbar-tertiary .appbar-action {
+    color: var(--color-on-tertiary);
+  }
+
+  .appbar-tertiary .appbar-nav:hover,
+  .appbar-tertiary .appbar-action:hover {
+    background-color: var(--color-tertiary-container);
+    color: var(--color-on-tertiary-container);
+  }
+
+  .appbar-tertiary .appbar-subtitle {
+    color: var(--color-on-tertiary);
+    opacity: 0.8;
+  }
+
+  /* Surface Variants */
   .appbar-surface {
+    background-color: var(--color-surface);
+  }
+
+  .appbar-surface-container {
     background-color: var(--color-surface-container);
   }
 
+  .appbar-surface-container-low {
+    background-color: var(--color-surface-container-low);
+  }
+
+  .appbar-surface-container-high {
+    background-color: var(--color-surface-container-high);
+  }
+
+  .appbar-surface-container-highest {
+    background-color: var(--color-surface-container-highest);
+  }
+
   /* Center Title */
   .appbar-center {
     justify-content: space-between;
@@ -13134,6 +13824,72 @@
     transform: scale(1);
   }
 
+  /* Direct popover structure (without .popover-content wrapper) */
+  .popover.popover-show,
+  .popover.show {
+    opacity: 1;
+    visibility: visible;
+  }
+
+  /* Popover as direct overlay (simpler structure) */
+  .popover[class*="popover-top"],
+  .popover[class*="popover-bottom"],
+  .popover[class*="popover-left"],
+  .popover[class*="popover-right"] {
+    position: absolute;
+    z-index: 1050;
+    min-width: 12rem;
+    max-width: 20rem;
+    padding: 1rem;
+    background-color: var(--color-surface);
+    border: 1px solid var(--color-outline-variant);
+    border-radius: 0.75rem;
+    box-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+    opacity: 0;
+    visibility: hidden;
+    transition: opacity 150ms ease-out, visibility 150ms ease-out;
+  }
+
+  .popover[class*="popover-top"].popover-show,
+  .popover[class*="popover-bottom"].popover-show,
+  .popover[class*="popover-left"].popover-show,
+  .popover[class*="popover-right"].popover-show {
+    opacity: 1;
+    visibility: visible;
+  }
+
+  /* Direct position: Top */
+  .popover.popover-top:not(:has(.popover-content)) {
+    bottom: 100%;
+    left: 50%;
+    transform: translateX(-50%);
+    margin-bottom: 0.75rem;
+  }
+
+  /* Direct position: Bottom */
+  .popover.popover-bottom:not(:has(.popover-content)) {
+    top: 100%;
+    left: 50%;
+    transform: translateX(-50%);
+    margin-top: 0.75rem;
+  }
+
+  /* Direct position: Left */
+  .popover.popover-left:not(:has(.popover-content)) {
+    right: 100%;
+    top: 50%;
+    transform: translateY(-50%);
+    margin-right: 0.75rem;
+  }
+
+  /* Direct position: Right */
+  .popover.popover-right:not(:has(.popover-content)) {
+    left: 100%;
+    top: 50%;
+    transform: translateY(-50%);
+    margin-left: 0.75rem;
+  }
+
   /* Popover Arrow */
   .popover-arrow {
     position: absolute;
@@ -13310,12 +14066,33 @@
   }
 
   /* Color Variants */
+  /*
+   * Color intensity for themed popovers.
+   * Override this variable to adjust how strongly colors appear:
+   * - 20% = subtle tint
+   * - 30% = moderate (default)
+   * - 40% = bold/prominent
+   */
+  .popover {
+    --popover-color-intensity: 30%;
+  }
+
+  /* Dark variant */
   .popover-dark .popover-content {
     background-color: var(--color-on-surface);
     color: var(--color-surface);
     border-color: transparent;
   }
 
+  .popover-dark[class*="popover-top"],
+  .popover-dark[class*="popover-bottom"],
+  .popover-dark[class*="popover-left"],
+  .popover-dark[class*="popover-right"] {
+    background-color: var(--color-on-surface);
+    color: var(--color-surface);
+    border-color: transparent;
+  }
+
   .popover-dark .popover-arrow {
     background-color: var(--color-on-surface);
     border-color: transparent;
@@ -13330,16 +14107,106 @@
     opacity: 0.9;
   }
 
+  /* Primary variant */
   .popover-primary .popover-content {
-    background-color: var(--color-primary-container);
+    background-color: color-mix(in oklch, var(--color-primary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-primary);
+  }
+
+  .popover-primary[class*="popover-top"],
+  .popover-primary[class*="popover-bottom"],
+  .popover-primary[class*="popover-left"],
+  .popover-primary[class*="popover-right"] {
+    background-color: color-mix(in oklch, var(--color-primary) var(--popover-color-intensity), var(--color-surface));
     border-color: var(--color-primary);
   }
 
   .popover-primary .popover-arrow {
-    background-color: var(--color-primary-container);
+    background-color: color-mix(in oklch, var(--color-primary) var(--popover-color-intensity), var(--color-surface));
     border-color: var(--color-primary);
   }
 
+  .popover-primary .popover-body {
+    color: var(--color-on-surface);
+  }
+
+  .popover-primary .popover-title {
+    color: var(--color-on-surface);
+  }
+
+  /* Secondary variant */
+  .popover-secondary .popover-content {
+    background-color: color-mix(in oklch, var(--color-secondary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-secondary);
+  }
+
+  .popover-secondary[class*="popover-top"],
+  .popover-secondary[class*="popover-bottom"],
+  .popover-secondary[class*="popover-left"],
+  .popover-secondary[class*="popover-right"] {
+    background-color: color-mix(in oklch, var(--color-secondary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-secondary);
+  }
+
+  .popover-secondary .popover-arrow {
+    background-color: color-mix(in oklch, var(--color-secondary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-secondary);
+  }
+
+  .popover-secondary .popover-body {
+    color: var(--color-on-surface);
+  }
+
+  .popover-secondary .popover-title {
+    color: var(--color-on-surface);
+  }
+
+  /* Tertiary variant */
+  .popover-tertiary .popover-content {
+    background-color: color-mix(in oklch, var(--color-tertiary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-tertiary);
+  }
+
+  .popover-tertiary[class*="popover-top"],
+  .popover-tertiary[class*="popover-bottom"],
+  .popover-tertiary[class*="popover-left"],
+  .popover-tertiary[class*="popover-right"] {
+    background-color: color-mix(in oklch, var(--color-tertiary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-tertiary);
+  }
+
+  .popover-tertiary .popover-arrow {
+    background-color: color-mix(in oklch, var(--color-tertiary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-tertiary);
+  }
+
+  .popover-tertiary .popover-body {
+    color: var(--color-on-surface);
+  }
+
+  .popover-tertiary .popover-title {
+    color: var(--color-on-surface);
+  }
+
+  /* Surface highest variant */
+  .popover-surface-highest .popover-content {
+    background-color: var(--color-surface-container-highest);
+    border-color: var(--color-outline-variant);
+  }
+
+  .popover-surface-highest[class*="popover-top"],
+  .popover-surface-highest[class*="popover-bottom"],
+  .popover-surface-highest[class*="popover-left"],
+  .popover-surface-highest[class*="popover-right"] {
+    background-color: var(--color-surface-container-highest);
+    border-color: var(--color-outline-variant);
+  }
+
+  .popover-surface-highest .popover-arrow {
+    background-color: var(--color-surface-container-highest);
+    border-color: var(--color-outline-variant);
+  }
+
   /* Hover Trigger */
   .popover-hover:hover .popover-content,
   .popover-hover:focus-within .popover-content {
@@ -13414,11 +14281,160 @@
     justify-content: center;
   }
 
+  /* ========================================
+   * HTML Popover API Support
+   * Uses native [popover] attribute with :popover-open pseudo-class
+   * ======================================== */
+
+  /* Native popover base styles */
+  .popover[popover] {
+    position: fixed;
+    inset: unset;
+    z-index: 1050;
+    min-width: 12rem;
+    max-width: 20rem;
+    padding: 1rem;
+    margin: 0;
+    background-color: var(--color-surface);
+    border: 1px solid var(--color-outline-variant);
+    border-radius: 0.75rem;
+    box-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+    opacity: 0;
+    transform: scale(0.95);
+    transition: opacity 150ms ease-out, transform 150ms ease-out, overlay 150ms ease-out allow-discrete, display 150ms ease-out allow-discrete;
+  }
+
+  /* Popover open state */
+  .popover[popover]:popover-open {
+    opacity: 1;
+    transform: scale(1);
+  }
+
+  /* Starting state for entry animation */
+  @starting-style {
+    .popover[popover]:popover-open {
+      opacity: 0;
+      transform: scale(0.95);
+    }
+  }
+
+  /* Native popover backdrop */
+  .popover[popover]::backdrop {
+    background-color: rgb(0 0 0 / 0);
+    transition: background-color 150ms ease-out, overlay 150ms ease-out allow-discrete, display 150ms ease-out allow-discrete;
+  }
+
+  .popover[popover]:popover-open::backdrop {
+    background-color: rgb(0 0 0 / 0.1);
+  }
+
+  @starting-style {
+    .popover[popover]:popover-open::backdrop {
+      background-color: rgb(0 0 0 / 0);
+    }
+  }
+
+  /* Native popover with modal backdrop */
+  .popover-modal[popover]::backdrop {
+    background-color: rgb(0 0 0 / 0);
+    transition: background-color 150ms ease-out, overlay 150ms ease-out allow-discrete, display 150ms ease-out allow-discrete;
+  }
+
+  .popover-modal[popover]:popover-open::backdrop {
+    background-color: rgb(0 0 0 / 0.3);
+  }
+
+  @starting-style {
+    .popover-modal[popover]:popover-open::backdrop {
+      background-color: rgb(0 0 0 / 0);
+    }
+  }
+
+  /* Native popover color variants */
+  .popover-primary[popover] {
+    background-color: color-mix(in oklch, var(--color-primary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-primary);
+  }
+
+  .popover-primary[popover] .popover-body {
+    color: var(--color-on-surface);
+  }
+
+  .popover-primary[popover] .popover-title {
+    color: var(--color-on-surface);
+  }
+
+  .popover-secondary[popover] {
+    background-color: color-mix(in oklch, var(--color-secondary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-secondary);
+  }
+
+  .popover-secondary[popover] .popover-body {
+    color: var(--color-on-surface);
+  }
+
+  .popover-secondary[popover] .popover-title {
+    color: var(--color-on-surface);
+  }
+
+  .popover-tertiary[popover] {
+    background-color: color-mix(in oklch, var(--color-tertiary) var(--popover-color-intensity), var(--color-surface));
+    border-color: var(--color-tertiary);
+  }
+
+  .popover-tertiary[popover] .popover-body {
+    color: var(--color-on-surface);
+  }
+
+  .popover-tertiary[popover] .popover-title {
+    color: var(--color-on-surface);
+  }
+
+  .popover-dark[popover] {
+    background-color: var(--color-on-surface);
+    border-color: transparent;
+  }
+
+  .popover-dark[popover] .popover-body {
+    color: var(--color-surface);
+    opacity: 0.9;
+  }
+
+  .popover-dark[popover] .popover-title {
+    color: var(--color-surface);
+  }
+
+  .popover-surface-highest[popover] {
+    background-color: var(--color-surface-container-highest);
+    border-color: var(--color-outline-variant);
+  }
+
+  /* Native popover size variants */
+  .popover-sm[popover] {
+    min-width: 8rem;
+    max-width: 14rem;
+    padding: 0.75rem;
+  }
+
+  .popover-lg[popover] {
+    min-width: 16rem;
+    max-width: 28rem;
+    padding: 1.25rem;
+  }
+
+  .popover-full[popover] {
+    min-width: 0;
+    max-width: none;
+    width: max-content;
+  }
+
   /* Reduce Motion */
   @media (prefers-reduced-motion: reduce) {
     .popover-content,
     .popover-close,
-    .popover-menu-item {
+    .popover-menu-item,
+    .popover[popover],
+    .popover[popover]::backdrop {
       transition: none;
     }
   }