@ringozz/godot 4.7.1-8 → 4.7.2-570

package/src/assets.d.ts

@@ -1,116 +1,130 @@
-/**********************************************************************
- Copyright (c) Vladimir Davidovich. All rights reserved.
-***********************************************************************/
-
-// Ambient types for Godot asset imports, resolved by `@ringozz/godot/preload`
-// into modules that export a `materialize` promise (files staged into MEMFS) and
-// default to the load promise (`const { materialize, load } = loadAsset(path,
-// Class, files, deps, import.meta.hot.data)` — `load` memoized on the module's
-// HMR data, so re-evaluations return the same fulfilled promise). The default is
-// a stable module singleton, so it can be passed to React's `use()` under
-// `<Suspense>`.
-
-declare module '*.tres' {
-	import type { Resource } from '@ringozz/godot/Resource';
-	const asset: Promise<Resource>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.po' {
-	import type { Translation } from '@ringozz/godot/Translation';
-	const asset: Promise<Translation>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.gltf' {
-	import type { PackedScene } from '@ringozz/godot/PackedScene';
-	const asset: Promise<PackedScene>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.tscn' {
-	import type { PackedScene } from '@ringozz/godot/PackedScene';
-	const asset: Promise<PackedScene>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.obj' {
-	import type { PackedScene } from '@ringozz/godot/PackedScene';
-	const asset: Promise<PackedScene>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.jpg' {
-	import type { CompressedTexture2D } from '@ringozz/godot/CompressedTexture2D';
-	const asset: Promise<CompressedTexture2D>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.jpeg' {
-	import type { CompressedTexture2D } from '@ringozz/godot/CompressedTexture2D';
-	const asset: Promise<CompressedTexture2D>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.png' {
-	import type { CompressedTexture2D } from '@ringozz/godot/CompressedTexture2D';
-	const asset: Promise<CompressedTexture2D>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.webp' {
-	import type { CompressedTexture2D } from '@ringozz/godot/CompressedTexture2D';
-	const asset: Promise<CompressedTexture2D>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.svg' {
-	import type { Texture2D } from '@ringozz/godot/Texture2D';
-	const asset: Promise<Texture2D>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.exr' {
-	import type { TextureLayered } from '@ringozz/godot/TextureLayered';
-	const asset: Promise<TextureLayered>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.hdr' {
-	import type { TextureLayered } from '@ringozz/godot/TextureLayered';
-	const asset: Promise<TextureLayered>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.wav' {
-	import type { AudioStreamWAV } from '@ringozz/godot/AudioStreamWAV';
-	const asset: Promise<AudioStreamWAV>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.ogg' {
-	import type { AudioStreamOggVorbis } from '@ringozz/godot/AudioStreamOggVorbis';
-	const asset: Promise<AudioStreamOggVorbis>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
-
-declare module '*.mp3' {
-	import type { AudioStreamMP3 } from '@ringozz/godot/AudioStreamMP3';
-	const asset: Promise<AudioStreamMP3>;
-	export default asset;
-	export const materialize: Promise<unknown>;
-}
+/**********************************************************************
+ Copyright (c) Vladimir Davidovich. All rights reserved.
+***********************************************************************/
+
+// Ambient types for Godot asset imports, resolved by `@ringozz/godot/preload`
+// into modules that export a `materialize` promise (files staged into MEMFS) and
+// default to the load promise (`const { materialize, load } = loadAsset(path,
+// Class, files, deps, import.meta.hot.data)` — `load` memoized on the module's
+// HMR data, so re-evaluations return the same fulfilled promise). The default is
+// a stable module singleton, so it can be passed to React's `use()` under
+// `<Suspense>`.
+
+declare module '*.tres' {
+	import type { Resource } from '@ringozz/godot/Resource';
+	const asset: Promise<Resource>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.po' {
+	import type { Translation } from '@ringozz/godot/Translation';
+	const asset: Promise<Translation>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.gltf' {
+	import type { PackedScene } from '@ringozz/godot/PackedScene';
+	const asset: Promise<PackedScene>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.tscn' {
+	import type { PackedScene } from '@ringozz/godot/PackedScene';
+	const asset: Promise<PackedScene>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.obj' {
+	import type { PackedScene } from '@ringozz/godot/PackedScene';
+	const asset: Promise<PackedScene>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.jpg' {
+	import type { CompressedTexture2D } from '@ringozz/godot/CompressedTexture2D';
+	const asset: Promise<CompressedTexture2D>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.jpeg' {
+	import type { CompressedTexture2D } from '@ringozz/godot/CompressedTexture2D';
+	const asset: Promise<CompressedTexture2D>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.png' {
+	import type { CompressedTexture2D } from '@ringozz/godot/CompressedTexture2D';
+	const asset: Promise<CompressedTexture2D>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.webp' {
+	import type { CompressedTexture2D } from '@ringozz/godot/CompressedTexture2D';
+	const asset: Promise<CompressedTexture2D>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.svg' {
+	import type { Texture2D } from '@ringozz/godot/Texture2D';
+	const asset: Promise<Texture2D>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.exr' {
+	import type { TextureLayered } from '@ringozz/godot/TextureLayered';
+	const asset: Promise<TextureLayered>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.hdr' {
+	import type { TextureLayered } from '@ringozz/godot/TextureLayered';
+	const asset: Promise<TextureLayered>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.wav' {
+	import type { AudioStreamWAV } from '@ringozz/godot/AudioStreamWAV';
+	const asset: Promise<AudioStreamWAV>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.ttf' {
+	import type { FontFile } from '@ringozz/godot/FontFile';
+	const asset: Promise<FontFile>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.otf' {
+	import type { FontFile } from '@ringozz/godot/FontFile';
+	const asset: Promise<FontFile>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.ogg' {
+	import type { AudioStreamOggVorbis } from '@ringozz/godot/AudioStreamOggVorbis';
+	const asset: Promise<AudioStreamOggVorbis>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}
+
+declare module '*.mp3' {
+	import type { AudioStreamMP3 } from '@ringozz/godot/AudioStreamMP3';
+	const asset: Promise<AudioStreamMP3>;
+	export default asset;
+	export const materialize: Promise<unknown>;
+}

package/src/boot.browser.ts

@@ -0,0 +1,41 @@
+/**********************************************************************
+ Copyright (c) Vladimir Davidovich. All rights reserved.
+***********************************************************************/
+
+// Web boot leaf (the `browser`-field replacement for `boot.ts`): boots the
+// Godot wasm engine and hands the module to `runtime.ts` as the native module
+// *namespace* (whose `.default` is the wasm module). This module is a leaf — it
+// imports nothing from the godot class graph, so a web entry can call
+// `preloadGodot()` *before* importing the app without pulling in `runtime.ts`.
+// `runtime.ts` statically imports this module too — by package self-reference
+// (`@ringozz/godot/boot`, whose `exports` `./boot` entry's `browser` condition
+// selects this file), the same resolution as the entrypoint's import, so both
+// sides are guaranteed the same module instance and `nativeModule` below is the
+// handoff — no global needed.
+
+let nativeModule: unknown = null;
+
+/** The cached wasm module import (its namespace), or `null` until `preloadGodot()` completes. */
+export function getNativeModule(): unknown {
+    return nativeModule;
+}
+
+/**
+ * Boots the Godot wasm engine so `@ringozz/godot/runtime` can read the native
+ * module synchronously via {@link getNativeModule} — keeping the shared module
+ * graph top-level-await free (which is what lets Bun's HMR module loader
+ * evaluate sibling importers in order). Returns the wasm module's namespace
+ * (the native module is its `.default`, which `runtime.ts` destructures).
+ * Idempotent: subsequent calls return the cached import without re-booting.
+ *
+ * A web entry must `await preloadGodot()` before importing the app:
+ *
+ * ```ts
+ * import { preloadGodot } from '@ringozz/godot/boot';
+ * await preloadGodot();
+ * await import('./app.ts');
+ * ```
+ */
+export async function preloadGodot(): Promise<unknown> {
+    return nativeModule ??= await import('@ringozz/godot-web-wasm32');
+}

package/src/boot.ts

@@ -2,36 +2,26 @@
  Copyright (c) Vladimir Davidovich. All rights reserved.
 ***********************************************************************/
 
-// Web boot helper. This module is a leaf — it imports nothing from the godot
-// class graph, so a web entry can call `preloadGodot()` *before* importing the
-// app without pulling in `runtime.ts` (which throws until the native module is
-// available). `runtime.ts` statically imports this module too, so both sides
-// share the same module instance and `nativeModule` below is the handoff — no
-// global needed.
+// Desktop boot leaf: resolves the native addon for the current host and
+// hands it to `runtime.ts` as the native module *namespace* (whose `.default`
+// is the addon's `module.exports`). `runtime.ts` imports this module by package
+// self-reference (`@ringozz/godot/boot`), whose `exports` `./boot` entry's
+// `browser` condition selects `boot.browser.ts` when bundling for
+// `target: 'browser'` — so the Bun-only `import.meta.require` below never
+// reaches a web bundle.
 
-let nativeModule: unknown = null;
+const { platform, arch } = globalThis.process ?? {};
+const mapping: any = {
+    'darwin-arm64': 'macos-arm64',
+    'win32-x64': 'windows-x86_64',
+};
 
-/** The cached wasm module import (its namespace), or `null` until `preloadGodot()` completes. */
+/** The native addon's module namespace (sync dlopen; engine boots on first call). */
 export function getNativeModule(): unknown {
-    return nativeModule;
+    return import.meta.require(`@ringozz/godot-${mapping[`${platform}-${arch}`]}`);
 }
 
-/**
- * Boots the Godot wasm engine so `@ringozz/godot/runtime` can read the native
- * module synchronously via {@link getNativeModule} — keeping the shared module
- * graph top-level-await free (which is what lets Bun's HMR module loader
- * evaluate sibling importers in order). Returns the wasm module's namespace
- * (the native module is its `.default`, which `runtime.ts` destructures).
- * Idempotent: subsequent calls return the cached import without re-booting.
- *
- * A web entry must `await preloadGodot()` before importing the app:
- *
- * ```ts
- * import { preloadGodot } from '@ringozz/godot/boot';
- * await preloadGodot();
- * await import('./app.ts');
- * ```
- */
+/** Desktop boots synchronously at import — nothing to preload. */
 export async function preloadGodot(): Promise<unknown> {
-    return nativeModule ??= await import('@ringozz/godot-web-wasm32');
+    return undefined;
 }