@plasius/gpu-shared 1.0.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/gpu-shared",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Shared browser-safe demo runtime and asset helpers for the Plasius gpu-* package family.",
   "type": "module",
   "sideEffects": false,

package/src/showcase-runtime.js

@@ -1640,40 +1640,74 @@ function buildTrianglesFromMesh(
   }
 }
 
-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")),
   ]);
+  const ships = {
+    brigantine,
+  };
 
-  return Object.freeze({
-    primaryShipKey: "brigantine",
-    ships: Object.freeze({
-      brigantine,
-      cutter,
-    }),
-    environment: Object.freeze({
+  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) {
@@ -1684,6 +1718,10 @@ function resolveShipModel(state, ship, fallbackModel = null) {
   );
 }
 
+function hasModeledHarborEnvironment(state) {
+  return Object.keys(state.assetCatalog?.environment ?? {}).length > 0;
+}
+
 function createPerformanceGovernor(performanceFeatures) {
   const createQualityLadderAdapter = assertRequiredFunction(
     performanceFeatures,
@@ -3036,7 +3074,7 @@ function renderProjectedShadow(ctx, worldPoints, camera, viewport, lightDir, opt
 }
 
 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" },
@@ -3905,7 +3943,11 @@ 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;
   }
 
@@ -4280,7 +4322,7 @@ function renderScene(
 
   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}`,
@@ -4375,17 +4417,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])
     ),
@@ -4443,9 +4496,9 @@ export 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;

package/src/translations/en-GB.js

@@ -11,7 +11,7 @@ export const gpuSharedEnGbTranslations = Object.freeze({
   "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}.",
+    "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",
@@ -52,4 +52,3 @@ export const gpuSharedEnGbTranslations = Object.freeze({
   "gpuShared.debug.allocation.mainColorBuffer": "Main color buffer",
   "gpuShared.debug.allocation.shadowImpressionAtlas": "Shadow impression atlas",
 });
-

package/dist/chunk-CH3ZS5TQ.js.map

@@ -1 +0,0 @@
-{"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    \"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}.\",\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\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":[]}