sapdon 3.0.2 → 3.0.3

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

@@ -0,0 +1,206 @@
+import { ButtonMapping } from "../buttonMapping.js";
+import { DataBindingObject } from "../dataBindingObject.js";
+import { Button } from "../elements/button.js";
+import { Image } from "../elements/image.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 { Input } from "../properties/input.js";
+import { Layout } from "../properties/layout.js";
+import { Sprite } from "../properties/sprite.js";
+import { Text } from "../properties/text.js";
+import { ServerUISystem } from "./serverForm.js";
+import { UISystem } from "./system.js";
+//表单按钮模板
+const form_button_template = new Button("form_button_template", "common.button");
+form_button_template.addVariable("default_texture|default", "");
+form_button_template.addVariable("hover_texture|default", "");
+form_button_template.addVariable("pressed_texture|default", "");
+form_button_template.addVariable("binding_button_text|default", "");
+form_button_template.dataBinding.addDataBinding(new DataBindingObject().setBindingType("collection_details")
+    .setBindingCollectionName("form_buttons"));
+form_button_template.dataBinding.addDataBinding(new DataBindingObject().setBindingType("collection")
+    .setBindingCollectionName("form_buttons")
+    .setBindingName("#form_button_text"));
+form_button_template.dataBinding.addDataBinding(new DataBindingObject().setBindingType("view")
+    .setSourcePropertyName("($binding_button_text = #form_button_text)")
+    .setTargetPropertyName("#visible"));
+form_button_template.addControls([
+    new Image("default").setSprite(new Sprite().setTexture("$default_texture")),
+    new Image("hover").setSprite(new Sprite().setTexture("$hover_texture")),
+    new Image("pressed").setSprite(new Sprite().setTexture("$pressed_texture"))
+]);
+//f
+const form_button_panel = new Panel("form_button_factory").enableDebug();
+form_button_panel.addProp("type", "collection_panel");
+form_button_panel.factory.setName("buttons").setControlName("$button_control");
+form_button_panel.addProp("collection_name", "form_buttons");
+form_button_panel.dataBinding.addDataBinding(new DataBindingObject().setBindingName("#form_button_length")
+    .setBindingNameOverride("#collection_length"));
+const page_template = new StackPanel("page_template").setOrientation("horizontal")
+    .addVariable("page_left_content | default", "")
+    .addVariable("page_right_content | default", "")
+    .setLayout(new Layout().setSize(["90%", "90%"]))
+    .addStack(["50%", "100%"], new UIElement("page_left", undefined, "$page_left_content").serialize())
+    .addStack(["50%", "100%"], new UIElement("page_right", undefined, "$page_right_content").serialize());
+page_template.dataBinding.addDataBinding(new DataBindingObject().setBindingType("view")
+    .setSourcePropertyName("($binding_text = #form_text)")
+    .setTargetPropertyName("#visible"));
+export class Guidebook {
+    #bindingList = [];
+    constructor(identifier, path) {
+        this.system = new UISystem(identifier, path);
+        //init
+        this.#binding();
+        this.#addTemplate();
+        this.#updateSystem();
+    }
+    addPageBinding(page_name, left_control_name, right_control_name) {
+        this.#bindingList.push({
+            page_name: page_name,
+            left_control_name: left_control_name,
+            right_control_name: right_control_name
+        });
+        //更新系统
+        this.#updateSystem();
+        return this;
+    }
+    addPage(page_name, left_control, right_control) {
+        this.addPageBinding(page_name, left_control.name, right_control.name);
+        //添加元素
+        this.addElement(left_control);
+        this.addElement(right_control);
+        //更新系统
+        this.#updateSystem();
+        return this;
+    }
+    addElement(element) {
+        this.system.addElement(element);
+        return this;
+    }
+    #binding() {
+        ServerUISystem.bindingTitlewithContent(this.system.name, `${this.system.namespace}.guidebook_root_panel`);
+    }
+    #addTemplate() {
+        this.addElement(form_button_template);
+        this.addElement(form_button_panel);
+        this.addElement(page_template);
+        //
+        this.#updateSystem();
+    }
+    #updateSystem() {
+        const guidebook_root_panel = new Panel("guidebook_root_panel");
+        //开启调试框
+        //guidebook_root_panel.enableDebug()
+        //设置布局属性
+        guidebook_root_panel.setLayout(new Layout().setSize([320, 207]));
+        //添加子元素
+        guidebook_root_panel.addControls([
+            //添加背景
+            new UIElement("book_background", undefined, "book.book_background"),
+            //添加书页
+            new StackPanel("book_page_stack_panel").setOrientation("horizontal")
+                .setLayout(new Layout().setSize([320, 207]))
+                .addVariable("page_size", [160, 207])
+                .addStack("$page_size", new Panel("book_left_panel").addControls([
+                {
+                    "page_crease_image@book.page_crease_left_image": {
+                        "size": ["100% - 40px", "100% - 14px"],
+                        "offset": [0, -2]
+                    }
+                },
+                {
+                    "page_edge_image@book.page_edge_left_image": {
+                        "size": ["100% - 7px", "100% - 16px"],
+                        "offset": [7, -1]
+                    }
+                }
+            ]).serialize())
+                .addStack("$page_size", new Panel("book_right_panel").addControls([
+                {
+                    "page_crease_image@book.page_crease_right_image": {
+                        "size": ["100% - 40px", "100% - 14px"],
+                        "offset": [0, -2]
+                    }
+                },
+                {
+                    "page_edge_image@book.page_edge_right_image": {
+                        "size": ["100% - 7px", "100% - 16px"],
+                        "offset": [-7, -1]
+                    }
+                }
+            ]).serialize()),
+            //添加书页内容
+            new Panel("page_content_root")
+                .setControl(new Control().setLayer(5))
+                .setLayout(new Layout().setSize(["90%", "90%"]))
+                .addControls([
+                new Panel("label_text_panel").setLayout(new Layout().setSize([32, 8]).setAnchorFrom("bottom_middle")
+                    .setAnchorTo("bottom_middle")).addControl(new Label("page_content").setText(new Text().setText("#form_text").setColor([0, 0, 0]))),
+                ...this.#bindingList.map(({ page_name, left_control_name, right_control_name }, index) => {
+                    return new UIElement(`page_index_${index}`, undefined, "page_template")
+                        .addVariable("binding_text", page_name)
+                        .addVariable("page_left_content", left_control_name)
+                        .addVariable("page_right_content", right_control_name);
+                })
+                /*
+                new UIElement("page_1",undefined,"page_template")
+                .addVariable("binding_text","page_index1")
+                .addVariable("page_left_content","page_left_content")
+                .addVariable("page_right_content","page_right_content"),
+                new UIElement("page_2",undefined,"page_template")
+                .addVariable("binding_text","page_index2")
+                .addVariable("page_left_content","page_left_content")
+                .addVariable("page_right_content","page_right_content"),
+                new UIElement("page_3",undefined,"page_template")
+                .addVariable("binding_text","page_index3")
+                .addVariable("page_left_content","page_left_content")
+                .addVariable("page_right_content","page_right_content")*/
+            ]),
+            //添加关闭按钮
+            new Button("close_button").setLayout(new Layout().setSize([14, 14])
+                .setAnchorFrom("top_right")
+                .setAnchorTo("top_right"))
+                .setInput(new Input().setButtonMappings([
+                new ButtonMapping().setMappingType("pressed")
+                    .setFromButtonId("button.menu_select")
+                    .setToButtonId("button.menu_exit")
+            ]))
+                .addControls([
+                new UIElement("default", undefined, "book.close_button_default"),
+                new UIElement("hover", undefined, "book.close_button_hover"),
+                new UIElement("pressed", undefined, "book.close_button_pressed"),
+            ]),
+            //添加下一页按钮
+            new Panel("prev_button_panel").enableDebug()
+                .setControl(new Control().setLayer(5))
+                .setLayout(new Layout().setSize([24, 24])
+                .setOffset([7, -9])
+                .setAnchorFrom("bottom_left")
+                .setAnchorTo("bottom_left"))
+                .addControl(new UIElement("prev_button", undefined, "form_button_factory")
+                .addVariable("binding_button_text", "test1")
+                .addVariable("button_control", `${this.system.namespace}.form_button_template`)
+                .addVariable("pressed_button_name", "button.form_button_click")
+                .addVariable("default_texture", "textures/ui/book_pageleft_default")
+                .addVariable("hover_texture", "textures/ui/book_pageleft_hover")
+                .addVariable("pressed_texture", "textures/ui/book_pageleft_pressed")),
+            new Panel("next_button_panel").enableDebug()
+                .setControl(new Control().setLayer(5))
+                .setLayout(new Layout().setSize([24, 24])
+                .setOffset([-7, -9])
+                .setAnchorFrom("bottom_right")
+                .setAnchorTo("bottom_right"))
+                .addControl(new UIElement("next_button", undefined, "form_button_factory")
+                .addVariable("binding_button_text", "test2")
+                .addVariable("button_control", "sapdon_guidebook.form_button_template")
+                .addVariable("pressed_button_name", "button.form_button_click")
+                .addVariable("default_texture", "textures/ui/book_pageright_default")
+                .addVariable("hover_texture", "textures/ui/book_pageright_hover")
+                .addVariable("pressed_texture", "textures/ui/book_pageright_pressed"))
+        ]);
+        this.addElement(guidebook_root_panel);
+    }
+}

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

@@ -0,0 +1,13 @@
+export const ServerFormSystem: UISystem;
+export const form_button_panel: Panel;
+export class ServerUISystem {
+    static "__#4@#binding_map": Map<any, any>;
+    static "__#4@#binding_title_list": any[];
+    static addBindingTitle(title_name: any): void;
+    static getBindingTitleList(): any[];
+    static getBindingContentList(): any[];
+    static bindingTitlewithContent(title_name: any, content: any): void;
+    static "__#4@#updateServerFormSystem"(): void;
+}
+import { UISystem } from "./system.js";
+import { Panel } from "../elements/panel.js";

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

@@ -0,0 +1,116 @@
+import { Modifications, UIElement } from "../elements/uiElement.js";
+import { DataBindingObject } from "../dataBindingObject.js";
+import { UISystem } from "./system.js";
+import { Panel } from "../elements/panel.js";
+import { Button } from "../elements/button.js";
+import { Image } from "../elements/image.js";
+import { Sprite } from "../properties/sprite.js";
+export const ServerFormSystem = new UISystem("server_form:server_form", "ui/");
+//表单按钮模板
+const form_button_template = new Button("sapdon_form_button_template", "common.button");
+form_button_template.addVariable("pressed_button_name", "button.form_button_click");
+form_button_template.addVariable("default_texture|default", "textures/gui/newgui/buttons/borderless/light");
+form_button_template.addVariable("hover_texture|default", "textures/gui/newgui/buttons/borderless/lighthover");
+form_button_template.addVariable("pressed_texture|default", "textures/gui/newgui/buttons/borderless/lightpressed");
+form_button_template.addVariable("binding_button_text|default", "");
+form_button_template.dataBinding.addDataBinding(new DataBindingObject().setBindingType("collection_details")
+    .setBindingCollectionName("form_buttons"));
+form_button_template.dataBinding.addDataBinding(new DataBindingObject().setBindingType("collection")
+    .setBindingCollectionName("form_buttons")
+    .setBindingName("#form_button_text"));
+form_button_template.dataBinding.addDataBinding(new DataBindingObject().setBindingType("view")
+    .setSourcePropertyName("($binding_button_text = #form_button_text)")
+    .setTargetPropertyName("#visible"));
+form_button_template.addControls([
+    new Image("default").setSprite(new Sprite().setTexture("$default_texture")),
+    new Image("hover").setSprite(new Sprite().setTexture("$hover_texture")),
+    new Image("pressed").setSprite(new Sprite().setTexture("$pressed_texture"))
+]);
+//f
+export const form_button_panel = new Panel("sapdon_form_button_factory");
+form_button_panel.addProp("type", "collection_panel");
+form_button_panel.factory.setName("buttons").setControlName("sapdon_form_button_template");
+form_button_panel.addProp("collection_name", "form_buttons");
+form_button_panel.dataBinding.addDataBinding(new DataBindingObject().setBindingName("#form_button_length")
+    .setBindingNameOverride("#collection_length"));
+ServerFormSystem.addElement(form_button_template);
+ServerFormSystem.addElement(form_button_panel);
+export class ServerUISystem {
+    static #binding_map = new Map();
+    static #binding_title_list = [];
+    static addBindingTitle(title_name) {
+        this.#binding_title_list.push(title_name);
+    }
+    static getBindingTitleList() {
+        //console.log("arrr:",Array.from(this.#binding_map.keys()))
+        return this.#binding_title_list.concat(Array.from(this.#binding_map.keys()));
+    }
+    static getBindingContentList() {
+        return Array.from(this.#binding_map.values());
+    }
+    static bindingTitlewithContent(title_name, content) {
+        //添加绑定
+        this.#binding_map.set(title_name, content);
+        this.#updateServerFormSystem();
+    }
+    static #updateServerFormSystem() {
+        //文本化处理
+        //console.log("ttttt:",this.getBindingTitleList())
+        const user_custom_ui_text = this.getBindingTitleList().map((title_name) => {
+            console.log("title_name", title_name);
+            return `'${title_name}'`;
+        }).join('-');
+        const long_form = new UIElement("long_form")
+            .addModification({
+            array_name: "bindings",
+            operation: Modifications.OPERATION.INSERT_BACK,
+            value: [
+                new DataBindingObject().setBindingName("#title_text"),
+                new DataBindingObject().setBindingType("view")
+                    .setSourcePropertyName(`((#title_text - ${user_custom_ui_text}) = #title_text)`)
+                    .setTargetPropertyName("#visible")
+            ]
+        });
+        const custom_server_form_factory = new Panel("custom_server_form_factory");
+        custom_server_form_factory.factory.setName("server_form_factory") //工程名被绑定至表单，不可改动
+            .setControlIds({ "long_form": "@server_form.custom_root_panel" });
+        //加入自定义表单内容
+        const main_screen_content = new UIElement("main_screen_content")
+            .addModification({
+            array_name: "controls",
+            operation: Modifications.OPERATION.INSERT_BACK,
+            value: [
+                custom_server_form_factory.serialize()
+            ]
+        });
+        //自定义ui模板
+        const custom_ui_template = new Panel("custom_ui_template");
+        custom_ui_template.dataBinding.addDataBinding(new DataBindingObject().setBindingName("#title_text")).addDataBinding(new DataBindingObject().setBindingType("view")
+            .setSourcePropertyName("(#title_text = $binding_text)")
+            .setTargetPropertyName("#visible"));
+        custom_ui_template.control.addControl(new UIElement("main", undefined, "$main_content").serialize());
+        //类似于 root ，决定什么时候加载自定义界面 ，不可改动
+        const custom_form_root = new Panel("custom_form_root");
+        //custom_form_root.addVariable("title_needs_to_contain",user_custom_ui_text)
+        custom_form_root.dataBinding.addDataBinding(new DataBindingObject().setBindingType("view")
+            .setSourceControlName("custom_root_panel")
+            .setSourcePropertyName(`(not ((#title_text - ${user_custom_ui_text}) = #title_text))`)
+            .setTargetPropertyName("#visible"));
+        //用户自定义ui内容绑定
+        this.#binding_map.forEach((content, key) => {
+            //加入 root
+            custom_form_root.control.addControl(new UIElement("custom_ui_" + key, undefined, "custom_ui_template")
+                .addVariable("main_content", content)
+                .addVariable("binding_text", key).serialize());
+        });
+        //类似于 sreen，必要，不可改动
+        const custom_root_panel = new Panel("custom_root_panel");
+        custom_root_panel.dataBinding.addDataBinding(new DataBindingObject().setBindingName("#title_text"));
+        custom_root_panel.control.addControl(custom_form_root.serialize());
+        ServerFormSystem
+            .addElement(custom_ui_template)
+            .addElement(long_form)
+            .addElement(custom_root_panel)
+            .addElement(main_screen_content);
+    }
+}

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

@@ -0,0 +1,16 @@
+export class UISystem {
+    constructor(identifier: any, path: any);
+    identifier: any;
+    namespace: any;
+    name: any;
+    path: any;
+    elements: Map<any, any>;
+    animations: Map<any, any>;
+    addElement(element: any): this;
+    getElement(element_name: any): any;
+    addAnimation(name: any, value: any): void;
+    getAnimation(animation_name: any): any;
+    toJson(): {
+        namespace: any;
+    };
+}

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

@@ -0,0 +1,37 @@
+import { UISystemRegistry } from "../registry/uiSystemRegistry.js";
+// UI 文件核心类
+export class UISystem {
+    constructor(identifier, path) {
+        this.identifier = identifier;
+        this.namespace = identifier.split(':')[0];
+        this.name = identifier.split(':')[1];
+        this.path = path;
+        this.elements = new Map();
+        this.animations = new Map();
+        UISystemRegistry.registerUISystem(this);
+    }
+    addElement(element) {
+        this.elements.set(element.id, element);
+        return this;
+    }
+    getElement(element_name) {
+        return this.elements.get(element_name);
+    }
+    addAnimation(name, value) {
+        this.animations.set(name, value);
+    }
+    getAnimation(animation_name) {
+        return this.animations.get(animation_name);
+    }
+    toJson() {
+        const ui = { namespace: this.namespace };
+        //序列化
+        this.elements.forEach((value, key) => {
+            //console.log("elements key:",key)
+            //console.log("elements value:",value);
+            ui[key] = value.serialize()[value.id];
+        });
+        //console.log("ui:",ui)
+        return ui;
+    }
+}

package/dist/oc/index.d.ts

@@ -0,0 +1,142 @@
+import * as _minecraft_server from '@minecraft/server';
+import { Entity, Player, InputButton } from '@minecraft/server';
+
+declare class Optional<T = any> {
+    private value;
+    static none<T>(): Optional<T>;
+    static some<T>(value: T): Optional<T>;
+    constructor(value: T);
+    unwrap(): T;
+    isEmpty(): boolean;
+    orElse(other: T): T;
+    use(fn: (v: T) => void, self?: any): boolean;
+}
+
+interface Component {
+    onTick(manager: ComponentManager, en: Optional<Entity>): void;
+    detach(manager: ComponentManager): void;
+    getManager(): ComponentManager;
+    getEntity(): Optional<Entity>;
+}
+interface BasicComponent extends Component {
+    onAttach(manager: ComponentManager): boolean | void | Promise<boolean | void>;
+    onDetach(manager: ComponentManager): void | Promise<void>;
+}
+declare const REFLECT_MANAGER: unique symbol;
+declare const REFLECT_ENTITY: unique symbol;
+declare class CustomComponent implements Component {
+    [REFLECT_MANAGER]?: ComponentManager;
+    [REFLECT_ENTITY]: Optional<Entity>;
+    onTick(manager: ComponentManager, en: Optional<Entity>): void;
+    detach(manager: ComponentManager): Promise<boolean>;
+    getManager(): ComponentManager;
+    getEntity(): Optional<Entity>;
+}
+declare class BaseComponent extends CustomComponent implements BasicComponent {
+    onAttach(manager: ComponentManager): boolean | void | Promise<boolean | void>;
+    onDetach(manager: ComponentManager): void | Promise<void>;
+}
+interface ComponentCtor<T extends Component | BasicComponent = Component> {
+    new (...args: any[]): T;
+}
+declare class ComponentManager {
+    #private;
+    static profilerEnable: boolean;
+    static readonly global: ComponentManager;
+    getComponentUnsafe(ctor: ComponentCtor): Component | undefined;
+    getComponent<T extends Component>(ctor: ComponentCtor<T>): Optional<T>;
+    getComponents(...ctor: ComponentCtor[]): (Component | undefined)[];
+    attachComponent(...component: Component[]): Promise<Optional<Component>[]>;
+    getOrCreate<T extends Component>(ctor: ComponentCtor<T>, ...args: any[]): Promise<Optional<T>>;
+    detachComponent(ctor: ComponentCtor): Promise<boolean>;
+    clear(): void;
+    getComponentKeys(): MapIterator<ComponentCtor<Component>>;
+    has(ctor: ComponentCtor): boolean;
+    afterTick(fn: (en: Optional<Entity>) => void): void;
+    beforeTick(fn: (en: Optional<Entity>) => void): void;
+    handleTicks(en: Entity): void;
+    update<T extends Component>(ctor: ComponentCtor<T>, fn: (component: T) => void): boolean;
+    profiler(fn: Function, component?: Component, name?: string): any;
+}
+type RequireComponentsParam = ComponentCtor | [ComponentCtor, ...any[]];
+declare const REQUIRED_COMPONENTS: unique symbol;
+interface RequiredComponent extends BasicComponent {
+    getComponent<T extends Component>(ctor: ComponentCtor): T;
+}
+declare function RequireComponents(...params: RequireComponentsParam[]): {
+    new (): {
+        getComponent<T extends Component>(ctor: ComponentCtor): T;
+        [REQUIRED_COMPONENTS]: Map<ComponentCtor<Component>, Component>;
+        onAttach(manager: ComponentManager): boolean | void | Promise<boolean | void>;
+        onDetach(manager: ComponentManager): void | Promise<void>;
+        onTick(manager: ComponentManager, en: Optional<Entity>): void;
+        detach(manager: ComponentManager): Promise<boolean>;
+        getManager(): ComponentManager;
+        getEntity(): Optional<Entity>;
+        [REFLECT_MANAGER]?: ComponentManager;
+        [REFLECT_ENTITY]: Optional<Entity>;
+    };
+};
+declare namespace oc {
+    function addEntity(entityId: string): ComponentManager;
+    function removeEntity(entityId: string): void;
+    function getManager(entityId: string): ComponentManager;
+    function tick(): void;
+    function start(): void;
+    function toPlayer(entity: Entity): Optional<Player>;
+}
+
+type ComponentDescriptor = string | ComponentCtor;
+declare class Actor {
+    readonly target: Entity;
+    readonly manager: ComponentManager;
+    constructor(target: Entity, manager: ComponentManager);
+    static from(target: Entity, manager: ComponentManager): Actor;
+    /**
+     * 优先使用 `Actor.getComponent`
+     * @param ctors
+     * @returns
+     */
+    getMinecraftComponent(...ids: string[]): (_minecraft_server.EntityComponent | undefined)[];
+    /**
+     * 优先使用 `Actor.getComponent`
+     * @param ctors
+     * @returns
+     */
+    getCustomComponent(...ctors: ComponentCtor[]): (Component | undefined)[];
+    getComponent<T extends readonly ComponentDescriptor[] | []>(...descs: T): {
+        -readonly [K in keyof T]: Component;
+    };
+    addComponent(...components: Component[]): Promise<Optional<Component>[]>;
+    removeComponent(ctor: ComponentCtor): Promise<boolean>;
+    updateComponent<T extends Component>(ctor: ComponentCtor<T>, fn: (component: T) => void): boolean;
+}
+
+declare enum InputChangeState {
+    Press = 0,
+    Release = 1,
+    None = 2
+}
+/**
+ * `@minecraft/server` version 2.0.0-beta
+ * 低于此版本请不要使用此组件
+ */
+declare class PlayerInputComponent extends BaseComponent {
+    [InputButton.Jump]: InputChangeState;
+    [InputButton.Sneak]: InputChangeState;
+    static setup(): void;
+}
+/**
+ * `@minecraft/server` version 1.17.0-beta
+ * 有 1tick 延迟
+ * 条件允许请使用 `PlayerInputComponent`
+ */
+declare class PlayerInputCompatibilityComponent extends BaseComponent {
+    [InputButton.Jump]: InputChangeState;
+    [InputButton.Sneak]: InputChangeState;
+    private _lastJump;
+    private _lastSneak;
+    onTick(manager: ComponentManager, en: Optional<Entity>): void;
+}
+
+export { Actor, BaseComponent, type BasicComponent, type Component, type ComponentCtor, type ComponentDescriptor, ComponentManager, CustomComponent, InputChangeState, Optional, PlayerInputCompatibilityComponent, PlayerInputComponent, RequireComponents, type RequiredComponent, oc };

package/dist/oc/index.js

@@ -0,0 +1 @@
+import{world as t,system as e,InputButton as n,ButtonState as s}from"@minecraft/server";class o{target;manager;constructor(t,e){this.target=t,this.manager=e}static from(t,e){return new o(t,e)}getMinecraftComponent(...t){return t.map((t=>this.target.getComponent(t)))}getCustomComponent(...t){return this.manager.getComponents(...t)}getComponent(...t){return t.map((t=>"string"==typeof t?this.target.getComponent(t):this.manager.getComponentUnsafe(t)))}addComponent(...t){return this.manager.attachComponent(...t)}removeComponent(t){return this.manager.detachComponent(t)}updateComponent(t,e){return this.manager.update(t,e)}}class r{value;static none(){return new r(null)}static some(t){return new r(t)}constructor(t){this.value=t}unwrap(){if(!this.isEmpty())return this.value;throw new Error("Optional is empty")}isEmpty(){return void 0===this.value||null===this.value}orElse(t){return this.value??t}use(t,e){return!this.isEmpty()&&(t.call(e,this.value),!0)}}const a=Symbol("reflect-manager"),i=Symbol("reflect-entity");class c{[a];[i]=r.none();onTick(t,e){}detach(t){const e=Object.getPrototypeOf(this).constructor;return t.detachComponent(e)}getManager(){return this[a]}getEntity(){return this[i]}}class p extends c{onAttach(t){}onDetach(t){}}class u{static profilerEnable=!1;static global=new u;#t=new Map;#e=[];#n=[];getComponentUnsafe(t){return this.#t.get(t)}getComponent(t){return r.some(this.#t.get(t))}getComponents(...t){return t.map((t=>this.#t.get(t)))}async#s(t,e,n=!0){let s=!this.#t.get(t);if(!s&&n&&(await this.detachComponent(t),s=!0),l in e)for(const[t,n]of e[l])this.#s(t,n,!1);return s&&"onAttach"in e&&await e.onAttach(this),this.#t.set(t,e),r.some(e)}async attachComponent(...t){const e=[];for(const n of t)e.push(await this.#s(Object.getPrototypeOf(n).constructor,n));return e}async getOrCreate(t,...e){let n=this.#t.get(t);return n?r.some(n):this.#s(t,new t(...e))}async detachComponent(t){const e=this.#t.get(t);return e&&"onDetach"in e&&await e.onDetach(this),this.#t.delete(t)}clear(){this.#t.clear()}getComponentKeys(){return this.#t.keys()}has(t){return this.#t.has(t)}afterTick(t){this.#n.push(t)}beforeTick(t){this.#e.unshift(t)}handleTicks(t){for(const e of this.#e)this.profiler((()=>e.call(null,r.some(t))));this.#e.length=0;for(const e of this.#t.values()){e[i]||(e[i]=r.some(t)),e[a]||(e[a]=this);const{onTick:n}=e;n&&this.profiler((()=>n.call(e,this,r.some(t))),e)}for(const e of this.#n)this.profiler((()=>e.call(null,r.some(t))));this.#n.length=0}update(t,e){const n=this.#t.get(t);return!!n&&(e(n),!0)}profiler(t,e,n){if(!u.profilerEnable)return t();const s=e?Object.getPrototypeOf(e).constructor.name:"",o=n||(s?`${s}.${t.name}`:t.name),r=performance.now(),a=t();return console.log(`[Profiler] ${o} took ${performance.now()-r}ms`),a}}const l=Symbol("REQUIRED_COMPONENTS");function h(...t){return class extends p{[l]=new Map;constructor(){super();for(const e of t)if(Array.isArray(e)){const[t,...n]=e;this[l].set(t,Reflect.construct(t,n))}else this[l].set(e,Reflect.construct(e,[]))}getComponent(t){return this[l].get(t)}}}var m,f;!function(n){const s=new Map;function o(t){const e=new u;return s.set(t,e),e}function a(){for(const[e,n]of s.entries()){const s=t.getEntity(e);s&&n.handleTicks(s)}}n.addEntity=o,n.removeEntity=function(t){const e=t,n=s.get(e);n?.clear(),s.delete(e)},n.getManager=function(t){return s.get(t)??o(t)},n.tick=a,n.start=function(){e.runInterval(a)},n.toPlayer=function(e){return r.some(t.getAllPlayers().find((t=>t.id===e.id)))}}(m||(m={})),function(t){t[t.Press=0]="Press",t[t.Release=1]="Release",t[t.None=2]="None"}(f||(f={}));class g extends p{[n.Jump]=f.None;[n.Sneak]=f.None;static setup(){t.afterEvents.playerButtonInput.subscribe((t=>{const e=m.getManager(t.player.id);e.getComponent(g).use((n=>{n[t.button]=t.newButtonState===s.Pressed?f.Press:f.Release,e.afterTick((()=>{n[t.button]=f.None}))}))}))}}class d extends p{[n.Jump]=f.None;[n.Sneak]=f.None;_lastJump=s.Released;_lastSneak=s.Released;onTick(t,e){const o=m.toPlayer(e.unwrap()).unwrap(),r=o.inputInfo.getButtonState(n.Jump),a=o.inputInfo.getButtonState(n.Sneak);r===s.Pressed&&this._lastJump===s.Released?this[n.Jump]=f.Press:r===s.Released&&this._lastJump===s.Pressed?this[n.Jump]=f.Release:this[n.Jump]=f.None,a===s.Pressed&&this._lastSneak===s.Released?this[n.Sneak]=f.Press:a===s.Released&&this._lastSneak===s.Pressed?this[n.Sneak]=f.Release:this[n.Sneak]=f.None,this._lastJump=r,this._lastSneak=a}}export{o as Actor,p as BaseComponent,u as ComponentManager,c as CustomComponent,f as InputChangeState,r as Optional,d as PlayerInputCompatibilityComponent,g as PlayerInputComponent,h as RequireComponents,m as oc};

package/doc/sapdon-ts.md

@@ -10,7 +10,7 @@ ts版本拥有更好的类型提示，更严格的类型检查，也可以直接
 比如我们需要注册一个物品，可能你会想去找它在哪，但在ts版本中，你只需要 `@sapdon/core` 就可以了
 
 ```ts
-import { ItemAPI } from '@sapdon/core.js'
+import { ItemAPI } from '@sapdon/core'
 ```
 
 如果你需要更高级的功能，比如你需要一个ts打包器，或者添加命令行的功能，你可以使用 `@sapdon/cli`
@@ -26,3 +26,37 @@ startDevServer(GRegistry, UISystemRegistry)
 ```
 如果需要从js迁移到ts，删除 `startDevServer` 那行即可（不删也没事）
 
+
+## OC (Object - Component)
+sapdon通过 `@sapdon/oc` 为sapi提供了一些高级功能, 比如:
+- 实体组件系统
+- 组件间通信
+
+传统的书写方式是通过事件和tick回调来实现功能, 而OC提供了更适合游戏的组件化开发方式
+
+```ts
+import { world, system } from '@minecraft/server'
+import { oc, CustomComponent } from '@sapdon/oc'
+
+world.afterEvents.worldInitialize.subscribe(oc.start)
+
+class MyComponent extends CustomComponent {
+    onTick() {
+        world.sendMessage('tick')
+    }
+}
+```
+
+是的, 我们得到了一个MyComponent, 它每刻都会给玩家发送 'tick'
+但是如果你进入游戏, 会发现它毫无作用, 没错! 因为我们还没有把它到绑定在实体身上!
+
+```ts
+const manager = oc.addEntity(id)
+manager.attachComponent(new MyComponent())
+```
+
+这样就可以了, 我们已经把MyComponent绑定到了entityId为id的实体身上
+
+你也可以动态增删改查组件! 这很方便!
+
+如果你想看它到底是怎么回事,可以从 `examples/oc-core` 开始了解

package/package.json

@@ -1,13 +1,9 @@
 {
     "name": "sapdon",
-    "version": "3.0.2",
-    "main": "dist/core/index.js",
-    "types": "dist/core/index.d.ts",
+    "version": "3.0.3",
     "scripts": {
-        "sapdon": "node dist/cli/index.js",
-        "create": "node dist/cli/index.js create",
-        "build": "node dist/cli/index.js build",
-        "pub": "tsc && npm publish"
+        "build": "rollup -c",
+        "pub": "rollup -c && npm publish"
     },
     "keywords": [
         "bedrock",
@@ -22,15 +18,17 @@
     },
     "description": "Sapdon is a Node.js toolkit designed for building Bedrock Edition Minecraft addon packs.",
     "devDependencies": {
-        "@minecraft/server": "^1.17.0",
+        "@minecraft/server": "^2.0.0-beta.1.21.80-preview.20",
         "@minecraft/server-ui": "^1.3.0",
         "@rollup/plugin-commonjs": "^28.0.2",
         "@rollup/plugin-json": "^6.1.0",
         "@rollup/plugin-node-resolve": "^16.0.0",
+        "@rollup/plugin-terser": "^0.4.4",
         "@rollup/plugin-typescript": "^12.1.2",
         "@types/lodash": "^4.17.16",
         "@types/node": "^22.13.8",
         "rollup": "^4.30.1",
+        "rollup-plugin-dts": "^6.1.1",
         "rollup-plugin-typescript-paths": "^1.5.0",
         "rollup-plugin-typescript2": "^0.36.0",
         "rollup-plugin-visualizer": "^5.14.0",