@cjhd/cj-decimal 1.0.0 → 1.1.2

package/.cj-package.json

@@ -0,0 +1,13 @@
+{
+    "schema": "cj-package-v1",
+    "name": "@cjhd/cj-decimal",
+    "version": "1.1.2",
+    "payloadManifest": "encrypted-payload/manifest.json",
+    "entry": "index.js",
+    "assetsDir": "assets",
+    "generatedFiles": [
+        "assets/Decimal.js",
+        "index.js"
+    ],
+    "dependencies": []
+}

package/assets/Decimal.d.ts

@@ -0,0 +1,464 @@
+type DecimalSign = 1 | -1;
+type IntNumber = number;
+/**
+ * Decimal 原地修改观察器。
+ * 默认不绑定，只有 @EcsObservedDecimal 这类业务装饰器显式绑定后才会触发。
+ */
+export interface IDecimalMutationObserver {
+    onDecimalMutated(decimal: Decimal): void;
+}
+/**
+ * 定点数计算
+ */
+export declare class Decimal {
+    static copy(other: Decimal): Decimal;
+    static createInt(value: IntNumber): Decimal;
+    static createFloat(value: string): Decimal;
+    static create(sign: DecimalSign, v1: IntNumber, v2: IntNumber): Decimal;
+    /**
+     * 精确度保留n位小数点, 默认是8。
+     * @description 注意整数与小数部分长度和不要超过16位，并且整数位大小不要超过「9 * Math.pow(10, 15-n)」，否则运算过程中会出现大整数导致的精度丢失。
+     */
+    static set accuracy(value: IntNumber);
+    static get accuracy(): IntNumber;
+    /**
+     * 180度对应的弧度值 （不要修改此值）
+     */
+    static get PI(): Decimal;
+    /**
+     * 180度的一半(90度)对应的弧度值 （不要修改此值）
+     */
+    static get PI_HALF(): Decimal;
+    /**
+     * 1度对应的弧度值 （不要修改此值）
+     */
+    static get DEG_TO_RAD(): Decimal;
+    /**
+     * 1弧度对应的角度值 （不要修改此值）
+     */
+    static get RAD_TO_DEG(): Decimal;
+    /**
+     * 0
+     */
+    static get zero(): Decimal;
+    /**
+     * 0 （不要修改此值）
+     */
+    static get ZERO(): Decimal;
+    /**
+     * 1
+     */
+    static get one(): Decimal;
+    /**
+     * 1 （不要修改此值）
+     */
+    static get ONE(): Decimal;
+    /**
+     * 2
+     */
+    static get two(): Decimal;
+    /**
+     * 2 （不要修改此值）
+     */
+    static get TWO(): Decimal;
+    /**
+     * -1
+     */
+    static get(): Decimal;
+    /**
+     * -1 （不要修改此值）
+     */
+    static get MINUS(): Decimal;
+    /**
+     * NaN
+     */
+    static get NaN(): Decimal;
+    /**
+     * 取较大
+     */
+    static max(...args: Decimal[]): Decimal;
+    /**
+     * 取较小
+     */
+    static min(...args: Decimal[]): Decimal;
+    /**
+     * 弧度转角度
+     */
+    static radiansToDegrees(out: Decimal, radians: Decimal): Decimal;
+    /**
+     * 角度转弧度
+     * @param out 输出结果
+     * @param degrees 角度
+     * @returns 结果
+     */
+    static degreesToRadians(out: Decimal, degrees: Decimal): Decimal;
+    /**
+     * 正弦函数
+     */
+    static sin(out: Decimal, angle: Decimal): Decimal;
+    /**
+     * 余弦函数
+     */
+    static cos(out: Decimal, angle: Decimal): Decimal;
+    /**
+     * 正切函数
+     */
+    static tan(out: Decimal, angle: Decimal): Decimal;
+    /**
+     * 计算反正弦
+     */
+    static asin(out: Decimal, value: Decimal): Decimal;
+    /**
+     * 计算反余弦
+     */
+    static acos(out: Decimal, value: Decimal): Decimal;
+    /**
+     * 计算反正切
+     */
+    static atan(out: Decimal, value: Decimal): Decimal;
+    /**
+     * 计算反正切，给定 x 和 y 的值
+     */
+    static atan2(out: Decimal, y: Decimal, x: Decimal): Decimal;
+    private _sign;
+    get sign(): DecimalSign;
+    private set sign(value);
+    private _v1;
+    get v1(): IntNumber;
+    private set v1(value);
+    private _v2;
+    get v2(): IntNumber;
+    private set v2(value);
+    /** 可选 observer。默认 null，算法 scratch Decimal 不承担观察成本。 */
+    private __observer;
+    /** 嵌套 mutation 深度，用于 batch 合并多次原地修改。 */
+    private __mutationDepth;
+    /** batch 内是否发生过实际数值变化。 */
+    private __mutationPending;
+    /** 静默写入深度。大批量业务写屏障可用 setSilent/copySilent 后手动 markDirty。 */
+    private __silentDepth;
+    /**
+     * 绑定或解绑 Decimal mutation observer。
+     * 仅 @EcsObservedDecimal 管理的组件字段需要绑定；普通 Decimal、SAT/MTV 临时值不要绑定。
+     */
+    bindMutationObserver(observer: IDecimalMutationObserver | null): this;
+    /** 开始合并多次 Decimal 修改，直到 endMutationBatch 才通知一次 observer。 */
+    beginMutationBatch(): this;
+    /** 结束 batch；如果期间值发生变化且已回到最外层，则通知一次 observer。 */
+    endMutationBatch(): this;
+    /** 用函数作用域包住 batch，避免异常时忘记 endMutationBatch。 */
+    runMutationBatch<T>(action: () => T): T;
+    /** 静默执行 Decimal 修改，不通知 observer。适合业务写屏障合并后手动 markDirty。 */
+    runSilentMutation<T>(action: () => T): T;
+    /** 静默 set，不触发 Decimal observer。 */
+    setSilent(sign?: DecimalSign, v1?: IntNumber, v2?: IntNumber): this;
+    /** 静默 copy，不触发 Decimal observer。 */
+    copySilent(other: Decimal): this;
+    private static compareAbs;
+    private static compareSigned;
+    private normalizeZero;
+    private snapshot;
+    private changedSince;
+    /** 所有会原地修改 Decimal 的 public 方法都应通过这里包裹，确保值变才通知。 */
+    private runMutation;
+    /** batch/silent 状态允许时，把一次已合并的 mutation 通知给 observer。 */
+    private flushMutationObserverIfReady;
+    private setAbsSub;
+    private setAbsAdd;
+    private setFromRawBigInt;
+    /**
+     * 用于等号赋值
+     * @example
+     * const a = new Decimal('1');
+     * const b = new Decimal('10');
+     * a.value = b;
+     */
+    set value(other: Decimal);
+    /**
+     * 传入字符串数字
+     * @param value 字符串数字(不支持科学计数)
+     */
+    constructor(value: string);
+    /**
+     * 构造 0
+     */
+    constructor();
+    /**
+     * 设置, 默认为0
+     */
+    set(sign?: DecimalSign, v1?: IntNumber, v2?: IntNumber): this;
+    /**
+     * 通过float字符串设置, 默认为0
+     */
+    setFloat(value?: string): this;
+    /**
+     * 通过int设置, 默认为0
+     */
+    setInt(value?: IntNumber): this;
+    /**
+     * 通过其他Decimal设置
+     */
+    copy(other: Decimal): this;
+    /**
+     * 转为浮点数
+     * @param strict 严格模式，默认关闭。开启后额外消耗性能，避免定点数转小数时出现精度问题。
+     */
+    toNumber(strict?: boolean): number;
+    /**
+     * 转为字符串
+     */
+    toString(): string;
+    /**
+     * 转为大整数
+     */
+    toBigInt(): IntNumber;
+    /**
+     * 是否为0
+     */
+    isZero(): boolean;
+    /**
+     * 是否是负数
+     */
+    isNegative(): boolean;
+    /**
+     * 是否是NaN
+     */
+    isNaN(): boolean;
+    /**
+     * 克隆
+     */
+    clone(): Decimal;
+    /**
+     * 向下取整
+     */
+    floor(): this;
+    /**
+     * 向上取整
+     */
+    ceil(): this;
+    /**
+     * 四舍五入
+     */
+    round(): this;
+    /**
+     * 绝对值
+     */
+    abs(): Decimal;
+    /**
+     * @deprecated 使用negative代替
+     */
+    reverse(): Decimal;
+    /**
+     * 相反数
+     */
+    negative(): Decimal;
+    /**
+     * 倒数
+     */
+    reciprocal(): Decimal;
+    /**
+     * 加法
+     * @param other
+     */
+    add(other: Decimal): Decimal;
+    /**
+     * 加法
+     * @param other
+     */
+    addInt(other: IntNumber): Decimal;
+    /**
+     * 加法
+     * @param other
+     */
+    addFloat(other: string): Decimal;
+    /**
+     * 减法
+     * @param other
+     */
+    sub(other: Decimal): Decimal;
+    /**
+     * 减法
+     * @param other
+     */
+    subInt(other: IntNumber): Decimal;
+    /**
+     * 减法
+     * @param other
+     */
+    subFloat(other: string): Decimal;
+    /**
+     * 乘法
+     * @param other
+     */
+    mul(other: Decimal): Decimal;
+    /**
+     * 乘法
+     * @param other
+     */
+    mulInt(other: IntNumber): Decimal;
+    /**
+     * 乘法
+     * @param other
+     */
+    mulFloat(other: string): Decimal;
+    /**
+     * 除法
+     * @param other
+     */
+    div(other: Decimal): Decimal;
+    /**
+     * 除法
+     * @param other
+     */
+    divInt(other: IntNumber): Decimal;
+    /**
+     * 除法
+     * @param other
+     */
+    divFloat(other: string): Decimal;
+    /**
+     * 取余数
+     * @param other
+     */
+    mod(other: Decimal): Decimal;
+    /**
+     * 取余数
+     * @param other
+     */
+    modInt(other: IntNumber): Decimal;
+    /**
+     * 取余数
+     * @param other
+     */
+    modFloat(other: string): Decimal;
+    /**
+    * n次方
+    * @param n 整数
+    */
+    pow(n?: IntNumber): this;
+    /**
+     * 开方
+     */
+    sqrt(): this;
+    /**
+     * 小于
+     * @param other
+     */
+    LT(other: Decimal): boolean;
+    /**
+     * 小于
+     * @param other
+     */
+    ['<'](other: Decimal): boolean;
+    /**
+     * 小于
+     * @param other
+     */
+    LTInt(other: IntNumber): boolean;
+    /**
+     * 小于
+     * @param other
+     */
+    LTFloat(other: string): boolean;
+    /**
+     * 小于等于
+     * @param other
+     */
+    LE(other: Decimal): boolean;
+    /**
+     * 小于等于
+     * @param other
+     */
+    ['<='](other: Decimal): boolean;
+    /**
+     * 小于等于
+     * @param other
+     */
+    LEInt(other: IntNumber): boolean;
+    /**
+     * 小于等于
+     * @param other
+     */
+    LEFloat(other: string): boolean;
+    /**
+     * 等于
+     * @param other
+     */
+    EQ(other: Decimal): boolean;
+    /**
+     * 等于
+     * @param other
+     */
+    ['=='](other: Decimal): boolean;
+    /**
+     * 等于
+     * @param other
+     */
+    EQInt(other: IntNumber): boolean;
+    /**
+     * 等于
+     * @param other
+     */
+    EQFloat(other: string): boolean;
+    /**
+     * 不等于
+     * @param other
+     */
+    NE(other: Decimal): boolean;
+    /**
+     * 不等于
+     * @param other
+     */
+    ['!='](other: Decimal): boolean;
+    /**
+     * 不等于
+     * @param other
+     */
+    NEInt(other: IntNumber): boolean;
+    /**
+     * 不等于
+     * @param other
+     */
+    NEFloat(other: string): boolean;
+    /**
+     * 大于
+     * @param other
+     */
+    GT(other: Decimal): boolean;
+    /**
+     * 大于
+     * @param other
+     */
+    ['>'](other: Decimal): boolean;
+    /**
+     * 大于
+     * @param other
+     */
+    GTInt(other: IntNumber): boolean;
+    /**
+     * 大于
+     * @param other
+     */
+    GTFloat(other: string): boolean;
+    /**
+     * 大于等于
+     * @param other
+     */
+    GE(other: Decimal): boolean;
+    /**
+     * 大于等于
+     * @param other
+     */
+    ['>='](other: Decimal): boolean;
+    /**
+     * 大于等于
+     * @param other
+     */
+    GEInt(other: IntNumber): boolean;
+    /**
+     * 大于等于
+     * @param other
+     */
+    GEFloat(other: string): boolean;
+}
+export {};

package/assets/Decimal.js

@@ -0,0 +1,6 @@
+function __cjLicenseError() {
+    throw new Error("[CJHD License] Runtime package is not unlocked. Expected license file: extensions/pkg/node_modules/@cjhd/cj-cocos-license/bin/cj-runtime-license.json. Then run: node extensions/pkg/node_modules/@cjhd/cj-cocos-license/bin/cj-license.js --mode install --force");
+}
+
+export class Decimal { constructor() { __cjLicenseError(); } }
+export function __cj_package_not_unlocked__() { __cjLicenseError(); }

package/bin/package-postinstall.js

@@ -0,0 +1,32 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import childProcess from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(__dirname, '..');
+const cjhdRoot = path.dirname(packageRoot);
+const pkgRoot = path.resolve(cjhdRoot, '../..');
+const cli = path.join(cjhdRoot, 'cj-cocos-license', 'bin', 'cj-license.js');
+
+if (!fs.existsSync(cli)) {
+    console.warn('[CJHD License] @cjhd/cj-cocos-license is not installed; keeping unauthorized stubs.');
+    process.exit(0);
+}
+
+const result = childProcess.spawnSync(process.execPath, [
+    cli,
+    '--mode',
+    'install',
+    '--soft',
+    '--pkg-root',
+    pkgRoot
+], {
+    cwd: pkgRoot,
+    stdio: 'inherit',
+    shell: false
+});
+
+if (result.status !== 0) {
+    console.warn('[CJHD License] install unlock check did not complete; keeping unauthorized stubs.');
+}

package/encrypted-payload/files/index.js.bin

@@ -0,0 +1 @@
+a���ｹǷ��������`��٣�g'E�|�Kʱ`�`َ[|I�

package/encrypted-payload/manifest.json

@@ -0,0 +1,29 @@
+{
+    "schema": "cj-encrypted-payload-v1",
+    "packageName": "@cjhd/cj-decimal",
+    "packageVersion": "1.1.2",
+    "algorithm": "AES-256-GCM",
+    "kdf": "HKDF-SHA256",
+    "sourceHash": "ef241625808b93480b2c4e880901e9b8345081fef968b4f4f6669a25bda2cd77",
+    "payloadHash": "d6921a00f2e48c3faa51fa369d82d5aa5d45f9463aba87c57ee9f00d698eb926",
+    "files": [
+        {
+            "out": "assets/Decimal.js",
+            "bin": "files/assets__Decimal.js.bin",
+            "iv": "cRNtEXix0DUozEka",
+            "authTag": "sMMEmUaAqR8Z6W8cO3Ej5A==",
+            "sha256": "c920e2ec189a291f8afab44929faf901d018c11c7f9d49cf14467f9c9f7646e5"
+        },
+        {
+            "out": "index.js",
+            "bin": "files/index.js.bin",
+            "iv": "qz7+q4JWi8k9IT0/",
+            "authTag": "7wQ5pZBy5H1E+oqqjG7juQ==",
+            "sha256": "1f4ad00b8da4e8d0a211500507f63f6031ccfb0fb89d2c0e4d8184fc6d1cfa05"
+        }
+    ],
+    "publicExports": [
+        "Decimal"
+    ],
+    "createdAt": "2026-05-20T02:39:02.234Z"
+}

package/{index.ts → index.d.ts}

@@ -1,2 +1,2 @@
-export { Decimal } from './assets/Decimal';
-export type { IDecimalMutationObserver } from './assets/Decimal';
+export { Decimal } from './assets/Decimal';
+export type { IDecimalMutationObserver } from './assets/Decimal';

package/index.js

@@ -0,0 +1,6 @@
+function __cjLicenseError() {
+    throw new Error("[CJHD License] Runtime package is not unlocked. Expected license file: extensions/pkg/node_modules/@cjhd/cj-cocos-license/bin/cj-runtime-license.json. Then run: node extensions/pkg/node_modules/@cjhd/cj-cocos-license/bin/cj-license.js --mode install --force");
+}
+
+export { Decimal } from './assets/Decimal.js';
+export function __cj_package_not_unlocked__() { __cjLicenseError(); }

package/package.json

@@ -1,11 +1,10 @@
 {
     "name": "@cjhd/cj-decimal",
-    "version": "1.0.0",
-    "engine": ">=3.8.0",
+    "version": "1.1.2",
     "description": "定点数学计算模块",
-    "main": "index.ts",
+    "main": "./index.js",
     "scripts": {
-        "test": "echo \"Error: no test specified\" && exit 1"
+        "postinstall": "node ./bin/package-postinstall.js"
     },
     "repository": {
         "type": "git",
@@ -16,6 +15,43 @@
         "registry": "https://registry.npmjs.org"
     },
     "author": "超M <402879660@qq.com>",
-    "license": "MIT",
-    "readme": ".cj-decimal.md"
-}
+    "license": "SEE LICENSE IN README.md",
+    "type": "module",
+    "browser": "./index.js",
+    "types": "./index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./index.d.ts",
+            "browser": "./index.js",
+            "import": "./index.js",
+            "default": "./index.js"
+        },
+        "./assets/*": {
+            "types": "./assets/*.d.ts",
+            "browser": "./assets/*.js",
+            "import": "./assets/*.js",
+            "default": "./assets/*.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "package.json",
+        "README.md",
+        "index.d.ts",
+        "index.js",
+        "assets/**/*.d.ts",
+        "assets/**/*.js",
+        "encrypted-payload/**",
+        "bin/**",
+        ".cj-package.json"
+    ],
+    "dependencies": {},
+    "peerDependencies": {
+        "@cjhd/cj-cocos-license": "^1.0.0"
+    },
+    "peerDependenciesMeta": {
+        "@cjhd/cj-cocos-license": {
+            "optional": true
+        }
+    }
+}