@eva/plugin-ui 2.1.0-beta.3 → 2.1.0-beta.4

package/dist/plugin-ui.d.ts

@@ -0,0 +1,875 @@
+import { Component } from '@eva/eva.js';
+import { ComponentChanged } from '@eva/eva.js';
+import type { Container } from 'pixi.js';
+import { System } from '@eva/eva.js';
+
+export declare const Button: UiComponentClass<ButtonParams>;
+
+export declare interface ButtonParams {
+    enabled?: boolean;
+    view?: ViewRef;
+}
+
+export declare const CheckBox: UiComponentClass<CheckBoxParams>;
+
+export declare interface CheckBoxParams {
+    enabled?: boolean;
+    checked?: boolean;
+    text?: string;
+    bindToStore?: string;
+    views?: {
+        checked?: ViewRef;
+        unchecked?: ViewRef;
+    };
+    textStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fill?: string | number;
+    };
+    textOffset?: {
+        x?: number;
+        y?: number;
+    };
+    disabledStyle?: CheckBoxStateStyle;
+}
+
+export declare interface CheckBoxStateStyle {
+    alpha?: number;
+    scale?: number;
+}
+
+/** 圆形样式 */
+export declare interface CircleStyle extends ShapeStyle {
+    x?: number;
+    y?: number;
+    radius: number;
+}
+
+export declare const CircularProgressBar: UiComponentClass<CircularProgressBarParams>;
+
+export declare interface CircularProgressBarParams {
+    value?: number;
+    valueRange?: [number, number];
+    radius?: number;
+    lineWidth?: number;
+    startAngle?: number;
+    backgroundColor?: number | string;
+    fillColor?: number | string;
+    backgroundAlpha?: number;
+    fillAlpha?: number;
+    cap?: 'round' | 'butt' | 'square';
+    bindToStore?: string;
+    rotation?: number;
+    offset?: {
+        x?: number;
+        y?: number;
+    };
+}
+
+export declare const COMPONENT_DEFINITIONS: Record<string, ComponentDefinition>;
+
+export declare interface ComponentDefinition<TParams = any, TInstance = any> {
+    /** Eva ECS component name(必须与 PIXI class import 名 / DSL type 字符串一致) */
+    name: string;
+    /** signal-bridge prefix(通常 = name.toLowerCase()) */
+    signalPrefix: string;
+    /** @pixi/ui 类构造器(或自定义构造函数) */
+    pixiClass: new (...args: any[]) => TInstance;
+    /** 字段表 - field name -> spec */
+    fields: Record<string, FieldSpec>;
+    /** view ref schema */
+    views?: ViewSchema;
+    /** 由字段值 + 解析后 views 生成 PIXI 实例构造参数(options 对象 | 位置参数数组) */
+    optionsBuilder: (component: TParams & Record<string, any>, views: ResolvedViews) => unknown[] | unknown;
+    /** 是否用位置参数构造(@pixi/ui Switcher),默认 false 走 options 对象 */
+    positional?: boolean;
+    /** 创建后立即同步的 prop(enabled / initial state)*/
+    postCreate?: (instance: TInstance, component: TParams & Record<string, any>) => void;
+    /** Signal -> 写回 component 字段的桥接 map(供 bridgeSignals) */
+    signalMap?: (component: TParams & Record<string, any>) => Record<string, true | ((...args: any[]) => Record<string, any>)>;
+    /** CHANGE 事件触发,把字段写回 PIXI 实例 */
+    syncOnChange?: (instance: TInstance, component: TParams & Record<string, any>) => void;
+    /** Transform.size -> @pixi/ui 实例尺寸同步。未提供时由 UISystem 使用通用 setSize/width/height 策略。 */
+    applySize?: (instance: TInstance, size: UiRenderSize, component: TParams & Record<string, any>, context: UiSizeSyncContext) => void;
+    /** ADD 完成后跑(Dialog 挂 content / MaskedFrame 挂 border)*/
+    onAttachedExtra?: (instance: TInstance, component: TParams & Record<string, any>, go: any, game: any) => void;
+    /** 实例方法 mixin(注入到 wrapper class.prototype) */
+    mixin?: Record<string, Function>;
+}
+
+export declare function defineUiComponent<TParams = any, TInstance = any>(def: ComponentDefinition<TParams, TInstance>): UiComponentClass<TParams>;
+
+export declare const Dialog: UiComponentClass<DialogParams>;
+
+declare interface DialogButtonParams {
+    kind?: 'button' | 'fancy';
+    text?: string;
+    value?: string | number;
+    closeOnPress?: boolean;
+    reopenDelay?: number;
+    width?: number;
+    height?: number;
+    radius?: number;
+    color?: number | string;
+    hoverColor?: number | string;
+    pressedColor?: number | string;
+    disabledColor?: number | string;
+    defaultView?: string;
+    hoverView?: string;
+    pressedView?: string;
+    disabledView?: string;
+    nineSliceSprite?: [number, number, number, number];
+    textStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fill?: string | number;
+        fontWeight?: string;
+    };
+    disabled?: boolean;
+    animations?: unknown;
+}
+
+declare interface DialogCheckBoxParams {
+    text?: string;
+    size?: number;
+    radius?: number;
+    checked?: boolean;
+    uncheckedColor?: number | string;
+    checkedColor?: number | string;
+    strokeColor?: number | string;
+    strokeWidth?: number;
+    textStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fill?: string | number;
+        fontWeight?: string;
+    };
+}
+
+export declare interface DialogParams {
+    open?: boolean;
+    title?: string;
+    width?: number;
+    height?: number;
+    padding?: number;
+    backdropColor?: number | string;
+    backdropAlpha?: number;
+    backdropView?: ViewRef;
+    backgroundView?: ViewRef;
+    closeOnBackdropClick?: boolean;
+    contentChildName?: string;
+    nineSliceSprite?: [number, number, number, number];
+    bindToStore?: string;
+    titleStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fill?: string | number;
+        fontWeight?: string;
+        lineHeight?: number;
+        dropShadow?: unknown;
+    };
+    content?: string;
+    contentStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fill?: string | number;
+        fontWeight?: string;
+        align?: 'left' | 'center' | 'right';
+        wordWrap?: boolean;
+        wordWrapWidth?: number;
+        lineHeight?: number;
+        dropShadow?: unknown;
+    };
+    contentButtons?: DialogButtonParams[];
+    contentCheckBoxes?: DialogCheckBoxParams[];
+    buttons?: DialogButtonParams[];
+    buttonList?: {
+        elementsMargin?: number;
+        type?: ListType;
+        padding?: number;
+    };
+    buttonListOffset?: {
+        x?: number;
+        y?: number;
+    };
+    scrollBox?: Partial<ScrollBoxParams> & {
+        type?: ListType;
+        offset?: {
+            x?: number;
+            y?: number;
+        };
+        size?: {
+            width?: number;
+            height?: number;
+        };
+    };
+    animations?: unknown;
+}
+
+export declare const DoubleSlider: UiComponentClass<DoubleSliderParams>;
+
+export declare interface DoubleSliderParams {
+    enabled?: boolean;
+    value1?: number;
+    value2?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    showValue?: boolean;
+    views?: {
+        bg?: ViewRef;
+        fill?: ViewRef;
+        slider1?: ViewRef;
+        slider2?: ViewRef;
+    };
+    nineSliceSprite?: {
+        bg?: [number, number, number, number];
+        fill?: [number, number, number, number];
+    };
+    fillPaddings?: ProgressBarFillPaddings;
+    valueTextStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fill?: string | number;
+    };
+    valueTextOffset?: {
+        x?: number;
+        y?: number;
+    };
+    width?: number;
+    height?: number;
+    bindToStore1?: string;
+    bindToStore2?: string;
+}
+
+/** 椭圆样式 */
+export declare interface EllipseStyle extends ShapeStyle {
+    x?: number;
+    y?: number;
+    width: number;
+    height: number;
+}
+
+export declare const FancyButton: UiComponentClass<FancyButtonParams>;
+
+export declare type FancyButtonOffset = {
+    x?: number;
+    y?: number;
+    default?: {
+        x?: number;
+        y?: number;
+    };
+    hover?: {
+        x?: number;
+        y?: number;
+    };
+    pressed?: {
+        x?: number;
+        y?: number;
+    };
+    disabled?: {
+        x?: number;
+        y?: number;
+    };
+};
+
+export declare interface FancyButtonParams {
+    enabled?: boolean;
+    state?: FancyButtonState;
+    selected?: boolean;
+    text?: string;
+    views?: FancyButtonViewRefs;
+    offset?: FancyButtonOffset;
+    textOffset?: FancyButtonOffset;
+    iconOffset?: FancyButtonOffset;
+    padding?: number;
+    nineSliceSprite?: [number, number, number, number];
+    selectedTint?: string;
+    textStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fill?: string | number;
+        fontWeight?: string;
+        dropShadow?: unknown;
+    };
+    textClass?: 'text' | 'html' | 'bitmap';
+    bitmapFontName?: string;
+    defaultTextScale?: {
+        x?: number;
+        y?: number;
+    } | number;
+    defaultIconScale?: {
+        x?: number;
+        y?: number;
+    } | number;
+    defaultTextAnchor?: {
+        x?: number;
+        y?: number;
+    } | number;
+    defaultIconAnchor?: {
+        x?: number;
+        y?: number;
+    } | number;
+    anchor?: number;
+    anchorX?: number;
+    anchorY?: number;
+    scale?: number;
+    animations?: unknown;
+    contentFittingMode?: 'default' | 'fill' | 'none';
+    ignoreRefitting?: boolean;
+    width?: number;
+    height?: number;
+}
+
+export declare type FancyButtonState = 'default' | 'hover' | 'pressed' | 'disabled' | 'selected';
+
+export declare interface FancyButtonViewRefs {
+    default?: ViewRef;
+    hover?: ViewRef;
+    pressed?: ViewRef;
+    disabled?: ViewRef;
+    icon?: ViewRef;
+}
+
+export declare type FieldKind = 'scalar' | 'shallowMerge' | 'arrayCopy' | 'tuple' | 'opaque';
+
+export declare interface FieldSpec {
+    kind: FieldKind;
+    /** tuple 长度 / 默认值 */
+    tupleLength?: number;
+    /** Inspector metadata 字段定义,用于生成 getInspectorMetadata */
+    inspector?: InspectorChild;
+    /** 默认值(field initial state) */
+    default?: unknown;
+}
+
+export declare interface InlineShape {
+    type: 'rect' | 'roundedRect' | 'circle' | 'ellipse';
+    style: {
+        x?: number;
+        y?: number;
+        width?: number;
+        height?: number;
+        radius?: number;
+        fill?: number | string;
+        stroke?: number | string;
+        lineWidth?: number;
+        alpha?: number;
+    };
+}
+
+export declare const Input: UiComponentClass<InputParams>;
+
+export declare interface InputParams {
+    enabled?: boolean;
+    value?: string;
+    placeholder?: string;
+    maxLength?: number;
+    secure?: boolean;
+    align?: 'left' | 'center' | 'right';
+    padding?: [number, number, number, number];
+    textStyle?: InputStyle;
+    bgView?: ViewRef;
+    nineSliceSprite?: [number, number, number, number];
+    cleanOnFocus?: boolean;
+    addMask?: boolean;
+    bindToStore?: string;
+    width?: number;
+    height?: number;
+}
+
+export declare interface InputStyle {
+    fontFamily?: string;
+    fontSize?: number;
+    fill?: string | number;
+    align?: 'left' | 'center' | 'right';
+}
+
+declare interface InspectorChild {
+    name: string;
+    type: string;
+    isArray?: boolean;
+    isFolder?: boolean;
+    step?: number;
+    children?: InspectorChild[];
+}
+
+declare interface InspectorFieldMetadata {
+    name: string;
+    type: string;
+    isArray: boolean;
+    children?: InspectorFieldMetadata[];
+    isFolder?: boolean;
+    step?: number;
+    label?: unknown;
+}
+
+declare interface InspectorFieldMetadata_2 {
+    name: string;
+    type: string;
+    isArray: boolean;
+    children?: InspectorFieldMetadata_2[];
+    isFolder?: boolean;
+    step?: number;
+}
+
+export declare const List: UiComponentClass<ListParams>;
+
+export declare interface ListParams {
+    type?: ListType;
+    elementsMargin?: number;
+    padding?: number;
+    vertPadding?: number;
+    horPadding?: number;
+    topPadding?: number;
+    bottomPadding?: number;
+    leftPadding?: number;
+    rightPadding?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    itemsChildName?: string;
+}
+
+export declare type ListType = 'horizontal' | 'vertical' | 'bidirectional';
+
+export declare const MaskedFrame: UiComponentClass<MaskedFrameParams>;
+
+export declare interface MaskedFrameParams {
+    targetView?: ViewRef;
+    maskView?: ViewRef;
+    borderView?: ViewRef;
+    borderWidth?: number;
+    borderColor?: number | string;
+}
+
+/**
+ * 由 defineUiComponent 创建的 wrapper class 基础形状。
+ * 所有由 factory 生成的 class 共享下面这套 init / applyDeclarativeProps / getInspectorMetadata
+ * / 内部状态计数器逻辑。
+ */
+export declare class PixiUiComponent<TParams = any> extends Component<TParams> {
+    /** runtime 计数,供 spec / debug 验证(toggleCount / pressCount / hoverCount / ...)*/
+    toggleCount: number;
+    pressCount: number;
+    downCount: number;
+    upCount: number;
+    hoverCount: number;
+    outCount: number;
+    upOutCount: number;
+    changeCount: number;
+    updateCount: number;
+    selectCount: number;
+    lastSignal: string;
+    visualState: string;
+    /** Input 私有 focused */
+    focused: boolean;
+    /** DSL/constructor 中显式传入过的字段,用于区分 metadata default 与用户配置。 */
+    __evaExplicitFields: Set<string>;
+    /** 由 factory 通过 metadata 注入的动态字段(views / value / checked / ...)*/
+    [key: string]: any;
+    init(p?: TParams): void;
+    applyDeclarativeProps(next: TParams, _prev?: TParams): void;
+    /** 通用字段 apply 循环:按 fieldSpec 走对应分支 */
+    protected applyParams(p: Record<string, any>): void;
+}
+
+export declare const ProgressBar: UiComponentClass<ProgressBarParams>;
+
+export declare interface ProgressBarFillPaddings {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+
+export declare interface ProgressBarParams {
+    value?: number;
+    valueRange?: [number, number];
+    bgView?: ViewRef;
+    fillView?: ViewRef;
+    nineSliceSprite?: {
+        bg?: [number, number, number, number];
+        fill?: [number, number, number, number];
+    };
+    fillPaddings?: ProgressBarFillPaddings;
+    bindToStore?: string;
+    width?: number;
+    height?: number;
+}
+
+export declare class RadioGroup extends Component<RadioGroupParams> {
+    static componentName: string;
+    componentName?: string;
+    selectedId: string | undefined;
+    childNames: string[] | undefined;
+    direction: 'horizontal' | 'vertical' | 'bidirectional';
+    elementsMargin: number;
+    /** runtime: 已绑定的子 CheckBox(System 填充) */
+    boundCheckBoxes: {
+        name: string;
+        cb: any;
+    }[];
+    static getInspectorMetadata(): InspectorFieldMetadata_2;
+    init(p?: RadioGroupParams): void;
+    applyDeclarativeProps(next: RadioGroupParams, _prev?: RadioGroupParams): void;
+    applySelection(): void;
+    private applyParams;
+}
+
+export declare interface RadioGroupParams {
+    selectedId?: string;
+    childNames?: string[];
+    direction?: 'horizontal' | 'vertical' | 'bidirectional';
+    elementsMargin?: number;
+}
+
+/** 矩形样式 */
+export declare interface RectStyle extends ShapeStyle {
+    x?: number;
+    y?: number;
+    width: number;
+    height: number;
+}
+
+export declare interface ResolvedViews {
+    /** single key -> Container | null */
+    single?: Container | null;
+    /** object folder -> { [key]: Container | null } */
+    object?: Record<string, Container | null>;
+    /** array key -> Container[] */
+    array?: Container[];
+}
+
+/** 圆角矩形样式 */
+export declare interface RoundedRectStyle extends ShapeStyle {
+    x?: number;
+    y?: number;
+    width: number;
+    height: number;
+    radius?: number;
+}
+
+export declare const ScrollBox: UiComponentClass<ScrollBoxParams>;
+
+export declare interface ScrollBoxParams {
+    width?: number;
+    height?: number;
+    direction?: ScrollDirection;
+    contentChildName?: string;
+    background?: number | string;
+    radius?: number;
+    elementsMargin?: number;
+    disableDynamicRendering?: boolean;
+    disableEasing?: boolean;
+    padding?: number;
+    vertPadding?: number;
+    horPadding?: number;
+    topPadding?: number;
+    bottomPadding?: number;
+    leftPadding?: number;
+    rightPadding?: number;
+    globalScroll?: boolean;
+    shiftScroll?: boolean;
+    proximityRange?: number;
+    proximityDebounce?: number;
+    inertia?: boolean;
+    inertiaDecay?: number;
+    bounceFactor?: number;
+}
+
+export declare type ScrollDirection = 'horizontal' | 'vertical' | 'both';
+
+export declare const Select: UiComponentClass<SelectParams>;
+
+export declare interface SelectItem {
+    text: string;
+    id?: string;
+}
+
+export declare interface SelectParams {
+    items?: SelectItem[];
+    selectedIndex?: number;
+    placeholder?: string;
+    closedView?: ViewRef;
+    openView?: ViewRef;
+    textStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fill?: string | number;
+    };
+    nineSliceSprite?: [number, number, number, number];
+    bindToStore?: string;
+    width?: number;
+    height?: number;
+    radius?: number;
+    visibleItems?: number;
+    itemWidth?: number;
+    itemHeight?: number;
+    itemBackgroundColor?: number | string;
+    itemHoverColor?: number | string;
+    selectedTextOffset?: {
+        x?: number;
+        y?: number;
+    };
+    scrollBox?: Partial<ScrollBoxParams> & {
+        offset?: {
+            x?: number;
+            y?: number;
+        };
+    };
+    textClass?: 'text' | 'html';
+    open?: boolean;
+}
+
+/**
+ * Shape 组件
+ *
+ * 基于 `@eva/plugin-renderer-graphics` 实现 rect/circle/ellipse/roundedRect 的
+ * 矢量绘制,支持纯色 / linear-gradient 填充与描边。`shapes` 数组允许在同一个
+ * GameObject 上层叠多个形状。
+ */
+declare class Shape extends Component<ShapeParams> {
+    /** 组件名称 */
+    static componentName: string;
+    /** 实例侧 componentName,DSL 序列化时使用 */
+    componentName?: string;
+    private shapes;
+    /** 编辑器 Inspector 元数据,主仓 ComponentInspector 通过静态方法读取 */
+    static getInspectorMetadata(): InspectorFieldMetadata;
+    init(params?: ShapeParams): void;
+    awake(): void;
+    start(): void;
+    /**
+     * 解析 linear-gradient 字符串
+     * 支持格式: linear-gradient(180deg, #340033 4%, #93005D 83%, #CB2269 99%)
+     */
+    private parseLinearGradient;
+    /**
+     * 创建 PixiJS FillGradient 对象
+     * CSS linear-gradient 角度定义：
+     * - 0deg = 从下到上(↑)
+     * - 90deg = 从左到右(→)
+     * - 180deg = 从上到下(↓)
+     * - 270deg = 从右到左(←)
+     *
+     * FillGradient 的坐标范围是 0~1 的相对坐标
+     */
+    private createGradient;
+    /** 计算形状包围盒,供渐变坐标使用 */
+    private getShapeBounds;
+    /** 重新绘制所有形状 */
+    redraw(): void;
+    /** 绘制单个形状 */
+    private drawShape;
+    private drawRect;
+    private drawCircle;
+    private drawEllipse;
+    private drawRoundedRect;
+    /** 追加一个形状 */
+    addShape(type: ShapeType, style: RectStyle | CircleStyle | EllipseStyle | RoundedRectStyle): void;
+    /** 清除所有形状 */
+    clearShapes(): void;
+    /** 更新指定索引的形状 */
+    updateShape(index: number, type: ShapeType, style: RectStyle | CircleStyle | EllipseStyle | RoundedRectStyle): void;
+    /** 移除指定索引的形状 */
+    removeShape(index: number): void;
+    /** 获取形状数量 */
+    getShapeCount(): number;
+    /** 获取指定索引的形状(只读视图) */
+    getShape(index: number): ShapeDefinition | null;
+    /** 设置所有形状的透明度 */
+    setAlpha(alpha: number): void;
+    /** 设置所有形状的填充色 */
+    setFill(fill: string): void;
+    /** 设置所有形状的描边 */
+    setStroke(stroke: string, lineWidth?: number): void;
+}
+export { Shape }
+export { Shape as UI }
+
+/** 单个 shape 描述 */
+export declare interface ShapeDefinition {
+    type: ShapeType;
+    style: RectStyle | CircleStyle | EllipseStyle | RoundedRectStyle;
+}
+
+/** Shape component params */
+export declare interface ShapeParams {
+    componentName?: string;
+    shapes?: ShapeDefinition[];
+    /** 单形状简化用法:type + style */
+    type?: ShapeType;
+    style?: RectStyle | CircleStyle | EllipseStyle | RoundedRectStyle;
+}
+
+/** Shape base style */
+export declare interface ShapeStyle {
+    /** 填充颜色,支持 #RRGGBB / rgb()/rgba() / linear-gradient(...) */
+    fill?: string;
+    /** 描边颜色 */
+    stroke?: string;
+    /** 描边宽度 */
+    lineWidth?: number;
+    /** 透明度 0~1 */
+    alpha?: number;
+}
+
+/** Shape primitive type enum */
+export declare enum ShapeType {
+    RECT = "rect",
+    CIRCLE = "circle",
+    ELLIPSE = "ellipse",
+    ROUNDED_RECT = "roundedRect"
+}
+
+export declare const Slider: UiComponentClass<SliderParams>;
+
+export declare type SliderOrientation = 'horizontal' | 'vertical';
+
+export declare interface SliderParams {
+    enabled?: boolean;
+    value?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    orientation?: SliderOrientation;
+    showValue?: boolean;
+    views?: {
+        bg?: ViewRef;
+        fill?: ViewRef;
+        thumb?: ViewRef;
+    };
+    nineSliceSprite?: {
+        bg?: [number, number, number, number];
+        fill?: [number, number, number, number];
+    };
+    fillPaddings?: ProgressBarFillPaddings;
+    valueTextStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fill?: string | number;
+    };
+    valueTextOffset?: {
+        x?: number;
+        y?: number;
+    };
+    width?: number;
+    height?: number;
+    bindToStore?: string;
+}
+
+export declare const Switcher: UiComponentClass<SwitcherParams>;
+
+export declare interface SwitcherParams {
+    active?: number;
+    views?: ViewRef[];
+    triggerEvent?: SwitcherTriggerEvent | SwitcherTriggerEvent[];
+    bindToStore?: string;
+}
+
+export declare type SwitcherTriggerEvent = 'onPress' | 'onDown' | 'onUp' | 'onHover' | 'onOut' | 'onUpOut';
+
+declare type UiComponentClass<TParams = any> = new () => PixiUiComponent<TParams>;
+
+export declare type UIComponentParams = ShapeParams;
+
+/** Backward-compatible aliases kept for existing TS imports. */
+export declare type UIParams = ShapeParams;
+
+declare interface UiRenderSize {
+    width?: number;
+    height?: number;
+}
+
+export declare type UIShape = ShapeDefinition;
+
+/** Backward-compatible enum value alias for existing TypeScript consumers. */
+export declare const UIShapeType: typeof ShapeType;
+
+export declare type UIShapeType = ShapeType;
+
+declare interface UiSizeSyncContext {
+    componentName: string;
+    component?: Record<string, any>;
+    gameObject?: any;
+    source: 'initial-transform' | 'transform-change' | 'component-change';
+}
+
+export declare type UIStyle = ShapeStyle;
+
+declare class UISystem extends System {
+    static systemName: string;
+    name: string;
+    /** componentName -> instance map(generic 共享一份) */
+    private instances;
+    private signalCleanups;
+    private transformSizeAuthorities;
+    /** 给 RadioGroup 反查 PixiCheckBox 实例用 */
+    private get checkBoxInstances();
+    private radioGroupInstances;
+    update(_e?: any): void;
+    componentChanged(changed: ComponentChanged): void;
+    private handleShape;
+    private handleGeneric;
+    private attachGeneric;
+    private detachGeneric;
+    private handleRadioGroup;
+    private attachRadioGroup;
+    private getInstanceMap;
+    private gameRef;
+    private handleTransformSizeChanged;
+    private relayoutLayoutInstances;
+    private applyTransientTransformSize;
+}
+export { UISystem as PluginUiSystem }
+export { UISystem }
+
+/**
+ * DSL 中 plugin-ui 组件用 ViewRef 引用视觉资源,而不是 Eva v2.0 的 *ChildName 模式。
+ *
+ * - { entityName: "background" }  — 引用同 GameObject 的子 entity 的 PIXI.Container,
+ *   这个 child entity 必须先 ADD,然后我们把它的 Container "借走" 交给 @pixi/ui 实例。
+ *   原 child entity 仍然存在(Transform/逻辑组件还在),只是 PIXI 显示对象被重新 parent。
+ * - { shape: { type, style } } — 内联 shape,生成一个新的 PIXI.Graphics(临时,与 Shape 组件不同源)
+ * - { texture: "loading.png" } — 从已加载的 Eva 资源池查 texture,生成 PIXI.Sprite
+ * - { color: 0xRRGGBB, width, height }  — 生成纯色矩形 Graphics
+ * - { fallback: <ViewRef> } — 当主 ref 解析失败时使用
+ */
+export declare type ViewRef = {
+    entityName: string;
+    fallback?: ViewRef;
+} | {
+    shape: InlineShape;
+    fallback?: ViewRef;
+} | {
+    ui: InlineShape;
+    fallback?: ViewRef;
+} | {
+    texture: string;
+    fallback?: ViewRef;
+} | {
+    color: number | string;
+    width: number;
+    height: number;
+    radius?: number;
+    fallback?: ViewRef;
+};
+
+export declare type ViewSchema = {
+    kind: 'single';
+    key: string;
+    required: boolean;
+} | {
+    kind: 'object';
+    folder: string;
+    keys: {
+        name: string;
+        required: boolean;
+    }[];
+} | {
+    kind: 'array';
+    key: string;
+    minLength: number;
+};
+
+export { }