svelte-multiselect 11.5.1 → 11.5.2

package/dist/Nav.svelte

@@ -1,19 +1,36 @@
-<script
-  lang="ts"
-  generics="Route extends string | [string, string] | [string, string[]]"
->import { click_outside } from './attachments';
+<script lang="ts">import { click_outside, tooltip } from './attachments';
 import Icon from './Icon.svelte';
-let { routes = [], children, link, menu_props, link_props, page, labels, ...rest } = $props();
+let { routes = [], children, item, link, menu_props, link_props, page, labels, tooltips, tooltip_options, breakpoint = 767, onnavigate, onopen, onclose, ...rest } = $props();
 let is_open = $state(false);
 let hovered_dropdown = $state(null);
 let focused_item_index = $state(-1);
 let is_touch_device = $state(false);
+let is_mobile = $state(false);
 const panel_id = `nav-menu-${crypto.randomUUID()}`;
-// Detect touch device
+// Track previous is_open state for callbacks
+let prev_is_open = $state(false);
+// Detect touch device and handle responsive breakpoint
 $effect(() => {
-    if (typeof globalThis !== `undefined`) {
-        is_touch_device = `ontouchstart` in globalThis || navigator.maxTouchPoints > 0;
+    if (typeof globalThis === `undefined`)
+        return;
+    is_touch_device = `ontouchstart` in globalThis || navigator.maxTouchPoints > 0;
+    // Handle responsive breakpoint via JS since CSS variables don't work in media queries
+    const check_mobile = () => {
+        is_mobile = globalThis.innerWidth <= breakpoint;
+    };
+    check_mobile();
+    globalThis.addEventListener(`resize`, check_mobile);
+    return () => globalThis.removeEventListener(`resize`, check_mobile);
+});
+// Call onopen/onclose callbacks when menu state changes
+$effect(() => {
+    if (is_open && !prev_is_open) {
+        onopen?.();
+    }
+    else if (!is_open && prev_is_open) {
+        onclose?.();
     }
+    prev_is_open = is_open;
 });
 function close_menus() {
     is_open = false;
@@ -27,9 +44,7 @@ function toggle_dropdown(href, focus_first = false) {
     // Focus management for keyboard users
     if (is_opening && focus_first) {
         setTimeout(() => {
-            const dropdown = document.querySelector(`.dropdown[data-href="${href}"]`);
-            const first_link = dropdown?.querySelector(`[role="menuitem"]`);
-            first_link?.focus();
+            document.querySelector(`.dropdown[data-href="${href}"] [role="menuitem"]`)?.focus();
         }, 0);
     }
 }
@@ -48,11 +63,8 @@ function handle_dropdown_keydown(event, href, sub_routes) {
     if (hovered_dropdown === href && (key === `ArrowDown` || key === `ArrowUp`)) {
         event.preventDefault();
         const direction = key === `ArrowDown` ? 1 : -1;
-        const new_index = Math.max(0, Math.min(sub_routes.length - 1, focused_item_index + direction));
-        focused_item_index = new_index;
-        const dropdown = document.querySelector(`.dropdown[data-href="${href}"]`);
-        const links = dropdown?.querySelectorAll(`[role="menuitem"]`);
-        links?.[new_index]?.focus();
+        focused_item_index = Math.max(0, Math.min(sub_routes.length - 1, focused_item_index + direction));
+        document.querySelectorAll(`.dropdown[data-href="${href}"] [role="menuitem"]`)?.[focused_item_index]?.focus();
     }
     // Open dropdown with ArrowDown when closed
     if (hovered_dropdown !== href && key === `ArrowDown`) {
@@ -64,14 +76,12 @@ function handle_dropdown_item_keydown(event, href) {
     if (event.key === `Escape`) {
         event.preventDefault();
         close_menus();
-        // Return focus to dropdown toggle button
-        document
-            .querySelector(`.dropdown[data-href="${href}"]`)
-            ?.querySelector(`[data-dropdown-toggle]`)
-            ?.focus();
+        document.querySelector(`.dropdown[data-href="${href}"] [data-dropdown-toggle]`)?.focus();
     }
 }
 function is_current(path) {
+    if (!path)
+        return undefined;
     if (path === `/`)
         return page?.url.pathname === `/` ? `page` : undefined;
     // Match exact path or path followed by / to avoid partial matches
@@ -83,28 +93,103 @@ function is_current(path) {
 }
 const is_child_current = (sub_routes) => sub_routes.some((child_path) => is_current(child_path) === `page`);
 function format_label(text, remove_parent = false) {
+    if (!text)
+        return { label: ``, style: `` };
     const custom_label = labels?.[text];
     if (custom_label)
         return { label: custom_label, style: `` };
     if (remove_parent)
         text = text.split(`/`).filter(Boolean).pop() ?? text;
-    const label = text.replace(/^\//, ``).replaceAll(`-`, ` `);
-    return { label, style: `text-transform: capitalize` };
+    let label = text.replace(/^\//, ``).replaceAll(`-`, ` `);
+    // Handle root path '/' which becomes empty after stripping
+    if (!label && text === `/`)
+        label = `Home`;
+    return { label, style: label ? `text-transform: capitalize` : `` };
 }
+// Normalize all route formats to NavRouteObject
 function parse_route(route) {
     if (typeof route === `string`)
-        return { href: route, label: route };
-    const [first, second] = route;
-    return Array.isArray(second)
-        ? { href: first, label: first, children: second }
-        : { href: first, label: second };
+        return { href: route };
+    if (Array.isArray(route)) {
+        const [href, second] = route;
+        return Array.isArray(second)
+            ? { href, children: second }
+            : { href, label: second };
+    }
+    return route;
+}
+function get_tooltip(route) {
+    // Priority: disabled message > route.tooltip > tooltips[href]
+    if (typeof route.disabled === `string`) {
+        return tooltip({ ...tooltip_options, content: route.disabled });
+    }
+    const content = route.tooltip ?? tooltips?.[route.href];
+    if (!content)
+        return undefined;
+    // Support both string (content only) and object (full options) formats
+    const opts = typeof content === `string` ? { content } : content;
+    return tooltip({ ...tooltip_options, ...opts });
+}
+// Handle link click with onnavigate callback
+function handle_link_click(event, route) {
+    if (route.disabled) {
+        event.preventDefault();
+        return;
+    }
+    if (onnavigate) {
+        const result = onnavigate({ href: route.href, event, route });
+        if (result === false) {
+            event.preventDefault();
+            return;
+        }
+    }
+    close_menus();
+}
+// Get external link attributes
+function get_external_attrs(route) {
+    if (!route.external)
+        return {};
+    return { target: `_blank`, rel: `noopener noreferrer` };
 }
 </script>
 
 <svelte:window {onkeydown} />
 
+<!-- Default item rendering snippet for escape hatch -->
+{#snippet default_item_render(
+  parsed_route: NavRouteObject,
+  formatted: { label: string; style: string },
+  item_tooltip: ReturnType<typeof tooltip> | undefined,
+)}
+  {@const is_disabled = Boolean(parsed_route.disabled)}
+  {#if is_disabled}
+    <span
+      class="disabled {parsed_route.class ?? ``}"
+      style={`${formatted.style}; ${parsed_route.style ?? ``}`}
+      aria-disabled="true"
+      {@attach item_tooltip}
+    >{@html formatted.label}</span>
+  {:else if link}
+    {@render link({ href: parsed_route.href, label: formatted.label })}
+  {:else}
+    <a
+      href={parsed_route.href}
+      aria-current={is_current(parsed_route.href)}
+      onclick={(event) => handle_link_click(event, parsed_route)}
+      class={parsed_route.class}
+      {...link_props}
+      {...get_external_attrs(parsed_route)}
+      style={`${formatted.style}; ${link_props?.style ?? ``}; ${parsed_route.style ?? ``}`}
+      {@attach item_tooltip}
+    >
+      {@html formatted.label}
+    </a>
+  {/if}
+{/snippet}
+
 <nav
   {...rest}
+  class:mobile={is_mobile}
   {@attach click_outside({ callback: close_menus })}
 >
   <button
@@ -129,24 +214,43 @@ function parse_route(route) {
     {onkeydown}
     {...menu_props}
   >
-    {#each routes as route (JSON.stringify(route))}
-      {@const { href, label, children: sub_routes } = parse_route(route)}
+    {#each routes as
+      route,
+      route_idx
+      (`${route_idx}-${
+        typeof route === `string`
+          ? route
+          : Array.isArray(route)
+          ? route[0]
+          : route.href ?? `sep-${route_idx}`
+      }`)
+    }
+      {@const parsed_route = parse_route(route)}
+      {@const formatted = format_label(parsed_route.label ?? parsed_route.href)}
+      {@const sub_routes = parsed_route.children}
+      {@const is_active = is_current(parsed_route.href) === `page`}
+      {@const is_dropdown = Boolean(sub_routes)}
+      {@const is_right = parsed_route.align === `right`}
+      {@const item_tooltip = get_tooltip(parsed_route)}
 
-      {#if sub_routes}
+      <!-- Separator-only item -->
+      {#if parsed_route.separator && !parsed_route.href}
+        <div class="separator" role="separator"></div>
+      {:else if sub_routes}
         <!-- Dropdown menu item -->
-        {@const parent = format_label(label)}
         {@const child_is_active = is_child_current(sub_routes)}
-        {@const parent_page_exists = sub_routes.includes(href)}
-        {@const filtered_sub_routes = sub_routes.filter((route) => route !== href)}
+        {@const parent_page_exists = sub_routes.includes(parsed_route.href)}
+        {@const filtered_sub_routes = sub_routes.filter((r) => r !== parsed_route.href)}
         <div
           class="dropdown"
           class:active={child_is_active}
-          data-href={href}
+          class:align-right={is_right}
+          data-href={parsed_route.href}
           role="group"
           aria-current={child_is_active ? `true` : undefined}
-          onmouseenter={() => !is_touch_device && (hovered_dropdown = href)}
+          onmouseenter={() => !is_touch_device && (hovered_dropdown = parsed_route.href)}
           onmouseleave={() => !is_touch_device && (hovered_dropdown = null)}
-          onfocusin={() => (hovered_dropdown = href)}
+          onfocusin={() => (hovered_dropdown = parsed_route.href)}
           onfocusout={(event) => {
             const next = event.relatedTarget as Node | null
             if (!next || !(event.currentTarget as HTMLElement).contains(next)) {
@@ -155,22 +259,45 @@ function parse_route(route) {
           }}
         >
           <div>
-            {#if parent_page_exists}
-              {@const { label, style } = parent}
-              <a {href} aria-current={is_current(href)} onclick={close_menus} {style}>
-                {@html label}
+            {#if parsed_route.disabled}
+              <span
+                class="disabled {parsed_route.class ?? ``}"
+                style={`${formatted.style}; ${parsed_route.style ?? ``}`}
+                aria-disabled="true"
+                {@attach item_tooltip}
+              >{@html formatted.label}</span>
+            {:else if parent_page_exists}
+              <a
+                href={parsed_route.href}
+                aria-current={is_current(parsed_route.href)}
+                onclick={(event) => handle_link_click(event, parsed_route)}
+                class={parsed_route.class}
+                style={`${formatted.style}; ${parsed_route.style ?? ``}`}
+                {...get_external_attrs(parsed_route)}
+                {@attach item_tooltip}
+              >
+                {@html formatted.label}
               </a>
             {:else}
-              <span style={parent.style}>{@html parent.label}</span>
+              <span
+                class={parsed_route.class}
+                style={`${formatted.style}; ${parsed_route.style ?? ``}`}
+                {@attach item_tooltip}
+              >{@html formatted.label}</span>
             {/if}
             <button
               type="button"
               data-dropdown-toggle
-              aria-label="Toggle {parent.label} submenu"
-              aria-expanded={hovered_dropdown === href}
+              aria-label="Toggle {formatted.label} submenu"
+              aria-expanded={hovered_dropdown === parsed_route.href}
               aria-haspopup="true"
-              onclick={() => toggle_dropdown(href, false)}
-              onkeydown={(event) => handle_dropdown_keydown(event, href, filtered_sub_routes)}
+              onclick={() => toggle_dropdown(parsed_route.href, false)}
+              onkeydown={(event) =>
+              handle_dropdown_keydown(
+                event,
+                parsed_route.href,
+                filtered_sub_routes,
+              )}
             >
               <Icon
                 icon="ChevronExpand"
@@ -179,12 +306,12 @@ function parse_route(route) {
             </button>
           </div>
           <div
-            class:visible={hovered_dropdown === href}
+            class:visible={hovered_dropdown === parsed_route.href}
             role="menu"
             tabindex="-1"
-            onmouseenter={() => !is_touch_device && (hovered_dropdown = href)}
+            onmouseenter={() => !is_touch_device && (hovered_dropdown = parsed_route.href)}
             onmouseleave={() => !is_touch_device && (hovered_dropdown = null)}
-            onfocusin={() => (hovered_dropdown = href)}
+            onfocusin={() => (hovered_dropdown = parsed_route.href)}
             onfocusout={(event) => {
               const next = event.relatedTarget as Node | null
               if (!next || !(event.currentTarget as HTMLElement).contains(next)) {
@@ -193,40 +320,56 @@ function parse_route(route) {
             }}
           >
             {#each filtered_sub_routes as child_href (child_href)}
-              {@const child = format_label(child_href, true)}
+              {@const child_formatted = format_label(child_href, true)}
+              {@const child_tooltip = get_tooltip({ href: child_href })}
               {#if link}
-                {@render link({ href: child_href, label: child.label })}
+                {@render link({ href: child_href, label: child_formatted.label })}
               {:else}
                 <a
                   href={child_href}
                   role="menuitem"
                   aria-current={is_current(child_href)}
-                  onclick={close_menus}
-                  onkeydown={(event) => handle_dropdown_item_keydown(event, href)}
+                  onclick={(event) => handle_link_click(event, { href: child_href })}
+                  onkeydown={(event) => handle_dropdown_item_keydown(event, parsed_route.href)}
                   {...link_props}
-                  style={`${child.style}; ${link_props?.style ?? ``}`}
+                  style={`${child_formatted.style}; ${link_props?.style ?? ``}`}
+                  {@attach child_tooltip}
                 >
-                  {@html child.label}
+                  {@html child_formatted.label}
                 </a>
               {/if}
             {/each}
           </div>
         </div>
+        <!-- Separator after dropdown if specified -->
+        {#if parsed_route.separator}
+          <div class="separator" role="separator"></div>
+        {/if}
       {:else}
         <!-- Regular link item -->
-        {@const regular = format_label(label)}
-        {#if link}
-          {@render link({ href, label })}
+        {#if item}
+          <!-- User-provided item snippet with render_default escape hatch -->
+          {#snippet render_default_snippet()}
+            {@render default_item_render(parsed_route, formatted, item_tooltip)}
+          {/snippet}
+          <span class:align-right={is_right}>
+            {@render item({
+          route: parsed_route,
+          href: parsed_route.href,
+          label: formatted.label,
+          is_active,
+          is_dropdown,
+          render_default: render_default_snippet,
+        })}
+          </span>
         {:else}
-          <a
-            {href}
-            aria-current={is_current(href)}
-            onclick={close_menus}
-            {...link_props}
-            style={`${regular.style}; ${link_props?.style ?? ``}`}
-          >
-            {@html regular.label}
-          </a>
+          <span class:align-right={is_right}>
+            {@render default_item_render(parsed_route, formatted, item_tooltip)}
+          </span>
+        {/if}
+        <!-- Separator after item if specified -->
+        {#if parsed_route.separator}
+          <div class="separator" role="separator"></div>
         {/if}
       {/if}
     {/each}
@@ -255,7 +398,8 @@ function parse_route(route) {
     flex-wrap: wrap;
     padding: 0.5em;
   }
-  .menu > a {
+  .menu > span,
+  .menu > span > a {
     line-height: 1.3;
     padding: 1pt 5pt;
     border-radius: var(--nav-border-radius);
@@ -263,13 +407,37 @@ function parse_route(route) {
     color: inherit;
     transition: background-color 0.2s;
   }
-  .menu > a:hover {
+  .menu > span > a:hover {
     background-color: var(--nav-link-bg-hover);
   }
-  .menu > a[aria-current='page'] {
+  .menu > span > a[aria-current='page'] {
     color: var(--nav-link-active-color);
   }
-
+  /* Disabled items */
+  .menu .disabled {
+    opacity: var(--nav-disabled-opacity, 0.5);
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+  /* Right-aligned items - only first one gets margin-left: auto */
+  .menu > .align-right,
+  .menu > .dropdown.align-right {
+    margin-left: auto;
+  }
+  .menu > .align-right + .align-right,
+  .menu > .align-right + .dropdown.align-right,
+  .menu > .dropdown.align-right + .align-right,
+  .menu > .dropdown.align-right + .dropdown.align-right {
+    margin-left: 0;
+  }
+  /* Separator */
+  .menu > .separator {
+    width: 1px;
+    height: 1.2em;
+    background-color: var(--nav-separator-color, currentColor);
+    opacity: 0.3;
+    margin: var(--nav-separator-margin, 0 0.25em);
+  }
   /* Dropdown styles */
   .dropdown {
     position: relative;
@@ -317,6 +485,11 @@ function parse_route(route) {
     align-items: center;
     justify-content: center;
     border-radius: 0 var(--nav-border-radius) var(--nav-border-radius) 0;
+    outline-offset: -1px;
+  }
+  .dropdown > div:first-child > button:focus-visible {
+    outline: 2px solid currentColor;
+    outline-offset: -2px;
   }
   .dropdown > div:last-child {
     position: absolute;
@@ -366,79 +539,89 @@ function parse_route(route) {
     z-index: var(--nav-toggle-btn-z-index, 10);
   }
   .burger span {
+    width: 100%;
     height: 0.18rem;
-    background-color: var(--text-color);
+    background-color: var(--text);
     border-radius: 8px;
     transition: all 0.2s linear;
-    transform-origin: 1px;
+    transform-origin: center;
   }
   .burger[aria-expanded='true'] span:first-child {
-    transform: rotate(45deg);
+    transform: translateY(0.4rem) rotate(45deg);
   }
   .burger[aria-expanded='true'] span:nth-child(2) {
     opacity: 0;
   }
   .burger[aria-expanded='true'] span:nth-child(3) {
-    transform: rotate(-45deg);
+    transform: translateY(-0.4rem) rotate(-45deg);
   }
-  /* Mobile styles */
-  @media (max-width: 767px) {
-    .burger {
-      display: flex;
-    }
-    .menu {
-      position: fixed;
-      top: 3rem;
-      left: 1rem;
-      background-color: var(--nav-surface-bg);
-      border: 1px solid var(--nav-surface-border);
-      box-shadow: var(--nav-surface-shadow);
-      opacity: 0;
-      visibility: hidden;
-      transition: all 0.3s ease;
-      z-index: var(--nav-mobile-z-index, 2);
-      flex-direction: column;
-      align-items: stretch;
-      justify-content: start;
-      gap: 0.2em;
-      max-width: 90vw;
-      border-radius: 6px;
-    }
-    .menu.open {
-      opacity: 1;
-      visibility: visible;
-    }
-    .menu > a,
-    .dropdown {
-      padding: 2pt 8pt;
-    }
-
-    /* Mobile dropdown styles - show as expandable section */
-    .dropdown {
-      flex-direction: column;
-      align-items: stretch;
-    }
-    .dropdown > div:first-child {
-      display: flex;
-      align-items: center;
-      justify-content: space-between;
-    }
-    .dropdown > div:first-child > a,
-    .dropdown > div:first-child > span {
-      flex: 1;
-      border-radius: var(--nav-border-radius);
-    }
-    .dropdown > div:first-child > button {
-      padding: 4pt 8pt;
-      border-radius: var(--nav-border-radius);
-    }
-    .dropdown > div:last-child {
-      position: static;
-      border: none;
-      box-shadow: none;
-      margin-top: 0.25em;
-      padding: 0 0 0 1em;
-      background-color: transparent;
-    }
+  /* Mobile styles - using .mobile class set via JS based on breakpoint prop */
+  nav.mobile .burger {
+    display: flex;
+  }
+  nav.mobile .menu {
+    position: fixed;
+    top: 3rem;
+    left: 1rem;
+    background-color: var(--nav-surface-bg);
+    border: 1px solid var(--nav-surface-border);
+    box-shadow: var(--nav-surface-shadow);
+    opacity: 0;
+    visibility: hidden;
+    transition: all 0.3s ease;
+    z-index: var(--nav-mobile-z-index, 2);
+    flex-direction: column;
+    align-items: stretch;
+    justify-content: start;
+    gap: 0.2em;
+    max-width: 90vw;
+    border-radius: 6px;
+  }
+  nav.mobile .menu.open {
+    opacity: 1;
+    visibility: visible;
+  }
+  nav.mobile .menu > span,
+  nav.mobile .menu > span > a,
+  nav.mobile .dropdown {
+    padding: 2pt 8pt;
+  }
+  /* Mobile separator */
+  nav.mobile .menu > .separator {
+    width: 100%;
+    height: 1px;
+    margin: var(--nav-separator-margin, 0.25em 0);
+  }
+  /* Mobile dropdown styles - show as expandable section */
+  nav.mobile .dropdown {
+    flex-direction: column;
+    align-items: stretch;
+  }
+  nav.mobile .dropdown > div:first-child {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+  }
+  nav.mobile .dropdown > div:first-child > a,
+  nav.mobile .dropdown > div:first-child > span {
+    flex: 1;
+    border-radius: var(--nav-border-radius);
+  }
+  nav.mobile .dropdown > div:first-child > button {
+    padding: 4pt 8pt;
+    border-radius: var(--nav-border-radius);
+  }
+  nav.mobile .dropdown > div:last-child {
+    position: static;
+    border: none;
+    box-shadow: none;
+    margin-top: 0.25em;
+    padding: 0 0 0 1em;
+    background-color: transparent;
+  }
+  /* Mobile right-aligned items stack normally */
+  nav.mobile .menu > .align-right,
+  nav.mobile .menu > .dropdown.align-right {
+    margin-left: 0;
   }
 </style>