sapdon 3.0.3 → 3.2.0

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

@@ -1,187 +0,0 @@
-/**
- * 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

@@ -1,8 +0,0 @@
-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

@@ -1,26 +0,0 @@
-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

@@ -1,5 +0,0 @@
-export class ChestUISystem {
-    static chest_screen: UISystem;
-    static registerContainerUI(new_container_title: any, ui_system_root_panel: any): void;
-}
-import { UISystem } from "./system.js";

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

@@ -1,21 +0,0 @@
-import { Modifications, UIElement } from "../elements/uiElement.js";
-import { UISystem } from "./system.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

@@ -1,67 +0,0 @@
-/**
- * 自定义容器 UI 系统类，用于创建和管理容器界面。
- * 支持动态添加网格项、设置标题、调整尺寸等功能。
- */
-export class ContainerUISystem {
-    /**
-     * 构造函数，初始化容器 UI 系统。
-     * @param {string} identifier - 容器的唯一标识符。
-     * @param {string} path - 资源路径。
-     */
-    constructor(identifier: string, path: string);
-    system: UISystem;
-    title: string;
-    root_panel_size: number[];
-    gridDimension: number[];
-    output_grids: any[];
-    main_panel: Panel;
-    grids: Grid;
-    setInputGrid(output_arr: any): void;
-    /**
-     * 向网格中添加一个网格项。
-     * @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 | undefined;
-        size?: number[] | undefined;
-        background_images?: UIElement[] | undefined;
-    }): 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: Object): 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 { UISystem } from "./system.js";
-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

@@ -1,214 +0,0 @@
-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 "./system.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.output_grids = []; // 记录输出槽
-        this.main_panel = new Panel("main_panel");
-        this.grids = new Grid("grids");
-        // 初始化
-        this.#register();
-        this.#updateSystem();
-    }
-    setInputGrid(output_arr) {
-        this.output_grids = output_arr;
-    }
-    /**
-     * 向网格中添加一个网格项。
-     * @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) => {
-            if (this.output_grids.indexOf(v)) {
-                this.addOutputGrid([0, i], v);
-                return;
-            }
-            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

@@ -1,9 +0,0 @@
-export class Guidebook {
-    constructor(identifier: any, path: any);
-    system: UISystem;
-    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;
-}
-import { UISystem } from "./system.js";