@vulfram/engine 0.14.8-alpha → 0.19.2-alpha

package/src/types/events/system.ts

@@ -1,42 +1,200 @@
-/** Payload for notification system events. */
-export interface SystemEventOnNotificationData {
-  id: string;
-}
+import type { CursorGrabMode } from '../kinds';
 
-/** Payload for async texture decode completion. */
-export interface SystemEventTextureReadyData {
-  window_id: number;
-  texture_id: number;
-  success: boolean;
-  message: string;
-}
+export type PointerTraceLevel = 'off' | 'errors' | 'basic' | 'full';
 
-/** Payload for async audio decode completion. */
-export interface SystemEventAudioReadyData {
-  resource_id: number;
-  success: boolean;
-  message: string;
-}
+export type UiViewportClass = 'root' | 'deferred' | 'immediate' | 'embedded';
 
-/** Payload for audio stream progress. */
-export interface SystemEventAudioStreamProgressData {
-  resource_id: number;
-  received_bytes: number;
-  total_bytes: number;
-  complete: boolean;
-}
+export type UiViewportCommand =
+  | { type: 'close' }
+  | { type: 'title'; content: { title: string } }
+  | { type: 'inner-size'; content: { width: number; height: number } }
+  | { type: 'outer-position'; content: { x: number; y: number } }
+  | { type: 'resizable'; content: { value: boolean } }
+  | { type: 'decorations'; content: { value: boolean } }
+  | { type: 'fullscreen'; content: { value: boolean } }
+  | { type: 'minimized'; content: { value: boolean } }
+  | { type: 'maximized'; content: { value: boolean } }
+  | { type: 'focus' }
+  | { type: 'screenshot' }
+  | { type: 'cursor-visible'; content: { value: boolean } }
+  | { type: 'cursor-grab'; content: { mode: CursorGrabMode } }
+  | { type: 'ime-allowed'; content: { value: boolean } }
+  | {
+      type: 'ime-rect';
+      content: { minX: number; minY: number; maxX: number; maxY: number };
+    };
 
-/** Discriminated union of system-level events. */
 export type SystemEvent =
+  | {
+      event: 'error';
+      data: {
+        scope: string;
+        message: string;
+        commandId?: number;
+        commandType?: string;
+      };
+    }
+  | {
+      event: 'command-deferred';
+      data: {
+        commandId: number;
+        commandType: string;
+        attempts: number;
+        reason: string;
+      };
+    }
+  | {
+      event: 'command-applied';
+      data: {
+        commandId: number;
+        commandType: string;
+        attempts: number;
+      };
+    }
+  | {
+      event: 'command-dropped';
+      data: {
+        commandId: number;
+        commandType: string;
+        attempts: number;
+        reason: string;
+      };
+    }
   | { event: 'on-resume' }
   | { event: 'on-suspend' }
   | { event: 'on-memory-warning' }
   | { event: 'on-exit' }
-  | { event: 'on-notification-clicked'; data: SystemEventOnNotificationData }
-  | { event: 'on-notification-dismissed'; data: SystemEventOnNotificationData }
-  | { event: 'texture-ready'; data: SystemEventTextureReadyData }
-  | { event: 'audio-ready'; data: SystemEventAudioReadyData }
+  | { event: 'on-notification-clicked'; data: { id: string } }
+  | { event: 'on-notification-dismissed'; data: { id: string } }
+  | {
+      event: 'texture-ready';
+      data: { windowId: number; textureId: number; success: boolean; message: string };
+    }
+  | {
+      event: 'texture-processing-started';
+      data: { windowId: number; textureId: number; totalBytes: number };
+    }
+  | {
+      event: 'texture-processing-progress';
+      data: {
+        windowId: number;
+        textureId: number;
+        processedBytes: number;
+        totalBytes: number;
+      };
+    }
+  | {
+      event: 'texture-processing-finished';
+      data: {
+        windowId: number;
+        textureId: number;
+        success: boolean;
+        message: string;
+        totalBytes: number;
+      };
+    }
+  | {
+      event: 'ui-image-ready';
+      data: { imageId: number; success: boolean; message: string };
+    }
+  | {
+      event: 'ui-image-processing-started';
+      data: { imageId: number; totalBytes: number };
+    }
+  | {
+      event: 'ui-image-processing-progress';
+      data: { imageId: number; processedBytes: number; totalBytes: number };
+    }
+  | {
+      event: 'ui-image-processing-finished';
+      data: {
+        imageId: number;
+        success: boolean;
+        message: string;
+        totalBytes: number;
+      };
+    }
+  | {
+      event: 'audio-ready';
+      data: { resourceId: number; success: boolean; message: string };
+    }
   | {
       event: 'audio-stream-progress';
-      data: SystemEventAudioStreamProgressData;
+      data: {
+        resourceId: number;
+        receivedBytes: number;
+        totalBytes: number;
+        complete: boolean;
+      };
+    }
+  | {
+      event: 'ui-open-url';
+      data: { windowId: number; realmId: number; url: string; newTab: boolean };
+    }
+  | {
+      event: 'ui-clipboard-set-text';
+      data: { windowId: number; realmId: number; text: string };
+    }
+  | {
+      event: 'ui-clipboard-request-copy';
+      data: { windowId: number; realmId: number };
+    }
+  | {
+      event: 'ui-clipboard-request-cut';
+      data: { windowId: number; realmId: number };
+    }
+  | {
+      event: 'ui-clipboard-request-paste';
+      data: { windowId: number; realmId: number };
+    }
+  | {
+      event: 'ui-screenshot-request';
+      data: { windowId: number; realmId: number };
+    }
+  | {
+      event: 'ui-viewport-sync';
+      data: {
+        windowId: number;
+        realmId: number;
+        viewportId: number;
+        parentViewportId?: number;
+        class: UiViewportClass;
+        title?: string;
+      };
+    }
+  | {
+      event: 'ui-viewport-command';
+      data: {
+        windowId: number;
+        realmId: number;
+        viewportId: number;
+        command: UiViewportCommand;
+      };
+    }
+  | {
+      event: 'ui-viewport-fallback-embedded';
+      data: {
+        windowId: number;
+        realmId: number;
+        viewportId: number;
+        parentViewportId?: number;
+      };
+    }
+  | {
+      event: 'input-target-listener-event';
+      data: {
+        listenerId: number;
+        targetId: number;
+        eventType: string;
+        windowId?: number;
+        windowWidth?: number;
+        windowHeight?: number;
+        pointerId?: number;
+        positionGlobal?: [number, number];
+        positionTarget?: [number, number];
+        targetWidth?: number;
+        targetHeight?: number;
+        keyCode?: number;
+        keyState?: 'pressed' | 'released';
+      };
     };

package/src/types/events/ui.ts

@@ -0,0 +1,21 @@
+export type UiEventKind =
+  | 'click'
+  | 'double-click'
+  | 'pressed'
+  | 'released'
+  | 'hover-enter'
+  | 'hover-leave'
+  | 'changed'
+  | 'change-commit'
+  | 'focus'
+  | 'blur'
+  | 'submit'
+  | 'anim-complete';
+
+export interface UiEvent {
+  realmId: number;
+  documentId: number;
+  nodeId: number;
+  kind: UiEventKind;
+  label?: string;
+}

package/src/types/index.ts

@@ -1,3 +1,4 @@
 export * from './kinds';
+export * from './json';
 export * from './cmds';
 export * from './events';

package/src/types/json.ts

@@ -0,0 +1,15 @@
+/**
+ * JSON-like values that are safe to serialize across the host/core boundary.
+ */
+export type JsonValue =
+  | null
+  | boolean
+  | number
+  | string
+  | JsonValue[]
+  | { [key: string]: JsonValue };
+
+/**
+ * Convenience alias for object-shaped JSON payloads.
+ */
+export type JsonObject = { [key: string]: JsonValue };

package/src/window.ts

@@ -0,0 +1,8 @@
+export {
+  closeWindow,
+  createWindow,
+  focusWindow,
+  requestAttention,
+  updateWindow,
+} from './engine/window/manager';
+export type { WindowId } from './engine/world/types';

package/src/world-ui.ts

@@ -0,0 +1,2 @@
+export * from './engine/world/world-ui';
+export type { EntityId, TargetId, WorldId, WorldUIId } from './engine/world/types';

package/src/world3d.ts

@@ -0,0 +1,10 @@
+export * from './engine/world/world3d';
+export type {
+  EntityId,
+  GeometryId,
+  MaterialId,
+  TargetId,
+  TextureId,
+  World3DId,
+  WorldId,
+} from './engine/world/types';

package/tsconfig.json

@@ -1,29 +0,0 @@
-{
-  "compilerOptions": {
-    // Environment setup & latest features
-    "lib": ["ESNext"],
-    "target": "ESNext",
-    "module": "Preserve",
-    "moduleDetection": "force",
-    "jsx": "react-jsx",
-    "allowJs": true,
-
-    // Bundler mode
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    // Best practices
-    "strict": true,
-    "skipLibCheck": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-
-    // Some stricter flags (disabled by default)
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
-  }
-}