mage-engine 3.23.26 → 3.23.28

package/dist/mage.js

@@ -55428,7 +55428,76 @@ var Universe$1 = new Universe();var generateUUID = function generateUUID() {
 };
 var generateRandomName = function generateRandomName(prefix) {
   return "".concat(prefix, "_").concat(generateUUID());
-};var uuid$1=/*#__PURE__*/Object.freeze({__proto__:null,generateUUID:generateUUID,generateRandomName:generateRandomName});var _MATERIAL_PROPERTIES_, _MATERIAL_PROPERTIES_2, _MATERIAL_TEXTURE_MAP$1;
+};var uuid$1=/*#__PURE__*/Object.freeze({__proto__:null,generateUUID:generateUUID,generateRandomName:generateRandomName});/**
+ * Environment configuration module for mage-engine.
+ * Centralizes all environment variables and their default values.
+ *
+ * Usage:
+ *   import env from './env';
+ *   const baseUrl = env.MAGE_ASSETS_BASE_URL;
+ */
+
+/**
+ * Safe window access - returns undefined in non-browser environments
+ */
+var getWindow = function getWindow() {
+  return typeof window !== "undefined" ? window : undefined;
+};
+/**
+ * Gets an environment variable from the window object with a fallback default.
+ * @param {string} key - The environment variable name
+ * @param {any} defaultValue - Default value if not set
+ * @returns {any} - The environment variable value or default
+ */
+
+
+var getEnv = function getEnv(key) {
+  var defaultValue = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : undefined;
+  var win = getWindow();
+  return win && win[key] !== undefined ? win[key] : defaultValue;
+};
+/**
+ * Environment variables with their default values.
+ * These are accessed as getters so they're evaluated at access time,
+ * not at module load time (important for variables set after page load).
+ */
+
+
+var env = {
+  /**
+   * Base URL for loading assets (textures, models, audio).
+   * Set by mage-studio editor or deployed builds.
+   * Default: empty string (paths used as-is for backwards compatibility)
+   */
+  get MAGE_ASSETS_BASE_URL() {
+    return getEnv("MAGE_ASSETS_BASE_URL", "");
+  },
+
+  /**
+   * Enable debug mode for verbose logging.
+   * Default: false
+   */
+  get MAGE_DEBUG() {
+    return getEnv("MAGE_DEBUG", false);
+  },
+
+  /**
+   * Current project ID (set by mage-studio).
+   * Default: empty string
+   */
+  get MAGE_PROJECT_ID() {
+    return getEnv("MAGE_PROJECT_ID", "");
+  },
+
+  /**
+   * Current build ID (set by deployed builds).
+   * Default: empty string
+   */
+  get MAGE_BUILD_ID() {
+    return getEnv("MAGE_BUILD_ID", "");
+  }
+
+};var _MATERIAL_PROPERTIES_, _MATERIAL_PROPERTIES_2, _MATERIAL_TEXTURE_MAP$1;
 var ALMOST_ZERO = 0.00001;
 var UP$1 = "UP";
 var DOWN$1 = "DOWN";
@@ -55722,7 +55791,64 @@ var TAGS = {
 };
 var isLevelName = function isLevelName(level) {
   return level.startsWith(DIVIDER);
-};var Images = /*#__PURE__*/function () {
+};/**
+ * Checks if a path is an absolute URL (with protocol).
+ */
+
+var isAbsoluteURL$3 = function isAbsoluteURL(path) {
+  try {
+    new URL(path);
+    return true;
+  } catch (_) {
+    return false;
+  }
+};
+/**
+ * Checks if a path already contains the assets API path.
+ * This prevents double-prepending when a full path is passed.
+ */
+
+
+var isAlreadyResolved$2 = function isAlreadyResolved(path) {
+  return path && (isAbsoluteURL$3(path) || path.includes("/api/assets/"));
+};
+/**
+ * Resolves a single asset path to a full URL using MAGE_ASSETS_BASE_URL.
+ */
+
+
+var resolveSinglePath = function resolveSinglePath(path) {
+  // If already a full URL or already contains the API path, return as-is
+  if (isAlreadyResolved$2(path)) {
+    return path;
+  }
+
+  var baseUrl = env.MAGE_ASSETS_BASE_URL;
+
+  if (baseUrl) {
+    var cleanPath = path.startsWith("/") ? path.slice(1) : path;
+    return "".concat(baseUrl, "/").concat(cleanPath);
+  }
+
+  return path;
+};
+/**
+ * Resolves asset path(s) to full URL(s) using MAGE_ASSETS_BASE_URL.
+ * Handles both single paths (string) and arrays of paths (for cube textures).
+ */
+
+
+var resolveAssetPath$2 = function resolveAssetPath(pathOrPaths) {
+  if (Array.isArray(pathOrPaths)) {
+    return pathOrPaths.map(function (p) {
+      return resolveSinglePath(p);
+    });
+  }
+
+  return resolveSinglePath(pathOrPaths);
+};
+
+var Images = /*#__PURE__*/function () {
   function Images() {
     var _this = this;
 
@@ -55801,11 +55927,13 @@ var isLevelName = function isLevelName(level) {
       var loaderType = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : _this.LOADERS.TEXTURE;
       var id = buildAssetId(name, level);
 
-      var loader = _this.getLoaderByType(loaderType);
+      var loader = _this.getLoaderByType(loaderType); // Resolve the path using MAGE_ASSETS_BASE_URL if available
 
+
+      var resolvedPath = resolveAssetPath$2(path);
       return new Promise(function (resolve) {
         try {
-          loader.load(path, function (asset) {
+          loader.load(resolvedPath, function (asset) {
             _this.add(id, asset);
 
             resolve(asset);
@@ -58297,7 +58425,7 @@ function applyMiddleware() {
 
 var thunk = createThunkMiddleware();
 thunk.withExtraArgument = createThunkMiddleware;var name = "mage-engine";
-var version$1 = "3.23.26";
+var version$1 = "3.23.28";
 var description = "A WebGL Javascript Game Engine, built on top of THREE.js and many other libraries.";
 var main = "dist/mage.js";
 var author$1 = {
@@ -70214,75 +70342,6 @@ var createConnect = function (ref) {
 };
 var connect = createConnect();var BaseUI = function BaseUI() {
   return null;
-};/**
- * Environment configuration module for mage-engine.
- * Centralizes all environment variables and their default values.
- *
- * Usage:
- *   import env from './env';
- *   const baseUrl = env.MAGE_ASSETS_BASE_URL;
- */
-
-/**
- * Safe window access - returns undefined in non-browser environments
- */
-var getWindow = function getWindow() {
-  return typeof window !== "undefined" ? window : undefined;
-};
-/**
- * Gets an environment variable from the window object with a fallback default.
- * @param {string} key - The environment variable name
- * @param {any} defaultValue - Default value if not set
- * @returns {any} - The environment variable value or default
- */
-
-
-var getEnv = function getEnv(key) {
-  var defaultValue = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : undefined;
-  var win = getWindow();
-  return win && win[key] !== undefined ? win[key] : defaultValue;
-};
-/**
- * Environment variables with their default values.
- * These are accessed as getters so they're evaluated at access time,
- * not at module load time (important for variables set after page load).
- */
-
-
-var env = {
-  /**
-   * Base URL for loading assets (textures, models, audio).
-   * Set by mage-studio editor or deployed builds.
-   * Default: empty string (paths used as-is for backwards compatibility)
-   */
-  get MAGE_ASSETS_BASE_URL() {
-    return getEnv("MAGE_ASSETS_BASE_URL", "");
-  },
-
-  /**
-   * Enable debug mode for verbose logging.
-   * Default: false
-   */
-  get MAGE_DEBUG() {
-    return getEnv("MAGE_DEBUG", false);
-  },
-
-  /**
-   * Current project ID (set by mage-studio).
-   * Default: empty string
-   */
-  get MAGE_PROJECT_ID() {
-    return getEnv("MAGE_PROJECT_ID", "");
-  },
-
-  /**
-   * Current build ID (set by deployed builds).
-   * Default: empty string
-   */
-  get MAGE_BUILD_ID() {
-    return getEnv("MAGE_BUILD_ID", "");
-  }
-
 };var TIME_FOR_UPDATE = 5;
 var VOLUME = 2;
 var DEFAULT_AUDIO_NODE_VOLUME = 5;
@@ -70293,12 +70352,10 @@ var AUDIO_RAMPS = {
   EXPONENTIAL: "EXPONENTIAL"
 };
 /**
- * Checks if a path is an absolute URL.
- * @param {string} path - The path to check
- * @returns {boolean} - True if path is an absolute URL
+ * Checks if a path is an absolute URL (with protocol).
  */
 
-var isURL$1 = function isURL(path) {
+var isAbsoluteURL$2 = function isAbsoluteURL(path) {
   try {
     new URL(path);
     return true;
@@ -70306,9 +70363,18 @@ var isURL$1 = function isURL(path) {
     return false;
   }
 };
+/**
+ * Checks if a path already contains the assets API path.
+ * This prevents double-prepending when a full path is passed.
+ */
+
+
+var isAlreadyResolved$1 = function isAlreadyResolved(path) {
+  return path && (isAbsoluteURL$2(path) || path.includes("/api/assets/"));
+};
 /**
  * Resolves an asset path to a full URL.
- * If path is already an absolute URL, returns it as-is.
+ * If path is already an absolute URL or contains the API path, returns it as-is.
  * If path is relative and MAGE_ASSETS_BASE_URL is set, prepends the base URL.
  * @param {string} path - The asset path (relative or absolute)
  * @returns {string} - The resolved full URL
@@ -70316,8 +70382,8 @@ var isURL$1 = function isURL(path) {
 
 
 var resolveAssetPath$1 = function resolveAssetPath(path) {
-  // If it's already an absolute URL, use it as-is
-  if (isURL$1(path)) {
+  // If already a full URL or already contains the API path, return as-is
+  if (isAlreadyResolved$1(path)) {
     return path;
   } // If MAGE_ASSETS_BASE_URL is set, prepend it to the relative path
 
@@ -76231,7 +76297,7 @@ var NURBSCurve = /*#__PURE__*/function (_Curve) {
   }]);
 
   return NURBSCurve;
-}(Curve);var isAbsoluteURL = function isAbsoluteURL(url) {
+}(Curve);var isAbsoluteURL$1 = function isAbsoluteURL(url) {
   return /^(?:\w+:)\/\//.test(url);
 };/**
  * Loader loads FBX file and generates Group representing FBX scene.
@@ -76327,7 +76393,7 @@ var buildFBXLoader = function buildFBXLoader() {
         var texturePath = LoaderUtils.extractUrlBase(texture);
         var textureLoader = new TextureLoader(this.manager).setCrossOrigin(this.crossOrigin);
 
-        if (!isAbsoluteURL(texture)) {
+        if (!isAbsoluteURL$1(texture)) {
           textureLoader.setPath(this.resourcePath || texturePath || path);
         }
 
@@ -80868,18 +80934,43 @@ var DEFAULTbuildObjectLoader = function DEFAULTbuildObjectLoader() {
 };
 
 var loaders = (_loaders = {}, _defineProperty$1(_loaders, EXTENSIONS.JSON, DEFAULTbuildObjectLoader), _defineProperty$1(_loaders, EXTENSIONS.GLB, buildGLTFLoader), _defineProperty$1(_loaders, EXTENSIONS.GLTF, buildGLTFLoader), _defineProperty$1(_loaders, EXTENSIONS.FBX, buildFBXLoader), _defineProperty$1(_loaders, EXTENSIONS.OBJ, buildOBJMTLLoader), _loaders);
+/**
+ * Checks if a path is an absolute URL (with protocol).
+ */
+
+var isAbsoluteURL = function isAbsoluteURL(path) {
+  try {
+    new URL(path);
+    return true;
+  } catch (_) {
+    return false;
+  }
+};
+/**
+ * Parses a URL and returns the URL object, or false if not a valid URL.
+ * Used by extractExtension to get the pathname.
+ */
+
 
 var isURL = function isURL(path) {
   try {
-    var url = new URL(path);
-    return url;
+    return new URL(path);
   } catch (_) {
     return false;
   }
 };
+/**
+ * Checks if a path already contains the assets API path.
+ * This prevents double-prepending when a full path is passed.
+ */
+
+
+var isAlreadyResolved = function isAlreadyResolved(path) {
+  return path && (isAbsoluteURL(path) || path.includes("/api/assets/"));
+};
 /**
  * Resolves an asset path to a full URL.
- * If path is already an absolute URL, returns it as-is.
+ * If path is already an absolute URL or contains the API path, returns it as-is.
  * If path is relative and MAGE_ASSETS_BASE_URL is set, prepends the base URL.
  * @param {string} path - The asset path (relative or absolute)
  * @returns {string} - The resolved full URL
@@ -80887,8 +80978,8 @@ var isURL = function isURL(path) {
 
 
 var resolveAssetPath = function resolveAssetPath(path) {
-  // If it's already an absolute URL, use it as-is
-  if (isURL(path)) {
+  // If already a full URL or already contains the API path, return as-is
+  if (isAlreadyResolved(path)) {
     return path;
   } // If MAGE_ASSETS_BASE_URL is set, prepend it to the relative path
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mage-engine",
-    "version": "3.23.26",
+    "version": "3.23.28",
     "description": "A WebGL Javascript Game Engine, built on top of THREE.js and many other libraries.",
     "main": "dist/mage.js",
     "author": {