sapdon 2.0.2 → 3.0.0

package/dist/core/ui/properties/text.js

@@ -0,0 +1,187 @@
+/**
+ * Text 类
+ *
+ * 该类表示一个文本控件，用于管理文本内容及其样式属性。
+ *
+ * 属性：
+ * - text: string - 文本内容（默认值：空字符串）
+ * - color: Vector [r, g, b] - 文本颜色（RGB 值，范围 0.0 到 1.0，默认值：[1.0, 1.0, 1.0]）
+ * - locked_color: Vector [r, g, b] - 父级禁用时的文本颜色
+ * - shadow: boolean - 是否显示文本阴影（默认值：false）
+ * - hide_hyphen: boolean - 是否隐藏断词连字符（默认值：false）
+ * - notify_on_ellipses: string[] - 文本出现省略号时需通知的控件名称数组
+ * - enable_profanity_filter: boolean - 是否启用脏话过滤（默认值：false）
+ * - locked_alpha: float - 父级禁用时的透明度
+ * - font_size: enum - 字体大小（可能值：small, normal, large, extra_large，默认值：normal）
+ * - font_scale_factor: float - 字体缩放比例（默认值：1.0）
+ * - localize: boolean - 是否启用本地化翻译（默认值：false）
+ * - line_padding: number - 行间距
+ * - font_type: enum - 字体类型（可能值：default, rune, unicode, smooth, MinecraftTen 或自定义字体，默认值：default）
+ * - backup_font_type: enum - 备用字体类型（默认值：default）
+ * - text_alignment: enum - 文本对齐方式（未定义时根据 anchor_from 和 anchor_to 自动调整）
+ */
+export class Text {
+    constructor() {
+        /*
+        this.text = '';
+        this.color = [1.0, 1.0, 1.0];
+        this.locked_color = null;
+        this.shadow = false;
+        this.hide_hyphen = false;
+        this.notify_on_ellipses = [];
+        this.enable_profanity_filter = false;
+        this.locked_alpha = null;
+        this.font_size = 'normal';
+        this.font_scale_factor = 1.0;
+        this.localize = false;
+        this.line_padding = null;
+        this.font_type = 'default';
+        this.backup_font_type = 'default';
+        this.text_alignment = null;
+        */
+    }
+    /**
+     * 设置文本内容。
+     * @param {string} text - 文本内容
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setText(text = '') {
+        this.text = text;
+        return this;
+    }
+    /**
+     * 设置文本颜色。
+     * @param {number[]} color - RGB 颜色值（格式：[r, g, b]，默认值：[1.0, 1.0, 1.0]）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setColor(color = [1.0, 1.0, 1.0]) {
+        this.color = color;
+        return this;
+    }
+    /**
+     * 设置父级禁用时的文本颜色。
+     * @param {number[]} lockedColor - RGB 颜色值（格式：[r, g, b]）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setLockedColor(lockedColor) {
+        this.locked_color = lockedColor;
+        return this;
+    }
+    /**
+     * 设置是否显示文本阴影。
+     * @param {boolean} shadow - 是否显示阴影（默认值：false）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setShadow(shadow = false) {
+        this.shadow = shadow;
+        return this;
+    }
+    /**
+     * 设置是否隐藏断词连字符。
+     * @param {boolean} hide - 是否隐藏连字符（默认值：false）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setHideHyphen(hide = false) {
+        this.hide_hyphen = hide;
+        return this;
+    }
+    /**
+     * 设置文本出现省略号时需通知的控件名称数组。
+     * @param {string[]} controls - 控件名称数组
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setNotifyOnEllipses(controls) {
+        this.notify_on_ellipses = controls;
+        return this;
+    }
+    /**
+     * 添加一个需通知省略号事件的控件名称。
+     * @param {string} controlName - 控件名称
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    addNotifyOnEllipses(controlName) {
+        this.notify_on_ellipses.push(controlName);
+        return this;
+    }
+    /**
+     * 设置是否启用脏话过滤。
+     * @param {boolean} enable - 是否启用过滤（默认值：false）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setEnableProfanityFilter(enable = false) {
+        this.enable_profanity_filter = enable;
+        return this;
+    }
+    /**
+     * 设置父级禁用时的透明度。
+     * @param {number} alpha - 透明度（范围：0.0 到 1.0）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setLockedAlpha(alpha) {
+        this.locked_alpha = alpha;
+        return this;
+    }
+    /**
+     * 设置字体大小。
+     * @param {string} size - 字体大小（可能值：small, normal, large, extra_large，默认值：normal）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setFontSize(size = 'normal') {
+        this.font_size = size;
+        return this;
+    }
+    /**
+     * 设置字体缩放比例。
+     * @param {number} factor - 缩放比例（默认值：1.0）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setFontScaleFactor(factor = 1.0) {
+        this.font_scale_factor = factor;
+        return this;
+    }
+    /**
+     * 设置是否启用本地化翻译。
+     * @param {boolean} localize - 是否启用本地化（默认值：false）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setLocalize(localize = false) {
+        this.localize = localize;
+        return this;
+    }
+    /**
+     * 设置行间距。
+     * @param {number} padding - 行间距
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setLinePadding(padding) {
+        this.line_padding = padding;
+        return this;
+    }
+    /**
+     * 设置字体类型。
+     * @param {string} font - 字体类型（可能值：default, rune, unicode 等，默认值：default）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setFontType(font = 'default') {
+        this.font_type = font;
+        return this;
+    }
+    /**
+     * 设置备用字体类型。
+     * @param {string} backupFont - 备用字体类型（默认值：default）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setBackupFontType(backupFont = 'default') {
+        this.backup_font_type = backupFont;
+        return this;
+    }
+    /**
+     * 设置文本对齐方式。
+     * @param {string} alignment - 对齐方式（例如：left, right, center）
+     * @returns {Text} 返回当前实例以支持链式调用
+     */
+    setTextAlignment(alignment) {
+        this.text_alignment = alignment;
+        return this;
+    }
+}

package/dist/core/ui/registry/uiSystemRegistry.d.ts

@@ -0,0 +1,8 @@
+export class UISystemRegistry {
+    static "__#3@#ui_system_map": Map<any, any>;
+    static "__#3@#ui_def_list": any[];
+    static registerUISystem(ui_system: any): void;
+    static getUISystemList(): any[];
+    static addOuterUIdefs(ui_defs: any): void;
+    static getUIdefList(): any[];
+}

package/dist/core/ui/registry/uiSystemRegistry.js

@@ -0,0 +1,26 @@
+export class UISystemRegistry {
+    // 私有静态字段
+    static #ui_system_map = new Map();
+    static #ui_def_list = [];
+    // 注册 UISystem
+    static registerUISystem(ui_system) {
+        const ui_system_path = ui_system.path + ui_system.name + ".json";
+        this.#ui_system_map.set(ui_system_path, ui_system);
+    }
+    // 获取所有注册的 UISystem
+    static getUISystemList() {
+        return Array.from(this.#ui_system_map.values());
+    }
+    // 添加外部 UI 定义
+    static addOuterUIdefs(ui_defs) {
+        if (!Array.isArray(ui_defs)) {
+            throw new Error("参数必须是一个数组");
+        }
+        this.#ui_def_list = this.#ui_def_list.concat(ui_defs);
+    }
+    // 获取 UI 定义列表（剔除 "ui/server_form"）
+    static getUIdefList() {
+        const combinedList = this.#ui_def_list.concat(Array.from(this.#ui_system_map.keys()));
+        return combinedList.filter(item => item !== "ui/server_form");
+    }
+}

package/dist/core/ui/systems/chest.d.ts

@@ -0,0 +1,4 @@
+export class ChestUISystem {
+    static chest_screen: any;
+    static registerContainerUI(new_container_title: any, ui_system_root_panel: any): void;
+}

package/dist/core/ui/systems/chest.js

@@ -0,0 +1,21 @@
+import { Modifications, UIElement } from "../elements/uiElement.js";
+import { UISystem } from "./UISystem.js";
+const small_chest_screen = new UIElement("small_chest_screen", undefined, "common.inventory_screen_common");
+small_chest_screen.addVariable("new_container_title|default", "$container_title");
+export class ChestUISystem {
+    static chest_screen = new UISystem("chest:chest_screen", "ui/");
+    static registerContainerUI(new_container_title, ui_system_root_panel) {
+        small_chest_screen.addModification({
+            array_name: "variables",
+            operation: Modifications.OPERATION.INSERT_BACK,
+            value: [
+                {
+                    requires: `($new_container_title = '${new_container_title}')`,
+                    $root_panel: ui_system_root_panel,
+                    $screen_content: ui_system_root_panel
+                }
+            ]
+        });
+        this.chest_screen.addElement(small_chest_screen);
+    }
+}

package/dist/core/ui/systems/containerUISystem.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 自定义容器 UI 系统类，用于创建和管理容器界面。
+ * 支持动态添加网格项、设置标题、调整尺寸等功能。
+ */
+export class ContainerUISystem {
+    /**
+     * 构造函数，初始化容器 UI 系统。
+     * @param {string} identifier - 容器的唯一标识符。
+     * @param {string} path - 资源路径。
+     */
+    constructor(identifier: string, path: string);
+    system: any;
+    title: string;
+    root_panel_size: number[];
+    gridDimension: number[];
+    main_panel: Panel;
+    grids: Grid;
+    /**
+     * 向网格中添加一个网格项。
+     * @param {number[]} grid_position - 网格项的位置 [行, 列] 用于定位实体的背包槽。
+     * @param {number[]} offset - 网格项的偏移量 [x, y]。
+     * @param {Object} [options] - 可选参数，用于配置网格项。
+     * @param {boolean} [options.enable=true] - 是否启用该网格项，默认为 true。
+     * @param {number[]} [options.size] - 网格项的大小 [宽度, 高度]。
+     * @param {UIElement[]} [options.background_images] - 网格项的背景图片控件。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    addGridItem(grid_position: number[], offset: number[], options?: {
+        enable?: boolean;
+        size?: number[];
+        background_images?: UIElement[];
+    }): ContainerUISystem;
+    addInputGrid(grid_position: any, offset: any, options: any): void;
+    addOutputGrid(grid_position: any, offset: any, options: any): void;
+    /**
+     * 向主面板中添加一个 UI 元素。
+     * @param {Object} element - 要添加的 UI 元素。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    addElementToMain(element: any): ContainerUISystem;
+    /**
+     * 设置网格的维度（行和列）。
+     * @param {number[]} dimension - 网格的维度 [行数, 列数]。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    setGridDimension(dimension: number[]): ContainerUISystem;
+    /**
+     * 设置容器的标题。
+     * @param {string} title - 容器的标题。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    setTitle(title: string): ContainerUISystem;
+    /**
+     * 设置根面板的尺寸。
+     * @param {number[]} size - 根面板的尺寸 [宽度, 高度]。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    setSize(size: number[]): ContainerUISystem;
+    setItemMatrix(n: any, matrix: any): void;
+    #private;
+}
+import { Panel } from "../elements/panel.js";
+import { Grid } from "../elements/grid.js";
+import { UIElement } from "../elements/uiElement.js";

package/dist/core/ui/systems/containerUISystem.js

@@ -0,0 +1,206 @@
+import { Grid } from "../elements/grid.js";
+import { Label } from "../elements/label.js";
+import { Panel } from "../elements/panel.js";
+import { StackPanel } from "../elements/stackPanel.js";
+import { UIElement } from "../elements/uiElement.js";
+import { Control } from "../properties/control.js";
+import { GridProp } from "../properties/gridProp.js";
+import { Layout } from "../properties/layout.js";
+import { Text } from "../properties/text.js";
+import { ChestUISystem } from "./chest.js";
+import { UISystem } from "./UISystem.js";
+/**
+ * 自定义容器 UI 系统类，用于创建和管理容器界面。
+ * 支持动态添加网格项、设置标题、调整尺寸等功能。
+ */
+export class ContainerUISystem {
+    /** @private 网格项的数量 */
+    #gridItemNum = 3;
+    /**
+     * 构造函数，初始化容器 UI 系统。
+     * @param {string} identifier - 容器的唯一标识符。
+     * @param {string} path - 资源路径。
+     */
+    constructor(identifier, path) {
+        this.system = new UISystem(identifier, path);
+        this.title = "自定义容器";
+        this.root_panel_size = [200, 200];
+        this.gridDimension = [3, 1];
+        this.main_panel = new Panel("main_panel");
+        this.grids = new Grid("grids");
+        // 初始化
+        this.#register();
+        this.#updateSystem();
+    }
+    /**
+     * 向网格中添加一个网格项。
+     * @param {number[]} grid_position - 网格项的位置 [行, 列] 用于定位实体的背包槽。
+     * @param {number[]} offset - 网格项的偏移量 [x, y]。
+     * @param {Object} [options] - 可选参数，用于配置网格项。
+     * @param {boolean} [options.enable=true] - 是否启用该网格项，默认为 true。
+     * @param {number[]} [options.size] - 网格项的大小 [宽度, 高度]。
+     * @param {UIElement[]} [options.background_images] - 网格项的背景图片控件。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    addGridItem(grid_position, offset, options) {
+        const gridItem = new UIElement("grid_item", undefined, "chest.chest_grid_item");
+        gridItem.addProp("offset", offset);
+        gridItem.addProp("enable", options.enable);
+        gridItem.addProp("size", options.size);
+        gridItem.addVariable("background_images|default", options.background_images);
+        this.grids.addGridItem(grid_position, gridItem);
+        this.#updateSystem();
+        return this;
+    }
+    addInputGrid(grid_position, offset, options) {
+        this.addGridItem(grid_position, offset, options);
+    }
+    addOutputGrid(grid_position, offset, options) {
+        //设置
+        options.enable = false;
+        this.addGridItem(grid_position, offset, options);
+    }
+    /**
+     * 向主面板中添加一个 UI 元素。
+     * @param {Object} element - 要添加的 UI 元素。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    addElementToMain(element) {
+        this.main_panel.addControl(element);
+        this.#updateSystem();
+        return this;
+    }
+    /**
+     * 设置网格的维度（行和列）。
+     * @param {number[]} dimension - 网格的维度 [行数, 列数]。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    setGridDimension(dimension) {
+        this.gridDimension = dimension;
+        this.#gridItemNum = dimension[0] * dimension[1];
+        this.#updateSystem();
+        return this;
+    }
+    /**
+     * 设置容器的标题。
+     * @param {string} title - 容器的标题。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    setTitle(title) {
+        this.title = title;
+        this.#updateSystem();
+        return this;
+    }
+    /**
+     * 设置根面板的尺寸。
+     * @param {number[]} size - 根面板的尺寸 [宽度, 高度]。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    setSize(size) {
+        this.root_panel_size = size;
+        this.#updateSystem();
+        return this;
+    }
+    setItemMatrix(n, matrix) {
+        //5*5
+        //设置
+        this.setGridDimension([1, n]); //n*n列
+        const offset_marix = [];
+        for (let i = 0; i < n; i++)
+            offset_marix.push([(-18) * Math.floor(n / 2), i * (-18)]);
+        //现在他们在右上角了
+        console.log("offoset:" + offset_marix);
+        matrix.forEach((row, rowIndex) => {
+            console.log("row:" + row);
+            row.forEach((value, colIndex) => {
+                if (value === 0)
+                    return;
+                console.log("value:" + value);
+                //y
+                offset_marix[value - 1][1] += rowIndex * (18);
+                //x
+                offset_marix[value - 1][0] += colIndex * (18);
+            });
+        });
+        offset_marix.forEach((v, i) => {
+            this.addGridItem([0, i], v);
+        });
+    }
+    /**
+     * 注册容器 UI 系统。
+     * @private
+     */
+    #register() {
+        ChestUISystem.registerContainerUI(this.system.name, `${this.system.namespace}.container_root_panel`);
+    }
+    /**
+     * 更新 UI 系统，根据当前属性重新构建 UI。
+     * @private
+     */
+    #updateSystem() {
+        const container_root_panel = new Panel("container_root_panel");
+        // 设置根面板的尺寸
+        container_root_panel.setLayout(new Layout().setSize(this.root_panel_size));
+        // 添加控件
+        container_root_panel.addControls([
+            // 通用面板
+            {
+                "common_panel@common.common_panel": {},
+            },
+            // 飞行动画图标按钮
+            {
+                "inventory_selected_icon_button@common.inventory_selected_icon_button": {},
+            },
+            // 主内容面板
+            new StackPanel("container_panel")
+                .setControl(new Control().setLayer(2))
+                // 标题
+                .addStack(["100%", "10%"], new Label("title")
+                .setControl(new Control().setLayer(12))
+                .setText(new Text().setText(this.title).setColor([0, 0, 0])))
+                // 自定义网格
+                .addStack(["100%", "40%"], 
+            //有一丢丢bug
+            this.main_panel.control =
+                this.grids.setGridProp(new GridProp()
+                    .setGridDimensions(this.gridDimension)
+                    .setGridItemTemplate("chest.chest_grid_item")).setCollectionName("container_items"))
+                // 玩家库存面板
+                .addStack(["100%", "50%"], new Panel("inventory_panel").addControls([
+                // 玩家背包
+                {
+                    "inventory_panel_bottom_half_with_label@common.inventory_panel_bottom_half_with_label": {},
+                },
+                // 物品栏
+                {
+                    "hotbar_grid@common.hotbar_grid_template": {},
+                },
+                {
+                    "inventory_take_progress_icon_button@common.inventory_take_progress_icon_button": {},
+                },
+            ])),
+        ]);
+        // 更新系统
+        this.system.addElement(container_root_panel);
+    }
+}
+/**
+ * 例子
+ *
+ * // 创建一个新的容器 UI 系统
+const containerUI = new ContainerUISystem("custom_container", "ui/");
+
+// 设置标题和尺寸
+containerUI.setTitle("我的自定义容器").setSize([300, 400]);
+
+// 设置网格维度（2 行 1 列）
+containerUI.setGridDimension([2, 1]);
+
+// 添加网格项
+containerUI.addGridItem([0, 0], [10, 10]); // 在将实体背包(0, 0) 项映射于此，偏移量为 [10, 10]
+containerUI.addGridItem([1, 0], [20, 20]); // 在将实体背包(1, 0) 项映射于此，偏移量为 [20, 20]
+
+// 向主面板添加自定义元素
+const customElement = new Panel("custom_element");
+containerUI.addElementToMain(customElement);
+ */ 

package/dist/core/ui/systems/guidebook.d.ts

@@ -0,0 +1,8 @@
+export class Guidebook {
+    constructor(identifier: any, path: any);
+    system: any;
+    addPageBinding(page_name: any, left_control_name: any, right_control_name: any): this;
+    addPage(page_name: any, left_control: any, right_control: any): this;
+    addElement(element: any): this;
+    #private;
+}