refactor: 加载系统核心移动至数据端

packages-user/client-base/package.json

@@ -3,6 +3,7 @@
     "dependencies": {
         "@motajs/audio": "workspace:*",
         "@motajs/render": "workspace:*",
-        "@motajs/client-base": "workspace:*"
+        "@motajs/client-base": "workspace:*",
+        "@user/data-base": "workspace:*"
     }
 }

packages-user/client-base/src/ins.ts

@@ -8,7 +8,7 @@ import {
 } from '@motajs/audio';
 import { MotaAssetsLoader } from './load/loader';
 import { AutotileProcessor, MaterialManager } from './material';
-import { loadProgress } from '@user/data-base';
+import { dataLoader, loadProgress } from '@user/data-base';
 
 //#region 音频实例
 
@@ -35,9 +35,10 @@ export const autotile = new AutotileProcessor(materials);
 
 //#region 加载实例
 
-/** 全局加载实例 */
+/** 客户端加载实例 */
 export const loader = new MotaAssetsLoader(
     loadProgress,
+    dataLoader,
     audioContext,
     soundPlayer,
     materials

packages-user/client-base/src/load/index.ts

@@ -1 +1 @@
-export * from './processor';
+export * from './loader';

packages-user/client-base/src/load/loader.ts

@@ -17,26 +17,15 @@ import {
     LoadAudioProcessor,
     LoadFontProcessor,
     LoadImageProcessor,
-    LoadJSONProcessor,
     LoadTextProcessor,
     LoadZipProcessor
-} from './processor';
+} from '@user/data-base';
 import { IMotaAudioContext, ISoundPlayer } from '@motajs/audio';
 import { loading } from '@user/data-base';
 import { IMaterialManager } from '../material';
 import { ITextureSplitter, Texture, TextureRowSplitter } from '@motajs/render';
 import { iconNames } from './data';
-
-interface LoadTaskStore<T extends LoadDataType = LoadDataType, R = any> {
-    /** 加载任务对象 */
-    readonly task: ILoadTask<T, R>;
-    /** 当 `onLoaded` 兑现后兑现的 `Promise` */
-    readonly loadPromise: Promise<R>;
-    /** 兑现 `loadPromise` */
-    readonly loadResolve: (data: R) => void;
-    /** 当加载任务完成时执行的函数 */
-    readonly onLoaded: CustomLoadFunc<R>;
-}
+import { IMotaDataLoader } from '@user/data-base';
 
 export class MotaAssetsLoader implements IMotaAssetsLoader {
     /** 当前是否正在进行加载 */
@@ -54,12 +43,8 @@ export class MotaAssetsLoader implements IMotaAssetsLoader {
         FontFace
     >;
     readonly textProcessor: ILoadTaskProcessor<LoadDataType.Text, string>;
-    readonly jsonProcessor: ILoadTaskProcessor<LoadDataType.JSON, any>;
     readonly zipProcessor: ILoadTaskProcessor<LoadDataType.ArrayBuffer, JSZip>;
 
-    /** 当前已添加的加载任务 */
-    private readonly tasks: Set<LoadTaskStore> = new Set();
-
     /** 素材索引 */
     private materialsCounter: number = 0;
     /** 贴图行分割器，用于处理遗留 `icons.png` */
@@ -67,6 +52,7 @@ export class MotaAssetsLoader implements IMotaAssetsLoader {
 
     constructor(
         readonly progress: ILoadProgressTotal,
+        private readonly dataLoader: IMotaDataLoader,
         private readonly ac: IMotaAudioContext,
         private readonly sounds: ISoundPlayer<SoundIds>,
         private readonly materials: IMaterialManager
@@ -75,7 +61,6 @@ export class MotaAssetsLoader implements IMotaAssetsLoader {
         this.audioProcessor = new LoadAudioProcessor(ac);
         this.fontProcessor = new LoadFontProcessor();
         this.textProcessor = new LoadTextProcessor();
-        this.jsonProcessor = new LoadJSONProcessor();
         this.zipProcessor = new LoadZipProcessor();
         this.rowSplitter = new TextureRowSplitter();
     }
@@ -469,7 +454,7 @@ export class MotaAssetsLoader implements IMotaAssetsLoader {
             url: `loadList.json`,
             dataType: LoadDataType.JSON,
             identifier: '@system-loadList',
-            processor: this.jsonProcessor,
+            processor: this.dataLoader.jsonProcessor,
             progress: { onProgress() {} }
         });
 
@@ -505,27 +490,15 @@ export class MotaAssetsLoader implements IMotaAssetsLoader {
         task: ILoadTask<LoadDataType, R>,
         onLoaded: CustomLoadFunc<R>
     ): Promise<R> {
-        this.progress.addTask(task);
-        const { promise, resolve } = Promise.withResolvers<R>();
-        const store: LoadTaskStore<LoadDataType, R> = {
-            task,
-            onLoaded,
-            loadPromise: promise,
-            loadResolve: resolve
-        };
-        this.tasks.add(store);
-        return promise;
+        return this.dataLoader.addCustomLoadTask(task, onLoaded);
     }
 
-    load(): Promise<any[]> {
-        const tasks = [...this.tasks].map(async task => {
-            task.task.start();
-            const data = await task.task.loaded();
-            await task.onLoaded(data);
-            task.loadResolve(data);
-            return data;
-        });
-        return Promise.all(tasks);
+    async load(): Promise<void> {
+        this.loading = true;
+        this.loaded = false;
+        await this.dataLoader.load();
+        this.loading = false;
+        this.loaded = true;
     }
 
     //#endregion

packages-user/client-base/src/load/types.ts

@@ -57,8 +57,6 @@ export interface IMotaAssetsLoader {
     >;
     /** 文字处理器 */
     readonly textProcessor: ILoadTaskProcessor<LoadDataType.Text, string>;
-    /** JSON 处理器 */
-    readonly jsonProcessor: ILoadTaskProcessor<LoadDataType.JSON, any>;
     /** `zip` 压缩包处理器 */
     readonly zipProcessor: ILoadTaskProcessor<LoadDataType.ArrayBuffer, JSZip>;
 
@@ -82,5 +80,5 @@ export interface IMotaAssetsLoader {
      * 开始所有加载任务的加载工作
      * @returns 一个 `Promise`，当所有加载任务加载完成后兑现
      */
-    load(): Promise<any[]>;
+    load(): Promise<void>;
 }

packages-user/data-base/package.json

@@ -1,6 +1,7 @@
 {
     "name": "@user/data-base",
     "dependencies": {
-        "@motajs/types": "workspace:*"
+        "@motajs/types": "workspace:*",
+        "@motajs/loader": "workspace:*"
     }
-}
+}

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

@@ -1 +1,4 @@
+export * from './load';
+
 export * from './game';
+export * from './ins';

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

@@ -0,0 +1,11 @@
+import { LoadProgressTotal } from '@motajs/loader';
+import { MotaDataLoader } from './load';
+
+//#region 加载实例
+
+/** 加载进度 */
+export const loadProgress = new LoadProgressTotal();
+/** 数据端加载对象 */
+export const dataLoader = new MotaDataLoader(loadProgress);
+
+//#endregion

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

@@ -0,0 +1,3 @@
+export * from './loader';
+export * from './processor';
+export * from './types';

packages-user/data-base/src/load/loader.ts

@@ -0,0 +1,63 @@
+import {
+    ILoadProgressTotal,
+    LoadDataType,
+    ILoadTask,
+    ILoadTaskProcessor
+} from '@motajs/loader';
+import { CustomLoadFunc, IMotaDataLoader } from './types';
+import { LoadJSONProcessor } from './processor';
+
+interface LoadTaskStore<T extends LoadDataType = LoadDataType, R = any> {
+    /** 加载任务对象 */
+    readonly task: ILoadTask<T, R>;
+    /** 当 `onLoaded` 兑现后兑现的 `Promise` */
+    readonly loadPromise: Promise<R>;
+    /** 兑现 `loadPromise` */
+    readonly loadResolve: (data: R) => void;
+    /** 当加载任务完成时执行的函数 */
+    readonly onLoaded: CustomLoadFunc<R>;
+}
+
+export class MotaDataLoader implements IMotaDataLoader {
+    /** 当前已添加的加载任务 */
+    private readonly tasks: Set<LoadTaskStore> = new Set();
+
+    readonly jsonProcessor: ILoadTaskProcessor<LoadDataType.JSON, any>;
+
+    constructor(readonly progress: ILoadProgressTotal) {
+        this.jsonProcessor = new LoadJSONProcessor();
+    }
+
+    //#region 对外接口
+
+    initSystemLoadTask(): void {}
+
+    addCustomLoadTask<R>(
+        task: ILoadTask<LoadDataType, R>,
+        onLoaded: CustomLoadFunc<R>
+    ): Promise<R> {
+        this.progress.addTask(task);
+        const { promise, resolve } = Promise.withResolvers<R>();
+        const store: LoadTaskStore<LoadDataType, R> = {
+            task,
+            onLoaded,
+            loadPromise: promise,
+            loadResolve: resolve
+        };
+        this.tasks.add(store);
+        return promise;
+    }
+
+    async load(): Promise<void> {
+        const tasks = [...this.tasks].map(async task => {
+            task.task.start();
+            const data = await task.task.loaded();
+            await task.onLoaded(data);
+            task.loadResolve(data);
+            return data;
+        });
+        await Promise.all(tasks);
+    }
+
+    //#endregion
+}

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

@@ -0,0 +1,38 @@
+import {
+    ILoadProgressTotal,
+    ILoadTask,
+    ILoadTaskProcessor,
+    LoadDataType
+} from '@motajs/loader';
+
+export type CustomLoadFunc<R> = (data: R) => Promise<void>;
+
+export interface IMotaDataLoader {
+    /** 加载进度对象 */
+    readonly progress: ILoadProgressTotal;
+
+    /** json 处理器 */
+    readonly jsonProcessor: ILoadTaskProcessor<LoadDataType.JSON, any>;
+
+    /**
+     * 初始化系统加载任务
+     */
+    initSystemLoadTask(): void;
+
+    /**
+     * 添加自定义加载任务
+     * @param task 自定义加载任务
+     * @param onLoad 当任务加载完成时执行
+     * @returns 一个 `Promise`，当添加的任务加载完毕，且 `onLoad` 返回的 `Promise` 兑现后兑现
+     */
+    addCustomLoadTask<R>(
+        task: ILoadTask<LoadDataType, R>,
+        onLoad: CustomLoadFunc<R>
+    ): Promise<R>;
+
+    /**
+     * 开始所有加载任务的加载工作
+     * @returns 一个 `Promise`，当所有加载任务加载完成后兑现
+     */
+    load(): Promise<void>;
+}