@ibobbyts/svelte-ui-utils 0.3.8 → 0.4.0

package/dist/tooltip/Tooltip.svelte

@@ -0,0 +1,149 @@
+<svelte:options runes={false} />
+
+<script lang="ts">
+  import { afterUpdate, onDestroy } from 'svelte';
+
+  let rootElement: HTMLSpanElement | undefined;
+  let panelElement: HTMLDivElement | undefined;
+  let hovered = false;
+  let focused = false;
+  let visible = false;
+  let panelId = `suu-tooltip-${Math.random().toString(36).slice(2)}`;
+  let frame = 0;
+  let triggerElement: HTMLElement | undefined;
+  let panelObserver: ResizeObserver | undefined;
+
+  $: visible = hovered || focused;
+
+  function updatePosition() {
+    if (!visible || !rootElement || !panelElement || typeof window === 'undefined') {
+      return;
+    }
+
+    const trigger = rootElement.getBoundingClientRect();
+    const panel = panelElement.getBoundingClientRect();
+    const gap = 8;
+    const canPlaceAbove = trigger.top >= panel.height + gap;
+    const preferredTop = canPlaceAbove ? trigger.top - panel.height - gap : trigger.bottom + gap;
+    const maxTop = Math.max(gap, window.innerHeight - panel.height - gap);
+    const top = Math.min(maxTop, Math.max(gap, preferredTop));
+    const maxLeft = Math.max(gap, window.innerWidth - panel.width - gap);
+    const left = Math.min(
+      Math.max(gap, trigger.left + (trigger.width - panel.width) / 2),
+      maxLeft,
+    );
+
+    panelElement.style.setProperty('--suu-tooltip-top', `${top}px`);
+    panelElement.style.setProperty('--suu-tooltip-left', `${left}px`);
+  }
+
+  function schedulePosition() {
+    if (typeof window === 'undefined') return;
+    cancelAnimationFrame(frame);
+    frame = requestAnimationFrame(updatePosition);
+  }
+
+  function showFromHover() {
+    hovered = true;
+    triggerElement = findTrigger();
+    schedulePosition();
+  }
+
+  function hideFromHover() {
+    hovered = false;
+  }
+
+  function focusIn(event: FocusEvent) {
+    focused = true;
+    triggerElement = event.target instanceof HTMLElement ? event.target : findTrigger();
+    schedulePosition();
+  }
+
+  function focusOut(event: FocusEvent) {
+    const next = event.relatedTarget;
+    if (next instanceof Node && rootElement?.contains(next)) return;
+    focused = false;
+  }
+
+  function handleViewportChange() {
+    schedulePosition();
+  }
+
+  function findTrigger() {
+    return rootElement?.querySelector<HTMLElement>(
+      'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])',
+    ) ?? undefined;
+  }
+
+  function syncDescription() {
+    if (!rootElement || !$$slots.content) return;
+    const nextTrigger = triggerElement ?? findTrigger();
+    if (triggerElement && triggerElement !== nextTrigger) {
+      removePanelDescription(triggerElement);
+    }
+    triggerElement = nextTrigger;
+    if (triggerElement) {
+      if (visible) addPanelDescription(triggerElement);
+      else removePanelDescription(triggerElement);
+    }
+  }
+
+  function addPanelDescription(element: HTMLElement) {
+    const ids = new Set((element.getAttribute('aria-describedby') ?? '').split(/\s+/).filter(Boolean));
+    ids.add(panelId);
+    element.setAttribute('aria-describedby', [...ids].join(' '));
+  }
+
+  function removePanelDescription(element: HTMLElement) {
+    const ids = (element.getAttribute('aria-describedby') ?? '')
+      .split(/\s+/)
+      .filter((id) => id && id !== panelId);
+    if (ids.length > 0) element.setAttribute('aria-describedby', ids.join(' '));
+    else element.removeAttribute('aria-describedby');
+  }
+
+  function syncPanelObserver() {
+    panelObserver?.disconnect();
+    panelObserver = undefined;
+    if (visible && panelElement && typeof ResizeObserver !== 'undefined') {
+      panelObserver = new ResizeObserver(() => schedulePosition());
+      panelObserver.observe(panelElement);
+    }
+    syncDescription();
+  }
+
+  if (typeof window !== 'undefined') {
+    window.addEventListener('resize', handleViewportChange);
+    window.addEventListener('scroll', handleViewportChange, true);
+  }
+
+  afterUpdate(syncPanelObserver);
+
+  onDestroy(() => {
+    if (typeof window !== 'undefined') {
+      window.removeEventListener('resize', handleViewportChange);
+      window.removeEventListener('scroll', handleViewportChange, true);
+      cancelAnimationFrame(frame);
+    }
+    panelObserver?.disconnect();
+    if (triggerElement) removePanelDescription(triggerElement);
+  });
+</script>
+
+<span
+  bind:this={rootElement}
+  class="suu-tooltip"
+  role="group"
+  on:mouseenter={showFromHover}
+  on:mouseleave={hideFromHover}
+  on:focusin={focusIn}
+  on:focusout={focusOut}
+>
+  <slot />
+
+  {#if visible && $$slots.content}
+    <div bind:this={panelElement} class="suu-tooltip__panel" id={panelId} role="tooltip">
+      <slot name="content" />
+    </div>
+  {/if}
+</span>

package/dist/tooltip/Tooltip.svelte.d.ts

@@ -0,0 +1,22 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const Tooltip: $$__sveltets_2_IsomorphicComponent<any, {
+    [evt: string]: CustomEvent<any>;
+}, {
+    default: {};
+    content: {};
+}, {}, string>;
+type Tooltip = InstanceType<typeof Tooltip>;
+export default Tooltip;
+//# sourceMappingURL=Tooltip.svelte.d.ts.map

package/dist/tooltip/Tooltip.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/tooltip/Tooltip.svelte.ts"],"names":[],"mappings":"AAqJA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAUD,QAAA,MAAM,OAAO;;;;;cAAqF,CAAC;AACjF,KAAK,OAAO,GAAG,YAAY,CAAC,OAAO,OAAO,CAAC,CAAC;AAC9C,eAAe,OAAO,CAAC"}

package/dist/tooltip/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Tooltip } from './Tooltip.svelte';
+//# sourceMappingURL=index.d.ts.map

package/dist/tooltip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/tooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tooltip/index.js

@@ -0,0 +1 @@
+export { default as Tooltip } from './Tooltip.svelte';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibobbyts/svelte-ui-utils",
-  "version": "0.3.8",
+	"version": "0.4.0",
   "description": "Reusable Svelte 5 UI utilities for dialogs, toast notifications, dropdown search, and data tables.",
   "type": "module",
   "license": "MIT",