@momoyu-ink/kit 0.9.1 → 0.10.1

package/AGENTS.md

@@ -259,6 +259,8 @@ Sandbox 为剧本表达式提供受控求值环境：
 | 组件          | 用途     | 关键 Props                                   |
 | ------------- | -------- | -------------------------------------------- |
 | `<container>` | 容器     | 基础变换属性                                 |
+| `<vbox>`      | 纵向布局 | `width`, `height`, `gap`, `padding`, `justifyContent`, `alignItems` |
+| `<hbox>`      | 横向布局 | `width`, `height`, `gap`, `padding`, `justifyContent`, `alignItems` |
 | `<sprite>`    | 图片精灵 | `src`, `area`, `mode`, `bounds`              |
 | `<text>`      | 文本     | `text`, `fontSize`, `fillColor`, `printMode`, `onFinish`, `onProgress` |
 | `<clip>`      | 裁剪     | 区域尺寸                                     |
@@ -277,7 +279,7 @@ Sandbox 为剧本表达式提供受控求值环境：
 type NodeProps = {
   label?: string;
   anchor?: [number, number];  // 0.0-1.0
-  pivot?: [number, number];   // pixels
+  pivot?: [number, number];   // 0.0-1.0
   x?: number; y?: number;
   scale?: number; scaleX?: number; scaleY?: number;
   rotation?: number;

package/dist/{jsx-dev-runtime-I0t9y4BC.d.mts → jsx-dev-runtime-x1NET2hA.d.mts}

@@ -284,6 +284,136 @@ type ShaderCommand = {
     subCommand: 'reset';
 };
 
+type OverlayDialog = 'friends' | 'community' | 'players' | 'settings' | 'officialGameGroup' | 'stats' | 'achievements';
+
+type OverlayNotificationPosition = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
+
+type OverlayStoreFlag = 'none' | 'addToCart' | 'addToCartAndShow';
+
+type TimelinePossibleClip = 'none' | 'standard' | 'featured';
+
+type SteamCommand = {
+    subCommand: 'achievementSet';
+    name: string;
+} | {
+    subCommand: 'achievementClear';
+    name: string;
+} | {
+    subCommand: 'achievementClearAll';
+} | {
+    subCommand: 'achievementGet';
+    name: string;
+} | {
+    subCommand: 'achievementIndicateProgress';
+    name: string;
+    current: number;
+    max: number;
+} | {
+    subCommand: 'appsDlcInstalled';
+    appId: number;
+} | {
+    subCommand: 'appsDlcProgress';
+    appId: number;
+} | {
+    subCommand: 'appsGetAppBuildId';
+} | {
+    subCommand: 'appsGetCurrentBetaName';
+} | {
+    subCommand: 'appsGetCurrentGameLanguage';
+} | {
+    subCommand: 'appsGetSteamUiLanguage';
+} | {
+    subCommand: 'appsInstallDlc';
+    appId: number;
+} | {
+    subCommand: 'appsIsSubscribedApp';
+    appId: number;
+} | {
+    subCommand: 'appsUninstallDlc';
+    appId: number;
+} | {
+    subCommand: 'overlayActivate';
+    dialog: OverlayDialog;
+} | {
+    subCommand: 'overlayActivateToStore';
+    appId: number;
+    flag?: OverlayStoreFlag;
+} | {
+    subCommand: 'overlayActivateToWebPage';
+    url: string;
+} | {
+    subCommand: 'overlayIsEnabled';
+} | {
+    subCommand: 'overlayNeedsPresent';
+} | {
+    subCommand: 'overlaySetNotificationPosition';
+    position: OverlayNotificationPosition;
+} | {
+    subCommand: 'statsClearAchievement';
+    name: string;
+} | {
+    subCommand: 'statsGetAchievement';
+    name: string;
+} | {
+    subCommand: 'statsGetFloatStat';
+    name: string;
+} | {
+    subCommand: 'statsGetIntStat';
+    name: string;
+} | {
+    subCommand: 'statsSetAchievement';
+    name: string;
+} | {
+    subCommand: 'statsIndicateAchievementProgress';
+    name: string;
+    current: number;
+    max: number;
+} | {
+    subCommand: 'statsListAchievements';
+} | {
+    subCommand: 'statsSetFloatStat';
+    name: string;
+    value: number;
+} | {
+    subCommand: 'statsSetIntStat';
+    name: string;
+    value: number;
+} | {
+    subCommand: 'statsStoreStats';
+} | {
+    subCommand: 'timelineAddEvent';
+    icon: string;
+    title: string;
+    description: string;
+    priority?: number;
+    startOffsetSeconds?: number;
+    durationSeconds?: number;
+    possibleClip?: TimelinePossibleClip;
+} | {
+    subCommand: 'timelineClearStateDescription';
+    timeDeltaSeconds?: number;
+} | {
+    subCommand: 'timelineSetStateDescription';
+    description: string;
+    timeDeltaSeconds?: number;
+} | {
+    subCommand: 'userGetAccountId';
+} | {
+    subCommand: 'userGetCSteamId';
+} | {
+    subCommand: 'userGetGameBadgeLevel';
+    series: number;
+    foil: boolean;
+} | {
+    subCommand: 'userGetPersonaName';
+} | {
+    subCommand: 'workshopGetSubscribedItemPath';
+    itemId: string;
+} | {
+    subCommand: 'workshopGetSubscribedItems';
+    includeDisabled?: boolean;
+};
+
 type ReadFormat = 'text' | 'binary';
 
 type WindowState = 'idle' | 'maximized' | 'minimized' | 'fullscreen';
@@ -332,72 +462,6 @@ type TextCommand = {
     subCommand: 'getCursorPosition';
 };
 
-declare function getStageSize(): {
-    width: number;
-    height: number;
-    scaleFactor: number;
-};
-type MakeNullOptional<T> = T extends any ? {
-    [K in keyof T as null extends T[K] ? never : K]: T[K];
-} & {
-    [K in keyof T as null extends T[K] ? K : never]?: T[K];
-} : never;
-
-type ShaderDirection = 'left' | 'right' | 'up' | 'down';
-
-type ShaderParamType = 'float' | 'int';
-
-type ShaderParam = {
-    name: string;
-    type: ShaderParamType;
-    value: number;
-};
-
-type ShaderSource = ({
-    type: 'builtin';
-} & ({
-    name: 'crossfade';
-} | {
-    name: 'wipe';
-    softness: number;
-    direction: ShaderDirection;
-} | {
-    name: 'fade';
-    out: number;
-    hold: number;
-    in: number;
-    color: string;
-} | {
-    name: 'push';
-    direction: ShaderDirection;
-} | {
-    name: 'slideaway';
-    direction: ShaderDirection;
-} | {
-    name: 'zoom';
-    startScale: number;
-    endScale: number;
-    origin: [number, number];
-} | {
-    name: 'pixellate';
-    steps: number;
-} | {
-    name: 'mask';
-    rule: string;
-    softness: number;
-    reverse: boolean;
-})) | {
-    type: 'raw';
-    content: string;
-    params?: Array<ShaderParam>;
-};
-
-type ShaderTimeControl = 'auto' | 'manual' | 'transition';
-
-type _Command = AudioCommand | TextCommand | GamepadCommand | ScenarioCommand | ShaderCommand | SystemCommand;
-type Command = MakeNullOptional<_Command>;
-type MaybePromise = any;
-
 interface MoyuEvent<T extends Record<string, unknown> = Record<string, unknown>> {
     name: string;
     body: T;
@@ -415,6 +479,54 @@ declare function createBubbleEvent<T extends BubbleEvent>(body: Record<string, a
     bubbleTargetIds: number[];
 }, targetId: number): T;
 
+declare class Node {
+    nodeId: number;
+    label?: string;
+    props: Record<string, any>;
+    listeners: Record<string, (evt?: BubbleEvent | Record<string, any>) => any>;
+    static create(label: string, type: string, props: Record<string, any>): Node;
+    static rootNode(): Node;
+    addChild(child: Node): void;
+    insertChild(_index: number, child: Node): void;
+    insertChildBefore(beforeChild: Node, child: Node): void;
+    removeChild(child: Node): void;
+    updateProps(props: Record<string, any>): void;
+    executeCommand(payload: Command): any;
+}
+
+type MouseEventKind = 'MouseEnter' | 'MouseLeave' | 'MouseDown' | 'MouseUp' | 'MouseMove' | 'Click' | 'DoubleClick' | 'ContextMenu';
+
+interface MouseEvent extends BubbleEvent {
+    kind: MouseEventKind;
+    targetId: number;
+    currentTargetId: number;
+    targetLabel?: string;
+    currentTargetLabel?: string;
+    clientX: number;
+    clientY: number;
+    screenX: number;
+    screenY: number;
+    offsetX: number;
+    offsetY: number;
+}
+
+type TouchEventKind = 'TouchStart' | 'TouchMove' | 'TouchEnd' | 'TouchCancel';
+
+interface TouchEvent extends BubbleEvent {
+    kind: TouchEventKind;
+    targetId: number;
+    currentTargetId: number;
+    targetLabel: string;
+    currentTargetLabel: string;
+    clientX: number;
+    clientY: number;
+    screenX: number;
+    screenY: number;
+    offsetX: number;
+    offsetY: number;
+    identifier: number;
+}
+
 type KeyboardEventKind = 'KeyDown' | 'KeyUp' | 'KeyPress';
 
 /**
@@ -453,52 +565,19 @@ interface KeyboardEvent extends BubbleEvent {
     readonly DOM_KEY_LOCATION_NUMPAD: 0x03;
 }
 
-type MouseEventKind = 'MouseEnter' | 'MouseLeave' | 'MouseDown' | 'MouseUp' | 'MouseMove' | 'Click' | 'DoubleClick' | 'ContextMenu';
-
-interface MouseEvent extends BubbleEvent {
-    kind: MouseEventKind;
-    targetId: number;
-    currentTargetId: number;
-    targetLabel?: string;
-    currentTargetLabel?: string;
-    clientX: number;
-    clientY: number;
-    screenX: number;
-    screenY: number;
-    offsetX: number;
-    offsetY: number;
-}
-
-type TouchEventKind = 'TouchStart' | 'TouchMove' | 'TouchEnd' | 'TouchCancel';
+type LayoutEvent = {
+    width: number;
+    height: number;
+};
 
-interface TouchEvent extends BubbleEvent {
-    kind: TouchEventKind;
-    targetId: number;
-    currentTargetId: number;
-    targetLabel: string;
-    currentTargetLabel: string;
-    clientX: number;
-    clientY: number;
-    screenX: number;
-    screenY: number;
-    offsetX: number;
-    offsetY: number;
-    identifier: number;
-}
+type WheelEventDeltaMode = 'pixel' | 'line' | 'page';
 
-declare class Node {
-    nodeId: number;
-    label?: string;
-    props: Record<string, any>;
-    listeners: Record<string, (evt?: BubbleEvent | Record<string, any>) => any>;
-    static create(label: string, type: string, props: Record<string, any>): Node;
-    static rootNode(): Node;
-    addChild(child: Node): void;
-    insertChild(_index: number, child: Node): void;
-    insertChildBefore(beforeChild: Node, child: Node): void;
-    removeChild(child: Node): void;
-    updateProps(props: Record<string, any>): void;
-    executeCommand(payload: Command): any;
+interface WheelEvent extends Omit<MouseEvent, 'kind'> {
+    kind: 'Wheel';
+    deltaX: number;
+    deltaY: number;
+    deltaZ: number;
+    deltaMode: WheelEventDeltaMode;
 }
 
 type MoyuCursor = 'hidden' | 'default' | 'context-menu' | 'help' | 'pointer' | 'progress' | 'wait' | 'cell' | 'crosshair' | 'text' | 'vertical-text' | 'alias' | 'copy' | 'move' | 'no-drop' | 'not-allowed' | 'grab' | 'grabbing' | 'e-resize' | 'n-resize' | 'ne-resize' | 'nw-resize' | 's-resize' | 'se-resize' | 'sw-resize' | 'w-resize' | 'ew-resize' | 'ns-resize' | 'nesw-resize' | 'nwse-resize' | 'col-resize' | 'row-resize' | 'all-scroll' | 'zoom-in' | 'zoom-out' | 'dnd-ask' | 'all-resize';
@@ -521,6 +600,33 @@ type NodeProps = {
     opacity?: number;
     interactive?: boolean;
     cursor?: MoyuCursor;
+    zIndex?: number;
+};
+
+type AlignItems = 'start' | 'center' | 'end';
+
+type JustifyContent = 'start' | 'center' | 'end' | 'space-between';
+
+type VBoxProps = {
+    width?: number;
+    height?: number;
+    gap?: number;
+    padding?: number;
+    paddingX?: number;
+    paddingY?: number;
+    justifyContent?: JustifyContent;
+    alignItems?: AlignItems;
+};
+
+type HBoxProps = {
+    width?: number;
+    height?: number;
+    gap?: number;
+    padding?: number;
+    paddingX?: number;
+    paddingY?: number;
+    justifyContent?: JustifyContent;
+    alignItems?: AlignItems;
 };
 
 type ClipProps = {
@@ -633,7 +739,59 @@ type TextProps = {
     shadowWidth?: number;
 };
 
+type ShaderDirection = 'left' | 'right' | 'up' | 'down';
+
+type ShaderParamType = 'float' | 'int';
+
+type ShaderParam = {
+    name: string;
+    type: ShaderParamType;
+    value: number;
+};
+
+type ShaderSource = ({
+    type: 'builtin';
+} & ({
+    name: 'crossfade';
+} | {
+    name: 'wipe';
+    softness: number;
+    direction: ShaderDirection;
+} | {
+    name: 'fade';
+    out: number;
+    hold: number;
+    in: number;
+    color: string;
+} | {
+    name: 'push';
+    direction: ShaderDirection;
+} | {
+    name: 'slideaway';
+    direction: ShaderDirection;
+} | {
+    name: 'zoom';
+    startScale: number;
+    endScale: number;
+    origin: [number, number];
+} | {
+    name: 'pixellate';
+    steps: number;
+} | {
+    name: 'mask';
+    softness: number;
+    reverse: boolean;
+})) | {
+    type: 'raw';
+    content: string;
+    params?: Array<ShaderParam>;
+};
+
+type ShaderTimeControl = 'auto' | 'manual' | 'transition';
+
 type ShaderProps = {
+    width?: number;
+    height?: number;
     shader?: ShaderSource;
     timeControl?: ShaderTimeControl;
     displayChannel?: number | null;
@@ -681,6 +839,7 @@ interface MoyuListenerAttributes {
     onKeyDown?: MoyuEventHandler<KeyboardEvent>;
     onKeyUp?: MoyuEventHandler<KeyboardEvent>;
     onKeyPress?: MoyuEventHandler<KeyboardEvent>;
+    onWheel?: MoyuEventHandler<WheelEvent>;
     onTouchStart?: MoyuEventHandler<TouchEvent>;
     onTouchMove?: MoyuEventHandler<TouchEvent>;
     onTouchEnd?: MoyuEventHandler<TouchEvent>;
@@ -690,6 +849,12 @@ type MoyuNodeAttributes = MoyuListenerAttributes & NodeProps & {
     children?: ReactNode;
 };
 type MoyuContainerAttributes = MoyuNodeAttributes;
+type MoyuVBoxAttributes = VBoxProps & MoyuNodeAttributes & {
+    onLayout?: (event: LayoutEvent) => void;
+};
+type MoyuHBoxAttributes = HBoxProps & MoyuNodeAttributes & {
+    onLayout?: (event: LayoutEvent) => void;
+};
 type MoyuClipAttributes = ClipProps & MoyuNodeAttributes;
 type MoyuFilterAttributes = FilterProps & MoyuNodeAttributes;
 type MoyuBackdropAttributes = BackdropProps & MoyuNodeAttributes;
@@ -728,6 +893,8 @@ declare namespace JSX {
     }
     interface IntrinsicElements {
         container: DetailedMoyuProps<MoyuContainerAttributes>;
+        vbox: DetailedMoyuProps<MoyuVBoxAttributes>;
+        hbox: DetailedMoyuProps<MoyuHBoxAttributes>;
         sprite: DetailedMoyuProps<MoyuSpriteAttributes>;
         text: DetailedMoyuProps<MoyuTextAttributes>;
         clip: DetailedMoyuProps<MoyuClipAttributes>;
@@ -740,4 +907,20 @@ declare namespace JSX {
     }
 }
 
-export { type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EffectParams as E, type SystemCommand as F, type GamepadCommand as G, type TouchEvent as H, type TouchEventKind as I, JSX as J, type KeyboardEvent as K, type Tuple2 as L, type MouseEvent as M, Node as N, type Tuple3 as O, type Tuple4 as P, createBubbleEvent as Q, type RetainMode as R, type ShaderDirection as S, type TextCommand as T, getStageSize as U, type WindowState as W, type MoyuEvent as a, type MaybePromise as b, type JsonValue as c, type AudioSettings as d, type KeyboardEventKind as e, type MakeNullOptional as f, type MouseEventKind as g, type MoyuAnimationAttributes as h, type MoyuBackdropAttributes as i, type MoyuClipAttributes as j, type MoyuContainerAttributes as k, type MoyuEventHandler as l, type MoyuFilterAttributes as m, type MoyuListenerAttributes as n, type MoyuNodeAttributes as o, type MoyuShaderAttributes as p, type MoyuShaderSlotAttributes as q, type MoyuSpriteAttributes as r, type MoyuTextAttributes as s, type MoyuVideoAttributes as t, type ScenarioCommand as u, type ShaderCommand as v, type ShaderParam as w, type ShaderParamType as x, type ShaderSource as y, type ShaderTimeControl as z };
+declare function getStageSize(): {
+    width: number;
+    height: number;
+    scaleFactor: number;
+};
+type MakeNullOptional<T> = T extends unknown ? {
+    [K in keyof T as null extends T[K] ? never : K]: T[K];
+} & {
+    [K in keyof T as null extends T[K] ? K : never]?: T[K];
+} : never;
+declare function mergeEvent<T extends BubbleEvent, K extends BubbleEvent>(handlers: MoyuEventHandler<T> | readonly MoyuEventHandler<T>[] | undefined, defaultHandler?: MoyuEventHandler<K>): (event: T | K) => void;
+
+type _Command = AudioCommand | TextCommand | GamepadCommand | ScenarioCommand | ShaderCommand | SteamCommand | SystemCommand;
+type Command = MakeNullOptional<_Command>;
+type MaybePromise = any;
+
+export { type Tuple2 as $, type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EffectParams as E, type ScenarioCommand as F, type GamepadCommand as G, type ShaderCommand as H, type ShaderParam as I, JSX as J, type KeyboardEvent as K, type LayoutEvent as L, type MoyuEvent as M, Node as N, type OverlayDialog as O, type ShaderParamType as P, type ShaderSource as Q, type RetainMode as R, type ShaderDirection as S, type TouchEvent as T, type ShaderTimeControl as U, type SteamCommand as V, type WheelEvent as W, type SystemCommand as X, type TextCommand as Y, type TimelinePossibleClip as Z, type TouchEventKind as _, type MaybePromise as a, type Tuple3 as a0, type Tuple4 as a1, type WheelEventDeltaMode as a2, type WindowState as a3, createBubbleEvent as a4, getStageSize as a5, mergeEvent as a6, type MoyuClipAttributes as b, type MoyuVBoxAttributes as c, type MoyuSpriteAttributes as d, type TextProps as e, type MoyuNodeAttributes as f, type MouseEvent as g, type SpriteProps as h, type JsonValue as i, type AudioSettings as j, type KeyboardEventKind as k, type MakeNullOptional as l, type MouseEventKind as m, type MoyuAnimationAttributes as n, type MoyuBackdropAttributes as o, type MoyuContainerAttributes as p, type MoyuEventHandler as q, type MoyuFilterAttributes as r, type MoyuHBoxAttributes as s, type MoyuListenerAttributes as t, type MoyuShaderAttributes as u, type MoyuShaderSlotAttributes as v, type MoyuTextAttributes as w, type MoyuVideoAttributes as x, type OverlayNotificationPosition as y, type OverlayStoreFlag as z };