@kine-design/core 0.0.1-beta.1

package/dist/compositions/utils/filters.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @description event filter(防抖、节流)
+ * @author youus
+ * @date 2022/8/20 00:17
+ * @version v1.0.0
+ *
+ * Hello, humor
+ */
+export type FunctionArgs<Args extends any[] = any[], Return = void> = (...args: Args) => Return;
+export interface FunctionWrapperOptions<Args extends any[] = any[], This = any> {
+    fn: FunctionArgs<Args, This>;
+    args: Args;
+    thisArg: This;
+}
+export type EventFilter<Args extends any[] = any[], This = any> = (invoke: () => void, options: FunctionWrapperOptions<Args, This>) => void;
+export interface DebounceFilterOptions {
+    /**
+     * The maximum time allowed to be delayed before it's invoked.
+     * In milliseconds.
+     */
+    maxWait?: number;
+}
+/**
+ * @internal
+ */
+export declare function createFilterWrapper<T extends FunctionArgs>(filter: EventFilter, fn: T): T;
+/**
+ * Create an EventFilter that debounce the events
+ *
+ * @param ms
+ * @param options
+ */
+export declare function debounceFilter(ms: number, options?: DebounceFilterOptions): EventFilter<any[], any>;
+/**
+ * Create an EventFilter that throttle the events
+ *
+ * @param ms
+ * @param [trailing=true]
+ * @param [leading=true]
+ */
+export declare function throttleFilter(ms: number, trailing?: boolean, leading?: boolean): EventFilter<any[], any>;

package/dist/compositions/virtualList/enums.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @description 虚拟列表 action 枚举
+ * @author 阿怪
+ * @date 2026/2/25 13:30
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+/** 元素可见性变化的动作类型 */
+export declare enum ACTION {
+    /** 从顶部进入可视区域（开始露出） */
+    ENTER_TOP_START = 0,
+    /** 从顶部完全进入可视区域 */
+    ENTER_TOP_END = 1,
+    /** 从底部进入可视区域（开始露出） */
+    ENTER_BOTTOM_START = 2,
+    /** 从底部完全进入可视区域 */
+    ENTER_BOTTOM_END = 3,
+    /** 从顶部开始离开可视区域 */
+    LEAVE_TOP_START = 4,
+    /** 从顶部完全离开可视区域 */
+    LEAVE_TOP_END = 5,
+    /** 从底部开始离开可视区域 */
+    LEAVE_BOTTOM_START = 6,
+    /** 从底部完全离开可视区域 */
+    LEAVE_BOTTOM_END = 7,
+    /** 未知状态 */
+    UNKNOWN = 8
+}
+/** 元素相对于容器的位置类型 */
+export declare enum POSITION_TYPE {
+    /** 完全在可视区域上方 */
+    TOP = 0,
+    /** 部分在可视区域上方（上半部分露出） */
+    TOP_VISIBLE = 1,
+    /** 完全在可视区域内 */
+    VISIBLE = 2,
+    /** 部分在可视区域下方（下半部分露出） */
+    BOTTOM_VISIBLE = 3,
+    /** 完全在可视区域下方 */
+    BOTTOM = 4
+}
+/** 元素信息记录 */
+export type EntryInfo = {
+    ratio: number;
+    position: POSITION_TYPE;
+    realIndex: number;
+    translateY: number;
+};

package/dist/compositions/virtualList/useContainerObserver.d.ts

@@ -0,0 +1,9 @@
+import { Ref } from 'vue';
+export default function useContainerObserver(options: {
+    containerRef: Ref<HTMLElement | null>;
+    threshold?: number | number[];
+    getTarget: () => ArrayLike<Element>;
+    callback: (entries: IntersectionObserverEntry[], observer: IntersectionObserver) => void;
+}): {
+    reObserve: (target: ArrayLike<Element>) => void;
+};

package/dist/compositions/virtualList/useEntries.d.ts

@@ -0,0 +1,29 @@
+import { Ref } from 'vue';
+export interface UseEntriesOptions {
+    /** 获取列表子元素 */
+    getChildren: () => ArrayLike<Element>;
+    /** 获取当前可见数量 */
+    getVisibleCount: () => number;
+    /** 从指定位置重新渲染列表 */
+    getList: (from: number) => void;
+    /** 获取当前渲染边界信息 */
+    getInfo: () => {
+        renderFrom: number;
+        realFrom: number;
+        realEnd: number;
+        renderEnd: number;
+    };
+    /** 设置可见数量 */
+    setVisibleCount: (count: number) => void;
+    /** 获取总数 */
+    getTotal: () => number;
+    /** 触底回调 */
+    reachBottom: () => void;
+    /** translateY 样式 ref */
+    styleRef: Ref<{
+        transform: string;
+    }>;
+}
+export default function useEntries(options: UseEntriesOptions): {
+    cb: (entries: IntersectionObserverEntry[], _observer: IntersectionObserver) => void;
+};

package/dist/compositions/virtualList/useHeightCache.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @description 虚拟列表高度缓存
+ * @author 阿怪
+ * @date 2026/2/25 14:00
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ *
+ * 管理每个列表项的高度缓存，支持预估高度和实际高度
+ * 提供基于 scrollTop 的二分查找定位
+ */
+export interface HeightCache {
+    /** 更新指定索引的实际高度 */
+    update: (index: number, height: number) => void;
+    /** 获取指定索引的高度（实际或预估） */
+    getHeight: (index: number) => number;
+    /** 获取 [0, index) 的累计高度（即第 index 项的顶部偏移） */
+    getOffset: (index: number) => number;
+    /** 获取所有项的总高度 */
+    getTotalHeight: () => number;
+    /** 根据 scrollTop 二分查找对应的起始索引 */
+    findIndex: (scrollTop: number) => number;
+    /** 重置缓存（列表数据变化时） */
+    reset: (total: number) => void;
+}
+export declare function createHeightCache(total: number, estimatedHeight: number): HeightCache;

package/dist/compositions/virtualList/useSentinelObserver.d.ts

@@ -0,0 +1,14 @@
+import { Ref } from 'vue';
+export interface SentinelObserverOptions {
+    containerRef: Ref<HTMLElement | null>;
+    topSentinelRef: Ref<HTMLElement | null>;
+    bottomSentinelRef: Ref<HTMLElement | null>;
+    /** 需要更新可视列表时调用 */
+    onUpdate: () => void;
+    /** 底部哨兵完全进入可视区（触底） */
+    onReachBottom?: () => void;
+}
+export declare function useSentinelObserver(options: SentinelObserverOptions): {
+    reobserve: () => void;
+    cleanup: () => void;
+};