hys-ui 0.2.0 → 0.4.0

package/dist/types/composables/mention.d.ts

@@ -0,0 +1,284 @@
+import type { StyleValue, VNodeChild } from "vue";
+import type { Placement } from "./useFloating";
+import type { HysPopupMotionProps } from "../motion/popup";
+export interface HysMentionUser {
+    id: string;
+    name: string;
+    disabled?: boolean;
+}
+export interface HysMentionOption {
+    id?: string | number;
+    value: string | number;
+    label?: string | ((option: HysMentionOption) => VNodeChild);
+    disabled?: boolean;
+    prefix?: string;
+    type?: string;
+    avatar?: string;
+    description?: string;
+    group?: string;
+    keywords?: readonly string[];
+    recommended?: boolean;
+    class?: string;
+    style?: StyleValue;
+    payload?: unknown;
+}
+export interface HysMentionContext {
+    prefix: string;
+    query: string;
+    start: number;
+    end: number;
+    manual?: boolean;
+}
+export interface HysMentionFieldNames {
+    value?: string;
+    label?: string;
+    disabled?: string;
+    id?: string;
+    group?: string;
+    avatar?: string;
+    description?: string;
+    type?: string;
+}
+export type HysMentionDataOption = HysMentionOption | Record<string, unknown>;
+export interface HysMentionLoadContext extends HysMentionContext {
+    signal: AbortSignal;
+    text: string;
+    page: number;
+    pageSize: number;
+    cursor?: string | number;
+}
+export interface HysMentionPage {
+    items: readonly HysMentionDataOption[];
+    hasMore?: boolean;
+    nextCursor?: string | number | null;
+    total?: number;
+}
+export type HysMentionLoader = (context: HysMentionLoadContext) => readonly HysMentionDataOption[] | HysMentionPage | Promise<readonly HysMentionDataOption[] | HysMentionPage>;
+export type HysMentionFilter = boolean | ((query: string, option: HysMentionOption, prefix: string) => boolean);
+export type HysMentionSearchField = string | ((option: HysMentionOption) => unknown);
+export type HysMentionSearchMode = "includes" | "fuzzy" | "pinyin" | "initials";
+export type HysMentionMatch = (context: {
+    text: string;
+    caret: number;
+    prefix: string;
+}) => {
+    start: number;
+    query: string;
+} | null | undefined;
+export interface HysMentionTrigger {
+    prefix: string;
+    minQueryLength?: number;
+    boundary?: "any" | "word" | ((text: string, index: number) => boolean);
+    allowSpaces?: boolean;
+    match?: HysMentionMatch;
+    split?: string;
+    type?: string;
+    options?: readonly HysMentionDataOption[];
+    loadOptions?: HysMentionLoader;
+    filterOption?: HysMentionFilter;
+    searchMode?: HysMentionSearchMode | readonly HysMentionSearchMode[];
+    formatMention?: HysMentionProps["formatMention"];
+    allowCreate?: boolean;
+}
+export interface HysMentionSource {
+    key: string;
+    prefixes?: readonly string[];
+    group?: string;
+    options?: readonly HysMentionDataOption[];
+    loadOptions?: HysMentionLoader;
+    fieldNames?: HysMentionFieldNames;
+}
+export interface HysMentionEntity {
+    id: string | number;
+    value: string | number;
+    label: string;
+    type: string;
+    prefix: string;
+    text: string;
+    start: number;
+    end: number;
+    payload?: unknown;
+}
+export interface HysMentionDocument {
+    text: string;
+    entities: HysMentionEntity[];
+}
+export interface HysMentionOpenOptions {
+    prefix?: string;
+    query?: string;
+    position?: number;
+}
+export interface HysMentionInsertOptions {
+    prefix?: string;
+    start?: number;
+    end?: number;
+    focus?: boolean;
+}
+export interface HysMentionAutosize {
+    minRows?: number;
+    maxRows?: number;
+}
+export interface HysMentionLocale {
+    input: string;
+    list: string;
+    placeholder: string;
+    loading: string;
+    empty: string;
+    error: string;
+    retry: string;
+    more: string;
+    recent: string;
+    recommended: string;
+    clear: string;
+    create: string;
+}
+export interface HysMentionSlots {
+    prefix?: () => VNodeChild;
+    suffix?: () => VNodeChild;
+    "clear-icon"?: () => VNodeChild;
+    count?: (props: {
+        count: number;
+        max?: number;
+    }) => VNodeChild;
+    option?: (props: {
+        user: HysMentionUser;
+        option: HysMentionOption;
+        context?: HysMentionContext;
+        created: boolean;
+    }) => VNodeChild;
+    avatar?: (props: {
+        option: HysMentionOption;
+    }) => VNodeChild;
+    group?: (props: {
+        label: string;
+        context?: HysMentionContext;
+    }) => VNodeChild;
+    header?: (props: {
+        context?: HysMentionContext;
+    }) => VNodeChild;
+    footer?: (props: {
+        context?: HysMentionContext;
+        hasMore: boolean;
+        loadMore: () => Promise<boolean>;
+    }) => VNodeChild;
+    loading?: () => VNodeChild;
+    empty?: () => VNodeChild;
+    error?: (props: {
+        error: unknown;
+        retry: () => void;
+        context?: HysMentionContext;
+    }) => VNodeChild;
+}
+export type HysMentionAction = "next" | "previous" | "first" | "last" | "select" | "close" | "open" | "retry";
+export interface HysMentionInstance {
+    readonly input: HTMLElement | undefined;
+    readonly dropdownVisible: boolean;
+    focus: () => void;
+    blur: () => void;
+    open: (options?: HysMentionOpenOptions) => boolean;
+    close: () => void;
+    update: () => void;
+    retry: () => void;
+    loadMore: () => Promise<boolean>;
+    insertMention: (option: HysMentionOption, options?: HysMentionInsertOptions) => Promise<boolean>;
+    removeMention: (target: HysMentionEntity | string | number) => Promise<boolean>;
+    getEntities: () => HysMentionEntity[];
+    getDocument: () => HysMentionDocument;
+    setDocument: (document: HysMentionDocument | string) => Promise<boolean>;
+    serialize: () => string;
+    clear: () => Promise<boolean>;
+    undo: () => Promise<boolean>;
+    redo: () => Promise<boolean>;
+}
+export interface HysMentionProps extends HysPopupMotionProps {
+    modelValue?: string;
+    users?: readonly HysMentionUser[];
+    /** 候选选项。提供时优先于 users。 */
+    options?: readonly HysMentionDataOption[];
+    fieldNames?: HysMentionFieldNames;
+    /** 输入触发词后按当前关键字加载候选。过期请求会被取消。 */
+    loadOptions?: HysMentionLoader;
+    sources?: readonly HysMentionSource[];
+    debounce?: number;
+    throttle?: number;
+    pageSize?: number;
+    cache?: boolean | {
+        ttl?: number;
+        maxEntries?: number;
+    };
+    historyKey?: string;
+    recentLimit?: number;
+    recommendations?: readonly HysMentionOption[];
+    recommendOnFocus?: boolean;
+    minQueryLength?: number;
+    defaultValue?: string;
+    /** 提及触发词，可传多个前缀。 */
+    prefix?: string | readonly string[];
+    triggers?: readonly HysMentionTrigger[];
+    boundary?: HysMentionTrigger["boundary"];
+    allowSpaces?: boolean;
+    matchTrigger?: HysMentionMatch;
+    /** 选择候选后插入的分隔符。 */
+    split?: string;
+    filterOption?: HysMentionFilter;
+    searchMode?: HysMentionTrigger["searchMode"];
+    searchFields?: readonly HysMentionSearchField[];
+    sortOptions?: boolean | ((a: HysMentionOption, b: HysMentionOption, context: HysMentionContext) => number);
+    groupBy?: (option: HysMentionOption, context: HysMentionContext) => string | undefined;
+    validateSearch?: (query: string, context: HysMentionContext) => boolean;
+    whole?: boolean;
+    checkIsWhole?: (value: string, prefix: string) => boolean;
+    validateEntity?: (entity: HysMentionEntity) => boolean;
+    invalidEntity?: "mark" | "text" | "remove";
+    canSelect?: (option: HysMentionOption, context: HysMentionContext) => boolean;
+    beforeRemove?: (entity: HysMentionEntity) => boolean;
+    parseEntities?: (text: string) => readonly HysMentionEntity[];
+    highlightMentions?: boolean;
+    entityClass?: string | ((entity: HysMentionEntity) => string);
+    allowCreate?: boolean;
+    createOption?: (context: HysMentionContext) => HysMentionOption | false;
+    /** 自定义写入的提及文本，包含所需前缀。组件会追加 split。 */
+    formatMention?: (option: HysMentionOption, context: HysMentionContext) => string;
+    /** 替换光标后的同一提及词尾。默认保留光标后的文本。 */
+    replaceRest?: boolean;
+    selectOnTab?: boolean;
+    highlightMatch?: boolean;
+    loading?: boolean;
+    notFoundText?: string;
+    errorText?: string;
+    maxOptions?: number;
+    placement?: Placement;
+    showArrow?: boolean;
+    offset?: number;
+    autoAdjustOverflow?: boolean;
+    popupWidth?: string | number;
+    popupMaxHeight?: string | number;
+    zIndex?: number;
+    virtual?: boolean;
+    itemHeight?: number;
+    overscan?: number;
+    appendTo?: string | HTMLElement | false;
+    popupClass?: string;
+    popupStyle?: StyleValue;
+    type?: "text" | "textarea" | "rich";
+    rows?: number;
+    name?: string;
+    autofocus?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    maxlength?: number;
+    minlength?: number;
+    required?: boolean;
+    clearable?: boolean;
+    showCount?: boolean;
+    autosize?: boolean | HysMentionAutosize;
+    restoreFocus?: boolean;
+    shortcuts?: Partial<Record<string, HysMentionAction>>;
+    locale?: Partial<HysMentionLocale>;
+    defaultEntities?: readonly HysMentionEntity[];
+    entities?: readonly HysMentionEntity[];
+    ariaLabel?: string;
+    status?: "error" | "warning";
+    size?: "sm" | "md" | "lg";
+}

package/dist/types/composables/mentionDocument.d.ts

@@ -0,0 +1,15 @@
+import type { HysMentionContext, HysMentionDocument, HysMentionEntity, HysMentionProps, HysMentionTrigger } from "./mention";
+export declare function mentionTriggers(props: HysMentionProps): HysMentionTrigger[];
+export declare function matchMention(text: string, caret: number, rules: readonly HysMentionTrigger[], defaults: Pick<HysMentionProps, "boundary" | "allowSpaces" | "matchTrigger" | "split">): HysMentionContext | undefined;
+export declare function normalizeMentionEntities(text: string, input: readonly HysMentionEntity[]): HysMentionEntity[];
+export declare function serializeMentionDocument(document: HysMentionDocument): string;
+export declare function deserializeMentionDocument(source: string): HysMentionDocument;
+export declare function rebaseMentionEntities(before: HysMentionDocument, text: string, range?: {
+    start: number;
+    end: number;
+}): HysMentionEntity[];
+export declare function mentionSegments(text: string, entities: readonly HysMentionEntity[]): {
+    text: string;
+    start: number;
+    entity?: HysMentionEntity;
+}[];

package/dist/types/composables/mentionEditor.d.ts

@@ -0,0 +1,7 @@
+export interface MentionSelection {
+    start: number;
+    end: number;
+}
+export declare function isNativeMentionInput(element: HTMLElement): element is HTMLInputElement | HTMLTextAreaElement;
+export declare function readMentionSelection(element: HTMLElement, fallback: number): MentionSelection;
+export declare function writeMentionSelection(element: HTMLElement, selection: MentionSelection): void;

package/dist/types/composables/menu.d.ts

@@ -0,0 +1,183 @@
+import type { HysPopupMotionProps } from "../motion/popup";
+import { type Component, type CSSProperties, type VNodeChild } from "vue";
+import type { Placement } from "./useFloating";
+export type HysMenuKey = string | number;
+export type HysContextMenuTrigger = "contextmenu" | "click" | "hover" | "focus";
+export interface HysContextMenuItem {
+    label: string;
+    value?: HysMenuKey;
+    type?: "item" | "divider" | "group" | "checkbox" | "radio";
+    children?: readonly HysContextMenuItem[];
+    disabled?: boolean;
+    hidden?: boolean;
+    danger?: boolean;
+    icon?: Component;
+    description?: string;
+    shortcut?: string;
+    href?: string;
+    target?: string;
+    rel?: string;
+    checked?: boolean;
+    radioGroup?: HysMenuKey;
+    closeOnSelect?: boolean;
+}
+export interface HysMenuFieldNames {
+    value: string;
+    label: string;
+    children: string;
+    disabled: string;
+    hidden: string;
+    type: string;
+    icon: string;
+    description: string;
+    shortcut: string;
+    href: string;
+    target: string;
+    rel: string;
+    danger: string;
+    checked: string;
+    radioGroup: string;
+    closeOnSelect: string;
+}
+export interface HysMenuSelectInfo<N extends object = HysContextMenuItem> {
+    item: N;
+    path: readonly N[];
+    keys: readonly HysMenuKey[];
+    event: MouseEvent | KeyboardEvent | undefined;
+    checked?: boolean;
+    checkedKeys: readonly HysMenuKey[];
+    selectedKeys: readonly HysMenuKey[];
+}
+export interface HysMenuShowOptions {
+    x?: number;
+    y?: number;
+    focus?: boolean;
+}
+export interface HysContextMenuProps<N extends object = HysContextMenuItem> extends HysPopupMotionProps {
+    items: readonly N[];
+    fieldNames?: Partial<HysMenuFieldNames>;
+    disabled?: boolean;
+    loading?: boolean;
+    size?: "sm" | "md" | "lg";
+    trigger?: HysContextMenuTrigger | readonly HysContextMenuTrigger[];
+    open?: boolean;
+    defaultOpen?: boolean;
+    openPath?: readonly HysMenuKey[];
+    defaultOpenPath?: readonly HysMenuKey[];
+    checkedKeys?: readonly HysMenuKey[];
+    defaultCheckedKeys?: readonly HysMenuKey[];
+    selectedKeys?: readonly HysMenuKey[];
+    defaultSelectedKeys?: readonly HysMenuKey[];
+    selectable?: boolean;
+    multiple?: boolean;
+    hideOnClick?: boolean;
+    autofocus?: boolean;
+    loopNavigation?: boolean;
+    showDelay?: number;
+    hideDelay?: number;
+    submenuDelay?: number;
+    submenuTrigger?: "hover" | "click";
+    placement?: Placement;
+    appendTo?: string | HTMLElement | false;
+    width?: string | number;
+    minWidth?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    arrow?: boolean;
+    popupClass?: string;
+    popupStyle?: CSSProperties;
+    direction?: "ltr" | "rtl";
+    ariaLabel?: string;
+    emptyText?: string;
+    loadingText?: string;
+    backText?: string;
+}
+export interface HysContextMenuInstance<N extends object = HysContextMenuItem> {
+    readonly element: HTMLElement | undefined;
+    readonly open: boolean;
+    readonly checkedKeys: HysMenuKey[];
+    readonly selectedKeys: HysMenuKey[];
+    readonly openPath: HysMenuKey[];
+    focus: () => void;
+    blur: () => void;
+    show: (event?: MouseEvent | KeyboardEvent | HysMenuShowOptions) => Promise<boolean>;
+    showAt: (x: number, y: number, focus?: boolean) => Promise<boolean>;
+    hide: (restoreFocus?: boolean) => Promise<boolean>;
+    handleOpen: () => Promise<boolean>;
+    handleClose: () => Promise<boolean>;
+    toggle: () => Promise<boolean>;
+    focusItem: (key: HysMenuKey) => Promise<boolean>;
+    openSubmenu: (key: HysMenuKey) => Promise<boolean>;
+    closeSubmenus: () => Promise<boolean>;
+    setCheckedKeys: (keys: readonly HysMenuKey[]) => Promise<boolean>;
+    setSelectedKeys: (keys: readonly HysMenuKey[]) => Promise<boolean>;
+    getItems: () => N[];
+}
+export interface HysMenuItemContext<N extends object = HysContextMenuItem> {
+    item: N;
+    value: HysMenuKey | undefined;
+    label: string;
+    path: readonly N[];
+    keys: readonly HysMenuKey[];
+    level: number;
+    disabled: boolean;
+    checked: boolean;
+    selected: boolean;
+    expanded: boolean;
+    submenu: boolean;
+}
+export interface HysContextMenuSlots<N extends object = HysContextMenuItem> {
+    default?: (scope: {
+        open: boolean;
+        show: HysContextMenuInstance<N>["show"];
+        hide: HysContextMenuInstance<N>["hide"];
+        toggle: HysContextMenuInstance<N>["toggle"];
+        attrs: Record<string, unknown>;
+    }) => VNodeChild;
+    item?: (scope: HysMenuItemContext<N>) => VNodeChild;
+    icon?: (scope: HysMenuItemContext<N>) => VNodeChild;
+    link?: (scope: HysMenuItemContext<N> & {
+        attrs: Record<string, unknown>;
+    }) => VNodeChild;
+    header?: (scope: {
+        close: () => Promise<boolean>;
+    }) => VNodeChild;
+    footer?: (scope: {
+        close: () => Promise<boolean>;
+    }) => VNodeChild;
+    empty?: () => VNodeChild;
+    loading?: () => VNodeChild;
+}
+export interface MenuRow<N extends object> {
+    id: string;
+    raw: N;
+    key?: HysMenuKey;
+    label: string;
+    type: NonNullable<HysContextMenuItem["type"]>;
+    disabled: boolean;
+    danger: boolean;
+    icon?: Component;
+    description: string;
+    shortcut: string;
+    href?: string;
+    target?: string;
+    rel?: string;
+    radioGroup?: HysMenuKey;
+    checked: boolean;
+    closeOnSelect?: boolean;
+    children: MenuRow<N>[];
+    parents: MenuRow<N>[];
+    path: N[];
+    keys: HysMenuKey[];
+    level: number;
+}
+export declare const menuToken: (key: HysMenuKey) => string;
+export declare function menuKeys(keys: readonly HysMenuKey[] | undefined): HysMenuKey[];
+export declare const menuKeysEqual: (a: readonly HysMenuKey[], b: readonly HysMenuKey[]) => boolean;
+export declare function menuField(item: object, path: string): unknown;
+export declare const menuSafeRel: (target?: string, rel?: string) => string | undefined;
+export declare function menuRows<N extends object>(items: readonly N[], fields?: Partial<HysMenuFieldNames>): {
+    roots: MenuRow<N>[];
+    all: MenuRow<N>[];
+    byKey: Map<string, MenuRow<N>>;
+};

package/dist/types/composables/modal.d.ts

@@ -0,0 +1,185 @@
+import type { Component, CSSProperties, TransitionProps, VNodeChild } from "vue";
+import type { HysButtonProps, HysButtonVariant } from "../components/HysButton/HysButton.vue";
+export type HysModalCloseReason = "mask" | "escape" | "button" | "cancel" | "confirm" | "api";
+export type HysModalType = "default" | "confirm" | "info" | "success" | "warning" | "error";
+export type HysModalInitialFocus = "auto" | "dialog" | "confirm" | "cancel" | false | string | InstanceType<typeof HTMLElement>;
+export type HysModalSizeName = "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full";
+export declare const modalWidths: {
+    readonly xs: 360;
+    readonly sm: 440;
+    readonly md: 560;
+    readonly lg: 720;
+    readonly xl: 960;
+    readonly "2xl": 1200;
+    readonly full: "100%";
+};
+export declare const modalWidth: (props: HysModalProps) => string | number;
+export type HysModalSectionSize = "sm" | "md" | "lg";
+export type HysModalDragEffect = "lift" | "outline" | "glow" | "shadow" | "ghost" | "none";
+export interface HysModalActionContext {
+    reason: HysModalCloseReason;
+    event?: Event;
+    signal: AbortSignal;
+}
+export interface HysModalPosition {
+    x: number;
+    y: number;
+}
+export interface HysModalSize {
+    width: number;
+    height: number;
+}
+export type HysModalBeforeClose = {
+    invoke(reason: HysModalCloseReason, context: HysModalActionContext): boolean | void | Promise<boolean | void>;
+}["invoke"];
+export interface HysModalProps {
+    open?: boolean;
+    modelValue?: boolean;
+    defaultOpen?: boolean;
+    title?: string;
+    description?: string;
+    type?: HysModalType;
+    showIcon?: boolean;
+    /** Background opacity from 0 to 1; does not fade text or controls. */
+    opacity?: number;
+    /** Mask opacity from 0 to 1; omitted keeps the default mask style. */
+    maskOpacity?: number;
+    icon?: Component;
+    width?: string | number;
+    height?: string | number;
+    maxHeight?: string | number;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    size?: HysModalSizeName;
+    centered?: boolean;
+    top?: string | number;
+    center?: boolean;
+    fullscreen?: boolean;
+    defaultFullscreen?: boolean;
+    showFullscreen?: boolean;
+    closeOnMask?: boolean;
+    closeOnEscape?: boolean;
+    showClose?: boolean;
+    destroyOnClose?: boolean;
+    forceRender?: boolean;
+    modal?: boolean;
+    modalPenetrable?: boolean;
+    appendTo?: string | InstanceType<typeof HTMLElement> | false;
+    lockScroll?: boolean;
+    trapFocus?: boolean;
+    restoreFocus?: boolean;
+    initialFocus?: HysModalInitialFocus;
+    openDelay?: number;
+    closeDelay?: number;
+    transition?: string | TransitionProps | false;
+    transitionDuration?: number;
+    zIndex?: number;
+    headerClass?: string;
+    headerSize?: HysModalSectionSize;
+    footerSize?: HysModalSectionSize;
+    /** Minimum height. Content may expand the region to avoid clipping. */
+    headerHeight?: string | number;
+    footerHeight?: string | number;
+    titleFontSize?: string | number;
+    bodyClass?: string;
+    footerClass?: string;
+    overlayClass?: string;
+    modalClass?: string;
+    headerStyle?: CSSProperties;
+    bodyStyle?: CSSProperties;
+    footerStyle?: CSSProperties;
+    maskStyle?: CSSProperties;
+    modalStyle?: CSSProperties;
+    ariaLabel?: string;
+    ariaLabelledby?: string;
+    ariaDescribedby?: string;
+    role?: "dialog" | "alertdialog";
+    headerAriaLevel?: number;
+    closeText?: string;
+    fullscreenText?: string;
+    restoreText?: string;
+    footer?: boolean;
+    footerAlign?: "start" | "center" | "end";
+    showCancel?: boolean;
+    okText?: string;
+    cancelText?: string;
+    okVariant?: HysButtonVariant;
+    okButtonProps?: HysButtonProps;
+    cancelButtonProps?: HysButtonProps;
+    confirmLoading?: boolean;
+    confirmDisabled?: boolean;
+    cancelDisabled?: boolean;
+    closeWhileConfirming?: boolean;
+    loading?: boolean;
+    loadingText?: string;
+    showError?: boolean;
+    errorText?: string | ((error: unknown, action: "confirm" | "close") => string);
+    confirmOnCtrlEnter?: boolean;
+    closeOnConfirm?: boolean;
+    beforeClose?(reason: HysModalCloseReason, context: HysModalActionContext): boolean | void | Promise<boolean | void>;
+    beforeConfirm?: (context: HysModalActionContext) => boolean | void | Promise<boolean | void>;
+    draggable?: boolean;
+    dragHandlePosition?: "center" | "left" | "right" | "both";
+    dragMode?: "live" | "preview";
+    /** Pointer movement in pixels before a header press becomes a drag. */
+    dragThreshold?: number;
+    /** Lightweight gesture feedback, activated only at drag start/end. */
+    dragEffect?: HysModalDragEffect;
+    overflow?: boolean;
+    /** Keep the move handle reachable even when the panel may overflow. */
+    keepHandleVisible?: boolean;
+    resizable?: boolean;
+    resetPositionOnClose?: boolean;
+    resetSizeOnClose?: boolean;
+    /** Retained legacy setting; position in a modal is controlled by centered/top. */
+    placement?: "left" | "right" | "top" | "bottom";
+}
+export interface HysModalSlotContext {
+    close: (reason?: HysModalCloseReason | Event) => Promise<boolean>;
+    cancel: (event?: Event) => Promise<boolean>;
+    confirm: (event?: Event) => Promise<boolean>;
+    closing: boolean;
+    confirming: boolean;
+    busy: boolean;
+    error: string;
+    titleId: string;
+    descriptionId: string;
+    fullscreen: boolean;
+    toggleFullscreen: () => Promise<boolean>;
+}
+export interface HysModalSlots {
+    default?: (context: HysModalSlotContext) => VNodeChild;
+    /** Content placed between the overlay and the dialog panel. */
+    backdrop?: (context: HysModalSlotContext) => VNodeChild;
+    header?: (context: HysModalSlotContext) => VNodeChild;
+    footer?: (context: HysModalSlotContext) => VNodeChild;
+    icon?: (context: HysModalSlotContext) => VNodeChild;
+    loading?: (context: HysModalSlotContext) => VNodeChild;
+    "close-icon"?: (context: HysModalSlotContext) => VNodeChild;
+    "fullscreen-icon"?: (context: HysModalSlotContext) => VNodeChild;
+}
+export interface HysModalInstance {
+    readonly element: HTMLElement | undefined;
+    readonly open: boolean;
+    readonly closing: boolean;
+    readonly confirming: boolean;
+    readonly fullscreen: boolean;
+    readonly position: HysModalPosition;
+    readonly dimensions: HysModalSize | undefined;
+    show: () => Promise<boolean>;
+    hide: () => Promise<boolean>;
+    close: (reason?: HysModalCloseReason) => Promise<boolean>;
+    handleOpen: () => Promise<boolean>;
+    handleClose: () => Promise<boolean>;
+    confirm: (event?: Event) => Promise<boolean>;
+    cancel: (event?: Event) => Promise<boolean>;
+    focus: () => void;
+    toggleFullscreen: () => Promise<boolean>;
+    setFullscreen: (value: boolean) => Promise<boolean>;
+    resetPosition: () => void;
+    resetSize: () => void;
+    setPosition: (position: HysModalPosition) => void;
+    setSize: (size: HysModalSize) => void;
+}
+export declare const modalLength: (value: string | number | undefined) => string | undefined;

package/dist/types/composables/overlayManager.d.ts

@@ -1,7 +1,11 @@
-export type OverlayKind = 'floating' | 'dialog';
-export declare const overlayCount: import("vue").Ref<number, number>;
-export declare function registerOverlay(kind: OverlayKind, dismiss: () => void): {
+/** Shared, deterministic overlay stack. Only the topmost layer responds to Escape. */
+import { type InjectionKey, type Ref } from "vue";
+export declare const overlayOwnerKey: InjectionKey<Readonly<Ref<boolean>>>;
+export type OverlayKind = "floating" | "dialog";
+export declare const overlayCount: Ref<number, number>;
+export declare function registerOverlay(kind: OverlayKind, dismiss: () => void, base?: () => number | undefined): {
     id: symbol;
+    zIndex: import("vue").ComputedRef<number>;
     isTop: () => boolean;
     unregister: () => void;
 };