✨ (base): Añade componente Dropdown

assets/css/basic.css

@@ -141,6 +141,117 @@ input:disabled + label {
     color: var(--val-color--text--muted);
 }
 
+/*
+ * Dropdown component
+ */
+
+.dropdown {
+    position: relative;
+    display: inline-block;
+}
+
+.dropdown-button,
+.dropdown-toggle {
+    padding: 0.5rem 0.75rem;
+    font: inherit;
+    color: var(--val-color--text);
+    background-color: transparent;
+    border: 1px solid var(--val-color--border);
+    border-radius: 0.375rem;
+    cursor: pointer;
+}
+.dropdown-toggle::after {
+    content: "";
+    display: inline-block;
+    width: 0.4em;
+    height: 0.4em;
+    margin-left: 0.35em;
+    border-right: 0.125em solid currentColor;
+    border-bottom: 0.125em solid currentColor;
+    transform: rotate(45deg);
+    transition: transform .15s ease-in-out;
+}
+.dropdown:has(> .dropdown-menu.show) > .dropdown-toggle::after {
+    transform: rotate(-135deg);
+}
+
+.dropdown-menu {
+    position: absolute;
+    z-index: 1000;
+    top: 100%;
+    left: 0;
+    min-width: 12rem;
+    margin: 0.25rem 0 0;
+    padding: 0.5rem 0;
+    list-style: none;
+    background-color: var(--val-color--bg);
+    border: 1px solid color-mix(in srgb, var(--val-color--border) 15%, var(--val-color--bg));
+    border-radius: 0.375rem;
+    box-shadow: 0 0.5rem 1rem rgba(0, 0, 0, 0.15);
+}
+.dropdown-menu.hide {
+    display: none;
+}
+
+.dropdown-item {
+    display: block;
+    width: 100%;
+    padding: 0.375rem 1rem;
+    text-align: left;
+    color: var(--val-color--text);
+    text-decoration: none;
+    background-color: transparent;
+    border: none;
+    font: inherit;
+    cursor: pointer;
+}
+.dropdown-item:hover {
+    background-color: color-mix(in srgb, var(--val-color--text) 8%, transparent);
+}
+.dropdown-item.active {
+    color: var(--val-color--primary);
+    font-weight: 600;
+}
+.dropdown-item.disabled {
+    color: var(--val-color--text--muted);
+    pointer-events: none;
+}
+
+.dropdown-item-text {
+    display: block;
+    padding: 0.375rem 1rem;
+    color: var(--val-color--text--muted);
+}
+
+.dropdown-header {
+    display: block;
+    padding: 0.5rem 1rem 0.25rem;
+    margin: 0;
+    font-size: 0.8125rem;
+    font-weight: 600;
+    color: var(--val-color--text--muted);
+}
+
+.dropdown-divider {
+    height: 0;
+    margin: 0.5rem 0;
+    border: none;
+    border-top: 1px solid var(--val-color--border);
+}
+
+/* Utility: visually hidden but still accessible to assistive technology */
+.visually-hidden {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+}
+
 /*
  * Messages component
  */

assets/js/dropdown.init.js

@@ -0,0 +1,26 @@
+// Conecta cada `Dropdown` (standalone o embebido en un `Nav`) con `accessible-menu` (ver
+// basic.menu.min.js), que añade los roles ARIA, el `aria-expanded` y la navegación por teclado
+// sobre el marcado ya generado en el servidor. Selecciona por clase, no por etiqueta, porque el
+// disparador es un `<button>` en un `Dropdown` independiente y un `<a>` cuando cuelga de un
+// `nav::Item::dropdown()`.
+document.querySelectorAll(".dropdown > .dropdown-toggle").forEach(function (toggle) {
+    var container = toggle.parentElement;
+    var menu = container.querySelector(":scope > .dropdown-menu");
+    if (!menu) {
+        return;
+    }
+
+    new TopLinkDisclosureMenu({
+        menuElement: menu,
+        containerElement: container,
+        controllerElement: toggle,
+        // `Header`/`Divider`/`Label` no son interactivos: se excluyen de `menuItemSelector`
+        // (si no, la librería asume que todo `<li>` tiene un enlace y lanza un TypeError al
+        // intentar añadirle listeners de foco).
+        menuItemSelector: "li:has(> a.dropdown-item, > button.dropdown-item)",
+        menuLinkSelector: "a.dropdown-item, button.dropdown-item",
+        // La navegación con flechas/Home/End es opcional en la librería (`false` por defecto);
+        // se activa para igualar el comportamiento habitual de un menú desplegable.
+        optionalKeySupport: true,
+    });
+});