twcpt 0.0.28 → 0.0.29

package/dist/utils/getCssVarValue.d.ts

@@ -0,0 +1,29 @@
+/**
+ * getCssVarValue 配置项
+ * @example
+ * const color = getCssVarValue(['--j-color-white', '--el-color-white'], {
+ *   fallback: '#fff',
+ * });
+ *
+ * @example
+ * const spacing = getCssVarValue('--j-spacing-base', {
+ *   fallback: 16,
+ *   transform: (v) => Number.parseFloat(v),
+ * });
+ */
+export interface GetCssVarValueOptions<T = string> {
+    fallback?: T | string;
+    target?: HTMLElement | null;
+    trim?: boolean;
+    transform?: (value: string) => T;
+}
+/**
+ * 读取 CSS 变量值，支持多变量回退与结果转换
+ * @param variableName CSS 变量名（支持 '--token' 或 'token'），也支持变量名数组（按顺序回退）
+ * @param options 配置项
+ * @example
+ * import { getCssVarValue } from 'twcpt';
+ *
+ * const whiteColor = getCssVarValue('--j-color-white', { fallback: '#FFFFFF' });
+ */
+export declare function getCssVarValue<T = string>(variableName: string | string[], options?: GetCssVarValueOptions<T>): T | string;

package/dist/utils/img-load/index.d.ts

@@ -0,0 +1,2 @@
+export { preloadImage, hasPreloadedImage, clearPreloadedImageCache } from './preloadImage';
+export type { ImageLoadStatus, PreloadImageOptions, PreloadImageResult } from './preloadImage';

package/dist/utils/img-load/preloadImage.d.ts

@@ -0,0 +1,32 @@
+export type ImageLoadStatus = 'loaded' | 'placeholder' | 'error';
+export interface PreloadImageOptions {
+    placeholderSrc?: string;
+    errorSrc?: string;
+    timeout?: number;
+    crossOrigin?: '' | 'anonymous' | 'use-credentials';
+    referrerPolicy?: ReferrerPolicy;
+    decode?: boolean;
+    cache?: boolean;
+    force?: boolean;
+}
+export interface PreloadImageResult {
+    src: string;
+    displaySrc: string;
+    status: ImageLoadStatus;
+    fromCache: boolean;
+    img: HTMLImageElement | null;
+}
+/**
+ * 预加载图片并返回可直接用于 img 的 displaySrc（成功图 / 占位图 / 错误图）
+ * @example
+ * const result = await preloadImage('https://cdn.xxx.com/a.png', {
+ *   placeholderSrc: '/images/placeholder.png',
+ *   errorSrc: '/images/error.png',
+ *   timeout: 8000,
+ * });
+ *
+ * // result.displaySrc 可直接用于 <img :src="result.displaySrc" />
+ */
+export declare function preloadImage(src: string, options?: PreloadImageOptions): Promise<PreloadImageResult>;
+export declare function hasPreloadedImage(src: string): boolean;
+export declare function clearPreloadedImageCache(src?: string): void;

package/dist/utils/useIntervalPolling.d.ts

@@ -0,0 +1,13 @@
+export interface IntervalPollingOptions {
+    interval?: number;
+    immediate?: boolean;
+    onError?: (error: unknown) => void;
+    autoStopWhenHidden?: boolean;
+}
+export interface IntervalPollingController {
+    start: () => void;
+    stop: () => void;
+    isRunning: () => boolean;
+    updateInterval: (newInterval: number) => void;
+}
+export declare function useIntervalPolling(callback: () => any, options?: IntervalPollingOptions): IntervalPollingController;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twcpt",
-  "version": "0.0.28",
+  "version": "0.0.29",
   "description": "A Vue 3 component library built with Vite and TypeScript, featuring components integrated with Element-plus.",
   "main": "dist/twcpt.umd.js",
   "module": "dist/twcpt.es.js",