pxd 0.0.61 → 0.0.62

package/dist/utils/ref.d.ts

@@ -1,5 +1,5 @@
-import type { MaybeElement } from '../types/shared/utils';
+import type { MaybeElement, Nullable } from '../types/shared/utils';
 import type { ComponentPublicInstance, MaybeRefOrGetter } from 'vue';
 export type UnRefElementReturn<T extends MaybeElement = MaybeElement> = T extends ComponentPublicInstance ? Exclude<MaybeElement, ComponentPublicInstance> : T | undefined;
 export declare function toValue<T>(source: MaybeRefOrGetter<T>): T;
-export declare function unrefElement<T extends MaybeElement>(elRef: MaybeRefOrGetter<T>): UnRefElementReturn<T>;
+export declare function unrefElement<T extends MaybeElement>(elRef: MaybeRefOrGetter<Nullable<T>>): UnRefElementReturn<Nullable<T>>;

package/dist/utils/{throttle.d.ts → timing.d.ts}

@@ -1,4 +1,5 @@
 import type { Callback } from '../types/shared';
+export { debounce } from 'es-toolkit/function';
 export { throttle } from 'es-toolkit/function';
 interface ThrottleByRafReturnType<T extends Callback> {
     (...args: Parameters<T>): void;

package/dist/utils/{throttle.js → timing.js}

@@ -1,3 +1,5 @@
+import { raf, caf } from "./event.js";
+export { debounce } from "es-toolkit/function";
 export { throttle } from "es-toolkit/function";
 export function throttleByRaf(callback) {
   let animationFrameId = 0;
@@ -5,14 +7,14 @@ export function throttleByRaf(callback) {
     if (animationFrameId) {
       return;
     }
-    animationFrameId = window.requestAnimationFrame(() => {
+    animationFrameId = raf(() => {
       animationFrameId = 0;
       callback(...args);
     });
   };
   throttle2.cancel = () => {
     if (animationFrameId) {
-      window.cancelAnimationFrame(animationFrameId);
+      caf(animationFrameId);
       animationFrameId = 0;
     }
   };

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "pxd",
-  "version": "0.0.61",
+  "version": "0.0.62",
   "description": "A Vue 2.7 & 3.2 universal component library. Built-in light/dark theme. PC & mobile ready. Animation-free mode supported.",
   "keywords": [
-    "component library",
-    "components",
-    "pxd",
+    "component-library",
+    "dark-mode",
+    "design-system",
+    "responsive",
+    "tailwind",
+    "typescript",
     "ui",
-    "ui framework",
     "vue",
+    "vue-components",
     "vue2",
     "vue3"
   ],
@@ -92,69 +95,70 @@
       "default": "./dist/utils/*.js"
     }
   },
+  "scripts": {
+    "dev": "run-s dev:lib dev:docs",
+    "dev:lib": "unbuild --stub",
+    "dev:docs": "pnpm --filter docs dev",
+    "build": "vp run build:core && vp run build:docs",
+    "build:lib": "vp run build:core && vp run gen-tw-css-file",
+    "build:only": "vp run build:core && vp run build:docs",
+    "build:style": "vp run gen-tw-css-file",
+    "lint": "git diff --staged --name-only --diff-filter=ACMR| xargs -r vp lint",
+    "lint:all": "vp lint",
+    "lint:changed": "git diff --name-only --relative --diff-filter=ACMR origin/main ... HEAD | xargs -r vp lint",
+    "lint:fix": "vp lint --fix",
+    "fmt": "git diff --staged --name-only --diff-filter=ACMR| xargs -r vp fmt",
+    "fmt:all": "vp fmt",
+    "fmt:changed": "git diff --name-only --relative --diff-filter=ACMR origin/main ... HEAD | xargs -r vp fmt",
+    "fmt:check": "vp fmt --check",
+    "test": "vp test run",
+    "test:watch": "vp test",
+    "bump": "pnpx bumpp",
+    "preview": "pnpm --filter docs preview",
+    "postversion": "vp run gen-volar-dts && vp run update-exports",
+    "prepublishOnly": "run-s build:lib"
+  },
   "dependencies": {
-    "@floating-ui/dom": "^1.7.6",
-    "@gdsicon/vue": "^1.0.8",
-    "@tanstack/virtual-core": "^3.13.22",
-    "dayjs": "^1.11.20",
-    "es-toolkit": "^1.45.1",
-    "focus-trap": "^8.0.0",
-    "tailwind-merge": "^3.5.0",
-    "tailwind-variants": "^3.2.2"
+    "@any-touch/core": "catalog:default",
+    "@any-touch/pan": "catalog:default",
+    "@chenglou/pretext": "catalog:default",
+    "@floating-ui/dom": "catalog:default",
+    "@gdsicon/vue": "catalog:default",
+    "@tanstack/virtual-core": "catalog:default",
+    "dayjs": "catalog:default",
+    "es-toolkit": "catalog:default",
+    "focus-trap": "catalog:default",
+    "tailwind-merge": "catalog:default",
+    "tailwind-variants": "catalog:default"
   },
   "devDependencies": {
-    "@tailwindcss/cli": "^4.2.1",
-    "@tsconfig/node22": "^22.0.5",
-    "@types/node": "^25.5.0",
-    "@vitejs/plugin-vue": "^6.0.5",
-    "@vue/test-utils": "^2.4.6",
-    "@vue/tsconfig": "^0.9.0",
-    "eslint-plugin-better-tailwindcss": "^4.3.2",
-    "fs-extra": "^11.3.4",
-    "happy-dom": "^20.8.4",
-    "husky": "^9.1.7",
-    "lint-staged": "^16.4.0",
-    "mkdist": "^2.4.1",
-    "npm-run-all2": "^8.0.4",
-    "oxfmt": "^0.40.0",
-    "oxlint": "^1.55.0",
-    "tinyglobby": "^0.2.15",
-    "typescript": "^5.9.3",
-    "unbuild": "^3.6.1",
-    "unplugin-vue-components": "^31.0.0",
-    "vitest": "^4.1.0",
-    "vue": "^3.5.30",
-    "vue-sfc-transformer": "^0.1.17",
-    "vue-tsc": "^3.2.5"
+    "@tailwindcss/cli": "catalog:default",
+    "@tsconfig/node22": "catalog:default",
+    "@types/node": "catalog:default",
+    "@vitejs/plugin-vue": "catalog:default",
+    "@vue/test-utils": "catalog:default",
+    "@vue/tsconfig": "catalog:default",
+    "eslint-plugin-better-tailwindcss": "catalog:default",
+    "fs-extra": "catalog:default",
+    "happy-dom": "catalog:default",
+    "mkdist": "catalog:default",
+    "npm-run-all2": "catalog:default",
+    "tinyglobby": "catalog:default",
+    "typescript": "catalog:default",
+    "unbuild": "catalog:default",
+    "unplugin-vue-components": "catalog:default",
+    "vite-plus": "catalog:",
+    "vue": "catalog:default",
+    "vue-sfc-transformer": "catalog:default",
+    "vue-tsc": "catalog:default"
   },
   "peerDependencies": {
     "vue": ">=2.7.0 || >=3.2.0"
   },
-  "lint-staged": {
-    "*.{ts,vue}": "oxfmt && oxlint"
-  },
-  "scripts": {
-    "dev": "run-s dev:lib dev:docs",
-    "dev:lib": "unbuild --stub",
-    "dev:docs": "pnpm --filter docs dev",
-    "build": "run-s update-exports build:core build:docs",
-    "build:lib": "run-s update-exports build:core build:style",
-    "build:core": "mkdist -d --src=src --ext=js --format=esm",
-    "build:only": "run-s build:core build:docs",
-    "build:docs": "pnpm --filter docs build",
-    "build:style": "run-s gen-styles-file gen-tw-css-file",
-    "update-exports": "node scripts/update-exports.js",
-    "gen-styles-file": "node scripts/gen-css-files.js",
-    "gen-tw-css-file": "tailwindcss -i ./dist/styles/source.css -o ./dist/styles/styles.css -m",
-    "gen-volar-dts": "node scripts/gen-component-dts.js",
-    "lint": "oxlint",
-    "lint:fix": "oxlint --fix",
-    "fmt": "oxfmt",
-    "fmt:check": "oxfmt --check",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "vue-tsc -p tsconfig.app.json --noEmit",
-    "bump": "pnpx bumpp",
-    "postversion": "run-s gen-volar-dts update-exports"
+  "packageManager": "pnpm@10.33.2",
+  "pnpm": {
+    "patchedDependencies": {
+      "mkdist": "patches/mkdist.patch"
+    }
   }
-}
+}

package/volar.d.ts

@@ -10,7 +10,9 @@ declare module 'vue' {
     PBadge: (typeof import('pxd/components/badge'))['default']
     PBook: (typeof import('pxd/components/book'))['default']
     PBrowser: (typeof import('pxd/components/browser'))['default']
+    PBubble: (typeof import('pxd/components/bubble'))['default']
     PButton: (typeof import('pxd/components/button'))['default']
+    PButtonGroup: (typeof import('pxd/components/button-group'))['default']
     PCarousel: (typeof import('pxd/components/carousel'))['default']
     PCarouselItem: (typeof import('pxd/components/carousel-item'))['default']
     PCheckbox: (typeof import('pxd/components/checkbox'))['default']
@@ -20,6 +22,7 @@ declare module 'vue' {
     PChoiceboxItem: (typeof import('pxd/components/choicebox-item'))['default']
     PCollapse: (typeof import('pxd/components/collapse'))['default']
     PCollapseGroup: (typeof import('pxd/components/collapse-group'))['default']
+    PColorSelector: (typeof import('pxd/components/color-selector'))['default']
     PCommandMenu: (typeof import('pxd/components/command-menu'))['default']
     PCommandMenuGroup: (typeof import('pxd/components/command-menu-group'))['default']
     PConfigProvider: (typeof import('pxd/components/config-provider'))['default']
@@ -65,7 +68,9 @@ declare module 'vue' {
     PResizable: (typeof import('pxd/components/resizable'))['default']
     PResizableHandle: (typeof import('pxd/components/resizable-handle'))['default']
     PResizablePanel: (typeof import('pxd/components/resizable-panel'))['default']
+    PScalableText: (typeof import('pxd/components/scalable-text'))['default']
     PScrollable: (typeof import('pxd/components/scrollable'))['default']
+    PSeparator: (typeof import('pxd/components/separator'))['default']
     PSkeleton: (typeof import('pxd/components/skeleton'))['default']
     PSlider: (typeof import('pxd/components/slider'))['default']
     PSnippet: (typeof import('pxd/components/snippet'))['default']
@@ -74,6 +79,8 @@ declare module 'vue' {
     PStatusDot: (typeof import('pxd/components/status-dot'))['default']
     PSwitch: (typeof import('pxd/components/switch'))['default']
     PSwitchItem: (typeof import('pxd/components/switch-item'))['default']
+    PTabs: (typeof import('pxd/components/tabs'))['default']
+    PTabsItem: (typeof import('pxd/components/tabs-item'))['default']
     PTeleport: (typeof import('pxd/components/teleport'))['default']
     PText: (typeof import('pxd/components/text'))['default']
     PTextarea: (typeof import('pxd/components/textarea'))['default']

package/dist/components/overlay/overlay-stack.d.ts

@@ -1,3 +0,0 @@
-export declare function pushOverlay(id: symbol): void;
-export declare function removeOverlay(id: symbol): void;
-export declare function isTopOverlay(id: symbol): boolean;

package/dist/components/overlay/overlay-stack.js

@@ -1,17 +0,0 @@
-const overlayStack = [];
-export function pushOverlay(id) {
-  const idx = overlayStack.indexOf(id);
-  if (idx !== -1) {
-    overlayStack.splice(idx, 1);
-  }
-  overlayStack.push(id);
-}
-export function removeOverlay(id) {
-  const idx = overlayStack.indexOf(id);
-  if (idx !== -1) {
-    overlayStack.splice(idx, 1);
-  }
-}
-export function isTopOverlay(id) {
-  return overlayStack[overlayStack.length - 1] === id;
-}

package/dist/composables/use-pointer-gesture.d.ts

@@ -1,180 +0,0 @@
-import type { MaybeElementRef } from '../types/shared/utils';
-type Axis = 'x' | 'y' | 'both';
-type Dir = 'left' | 'right' | 'up' | 'down' | null;
-/**
- * 速度向量。
- * @property x - X 方向速度（px/s）
- * @property y - Y 方向速度（px/s）
- * @property v - 合速度（px/s）
- */
-interface Velocity {
-    x: number;
-    y: number;
-    v: number;
-}
-/**
- * 对外公开的手势状态。
- * @property isActive - 指针是否按下激活
- * @property isDragging - 是否处于拖拽中（超过启动阈值）
- * @property isLongPressing - 是否处于长按态
- * @property direction - 当前判定的方向（可能为 null）
- * @property delta - 自按下以来位移（px）
- * @property velocity - 当前速度（px/s）
- * @property progress - 触发进度（0~1，基于 triggerThreshold）
- */
-export interface PublicState {
-    isActive: boolean;
-    isDragging: boolean;
-    isLongPressing: boolean;
-    direction: Dir;
-    delta: {
-        x: number;
-        y: number;
-    };
-    velocity: Velocity;
-    progress: number;
-}
-/**
- * usePointerGesture 的可配置项。
- * 如未指定，均有默认值（见 OPTIONS_DEFAULTS）。
- */
-export interface UsePointerGestureOptions {
-    /**
-     * 限制生效轴向。
-     * 返回 'x' | 'y' | 'both'，默认为 'both'。
-     */
-    axis?: () => Axis;
-    /**
-     * 拖拽启动阈值（px）。手指移动距离超过该值后进入拖拽。
-     * 默认 6。
-     */
-    startThreshold?: number;
-    /**
-     * 触发阈值（px）。释放时若位移达到该值视为命中触发（kind='threshold'）。
-     * 默认 80。
-     */
-    triggerThreshold?: number;
-    /**
-     * 甩动触发速度阈值（px/s）。移动中若合速度超过该值将记录可能触发为 'fling'。
-     * 默认 1000。
-     */
-    velocityThreshold?: number;
-    /**
-     * 长按判定时长（ms）。到达该时长后进入长按态并触发 onLongPress。
-     * 默认 300。
-     */
-    longPressMs?: number;
-    /**
-     * 长按容忍移动距离（px）。在进入拖拽前，若移动超过该距离则取消长按。
-     * 默认 4。
-     */
-    longPressMoveTolerance?: number;
-    /**
-     * 是否在拖拽开始时锁定轴向。开启后根据初始位移较大方向锁定为 'x' 或 'y'。
-     * 默认 true。
-     */
-    lockDirectionOnStart?: boolean;
-    /**
-     * 是否允许在可滚动容器尚可继续滚动时将移动交由滚动，直到触达边缘才接管拖拽。
-     * 默认 true。
-     */
-    allowScrollUntilEdge?: boolean;
-    /**
-     * 拖拽期间是否调用 preventDefault 阻止滚动。
-     * 默认 true。
-     */
-    preventScrollOnDrag?: boolean;
-    /**
-     * 是否使用 Pointer Capture（setPointerCapture/releasePointerCapture）。
-     * 默认 true。
-     */
-    usePointerCapture?: boolean;
-    /**
-     * RTL 支持：
-     * - 若为 boolean，true 表示水平方向取反（dx>0 视为向左）；false 为自然方向
-     * - 若为函数，可根据 dx 自定义返回 'left' 或 'right'
-     * 默认 false。
-     */
-    rtl?: boolean | ((dx: number) => 'left' | 'right');
-    /**
-     * 提供一个返回可参与滚动判断的元素（通常为最近滚动容器内的滚动元素）。
-     * 若不提供，将自动查找。
-     */
-    getScrollable?: () => HTMLElement | null;
-    /**
-     * 指针按下时回调。
-     * @param e - PointerEvent
-     * @param ctx - 当前公开状态
-     */
-    onStart?: (e: PointerEvent, ctx: PublicState) => void;
-    /**
-     * 指针移动时回调（拖拽中会持续触发，可用于执行动画）。
-     * @param e - PointerEvent
-     * @param ctx - 当前公开状态
-     */
-    onMove?: (e: PointerEvent, ctx: PublicState) => void;
-    /**
-     * 指针释放时统一回调。
-     * - 命中触发条件时：hit=true，并给出方向 dir 与触发类型 kind（'threshold' | 'longpress' | 'fling'）
-     * - 未命中时：hit=false，dir=null，kind=null；此时会自动调用 onReset 便于复位动画
-     * @param hit - 是否命中触发
-     * @param dir - 方向（未命中为 null）
-     * @param kind - 触发类型（未命中为 null）
-     * @param ctx - 当前公开状态
-     */
-    onRelease?: (hit: boolean, dir: Dir, kind: null | 'threshold' | 'longpress' | 'fling', ctx: PublicState) => void;
-    /**
-     * 指针生命周期结束时回调（在 onRelease 之前调用）。
-     * @param e - PointerEvent
-     * @param ctx - 当前公开状态
-     */
-    onEnd?: (e: PointerEvent, ctx: PublicState) => void;
-    /**
-     * 手势被取消时回调（如 pointercancel 或主动 cancel）。
-     * @param e - 事件对象；由 cancel() 触发时为 null
-     * @param ctx - 当前公开状态
-     */
-    onCancel?: (e: Event | null, ctx: PublicState) => void;
-    /**
-     * 复位回调：取消或未命中触发条件时会自动调用，便于执行复位动画。
-     * @param ctx - 当前公开状态
-     */
-    onReset?: (ctx: PublicState) => void;
-    /**
-     * 长按回调：达到长按时长后触发。
-     * @param ctx - 当前公开状态
-     */
-    onLongPress?: (ctx: PublicState) => void;
-    /**
-     * 指针守卫：记录后续是否需要响应事件, 只在 pointer-down 中执行一次
-     * 返回 true 表示允许，false 表示阻止触发。
-     * @param e - PointerEvent
-     */
-    pointerGuard?: (e: PointerEvent) => boolean;
-    /**
-     * 方向守卫：在记录触发与最终释放判定处均会调用，用于限制允许的触发方向。
-     * 返回 true 表示允许，false 表示阻止触发。
-     * @param dir - 非空方向
-     * @param ctx - 当前公开状态
-     */
-    directionGuard?: (dir: Exclude<Dir, null>, ctx: PublicState) => boolean;
-}
-export declare function usePointerGesture(container: MaybeElementRef<HTMLElement>, options?: UsePointerGestureOptions): {
-    isActive: import("vue").ShallowRef<boolean, boolean>;
-    isDragging: import("vue").ShallowRef<boolean, boolean>;
-    isLongPressing: import("vue").ShallowRef<boolean, boolean>;
-    direction: import("vue").ShallowRef<Dir, Dir>;
-    delta: import("vue").ShallowRef<{
-        x: number;
-        y: number;
-    }, {
-        x: number;
-        y: number;
-    }>;
-    velocity: import("vue").ShallowRef<Velocity, Velocity>;
-    progress: import("vue").ShallowRef<number, number>;
-    reset: () => void;
-    cancel: () => void;
-    stop: () => void;
-};
-export {};