@cjhd/cj-ecs 1.0.0 → 1.0.1

package/assets/common/system/MoveSystem.ts

@@ -1,108 +0,0 @@
-import { math } from 'cc';
-import { EcsSystem } from '../../ecs/EcsSystem';
-import { filter } from '../../lib/EcsFilter';
-import { IEntity } from '../../lib/EcsObject';
-import { IMoveComponent, MoveComponent, MoveTowardType } from '../component/MoveComponent';
-import { NodeComponent } from '../component/NodeComponent';
-
-/**
- * 修正为范围值
- */
-function getAbsoluteValue(input: number, threshold: number) {
-    if (threshold < 0) {
-        threshold = -threshold;
-    }
-    if (input > 0) {
-        if (input > threshold) return threshold;
-        return input;
-    }
-    if (input < 0) {
-        if (input < -threshold) return -threshold;
-    }
-    return input;
-}
-
-/**
- * 负责驱动move组件
- */
-export class MoveSystem extends EcsSystem {
-    private filter = filter.all(MoveComponent, NodeComponent);
-
-    protected execute(dt?: number): void {
-        this.query(this.filter, MoveComponent).forEach((move) => {
-            this.handle(move, move.entity, dt);
-        });
-    }
-
-    /**
-     * 处理
-     * @param move 
-     * @param entity 
-     * @param dt 
-     */
-    private handle(move: IMoveComponent, entity: IEntity, dt: number) {
-        // 追踪角度
-        if (move.target) {
-            move.toward = MoveComponent.getTowardAngle(entity.getComponent(NodeComponent), move.target);
-        }
-
-        this.rotate(move, entity, dt);
-
-        // 初速度
-        const lastSpeed = move.speed;
-        // 加速度
-        move.speed += move.options.acceleratedVelocity * dt;
-        if (move.speed < move.options.minSpeed) {
-            move.speed = move.options.minSpeed;
-        }
-        if (move.speed > move.options.maxSpeed) {
-            move.speed = move.options.maxSpeed;
-        }
-        // 平均速度
-        const speed = (lastSpeed + move.speed) / 2;
-        this.run(move, entity, dt, speed);
-    }
-
-    private run(move: IMoveComponent, entity: IEntity, dt: number, speed: number) {
-        // 移动距离
-        const distance = speed * dt;
-        // 设置节点位移
-        if (move.angle === MoveTowardType.Right) {
-            entity.getComponent(NodeComponent).addPosition(distance, 0);
-        } else if (move.angle === MoveTowardType.Left) {
-            entity.getComponent(NodeComponent).addPosition(-distance, 0);
-        } else if (move.angle === MoveTowardType.Up) {
-            entity.getComponent(NodeComponent).addPosition(0, distance);
-        } else if (move.angle === MoveTowardType.Down) {
-            entity.getComponent(NodeComponent).addPosition(0, -distance);
-        } else {
-            // 会有细微的误差
-            const radian = math.toRadian(move.angle);
-            const x = Math.cos(radian) * distance;
-            const y = Math.sin(radian) * distance;
-            entity.getComponent(NodeComponent).addPosition(x, y);
-        }
-        // 记录移动
-        move.distance += distance;
-    }
-
-    private rotate(move: IMoveComponent, entity: IEntity, dt: number) {
-        let addAngle = 0;
-        if (move.toward !== move.angle) {
-            // 角度差值
-            const diffAngle = MoveComponent.getAngleFromNeg180to180(move.toward - move.angle);
-            // 差值限制(实际增加)
-            addAngle = move.options.angleVelocity === 0 ? diffAngle : getAbsoluteValue(diffAngle, move.options.angleVelocity * dt);
-            // 实际角度
-            move.angle += addAngle;
-
-            // 设置节点角度
-            if (move.options.rotate) {
-                entity.getComponent(NodeComponent).setAngle(move.angle);
-            }
-        }
-
-        return addAngle;
-    }
-}
-

package/assets/common/system/MoveSystem.ts.meta

@@ -1,9 +0,0 @@
-{
-  "ver": "4.0.24",
-  "importer": "typescript",
-  "imported": true,
-  "uuid": "3c7901a5-7e25-4b92-9fab-8545febc131f",
-  "files": [],
-  "subMetas": {},
-  "userData": {}
-}

package/assets/common/system.meta

@@ -1,12 +0,0 @@
-{
-  "ver": "1.2.0",
-  "importer": "directory",
-  "imported": true,
-  "uuid": "92ee71d6-4d80-49c0-ac18-b30302579048",
-  "files": [],
-  "subMetas": {},
-  "userData": {
-    "compressionType": {},
-    "isRemoteBundle": {}
-  }
-}

package/assets/common.meta

@@ -1,12 +0,0 @@
-{
-  "ver": "1.2.0",
-  "importer": "directory",
-  "imported": true,
-  "uuid": "458425eb-7ee3-40d6-b238-ab3703c68aa0",
-  "files": [],
-  "subMetas": {},
-  "userData": {
-    "compressionType": {},
-    "isRemoteBundle": {}
-  }
-}

package/assets/ecs/EcsComponent.ts

@@ -1,244 +0,0 @@
-
-import { ecsclass } from '../lib/EcsManager';
-import { EcsBaseComponent, IComponent, IEntity } from '../lib/EcsObject';
-import type { EcsDirtyMask, IEcsComponentDirtySink } from './EcsDirty';
-
-@ecsclass('EcsComponent')
-export class EcsComponent<E extends IEntity = IEntity> extends EcsBaseComponent implements IComponent {
-    declare static readonly Fields: Record<string, any>;
-
-    /**内部函数 */
-    static updateEnable(comp: EcsComponent) {
-        comp.updateEnable();
-    }
-
-    /** 内部函数：ECS/observed runtime 用它把 dirty sink 绑定到组件实例。 */
-    static bindDirtySink(comp: EcsComponent, sink: IEcsComponentDirtySink | null) {
-        comp._dirtySink = sink;
-    }
-
-    /**内部函数 */
-    static beforeRemove(comp: EcsComponent) {
-        return comp.innerBeforeRemove();
-    }
-
-    /**内部函数 */
-    static onAdd(comp: EcsComponent, entity: IEntity) {
-        return comp.innerAdd(entity);
-    }
-
-    /**内部函数 */
-    static onRemove(comp: EcsComponent) {
-        return comp.innerRemove();
-    }
-
-    /**正在初始化中 */
-    private _initing = false;
-    /**正在移除中 */
-    private _removing = false;
-    /** 当前组件累积的 dirty bit。未安装 observed 时也会维护这个本地状态。 */
-    private _dirtyMask: EcsDirtyMask = 0;
-    /** 每次 dirtyMask 从“未包含某 bit”变为“包含某 bit”时递增，方便调试或增量同步判断。 */
-    private _dirtyVersion = 0;
-    /** 可选扩展 sink。只有 observed runtime install 后才会非空。 */
-    private _dirtySink: IEcsComponentDirtySink | null = null;
-
-    /**是否有效 */
-    private _isValid = false;
-    public get isValid() {
-        return this._isValid;
-    }
-    private set isValid(value) {
-        this._isValid = value;
-    }
-
-    public get isStrictValid() {
-        return this._isValid && !this._removing;
-    }
-
-    /**是否生效 */
-    private _enabled = false;
-    public get enabled() {
-        return this._enabled;
-    }
-    public set enabled(value) {
-        if (this._enabled === value) return;
-        this._enabled = value;
-        if (this._initing) return;
-        if (this._removing) return;
-        this.updateEnable();
-    }
-
-    /**当前组件所在的实体 */
-    private _entity: E | null = null;
-    public get entity() {
-        return this._entity;
-    }
-    private set entity(value) {
-        this._entity = value;
-    }
-
-    /**表示该组件是否被启用并且所在的实体也处于启用状态(为false代表不会被查询到) */
-    public get enabledInHierarchy() {
-        if (!this._enabled) return false;
-        if (!this._entity) return false;
-        if (!this._entity.enabled) return false;
-        return true;
-    }
-
-    private __enabled = false;
-    private updateEnable() {
-        const enabledInHierarchy = this.enabledInHierarchy;
-        if (this.__enabled === enabledInHierarchy) return;
-        this.__enabled = enabledInHierarchy;
-        if (enabledInHierarchy) {
-            this.onEnable();
-        } else {
-            this.onDisable();
-        }
-        const sink = this._dirtySink;
-        if (sink && sink.onComponentEnabledChanged) {
-            sink.onComponentEnabledChanged(this, enabledInHierarchy);
-        }
-    }
-
-    public get dirty(): boolean {
-        return this._dirtyMask !== 0;
-    }
-
-    /**
-     * 兼容旧式 boolean dirty 用法。
-     * 设置 true 等价于 markDirty(1)，设置 false 会清掉全部 dirty bit。
-     */
-    public set dirty(value: boolean) {
-        if (value) {
-            this.markDirty(1);
-        } else {
-            this.clearDirty(this._dirtyMask);
-        }
-    }
-
-    public get dirtyMask(): EcsDirtyMask {
-        return this._dirtyMask;
-    }
-
-    public get dirtyVersion(): number {
-        return this._dirtyVersion;
-    }
-
-    /** 判断当前组件是否包含指定 dirty bit。 */
-    public hasDirty(mask: EcsDirtyMask): boolean {
-        return (this._dirtyMask & mask) !== 0;
-    }
-
-    /**
-     * 标记组件 dirty。
-     *
-     * 业务组件的写屏障应该调用它，例如 position.setXYRaw 后标记 PositionDirtyBits.Spatial。
-     * 如果 observed runtime 已安装，会同步入队；未安装时只更新本地 dirtyMask/version。
-     */
-    public markDirty(mask: EcsDirtyMask = 1): void {
-        if (mask === 0) return;
-
-        const oldMask = this._dirtyMask;
-        const newMask = oldMask | mask;
-        if (oldMask === newMask) return;
-
-        this._dirtyMask = newMask;
-        this._dirtyVersion++;
-
-        const sink = this._dirtySink;
-        if (sink && this.isStrictValid && this.entity) {
-            sink.onComponentDirty(this, mask, oldMask, newMask);
-        }
-    }
-
-    /**
-     * 清理组件 dirty。
-     * drain 默认会调用它清理 matched bit；业务也可以在重置组件状态时主动调用。
-     */
-    public clearDirty(mask: EcsDirtyMask = this._dirtyMask): void {
-        if (mask === 0) return;
-
-        const oldMask = this._dirtyMask;
-        const newMask = oldMask & ~mask;
-        if (oldMask === newMask) return;
-
-        this._dirtyMask = newMask;
-
-        const sink = this._dirtySink;
-        if (sink && this.isStrictValid && this.entity && sink.onComponentClearDirty) {
-            sink.onComponentClearDirty(this, mask, oldMask, newMask);
-        }
-    }
-
-    /**
-     * 静默清理本地 dirtyMask，不通知 sink。
-     * 只用于组件移除/回收这类生命周期收尾，普通业务不要用它代替 clearDirty。
-     */
-    public clearDirtySilent(): void {
-        this._dirtyMask = 0;
-    }
-
-    /**
-     * 组件被添加(内部调用)
-     */
-    private innerAdd(entity: E) {
-        this._initing = true;
-        this._removing = false;
-        this._isValid = true;
-        this._enabled = true;
-        this.__enabled = false;
-        this._entity = entity;
-        this.onAdd();
-        this._initing = false;
-        this.__enabled = this.enabledInHierarchy;
-        this.__enabled && this.onEnable();
-    }
-
-    /**
-     * 组件被移除前(内部调用)
-     */
-    private innerBeforeRemove() {
-        this._removing = true;
-    }
-
-    /**
-     * 组件被移除(内部调用)
-     */
-    private innerRemove() {
-        const sink = this._dirtySink;
-        if (sink && sink.onComponentRemoved) {
-            sink.onComponentRemoved(this);
-        }
-        this.__enabled && this.onDisable();
-        this.onRemove();
-        this._removing = false;
-        this._isValid = false;
-        this._enabled = false;
-        this.__enabled = false;
-        this.clearDirtySilent();
-        this._dirtySink = null;
-        this._entity = null;
-    }
-
-    protected onAdd() { }
-    protected onEnable() { }
-    protected onDisable() { }
-    protected onRemove() { }
-
-    public destroy(): boolean {
-        if (!this.entity) return false;
-        return this.entity.remove(this);
-    }
-
-    protected log(...args: any[]) {
-        console.log(`[${this.ecsName}] [log]`, ...args);
-    }
-    protected warn(...args: any[]) {
-        console.warn(`[${this.ecsName}] [warn]`, ...args);
-    }
-    protected error(...args: any[]) {
-        console.error(`[${this.ecsName}] [error]`, ...args);
-    }
-}

package/assets/ecs/EcsComponent.ts.meta

@@ -1,9 +0,0 @@
-{
-  "ver": "4.0.24",
-  "importer": "typescript",
-  "imported": true,
-  "uuid": "e3cef916-2f45-4f63-aadf-45ce183a40c8",
-  "files": [],
-  "subMetas": {},
-  "userData": {}
-}

package/assets/ecs/EcsDirty.ts.meta

@@ -1,9 +0,0 @@
-{
-  "ver": "4.0.24",
-  "importer": "typescript",
-  "imported": true,
-  "uuid": "642c20f8-46f8-4b42-8d6e-3d5a5b85faf9",
-  "files": [],
-  "subMetas": {},
-  "userData": {}
-}