@destyler/popover 0.0.5 → 0.0.7-beta.1

package/dist/index.d.mts

@@ -1,5 +1,152 @@
-export { a as PopoverArrow, b as PopoverArrowProps, c as PopoverClose, e as PopoverCloseProps, f as PopoverContent, i as PopoverContentProps, j as PopoverPortal, l as PopoverPortalProps, m as PopoverRoot, q as PopoverRootProps, r as PopoverTrigger, t as PopoverTriggerProps, p as popoverArrowProps, d as popoverCloseProps, g as popoverContentProps, k as popoverPortalProps, n as popoverRootProps, s as popoverTriggerProps } from './shared/popover.2b6be8bf.mjs';
-import '@destyler/primitive';
-import 'vue';
-import '@destyler/shared';
-import '@vue/shared';
+import * as _zag_js_anatomy from '@zag-js/anatomy';
+import { RequiredBy, PropTypes, CommonProperties, DirectionProperty, NormalizeProps } from '@zag-js/types';
+import * as _zag_js_core from '@zag-js/core';
+import { Machine, StateMachine } from '@zag-js/core';
+import { DismissableElementHandlers, PersistentElementOptions } from '@zag-js/dismissable';
+export { FocusOutsideEvent, InteractOutsideEvent, PointerDownOutsideEvent } from '@zag-js/dismissable';
+import { PositioningOptions, Placement } from '@zag-js/popper';
+export { Placement, PositioningOptions } from '@zag-js/popper';
+
+declare const anatomy: _zag_js_anatomy.AnatomyInstance<"arrow" | "arrowTip" | "anchor" | "trigger" | "indicator" | "positioner" | "content" | "title" | "description" | "closeTrigger">;
+
+interface OpenChangeDetails {
+    open: boolean;
+}
+type ElementIds = Partial<{
+    anchor: string;
+    trigger: string;
+    content: string;
+    title: string;
+    description: string;
+    closeTrigger: string;
+    positioner: string;
+    arrow: string;
+}>;
+interface PublicContext extends CommonProperties, DirectionProperty, DismissableElementHandlers, PersistentElementOptions {
+    /**
+     * The ids of the elements in the popover. Useful for composition.
+     */
+    'ids'?: ElementIds | undefined;
+    /**
+     * Whether the popover should be modal. When set to `true`:
+     * - interaction with outside elements will be disabled
+     * - only popover content will be visible to screen readers
+     * - scrolling is blocked
+     * - focus is trapped within the popover
+     *
+     * @default false
+     */
+    'modal'?: boolean | undefined;
+    /**
+     * Whether the popover is portalled. This will proxy the tabbing behavior regardless of the DOM position
+     * of the popover content.
+     *
+     * @default true
+     */
+    'portalled'?: boolean | undefined;
+    /**
+     * Whether to automatically set focus on the first focusable
+     * content within the popover when opened.
+     *
+     * @default true
+     */
+    'autoFocus'?: boolean | undefined;
+    /**
+     * The element to focus on when the popover is opened.
+     */
+    'initialFocusEl'?: (() => HTMLElement | null) | undefined;
+    /**
+     * Whether to close the popover when the user clicks outside of the popover.
+     * @default true
+     */
+    'closeOnInteractOutside'?: boolean | undefined;
+    /**
+     * Whether to close the popover when the escape key is pressed.
+     * @default true
+     */
+    'closeOnEscape'?: boolean | undefined;
+    /**
+     * Function invoked when the popover opens or closes
+     */
+    'onOpenChange'?: ((details: OpenChangeDetails) => void) | undefined;
+    /**
+     * The user provided options used to position the popover content
+     */
+    'positioning': PositioningOptions;
+    /**
+     * Whether the popover is open
+     */
+    'open'?: boolean | undefined;
+    /**
+     * Whether the popover is controlled by the user
+     */
+    'open.controlled'?: boolean | undefined;
+}
+type UserDefinedContext = RequiredBy<PublicContext, 'id'>;
+type ComputedContext = Readonly<{
+    /**
+     * @computed
+     * The computed value of `portalled`
+     */
+    currentPortalled: boolean;
+}>;
+interface PrivateContext {
+    /**
+     * @internal
+     * The elements that are rendered on mount
+     */
+    renderedElements: {
+        title: boolean;
+        description: boolean;
+    };
+    /**
+     * @internal
+     * The computed placement (maybe different from initial placement)
+     */
+    currentPlacement?: Placement | undefined;
+}
+interface MachineContext extends PublicContext, ComputedContext, PrivateContext {
+}
+interface MachineState {
+    value: 'open' | 'closed';
+}
+type State = StateMachine.State<MachineContext, MachineState>;
+type Send = StateMachine.Send<StateMachine.AnyEventObject>;
+type Service = Machine<MachineContext, MachineState, StateMachine.AnyEventObject>;
+interface MachineApi<T extends PropTypes = PropTypes> {
+    /**
+     * Whether the popover is portalled.
+     */
+    portalled: boolean;
+    /**
+     * Whether the popover is open
+     */
+    open: boolean;
+    /**
+     * Function to open or close the popover
+     */
+    setOpen: (open: boolean) => void;
+    /**
+     * Function to reposition the popover
+     */
+    reposition: (options?: Partial<PositioningOptions>) => void;
+    getArrowProps: () => T['element'];
+    getArrowTipProps: () => T['element'];
+    getAnchorProps: () => T['element'];
+    getTriggerProps: () => T['button'];
+    getIndicatorProps: () => T['element'];
+    getPositionerProps: () => T['element'];
+    getContentProps: () => T['element'];
+    getTitleProps: () => T['element'];
+    getDescriptionProps: () => T['element'];
+    getCloseTriggerProps: () => T['button'];
+}
+
+declare function connect<T extends PropTypes>(state: State, send: Send, normalize: NormalizeProps<T>): MachineApi<T>;
+
+declare function machine(userContext: UserDefinedContext): _zag_js_core.Machine<MachineContext, MachineState, _zag_js_core.StateMachine.AnyEventObject>;
+
+declare const props: ("ids" | "modal" | "portalled" | "autoFocus" | "initialFocusEl" | "closeOnInteractOutside" | "closeOnEscape" | "onOpenChange" | "positioning" | "open" | "open.controlled" | "id" | "getRootNode" | "dir" | "onEscapeKeyDown" | "onPointerDownOutside" | "onFocusOutside" | "onInteractOutside" | "persistentElements")[];
+declare const splitProps: <Props extends Partial<UserDefinedContext>>(props: Props) => [Partial<UserDefinedContext>, Omit<Props, "ids" | "modal" | "portalled" | "autoFocus" | "initialFocusEl" | "closeOnInteractOutside" | "closeOnEscape" | "onOpenChange" | "positioning" | "open" | "open.controlled" | "id" | "getRootNode" | "dir" | "onEscapeKeyDown" | "onPointerDownOutside" | "onFocusOutside" | "onInteractOutside" | "persistentElements">];
+
+export { type MachineApi as Api, type UserDefinedContext as Context, type ElementIds, type OpenChangeDetails, type Service, anatomy, connect, machine, props, splitProps };

package/dist/index.d.ts

@@ -1,5 +1,152 @@
-export { a as PopoverArrow, b as PopoverArrowProps, c as PopoverClose, e as PopoverCloseProps, f as PopoverContent, i as PopoverContentProps, j as PopoverPortal, l as PopoverPortalProps, m as PopoverRoot, q as PopoverRootProps, r as PopoverTrigger, t as PopoverTriggerProps, p as popoverArrowProps, d as popoverCloseProps, g as popoverContentProps, k as popoverPortalProps, n as popoverRootProps, s as popoverTriggerProps } from './shared/popover.2b6be8bf.js';
-import '@destyler/primitive';
-import 'vue';
-import '@destyler/shared';
-import '@vue/shared';
+import * as _zag_js_anatomy from '@zag-js/anatomy';
+import { RequiredBy, PropTypes, CommonProperties, DirectionProperty, NormalizeProps } from '@zag-js/types';
+import * as _zag_js_core from '@zag-js/core';
+import { Machine, StateMachine } from '@zag-js/core';
+import { DismissableElementHandlers, PersistentElementOptions } from '@zag-js/dismissable';
+export { FocusOutsideEvent, InteractOutsideEvent, PointerDownOutsideEvent } from '@zag-js/dismissable';
+import { PositioningOptions, Placement } from '@zag-js/popper';
+export { Placement, PositioningOptions } from '@zag-js/popper';
+
+declare const anatomy: _zag_js_anatomy.AnatomyInstance<"arrow" | "arrowTip" | "anchor" | "trigger" | "indicator" | "positioner" | "content" | "title" | "description" | "closeTrigger">;
+
+interface OpenChangeDetails {
+    open: boolean;
+}
+type ElementIds = Partial<{
+    anchor: string;
+    trigger: string;
+    content: string;
+    title: string;
+    description: string;
+    closeTrigger: string;
+    positioner: string;
+    arrow: string;
+}>;
+interface PublicContext extends CommonProperties, DirectionProperty, DismissableElementHandlers, PersistentElementOptions {
+    /**
+     * The ids of the elements in the popover. Useful for composition.
+     */
+    'ids'?: ElementIds | undefined;
+    /**
+     * Whether the popover should be modal. When set to `true`:
+     * - interaction with outside elements will be disabled
+     * - only popover content will be visible to screen readers
+     * - scrolling is blocked
+     * - focus is trapped within the popover
+     *
+     * @default false
+     */
+    'modal'?: boolean | undefined;
+    /**
+     * Whether the popover is portalled. This will proxy the tabbing behavior regardless of the DOM position
+     * of the popover content.
+     *
+     * @default true
+     */
+    'portalled'?: boolean | undefined;
+    /**
+     * Whether to automatically set focus on the first focusable
+     * content within the popover when opened.
+     *
+     * @default true
+     */
+    'autoFocus'?: boolean | undefined;
+    /**
+     * The element to focus on when the popover is opened.
+     */
+    'initialFocusEl'?: (() => HTMLElement | null) | undefined;
+    /**
+     * Whether to close the popover when the user clicks outside of the popover.
+     * @default true
+     */
+    'closeOnInteractOutside'?: boolean | undefined;
+    /**
+     * Whether to close the popover when the escape key is pressed.
+     * @default true
+     */
+    'closeOnEscape'?: boolean | undefined;
+    /**
+     * Function invoked when the popover opens or closes
+     */
+    'onOpenChange'?: ((details: OpenChangeDetails) => void) | undefined;
+    /**
+     * The user provided options used to position the popover content
+     */
+    'positioning': PositioningOptions;
+    /**
+     * Whether the popover is open
+     */
+    'open'?: boolean | undefined;
+    /**
+     * Whether the popover is controlled by the user
+     */
+    'open.controlled'?: boolean | undefined;
+}
+type UserDefinedContext = RequiredBy<PublicContext, 'id'>;
+type ComputedContext = Readonly<{
+    /**
+     * @computed
+     * The computed value of `portalled`
+     */
+    currentPortalled: boolean;
+}>;
+interface PrivateContext {
+    /**
+     * @internal
+     * The elements that are rendered on mount
+     */
+    renderedElements: {
+        title: boolean;
+        description: boolean;
+    };
+    /**
+     * @internal
+     * The computed placement (maybe different from initial placement)
+     */
+    currentPlacement?: Placement | undefined;
+}
+interface MachineContext extends PublicContext, ComputedContext, PrivateContext {
+}
+interface MachineState {
+    value: 'open' | 'closed';
+}
+type State = StateMachine.State<MachineContext, MachineState>;
+type Send = StateMachine.Send<StateMachine.AnyEventObject>;
+type Service = Machine<MachineContext, MachineState, StateMachine.AnyEventObject>;
+interface MachineApi<T extends PropTypes = PropTypes> {
+    /**
+     * Whether the popover is portalled.
+     */
+    portalled: boolean;
+    /**
+     * Whether the popover is open
+     */
+    open: boolean;
+    /**
+     * Function to open or close the popover
+     */
+    setOpen: (open: boolean) => void;
+    /**
+     * Function to reposition the popover
+     */
+    reposition: (options?: Partial<PositioningOptions>) => void;
+    getArrowProps: () => T['element'];
+    getArrowTipProps: () => T['element'];
+    getAnchorProps: () => T['element'];
+    getTriggerProps: () => T['button'];
+    getIndicatorProps: () => T['element'];
+    getPositionerProps: () => T['element'];
+    getContentProps: () => T['element'];
+    getTitleProps: () => T['element'];
+    getDescriptionProps: () => T['element'];
+    getCloseTriggerProps: () => T['button'];
+}
+
+declare function connect<T extends PropTypes>(state: State, send: Send, normalize: NormalizeProps<T>): MachineApi<T>;
+
+declare function machine(userContext: UserDefinedContext): _zag_js_core.Machine<MachineContext, MachineState, _zag_js_core.StateMachine.AnyEventObject>;
+
+declare const props: ("ids" | "modal" | "portalled" | "autoFocus" | "initialFocusEl" | "closeOnInteractOutside" | "closeOnEscape" | "onOpenChange" | "positioning" | "open" | "open.controlled" | "id" | "getRootNode" | "dir" | "onEscapeKeyDown" | "onPointerDownOutside" | "onFocusOutside" | "onInteractOutside" | "persistentElements")[];
+declare const splitProps: <Props extends Partial<UserDefinedContext>>(props: Props) => [Partial<UserDefinedContext>, Omit<Props, "ids" | "modal" | "portalled" | "autoFocus" | "initialFocusEl" | "closeOnInteractOutside" | "closeOnEscape" | "onOpenChange" | "positioning" | "open" | "open.controlled" | "id" | "getRootNode" | "dir" | "onEscapeKeyDown" | "onPointerDownOutside" | "onFocusOutside" | "onInteractOutside" | "persistentElements">];
+
+export { type MachineApi as Api, type UserDefinedContext as Context, type ElementIds, type OpenChangeDetails, type Service, anatomy, connect, machine, props, splitProps };