sapdon 2.0.2 → 3.0.0

package/dist/core/ui/dataBindingObject.d.ts

@@ -0,0 +1,97 @@
+/**
+ * DataBinding 类
+ *
+ * 该类表示数据绑定配置，用于将硬编码值或变量绑定到元素属性。
+ *
+ * 属性：
+ * - ignored: boolean - 是否忽略绑定（默认值：false）
+ * - binding_type: enum - 绑定类型（可能值：global, view, collection, collection_details, none）
+ * - binding_name: string - 数据绑定名称或条件的值
+ * - binding_name_override: string - 应用 binding_name 值的 UI 元素属性名称
+ * - binding_collection_name: string - 要使用的集合名称
+ * - binding_collection_prefix: string - 集合前缀
+ * - binding_condition: enum - 数据绑定的条件（可能值：always, always_when_visible, visible, once, none, visibility_changed）
+ * - source_control_name: string - 要观察其属性值的 UI 元素名称
+ * - source_property_name: string - 存储 source_control_name 引用的 UI 元素的属性值
+ * - target_property_name: string - 应用 source_property_name 值的 UI 元素属性
+ * - resolve_sibling_scope: boolean - 是否允许选择同级元素而非子元素（默认值：false）
+ */
+export class DataBindingObject {
+    /**
+     * 设置是否忽略绑定。
+     * @param {boolean} ignored - 是否忽略绑定（默认值：false）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setIgnored(ignored?: boolean): DataBindingObject;
+    ignored: boolean;
+    /**
+     * 设置绑定类型。
+     * @param {string} type - 绑定类型（可能值：global, view, collection, collection_details, none）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingType(type: string): DataBindingObject;
+    binding_type: string;
+    /**
+     * 设置数据绑定名称或条件的值。
+     * @param {string} name - 数据绑定名称或条件的值
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingName(name: string): DataBindingObject;
+    binding_name: string;
+    /**
+     * 设置应用 binding_name 值的 UI 元素属性名称。
+     * @param {string} nameOverride - 应用 binding_name 值的 UI 元素属性名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingNameOverride(nameOverride: string): DataBindingObject;
+    binding_name_override: string;
+    /**
+     * 设置要使用的集合名称。
+     * @param {string} collectionName - 集合名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingCollectionName(collectionName: string): DataBindingObject;
+    binding_collection_name: string;
+    /**
+     * 设置集合前缀。
+     * @param {string} prefix - 集合前缀
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingCollectionPrefix(prefix: string): DataBindingObject;
+    binding_collection_prefix: string;
+    /**
+     * 设置数据绑定的条件。
+     * @param {string} condition - 数据绑定的条件（可能值：always, always_when_visible, visible, once, none, visibility_changed）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingCondition(condition: string): DataBindingObject;
+    binding_condition: string;
+    /**
+     * 设置要观察其属性值的 UI 元素名称。
+     * @param {string} controlName - UI 元素名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setSourceControlName(controlName: string): DataBindingObject;
+    source_control_name: string;
+    /**
+     * 设置存储 source_control_name 引用的 UI 元素的属性值。
+     * @param {string} propertyName - 属性名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setSourcePropertyName(propertyName: string): DataBindingObject;
+    source_property_name: string;
+    /**
+     * 设置应用 source_property_name 值的 UI 元素属性。
+     * @param {string} propertyName - 属性名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setTargetPropertyName(propertyName: string): DataBindingObject;
+    target_property_name: string;
+    /**
+     * 设置是否允许选择同级元素而非子元素。
+     * @param {boolean} resolve - 是否允许选择同级元素（默认值：false）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setResolveSiblingScope(resolve?: boolean): DataBindingObject;
+    resolve_sibling_scope: boolean;
+}

package/dist/core/ui/dataBindingObject.js

@@ -0,0 +1,134 @@
+/**
+ * DataBinding 类
+ *
+ * 该类表示数据绑定配置，用于将硬编码值或变量绑定到元素属性。
+ *
+ * 属性：
+ * - ignored: boolean - 是否忽略绑定（默认值：false）
+ * - binding_type: enum - 绑定类型（可能值：global, view, collection, collection_details, none）
+ * - binding_name: string - 数据绑定名称或条件的值
+ * - binding_name_override: string - 应用 binding_name 值的 UI 元素属性名称
+ * - binding_collection_name: string - 要使用的集合名称
+ * - binding_collection_prefix: string - 集合前缀
+ * - binding_condition: enum - 数据绑定的条件（可能值：always, always_when_visible, visible, once, none, visibility_changed）
+ * - source_control_name: string - 要观察其属性值的 UI 元素名称
+ * - source_property_name: string - 存储 source_control_name 引用的 UI 元素的属性值
+ * - target_property_name: string - 应用 source_property_name 值的 UI 元素属性
+ * - resolve_sibling_scope: boolean - 是否允许选择同级元素而非子元素（默认值：false）
+ */
+export class DataBindingObject {
+    constructor() {
+        /*
+        this.ignored = false;
+        this.binding_type = null;
+        this.binding_name = '';
+        this.binding_name_override = '';
+        this.binding_collection_name = '';
+        this.binding_collection_prefix = '';
+        this.binding_condition = null;
+        this.source_control_name = '';
+        this.source_property_name = '';
+        this.target_property_name = '';
+        this.resolve_sibling_scope = false;
+        */
+    }
+    /**
+     * 设置是否忽略绑定。
+     * @param {boolean} ignored - 是否忽略绑定（默认值：false）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setIgnored(ignored = false) {
+        this.ignored = ignored;
+        return this;
+    }
+    /**
+     * 设置绑定类型。
+     * @param {string} type - 绑定类型（可能值：global, view, collection, collection_details, none）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingType(type) {
+        this.binding_type = type;
+        return this;
+    }
+    /**
+     * 设置数据绑定名称或条件的值。
+     * @param {string} name - 数据绑定名称或条件的值
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingName(name) {
+        this.binding_name = name;
+        return this;
+    }
+    /**
+     * 设置应用 binding_name 值的 UI 元素属性名称。
+     * @param {string} nameOverride - 应用 binding_name 值的 UI 元素属性名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingNameOverride(nameOverride) {
+        this.binding_name_override = nameOverride;
+        return this;
+    }
+    /**
+     * 设置要使用的集合名称。
+     * @param {string} collectionName - 集合名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingCollectionName(collectionName) {
+        this.binding_collection_name = collectionName;
+        return this;
+    }
+    /**
+     * 设置集合前缀。
+     * @param {string} prefix - 集合前缀
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingCollectionPrefix(prefix) {
+        this.binding_collection_prefix = prefix;
+        return this;
+    }
+    /**
+     * 设置数据绑定的条件。
+     * @param {string} condition - 数据绑定的条件（可能值：always, always_when_visible, visible, once, none, visibility_changed）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingCondition(condition) {
+        this.binding_condition = condition;
+        return this;
+    }
+    /**
+     * 设置要观察其属性值的 UI 元素名称。
+     * @param {string} controlName - UI 元素名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setSourceControlName(controlName) {
+        this.source_control_name = controlName;
+        return this;
+    }
+    /**
+     * 设置存储 source_control_name 引用的 UI 元素的属性值。
+     * @param {string} propertyName - 属性名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setSourcePropertyName(propertyName) {
+        this.source_property_name = propertyName;
+        return this;
+    }
+    /**
+     * 设置应用 source_property_name 值的 UI 元素属性。
+     * @param {string} propertyName - 属性名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setTargetPropertyName(propertyName) {
+        this.target_property_name = propertyName;
+        return this;
+    }
+    /**
+     * 设置是否允许选择同级元素而非子元素。
+     * @param {boolean} resolve - 是否允许选择同级元素（默认值：false）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setResolveSiblingScope(resolve = false) {
+        this.resolve_sibling_scope = resolve;
+        return this;
+    }
+}

package/dist/core/ui/elements/button.d.ts

@@ -0,0 +1,21 @@
+export class Button extends UIElement {
+    constructor(id: any, template: any);
+    input: Input;
+    sound: Sound;
+    layout: Layout;
+    dataBinding: DataBinding;
+    factory: Factory;
+    setDefaultControl(default_control: any): this;
+    setHoverControl(hover_control: any): this;
+    setPressedControl(pressed_control: any): this;
+    setLockedControl(locked_control: any): this;
+    setInput(input: any): this;
+    setSound(sound: any): this;
+    setLayout(layout: any): this;
+}
+import { UIElement } from "./uiElement.js";
+import { Input } from "../properties/input.js";
+import { Sound } from "../properties/sound.js";
+import { Layout } from "../properties/layout.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";

package/dist/core/ui/elements/button.js

@@ -0,0 +1,101 @@
+/**
+ * Button ​
+    Property Name	Type	Default Value	Description
+    default_control	string		Name of the child control that will be displayed only in the default state
+    hover_control	string		Name of the child control that will be displayed only in the hover state
+    pressed_control	string		Name of the child control that will be displayed only in the pressed state
+    locked_control	string		Name of the child control that will be displayed only in the locked state
+ */
+import { Control } from "../properties/control.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";
+import { Input } from "../properties/input.js";
+import { Layout } from "../properties/layout.js";
+import { Sound } from "../properties/sound.js";
+import { UIElement } from "./uiElement.js";
+export class Button extends UIElement {
+    constructor(id, template) {
+        super(id, "button", template);
+        this.input = new Input();
+        this.sound = new Sound();
+        this.control = new Control();
+        this.layout = new Layout();
+        this.dataBinding = new DataBinding();
+        this.factory = new Factory();
+    }
+    setDefaultControl(default_control) {
+        this.addProp("default_control", default_control);
+        return this;
+    }
+    setHoverControl(hover_control) {
+        this.addProp("hover_control", hover_control);
+        return this;
+    }
+    setPressedControl(pressed_control) {
+        this.addProp("pressed_control", pressed_control);
+        return this;
+    }
+    setLockedControl(locked_control) {
+        this.addProp("locked_control", locked_control);
+        return this;
+    }
+    setInput(input) {
+        if (!(input instanceof Input))
+            new Error("需求Input类");
+        this.input = input;
+        return this;
+    }
+    setSound(sound) {
+        if (!(sound instanceof Sound))
+            new Error("需求Sound类");
+        this.sound = sound;
+        return this;
+    }
+    setLayout(layout) {
+        if (!(layout instanceof Layout))
+            new Error("参数需要Layout类");
+        this.layout = layout;
+        return this;
+    }
+    serialize() {
+        //序列化
+        // 复制Layout的属性
+        for (const key in this.layout) {
+            if (this.layout.hasOwnProperty(key)) {
+                this.properties.set(key, this.layout[key]);
+            }
+        }
+        // 复制input的属性
+        for (const key in this.input) {
+            if (this.input.hasOwnProperty(key)) {
+                this.properties.set(key, this.input[key]);
+            }
+        }
+        // 复制sound的属性
+        for (const key in this.sound) {
+            if (this.sound.hasOwnProperty(key)) {
+                this.properties.set(key, this.sound[key]);
+            }
+        }
+        // 复制DataBinding的属性
+        for (const key in this.dataBinding) {
+            if (this.dataBinding.hasOwnProperty(key)) {
+                this.properties.set(key, this.dataBinding[key]);
+            }
+        }
+        // 复制Factory的属性
+        for (const key in this.factory) {
+            if (this.factory.hasOwnProperty(key)) {
+                this.properties.set(key, this.factory[key]);
+            }
+        }
+        // 复制Control的属性
+        for (const key in this.control) {
+            if (this.control.hasOwnProperty(key)) {
+                this.properties.set(key, this.control[key]);
+            }
+        }
+        // 调用父类的serialize方法
+        return super.serialize();
+    }
+}

package/dist/core/ui/elements/collectionPanel.d.ts

@@ -0,0 +1,12 @@
+export class CollectionPanel extends UIElement {
+    constructor(id: any, template: any);
+    layout: Layout;
+    dataBinding: DataBinding;
+    factory: Factory;
+    setCollectionName(collection_name: any): this;
+    setLayout(layout: any): this;
+}
+import { UIElement } from "./uiElement.js";
+import { Layout } from "../properties/layout.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";

package/dist/core/ui/elements/collectionPanel.js

@@ -0,0 +1,53 @@
+import { Control } from "../properties/control.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";
+import { Layout } from "../properties/layout.js";
+import { UIElement } from "./uiElement.js";
+export class CollectionPanel extends UIElement {
+    constructor(id, template) {
+        super(id, "collection_panel", template);
+        this.control = new Control();
+        this.layout = new Layout();
+        this.dataBinding = new DataBinding();
+        this.factory = new Factory();
+    }
+    setCollectionName(collection_name) {
+        this.addProp("collection_name", collection_name);
+        return this;
+    }
+    setLayout(layout) {
+        if (!(layout instanceof Layout))
+            new Error("参数需要Layout类");
+        this.layout = layout;
+        return this;
+    }
+    serialize() {
+        //序列化
+        // 复制Layout的属性
+        for (const key in this.layout) {
+            if (this.layout.hasOwnProperty(key)) {
+                this.properties.set(key, this.layout[key]);
+            }
+        }
+        // 复制DataBinding的属性
+        for (const key in this.dataBinding) {
+            if (this.dataBinding.hasOwnProperty(key)) {
+                this.properties.set(key, this.dataBinding[key]);
+            }
+        }
+        // 复制Factory的属性
+        for (const key in this.factory) {
+            if (this.factory.hasOwnProperty(key)) {
+                this.properties.set(key, this.factory[key]);
+            }
+        }
+        // 复制Control的属性
+        for (const key in this.control) {
+            if (this.control.hasOwnProperty(key)) {
+                this.properties.set(key, this.control[key]);
+            }
+        }
+        // 调用父类的serialize方法
+        return super.serialize();
+    }
+}

package/dist/core/ui/elements/grid.d.ts

@@ -0,0 +1,8 @@
+export class Grid extends CollectionPanel {
+    gridNum: number;
+    grid: GridProp;
+    setGridProp(grid_prop: any): this;
+    addGridItem(grid_position: any, content: any): this;
+}
+import { CollectionPanel } from "./collectionPanel.js";
+import { GridProp } from "../properties/gridProp.js";

package/dist/core/ui/elements/grid.js

@@ -0,0 +1,33 @@
+import { GridProp } from "../properties/gridProp.js";
+import { CollectionPanel } from "./collectionPanel.js";
+import { Panel } from "./panel.js";
+export class Grid extends CollectionPanel {
+    constructor(id, template) {
+        super(id, template);
+        this.gridNum = 0;
+        this.grid = new GridProp();
+    }
+    setGridProp(grid_prop) {
+        this.grid = grid_prop;
+        return this;
+    }
+    addGridItem(grid_position, content) {
+        const grid_item = new Panel(`grid_item_${this.gridNum}`);
+        grid_item.addProp("grid_position", grid_position);
+        grid_item.addControl(content);
+        this.addControl(grid_item);
+        this.gridNum++;
+        return this;
+    }
+    serialize() {
+        // 复制grid的属性
+        for (const key in this.grid) {
+            if (this.grid.hasOwnProperty(key)) {
+                this.properties.set(key, this.grid[key]);
+            }
+        }
+        //类型修正
+        this.properties.set("type", "grid");
+        return super.serialize();
+    }
+}

package/dist/core/ui/elements/image.d.ts

@@ -0,0 +1,13 @@
+export class Image extends UIElement {
+    constructor(id: any, template: any);
+    sprite: Sprite;
+    layout: Layout;
+    dataBinding: DataBinding;
+    factory: Factory;
+    setSprite(sprite: any): this;
+}
+import { UIElement } from "./uiElement.js";
+import { Sprite } from "../properties/sprite.js";
+import { Layout } from "../properties/layout.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";

package/dist/core/ui/elements/image.js

@@ -0,0 +1,55 @@
+import { Control } from "../properties/control.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";
+import { Layout } from "../properties/layout.js";
+import { Sprite } from "../properties/sprite.js";
+import { UIElement } from "./uiElement.js";
+export class Image extends UIElement {
+    constructor(id, template) {
+        super(id, "image", template);
+        this.sprite = new Sprite();
+        this.control = new Control();
+        this.layout = new Layout();
+        this.dataBinding = new DataBinding();
+        this.factory = new Factory();
+    }
+    setSprite(sprite) {
+        this.sprite = sprite;
+        return this;
+    }
+    serialize() {
+        //合并属性
+        // 复制Sprite的属性
+        for (const key in this.sprite) {
+            if (this.sprite.hasOwnProperty(key)) {
+                this.properties.set(key, this.sprite[key]);
+            }
+        }
+        // 复制Layout的属性
+        for (const key in this.layout) {
+            if (this.layout.hasOwnProperty(key)) {
+                this.properties.set(key, this.layout[key]);
+            }
+        }
+        // 复制DataBinding的属性
+        for (const key in this.dataBinding) {
+            if (this.dataBinding.hasOwnProperty(key)) {
+                this.properties.set(key, this.dataBinding[key]);
+            }
+        }
+        // 复制Factory的属性
+        for (const key in this.factory) {
+            if (this.factory.hasOwnProperty(key)) {
+                this.properties.set(key, this.factory[key]);
+            }
+        }
+        // 复制Control的属性
+        for (const key in this.control) {
+            if (this.control.hasOwnProperty(key)) {
+                this.properties.set(key, this.control[key]);
+            }
+        }
+        // 调用父类的serialize方法
+        return super.serialize();
+    }
+}

package/dist/core/ui/elements/label.d.ts

@@ -0,0 +1,14 @@
+export class Label extends UIElement {
+    constructor(id: any, template: any);
+    text: Text;
+    layout: Layout;
+    dataBinding: DataBinding;
+    factory: Factory;
+    setLayout(layout: any): this;
+    setText(text: any): this;
+}
+import { UIElement } from "./uiElement.js";
+import { Text } from "../properties/text.js";
+import { Layout } from "../properties/layout.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";

package/dist/core/ui/elements/label.js

@@ -0,0 +1,61 @@
+import { Control } from "../properties/control.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";
+import { Layout } from "../properties/layout.js";
+import { Text } from "../properties/text.js";
+import { UIElement } from "./uiElement.js";
+export class Label extends UIElement {
+    constructor(id, template) {
+        super(id, "label", template);
+        this.text = new Text();
+        this.control = new Control();
+        this.layout = new Layout();
+        this.dataBinding = new DataBinding();
+        this.factory = new Factory();
+    }
+    setLayout(layout) {
+        if (!(layout instanceof Layout))
+            new Error("参数需要Layout类");
+        this.layout = layout;
+        return this;
+    }
+    setText(text) {
+        this.text = text;
+        return this;
+    }
+    serialize() {
+        //合并属性
+        // 复制Text的属性
+        for (const key in this.text) {
+            if (this.text.hasOwnProperty(key)) {
+                this.properties.set(key, this.text[key]);
+            }
+        }
+        // 复制Layout的属性
+        for (const key in this.layout) {
+            if (this.layout.hasOwnProperty(key)) {
+                this.properties.set(key, this.layout[key]);
+            }
+        }
+        // 复制DataBinding的属性
+        for (const key in this.dataBinding) {
+            if (this.dataBinding.hasOwnProperty(key)) {
+                this.properties.set(key, this.dataBinding[key]);
+            }
+        }
+        // 复制Factory的属性
+        for (const key in this.factory) {
+            if (this.factory.hasOwnProperty(key)) {
+                this.properties.set(key, this.factory[key]);
+            }
+        }
+        // 复制Control的属性
+        for (const key in this.control) {
+            if (this.control.hasOwnProperty(key)) {
+                this.properties.set(key, this.control[key]);
+            }
+        }
+        // 调用父类的serialize方法
+        return super.serialize();
+    }
+}

package/dist/core/ui/elements/panel.d.ts

@@ -0,0 +1,11 @@
+export class Panel extends UIElement {
+    constructor(id: any, template: any);
+    layout: Layout;
+    dataBinding: DataBinding;
+    factory: Factory;
+    setLayout(layout: any): this;
+}
+import { UIElement } from "./uiElement.js";
+import { Layout } from "../properties/layout.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";

package/dist/core/ui/elements/panel.js

@@ -0,0 +1,49 @@
+import { Control } from "../properties/control.js";
+import { DataBinding } from "../properties/dataBinding.js";
+import { Factory } from "../properties/factory.js";
+import { Layout } from "../properties/layout.js";
+import { UIElement } from "./uiElement.js";
+export class Panel extends UIElement {
+    constructor(id, template) {
+        super(id, "panel", template);
+        this.control = new Control();
+        this.layout = new Layout();
+        this.dataBinding = new DataBinding();
+        this.factory = new Factory();
+    }
+    setLayout(layout) {
+        if (!(layout instanceof Layout))
+            new Error("参数需要Layout类");
+        this.layout = layout;
+        return this;
+    }
+    serialize() {
+        //序列化
+        // 复制Layout的属性
+        for (const key in this.layout) {
+            if (this.layout.hasOwnProperty(key)) {
+                this.properties.set(key, this.layout[key]);
+            }
+        }
+        // 复制DataBinding的属性
+        for (const key in this.dataBinding) {
+            if (this.dataBinding.hasOwnProperty(key)) {
+                this.properties.set(key, this.dataBinding[key]);
+            }
+        }
+        // 复制Factory的属性
+        for (const key in this.factory) {
+            if (this.factory.hasOwnProperty(key)) {
+                this.properties.set(key, this.factory[key]);
+            }
+        }
+        // 复制Control的属性
+        for (const key in this.control) {
+            if (this.control.hasOwnProperty(key)) {
+                this.properties.set(key, this.control[key]);
+            }
+        }
+        // 调用父类的serialize方法
+        return super.serialize();
+    }
+}