hys-ui 0.1.1 → 0.3.0

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

@@ -0,0 +1,126 @@
+import type { CSSProperties, HTMLAttributes, VNodeChild } from "vue";
+export type HysVirtualTableKey = string | number;
+export type HysVirtualTableAlign = "start" | "center" | "end" | "nearest";
+export interface HysVirtualTableSort {
+    key: string;
+    direction: "asc" | "desc";
+}
+export interface HysVirtualTableCell<T extends object = Record<string, unknown>> {
+    row: T;
+    column: HysVirtualTableColumn<T>;
+    value: unknown;
+    rowIndex: number;
+    columnIndex: number;
+}
+export interface HysVirtualTableColumn<T extends object = any> {
+    key: string;
+    label: string;
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    dataIndex?: string | readonly (string | number)[];
+    valueGetter?: (row: T, index: number) => unknown;
+    formatter?: (context: HysVirtualTableCell<T>) => VNodeChild;
+    fixed?: boolean | "left" | "right";
+    hidden?: boolean;
+    align?: "left" | "center" | "right";
+    headerAlign?: "left" | "center" | "right";
+    sortable?: boolean | "custom";
+    sorter?: (a: T, b: T) => number;
+    className?: string;
+    headerClassName?: string;
+}
+export interface HysVirtualTableRange {
+    start: number;
+    end: number;
+    visibleStart: number;
+    visibleEnd: number;
+    columnKeys: string[];
+}
+export interface HysVirtualTableScroll {
+    scrollTop: number;
+    scrollLeft: number;
+    direction: "up" | "down" | "left" | "right" | null;
+}
+export interface HysVirtualTableProps<T extends object> {
+    rows: readonly T[];
+    columns: readonly HysVirtualTableColumn<T>[];
+    rowKey?: string | ((row: T, index: number) => HysVirtualTableKey);
+    rowHeight?: number;
+    height?: number | string;
+    width?: number | string;
+    headerHeight?: number;
+    showHeader?: boolean;
+    fit?: boolean;
+    overscan?: number;
+    virtualColumns?: boolean;
+    columnOverscan?: number;
+    loading?: boolean;
+    loadingMode?: "replace" | "overlay";
+    loadingText?: string;
+    emptyText?: string;
+    disabled?: boolean;
+    fixedRows?: readonly T[];
+    striped?: boolean;
+    bordered?: boolean;
+    sortState?: HysVirtualTableSort | null;
+    defaultSort?: HysVirtualTableSort | null;
+    selectable?: boolean | ((row: T, index: number) => boolean);
+    selectedRowKeys?: readonly HysVirtualTableKey[];
+    defaultSelectedRowKeys?: readonly HysVirtualTableKey[];
+    selectionType?: "checkbox" | "radio";
+    selectionWidth?: number;
+    reserveSelection?: boolean;
+    selectOnClick?: boolean;
+    currentRowKey?: HysVirtualTableKey | null;
+    defaultCurrentRowKey?: HysVirtualTableKey | null;
+    highlightCurrentRow?: boolean;
+    keyboard?: boolean;
+    endReachedThreshold?: number;
+    ariaLabel?: string;
+    rowClassName?: string | ((row: T, index: number) => string);
+    rowStyle?: CSSProperties | ((row: T, index: number) => CSSProperties);
+    cellClassName?: string | ((context: HysVirtualTableCell<T>) => string);
+    cellStyle?: CSSProperties | ((context: HysVirtualTableCell<T>) => CSSProperties);
+    customRow?: (row: T, index: number) => HTMLAttributes;
+    customCell?: (context: HysVirtualTableCell<T>) => HTMLAttributes;
+    customHeaderCell?: (column: HysVirtualTableColumn<T>, index: number) => HTMLAttributes;
+}
+export interface HysVirtualTableInstance<T extends object = Record<string, unknown>> {
+    readonly element: HTMLElement | undefined;
+    readonly viewport: HTMLElement | undefined;
+    readonly scrollTop: number;
+    readonly scrollLeft: number;
+    readonly range: HysVirtualTableRange;
+    readonly selectedRowKeys: HysVirtualTableKey[];
+    readonly sortState: HysVirtualTableSort | null;
+    scrollTo(options: {
+        top?: number;
+        left?: number;
+        behavior?: ScrollBehavior;
+    }): void;
+    scrollToRow(index: number, align?: HysVirtualTableAlign): void;
+    scrollToKey(key: HysVirtualTableKey, align?: HysVirtualTableAlign): boolean;
+    scrollToColumn(key: string, align?: HysVirtualTableAlign): boolean;
+    focusCell(index: number, key?: string): Promise<boolean>;
+    setSort(sort: HysVirtualTableSort | null): Promise<boolean>;
+    clearSelection(): Promise<boolean>;
+    toggleRowSelection(key: HysVirtualTableKey, selected?: boolean): Promise<boolean>;
+    selectAll(selected?: boolean): Promise<boolean>;
+    setCurrentRow(key: HysVirtualTableKey | null): Promise<boolean>;
+    getRow(index: number): T | undefined;
+    remeasure(): void;
+}
+export declare const virtualFinite: (value: unknown, fallback: number, min?: number, max?: number) => number;
+export declare const virtualKey: (key: unknown) => key is HysVirtualTableKey;
+export declare const virtualToken: (key: HysVirtualTableKey) => string;
+export declare function virtualValue<T extends object>(row: T, column: HysVirtualTableColumn<T>, index: number): unknown;
+export interface VirtualEntry<T extends object> {
+    row: T;
+    key: HysVirtualTableKey;
+    token: string;
+    sourceIndex: number;
+    valid: boolean;
+}
+export declare function virtualEntries<T extends object>(rows: readonly T[], rowKey: HysVirtualTableProps<T>["rowKey"]): VirtualEntry<T>[];
+export declare function virtualAligned(start: number, size: number, scroll: number, extent: number, align: HysVirtualTableAlign): number;

package/dist/types/index.d.ts

@@ -1,21 +1,28 @@
 import './styles/index.css';
 export { default as HysAccordion } from './components/HysAccordion/HysAccordion.vue';
+export type { HysAccordionKey } from './components/HysAccordion/HysAccordion.vue';
+export type { HysAccordionItem } from './components/HysAccordion/HysAccordion.vue';
 export { default as HysAlert } from './components/HysAlert/HysAlert.vue';
 export { default as HysAnimatedNumber } from './components/HysAnimatedNumber/HysAnimatedNumber.vue';
+export { default as HysAutocomplete } from './components/HysAutocomplete/HysAutocomplete.vue';
 export { default as HysAvatar } from './components/HysAvatar/HysAvatar.vue';
+export { default as HysAvatarGroup } from './components/HysAvatarGroup/HysAvatarGroup.vue';
 export { default as HysBadge } from './components/HysBadge/HysBadge.vue';
 export { default as HysBreadcrumb } from './components/HysBreadcrumb/HysBreadcrumb.vue';
+export type { HysBreadcrumbItem } from './components/HysBreadcrumb/HysBreadcrumb.vue';
+export type { HysBreadcrumbSelectInfo } from './components/HysBreadcrumb/HysBreadcrumb.vue';
+export type { HysBreadcrumbProps } from './components/HysBreadcrumb/HysBreadcrumb.vue';
 export { default as HysButton } from './components/HysButton/HysButton.vue';
 export type { HysButtonVariant } from './components/HysButton/HysButton.vue';
 export type { HysButtonProps } from './components/HysButton/HysButton.vue';
 export { default as HysCalendar } from './components/HysCalendar/HysCalendar.vue';
-export type { CalendarEvent } from './components/HysCalendar/HysCalendar.vue';
 export { default as HysCalendarNavigation } from './components/HysCalendarNavigation/HysCalendarNavigation.vue';
 export { default as HysCard } from './components/HysCard/HysCard.vue';
+export type { HysCardTab } from './components/HysCard/HysCard.vue';
 export { default as HysCascader } from './components/HysCascader/HysCascader.vue';
-export type { HysCascaderNode } from './components/HysCascader/HysCascader.vue';
 export { default as HysChart } from './components/HysChart/HysChart.vue';
 export { default as HysCheckbox } from './components/HysCheckbox/HysCheckbox.vue';
+export { default as HysCheckboxGroup } from './components/HysCheckboxGroup/HysCheckboxGroup.vue';
 export { default as HysColorPicker } from './components/HysColorPicker/HysColorPicker.vue';
 export { default as HysColorTokenEditor } from './components/HysColorTokenEditor/HysColorTokenEditor.vue';
 export { default as HysCommandPalette } from './components/HysCommandPalette/HysCommandPalette.vue';
@@ -24,7 +31,6 @@ export type { Comment } from './components/HysCommentEditor/HysCommentEditor.vue
 export { default as HysContextMenu } from './components/HysContextMenu/HysContextMenu.vue';
 export { default as HysCronEditor } from './components/HysCronEditor/HysCronEditor.vue';
 export { default as HysDataGrid } from './components/HysDataGrid/HysDataGrid.vue';
-export type { GridColumn } from './components/HysDataGrid/HysDataGrid.vue';
 export { default as HysDatePicker } from './components/HysDatePicker/HysDatePicker.vue';
 export { default as HysDateRangePicker } from './components/HysDateRangePicker/HysDateRangePicker.vue';
 export { default as HysDiffViewer } from './components/HysDiffViewer/HysDiffViewer.vue';
@@ -52,6 +58,7 @@ export { default as HysPagination } from './components/HysPagination/HysPaginati
 export { default as HysPermissionMatrix } from './components/HysPermissionMatrix/HysPermissionMatrix.vue';
 export { default as HysPopover } from './components/HysPopover/HysPopover.vue';
 export { default as HysProgress } from './components/HysProgress/HysProgress.vue';
+export { default as HysRadio } from './components/HysRadio/HysRadio.vue';
 export { default as HysRadioGroup } from './components/HysRadioGroup/HysRadioGroup.vue';
 export type { HysRadioOption } from './components/HysRadioGroup/HysRadioGroup.vue';
 export { default as HysRating } from './components/HysRating/HysRating.vue';
@@ -60,17 +67,20 @@ export { default as HysRichTextEditor } from './components/HysRichTextEditor/Hys
 export { default as HysSearch } from './components/HysSearch/HysSearch.vue';
 export { default as HysSegmented } from './components/HysSegmented/HysSegmented.vue';
 export { default as HysSelect } from './components/HysSelect/HysSelect.vue';
-export type { HysSelectOption } from './components/HysSelect/HysSelect.vue';
 export { default as HysShortcutHelp } from './components/HysShortcutHelp/HysShortcutHelp.vue';
 export { default as HysSkeleton } from './components/HysSkeleton/HysSkeleton.vue';
+export type { HysSkeletonVariant } from './components/HysSkeleton/HysSkeleton.vue';
 export { default as HysSlider } from './components/HysSlider/HysSlider.vue';
 export { default as HysSortableList } from './components/HysSortableList/HysSortableList.vue';
 export { default as HysSplitPane } from './components/HysSplitPane/HysSplitPane.vue';
 export { default as HysSteps } from './components/HysSteps/HysSteps.vue';
+export type { HysStepStatus } from './components/HysSteps/HysSteps.vue';
+export type { HysStepItem } from './components/HysSteps/HysSteps.vue';
 export { default as HysSwitch } from './components/HysSwitch/HysSwitch.vue';
 export { default as HysTable } from './components/HysTable/HysTable.vue';
-export type { HysTableColumn } from './components/HysTable/HysTable.vue';
 export { default as HysTabs } from './components/HysTabs/HysTabs.vue';
+export type { HysTabValue } from './components/HysTabs/HysTabs.vue';
+export type { HysTabItem } from './components/HysTabs/HysTabs.vue';
 export { default as HysTagInput } from './components/HysTagInput/HysTagInput.vue';
 export { default as HysTextarea } from './components/HysTextarea/HysTextarea.vue';
 export { default as HysTimeline } from './components/HysTimeline/HysTimeline.vue';
@@ -81,15 +91,46 @@ export { default as HysTooltip } from './components/HysTooltip/HysTooltip.vue';
 export { default as HysTour } from './components/HysTour/HysTour.vue';
 export { default as HysTransfer } from './components/HysTransfer/HysTransfer.vue';
 export { default as HysTree } from './components/HysTree/HysTree.vue';
-export type { TreeNode } from './components/HysTree/HysTree.vue';
 export { default as HysTreeSelect } from './components/HysTreeSelect/HysTreeSelect.vue';
-export type { HysTreeSelectNode } from './components/HysTreeSelect/HysTreeSelect.vue';
 export { default as HysUpload } from './components/HysUpload/HysUpload.vue';
-export type { HysUploadFile } from './components/HysUpload/HysUpload.vue';
 export { default as HysVirtualTable } from './components/HysVirtualTable/HysVirtualTable.vue';
 export { provideHysConfig } from './config';
 export type { HysConfig, HysTheme, HysMotion } from './config';
 export type { Placement } from './composables/useFloating';
-export type { HysFormRule } from './composables/formContext';
+export type { HysFormRule, HysFormRules, HysFormPath, HysFormPaths, HysFormTrigger, HysFormRuleType, HysFormStatus, HysFormMessages, HysFormField, HysFormFieldState, HysFormValidationResult, HysFormValidationContext, HysFormValidateCallback, HysFormFieldData } from './composables/formContext';
+export { useHysFormItemContext } from './composables/formContext';
+export type { HysFormCol, HysFormColSize, HysFormGridValue, HysFormBreakpoint } from './composables/formLayout';
+export type { HysSelectValue, HysSelectModelValue, HysSelectOption, HysSelectGroup, HysSelectDataOption, HysSelectFieldNames, HysSelectSearchContext, HysSelectInstance } from './composables/selectOptions';
+export type { HysNumberInputValue, HysNumberInputFormatInfo, HysNumberInputStepInfo, HysNumberInputInvalidInfo, HysNumberInputInstance } from './composables/numberInput';
+export type { HysInputProps, HysTextareaProps, HysInputFormatInfo, HysInputCountInfo, HysInputCountStrategy, HysInputInstance, HysTextareaInstance } from './composables/textInput';
 export { useHysToast, createHysToast } from './composables/useHysToast';
 export type { HysToastApi, HysToastOptions, HysToastConfig, HysToastHandle, HysToastServiceConfig, HysToastService } from './composables/useHysToast';
+export type { HysSliderValue, HysSliderStep, HysSliderMarks, HysSliderDragInfo, HysSliderInstance } from './composables/slider';
+export type { HysAvatarProps, HysAvatarSize, HysAvatarBreakpoint, HysAvatarFit, HysAvatarLoadInfo, HysAvatarOption, HysAvatarInstance, HysAvatarGroupProps, HysAvatarGroupInstance } from './composables/avatar';
+export type { HysAutocompleteProps, HysAutocompleteRow, HysAutocompleteOption, HysAutocompleteItem, HysAutocompleteGroup, HysAutocompleteDataOption, HysAutocompleteContext, HysAutocompleteCallback, HysAutocompleteFetch, HysAutocompleteInstance } from './composables/autocomplete';
+export type { HysChoiceValue, HysChoiceFieldNames, HysChoiceOption, HysChoiceDataOption, HysCheckboxChange, HysCheckboxReject, HysCheckboxInstance, HysCheckboxGroupInstance, HysRadioInstance, HysRadioGroupInstance, HysSwitchGuardContext, HysSwitchInstance } from './composables/choice';
+export type { HysRatingIcon, HysRatingLevels, HysRatingInstance } from './composables/rating';
+export type { HysSegmentedOption, HysSegmentedInstance } from './composables/segmented';
+export type { HysGanttScrollOptions, HysGanttInstance, HysGanttDependencyChange, HysGanttDependencyMove, HysGanttDependencyInvalid, HysGanttDependencyReason, HysGanttHistoryType, HysGanttHistoryEntry, HysGanttHistoryState, HysGanttHistoryInvalid, HysGanttConflictType, HysGanttConflict } from './composables/gantt';
+export type { CalendarEvent, HysCalendarValue, HysCalendarMode, HysCalendarTransition, HysCalendarAction, HysCalendarCell, HysCalendarMonthCell, HysCalendarSelectInfo, HysCalendarInstance } from './composables/calendar';
+export type { HysTableSelectionProps, HysTableSelectionColumn, HysTableFilterConfirmOptions, HysTableFilterResetOptions, HysTableScrollRowOptions, HysTableKey, HysTableDirection, HysTableFilterValue, HysTableFilters, HysTableSort, HysTableFilter, HysTableCellContext, HysTableColumn, HysTableElementAttrs, HysTablePaginationPosition, HysTablePagination, HysTableQuery, HysTableLoadContext, HysTableLocale, HysTableProps, HysTableInstance } from './composables/table';
+export type { HysTransferKey, HysTransferSide, HysTransferOption, HysTransferFieldNames, HysTransferPagination, HysTransferLocale, HysTransferHeaderInfo, HysTransferProps, HysTransferPanelContext, HysTransferInstance, HysTransferSlots } from './composables/transfer';
+export type { TreeNode, HysTreeKey, HysTreeValue, HysTreeNode, HysTreeFieldNames, HysTreeLoadContext, HysTreeLocale, HysTreeRecord, HysTreeCheckInfo, HysTreeSelectInfo, HysTreeDropPosition, HysTreeDropInfo, HysTreeNodeContext, HysTreeProps, HysTreeInstance } from './composables/tree';
+export type { HysTreeSelectNode, HysTreeSelectDataNode, HysTreeSelectLabelValue, HysTreeSelectValue, HysTreeSelectFieldNames, HysTreeSelectSimpleMode, HysTreeSelectStrategy, HysTreeSelectItem, HysTreeSelectChange, HysTreeSelectProps, HysTreeSelectInstance } from './composables/treeSelect';
+export type { HysCascaderKey, HysCascaderPath, HysCascaderValue, HysCascaderDataNode, HysCascaderNode, HysCascaderFieldNames, HysCascaderItem, HysCascaderOptionContext, HysCascaderLoadContext, HysCascaderChange, HysCascaderLocale, HysCascaderProps, HysCascaderInstance } from './composables/cascader';
+export type { HysDatePickerWeek, HysDateScalar, HysDatePickerValue, HysDateRangeValue, HysDatePickerType, HysDatePickerUnit, HysDatePickerView, HysDatePoint, HysDatePickerContext, HysDateDisabledTime, HysDateShortcut, HysDatePickerCell, HysDatePickerChange, HysDatePickerLocale, HysDatePickerProps, HysDateRangePickerProps, HysDatePickerInstance, HysDateRangePickerInstance, HysDatePickerSlots } from './composables/datePicker';
+export type { HysModalDragEffect, HysModalSectionSize, HysModalSizeName, HysModalBeforeClose, HysModalCloseReason, HysModalType, HysModalInitialFocus, HysModalActionContext, HysModalPosition, HysModalSize, HysModalProps, HysModalSlotContext, HysModalSlots, HysModalInstance } from './composables/modal';
+export { useHysModal, createHysModal } from './composables/useHysModal';
+export type { HysModalResult, HysModalOptions, HysModalHandle, HysModalConfig, HysModalApi, HysModalService, HysModalServiceConfig } from './composables/useHysModal';
+export type { HysMenuKey, HysContextMenuTrigger, HysContextMenuItem, HysMenuFieldNames, HysMenuSelectInfo, HysMenuShowOptions, HysContextMenuProps, HysContextMenuInstance, HysMenuItemContext, HysContextMenuSlots } from './composables/menu';
+export type { HysDrawerProps, HysDrawerBeforeClose, HysDrawerPlacement, HysDrawerSizeName, HysDrawerCloseReason, HysDrawerActionContext, HysDrawerInitialFocus, HysDrawerSectionSize, HysDrawerResizeOptions, HysDrawerResizeInfo, HysDrawerPushOptions, HysDrawerSlotContext, HysDrawerSlots, HysDrawerInstance } from './composables/drawer';
+export type { HysPopupPlacement, HysPopupTrigger, HysPopupVirtualReference, HysPopupReference, HysPopupSurfaceProps, HysTooltipProps, HysPopoverProps, HysPopupSurfaceContext, HysTooltipSlots, HysPopoverSlots, HysPopupSurfaceInstance, HysTooltipInstance, HysPopoverInstance } from './composables/popupSurface';
+export type { HysUploadFile, HysUploadItem, HysUploadStatus, HysUploadListType, HysUploadChangeType, HysUploadChange, HysUploadContext, HysUploadInvalid, HysUploadError, HysUploadDataScalar, HysUploadData, HysUploadRequestOptions, HysUploadRequestResult, HysUploadLocale, HysUploadProps, HysUploadActions, HysUploadFileContext, HysUploadSlotContext, HysUploadSlots, HysUploadInstance } from './composables/upload';
+export type { HysProgressType, HysProgressStatus, HysProgressSize, HysProgressLinecap, HysProgressGapPosition, HysProgressGradientDirection, HysProgressGradientStop, HysProgressGradient, HysProgressColorStop, HysProgressColor, HysProgressSuccess, HysProgressLabelContext, HysProgressProps, HysProgressSlots, HysProgressInstance } from './composables/progress';
+export type { HysAlertTone, HysAlertEffect, HysAlertTransition, HysAlertCloseContext, HysAlertProps, HysAlertSlotContext, HysAlertSlots, HysAlertInstance, HysEmptyIllustration, HysEmptyProps, HysEmptySlotContext, HysEmptySlots, HysEmptyInstance } from './composables/feedback';
+export type { HysTimelineKey, HysTimelineMode, HysTimelinePosition, HysTimelineSize, HysTimelineTone, HysTimelineItem, HysTimelineFieldNames, HysTimelineProps, HysTimelineItemContext, HysTimelinePendingContext, HysTimelineSlots, HysTimelineInstance } from './composables/timeline';
+export type { HysTagInputReason, HysTagInputAddContext, HysTagInputInvalid, HysTagInputProps, HysTagInputSlotContext, HysTagInputTagContext, HysTagInputSlots, HysTagInputInstance } from './composables/tagInput';
+export type { HysColorFormat, HysColor, HysColorPickerProps, HysColorPickerContext, HysColorPickerSlots, HysColorPickerInstance } from './composables/color';
+export type { HysVirtualTableKey, HysVirtualTableAlign, HysVirtualTableSort, HysVirtualTableCell, HysVirtualTableColumn, HysVirtualTableRange, HysVirtualTableScroll, HysVirtualTableProps, HysVirtualTableInstance } from './composables/virtualTable';
+export type { GridColumn, HysDataGridKey, HysDataGridSort, HysDataGridQuery, HysDataGridProps, HysDataGridResult, HysDataGridLoader, HysDataGridInstance } from './composables/dataGrid';
+export type { HysPopupTransition, HysPopupMotionProps } from './motion/popup';

package/dist/types/internal/PopupReference.d.ts

@@ -0,0 +1,18 @@
+import { type VNode } from "vue";
+/** Adds popup ARIA to the real control without introducing another keyboard stop. */
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    id: StringConstructor;
+    open: BooleanConstructor;
+    kind: StringConstructor;
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "element"[], "element", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    id: StringConstructor;
+    open: BooleanConstructor;
+    kind: StringConstructor;
+}>> & Readonly<{
+    onElement?: ((...args: any[]) => any) | undefined;
+}>, {
+    open: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/internal/PopupSurfacePanel.vue.d.ts

@@ -0,0 +1,37 @@
+import type { HysPopupSurfaceProps } from "../composables/popupSurface";
+import type { usePopupSurface } from "../composables/usePopupSurface";
+type __VLS_Props = {
+    surface: ReturnType<typeof usePopupSurface>;
+    options: HysPopupSurfaceProps;
+    kind: "tooltip" | "popover";
+    title?: string;
+};
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        title?: (props: {
+            open: boolean;
+            show: () => Promise<boolean>;
+            close: () => Promise<boolean>;
+            toggle: () => Promise<boolean>;
+            updatePosition: () => void;
+        }) => any;
+    } & {
+        default?: (props: {
+            open: boolean;
+            show: () => Promise<boolean>;
+            close: () => Promise<boolean>;
+            toggle: () => Promise<boolean>;
+            updatePosition: () => void;
+        }) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/motion/PopupMotion.d.ts

@@ -0,0 +1,59 @@
+import { type PropType } from "vue";
+import type { HysPopupTransition } from "./popup";
+/** Internal transparent boundary: preserves the popup DOM/ref and owns only its transition. */
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    popupTransition: {
+        type: PropType<HysPopupTransition>;
+        default: undefined;
+    };
+    popupTransitionDuration: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    placement: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    ignoreOwner: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}> | null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("left" | "inactive" | "entered")[], "left" | "inactive" | "entered", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    popupTransition: {
+        type: PropType<HysPopupTransition>;
+        default: undefined;
+    };
+    popupTransitionDuration: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    placement: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    ignoreOwner: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{
+    onLeft?: ((...args: any[]) => any) | undefined;
+    onInactive?: ((...args: any[]) => any) | undefined;
+    onEntered?: ((...args: any[]) => any) | undefined;
+}>, {
+    disabled: boolean;
+    popupTransition: HysPopupTransition;
+    popupTransitionDuration: number;
+    placement: string;
+    ignoreOwner: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/motion/popup.d.ts

@@ -0,0 +1,12 @@
+export type HysPopupTransition = "scale" | "fade" | "slide" | "slide-fade" | "none";
+export interface HysPopupMotionProps {
+    /** Built-in entrance/exit effect. Defaults to scale; none disables it. */
+    popupTransition?: HysPopupTransition;
+    /** Duration in milliseconds, default 160. Zero disables the transition. */
+    popupTransitionDuration?: number;
+}
+/** Layout dimensions, unaffected by an in-flight scale/slide animation. */
+export declare function popupSize(element: HTMLElement): {
+    width: number;
+    height: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hys-ui",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Themeable Vue 3 components with TypeScript and interactive documentation",
   "type": "module",
   "license": "MIT",
@@ -43,6 +43,7 @@
     "vue": ">=3.5.0 <4"
   },
   "dependencies": {
+    "async-validator": "^4.2.5",
     "lucide-vue-next": "^0.468.0"
   },
   "devDependencies": {