@plasius/gpu-shared 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -16,6 +16,23 @@ All notable changes to this project will be documented in this file.
 - **Security**
   - (placeholder)
 
+## [1.0.1] - 2026-06-27
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - The shared harbor showcase now keeps the modeled lighthouse, dock, and
+    shoreline asset set even when `gpu_showcase_realistic_models_v1` is
+    disabled, falling back only to a brigantine-only ship catalog.
+
+- **Fixed**
+  - Added regression coverage for the flag-disabled modeled-harbor path and
+    the bounded legacy fallback used only when showcase asset loading fails.
+
+- **Security**
+  - (placeholder)
+
 ## [1.0.0] - 2026-06-27
 
 - **Added**
@@ -331,3 +348,4 @@ All notable changes to this project will be documented in this file.
 [0.1.19]: https://github.com/Plasius-LTD/gpu-shared/releases/tag/v0.1.19
 [0.1.20]: https://github.com/Plasius-LTD/gpu-shared/releases/tag/v0.1.20
 [1.0.0]: https://github.com/Plasius-LTD/gpu-shared/releases/tag/v1.0.0
+[1.0.1]: https://github.com/Plasius-LTD/gpu-shared/releases/tag/v1.0.1

package/README.md

@@ -209,6 +209,10 @@ distinct cutter profile, a modeled lighthouse, a dock/warehouse scene, and a
 generated rocky shoreline/breakwater so the harbor reads closer to a believable
 coastal night view on high-end machines.
 
+If `gpu_showcase_realistic_models_v1` is disabled, the harbor keeps the modeled
+lighthouse/dock/shoreline environment and falls back only to a brigantine-only
+ship catalog instead of reverting to placeholder harbor blocks.
+
 For slide-deck screenshots or video capture, open the route with
 `?capture=1&renderScale=1`. Capture mode hides the validation chrome, fills the
 viewport with the scene canvas, and caps the backing buffer at 1080p by default

package/dist/{chunk-CH3ZS5TQ.js → chunk-Z6SOXBHL.js}

@@ -11,7 +11,7 @@ var gpuSharedEnGbTranslations = Object.freeze({
   "gpuShared.showcase.details.booting": "Preparing a moonlit harbor scene, GLTF hull data, cloth and fluid continuity plans, and adaptive quality metadata.",
   "gpuShared.showcase.details.physics": "Stable world snapshots are emitted from {snapshotStageId} after the authoritative solver; the heavier hull now carries momentum through mass-aware collision impulses while cloth and fluid remain downstream.",
   "gpuShared.showcase.details.realistic": "Moonlit GLTF ships now mix a brigantine and a cutter against modeled harbor assets; cloth, fluid, and ship-local lighting stay continuous while the governor pressure is {pressureLevel}.",
-  "gpuShared.showcase.details.legacy": "Moonlit GLTF ships use the legacy brigantine and placeholder harbor blocks while cloth, fluid, and ship-local lighting stay continuous while the governor pressure is {pressureLevel}.",
+  "gpuShared.showcase.details.legacy": "Showcase fallback keeps the brigantine-only harbor path active while cloth, fluid, and ship-local lighting stay continuous under {pressureLevel} governor pressure.",
   "gpuShared.showcase.action.pause": "Pause",
   "gpuShared.showcase.action.resume": "Resume",
   "gpuShared.showcase.control.stressMode": "Stress mode",
@@ -116,4 +116,4 @@ export {
   translateGpuSharedText,
   createGpuSharedTranslator
 };
-//# sourceMappingURL=chunk-CH3ZS5TQ.js.map
+//# sourceMappingURL=chunk-Z6SOXBHL.js.map

package/dist/chunk-Z6SOXBHL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/feature-flags.js","../src/translations/en-GB.js","../src/i18n.js"],"sourcesContent":["export const GPU_SHOWCASE_REALISTIC_MODELS_FEATURE = \"gpu_showcase_realistic_models_v1\";\nexport const GPU_SHOWCASE_PRODUCT_STUDIO_FEATURE = \"gpu_showcase_product_studio_wavefront_v1\";\n","export const gpuSharedEnGbTranslations = Object.freeze({\n  \"gpuShared.showcase.title\": \"Flag by the Sea\",\n  \"gpuShared.showcase.subtitle\":\n    \"Shared 3D validation scene using GLTF ships, cloth, fluid continuity, adaptive performance, and telemetry.\",\n  \"gpuShared.showcase.status.booting\": \"Booting 3D scene...\",\n  \"gpuShared.showcase.status.live\": \"3D scene live - {fps} FPS\",\n  \"gpuShared.showcase.details.booting\":\n    \"Preparing a moonlit harbor scene, GLTF hull data, cloth and fluid continuity plans, and adaptive quality metadata.\",\n  \"gpuShared.showcase.details.physics\":\n    \"Stable world snapshots are emitted from {snapshotStageId} after the authoritative solver; the heavier hull now carries momentum through mass-aware collision impulses while cloth and fluid remain downstream.\",\n  \"gpuShared.showcase.details.realistic\":\n    \"Moonlit GLTF ships now mix a brigantine and a cutter against modeled harbor assets; cloth, fluid, and ship-local lighting stay continuous while the governor pressure is {pressureLevel}.\",\n  \"gpuShared.showcase.details.legacy\":\n    \"Showcase fallback keeps the brigantine-only harbor path active while cloth, fluid, and ship-local lighting stay continuous under {pressureLevel} governor pressure.\",\n  \"gpuShared.showcase.action.pause\": \"Pause\",\n  \"gpuShared.showcase.action.resume\": \"Resume\",\n  \"gpuShared.showcase.control.stressMode\": \"Stress mode\",\n  \"gpuShared.showcase.control.focus\": \"Focus\",\n  \"gpuShared.showcase.focus.integrated\": \"integrated\",\n  \"gpuShared.showcase.focus.lighting\": \"lighting\",\n  \"gpuShared.showcase.focus.cloth\": \"cloth\",\n  \"gpuShared.showcase.focus.fluid\": \"fluid\",\n  \"gpuShared.showcase.focus.physics\": \"physics\",\n  \"gpuShared.showcase.focus.performance\": \"performance\",\n  \"gpuShared.showcase.focus.debug\": \"debug\",\n  \"gpuShared.showcase.legend.title\": \"Scene\",\n  \"gpuShared.showcase.legend.shipMetadata\":\n    \"GLTF ships carry hull mass and damping metadata.\",\n  \"gpuShared.showcase.legend.lighting\":\n    \"Lanterns and torches warm the moonlit harbor.\",\n  \"gpuShared.showcase.legend.collisions\":\n    \"Mass-aware collisions stay authoritative near the camera.\",\n  \"gpuShared.showcase.section.sceneState\": \"Scene State\",\n  \"gpuShared.showcase.section.qualityBudgets\": \"Quality + Budgets\",\n  \"gpuShared.showcase.section.debugTelemetry\": \"Debug Telemetry\",\n  \"gpuShared.showcase.section.notes\": \"Notes\",\n  \"gpuShared.showcase.note.assetLoading\":\n    \"Ships are loaded from a GLTF asset and carry mass, damping, restitution, and hull extents from node extras.\",\n  \"gpuShared.showcase.note.moonlight\":\n    \"Moonlight sets the cold ambient read while deck lanterns and harbor torches provide warm local contrast.\",\n  \"gpuShared.showcase.note.continuity\":\n    \"Cloth and fluid continuity stay coherent across near, mid, far, and horizon bands even in the darker night palette.\",\n  \"gpuShared.showcase.note.performance\":\n    \"Performance pressure reduces visual detail before mass-weighted authoritative collision motion is touched.\",\n  \"gpuShared.showcase.note.physicsSnapshots\":\n    \"Stable world snapshots are taken after the authoritative rigid-body commit and before visual follow-up work.\",\n  \"gpuShared.showcase.note.physicsCollisions\":\n    \"The ships collide with mass-weighted impulses and positional correction, so the heavier hull keeps more of its line.\",\n  \"gpuShared.showcase.note.physicsLighting\":\n    \"Moonlight keeps the overall read legible while lanterns and torches make collision moments easy to track against the water.\",\n  \"gpuShared.debug.adapter.showcase\": \"3D showcase\",\n  \"gpuShared.debug.allocation.mainColorBuffer\": \"Main color buffer\",\n  \"gpuShared.debug.allocation.shadowImpressionAtlas\": \"Shadow impression atlas\",\n});\n","import { gpuSharedEnGbTranslations } from \"./translations/en-GB.js\";\n\nexport const gpuSharedTranslationKeys = Object.freeze({\n  showcaseTitle: \"gpuShared.showcase.title\",\n  showcaseSubtitle: \"gpuShared.showcase.subtitle\",\n  statusBooting: \"gpuShared.showcase.status.booting\",\n  statusLive: \"gpuShared.showcase.status.live\",\n  detailsBooting: \"gpuShared.showcase.details.booting\",\n  detailsPhysics: \"gpuShared.showcase.details.physics\",\n  detailsRealistic: \"gpuShared.showcase.details.realistic\",\n  detailsLegacy: \"gpuShared.showcase.details.legacy\",\n  pause: \"gpuShared.showcase.action.pause\",\n  resume: \"gpuShared.showcase.action.resume\",\n  stressMode: \"gpuShared.showcase.control.stressMode\",\n  focus: \"gpuShared.showcase.control.focus\",\n  focusIntegrated: \"gpuShared.showcase.focus.integrated\",\n  focusLighting: \"gpuShared.showcase.focus.lighting\",\n  focusCloth: \"gpuShared.showcase.focus.cloth\",\n  focusFluid: \"gpuShared.showcase.focus.fluid\",\n  focusPhysics: \"gpuShared.showcase.focus.physics\",\n  focusPerformance: \"gpuShared.showcase.focus.performance\",\n  focusDebug: \"gpuShared.showcase.focus.debug\",\n  legendTitle: \"gpuShared.showcase.legend.title\",\n  legendShipMetadata: \"gpuShared.showcase.legend.shipMetadata\",\n  legendLighting: \"gpuShared.showcase.legend.lighting\",\n  legendCollisions: \"gpuShared.showcase.legend.collisions\",\n  sceneState: \"gpuShared.showcase.section.sceneState\",\n  qualityBudgets: \"gpuShared.showcase.section.qualityBudgets\",\n  debugTelemetry: \"gpuShared.showcase.section.debugTelemetry\",\n  notes: \"gpuShared.showcase.section.notes\",\n  noteAssetLoading: \"gpuShared.showcase.note.assetLoading\",\n  noteMoonlight: \"gpuShared.showcase.note.moonlight\",\n  noteContinuity: \"gpuShared.showcase.note.continuity\",\n  notePerformance: \"gpuShared.showcase.note.performance\",\n  notePhysicsSnapshots: \"gpuShared.showcase.note.physicsSnapshots\",\n  notePhysicsCollisions: \"gpuShared.showcase.note.physicsCollisions\",\n  notePhysicsLighting: \"gpuShared.showcase.note.physicsLighting\",\n  debugAdapterShowcase: \"gpuShared.debug.adapter.showcase\",\n  debugMainColorBuffer: \"gpuShared.debug.allocation.mainColorBuffer\",\n  debugShadowImpressionAtlas: \"gpuShared.debug.allocation.shadowImpressionAtlas\",\n});\n\nexport const gpuSharedTranslations = Object.freeze({\n  \"en-GB\": gpuSharedEnGbTranslations,\n});\n\nfunction formatTranslation(template, args = {}) {\n  return template.replace(/\\{([A-Za-z0-9_]+)\\}/g, (match, name) => {\n    if (!Object.prototype.hasOwnProperty.call(args, name)) {\n      return match;\n    }\n\n    const value = args[name];\n    return value == null ? \"\" : String(value);\n  });\n}\n\nexport function translateGpuSharedText(key, args, translate) {\n  const translated = translate?.(key, args);\n  if (translated && translated !== key) {\n    return translated;\n  }\n\n  const fallback = gpuSharedEnGbTranslations[key];\n  return fallback ? formatTranslation(fallback, args) : key;\n}\n\nexport function createGpuSharedTranslator(translate) {\n  return (key, args) => translateGpuSharedText(key, args, translate);\n}\n\n"],"mappings":";AAAO,IAAM,wCAAwC;AAC9C,IAAM,sCAAsC;;;ACD5C,IAAM,4BAA4B,OAAO,OAAO;AAAA,EACrD,4BAA4B;AAAA,EAC5B,+BACE;AAAA,EACF,qCAAqC;AAAA,EACrC,kCAAkC;AAAA,EAClC,sCACE;AAAA,EACF,sCACE;AAAA,EACF,wCACE;AAAA,EACF,qCACE;AAAA,EACF,mCAAmC;AAAA,EACnC,oCAAoC;AAAA,EACpC,yCAAyC;AAAA,EACzC,oCAAoC;AAAA,EACpC,uCAAuC;AAAA,EACvC,qCAAqC;AAAA,EACrC,kCAAkC;AAAA,EAClC,kCAAkC;AAAA,EAClC,oCAAoC;AAAA,EACpC,wCAAwC;AAAA,EACxC,kCAAkC;AAAA,EAClC,mCAAmC;AAAA,EACnC,0CACE;AAAA,EACF,sCACE;AAAA,EACF,wCACE;AAAA,EACF,yCAAyC;AAAA,EACzC,6CAA6C;AAAA,EAC7C,6CAA6C;AAAA,EAC7C,oCAAoC;AAAA,EACpC,wCACE;AAAA,EACF,qCACE;AAAA,EACF,sCACE;AAAA,EACF,uCACE;AAAA,EACF,4CACE;AAAA,EACF,6CACE;AAAA,EACF,2CACE;AAAA,EACF,oCAAoC;AAAA,EACpC,8CAA8C;AAAA,EAC9C,oDAAoD;AACtD,CAAC;;;ACnDM,IAAM,2BAA2B,OAAO,OAAO;AAAA,EACpD,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,kBAAkB;AAAA,EAClB,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,kBAAkB;AAAA,EAClB,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,OAAO;AAAA,EACP,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,sBAAsB;AAAA,EACtB,uBAAuB;AAAA,EACvB,qBAAqB;AAAA,EACrB,sBAAsB;AAAA,EACtB,sBAAsB;AAAA,EACtB,4BAA4B;AAC9B,CAAC;AAEM,IAAM,wBAAwB,OAAO,OAAO;AAAA,EACjD,SAAS;AACX,CAAC;AAED,SAAS,kBAAkB,UAAU,OAAO,CAAC,GAAG;AAC9C,SAAO,SAAS,QAAQ,wBAAwB,CAAC,OAAO,SAAS;AAC/D,QAAI,CAAC,OAAO,UAAU,eAAe,KAAK,MAAM,IAAI,GAAG;AACrD,aAAO;AAAA,IACT;AAEA,UAAM,QAAQ,KAAK,IAAI;AACvB,WAAO,SAAS,OAAO,KAAK,OAAO,KAAK;AAAA,EAC1C,CAAC;AACH;AAEO,SAAS,uBAAuB,KAAK,MAAM,WAAW;AAC3D,QAAM,aAAa,YAAY,KAAK,IAAI;AACxC,MAAI,cAAc,eAAe,KAAK;AACpC,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,0BAA0B,GAAG;AAC9C,SAAO,WAAW,kBAAkB,UAAU,IAAI,IAAI;AACxD;AAEO,SAAS,0BAA0B,WAAW;AACnD,SAAO,CAAC,KAAK,SAAS,uBAAuB,KAAK,MAAM,SAAS;AACnE;","names":[]}

package/dist/index.cjs

@@ -137,7 +137,7 @@ var init_en_GB = __esm({
       "gpuShared.showcase.details.booting": "Preparing a moonlit harbor scene, GLTF hull data, cloth and fluid continuity plans, and adaptive quality metadata.",
       "gpuShared.showcase.details.physics": "Stable world snapshots are emitted from {snapshotStageId} after the authoritative solver; the heavier hull now carries momentum through mass-aware collision impulses while cloth and fluid remain downstream.",
       "gpuShared.showcase.details.realistic": "Moonlit GLTF ships now mix a brigantine and a cutter against modeled harbor assets; cloth, fluid, and ship-local lighting stay continuous while the governor pressure is {pressureLevel}.",
-      "gpuShared.showcase.details.legacy": "Moonlit GLTF ships use the legacy brigantine and placeholder harbor blocks while cloth, fluid, and ship-local lighting stay continuous while the governor pressure is {pressureLevel}.",
+      "gpuShared.showcase.details.legacy": "Showcase fallback keeps the brigantine-only harbor path active while cloth, fluid, and ship-local lighting stay continuous under {pressureLevel} governor pressure.",
       "gpuShared.showcase.action.pause": "Pause",
       "gpuShared.showcase.action.resume": "Resume",
       "gpuShared.showcase.control.stressMode": "Stress mode",
@@ -4080,42 +4080,74 @@ function buildTrianglesFromMesh(mesh, transform, colorOverride, camera, viewport
     }
   }
 }
-async function loadShowcaseAssetCatalog() {
-  const [brigantine, cutter, lighthouse, harborDock, shoreline] = await Promise.all([
+function createShowcaseAssetCatalog({
+  mode,
+  ships,
+  environment,
+  primaryShipKey = "brigantine",
+  fallbackReason = null
+}) {
+  return Object.freeze({
+    mode,
+    primaryShipKey,
+    ships: Object.freeze(ships),
+    environment: Object.freeze(environment),
+    fallbackReason
+  });
+}
+function normalizeAssetCatalogFailureReason(error) {
+  if (typeof error?.message === "string" && error.message.trim().length > 0) {
+    return error.message;
+  }
+  return "showcase asset loading failed";
+}
+async function loadShowcaseAssetCatalog({ includeSecondaryShip = true } = {}) {
+  const [brigantine, lighthouse, harborDock, shoreline] = await Promise.all([
     loadGltfModel(resolveShowcaseAssetUrl("brigantine")),
-    loadGltfModel(resolveShowcaseAssetUrl("cutter")),
     loadGltfModel(resolveShowcaseAssetUrl("lighthouse")),
     loadGltfModel(resolveShowcaseAssetUrl("harbor-dock")),
     loadGltfModel(resolveShowcaseAssetUrl("shoreline"))
   ]);
-  return Object.freeze({
-    primaryShipKey: "brigantine",
-    ships: Object.freeze({
-      brigantine,
-      cutter
-    }),
-    environment: Object.freeze({
+  const ships = {
+    brigantine
+  };
+  if (includeSecondaryShip) {
+    ships.cutter = await loadGltfModel(resolveShowcaseAssetUrl("cutter"));
+  }
+  return createShowcaseAssetCatalog({
+    mode: includeSecondaryShip ? "modeled-rich" : "modeled-baseline",
+    ships,
+    environment: {
       lighthouse,
       "harbor-dock": harborDock,
       shoreline
-    })
+    }
   });
 }
-function createLegacyShowcaseAssetCatalog() {
-  const brigantine = loadGltfModel(resolveShowcaseAssetUrl("brigantine"));
-  return Promise.resolve(brigantine).then(
-    (primary) => Object.freeze({
-      primaryShipKey: "brigantine",
-      ships: Object.freeze({
-        brigantine: primary
-      }),
-      environment: Object.freeze({})
-    })
-  );
+async function createLegacyShowcaseAssetCatalog(error = null) {
+  const brigantine = await loadGltfModel(resolveShowcaseAssetUrl("brigantine"));
+  return createShowcaseAssetCatalog({
+    mode: "legacy-fallback",
+    ships: {
+      brigantine
+    },
+    environment: {},
+    fallbackReason: normalizeAssetCatalogFailureReason(error)
+  });
+}
+async function loadShowcaseAssetCatalogWithFallback({ includeSecondaryShip = true } = {}) {
+  try {
+    return await loadShowcaseAssetCatalog({ includeSecondaryShip });
+  } catch (error) {
+    return createLegacyShowcaseAssetCatalog(error);
+  }
 }
 function resolveShipModel(state, ship, fallbackModel = null) {
   return state.assetCatalog?.ships?.[ship.modelKey ?? state.assetCatalog?.primaryShipKey ?? "brigantine"] ?? fallbackModel ?? state.shipModel;
 }
+function hasModeledHarborEnvironment(state) {
+  return Object.keys(state.assetCatalog?.environment ?? {}).length > 0;
+}
 function createPerformanceGovernor(performanceFeatures) {
   const createQualityLadderAdapter = assertRequiredFunction(
     performanceFeatures,
@@ -5268,7 +5300,7 @@ function renderProjectedShadow(ctx, worldPoints, camera, viewport, lightDir, opt
   ctx.restore();
 }
 function pushHarborGeometry(camera, viewport, triangles, state) {
-  if (!state.showcaseRealisticModelsEnabled) {
+  if (!hasModeledHarborEnvironment(state)) {
     for (const object of LEGACY_HARBOR_LAYOUT) {
       buildTrianglesFromMesh(
         { positions: [object], indices: [0], normals: null, colors: null, material: createLegacyMeshPrimitive({})?.material, bounds: null, name: "legacy-structure" },
@@ -6024,7 +6056,7 @@ function renderLighthouseBeam(ctx, state, camera, viewport, visuals) {
   const lighthousePlacement = SHOWCASE_ENVIRONMENT_LAYOUT.find(
     (placement) => placement.assetKey === "lighthouse"
   );
-  if (!lighthousePlacement || !state.showcaseRealisticModelsEnabled) {
+  if (!lighthousePlacement || !state.showcaseRealisticModelsEnabled || !hasModeledHarborEnvironment(state)) {
     return;
   }
   const source = transformPoint2(
@@ -6360,7 +6392,7 @@ function renderScene(ctx, canvas, state, shipModel, dom, lightingFeatures, fluid
   };
   const sceneMetrics = [
     `focus: ${state.focus}`,
-    `ships: ${state.ships.length} active GLTF hulls across ${new Set(state.ships.map((ship) => ship.modelKey)).size} model families`,
+    `ships: ${state.ships.length} active GLTF hulls across ${new Set(state.ships.map((ship) => resolveShipModel(state, ship, shipModel)?.name ?? ship.modelKey)).size} model families`,
     `moonlight: cold overhead key + ${HARBOR_TORCHES.length + state.ships.reduce((total, ship) => total + (Array.isArray(ship.lanterns) ? ship.lanterns.length : 0), 0)} warm deck and harbor lights`,
     `physics snapshot: ${state.physics.snapshot.stage} (${state.physics.snapshot.stability})`,
     `physics contacts: ${state.contactCount}`,
@@ -6438,17 +6470,28 @@ function syncTextState(state, shipModel, featureAdapters) {
     coordinateSystem: "right-handed world; +x right, +y up, +z forward from the shore",
     focus: state.focus,
     stress: state.stress,
-    ships: state.ships.map((ship) => ({
-      id: ship.id,
-      modelKey: ship.modelKey ?? "brigantine",
-      x: Number(ship.position.x.toFixed(2)),
-      y: Number(ship.position.y.toFixed(2)),
-      z: Number(ship.position.z.toFixed(2)),
-      vx: Number(ship.velocity.x.toFixed(2)),
-      vz: Number(ship.velocity.z.toFixed(2)),
-      massKg: Math.round(getShipMass(ship, resolveShipModel(state, ship, shipModel))),
-      lanterns: Array.isArray(ship.lanterns) ? ship.lanterns.length : 0
-    })),
+    ships: state.ships.map((ship) => {
+      const resolvedShipModel = resolveShipModel(state, ship, shipModel);
+      return {
+        id: ship.id,
+        modelKey: ship.modelKey ?? "brigantine",
+        resolvedModelKey: resolvedShipModel?.name ?? ship.modelKey ?? "brigantine",
+        x: Number(ship.position.x.toFixed(2)),
+        y: Number(ship.position.y.toFixed(2)),
+        z: Number(ship.position.z.toFixed(2)),
+        vx: Number(ship.velocity.x.toFixed(2)),
+        vz: Number(ship.velocity.z.toFixed(2)),
+        massKg: Math.round(getShipMass(ship, resolvedShipModel)),
+        lanterns: Array.isArray(ship.lanterns) ? ship.lanterns.length : 0
+      };
+    }),
+    assetCatalog: {
+      mode: state.assetCatalog?.mode ?? "unknown",
+      shipKeys: Object.keys(state.assetCatalog?.ships ?? {}).sort(),
+      environmentKeys: Object.keys(state.assetCatalog?.environment ?? {}).sort(),
+      fallbackReason: state.assetCatalog?.fallbackReason ?? null,
+      requestedRealisticModels: state.showcaseRealisticModelsEnabled
+    },
     shipPhysics: Object.fromEntries(
       state.ships.map((ship) => [ship.id, resolveShipModel(state, ship, shipModel)?.physics ?? null])
     ),
@@ -6505,7 +6548,9 @@ async function mountGpuShowcase(options = {}, featureFlags = null) {
     },
     featureAdapters
   );
-  const assetCatalog = await (state.showcaseRealisticModelsEnabled ? loadShowcaseAssetCatalog() : createLegacyShowcaseAssetCatalog());
+  const assetCatalog = await loadShowcaseAssetCatalogWithFallback({
+    includeSecondaryShip: state.showcaseRealisticModelsEnabled
+  });
   const shipModel = assetCatalog.ships[assetCatalog.primaryShipKey];
   state.assetCatalog = assetCatalog;
   state.shipModel = shipModel;