nucleation 0.1.14 → 0.1.17

package/nucleation-cdn-loader.js

@@ -0,0 +1,112 @@
+// nucleation-cdn-loader.js - Custom loader for CDN usage
+// This file will be imported by the user's HTML script.
+
+// These imports are relative to this loader file within the 'pkg' directory structure on the CDN
+import * as bgModule from './nucleation_bg.js'; // Imports SchematicWrapper, __wbg_set_wasm, etc.
+
+let initialized = false;
+let wasmExports = null;
+
+/**
+ * Initializes the WebAssembly module.
+ * @param {string | URL | Request | Response | BufferSource} [wasmPathOrModule]
+ *   Optional. Path/URL to the 'nucleation_bg.wasm' file, or a pre-fetched Response/BufferSource.
+ *   If not provided, it will attempt to fetch 'nucleation_bg.wasm' relative to this script.
+ * @returns {Promise<object>} A promise that resolves to an object containing the WASM exports
+ *                            (e.g., SchematicWrapper, BlockStateWrapper).
+ */
+async function init(wasmPathOrModule) {
+    if (initialized) {
+        // console.debug("WASM already initialized. Returning existing exports.");
+        return {
+            SchematicWrapper: bgModule.SchematicWrapper,
+            BlockStateWrapper: bgModule.BlockStateWrapper,
+            // Add other direct exports from bgModule you want to expose
+            debug_schematic: bgModule.debug_schematic,
+            debug_json_schematic: bgModule.debug_json_schematic,
+            start: bgModule.start,
+            BlockPosition: bgModule.BlockPosition
+        };
+    }
+
+    if (typeof bgModule.__wbg_set_wasm !== 'function') {
+        throw new Error("__wbg_set_wasm function not found in ./nucleation_bg.js. The WASM bindings seem incomplete.");
+    }
+
+    let input = wasmPathOrModule;
+    if (input === undefined) {
+        // Default to fetching WASM relative to this loader script's location
+        // On CDN, this means same directory, e.g., .../pkg/nucleation_bg.wasm
+        input = new URL('./nucleation_bg.wasm', import.meta.url);
+        // console.debug("No WASM path provided, attempting to load from default relative path:", input.href);
+    }
+
+    const importsObject = { './nucleation_bg.js': bgModule };
+    let instanceExports;
+
+    if (typeof input === 'string' || input instanceof URL || input instanceof Request) {
+        // console.debug("Fetching WASM from URL/Request:", input);
+        const response = await fetch(input);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch WASM (${input}): ${response.status} ${response.statusText}`);
+        }
+        if (typeof WebAssembly.instantiateStreaming === 'function') {
+            const { instance } = await WebAssembly.instantiateStreaming(response, importsObject);
+            instanceExports = instance.exports;
+        } else {
+            const buffer = await response.arrayBuffer();
+            const { instance } = await WebAssembly.instantiate(buffer, importsObject);
+            instanceExports = instance.exports;
+        }
+    } else if (input instanceof Response) { // Pre-fetched Response object
+        // console.debug("Using pre-fetched Response object for WASM.");
+         if (typeof WebAssembly.instantiateStreaming === 'function') {
+            const { instance } = await WebAssembly.instantiateStreaming(input, importsObject);
+            instanceExports = instance.exports;
+        } else {
+            const buffer = await input.arrayBuffer();
+            const { instance } = await WebAssembly.instantiate(buffer, importsObject);
+            instanceExports = instance.exports;
+        }
+    } else if (input instanceof ArrayBuffer || input instanceof Uint8Array) { // Pre-loaded BufferSource
+        // console.debug("Using pre-loaded BufferSource for WASM.");
+        const { instance } = await WebAssembly.instantiate(input, importsObject);
+        instanceExports = instance.exports;
+    } else if (input instanceof WebAssembly.Module) { // Pre-compiled Module
+        // console.debug("Using pre-compiled WebAssembly.Module.");
+         const instance = await WebAssembly.instantiate(input, importsObject);
+         instanceExports = instance.exports;
+    }
+     else {
+        throw new TypeError('Invalid input type for WASM module/path to init().');
+    }
+
+    bgModule.__wbg_set_wasm(instanceExports);
+    // console.debug("WASM instance linked via __wbg_set_wasm.");
+
+    initialized = true;
+    wasmExports = {
+        SchematicWrapper: bgModule.SchematicWrapper,
+        BlockStateWrapper: bgModule.BlockStateWrapper,
+        debug_schematic: bgModule.debug_schematic,
+        debug_json_schematic: bgModule.debug_json_schematic,
+        start: bgModule.start,
+        BlockPosition: bgModule.BlockPosition
+        // Add any other exports from bgModule that you want to make available
+    };
+    return wasmExports;
+}
+
+// Re-export the named items so users can do:
+// import init, { SchematicWrapper } from '.../nucleation-cdn-loader.js';
+export {
+    SchematicWrapper,
+    BlockStateWrapper,
+    debug_schematic,
+    debug_json_schematic,
+    start,
+    BlockPosition
+} from './nucleation_bg.js'; // Re-export directly from _bg.js
+                                // These will become "live" after init() is called and __wbg_set_wasm populates the WASM instance.
+
+export default init; // Default export is the init function

package/package.json

@@ -5,7 +5,7 @@
     "Nano nano@schem.at"
   ],
   "description": "A high-performance Minecraft schematic parser and utility library",
-  "version": "0.1.14",
+  "version": "0.1.17",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",
@@ -16,10 +16,11 @@
     "nucleation_bg.wasm",
     "nucleation_bg.js",
     "nucleation.d.ts",
+    "nucleation-cdn-loader.js",
     "README.md"
   ],
-  "main": "nucleation.js",
-  "types": "nucleation.d.ts",
+  "main": "./nucleation.js",
+  "types": "./nucleation.d.ts",
   "sideEffects": [
     "./nucleation.js",
     "./snippets/*"
@@ -32,7 +33,17 @@
     "webassembly",
     "voxel"
   ],
-  "module": "nucleation.js",
+  "module": "./nucleation.js",
+  "exports": {
+    ".": {
+      "import": "./nucleation.js",
+      "types": "./nucleation.d.ts"
+    },
+    "./cdn-loader": {
+      "import": "./nucleation-cdn-loader.js"
+    },
+    "./package.json": "./package.json"
+  },
   "author": "Nano <nano@schem.at>",
   "homepage": "https://github.com/Schem-at/Nucleation"
 }