@gongxh/bit-core 0.0.1

package/README.md

@@ -0,0 +1,75 @@
+# bit-core
+bit-framework库的核心部分
+
+#### 版本支持
+- creator 3.7之前的版本理论上也支持，未测试
+- creator 3.7+ 支持
+- creator 3.8+ 支持
+
+>  此项目是框架源码，不是creator项目
+>
+> demo见最下方仓库地址
+
+## 安装bit-core
+
+项目已发布到 `npm`, 安装方法如下：
+
+```bash
+npm install bit-core
+```
+
+> 如果连不上npm, 可使用国内镜像 比如: 淘宝、腾讯、华为
+
+```bash
+# 官方
+npm set registry https://registry.npmjs.org
+# 中国镜像站（用这个就行）
+npm set registry https://registry.npmmirror.com/
+#腾讯
+npm set registry https://mirrors.cloud.tencent.com/npm/
+# 华为
+npm set registry https://repo.huaweicloud.com/repository/npm/
+# 阿里
+npm set registry https://npm.aliyun.com
+```
+
+# 集成目录
+1. [使用教程 (新手必看)](./docs/Noviciate.md)
+2. [项目配置](./docs/Basic.md)
+3. [UI模块](./docs/UI.md)
+4. [全局计时器](./docs/Timer.md)
+5. [平台工具](./docs/Platform.md)
+6. [屏幕尺寸](./docs/Screen.md)
+7. [小工具](./docs/Tools.md)
+8. [时间](./docs/Time.md)
+9. [小游戏接口封装](./docs/MiniGame.md)
+10. [热更新](./docs/HotUpdate.md)
+11. [条件显示节点 (一般用于UI上的红点)](./docs/Condition.md)
+12. [数据模块](./docs/Data.md)
+
+# 独立模块目录
+1. [ec模块](https://github.com/Gongxh0901/kunpo-ec)
+2. [ecs模块](https://github.com/Gongxh0901/kunpo-esc)
+3. [网络模块 http和socket](https://github.com/Gongxh0901/bit-core-net)
+4. [四叉树](https://github.com/Gongxh0901/kunpo-quadtree)
+5. [行为树](https://github.com/Gongxh0901/bit-core-behaviortree)
+6. [资源管理](https://github.com/Gongxh0901/bit-core-assets)
+7. [全局事件](https://github.com/Gongxh0901/bit-core-event)
+## 类型支持
+
+该库完全使用 TypeScript 编写，提供完整的类型定义文件。
+
+## 许可证
+
+ISC License
+
+## 作者
+
+gongxh
+
+## 联系作者
+
+*  邮箱: gong.xinhai@163.com
+
+## 源码仓库
+[bit-core github地址](https://github.com/Gongxh0901/bit-framework)

package/dist/bit-core.cjs

@@ -0,0 +1,448 @@
+'use strict';
+
+var cc = require('cc');
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-08
+ * @Description: 窗口的一些类型配置
+ */
+/** 是否开启调试模式 */
+let KUNPO_DEBUG = false;
+/**
+ * 启用或禁用调试模式。
+ * @param enable - 如果为 true，则启用调试模式；如果为 false，则禁用调试模式。不设置默认不开启
+ */
+function enableDebugMode(enable) {
+    if (enable == true) {
+        KUNPO_DEBUG = true;
+        console.warn("调试模式已开启");
+    }
+    else {
+        KUNPO_DEBUG = false;
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-05
+ * @Description: log相关的api
+ */
+function log(...args) {
+    console.log("bit-framework:", ...args);
+}
+/**
+ * 开启debug模式后 输出调试信息
+ * @param args
+ */
+function debug(...args) {
+    KUNPO_DEBUG && console.log("bit-framework:", ...args);
+}
+/**
+ * 信息性消息 某些浏览器中会带有小图标，但颜色通常与 log 相同
+ * @param args
+ */
+function info(...args) {
+    KUNPO_DEBUG && console.info("bit-framework:", ...args);
+}
+/**
+ * 警告信息 黄色背景，通常带有警告图标
+ * @param args
+ */
+function warn(...args) {
+    KUNPO_DEBUG && console.warn("bit-framework:", ...args);
+}
+/**
+ * 错误消息 红色背景，通常带有错误图标
+ * @param args
+ */
+function error(...args) {
+    KUNPO_DEBUG && console.error("bit-framework:", ...args);
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description: 平台相关
+ */
+exports.PlatformType = void 0;
+(function (PlatformType) {
+    PlatformType[PlatformType["Android"] = 1] = "Android";
+    PlatformType[PlatformType["IOS"] = 2] = "IOS";
+    PlatformType[PlatformType["HarmonyOS"] = 3] = "HarmonyOS";
+    /** 微信小游戏 */
+    PlatformType[PlatformType["WX"] = 4] = "WX";
+    /** 支付宝小游戏 */
+    PlatformType[PlatformType["Alipay"] = 5] = "Alipay";
+    /** 字节小游戏 */
+    PlatformType[PlatformType["Bytedance"] = 6] = "Bytedance";
+    /** 华为快游戏 */
+    PlatformType[PlatformType["HuaweiQuick"] = 7] = "HuaweiQuick";
+    /** 其他都为Browser */
+    PlatformType[PlatformType["Browser"] = 1001] = "Browser";
+})(exports.PlatformType || (exports.PlatformType = {}));
+class Platform {
+}
+/**
+ * 是否为原生平台
+ * @type {boolean}
+ */
+Platform.isNative = false;
+/**
+ * 是否为移动平台
+ * @type {boolean}
+ */
+Platform.isMobile = false;
+/**
+ * 是否为原生移动平台
+ * @type {boolean}
+ */
+Platform.isNativeMobile = false;
+/**
+ * 是否为安卓平台
+ * @type {boolean}
+ */
+Platform.isAndroid = false;
+/**
+ * 是否为IOS平台
+ * @type {boolean}
+ */
+Platform.isIOS = false;
+/**
+ * 是否为HarmonyOS平台
+ * @type {boolean}
+ */
+Platform.isHarmonyOS = false;
+/**
+ * 是否为微信小游戏
+ * @type {boolean}
+ */
+Platform.isWX = false;
+/**
+ * 是否为支付宝小游戏
+ * @type {boolean}
+ */
+Platform.isAlipay = false;
+/**
+ * 是否为字节小游戏
+ * @type {boolean}
+ */
+Platform.isBytedance = false;
+/**
+ * 是否是华为快游戏
+ * @type {boolean}
+ */
+Platform.isHuaweiQuick = false;
+/**
+ * 是否为浏览器
+ * @type {boolean}
+ */
+Platform.isBrowser = false;
+/**
+ * 平台初始化器
+ * @internal
+ */
+class PlatformInitializer {
+    constructor() {
+        this.initPlatform();
+    }
+    /**
+     * 初始化平台
+     * @internal
+     */
+    initPlatform() {
+        // 处理平台判断
+        Platform.isNative = cc.sys.isNative;
+        Platform.isMobile = cc.sys.isMobile;
+        Platform.isNativeMobile = cc.sys.isNative && cc.sys.isMobile;
+        switch (cc.sys.os) {
+            case cc.sys.OS.ANDROID:
+                Platform.isAndroid = true;
+                debug("系统类型 Android");
+                break;
+            case cc.sys.OS.IOS:
+                Platform.isIOS = true;
+                debug("系统类型 IOS");
+                break;
+            case cc.sys.OS.OPENHARMONY:
+                Platform.isHarmonyOS = true;
+                debug("系统类型 HarmonyOS");
+                break;
+        }
+        switch (cc.sys.platform) {
+            case cc.sys.Platform.WECHAT_GAME:
+                Platform.isWX = true;
+                Platform.platform = exports.PlatformType.WX;
+                break;
+            case cc.sys.Platform.ALIPAY_MINI_GAME:
+                Platform.isAlipay = true;
+                Platform.platform = exports.PlatformType.Alipay;
+                break;
+            case cc.sys.Platform.BYTEDANCE_MINI_GAME:
+                Platform.isBytedance = true;
+                Platform.platform = exports.PlatformType.Bytedance;
+                break;
+            case cc.sys.Platform.HUAWEI_QUICK_GAME:
+                Platform.isHuaweiQuick = true;
+                Platform.platform = exports.PlatformType.HuaweiQuick;
+                break;
+            default:
+                // 其他都设置为浏览器
+                Platform.isBrowser = true;
+                Platform.platform = exports.PlatformType.Browser;
+                break;
+        }
+        debug(`platform: ${exports.PlatformType[Platform.platform]}`);
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-08
+ * @Description: 屏幕尺寸信息接口
+ */
+class Screen {
+}
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+function __decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description: 适配用的类
+ */
+class Adapter {
+    constructor() {
+        this.listeners = [];
+    }
+    /**
+     * 外部监听屏幕尺寸发生变化
+     * @param listener 监听器
+     * @internal
+     */
+    addResizeListener(listener) {
+        this.listeners.push(listener);
+    }
+    /**
+     * 初始化适配器
+     * @internal
+     */
+    init() {
+        Adapter.instance = this;
+        debug("初始化适配器");
+        // 设计尺寸 不会变化
+        let designSize = this.getDesignSize();
+        Screen.DesignHeight = designSize.height;
+        Screen.DesignWidth = designSize.width;
+        cc.view.setDesignResolutionSize(Screen.DesignWidth, Screen.DesignHeight, cc.ResolutionPolicy.SHOW_ALL);
+        this.resize();
+        this.registerListener((...args) => {
+            debug("屏幕发生变化", ...args);
+            this.resize();
+            // 通知所有监听器
+            for (const listener of this.listeners) {
+                listener(...args);
+            }
+        });
+    }
+    /**
+     * 调整屏幕尺寸
+     * @internal
+     */
+    resize() {
+        Screen.SafeAreaHeight = 60;
+        // 屏幕像素尺寸
+        const winSize = this.getScreenSize();
+        const isDesignLandscape = Screen.DesignWidth > Screen.DesignHeight;
+        const isLandscape = winSize.width > winSize.height;
+        if (isDesignLandscape == isLandscape) {
+            Screen.ScreenWidth = winSize.width;
+            Screen.ScreenHeight = winSize.height;
+        }
+        else {
+            Screen.ScreenWidth = winSize.height;
+            Screen.ScreenHeight = winSize.width;
+        }
+        if (isDesignLandscape) {
+            // 横屏
+            /** 安全区的宽度 */
+            Screen.SafeWidth = Screen.ScreenWidth - Screen.SafeAreaHeight * 2;
+            /** 安全区的高度 */
+            Screen.SafeHeight = Screen.ScreenHeight;
+        }
+        else {
+            // 竖屏
+            /** 安全区的宽度 */
+            Screen.SafeWidth = Screen.ScreenWidth;
+            /** 安全区的高度 */
+            Screen.SafeHeight = Screen.ScreenHeight - Screen.SafeAreaHeight * 2;
+        }
+        this.printScreen();
+    }
+    /**
+     * 打印屏幕信息
+     * @internal
+     */
+    printScreen() {
+        debug(`设计分辨率: ${Screen.DesignWidth}x${Screen.DesignHeight}`);
+        debug(`屏幕分辨率: ${Screen.ScreenWidth}x${Screen.ScreenHeight}`);
+        debug(`安全区域高度: ${Screen.SafeAreaHeight}`);
+        debug(`安全区宽高: ${Screen.SafeWidth}x${Screen.SafeHeight}`);
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-08
+ * @Description:
+ */
+class CocosAdapter extends Adapter {
+    /**
+     * 获取屏幕像素尺寸
+     * @returns {Size}
+     * @internal
+     */
+    getScreenSize() {
+        let windowSize = cc.screen.windowSize;
+        let width = Math.ceil(windowSize.width / cc.view.getScaleX());
+        let height = Math.ceil(windowSize.height / cc.view.getScaleY());
+        return { width, height };
+    }
+    /**
+     * 获取设计尺寸
+     * @returns {Size}
+     * @internal
+     */
+    getDesignSize() {
+        let designSize = cc.view.getDesignResolutionSize();
+        return { width: designSize.width, height: designSize.height };
+    }
+    /**
+     * 设置尺寸发生变化的监听
+     * @param callback 回调
+     * @internal
+     */
+    registerListener(listener) {
+        if (cc.screen && cc.screen.on) {
+            cc.screen.on("window-resize", (...args) => {
+                debug("window-resize");
+                listener(...args);
+            }, this);
+            cc.screen.on("orientation-change", (...args) => {
+                debug("orientation-change");
+                listener(...args);
+            }, this);
+            cc.screen.on("fullscreen-change", (...args) => {
+                debug("fullscreen-change");
+                listener(...args);
+            }, this);
+        }
+        else {
+            // 3.8.0之前的版本
+            cc.view.setResizeCallback(listener);
+        }
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description: cocos UI模块
+ */
+class Module extends cc.Component {
+    /**
+     * 模块初始化 (内部使用)
+     * @internal
+     */
+    init() {
+        this.onInit();
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description:cocos游戏入口 定义了游戏启动时的基本配置和初始化流程。
+ */
+const { property } = cc._decorator;
+class CocosEntry extends cc.Component {
+    constructor() {
+        super(...arguments);
+        this.fps = 60;
+        this.enableDebug = false;
+    }
+    /**
+     * 开始初始化kunpo框架
+     * @internal
+     */
+    start() {
+        // 是否开启调试输出
+        this.enableDebug && enableDebugMode(true);
+        debug("开始初始化【bit-framework】");
+        // 设置游戏真帧率
+        cc.game.frameRate = this.fps;
+        cc.director.addPersistRootNode(this.node);
+        this.node.setSiblingIndex(this.node.children.length - 1);
+        // 平台信息初始化
+        new PlatformInitializer();
+        // 适配器
+        new CocosAdapter().init();
+        this.initModule();
+        debug("【bit-framework】初始化完成");
+        this.onInit();
+    }
+    /**
+     * 初始化模块
+     * @internal
+     */
+    initModule() {
+        const modules = this.getComponentsInChildren(Module);
+        for (const module of modules) {
+            module.init();
+        }
+    }
+}
+__decorate([
+    property({ displayName: "游戏帧率" })
+], CocosEntry.prototype, "fps", void 0);
+__decorate([
+    property({ displayName: "开启调试输出" })
+], CocosEntry.prototype, "enableDebug", void 0);
+
+exports.CocosEntry = CocosEntry;
+exports.Module = Module;
+exports.Platform = Platform;
+exports.Screen = Screen;
+exports.debug = debug;
+exports.enableDebugMode = enableDebugMode;
+exports.error = error;
+exports.info = info;
+exports.log = log;
+exports.warn = warn;

package/dist/bit-core.d.ts

@@ -0,0 +1,182 @@
+import { Component } from 'cc';
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description: 平台相关
+ */
+declare enum PlatformType {
+    Android = 1,
+    IOS = 2,
+    HarmonyOS = 3,
+    /** 微信小游戏 */
+    WX = 4,
+    /** 支付宝小游戏 */
+    Alipay = 5,
+    /** 字节小游戏 */
+    Bytedance = 6,
+    /** 华为快游戏 */
+    HuaweiQuick = 7,
+    /** 其他都为Browser */
+    Browser = 1001
+}
+declare class Platform {
+    /**
+     * 是否为原生平台
+     * @type {boolean}
+     */
+    static isNative: boolean;
+    /**
+     * 是否为移动平台
+     * @type {boolean}
+     */
+    static isMobile: boolean;
+    /**
+     * 是否为原生移动平台
+     * @type {boolean}
+     */
+    static isNativeMobile: boolean;
+    /**
+     * 是否为安卓平台
+     * @type {boolean}
+     */
+    static isAndroid: boolean;
+    /**
+     * 是否为IOS平台
+     * @type {boolean}
+     */
+    static isIOS: boolean;
+    /**
+     * 是否为HarmonyOS平台
+     * @type {boolean}
+     */
+    static isHarmonyOS: boolean;
+    /**
+     * 是否为微信小游戏
+     * @type {boolean}
+     */
+    static isWX: boolean;
+    /**
+     * 是否为支付宝小游戏
+     * @type {boolean}
+     */
+    static isAlipay: boolean;
+    /**
+     * 是否为字节小游戏
+     * @type {boolean}
+     */
+    static isBytedance: boolean;
+    /**
+     * 是否是华为快游戏
+     * @type {boolean}
+     */
+    static isHuaweiQuick: boolean;
+    /**
+     * 是否为浏览器
+     * @type {boolean}
+     */
+    static isBrowser: boolean;
+    /**
+     * 平台类型
+     * @type {PlatformType}
+     */
+    static platform: PlatformType;
+    /**
+     * 设备ID
+     * @type {string}
+     */
+    static deviceId: string;
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-08
+ * @Description: 屏幕尺寸信息接口
+ */
+declare class Screen {
+    /** 屏幕宽度 */
+    static ScreenWidth: number;
+    /** 屏幕高度 */
+    static ScreenHeight: number;
+    /** 设计分辨率宽 */
+    static DesignWidth: number;
+    /** 设计分辨率高 */
+    static DesignHeight: number;
+    /** 安全区外一侧的高度 或 宽度 */
+    static SafeAreaHeight: number;
+    /** 安全区的宽度 */
+    static SafeWidth: number;
+    /** 安全区的高度 */
+    static SafeHeight: number;
+}
+
+/**
+ * 启用或禁用调试模式。
+ * @param enable - 如果为 true，则启用调试模式；如果为 false，则禁用调试模式。不设置默认不开启
+ */
+declare function enableDebugMode(enable: boolean): void;
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-05
+ * @Description: log相关的api
+ */
+declare function log(...args: any[]): void;
+/**
+ * 开启debug模式后 输出调试信息
+ * @param args
+ */
+declare function debug(...args: any[]): void;
+/**
+ * 信息性消息 某些浏览器中会带有小图标，但颜色通常与 log 相同
+ * @param args
+ */
+declare function info(...args: any[]): void;
+/**
+ * 警告信息 黄色背景，通常带有警告图标
+ * @param args
+ */
+declare function warn(...args: any[]): void;
+/**
+ * 错误消息 红色背景，通常带有错误图标
+ * @param args
+ */
+declare function error(...args: any[]): void;
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description:cocos游戏入口 定义了游戏启动时的基本配置和初始化流程。
+ */
+
+declare abstract class CocosEntry extends Component {
+    fps: number;
+    enableDebug: boolean;
+    /**
+     * 虚函数，子类需要实现
+     * kunpo库初始化完成后调用
+     */
+    abstract onInit(): void;
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description: cocos UI模块
+ */
+
+declare abstract class Module extends Component {
+    /**
+     * 模块名称
+     * @type {string}
+     */
+    readonly moduleName: string;
+    /**
+     * 虚函数，子类需要实现
+     * 模块初始化完成后调用的函数
+     * @abstract
+     */
+    protected abstract onInit(): void;
+}
+
+export { CocosEntry, Module, Platform, PlatformType, Screen, debug, enableDebugMode, error, info, log, warn };

package/dist/bit-core.min.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("cc");let t=!1;function i(e){1==e?(t=!0,console.warn("调试模式已开启")):t=!1}function s(...e){t&&console.log("bit-framework:",...e)}var r;exports.PlatformType=void 0,(r=exports.PlatformType||(exports.PlatformType={}))[r.Android=1]="Android",r[r.IOS=2]="IOS",r[r.HarmonyOS=3]="HarmonyOS",r[r.WX=4]="WX",r[r.Alipay=5]="Alipay",r[r.Bytedance=6]="Bytedance",r[r.HuaweiQuick=7]="HuaweiQuick",r[r.Browser=1001]="Browser";class o{}o.isNative=!1,o.isMobile=!1,o.isNativeMobile=!1,o.isAndroid=!1,o.isIOS=!1,o.isHarmonyOS=!1,o.isWX=!1,o.isAlipay=!1,o.isBytedance=!1,o.isHuaweiQuick=!1,o.isBrowser=!1;class n{constructor(){this.initPlatform()}initPlatform(){switch(o.isNative=e.sys.isNative,o.isMobile=e.sys.isMobile,o.isNativeMobile=e.sys.isNative&&e.sys.isMobile,e.sys.os){case e.sys.OS.ANDROID:o.isAndroid=!0,s("系统类型 Android");break;case e.sys.OS.IOS:o.isIOS=!0,s("系统类型 IOS");break;case e.sys.OS.OPENHARMONY:o.isHarmonyOS=!0,s("系统类型 HarmonyOS")}switch(e.sys.platform){case e.sys.Platform.WECHAT_GAME:o.isWX=!0,o.platform=exports.PlatformType.WX;break;case e.sys.Platform.ALIPAY_MINI_GAME:o.isAlipay=!0,o.platform=exports.PlatformType.Alipay;break;case e.sys.Platform.BYTEDANCE_MINI_GAME:o.isBytedance=!0,o.platform=exports.PlatformType.Bytedance;break;case e.sys.Platform.HUAWEI_QUICK_GAME:o.isHuaweiQuick=!0,o.platform=exports.PlatformType.HuaweiQuick;break;default:o.isBrowser=!0,o.platform=exports.PlatformType.Browser}s(`platform: ${exports.PlatformType[o.platform]}`)}}class a{}function c(e,t,i,s){var r,o=arguments.length,n=o<3?t:null===s?s=Object.getOwnPropertyDescriptor(t,i):s;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)n=Reflect.decorate(e,t,i,s);else for(var a=e.length-1;a>=0;a--)(r=e[a])&&(n=(o<3?r(n):o>3?r(t,i,n):r(t,i))||n);return o>3&&n&&Object.defineProperty(t,i,n),n}"function"==typeof SuppressedError&&SuppressedError;class l{constructor(){this.listeners=[]}addResizeListener(e){this.listeners.push(e)}init(){l.instance=this,s("初始化适配器");let t=this.getDesignSize();a.DesignHeight=t.height,a.DesignWidth=t.width,e.view.setDesignResolutionSize(a.DesignWidth,a.DesignHeight,e.ResolutionPolicy.SHOW_ALL),this.resize(),this.registerListener((...e)=>{s("屏幕发生变化",...e),this.resize();for(const t of this.listeners)t(...e)})}resize(){a.SafeAreaHeight=60;const e=this.getScreenSize(),t=a.DesignWidth>a.DesignHeight;t==e.width>e.height?(a.ScreenWidth=e.width,a.ScreenHeight=e.height):(a.ScreenWidth=e.height,a.ScreenHeight=e.width),t?(a.SafeWidth=a.ScreenWidth-2*a.SafeAreaHeight,a.SafeHeight=a.ScreenHeight):(a.SafeWidth=a.ScreenWidth,a.SafeHeight=a.ScreenHeight-2*a.SafeAreaHeight),this.printScreen()}printScreen(){s(`设计分辨率: ${a.DesignWidth}x${a.DesignHeight}`),s(`屏幕分辨率: ${a.ScreenWidth}x${a.ScreenHeight}`),s(`安全区域高度: ${a.SafeAreaHeight}`),s(`安全区宽高: ${a.SafeWidth}x${a.SafeHeight}`)}}class h extends l{getScreenSize(){let t=e.screen.windowSize;return{width:Math.ceil(t.width/e.view.getScaleX()),height:Math.ceil(t.height/e.view.getScaleY())}}getDesignSize(){let t=e.view.getDesignResolutionSize();return{width:t.width,height:t.height}}registerListener(t){e.screen&&e.screen.on?(e.screen.on("window-resize",(...e)=>{s("window-resize"),t(...e)},this),e.screen.on("orientation-change",(...e)=>{s("orientation-change"),t(...e)},this),e.screen.on("fullscreen-change",(...e)=>{s("fullscreen-change"),t(...e)},this)):e.view.setResizeCallback(t)}}class f extends e.Component{init(){this.onInit()}}const{property:d}=e._decorator;class p extends e.Component{constructor(){super(...arguments),this.fps=60,this.enableDebug=!1}start(){this.enableDebug&&i(!0),s("开始初始化【bit-framework】"),e.game.frameRate=this.fps,e.director.addPersistRootNode(this.node),this.node.setSiblingIndex(this.node.children.length-1),new n,(new h).init(),this.initModule(),s("【bit-framework】初始化完成"),this.onInit()}initModule(){const e=this.getComponentsInChildren(f);for(const t of e)t.init()}}c([d({displayName:"游戏帧率"})],p.prototype,"fps",void 0),c([d({displayName:"开启调试输出"})],p.prototype,"enableDebug",void 0),exports.CocosEntry=p,exports.Module=f,exports.Platform=o,exports.Screen=a,exports.debug=s,exports.enableDebugMode=i,exports.error=function(...e){t&&console.error("bit-framework:",...e)},exports.info=function(...e){t&&console.info("bit-framework:",...e)},exports.log=function(...e){console.log("bit-framework:",...e)},exports.warn=function(...e){t&&console.warn("bit-framework:",...e)};

package/dist/bit-core.min.mjs

@@ -0,0 +1 @@
+import{sys as e,view as i,ResolutionPolicy as t,screen as s,Component as n,_decorator as r,game as o,director as a}from"cc";let c=!1;function h(e){1==e?(c=!0,console.warn("调试模式已开启")):c=!1}function l(...e){console.log("bit-framework:",...e)}function d(...e){c&&console.log("bit-framework:",...e)}function f(...e){c&&console.info("bit-framework:",...e)}function g(...e){c&&console.warn("bit-framework:",...e)}function S(...e){c&&console.error("bit-framework:",...e)}var p;!function(e){e[e.Android=1]="Android",e[e.IOS=2]="IOS",e[e.HarmonyOS=3]="HarmonyOS",e[e.WX=4]="WX",e[e.Alipay=5]="Alipay",e[e.Bytedance=6]="Bytedance",e[e.HuaweiQuick=7]="HuaweiQuick",e[e.Browser=1001]="Browser"}(p||(p={}));class u{}u.isNative=!1,u.isMobile=!1,u.isNativeMobile=!1,u.isAndroid=!1,u.isIOS=!1,u.isHarmonyOS=!1,u.isWX=!1,u.isAlipay=!1,u.isBytedance=!1,u.isHuaweiQuick=!1,u.isBrowser=!1;class w{constructor(){this.initPlatform()}initPlatform(){switch(u.isNative=e.isNative,u.isMobile=e.isMobile,u.isNativeMobile=e.isNative&&e.isMobile,e.os){case e.OS.ANDROID:u.isAndroid=!0,d("系统类型 Android");break;case e.OS.IOS:u.isIOS=!0,d("系统类型 IOS");break;case e.OS.OPENHARMONY:u.isHarmonyOS=!0,d("系统类型 HarmonyOS")}switch(e.platform){case e.Platform.WECHAT_GAME:u.isWX=!0,u.platform=p.WX;break;case e.Platform.ALIPAY_MINI_GAME:u.isAlipay=!0,u.platform=p.Alipay;break;case e.Platform.BYTEDANCE_MINI_GAME:u.isBytedance=!0,u.platform=p.Bytedance;break;case e.Platform.HUAWEI_QUICK_GAME:u.isHuaweiQuick=!0,u.platform=p.HuaweiQuick;break;default:u.isBrowser=!0,u.platform=p.Browser}d(`platform: ${p[u.platform]}`)}}class m{}function b(e,i,t,s){var n,r=arguments.length,o=r<3?i:null===s?s=Object.getOwnPropertyDescriptor(i,t):s;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,i,t,s);else for(var a=e.length-1;a>=0;a--)(n=e[a])&&(o=(r<3?n(o):r>3?n(i,t,o):n(i,t))||o);return r>3&&o&&Object.defineProperty(i,t,o),o}"function"==typeof SuppressedError&&SuppressedError;class H{constructor(){this.listeners=[]}addResizeListener(e){this.listeners.push(e)}init(){H.instance=this,d("初始化适配器");let e=this.getDesignSize();m.DesignHeight=e.height,m.DesignWidth=e.width,i.setDesignResolutionSize(m.DesignWidth,m.DesignHeight,t.SHOW_ALL),this.resize(),this.registerListener((...e)=>{d("屏幕发生变化",...e),this.resize();for(const i of this.listeners)i(...e)})}resize(){m.SafeAreaHeight=60;const e=this.getScreenSize(),i=m.DesignWidth>m.DesignHeight;i==e.width>e.height?(m.ScreenWidth=e.width,m.ScreenHeight=e.height):(m.ScreenWidth=e.height,m.ScreenHeight=e.width),i?(m.SafeWidth=m.ScreenWidth-2*m.SafeAreaHeight,m.SafeHeight=m.ScreenHeight):(m.SafeWidth=m.ScreenWidth,m.SafeHeight=m.ScreenHeight-2*m.SafeAreaHeight),this.printScreen()}printScreen(){d(`设计分辨率: ${m.DesignWidth}x${m.DesignHeight}`),d(`屏幕分辨率: ${m.ScreenWidth}x${m.ScreenHeight}`),d(`安全区域高度: ${m.SafeAreaHeight}`),d(`安全区宽高: ${m.SafeWidth}x${m.SafeHeight}`)}}class A extends H{getScreenSize(){let e=s.windowSize;return{width:Math.ceil(e.width/i.getScaleX()),height:Math.ceil(e.height/i.getScaleY())}}getDesignSize(){let e=i.getDesignResolutionSize();return{width:e.width,height:e.height}}registerListener(e){s&&s.on?(s.on("window-resize",(...i)=>{d("window-resize"),e(...i)},this),s.on("orientation-change",(...i)=>{d("orientation-change"),e(...i)},this),s.on("fullscreen-change",(...i)=>{d("fullscreen-change"),e(...i)},this)):i.setResizeCallback(e)}}class y extends n{init(){this.onInit()}}const{property:O}=r;class W extends n{constructor(){super(...arguments),this.fps=60,this.enableDebug=!1}start(){this.enableDebug&&h(!0),d("开始初始化【bit-framework】"),o.frameRate=this.fps,a.addPersistRootNode(this.node),this.node.setSiblingIndex(this.node.children.length-1),new w,(new A).init(),this.initModule(),d("【bit-framework】初始化完成"),this.onInit()}initModule(){const e=this.getComponentsInChildren(y);for(const i of e)i.init()}}b([O({displayName:"游戏帧率"})],W.prototype,"fps",void 0),b([O({displayName:"开启调试输出"})],W.prototype,"enableDebug",void 0);export{W as CocosEntry,y as Module,u as Platform,p as PlatformType,m as Screen,d as debug,h as enableDebugMode,S as error,f as info,l as log,g as warn};

package/dist/bit-core.mjs

@@ -0,0 +1,437 @@
+import { sys, view, ResolutionPolicy, screen, Component, _decorator, game, director } from 'cc';
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-08
+ * @Description: 窗口的一些类型配置
+ */
+/** 是否开启调试模式 */
+let KUNPO_DEBUG = false;
+/**
+ * 启用或禁用调试模式。
+ * @param enable - 如果为 true，则启用调试模式；如果为 false，则禁用调试模式。不设置默认不开启
+ */
+function enableDebugMode(enable) {
+    if (enable == true) {
+        KUNPO_DEBUG = true;
+        console.warn("调试模式已开启");
+    }
+    else {
+        KUNPO_DEBUG = false;
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-05
+ * @Description: log相关的api
+ */
+function log(...args) {
+    console.log("bit-framework:", ...args);
+}
+/**
+ * 开启debug模式后 输出调试信息
+ * @param args
+ */
+function debug(...args) {
+    KUNPO_DEBUG && console.log("bit-framework:", ...args);
+}
+/**
+ * 信息性消息 某些浏览器中会带有小图标，但颜色通常与 log 相同
+ * @param args
+ */
+function info(...args) {
+    KUNPO_DEBUG && console.info("bit-framework:", ...args);
+}
+/**
+ * 警告信息 黄色背景，通常带有警告图标
+ * @param args
+ */
+function warn(...args) {
+    KUNPO_DEBUG && console.warn("bit-framework:", ...args);
+}
+/**
+ * 错误消息 红色背景，通常带有错误图标
+ * @param args
+ */
+function error(...args) {
+    KUNPO_DEBUG && console.error("bit-framework:", ...args);
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description: 平台相关
+ */
+var PlatformType;
+(function (PlatformType) {
+    PlatformType[PlatformType["Android"] = 1] = "Android";
+    PlatformType[PlatformType["IOS"] = 2] = "IOS";
+    PlatformType[PlatformType["HarmonyOS"] = 3] = "HarmonyOS";
+    /** 微信小游戏 */
+    PlatformType[PlatformType["WX"] = 4] = "WX";
+    /** 支付宝小游戏 */
+    PlatformType[PlatformType["Alipay"] = 5] = "Alipay";
+    /** 字节小游戏 */
+    PlatformType[PlatformType["Bytedance"] = 6] = "Bytedance";
+    /** 华为快游戏 */
+    PlatformType[PlatformType["HuaweiQuick"] = 7] = "HuaweiQuick";
+    /** 其他都为Browser */
+    PlatformType[PlatformType["Browser"] = 1001] = "Browser";
+})(PlatformType || (PlatformType = {}));
+class Platform {
+}
+/**
+ * 是否为原生平台
+ * @type {boolean}
+ */
+Platform.isNative = false;
+/**
+ * 是否为移动平台
+ * @type {boolean}
+ */
+Platform.isMobile = false;
+/**
+ * 是否为原生移动平台
+ * @type {boolean}
+ */
+Platform.isNativeMobile = false;
+/**
+ * 是否为安卓平台
+ * @type {boolean}
+ */
+Platform.isAndroid = false;
+/**
+ * 是否为IOS平台
+ * @type {boolean}
+ */
+Platform.isIOS = false;
+/**
+ * 是否为HarmonyOS平台
+ * @type {boolean}
+ */
+Platform.isHarmonyOS = false;
+/**
+ * 是否为微信小游戏
+ * @type {boolean}
+ */
+Platform.isWX = false;
+/**
+ * 是否为支付宝小游戏
+ * @type {boolean}
+ */
+Platform.isAlipay = false;
+/**
+ * 是否为字节小游戏
+ * @type {boolean}
+ */
+Platform.isBytedance = false;
+/**
+ * 是否是华为快游戏
+ * @type {boolean}
+ */
+Platform.isHuaweiQuick = false;
+/**
+ * 是否为浏览器
+ * @type {boolean}
+ */
+Platform.isBrowser = false;
+/**
+ * 平台初始化器
+ * @internal
+ */
+class PlatformInitializer {
+    constructor() {
+        this.initPlatform();
+    }
+    /**
+     * 初始化平台
+     * @internal
+     */
+    initPlatform() {
+        // 处理平台判断
+        Platform.isNative = sys.isNative;
+        Platform.isMobile = sys.isMobile;
+        Platform.isNativeMobile = sys.isNative && sys.isMobile;
+        switch (sys.os) {
+            case sys.OS.ANDROID:
+                Platform.isAndroid = true;
+                debug("系统类型 Android");
+                break;
+            case sys.OS.IOS:
+                Platform.isIOS = true;
+                debug("系统类型 IOS");
+                break;
+            case sys.OS.OPENHARMONY:
+                Platform.isHarmonyOS = true;
+                debug("系统类型 HarmonyOS");
+                break;
+        }
+        switch (sys.platform) {
+            case sys.Platform.WECHAT_GAME:
+                Platform.isWX = true;
+                Platform.platform = PlatformType.WX;
+                break;
+            case sys.Platform.ALIPAY_MINI_GAME:
+                Platform.isAlipay = true;
+                Platform.platform = PlatformType.Alipay;
+                break;
+            case sys.Platform.BYTEDANCE_MINI_GAME:
+                Platform.isBytedance = true;
+                Platform.platform = PlatformType.Bytedance;
+                break;
+            case sys.Platform.HUAWEI_QUICK_GAME:
+                Platform.isHuaweiQuick = true;
+                Platform.platform = PlatformType.HuaweiQuick;
+                break;
+            default:
+                // 其他都设置为浏览器
+                Platform.isBrowser = true;
+                Platform.platform = PlatformType.Browser;
+                break;
+        }
+        debug(`platform: ${PlatformType[Platform.platform]}`);
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-08
+ * @Description: 屏幕尺寸信息接口
+ */
+class Screen {
+}
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+function __decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description: 适配用的类
+ */
+class Adapter {
+    constructor() {
+        this.listeners = [];
+    }
+    /**
+     * 外部监听屏幕尺寸发生变化
+     * @param listener 监听器
+     * @internal
+     */
+    addResizeListener(listener) {
+        this.listeners.push(listener);
+    }
+    /**
+     * 初始化适配器
+     * @internal
+     */
+    init() {
+        Adapter.instance = this;
+        debug("初始化适配器");
+        // 设计尺寸 不会变化
+        let designSize = this.getDesignSize();
+        Screen.DesignHeight = designSize.height;
+        Screen.DesignWidth = designSize.width;
+        view.setDesignResolutionSize(Screen.DesignWidth, Screen.DesignHeight, ResolutionPolicy.SHOW_ALL);
+        this.resize();
+        this.registerListener((...args) => {
+            debug("屏幕发生变化", ...args);
+            this.resize();
+            // 通知所有监听器
+            for (const listener of this.listeners) {
+                listener(...args);
+            }
+        });
+    }
+    /**
+     * 调整屏幕尺寸
+     * @internal
+     */
+    resize() {
+        Screen.SafeAreaHeight = 60;
+        // 屏幕像素尺寸
+        const winSize = this.getScreenSize();
+        const isDesignLandscape = Screen.DesignWidth > Screen.DesignHeight;
+        const isLandscape = winSize.width > winSize.height;
+        if (isDesignLandscape == isLandscape) {
+            Screen.ScreenWidth = winSize.width;
+            Screen.ScreenHeight = winSize.height;
+        }
+        else {
+            Screen.ScreenWidth = winSize.height;
+            Screen.ScreenHeight = winSize.width;
+        }
+        if (isDesignLandscape) {
+            // 横屏
+            /** 安全区的宽度 */
+            Screen.SafeWidth = Screen.ScreenWidth - Screen.SafeAreaHeight * 2;
+            /** 安全区的高度 */
+            Screen.SafeHeight = Screen.ScreenHeight;
+        }
+        else {
+            // 竖屏
+            /** 安全区的宽度 */
+            Screen.SafeWidth = Screen.ScreenWidth;
+            /** 安全区的高度 */
+            Screen.SafeHeight = Screen.ScreenHeight - Screen.SafeAreaHeight * 2;
+        }
+        this.printScreen();
+    }
+    /**
+     * 打印屏幕信息
+     * @internal
+     */
+    printScreen() {
+        debug(`设计分辨率: ${Screen.DesignWidth}x${Screen.DesignHeight}`);
+        debug(`屏幕分辨率: ${Screen.ScreenWidth}x${Screen.ScreenHeight}`);
+        debug(`安全区域高度: ${Screen.SafeAreaHeight}`);
+        debug(`安全区宽高: ${Screen.SafeWidth}x${Screen.SafeHeight}`);
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-08
+ * @Description:
+ */
+class CocosAdapter extends Adapter {
+    /**
+     * 获取屏幕像素尺寸
+     * @returns {Size}
+     * @internal
+     */
+    getScreenSize() {
+        let windowSize = screen.windowSize;
+        let width = Math.ceil(windowSize.width / view.getScaleX());
+        let height = Math.ceil(windowSize.height / view.getScaleY());
+        return { width, height };
+    }
+    /**
+     * 获取设计尺寸
+     * @returns {Size}
+     * @internal
+     */
+    getDesignSize() {
+        let designSize = view.getDesignResolutionSize();
+        return { width: designSize.width, height: designSize.height };
+    }
+    /**
+     * 设置尺寸发生变化的监听
+     * @param callback 回调
+     * @internal
+     */
+    registerListener(listener) {
+        if (screen && screen.on) {
+            screen.on("window-resize", (...args) => {
+                debug("window-resize");
+                listener(...args);
+            }, this);
+            screen.on("orientation-change", (...args) => {
+                debug("orientation-change");
+                listener(...args);
+            }, this);
+            screen.on("fullscreen-change", (...args) => {
+                debug("fullscreen-change");
+                listener(...args);
+            }, this);
+        }
+        else {
+            // 3.8.0之前的版本
+            view.setResizeCallback(listener);
+        }
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description: cocos UI模块
+ */
+class Module extends Component {
+    /**
+     * 模块初始化 (内部使用)
+     * @internal
+     */
+    init() {
+        this.onInit();
+    }
+}
+
+/**
+ * @Author: Gongxh
+ * @Date: 2024-12-07
+ * @Description:cocos游戏入口 定义了游戏启动时的基本配置和初始化流程。
+ */
+const { property } = _decorator;
+class CocosEntry extends Component {
+    constructor() {
+        super(...arguments);
+        this.fps = 60;
+        this.enableDebug = false;
+    }
+    /**
+     * 开始初始化kunpo框架
+     * @internal
+     */
+    start() {
+        // 是否开启调试输出
+        this.enableDebug && enableDebugMode(true);
+        debug("开始初始化【bit-framework】");
+        // 设置游戏真帧率
+        game.frameRate = this.fps;
+        director.addPersistRootNode(this.node);
+        this.node.setSiblingIndex(this.node.children.length - 1);
+        // 平台信息初始化
+        new PlatformInitializer();
+        // 适配器
+        new CocosAdapter().init();
+        this.initModule();
+        debug("【bit-framework】初始化完成");
+        this.onInit();
+    }
+    /**
+     * 初始化模块
+     * @internal
+     */
+    initModule() {
+        const modules = this.getComponentsInChildren(Module);
+        for (const module of modules) {
+            module.init();
+        }
+    }
+}
+__decorate([
+    property({ displayName: "游戏帧率" })
+], CocosEntry.prototype, "fps", void 0);
+__decorate([
+    property({ displayName: "开启调试输出" })
+], CocosEntry.prototype, "enableDebug", void 0);
+
+export { CocosEntry, Module, Platform, PlatformType, Screen, debug, enableDebugMode, error, info, log, warn };

package/package.json

@@ -0,0 +1,55 @@
+{
+    "name": "@gongxh/bit-core",
+    "version": "0.0.1",
+    "description": "基于creator3.0+的bit-core库",
+    "main": "./dist/bit-core.cjs",
+    "module": "./dist/bit-core.mjs",
+    "types": "./dist/bit-core.d.ts",
+    "exports": {
+        ".": {
+            "require": "./dist/bit-core.cjs",
+            "import": "./dist/bit-core.mjs",
+            "types": "./dist/bit-core.d.ts",
+            "default": "./dist/bit-core.cjs"
+        },
+        "./min": {
+            "require": "./dist/bit-core.min.cjs",
+            "import": "./dist/bit-core.min.mjs"
+        }
+    },
+    "scripts": {
+        "clean": "rm -rf dist",
+        "build": "npm run clean && rollup -c rollup.config.mjs",
+        "copy": "cp -r dist/* demo/node_modules/bit-core/dist/",
+        "build:all": "npm run build && npm run copy"
+    },
+    "files": [
+        "dist/bit-core.cjs",
+        "dist/bit-core.mjs",
+        "dist/bit-core.min.cjs",
+        "dist/bit-core.min.mjs",
+        "dist/bit-core.d.ts"
+    ],
+    "author": "gongxh",
+    "license": "ISC",
+    "repository": {
+        "type": "gitlab",
+        "url": "https://github.com/Gongxh0901/bit-core"
+    },
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org/"
+    },
+    "dependencies": {
+    },
+    "devDependencies": {
+        "@cocos/creator-types": "^3.8.0",
+        "@rollup/plugin-terser": "^0.4.4",
+        "@rollup/plugin-typescript": "^12.1.2",
+        "@types/lodash": "^4.17.13",
+        "@types/node": "^22.10.2",
+        "rollup": "^4.28.1",
+        "rollup-plugin-dts": "^6.1.1",
+        "ts-node": "^10.9.2",
+        "tslib": "^2.6.2"
+    }
+}