@svelte-atoms/core 1.0.0-alpha.41 → 1.0.0-alpha.44

package/dist/components/drawer/motion.d.ts

@@ -1,15 +1,69 @@
-import { type Easing } from 'motion';
+import { type Easing, type Spring } from 'motion';
+export type DrawerSide = 'left' | 'right' | 'top' | 'bottom';
+type EasingOption = Easing | Easing[] | Spring;
 type AnimateDrawerContentParams = {
+    /** Animation duration in seconds (default: 0.3) */
     duration?: number;
+    /** Delay before animation starts in seconds (default: 0) */
     delay?: number;
-    ease?: Easing | Easing[];
-    side?: 'left' | 'right' | 'top' | 'bottom';
+    /** Easing for open animation (default: smooth deceleration) */
+    easeOpen?: EasingOption;
+    /** Easing for close animation (default: snappy acceleration) */
+    easeClose?: EasingOption;
+    /** Easing override for both open/close */
+    ease?: EasingOption;
+    /** Use spring physics for natural motion (default: false) */
+    spring?: boolean;
+    /** Spring stiffness (default: 300) */
+    stiffness?: number;
+    /** Spring damping (default: 30) */
+    damping?: number;
+    /** Disable pointer events during animation (default: true) */
+    inert?: boolean;
 };
-export declare function animateDrawerContent(params: AnimateDrawerContentParams): (node: HTMLElement) => void;
+/**
+ * Modern drawer animation with smooth sliding and subtle fade
+ *
+ * Features:
+ * - Smooth directional slide from edge
+ * - Subtle opacity fade (0.3 → 1) for depth
+ * - Optimized easing curves for natural feel
+ * - Optional spring physics
+ * - Proper inert handling during animation
+ * - Reads 'side' from Drawer.Root bond automatically
+ *
+ * Improvements over old version:
+ * - Added opacity fade for better visual hierarchy
+ * - Smoother easing curves (custom cubic-bezier)
+ * - Optional spring physics for bouncy feel
+ * - Better duration defaults (0.3s vs 0.5s)
+ * - Cleaner inert management
+ * - Auto-detects side from bond (no manual prop needed)
+ *
+ * @example
+ * ```svelte
+ * <Drawer.Root side="right">
+ *   <Drawer.Content animate={animateDrawerContent()}>
+ * </Drawer.Root>
+ *
+ * <Drawer.Root side="left">
+ *   <Drawer.Content animate={animateDrawerContent({ spring: true })}>
+ * </Drawer.Root>
+ * ```
+ */
+export declare function animateDrawerContent(params?: AnimateDrawerContentParams): (node: HTMLElement) => () => void;
 type AnimateDrawerRootParams = {
+    /** Animation duration in seconds (default: 0.3) */
     duration?: number;
+    /** Delay before animation starts in seconds (default: 0) */
     delay?: number;
-    ease?: Easing | Easing[];
+    /** Easing function (default: smooth in-out) */
+    ease?: EasingOption;
 };
+/**
+ * Backdrop/overlay fade animation for drawer
+ *
+ * Fades the backdrop in/out smoothly when drawer opens/closes
+ */
 export declare function animateDrawerRoot(params?: AnimateDrawerRootParams): (node: HTMLElement) => void;
 export {};

package/dist/components/drawer/motion.js

@@ -1,25 +1,143 @@
-import { animate } from 'motion';
+import { animate, spring } from 'motion';
 import { DURATION } from '../../shared';
 import { DrawerBond } from '.';
-export function animateDrawerContent(params) {
-    const { duration = DURATION.fast / 1000, delay = 0, ease = 'easeInOut', side = 'left' } = params;
-    const bond = DrawerBond.get();
-    const mainProp = side === 'left' || side === 'right' ? 'x' : 'y';
-    const crossProp = mainProp === 'x' ? 'y' : 'x';
-    const d = side === 'left' || side === 'top' ? -1 : 1;
+import { untrack } from 'svelte';
+/**
+ * Modern drawer animation with smooth sliding and subtle fade
+ *
+ * Features:
+ * - Smooth directional slide from edge
+ * - Subtle opacity fade (0.3 → 1) for depth
+ * - Optimized easing curves for natural feel
+ * - Optional spring physics
+ * - Proper inert handling during animation
+ * - Reads 'side' from Drawer.Root bond automatically
+ *
+ * Improvements over old version:
+ * - Added opacity fade for better visual hierarchy
+ * - Smoother easing curves (custom cubic-bezier)
+ * - Optional spring physics for bouncy feel
+ * - Better duration defaults (0.3s vs 0.5s)
+ * - Cleaner inert management
+ * - Auto-detects side from bond (no manual prop needed)
+ *
+ * @example
+ * ```svelte
+ * <Drawer.Root side="right">
+ *   <Drawer.Content animate={animateDrawerContent()}>
+ * </Drawer.Root>
+ *
+ * <Drawer.Root side="left">
+ *   <Drawer.Content animate={animateDrawerContent({ spring: true })}>
+ * </Drawer.Root>
+ * ```
+ */
+export function animateDrawerContent(params = {}) {
+    const { duration = 0.3, delay = 0, ease, easeOpen = [0.16, 1, 0.3, 1], // Smooth deceleration (similar to popover)
+    easeClose = [0.4, 0, 0.6, 1], // Quick acceleration out
+    spring: useSpring = false, stiffness = 280, damping = 28, inert = true } = params;
+    const bond = untrack(() => DrawerBond.get());
+    // Read side from bond (set in Drawer.Root)
+    const side = bond?.state.props.side ?? 'right';
+    const position = getSidePosition(side);
+    const hidden = getHiddenTransform(side);
+    let animated = false;
     return (node) => {
         const isOpen = bond?.state.props.open ?? false;
-        animate(node, {
-            [mainProp]: isOpen ? 0 : d * 100 + '%',
-            [crossProp]: 0,
-            left: 'unset',
-            right: 'unset',
-            [side]: 0
-        }, { duration, ease, delay });
+        // Apply initial hidden state immediately (before any animation)
+        // This prevents FOUC (flash of unstyled content)
+        if (!animated) {
+            node.style.transform = `translate(${hidden.x}, ${hidden.y})`;
+            node.style.opacity = '0.3';
+            Object.assign(node.style, position);
+        }
+        // Disable interactions during animation
+        if (inert) {
+            node.style.pointerEvents = 'none';
+        }
+        let controller;
+        // Initial mount (closed state)
+        if (!animated && !isOpen) {
+            controller = animate(node, {
+                x: hidden.x,
+                y: hidden.y,
+                opacity: 0.3,
+                ...position
+            }, {
+                duration: 0,
+                onComplete: () => {
+                    if (inert)
+                        node.style.pointerEvents = 'auto';
+                }
+            });
+            animated = true;
+        }
+        else {
+            // Animated open/close transition
+            const resolvedEase = ease ?? (isOpen ? easeOpen : easeClose);
+            const keyframes = {
+                x: isOpen ? '0%' : hidden.x,
+                y: isOpen ? '0%' : hidden.y,
+                opacity: isOpen ? 1 : 0.3,
+                ...position
+            };
+            const animationOptions = useSpring
+                ? { easing: spring({ stiffness, damping }), delay }
+                : { duration, ease: resolvedEase, delay };
+            controller = animate(node, keyframes, {
+                ...animationOptions,
+                onComplete: () => {
+                    if (inert) {
+                        node.style.pointerEvents = isOpen ? 'auto' : 'none';
+                    }
+                }
+            });
+        }
+        return () => {
+            controller?.stop();
+            if (inert)
+                node.style.pointerEvents = 'auto';
+        };
     };
 }
+/**
+ * Returns the hidden (offscreen) translate values for each side.
+ * The panel slides in from its edge — e.g. left panel starts at -100% x.
+ */
+function getHiddenTransform(side) {
+    switch (side) {
+        case 'left':
+            return { x: '-100%', y: '0%' };
+        case 'right':
+            return { x: '100%', y: '0%' };
+        case 'top':
+            return { x: '0%', y: '-100%' };
+        case 'bottom':
+            return { x: '0%', y: '100%' };
+    }
+}
+/**
+ * Returns the CSS positioning properties to anchor the panel to its side.
+ */
+function getSidePosition(side) {
+    switch (side) {
+        case 'left':
+            return { top: '0', bottom: '0', left: '0', right: 'unset' };
+        case 'right':
+            return { top: '0', bottom: '0', right: '0', left: 'unset' };
+        case 'top':
+            return { top: '0', left: '0', right: '0', bottom: 'unset' };
+        case 'bottom':
+            return { bottom: '0', left: '0', right: '0', top: 'unset' };
+    }
+}
+/**
+ * Backdrop/overlay fade animation for drawer
+ *
+ * Fades the backdrop in/out smoothly when drawer opens/closes
+ */
 export function animateDrawerRoot(params = {}) {
-    const { duration = DURATION.fast / 1000, delay = 0, ease = 'easeInOut' } = params;
+    const { duration = 0.3, delay = 0, ease = [0.16, 1, 0.3, 1] } = params;
     return (node) => {
         const bond = DrawerBond.get();
         const isOpen = bond?.state.props.open ?? false;

package/dist/components/drawer/types.d.ts

@@ -1,5 +1,5 @@
 import type { Snippet } from 'svelte';
-import type { HtmlAtomProps, Base } from '../atom';
+import type { HtmlAtomProps, Base, SnippetProps } from '../atom';
 import type { Override, Factory } from '../../types';
 import type { TransitionFunction } from '../element';
 import type { PortalBond } from '../portal';
@@ -44,43 +44,34 @@ export interface DrawerDescriptionExtendProps {
  */
 export interface DrawerBackdropExtendProps {
 }
-export interface SlideoverRootProps<E extends keyof HTMLElementTagNameMap, B extends Base = Base> extends Override<HtmlAtomProps<E, B>, {
-    children?: Snippet<[{
-        drawer: DrawerBond;
-    }]>;
+export interface DrawerSnippetProps extends SnippetProps {
+    drawer: DrawerBond;
+}
+export type DrawerChildren = Snippet<[DrawerSnippetProps]>;
+export interface SlideoverRootProps<E extends keyof HTMLElementTagNameMap, B extends Base = Base> extends Override<HtmlAtomProps<E, B, DrawerChildren>, {
     initial?: (node: HTMLElement, bond: DrawerBond) => void;
     enter?: (node: HTMLElement, bond: DrawerBond) => TransitionFunction<'dialog'>;
     exit?: (node: HTMLElement, bond: DrawerBond) => TransitionFunction<'dialog'>;
 }>, DrawerExtendProps {
+    "z-index"?: number;
     open?: boolean;
     disabled?: boolean;
+    side?: 'left' | 'right' | 'top' | 'bottom';
     portal?: string | PortalBond;
     onclose?: (event: Event, bond: DrawerBond) => void;
     factory?: Factory<DrawerBond>;
 }
-export interface SlideoverContentProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B>, DrawerContentExtendProps {
+export interface SlideoverContentProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B, DrawerChildren> {
 }
-export interface SlideoverHeaderProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends Override<HtmlAtomProps<E, B>, {
-    children?: Snippet<[{
-        drawer?: DrawerBond;
-    }]>;
-}>, DrawerHeaderExtendProps {
+export interface SlideoverHeaderProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B, DrawerChildren> {
 }
-export interface DrawerBodyProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends Override<HtmlAtomProps<E, B>, {
-    children?: Snippet<[{
-        drawer?: DrawerBond;
-    }]>;
-}>, DrawerBodyExtendProps {
+export interface DrawerBodyProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B, DrawerChildren> {
 }
-export interface SlideoverFooterProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends Override<HtmlAtomProps<E, B>, {
-    children?: Snippet<[{
-        drawer?: DrawerBond;
-    }]>;
-}>, DrawerFooterExtendProps {
+export interface SlideoverFooterProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B, DrawerChildren> {
 }
-export interface SlideoverTitleProps<E extends keyof HTMLElementTagNameMap = 'h2', B extends Base = Base> extends HtmlAtomProps<E, B>, DrawerTitleExtendProps {
+export interface SlideoverTitleProps<E extends keyof HTMLElementTagNameMap = 'h2', B extends Base = Base> extends HtmlAtomProps<E, B, DrawerChildren> {
 }
-export interface SlideoverDescriptionProps<E extends keyof HTMLElementTagNameMap = 'p', B extends Base = Base> extends HtmlAtomProps<E, B>, DrawerDescriptionExtendProps {
+export interface SlideoverDescriptionProps<E extends keyof HTMLElementTagNameMap = 'p', B extends Base = Base> extends HtmlAtomProps<E, B, DrawerChildren> {
 }
-export interface SlideoverBackdropProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B>, DrawerBackdropExtendProps {
+export interface SlideoverBackdropProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B, DrawerChildren> {
 }

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

@@ -1,8 +1,4 @@
-export { default as Root } from './dropdown-root.svelte';
-export { default as Item } from './item/dropdown-item.svelte';
-export { default as Trigger } from './dropdown-trigger.svelte';
-export { default as Placeholder } from './dropdown-placeholder.svelte';
-export { default as Selection } from './dropdown-selection.svelte';
-export { default as Selections } from './dropdown-selections.svelte';
-export { Arrow, Indicator } from '../popover/atoms';
-export { Content, List, Divider, Title, Group } from '../menu/atoms';
+/**
+ * @deprecated Import from `select` instead. This module will be removed in a future version.
+ */
+export * from '../select/atoms';

package/dist/components/dropdown/atoms.js

@@ -1,9 +1,4 @@
-export { default as Root } from './dropdown-root.svelte';
-export { default as Item } from './item/dropdown-item.svelte';
-export { default as Trigger } from './dropdown-trigger.svelte';
-export { default as Placeholder } from './dropdown-placeholder.svelte';
-// export { default as Query } from './dropdown-query.svelte';
-export { default as Selection } from './dropdown-selection.svelte';
-export { default as Selections } from './dropdown-selections.svelte';
-export { Arrow, Indicator } from '../popover/atoms';
-export { Content, List, Divider, Title, Group } from '../menu/atoms';
+/**
+ * @deprecated Import from `select` instead. This module will be removed in a future version.
+ */
+export * from '../select/atoms';

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

@@ -1,53 +1,4 @@
-import { MenuBond, MenuBondState, type MenuBondElements, type MenuBondProps } from '../menu/bond.svelte';
-import type { DropdownItemController } from './item/controller.svelte';
-export type DropdownStateProps = MenuBondProps & {
-    values?: string[];
-    value?: string;
-    labels?: string[];
-    label?: string;
-    multiple?: boolean;
-    keys?: string[];
-    readonly rest?: Record<string, unknown>;
-};
-export type DropdownBondElements = MenuBondElements & {
-    placeholder?: HTMLElement;
-};
-export declare class DropdownBond<Props extends DropdownStateProps = DropdownStateProps, State extends DropdownBondState<Props> = DropdownBondState<Props>, Elements extends DropdownBondElements = DropdownBondElements> extends MenuBond<Props, State, Elements> {
-    constructor(state: State);
-    content(): {
-        role: string;
-        'aria-multiselectable': boolean;
-        '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;
-    };
-    item(): {
-        role: string;
-        onkeyup: (ev: KeyboardEvent) => void;
-    };
-    placeholder(): {
-        [x: symbol]: (node: HTMLElement) => void;
-        id: string;
-        role: string;
-        'data-atom': string;
-        'data-kind': string;
-    };
-    static get<Props extends DropdownStateProps = DropdownStateProps, State extends DropdownBondState<Props> = DropdownBondState<Props>, Elements extends DropdownBondElements = DropdownBondElements>(): DropdownBond<Props, State, Elements> | undefined;
-    static set<Props extends DropdownStateProps = DropdownStateProps, State extends DropdownBondState<Props> = DropdownBondState<Props>, Elements extends DropdownBondElements = DropdownBondElements>(context: DropdownBond<Props, State, Elements>): DropdownBond<Props, State, Elements>;
-}
-export declare class DropdownBondState<Props extends DropdownStateProps = DropdownStateProps> extends MenuBondState<Props> {
-    #private;
-    constructor(props: () => Props);
-    get selections(): DropdownItemController<unknown>[];
-    select(ids: string[]): void;
-    unselect(ids: string[]): void;
-    protected updateLabels(): void;
-}
+/**
+ * @deprecated Import from `select/bond.svelte` instead. This module will be removed in a future version.
+ */
+export { SelectBond as DropdownBond, SelectBondState as DropdownBondState, type SelectBondElements as DropdownBondElements, type SelectStateProps as DropdownStateProps } from '../select/bond.svelte';

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

@@ -1,89 +1,4 @@
-import { untrack } from 'svelte';
-import { createAttachmentKey } from 'svelte/attachments';
-import { MenuBond, MenuBondState } from '../menu/bond.svelte';
-const DROPDOWN_ELEMENTS_KIND = {
-    placeholder: 'dropdown-placeholder',
-    arrow: 'popover-arrow',
-    trigger: 'popover-trigger',
-    content: 'popover-content',
-    indicator: 'popover-indicator'
-};
-export class DropdownBond extends MenuBond {
-    constructor(state) {
-        super(state);
-    }
-    content() {
-        const isMultiselect = this.state.props.multiple ?? false;
-        const highlightedId = this.state.highlightedItem?.id;
-        return {
-            ...super.content(),
-            role: 'listbox',
-            'aria-multiselectable': isMultiselect,
-            'aria-activedescendant': highlightedId ? `item-${highlightedId}` : undefined,
-            'aria-orientation': 'vertical'
-        };
-    }
-    item() {
-        return {
-            ...super.item(),
-            role: 'option'
-        };
-    }
-    placeholder() {
-        const id = [DROPDOWN_ELEMENTS_KIND.placeholder, this.id].join('-');
-        return {
-            id,
-            role: 'group',
-            'data-atom': 'dropdown',
-            'data-kind': 'placeholder',
-            [createAttachmentKey()]: (node) => {
-                this.elements.placeholder = node;
-            }
-        };
-    }
-    // static get = getDropdownContext;
-    // static set = setDropdownContext;
-    static get() {
-        return MenuBond.get();
-    }
-    static set(context) {
-        return MenuBond.set(context);
-    }
-}
-export class DropdownBondState extends MenuBondState {
-    #selections = $derived(this.props.values
-        ?.map((value) => this.items.get(value))
-        .filter(Boolean) ?? []);
-    constructor(props) {
-        super(props);
-    }
-    get selections() {
-        return this.#selections;
-    }
-    select(ids) {
-        if (untrack(() => this.props.multiple)) {
-            // eslint-disable-next-line svelte/prefer-svelte-reactivity
-            const sequence = new Set(untrack(() => [...ids, ...(this.props.values ?? [])]));
-            this.props.values = [...sequence];
-        }
-        else {
-            const value = ids[0];
-            this.props.values = value ? [value] : [];
-        }
-        this.updateLabels();
-    }
-    unselect(ids) {
-        // eslint-disable-next-line svelte/prefer-svelte-reactivity
-        const sequence = new Set(untrack(() => this.props.values ?? []));
-        for (const v of ids) {
-            sequence.delete(v);
-        }
-        this.props.values = [...sequence];
-        this.updateLabels();
-    }
-    updateLabels() {
-        const labels = this.#selections.map((s) => s.label);
-        this.props.labels = labels;
-        this.props.label = labels[0] ?? '';
-    }
-}
+/**
+ * @deprecated Import from `select/bond.svelte` instead. This module will be removed in a future version.
+ */
+export { SelectBond as DropdownBond, SelectBondState as DropdownBondState } from '../select/bond.svelte';

package/dist/components/dropdown/dropdown-query.svelte

@@ -1,43 +1,43 @@
-<script lang="ts">
-	import { DropdownBond } from './bond.svelte';
-	import { Input } from '../input';
-	import type { DropdownQueryProps } from './types';
-
-	const bond = DropdownBond.get() as DropdownBond;
-
-	if (!bond) {
-		throw new Error('Dropdown atom was not found');
-	}
-
-	let {
-		value = $bindable(),
-		class: klass = '',
-		children = undefined,
-		onmount = undefined,
-		ondestroy = undefined,
-		animate = undefined,
-		enter = undefined,
-		exit = undefined,
-		initial = undefined,
-		...restProps
-	}: DropdownQueryProps = $props();
-</script>
-
-<Input.Control
-	bind:value={
-		() => value,
-		(v) => {
-			value = v;
-		}
-	}
-	{bond}
-	preset="dropdown.query"
-	class={['inline-flex h-auto w-auto flex-1 py-1', '$preset', klass]}
-	onmount={onmount?.bind(bond.state)}
-	ondestroy={ondestroy?.bind(bond.state)}
-	enter={enter?.bind(bond.state)}
-	exit={exit?.bind(bond.state)}
-	initial={initial?.bind(bond.state)}
-	animate={animate?.bind(bond.state)}
-	{...restProps}
-/>
+<script lang="ts">
+	import { DropdownBond } from './bond.svelte';
+	import { Input } from '../input';
+	import type { DropdownQueryProps } from './types';
+
+	const bond = DropdownBond.get() as DropdownBond;
+
+	if (!bond) {
+		throw new Error('Dropdown atom was not found');
+	}
+
+	let {
+		value = $bindable(),
+		class: klass = '',
+		children = undefined,
+		onmount = undefined,
+		ondestroy = undefined,
+		animate = undefined,
+		enter = undefined,
+		exit = undefined,
+		initial = undefined,
+		...restProps
+	}: DropdownQueryProps = $props();
+</script>
+
+<Input.Control
+	bind:value={
+		() => value,
+		(v) => {
+			value = v;
+		}
+	}
+	{bond}
+	preset="dropdown.query"
+	class={['inline-flex h-auto w-auto flex-1 py-1', '$preset', klass]}
+	onmount={onmount?.bind(bond.state)}
+	ondestroy={ondestroy?.bind(bond.state)}
+	enter={enter?.bind(bond.state)}
+	exit={exit?.bind(bond.state)}
+	initial={initial?.bind(bond.state)}
+	animate={animate?.bind(bond.state)}
+	{...restProps}
+/>