@pzerelles/headlessui-svelte 2.1.1-next.1 → 2.1.2-next.2

package/dist/menu/MenuHeading.svelte.d.ts

@@ -0,0 +1,39 @@
+import { type Snippet } from "svelte";
+import type { ElementType, Props } from "../utils/types.js";
+declare const DEFAULT_HEADING_TAG: "header";
+type HeadingRenderPropArg = {};
+type HeadingPropsWeControl = "role";
+export type MenuHeadingProps<TTag extends ElementType = typeof DEFAULT_HEADING_TAG> = Props<TTag, HeadingRenderPropArg, HeadingPropsWeControl, {
+    id?: string;
+}>;
+export type MenuHeadingChildren = Snippet<[HeadingRenderPropArg]>;
+declare class __sveltets_Render<TTag extends ElementType = typeof DEFAULT_HEADING_TAG> {
+    props(): {
+        as?: TTag | undefined;
+    } & (Exclude<keyof import("../utils/types.js").PropsOf<TTag>, ("as" | "children" | "refName" | "class") | "id" | "role"> extends infer T extends keyof import("../utils/types.js").PropsOf<TTag> ? { [P in T]: import("../utils/types.js").PropsOf<TTag>[P]; } : never) & {
+        children?: import("../utils/types.js").Children<HeadingRenderPropArg> | undefined;
+        ref?: HTMLElement;
+    } & (true extends (import("../utils/types.js").PropsOf<TTag> extends infer T_1 ? T_1 extends import("../utils/types.js").PropsOf<TTag> ? T_1 extends never ? never : "class" extends infer T_2 ? T_2 extends "class" ? T_2 extends keyof T_1 ? true : never : never : never : never : never) ? {
+        class?: import("../utils/types.js").PropsOf<TTag>["class"] | ((bag: HeadingRenderPropArg) => string) | undefined;
+    } : {}) & {
+        id?: string;
+    };
+    events(): {} & {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots(): {};
+    bindings(): "ref";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TTag extends ElementType = typeof DEFAULT_HEADING_TAG>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TTag>['bindings']>;
+    } & ReturnType<__sveltets_Render<TTag>['exports']>;
+    <TTag extends ElementType = typeof DEFAULT_HEADING_TAG>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
+        $$events?: ReturnType<__sveltets_Render<TTag>['events']>;
+    }): ReturnType<__sveltets_Render<TTag>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const MenuHeading: $$IsomorphicComponent;
+type MenuHeading<TTag extends ElementType = typeof DEFAULT_HEADING_TAG> = InstanceType<typeof MenuHeading<TTag>>;
+export default MenuHeading;

package/dist/menu/MenuItem.svelte

@@ -0,0 +1,114 @@
+<script lang="ts" module>import { onMount } from "svelte";
+const DEFAULT_ITEM_TAG = "svelte:fragment";
+</script>
+
+<script lang="ts" generics="TTag extends ElementType = typeof DEFAULT_ITEM_TAG">import { useId } from "../hooks/use-id.js";
+import { ActivationTrigger, MenuStates, useMenuContext } from "./context.svelte.js";
+import { disposables } from "../utils/disposables.js";
+import { useTextValue } from "../hooks/use-text-value.svelte.js";
+import { restoreFocusIfNecessary } from "../utils/focus-management.js";
+import { Focus } from "../utils/calculate-active-index.js";
+import { useTrackedPointer } from "../hooks/use-tracked-pointer.js";
+import { useLabels } from "../label/context.svelte.js";
+import ElementOrComponent from "../utils/ElementOrComponent.svelte";
+import { mergeProps } from "../utils/render.js";
+import { useDescriptions } from "../description/context.svelte.js";
+const internalId = useId();
+let {
+  ref = $bindable(),
+  id = `headlessui-menu-item-${internalId}`,
+  disabled = false,
+  ...theirProps
+} = $props();
+const _state = useMenuContext("MenuItem");
+const active = $derived(_state.activeItemIndex !== null ? _state.items[_state.activeItemIndex].id === id : false);
+$effect(() => {
+  _state.activeItemIndex;
+  if (_state.__demoMode) return;
+  if (_state.menuState !== MenuStates.Open) return;
+  if (!active) return;
+  if (_state.activationTrigger === ActivationTrigger.Pointer) return;
+  return disposables().requestAnimationFrame(() => {
+    ;
+    ref?.scrollIntoView?.({ block: "nearest" });
+  });
+});
+const getTextValue = useTextValue({
+  get element() {
+    return ref || null;
+  }
+});
+const bag = $derived({
+  disabled,
+  domRef: { current: ref || null },
+  get textValue() {
+    return getTextValue();
+  }
+});
+onMount(() => {
+  _state.registerItem(id, {
+    get current() {
+      return bag;
+    }
+  });
+  return () => _state.unregisterItem(id);
+});
+const handleClick = (event) => {
+  if (disabled) return event.preventDefault();
+  _state.closeMenu();
+  restoreFocusIfNecessary(_state.buttonElement);
+};
+const handleFocus = () => {
+  if (disabled) return _state.goToItem({ focus: Focus.Nothing });
+  _state.goToItem({ focus: Focus.Specific, id });
+};
+const pointer = useTrackedPointer();
+const handleEnter = (evt) => {
+  pointer.update(evt);
+  if (disabled) return;
+  if (active) return;
+  _state.goToItem({ focus: Focus.Specific, id, trigger: ActivationTrigger.Pointer });
+};
+const handleMove = (evt) => {
+  if (!pointer.wasMoved(evt)) return;
+  if (disabled) return;
+  if (active) return;
+  _state.goToItem({ focus: Focus.Specific, id, trigger: ActivationTrigger.Pointer });
+};
+const handleLeave = (evt) => {
+  if (!pointer.wasMoved(evt)) return;
+  if (disabled) return;
+  if (!active) return;
+  _state.goToItem({ focus: Focus.Nothing });
+};
+const labelledby = useLabels();
+const describedby = useDescriptions();
+const slot = $derived({
+  active,
+  focus: active,
+  disabled,
+  close: _state.closeMenu
+});
+const ourProps = $derived(
+  mergeProps({
+    id,
+    role: "menuitem",
+    tabindex: disabled === true ? void 0 : -1,
+    "aria-disabled": disabled === true ? true : void 0,
+    "aria-labelledby": labelledby.value,
+    "aria-describedby": describedby.value,
+    disabled: void 0,
+    // Never forward the `disabled` prop
+    onclick: handleClick,
+    onfocus: handleFocus,
+    onpointerenter: handleEnter,
+    onmouseenter: handleEnter,
+    onpointermove: handleMove,
+    onmousemove: handleMove,
+    onpointerleave: handleLeave,
+    onmouseleave: handleLeave
+  })
+);
+</script>
+
+<ElementOrComponent {ourProps} {theirProps} {slot} defaultTag={DEFAULT_ITEM_TAG} name="MenuItem" bind:ref />

package/dist/menu/MenuItem.svelte.d.ts

@@ -0,0 +1,49 @@
+import type { Props, ElementType, Children } from "../utils/types.js";
+declare const DEFAULT_ITEM_TAG: "svelte:fragment";
+type ItemRenderPropArg = {
+    /** @deprecated use `focus` instead */
+    active: boolean;
+    focus: boolean;
+    disabled: boolean;
+    close: () => void;
+    props?: Record<string, any>;
+};
+type ItemPropsWeControl = "aria-describedby" | "aria-disabled" | "aria-labelledby" | "role" | "tabIndex";
+export type MenuItemProps<TTag extends ElementType = typeof DEFAULT_ITEM_TAG> = Props<TTag, ItemRenderPropArg, ItemPropsWeControl | "children", {
+    id?: string;
+    disabled?: boolean;
+    children: Children<ItemRenderPropArg>;
+}>;
+export type MenuItemChildren = Children<ItemRenderPropArg>;
+declare class __sveltets_Render<TTag extends ElementType = typeof DEFAULT_ITEM_TAG> {
+    props(): {
+        as?: TTag | undefined;
+    } & (Exclude<keyof import("../utils/types.js").PropsOf<TTag>, ("as" | "children" | "refName" | "class") | "disabled" | "id" | ItemPropsWeControl> extends infer T extends keyof import("../utils/types.js").PropsOf<TTag> ? { [P in T]: import("../utils/types.js").PropsOf<TTag>[P]; } : never) & {
+        children?: Children<ItemRenderPropArg> | undefined;
+        ref?: HTMLElement;
+    } & (true extends (import("../utils/types.js").PropsOf<TTag> extends infer T_1 ? T_1 extends import("../utils/types.js").PropsOf<TTag> ? T_1 extends never ? never : "class" extends infer T_2 ? T_2 extends "class" ? T_2 extends keyof T_1 ? true : never : never : never : never : never) ? {
+        class?: import("../utils/types.js").PropsOf<TTag>["class"] | ((bag: ItemRenderPropArg) => string) | undefined;
+    } : {}) & {
+        id?: string;
+        disabled?: boolean;
+        children: Children<ItemRenderPropArg>;
+    };
+    events(): {} & {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots(): {};
+    bindings(): "ref";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TTag extends ElementType = typeof DEFAULT_ITEM_TAG>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TTag>['bindings']>;
+    } & ReturnType<__sveltets_Render<TTag>['exports']>;
+    <TTag extends ElementType = typeof DEFAULT_ITEM_TAG>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
+        $$events?: ReturnType<__sveltets_Render<TTag>['events']>;
+    }): ReturnType<__sveltets_Render<TTag>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const MenuItem: $$IsomorphicComponent;
+type MenuItem<TTag extends ElementType = typeof DEFAULT_ITEM_TAG> = InstanceType<typeof MenuItem<TTag>>;
+export default MenuItem;

package/dist/menu/MenuItems.svelte

@@ -0,0 +1,244 @@
+<script lang="ts" module>import { mergeProps, RenderFeatures } from "../utils/render.js";
+import {
+  useFloatingPanel,
+  useFloatingPanelProps,
+  useResolvedAnchor
+} from "../internal/floating.svelte.js";
+const DEFAULT_ITEMS_TAG = "div";
+let ItemsRenderFeatures = RenderFeatures.RenderStrategy | RenderFeatures.Static;
+</script>
+
+<script lang="ts" generics="TTag extends ElementType = typeof DEFAULT_ITEMS_TAG">import { useId } from "../hooks/use-id.js";
+import { getOwnerDocument } from "../utils/owner.js";
+import { State, useOpenClosed } from "../internal/open-closed.js";
+import { transitionDataAttributes, useTransition } from "../hooks/use-transition.svelte.js";
+import { useOnDisappear } from "../hooks/use-on-disappear.svelte.js";
+import { useScrollLock } from "../hooks/use-scroll-lock.svelte.js";
+import { useInertOthers } from "../hooks/use-inert-others.svelte.js";
+import { useDidElementMove } from "../hooks/use-did-element-move.svelte.js";
+import { useDisposables } from "../utils/disposables.js";
+import { Focus } from "../utils/calculate-active-index.js";
+import { focusFrom, Focus as FocusManagementFocus, restoreFocusIfNecessary } from "../utils/focus-management.js";
+import { useElementSize } from "../hooks/use-element-size.svelte.js";
+import { tick, untrack } from "svelte";
+import Portal from "../portal/Portal.svelte";
+import { MenuStates, useMenuContext } from "./context.svelte.js";
+import { useTreeWalker } from "../hooks/use-tree-walker.svelte.js";
+import ElementOrComponent from "../utils/ElementOrComponent.svelte";
+const internalId = useId();
+let {
+  as = DEFAULT_ITEMS_TAG,
+  ref = $bindable(),
+  id = `headlessui-menu-items-${internalId}`,
+  anchor: rawAnchor,
+  portal = false,
+  modal = true,
+  transition = false,
+  ...theirProps
+} = $props();
+const anchor = $derived(useResolvedAnchor(rawAnchor));
+const _state = useMenuContext("MenuOptions");
+const floatingPanel = useFloatingPanel({
+  get placement() {
+    return anchor;
+  }
+});
+const { setFloating, style } = $derived(floatingPanel);
+const getFloatingPanelProps = useFloatingPanelProps();
+$effect(() => {
+  untrack(() => _state.setItemsElement(ref || null));
+  if (anchor) setFloating(ref);
+});
+const ownerDocument = $derived(getOwnerDocument(_state.itemsElement));
+$effect(() => {
+  if (anchor) {
+    portal = true;
+  }
+});
+const usesOpenClosedState = useOpenClosed();
+const show = $derived(
+  usesOpenClosedState !== null ? (usesOpenClosedState.value & State.Open) === State.Open : _state.menuState === MenuStates.Open
+);
+const _transition = useTransition({
+  get enabled() {
+    return transition;
+  },
+  get element() {
+    return ref;
+  },
+  get show() {
+    return show;
+  }
+});
+const { visible, data: transitionData } = $derived(_transition);
+useOnDisappear({
+  get enabled() {
+    return visible;
+  },
+  get ref() {
+    return _state.buttonElement;
+  },
+  get ondisappear() {
+    return _state.closeMenu;
+  }
+});
+const scrollLockEnabled = $derived(_state.__demoMode ? false : modal && _state.menuState === MenuStates.Open);
+useScrollLock({
+  get enabled() {
+    return scrollLockEnabled;
+  },
+  get ownerDocument() {
+    return ownerDocument;
+  }
+});
+const inertOthersEnabled = $derived(_state.__demoMode ? false : modal && _state.menuState === MenuStates.Open);
+useInertOthers({
+  get enabled() {
+    return inertOthersEnabled;
+  },
+  elements: {
+    get allowed() {
+      return [_state.buttonElement, _state.itemsElement].filter(Boolean);
+    }
+  }
+});
+const didElementMoveEnabled = $derived(_state.menuState !== MenuStates.Open);
+const didButtonMove = useDidElementMove({
+  get enabled() {
+    return didElementMoveEnabled;
+  },
+  get element() {
+    return _state.buttonElement;
+  }
+});
+const panelEnabled = $derived(didButtonMove.value ? false : visible);
+$effect(() => {
+  let container = _state.itemsElement;
+  if (!container) return;
+  if (_state.menuState !== MenuStates.Open) return;
+  if (container === ownerDocument?.activeElement) return;
+  container.focus({ preventScroll: true });
+});
+useTreeWalker({
+  get enabled() {
+    return _state.menuState === MenuStates.Open;
+  },
+  get container() {
+    return _state.itemsElement;
+  },
+  accept: (node) => {
+    if (node.getAttribute("role") === "menuitem") return NodeFilter.FILTER_REJECT;
+    if (node.hasAttribute("role")) return NodeFilter.FILTER_SKIP;
+    return NodeFilter.FILTER_ACCEPT;
+  },
+  walk: (node) => {
+    node.setAttribute("role", "none");
+  }
+});
+const searchDisposables = useDisposables();
+const handleKeyDown = async (event) => {
+  searchDisposables.dispose();
+  switch (event.key) {
+    case " ":
+      if (_state.searchQuery !== "") {
+        event.preventDefault();
+        event.stopPropagation();
+        return _state.search(event.key);
+      }
+    case "Enter":
+      event.preventDefault();
+      event.stopPropagation();
+      _state.closeMenu();
+      if (_state.activeItemIndex !== null) {
+        let { dataRef } = _state.items[_state.activeItemIndex];
+        dataRef.current?.domRef.current?.click();
+      }
+      restoreFocusIfNecessary(_state.buttonElement);
+      break;
+    case "ArrowDown":
+      event.preventDefault();
+      event.stopPropagation();
+      return _state.goToItem({ focus: Focus.Next });
+    case "ArrowUp":
+      event.preventDefault();
+      event.stopPropagation();
+      return _state.goToItem({ focus: Focus.Previous });
+    case "Home":
+    case "PageUp":
+      event.preventDefault();
+      event.stopPropagation();
+      return _state.goToItem({ focus: Focus.First });
+    case "End":
+    case "PageDown":
+      event.preventDefault();
+      event.stopPropagation();
+      return _state.goToItem({ focus: Focus.Last });
+    case "Escape":
+      event.preventDefault();
+      event.stopPropagation();
+      _state.closeMenu();
+      await tick();
+      _state.buttonElement?.focus({ preventScroll: true });
+      break;
+    case "Tab":
+      event.preventDefault();
+      event.stopPropagation();
+      _state.closeMenu();
+      await tick();
+      focusFrom(_state.buttonElement, event.shiftKey ? FocusManagementFocus.Previous : FocusManagementFocus.Next);
+      break;
+    default:
+      if (event.key.length === 1) {
+        _state.search(event.key);
+        searchDisposables.setTimeout(() => _state.clearSearch(), 350);
+      }
+      break;
+  }
+};
+const handleKeyUp = (event) => {
+  switch (event.key) {
+    case " ":
+      event.preventDefault();
+      break;
+  }
+};
+const slot = $derived({
+  open: _state.menuState === MenuStates.Open
+});
+const buttonSize = useElementSize({
+  get element() {
+    return _state.buttonElement;
+  },
+  unit: true
+});
+const ourProps = $derived(
+  mergeProps(anchor ? getFloatingPanelProps() : {}, {
+    "aria-activedescendant": _state.activeItemIndex === null ? void 0 : _state.items[_state.activeItemIndex]?.id,
+    "aria-labelledby": _state.buttonElement?.id,
+    id,
+    onkeydown: handleKeyDown,
+    onkeyup: handleKeyUp,
+    role: "menu",
+    // When the `Menu` is closed, it should not be focusable. This allows us
+    // to skip focusing the `MenuItems` when pressing the tab key on an
+    // open `Menu`, and go to the next focusable element.
+    tabindex: _state.menuState === MenuStates.Open ? 0 : void 0,
+    ref,
+    style: [theirProps.style, style, `--button-width: ${buttonSize.width}`].filter(Boolean).join("; "),
+    ...transitionDataAttributes(transitionData)
+  })
+);
+</script>
+
+<Portal enabled={portal ? theirProps.static || visible : false}>
+  <ElementOrComponent
+    {ourProps}
+    {theirProps}
+    slots={slot}
+    defaultTag={DEFAULT_ITEMS_TAG}
+    features={ItemsRenderFeatures}
+    visible={panelEnabled}
+    name="MenuItems"
+    bind:ref
+  />
+</Portal>

package/dist/menu/MenuItems.svelte.d.ts

@@ -0,0 +1,55 @@
+import type { ElementType, Props } from "../utils/types.js";
+import { type PropsForFeatures } from "../utils/render.js";
+import { type AnchorProps } from "../internal/floating.svelte.js";
+declare const DEFAULT_ITEMS_TAG: "div";
+type ItemsRenderPropArg = {
+    open: boolean;
+};
+type ItemsPropsWeControl = "aria-activedescendant" | "aria-labelledby" | "role" | "tabIndex";
+declare let ItemsRenderFeatures: number;
+export type MenuItemsProps<TTag extends ElementType = typeof DEFAULT_ITEMS_TAG> = Props<TTag, ItemsRenderPropArg, ItemsPropsWeControl, {
+    id?: string;
+    anchor?: AnchorProps;
+    portal?: boolean;
+    modal?: boolean;
+    transition?: boolean;
+} & PropsForFeatures<typeof ItemsRenderFeatures>>;
+export type MenuItemsChildren = Snippet<[ItemsRenderPropArg]>;
+import { type Snippet } from "svelte";
+declare class __sveltets_Render<TTag extends ElementType = typeof DEFAULT_ITEMS_TAG> {
+    props(): {
+        as?: TTag | undefined;
+    } & (Exclude<keyof import("../utils/types.js").PropsOf<TTag>, ("as" | "children" | "refName" | "class") | "anchor" | "unmount" | "static" | "id" | "transition" | "portal" | "modal" | ItemsPropsWeControl> extends infer T extends keyof import("../utils/types.js").PropsOf<TTag> ? { [P in T]: import("../utils/types.js").PropsOf<TTag>[P]; } : never) & {
+        children?: import("../utils/types.js").Children<ItemsRenderPropArg> | undefined;
+        ref?: HTMLElement;
+    } & (true extends (import("../utils/types.js").PropsOf<TTag> extends infer T_1 ? T_1 extends import("../utils/types.js").PropsOf<TTag> ? T_1 extends never ? never : "class" extends infer T_2 ? T_2 extends "class" ? T_2 extends keyof T_1 ? true : never : never : never : never : never) ? {
+        class?: import("../utils/types.js").PropsOf<TTag>["class"] | ((bag: ItemsRenderPropArg) => string) | undefined;
+    } : {}) & {
+        id?: string;
+        anchor?: AnchorProps;
+        portal?: boolean;
+        modal?: boolean;
+        transition?: boolean;
+    } & {
+        static?: boolean | undefined;
+        unmount?: boolean | undefined;
+    };
+    events(): {} & {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots(): {};
+    bindings(): "ref";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TTag extends ElementType = typeof DEFAULT_ITEMS_TAG>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TTag>['bindings']>;
+    } & ReturnType<__sveltets_Render<TTag>['exports']>;
+    <TTag extends ElementType = typeof DEFAULT_ITEMS_TAG>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
+        $$events?: ReturnType<__sveltets_Render<TTag>['events']>;
+    }): ReturnType<__sveltets_Render<TTag>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const MenuItems: $$IsomorphicComponent;
+type MenuItems<TTag extends ElementType = typeof DEFAULT_ITEMS_TAG> = InstanceType<typeof MenuItems<TTag>>;
+export default MenuItems;

package/dist/menu/MenuSection.svelte

@@ -0,0 +1,14 @@
+<script lang="ts" module>const DEFAULT_SECTION_TAG = "div";
+</script>
+
+<script lang="ts" generics="TTag extends ElementType = typeof DEFAULT_SECTION_TAG">import { useLabels } from "../label/context.svelte.js";
+import ElementOrComponent from "../utils/ElementOrComponent.svelte";
+const labelledby = useLabels();
+let { ref = $bindable(), ...theirProps } = $props();
+const ourProps = $derived({
+  "aria-labelledby": labelledby,
+  role: "group"
+});
+</script>
+
+<ElementOrComponent {ourProps} {theirProps} defaultTag={DEFAULT_SECTION_TAG} name="MenuSection" bind:ref />

package/dist/menu/MenuSection.svelte.d.ts

@@ -0,0 +1,35 @@
+import type { Snippet } from "svelte";
+import type { ElementType, Props } from "../utils/types.js";
+declare const DEFAULT_SECTION_TAG: "div";
+type SectionRenderPropArg = {};
+type SectionPropsWeControl = "role" | "aria-labelledby";
+export type MenuSectionProps<TTag extends ElementType = typeof DEFAULT_SECTION_TAG> = Props<TTag, SectionRenderPropArg, SectionPropsWeControl>;
+export type MenuSectionChildren = Snippet<[SectionRenderPropArg]>;
+declare class __sveltets_Render<TTag extends ElementType = typeof DEFAULT_SECTION_TAG> {
+    props(): {
+        as?: TTag | undefined;
+    } & (Exclude<keyof import("../utils/types.js").PropsOf<TTag>, ("as" | "children" | "refName" | "class") | SectionPropsWeControl> extends infer T extends keyof import("../utils/types.js").PropsOf<TTag> ? { [P in T]: import("../utils/types.js").PropsOf<TTag>[P]; } : never) & {
+        children?: import("../utils/types.js").Children<SectionRenderPropArg> | undefined;
+        ref?: HTMLElement;
+    } & (true extends (import("../utils/types.js").PropsOf<TTag> extends infer T_1 ? T_1 extends import("../utils/types.js").PropsOf<TTag> ? T_1 extends never ? never : "class" extends infer T_2 ? T_2 extends "class" ? T_2 extends keyof T_1 ? true : never : never : never : never : never) ? {
+        class?: import("../utils/types.js").PropsOf<TTag>["class"] | ((bag: SectionRenderPropArg) => string) | undefined;
+    } : {});
+    events(): {} & {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots(): {};
+    bindings(): "ref";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TTag extends ElementType = typeof DEFAULT_SECTION_TAG>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TTag>['bindings']>;
+    } & ReturnType<__sveltets_Render<TTag>['exports']>;
+    <TTag extends ElementType = typeof DEFAULT_SECTION_TAG>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
+        $$events?: ReturnType<__sveltets_Render<TTag>['events']>;
+    }): ReturnType<__sveltets_Render<TTag>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const MenuSection: $$IsomorphicComponent;
+type MenuSection<TTag extends ElementType = typeof DEFAULT_SECTION_TAG> = InstanceType<typeof MenuSection<TTag>>;
+export default MenuSection;

package/dist/menu/MenuSeparator.svelte

@@ -0,0 +1,9 @@
+<script lang="ts" module>const DEFAULT_SEPARATOR_TAG = "div";
+</script>
+
+<script lang="ts" generics="TTag extends ElementType = typeof DEFAULT_SEPARATOR_TAG">import ElementOrComponent from "../utils/ElementOrComponent.svelte";
+let { ref = $bindable(), ...theirProps } = $props();
+const ourProps = { role: "separator" };
+</script>
+
+<ElementOrComponent {ourProps} {theirProps} defaultTag={DEFAULT_SEPARATOR_TAG} name="MenuSeparator" bind:ref />

package/dist/menu/MenuSeparator.svelte.d.ts

@@ -0,0 +1,35 @@
+import type { Snippet } from "svelte";
+import type { ElementType, Props } from "../utils/types.js";
+declare const DEFAULT_SEPARATOR_TAG: "div";
+type SeparatorRenderPropArg = {};
+type SeparatorPropsWeControl = "role";
+export type MenuSeparatorProps<TTag extends ElementType = typeof DEFAULT_SEPARATOR_TAG> = Props<TTag, SeparatorRenderPropArg, SeparatorPropsWeControl>;
+export type MenuSeparatorChildren = Snippet<[SeparatorRenderPropArg]>;
+declare class __sveltets_Render<TTag extends ElementType = typeof DEFAULT_SEPARATOR_TAG> {
+    props(): {
+        as?: TTag | undefined;
+    } & (Exclude<keyof import("../utils/types.js").PropsOf<TTag>, ("as" | "children" | "refName" | "class") | "role"> extends infer T extends keyof import("../utils/types.js").PropsOf<TTag> ? { [P in T]: import("../utils/types.js").PropsOf<TTag>[P]; } : never) & {
+        children?: import("../utils/types.js").Children<SeparatorRenderPropArg> | undefined;
+        ref?: HTMLElement;
+    } & (true extends (import("../utils/types.js").PropsOf<TTag> extends infer T_1 ? T_1 extends import("../utils/types.js").PropsOf<TTag> ? T_1 extends never ? never : "class" extends infer T_2 ? T_2 extends "class" ? T_2 extends keyof T_1 ? true : never : never : never : never : never) ? {
+        class?: import("../utils/types.js").PropsOf<TTag>["class"] | ((bag: SeparatorRenderPropArg) => string) | undefined;
+    } : {});
+    events(): {} & {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots(): {};
+    bindings(): "ref";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TTag extends ElementType = typeof DEFAULT_SEPARATOR_TAG>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TTag>['bindings']>;
+    } & ReturnType<__sveltets_Render<TTag>['exports']>;
+    <TTag extends ElementType = typeof DEFAULT_SEPARATOR_TAG>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
+        $$events?: ReturnType<__sveltets_Render<TTag>['events']>;
+    }): ReturnType<__sveltets_Render<TTag>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const MenuSeparator: $$IsomorphicComponent;
+type MenuSeparator<TTag extends ElementType = typeof DEFAULT_SEPARATOR_TAG> = InstanceType<typeof MenuSeparator<TTag>>;
+export default MenuSeparator;

package/dist/menu/context.svelte.d.ts

@@ -0,0 +1,47 @@
+import type { Focus } from "../utils/calculate-active-index.js";
+import type { MutableRefObject } from "../utils/ref.svelte.js";
+export declare enum MenuStates {
+    Open = 0,
+    Closed = 1
+}
+export declare enum ActivationTrigger {
+    Pointer = 0,
+    Other = 1
+}
+export type MenuItemDataRef = MutableRefObject<{
+    textValue?: string;
+    disabled: boolean;
+    domRef: MutableRefObject<HTMLElement | null>;
+}>;
+export interface StateDefinition {
+    __demoMode: boolean;
+    menuState: MenuStates;
+    buttonElement: HTMLButtonElement | null;
+    itemsElement: HTMLElement | null;
+    items: {
+        id: string;
+        dataRef: MenuItemDataRef;
+    }[];
+    searchQuery: string;
+    activeItemIndex: number | null;
+    activationTrigger: ActivationTrigger;
+}
+export type MenuContext = StateDefinition & {
+    closeMenu(): void;
+    openMenu(): void;
+    goToItem(action: {
+        focus: Focus.Specific;
+        id: string;
+        trigger?: ActivationTrigger;
+    } | {
+        focus: Exclude<Focus, Focus.Specific>;
+        trigger?: ActivationTrigger;
+    }): void;
+    search(value: string): void;
+    clearSearch(): void;
+    registerItem(id: string, dataRef: MenuItemDataRef): void;
+    unregisterItem(id: string): void;
+    setButtonElement(element: HTMLButtonElement | null): void;
+    setItemsElement(element: HTMLElement | null): void;
+};
+export declare function useMenuContext(component: string): MenuContext;