@zephyr3d/editor 0.3.5 → 0.3.7

package/dist/modules/zephyr3d_base.js

@@ -9920,35 +9920,35 @@ const mimeTypes = {
     '.zprefab': 'application/vnd.zephyr3d.prefab+json',
     '.zabc': 'application/vnd.zephyr3d.alembic-cache+json'
 };
-/**
- * Path utilities.
- *
- * Provides POSIX-like path manipulation helpers (pure string operations),
- * including normalization, joining, dirname/basename/extname extraction,
- * absolute-path detection, and relative path computation.
- *
- * Notes:
- * - Uses "/" as the separator (web/URL or POSIX-like paths).
- * - All methods are pure and do not touch a real filesystem.
- * - `normalize` collapses ".", "..", and redundant slashes.
- *
- * @public
+/**
+ * Path utilities.
+ *
+ * Provides POSIX-like path manipulation helpers (pure string operations),
+ * including normalization, joining, dirname/basename/extname extraction,
+ * absolute-path detection, and relative path computation.
+ *
+ * Notes:
+ * - Uses "/" as the separator (web/URL or POSIX-like paths).
+ * - All methods are pure and do not touch a real filesystem.
+ * - `normalize` collapses ".", "..", and redundant slashes.
+ *
+ * @public
  */ class PathUtils {
-    /**
-   * Normalizes a path by collapsing redundant slashes, removing "." segments,
-   * and resolving ".." segments.
-   *
-   * Rules:
-   * - Multiple consecutive "/" are collapsed into a single "/".
-   * - "." segments are removed.
-   * - ".." removes the previous segment (no-op at root).
-   * - The result always starts with "/" (absolute form).
-   *
-   * Example:
-   * - normalize('/a//b/./c/../d') -\> '/a/b/d'
-   *
-   * @param path - Input path (relative or absolute).
-   * @returns The normalized absolute path (always starting with "/").
+    /**
+   * Normalizes a path by collapsing redundant slashes, removing "." segments,
+   * and resolving ".." segments.
+   *
+   * Rules:
+   * - Multiple consecutive "/" are collapsed into a single "/".
+   * - "." segments are removed.
+   * - ".." removes the previous segment (no-op at root).
+   * - The result always starts with "/" (absolute form).
+   *
+   * Example:
+   * - normalize('/a//b/./c/../d') -\> '/a/b/d'
+   *
+   * @param path - Input path (relative or absolute).
+   * @returns The normalized absolute path (always starting with "/").
    */ static normalize(path) {
         const parts = path.split('/').filter((p)=>p && p !== '.');
         const result = [];
@@ -9961,55 +9961,55 @@ const mimeTypes = {
         }
         return '/' + result.join('/');
     }
-    /**
-   * Joins multiple path segments and normalizes the result.
-   *
-   * Behavior:
-   * - Concatenates segments with "/" and then runs `normalize`.
-   * - The returned path is always absolute.
-   *
-   * Example:
-   * - join('/a', 'b', '../c') -\> '/a/c'
-   *
-   * @param paths - Path segments in order.
-   * @returns Normalized absolute path.
+    /**
+   * Joins multiple path segments and normalizes the result.
+   *
+   * Behavior:
+   * - Concatenates segments with "/" and then runs `normalize`.
+   * - The returned path is always absolute.
+   *
+   * Example:
+   * - join('/a', 'b', '../c') -\> '/a/c'
+   *
+   * @param paths - Path segments in order.
+   * @returns Normalized absolute path.
    */ static join(...paths) {
         return this.normalize(paths.join('/'));
     }
-    /**
-   * Returns the directory name (parent directory) of a path.
-   *
-   * Behavior:
-   * - Applies `normalize` first.
-   * - If the path is root "/" or has no parent, returns "/".
-   *
-   * Examples:
-   * - dirname('/a/b/c') -\> '/a/b'
-   * - dirname('/a') -\> '/'
-   * - dirname('/') -\> '/'
-   *
-   * @param path - Input path.
-   * @returns Directory path of the input.
+    /**
+   * Returns the directory name (parent directory) of a path.
+   *
+   * Behavior:
+   * - Applies `normalize` first.
+   * - If the path is root "/" or has no parent, returns "/".
+   *
+   * Examples:
+   * - dirname('/a/b/c') -\> '/a/b'
+   * - dirname('/a') -\> '/'
+   * - dirname('/') -\> '/'
+   *
+   * @param path - Input path.
+   * @returns Directory path of the input.
    */ static dirname(path) {
         const normalized = this.normalize(path);
         const lastSlash = normalized.lastIndexOf('/');
         return lastSlash <= 0 ? '/' : normalized.slice(0, lastSlash);
     }
-    /**
-   * Returns the last portion of a path (file name).
-   *
-   * Behavior:
-   * - Applies `normalize` first.
-   * - If `ext` is provided and the name ends with it, the extension is stripped.
-   *
-   * Examples:
-   * - basename('/a/b/c.txt') -\> 'c.txt'
-   * - basename('/a/b/c.txt', '.txt') -\> 'c'
-   * - basename('/') -\> ''
-   *
-   * @param path - Input path.
-   * @param ext - Optional extension to strip (exact suffix match).
-   * @returns The base name of the path.
+    /**
+   * Returns the last portion of a path (file name).
+   *
+   * Behavior:
+   * - Applies `normalize` first.
+   * - If `ext` is provided and the name ends with it, the extension is stripped.
+   *
+   * Examples:
+   * - basename('/a/b/c.txt') -\> 'c.txt'
+   * - basename('/a/b/c.txt', '.txt') -\> 'c'
+   * - basename('/') -\> ''
+   *
+   * @param path - Input path.
+   * @param ext - Optional extension to strip (exact suffix match).
+   * @returns The base name of the path.
    */ static basename(path, ext) {
         const normalized = this.normalize(path);
         const lastSlash = normalized.lastIndexOf('/');
@@ -10019,44 +10019,44 @@ const mimeTypes = {
         }
         return name;
     }
-    /**
-   * Returns the extension of the path, including the leading dot.
-   *
-   * Behavior:
-   * - Based on the result of `basename`.
-   * - If there is no dot, returns an empty string.
-   *
-   * Examples:
-   * - extname('/a/b/c.txt') -\> '.txt'
-   * - extname('/a/b/c') -\> ''
-   *
-   * @param path - Input path.
-   * @returns The extension (e.g., ".txt") or an empty string if none.
+    /**
+   * Returns the extension of the path, including the leading dot.
+   *
+   * Behavior:
+   * - Based on the result of `basename`.
+   * - If there is no dot, returns an empty string.
+   *
+   * Examples:
+   * - extname('/a/b/c.txt') -\> '.txt'
+   * - extname('/a/b/c') -\> ''
+   *
+   * @param path - Input path.
+   * @returns The extension (e.g., ".txt") or an empty string if none.
    */ static extname(path) {
         const basename = this.basename(path);
         const lastDot = basename.lastIndexOf('.');
         return lastDot === -1 ? '' : basename.slice(lastDot);
     }
-    /**
-   * Sanitizes a file or directory name by replacing or removing invalid characters.
-   *
-   * Behavior:
-   * - Removes or replaces characters that are invalid in common filesystems.
-   * - Trims leading/trailing spaces and dots.
-   * - Collapses multiple spaces into single spaces.
-   * - Replaces reserved names with safe alternatives.
-   * - Optionally limits the length of the result.
-   *
-   * Examples:
-   * - sanitizeFilename('my file.txt') -\> 'my file.txt'
-   * - sanitizeFilename('file:name*.txt') -\> 'file_name_.txt'
-   * - sanitizeFilename('  .hidden  ') -\> 'hidden'
-   * - sanitizeFilename('CON') -\> '_CON'
-   * - sanitizeFilename('a'.repeat(300)) -\> (truncated to maxLength)
-   *
-   * @param filename - Input filename to sanitize.
-   * @param options - Optional configuration.
-   * @returns Sanitized filename safe for use across platforms.
+    /**
+   * Sanitizes a file or directory name by replacing or removing invalid characters.
+   *
+   * Behavior:
+   * - Removes or replaces characters that are invalid in common filesystems.
+   * - Trims leading/trailing spaces and dots.
+   * - Collapses multiple spaces into single spaces.
+   * - Replaces reserved names with safe alternatives.
+   * - Optionally limits the length of the result.
+   *
+   * Examples:
+   * - sanitizeFilename('my file.txt') -\> 'my file.txt'
+   * - sanitizeFilename('file:name*.txt') -\> 'file_name_.txt'
+   * - sanitizeFilename('  .hidden  ') -\> 'hidden'
+   * - sanitizeFilename('CON') -\> '_CON'
+   * - sanitizeFilename('a'.repeat(300)) -\> (truncated to maxLength)
+   *
+   * @param filename - Input filename to sanitize.
+   * @param options - Optional configuration.
+   * @returns Sanitized filename safe for use across platforms.
    */ static sanitizeFilename(filename, options) {
         const { replacement = '_', maxLength = 255, asciiOnly = false } = options ?? {};
         const reserved = /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])$/i;
@@ -10097,32 +10097,32 @@ const mimeTypes = {
         }
         return sanitized;
     }
-    /**
-   * Determines whether the path is absolute.
-   *
-   * Definition here: absolute paths start with "/".
-   *
-   * @param path - Input path.
-   * @returns True if the path starts with "/", otherwise false.
+    /**
+   * Determines whether the path is absolute.
+   *
+   * Definition here: absolute paths start with "/".
+   *
+   * @param path - Input path.
+   * @returns True if the path starts with "/", otherwise false.
    */ static isAbsolute(path) {
         return path.startsWith('/');
     }
-    /**
-   * Computes a relative path from one path to another.
-   *
-   * Behavior:
-   * - Both `from` and `to` are normalized first.
-   * - The returned path does not start with "/" (relative form).
-   * - If both resolve to the same path, returns ".".
-   *
-   * Examples:
-   * - relative('/a/b/c', '/a/d/e') -\> '../../d/e'
-   * - relative('/a/b', '/a/b/c') -\> 'c'
-   * - relative('/a/b', '/a/b') -\> '.'
-   *
-   * @param from - Base path to start from.
-   * @param to - Target path to reach.
-   * @returns Relative path from `from` to `to`.
+    /**
+   * Computes a relative path from one path to another.
+   *
+   * Behavior:
+   * - Both `from` and `to` are normalized first.
+   * - The returned path does not start with "/" (relative form).
+   * - If both resolve to the same path, returns ".".
+   *
+   * Examples:
+   * - relative('/a/b/c', '/a/d/e') -\> '../../d/e'
+   * - relative('/a/b', '/a/b/c') -\> 'c'
+   * - relative('/a/b', '/a/b') -\> '.'
+   *
+   * @param from - Base path to start from.
+   * @param to - Target path to reach.
+   * @returns Relative path from `from` to `to`.
    */ static relative(from, to) {
         const fromParts = this.normalize(from).split('/').filter(Boolean);
         const toParts = this.normalize(to).split('/').filter(Boolean);
@@ -10135,37 +10135,37 @@ const mimeTypes = {
         return up + down || '.';
     }
 }
-/**
- * Guesses the MIME type based on a file path or file name.
- *
- * Behavior:
- * - Uses `PathUtils.extname` to extract the extension (case-insensitive).
- * - Falls back to `application/octet-stream` if unknown.
- *
- * Notes:
- * - The mapping is intentionally minimal and web-oriented.
- * - Extend the `mimeTypes` table if you need additional types.
- *
- * Examples:
- * - guessMimeType('image.png') -\> 'image/png'
- * - guessMimeType('/a/b/model.glb') -\> 'model/gltf-binary'
- * - guessMimeType('unknown.ext') -\> 'application/octet-stream'
- *
- * @param path - File path or name used to infer the MIME type.
- * @returns The guessed MIME type string.
- *
- * @public
+/**
+ * Guesses the MIME type based on a file path or file name.
+ *
+ * Behavior:
+ * - Uses `PathUtils.extname` to extract the extension (case-insensitive).
+ * - Falls back to `application/octet-stream` if unknown.
+ *
+ * Notes:
+ * - The mapping is intentionally minimal and web-oriented.
+ * - Extend the `mimeTypes` table if you need additional types.
+ *
+ * Examples:
+ * - guessMimeType('image.png') -\> 'image/png'
+ * - guessMimeType('/a/b/model.glb') -\> 'model/gltf-binary'
+ * - guessMimeType('unknown.ext') -\> 'application/octet-stream'
+ *
+ * @param path - File path or name used to infer the MIME type.
+ * @returns The guessed MIME type string.
+ *
+ * @public
  */ function guessMimeType(path) {
     const ext = PathUtils.extname(path).toLowerCase();
     return mimeTypes[ext] || 'application/octet-stream';
 }
-/**
- * Gets the MIME type based on a file extension.
- *
- * @param ext - File extension (e.g., "png", ".jpg").
- * @returns The corresponding MIME type or 'application/octet-stream' if unknown.
- *
- * @public
+/**
+ * Gets the MIME type based on a file extension.
+ *
+ * @param ext - File extension (e.g., "png", ".jpg").
+ * @returns The corresponding MIME type or 'application/octet-stream' if unknown.
+ *
+ * @public
  */ function mimeTypeOf(ext) {
     ext = ext.toLowerCase();
     if (!ext.startsWith('.')) {