@x1a0ma17x/zeppos-fx 2.1.0 → 2.1.1

package/README_zh-CN.md

@@ -90,42 +90,6 @@ Page({
 });
 ```
 
-## 开发
-
-### 安装依赖
-
-```bash
-pnpm install
-```
-
-### 构建
-
-```bash
-pnpm build
-```
-
-### 创建本地调试环境
-
-```bash
-npm link
-```
-
-### 导入本地调试包
-
-在`example`目录中，执行以下命令来导入本地调试包
-
-```bash
-npm link @x1a0ma17x/zeppos-fx
-```
-
-### 解除本地调试包
-
-在`example`目录中，执行以下命令来解除本地调试包
-
-```bash
-npm unlink @x1a0ma17x/zeppos-fx
-```
-
 ## Roadmap
 
 - [ ] 动态兼容 ZeppOS API

package/dist/fx.d.ts

@@ -0,0 +1,163 @@
+/**
+ * fx.ts
+ * @description 一个用于在ZeppOS中提供简单动画的库
+ * @author XiaomaiTX
+ * @license MIT
+ * @repository https://github.com/XiaomaiTX/zeppos-fx
+ */
+/**
+ * 动画选项接口
+ */
+export interface FxOptions {
+    delay?: number;
+    begin?: number;
+    end?: number;
+    x_start?: number;
+    x_end?: number;
+    time?: number;
+    fx?: (x: number) => number;
+    func: (value: number) => void;
+    fps?: number;
+    enabled?: boolean;
+    style?: number;
+    onStop?: () => void;
+}
+/**
+ *边框 接口
+ */
+export interface Border {
+    x?: number;
+    y?: number;
+    w?: number;
+    h?: number;
+    radius?: number;
+}
+/**
+ * 动画类 (Fx)
+ *
+ * 一个用于在 ZeppOS 中创建平滑动画的类，支持多种缓动函数和动画样式。
+ * 提供开始、停止、暂停、恢复等控制方法，以及颜色混合、边框计算等静态工具函数。
+ *
+ * @example
+ * // 创建动画实例
+ * const fx = new Fx({
+ *   begin: 0,
+ *   end: 100,
+ *   time: 1000,
+ *   func: (value) => console.log(value),
+ *   style: Fx.Styles.LINEAR
+ * });
+ * fx.start();
+ *
+ * @see {@link FxOptions} 配置选项
+ * @see {@link Fx.Styles} 动画样式枚举
+ * @see {@link Fx.Easing} 缓动函数集合
+ */
+export declare class Fx {
+    begin: number;
+    end: number;
+    fps: number;
+    time: number;
+    per_clock: number;
+    delay: number;
+    func: (value: number) => void;
+    onStop?: () => void;
+    enabled: boolean;
+    timer: ZeppTimer | null;
+    x_start: number;
+    x_end: number;
+    fx: (x: number) => number;
+    speed: number;
+    x_now: number;
+    static Styles: {
+        [key: string]: number;
+    };
+    static Easing: {
+        [key: string]: (now_x: number, begin: number, end: number, max_x: number) => number;
+    };
+    /**
+     * 创建动画实例
+     * @param {FxOptions} options 配置选项
+     */
+    constructor({ delay, begin, end, x_start, x_end, time, fx, func, fps, enabled, style, onStop, }: FxOptions);
+    /**
+     * 获取样式名称
+     * @param {number} styleValue 样式枚举值
+     * @returns {string} 样式名称
+     * @private
+     */
+    _getStyleName(styleValue: number): string;
+    /**
+     * 开始动画
+     * 如果动画已经运行，会先停止再重新开始
+     */
+    start(): void;
+    /**
+ *     停止动画
+     * 重置动画进度到起始点，并停止计时器
+     */
+    stop(): void;
+    /**
+     * 暂停动画
+     * 停止计时器但保持当前进度
+     */
+    pause(): void;
+    /**
+     * 重新开始动画
+     */
+    restart(): void;
+    /**
+     * 设置动画是否启用
+     * @param {boolean} enabled 是否启用
+     */
+    setEnable(enabled: boolean): void;
+    /**
+     * 注册定时器
+     * @private
+     */
+    registerTimer(): void;
+    /**
+     * 获取两个颜色的混合色
+     * @param {number} color1 初始颜色1 (6位十六进制)
+     * @param {number} color2 初始颜色2 (6位十六进制)
+     * @param {number} percentage 混合百分比 [0,1]，越小越接近color1
+     * @returns {number} 混合后的颜色
+     */
+    static getMixColor(color1: number, color2: number, percentage: number): number;
+    static getRainbowColor(percentage: number): number;
+    /**
+     * 获取两个边框的混合值
+     * @param {Border} border1 边框1
+     * @param {Border} border2 边框2
+     * @param {number} percentage 混合百分比 [0,1]
+     * @returns {Border} 混合后的边框
+     */
+    static getMixBorder(border1: Border, border2: Border, percentage: number): Border;
+}
+/**
+ * zeppos-timer.js
+ * @description An accurate timer for ZeppOS. 一个适用于ZeppOS的准确的计时器
+ * @version 1.0.0
+ * @date 2023/04/07
+ * @author XiaomaiTX
+ * @license MIT
+ * https://github.com/XiaomaiTX/zeppos-timer
+ *
+ * */
+import { Time } from "@zos/sensor";
+declare class ZeppTimer {
+    callback: () => void;
+    interval: number;
+    timerId: any;
+    startTime: number | null;
+    nextTick: number | null;
+    time: Time;
+    stopped: boolean;
+    constructor(callback: () => void, interval: number);
+    start(delay?: number): void;
+    stop(): void;
+    scheduleTick(): void;
+    tick(): void;
+}
+export {};
+//# sourceMappingURL=fx.d.ts.map

package/dist/fx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx.d.ts","sourceRoot":"","sources":["../src/fx.ts"],"names":[],"mappings":"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"}