@kine-design/core 0.0.1-beta.1

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

@@ -0,0 +1,9 @@
+import { useMessageQueue } from './useMessage';
+export declare const MessageCore: {
+    messageProps: import('../../types/props').MCOPO<import('./props').MessageProps>;
+    messageListProps: import('../../types/props').MCOPO<import('./props').MessageListProps>;
+    useMessageQueue: typeof useMessageQueue;
+};
+export { useMessageQueue } from './useMessage';
+export type { MessageProps, MessageListProps, MessageType, MessageDirectionType } from './props';
+export type { MessageItem } from './useMessage';

package/dist/components/message/message/useMessage.d.ts

@@ -0,0 +1,23 @@
+import { MessageType } from './props';
+/**
+ * 消息队列中每一条消息的内部结构
+ */
+export interface MessageItem {
+    id: number;
+    type: MessageType;
+    content: string;
+    duration: number;
+}
+/**
+ * 消息队列 composable
+ * 管理消息的增删与自动关闭定时器
+ */
+export declare function useMessageQueue(): {
+    messages: any;
+    add: (props: {
+        type?: MessageType;
+        content: string;
+        duration?: number;
+    }) => number;
+    remove: (id: number) => void;
+};

package/dist/components/message/notification/api.d.ts

@@ -0,0 +1,6 @@
+import { MCOPO } from '../../types/props';
+import { NotificationProps } from './props';
+/**
+ * 单条通知运行时 props
+ */
+export declare const notificationProps: MCOPO<NotificationProps>;

package/dist/components/message/notification/index.d.ts

@@ -0,0 +1,8 @@
+import { useNotificationQueue } from './useNotification';
+export declare const NotificationCore: {
+    notificationProps: import('../../types/props').MCOPO<import('./props').NotificationProps>;
+    useNotificationQueue: typeof useNotificationQueue;
+};
+export { useNotificationQueue } from './useNotification';
+export type { NotificationProps, NotificationEvents, NotificationType, NotificationPosition } from './props';
+export type { NotificationItem, NotificationAddOptions } from './useNotification';

package/dist/components/message/notification/useNotification.d.ts

@@ -0,0 +1,33 @@
+import { NotificationType, NotificationPosition } from './props';
+/**
+ * 通知队列中每一条通知的内部结构
+ */
+export interface NotificationItem {
+    id: number;
+    title: string;
+    message: string;
+    type: NotificationType;
+    duration: number;
+    position: NotificationPosition;
+    closable: boolean;
+}
+/**
+ * 创建通知时的配置参数
+ */
+export interface NotificationAddOptions {
+    title: string;
+    message?: string;
+    type?: NotificationType;
+    duration?: number;
+    position?: NotificationPosition;
+    closable?: boolean;
+}
+/**
+ * 通知队列 composable
+ * 管理通知的增删与自动关闭定时器
+ */
+export declare function useNotificationQueue(): {
+    notifications: any;
+    add: (options: NotificationAddOptions) => number;
+    remove: (id: number) => void;
+};

package/dist/components/message/popover/MPopover.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/dist/components/message/popover/api.d.ts

@@ -0,0 +1,3 @@
+import { PopoverProps } from './props';
+import { MCOPO } from '../../types/props';
+export declare const props: MCOPO<PopoverProps>;

package/dist/components/message/popover/index.d.ts

@@ -0,0 +1,6 @@
+import { usePopover } from './usePopover.ts';
+export declare const MessagePopoverCore: {
+    props: import('../../types/props').MCOPO<import('./props').PopoverProps>;
+    usePopover: typeof usePopover;
+};
+export type { PopoverProps as MessagePopoverProps } from './props';

package/dist/components/message/popover/usePopover.d.ts

@@ -0,0 +1,56 @@
+import { Placement, PopperConfig, PositionStyle, usePopper } from '../../../compositions/popper/usePopper.ts';
+import { Options } from '../../../compositions/common/defineCore';
+import { PopoverProps } from './props';
+import { Ref } from 'vue';
+export type IPopper = ReturnType<typeof usePopper>;
+export declare class PopoverImpl {
+    protected _active: HTMLElement;
+    protected _content: HTMLElement;
+    protected _arrow: HTMLElement | undefined;
+    popperInstance: IPopper;
+    style: Ref;
+    arrowStyle: Ref;
+    placement: Ref;
+    visible: boolean;
+    onShow?: Function;
+    onHide?: Function;
+    constructor(val: {
+        style: Ref;
+        arrowStyle: Ref;
+        placement: Ref;
+        show: boolean;
+    }, active?: HTMLElement, content?: HTMLElement, arrow?: HTMLElement, config?: PopperConfig, lifecycle?: {
+        onShow?: Function;
+        onHide?: Function;
+    });
+    get content(): HTMLElement;
+    show(): Promise<void>;
+    update(positionStyle: PositionStyle): void;
+    hide(): void;
+    toggle(): Promise<void>;
+    destroy(): void;
+}
+type ArrayElement<ArrayType> = ArrayType extends readonly (infer ElementType)[] ? ElementType : never;
+export declare function usePopover(options: Options<{
+    props: PopoverProps;
+    value: {
+        placement: Placement;
+    };
+}>, lifecycle?: {
+    onShow?: Function;
+    onHide?: Function;
+}): {
+    getContent: <T>(props: PopoverProps, getContentSlot: () => T, useTeleport: (options: any) => ArrayElement<T> | T, _instance?: PopoverImpl | null) => T | ArrayElement<T> | null;
+    popoverEnter: () => void;
+    popoverLeave: () => void;
+    popoverRef: any;
+    contentRef: any;
+    arrowRef: any;
+    popperInstance: any;
+    style: any;
+    arrowStyle: any;
+    lifecycle: {
+        onBeforeDestroyEvents: Function[];
+    };
+};
+export {};

package/dist/components/other/darkMode/api.d.ts

@@ -0,0 +1,3 @@
+import { MCOPO } from '../../types/props';
+import { DarkModeProps } from './props';
+export declare const props: MCOPO<DarkModeProps>;

package/dist/components/other/darkMode/index.d.ts

@@ -0,0 +1,6 @@
+import { useDarkMode } from './useDarkMode';
+export declare const DarkModeCore: {
+    props: import('../../types/props').MCOPO<import('./props').DarkModeProps>;
+    useDarkMode: typeof useDarkMode;
+};
+export type { DarkModeProps } from './props';

package/dist/components/other/darkMode/useDarkMode.d.ts

@@ -0,0 +1,11 @@
+import { DarkModeProps } from './props';
+/** 将暗色状态同步到 html[dark] attribute */
+declare function applyDarkAttr(isDark: boolean): void;
+export declare function useDarkMode(props: DarkModeProps, ctx: {
+    emit: (event: string, ...args: any[]) => void;
+}): {
+    isDark: any;
+    toggle: () => void;
+    applyDarkAttr: typeof applyDarkAttr;
+};
+export {};

package/dist/components/template/border/api.d.ts

@@ -0,0 +1,3 @@
+import { MCOPO } from '../../types/props';
+import { BorderProps } from './props';
+export declare const props: MCOPO<BorderProps>;

package/dist/components/template/border/index.d.ts

@@ -0,0 +1,4 @@
+export declare const BorderCore: {
+    props: import('../../types/props').MCOPO<import('./props').BorderProps>;
+};
+export type { BorderProps } from './props';

package/dist/components/template/breadcrumb/api.d.ts

@@ -0,0 +1,3 @@
+import { MCOPO } from '../../types/props';
+import { BreadcrumbProps } from './props';
+export declare const props: MCOPO<BreadcrumbProps>;

package/dist/components/template/breadcrumb/index.d.ts

@@ -0,0 +1,4 @@
+export declare const BreadcrumbCore: {
+    props: import('../../types/props').MCOPO<import('./props').BreadcrumbProps>;
+};
+export type { BreadcrumbProps, BreadcrumbItemOption } from './props';

package/dist/components/template/descriptions/api.d.ts

@@ -0,0 +1,4 @@
+import { MCOPO } from '../../types/props';
+import { DescriptionsProps, DescriptionsItemProps } from './props';
+export declare const descriptionsProps: MCOPO<DescriptionsProps>;
+export declare const descriptionsItemProps: MCOPO<DescriptionsItemProps>;

package/dist/components/template/descriptions/index.d.ts

@@ -0,0 +1,5 @@
+export declare const DescriptionsCore: {
+    descriptionsProps: import('../../types/props').MCOPO<import('./props').DescriptionsProps>;
+    descriptionsItemProps: import('../../types/props').MCOPO<import('./props').DescriptionsItemProps>;
+};
+export type { DescriptionsProps, DescriptionsItemProps } from './props';

package/dist/components/template/form/api.d.ts

@@ -0,0 +1,4 @@
+import { MCOPO } from '../../types/props';
+import { FormProps, FormItemProps } from './props';
+export declare const formProps: MCOPO<FormProps>;
+export declare const formItemProps: MCOPO<FormItemProps>;

package/dist/components/template/form/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * FormCore 使用包装对象导出，避免 formProps / formItemProps 两个 props 名称与其他组件冲突。
+ * headless / lib 均通过解构 FormCore 取用。
+ */
+export declare const FormCore: {
+    props: import('../../types/props').MCOPO<import('./props').FormProps>;
+    formItemProps: import('../../types/props').MCOPO<import('./props').FormItemProps>;
+};
+export type { FormProps, FormItemProps } from './props';

package/dist/components/template/grid/api.d.ts

@@ -0,0 +1,3 @@
+import { MCOPO } from '../../types/props';
+import { GridProps } from './props';
+export declare const props: MCOPO<GridProps>;

package/dist/components/template/grid/index.d.ts

@@ -0,0 +1,4 @@
+export declare const GridCore: {
+    props: import('../../types/props').MCOPO<import('./props').GridProps>;
+};
+export type { GridProps } from './props';

package/dist/components/template/menu/api.d.ts

@@ -0,0 +1,8 @@
+import { MCOPO } from '../../types/props';
+import { MenuProps } from './props';
+export declare const DEFAULT_MENU_CONFIG: {
+    key: string;
+    label: string;
+    children: string;
+};
+export declare const props: MCOPO<MenuProps>;

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

@@ -0,0 +1,9 @@
+import { DEFAULT_MENU_CONFIG } from './api';
+import { useMenu } from './useMenu';
+export declare const MenuCore: {
+    props: import('../../types/props').MCOPO<import('./props').MenuProps>;
+    useMenu: typeof useMenu;
+};
+export { DEFAULT_MENU_CONFIG };
+export { useMenu } from './useMenu';
+export type { MenuProps, MenuData, MenuNodeData, MenuConfig } from './props';

package/dist/components/template/menu/useMenu.d.ts

@@ -0,0 +1,12 @@
+import { MenuData, MenuNodeData, MenuConfig, MenuProps } from './props';
+export declare function useMenu(props: MenuProps, emit?: (event: string, ...args: unknown[]) => void): {
+    nodesRef: ShallowRef<MenuNodeData[]>;
+    nodeMap: Map<string | number, MenuNodeData>;
+    initNodes: (data?: MenuData[]) => void;
+    toggleExpand: (node: MenuNodeData) => void;
+    setActive: (node: MenuNodeData) => void;
+    toggleChecked: (node: MenuNodeData, checked: boolean) => void;
+    getCheckedKeys: () => (string | number)[];
+    getNodesByKeys: (keys: (string | number)[]) => MenuNodeData[];
+    config: MenuConfig;
+};

package/dist/components/template/pagination/api.d.ts

@@ -0,0 +1,3 @@
+import { MCOPO } from '../../types/props';
+import { PaginationProps } from './props';
+export declare const props: MCOPO<PaginationProps>;

package/dist/components/template/pagination/index.d.ts

@@ -0,0 +1,7 @@
+import { usePagination } from './usePagination';
+export declare const PaginationCore: {
+    props: import('../../types/props').MCOPO<import('./props').PaginationProps>;
+    usePagination: typeof usePagination;
+};
+export type { PaginationProps } from './props';
+export { usePagination, type Pager } from './usePagination';

package/dist/components/template/pagination/usePagination.d.ts

@@ -0,0 +1,27 @@
+import { Ref } from 'vue';
+import { PaginationProps } from './props';
+/**
+ * 页码按钮描述类型
+ * - type 为 'number' 时表示普通页码按钮
+ * - type 为 'folded' 时表示折叠省略号，jump 为点击后跳转的目标页
+ */
+export type Pager = {
+    value: number;
+    type: 'number';
+    isCurrent: boolean;
+    jump?: number;
+} | {
+    value: string;
+    type: 'folded';
+    isCurrent: false;
+    jump: number;
+};
+/**
+ * 分页核心 hook
+ * @param props 分页组件 props（需包含 total / pageSize / foldedMaxPageBtn / maxPageBtn / showEdgePageNum）
+ * @param currentValue 当前页的响应式引用，由调用方维护
+ */
+export declare function usePagination(props: PaginationProps, currentValue: Ref<number>): {
+    getPageNumList: () => Pager[];
+    getPageBtnLength: () => number;
+};

package/dist/components/template/table/api.d.ts

@@ -0,0 +1,3 @@
+import { MCOPO } from '../../types/props';
+import { TableProps } from './props';
+export declare const props: MCOPO<TableProps>;

package/dist/components/template/table/index.d.ts

@@ -0,0 +1,7 @@
+import { useTable } from './useTable';
+export declare const TableCore: {
+    props: import('../../types/props').MCOPO<import('./props').TableProps>;
+    useTable: typeof useTable;
+};
+export type { TableProps } from './props';
+export { useTable } from './useTable';

package/dist/components/template/table/useTable.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @description core table hook
+ * @author 阿怪
+ * @date 2026/2/25
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export declare function useTable(): {
+    initTable: <T>(renders: {
+        /** 数据为空时渲染的内容 */
+        empty: T;
+        /** 渲染单个 td 单元格 */
+        tbodyTr: (option: {
+            data: any | string;
+            param: string;
+            slot?: any;
+            style?: {
+                width?: string;
+            } | undefined;
+            slotInfo?: {
+                data: any;
+                index: number;
+            };
+        }) => T;
+        /** 渲染单个 th 表头单元格 */
+        theadTh: (option: {
+            param?: string;
+            label?: string;
+            slot?: any;
+            style?: {
+                width?: string;
+            } | undefined;
+        }) => T;
+        /** 渲染整个 thead */
+        thead: (ths: T[]) => T;
+        /** 渲染整个 tbody */
+        tbody: (trs: T[]) => T;
+        /** 渲染单行 tr */
+        tbodyTrs: (tds: T[], i: number) => T;
+        /** 从 tableColumn VNode 中提取 body/head 插槽 */
+        initSlot: (tableColumn: any) => {
+            body: any;
+            head: any;
+        } | undefined;
+    }, columns: Array<any>, data: any[]) => {
+        thead: T;
+        tbody: T;
+    };
+    error: (msg: string) => void;
+};

package/dist/components/template/tableColumn/api.d.ts

@@ -0,0 +1,3 @@
+import { MCOPO } from '../../types/props';
+import { TableColumnProps } from './props';
+export declare const props: MCOPO<TableColumnProps>;

package/dist/components/template/tableColumn/index.d.ts

@@ -0,0 +1,4 @@
+export declare const TableColumnCore: {
+    props: import('../../types/props').MCOPO<import('./props').TableColumnProps>;
+};
+export type { TableColumnProps } from './props';

package/dist/components/template/virtualList/api.d.ts

@@ -0,0 +1,3 @@
+import { MCOPO } from '../../types/props';
+import { VirtualListProps } from './props';
+export declare const props: MCOPO<VirtualListProps>;

package/dist/components/template/virtualList/index.d.ts

@@ -0,0 +1,7 @@
+import { useVirtualList } from './useVirtualList';
+export declare const VirtualListCore: {
+    props: import('../../types/props').MCOPO<import('./props').VirtualListProps>;
+    useVirtualList: typeof useVirtualList;
+};
+export type { VirtualListProps } from './props';
+export { useVirtualList } from './useVirtualList';

package/dist/components/template/virtualList/useVirtualList.d.ts

@@ -0,0 +1,15 @@
+import { VirtualListProps } from './props';
+export interface UseVirtualListOptions<T> {
+    props: VirtualListProps<T>;
+    /** 触底事件 */
+    onReachBottom?: () => void;
+}
+export declare function useVirtualList<T>(options: UseVirtualListOptions<T>): {
+    displayList: any;
+    containerRef: any;
+    wrapperRef: any;
+    topSentinelRef: any;
+    bottomSentinelRef: any;
+    totalHeight: any;
+    offsetY: any;
+};

package/dist/compositions/common/defineCore.d.ts

@@ -0,0 +1,25 @@
+import { Ref } from 'vue';
+type OptionsEmpty = undefined;
+type IsAllUndefined<T extends any[]> = T extends [infer H, ...infer R] ? H extends undefined ? IsAllUndefined<R> : false : true;
+interface OptionsNotEmpty<P, V, E> {
+    props: Required<P>;
+    value: {
+        [K in keyof V]: Ref<V[K]>;
+    };
+    event: E;
+}
+type CoreArguments = keyof OptionsNotEmpty<any, any, any>;
+type AnyArguments = {
+    [K in CoreArguments]?: any;
+};
+type DefinedKeys<T extends AnyArguments> = {
+    [K in keyof T]: T[K] extends undefined ? never : K;
+}[keyof T];
+type UndefinedKeys<T extends AnyArguments> = Exclude<keyof CoreArguments, DefinedKeys<T>>;
+export type OptionsKeys<A extends AnyArguments, P, V, E, DK extends string | number | symbol = DefinedKeys<A>, UK extends string | number | symbol = UndefinedKeys<A>> = {
+    [K in DK & keyof OptionsNotEmpty<P, V, E>]: OptionsNotEmpty<P, V, E>[K];
+} & {
+    [K in UK & keyof OptionsNotEmpty<P, V, E>]-?: OptionsNotEmpty<P, V, E>[K];
+};
+export type Options<K extends AnyArguments, P = K['props'], V = K['value'], E = K['event']> = IsAllUndefined<[P, V, E]> extends true ? OptionsEmpty : OptionsKeys<K, P, V, E>;
+export {};

package/dist/compositions/common/useDebounceFn.d.ts

@@ -0,0 +1,12 @@
+import { DebounceFilterOptions, FunctionArgs } from '../utils/filters';
+/**
+ * Debounce execution of a function.
+ *
+ * @see https://vueuse.org/useDebounceFn
+ * @param  fn          A function to be executed after delay milliseconds debounced.
+ * @param  ms          A zero-or-greater delay in milliseconds. For event callbacks, values around 100 or 250 (or even higher) are most useful.
+ * @param  opts        options
+ *
+ * @return A new, debounce, function.
+ */
+export default function useDebounceFn<T extends FunctionArgs>(fn: T, ms?: number, options?: DebounceFilterOptions): T;

package/dist/compositions/common/useDrag.d.ts

@@ -0,0 +1,28 @@
+import { Ref } from 'vue';
+export type DragDirectionType = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'top-center' | string;
+export type InteractEvent = any;
+export type DragPosition = {
+    x: number;
+    y: number;
+};
+export type DragOption = {
+    startAxis: 'x' | 'y';
+    lockAxis: 'x' | 'y';
+};
+export default function useDrag(config: {
+    direction: DragDirectionType;
+    value?: {
+        domRef?: Ref<HTMLElement | null>;
+    };
+    event?: {
+        getOption?: () => DragOption;
+        movePositionHandler?: (event: InteractEvent, position: DragPosition) => DragPosition;
+        onDragLeave?: (event: InteractEvent) => void;
+    };
+}): {
+    domRef: any;
+    init: (basePosition?: {
+        x?: number;
+        y?: number;
+    }) => any;
+};

package/dist/compositions/common/useElementSize.d.ts

@@ -0,0 +1,5 @@
+import { Ref } from 'vue';
+export declare function useElementSize(target: Ref<HTMLElement | null>): {
+    w: any;
+    h: any;
+};

package/dist/compositions/common/useEventListener.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @description event listener hook
+ * @author 阿怪
+ * @date 2023/5/12 00:57
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export type EventListenerOptions = {
+    target: any;
+    event: string;
+    handler: EventListenerOrEventListenerObject;
+};
+export default function useEventListener(options: EventListenerOptions): {
+    add: () => void;
+    remove: () => void;
+    onMounted: () => void;
+    onBeforeDestroy: () => void;
+};

package/dist/compositions/common/usePopover.d.ts

@@ -0,0 +1,9 @@
+import { PopoverProps } from '../../components/message/popover/props';
+import { arrow, flip, offset, OffsetOptions, shift } from '@floating-ui/dom';
+export { flip, offset, shift, arrow, };
+export default function usePopover(props?: Partial<PopoverProps>, middleware?: {
+    offset?: OffsetOptions;
+    extends?: any[];
+}): {
+    popoverOptions: PopoverProps;
+};

package/dist/compositions/common/useResizeObserver.d.ts

@@ -0,0 +1,4 @@
+import { Ref } from 'vue';
+export declare function useResizeObserver(target: Ref<HTMLElement | null>, callback: ResizeObserverCallback, options?: ResizeObserverOptions): {
+    cleanup: () => void;
+};

package/dist/compositions/common/useTeleport.d.ts

@@ -0,0 +1,7 @@
+import { TeleportProps, VNode } from 'vue';
+import { MTeleportProps } from '../../types/common/common';
+export default function useTeleport(options: {
+    teleportProps?: MTeleportProps | true;
+    slot: VNode | VNode[];
+}): any;
+export declare const initTeleportOptions: (options: TeleportProps | true | undefined) => any;

package/dist/compositions/input/useBooleanInput.d.ts

@@ -0,0 +1,9 @@
+export declare const initChecked: (props: {
+    checked: boolean | null | undefined;
+    modelValue: any;
+    value: any;
+}) => boolean;
+export declare const getNewModelValue: (props: {
+    value: any;
+    modelValue?: any;
+}, checked: boolean) => any;

package/dist/compositions/modal/useModal.d.ts

@@ -0,0 +1,14 @@
+import { ModelMask } from '../../types/common/model';
+export interface UseModalProps {
+    visible?: boolean;
+    mask?: ModelMask;
+}
+export declare function useModal(props: UseModalProps, emit: (...args: any[]) => void): {
+    visible: any;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    onMaskClick: () => void;
+    showMask: () => boolean;
+    onContentClick: (e: MouseEvent) => void;
+};

package/dist/compositions/popper/useClickAway.d.ts

@@ -0,0 +1,9 @@
+export default function useClickAway(options: {
+    target: any;
+    handler: (event: any) => void;
+}): {
+    add: () => void;
+    remove: () => void;
+    onMounted: () => void;
+    onBeforeDestroy: () => void;
+} | undefined;

package/dist/compositions/popper/usePopper.d.ts

@@ -0,0 +1,19 @@
+import { ComputePositionConfig } from '@floating-ui/dom';
+export type Placement = 'top' | 'top-start' | 'top-end' | 'right' | 'right-start' | 'right-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end';
+export type PopperConfig = Partial<ComputePositionConfig>;
+type DomStyle = {
+    left: string;
+    top: string;
+    display: string;
+    position: string;
+};
+export type PositionStyle = {
+    style: DomStyle;
+    arrowStyle: DomStyle;
+    placement: Placement;
+};
+export declare const usePopper: (triggerNode: HTMLElement, popperNode: HTMLElement, update: (data: PositionStyle) => void, arrowNode?: HTMLElement, config?: PopperConfig) => {
+    getPositionStyle: () => Promise<PositionStyle>;
+    clear: () => void;
+};
+export {};