@vulfram/engine 0.5.8-alpha → 0.17.1-alpha

package/src/types/cmds/model.ts

@@ -1,7 +1,9 @@
+import type { ResourceEntry } from './resources';
+
 /** Command payload for creating a model. */
 export interface CmdModelCreateArgs {
-  windowId: number ;
-  modelId: number ;
+  realmId: number;
+  modelId: number;
   label?: string;
   geometryId: number;
   materialId?: number;
@@ -9,18 +11,14 @@ export interface CmdModelCreateArgs {
   layerMask: number;
   castShadow: boolean;
   receiveShadow: boolean;
-}
-
-/** Result payload for model create. */
-export interface CmdResultModelCreate {
-  success: boolean;
-  message: string;
+  castOutline: boolean;
+  outlineColor: [number, number, number, number];
 }
 
 /** Command payload for updating a model. */
 export interface CmdModelUpdateArgs {
-  windowId: number ;
-  modelId: number ;
+  realmId: number;
+  modelId: number;
   label?: string;
   geometryId?: number;
   materialId?: number;
@@ -28,18 +26,42 @@ export interface CmdModelUpdateArgs {
   layerMask?: number;
   castShadow?: boolean;
   receiveShadow?: boolean;
+  castOutline?: boolean;
+  outlineColor?: [number, number, number, number];
+}
+
+/** Result payload for model upsert. */
+export interface CmdResultModelUpsert {
+  success: boolean;
+  message: string;
 }
 
-/** Result payload for model update. */
-export interface CmdResultModelUpdate {
+/** Upsert payload accepted by the core (`create` or `update`). */
+export type CmdModelUpsertArgs = CmdModelCreateArgs | CmdModelUpdateArgs;
+
+/** Backward-compatible aliases. */
+export type CmdResultModelCreate = CmdResultModelUpsert;
+export type CmdResultModelUpdate = CmdResultModelUpsert;
+
+/** Command payload for updating a model pose (skinning). */
+export interface CmdPoseUpdateArgs {
+  realmId: number;
+  modelId: number;
+  boneCount: number;
+  matricesBufferId: number;
+  windowId?: number;
+}
+
+/** Result payload for pose update. */
+export interface CmdResultPoseUpdate {
   success: boolean;
   message: string;
 }
 
 /** Command payload for disposing a model. */
 export interface CmdModelDisposeArgs {
-  windowId: number ;
-  modelId: number ;
+  realmId: number;
+  modelId: number;
 }
 
 /** Result payload for model dispose. */
@@ -49,11 +71,13 @@ export interface CmdResultModelDispose {
 }
 
 /** Command payload for listing models. */
-export interface CmdModelListArgs {}
+export interface CmdModelListArgs {
+  windowId: number;
+}
 
 /** Result payload for model list. */
 export interface CmdResultModelList {
   success: boolean;
   message: string;
-  content: number[]; // List of model IDs
+  models: ResourceEntry[];
 }

package/src/types/cmds/realm.ts

@@ -0,0 +1,25 @@
+export type RealmKind = 'three-d' | 'two-d';
+
+export interface CmdRealmCreateArgs {
+  kind: RealmKind;
+  outputSurfaceId?: number;
+  hostWindowId?: number;
+  importance?: number;
+  cachePolicy?: number;
+  flags?: number;
+}
+
+export interface CmdResultRealmCreate {
+  success: boolean;
+  message: string;
+  realmId?: number;
+}
+
+export interface CmdRealmDisposeArgs {
+  realmId: number;
+}
+
+export interface CmdResultRealmDispose {
+  success: boolean;
+  message: string;
+}

package/src/types/cmds/render-graph.ts

@@ -0,0 +1,49 @@
+export type LogicalId = string | number;
+
+export type RenderGraphResourceKind = 'texture' | 'buffer' | 'attachment';
+
+export type RenderGraphLifetime = 'frame' | 'persistent';
+
+export type RenderGraphEdgeReason = 'read-after-write' | 'write-after-read';
+
+export type RenderGraphValue = boolean | number | string;
+
+export interface RenderGraphResource {
+  resId: LogicalId;
+  kind?: RenderGraphResourceKind;
+  lifetime?: RenderGraphLifetime;
+  aliasGroup?: LogicalId | null;
+}
+
+export interface RenderGraphNode {
+  nodeId: LogicalId;
+  passId: string;
+  inputs?: LogicalId[];
+  outputs?: LogicalId[];
+  params?: Record<string, RenderGraphValue>;
+}
+
+export interface RenderGraphEdge {
+  fromNodeId: LogicalId;
+  toNodeId: LogicalId;
+  reason?: RenderGraphEdgeReason;
+}
+
+export interface RenderGraphDesc {
+  graphId: LogicalId;
+  nodes: RenderGraphNode[];
+  edges: RenderGraphEdge[];
+  resources?: RenderGraphResource[];
+  fallback?: boolean;
+}
+
+export interface CmdRenderGraphSetArgs {
+  windowId: number;
+  graph: RenderGraphDesc;
+}
+
+export interface CmdResultRenderGraphSet {
+  success: boolean;
+  fallbackUsed: boolean;
+  message: string;
+}

package/src/types/cmds/resources.ts

@@ -0,0 +1,4 @@
+export interface ResourceEntry {
+  id: number;
+  label: string | null;
+}

package/src/types/cmds/shadow.ts

@@ -1,12 +1,12 @@
 /** Shadow rendering configuration. */
 export interface ShadowConfig {
-  tileResolution: number;
-  atlasTilesW: number;
-  atlasTilesH: number;
-  atlasLayers: number;
-  virtualGridSize: number;
-  smoothing: number;
-  normalBias: number;
+  tileResolution?: number;
+  atlasTilesW?: number;
+  atlasTilesH?: number;
+  atlasLayers?: number;
+  virtualGridSize?: number;
+  smoothing?: number;
+  normalBias?: number;
 }
 
 /** Command payload for shadow configuration. */

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;
@@ -13,3 +16,29 @@ export interface CmdNotificationSendArgs {
 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 {}
+
+/** Result payload for upload discard all. */
+export interface CmdResultUploadBufferDiscardAll {
+  success: boolean;
+  discardedCount: number;
+  message: string;
+}

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

@@ -1,4 +1,5 @@
 import type { TextureCreateMode } from '../kinds';
+import type { ResourceEntry } from './resources';
 
 /** Options for forward atlas texture packing. */
 export interface ForwardAtlasOptions {
@@ -8,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;
@@ -21,11 +21,11 @@ export interface CmdTextureCreateFromBufferArgs {
 export interface CmdResultTextureCreateFromBuffer {
   success: boolean;
   message: string;
+  pending: boolean;
 }
 
 /** Command payload for creating a solid color texture. */
 export interface CmdTextureCreateSolidColorArgs {
-  windowId: number;
   textureId: number;
   label?: string;
   color: [number, number, number, number];
@@ -42,7 +42,6 @@ export interface CmdResultTextureCreateSolidColor {
 
 /** Command payload for disposing a texture. */
 export interface CmdTextureDisposeArgs {
-  windowId: number;
   textureId: number;
 }
 
@@ -52,12 +51,27 @@ 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 {}
+export interface CmdTextureListArgs {
+  windowId: number;
+}
 
 /** Result payload for texture list. */
 export interface CmdResultTextureList {
   success: boolean;
   message: string;
-  content: number[]; // List of texture IDs
+  textures: ResourceEntry[];
 }

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