@galacean/effects-specification 2.8.1 → 2.9.0

package/es/components/dom-content-component-data.d.ts

@@ -0,0 +1,26 @@
+import type { MaskableGraphicData } from './maskable-graphic-data';
+/**
+ * DOM 内容组件数据
+ * 将 HTML/CSS 渲染为纹理，运行时由开发者通过 setContent 手动驱动
+ */
+export interface DomContentComponentData extends MaskableGraphicData {
+    /**
+     * HTML 内容字符串
+     */
+    htmlContent: string;
+    /**
+     * 内容宽度（CSS 像素）
+     * @default 300
+     */
+    contentWidth: number;
+    /**
+     * 内容高度（CSS 像素）
+     * @default 200
+     */
+    contentHeight: number;
+    /**
+     * 内容缩放系数，纹理尺寸 = content* × contentScale
+     * @default 1
+     */
+    contentScale: number;
+}

package/es/components/dom-content-component-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/index.d.ts

@@ -4,3 +4,5 @@ export * from './ffd-data';
 export * from './frame-component-data';
 export * from './maskable-graphic-data';
 export * from './orientation-component-data';
+export * from './dom-content-component-data';
+export * from './ui-control';

package/es/components/index.js

@@ -4,3 +4,5 @@ export * from './ffd-data';
 export * from './frame-component-data';
 export * from './maskable-graphic-data';
 export * from './orientation-component-data';
+export * from './dom-content-component-data';
+export * from './ui-control';

package/es/components/ui-control/aspect-ratio-container-data.d.ts

@@ -0,0 +1,8 @@
+import type { ControlData } from './control-data';
+import type { AspectRatioStretchMode, LayoutAlignment } from './serialized-enums';
+export interface AspectRatioContainerData extends ControlData {
+    ratio?: number;
+    stretchMode?: AspectRatioStretchMode;
+    horizontalAlignment?: LayoutAlignment;
+    verticalAlignment?: LayoutAlignment;
+}

package/es/components/ui-control/aspect-ratio-container-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/base-button-data.d.ts

@@ -0,0 +1,10 @@
+import type { ControlData } from './control-data';
+import type { ButtonActionMode } from './serialized-enums';
+export interface BaseButtonData extends ControlData {
+    disabled?: boolean;
+    toggleMode?: boolean;
+    buttonPressed?: boolean;
+    buttonMask?: number;
+    actionMode?: ButtonActionMode;
+    keepPressedOutside?: boolean;
+}

package/es/components/ui-control/base-button-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/box-container-data.d.ts

@@ -0,0 +1,6 @@
+import type { ControlData } from './control-data';
+import type { LayoutAlignment } from './serialized-enums';
+export interface BoxContainerData extends ControlData {
+    alignment?: LayoutAlignment;
+    reverse?: boolean;
+}

package/es/components/ui-control/box-container-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/button-data.d.ts

@@ -0,0 +1,13 @@
+import type { DataPath } from '../component-data';
+import type { BaseButtonData } from './base-button-data';
+import type { HorizontalAlignment, VerticalAlignment } from './serialized-enums';
+export interface ButtonData extends BaseButtonData {
+    text?: string;
+    icon?: DataPath | null;
+    flat?: boolean;
+    clipText?: boolean;
+    expandIcon?: boolean;
+    textAlignment?: HorizontalAlignment;
+    iconAlignment?: HorizontalAlignment;
+    iconVerticalAlignment?: VerticalAlignment;
+}

package/es/components/ui-control/button-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/center-container-data.d.ts

@@ -0,0 +1,4 @@
+import type { ControlData } from './control-data';
+export interface CenterContainerData extends ControlData {
+    useTopLeft?: boolean;
+}

package/es/components/ui-control/center-container-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/check-button-data.d.ts

@@ -0,0 +1,3 @@
+import type { ButtonData } from './button-data';
+export interface CheckButtonData extends ButtonData {
+}

package/es/components/ui-control/check-button-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/checkbox-data.d.ts

@@ -0,0 +1,3 @@
+import type { ButtonData } from './button-data';
+export interface CheckboxData extends ButtonData {
+}

package/es/components/ui-control/checkbox-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/color-picker-button-data.d.ts

@@ -0,0 +1,6 @@
+import type { ColorData } from '../../math/color-data';
+import type { ButtonData } from './button-data';
+export interface ColorPickerButtonData extends ButtonData {
+    color?: ColorData;
+    editAlpha?: boolean;
+}

package/es/components/ui-control/color-picker-button-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/color-picker-data.d.ts

@@ -0,0 +1,6 @@
+import type { ColorData } from '../../math/color-data';
+import type { ControlData } from './control-data';
+export interface ColorPickerData extends ControlData {
+    color?: ColorData;
+    editAlpha?: boolean;
+}

package/es/components/ui-control/color-picker-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/color-rect-data.d.ts

@@ -0,0 +1,5 @@
+import type { ColorData } from '../../math/color-data';
+import type { ControlData } from './control-data';
+export interface ColorRectData extends ControlData {
+    color?: ColorData;
+}

package/es/components/ui-control/color-rect-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/control-data.d.ts

@@ -0,0 +1,29 @@
+import type { vec2 } from '../../number-expression';
+import type { ThemeOverridesData } from './theme-data';
+/** Common serialized properties shared by every GUI control. */
+export interface ControlData {
+    anchorMin?: vec2;
+    anchorMax?: vec2;
+    offsetMin?: vec2;
+    offsetMax?: vec2;
+    pivot?: vec2;
+    scale?: vec2;
+    shear?: vec2;
+    rotation?: number;
+    customMinimumSize?: vec2;
+    customMaximumSize?: vec2;
+    horizontalSizeFlags?: number;
+    verticalSizeFlags?: number;
+    stretchRatio?: number;
+    horizontalGrowDirection?: number;
+    verticalGrowDirection?: number;
+    mouseFilter?: number;
+    mouseBehaviorRecursive?: number;
+    mouseForcePassScrollEvents?: boolean;
+    focusMode?: number;
+    focusBehaviorRecursive?: number;
+    defaultCursorShape?: number | string;
+    clipContents?: boolean;
+    themeTypeVariation?: string;
+    themeOverrides?: ThemeOverridesData;
+}

package/es/components/ui-control/control-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/grid-container-data.d.ts

@@ -0,0 +1,4 @@
+import type { ControlData } from './control-data';
+export interface GridContainerData extends ControlData {
+    columns?: number;
+}

package/es/components/ui-control/grid-container-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/index.d.ts

@@ -0,0 +1,32 @@
+export * from './aspect-ratio-container-data';
+export * from './base-button-data';
+export * from './box-container-data';
+export * from './button-data';
+export * from './center-container-data';
+export * from './check-button-data';
+export * from './checkbox-data';
+export * from './color-picker-button-data';
+export * from './color-picker-data';
+export * from './color-rect-data';
+export * from './control-data';
+export * from './grid-container-data';
+export * from './label-data';
+export * from './line-edit-data';
+export * from './margin-container-data';
+export * from './menu-button-data';
+export * from './nine-patch-rect-data';
+export * from './option-button-data';
+export * from './panel-data';
+export * from './popup-menu-data';
+export * from './progress-bar-data';
+export * from './range-data';
+export * from './rect-data';
+export * from './scroll-bar-data';
+export * from './scroll-container-data';
+export * from './slider-data';
+export * from './text-edit-data';
+export * from './text-input-data';
+export * from './texture-rect-data';
+export * from './theme-data';
+export * from './ui-control-data';
+export * from './ui-control-type';

package/es/components/ui-control/index.js

@@ -0,0 +1,32 @@
+export * from './aspect-ratio-container-data';
+export * from './base-button-data';
+export * from './box-container-data';
+export * from './button-data';
+export * from './center-container-data';
+export * from './check-button-data';
+export * from './checkbox-data';
+export * from './color-picker-button-data';
+export * from './color-picker-data';
+export * from './color-rect-data';
+export * from './control-data';
+export * from './grid-container-data';
+export * from './label-data';
+export * from './line-edit-data';
+export * from './margin-container-data';
+export * from './menu-button-data';
+export * from './nine-patch-rect-data';
+export * from './option-button-data';
+export * from './panel-data';
+export * from './popup-menu-data';
+export * from './progress-bar-data';
+export * from './range-data';
+export * from './rect-data';
+export * from './scroll-bar-data';
+export * from './scroll-container-data';
+export * from './slider-data';
+export * from './text-edit-data';
+export * from './text-input-data';
+export * from './texture-rect-data';
+export * from './theme-data';
+export * from './ui-control-data';
+export * from './ui-control-type';

package/es/components/ui-control/label-data.d.ts

@@ -0,0 +1,9 @@
+import type { ControlData } from './control-data';
+import type { AutowrapMode, HorizontalAlignment, TextOverflow, VerticalAlignment } from './serialized-enums';
+export interface LabelData extends ControlData {
+    text?: string;
+    horizontalAlignment?: HorizontalAlignment;
+    verticalAlignment?: VerticalAlignment;
+    autowrapMode?: AutowrapMode;
+    textOverflow?: TextOverflow;
+}

package/es/components/ui-control/label-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/line-edit-data.d.ts

@@ -0,0 +1,7 @@
+import type { HorizontalAlignment } from './serialized-enums';
+import type { TextInputData } from './text-input-data';
+export interface LineEditData extends TextInputData {
+    secret?: boolean;
+    secretCharacter?: string;
+    alignment?: HorizontalAlignment;
+}

package/es/components/ui-control/line-edit-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/margin-container-data.d.ts

@@ -0,0 +1,3 @@
+import type { ControlData } from './control-data';
+export interface MarginContainerData extends ControlData {
+}

package/es/components/ui-control/margin-container-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/menu-button-data.d.ts

@@ -0,0 +1,5 @@
+import type { ButtonData } from './button-data';
+import type { PopupMenuItemData } from './popup-menu-data';
+export interface MenuButtonData extends ButtonData {
+    items?: PopupMenuItemData[];
+}

package/es/components/ui-control/menu-button-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/nine-patch-rect-data.d.ts

@@ -0,0 +1,17 @@
+import type { ColorData } from '../../math/color-data';
+import type { DataPath } from '../component-data';
+import type { ControlData } from './control-data';
+import type { RectData } from './rect-data';
+import type { AxisStretchMode } from './serialized-enums';
+export interface NinePatchRectData extends ControlData {
+    texture?: DataPath | null;
+    regionRect?: RectData;
+    patchMarginLeft?: number;
+    patchMarginTop?: number;
+    patchMarginRight?: number;
+    patchMarginBottom?: number;
+    drawCenter?: boolean;
+    horizontalAxisStretchMode?: AxisStretchMode;
+    verticalAxisStretchMode?: AxisStretchMode;
+    tint?: ColorData;
+}

package/es/components/ui-control/nine-patch-rect-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/option-button-data.d.ts

@@ -0,0 +1,4 @@
+import type { MenuButtonData } from './menu-button-data';
+export interface OptionButtonData extends MenuButtonData {
+    selected?: number;
+}

package/es/components/ui-control/option-button-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/panel-data.d.ts

@@ -0,0 +1,3 @@
+import type { ControlData } from './control-data';
+export interface PanelData extends ControlData {
+}

package/es/components/ui-control/panel-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/popup-menu-data.d.ts

@@ -0,0 +1,11 @@
+import type { ControlData } from './control-data';
+export interface PopupMenuItemData {
+    id: number | string;
+    text: string;
+    disabled?: boolean;
+    separator?: boolean;
+    checked?: boolean;
+}
+export interface PopupMenuData extends ControlData {
+    items?: PopupMenuItemData[];
+}

package/es/components/ui-control/popup-menu-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/progress-bar-data.d.ts

@@ -0,0 +1,6 @@
+import type { RangeData } from './range-data';
+import type { ProgressFillMode } from './serialized-enums';
+export interface ProgressBarData extends RangeData {
+    showPercentage?: boolean;
+    fillMode?: ProgressFillMode;
+}

package/es/components/ui-control/progress-bar-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/range-data.d.ts

@@ -0,0 +1,12 @@
+import type { ControlData } from './control-data';
+export interface RangeData extends ControlData {
+    minValue?: number;
+    maxValue?: number;
+    step?: number;
+    page?: number;
+    value?: number;
+    exponentialRatio?: boolean;
+    rounded?: boolean;
+    allowGreater?: boolean;
+    allowLesser?: boolean;
+}

package/es/components/ui-control/range-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/rect-data.d.ts

@@ -0,0 +1,5 @@
+import type { vec2 } from '../../number-expression';
+export interface RectData {
+    position: vec2;
+    size: vec2;
+}

package/es/components/ui-control/rect-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/scroll-bar-data.d.ts

@@ -0,0 +1,4 @@
+import type { RangeData } from './range-data';
+export interface ScrollBarData extends RangeData {
+    customStep?: number;
+}

package/es/components/ui-control/scroll-bar-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/scroll-container-data.d.ts

@@ -0,0 +1,13 @@
+import type { ControlData } from './control-data';
+import type { ScrollMode } from './serialized-enums';
+export interface ScrollContainerData extends ControlData {
+    hScroll?: number;
+    vScroll?: number;
+    horizontalScrollMode?: ScrollMode;
+    verticalScrollMode?: ScrollMode;
+    horizontalCustomStep?: number;
+    verticalCustomStep?: number;
+    scrollHorizontalByDefault?: boolean;
+    deadzone?: number;
+    followFocus?: boolean;
+}

package/es/components/ui-control/scroll-container-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/serialized-enums.d.ts

@@ -0,0 +1,12 @@
+export type LayoutAlignment = 0 | 1 | 2;
+export type AspectRatioStretchMode = 0 | 1 | 2 | 3;
+export type ScrollMode = 0 | 1 | 2 | 3 | 4 | 5;
+export type HorizontalAlignment = 0 | 1 | 2 | 3;
+export type VerticalAlignment = 0 | 1 | 2 | 3;
+export type AutowrapMode = 0 | 1 | 2 | 3;
+export type TextOverflow = 0 | 1 | 2;
+export type TextureExpandMode = 0 | 1 | 2 | 3 | 4 | 5;
+export type TextureStretchMode = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+export type AxisStretchMode = 0 | 1 | 2;
+export type ButtonActionMode = 0 | 1;
+export type ProgressFillMode = 0 | 1 | 2 | 3;

package/es/components/ui-control/serialized-enums.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/slider-data.d.ts

@@ -0,0 +1,5 @@
+import type { RangeData } from './range-data';
+export interface SliderData extends RangeData {
+    editable?: boolean;
+    scrollable?: boolean;
+}

package/es/components/ui-control/slider-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/text-edit-data.d.ts

@@ -0,0 +1,3 @@
+import type { TextInputData } from './text-input-data';
+export interface TextEditData extends TextInputData {
+}

package/es/components/ui-control/text-edit-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/text-input-data.d.ts

@@ -0,0 +1,7 @@
+import type { ControlData } from './control-data';
+export interface TextInputData extends ControlData {
+    text?: string;
+    placeholderText?: string;
+    editable?: boolean;
+    maxLength?: number;
+}

package/es/components/ui-control/text-input-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/texture-rect-data.d.ts

@@ -0,0 +1,12 @@
+import type { ColorData } from '../../math/color-data';
+import type { DataPath } from '../component-data';
+import type { ControlData } from './control-data';
+import type { TextureExpandMode, TextureStretchMode } from './serialized-enums';
+export interface TextureRectData extends ControlData {
+    texture?: DataPath | null;
+    expandMode?: TextureExpandMode;
+    stretchMode?: TextureStretchMode;
+    flipH?: boolean;
+    flipV?: boolean;
+    tint?: ColorData;
+}

package/es/components/ui-control/texture-rect-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/theme-data.d.ts

@@ -0,0 +1,54 @@
+import type { ColorData } from '../../math/color-data';
+import type { FontStyle } from '../../text';
+import type { DataPath } from '../component-data';
+import type { RectData } from './rect-data';
+export type FontWeight = 'normal' | 'bold' | number;
+export interface ThemeFontData {
+    family: string;
+    weight?: FontWeight;
+    style?: FontStyle;
+}
+export interface StyleBoxMarginsData {
+    left?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+}
+export interface StyleBoxEmptyData {
+    type: 'empty';
+    contentMargins?: StyleBoxMarginsData;
+}
+export interface StyleBoxFlatData {
+    type: 'flat';
+    backgroundColor?: ColorData;
+    borderColor?: ColorData;
+    borderWidths?: StyleBoxMarginsData;
+    cornerRadii?: StyleBoxMarginsData;
+    contentMargins?: StyleBoxMarginsData;
+}
+export interface StyleBoxTextureData {
+    type: 'texture';
+    texture: DataPath | null;
+    sourceRect?: RectData;
+    patchMargins?: StyleBoxMarginsData;
+    contentMargins?: StyleBoxMarginsData;
+    horizontalAxisStretchMode?: number;
+    verticalAxisStretchMode?: number;
+    drawCenter?: boolean;
+    tint?: ColorData;
+}
+export type StyleBoxData = StyleBoxEmptyData | StyleBoxFlatData | StyleBoxTextureData;
+export interface ThemeItemCollectionData {
+    colors?: Record<string, ColorData>;
+    constants?: Record<string, number>;
+    fonts?: Record<string, ThemeFontData>;
+    fontSizes?: Record<string, number>;
+    icons?: Record<string, DataPath | null>;
+    styleBoxes?: Record<string, StyleBoxData>;
+}
+export interface ThemeData {
+    types: Record<string, ThemeItemCollectionData>;
+    variations?: Record<string, string>;
+}
+export interface ThemeOverridesData extends ThemeItemCollectionData {
+}

package/es/components/ui-control/theme-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/ui-control-data.d.ts

@@ -0,0 +1,9 @@
+import type { DataType } from '../../data-type';
+import type { ComponentData } from '../component-data';
+import type { ControlData } from './control-data';
+import type { UIControlType } from './ui-control-type';
+export interface UIControlData extends ComponentData {
+    dataType: DataType.UIControl;
+    control: UIControlType;
+    data: ControlData;
+}

package/es/components/ui-control/ui-control-data.js

@@ -0,0 +1 @@
+export {};

package/es/components/ui-control/ui-control-type.d.ts

@@ -0,0 +1,2 @@
+import type { DataType } from '../../data-type';
+export type UIControlType = DataType.Control | DataType.Container | DataType.HBoxContainer | DataType.VBoxContainer | DataType.GridContainer | DataType.PanelContainer | DataType.MarginContainer | DataType.CenterContainer | DataType.AspectRatioContainer | DataType.ScrollContainer | DataType.HScrollBar | DataType.VScrollBar | DataType.HSeparator | DataType.VSeparator | DataType.Label | DataType.LineEdit | DataType.TextEdit | DataType.PopupPanel | DataType.PopupMenu | DataType.MenuButton | DataType.OptionButton | DataType.ColorPicker | DataType.ColorPickerButton | DataType.TextureRect | DataType.NinePatchRect | DataType.ColorRect | DataType.Panel | DataType.ProgressBar | DataType.Button | DataType.Checkbox | DataType.CheckButton | DataType.HSlider | DataType.VSlider;

package/es/components/ui-control/ui-control-type.js

@@ -0,0 +1 @@
+export {};

package/es/composition.d.ts

@@ -91,7 +91,7 @@ export interface Composition extends CompositionBase {
  */
 export interface CompositionData extends CompositionBase {
     /**
-     * @description 组件数据
+     * 组件数据
      */
     components: DataPath[];
     /**
@@ -104,7 +104,7 @@ export interface CompositionData extends CompositionBase {
  */
 export interface CompositionComponentData extends ComponentData {
     /**
-     * @description 合成组件类型 - 固定为 CompositionComponent
+     * 合成组件类型 - 固定为 CompositionComponent
      */
     dataType: DataType.CompositionComponent;
     /**

package/es/data-type.d.ts

@@ -7,6 +7,7 @@ export declare enum DataType {
     Image = "Image",
     AnimationClip = "AnimationClip",
     BinaryAsset = "BinaryAsset",
+    Sprite = "Sprite",
     TrackAsset = "TrackAsset",
     TimelineAsset = "TimelineAsset",
     ObjectBindingTrack = "ObjectBindingTrack",
@@ -19,6 +20,7 @@ export declare enum DataType {
     Vector2PropertyTrack = "Vector2PropertyTrack",
     Vector3PropertyTrack = "Vector3PropertyTrack",
     Vector4PropertyTrack = "Vector4PropertyTrack",
+    SpritePropertyTrack = "SpritePropertyTrack",
     TransformPlayableAsset = "TransformPlayableAsset",
     SpriteColorPlayableAsset = "SpriteColorPlayableAsset",
     ActivationPlayableAsset = "ActivationPlayableAsset",
@@ -28,6 +30,7 @@ export declare enum DataType {
     Vector2PropertyPlayableAsset = "Vector2PropertyPlayableAsset",
     Vector3PropertyPlayableAsset = "Vector3PropertyPlayableAsset",
     Vector4PropertyPlayableAsset = "Vector4PropertyPlayableAsset",
+    SpritePropertyPlayableAsset = "SpritePropertyPlayableAsset",
     MeshComponent = "MeshComponent",
     SkyboxComponent = "SkyboxComponent",
     LightComponent = "LightComponent",
@@ -53,5 +56,40 @@ export declare enum DataType {
     FFDComponent = "FFDComponent",
     FrameComponent = "FrameComponent",
     Animator = "Animator",
+    DomContentComponent = "DomContentComponent",
+    UIControl = "UIControl",
+    Control = "Control",
+    Container = "Container",
+    HBoxContainer = "HBoxContainer",
+    VBoxContainer = "VBoxContainer",
+    GridContainer = "GridContainer",
+    PanelContainer = "PanelContainer",
+    MarginContainer = "MarginContainer",
+    CenterContainer = "CenterContainer",
+    AspectRatioContainer = "AspectRatioContainer",
+    ScrollContainer = "ScrollContainer",
+    HScrollBar = "HScrollBar",
+    VScrollBar = "VScrollBar",
+    HSeparator = "HSeparator",
+    VSeparator = "VSeparator",
+    Label = "Label",
+    LineEdit = "LineEdit",
+    TextEdit = "TextEdit",
+    PopupPanel = "PopupPanel",
+    PopupMenu = "PopupMenu",
+    MenuButton = "MenuButton",
+    OptionButton = "OptionButton",
+    ColorPicker = "ColorPicker",
+    ColorPickerButton = "ColorPickerButton",
+    TextureRect = "TextureRect",
+    NinePatchRect = "NinePatchRect",
+    ColorRect = "ColorRect",
+    Panel = "Panel",
+    ProgressBar = "ProgressBar",
+    Button = "Button",
+    Checkbox = "Checkbox",
+    CheckButton = "CheckButton",
+    HSlider = "HSlider",
+    VSlider = "VSlider",
     TimelineClip = "TimelineClip"
 }

package/es/data-type.js

@@ -9,6 +9,7 @@ export var DataType;
     DataType["Image"] = "Image";
     DataType["AnimationClip"] = "AnimationClip";
     DataType["BinaryAsset"] = "BinaryAsset";
+    DataType["Sprite"] = "Sprite";
     // Timeline
     DataType["TrackAsset"] = "TrackAsset";
     DataType["TimelineAsset"] = "TimelineAsset";
@@ -22,6 +23,7 @@ export var DataType;
     DataType["Vector2PropertyTrack"] = "Vector2PropertyTrack";
     DataType["Vector3PropertyTrack"] = "Vector3PropertyTrack";
     DataType["Vector4PropertyTrack"] = "Vector4PropertyTrack";
+    DataType["SpritePropertyTrack"] = "SpritePropertyTrack";
     DataType["TransformPlayableAsset"] = "TransformPlayableAsset";
     DataType["SpriteColorPlayableAsset"] = "SpriteColorPlayableAsset";
     DataType["ActivationPlayableAsset"] = "ActivationPlayableAsset";
@@ -31,6 +33,7 @@ export var DataType;
     DataType["Vector2PropertyPlayableAsset"] = "Vector2PropertyPlayableAsset";
     DataType["Vector3PropertyPlayableAsset"] = "Vector3PropertyPlayableAsset";
     DataType["Vector4PropertyPlayableAsset"] = "Vector4PropertyPlayableAsset";
+    DataType["SpritePropertyPlayableAsset"] = "SpritePropertyPlayableAsset";
     // Components
     DataType["MeshComponent"] = "MeshComponent";
     DataType["SkyboxComponent"] = "SkyboxComponent";
@@ -57,6 +60,42 @@ export var DataType;
     DataType["FFDComponent"] = "FFDComponent";
     DataType["FrameComponent"] = "FrameComponent";
     DataType["Animator"] = "Animator";
+    DataType["DomContentComponent"] = "DomContentComponent";
+    DataType["UIControl"] = "UIControl";
+    // GUI Controls
+    DataType["Control"] = "Control";
+    DataType["Container"] = "Container";
+    DataType["HBoxContainer"] = "HBoxContainer";
+    DataType["VBoxContainer"] = "VBoxContainer";
+    DataType["GridContainer"] = "GridContainer";
+    DataType["PanelContainer"] = "PanelContainer";
+    DataType["MarginContainer"] = "MarginContainer";
+    DataType["CenterContainer"] = "CenterContainer";
+    DataType["AspectRatioContainer"] = "AspectRatioContainer";
+    DataType["ScrollContainer"] = "ScrollContainer";
+    DataType["HScrollBar"] = "HScrollBar";
+    DataType["VScrollBar"] = "VScrollBar";
+    DataType["HSeparator"] = "HSeparator";
+    DataType["VSeparator"] = "VSeparator";
+    DataType["Label"] = "Label";
+    DataType["LineEdit"] = "LineEdit";
+    DataType["TextEdit"] = "TextEdit";
+    DataType["PopupPanel"] = "PopupPanel";
+    DataType["PopupMenu"] = "PopupMenu";
+    DataType["MenuButton"] = "MenuButton";
+    DataType["OptionButton"] = "OptionButton";
+    DataType["ColorPicker"] = "ColorPicker";
+    DataType["ColorPickerButton"] = "ColorPickerButton";
+    DataType["TextureRect"] = "TextureRect";
+    DataType["NinePatchRect"] = "NinePatchRect";
+    DataType["ColorRect"] = "ColorRect";
+    DataType["Panel"] = "Panel";
+    DataType["ProgressBar"] = "ProgressBar";
+    DataType["Button"] = "Button";
+    DataType["Checkbox"] = "Checkbox";
+    DataType["CheckButton"] = "CheckButton";
+    DataType["HSlider"] = "HSlider";
+    DataType["VSlider"] = "VSlider";
     // Non-EffectObject
     DataType["TimelineClip"] = "TimelineClip";
 })(DataType || (DataType = {}));

package/es/index.d.ts

@@ -29,6 +29,7 @@ export * from './binary';
 export * from './text';
 export * from './components';
 export * from './buitin-object-guid';
+export * from './sprite';
 export * from './shape';
 export * from './animation-graph';
 export * from './timeline';
@@ -41,4 +42,4 @@ export * from './material-data';
 export * from './geometry-data';
 export * from './shader-data';
 export * from './effects-package-data';
-export declare const LATEST_VERSION = JSONSceneVersion['3_7'];
+export declare const LATEST_VERSION = JSONSceneVersion['3_8'];

package/es/index.js

@@ -29,6 +29,7 @@ export * from './binary';
 export * from './text';
 export * from './components';
 export * from './buitin-object-guid';
+export * from './sprite';
 export * from './shape';
 export * from './animation-graph';
 export * from './timeline';

package/es/item/base-item.d.ts

@@ -36,26 +36,38 @@ export declare enum EndBehavior {
      */
     freeze = 4
 }
+/**
+ * 单个蒙版引用数据，用于多蒙版场景
+ */
+export interface MaskReferenceData {
+    /**
+     * 指向作为蒙版的组件
+     */
+    mask: DataPath;
+    /**
+     * 是否反向蒙版（true: 反向遮挡，false: 正向遮挡）
+     * @default false
+     */
+    inverted?: boolean;
+}
 /**
  * 元素的蒙版选项
+ * 使用 references 数组指定蒙版引用，每个引用可独立设置 inverted 属性。
  */
 export interface MaskOptions {
     /**
      * 是否作为蒙版
      */
     isMask?: boolean;
-    /**
-     * 是否反转
-     */
-    inverted?: boolean;
     /**
      * 是否开启图片透明蒙版
      */
     alphaMaskEnabled?: boolean;
     /**
-     * 指向作为蒙版的组件
+     * 蒙版引用列表
+     * 每个引用指定一个蒙版组件及其是否反向。
      */
-    reference: DataPath;
+    references?: MaskReferenceData[];
 }
 export interface BaseItem {
     /**

package/es/item/sprite-item.d.ts

@@ -31,6 +31,7 @@ export interface SpriteContent {
     /**
      * added by loader
      * @default null
+     * @deprecated 2.9.0 Please use Sprite
      */
     splits?: SplitParameter[];
     /**
@@ -83,4 +84,8 @@ export interface SpriteComponentData extends ComponentData, SpriteContent {
      * 自定义几何体数据
      */
     geometry?: DataPath;
+    /**
+     * 引用的 Sprite 资产（新版数据流）；未设置时走旧 renderer.texture + splits 路径
+     */
+    sprite?: DataPath;
 }

package/es/number-expression.d.ts

@@ -91,7 +91,11 @@ export declare enum ValueType {
     /**
      * Vector3 曲线
      */
-    VECTOR3_CURVE = 27
+    VECTOR3_CURVE = 27,
+    /**
+     * 对象引用阶梯曲线（不插值）
+     */
+    REFERENCE_CURVE = 28
 }
 export type vec2 = [x: number, y: number];
 export type vec3 = [x: number, y: number, z: number];

package/es/number-expression.js

@@ -93,6 +93,10 @@ export var ValueType;
      * Vector3 曲线
      */
     ValueType[ValueType["VECTOR3_CURVE"] = 27] = "VECTOR3_CURVE";
+    /**
+     * 对象引用阶梯曲线（不插值）
+     */
+    ValueType[ValueType["REFERENCE_CURVE"] = 28] = "REFERENCE_CURVE";
 })(ValueType || (ValueType = {}));
 /**
  * 关键帧类型

package/es/scene.d.ts

@@ -36,7 +36,8 @@ export declare enum JSONSceneVersion {
     '3_5' = "3.5",// 网格形状变化动画、矢量图形填充/描边渐变色
     '3_6' = "3.6",// 支持 KTX2 纹理、H265 视频格式、文本增强
     '3_7' = "3.7",// 文本 autoSize、元素子节点
-    'LATEST' = "3.7"
+    '3_8' = "3.8",// 支持 UI Control、Multi-mask
+    'LATEST' = "3.8"
 }
 /**
  * runtime 2.0 之前的场景信息

package/es/scene.js

@@ -22,5 +22,6 @@ export var JSONSceneVersion;
     JSONSceneVersion["3_5"] = "3.5";
     JSONSceneVersion["3_6"] = "3.6";
     JSONSceneVersion["3_7"] = "3.7";
-    JSONSceneVersion["LATEST"] = "3.7";
+    JSONSceneVersion["3_8"] = "3.8";
+    JSONSceneVersion["LATEST"] = "3.8";
 })(JSONSceneVersion || (JSONSceneVersion = {}));

package/es/sprite.d.ts

@@ -0,0 +1,39 @@
+import type { DataPath } from './components';
+import type { EffectsObjectData } from './effects-object-data';
+import type { vec4 } from './number-expression';
+/**
+ * Sprite UV 旋转方式。序列化为整数（兼容老 splits 的 flip 0/1）。
+ * None 不旋转、Rotate90 将 UV 顺时针旋转 90°（width/height 互换）。
+ */
+export declare enum SpriteRotation {
+    /** 不旋转 */
+    None = 0,
+    /** UV 旋转 90°（对应老 splits flip=1） */
+    Rotate90 = 1
+}
+/**
+ * Sprite 资产：一张纹理 + 一个归一化 UV 矩形区域。
+ * 被 SpriteComponent 引用，替代直接引用 Texture + 散落的 splits。
+ */
+export interface SpriteData extends EffectsObjectData {
+    /** 关联纹理（DataPath 引用） */
+    texture?: DataPath;
+    /** 归一化 UV 矩形 [x, y, w, h]，默认整张纹理 */
+    rect?: vec4;
+    /** UV 旋转方式（0=None, 1=Rotate90） */
+    rotation?: SpriteRotation;
+}
+/**
+ * 对象引用曲线值（createValueGetter 入参 / 序列化形态）：[curveType, keyframes[]]。
+ * curveType 为 ValueType.REFERENCE_CURVE。
+ * 序列化时 value 为 DataPath（{id}），运行时由 fromData 解析为 EffectsObject 实例。
+ */
+export type ReferenceCurveValue = [number, [time: number, value: DataPath][]];
+/**
+ * Sprite 属性 K 帧 PlayableAsset 数据。
+ * curveData 为对象引用阶梯曲线，阶梯采样（不插值）。
+ */
+export interface SpritePropertyAssetData extends EffectsObjectData {
+    /** [REFERENCE_CURVE, [time, DataPath][]] */
+    curveData: ReferenceCurveValue;
+}

package/es/sprite.js

@@ -0,0 +1,11 @@
+/**
+ * Sprite UV 旋转方式。序列化为整数（兼容老 splits 的 flip 0/1）。
+ * None 不旋转、Rotate90 将 UV 顺时针旋转 90°（width/height 互换）。
+ */
+export var SpriteRotation;
+(function (SpriteRotation) {
+    /** 不旋转 */
+    SpriteRotation[SpriteRotation["None"] = 0] = "None";
+    /** UV 旋转 90°（对应老 splits flip=1） */
+    SpriteRotation[SpriteRotation["Rotate90"] = 1] = "Rotate90";
+})(SpriteRotation || (SpriteRotation = {}));

package/es/type.d.ts

@@ -444,6 +444,7 @@ export interface RendererOptions {
     transparentOcclusion?: boolean;
     /**
      * 贴图，索引到 scene 中的 images 数组
+     * @deprecated 2.9.0 迁移至 sprite.texture
      */
     texture?: DataPath;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-specification",
-  "version": "2.8.1",
+  "version": "2.9.0",
   "description": "Galacean Effects JSON Specification",
   "module": "./es/index.js",
   "main": "./es/index.js",
@@ -15,17 +15,6 @@
       "types": "./es/index.d.ts"
     }
   },
-  "scripts": {
-    "prebuild": "pnpm clean",
-    "build": "pnpm build:lib",
-    "build:lib": "tsc -b tsconfig.build.json",
-    "lint": "eslint src --ext .ts,.mjs",
-    "lint:fix": "eslint src --fix --quiet --ext .ts,.mjs",
-    "check:ts": "tsc -b tsconfig.check.json",
-    "clean": "rimraf es/**",
-    "prepare": "husky install",
-    "prepublishOnly": "npm run build"
-  },
   "browserslist": [
     "iOS 9"
   ],
@@ -48,5 +37,14 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "prebuild": "pnpm clean",
+    "build": "pnpm build:lib",
+    "build:lib": "tsc -b tsconfig.build.json",
+    "lint": "eslint src --ext .ts,.mjs",
+    "lint:fix": "eslint src --fix --quiet --ext .ts,.mjs",
+    "check:ts": "tsc -b tsconfig.check.json",
+    "clean": "rimraf es/**"
   }
-}
+}