hzengine-core 0.1.2-dev

package/dist/storage/index.js

@@ -0,0 +1,442 @@
+// import * as this._core.platform from "@zos/fs";
+import Path from "../utils/path.js";
+// import { isFileSync } from "./fs.js";
+export class Storage {
+    constructor(_core) {
+        this._core = _core;
+        this.projectRoot = null;
+        this.cacheRoot = null;
+        this.saveRoot = null;
+        this.preloadedData = null;
+        this.packageData = null;
+        // Storage Data
+        /**
+         * 全局数据
+         * 其中的数据不会跟随存档保存，而是直接存储在全局数据文件中
+         * 如：设置、CG解锁情况等
+         */
+        this._globalData = null;
+        /**
+         * 存档数据
+         * 其中的数据会跟随存档保存
+         * 如：脚本执行位置即调用栈，攻略度等
+         */
+        this._archiveData = null;
+        /**
+         * 保存全局数据
+         * 可以多次調用，實際上會異步儲存，也就是在一個宏任務中即使調用多次，也只會在宏任務結束後儲存一次
+         */
+        this._saveGlobalDataTimerId = null;
+        this._saveArchiveDataTimerId = null;
+    }
+    loadProject(options) {
+        this._core.emit("beforeLoadProject");
+        if (!this._core.platform.readdirSync({ path: options.projectPath })) {
+            throw "Dir not exist";
+        }
+        this.projectRoot = options.projectPath;
+        this.cacheRoot = options.cachePath;
+        this.saveRoot = options.savePath;
+        this.loadPackageData();
+        this.preload();
+        this._core.emit("afterLoadProject");
+    }
+    loadPackageData() {
+        if (!this.projectRoot)
+            throw "projectDir is null";
+        this._core.debug.log(`loadPackageData ${this.projectRoot} ${Path.join(this.projectRoot, "hz_package.json")}`);
+        if (!this._core.platform.statSync({
+            path: Path.join(this.projectRoot, "hz_package.json"),
+        })) {
+            throw "HZEngine Package File (hz_package.json) not exist";
+        }
+        this.packageData = JSON.parse(this._core.platform.readFileSync({
+            path: Path.join(this.projectRoot, "hz_package.json"),
+            options: { encoding: "utf8" },
+        }));
+    }
+    get globalData() {
+        if (!this._globalData) {
+            this.loadGlobalData();
+        }
+        if (this._globalData == null)
+            throw `[HZEngine] GlobalData is null`;
+        return this._globalData;
+    }
+    /**
+     * alias globalData
+     */
+    get gd() {
+        return this.globalData;
+    }
+    get archiveData() {
+        if (!this._archiveData) {
+            this.loadArchiveData();
+        }
+        if (this._archiveData == null)
+            throw `[HZEngine] ArchiveData is null`;
+        return this._archiveData;
+    }
+    /**
+     * alias archiveData
+     */
+    get sd() {
+        return this.archiveData;
+    }
+    loadGlobalData() {
+        if (!this.saveRoot) {
+            throw "saveDir is null, please loadProject first";
+        }
+        this._core.emit("beforeLoadGlobalData");
+        if (this._core.platform.statSync({
+            path: Path.join(this.saveRoot, "globalData.json"),
+        })) {
+            this._globalData = JSON.parse(this._core.platform.readFileSync({
+                path: Path.join(this.saveRoot, "globalData.json"),
+                options: {
+                    encoding: "utf8",
+                },
+            }));
+            if (this._globalData == null) {
+                this._globalData = {}; // TODO initial GlobalData value
+                this._core.emit("initGlobalData");
+            }
+        }
+        else {
+            this._core.debug.log(`globalData.json not exist, create it.`);
+            this._globalData = {}; // Initial GlobalData value
+            this._core.emit("initGlobalData");
+            this._core.platform.writeFileSync({
+                path: Path.join(this.saveRoot, "globalData.json"),
+                data: JSON.stringify(this._globalData),
+            });
+        }
+        this._core.emit("afterLoadGlobalData");
+    }
+    saveGlobalData() {
+        if (!this.projectRoot) {
+            throw "projectDir is null, please loadProject first";
+        }
+        if (this._saveGlobalDataTimerId)
+            return;
+        this._saveGlobalDataTimerId = setTimeout(() => {
+            this._saveGlobalDataTimerId = null;
+            if (!this.projectRoot) {
+                throw "projectDir is null, please loadProject first";
+            }
+            this._core.emit("beforeSaveGlobalData");
+            let res = this._core.platform.writeFileSync({
+                path: Path.join(this.saveRoot, "globalData.json"),
+                data: JSON.stringify(this._globalData),
+            }); // TODO
+            if (res < 0)
+                throw `[HZEngine] save globalData to globalData.json failed, code = ${res}`;
+            this._core.debug.log(`save globalData to globalData.json`);
+            this._core.emit("afterSaveGlobalData");
+        }, 0);
+    }
+    loadArchiveData(archiveFile) {
+        this._core.emit("beforeLoadArchive");
+        if (archiveFile) {
+            if (!this.saveRoot)
+                throw `saveRoot is null, please loadProject first`;
+            if (!this._core.platform.statSync({
+                path: Path.join(this.saveRoot, archiveFile),
+            })) {
+                throw `Archive [${archiveFile}] not exist`;
+            }
+            let archiveData = JSON.parse(this._core.platform.readFileSync({
+                path: Path.join(this.saveRoot, archiveFile),
+                options: {
+                    encoding: "utf8",
+                },
+            }));
+            if (archiveData == null)
+                throw `[HZEngine] ArchiveData is null`;
+            this._archiveData = archiveData;
+            this._core.debug.log(`load archiveData from ${archiveFile}`);
+            this._core.emit("afterLoadArchive");
+        }
+        else {
+            this._core.debug.log(`load archiveData from empty template`);
+            this._archiveData = {};
+            this._core.emit("initArchiveData");
+        }
+    }
+    /**
+     * 保存存档数据
+     * 可以多次調用，實際上會異步儲存，也就是在一個宏任務中即使調用多次，也只會在宏任務結束後儲存一次
+     * @param archiveFile 存档文件目錄及名字
+     */
+    saveArchiveData(archiveFile, immediate = false) {
+        if (!this.saveRoot)
+            throw `saveRoot is null, please loadProject first`;
+        this._core.emit("beforeSaveArchive");
+        this._core.debug.log("Will save archiveData to " + archiveFile);
+        let saveFunc = () => {
+            this._core.debug.log("Saving archiveData to " + archiveFile);
+            if (!this.saveRoot)
+                throw `projectDir is null, please loadProject first`;
+            let res = this._core.platform.writeFileSync({
+                path: Path.join(this.saveRoot, archiveFile),
+                data: JSON.stringify(this._archiveData),
+            }); //TODO
+            if (res < 0)
+                throw `[HZEngine] save archiveData to ${archiveFile} failed, code = ${res}`;
+            this._core.debug.log(`Save archiveData to ${archiveFile}`);
+            this._core.emit("afterSaveArchive");
+        };
+        if (immediate) {
+            saveFunc();
+            if (this._saveArchiveDataTimerId) {
+                clearTimeout(this._saveArchiveDataTimerId);
+                this._saveArchiveDataTimerId = null;
+            }
+        }
+        else
+            this._saveArchiveDataTimerId = setTimeout(() => {
+                this._saveArchiveDataTimerId = null;
+                saveFunc();
+            }, 0);
+    }
+    getSaveableData(data, auto_correct, ...key_chain) {
+        let obj = data;
+        // if(obj == null) throw `[HZEngine] saveable data is null`
+        for (let key of key_chain) {
+            if (obj == null)
+                throw Error(`[HZEngine] saveable data is null`);
+            if (typeof obj !== "object")
+                throw Error(`[HZEngine] saveable data is not object`);
+            if (Array.isArray(obj))
+                throw Error(`[HZEngine] saveable data is array`);
+            if (!obj[key]) {
+                if (auto_correct) {
+                    obj[key] = {};
+                }
+                else
+                    throw Error(`[HZEngine] saveable data key ${key} not exist`);
+            }
+            obj = obj[key];
+        }
+        if (obj == null)
+            throw Error(`[HZEngine] saveable data result obj is null`);
+        // if (typeof obj !== "object")
+        // throw Error(`[HZEngine] saveable data result obj is not array or object`);
+        // if (Array.isArray(obj)) throw Error(`[HZEngine] saveable data result is an array, key_chain = ${key_chain.join(".")}, res = ${JSON.stringify(obj)}`);
+        return obj;
+    }
+    setSaveableData(data, auto_correct, value, ...key_chain) {
+        this._core.debug.log(`setSaveableData ${key_chain} => ${JSON.stringify(value)}`);
+        if (key_chain.length == 0)
+            throw `key_chain is empty`;
+        let parentObj = this.getSaveableData(data, auto_correct, ...key_chain.slice(0, -1));
+        if (parentObj == null)
+            throw `[HZEngine] saveable data is null`;
+        if (typeof parentObj !== "object")
+            throw `[HZEngine] saveable data is not object`;
+        if (Array.isArray(parentObj))
+            throw `[HZEngine] saveable data is array`;
+        parentObj[key_chain[key_chain.length - 1]] = value;
+    }
+    checkSaveableData(data, ...key_chain) {
+        return this.getSaveableData(data, false, ...key_chain);
+    }
+    // Preload
+    preload() {
+        if (!this.cacheRoot) {
+            throw "cacheRoot is null, please loadProject first";
+        }
+        // writeFileSync({path: "data://test.json", data: "awa", options: {encoding: "utf8"}});
+        if (this._core.platform.statSync({
+            path: Path.join(this.cacheRoot, "preloaded.json"),
+        })) {
+            // 已经预加载过了，退出
+            this.preloadedData = JSON.parse(this._core.platform.readFileSync({
+                path: Path.join(this.cacheRoot, "preloaded.json"),
+                options: {
+                    encoding: "utf8",
+                },
+            }));
+            return;
+        }
+        this.preloadedData = {
+            script: {
+                labelMap: {},
+                hzsInfoMap: {},
+            },
+            image: {
+                nameMap: {},
+            },
+            animation: {
+                profileMap: {},
+            },
+        };
+        this.preloadScript();
+        this.preloadImage();
+        this.preloadAnimation();
+        // console.log(JSON.stringify(this.preloadedData));
+        this._core.platform.writeFileSync({
+            path: Path.join(this.cacheRoot, "preloaded.json"),
+            data: JSON.stringify(this.preloadedData),
+        });
+        // console.log(
+        //   `${Path.join(this.projectDir, "preloaded.json")} = ${readFileSync({
+        //     path: Path.join(this.projectDir, "preloaded.json"),
+        //     options:{encoding:"utf8"}
+        //   })}`
+        // );
+    }
+    /**
+     * 预加载脚本
+     * 遍历出所有hzs文件和所有label，建立map
+     */
+    preloadScript() {
+        // TODO
+        // 记录脚本label的位置
+        // 这里的index是以0开始计数的行数
+        let labelMap = this.preloadedData.script.labelMap;
+        let scriptDir = Path.join(this.projectRoot, "script");
+        let hzsInfoMap = this.preloadedData.script.hzsInfoMap;
+        if (!this._core.platform.readdirSync({ path: scriptDir }))
+            throw "项目文件夹中script文件夹不存在";
+        /**
+     * 1. 预加载所有的label并检查冲突
+     * 2. 记录所有脚本文件的行数
+     */
+        const preloadHzs = (path) => {
+            // let fd = this._core.platform.openSync({ path });
+            // if (fd < 0) throw "Fd<0";
+            // let size = this._core.platform.statSync({ path })!.size;
+            // let arrbuf = new ArrayBuffer(size);
+            // this._core.platform.readSync({ fd, buffer: arrbuf });
+            // let buffer = Buffer.from(arrbuf);
+            // let contentStr = buffer.toString();
+            let contentStr = this._core.platform.readFileSync({ path, options: { encoding: "utf8" } });
+            let contentLines = contentStr.split("\n");
+            let totalLines = contentLines.length;
+            hzsInfoMap[path] = { totalLines };
+            for (let i = 0; i < totalLines; ++i) {
+                let line = contentLines[i].trim();
+                if (line.startsWith("*")) {
+                    let len = line.length, p = 1, q;
+                    while (p < len && line.charAt(p) === " ")
+                        ++p;
+                    if (p === len)
+                        throw `Lost Label Name at file(${path}) line(${i + 1})`;
+                    q = p;
+                    while (q < len && line.charAt(q) !== " ")
+                        ++q;
+                    // [p, q)
+                    let label = line.slice(p, q);
+                    if (labelMap[label]) {
+                        throw `Label name "${label}" conflict : \
+    at [${labelMap[label][0]}(line ${labelMap[label][1]})] \
+    [${path}(line ${i + 1})]`;
+                    }
+                    labelMap[label] = [path, i];
+                }
+            }
+        };
+        // 遍历所有hzs文件
+        const traverseScript = (path) => {
+            let dirs = this._core.platform.readdirSync({ path });
+            // console.log(dirs);
+            for (let dir of dirs) {
+                let subpath = Path.join(path, dir);
+                if (this._core.platform.isFileSync({ path: subpath })) {
+                    // 是文件
+                    if (dir.endsWith(".hzs")) {
+                        preloadHzs(subpath);
+                    }
+                }
+                else {
+                    // 是目录
+                    traverseScript(subpath);
+                }
+            }
+        };
+        traverseScript(scriptDir);
+    }
+    /**
+     * 预加载资源
+     * 遍历所有png文件，计算对应的name key，建立map
+     */
+    preloadImage() {
+        let nameMap = this.preloadedData.image.nameMap;
+        let imageDir = Path.join(this.projectRoot, "image");
+        if (!this._core.platform.readdirSync({ path: imageDir }))
+            throw "项目文件夹中image文件夹不存在";
+        /**
+         * 1. 预加载所有的image并检查冲突
+         * 2. 记录所有image的name key和路径
+         */
+        function preloadImage(path) {
+            let raw_name = Path.parse(path).name;
+            let name_key = raw_name
+                .trim()
+                .replace("_", " ")
+                .replace(/ +/, " ")
+                .toLowerCase();
+            if (nameMap[name_key])
+                throw `Image name key conflict [${name_key}], at file [${path}] and [${nameMap[name_key]}]`;
+            nameMap[name_key] = [path];
+        }
+        // 遍历所有hzs文件
+        const traverseImage = (path) => {
+            let dirs = this._core.platform.readdirSync({ path });
+            // console.log(dirs);
+            for (let dir of dirs) {
+                let subpath = Path.join(path, dir);
+                if (this._core.platform.isFileSync({ path: subpath })) {
+                    // 是文件
+                    if (dir.endsWith(".png")) {
+                        preloadImage(subpath);
+                    }
+                }
+                else {
+                    // 是目录
+                    traverseImage(subpath);
+                }
+            }
+        };
+        traverseImage(imageDir);
+        // console.log(
+        //   `Preloaded image: ${JSON.stringify(this.preloadedData.image.nameMap)}`
+        // );
+    }
+    /**
+     * 預加載動畫profile
+     * 遍歷animation文件夾下的所有json文件，以文件名為key，json内容為value
+     */
+    preloadAnimation() {
+        let profileMap = this.preloadedData.animation.profileMap;
+        let animationDir = Path.join(this.projectRoot, "animation");
+        if (!this._core.platform.readdirSync({ path: animationDir }))
+            throw "项目文件夹中animation文件夹不存在";
+        function preloadAnimation(path) {
+            let raw_name = Path.parse(path).name;
+            let name_key = raw_name.trim().replace(/ +/, "_");
+            if (profileMap[name_key])
+                throw `Animation profile name key conflict [${name_key}], at file [${path}] and [${profileMap[name_key]}]`;
+            profileMap[name_key] = [path];
+        }
+        const traverseAnimation = (path) => {
+            let dirs = this._core.platform.readdirSync({ path });
+            // console.log(dirs);
+            for (let dir of dirs) {
+                let subpath = Path.join(path, dir);
+                if (this._core.platform.isFileSync({ path: subpath })) {
+                    // 是文件
+                    if (dir.endsWith(".json")) {
+                        preloadAnimation(subpath);
+                    }
+                }
+                else {
+                    // 是目录
+                    traverseAnimation(subpath);
+                }
+            }
+        };
+        traverseAnimation(animationDir);
+    }
+}

package/dist/system/index.js

@@ -0,0 +1,144 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+import { Save } from "../storage/decorator.js";
+let System = (() => {
+    var _a, _System_condition_accessor_storage;
+    let _condition_decorators;
+    let _condition_initializers = [];
+    let _condition_extraInitializers = [];
+    return _a = class System {
+            constructor(_core) {
+                this._core = _core;
+                _System_condition_accessor_storage.set(this, __runInitializers(this, _condition_initializers, _a.Condition.Free));
+                this._pauseTimer = (__runInitializers(this, _condition_extraInitializers), null);
+                _core.on("system.continue", () => {
+                    this._pauseTimer = null;
+                    this.continue();
+                });
+            }
+            get condition() { return __classPrivateFieldGet(this, _System_condition_accessor_storage, "f"); }
+            set condition(value) { __classPrivateFieldSet(this, _System_condition_accessor_storage, value, "f"); }
+            /**
+             * 暂停(可指定一段时间)
+             * 后调用的会覆盖之前pause的设定时间
+             * @param delayMs
+             */
+            pause(delayMs) {
+                this._core.debug.log(`Pause`);
+                if (this.condition === _a.Condition.Gaming) {
+                    this.condition = _a.Condition.Pause;
+                }
+                else
+                    throw `pause but condition error (todo)`; // TODO
+                if (this._pauseTimer) {
+                    this._core.async.removeTask(this._pauseTimer);
+                    this._pauseTimer = null;
+                }
+                if (delayMs !== undefined) {
+                    this._pauseTimer = this._core.async.addDelayTask("system.continue", [], delayMs);
+                }
+            }
+            /**
+             * 继续由于pause中断的游戏
+             */
+            continue() {
+                if (this.condition !== _a.Condition.Pause)
+                    return;
+                this.condition = _a.Condition.Gaming;
+                this.run();
+            }
+            /**
+             * 阻塞
+             */
+            block() {
+                if (this.condition !== _a.Condition.Gaming)
+                    throw `block but condition error (todo)`;
+                this.condition = _a.Condition.Blocked;
+            }
+            /**
+             * 取消阻塞
+             */
+            unBlock() {
+                if (this.condition !== _a.Condition.Blocked)
+                    return;
+                this.condition = _a.Condition.Gaming;
+                this.run();
+            }
+            run() {
+                this.condition = _a.Condition.Gaming;
+                while (this.condition === _a.Condition.Gaming) {
+                    // console.log("Run Single Line");
+                    this._core.script.runSingleLine();
+                }
+            }
+            start(initLabel = "start") {
+                // 初始化存档
+                this._core.storage.archiveData;
+                this._core.debug.log("Game Start");
+                this._core.script.clear();
+                this._core.script.jumpLabel(initLabel);
+                this.run();
+            }
+        },
+        _System_condition_accessor_storage = new WeakMap(),
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _condition_decorators = [Save("system.condition")];
+            __esDecorate(_a, null, _condition_decorators, { kind: "accessor", name: "condition", static: false, private: false, access: { has: obj => "condition" in obj, get: obj => obj.condition, set: (obj, value) => { obj.condition = value; } }, metadata: _metadata }, _condition_initializers, _condition_extraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
+export { System };
+(function (System) {
+    let Condition;
+    (function (Condition) {
+        Condition[Condition["Free"] = 0] = "Free";
+        Condition[Condition["Pause"] = 1] = "Pause";
+        Condition[Condition["Blocked"] = 2] = "Blocked";
+        Condition[Condition["Gaming"] = 3] = "Gaming";
+    })(Condition = System.Condition || (System.Condition = {}));
+})(System || (System = {}));