@vulfram/engine 0.5.6-alpha

package/src/types/events/system.ts

@@ -0,0 +1,13 @@
+/** Payload for notification system events. */
+export interface SystemEventOnNotificationData {
+  id: string;
+}
+
+/** Discriminated union of system-level events. */
+export type SystemEvent =
+  | { 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 };

package/src/types/events/window.ts

@@ -0,0 +1,96 @@
+/** Payload for window create event. */
+export interface WindowEventOnCreateData {
+  windowId: number;
+}
+
+/** Payload for window resize event. */
+export interface WindowEventOnResizeData {
+  windowId: number;
+  width: number;
+  height: number;
+}
+
+/** Payload for window move event. */
+export interface WindowEventOnMoveData {
+  windowId: number;
+  position: [number, number];
+}
+
+/** Payload for window close request event. */
+export interface WindowEventOnCloseRequestData {
+  windowId: number;
+}
+
+/** Payload for window destroy event. */
+export interface WindowEventOnDestroyData {
+  windowId: number;
+}
+
+/** Payload for window focus event. */
+export interface WindowEventOnFocusData {
+  windowId: number;
+  focused: boolean;
+}
+
+/** Payload for window scale factor change event. */
+export interface WindowEventOnScaleFactorChangeData {
+  windowId: number;
+  scaleFactor: number;
+  newWidth: number;
+  newHeight: number;
+}
+
+/** Payload for window occlusion event. */
+export interface WindowEventOnOccludeData {
+  windowId: number;
+  occluded: boolean;
+}
+
+/** Payload for window redraw request event. */
+export interface WindowEventOnRedrawRequestData {
+  windowId: number;
+}
+
+/** Payload for file drop event. */
+export interface WindowEventOnFileDropData {
+  windowId: number;
+  path: string;
+  position: [number, number];
+}
+
+/** Payload for file hover event. */
+export interface WindowEventOnFileHoverData {
+  windowId: number;
+  path: string;
+  position: [number, number];
+}
+
+/** Payload for file hover cancel event. */
+export interface WindowEventOnFileHoverCancelData {
+  windowId: number;
+}
+
+/** Payload for theme change event. */
+export interface WindowEventOnThemeChangeData {
+  windowId: number;
+  darkMode: boolean;
+}
+
+/** Discriminated union of window events. */
+export type WindowEvent =
+  | { event: 'on-create'; data: WindowEventOnCreateData }
+  | { event: 'on-resize'; data: WindowEventOnResizeData }
+  | { event: 'on-move'; data: WindowEventOnMoveData }
+  | { event: 'on-close-request'; data: WindowEventOnCloseRequestData }
+  | { event: 'on-destroy'; data: WindowEventOnDestroyData }
+  | { event: 'on-focus'; data: WindowEventOnFocusData }
+  | {
+      event: 'on-scale-factor-change';
+      data: WindowEventOnScaleFactorChangeData;
+    }
+  | { event: 'on-occlude'; data: WindowEventOnOccludeData }
+  | { event: 'on-redraw-request'; data: WindowEventOnRedrawRequestData }
+  | { event: 'on-file-drop'; data: WindowEventOnFileDropData }
+  | { event: 'on-file-hover'; data: WindowEventOnFileHoverData }
+  | { event: 'on-file-hover-cancel'; data: WindowEventOnFileHoverCancelData }
+  | { event: 'on-theme-change'; data: WindowEventOnThemeChangeData };

package/src/types/index.ts

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

package/src/types/kinds.ts

@@ -0,0 +1,111 @@
+/** Camera projection mode. */
+export type CameraKind = 'perspective' | 'orthographic';
+
+/** Standard cursor icons. */
+export type CursorIcon =
+  | 'default'
+  | 'context-menu'
+  | 'help'
+  | 'pointer'
+  | 'progress'
+  | 'wait'
+  | 'cell'
+  | 'crosshair'
+  | 'text'
+  | 'vertical-text'
+  | 'alias'
+  | 'copy'
+  | 'move'
+  | 'no-drop'
+  | 'not-allowed'
+  | 'grab'
+  | 'grabbing'
+  | 'e-resize'
+  | 'n-resize'
+  | 'ne-resize'
+  | 'nw-resize'
+  | 's-resize'
+  | 'se-resize'
+  | 'sw-resize'
+  | 'w-resize'
+  | 'ew-resize'
+  | 'ns-resize'
+  | 'nesw-resize'
+  | 'nwse-resize'
+  | 'col-resize'
+  | 'row-resize'
+  | 'all-scroll'
+  | 'zoom-in'
+  | 'zoom-out';
+
+/** Press state for input events. */
+export type ElementState = 'released' | 'pressed';
+
+/** Light source type. */
+export type LightKind =
+  | 'directional'
+  | 'point'
+  | 'spot'
+  | 'ambient'
+  | 'hemisphere';
+
+/** Material shading model. */
+export type MaterialKind = 'standard' | 'pbr';
+
+/** Notification severity level. */
+export type NotificationLevel = 'info' | 'warning' | 'error' | 'success';
+
+/** Built-in primitive geometry shapes. */
+export type PrimitiveShape =
+  | 'cube'
+  | 'plane'
+  | 'sphere'
+  | 'cylinder'
+  | 'torus'
+  | 'pyramid';
+
+/** Texture sampler presets. */
+export type SamplerMode =
+  | 'point-clamp'
+  | 'linear-clamp'
+  | 'point-repeat'
+  | 'linear-repeat';
+
+/** Mesh shading model identifier. */
+export type ShadeModel = 'standard' | 'pbr';
+
+/** Texture allocation strategy. */
+export type TextureCreateMode = 'standalone' | 'forward-atlas';
+
+/** Touch interaction phase. */
+export type TouchPhase = 'started' | 'moved' | 'ended' | 'cancelled';
+
+/** Material transparency mode. */
+export type TransparencyMode = 'opaque' | 'masked' | 'transparent';
+
+/** Upload payload types for buffer transfers. */
+export type UploadType =
+  | 'raw'
+  | 'shader-source'
+  | 'geometry-data'
+  | 'vertex-data'
+  | 'index-data'
+  | 'image-data'
+  | 'binary-asset';
+
+/** Skybox rendering mode. */
+export type SkyboxMode = 'none' | 'procedural' | 'cubemap';
+
+/** Window state transitions. */
+export type WindowState =
+  | 'minimized'
+  | 'maximized'
+  | 'windowed'
+  | 'fullscreen'
+  | 'windowed-fullscreen';
+
+/** Cursor grab behavior. */
+export type CursorGrabMode = 'none' | 'confined' | 'locked';
+
+/** User attention request type. */
+export type UserAttentionType = 'critical' | 'informational';

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "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
+  }
+}