@momoyu-ink/kit 0.10.0 → 0.11.0

package/AGENTS.md

@@ -193,7 +193,7 @@ Stage 是剧情驱动 UI 的核心抽象：命令调度、流程控制、skip /
 
 | 方法 | 作用 |
 |------|------|
-| `control.hold()` | 暂停直到用户操作；在 auto 模式下会打开 `hold` barrier |
+| `control.hold(until?, skippable?)` | 无参数时保持无限暂停；传入 Promise-like 时等待其 settle，`skippable` 为 true 时允许 interrupt / skip 提前完成 |
 | `control.setWaiting(ms, skippable)` | 定时等待；在 auto 模式下会打开 `wait` barrier |
 | `control.nextLine()` | 立即推进 |
 | `control.unskippable()` | 将本次 dispatch 标记为不可跳过 |
@@ -202,7 +202,8 @@ Stage 是剧情驱动 UI 的核心抽象：命令调度、流程控制、skip /
 **实现要点：**
 
 - Stage 当前只封装 `scenariocommandline` 和 `scenariotext` 两类事件；`ResolvedSystemCallLine` 虽然从 `events.ts` 导出，但若要处理 system call，需要自己显式监听对应事件。
-- auto 模式下，`hold()` / `setWaiting()` 不会直接把控制权交给普通等待逻辑，而是打开一个 barrier。只有当 barrier 的 ticket 全部 `done()` / `cancel()`，并且各自 `tailMs` 都结算完成后，Stage 才会恢复 `nextLine()`。
+- auto 模式下，无参数 `hold()` / `setWaiting()` 不会直接把控制权交给普通等待逻辑，而是打开一个 barrier。只有当 barrier 的 ticket 全部 `done()` / `cancel()`，并且各自 `tailMs` 都结算完成后，Stage 才会恢复 `nextLine()`。
+- `hold(until, skippable)` 使用 Stage 当前 dispatch 的唯一 active wait，不进入 auto barrier。Promise resolve 或 reject 后请求一次推进；reject 会记录错误。`skippable` 默认为 false；为 true 时，interrupt / skip 会先调用等待对象可选的 `finish()`，再解除等待。Promise、interrupt、skip、reset 和新 dispatch 竞争同一个一次性完成状态。
 - `useAutoTicket()` 允许 actor 参与 auto barrier 协调。若 ticket 在 barrier 打开前的短暂采集窗口内创建，Stage 会先把它放入 pending 集合，再在下一个 barrier 打开时收编，解决语音等副作用早于文本 barrier 注册的问题。
 - skip / auto blocker 用于表达“当前流程禁止模式继续”的业务条件，适合选项菜单、模态交互等必须等待用户操作的场景。
 

package/dist/{jsx-dev-runtime-gGlb6FbX.d.mts → jsx-dev-runtime-BasPxDFu.d.mts}

@@ -109,6 +109,19 @@ type AudioCommand = {
     panning: number;
 };
 
+type EditableCommand = {
+    subCommand: 'getState';
+} | {
+    subCommand: 'setValue';
+    value: string;
+} | {
+    subCommand: 'setCaretRect';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+
 type EffectParams = {
     duration: number;
     startDelay: number;
@@ -284,6 +297,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';
@@ -318,6 +461,9 @@ type SystemCommand = {
     format?: ReadFormat;
 } | {
     subCommand: 'getParams';
+} | {
+    subCommand: 'openUrl';
+    url: string;
 } | {
     subCommand: 'quit';
 };
@@ -332,6 +478,28 @@ type TextCommand = {
     subCommand: 'getCursorPosition';
 };
 
+type VideoCommand = {
+    subCommand: 'play';
+} | {
+    subCommand: 'pause';
+} | {
+    subCommand: 'resume';
+} | {
+    subCommand: 'stop';
+} | {
+    subCommand: 'seek';
+    time: number;
+} | {
+    subCommand: 'setVolume';
+    volume: number;
+} | {
+    subCommand: 'setMuted';
+    muted: boolean;
+} | {
+    subCommand: 'setLoop';
+    enabled: boolean;
+};
+
 interface MoyuEvent<T extends Record<string, unknown> = Record<string, unknown>> {
     name: string;
     body: T;
@@ -440,6 +608,13 @@ type LayoutEvent = {
     height: number;
 };
 
+type TextLayoutEvent = {
+    text: string;
+    width: number;
+    height: number;
+    endCursorPosition: [number, number];
+};
+
 type WheelEventDeltaMode = 'pixel' | 'line' | 'page';
 
 interface WheelEvent extends Omit<MouseEvent, 'kind'> {
@@ -471,6 +646,7 @@ type NodeProps = {
     interactive?: boolean;
     cursor?: MoyuCursor;
     zIndex?: number;
+    excludeFromLayout?: boolean;
 };
 
 type AlignItems = 'start' | 'center' | 'end';
@@ -504,6 +680,44 @@ type ClipProps = {
     height?: number;
 };
 
+type EditableChangeSource = 'insertText' | 'insertCompositionText' | 'deleteBackward';
+
+type EditableState = {
+    value: string;
+    isComposing: boolean;
+    compositionText: string;
+};
+
+type EditableEvent = {
+    type: 'focus';
+    state: EditableState;
+} | {
+    type: 'blur';
+    state: EditableState;
+} | {
+    type: 'input';
+    state: EditableState;
+} | {
+    type: 'change';
+    state: EditableState;
+    source: EditableChangeSource;
+} | {
+    type: 'compositionStart';
+    state: EditableState;
+} | {
+    type: 'compositionUpdate';
+    state: EditableState;
+} | {
+    type: 'compositionEnd';
+    state: EditableState;
+};
+
+type EditableProps = {
+    value?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+};
+
 /**
  * 滤镜配置（可序列化，用于 JS 互操作）
  */
@@ -577,6 +791,7 @@ type TextProps = {
     text?: string;
     printMode?: TextPrintMode;
     printSpeed?: number;
+    parseMarkup?: boolean;
     /**
      * the writing direction of the text in the box,
      * only `Horizontal` (right-to-left) or `Vertical` (top-to-bottom) is valid.
@@ -649,13 +864,16 @@ type ShaderSource = ({
     steps: number;
 } | {
     name: 'mask';
-    rule: string;
     softness: number;
     reverse: boolean;
 })) | {
     type: 'raw';
     content: string;
     params?: Array<ShaderParam>;
+} | {
+    type: 'file';
+    src: string;
+    params?: Array<ShaderParam>;
 };
 
 type ShaderTimeControl = 'auto' | 'manual' | 'transition';
@@ -727,6 +945,29 @@ type MoyuHBoxAttributes = HBoxProps & MoyuNodeAttributes & {
     onLayout?: (event: LayoutEvent) => void;
 };
 type MoyuClipAttributes = ClipProps & MoyuNodeAttributes;
+type MoyuEditableAttributes = EditableProps & MoyuNodeAttributes & {
+    onFocus?: (event: Extract<EditableEvent, {
+        type: 'focus';
+    }>) => void;
+    onBlur?: (event: Extract<EditableEvent, {
+        type: 'blur';
+    }>) => void;
+    onInput?: (event: Extract<EditableEvent, {
+        type: 'input';
+    }>) => void;
+    onChange?: (event: Extract<EditableEvent, {
+        type: 'change';
+    }>) => void;
+    onCompositionStart?: (event: Extract<EditableEvent, {
+        type: 'compositionStart';
+    }>) => void;
+    onCompositionUpdate?: (event: Extract<EditableEvent, {
+        type: 'compositionUpdate';
+    }>) => void;
+    onCompositionEnd?: (event: Extract<EditableEvent, {
+        type: 'compositionEnd';
+    }>) => void;
+};
 type MoyuFilterAttributes = FilterProps & MoyuNodeAttributes;
 type MoyuBackdropAttributes = BackdropProps & MoyuNodeAttributes;
 type MoyuAnimationAttributes = AnimationProps & MoyuNodeAttributes;
@@ -744,6 +985,7 @@ type MoyuTextAttributes = TextProps & MoyuNodeAttributes & {
     onStart?: () => void;
     onFinish?: () => void;
     onProgress?: (progress: number) => void;
+    onTextLayout?: (event: TextLayoutEvent) => void;
 };
 declare namespace JSX {
     type ElementType = string | React.JSXElementConstructor<any>;
@@ -769,6 +1011,7 @@ declare namespace JSX {
         sprite: DetailedMoyuProps<MoyuSpriteAttributes>;
         text: DetailedMoyuProps<MoyuTextAttributes>;
         clip: DetailedMoyuProps<MoyuClipAttributes>;
+        editable: DetailedMoyuProps<MoyuEditableAttributes>;
         filter: DetailedMoyuProps<MoyuFilterAttributes>;
         backdrop: DetailedMoyuProps<MoyuBackdropAttributes>;
         animation: DetailedMoyuProps<MoyuAnimationAttributes>;
@@ -790,8 +1033,8 @@ type MakeNullOptional<T> = T extends unknown ? {
 } : 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 | SystemCommand;
+type _Command = AudioCommand | EditableCommand | TextCommand | GamepadCommand | ScenarioCommand | ShaderCommand | SteamCommand | SystemCommand | VideoCommand;
 type Command = MakeNullOptional<_Command>;
 type MaybePromise = any;
 
-export { createBubbleEvent as $, type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EffectParams as E, type ShaderParam as F, type GamepadCommand as G, type ShaderParamType as H, type ShaderSource as I, JSX as J, type KeyboardEvent as K, type LayoutEvent as L, type MoyuEvent as M, Node as N, type ShaderTimeControl as O, type SystemCommand as P, type TextCommand as Q, type RetainMode as R, type ShaderDirection as S, type TouchEvent as T, type TouchEventKind as U, type Tuple2 as V, type WheelEvent as W, type Tuple3 as X, type Tuple4 as Y, type WheelEventDeltaMode as Z, type WindowState as _, type MaybePromise as a, getStageSize as a0, mergeEvent as a1, 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 ScenarioCommand as y, type ShaderCommand as z };
+export { type SteamCommand as $, type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EditableState as E, type MoyuShaderAttributes as F, type GamepadCommand as G, type MoyuShaderSlotAttributes as H, type MoyuVideoAttributes 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 OverlayNotificationPosition as P, type OverlayStoreFlag as Q, type RetainMode as R, type ShaderDirection as S, type TouchEvent as T, type ScenarioCommand as U, type ShaderCommand as V, type WheelEvent as W, type ShaderParam as X, type ShaderParamType as Y, type ShaderSource as Z, type ShaderTimeControl as _, type MaybePromise as a, type SystemCommand as a0, type TextCommand as a1, type TextLayoutEvent as a2, type TimelinePossibleClip as a3, type TouchEventKind as a4, type Tuple2 as a5, type Tuple3 as a6, type Tuple4 as a7, type VideoCommand as a8, type WheelEventDeltaMode as a9, type WindowState as aa, createBubbleEvent as ab, getStageSize as ac, mergeEvent as ad, 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 MoyuTextAttributes as h, type EditableChangeSource as i, type SpriteProps as j, type JsonValue as k, type AudioSettings as l, type EditableCommand as m, type EditableEvent as n, type EffectParams as o, type KeyboardEventKind as p, type MakeNullOptional as q, type MouseEventKind as r, type MoyuAnimationAttributes as s, type MoyuBackdropAttributes as t, type MoyuContainerAttributes as u, type MoyuEditableAttributes as v, type MoyuEventHandler as w, type MoyuFilterAttributes as x, type MoyuHBoxAttributes as y, type MoyuListenerAttributes as z };