sapdon 3.4.0 → 3.5.0

package/prod/core/index.d.ts

@@ -2973,21 +2973,148 @@ declare class RecipeRegistry {
     registerShapeless(identifier: any): AddonRecipeShapeless_1_17;
 }
 
+type Any$1 = any;
 declare 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;
-    toObject(): {
-        namespace: any;
-    };
+    identifier: string;
+    namespace: string;
+    name: string;
+    path: string;
+    elements: Map<string, Any$1>;
+    animations: Map<string, Any$1>;
+    constructor(identifier: string, path: string);
+    addElement(element: Any$1): this;
+    getElement(element_name: string): Any$1;
+    addAnimation(name: string, value: Any$1): void;
+    getAnimation(animation_name: string): Any$1;
+    toObject(): Record<string, Any$1>;
+}
+
+/** 共享 UI 类型定义（JSON UI 规范的受控映射） */
+/** 尺寸向量（像素数字或百分比/计算字符串），如 [320, 207] / ["50%", "100%"] */
+type Size2 = [number | string, number | string];
+/** 偏移向量 [x, y]（像素） */
+type Offset2 = [number, number];
+/** 锚点（anchor_from / anchor_to）可选值 */
+type Anchor = 'top_left' | 'top_middle' | 'top_right' | 'left_middle' | 'center' | 'right_middle' | 'bottom_left' | 'bottom_middle' | 'bottom_right';
+/** 数据绑定类型 */
+type BindingType = 'global' | 'view' | 'collection' | 'collection_details' | 'none';
+/** 数据绑定条件 */
+type BindingCondition = 'always' | 'always_when_visible' | 'visible' | 'once' | 'none' | 'visibility_changed';
+/** 调制操作类型（Modifications.OPERATION 的字面量） */
+type ModificationOperation = 'insert_back' | 'insert_front' | 'insert_after' | 'insert_before' | 'move_back' | 'move_front' | 'move_after' | 'move_before' | 'swap' | 'replace' | 'remove';
+/** 支持任意键的 JSON UI 属性包（类内部索引签名基类型） */
+type JsonUIBag = {
+    [key: string]: any;
+};
+
+/**
+ * DataBindingObject 类
+ *
+ * 该类表示数据绑定配置，用于将硬编码值或变量绑定到元素属性。
+ *
+ * 属性：
+ * - 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）
+ */
+
+type BindingTypeOrString = BindingType | string;
+type BindingConditionOrString = BindingCondition | string;
+declare class DataBindingObject {
+    [key: string]: unknown;
+    ignored: boolean;
+    binding_type: BindingTypeOrString;
+    binding_name: string;
+    binding_name_override: string;
+    binding_collection_name: string;
+    binding_collection_prefix: string;
+    binding_condition: BindingConditionOrString;
+    source_control_name: string;
+    source_property_name: string;
+    target_property_name: string;
+    resolve_sibling_scope: boolean;
+    /**
+     * 设置是否忽略绑定。
+     * @param {boolean} ignored - 是否忽略绑定（默认值：false）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setIgnored(ignored?: boolean): this;
+    /**
+     * 设置绑定类型。
+     * @param {BindingTypeOrString} type - 绑定类型（可能值：global, view, collection, collection_details, none）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingType(type: BindingTypeOrString): this;
+    /**
+     * 设置数据绑定名称或条件的值。
+     * @param {string} name - 数据绑定名称或条件的值
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingName(name: string): this;
+    /**
+     * 设置应用 binding_name 值的 UI 元素属性名称。
+     * @param {string} nameOverride - 应用 binding_name 值的 UI 元素属性名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingNameOverride(nameOverride: string): this;
+    /**
+     * 设置要使用的集合名称。
+     * @param {string} collectionName - 集合名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingCollectionName(collectionName: string): this;
+    /**
+     * 设置集合前缀。
+     * @param {string} prefix - 集合前缀
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingCollectionPrefix(prefix: string): this;
+    /**
+     * 设置数据绑定的条件。
+     * @param {BindingConditionOrString} condition - 数据绑定的条件（可能值：always, always_when_visible, visible, once, none, visibility_changed）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setBindingCondition(condition: BindingConditionOrString): this;
+    /**
+     * 设置要观察其属性值的 UI 元素名称。
+     * @param {string} controlName - UI 元素名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setSourceControlName(controlName: string): this;
+    /**
+     * 设置存储 source_control_name 引用的 UI 元素的属性值。
+     * @param {string} propertyName - 属性名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setSourcePropertyName(propertyName: string): this;
+    /**
+     * 设置应用 source_property_name 值的 UI 元素属性。
+     * @param {string} propertyName - 属性名称
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setTargetPropertyName(propertyName: string): this;
+    /**
+     * 设置是否允许选择同级元素而非子元素。
+     * @param {boolean} resolve - 是否允许选择同级元素（默认值：false）
+     * @returns {DataBindingObject} 返回当前实例以支持链式调用
+     */
+    setResolveSiblingScope(resolve?: boolean): this;
+}
+
+declare class DataBinding {
+    [key: string]: unknown;
+    bindings: DataBindingObject[];
+    binding: DataBindingObject;
+    setBinding(binding: DataBindingObject): this;
+    addDataBinding(dataBindingObject: DataBindingObject): this;
 }
 
 /**
@@ -3019,190 +3146,165 @@ declare class UISystem {
  * - grid_position: Vector [row, column] - Position that the control will take inside the grid. This also allows to modify specific grid items of a hardcoded grid
  * - collection_index: int - Index that the control takes in the collection
  */
-/**
- * Control 类
- *
- * 该类表示一个具有各种属性和方法的 UI 控件元素，用于操作其状态。
- *
- * 属性：
- * - visible: boolean - 控制 UI 元素是否可见（默认值：true）
- * - enabled: boolean - 如果为 true，且 UI 元素或其任何子元素处于锁定状态，则它们将被锁定（默认值：true）
- * - layer: int - 相对于父元素的 Z-Index/层级（类似于 CSS 中的 zindex）。较高的层级将渲染在上方（默认值：0）
- * - alpha: float - 元素的透明度。仅影响 UI 元素本身，其子元素不受影响。如果希望透明度同时应用于父元素和子元素，请使用 propagate_alpha（默认值：1.0）
- * - propagate_alpha: boolean - 透明度是否应同时应用于父元素及其所有子元素（默认值：false）
- * - clips_children: boolean - 是否在视觉上和交互上裁剪超出 UI 元素边界的内容（默认值：false）
- * - allow_clipping: boolean - 是否允许在 UI 元素中启用裁剪。否则，clips_children 将无效（默认值：true）
- * - clip_offset: Vector [x, y] - 裁剪起始点的偏移量（默认值：[0, 0]）
- * - clip_state_change_event: string - 裁剪状态更改时触发的事件
- * - enable_scissor_test: boolean - 是否启用裁剪测试（默认值：false）
- * - property_bag: object - 属性包，包含与数据相关的属性/变量，而不是 UI 元素的实际结构和外观
- * - selected: boolean - 文本框是否默认被选中
- * - use_child_anchors: boolean - 是否使用 UI 元素子元素的 anchor_from 和 anchor_to（默认值：false）
- * - controls: array - 用于向元素添加子元素
- * - anims: string[] - 动画名称数组
- * - disable_anim_fast_forward: boolean - 是否禁用动画快进
- * - animation_reset_name: string - 重置动画的名称
- * - ignored: boolean - 是否忽略该 UI 元素（默认值：false）
- * - variables: array 或 object - 一组条件，用于更改变量的值
- * - modifications: array - 允许修改资源包中的 UI 文件（最底层为原版资源包）
- * - grid_position: Vector [row, column] - 控件在网格中的位置。此属性还允许修改硬编码网格中的特定网格项
- * - collection_index: int - 控件在集合中的索引
- */
+
+/** 附加到 Control.controls 的子元素：可序列化元素对象或 JSON UI 控件对象 */
+type ChildControl = Record<string, unknown>;
 declare class Control {
+    [key: string]: unknown;
+    visible: boolean;
+    enabled: boolean;
+    layer: number;
+    alpha: number;
+    propagate_alpha: boolean;
+    clips_children: boolean;
+    allow_clipping: boolean;
+    clip_offset: Offset2;
+    clip_state_change_event: string;
+    enable_scissor_test: boolean;
+    property_bag: JsonUIBag;
+    selected: boolean;
+    use_child_anchors: boolean;
+    controls: ChildControl[];
+    anims: string[];
+    disable_anim_fast_forward: boolean;
+    animation_reset_name: string;
+    ignored: boolean;
+    variables: JsonUIBag;
+    modifications: unknown[];
+    grid_position: Offset2;
+    collection_index: number;
     /**
      * 设置控件的可见性。
      * @param {boolean} visible - 控件是否可见（默认值：true）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setVisible(visible?: boolean): Control;
-    visible: boolean | undefined;
+    setVisible(visible?: boolean): this;
     /**
      * 设置控件的启用状态。
      * @param {boolean} enabled - 控件是否启用（默认值：true）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setEnabled(enabled?: boolean): Control;
-    enabled: boolean | undefined;
+    setEnabled(enabled?: boolean): this;
     /**
      * 设置控件的层级（z-index）。
      * @param {number} layer - 要设置的层级（默认值：0）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setLayer(layer?: number): Control;
-    layer: number | undefined;
+    setLayer(layer?: number): this;
     /**
      * 设置控件的透明度。
      * @param {number} alpha - 要设置的透明度值（默认值：1.0）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setAlpha(alpha?: number): Control;
-    alpha: number | undefined;
+    setAlpha(alpha?: number): this;
     /**
      * 设置透明度是否应传播到子元素。
      * @param {boolean} propagate - 透明度是否应传播（默认值：false）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setPropagateAlpha(propagate?: boolean): Control;
-    propagate_alpha: boolean | undefined;
+    setPropagateAlpha(propagate?: boolean): this;
     /**
      * 设置控件是否应裁剪其子元素。
      * @param {boolean} clips - 控件是否应裁剪其子元素（默认值：false）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setClipsChildren(clips?: boolean): Control;
-    clips_children: boolean | undefined;
+    setClipsChildren(clips?: boolean): this;
     /**
      * 设置控件是否允许裁剪。
      * @param {boolean} allow - 是否允许裁剪（默认值：true）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setAllowClipping(allow?: boolean): Control;
-    allow_clipping: boolean | undefined;
+    setAllowClipping(allow?: boolean): this;
     /**
      * 设置控件的裁剪偏移量。
-     * @param {number[]} offset - 裁剪偏移量，格式为 [x, y]（默认值：[0, 0]）
+     * @param {Offset2} offset - 裁剪偏移量，格式为 [x, y]（默认值：[0, 0]）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setClipOffset(offset?: number[]): Control;
-    clip_offset: number[] | undefined;
+    setClipOffset(offset?: Offset2): this;
     /**
      * 设置裁剪状态更改事件。
      * @param {string} event - 裁剪状态更改时触发的事件名称
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setClipStateChangeEvent(event: string): Control;
-    clip_state_change_event: string | undefined;
+    setClipStateChangeEvent(event: string): this;
     /**
      * 设置是否启用裁剪测试。
      * @param {boolean} enable - 是否启用裁剪测试（默认值：false）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setEnableScissorTest(enable?: boolean): Control;
-    enable_scissor_test: boolean | undefined;
+    setEnableScissorTest(enable?: boolean): this;
     /**
      * 设置控件的属性包。
-     * @param {object} bag - 要设置的属性包
+     * @param {JsonUIBag} bag - 要设置的属性包
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setPropertyBag(bag: object): Control;
-    property_bag: object | undefined;
+    setPropertyBag(bag: JsonUIBag): this;
     /**
      * 设置控件是否被选中。
      * @param {boolean} selected - 控件是否被选中（默认值：false）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setSelected(selected?: boolean): Control;
-    selected: boolean | undefined;
+    setSelected(selected?: boolean): this;
     /**
      * 设置控件是否使用子元素的锚点。
      * @param {boolean} use - 是否使用子元素的锚点（默认值：false）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setUseChildAnchors(use?: boolean): Control;
-    use_child_anchors: boolean | undefined;
+    setUseChildAnchors(use?: boolean): this;
     /**
      * 向控件添加子控件。
-     * @param {Control} control - 要添加的子控件
+     * @param {ChildControl} control - 要添加的子控件
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    addControl(control: Control): Control;
-    controls: any[] | undefined;
+    addControl(control: ChildControl): this;
     /**
      * 设置控件的动画。
      * @param {string[]} anims - 动画名称数组
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setAnimations(anims: string[]): Control;
-    anims: string[] | undefined;
+    setAnimations(anims: string[]): this;
     /**
      * 设置是否禁用动画快进。
      * @param {boolean} disable - 是否禁用动画快进（默认值：false）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setDisableAnimFastForward(disable?: boolean): Control;
-    disable_anim_fast_forward: boolean | undefined;
+    setDisableAnimFastForward(disable?: boolean): this;
     /**
      * 设置动画重置名称。
      * @param {string} name - 要重置的动画名称
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setAnimationResetName(name: string): Control;
-    animation_reset_name: string | undefined;
+    setAnimationResetName(name: string): this;
     /**
      * 设置是否忽略该控件。
      * @param {boolean} ignored - 是否忽略该控件（默认值：false）
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setIgnored(ignored?: boolean): Control;
-    ignored: boolean | undefined;
+    setIgnored(ignored?: boolean): this;
     /**
      * 设置控件的变量。
-     * @param {object} variables - 要设置的变量
+     * @param {JsonUIBag} variables - 要设置的变量
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setVariables(variables: object): Control;
-    variables: object | undefined;
+    setVariables(variables: JsonUIBag): this;
     /**
      * 设置控件的修改项。
-     * @param {array} modifications - 要设置的修改项
+     * @param {unknown[]} modifications - 要设置的修改项
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setModifications(modifications: array): Control;
-    modifications: any;
+    setModifications(modifications: unknown[]): this;
     /**
      * 设置控件在网格中的位置。
-     * @param {number[]} position - 网格位置，格式为 [行, 列]
+     * @param {Offset2} position - 网格位置，格式为 [行, 列]
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setGridPosition(position: number[]): Control;
-    grid_position: number[] | undefined;
+    setGridPosition(position: Offset2): this;
     /**
      * 设置控件在集合中的索引。
      * @param {number} index - 要设置的索引
      * @returns {Control} 返回当前实例以支持链式调用
      */
-    setCollectionIndex(index: number): Control;
-    collection_index: number | undefined;
+    setCollectionIndex(index: number): this;
 }
 
 /**
@@ -3224,125 +3326,163 @@ declare class Control {
  * - draggable: enum - 是否使元素可拖动（可能值：vertical, horizontal, both）
  * - follows_cursor: boolean - 是否使元素跟随光标（默认值：false）
  */
+
+type AnchorOrString = Anchor | string;
+type SizeOrString = Size2 | string;
 declare class Layout {
+    [key: string]: unknown;
+    size: SizeOrString;
+    max_size: Size2;
+    min_size: Size2;
+    offset: Offset2;
+    anchor_from: AnchorOrString;
+    anchor_to: AnchorOrString;
+    inherit_max_sibling_width: boolean;
+    inherit_max_sibling_height: boolean;
+    use_anchored_offset: boolean;
+    contained: boolean;
+    draggable: 'vertical' | 'horizontal' | 'both';
+    follows_cursor: boolean;
     /**
      * 设置 UI 元素的大小。
-     * @param {any[]} size - 大小，格式为 [width, height]（默认值：["default", "default"]）
+     * @param {Size2} size - 大小，格式为 [width, height]（默认值：["default", "default"]）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setSize(size?: any[]): Layout;
-    size: any[] | undefined;
+    setSize(size?: SizeOrString): this;
     /**
      * 设置 UI 元素的最大大小。
-     * @param {string[]} maxSize - 最大大小，格式为 [width, height]（默认值：["default", "default"]）
+     * @param {Size2} maxSize - 最大大小，格式为 [width, height]（默认值：["default", "default"]）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setMaxSize(maxSize?: string[]): Layout;
-    max_size: string[] | undefined;
+    setMaxSize(maxSize?: Size2): this;
     /**
      * 设置 UI 元素的最小大小。
-     * @param {string[]} minSize - 最小大小，格式为 [width, height]（默认值：["default", "default"]）
+     * @param {Size2} minSize - 最小大小，格式为 [width, height]（默认值：["default", "default"]）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setMinSize(minSize?: string[]): Layout;
-    min_size: string[] | undefined;
+    setMinSize(minSize?: Size2): this;
     /**
      * 设置 UI 元素相对于父元素的位置。
-     * @param {number[]} offset - 偏移量，格式为 [x, y]（默认值：[0, 0]）
+     * @param {Offset2} offset - 偏移量，格式为 [x, y]（默认值：[0, 0]）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setOffset(offset?: number[]): Layout;
-    offset: number[] | undefined;
+    setOffset(offset?: Offset2): this;
     /**
      * 设置父元素中的锚点。
-     * @param {string} anchorFrom - 锚点（可能值：top_left, top_middle, top_right, left_middle, center, right_middle, bottom_left, bottom_middle, bottom_right）（默认值：center）
+     * @param {AnchorOrString} anchorFrom - 锚点（可能值：top_left, top_middle, top_right, left_middle, center, right_middle, bottom_left, bottom_middle, bottom_right）（默认值：center）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setAnchorFrom(anchorFrom?: string): Layout;
-    anchor_from: string | undefined;
+    setAnchorFrom(anchorFrom?: AnchorOrString): this;
     /**
      * 设置元素自身的锚点。
-     * @param {string} anchorTo - 锚点（可能值：top_left, top_middle, top_right, left_middle, center, right_middle, bottom_left, bottom_middle, bottom_right）（默认值：center）
+     * @param {AnchorOrString} anchorTo - 锚点（可能值：top_left, top_middle, top_right, left_middle, center, right_middle, bottom_left, bottom_middle, bottom_right）（默认值：center）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setAnchorTo(anchorTo?: string): Layout;
-    anchor_to: string | undefined;
+    setAnchorTo(anchorTo?: AnchorOrString): this;
     /**
      * 设置是否使用兄弟元素的最大宽度。
      * @param {boolean} inherit - 是否使用兄弟元素的最大宽度（默认值：false）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setInheritMaxSiblingWidth(inherit?: boolean): Layout;
-    inherit_max_sibling_width: boolean | undefined;
+    setInheritMaxSiblingWidth(inherit?: boolean): this;
     /**
      * 设置是否使用兄弟元素的最大高度。
      * @param {boolean} inherit - 是否使用兄弟元素的最大高度（默认值：false）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setInheritMaxSiblingHeight(inherit?: boolean): Layout;
-    inherit_max_sibling_height: boolean | undefined;
+    setInheritMaxSiblingHeight(inherit?: boolean): this;
     /**
      * 设置是否使用基于锚点的偏移。
      * @param {boolean} use - 是否使用基于锚点的偏移（默认值：false）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setUseAnchoredOffset(use?: boolean): Layout;
-    use_anchored_offset: boolean | undefined;
+    setUseAnchoredOffset(use?: boolean): this;
     /**
      * 设置是否限制元素在父元素边界内。
      * @param {boolean} contained - 是否限制元素在父元素边界内（默认值：false）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setContained(contained?: boolean): Layout;
-    contained: boolean | undefined;
+    setContained(contained?: boolean): this;
     /**
      * 设置是否使元素可拖动。
-     * @param {string} draggable - 是否使元素可拖动（可能值：vertical, horizontal, both）
+     * @param {'vertical' | 'horizontal' | 'both'} draggable - 是否使元素可拖动（可能值：vertical, horizontal, both）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setDraggable(draggable: string): Layout;
-    draggable: string | undefined;
+    setDraggable(draggable: 'vertical' | 'horizontal' | 'both'): this;
     /**
      * 设置是否使元素跟随光标。
      * @param {boolean} follows - 是否使元素跟随光标（默认值：false）
      * @returns {Layout} 返回当前实例以支持链式调用
      */
-    setFollowsCursor(follows?: boolean): Layout;
-    follows_cursor: boolean | undefined;
+    setFollowsCursor(follows?: boolean): this;
 }
 
-declare class DataBinding {
-    setBinding(binding: any): this;
-    bindings: any[] | undefined;
-    binding: any;
-    addDataBinding(dataBindingObject: any): this;
-}
+/**
+ * Elements
+    A JSON UI element is the basic form of data within JSON UI. Elements must have a unique name for each namespace so as to not have a conflict with other elements of the same name yet may have different functions.
+
+    Here the element type is label so it will render a text of Hello World when called:
 
+    vanilla/ui/example_file.json
+
+    {
+        "test_element": {
+            "type": "label",
+            "text": "Hello World"
+        }
+    }
+    Types
+    The following are some of the element types, which are possible values for the type property:
+
+    label - for creating text objects
+    image - for rendering images from a filepath provided
+    button - for creating interactive and clickable elements
+    panel - an empty container where you can store all other elements that may overlap to each other
+    stack_panel - an empty container where you can store all other elements in a stack that doesn't overlap to each other
+    grid - uses another element as a template, and then renders it repeatedly in multiple rows and columns
+    factory - renders an element based off of another element, is capable of calling hardcoded values and variables
+    custom - is paired with another property renderer which renders hardcoded JSON UI elements
+    screen - elements that are called by the game directly, usually root panel elements
+ */
+
+type SerializedElement = Record<string, JsonUIBag>;
+type AnyJSON = any;
 declare class UIElement {
-    constructor(name: any, type: any, template: any);
-    type: any;
-    id: any;
-    name: any;
+    type: string | undefined;
+    id: string;
+    name: string;
     control: Control;
     layout: Layout;
-    properties: Map<any, any>;
-    variables: Map<any, any>;
+    properties: Map<string, AnyJSON>;
+    variables: Map<string, AnyJSON>;
     dataBinding: DataBinding;
-    modifications: any[];
-    enableDebug(): this;
-    setLayout(layout: any): this;
-    setControl(control: any): this;
-    addControl(control: any): this;
-    addControls(controls: any): this;
-    addVariable(name: any, value: any): this;
-    addProp(name: any, value: any): this;
-    addModification(modification: any): this;
-    serialize(): {
-        [x: number]: any;
-    };
+    modifications: {
+        array_name: string;
+        operation: ModificationOperation;
+        value: AnyJSON;
+    }[];
+    constructor(name: string, type?: string, template?: string);
+    enableDebug(color?: [number, number, number, number]): this;
+    setLayout(layout: Layout): this;
+    setControl(control: Control): this;
+    addControl(control: UIElement | JsonUIBag): this;
+    addControls(controls: (UIElement | JsonUIBag)[]): this;
+    addVariable(name: string, value: AnyJSON): this;
+    addProp(name: string, value: AnyJSON): this;
+    addModification(modification: {
+        array_name: string;
+        operation: ModificationOperation;
+        value: AnyJSON;
+    }): this;
+    /**
+     * 声明待序列化合并的属性包（子类覆写以加入自己的专属属性包）。
+     * 合并顺序对结果无影响：重复键值均相同。
+     */
+    protected serializableSources(): object[];
+    serialize(): SerializedElement;
 }
 /**
- * Modifications ​
+ * Modifications
     To modify JSON UI in a non-intrusive way, you can use the modifications property to modify previously existing JSON UI elements from other packs (usually vanilla JSON UI files). Doing this makes sure only necessary parts are modified unless otherwise intended, to improve compatibility with other packs that modify the JSON UI.
 
     Modification	Description
@@ -3360,17 +3500,17 @@ declare class UIElement {
  */
 declare class Modifications {
     static OPERATION: Readonly<{
-        INSERT_BACK: "insert_back";
-        INSERT_FRONT: "insert_front";
-        INSERT_AFTER: "insert_after";
-        INSERT_BEFORE: "insert_before";
-        MOVE_BACK: "move_back";
-        MOVE_FRONT: "move_front";
-        MOVE_AFTER: "move_after";
-        MOVE_BEFORE: "move_before";
-        SWAP: "swap";
-        REPLACE: "replace";
-        REMOVE: "remove";
+        readonly INSERT_BACK: "insert_back";
+        readonly INSERT_FRONT: "insert_front";
+        readonly INSERT_AFTER: "insert_after";
+        readonly INSERT_BEFORE: "insert_before";
+        readonly MOVE_BACK: "move_back";
+        readonly MOVE_FRONT: "move_front";
+        readonly MOVE_AFTER: "move_after";
+        readonly MOVE_BEFORE: "move_before";
+        readonly SWAP: "swap";
+        readonly REPLACE: "replace";
+        readonly REMOVE: "remove";
     }>;
 }
 
@@ -3383,44 +3523,46 @@ declare class Modifications {
  * - control_name: string - 工厂的子控件名
  * - control_ids: object - 工厂的子控件 ID 对象组
  */
+
 declare class Factory {
+    [key: string]: unknown;
+    factory: JsonUIBag;
     /**
      * 设置工厂的名。
      * @param {string} name - 名（格式：name）
      * @returns {Factory} 返回当前实例以支持链式调用
      */
-    setName(name: string): Factory;
-    factory: {} | undefined;
+    setName(name: string): this;
     /**
      * 设置工厂的子控件名。
      * @param {string} name - 子控件名（格式：namespace.controls_name）
      * @returns {Factory} 返回当前实例以支持链式调用
      */
-    setControlName(name: string): Factory;
+    setControlName(name: string): this;
     /**
      * 设置工厂的子控件 ID 对象组。
-     * @param {object} ids - 子控件 ID 对象组
+     * @param {JsonUIBag} ids - 子控件 ID 对象组
      * @returns {Factory} 返回当前实例以支持链式调用
      */
-    setControlIds(ids: object): Factory;
+    setControlIds(ids: JsonUIBag): this;
     /**
      * 添加一个子控件 ID。
      * @param {string} key - 子控件的键名
      * @param {string} value - 子控件的 ID 值
      * @returns {Factory} 返回当前实例以支持链式调用
      */
-    addControlId(key: string, value: string): Factory;
+    addControlId(key: string, value: string): this;
 }
 
 declare class Panel extends UIElement {
+    factory: Factory;
     /**
-     *
-     * @param {*} id
-     * @param {*} [template]
+     * @param {string} id
+     * @param {string} [template]
      */
-    constructor(id: any, template?: any);
-    factory: Factory;
-    setLayout(layout: any): this;
+    constructor(id: string, template?: string);
+    setLayout(layout: Layout): this;
+    protected serializableSources(): object[];
 }
 
 /**
@@ -3449,147 +3591,152 @@ declare class Panel extends UIElement {
  * - force_texture_reload: boolean - 是否在纹理路径更改时强制重新加载图像
  * - base_size: Vector [width, height] - 基础大小
  */
+type UV = [number, number];
+type ClipDirection = 'left' | 'right' | 'up' | 'down' | 'center';
+type TextureFileSystem = 'InUserPackage' | 'InAppPackage' | 'RawPath' | 'RawPersistent' | 'InSettingsDir' | 'InExternalDir' | 'InServerPackage' | 'InDataDir' | 'InUserDir' | 'InWorldDir' | 'StoreCache' | string;
 declare class Sprite {
+    [key: string]: unknown;
+    texture: string;
+    allow_debug_missing_texture: boolean;
+    uv: UV;
+    uv_size: UV;
+    texture_file_system: TextureFileSystem;
+    nineslice_size: number | [number, number, number, number];
+    tiled: boolean | 'x' | 'y';
+    tiled_scale: [number, number];
+    clip_direction: ClipDirection | string;
+    clip_ratio: number;
+    clip_pixelperfect: boolean;
+    keep_ratio: boolean;
+    bilinear: boolean;
+    fill: boolean;
+    $fit_to_width: boolean;
+    zip_folder: string;
+    grayscale: boolean;
+    force_texture_reload: boolean;
+    base_size: [number, number];
     /**
      * 设置图像纹理路径。
      * @param {string} texture - 图像路径（例如："textures/ui/White"）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setTexture(texture: string): Sprite;
-    texture: string | undefined;
+    setTexture(texture: string): this;
     /**
      * 设置是否在纹理未找到时显示缺失纹理。
      * @param {boolean} allow - 是否显示缺失纹理（默认值：true）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setAllowDebugMissingTexture(allow?: boolean): Sprite;
-    allow_debug_missing_texture: boolean | undefined;
+    setAllowDebugMissingTexture(allow?: boolean): this;
     /**
      * 设置纹理映射的起始位置。
-     * @param {number[]} uv - 起始位置，格式为 [u, v]
+     * @param {UV} uv - 起始位置，格式为 [u, v]
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setUV(uv: number[]): Sprite;
-    uv: number[] | undefined;
+    setUV(uv: UV): this;
     /**
      * 设置纹理映射的大小。
-     * @param {number[]} uvSize - 大小，格式为 [width, height]
+     * @param {UV} uvSize - 大小，格式为 [width, height]
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setUVSize(uvSize: number[]): Sprite;
-    uv_size: number[] | undefined;
+    setUVSize(uvSize: UV): this;
     /**
      * 设置纹理来源。
-     * @param {string} source - 纹理来源（可能值：InUserPackage, InAppPackage, RawPath, RawPersistent, InSettingsDir, InExternalDir, InServerPackage, InDataDir, InUserDir, InWorldDir, StoreCache, Usage is Unknown）
+     * @param {TextureFileSystem} source - 纹理来源（可能值：InUserPackage, InAppPackage 等）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setTextureFileSystem(source?: string): Sprite;
-    texture_file_system: string | undefined;
+    setTextureFileSystem(source?: TextureFileSystem): this;
     /**
      * 设置 9-slice 分割大小。
-     * @param {number|number[]} size - 9-slice 分割大小（可以是单个数字或 [x0, y0, x1, y1] 数组）
+     * @param {number | [number, number, number, number]} size - 9-slice 分割大小
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setNineSliceSize(size: number | number[]): Sprite;
-    nineslice_size: number | number[] | undefined;
+    setNineSliceSize(size: number | [number, number, number, number]): this;
     /**
      * 设置是否平铺纹理。
-     * @param {boolean|string} tiled - 是否平铺纹理（可能值：true/false, x, y）
+     * @param {boolean | 'x' | 'y'} tiled - 是否平铺纹理（可能值：true/false, x, y）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setTiled(tiled: boolean | string): Sprite;
-    tiled: string | boolean | undefined;
+    setTiled(tiled: boolean | 'x' | 'y'): this;
     /**
      * 设置平铺纹理的缩放比例。
-     * @param {number[]} scale - 缩放比例，格式为 [sX, sY]（默认值：[1, 1]）
+     * @param {[number, number]} scale - 缩放比例，格式为 [sX, sY]（默认值：[1, 1]）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setTiledScale(scale?: number[]): Sprite;
-    tiled_scale: number[] | undefined;
+    setTiledScale(scale?: [number, number]): this;
     /**
      * 设置裁剪方向的起始点。
-     * @param {string} direction - 裁剪方向（可能值：left, right, up, down, center）
+     * @param {ClipDirection} direction - 裁剪方向（可能值：left, right, up, down, center）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setClipDirection(direction: string): Sprite;
-    clip_direction: string | undefined;
+    setClipDirection(direction: ClipDirection | string): this;
     /**
      * 设置裁剪比例。
      * @param {number} ratio - 裁剪比例（范围：0.0 到 1.0）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setClipRatio(ratio: number): Sprite;
-    clip_ratio: number | undefined;
+    setClipRatio(ratio: number): this;
     /**
      * 设置是否尽可能保持像素精确裁剪。
      * @param {boolean} pixelPerfect - 是否保持像素精确裁剪
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setClipPixelPerfect(pixelPerfect?: boolean): Sprite;
-    clip_pixelperfect: boolean | undefined;
+    setClipPixelPerfect(pixelPerfect?: boolean): this;
     /**
      * 设置是否在调整大小时保持比例。
      * @param {boolean} keep - 是否保持比例（默认值：true）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setKeepRatio(keep?: boolean): Sprite;
-    keep_ratio: boolean | undefined;
+    setKeepRatio(keep?: boolean): this;
     /**
      * 设置是否在调整大小时使用双线性函数。
      * @param {boolean} bilinear - 是否使用双线性函数（默认值：false）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setBilinear(bilinear?: boolean): Sprite;
-    bilinear: boolean | undefined;
+    setBilinear(bilinear?: boolean): this;
     /**
      * 设置是否拉伸图像以适应大小。
      * @param {boolean} fill - 是否拉伸图像（默认值：false）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setFill(fill?: boolean): Sprite;
-    fill: boolean | undefined;
+    setFill(fill?: boolean): this;
     /**
      * 设置是否适应宽度。
      * @param {boolean} fit - 是否适应宽度
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setFitToWidth(fit?: boolean): Sprite;
-    $fit_to_width: boolean | undefined;
+    setFitToWidth(fit?: boolean): this;
     /**
      * 设置压缩文件夹路径。
      * @param {string} folder - 压缩文件夹路径
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setZipFolder(folder: string): Sprite;
-    zip_folder: string | undefined;
+    setZipFolder(folder: string): this;
     /**
      * 设置是否以黑白渲染图像。
      * @param {boolean} grayscale - 是否以黑白渲染图像（默认值：false）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setGrayscale(grayscale?: boolean): Sprite;
-    grayscale: boolean | undefined;
+    setGrayscale(grayscale?: boolean): this;
     /**
      * 设置是否在纹理路径更改时强制重新加载图像。
-     * @param {boolean} force - 是否强制重新加载图像
+     * @param {boolean} force - 是否强制重新加载图像（默认值：false）
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setForceTextureReload(force?: boolean): Sprite;
-    force_texture_reload: boolean | undefined;
+    setForceTextureReload(force?: boolean): this;
     /**
      * 设置基础大小。
-     * @param {number[]} size - 基础大小，格式为 [width, height]
+     * @param {[number, number]} size - 基础大小，格式为 [width, height]
      * @returns {Sprite} 返回当前实例以支持链式调用
      */
-    setBaseSize(size: number[]): Sprite;
-    base_size: number[] | undefined;
+    setBaseSize(size: [number, number]): this;
 }
 
 declare class Image extends UIElement {
-    constructor(id: any, template: any);
     sprite: Sprite;
     factory: Factory;
-    setSprite(sprite: any): this;
+    constructor(id: string, template?: string);
+    setSprite(sprite: Sprite): this;
+    protected serializableSources(): object[];
 }
 
 /**
@@ -3614,126 +3761,131 @@ declare class Image extends UIElement {
  * - backup_font_type: enum - 备用字体类型（默认值：default）
  * - text_alignment: enum - 文本对齐方式（未定义时根据 anchor_from 和 anchor_to 自动调整）
  */
+type RGB = [number, number, number];
+type FontSize = 'small' | 'normal' | 'large' | 'extra_large';
+type TextAlignment = 'left' | 'right' | 'center';
 declare class Text {
+    [key: string]: unknown;
+    text: string;
+    color: RGB;
+    locked_color: RGB;
+    shadow: boolean;
+    hide_hyphen: boolean;
+    notify_on_ellipses: string[];
+    enable_profanity_filter: boolean;
+    locked_alpha: number;
+    font_size: FontSize;
+    font_scale_factor: number;
+    localize: boolean;
+    line_padding: number;
+    font_type: string;
+    backup_font_type: string;
+    text_alignment: TextAlignment;
     /**
      * 设置文本内容。
      * @param {string} text - 文本内容
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setText(text?: string): Text;
-    text: string | undefined;
+    setText(text?: string): this;
     /**
      * 设置文本颜色。
-     * @param {number[]} color - RGB 颜色值（格式：[r, g, b]，默认值：[1.0, 1.0, 1.0]）
+     * @param {RGB} color - RGB 颜色值（格式：[r, g, b]，默认值：[1.0, 1.0, 1.0]）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setColor(color?: number[]): Text;
-    color: number[] | undefined;
+    setColor(color?: RGB): this;
     /**
      * 设置父级禁用时的文本颜色。
-     * @param {number[]} lockedColor - RGB 颜色值（格式：[r, g, b]）
+     * @param {RGB} lockedColor - RGB 颜色值（格式：[r, g, b]）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setLockedColor(lockedColor: number[]): Text;
-    locked_color: number[] | undefined;
+    setLockedColor(lockedColor: RGB): this;
     /**
      * 设置是否显示文本阴影。
      * @param {boolean} shadow - 是否显示阴影（默认值：false）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setShadow(shadow?: boolean): Text;
-    shadow: boolean | undefined;
+    setShadow(shadow?: boolean): this;
     /**
      * 设置是否隐藏断词连字符。
      * @param {boolean} hide - 是否隐藏连字符（默认值：false）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setHideHyphen(hide?: boolean): Text;
-    hide_hyphen: boolean | undefined;
+    setHideHyphen(hide?: boolean): this;
     /**
      * 设置文本出现省略号时需通知的控件名称数组。
      * @param {string[]} controls - 控件名称数组
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setNotifyOnEllipses(controls: string[]): Text;
-    notify_on_ellipses: string[] | undefined;
+    setNotifyOnEllipses(controls: string[]): this;
     /**
      * 添加一个需通知省略号事件的控件名称。
      * @param {string} controlName - 控件名称
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    addNotifyOnEllipses(controlName: string): Text;
+    addNotifyOnEllipses(controlName: string): this;
     /**
      * 设置是否启用脏话过滤。
      * @param {boolean} enable - 是否启用过滤（默认值：false）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setEnableProfanityFilter(enable?: boolean): Text;
-    enable_profanity_filter: boolean | undefined;
+    setEnableProfanityFilter(enable?: boolean): this;
     /**
      * 设置父级禁用时的透明度。
      * @param {number} alpha - 透明度（范围：0.0 到 1.0）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setLockedAlpha(alpha: number): Text;
-    locked_alpha: number | undefined;
+    setLockedAlpha(alpha: number): this;
     /**
      * 设置字体大小。
-     * @param {string} size - 字体大小（可能值：small, normal, large, extra_large，默认值：normal）
+     * @param {FontSize} size - 字体大小（可能值：small, normal, large, extra_large，默认值：normal）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setFontSize(size?: string): Text;
-    font_size: string | undefined;
+    setFontSize(size?: FontSize): this;
     /**
      * 设置字体缩放比例。
      * @param {number} factor - 缩放比例（默认值：1.0）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setFontScaleFactor(factor?: number): Text;
-    font_scale_factor: number | undefined;
+    setFontScaleFactor(factor?: number): this;
     /**
      * 设置是否启用本地化翻译。
      * @param {boolean} localize - 是否启用本地化（默认值：false）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setLocalize(localize?: boolean): Text;
-    localize: boolean | undefined;
+    setLocalize(localize?: boolean): this;
     /**
      * 设置行间距。
      * @param {number} padding - 行间距
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setLinePadding(padding: number): Text;
-    line_padding: number | undefined;
+    setLinePadding(padding: number): this;
     /**
      * 设置字体类型。
      * @param {string} font - 字体类型（可能值：default, rune, unicode 等，默认值：default）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setFontType(font?: string): Text;
-    font_type: string | undefined;
+    setFontType(font?: string): this;
     /**
      * 设置备用字体类型。
      * @param {string} backupFont - 备用字体类型（默认值：default）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setBackupFontType(backupFont?: string): Text;
-    backup_font_type: string | undefined;
+    setBackupFontType(backupFont?: string): this;
     /**
      * 设置文本对齐方式。
-     * @param {string} alignment - 对齐方式（例如：left, right, center）
+     * @param {TextAlignment} alignment - 对齐方式（例如：left, right, center）
      * @returns {Text} 返回当前实例以支持链式调用
      */
-    setTextAlignment(alignment: string): Text;
-    text_alignment: string | undefined;
+    setTextAlignment(alignment: TextAlignment): this;
 }
 
 declare class Label extends UIElement {
-    constructor(id: any, template: any);
     text: Text;
     factory: Factory;
-    setLayout(layout: any): this;
-    setText(text: any): this;
+    constructor(id: string, template?: string);
+    setLayout(layout: Layout): this;
+    setText(text: Text): this;
+    protected serializableSources(): object[];
 }
 
 declare namespace UiAPI {
@@ -4115,7 +4267,8 @@ declare class ItemComponent {
  * - handle_deselect: boolean - 是否处理取消选择事件
  * - button_up_right_of_first_refusal: boolean - 是否在首次拒绝后处理按钮释放事件
  */
-declare class ButtonMapping$1 {
+declare class ButtonMapping {
+    [key: string]: unknown;
     ignored: boolean;
     from_button_id: string;
     to_button_id: string;
@@ -4127,170 +4280,113 @@ declare class ButtonMapping$1 {
     handle_select: boolean;
     handle_deselect: boolean;
     button_up_right_of_first_refusal: boolean;
+    constructor();
     /**
      * 设置是否忽略映射。
      * @param {boolean} ignored - 是否忽略映射（默认值：false）
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setIgnored(ignored?: boolean): ButtonMapping$1;
+    setIgnored(ignored?: boolean): this;
     /**
      * 设置触发事件的按钮 ID。
      * @param {string} fromButtonId - 触发事件的按钮 ID
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setFromButtonId(fromButtonId: string): ButtonMapping$1;
+    setFromButtonId(fromButtonId: string): this;
     /**
      * 设置事件触发时执行的按钮 ID。
      * @param {string} toButtonId - 事件触发时执行的按钮 ID
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setToButtonId(toButtonId: string): ButtonMapping$1;
+    setToButtonId(toButtonId: string): this;
     /**
      * 设置映射类型。
      * @param {string} mappingType - 映射类型（可能值：global, pressed, double_pressed, focused）
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setMappingType(mappingType: string): ButtonMapping$1;
+    setMappingType(mappingType: string): this;
     /**
      * 设置映射范围。
      * @param {string} scope - 映射范围（可能值：view, controller）
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setScope(scope: string): ButtonMapping$1;
+    setScope(scope: string): this;
     /**
      * 设置输入模式条件。
      * @param {string} condition - 输入模式条件（可能值：not_gaze, not_gamepad, gamepad_and_not_gaze）
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setInputModeCondition(condition: string): ButtonMapping$1;
+    setInputModeCondition(condition: string): this;
     /**
      * 设置是否忽略输入范围。
      * @param {boolean} ignore - 是否忽略输入范围
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setIgnoreInputScope(ignore?: boolean): ButtonMapping$1;
+    setIgnoreInputScope(ignore?: boolean): this;
     /**
      * 设置是否消耗事件。
      * @param {boolean} consume - 是否消耗事件
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setConsumeEvent(consume?: boolean): ButtonMapping$1;
+    setConsumeEvent(consume?: boolean): this;
     /**
      * 设置是否处理选择事件。
      * @param {boolean} handle - 是否处理选择事件
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setHandleSelect(handle?: boolean): ButtonMapping$1;
+    setHandleSelect(handle?: boolean): this;
     /**
      * 设置是否处理取消选择事件。
      * @param {boolean} handle - 是否处理取消选择事件
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setHandleDeselect(handle?: boolean): ButtonMapping$1;
+    setHandleDeselect(handle?: boolean): this;
     /**
      * 设置是否在首次拒绝后处理按钮释放事件。
      * @param {boolean} handle - 是否处理按钮释放事件
      * @returns {ButtonMapping} 返回当前实例以支持链式调用
      */
-    setButtonUpRightOfFirstRefusal(handle?: boolean): ButtonMapping$1;
+    setButtonUpRightOfFirstRefusal(handle?: boolean): this;
 }
 
-/**
- * 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）
- */
-declare class DataBindingObject {
-    /**
-     * 设置是否忽略绑定。
-     * @param {boolean} ignored - 是否忽略绑定（默认值：false）
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setIgnored(ignored?: boolean): DataBindingObject;
-    ignored: boolean | undefined;
-    /**
-     * 设置绑定类型。
-     * @param {string} type - 绑定类型（可能值：global, view, collection, collection_details, none）
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setBindingType(type: string): DataBindingObject;
-    binding_type: string | undefined;
-    /**
-     * 设置数据绑定名称或条件的值。
-     * @param {string} name - 数据绑定名称或条件的值
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setBindingName(name: string): DataBindingObject;
-    binding_name: string | undefined;
-    /**
-     * 设置应用 binding_name 值的 UI 元素属性名称。
-     * @param {string} nameOverride - 应用 binding_name 值的 UI 元素属性名称
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setBindingNameOverride(nameOverride: string): DataBindingObject;
-    binding_name_override: string | undefined;
-    /**
-     * 设置要使用的集合名称。
-     * @param {string} collectionName - 集合名称
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setBindingCollectionName(collectionName: string): DataBindingObject;
-    binding_collection_name: string | undefined;
-    /**
-     * 设置集合前缀。
-     * @param {string} prefix - 集合前缀
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setBindingCollectionPrefix(prefix: string): DataBindingObject;
-    binding_collection_prefix: string | undefined;
-    /**
-     * 设置数据绑定的条件。
-     * @param {string} condition - 数据绑定的条件（可能值：always, always_when_visible, visible, once, none, visibility_changed）
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setBindingCondition(condition: string): DataBindingObject;
-    binding_condition: string | undefined;
-    /**
-     * 设置要观察其属性值的 UI 元素名称。
-     * @param {string} controlName - UI 元素名称
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setSourceControlName(controlName: string): DataBindingObject;
-    source_control_name: string | undefined;
-    /**
-     * 设置存储 source_control_name 引用的 UI 元素的属性值。
-     * @param {string} propertyName - 属性名称
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setSourcePropertyName(propertyName: string): DataBindingObject;
-    source_property_name: string | undefined;
-    /**
-     * 设置应用 source_property_name 值的 UI 元素属性。
-     * @param {string} propertyName - 属性名称
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setTargetPropertyName(propertyName: string): DataBindingObject;
-    target_property_name: string | undefined;
-    /**
-     * 设置是否允许选择同级元素而非子元素。
-     * @param {boolean} resolve - 是否允许选择同级元素（默认值：false）
-     * @returns {DataBindingObject} 返回当前实例以支持链式调用
-     */
-    setResolveSiblingScope(resolve?: boolean): DataBindingObject;
-    resolve_sibling_scope: boolean | undefined;
+interface ProgressBarLayer {
+    color: [number, number, number];
+    clipRatio: number;
+}
+interface HudProgressBarOptions {
+    id: string;
+    texture: string;
+    uv?: [number, number];
+    uvSize?: [number, number];
+    barSize?: [string | number, string | number];
+    layers: ProgressBarLayer[];
+    states: number;
+    fillColor?: [number, number, number];
+    fillUv?: [number, number];
+    segments?: {
+        count: number;
+        color: [number, number, number];
+    };
+    hudSize?: [string | number, string | number];
+    anchorFrom?: string;
+    anchorTo?: string;
+    offset?: [number, number];
+    clipDirection?: string;
+}
+declare class HudProgressBar {
+    private panel;
+    private options;
+    constructor(options: HudProgressBarOptions);
+    private build;
+    getPanel(): Panel;
+    mountToHud(): void;
+}
+
+type AnyUI = any;
+declare class UISystemRegistry {
+    #private;
+    static registerUISystem(ui_system: AnyUI): void;
+    static addOuterUIdefs(ui_defs: string[]): void;
 }
 
 /**
@@ -4311,84 +4407,86 @@ declare class DataBindingObject {
  * - consume_hover_events: boolean - 是否消耗悬停事件
  * - gesture_tracking_button: string - 手势跟踪按钮
  */
+
 declare class Input {
+    [key: string]: unknown;
+    button_mappings: JsonUIBag[];
+    modal: boolean;
+    inline_modal: boolean;
+    always_listen_to_input: boolean;
+    always_handle_pointer: boolean;
+    always_handle_controller_direction: boolean;
+    hover_enabled: boolean;
+    prevent_touch_input: boolean;
+    consume_event: boolean;
+    consume_hover_events: boolean;
+    gesture_tracking_button: string;
     /**
      * 设置按钮映射配置。
-     * @param {ButtonMapping[]} mappings - 按钮映射配置数组
+     * @param {JsonUIBag[]} mappings - 按钮映射配置数组
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setButtonMappings(mappings: ButtonMapping[]): Input;
-    button_mappings: ButtonMapping[] | undefined;
+    setButtonMappings(mappings: JsonUIBag[]): this;
     /**
      * 设置是否为模态输入。
      * @param {boolean} modal - 是否为模态输入
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setModal(modal?: boolean): Input;
-    modal: boolean | undefined;
+    setModal(modal?: boolean): this;
     /**
      * 设置是否为内联模态输入。
      * @param {boolean} inlineModal - 是否为内联模态输入
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setInlineModal(inlineModal?: boolean): Input;
-    inline_modal: boolean | undefined;
+    setInlineModal(inlineModal?: boolean): this;
     /**
      * 设置是否始终监听输入。
      * @param {boolean} alwaysListen - 是否始终监听输入
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setAlwaysListenToInput(alwaysListen?: boolean): Input;
-    always_listen_to_input: boolean | undefined;
+    setAlwaysListenToInput(alwaysListen?: boolean): this;
     /**
      * 设置是否始终处理指针事件。
      * @param {boolean} alwaysHandle - 是否始终处理指针事件
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setAlwaysHandlePointer(alwaysHandle?: boolean): Input;
-    always_handle_pointer: boolean | undefined;
+    setAlwaysHandlePointer(alwaysHandle?: boolean): this;
     /**
      * 设置是否始终处理控制器方向事件。
      * @param {boolean} alwaysHandle - 是否始终处理控制器方向事件
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setAlwaysHandleControllerDirection(alwaysHandle?: boolean): Input;
-    always_handle_controller_direction: boolean | undefined;
+    setAlwaysHandleControllerDirection(alwaysHandle?: boolean): this;
     /**
      * 设置是否启用悬停事件。
      * @param {boolean} enabled - 是否启用悬停事件
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setHoverEnabled(enabled?: boolean): Input;
-    hover_enabled: boolean | undefined;
+    setHoverEnabled(enabled?: boolean): this;
     /**
      * 设置是否阻止触摸输入。
      * @param {boolean} prevent - 是否阻止触摸输入
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setPreventTouchInput(prevent?: boolean): Input;
-    prevent_touch_input: boolean | undefined;
+    setPreventTouchInput(prevent?: boolean): this;
     /**
      * 设置是否消耗事件。
      * @param {boolean} consume - 是否消耗事件
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setConsumeEvent(consume?: boolean): Input;
-    consume_event: boolean | undefined;
+    setConsumeEvent(consume?: boolean): this;
     /**
      * 设置是否消耗悬停事件。
      * @param {boolean} consume - 是否消耗悬停事件
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setConsumeHoverEvents(consume?: boolean): Input;
-    consume_hover_events: boolean | undefined;
+    setConsumeHoverEvents(consume?: boolean): this;
     /**
      * 设置手势跟踪按钮。
      * @param {string} button - 手势跟踪按钮
      * @returns {Input} 返回当前实例以支持链式调用
      */
-    setGestureTrackingButton(button: string): Input;
-    gesture_tracking_button: string | undefined;
+    setGestureTrackingButton(button: string): this;
 }
 
 /**
@@ -4402,62 +4500,75 @@ declare class Input {
  * - sound_pitch: float - 声音音调（默认值：1.0）
  * - sounds: Array of sound objects - 触发事件时播放的声音数组
  */
+
 declare class Sound {
+    [key: string]: unknown;
+    sound_name: string;
+    sound_volume: number;
+    sound_pitch: number;
+    sounds: JsonUIBag[];
     /**
      * 设置声音名称。
      * @param {string} name - 声音名称（定义在 RP/sounds/sound_definitions.json 文件中）
      * @returns {Sound} 返回当前实例以支持链式调用
      */
-    setSoundName(name: string): Sound;
-    sound_name: string | undefined;
+    setSoundName(name: string): this;
     /**
      * 设置声音音量。
      * @param {number} volume - 音量（范围：0.0 到 1.0，默认值：1.0）
      * @returns {Sound} 返回当前实例以支持链式调用
      */
-    setSoundVolume(volume?: number): Sound;
-    sound_volume: number | undefined;
+    setSoundVolume(volume?: number): this;
     /**
      * 设置声音音调。
      * @param {number} pitch - 音调（默认值：1.0）
      * @returns {Sound} 返回当前实例以支持链式调用
      */
-    setSoundPitch(pitch?: number): Sound;
-    sound_pitch: number | undefined;
+    setSoundPitch(pitch?: number): this;
     /**
      * 设置触发事件时播放的声音数组。
-     * @param {object[]} sounds - 声音对象数组
+     * @param {JsonUIBag[]} sounds - 声音对象数组
      * @returns {Sound} 返回当前实例以支持链式调用
      */
-    setSounds(sounds: object[]): Sound;
-    sounds: object[] | undefined;
+    setSounds(sounds: JsonUIBag[]): this;
     /**
      * 添加一个声音对象到声音数组。
-     * @param {object} sound - 声音对象
+     * @param {JsonUIBag} sound - 声音对象
      * @returns {Sound} 返回当前实例以支持链式调用
      */
-    addSound(sound: object): Sound;
+    addSound(sound: JsonUIBag): this;
 }
 
+/**
+ * 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
+ */
+
 declare class Button extends UIElement {
-    constructor(id: any, template: any);
     input: Input;
     sound: Sound;
     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;
+    constructor(id: string, template?: string);
+    setDefaultControl(default_control: string): this;
+    setHoverControl(hover_control: string): this;
+    setPressedControl(pressed_control: string): this;
+    setLockedControl(locked_control: string): this;
+    setInput(input: Input): this;
+    setSound(sound: Sound): this;
+    setLayout(layout: Layout): this;
+    protected serializableSources(): object[];
 }
 
 declare class CollectionPanel extends UIElement {
-    constructor(id: any, template: any);
     factory: Factory;
-    setCollectionName(collection_name: any): this;
-    setLayout(layout: any): this;
+    constructor(id: string, template?: string);
+    setCollectionName(collection_name: string): this;
+    setLayout(layout: Layout): this;
+    protected serializableSources(): object[];
 }
 
 /**
@@ -4475,62 +4586,66 @@ declare class CollectionPanel extends UIElement {
  * - precached_grid_item_count: int - 预缓存的网格项目数量
  */
 declare class GridProp {
+    [key: string]: unknown;
+    grid_dimensions: [number, number];
+    maximum_grid_items: number;
+    grid_dimension_binding: string;
+    grid_rescaling_type: 'vertical' | 'horizontal' | 'none';
+    grid_fill_direction: 'vertical' | 'horizontal' | 'none';
+    grid_item_template: string;
+    precached_grid_item_count: number;
     /**
      * 设置网格的列数和行数。
-     * @param {number[]} dimensions - 格式为 [columns, rows]
+     * @param {[number, number]} dimensions - 格式为 [columns, rows]
      * @returns {GridProp} 返回当前实例以支持链式调用
      */
-    setGridDimensions(dimensions: number[]): GridProp;
-    grid_dimensions: number[] | undefined;
+    setGridDimensions(dimensions: [number, number]): this;
     /**
      * 设置网格生成的最大项目数。
      * @param {number} maxItems - 最大项目数
      * @returns {GridProp} 返回当前实例以支持链式调用
      */
-    setMaximumGridItems(maxItems: number): GridProp;
-    maximum_grid_items: number | undefined;
+    setMaximumGridItems(maxItems: number): this;
     /**
      * 设置网格尺寸的绑定名称。
      * @param {string} binding - 绑定名称
      * @returns {GridProp} 返回当前实例以支持链式调用
      */
-    setGridDimensionBinding(binding: string): GridProp;
-    grid_dimension_binding: string | undefined;
+    setGridDimensionBinding(binding: string): this;
     /**
      * 设置网格重新缩放方向。
-     * @param {string} type - 可能值：vertical, horizontal, none（默认值：none）
+     * @param {'vertical' | 'horizontal' | 'none'} type - 可能值：vertical, horizontal, none（默认值：none）
      * @returns {GridProp} 返回当前实例以支持链式调用
      */
-    setGridRescalingType(type?: string): GridProp;
-    grid_rescaling_type: string | undefined;
+    setGridRescalingType(type?: 'vertical' | 'horizontal' | 'none'): this;
     /**
      * 设置网格填充方向。
-     * @param {string} direction - 可能值：vertical, horizontal, none（默认值：none）
+     * @param {'vertical' | 'horizontal' | 'none'} direction - 可能值：vertical, horizontal, none（默认值：none）
      * @returns {GridProp} 返回当前实例以支持链式调用
      */
-    setGridFillDirection(direction?: string): GridProp;
-    grid_fill_direction: string | undefined;
+    setGridFillDirection(direction?: 'vertical' | 'horizontal' | 'none'): this;
     /**
      * 设置处理集合的子元素名称。
      * @param {string} template - 元素名称（例如："common.container_item"）
      * @returns {GridProp} 返回当前实例以支持链式调用
      */
-    setGridItemTemplate(template: string): GridProp;
-    grid_item_template: string | undefined;
+    setGridItemTemplate(template: string): this;
     /**
      * 设置预缓存的网格项目数量。
      * @param {number} count - 预缓存数量
      * @returns {GridProp} 返回当前实例以支持链式调用
      */
-    setPrecachedGridItemCount(count: number): GridProp;
-    precached_grid_item_count: number | undefined;
+    setPrecachedGridItemCount(count: number): this;
 }
 
 declare class Grid extends CollectionPanel {
     gridNum: number;
     grid: GridProp;
-    setGridProp(grid_prop: any): this;
-    addGridItem(grid_position: any, content: any): this;
+    constructor(id: string, template?: string);
+    setGridProp(grid_prop: GridProp): this;
+    addGridItem(grid_position: Offset2, content: UIElement | JsonUIBag, name?: string, debugColor?: [number, number, number, number]): this;
+    protected serializableSources(): object[];
+    serialize(): SerializedElement;
 }
 
 /**
@@ -4553,218 +4668,114 @@ declare class Grid extends CollectionPanel {
  * - jump_to_bottom_on_update: boolean - 是否在更新时跳转到底部
  */
 declare class ScrollView {
+    [key: string]: unknown;
+    scrollbar_track_button: string;
+    scrollbar_touch_button: string;
+    scroll_speed: number;
+    gesture_control_enabled: boolean;
+    always_handle_scrolling: boolean;
+    touch_mode: boolean;
+    scrollbar_box: string;
+    scrollbar_track: string;
+    scroll_view_port: string;
+    scroll_content: string;
+    scroll_box_and_track_panel: string;
+    jump_to_bottom_on_update: boolean;
     /**
      * 设置滚动条轨道按钮的 ID。
      * @param {string} buttonId - 滚动条轨道按钮的 ID
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setScrollbarTrackButton(buttonId: string): ScrollView;
-    scrollbar_track_button: string | undefined;
+    setScrollbarTrackButton(buttonId: string): this;
     /**
      * 设置滚动条触摸按钮的 ID。
      * @param {string} buttonId - 滚动条触摸按钮的 ID
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setScrollbarTouchButton(buttonId: string): ScrollView;
-    scrollbar_touch_button: string | undefined;
+    setScrollbarTouchButton(buttonId: string): this;
     /**
      * 设置滚动速度。
      * @param {number} speed - 滚动速度
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setScrollSpeed(speed: number): ScrollView;
-    scroll_speed: number | undefined;
+    setScrollSpeed(speed: number): this;
     /**
      * 设置是否启用手势控制。
      * @param {boolean} enabled - 是否启用手势控制（默认值：false）
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setGestureControlEnabled(enabled?: boolean): ScrollView;
-    gesture_control_enabled: boolean | undefined;
+    setGestureControlEnabled(enabled?: boolean): this;
     /**
      * 设置是否始终处理滚动。
      * @param {boolean} alwaysHandle - 是否始终处理滚动（默认值：false）
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setAlwaysHandleScrolling(alwaysHandle?: boolean): ScrollView;
-    always_handle_scrolling: boolean | undefined;
+    setAlwaysHandleScrolling(alwaysHandle?: boolean): this;
     /**
      * 设置是否启用触摸模式。
      * @param {boolean} touchMode - 是否启用触摸模式（默认值：false）
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setTouchMode(touchMode?: boolean): ScrollView;
-    touch_mode: boolean | undefined;
+    setTouchMode(touchMode?: boolean): this;
     /**
      * 设置滚动条滑块子元素的名称。
      * @param {string} boxName - 滚动条滑块子元素的名称
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setScrollbarBox(boxName: string): ScrollView;
-    scrollbar_box: string | undefined;
+    setScrollbarBox(boxName: string): this;
     /**
      * 设置滚动条轨道子元素的名称。
      * @param {string} trackName - 滚动条轨道子元素的名称
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setScrollbarTrack(trackName: string): ScrollView;
-    scrollbar_track: string | undefined;
+    setScrollbarTrack(trackName: string): this;
     /**
      * 设置视口子元素的名称。
      * @param {string} viewPortName - 视口子元素的名称
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setScrollViewPort(viewPortName: string): ScrollView;
-    scroll_view_port: string | undefined;
+    setScrollViewPort(viewPortName: string): this;
     /**
      * 设置内容根父元素的名称。
      * @param {string} contentName - 内容根父元素的名称
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setScrollContent(contentName: string): ScrollView;
-    scroll_content: string | undefined;
+    setScrollContent(contentName: string): this;
     /**
      * 设置包含滚动条滑块和轨道的子元素名称。
      * @param {string} panelName - 包含滚动条滑块和轨道的子元素名称
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setScrollBoxAndTrackPanel(panelName: string): ScrollView;
-    scroll_box_and_track_panel: string | undefined;
+    setScrollBoxAndTrackPanel(panelName: string): this;
     /**
      * 设置是否在更新时跳转到底部。
      * @param {boolean} jump - 是否在更新时跳转到底部（默认值：false）
      * @returns {ScrollView} 返回当前实例以支持链式调用
      */
-    setJumpToBottomOnUpdate(jump?: boolean): ScrollView;
-    jump_to_bottom_on_update: boolean | undefined;
+    setJumpToBottomOnUpdate(jump?: boolean): this;
 }
 
 declare class ScrollingPanel extends UIElement {
-    constructor(id: any, template: any);
     input: Input;
     scrollView: ScrollView;
     factory: Factory;
+    constructor(id: string, template?: string);
+    protected serializableSources(): object[];
 }
 
 declare class StackPanel extends Panel {
-    constructor(id: any, template: any);
-    type: string;
     orientation: string;
     stackNum: number;
-    addStack(size: any, content: any, debug?: boolean): this;
+    constructor(id: string, template?: string);
+    addStack(size: Size2 | string, content: UIElement | JsonUIBag, debug?: boolean): this;
     /**
      * Possible values:
-        vertical
-        horizontal
-     * @param {*} orientation
+       vertical
+       horizontal
+     * @param {string} orientation
      */
-    setOrientation(orientation: any): this;
-}
-
-declare class ChestUISystem {
-    static chest_screen: UISystem;
-    static registerContainerUI(new_container_title: any, ui_system_root_panel: any): void;
-}
-
-/**
- * 自定义容器 UI 系统类，用于创建和管理容器界面。
- * 支持动态添加网格项、设置标题、调整尺寸等功能。
- */
-declare 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;
-}
-
-declare const ServerFormSystem: UISystem;
-declare class ServerFormButton extends UIElement {
-    /**
-     * 定义一个新的表单按钮
-     * @param {*} name
-     * @param {*} binding_button_name
-     */
-    constructor(name: any, binding_button_name: any);
-    /**
-     *
-     * @param {string} texture
-     * @returns
-     */
-    setDefaultTexture(texture: string): this;
-    setPressedTexture(texture: any): this;
-    setHoverTexture(texture: any): this;
-}
-declare const form_button_panel: Panel;
-declare class ServerUISystem {
-    static "__#private@#binding_map": Map<any, any>;
-    static "__#private@#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 "__#private@#updateServerFormSystem"(): void;
-}
-
-declare 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;
+    setOrientation(orientation: string): this;
+    serialize(): SerializedElement;
 }
 
 type CustomButtonConfig = {
@@ -4851,17 +4862,8 @@ declare class NeoGuidebook {
 }
 
 /**
- * SapdonButton：sapdon 页面壳内的表单按钮。
- * 默认模板固定为 server_form.form_button（集合按钮，吃 form_buttons 数据）。
- */
-declare class SapdonButton extends UIElement {
-    constructor(id: string);
-    /** 设置锚点对齐（如 bottom_left / bottom_right / top_right），默认尺寸 32×32 */
-    setAnchor(anchor: string): this;
-}
-/**
- * SapdonTexturedButton：sapdon 页面壳内的纹理按钮。
- * 默认模板固定为 server_form.sapdon_textured_button（三态纹理 + binding_button_text 门控）。
+ * @deprecated 图标/纹理按钮请改用 FormButton（@common.button + 三态纹理 + 门控绑定）。
+ * 本类仅为兼容 NeoGuidebook 保留；后续随 guidebook 迁移一并移除。
  */
 declare class SapdonTexturedButton extends UIElement {
     constructor(id: string, bindingButtonName?: string);
@@ -4934,39 +4936,132 @@ declare class NeoGuidebookPage {
     clear(): this;
 }
 
+declare namespace HudUISystem {
+    /**
+     * 获取HUD UI系统实例
+     * @returns The HUD UI System instance
+     */
+    function getInstance(): UISystem;
+    function registerElement(element: UIElement): void;
+    function mountRootElement(element: UIElement): void;
+}
+
+declare class HudStatePanel {
+    name: string;
+    private root_panel;
+    private ui_id;
+    constructor(name: string);
+    addStateControl(state: string | number, control: UIElement): this;
+    getPanel(): Panel;
+}
+
+declare class ChestUISystem {
+    static chest_screen: UISystem;
+    static registerContainerUI(new_container_title: string, ui_system_root_panel: string): void;
+}
+
+type Any = any;
+/**
+ * 自定义容器 UI 系统类，用于创建和管理容器界面。
+ * 支持动态添加网格项、设置标题、调整尺寸等功能。
+ */
+declare class ContainerUISystem {
+    #private;
+    system: UISystem;
+    title: string;
+    root_panel_size: [number, number];
+    gridDimension: [number, number];
+    output_grids: number[][];
+    main_panel: Panel;
+    grids: Grid;
+    constructor(identifier: string, path: string);
+    setInputGrid(output_arr: number[][]): 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: Offset2, offset: Offset2, options?: {
+        enable?: boolean;
+        size?: Any;
+        background_images?: Any;
+    }): this;
+    addInputGrid(grid_position: Offset2, offset: Offset2, options?: {
+        enable?: boolean;
+        size?: Any;
+        background_images?: Any;
+    }): void;
+    addOutputGrid(grid_position: Offset2, offset: Offset2, options?: {
+        enable?: boolean;
+        size?: Any;
+        background_images?: Any;
+    }): void;
+    /**
+     * 向主面板中添加一个 UI 元素。
+     * @param {Any} element - 要添加的 UI 元素。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    addElementToMain(element: Any): this;
+    /**
+     * 设置网格的维度（行和列）。
+     * @param {number[]} dimension - 网格的维度 [行数, 列数]。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    setGridDimension(dimension: number[]): this;
+    /**
+     * 设置容器的标题。
+     * @param {string} title - 容器的标题。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    setTitle(title: string): this;
+    /**
+     * 设置根面板的尺寸。
+     * @param {number[]} size - 根面板的尺寸 [宽度, 高度]。
+     * @returns {ContainerUISystem} 返回当前实例以支持链式调用。
+     */
+    setSize(size: number[]): this;
+    setItemMatrix(n: number, matrix: number[][]): void;
+}
+
 /**
  * sapdon_ui: 页面壳路由系统（生成 server_form.json）
  *
- * 结构：
- *   third_party_server_screen@common.base_screen (type:screen)
- *     └─ $screen_content = custom_full_screen
- *          ├─ native_form@main_screen_content        (title 含 'sapdon_ui:' ? 隐藏 : 显示)
- *          └─ sapdon_custom_full@sapdon_screen_content (title 含 'sapdon_ui:' 显示)
- *               └─ (页面各自) @server_form.custom_panel_content (panel_id 精确匹配)
- *                    ├─ content@$user_content_panel   (下)
- *                    └─ buttons@$user_buttons_panel   (上)
+ * 采用 Bedrock Wiki「Modifying Server Forms — Action Form」官方路由：
+ *   main_screen_content ─(modification: insert_back controls)→ sapdon_form_factory
+ *     └─ factory { name: server_form_factory, control_ids.long_form } → @server_form.sapdon_long_form_panel
+ *          └─ (modifications insert_back) 所有注册页 Panel（$panel_id 前缀门控）
+ *             └─ content@$user_content_panel (下) + buttons@$user_buttons_panel (上)
+ *   vanilla long_form ─(modification: bindings)→ title 含 'sapdon_ui:' 时隐藏原生表单
+ *
+ * 关键收益：自定义页处于 main_screen_content 作用域 → #form_text / #title_text 均可解析。
  */
 interface SapdonPageRegistration {
     panelId: string;
     contentPanel: UIElement | string;
     buttonsPanel?: UIElement | string;
-    /** 页面控件�?默认 pageN) */
+    /** 页面控件名（默认 pageN） */
     name?: string;
 }
 declare class SapdonServerUI {
     static readonly MARKER = "sapdon_ui:";
     static readonly NS = "server_form";
     private static _system;
-    private static _screenContent;
+    private static _factories;
     private static _pageCount;
-    /** 框架侧固定提供的按钮项模�?form_button@common_buttons.light_text_button */
-    static createFormButtonTemplate(): UIElement;
-    /** 框架侧固定提供的纹理按钮模板 sapdon_textured_button@common.button（三态纹理 + 门控） */
-    static createTexturedButtonTemplate(): UIElement;
-    /** 通用页面壳 custom_panel_content: panel_id 精确匹配 + 内容(下)/按键(上) */
-    static createPanelContentShell(): UIElement;
     private static _ensureBuilt;
-    /** 注册一个自定义页面到 sapdon_screen_content */
+    /** 页面根壳：在页面自己的 UISystem 里生成 <name> 元素（门控 + content/buttons 子控件 + 变量），供工厂 long_form 引用 */
+    static createPageRoot(reg: {
+        name: string;
+        panelId: string;
+        contentRef: string;
+        buttonsRef: string;
+    }): UIElement;
+    /** 注册一个自定义页面：向 main_screen_content 追加一个纯 gated factory（long_form → @<页ns>.<name>），门控在页面根 */
     static registerPage(reg: SapdonPageRegistration): void;
     static getSystem(): UISystem | null;
 }
@@ -4986,80 +5081,129 @@ declare class SapdonPanel {
 }
 
 /**
- * SapdonButtonPanel：按键网格面板。
- * 内部造一个 Grid（collection_name 注入 form_buttons），
- * 通过 place() 逐个把 form_button 内容按 pos_wrap 摆到指定格。
+ * FormButton：服务端表单按钮（纯样式）。
+ * 只管长什么样（三态纹理 / 尺寸 / 锚点 / 门控键），不含几何与绑定。
+ * 必须 addButton 进 FormButtonGrid 才被注入集合/门控绑定并定位生效。
  */
-declare class SapdonButtonPanel {
-    private grid;
-    constructor(gridId: string);
-    /** 网格尺寸 [列, 行] */
-    setDimensions([cols, rows]: [number, number]): this;
-    setSize(size: [number | string, number | string]): this;
-    /** 注入按钮集合 */
-    setCollection(collectionName: string): this;
-    /** 摆一个按钮(内部会生成带 grid_position 的 pos_wrap 面板包裹) */
-    place(gridPosition: [number, number], content: UIElement): this;
-    build(): Grid;
+declare class FormButton extends Button {
+    constructor(id: string);
+    /** 三态纹理 default/hover/pressed */
+    setTexture(defaultTex: string, hoverTex: string, pressedTex: string): this;
+    /** 尺寸（原地改，保留锚点/offset） */
+    setSize(w: number | string, h: number | string): this;
+    /** 锚点对齐（原地改，导航贴角用） */
+    setAnchor(anchor: string): this;
+    /** 门控键：仅当运行时 emit 的 #form_button_text 等于该键时可见（绑定由 Grid 注入） */
+    setBinding(key: string): this;
 }
 
-declare class UISystemRegistry {
-    static "__#private@#ui_system_map": {};
-    static "__#private@#ui_def_list": any[];
-    static registerUISystem(ui_system: any): void;
-    static addOuterUIdefs(ui_defs: any): void;
+/**
+ * FormButtonGrid：按键格盘（几何 + 激活）。
+ * 内部一个 Grid（collection: form_buttons），把面板按 dimensions 分格；
+ * addButton 时按 index 派生基准格 base 并注入 FormButton 的三组绑定。
+ */
+declare class FormButtonGrid {
+    private grid;
+    private cols;
+    private rows;
+    private index;
+    private debug;
+    private static readonly RED;
+    constructor(id: string, options: {
+        dimensions: [number, number];
+        size: [number | string, number | string];
+    });
+    /** 给每个格子描红调试框 */
+    enableDebug(): this;
+    /** 加一枚内容：index 决定基准格（off_col = index%c, off_row = index/c）；给 pos 则叠加。仅 FormButton 注入集合/门控绑定。 */
+    addButton(index: number, btn: FormButton | UIElement, pos?: [number, number]): this;
+    /** 注入 FormButton 的集合/门控绑定（离开 Grid 则无效） */
+    private injectBindings;
+    build(): UIElement;
 }
 
-interface ProgressBarLayer {
-    color: [number, number, number];
-    clipRatio: number;
-}
-interface HudProgressBarOptions {
-    id: string;
-    texture: string;
-    uv?: [number, number];
-    uvSize?: [number, number];
-    barSize?: [string | number, string | number];
-    layers: ProgressBarLayer[];
-    states: number;
-    fillColor?: [number, number, number];
-    fillUv?: [number, number];
-    segments?: {
-        count: number;
-        color: [number, number, number];
+/**
+ * SapdonGuideBook —— 帕秋莉式手册（分类索引 INDEX + 词条列表 CAT + 内容页 ENT + home/prev/next 导航）。
+ *
+ * 线协议（运行时发射）：
+ *   body = "INDEX"          → 显示分类索引网格（子按钮 = 各分类，setBinding 精确门控）
+ *   body = "CAT:<id>|p<N>"   → 分类页（p0 左简介/右 list，p1+ 左右 list）
+ *   body = "ENT:<id>:<gi>|p<N>" → 词条内容页（按 pageType 渲染、可分页）
+ *   title = "sapdon_ui:<name>"
+ *   button(...)             → 集合 form_buttons：分类按钮 or 导航，均 exact-match 门控
+ */
+type GuideBookPageType = 'text' | 'crafting' | 'spotlight' | 'image';
+interface GuideBookChapter {
+    name: string;
+    icon: string;
+    /** 词条正文（多行，ENT 页逐行渲染；text 类型按 5 行/半页分页） */
+    lines: string[];
+    /** 页类型（默认 text） */
+    pageType?: GuideBookPageType;
+    /** crafting：3×3 合成格（9 项，空位 ''）+ 输出图标 */
+    craft?: {
+        grid: string[];
+        output: string;
+    };
+    /** spotlight：大图标 + 描述 */
+    spotlight?: {
+        icon: string;
+        desc: string;
+    };
+    /** image：整页图 + 说明 */
+    image?: {
+        texture: string;
+        caption: string;
     };
-    hudSize?: [string | number, string | number];
-    anchorFrom?: string;
-    anchorTo?: string;
-    offset?: [number, number];
-    clipDirection?: string;
-}
-declare class HudProgressBar {
-    private panel;
-    private options;
-    constructor(options: HudProgressBarOptions);
-    private build;
-    getPanel(): Panel;
-    mountToHud(): void;
-}
-
-declare namespace HudUISystem {
-    /**
-     * 获取HUD UI系统实例
-     * @returns The HUD UI System instance
-     */
-    function getInstance(): UISystem;
-    function registerElement(element: UIElement): void;
-    function mountRootElement(element: UIElement): void;
 }
-
-declare class HudStatePanel {
-    name: string;
-    private root_panel;
-    private ui_id;
-    constructor(name: string);
-    addStateControl(state: string | number, control: UIElement): this;
-    getPanel(): Panel;
+interface GuideBookCategory {
+    /** 英文 id（路由用，如 intro / routing / controls / undecided） */
+    id: string;
+    /** 中文标题（左页标题 / 索引卡名称） */
+    title: string;
+    /** 分类图标（索引卡） */
+    icon: string;
+    /** 简介正文（左页，多行，逐行渲染） */
+    introLines: string[];
+    /** 右页章节条目 */
+    chapters: GuideBookChapter[];
+}
+declare class SapdonGuideBook {
+    private system;
+    private namespace;
+    private name;
+    private size;
+    private background;
+    private debug;
+    private coverTitle;
+    private coverLines;
+    constructor(identifier: string, size?: [number, number], background?: string);
+    enableDebug(): this;
+    /** 自定义封面：标题（可含 \n）+ 简介行 */
+    setCover(title: string, lines: string[]): this;
+    /** 布局容器：<tag> 命中 #form_text（含 tag 即显示） */
+    private gateLayout;
+    private navButton;
+    private closeButton;
+    /** NeoGuidebook 书页纸面：页脊 + 页边模板（左/右半页） */
+    private bookPagePane;
+    /** 全幅纸页基底：横向 50/50 左右半页（crease+edge），layer 0 常显 */
+    private bookPageBase;
+    /** 给游离 FormButton 注入集合/门控绑定（非 FormButtonGrid 场景，如章节条目行） */
+    private wireButton;
+    /** 章节列表列（章节标题 + 分割线 + ≤8 行条目） */
+    private catListColumn;
+    /** 介绍列（标题 + 分割线 + 简介逐行）——仅 p0 左页 */
+    private catIntroColumn;
+    /**
+     * CAT 页（L2）：按词条数分页容器，门控 CAT:<id>|p<N>。
+     * p0：左=介绍，右=章节 list（≤8）；p1+：左、右都是章节 list（容量 8+8=16，先填左列再右列）。
+     */
+    private catPages;
+    /** ENT 词条内容页（L3）：按 pageType 分派布局；text 按 5 行/半页分页；门控 ENT:<id>:<gi>|p<N> */
+    private entPages;
+    build(categories: GuideBookCategory[]): this;
+    getSystem(): UISystem;
 }
 
 declare class ItemTextureManager {
@@ -5139,5 +5283,5 @@ declare namespace registry {
     function submit(): void;
 }
 
-export { AddonAnimationController, AddonAnimationStateMachine, AddonAttachable, AddonAttachableDefinition, AddonAttachableDescription, AddonBiome, AddonBiomeDefinition, AddonBiomeDescription, AddonBlock, AddonBlockDefinition, AddonBlockDescription, AddonClientEntity, AddonClientEntityDefinition, AddonClientEntityDescription, AddonEntity, AddonEntityDefinition, AddonEntityDescription, AddonFeatureRule, AddonFeatureRuleDecription, AddonFeatureRuleDenifition, AddonItem, AddonItemDefinition, AddonItemDescription, AddonManifest, AddonManifestDependency, AddonManifestHeader, AddonManifestMetadata, AddonManifestModule, AddonMenuCategory, AddonOreFeature, AddonOreFeatureDefinition, AddonOreFeatureDescription, AddonRecipe, AddonRecipeFurnace, AddonRecipeFurnace_1_12, AddonRecipeFurnace_1_17, AddonRecipeShaped, AddonRecipeShaped_1_12, AddonRecipeShaped_1_17, AddonRecipeShaped_1_19, AddonRecipeShaped_1_20, AddonRecipeShapeless, AddonRecipeShapeless_1_12, AddonRecipeShapeless_1_17, AddonRenderController, AddonRenderControllerGroup, AddonSemanticVersion, Armor, ArmorType, Attachable, BasicBlock, BasicBundle, BasicEntity, BasicMovementBundle, Biome, BiomeAPI, BiomeComponent, BiomeFilter, Block, BlockAPI, BlockComponent, BlockCustomComponentBuilder, BookButton, BookCategoryGrid, BookImage, BookRecipeGrid, BookText, BookTitle, BookTitleBar, Button, ButtonMapping$1 as ButtonMapping, ChapterItem, ChestUISystem, ClientEntity, CollectionPanel, ContainerUISystem, Control, CoordinateDistribution, CropBlock, DataBinding, DataBindingObject, Divider, DummyEntity, EmptySpace, Entity, EntityAPI, EntityComponent, Factory, FeatureAPI, FeatureConditions, FeatureDistribution, FeatureRule, FenceBlock, FlipbookItem, FlipbookTextureConfig, FlipbookTextures, FollowMobBehavior, FollowParentBehavior, Food, GeometryBlock, GlassBlock, GoHomeBehavior, Grid, GridProp, Guidebook, HeadBlock, HudProgressBar, HudStatePanel, HudUISystem, Image, Input, Item, ItemAPI, ItemCatalog, ItemCategory, ItemComponent, ItemTextureManager, Label, Layout, Modifications, MoveTowardsHomeRestrictionBehavior, NativeEntity, NativeEntityData, Navigation, NearestAttackableTargetBehavor, NeoGuidebook, NeoGuidebookPage, NonNullMap, OreBlock, OreFeature, Panel, PickupItemsBehavior, Projectile, RandomStrollBehavior, RecipeAPI, RecipeInputTags, RecipeTags, RecipeTypes, RotatableBlock, RotationTypes, SapdonButton, SapdonButtonPanel, SapdonPanel, SapdonServerUI, SapdonTexturedButton, ScrollView, ScrollingPanel, Serializable, Serializer, ServerFormButton, ServerFormSystem, ServerUISystem, Sound, Sprite, StackPanel, StairBlock, TemptBehavior, TerrainTextureManager, Text, TextureVariationConfig, TileBlock, TintMethod, TrapdoorBlock, UIElement, UISystem, UISystemRegistry, UiAPI, decode, defaultSerializer, encode, f64, form_button_panel, getMetadata, getOrCreateMetadata, isRawJSON, jsonEncodeDecoder, jsonEncoderReplacer, mixin, registerBlock, registerEntity, registry, serialize };
-export type { ArmorOptions, ArmorSpec, BeforeOnPlayerPlaceEvent, BlockCustomComponentHandlers, BlockDescriptor, BlockPlacerOptions, ConstructorOf, CooldownOptions, CreateModelItemOptions, DiggerOptions, DurabilitySensorOptions, DurabilityThreshold, EncodeDecoder, EntityPlacerOptions, FlipbookEntry, FlipbookItemOptions, FloatLiteral, FoodComponentOptions, FoodOptions, ISerializer, IconTextures, ItemCatalogCategory, ItemCatalogGroupOptions, ItemComponentMap, ItemOptions, ItemRarity, KineticWeaponOptions, ModelBoneTransform, OnBlockStateChangeEvent, OnBreakEvent, OnEntityEvent, OnEntityFallOnEvent, OnPlaceEvent, OnPlayerBreakEvent, OnPlayerInteractEvent, OnRandomTickEvent, OnRedstoneUpdateEvent, OnStepOffEvent, OnStepOnEvent, OnTickEvent, PiercingWeaponOptions, Range, RawType, RecordOptions, RepairItem, SapdonPageRegistration, ShooterAmmunition, ShooterOptions, StorageItemOptions, SwingSoundsOptions, TextureEntry, TextureVariation, ThrowableOptions, UseModifiersOptions };
+export { AddonAnimationController, AddonAnimationStateMachine, AddonAttachable, AddonAttachableDefinition, AddonAttachableDescription, AddonBiome, AddonBiomeDefinition, AddonBiomeDescription, AddonBlock, AddonBlockDefinition, AddonBlockDescription, AddonClientEntity, AddonClientEntityDefinition, AddonClientEntityDescription, AddonEntity, AddonEntityDefinition, AddonEntityDescription, AddonFeatureRule, AddonFeatureRuleDecription, AddonFeatureRuleDenifition, AddonItem, AddonItemDefinition, AddonItemDescription, AddonManifest, AddonManifestDependency, AddonManifestHeader, AddonManifestMetadata, AddonManifestModule, AddonMenuCategory, AddonOreFeature, AddonOreFeatureDefinition, AddonOreFeatureDescription, AddonRecipe, AddonRecipeFurnace, AddonRecipeFurnace_1_12, AddonRecipeFurnace_1_17, AddonRecipeShaped, AddonRecipeShaped_1_12, AddonRecipeShaped_1_17, AddonRecipeShaped_1_19, AddonRecipeShaped_1_20, AddonRecipeShapeless, AddonRecipeShapeless_1_12, AddonRecipeShapeless_1_17, AddonRenderController, AddonRenderControllerGroup, AddonSemanticVersion, Armor, ArmorType, Attachable, BasicBlock, BasicBundle, BasicEntity, BasicMovementBundle, Biome, BiomeAPI, BiomeComponent, BiomeFilter, Block, BlockAPI, BlockComponent, BlockCustomComponentBuilder, BookButton, BookCategoryGrid, BookImage, BookRecipeGrid, BookText, BookTitle, BookTitleBar, Button, ButtonMapping, ChapterItem, ChestUISystem, ClientEntity, CollectionPanel, ContainerUISystem, Control, CoordinateDistribution, CropBlock, DataBinding, DataBindingObject, Divider, DummyEntity, EmptySpace, Entity, EntityAPI, EntityComponent, Factory, FeatureAPI, FeatureConditions, FeatureDistribution, FeatureRule, FenceBlock, FlipbookItem, FlipbookTextureConfig, FlipbookTextures, FollowMobBehavior, FollowParentBehavior, Food, FormButton, FormButtonGrid, GeometryBlock, GlassBlock, GoHomeBehavior, Grid, GridProp, HeadBlock, HudProgressBar, HudStatePanel, HudUISystem, Image, Input, Item, ItemAPI, ItemCatalog, ItemCategory, ItemComponent, ItemTextureManager, Label, Layout, Modifications, MoveTowardsHomeRestrictionBehavior, NativeEntity, NativeEntityData, Navigation, NearestAttackableTargetBehavor, NeoGuidebook, NeoGuidebookPage, NonNullMap, OreBlock, OreFeature, Panel, PickupItemsBehavior, Projectile, RandomStrollBehavior, RecipeAPI, RecipeInputTags, RecipeTags, RecipeTypes, RotatableBlock, RotationTypes, SapdonGuideBook, SapdonPanel, SapdonServerUI, SapdonTexturedButton, ScrollView, ScrollingPanel, Serializable, Serializer, Sound, Sprite, StackPanel, StairBlock, TemptBehavior, TerrainTextureManager, Text, TextureVariationConfig, TileBlock, TintMethod, TrapdoorBlock, UIElement, UISystem, UISystemRegistry, UiAPI, decode, defaultSerializer, encode, f64, getMetadata, getOrCreateMetadata, isRawJSON, jsonEncodeDecoder, jsonEncoderReplacer, mixin, registerBlock, registerEntity, registry, serialize };
+export type { ArmorOptions, ArmorSpec, BeforeOnPlayerPlaceEvent, BlockCustomComponentHandlers, BlockDescriptor, BlockPlacerOptions, ConstructorOf, CooldownOptions, CreateModelItemOptions, DiggerOptions, DurabilitySensorOptions, DurabilityThreshold, EncodeDecoder, EntityPlacerOptions, FlipbookEntry, FlipbookItemOptions, FloatLiteral, FoodComponentOptions, FoodOptions, GuideBookCategory, GuideBookChapter, GuideBookPageType, ISerializer, IconTextures, ItemCatalogCategory, ItemCatalogGroupOptions, ItemComponentMap, ItemOptions, ItemRarity, KineticWeaponOptions, ModelBoneTransform, OnBlockStateChangeEvent, OnBreakEvent, OnEntityEvent, OnEntityFallOnEvent, OnPlaceEvent, OnPlayerBreakEvent, OnPlayerInteractEvent, OnRandomTickEvent, OnRedstoneUpdateEvent, OnStepOffEvent, OnStepOnEvent, OnTickEvent, PiercingWeaponOptions, Range, RawType, RecordOptions, RepairItem, SapdonPageRegistration, SerializedElement, ShooterAmmunition, ShooterOptions, StorageItemOptions, SwingSoundsOptions, TextureEntry, TextureVariation, ThrowableOptions, UseModifiersOptions };