dsh-3d-viewer 0.1.0 → 0.1.1

package/index.js

@@ -1,7 +1,167 @@
 /**
  * Host half of the 3D viewer bundle.
  *
- * The viewer is entirely browser-side: it extends the right Sidebar's
- * document-preview registry, so it registers nothing in the Host tree.
+ * The viewer itself runs in the browser, but its four HDRI environments are
+ * packaged as `.hdr` files instead of base64 inside the client bundle: a web
+ * page has no URL for a file inside an installed plugin package. This half
+ * registers one read-only route that serves those files from the package the
+ * host already loaded, so the browser can fetch them like any other asset.
+ *
+ * The route is public by design. The HDRIs are CC0 images, the route answers
+ * only GET/HEAD, and it maps a fixed whitelist of names to files — it never
+ * accepts a caller-chosen path, so there is nothing to traverse and nothing
+ * secret to leak. This mirrors how other Host plugins serve their own assets.
+ */
+import { readFile } from 'node:fs/promises';
+
+/**
+ * Route prefix registered with the host web server.
+ *
+ * No trailing slash: `webServer.match` accepts a prefix only when the request
+ * pathname equals it or starts with `${prefix}/`. A registered `/hdri/` would
+ * therefore never match `/hdri/nature.hdr`.
+ */
+export const HDRI_ROUTE = '/dsh-3d-viewer/hdri';
+
+/** Request prefix, with the slash the route matcher expects after the prefix. */
+const HDRI_PREFIX = `${HDRI_ROUTE}/`;
+
+/** Environment id to packaged file name. Mirrors `ENVIRONMENT_IDS` client-side. */
+const HDRI_FILES = Object.freeze({
+  nature: 'nature.hdr',
+  city: 'city.hdr',
+  indoor: 'indoor.hdr',
+  studio: 'studio.hdr',
+});
+
+/** Request name (`<id>.hdr`) to packaged file name. */
+const HDRI_PATHS = new Map(
+  Object.entries(HDRI_FILES).map(([id, file]) => [`${id}.hdr`, file]),
+);
+
+const HDRI_TYPE = 'image/vnd.radiance';
+// The client appends `?v=<package version>`, so a long immutable lifetime is
+// safe: an upgrade changes the URL instead of reusing a stale cached response.
+const HDRI_CACHE_CONTROL = 'public, max-age=31536000, immutable';
+
+/**
+ * Packaged HDRIs read once per host process.
+ *
+ * The files belong to an installed (immutable) package, so caching decoded
+ * query results is safe; a rebuilt package restarts the host.
+ *
+ * @type {Map<string, Promise<Buffer>>}
+ */
+const fileCache = new Map();
+
+/**
+ * Read one packaged HDRI, reusing an earlier read.
+ *
+ * @param {string} file Packaged file name.
+ * @returns {Promise<Buffer>} File contents.
+ */
+function readHdriFile(file) {
+  const cached = fileCache.get(file);
+  if (cached !== undefined) return cached;
+
+  const task = readFile(new URL(`./assets/hdri/${file}`, import.meta.url));
+  task.catch(() => fileCache.delete(file));
+  fileCache.set(file, task);
+  return task;
+}
+
+/**
+ * Answer one request with a short plain-text response.
+ *
+ * @param {import('node:http').ServerResponse} response Response to finish.
+ * @param {number} status HTTP status.
+ * @param {string} message Body text.
+ * @param {Record<string, string | number>} [headers] Extra headers.
+ * @param {boolean} [headOnly] Omit the body for a HEAD request.
+ */
+function sendText(response, status, message, headers = {}, headOnly = false) {
+  response.writeHead(status, {
+    'content-type': 'text/plain; charset=utf-8',
+    'content-length': Buffer.byteLength(message),
+    ...headers,
+  });
+  response.end(headOnly ? undefined : message);
+}
+
+/**
+ * Create the read-only route that serves the packaged HDRIs.
+ *
+ * @returns {{
+ *   kind: 'prefix',
+ *   path: string,
+ *   handler: (request: import('node:http').IncomingMessage, response: import('node:http').ServerResponse) => Promise<void>,
+ * }} A WebRoute for the host `webServer` service.
+ */
+export function createHdriRoute() {
+  return {
+    kind: 'prefix',
+    path: HDRI_ROUTE,
+
+    async handler(request, response) {
+      if (request.method !== 'GET' && request.method !== 'HEAD') {
+        sendText(response, 405, 'Method not allowed', { allow: 'GET, HEAD' });
+        return;
+      }
+
+      const headOnly = request.method === 'HEAD';
+      let pathname;
+      try {
+        pathname = new URL(request.url ?? '', 'http://localhost').pathname;
+      } catch {
+        sendText(response, 400, 'Malformed request URL', {}, headOnly);
+        return;
+      }
+
+      // Only the exact `<id>.hdr` names in the whitelist resolve. Percent
+      // escapes are never decoded, so `..%2fpackage.json` stays a miss.
+      const name = pathname.startsWith(HDRI_PREFIX) ? pathname.slice(HDRI_PREFIX.length) : '';
+      const file = HDRI_PATHS.get(name);
+      if (file === undefined) {
+        sendText(response, 404, 'Unknown HDRI', {}, headOnly);
+        return;
+      }
+
+      let body;
+      try {
+        body = await readHdriFile(file);
+      } catch (error) {
+        console.warn(`[dsh-3d-viewer] Could not read the packaged HDRI "${file}".`, error);
+        sendText(response, 500, 'The packaged HDRI could not be read', {}, headOnly);
+        return;
+      }
+
+      response.writeHead(200, {
+        'content-type': HDRI_TYPE,
+        'content-length': body.length,
+        'cache-control': HDRI_CACHE_CONTROL,
+      });
+      if (headOnly) response.end();
+      else response.end(body);
+    },
+  };
+}
+
+/**
+ * Register the HDRI route once the composition provides a web server.
+ *
+ * The service is acquired through `ctx.inject`, not `ctx.get`: a Host plugin
+ * applies before sibling rows finish loading, so a direct probe can run while
+ * `webServer` is still absent. `inject` keeps the callback dormant until the
+ * service exists and disposes the route with the plugin. A non-web runtime has
+ * no `webServer`, and this half never registers anything there.
+ *
+ * @param {import('@deepseek-ai/cordis').Context} ctx Owning Host context.
  */
-export function apply() {}
+export function apply(ctx) {
+  ctx.inject(['webServer'], (hostCtx) => {
+    hostCtx.effect(
+      () => hostCtx.webServer.register(createHdriRoute()),
+      'dsh-3d-viewer: HDRI route',
+    );
+  });
+}

package/package.json

@@ -1,7 +1,21 @@
 {
   "name": "dsh-3d-viewer",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Render FBX, OBJ, glTF, GLB, and STL models from the right Sidebar's workspace file tree in an orbitable 3D view.",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "3d-viewer"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ybniaobu/dsh-3d-viewer.git"
+  },
+  "homepage": "https://github.com/ybniaobu/dsh-3d-viewer#readme",
+  "bugs": {
+    "url": "https://github.com/ybniaobu/dsh-3d-viewer/issues"
+  },
   "type": "module",
   "icon": "./icon.svg",
   "exports": {
@@ -21,10 +35,7 @@
     "LICENSE",
     "THIRD_PARTY_NOTICES.md",
     "icon.svg",
-    "src",
-    "assets",
-    "scripts",
-    "build.mjs"
+    "assets/hdri"
   ],
   "dsh": {
     "bundle": {
@@ -41,8 +52,16 @@
   },
   "scripts": {
     "build": "node build.mjs",
-    "embed:hdri": "node scripts/embed-hdri.mjs --force",
     "test": "node tests/run.mjs"
   },
+  "devDependencies": {
+    "esbuild": "^0.28.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "three": "^0.187.0"
+  },
+  "engines": {
+    "dsh": ">=0.2.2-rc.1"
+  },
   "license": "MIT"
 }

package/build.mjs

@@ -1,49 +0,0 @@
-import { spawnSync } from 'node:child_process';
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { embedHdri } from './scripts/embed-hdri.mjs';
-
-const root = dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(await readFile(resolve(root, 'package.json'), 'utf8'));
-const esbuildBin = resolve(root, 'node_modules/esbuild/bin/esbuild');
-const bundlePath = resolve(root, '.build/client.bundle.cjs');
-
-await embedHdri();
-await mkdir(dirname(bundlePath), { recursive: true });
-
-const result = spawnSync(process.execPath, [
-  esbuildBin,
-  resolve(root, 'src/client.js'),
-  '--bundle',
-  '--format=cjs',
-  '--platform=browser',
-  '--target=chrome120,edge120',
-  '--external:react',
-  '--minify',
-  '--legal-comments=none',
-  '--log-level=warning',
-  `--outfile=${bundlePath}`,
-], {
-  cwd: root,
-  stdio: 'inherit',
-});
-
-if (result.error !== undefined) throw result.error;
-if (result.status !== 0) process.exit(result.status ?? 1);
-
-const code = (await readFile(bundlePath, 'utf8')).trimEnd();
-const wrapped = `/*! dsh-3d-viewer | bundles Three.js (MIT), FBXLoader, OBJLoader, MTLLoader, GLTFLoader, STLLoader, OrbitControls and HDRLoader (MIT), plus embedded Poly Haven CC0 HDRIs. See THIRD_PARTY_NOTICES.md for third-party licenses. */
-window.__ModuleLoader__.load({
-  id: ${JSON.stringify(pkg.name)},
-  factory(require) {
-    var module = { exports: {} };
-    var exports = module.exports;
-${code}
-    return module.exports;
-  },
-});
-`;
-
-await writeFile(resolve(root, 'client.js'), wrapped);
-console.log(`Built client.js (${Buffer.byteLength(wrapped)} bytes) for ${pkg.name}.`);

package/scripts/embed-hdri.mjs

@@ -1,70 +0,0 @@
-import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-const files = {
-  nature: 'nature.hdr',
-  city: 'city.hdr',
-  indoor: 'indoor.hdr',
-  studio: 'studio.hdr',
-};
-
-const targetPath = resolve(root, 'src', 'generated', 'hdri-data.js');
-const scriptPath = fileURLToPath(import.meta.url);
-
-async function mtime(path) {
-  try {
-    return (await stat(path)).mtimeMs;
-  } catch {
-    return 0;
-  }
-}
-
-async function isUpToDate() {
-  const targetInfo = await stat(targetPath).catch(() => null);
-  if (targetInfo === null || targetInfo.size === 0) return false;
-
-  const assets = Object.values(files).map((file) => resolve(root, 'assets', 'hdri', file));
-  const newestSource = Math.max(await mtime(scriptPath), ...(await Promise.all(assets.map(mtime))));
-  return targetInfo.mtimeMs >= newestSource;
-}
-
-/**
- * Embed the four CC0 HDRIs into a generated ES module.
- *
- * The generated module is reused when it is newer than every source asset, so
- * repeated builds do not re-read and re-encode ~8.7 MB of base64 text.
- *
- * @param {{ force?: boolean }} [options] Regenerate even when the cache is fresh.
- * @returns {Promise<boolean>} Whether the file was rewritten.
- */
-export async function embedHdri({ force = false } = {}) {
-  if (!force && await isUpToDate()) {
-    console.log('Embedded HDRIs are up to date; skipped regeneration.');
-    return false;
-  }
-
-  const entries = [];
-  for (const [id, file] of Object.entries(files)) {
-    const data = await readFile(resolve(root, 'assets', 'hdri', file));
-    const dataUrl = `data:application/octet-stream;base64,${data.toString('base64')}`;
-    entries.push(`  ${id}: ${JSON.stringify(dataUrl)},`);
-  }
-
-  const source = `// Generated by scripts/embed-hdri.mjs from assets/hdri/*.hdr. Do not edit.
-// HDRIs are Poly Haven CC0 assets; see assets/hdri/LICENSE.md.
-export const HDRI_DATA_URLS = {
-${entries.join('\n')}
-};
-`;
-  await mkdir(dirname(targetPath), { recursive: true });
-  await writeFile(targetPath, source);
-  console.log(`Embedded ${entries.length} HDRIs into src/generated/hdri-data.js.`);
-  return true;
-}
-
-const invokedDirectly = process.argv[1] !== undefined
-  && resolve(process.argv[1]) === fileURLToPath(import.meta.url);
-
-if (invokedDirectly) await embedHdri({ force: process.argv.includes('--force') });

package/src/bytes.js

@@ -1,158 +0,0 @@
-/**
- * Byte, text, and path helpers shared by the model loaders.
- *
- * The loaders previously carried their own copies of these conversions
- * (`toArrayBuffer`, `decodeText`, `localPath`, `mimeOf`, `abortError`), which
- * drifted apart over time. One module keeps their edge cases consistent.
- */
-
-/** URLs Three.js resolves itself instead of the DSH workspace. */
-export const REMOTE_URL = /^(?:data:|blob:|https?:|file:|\/\/)/iu;
-
-/** Local paths anchored at a drive letter or a POSIX root. */
-export const ABSOLUTE_PATH = /^(?:[A-Za-z]:[\\/]|\/)/u;
-
-const MIME_TYPES = new Map([
-  ['bin', 'application/octet-stream'],
-  ['png', 'image/png'],
-  ['jpg', 'image/jpeg'],
-  ['jpeg', 'image/jpeg'],
-  ['webp', 'image/webp'],
-  ['gif', 'image/gif'],
-  ['bmp', 'image/bmp'],
-  ['tga', 'image/x-tga'],
-  ['dds', 'image/vnd-ms.dds'],
-  ['exr', 'image/x-exr'],
-  ['hdr', 'image/vnd.radiance'],
-]);
-
-const UTF8 = new TextDecoder('utf-8');
-
-/**
- * Copy preview bytes into a standalone ArrayBuffer.
- *
- * A view into a larger buffer is copied, so the returned payload never keeps
- * the document-preview store's memory alive. Text is encoded as UTF-8 for the
- * loaders that also accept a decoded document.
- *
- * @param {Uint8Array | ArrayBuffer | string} data Complete file bytes or text.
- * @returns {ArrayBuffer} A standalone payload.
- */
-export function toArrayBuffer(data) {
-  if (data instanceof ArrayBuffer) return data;
-  if (ArrayBuffer.isView(data)) {
-    return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
-  }
-  if (typeof data === 'string') return new TextEncoder().encode(data).buffer;
-  throw new TypeError('The 3D preview was not given binary data');
-}
-
-/**
- * View preview bytes as a Uint8Array without copying, encoding text inputs.
- *
- * @param {Uint8Array | ArrayBuffer | string} data Complete file bytes or text.
- * @returns {Uint8Array} Byte view of the payload.
- */
-export function toBytes(data) {
-  if (data instanceof ArrayBuffer) return new Uint8Array(data);
-  if (ArrayBuffer.isView(data)) {
-    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-  }
-  if (typeof data === 'string') return new TextEncoder().encode(data);
-  throw new TypeError('The 3D preview was not given model data');
-}
-
-/**
- * Decode text-format model data, decoding bytes as UTF-8.
- *
- * @param {Uint8Array | ArrayBuffer | string} data Complete file bytes or text.
- * @returns {string} Decoded text.
- */
-export function decodeText(data) {
-  if (typeof data === 'string') return data;
-  if (data instanceof ArrayBuffer) return UTF8.decode(data);
-  if (ArrayBuffer.isView(data)) return UTF8.decode(data);
-  throw new TypeError('The 3D preview was not given model data');
-}
-
-/**
- * Turn a loader URL into a workspace-relative path.
- *
- * Query and fragment suffixes are dropped and percent escapes are decoded;
- * backslashes are normalized so Windows-authored MTL/FBX/glTF references
- * resolve on every platform.
- *
- * @param {string} value Loader URL or asset path.
- * @returns {string} Normalized forward-slash path.
- */
-export function decodeLocalPath(value) {
-  const withoutSuffix = String(value).split(/[?#]/u, 1)[0];
-  try {
-    return decodeURIComponent(withoutSuffix).replaceAll('\\', '/');
-  } catch {
-    return withoutSuffix.replaceAll('\\', '/');
-  }
-}
-
-/**
- * Whether a loader URL must be read from the session workspace.
- *
- * @param {unknown} value Loader URL or asset path.
- * @returns {boolean} True for relative or absolute local paths.
- */
-export function isLocalPath(value) {
-  return typeof value === 'string' && value !== '' && REMOTE_URL.test(value) === false;
-}
-
-/**
- * Guess a blob MIME type from a file name.
- *
- * @param {unknown} value File name, path, or loader URL.
- * @returns {string} A MIME type, defaulting to application/octet-stream.
- */
-export function mimeOf(value) {
-  const path = decodeLocalPath(value);
-  const extension = path.slice(path.lastIndexOf('.') + 1).toLowerCase();
-  return MIME_TYPES.get(extension) ?? 'application/octet-stream';
-}
-
-/**
- * Decode a base64 payload into bytes.
- *
- * `Uint8Array.fromBase64` is used when the runtime provides it; the manual
- * fallback keeps older browsers working.
- *
- * @param {string} value Base64 payload without a data-URL prefix.
- * @returns {Uint8Array} Decoded bytes.
- */
-export function decodeBase64(value) {
-  if (typeof Uint8Array.fromBase64 === 'function') return Uint8Array.fromBase64(value);
-
-  const binary = atob(value);
-  const bytes = new Uint8Array(binary.length);
-  for (let index = 0; index < binary.length; index += 1) {
-    bytes[index] = binary.charCodeAt(index);
-  }
-  return bytes;
-}
-
-/**
- * Create the error a cancelled load rejects with.
- *
- * @param {string} [message] Human-readable reason.
- * @returns {Error} Error named `AbortError`.
- */
-export function abortError(message = 'Model loading was cancelled.') {
-  const error = new Error(message);
-  error.name = 'AbortError';
-  return error;
-}
-
-/**
- * Log a recoverable loading problem without failing the whole preview.
- *
- * @param {string} message Diagnostic message.
- */
-export function warn(message) {
-  if (typeof console !== 'undefined') console.warn(message);
-}

package/src/client.js

@@ -1,57 +0,0 @@
-import { FORMAT_ENTRIES } from './formats.js';
-import { readWorkspaceFile } from './loaders/workspace.js';
-import { VIEWER_COMPONENTS } from './ui/ModelViewer.js';
-import { en, zh } from './ui/dictionaries.js';
-
-const NS = 'dsh3dViewer';
-const BODY_SLOT = 'sidebar.right.tab.document';
-
-export const inject = ['documentPreviews', 'slots', 'locale', 'remote', 'remote.workspaceFiles'];
-
-/**
- * Register one document format and its right-Sidebar view body.
- *
- * @param {import('@deepseek-ai/cordis').Context} ctx Owning Client context.
- * @param {(key: string) => string} t Namespace-bound translator.
- * @param {import('./formats.js').FormatDefinition} entry Format definition.
- */
-function registerPreview(ctx, t, entry) {
-  const component = VIEWER_COMPONENTS[entry.format];
-
-  ctx.effect(() => ctx.documentPreviews.register({
-    id: entry.id,
-    extensions: [...entry.extensions],
-    binaryExtensions: [...entry.extensions],
-    priority: 'extension',
-    title: () => t(entry.titleKey),
-    loading: 'bytes-complete',
-    wrap: false,
-  }), `dsh-3d-viewer: ${entry.label} document preview`);
-
-  ctx.effect(() => ctx.slots.inject(BODY_SLOT, () => ctx.slots.register({
-    name: BODY_SLOT,
-    key: entry.id,
-    locale: NS,
-    inject: () => ({
-      fallbackT: t,
-      readWorkspaceFile: (address, path, options) => readWorkspaceFile(ctx.remote, address, path, options),
-    }),
-  }, component)), `dsh-3d-viewer: ${entry.label} viewer body`);
-}
-
-/**
- * Register the FBX, OBJ, glTF/GLB, and STL document renderers and their view
- * bodies in the right Sidebar.
- *
- * Formats come from the shared registry, so registration, badges, and viewer
- * components cannot drift apart.
- *
- * @param {import('@deepseek-ai/cordis').Context} ctx Owning Client context.
- */
-export function apply(ctx) {
-  const t = ctx.locale.bind(NS);
-
-  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-3d-viewer: dictionaries');
-
-  for (const entry of FORMAT_ENTRIES) registerPreview(ctx, t, entry);
-}

package/src/formats.js

@@ -1,100 +0,0 @@
-/**
- * The single registry of document formats this plugin renders.
- *
- * Registration (client.js), the viewer factories (ui/ModelViewer.js), the HUD
- * badge (ui/chrome.js), and format normalization all derive from this table,
- * so a format is declared exactly once instead of in four parallel lists.
- */
-
-/**
- * @typedef {{
- *   id: string,
- *   format: 'fbx' | 'obj' | 'gltf' | 'stl',
- *   extensions: readonly string[],
- *   titleKey: string,
- *   badgeKey: string,
- *   glbBadgeKey?: string,
- *   label: string,
- * }} FormatDefinition
- */
-
-/** @type {Readonly<Record<string, FormatDefinition>>} */
-export const FORMATS = Object.freeze({
-  fbx: Object.freeze({
-    id: 'dsh-3d-viewer/fbx',
-    format: 'fbx',
-    extensions: Object.freeze(['fbx']),
-    titleKey: 'rendererTitle',
-    badgeKey: 'badge',
-    label: 'FBX',
-  }),
-  obj: Object.freeze({
-    id: 'dsh-3d-viewer/obj',
-    format: 'obj',
-    extensions: Object.freeze(['obj']),
-    titleKey: 'objRendererTitle',
-    badgeKey: 'objBadge',
-    label: 'OBJ',
-  }),
-  gltf: Object.freeze({
-    id: 'dsh-3d-viewer/gltf',
-    format: 'gltf',
-    extensions: Object.freeze(['gltf', 'glb']),
-    titleKey: 'gltfRendererTitle',
-    badgeKey: 'gltfBadge',
-    glbBadgeKey: 'glbBadge',
-    label: 'glTF / GLB',
-  }),
-  stl: Object.freeze({
-    id: 'dsh-3d-viewer/stl',
-    format: 'stl',
-    extensions: Object.freeze(['stl']),
-    titleKey: 'stlRendererTitle',
-    badgeKey: 'stlBadge',
-    label: 'STL',
-  }),
-});
-
-/** Registration order, which is also the order of the sidebar preview list. */
-export const FORMAT_IDS = Object.freeze(Object.keys(FORMATS));
-
-/** @type {readonly FormatDefinition[]} */
-export const FORMAT_ENTRIES = Object.freeze(FORMAT_IDS.map((id) => FORMATS[id]));
-
-/**
- * Normalize a slot-provided format name.
- *
- * `glb` is an alias of `gltf`; unknown values fall back to the FBX viewer,
- * matching the previous default of the single viewer component.
- *
- * @param {unknown} value Requested format.
- * @returns {'fbx' | 'obj' | 'gltf' | 'stl'} A registered format.
- */
-export function normalizeFormat(value) {
-  if (value === 'glb') return 'gltf';
-  return typeof value === 'string' && Object.hasOwn(FORMATS, value)
-    ? /** @type {'fbx' | 'obj' | 'gltf' | 'stl'} */ (value)
-    : 'fbx';
-}
-
-/**
- * Resolve the dictionary key for a preview badge.
- *
- * @param {unknown} format Document format.
- * @param {boolean} [glb] Whether a glTF document is a binary GLB.
- * @returns {string} Dictionary key.
- */
-export function badgeKeyFor(format, glb = false) {
-  const entry = FORMATS[normalizeFormat(format)];
-  return glb === true && entry.glbBadgeKey !== undefined ? entry.glbBadgeKey : entry.badgeKey;
-}
-
-/**
- * Whether a document address points at a binary GLB container.
- *
- * @param {unknown} address Document resource address.
- * @returns {boolean} True for `.glb` paths, ignoring query and fragment suffixes.
- */
-export function isGlbAddress(address) {
-  return typeof address === 'string' && /\.glb(?:[?#]|$)/iu.test(address);
-}