@vulfram/engine 0.14.8-alpha → 0.19.2-alpha

package/src/types/cmds/window.ts

@@ -22,6 +22,9 @@ export interface CmdWindowCreateArgs {
 export interface CmdResultWindowCreate {
   success: boolean;
   message: string;
+  realmId?: number;
+  surfaceId?: number;
+  presentId?: number;
 }
 
 /** Command payload for closing a window. */
@@ -35,229 +38,63 @@ export interface CmdResultWindowClose {
   message: string;
 }
 
-/** Command payload for setting window title. */
-export interface CmdWindowSetTitleArgs {
+/** Command payload for changing and/or querying window measurements. */
+export interface CmdWindowMeasurementArgs {
   windowId: number;
-  title: string;
+  position?: [number, number];
+  size?: [number, number];
+  getPosition?: boolean;
+  getSize?: boolean;
+  getOuterSize?: boolean;
+  getSurfaceSize?: boolean;
 }
 
-/** Result payload for window title update. */
-export interface CmdResultWindowSetTitle {
+/** Result payload for window measurement command. */
+export interface CmdResultWindowMeasurement {
   success: boolean;
   message: string;
+  position?: [number, number];
+  size?: [number, number];
+  outerSize?: [number, number];
+  surfaceSize?: [number, number];
 }
 
-/** Command payload for setting window position. */
-export interface CmdWindowSetPositionArgs {
+/** Command payload for cursor updates. */
+export interface CmdWindowCursorArgs {
   windowId: number;
-  position: [number, number];
+  visible?: boolean;
+  mode?: CursorGrabMode;
+  icon?: CursorIcon;
 }
 
-/** Result payload for window position update. */
-export interface CmdResultWindowSetPosition {
+/** Result payload for cursor command. */
+export interface CmdResultWindowCursor {
   success: boolean;
   message: string;
 }
 
-/** Command payload for querying window position. */
-export interface CmdWindowGetPositionArgs {
-  windowId: number;
-}
-
-/** Result payload for window position query. */
-export interface CmdResultWindowGetPosition {
-  success: boolean;
-  message: string;
-  content: [number, number];
-}
-
-/** Command payload for setting window size. */
-export interface CmdWindowSetSizeArgs {
-  windowId: number;
-  size: [number, number];
-}
-
-/** Result payload for window size update. */
-export interface CmdResultWindowSetSize {
-  success: boolean;
-  message: string;
-}
-
-/** Command payload for querying window size. */
-export interface CmdWindowGetSizeArgs {
-  windowId: number;
-}
-
-/** Result payload for window size query. */
-export interface CmdResultWindowGetSize {
-  success: boolean;
-  message: string;
-  content: [number, number];
-}
-
-/** Command payload for querying outer window size. */
-export interface CmdWindowGetOuterSizeArgs {
-  windowId: number;
-}
-
-/** Result payload for outer window size query. */
-export interface CmdResultWindowGetOuterSize {
-  success: boolean;
-  message: string;
-  content: [number, number];
-}
-
-/** Command payload for querying surface size. */
-export interface CmdWindowGetSurfaceSizeArgs {
-  windowId: number;
-}
-
-/** Result payload for surface size query. */
-export interface CmdResultWindowGetSurfaceSize {
-  success: boolean;
-  message: string;
-  content: [number, number];
-}
-
-/** Command payload for setting window state. */
-export interface CmdWindowSetStateArgs {
-  windowId: number;
-  state: WindowState;
-}
-
-/** Result payload for window state update. */
-export interface CmdResultWindowSetState {
-  success: boolean;
-  message: string;
-}
-
-/** Command payload for querying window state. */
-export interface CmdWindowGetStateArgs {
-  windowId: number;
-}
-
-/** Result payload for window state query. */
-export interface CmdResultWindowGetState {
-  success: boolean;
-  message: string;
-  content: WindowState;
-}
-
-/** Command payload for setting window icon. */
-export interface CmdWindowSetIconArgs {
-  windowId: number;
-  bufferId: number; // Buffer ID pointing to an image
-}
-
-/** Result payload for window icon update. */
-export interface CmdResultWindowSetIcon {
-  success: boolean;
-  message: string;
-}
-
-/** Command payload for toggling window decorations. */
-export interface CmdWindowSetDecorationsArgs {
-  windowId: number;
-  decorations: boolean;
-}
-
-/** Result payload for window decoration update. */
-export interface CmdResultWindowSetDecorations {
-  success: boolean;
-  message: string;
-}
+export type WindowStateAction = 'focus' | 'request-attention';
 
-/** Command payload for querying window decorations. */
-export interface CmdWindowHasDecorationsArgs {
-  windowId: number;
-}
-
-/** Result payload for window decoration query. */
-export interface CmdResultWindowHasDecorations {
-  success: boolean;
-  message: string;
-  content: boolean;
-}
-
-/** Command payload for toggling window resizable state. */
-export interface CmdWindowSetResizableArgs {
-  windowId: number;
-  resizable: boolean;
-}
-
-/** Result payload for window resizable update. */
-export interface CmdResultWindowSetResizable {
-  success: boolean;
-  message: string;
-}
-
-/** Command payload for querying resizable state. */
-export interface CmdWindowIsResizableArgs {
-  windowId: number;
-}
-
-/** Result payload for resizable query. */
-export interface CmdResultWindowIsResizable {
-  success: boolean;
-  message: string;
-  content: boolean;
-}
-
-/** Command payload for requesting user attention. */
-export interface CmdWindowRequestAttentionArgs {
+/** Command payload for state updates/queries. */
+export interface CmdWindowStateArgs {
   windowId: number;
+  title?: string;
+  state?: WindowState;
+  iconBufferId?: number;
+  decorations?: boolean;
+  resizable?: boolean;
+  action?: WindowStateAction;
   attentionType?: UserAttentionType;
+  getState?: boolean;
+  getDecorations?: boolean;
+  getResizable?: boolean;
 }
 
-/** Result payload for attention request. */
-export interface CmdResultWindowRequestAttention {
-  success: boolean;
-  message: string;
-}
-
-/** Command payload for focusing a window. */
-export interface CmdWindowFocusArgs {
-  windowId: number;
-}
-
-/** Result payload for window focus. */
-export interface CmdResultWindowFocus {
-  success: boolean;
-  message: string;
-}
-
-/** Command payload for toggling cursor visibility. */
-export interface CmdWindowSetCursorVisibleArgs {
-  windowId: number;
-  visible: boolean;
-}
-
-/** Result payload for cursor visibility update. */
-export interface CmdResultWindowSetCursorVisible {
-  success: boolean;
-  message: string;
-}
-
-/** Command payload for setting cursor grab mode. */
-export interface CmdWindowSetCursorGrabArgs {
-  windowId: number;
-  mode: CursorGrabMode;
-}
-
-/** Result payload for cursor grab update. */
-export interface CmdResultWindowSetCursorGrab {
-  success: boolean;
-  message: string;
-}
-
-/** Command payload for setting cursor icon. */
-export interface CmdWindowSetCursorIconArgs {
-  windowId: number;
-  icon: CursorIcon;
-}
-
-/** Result payload for cursor icon update. */
-export interface CmdResultWindowSetCursorIcon {
+/** Result payload for state command. */
+export interface CmdResultWindowState {
   success: boolean;
   message: string;
+  state?: WindowState;
+  decorations?: boolean;
+  resizable?: boolean;
 }

package/src/types/events/index.ts

@@ -3,12 +3,14 @@ import type { PointerEvent } from './pointer';
 import type { KeyboardEvent } from './keyboard';
 import type { GamepadEvent } from './gamepad';
 import type { SystemEvent } from './system';
+import type { UiEvent } from './ui';
 
 export * from './window';
 export * from './pointer';
 export * from './keyboard';
 export * from './gamepad';
 export * from './system';
+export * from './ui';
 
 /** Discriminated union of all engine events. */
 export type EngineEvent =
@@ -16,4 +18,5 @@ export type EngineEvent =
   | { type: 'pointer'; content: PointerEvent }
   | { type: 'keyboard'; content: KeyboardEvent }
   | { type: 'gamepad'; content: GamepadEvent }
-  | { type: 'system'; content: SystemEvent };
+  | { type: 'system'; content: SystemEvent }
+  | { type: 'ui'; content: UiEvent };

package/src/types/events/keyboard.ts

@@ -120,8 +120,8 @@ export enum KeyCode {
   ControlLeft = 55,
   ControlRight = 56,
   Enter = 57,
-  SuperLeft = 58,
-  SuperRight = 59,
+  MetaLeft = 58,
+  MetaRight = 59,
   ShiftLeft = 60,
   ShiftRight = 61,
   Space = 62,

package/src/types/events/pointer.ts

@@ -1,85 +1,158 @@
 import type { ElementState, TouchPhase } from '../kinds';
 
-/** Scroll delta reported in line or pixel units. */
 export type ScrollDelta =
   | { type: 'line'; value: [number, number] }
   | { type: 'pixel'; value: [number, number] };
 
-/** Payload for pointer move event. */
+export type PointerTraceStage =
+  | 'root-window'
+  | 'capture'
+  | 'focus-fallback'
+  | 'connector-hit'
+  | 'realm-plane-hit'
+  | 'hop-forward'
+  | 'stop-no-hit'
+  | 'stop-cycle'
+  | 'stop-step-budget';
+
+export interface PointerTraceHop {
+  stage: PointerTraceStage;
+  realmId?: number;
+  targetId?: number;
+  layerRealmId?: number;
+  connectorId?: number;
+  surfaceId?: number;
+  cameraId?: number;
+  uv?: [number, number];
+}
+
+export interface PointerEventTrace {
+  windowId: number;
+  realmId: number;
+  targetId?: number;
+  connectorId?: number;
+  sourceRealmId?: number;
+  uv?: [number, number];
+  hops: PointerTraceHop[];
+}
+
 export interface PointerEventOnMoveData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
   pointerType: number;
   pointerId: number;
   position: [number, number];
+  positionTarget?: [number, number];
+  targetWidth?: number;
+  targetHeight?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Payload for pointer enter event. */
 export interface PointerEventOnEnterData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
   pointerType: number;
   pointerId: number;
+  targetWidth?: number;
+  targetHeight?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Payload for pointer leave event. */
 export interface PointerEventOnLeaveData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
   pointerType: number;
   pointerId: number;
+  targetWidth?: number;
+  targetHeight?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Payload for pointer button event. */
 export interface PointerEventOnButtonData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
   pointerType: number;
   pointerId: number;
   button: MouseButton;
   state: ElementState;
   position: [number, number];
+  positionTarget?: [number, number];
+  targetWidth?: number;
+  targetHeight?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Payload for pointer scroll event. */
 export interface PointerEventOnScrollData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
   delta: ScrollDelta;
   phase: TouchPhase;
+  targetWidth?: number;
+  targetHeight?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Payload for touch event. */
 export interface PointerEventOnTouchData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
   pointerId: number;
   phase: TouchPhase;
   position: [number, number];
+  positionTarget?: [number, number];
+  targetWidth?: number;
+  targetHeight?: number;
   pressure?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Payload for pinch gesture event. */
 export interface PointerEventOnPinchGestureData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
   delta: number;
   phase: TouchPhase;
+  targetWidth?: number;
+  targetHeight?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Payload for pan gesture event. */
 export interface PointerEventOnPanGestureData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
   delta: [number, number];
   phase: TouchPhase;
+  targetWidth?: number;
+  targetHeight?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Payload for rotation gesture event. */
 export interface PointerEventOnRotationGestureData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
   delta: number;
   phase: TouchPhase;
+  targetWidth?: number;
+  targetHeight?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Payload for double tap gesture event. */
 export interface PointerEventOnDoubleTapGestureData {
   windowId: number;
+  windowWidth?: number;
+  windowHeight?: number;
+  targetWidth?: number;
+  targetHeight?: number;
+  trace?: PointerEventTrace;
 }
 
-/** Discriminated union of pointer events. */
 export type PointerEvent =
   | { event: 'on-move'; data: PointerEventOnMoveData }
   | { event: 'on-enter'; data: PointerEventOnEnterData }
@@ -95,7 +168,6 @@ export type PointerEvent =
       data: PointerEventOnDoubleTapGestureData;
     };
 
-/** Mouse button identifiers. */
 export enum MouseButton {
   Left = 0,
   Right = 1,