@svelte-atoms/core 1.0.0-alpha.31 → 1.0.0-alpha.33

package/dist/components/dropdown/item/types.d.ts

@@ -0,0 +1,29 @@
+import type { Snippet } from 'svelte';
+import type { MenuItemProps } from '../../menu/item/types';
+import type { DropdownItemController } from './controller.svelte';
+export interface DropdownItemProps<T = unknown> extends Omit<MenuItemProps, 'factory' | 'children' | 'preset'> {
+    /**
+     * Preset key for styling
+     * @default 'dropdown.item'
+     */
+    preset?: string;
+    /**
+     * The value of the dropdown item
+     * @default nanoid()
+     */
+    value?: string;
+    /**
+     * Custom data associated with the item
+     */
+    data?: T;
+    /**
+     * Factory function to create a custom DropdownItemController instance
+     */
+    factory?: () => DropdownItemController<T>;
+    /**
+     * Render prop for children
+     */
+    children?: Snippet<[{
+        dropdownItem: DropdownItemController<T>;
+    }]>;
+}

package/dist/components/dropdown/item/types.js

@@ -0,0 +1 @@
+export {};

package/dist/components/list/list-item.svelte

@@ -1,20 +1,20 @@
-<script lang="ts" generics="T extends keyof HTMLElementTagNameMap = 'li', B extends Base = Base">
-	import { HtmlAtom, type Base } from '../atom';
-
-	let {
-		class: klass = '',
-		as = 'li' as T,
-		preset = 'list.item',
-		children = undefined,
-		...restProps
-	} = $props();
-</script>
-
-<HtmlAtom
-	{as}
-	{preset}
-	class={['border-border flex w-full gap-2 px-4 py-1', '$preset', klass]}
-	{...restProps}
->
-	{@render children?.()}
-</HtmlAtom>
+<script lang="ts" generics="T extends keyof HTMLElementTagNameMap = 'li', B extends Base = Base">
+	import { HtmlAtom, type Base } from '../atom';
+
+	let {
+		class: klass = '',
+		as = 'li' as T,
+		preset = 'list.item',
+		children = undefined,
+		...restProps
+	} = $props();
+</script>
+
+<HtmlAtom
+	{as}
+	{preset}
+	class={['border-border flex w-full gap-2 px-4 py-1', '$preset', klass]}
+	{...restProps}
+>
+	{@render children?.()}
+</HtmlAtom>

package/dist/components/menu/atoms.d.ts

@@ -1,4 +1,9 @@
-export { Root, Trigger, Arrow, Indicator } from '../popover/atoms';
-export { default as List } from './menu-list.svelte';
-export { default as Item } from './menu-item.svelte';
+export { default as Root } from './menu-root.svelte';
+export { default as Content } from './menu-content.svelte';
+/**
+ * @deprecated Use Menu.Content instead
+ */
+export { default as List } from './menu-content.svelte';
+export { default as Item } from './item/menu-item.svelte';
+export { Trigger, Arrow, Indicator } from '../popover/atoms';
 export { Divider, Group, Title } from '../list/atoms';

package/dist/components/menu/atoms.js

@@ -1,4 +1,9 @@
-export { Root, Trigger, Arrow, Indicator } from '../popover/atoms';
-export { default as List } from './menu-list.svelte';
-export { default as Item } from './menu-item.svelte';
+export { default as Root } from './menu-root.svelte';
+export { default as Content } from './menu-content.svelte';
+/**
+ * @deprecated Use Menu.Content instead
+ */
+export { default as List } from './menu-content.svelte';
+export { default as Item } from './item/menu-item.svelte';
+export { Trigger, Arrow, Indicator } from '../popover/atoms';
 export { Divider, Group, Title } from '../list/atoms';

package/dist/components/menu/bond.svelte.d.ts

@@ -0,0 +1,54 @@
+import { PopoverBond, PopoverState, type PopoverDomElements, type PopoverStateProps } from '../popover/bond.svelte';
+import type { MenuItemController } from './item/controller.svelte';
+export type MenuBondProps = PopoverStateProps;
+export type MenuBondElements = PopoverDomElements;
+export declare class MenuBond<Props extends MenuBondProps = MenuBondProps, State extends MenuBondState<Props> = MenuBondState<Props>, Elements extends MenuBondElements = MenuBondElements> extends PopoverBond<Props, State, Elements> {
+    constructor(state: State);
+    content(): {
+        role: string;
+        'aria-activedescendant': string | undefined;
+        'aria-orientation': "vertical";
+        onkeydown: (ev: KeyboardEvent) => void;
+        id: string;
+        'aria-modal': boolean;
+        'aria-labelledby': string;
+        inert: boolean | undefined;
+        tabindex: number;
+        'data-atom': string;
+        'data-kind': string;
+        'data-active': boolean;
+    };
+    trigger(): {
+        'aria-haspopup': "menu";
+        onkeydown: (ev: KeyboardEvent) => void;
+        id: string;
+        role: string;
+        disabled: boolean | undefined;
+        tabindex: number;
+        'aria-expanded': boolean;
+        'aria-disabled': boolean;
+        'aria-controls': string;
+        'data-kind': string;
+        onclick: (ev: PointerEvent) => void;
+    };
+    item(): {
+        role: string;
+        onkeyup: (ev: KeyboardEvent) => void;
+    };
+    static get<Props extends MenuBondProps = MenuBondProps, State extends MenuBondState<Props> = MenuBondState<Props>, Elements extends MenuBondElements = MenuBondElements>(): MenuBond<Props, State, Elements> | undefined;
+    static set<Props extends MenuBondProps = MenuBondProps, State extends MenuBondState<Props> = MenuBondState<Props>, Elements extends MenuBondElements = MenuBondElements>(context: MenuBond<Props, State, Elements>): MenuBond<Props, State, Elements>;
+}
+export declare class MenuBondState<Props extends MenuBondProps = MenuBondProps> extends PopoverState<Props> {
+    #private;
+    constructor(props: () => Props);
+    get items(): Map<string, MenuItemController>;
+    get highlightedId(): string | null;
+    get highlightedItem(): MenuItemController | null;
+    get navigation(): {
+        next: () => MenuItemController | null;
+        previous: () => MenuItemController | null;
+    };
+    mountItem(id: string, item: MenuItemController): () => void;
+    unmountItem(id: string): void;
+    item(id: string): MenuItemController | undefined;
+}

package/dist/components/menu/bond.svelte.js

@@ -0,0 +1,132 @@
+import { SvelteMap, SvelteSet } from 'svelte/reactivity';
+import { PopoverBond, PopoverState } from '../popover/bond.svelte';
+export class MenuBond extends PopoverBond {
+    constructor(state) {
+        super(state);
+    }
+    content() {
+        const superProps = super.content();
+        const onkeydown = superProps.onkeydown;
+        const highlightedId = this.state.highlightedId;
+        return {
+            ...superProps,
+            role: 'menu',
+            'aria-activedescendant': highlightedId ? `item-${highlightedId}` : undefined,
+            'aria-orientation': 'vertical',
+            onkeydown: (ev) => {
+                // Call any additional onkeydown handler
+                onkeydown?.(ev);
+                if (ev.defaultPrevented)
+                    return;
+                // Handle arrow key navigation
+                if (ev.key === 'ArrowDown') {
+                    this.state.navigation.next();
+                }
+                if (ev.key === 'ArrowUp') {
+                    this.state.navigation.previous();
+                }
+            }
+        };
+    }
+    trigger() {
+        const superProps = super.trigger();
+        return {
+            ...superProps,
+            'aria-haspopup': 'menu',
+            'onkeydown': (ev) => {
+                if (ev.key === 'ArrowDown') {
+                    this.state.navigation.next();
+                }
+                if (ev.key === 'ArrowUp') {
+                    this.state.navigation.previous();
+                }
+                if ((ev.key === 'Enter' || ev.key === ' ') && this.state.props.open && this.state.highlightedItem) {
+                    if (ev.key === ' ') {
+                        ev.preventDefault();
+                    }
+                    this.state.highlightedItem?.element?.click();
+                }
+                // Call any additional onkeydown handler
+                superProps.onkeydown?.(ev);
+            }
+        };
+    }
+    item() {
+        return {
+            role: 'menuitem',
+            onkeyup: (ev) => {
+                const currentTarget = ev.currentTarget;
+                const disabled = currentTarget.getAttribute('disabled') ||
+                    currentTarget.getAttribute('aria-disabled') === 'true';
+                if (disabled)
+                    return;
+                // Activate on Enter or Space
+                if (ev.key === 'Enter' || ev.key === ' ') {
+                    ev.preventDefault();
+                    // Call the click handler if provided
+                    // cast to any to avoid strict event-type mismatch when forwarding
+                    this?.state.close();
+                }
+            }
+        };
+    }
+    static get() {
+        return PopoverBond.get();
+    }
+    static set(context) {
+        return PopoverBond.set(context);
+    }
+}
+export class MenuBondState extends PopoverState {
+    #keys = new SvelteSet();
+    #items = new SvelteMap();
+    #itemsAsArray = $derived(Array.from(this.#items.values()));
+    #index = $state(-1);
+    #highlightedId = $derived(Array.from(this.#items.keys())[this.#index] ?? null);
+    #highlightedItem = $derived(this.#itemsAsArray[this.#index] ?? null);
+    constructor(props) {
+        super(props);
+    }
+    get items() {
+        return this.#items;
+    }
+    get highlightedId() {
+        return this.#highlightedId;
+    }
+    get highlightedItem() {
+        return this.#highlightedItem;
+    }
+    get navigation() {
+        return {
+            next: () => {
+                if (this.#index < 0) {
+                    this.#index = 0;
+                    return this.#highlightedItem;
+                }
+                const length = this.#items.size;
+                this.#index = Math.min((this.#index + 1) % length, length - 1);
+                return this.#highlightedItem;
+            },
+            previous: () => {
+                if (this.#index <= 0) {
+                    this.#index = this.#items.size - 1;
+                    return this.#highlightedItem;
+                }
+                this.#index = Math.max(this.#index - 1, 0);
+                return this.#highlightedItem;
+            }
+        };
+    }
+    mountItem(id, item) {
+        this.#items.set(id, item);
+        return () => this.unmountItem(id);
+    }
+    unmountItem(id) {
+        if (this.#keys.has(id))
+            return; // keep the item if it's still in the data source
+        this.#items.delete(id);
+    }
+    item(id) {
+        return this.#items.get(id);
+    }
+}

package/dist/components/menu/index.d.ts

@@ -2,3 +2,4 @@ export * as Menu from './atoms';
 export * from './types';
 export { PopoverBond, type PopoverDomElements, type PopoverParams, PopoverState, type PopoverStateProps, type TriggerParams } from '../popover';
 export type { AnimatePopoverContentParams as AnimateMenuContentParams, animatePopoverContent as animateMenuContent } from '../popover/motion';
+export * from './item';

package/dist/components/menu/index.js

@@ -1,3 +1,4 @@
 export * as Menu from './atoms';
 export * from './types';
 export { PopoverBond, PopoverState } from '../popover';
+export * from './item';

package/dist/components/menu/item/controller.svelte.d.ts

@@ -0,0 +1,26 @@
+import { MenuBond, MenuBondState, type MenuBondProps } from '../bond.svelte';
+export type MenuItemControllerProps = {
+    id?: string;
+};
+export declare class MenuItemController {
+    #private;
+    static CONTEXT_KEY: string;
+    constructor(props?: () => MenuItemControllerProps);
+    get id(): string;
+    get props(): MenuItemControllerProps;
+    get element(): HTMLElement | null;
+    get menu(): MenuBond<MenuBondProps, MenuBondState<MenuBondProps>, import("..").PopoverDomElements> | undefined;
+    get isHighlighted(): boolean;
+    mount(): () => void;
+    unmount(): void;
+    destroy(): void;
+    share(): MenuItemController;
+    elementProps(): {
+        readonly [x: symbol]: (node: HTMLElement) => () => void;
+        readonly id: string;
+        readonly role: "menuitem";
+        readonly 'data-highlighted': boolean;
+    };
+    static get(): MenuItemController | undefined;
+    static set(item: MenuItemController): MenuItemController;
+}

package/dist/components/menu/item/controller.svelte.js

@@ -0,0 +1,69 @@
+import { getContext, setContext } from 'svelte';
+import { createAttachmentKey } from 'svelte/attachments';
+import { nanoid } from 'nanoid';
+import { MenuBond, MenuBondState } from '../bond.svelte';
+export class MenuItemController {
+    static CONTEXT_KEY = '@atoms/context/menu/item';
+    #id;
+    #props;
+    #element = null;
+    #menu;
+    #unmount;
+    constructor(props = () => ({})) {
+        this.#props = props;
+        this.#id = this.props.id ?? nanoid();
+        this.#menu = MenuBond.get();
+        if (!this.#menu) {
+            throw new Error('MenuItem must be used within a Menu context');
+        }
+    }
+    get id() {
+        return this.#id;
+    }
+    get props() {
+        return this.#props();
+    }
+    get element() {
+        return this.#element;
+    }
+    get menu() {
+        return this.#menu;
+    }
+    get isHighlighted() {
+        return this.#menu?.state.highlightedId === this.#id;
+    }
+    mount() {
+        this.#unmount = this.#menu?.state?.mountItem?.(this.#id, this) ?? undefined;
+        return this.unmount;
+    }
+    unmount() {
+        this.#unmount?.();
+    }
+    destroy() {
+        this.unmount();
+    }
+    share() {
+        return MenuItemController.set(this);
+    }
+    elementProps() {
+        const itemId = `item-${this.id}`;
+        return {
+            id: itemId,
+            role: 'menuitem',
+            'data-highlighted': this.isHighlighted,
+            [createAttachmentKey()]: (node) => {
+                this.#element = node;
+                return () => {
+                    // this.#unmount?.();
+                    this.#element = null;
+                };
+            }
+        };
+    }
+    static get() {
+        return getContext(MenuItemController.CONTEXT_KEY);
+    }
+    static set(item) {
+        return setContext(MenuItemController.CONTEXT_KEY, item);
+    }
+}

package/dist/components/menu/item/index.d.ts

@@ -0,0 +1,2 @@
+export { MenuItemController, type MenuItemControllerProps } from './controller.svelte';
+export * from './types';

package/dist/components/menu/item/index.js

@@ -0,0 +1,2 @@
+export { MenuItemController } from './controller.svelte';
+export * from './types';

package/dist/components/menu/item/menu-item.svelte

@@ -0,0 +1,103 @@
+<script
+	lang="ts"
+	generics="D, E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base"
+>
+	import { defineProperty, defineState } from '../../../utils';
+	import type { Base } from '../../atom';
+	import { MenuItemController, type MenuItemControllerProps } from './controller.svelte';
+	import { MenuBond } from '../bond.svelte';
+	import { List } from '../../list';
+	import type { MenuItemProps } from './types';
+
+	const menu = MenuBond.get();
+
+	if (!menu) {
+		throw new Error('<MenuItem> must be used within a <Menu>.');
+	}
+
+	const ID = $props.id();
+
+	let {
+		class: klass = '',
+		id = ID,
+		preset: presetKey = 'menu.item',
+		children = undefined,
+		onclick = undefined,
+		disabled = undefined,
+		onmount = undefined,
+		ondestroy = undefined,
+		animate = undefined,
+		enter = undefined,
+		exit = undefined,
+		initial = undefined,
+		factory = _factory,
+		...restProps
+	}: MenuItemProps = $props();
+
+	const controller = factory().share();
+
+	const itemProps = $derived({
+		...menu?.item?.(),
+		...controller?.elementProps(),
+		...restProps
+	});
+
+	$effect(() => {
+		return () => {
+			controller.destroy();
+		};
+	});
+
+	function _factory() {
+		const item = menu?.state?.item?.(id);
+
+		if (item) {
+			return item as MenuItemController;
+		}
+
+		const bondProps = defineState<MenuItemControllerProps>([defineProperty('id', () => id)]);
+		const controller = new MenuItemController(() => bondProps);
+
+		controller.mount();
+
+		return controller;
+	}
+
+	function handleClick(ev: MouseEvent) {
+		onclick?.(ev);
+
+		if (ev.defaultPrevented) {
+			return;
+		}
+
+		ev.preventDefault();
+
+		controller?.menu?.state.close();
+	}
+
+	export function getController() {
+		return controller;
+	}
+</script>
+
+<List.Item
+	bond={controller}
+	preset={presetKey}
+	class={[
+		'border-border last:border-b-none hover:bg-foreground/5 active:bg-foreground/10 outline-primary cursor-pointer border-b',
+		'$preset',
+		klass
+	]}
+	onmount={onmount?.bind(controller) as any}
+	ondestroy={ondestroy?.bind(controller) as any}
+	enter={enter?.bind(controller) as any}
+	exit={exit?.bind(controller) as any}
+	initial={initial?.bind(controller) as any}
+	animate={animate?.bind(controller) as any}
+	aria-disabled={disabled ? true : undefined}
+	tabIndex={disabled ? -1 : 0}
+	onclick={handleClick}
+	{...itemProps}
+>
+	{@render children?.({ menuItem: controller })}
+</List.Item>

package/dist/components/menu/item/menu-item.svelte.d.ts

@@ -0,0 +1,31 @@
+import type { Base } from '../../atom';
+import { MenuItemController } from './controller.svelte';
+import type { MenuItemProps } from './types';
+declare function $$render<D, E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base>(): {
+    props: MenuItemProps;
+    exports: {
+        getController: () => MenuItemController;
+    };
+    bindings: "";
+    slots: {};
+    events: {};
+};
+declare class __sveltets_Render<D, E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> {
+    props(): ReturnType<typeof $$render<D, E, B>>['props'];
+    events(): ReturnType<typeof $$render<D, E, B>>['events'];
+    slots(): ReturnType<typeof $$render<D, E, B>>['slots'];
+    bindings(): "";
+    exports(): {
+        getController: () => MenuItemController;
+    };
+}
+interface $$IsomorphicComponent {
+    new <D, E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<D, E, B>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<D, E, B>['props']>, ReturnType<__sveltets_Render<D, E, B>['events']>, ReturnType<__sveltets_Render<D, E, B>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<D, E, B>['bindings']>;
+    } & ReturnType<__sveltets_Render<D, E, B>['exports']>;
+    <D, E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base>(internal: unknown, props: ReturnType<__sveltets_Render<D, E, B>['props']> & {}): ReturnType<__sveltets_Render<D, E, B>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any, any, any>['bindings']>;
+}
+declare const MenuItem: $$IsomorphicComponent;
+type MenuItem<D, E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> = InstanceType<typeof MenuItem<D, E, B>>;
+export default MenuItem;

package/dist/components/menu/item/types.d.ts

@@ -0,0 +1,62 @@
+import type { Snippet } from 'svelte';
+import type { MenuItemController } from './controller.svelte';
+import type { ClassValue } from '../../../utils';
+import type { Base, HtmlAtomProps } from '../../atom';
+/**
+ * Extend this interface to add custom menu list properties in your application.
+ */
+export interface MenuItemExtendProps {
+}
+export interface MenuItemProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B>, MenuItemExtendProps {
+    /**
+     * Custom CSS class(es) to apply to the menu item
+     */
+    class?: ClassValue;
+    /**
+     * Preset key for styling
+     * @default 'menu.item'
+     */
+    preset?: string;
+    /**
+     * Whether the menu item is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Click event handler
+     */
+    onclick?: (event: MouseEvent) => void;
+    /**
+     * Mount lifecycle callback
+     */
+    onmount?: (this: MenuItemController) => void;
+    /**
+     * Destroy lifecycle callback
+     */
+    ondestroy?: (this: MenuItemController) => void;
+    /**
+     * Animation configuration
+     */
+    animate?: (this: MenuItemController) => any;
+    /**
+     * Enter animation configuration
+     */
+    enter?: (this: MenuItemController) => any;
+    /**
+     * Exit animation configuration
+     */
+    exit?: (this: MenuItemController) => any;
+    /**
+     * Initial state configuration
+     */
+    initial?: (this: MenuItemController) => any;
+    /**
+     * Factory function to create a custom MenuItemController instance
+     */
+    factory?: () => MenuItemController;
+    /**
+     * Render prop for children
+     */
+    children?: Snippet<[{
+        menuItem: MenuItemController;
+    }]>;
+}

package/dist/components/menu/item/types.js

@@ -0,0 +1 @@
+export {};