@ringozz/godot 0.1.1 → 4.7.1-1

package/README.md

@@ -1,62 +1,62 @@
-# @ringozz/godot
-
-Node-API bindings for the Godot Engine — call Godot classes, value types, and utility functions from JavaScript.
-
-This is the core runtime package. The React layer is a separate package ([`@ringozz/react-godot`](../react-godot/README.md)).
-
-## Installation
-
-```sh
-bun add @ringozz/godot
-```
-
-The package ships no engine binary itself — it auto-selects a platform addon from its optional dependencies on install: `@ringozz/godot-macos-arm64`, `@ringozz/godot-windows-x86_64`, or `@ringozz/godot-web-wasm32` (the WASM build is installed everywhere and used on web). No `project.godot` is required — the engine boots from engine defaults with `res://` = your working directory.
-
-## Usage
-
-The engine is already running when you import — `getGodot()` returns the instance synchronously. Pump frames with `runGodot()`:
-
-```ts
-import { runGodot } from '@ringozz/godot';
-import { Engine } from '@ringozz/godot/Engine';
-import { SceneTree } from '@ringozz/godot/SceneTree';
-
-const tree = Engine.getMainLoop() as SceneTree;
-const root = tree.root;
-
-const label = new Label();
-label.text = 'hello from godot-node';
-root.addChild(label);
-
-const done = runGodot(); // pumps frames until aborted
-```
-
-### What's exported where
-
-| Specifier | Contents |
-|---|---|
-| `@ringozz/godot` | Value types (`Vector3`, `Color`, …), global enums, heap types, utility functions, global constants, `runGodot()`, RAF polyfills |
-| `@ringozz/godot/ClassName` | Classes, one per module — e.g. `@ringozz/godot/Label`, `@ringozz/godot/Node` |
-| `@ringozz/godot/runtime` | Low-level dispatch: `_C`, `_S`, `_get`, `_set`, `_R`, `_G`, `_P`, `getGodot`, `GodotVar` |
-| `@ringozz/godot/debug` | `initDebug()`, `dumpStr`, `dumpTreeStr`, `statsStr`, `gc` |
-
-Class-scoped enums use bare names (import `ProcessMode` from `@ringozz/godot/Node`, not `NodeProcessMode`).
-
-### Debugging
-
-```ts
-import { initDebug } from '@ringozz/godot/debug';
-initDebug();
-// singletons + helpers now on globalThis.$: $.Engine, $.dumpTreeStr(root), $.statsStr(), $.gc()
-```
-
-`initDebug` also registers an `uncaughtException` handler that keeps the process alive, and adds `getBoundingClientRect()` to `CanvasItem`/`Node3D`.
-
-## Notes
-
-- **Memory**: non-RefCounted objects (`Node`, `Node2D`, `Node3D`, …) must call `free()` explicitly. RefCounted objects are managed by Godot's ref counting; calling `free()` clears the JS wrapper (decrements the ref).
-- **Class-registration tree-shaking**: `ClassDB.instantiate('X')` requires the JS class to be value-imported (`import { Label } from '@ringozz/godot/Label'`). If a class is only type-used (e.g. `as Label` casts), bundlers may drop its registration side effect, and wrappers fall back to an ancestor class. Render through JSX is unaffected. Workaround: keep a value reference (`void Label;`).
-
-## Development
-
-`gen/` is generated (and gitignored) by `dev/codegen.ts` from `godot --dump-extension-api-with-docs`. Regenerate + typecheck with `bun run prebuild`. Build the native addon with `bun run build`. See [`AGENTS.md`](../../AGENTS.md) for the full workflow.
+# @ringozz/godot
+
+Node-API bindings for the Godot Engine — call Godot classes, value types, and utility functions from JavaScript.
+
+This is the core runtime package. The React layer is a separate package ([`@ringozz/react-godot`](../react-godot/README.md)).
+
+## Installation
+
+```sh
+bun add @ringozz/godot
+```
+
+The package ships no engine binary itself — it auto-selects a platform addon from its optional dependencies on install: `@ringozz/godot-macos-arm64`, `@ringozz/godot-windows-x86_64`, or `@ringozz/godot-web-wasm32` (the WASM build is installed everywhere and used on web). No `project.godot` is required — the engine boots from engine defaults with `res://` = your working directory.
+
+## Usage
+
+The engine is already running when you import — `getGodot()` returns the instance synchronously. Pump frames with `runGodot()`:
+
+```ts
+import { runGodot } from '@ringozz/godot';
+import { Engine } from '@ringozz/godot/Engine';
+import { SceneTree } from '@ringozz/godot/SceneTree';
+
+const tree = Engine.getMainLoop() as SceneTree;
+const root = tree.root;
+
+const label = new Label();
+label.text = 'hello from godot-node';
+root.addChild(label);
+
+const done = runGodot(); // pumps frames until aborted
+```
+
+### What's exported where
+
+| Specifier | Contents |
+|---|---|
+| `@ringozz/godot` | Value types (`Vector3`, `Color`, …), global enums, heap types, utility functions, global constants, `runGodot()`, RAF polyfills |
+| `@ringozz/godot/ClassName` | Classes, one per module — e.g. `@ringozz/godot/Label`, `@ringozz/godot/Node` |
+| `@ringozz/godot/runtime` | Low-level dispatch: `_C`, `_S`, `_get`, `_set`, `_R`, `_G`, `_P`, `getGodot`, `GodotVar` |
+| `@ringozz/godot/debug` | `initDebug()`, `dumpStr`, `dumpTreeStr`, `statsStr`, `gc` |
+
+Class-scoped enums use bare names (import `ProcessMode` from `@ringozz/godot/Node`, not `NodeProcessMode`).
+
+### Debugging
+
+```ts
+import { initDebug } from '@ringozz/godot/debug';
+initDebug();
+// singletons + helpers now on globalThis.$: $.Engine, $.dumpTreeStr(root), $.statsStr(), $.gc()
+```
+
+`initDebug` also registers an `uncaughtException` handler that keeps the process alive, and adds `getBoundingClientRect()` to `CanvasItem`/`Node3D`.
+
+## Notes
+
+- **Memory**: non-RefCounted objects (`Node`, `Node2D`, `Node3D`, …) must call `free()` explicitly. RefCounted objects are managed by Godot's ref counting; calling `free()` clears the JS wrapper (decrements the ref).
+- **Class-registration tree-shaking**: `ClassDB.instantiate('X')` requires the JS class to be value-imported (`import { Label } from '@ringozz/godot/Label'`). If a class is only type-used (e.g. `as Label` casts), bundlers may drop its registration side effect, and wrappers fall back to an ancestor class. Render through JSX is unaffected. Workaround: keep a value reference (`void Label;`).
+
+## Development
+
+`gen/` is generated (and gitignored) by `dev/codegen.ts` from `godot --dump-extension-api-with-docs`. Regenerate + typecheck with `bun run prebuild`. Build the native addon with `bun run build`. See [`AGENTS.md`](../../AGENTS.md) for the full workflow.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ringozz/godot",
   "author": "Vladimir Davidovich",
-  "version": "0.1.1",
+  "version": "4.7.1-1",
   "description": "Node-API bindings for Godot Engine — call Godot classes from JavaScript",
   "type": "module",
   "main": "./src/index.ts",
@@ -27,8 +27,8 @@
     "precision": "single"
   },
   "optionalDependencies": {
-    "@ringozz/godot-macos-arm64": "^0.1.0",
-    "@ringozz/godot-windows-x86_64": "^0.1.0",
-    "@ringozz/godot-web-wasm32": "^0.1.0"
+    "@ringozz/godot-macos-arm64": "^4.7.1-1",
+    "@ringozz/godot-windows-x86_64": "^4.7.1-1",
+    "@ringozz/godot-web-wasm32": "^4.7.1-2"
   }
 }

package/src/debug.ts

@@ -1,219 +1,219 @@
-/**********************************************************************
- Copyright (c) Vladimir Davidovich. All rights reserved.
-***********************************************************************/
-
-import { Rect2, Vector3 } from './index.ts';
-import { CanvasItem } from '../gen/classes/CanvasItem.ts';
-import { ClassDB } from '../gen/classes/ClassDB.ts';
-import { Control } from '../gen/classes/Control.ts';
-import { DisplayServer } from '../gen/classes/DisplayServer.ts';
-import { Engine } from '../gen/classes/Engine.ts';
-import { Node } from '../gen/classes/Node.ts';
-import { Node3D } from '../gen/classes/Node3D.ts';
-import { OS } from '../gen/classes/OS.ts';
-import { Time } from '../gen/classes/Time.ts';
-
-/**
- * Dump a Godot object's properties as an indented string.
- * Uses `getPropertyList()` + `get()` to safely introspect — never invokes JS getters.
- *
- * @param obj - Any Godot wrapper (Node, Resource, etc.) or plain value
- * @param depth - Max recursion depth into sub-objects (default 2)
- * @param maxProps - Max properties to show per object (default 30)
- */
-export function dumpStr(obj: unknown, depth = 2, maxProps = 30): string {
-  if (obj == null || typeof obj !== 'object') return String(obj);
-  let cls: string;
-  try { cls = (obj as any).getClass?.(); } catch { cls = (obj as any).constructor?.name ?? typeof obj; }
-  if (!cls) return String(obj);
-  const lines = [`[${cls}]`];
-  let count = 0;
-  try {
-    const plist = (obj as any).getPropertyList?.();
-    if (plist?.size) {
-      for (let i = 0; i < plist.size() && count < maxProps; i++) {
-        const name = plist.get(i).get('name');
-        if (!name || (name + '').startsWith('_')) continue;
-        let val: unknown;
-        try { val = (obj as any).get(name); } catch { val = '<err>'; }
-        if (typeof val === 'object' && val !== null && depth > 1)
-          lines.push(`  ${name}:\n${indent(dumpStr(val, depth - 1, maxProps), '    ')}`);
-        else
-          lines.push(`  ${name}: ${String(val)}`);
-        count++;
-      }
-    }
-  } catch { /* not a GodotVar */ }
-  return lines.join('\n');
-}
-
-function indent(s: string, prefix: string): string { return s.split('\n').join('\n' + prefix); }
-
-/**
- * Serialize a scene subtree as a tree-formatted string.
- *
- * @param node - Root node to start from
- * @param depth - Max depth (default 99)
- */
-export function dumpTreeStr(node: Node, depth = 99): string {
-  const lines: string[] = [];
-  (function walk(n: Node, d: number, ind: string) {
-    if (d <= 0) return;
-    lines.push(`${ind}${n.getClass()} "${n.name}" (${n.getChildCount()} children)`);
-    for (let i = 0; i < n.getChildCount(); i++) {
-      const c = n.getChild(i);
-      if (c) walk(c as Node, d - 1, ind + '  ');
-    }
-  })(node, depth, '');
-  return lines.join('\n');
-}
-
-/**
- * Return a snapshot of engine runtime stats as a formatted string.
- *
- * Includes process frames, FPS, physics frames, node count, time scale,
- * and main-loop class.
- */
-export function statsStr(): string {
-  const tree = Engine.getMainLoop() as any;
-  return [
-    `Frames:     ${Engine.getProcessFrames()}`,
-    `FPS:        ${Engine.getFramesPerSecond()}`,
-    `Physics:    ${Engine.getPhysicsFrames()}`,
-    `Nodes:      ${tree.getNodeCount()}`,
-    `Time scale: ${Engine.timeScale}`,
-    `Main loop:  ${Engine.getMainLoop().getClass()}`,
-  ].join('\n');
-}
-
-/**
- * Run `gc()` and report how much heap was freed.
- * Requires the `--expose-gc` Node.js flag.
- */
-export function gc(): string {
-  const before = process.memoryUsage().heapUsed;
-  if (typeof Bun !== 'undefined')
-    Bun.gc(true);
-  else if (globalThis.gc)
-    globalThis.gc({ type: 'major', execution: 'sync' });
-  else
-    return 'gc() unavailable — need --expose-gc';
-
-  const after = process.memoryUsage().heapUsed;
-  return `GC: freed ${((before - after) / 1024).toFixed(0)} KB`;
-}
-
-/**
- * Bootstrap the debugging environment.
- *
- * - Exposes common singletons (`Engine`, `OS`, `ClassDB`, `Time`) and all
- *   debug utility functions on `globalThis.$` so they're reachable from
- *   breakpoints in any module.
- * - Registers an `uncaughtException` handler that logs but keeps the process
- *   alive for interactive debugging.
- */
-export function initDebug(): void {
-  globalThis.process?.on('uncaughtException', (err, origin) => {
-    console.error(`\n✗ ${origin}:`, err.stack);
-  });
-
-  Object.defineProperty(CanvasItem.prototype, 'getBoundingClientRect', {
-    configurable: true,
-    value(this: CanvasItem): DOMRect | null {
-      const scale = DisplayServer.screenGetScale();
-      if (this instanceof Control) {
-        const rc = (this as Control).getGlobalRect();
-        return new DOMRect(
-          rc.position.x / scale, rc.position.y / scale,
-          rc.size.x / scale, rc.size.y / scale,
-        );
-      }
-
-      if (typeof (this as any).getRect !== 'function') return null;
-
-      const rect = (this as any).getRect() as Rect2;
-      const t = this.getScreenTransform();
-
-      const pos = rect.position;
-      const sz = rect.size;
-      const tx = t.x;
-      const ty = t.y;
-      const to = t.origin;
-
-      const x0 = pos.x, y0 = pos.y;
-      const x1 = x0 + sz.x, y1 = y0 + sz.y;
-      const txx = tx.x, txy = tx.y;
-      const tyx = ty.x, tyy = ty.y;
-      const tox = to.x, toy = to.y;
-
-      let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
-      const accum = (px: number, py: number) => {
-        if (px < minX) minX = px; if (py < minY) minY = py;
-        if (px > maxX) maxX = px; if (py > maxY) maxY = py;
-      };
-
-      accum(txx * x0 + tyx * y0 + tox, txy * x0 + tyy * y0 + toy);
-      accum(txx * x1 + tyx * y0 + tox, txy * x1 + tyy * y0 + toy);
-      accum(txx * x0 + tyx * y1 + tox, txy * x0 + tyy * y1 + toy);
-      accum(txx * x1 + tyx * y1 + tox, txy * x1 + tyy * y1 + toy);
-
-      return new DOMRect(
-        minX / scale, minY / scale,
-        (maxX - minX) / scale, (maxY - minY) / scale,
-      );
-    },
-  });
-
-  Object.defineProperty(Node3D.prototype, 'getBoundingClientRect', {
-    configurable: true,
-    value(this: Node3D): DOMRect | null {
-      if (typeof (this as any).getAabb !== 'function') return null;
-
-      const aabb = (this as any).getAabb();
-      const gt = this.globalTransform;
-      const viewport = this.getViewport();
-      if (!viewport) return null;
-      const camera = viewport.getCamera3d();
-      if (!camera) return null;
-      const scale = DisplayServer.screenGetScale();
-
-      const b = gt.basis;
-      const bx = b.x, by = b.y, bz = b.z;
-      const o = gt.origin;
-      const p = aabb.position, e = aabb.end;
-
-      const [px, py, pz] = [p.x, p.y, p.z];
-      const [ex, ey, ez] = [e.x, e.y, e.z];
-      const [bxx, bxy, bxz] = [bx.x, bx.y, bx.z];
-      const [byx, byy, byz] = [by.x, by.y, by.z];
-      const [bzx, bzy, bzz] = [bz.x, bz.y, bz.z];
-      const [ox, oy, oz] = [o.x, o.y, o.z];
-
-      const corners = [
-        [px, py, pz], [ex, py, pz], [px, ey, pz], [ex, ey, pz],
-        [px, py, ez], [ex, py, ez], [px, ey, ez], [ex, ey, ez],
-      ];
-
-      let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
-
-      for (const [cx, cy, cz] of corners) {
-        const wx = bxx * cx + byx * cy + bzx * cz + ox;
-        const wy = bxy * cx + byy * cy + bzy * cz + oy;
-        const wz = bxz * cx + byz * cy + bzz * cz + oz;
-        const s = camera.unprojectPosition(new Vector3(wx, wy, wz));
-        if (s.x < minX) minX = s.x; if (s.y < minY) minY = s.y;
-        if (s.x > maxX) maxX = s.x; if (s.y > maxY) maxY = s.y;
-      }
-
-      return new DOMRect(
-        minX / scale, minY / scale,
-        (maxX - minX) / scale, (maxY - minY) / scale,
-      );
-    },
-  });
-
-  (globalThis as any).$ = {
-    Engine, OS, ClassDB, Time,
-    dumpStr, dumpTreeStr, statsStr, gc,
-  };
-}
+/**********************************************************************
+ Copyright (c) Vladimir Davidovich. All rights reserved.
+***********************************************************************/
+
+import { Rect2, Vector3 } from './index.ts';
+import { CanvasItem } from '../gen/classes/CanvasItem.ts';
+import { ClassDB } from '../gen/classes/ClassDB.ts';
+import { Control } from '../gen/classes/Control.ts';
+import { DisplayServer } from '../gen/classes/DisplayServer.ts';
+import { Engine } from '../gen/classes/Engine.ts';
+import { Node } from '../gen/classes/Node.ts';
+import { Node3D } from '../gen/classes/Node3D.ts';
+import { OS } from '../gen/classes/OS.ts';
+import { Time } from '../gen/classes/Time.ts';
+
+/**
+ * Dump a Godot object's properties as an indented string.
+ * Uses `getPropertyList()` + `get()` to safely introspect — never invokes JS getters.
+ *
+ * @param obj - Any Godot wrapper (Node, Resource, etc.) or plain value
+ * @param depth - Max recursion depth into sub-objects (default 2)
+ * @param maxProps - Max properties to show per object (default 30)
+ */
+export function dumpStr(obj: unknown, depth = 2, maxProps = 30): string {
+  if (obj == null || typeof obj !== 'object') return String(obj);
+  let cls: string;
+  try { cls = (obj as any).getClass?.(); } catch { cls = (obj as any).constructor?.name ?? typeof obj; }
+  if (!cls) return String(obj);
+  const lines = [`[${cls}]`];
+  let count = 0;
+  try {
+    const plist = (obj as any).getPropertyList?.();
+    if (plist?.size) {
+      for (let i = 0; i < plist.size() && count < maxProps; i++) {
+        const name = plist.get(i).get('name');
+        if (!name || (name + '').startsWith('_')) continue;
+        let val: unknown;
+        try { val = (obj as any).get(name); } catch { val = '<err>'; }
+        if (typeof val === 'object' && val !== null && depth > 1)
+          lines.push(`  ${name}:\n${indent(dumpStr(val, depth - 1, maxProps), '    ')}`);
+        else
+          lines.push(`  ${name}: ${String(val)}`);
+        count++;
+      }
+    }
+  } catch { /* not a GodotVar */ }
+  return lines.join('\n');
+}
+
+function indent(s: string, prefix: string): string { return s.split('\n').join('\n' + prefix); }
+
+/**
+ * Serialize a scene subtree as a tree-formatted string.
+ *
+ * @param node - Root node to start from
+ * @param depth - Max depth (default 99)
+ */
+export function dumpTreeStr(node: Node, depth = 99): string {
+  const lines: string[] = [];
+  (function walk(n: Node, d: number, ind: string) {
+    if (d <= 0) return;
+    lines.push(`${ind}${n.getClass()} "${n.name}" (${n.getChildCount()} children)`);
+    for (let i = 0; i < n.getChildCount(); i++) {
+      const c = n.getChild(i);
+      if (c) walk(c as Node, d - 1, ind + '  ');
+    }
+  })(node, depth, '');
+  return lines.join('\n');
+}
+
+/**
+ * Return a snapshot of engine runtime stats as a formatted string.
+ *
+ * Includes process frames, FPS, physics frames, node count, time scale,
+ * and main-loop class.
+ */
+export function statsStr(): string {
+  const tree = Engine.getMainLoop() as any;
+  return [
+    `Frames:     ${Engine.getProcessFrames()}`,
+    `FPS:        ${Engine.getFramesPerSecond()}`,
+    `Physics:    ${Engine.getPhysicsFrames()}`,
+    `Nodes:      ${tree.getNodeCount()}`,
+    `Time scale: ${Engine.timeScale}`,
+    `Main loop:  ${Engine.getMainLoop().getClass()}`,
+  ].join('\n');
+}
+
+/**
+ * Run `gc()` and report how much heap was freed.
+ * Requires the `--expose-gc` Node.js flag.
+ */
+export function gc(): string {
+  const before = process.memoryUsage().heapUsed;
+  if (typeof Bun !== 'undefined')
+    Bun.gc(true);
+  else if (globalThis.gc)
+    globalThis.gc({ type: 'major', execution: 'sync' });
+  else
+    return 'gc() unavailable — need --expose-gc';
+
+  const after = process.memoryUsage().heapUsed;
+  return `GC: freed ${((before - after) / 1024).toFixed(0)} KB`;
+}
+
+/**
+ * Bootstrap the debugging environment.
+ *
+ * - Exposes common singletons (`Engine`, `OS`, `ClassDB`, `Time`) and all
+ *   debug utility functions on `globalThis.$` so they're reachable from
+ *   breakpoints in any module.
+ * - Registers an `uncaughtException` handler that logs but keeps the process
+ *   alive for interactive debugging.
+ */
+export function initDebug(): void {
+  globalThis.process?.on('uncaughtException', (err, origin) => {
+    console.error(`\n✗ ${origin}:`, err.stack);
+  });
+
+  Object.defineProperty(CanvasItem.prototype, 'getBoundingClientRect', {
+    configurable: true,
+    value(this: CanvasItem): DOMRect | null {
+      const scale = DisplayServer.screenGetScale();
+      if (this instanceof Control) {
+        const rc = (this as Control).getGlobalRect();
+        return new DOMRect(
+          rc.position.x / scale, rc.position.y / scale,
+          rc.size.x / scale, rc.size.y / scale,
+        );
+      }
+
+      if (typeof (this as any).getRect !== 'function') return null;
+
+      const rect = (this as any).getRect() as Rect2;
+      const t = this.getScreenTransform();
+
+      const pos = rect.position;
+      const sz = rect.size;
+      const tx = t.x;
+      const ty = t.y;
+      const to = t.origin;
+
+      const x0 = pos.x, y0 = pos.y;
+      const x1 = x0 + sz.x, y1 = y0 + sz.y;
+      const txx = tx.x, txy = tx.y;
+      const tyx = ty.x, tyy = ty.y;
+      const tox = to.x, toy = to.y;
+
+      let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+      const accum = (px: number, py: number) => {
+        if (px < minX) minX = px; if (py < minY) minY = py;
+        if (px > maxX) maxX = px; if (py > maxY) maxY = py;
+      };
+
+      accum(txx * x0 + tyx * y0 + tox, txy * x0 + tyy * y0 + toy);
+      accum(txx * x1 + tyx * y0 + tox, txy * x1 + tyy * y0 + toy);
+      accum(txx * x0 + tyx * y1 + tox, txy * x0 + tyy * y1 + toy);
+      accum(txx * x1 + tyx * y1 + tox, txy * x1 + tyy * y1 + toy);
+
+      return new DOMRect(
+        minX / scale, minY / scale,
+        (maxX - minX) / scale, (maxY - minY) / scale,
+      );
+    },
+  });
+
+  Object.defineProperty(Node3D.prototype, 'getBoundingClientRect', {
+    configurable: true,
+    value(this: Node3D): DOMRect | null {
+      if (typeof (this as any).getAabb !== 'function') return null;
+
+      const aabb = (this as any).getAabb();
+      const gt = this.globalTransform;
+      const viewport = this.getViewport();
+      if (!viewport) return null;
+      const camera = viewport.getCamera3d();
+      if (!camera) return null;
+      const scale = DisplayServer.screenGetScale();
+
+      const b = gt.basis;
+      const bx = b.x, by = b.y, bz = b.z;
+      const o = gt.origin;
+      const p = aabb.position, e = aabb.end;
+
+      const [px, py, pz] = [p.x, p.y, p.z];
+      const [ex, ey, ez] = [e.x, e.y, e.z];
+      const [bxx, bxy, bxz] = [bx.x, bx.y, bx.z];
+      const [byx, byy, byz] = [by.x, by.y, by.z];
+      const [bzx, bzy, bzz] = [bz.x, bz.y, bz.z];
+      const [ox, oy, oz] = [o.x, o.y, o.z];
+
+      const corners = [
+        [px, py, pz], [ex, py, pz], [px, ey, pz], [ex, ey, pz],
+        [px, py, ez], [ex, py, ez], [px, ey, ez], [ex, ey, ez],
+      ];
+
+      let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+
+      for (const [cx, cy, cz] of corners) {
+        const wx = bxx * cx + byx * cy + bzx * cz + ox;
+        const wy = bxy * cx + byy * cy + bzy * cz + oy;
+        const wz = bxz * cx + byz * cy + bzz * cz + oz;
+        const s = camera.unprojectPosition(new Vector3(wx, wy, wz));
+        if (s.x < minX) minX = s.x; if (s.y < minY) minY = s.y;
+        if (s.x > maxX) maxX = s.x; if (s.y > maxY) maxY = s.y;
+      }
+
+      return new DOMRect(
+        minX / scale, minY / scale,
+        (maxX - minX) / scale, (maxY - minY) / scale,
+      );
+    },
+  });
+
+  (globalThis as any).$ = {
+    Engine, OS, ClassDB, Time,
+    dumpStr, dumpTreeStr, statsStr, gc,
+  };
+}

package/src/index.ts

@@ -1,36 +1,36 @@
-/**********************************************************************
- Copyright (c) Vladimir Davidovich. All rights reserved.
-***********************************************************************/
-
-export * from '../gen/index.ts';
-import { Engine } from '../gen/classes/Engine.ts';
-import { GodotInstance } from '../gen/classes/GodotInstance.ts';
-import { SceneTree } from '../gen/classes/SceneTree.ts';
-import { Window } from '../gen/classes/Window.ts';
-import { gc } from './debug.ts';
-import { cancelAnimationFrame, getGodot, requestAnimationFrame } from './runtime.ts';
-
-// ---- make sure these classes are not tree-shaked ----
-void GodotInstance;
-void SceneTree;
-void Window;
-
-// ---- globalThis browser-compat API ----
-Object.assign(globalThis as any, { requestAnimationFrame, cancelAnimationFrame });
-
-// ---- GodotInstance frame pump (engine already started by C++ InitModule) ----
-export async function runGodot(signal?: AbortSignal, unmount?: () => PromiseLike<void>) {
-    signal?.throwIfAborted();
-    signal?.addEventListener('abort', () => {
-        (Engine.getMainLoop() as SceneTree).quit();
-    }, { once: true });
-
-    const godot = getGodot();
-    while (!godot.iteration())
-        await new Promise(requestAnimationFrame);
-
-    await unmount?.();
-    console.log(gc());
-    return godot.free();
-}
-
+/**********************************************************************
+ Copyright (c) Vladimir Davidovich. All rights reserved.
+***********************************************************************/
+
+export * from '../gen/index.ts';
+import { Engine } from '../gen/classes/Engine.ts';
+import { GodotInstance } from '../gen/classes/GodotInstance.ts';
+import { SceneTree } from '../gen/classes/SceneTree.ts';
+import { Window } from '../gen/classes/Window.ts';
+import { gc } from './debug.ts';
+import { cancelAnimationFrame, getGodot, requestAnimationFrame } from './runtime.ts';
+
+// ---- make sure these classes are not tree-shaked ----
+void GodotInstance;
+void SceneTree;
+void Window;
+
+// ---- globalThis browser-compat API ----
+Object.assign(globalThis as any, { requestAnimationFrame, cancelAnimationFrame });
+
+// ---- GodotInstance frame pump (engine already started by C++ InitModule) ----
+export async function runGodot(signal?: AbortSignal, unmount?: () => PromiseLike<void>) {
+    signal?.throwIfAborted();
+    signal?.addEventListener('abort', () => {
+        (Engine.getMainLoop() as SceneTree).quit();
+    }, { once: true });
+
+    const godot = getGodot();
+    while (!godot.iteration())
+        await new Promise(requestAnimationFrame);
+
+    await unmount?.();
+    console.log(gc());
+    return godot.free();
+}
+

package/src/runtime.ts

@@ -1,69 +1,68 @@
-/**********************************************************************
- Copyright (c) Vladimir Davidovich. All rights reserved.
-***********************************************************************/
-
-const { default: _mod } = await (() => {
-    const { platform, arch } = globalThis.process ?? {};
-    switch (`${platform}-${arch}`) {
-        case 'darwin-arm64': return import('@ringozz/godot-macos-arm64');
-        case 'win32-x64': return import('@ringozz/godot-windows-x86_64');
-        default: return import('@ringozz/godot-web-wasm32');
-    }
-})();
-
-/** Godot instance */
-import type { GodotInstance } from '../gen/classes/GodotInstance.ts';
-export const getGodot = _mod.getGodot as () => GodotInstance;
-
-/** Base constructor for all Godot object wrappers. */
-export interface GodotVar {
-    free(): void;
-}
-export const GodotVar = _mod.GodotVar as (new (...args: unknown[]) => GodotVar) & {
-    assign<T extends GodotVar>(target: T, props: Record<string, unknown>): T;
-};
-
-/** Unified entry point:
- *  - _C(this,    methodId, ...args)    → instance method
- *  - _C(classId, methodId, ...args)    → static method
- *  - _C(null,    methodId, ...args)    → singleton lookup (_getInstance) or internal
- *  - _C(0xHASHn, methodId, ...args)    → utility function (BigInt carries hash + type metadata)
- */
-export const _C = _mod._C as (...args: unknown[]) => unknown;
-
-/** Resolve a string name to its integer handle. */
-export const _S = _mod._S as (name: string) => number;
-
-/** Low-level property getter for value type fields. */
-export const _get = _mod._get as (target: GodotVar, nameId: number) => unknown;
-
-/** Low-level property setter for value type fields. */
-export const _set = _mod._set as (target: GodotVar, nameId: number, val: unknown) => void;
-
-/** Register Godot object wrapper. */
-export const _R = _mod._R as (typeId: number, ctor: Function) => string;
-
-/** Get a Signal value from an Object by signal name, or connect a callback when 3rd arg given. */
-export const _G = _mod._G as (target: GodotVar, signalNameId: number, callback?: unknown) => unknown;
-
-/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DedicatedWorkerGlobalScope/requestAnimationFrame) */
-export const requestAnimationFrame = _mod.requestAnimationFrame as typeof globalThis.requestAnimationFrame ?? globalThis.requestAnimationFrame;
-
-/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DedicatedWorkerGlobalScope/cancelAnimationFrame) */
-export const cancelAnimationFrame = _mod.cancelAnimationFrame as typeof globalThis.cancelAnimationFrame ?? globalThis.cancelAnimationFrame;
-
-/** Make a Signal PromiseLike: connects a one-shot callback that resolves with the args tuple. */
-export function _P(signal: any, onfulfilled?: any, onrejected?: any) {
-    return new Promise<any>((resolve, reject) => {
-        if (signal.isNull()) {
-            reject(new Error('Cannot await a null Signal'));
-            return;
-        }
-        const cb = (...args: any[]) => {
-            signal.disconnect(cb);
-            resolve(args);
-        };
-        const res = signal.connect(cb);
-        if (res !== 0) reject(new Error('Failed to connect signal: error code ' + res));
-    }).then(onfulfilled, onrejected);
-}
+/**********************************************************************
+ Copyright (c) Vladimir Davidovich. All rights reserved.
+***********************************************************************/
+
+const { platform, arch } = globalThis.process ?? {};
+const mapping: any = {
+    'darwin-arm64': 'macos-arm64',
+    'win32-x64': 'windows-x86_64',
+};
+const suffix = mapping[`${platform}-${arch}`];
+const { default: _mod } = await (suffix ? import(`@ringozz/godot-${suffix}`) : import('@ringozz/godot-web-wasm32'));
+
+/** Godot instance */
+import type { GodotInstance } from '../gen/classes/GodotInstance.ts';
+export const getGodot = _mod.getGodot as () => GodotInstance;
+
+/** Base constructor for all Godot object wrappers. */
+export interface GodotVar {
+    free(): void;
+}
+export const GodotVar = _mod.GodotVar as (new (...args: unknown[]) => GodotVar) & {
+    assign<T extends GodotVar>(target: T, props: Record<string, unknown>): T;
+};
+
+/** Unified entry point:
+ *  - _C(this,    methodId, ...args)    → instance method
+ *  - _C(classId, methodId, ...args)    → static method
+ *  - _C(null,    methodId, ...args)    → singleton lookup (_getInstance) or internal
+ *  - _C(0xHASHn, methodId, ...args)    → utility function (BigInt carries hash + type metadata)
+ */
+export const _C = _mod._C as (...args: unknown[]) => unknown;
+
+/** Resolve a string name to its integer handle. */
+export const _S = _mod._S as (name: string) => number;
+
+/** Low-level property getter for value type fields. */
+export const _get = _mod._get as (target: GodotVar, nameId: number) => unknown;
+
+/** Low-level property setter for value type fields. */
+export const _set = _mod._set as (target: GodotVar, nameId: number, val: unknown) => void;
+
+/** Register Godot object wrapper. */
+export const _R = _mod._R as (typeId: number, ctor: Function) => string;
+
+/** Get a Signal value from an Object by signal name, or connect a callback when 3rd arg given. */
+export const _G = _mod._G as (target: GodotVar, signalNameId: number, callback?: unknown) => unknown;
+
+/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DedicatedWorkerGlobalScope/requestAnimationFrame) */
+export const requestAnimationFrame = _mod.requestAnimationFrame as typeof globalThis.requestAnimationFrame ?? globalThis.requestAnimationFrame;
+
+/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DedicatedWorkerGlobalScope/cancelAnimationFrame) */
+export const cancelAnimationFrame = _mod.cancelAnimationFrame as typeof globalThis.cancelAnimationFrame ?? globalThis.cancelAnimationFrame;
+
+/** Make a Signal PromiseLike: connects a one-shot callback that resolves with the args tuple. */
+export function _P(signal: any, onfulfilled?: any, onrejected?: any) {
+    return new Promise<any>((resolve, reject) => {
+        if (signal.isNull()) {
+            reject(new Error('Cannot await a null Signal'));
+            return;
+        }
+        const cb = (...args: any[]) => {
+            signal.disconnect(cb);
+            resolve(args);
+        };
+        const res = signal.connect(cb);
+        if (res !== 0) reject(new Error('Failed to connect signal: error code ' + res));
+    }).then(onfulfilled, onrejected);
+}