@plasius/gpu-shared 0.1.3 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/gpu-shared",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "Shared browser-safe demo runtime and asset helpers for the Plasius gpu-* package family.",
   "type": "module",
   "sideEffects": false,
@@ -66,7 +66,7 @@
     "eslint": "^10.1.0",
     "globals": "^17.3.0",
     "tsup": "^8.5.0",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.2"
   },
   "repository": {
     "type": "git",

package/src/asset-url.js

@@ -0,0 +1,37 @@
+const INLINE_BRIGANTINE_GLTF_URL =
+  "data:application/json;base64,ewogICJhc3NldCI6IHsKICAgICJ2ZXJzaW9uIjogIjIuMCIsCiAgICAiZ2VuZXJhdG9yIjogIlBsYXNpdXMgZGVtbyBhc3NldCBnZW5lcmF0b3IiCiAgfSwKICAic2NlbmUiOiAwLAogICJzY2VuZXMiOiBbCiAgICB7CiAgICAgICJub2RlcyI6IFswXQogICAgfQogIF0sCiAgIm5vZGVzIjogWwogICAgewogICAgICAibWVzaCI6IDAsCiAgICAgICJuYW1lIjogImJyaWdhbnRpbmUiLAogICAgICAiZXh0cmFzIjogewogICAgICAgICJwaHlzaWNzIjogewogICAgICAgICAgInNoYXBlIjogImJveCIsCiAgICAgICAgICAiaGFsZkV4dGVudHMiOiBbMS4zNSwgMC45NSwgMy45XSwKICAgICAgICAgICJtYXNzIjogMzIwMCwKICAgICAgICAgICJyZXN0aXR1dGlvbiI6IDAuMjIsCiAgICAgICAgICAibGluZWFyRGFtcGluZyI6IDAuMDQsCiAgICAgICAgICAiYW5ndWxhckRhbXBpbmciOiAwLjA4LAogICAgICAgICAgIndhdGVybGluZSI6IDAuNDIKICAgICAgICB9CiAgICAgIH0KICAgIH0KICBdLAogICJtZXNoZXMiOiBbCiAgICB7CiAgICAgICJuYW1lIjogImJyaWdhbnRpbmUtaHVsbCIsCiAgICAgICJwcmltaXRpdmVzIjogWwogICAgICAgIHsKICAgICAgICAgICJhdHRyaWJ1dGVzIjogewogICAgICAgICAgICAiUE9TSVRJT04iOiAwCiAgICAgICAgICB9LAogICAgICAgICAgImluZGljZXMiOiAxLAogICAgICAgICAgIm1hdGVyaWFsIjogMAogICAgICAgIH0KICAgICAgXQogICAgfQogIF0sCiAgIm1hdGVyaWFscyI6IFsKICAgIHsKICAgICAgIm5hbWUiOiAicGFpbnRlZC1odWxsIiwKICAgICAgInBick1ldGFsbGljUm91Z2huZXNzIjogewogICAgICAgICJiYXNlQ29sb3JGYWN0b3IiOiBbMC41NiwgMC4zMywgMC4yMiwgMV0sCiAgICAgICAgIm1ldGFsbGljRmFjdG9yIjogMC4wOCwKICAgICAgICAicm91Z2huZXNzRmFjdG9yIjogMC45MgogICAgICB9CiAgICB9CiAgXSwKICAiYnVmZmVycyI6IFsKICAgIHsKICAgICAgInVyaSI6ICJkYXRhOmFwcGxpY2F0aW9uL29jdGV0LXN0cmVhbTtiYXNlNjQsbXBtWnZ3QUFBTC9OekV6QW1wbVpQd0FBQUwvTnpFekF6Y3lzdnpNenM3NHpNN08vemN5c1B6TXpzNzR6TTdPL0FBQ2d2ODNNVEwzTnpNdy9BQUNnUDgzTVRMM056TXcvQUFBQUFPeFJPTDR6TTROQUFBQUFBR1ptNWo0QUFIQkFNek56dnpNenN6NmFtUm5BTXpOelB6TXpzejZhbVJuQXpjeE12ejBLMXo3TnpFdy96Y3hNUHowSzF6N056RXcvQUFBQUFETXpjejltWm1hL0FBQUNBQU1BQUFBREFBRUFBZ0FFQUFVQUFnQUZBQU1BQkFBSEFBVUFCQUFHQUFjQUJRQUhBQVlBQUFBQkFBa0FBQUFKQUFnQUNBQUpBQXdBQWdBSUFBd0FBd0FNQUFrQUFnQU1BQW9BQXdBTEFBd0FBZ0FLQUFRQUF3QUZBQXNBQ2dBTUFBc0FBQUFJQUFJQUFRQURBQWtBQkFBS0FBWUFCUUFHQUFzQUFnQUtBQXNBQWdBTEFBTUEiLAogICAgICAiYnl0ZUxlbmd0aCI6IDI5NAogICAgfQogIF0sCiAgImJ1ZmZlclZpZXdzIjogWwogICAgewogICAgICAiYnVmZmVyIjogMCwKICAgICAgImJ5dGVPZmZzZXQiOiAwLAogICAgICAiYnl0ZUxlbmd0aCI6IDE1NiwKICAgICAgInRhcmdldCI6IDM0OTYyCiAgICB9LAogICAgewogICAgICAiYnVmZmVyIjogMCwKICAgICAgImJ5dGVPZmZzZXQiOiAxNTYsCiAgICAgICJieXRlTGVuZ3RoIjogMTM4LAogICAgICAidGFyZ2V0IjogMzQ5NjMKICAgIH0KICBdLAogICJhY2Nlc3NvcnMiOiBbCiAgICB7CiAgICAgICJidWZmZXJWaWV3IjogMCwKICAgICAgImJ5dGVPZmZzZXQiOiAwLAogICAgICAiY29tcG9uZW50VHlwZSI6IDUxMjYsCiAgICAgICJjb3VudCI6IDEzLAogICAgICAidHlwZSI6ICJWRUMzIiwKICAgICAgIm1pbiI6IFstMS4zNSwgLTAuNSwgLTMuMl0sCiAgICAgICJtYXgiOiBbMS4zNSwgMC45NSwgNC4xXQogICAgfSwKICAgIHsKICAgICAgImJ1ZmZlclZpZXciOiAxLAogICAgICAiYnl0ZU9mZnNldCI6IDAsCiAgICAgICJjb21wb25lbnRUeXBlIjogNTEyMywKICAgICAgImNvdW50IjogNjksCiAgICAgICJ0eXBlIjogIlNDQUxBUiIsCiAgICAgICJtYXgiOiBbMTJdLAogICAgICAibWluIjogWzBdCiAgICB9CiAgXQp9Cg==";
+
+function createInlineShowcaseAssetUrl() {
+  return new URL(INLINE_BRIGANTINE_GLTF_URL);
+}
+
+function getBrowserBaseUrl() {
+  if (typeof document !== "undefined" && typeof document.baseURI === "string" && document.baseURI.length > 0) {
+    return document.baseURI;
+  }
+  if (
+    typeof window !== "undefined" &&
+    typeof window.location?.href === "string" &&
+    window.location.href.length > 0
+  ) {
+    return window.location.href;
+  }
+  return null;
+}
+
+export function resolveShowcaseAssetUrl(baseUrl = import.meta.url) {
+  try {
+    return new URL("../assets/brigantine.gltf", baseUrl);
+  } catch {
+    const browserBaseUrl = getBrowserBaseUrl();
+    if (browserBaseUrl) {
+      try {
+        const normalizedBaseUrl = new URL(baseUrl, browserBaseUrl);
+        return new URL("../assets/brigantine.gltf", normalizedBaseUrl);
+      } catch {
+        return createInlineShowcaseAssetUrl();
+      }
+    }
+    return createInlineShowcaseAssetUrl();
+  }
+}

package/src/gltf-loader.js

@@ -76,6 +76,40 @@ function computeBounds(positions) {
   return { min, max };
 }
 
+function resolveBrowserRequestBaseUrl() {
+  if (typeof document !== "undefined" && typeof document.baseURI === "string" && document.baseURI.length > 0) {
+    return document.baseURI;
+  }
+  if (
+    typeof window !== "undefined" &&
+    typeof window.location?.href === "string" &&
+    window.location.href.length > 0
+  ) {
+    return window.location.href;
+  }
+  return null;
+}
+
+function resolveFetchBaseUrl(requestUrl, responseUrl) {
+  if (typeof responseUrl === "string" && responseUrl.length > 0) {
+    try {
+      return new URL(responseUrl);
+    } catch {
+      // Keep trying the other candidates when an environment reports a malformed response URL.
+    }
+  }
+
+  try {
+    return new URL(requestUrl);
+  } catch {
+    const browserBaseUrl = resolveBrowserRequestBaseUrl();
+    if (browserBaseUrl) {
+      return new URL(requestUrl, browserBaseUrl);
+    }
+    throw new Error(`Unable to resolve a stable base URL for glTF asset loading: ${String(requestUrl)}`);
+  }
+}
+
 export async function loadGltfModel(url) {
   const response = await fetch(url);
   if (!response.ok) {
@@ -83,6 +117,7 @@ export async function loadGltfModel(url) {
   }
 
   const document = await response.json();
+  const baseUrl = resolveFetchBaseUrl(url, response.url);
   const buffers = await Promise.all(
     (document.buffers ?? []).map(async (buffer) => {
       if (typeof buffer.uri !== "string") {
@@ -91,7 +126,7 @@ export async function loadGltfModel(url) {
       if (buffer.uri.startsWith("data:")) {
         return decodeDataUri(buffer.uri);
       }
-      const nested = await fetch(new URL(buffer.uri, url));
+      const nested = await fetch(new URL(buffer.uri, baseUrl));
       if (!nested.ok) {
         throw new Error(`Failed to load glTF buffer: ${nested.status} ${nested.statusText}`);
       }

package/src/index.d.ts

@@ -34,6 +34,10 @@ export interface MountGpuShowcaseOptions {
   packageName?: string;
   title?: string;
   subtitle?: string;
+  createState?: () => unknown;
+  updateState?: (state: unknown, scene: Record<string, unknown>, dt: number) => unknown;
+  describeState?: (state: unknown, scene: Record<string, unknown>) => Record<string, unknown> | null;
+  destroyState?: (state: unknown) => void;
 }
 
 export interface MountGpuShowcaseResult {

package/src/index.js

@@ -1,3 +1,5 @@
+export { resolveShowcaseAssetUrl } from "./asset-url.js";
+
 export const showcaseFocusModes = Object.freeze([
   "integrated",
   "lighting",
@@ -8,10 +10,6 @@ export const showcaseFocusModes = Object.freeze([
   "debug",
 ]);
 
-export function resolveShowcaseAssetUrl(baseUrl = import.meta.url) {
-  return new URL("../assets/brigantine.gltf", baseUrl);
-}
-
 export async function loadGltfModel(url) {
   const module = await import("./gltf-loader.js");
   return module.loadGltfModel(url);