goudengine 0.0.827 → 0.0.830

package/index.d.ts

@@ -11,7 +11,101 @@ export declare class Entity {
   display(): string
 }
 
+export declare class GoudContext {
+  constructor(config?: NapiContextConfig | undefined | null)
+  destroy(): boolean
+  isValid(): boolean
+  getNetworkCapabilities(): NapiNetworkCapabilities
+  networkHost(protocol: number, port: number): number
+  networkConnect(protocol: number, address: string, port: number): number
+  networkConnectWithPeer(protocol: number, address: string, port: number): NapiNetworkConnectResult
+  networkDisconnect(handle: number): number
+  networkSend(handle: number, peerId: number, data: Buffer, channel: number): number
+  networkReceive(handle: number): Buffer
+  networkReceivePacket(handle: number): NapiNetworkPacket | null
+  networkPoll(handle: number): number
+  getNetworkStats(handle: number): NapiNetworkStats
+  networkPeerCount(handle: number): number
+  setNetworkSimulation(handle: number, config: NapiNetworkSimulationConfig): number
+  clearNetworkSimulation(handle: number): number
+  setNetworkOverlayHandle(handle: number): number
+  clearNetworkOverlayHandle(): number
+  getDebuggerSnapshotJson(): string
+  getDebuggerManifestJson(): string
+  setDebuggerPaused(paused: boolean): void
+  stepDebugger(kind: number, count: number): void
+  setDebuggerTimeScale(scale: number): void
+  setDebuggerDebugDrawEnabled(enabled: boolean): void
+  injectDebuggerKeyEvent(key: number, pressed: boolean): void
+  injectDebuggerMouseButton(button: number, pressed: boolean): void
+  injectDebuggerMousePosition(position: Vec2): void
+  injectDebuggerScroll(delta: Vec2): void
+  setDebuggerProfilingEnabled(enabled: boolean): void
+  setDebuggerSelectedEntity(entityId: number): void
+  clearDebuggerSelectedEntity(): void
+  getMemorySummary(): NapiMemorySummary
+  captureDebuggerFrame(): string
+  startDebuggerRecording(): void
+  stopDebuggerRecording(): string
+  startDebuggerReplay(recording: Buffer): void
+  stopDebuggerReplay(): void
+  getDebuggerReplayStatusJson(): string
+  getDebuggerMetricsTraceJson(): string
+}
+
 export declare class GoudGame {
+  /** Plays audio from raw bytes on the default channel */
+  audioPlay(data: Buffer): number
+  /** Plays audio from raw bytes on the given channel */
+  audioPlayOnChannel(data: Buffer, channel: number): number
+  /** Plays audio with explicit volume, speed, looping, and channel settings */
+  audioPlayWithSettings(data: Buffer, volume: number, speed: number, looping: boolean, channel: number): number
+  /** Stops a playing audio player */
+  audioStop(playerId: number): number
+  /** Pauses a playing audio player */
+  audioPause(playerId: number): number
+  /** Resumes a paused audio player */
+  audioResume(playerId: number): number
+  /** Stops all active audio players */
+  audioStopAll(): number
+  /** Sets the global audio volume */
+  audioSetGlobalVolume(volume: number): number
+  /** Gets the global audio volume */
+  audioGetGlobalVolume(): number
+  /** Sets the volume for a specific channel */
+  audioSetChannelVolume(channel: number, volume: number): number
+  /** Gets the volume for a specific channel */
+  audioGetChannelVolume(channel: number): number
+  /** Returns non-zero when the player is still playing */
+  audioIsPlaying(playerId: number): number
+  /** Returns the number of active audio players */
+  audioActiveCount(): number
+  /** Cleans up finished audio players */
+  audioCleanupFinished(): number
+  /** Plays audio with 3D spatial attenuation */
+  audioPlaySpatial3d(data: Buffer, sourceX: number, sourceY: number, sourceZ: number, listenerX: number, listenerY: number, listenerZ: number, maxDistance: number, rolloff: number): number
+  /** Updates 3D spatial attenuation for an active player */
+  audioUpdateSpatial3d(playerId: number, sourceX: number, sourceY: number, sourceZ: number, listenerX: number, listenerY: number, listenerZ: number, maxDistance: number, rolloff: number): number
+  /** Sets the 3D listener position */
+  audioSetListenerPosition3d(x: number, y: number, z: number): number
+  /** Sets the 3D source position for an active player */
+  audioSetSourcePosition3d(playerId: number, x: number, y: number, z: number, maxDistance: number, rolloff: number): number
+  /** Sets the volume for an active player */
+  audioSetPlayerVolume(playerId: number, volume: number): number
+  /** Sets the playback speed for an active player */
+  audioSetPlayerSpeed(playerId: number, speed: number): number
+  /** Applies an immediate crossfade mix between two active players */
+  audioCrossfade(fromPlayerId: number, toPlayerId: number, mix: number): number
+  /** Starts a timed crossfade from one player to a new audio asset */
+  audioCrossfadeTo(fromPlayerId: number, data: Buffer, durationSec: number, channel: number): number
+  /** Mixes a secondary audio asset with a primary player */
+  audioMixWith(primaryPlayerId: number, data: Buffer, secondaryVolume: number, secondaryChannel: number): number
+  /** Advances all active timed crossfades */
+  audioUpdateCrossfades(deltaSec: number): number
+  /** Returns the number of active timed crossfades */
+  audioActiveCrossfadeCount(): number
+  /** Activates audio playback on platforms that require user gesture initialization */
+  audioActivate(): number
   constructor(config?: GameConfig | undefined | null)
   shouldClose(): boolean
   close(): void
@@ -20,6 +114,9 @@ export declare class GoudGame {
   endFrame(): void
   loadTexture(path: string): number
   destroyTexture(handle: number): boolean
+  loadFont(path: string): number
+  destroyFont(handle: number): boolean
+  drawText(fontHandle: number, text: string, x: number, y: number, fontSize?: number | undefined | null, alignment?: number | undefined | null, maxWidth?: number | undefined | null, lineSpacing?: number | undefined | null, direction?: number | undefined | null, r?: number | undefined | null, g?: number | undefined | null, b?: number | undefined | null, a?: number | undefined | null): boolean
   drawSprite(texture: number, x: number, y: number, w: number, h: number, rotation?: number | undefined | null, r?: number | undefined | null, g?: number | undefined | null, b?: number | undefined | null, a?: number | undefined | null): boolean
   drawSpriteRect(texture: number, x: number, y: number, w: number, h: number, rotation: number | undefined | null, srcX: number, srcY: number, srcW: number, srcH: number, r?: number | undefined | null, g?: number | undefined | null, b?: number | undefined | null, a?: number | undefined | null): boolean
   drawQuad(x: number, y: number, w: number, h: number, r?: number | undefined | null, g?: number | undefined | null, b?: number | undefined | null, a?: number | undefined | null): boolean
@@ -29,6 +126,52 @@ export declare class GoudGame {
   clearDepth(): void
   disableBlending(): void
   getRenderStats(): NapiRenderStats
+  getFpsStats(): NapiFpsStats
+  setFpsOverlayEnabled(enabled: boolean): void
+  setFpsUpdateInterval(interval: number): void
+  setFpsOverlayCorner(corner: number): void
+  getDebuggerSnapshotJson(): string
+  getDebuggerManifestJson(): string
+  setDebuggerPaused(paused: boolean): void
+  stepDebugger(kind: number, count: number): void
+  setDebuggerTimeScale(scale: number): void
+  setDebuggerDebugDrawEnabled(enabled: boolean): void
+  injectDebuggerKeyEvent(key: number, pressed: boolean): void
+  injectDebuggerMouseButton(button: number, pressed: boolean): void
+  injectDebuggerMousePosition(position: Vec2): void
+  injectDebuggerScroll(delta: Vec2): void
+  setDebuggerProfilingEnabled(enabled: boolean): void
+  setDebuggerSelectedEntity(entityId: number): void
+  clearDebuggerSelectedEntity(): void
+  getMemorySummary(): NapiMemorySummary
+  captureDebuggerFrame(): string
+  startDebuggerRecording(): void
+  stopDebuggerRecording(): string
+  startDebuggerReplay(recording: Buffer): void
+  stopDebuggerReplay(): void
+  getDebuggerReplayStatusJson(): string
+  getDebuggerMetricsTraceJson(): string
+  getRenderCapabilities(): NapiRenderCapabilities
+  getPhysicsCapabilities(): NapiPhysicsCapabilities
+  getAudioCapabilities(): NapiAudioCapabilities
+  getInputCapabilities(): NapiInputCapabilities
+  getNetworkCapabilities(): NapiNetworkCapabilities
+  /** Checks if the hot-swap shortcut (F5) was pressed and cycles render provider. Debug builds only. */
+  checkHotSwapShortcut(): boolean
+  networkHost(protocol: number, port: number): number
+  networkConnect(protocol: number, address: string, port: number): number
+  networkConnectWithPeer(protocol: number, address: string, port: number): NapiNetworkConnectResult
+  networkDisconnect(handle: number): number
+  networkSend(handle: number, peerId: number, data: Buffer, channel: number): number
+  networkReceive(handle: number): Buffer
+  networkReceivePacket(handle: number): NapiNetworkPacket | null
+  networkPoll(handle: number): number
+  getNetworkStats(handle: number): NapiNetworkStats
+  networkPeerCount(handle: number): number
+  setNetworkSimulation(handle: number, config: NapiNetworkSimulationConfig): number
+  clearNetworkSimulation(handle: number): number
+  setNetworkOverlayHandle(handle: number): number
+  clearNetworkOverlayHandle(): number
   isKeyPressed(key: number): boolean
   isKeyJustPressed(key: number): boolean
   isKeyJustReleased(key: number): boolean
@@ -47,6 +190,9 @@ export declare class GoudGame {
   despawn(entity: Entity): boolean
   entityCount(): number
   isAlive(entity: Entity): boolean
+  loadScene(name: string, json: string): number
+  unloadScene(name: string): boolean
+  setActiveScene(sceneId: number, active: boolean): boolean
   addTransform2D(entity: Entity, data: Transform2DData): void
   getTransform2D(entity: Entity): Transform2DData | null
   setTransform2D(entity: Entity, data: Transform2DData): void
@@ -61,6 +207,10 @@ export declare class GoudGame {
   getName(entity: Entity): string | null
   hasName(entity: Entity): boolean
   removeName(entity: Entity): boolean
+  physicsRaycastEx(originX: number, originY: number, dirX: number, dirY: number, maxDist: number, layerMask: number): NapiPhysicsRaycastHit2D | null
+  physicsCollisionEventsCount(): number
+  physicsCollisionEventsRead(index: number): NapiPhysicsCollisionEvent2D | null
+  physicsSetCollisionCallback(callbackPtr: number, userData: number): number
   collisionAabbAabb(caX: number, caY: number, hwA: number, hhA: number, cbX: number, cbY: number, hwB: number, hhB: number): NapiContact | null
   collisionCircleCircle(caX: number, caY: number, ra: number, cbX: number, cbY: number, rb: number): NapiContact | null
   collisionCircleAabb(cx: number, cy: number, cr: number, bx: number, by: number, bhw: number, bhh: number): NapiContact | null
@@ -100,6 +250,113 @@ export declare class GoudGame {
   get contextValid(): boolean
   /** Returns the raw FFI delta time from the last poll_events call. */
   get ffiDeltaTime(): number
+  animationLayerStackCreate(entity: Entity): number
+  animationLayerAdd(entity: Entity, name: string, blendMode: number): number
+  animationLayerSetWeight(entity: Entity, layerIndex: number, weight: number): number
+  animationLayerPlay(entity: Entity, layerIndex: number): number
+  animationLayerSetClip(entity: Entity, layerIndex: number, frameCount: number, frameDuration: number, mode: number): number
+  animationLayerAddFrame(entity: Entity, layerIndex: number, x: number, y: number, w: number, h: number): number
+  animationLayerReset(entity: Entity, layerIndex: number): number
+  animationClipAddEvent(entity: Entity, frameIndex: number, name: string, payloadType: number, payloadInt: number, payloadFloat: number, payloadString?: string | undefined | null): number
+  animationEventsCount(): number
+  animationEventsRead(index: number): NapiAnimationEventData
+}
+
+export declare class NativeEngineConfig {
+  constructor()
+  setTitle(title: string): boolean
+  setSize(width: number, height: number): boolean
+  setVsync(enabled: boolean): boolean
+  setFullscreen(enabled: boolean): boolean
+  setTargetFps(fps: number): boolean
+  setFpsOverlay(enabled: boolean): boolean
+  setPhysicsBackend2D(backend: number): boolean
+  setDebugger(debugger: NapiDebuggerConfig): boolean
+  build(): GoudGame
+  destroy(): void
+}
+
+export declare class NativePhysicsWorld2D {
+  constructor(gravityX: number, gravityY: number, backend?: number | undefined | null)
+  create(gravityX: number, gravityY: number): number
+  createWithBackend(gravityX: number, gravityY: number, backend: number): number
+  destroy(): number
+  setGravity(x: number, y: number): number
+  addRigidBody(bodyType: number, x: number, y: number, gravityScale: number): number
+  addRigidBodyEx(bodyType: number, x: number, y: number, gravityScale: number, ccdEnabled: boolean): number
+  addCollider(bodyHandle: number, shapeType: number, width: number, height: number, radius: number, friction: number, restitution: number): number
+  addColliderEx(bodyHandle: number, shapeType: number, width: number, height: number, radius: number, friction: number, restitution: number, isSensor: boolean, layer: number, mask: number): number
+  removeBody(handle: number): number
+  createJoint(bodyA: number, bodyB: number, kind: number, anchorAx: number, anchorAy: number, anchorBx: number, anchorBy: number, axisX: number, axisY: number, hasLimits: boolean, limitMin: number, limitMax: number, hasMotor: boolean, motorTargetVelocity: number, motorMaxForce: number): number
+  removeJoint(handle: number): number
+  step(dt: number): number
+  getPosition(handle: number): Vec2
+  getVelocity(handle: number): Vec2
+  setVelocity(handle: number, vx: number, vy: number): number
+  applyForce(handle: number, fx: number, fy: number): number
+  applyImpulse(handle: number, ix: number, iy: number): number
+  raycast(originX: number, originY: number, dirX: number, dirY: number, maxDist: number): Vec2
+  raycastEx(originX: number, originY: number, dirX: number, dirY: number, maxDist: number, layerMask: number): NapiPhysicsRaycastHit2D
+  collisionEventsCount(): number
+  collisionEventsRead(index: number): NapiPhysicsCollisionEvent2D
+  collisionEventCount(): number
+  collisionEventRead(index: number): NapiPhysicsCollisionEvent2D
+  setCollisionCallback(callbackPtr: number, userData: number): number
+  getGravity(): Vec2
+  setBodyGravityScale(handle: number, scale: number): number
+  getBodyGravityScale(handle: number): number
+  setColliderFriction(handle: number, friction: number): number
+  getColliderFriction(handle: number): number
+  setColliderRestitution(handle: number, restitution: number): number
+  getColliderRestitution(handle: number): number
+  setTimestep(dt: number): number
+  getTimestep(): number
+}
+
+export declare class NativePhysicsWorld3D {
+  constructor(gravityX: number, gravityY: number, gravityZ: number)
+  create(gravityX: number, gravityY: number, gravityZ: number): number
+  destroy(): number
+  setGravity(x: number, y: number, z: number): number
+  addRigidBody(bodyType: number, x: number, y: number, z: number, gravityScale: number): number
+  addCollider(bodyHandle: number, shapeType: number, width: number, height: number, depth: number, radius: number, friction: number, restitution: number): number
+  removeBody(handle: number): number
+  step(dt: number): number
+  getPosition(handle: number): Vec3
+  setVelocity(handle: number, vx: number, vy: number, vz: number): number
+  applyForce(handle: number, fx: number, fy: number, fz: number): number
+  applyImpulse(handle: number, ix: number, iy: number, iz: number): number
+  getGravity(): Vec3
+  setBodyGravityScale(handle: number, scale: number): number
+  getBodyGravityScale(handle: number): number
+  setColliderFriction(handle: number, friction: number): number
+  getColliderFriction(handle: number): number
+  setColliderRestitution(handle: number, restitution: number): number
+  getColliderRestitution(handle: number): number
+  setTimestep(dt: number): number
+  getTimestep(): number
+}
+
+export declare class UiManager {
+  constructor()
+  destroy(): void
+  update(): void
+  render(): void
+  nodeCount(): number
+  createNode(componentType: number): number
+  removeNode(nodeId: number): number
+  setParent(childId: number, parentId: number): number
+  getParent(nodeId: number): number
+  getChildCount(nodeId: number): number
+  getChildAt(nodeId: number, index: number): number
+  setWidget(nodeId: number, widgetKind: number): number
+  setStyle(nodeId: number, style: NapiUiStyle): number
+  setLabelText(nodeId: number, text: string): number
+  setButtonEnabled(nodeId: number, enabled: boolean): number
+  setImageTexturePath(nodeId: number, path: string): number
+  setSlider(nodeId: number, min: number, max: number, value: number, enabled: boolean): number
+  eventCount(): number
+  eventRead(index: number): NapiUiEvent | null
 }
 
 export interface Color {
@@ -141,6 +398,21 @@ export interface GameConfig {
   height?: number
 }
 
+export interface NapiAnimationEventData {
+  entity: number
+  name: string
+  frameIndex: number
+  payloadType: number
+  payloadInt: number
+  payloadFloat: number
+  payloadString: string
+}
+
+export interface NapiAudioCapabilities {
+  supportsSpatial: boolean
+  maxChannels: number
+}
+
 export interface NapiContact {
   pointX: number
   pointY: number
@@ -149,6 +421,114 @@ export interface NapiContact {
   penetration: number
 }
 
+export interface NapiContextConfig {
+  debugger: NapiDebuggerConfig
+}
+
+export interface NapiDebuggerConfig {
+  enabled: boolean
+  publishLocalAttach: boolean
+  routeLabel: string
+}
+
+export interface NapiFpsStats {
+  currentFps: number
+  minFps: number
+  maxFps: number
+  avgFps: number
+  frameTimeMs: number
+}
+
+export interface NapiInputCapabilities {
+  supportsGamepad: boolean
+  supportsTouch: boolean
+  maxGamepads: number
+}
+
+export interface NapiMemoryCategoryStats {
+  currentBytes: number
+  peakBytes: number
+}
+
+export interface NapiMemorySummary {
+  rendering: NapiMemoryCategoryStats
+  assets: NapiMemoryCategoryStats
+  ecs: NapiMemoryCategoryStats
+  ui: NapiMemoryCategoryStats
+  audio: NapiMemoryCategoryStats
+  network: NapiMemoryCategoryStats
+  debugger: NapiMemoryCategoryStats
+  other: NapiMemoryCategoryStats
+  totalCurrentBytes: number
+  totalPeakBytes: number
+}
+
+export interface NapiNetworkCapabilities {
+  supportsHosting: boolean
+  maxConnections: number
+  maxChannels: number
+  maxMessageSize: number
+}
+
+export interface NapiNetworkConnectResult {
+  handle: number
+  peerId: number
+}
+
+export interface NapiNetworkPacket {
+  peerId: number
+  data: Buffer
+}
+
+export interface NapiNetworkSimulationConfig {
+  oneWayLatencyMs: number
+  jitterMs: number
+  packetLossPercent: number
+}
+
+export interface NapiNetworkStats {
+  bytesSent: number
+  bytesReceived: number
+  packetsSent: number
+  packetsReceived: number
+  packetsLost: number
+  rttMs: number
+  sendBandwidthBytesPerSec: number
+  receiveBandwidthBytesPerSec: number
+  packetLossPercent: number
+  jitterMs: number
+}
+
+export interface NapiPhysicsCapabilities {
+  supportsContinuousCollision: boolean
+  supportsJoints: boolean
+  maxBodies: number
+}
+
+export interface NapiPhysicsCollisionEvent2D {
+  bodyA: number
+  bodyB: number
+  kind: number
+}
+
+export interface NapiPhysicsRaycastHit2D {
+  bodyHandle: number
+  colliderHandle: number
+  pointX: number
+  pointY: number
+  normalX: number
+  normalY: number
+  distance: number
+}
+
+export interface NapiRenderCapabilities {
+  maxTextureUnits: number
+  maxTextureSize: number
+  supportsInstancing: boolean
+  supportsCompute: boolean
+  supportsMsaa: boolean
+}
+
 export interface NapiRenderStats {
   drawCalls: number
   triangles: number
@@ -156,6 +536,31 @@ export interface NapiRenderStats {
   shaderBinds: number
 }
 
+export interface NapiUiColor {
+  r: number
+  g: number
+  b: number
+  a: number
+}
+
+export interface NapiUiEvent {
+  eventKind: number
+  nodeId: number
+  previousNodeId: number
+  currentNodeId: number
+}
+
+export interface NapiUiStyle {
+  backgroundColor?: NapiUiColor
+  foregroundColor?: NapiUiColor
+  borderColor?: NapiUiColor
+  borderWidth?: number
+  fontFamily?: string
+  fontSize?: number
+  texturePath?: string
+  widgetSpacing?: number
+}
+
 export interface Rect {
   x: number
   y: number