@vulfram/engine 0.14.8-alpha → 0.17.1-alpha

package/src/types/cmds/system.ts

@@ -1,5 +1,8 @@
 import type { NotificationLevel } from '../kinds';
 
+export type ProfilingDetailLevel = 'basic' | 'full';
+export type SystemPointerTraceLevel = 'off' | 'errors' | 'basic' | 'full';
+
 /** Command payload for sending a notification. */
 export interface CmdNotificationSendArgs {
   id?: string;
@@ -14,6 +17,22 @@ export interface CmdResultNotificationSend {
   success: boolean;
 }
 
+/** Command payload for runtime diagnostics and tracing controls. */
+export interface CmdSystemDiagnosticsSetArgs {
+  profilingEnabled?: boolean;
+  profilingDetail?: ProfilingDetailLevel;
+  profilingSamplingPercent?: number;
+  profilingWindowFrames?: number;
+  traceLevel?: SystemPointerTraceLevel;
+  traceSamplingPercent?: number;
+}
+
+/** Result payload for diagnostics update. */
+export interface CmdResultSystemDiagnosticsSet {
+  success: boolean;
+  message: string;
+}
+
 /** Command payload for discarding all pending upload buffers. */
 export interface CmdUploadBufferDiscardAllArgs {}
 

package/src/types/cmds/target.ts

@@ -0,0 +1,82 @@
+export type TargetKind =
+  | 'window'
+  | 'widget-realm-viewport'
+  | 'realm-plane'
+  | 'texture';
+
+export type SurfaceFormat =
+  | 'rgba16-float'
+  | 'rgba8-unorm'
+  | 'bgra8-unorm'
+  | 'depth32-float'
+  | 'depth24-plus';
+
+export type SurfaceAlphaMode =
+  | 'auto'
+  | 'opaque'
+  | 'pre-multiplied'
+  | 'post-multiplied'
+  | 'inherit';
+
+export type DimensionValue =
+  | { unit: 'px'; value: number }
+  | { unit: 'percent'; value: number }
+  | { unit: 'character'; value: number }
+  | { unit: 'display'; value: number };
+
+export interface TargetLayerLayout {
+  left: DimensionValue;
+  top: DimensionValue;
+  width: DimensionValue;
+  height: DimensionValue;
+  zIndex: number;
+  blendMode: number;
+  clip?: [number, number, number, number] | null;
+}
+
+export interface CmdTargetUpsertArgs {
+  targetId: number;
+  kind: TargetKind;
+  windowId?: number;
+  size?: [number, number];
+  formatPolicy?: SurfaceFormat;
+  alphaPolicy?: SurfaceAlphaMode;
+  msaaSamples?: number;
+}
+
+export interface CmdResultTargetUpsert {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdTargetDisposeArgs {
+  targetId: number;
+}
+
+export interface CmdResultTargetDispose {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdTargetLayerUpsertArgs {
+  realmId: number;
+  targetId: number;
+  layout: TargetLayerLayout;
+  cameraId?: number;
+  environmentId?: number;
+}
+
+export interface CmdResultTargetLayerUpsert {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdTargetLayerDisposeArgs {
+  realmId: number;
+  targetId: number;
+}
+
+export interface CmdResultTargetLayerDispose {
+  success: boolean;
+  message: string;
+}

package/src/types/cmds/texture.ts

@@ -9,7 +9,6 @@ export interface ForwardAtlasOptions {
 
 /** Command payload for creating a texture from an uploaded buffer. */
 export interface CmdTextureCreateFromBufferArgs {
-  windowId: number;
   textureId: number;
   label?: string;
   bufferId: number;
@@ -27,7 +26,6 @@ export interface CmdResultTextureCreateFromBuffer {
 
 /** Command payload for creating a solid color texture. */
 export interface CmdTextureCreateSolidColorArgs {
-  windowId: number;
   textureId: number;
   label?: string;
   color: [number, number, number, number];
@@ -44,7 +42,6 @@ export interface CmdResultTextureCreateSolidColor {
 
 /** Command payload for disposing a texture. */
 export interface CmdTextureDisposeArgs {
-  windowId: number;
   textureId: number;
 }
 
@@ -54,6 +51,19 @@ export interface CmdResultTextureDispose {
   message: string;
 }
 
+/** Command payload for binding a texture to a target output. */
+export interface CmdTextureBindTargetArgs {
+  textureId: number;
+  targetId: number;
+  label?: string;
+}
+
+/** Result payload for texture-target binding. */
+export interface CmdResultTextureBindTarget {
+  success: boolean;
+  message: string;
+}
+
 /** Command payload for listing textures. */
 export interface CmdTextureListArgs {
   windowId: number;

package/src/types/cmds/ui.ts

@@ -0,0 +1,220 @@
+import type { JsonObject, JsonValue } from '../json';
+
+export type UiThemeValue = JsonValue;
+export type UiOp = JsonObject;
+export type UiNodeKind = string;
+export type UiNodeProps = JsonObject;
+
+export interface CmdUiThemeDefineArgs {
+  themeId: number;
+  version?: number;
+  data?: Record<string, UiThemeValue>;
+  fontData?: Record<string, number[]>;
+  fontFamilies?: Record<string, string[]>;
+}
+
+export interface CmdResultUiThemeDefine {
+  success: boolean;
+  message: string;
+  themeId?: number;
+  version?: number;
+}
+
+export interface CmdUiThemeDisposeArgs {
+  themeId: number;
+}
+
+export interface CmdResultUiThemeDispose {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdUiDocumentCreateArgs {
+  documentId: number;
+  realmId: number;
+  rect: [number, number, number, number];
+  themeId?: number;
+}
+
+export interface CmdResultUiDocumentCreate {
+  success: boolean;
+  message: string;
+  documentId?: number;
+}
+
+export interface CmdUiDocumentDisposeArgs {
+  documentId: number;
+}
+
+export interface CmdResultUiDocumentDispose {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdUiDocumentSetRectArgs {
+  documentId: number;
+  rect: [number, number, number, number];
+}
+
+export interface CmdResultUiDocumentSetRect {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdUiDocumentSetThemeArgs {
+  documentId: number;
+  themeId?: number;
+}
+
+export interface CmdResultUiDocumentSetTheme {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdUiDocumentGetTreeArgs {
+  documentId: number;
+}
+
+export interface UiDocumentTreeNode {
+  nodeId: number;
+  kind: UiNodeKind;
+  zIndex: number;
+  children: UiDocumentTreeNode[];
+}
+
+export interface CmdResultUiDocumentGetTree {
+  success: boolean;
+  message: string;
+  documentId?: number;
+  version?: number;
+  rootNodes: UiDocumentTreeNode[];
+}
+
+export interface CmdUiDocumentGetLayoutRectsArgs {
+  documentId: number;
+}
+
+export interface UiNodeLayoutRect {
+  nodeId: number;
+  rect: [number, number, number, number];
+}
+
+export interface CmdResultUiDocumentGetLayoutRects {
+  success: boolean;
+  message: string;
+  documentId?: number;
+  version?: number;
+  rects: UiNodeLayoutRect[];
+}
+
+export interface CmdUiApplyOpsArgs {
+  documentId: number;
+  version: number;
+  ops: UiOp[];
+}
+
+export interface CmdResultUiApplyOps {
+  success: boolean;
+  message: string;
+  version?: number;
+}
+
+export interface CmdUiDebugSetArgs {
+  enabled: boolean;
+  showBounds?: boolean;
+  showIds?: boolean;
+  showProfile?: boolean;
+}
+
+export interface CmdResultUiDebugSet {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdUiFocusSetArgs {
+  windowId: number;
+  realmId: number;
+  documentId: number;
+  nodeId?: number;
+}
+
+export interface CmdUiFocusGetArgs {
+  windowId?: number;
+}
+
+export interface CmdResultUiFocusSet {
+  success: boolean;
+  message: string;
+}
+
+export interface UiFocusEntry {
+  windowId: number;
+  realmId: number;
+  documentId: number;
+  nodeId: number;
+}
+
+export interface CmdResultUiFocusGet {
+  success: boolean;
+  message: string;
+  entries: UiFocusEntry[];
+}
+
+export type UiCmdPointerTraceLevel = 'off' | 'errors' | 'basic' | 'full';
+
+export interface CmdUiEventTraceSetArgs {
+  level?: UiCmdPointerTraceLevel;
+  samplingPercent?: number;
+}
+
+export interface CmdResultUiEventTraceSet {
+  success: boolean;
+  message: string;
+  level?: UiCmdPointerTraceLevel;
+  samplingPercent?: number;
+}
+
+export interface CmdUiImageCreateFromBufferArgs {
+  imageId: number;
+  bufferId: number;
+  label?: string;
+}
+
+export interface CmdResultUiImageCreateFromBuffer {
+  success: boolean;
+  message: string;
+  pending: boolean;
+}
+
+export interface CmdUiImageDisposeArgs {
+  imageId: number;
+}
+
+export interface CmdResultUiImageDispose {
+  success: boolean;
+  message: string;
+}
+
+export interface CmdUiClipboardPasteArgs {
+  windowId: number;
+  text: string;
+}
+
+export interface CmdUiScreenshotReplyArgs {
+  windowId: number;
+  realmId?: number;
+  width: number;
+  height: number;
+  rgba: number[];
+}
+
+export interface CmdUiAccessKitActionRequestArgs {
+  windowId: number;
+  realmId?: number;
+  action: string;
+}
+
+export interface CmdResultUiInputEvent {
+  success: boolean;
+  message: string;
+}

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 };