refactor: 新增朝向系统

packages-user/data-base/src/common/faceManager.ts

@@ -0,0 +1,282 @@
+import { FaceDirection } from './types';
+
+//#region 接口与枚举
+
+export const enum InternalFaceGroup {
+    /** 四方向（上下左右） */
+    Dir4,
+    /** 八方向（上下左右+斜向） */
+    Dir8
+}
+
+export interface IFaceDescriptor {
+    /** 横坐标增量 */
+    readonly x: number;
+    /** 纵坐标增量 */
+    readonly y: number;
+}
+
+export interface IFaceHandler<T extends number> {
+    /**
+     * 将任意朝向值降级为本组支持的方向。
+     * 对于无法合理降级的方向（包括 `Unknown`），返回 `FaceDirection.Unknown`
+     * @param dir 任意朝向值
+     */
+    degrade(dir: number): T;
+
+    /**
+     * 获取指定方向的单步坐标偏移量，输入先经过 `degrade`
+     * @param dir 朝向
+     */
+    movement(dir: number): IFaceDescriptor;
+
+    /**
+     * 获取指定方向走 `count` 步的坐标偏移量，等价于 `movement * count`。
+     * `count` 允许为负数，表示反向位移，输入先经过 `degrade`
+     * @param dir 朝向
+     * @param count 步数，允许为负
+     */
+    move(dir: number, count: number): IFaceDescriptor;
+
+    /**
+     * 获取本组内的反方向，输入先经过 `degrade`，`Unknown` 返回 `Unknown`
+     * @param dir 朝向
+     */
+    opposite(dir: number): T;
+
+    /**
+     * 在本组方向集合内顺时针（默认）或逆时针旋转一步，输入先经过 `degrade`，
+     * `Unknown` 返回 `Unknown`
+     * @param dir 朝向
+     * @param anticlockwise 是否逆时针，默认顺时针
+     */
+    next(dir: number, anticlockwise?: boolean): T;
+
+    /**
+     * 迭代本组支持的所有朝向，包含 `Unknown`
+     */
+    mapDirection(): Iterable<T>;
+
+    /**
+     * 迭代本组所有朝向及其对应的坐标描述器，包含 `Unknown`（对应 `{ x: 0, y: 0 }`）
+     */
+    mapMovement(): Iterable<[T, IFaceDescriptor]>;
+}
+
+export interface IFaceManager {
+    /**
+     * 以数字 key 注册一个 handler
+     * @param group 数字 key
+     * @param handler 朝向处理器
+     */
+    register(group: number, handler: IFaceHandler<number>): void;
+
+    /**
+     * 以字符串 id 注册一个 handler
+     * @param id 字符串 id
+     * @param handler 朝向处理器
+     */
+    registerById(id: string, handler: IFaceHandler<number>): void;
+
+    /**
+     * 按数字 key 查找 handler，未找到返回 `null`
+     * @param group 数字 key
+     */
+    get<T extends number>(group: number): IFaceHandler<T> | null;
+
+    /**
+     * 按字符串 id 查找 handler，未找到返回 `null`
+     * @param id 字符串 id
+     */
+    getById<T extends number>(id: string): IFaceHandler<T> | null;
+}
+
+//#endregion
+
+//#region 内置 Handler
+
+const ZERO_DESCRIPTOR: IFaceDescriptor = { x: 0, y: 0 };
+
+const DIR8_MOVEMENTS: ReadonlyMap<FaceDirection, IFaceDescriptor> = new Map([
+    [FaceDirection.Unknown, ZERO_DESCRIPTOR],
+    [FaceDirection.Left, { x: -1, y: 0 }],
+    [FaceDirection.Up, { x: 0, y: -1 }],
+    [FaceDirection.Right, { x: 1, y: 0 }],
+    [FaceDirection.Down, { x: 0, y: 1 }],
+    [FaceDirection.LeftUp, { x: -1, y: -1 }],
+    [FaceDirection.RightUp, { x: 1, y: -1 }],
+    [FaceDirection.LeftDown, { x: -1, y: 1 }],
+    [FaceDirection.RightDown, { x: 1, y: 1 }]
+]);
+
+/** 顺时针旋转顺序（不含 Unknown） */
+const DIR8_CW: ReadonlyMap<FaceDirection, FaceDirection> = new Map([
+    [FaceDirection.Up, FaceDirection.RightUp],
+    [FaceDirection.RightUp, FaceDirection.Right],
+    [FaceDirection.Right, FaceDirection.RightDown],
+    [FaceDirection.RightDown, FaceDirection.Down],
+    [FaceDirection.Down, FaceDirection.LeftDown],
+    [FaceDirection.LeftDown, FaceDirection.Left],
+    [FaceDirection.Left, FaceDirection.LeftUp],
+    [FaceDirection.LeftUp, FaceDirection.Up]
+]);
+
+/** 逆时针旋转顺序（不含 Unknown） */
+const DIR8_CCW: ReadonlyMap<FaceDirection, FaceDirection> = new Map([
+    [FaceDirection.Up, FaceDirection.LeftUp],
+    [FaceDirection.LeftUp, FaceDirection.Left],
+    [FaceDirection.Left, FaceDirection.LeftDown],
+    [FaceDirection.LeftDown, FaceDirection.Down],
+    [FaceDirection.Down, FaceDirection.RightDown],
+    [FaceDirection.RightDown, FaceDirection.Right],
+    [FaceDirection.Right, FaceDirection.RightUp],
+    [FaceDirection.RightUp, FaceDirection.Up]
+]);
+
+const DIR8_OPPOSITE: ReadonlyMap<FaceDirection, FaceDirection> = new Map([
+    [FaceDirection.Up, FaceDirection.Down],
+    [FaceDirection.Down, FaceDirection.Up],
+    [FaceDirection.Left, FaceDirection.Right],
+    [FaceDirection.Right, FaceDirection.Left],
+    [FaceDirection.LeftUp, FaceDirection.RightDown],
+    [FaceDirection.RightDown, FaceDirection.LeftUp],
+    [FaceDirection.RightUp, FaceDirection.LeftDown],
+    [FaceDirection.LeftDown, FaceDirection.RightUp]
+]);
+
+export class Dir8FaceHandler implements IFaceHandler<FaceDirection> {
+    degrade(dir: number): FaceDirection {
+        return dir as FaceDirection;
+    }
+
+    movement(dir: number): IFaceDescriptor {
+        return DIR8_MOVEMENTS.get(this.degrade(dir)) ?? ZERO_DESCRIPTOR;
+    }
+
+    move(dir: number, count: number): IFaceDescriptor {
+        const { x, y } = this.movement(dir);
+        return { x: x * count, y: y * count };
+    }
+
+    opposite(dir: number): FaceDirection {
+        const degraded = this.degrade(dir);
+        return DIR8_OPPOSITE.get(degraded) ?? FaceDirection.Unknown;
+    }
+
+    next(dir: number, anticlockwise: boolean = false): FaceDirection {
+        const degraded = this.degrade(dir);
+        if (degraded === FaceDirection.Unknown) return FaceDirection.Unknown;
+        const map = anticlockwise ? DIR8_CCW : DIR8_CW;
+        return map.get(degraded) ?? FaceDirection.Unknown;
+    }
+
+    mapDirection(): Iterable<FaceDirection> {
+        return DIR8_MOVEMENTS.keys();
+    }
+
+    mapMovement(): Iterable<[FaceDirection, IFaceDescriptor]> {
+        return DIR8_MOVEMENTS.entries();
+    }
+}
+
+const DIR4_DEGRADE: ReadonlyMap<FaceDirection, FaceDirection> = new Map([
+    [FaceDirection.Left, FaceDirection.Left],
+    [FaceDirection.Up, FaceDirection.Up],
+    [FaceDirection.Right, FaceDirection.Right],
+    [FaceDirection.Down, FaceDirection.Down],
+    [FaceDirection.LeftUp, FaceDirection.Left],
+    [FaceDirection.LeftDown, FaceDirection.Left],
+    [FaceDirection.RightUp, FaceDirection.Right],
+    [FaceDirection.RightDown, FaceDirection.Right]
+]);
+
+const DIR4_MOVEMENTS: ReadonlyMap<FaceDirection, IFaceDescriptor> = new Map([
+    [FaceDirection.Unknown, ZERO_DESCRIPTOR],
+    [FaceDirection.Left, { x: -1, y: 0 }],
+    [FaceDirection.Up, { x: 0, y: -1 }],
+    [FaceDirection.Right, { x: 1, y: 0 }],
+    [FaceDirection.Down, { x: 0, y: 1 }]
+]);
+
+const DIR4_CW: ReadonlyMap<FaceDirection, FaceDirection> = new Map([
+    [FaceDirection.Up, FaceDirection.Right],
+    [FaceDirection.Right, FaceDirection.Down],
+    [FaceDirection.Down, FaceDirection.Left],
+    [FaceDirection.Left, FaceDirection.Up]
+]);
+
+const DIR4_CCW: ReadonlyMap<FaceDirection, FaceDirection> = new Map([
+    [FaceDirection.Up, FaceDirection.Left],
+    [FaceDirection.Left, FaceDirection.Down],
+    [FaceDirection.Down, FaceDirection.Right],
+    [FaceDirection.Right, FaceDirection.Up]
+]);
+
+const DIR4_OPPOSITE: ReadonlyMap<FaceDirection, FaceDirection> = new Map([
+    [FaceDirection.Up, FaceDirection.Down],
+    [FaceDirection.Down, FaceDirection.Up],
+    [FaceDirection.Left, FaceDirection.Right],
+    [FaceDirection.Right, FaceDirection.Left]
+]);
+
+export class Dir4FaceHandler implements IFaceHandler<FaceDirection> {
+    degrade(dir: number): FaceDirection {
+        return DIR4_DEGRADE.get(dir as FaceDirection) ?? FaceDirection.Unknown;
+    }
+
+    movement(dir: number): IFaceDescriptor {
+        return DIR4_MOVEMENTS.get(this.degrade(dir)) ?? ZERO_DESCRIPTOR;
+    }
+
+    move(dir: number, count: number): IFaceDescriptor {
+        const { x, y } = this.movement(dir);
+        return { x: x * count, y: y * count };
+    }
+
+    opposite(dir: number): FaceDirection {
+        const degraded = this.degrade(dir);
+        return DIR4_OPPOSITE.get(degraded) ?? FaceDirection.Unknown;
+    }
+
+    next(dir: number, anticlockwise: boolean = false): FaceDirection {
+        const degraded = this.degrade(dir);
+        if (degraded === FaceDirection.Unknown) return FaceDirection.Unknown;
+        const map = anticlockwise ? DIR4_CCW : DIR4_CW;
+        return map.get(degraded) ?? FaceDirection.Unknown;
+    }
+
+    mapDirection(): Iterable<FaceDirection> {
+        return DIR4_MOVEMENTS.keys();
+    }
+
+    mapMovement(): Iterable<[FaceDirection, IFaceDescriptor]> {
+        return DIR4_MOVEMENTS.entries();
+    }
+}
+
+//#endregion
+
+//#region FaceManager
+
+export class FaceManager implements IFaceManager {
+    private readonly byGroup: Map<number, IFaceHandler<number>> = new Map();
+    private readonly byId: Map<string, IFaceHandler<number>> = new Map();
+
+    register(group: number, handler: IFaceHandler<number>): void {
+        this.byGroup.set(group, handler);
+    }
+
+    registerById(id: string, handler: IFaceHandler<number>): void {
+        this.byId.set(id, handler);
+    }
+
+    get<T extends number>(group: number): IFaceHandler<T> | null {
+        return (this.byGroup.get(group) as IFaceHandler<T>) ?? null;
+    }
+
+    getById<T extends number>(id: string): IFaceHandler<T> | null {
+        return (this.byId.get(id) as IFaceHandler<T>) ?? null;
+    }
+}
+
+//#endregion

packages-user/data-base/src/common/index.ts

@@ -1,4 +1,5 @@
 export * from './face';
+export * from './faceManager';
 export * from './mover';
 export * from './types';
 export * from './utils';

packages-user/data-base/src/types.ts

@@ -1,7 +1,7 @@
 import { IHeroFollower, IHeroState } from './hero';
 import { IEnemyManager } from './enemy';
 import { IFlagSystem } from './flag';
-import { IRoleFaceBinder, ISaveableContent } from './common';
+import { IFaceManager, IRoleFaceBinder, ISaveableContent } from './common';
 import { IMapStore } from './map';
 
 export interface IStateSaveData {
@@ -12,6 +12,8 @@ export interface IStateSaveData {
 export interface IStateBase<TEnemy, THero> {
     /** 朝向绑定 */
     readonly roleFace: IRoleFaceBinder;
+    /** 朝向管理 */
+    readonly faceManager: IFaceManager;
     /** id 到图块数字的映射 */
     readonly idNumberMap: Map<string, number>;
     /** 图块数字到 id 的映射 */