@wave3d/core 0.1.0 → 0.2.0

package/dist/shell/createWave.js.map

@@ -1 +1 @@
-{"version":3,"file":"createWave.js","names":[],"sources":["../../src/shell/createWave.ts"],"sourcesContent":["import type { StudioConfig } from \"../config/model\";\nimport type { WaveRenderer, WaveRendererOptions } from \"../renderer/WaveRenderer\";\nimport { hasWebGL, prefersReducedMotion, prefersReducedData } from \"./probe\";\nimport { setupPoster, ensurePositioned, type Poster } from \"./poster\";\n\n/** Why the shell showed the poster instead of a live wave. */\nexport type FallbackReason =\n  | \"no-webgl\"\n  | \"reduced-motion\"\n  | \"save-data\"\n  | \"context-lost\"\n  | \"load-error\";\n\n/** poster → loading → running, or → fallback (permanent poster). */\nexport type WaveState = \"poster\" | \"loading\" | \"running\" | \"fallback\";\n\n/** The heavy module fetched on upgrade. */\ntype CoreModule = typeof import(\"../core-loader\");\n\nexport interface WaveOptions {\n  /** Poster URL / data-URI. Defaults to adopting the container's `<img data-wave3d-poster>` (SSR). */\n  poster?: string;\n  /** Wait until the container nears the viewport before fetching the engine. Default true. */\n  lazy?: boolean;\n  /** IntersectionObserver margin for the lazy trigger. Default \"200px\". */\n  rootMargin?: string;\n  /** \"auto\" probes WebGL (with failIfMajorPerformanceCaveat); \"force\" skips the probe; \"off\" stays a poster. */\n  webgl?: \"auto\" | \"force\" | \"off\";\n  /** Forward prefers-reduced-motion to the renderer (freezes to a full static frame). Default true. */\n  respectReducedMotion?: boolean;\n  /** With reduced motion: \"static\" upgrades to a frozen frame; \"poster\" stays a poster. Default \"static\". */\n  reducedMotionBehavior?: \"static\" | \"poster\";\n  /** Keep a permanent poster when the user has Save-Data on. Default true. */\n  respectSaveData?: boolean;\n  /** Poster→canvas crossfade duration (ms). Default 300. */\n  fadeMs?: number;\n  /** Start paused. */\n  paused?: boolean;\n  onReady?(renderer: WaveRenderer): void;\n  onFallback?(reason: FallbackReason): void;\n  onStateChange?(state: WaveState): void;\n  /** Seam for the standalone/CDN build to supply the core synchronously (three already bundled). */\n  loadCore?(): Promise<CoreModule>;\n}\n\nexport interface WaveHandle {\n  readonly state: WaveState;\n  readonly renderer: WaveRenderer | null;\n  /** Merge a partial config. Staged before upgrade; after, setConfig() then refreshPlayback(). */\n  set(config: Partial<StudioConfig>): void;\n  play(): void;\n  pause(): void;\n  /** Safe to call in any state (aborts a pending upgrade, disposes a live renderer, removes the poster). */\n  destroy(): void;\n}\n\n/**\n * The shell implementation. `loadCore` is an explicit parameter (not read from options) so the\n * standalone/CDN build can pass a synchronous core and NOT bundle the dynamic-import path — its\n * output stays a single file. The public {@link createWave} supplies the dynamic-import default.\n */\nexport function createWaveImpl(\n  loadCore: () => Promise<CoreModule>,\n  container: HTMLElement,\n  config: Partial<StudioConfig>,\n  options: WaveOptions,\n): WaveHandle {\n  const {\n    lazy = true,\n    rootMargin = \"200px\",\n    webgl = \"auto\",\n    respectReducedMotion = true,\n    reducedMotionBehavior = \"static\",\n    respectSaveData = true,\n    fadeMs = 300,\n  } = options;\n\n  let state: WaveState = \"poster\";\n  let renderer: WaveRenderer | null = null;\n  let staged: Partial<StudioConfig> = { ...config };\n  if (options.paused !== undefined) staged.paused = options.paused;\n\n  let aborted = false;\n  let io: IntersectionObserver | null = null;\n  let lostTimer: ReturnType<typeof setTimeout> | undefined;\n  let lossCount = 0;\n\n  ensurePositioned(container);\n  const poster: Poster | null = setupPoster(container, options.poster);\n\n  function setState(next: WaveState): void {\n    if (state === next) return;\n    state = next;\n    options.onStateChange?.(next);\n  }\n\n  function fallback(reason: FallbackReason): void {\n    setState(\"fallback\");\n    poster?.show();\n    options.onFallback?.(reason);\n  }\n\n  function onContextRestored(): void {\n    clearTimeout(lostTimer); // three rebuilt the context in time; stay live\n  }\n\n  function onContextLost(): void {\n    lossCount += 1;\n    clearTimeout(lostTimer);\n    if (lossCount >= 2) {\n      teardownRenderer();\n      fallback(\"context-lost\");\n      return;\n    }\n    // three (WaveRenderer) tries to restore; if it hasn't within ~4s, give up to the poster.\n    lostTimer = setTimeout(() => {\n      teardownRenderer();\n      fallback(\"context-lost\");\n    }, 4000);\n  }\n\n  function teardownRenderer(): void {\n    if (!renderer) return;\n    const canvas = renderer.renderer.domElement;\n    canvas.removeEventListener(\"webglcontextlost\", onContextLost);\n    canvas.removeEventListener(\"webglcontextrestored\", onContextRestored);\n    renderer.dispose();\n    renderer = null;\n  }\n\n  async function upgrade(): Promise<void> {\n    setState(\"loading\");\n    let core: CoreModule;\n    try {\n      core = await loadCore();\n    } catch {\n      if (!aborted) fallback(\"load-error\");\n      return;\n    }\n    if (aborted) return;\n\n    const full: StudioConfig = { ...core.createDefaultConfig(), ...staged };\n    const rendererOptions: WaveRendererOptions = { respectReducedMotion };\n    renderer = new core.WaveRenderer(container, full, rendererOptions);\n    const canvas = renderer.renderer.domElement;\n    canvas.addEventListener(\"webglcontextlost\", onContextLost, false);\n    canvas.addEventListener(\"webglcontextrestored\", onContextRestored, false);\n    renderer.start();\n    setState(\"running\");\n    options.onReady?.(renderer);\n\n    if (poster) {\n      // Crossfade only after two frames, so the wave has definitely painted first.\n      requestAnimationFrame(() =>\n        requestAnimationFrame(() => {\n          if (!aborted && renderer) poster.fadeOut(fadeMs);\n        }),\n      );\n    }\n  }\n\n  function probeAndUpgrade(): void {\n    if (aborted) return;\n    if (webgl === \"auto\" && !hasWebGL()) {\n      fallback(\"no-webgl\");\n      return;\n    }\n    void upgrade();\n  }\n\n  function begin(): void {\n    // Permanent-poster gates (checked before any lazy wait or engine fetch).\n    if (webgl === \"off\") return; // deliberate poster-only mode — stay \"poster\", no fallback callback\n    if (respectSaveData && prefersReducedData()) return fallback(\"save-data\");\n    if (respectReducedMotion && reducedMotionBehavior === \"poster\" && prefersReducedMotion()) {\n      return fallback(\"reduced-motion\");\n    }\n    if (lazy && typeof IntersectionObserver !== \"undefined\") {\n      io = new IntersectionObserver(\n        (entries) => {\n          if (entries.some((e) => e.isIntersecting)) {\n            io?.disconnect();\n            io = null;\n            probeAndUpgrade();\n          }\n        },\n        { rootMargin },\n      );\n      io.observe(container);\n    } else {\n      probeAndUpgrade();\n    }\n  }\n\n  const handle: WaveHandle = {\n    get state() {\n      return state;\n    },\n    get renderer() {\n      return renderer;\n    },\n    set(next) {\n      if (renderer) {\n        renderer.setConfig({ ...renderer.getConfig(), ...next });\n        renderer.refreshPlayback(); // setConfig doesn't re-evaluate `paused` on its own\n      } else {\n        staged = { ...staged, ...next };\n      }\n    },\n    play() {\n      if (renderer) {\n        renderer.getConfig().paused = false;\n        renderer.refreshPlayback();\n      } else {\n        staged.paused = false;\n      }\n    },\n    pause() {\n      if (renderer) {\n        renderer.getConfig().paused = true;\n        renderer.refreshPlayback();\n      } else {\n        staged.paused = true;\n      }\n    },\n    destroy() {\n      aborted = true;\n      io?.disconnect();\n      io = null;\n      clearTimeout(lostTimer);\n      teardownRenderer();\n      poster?.remove();\n    },\n  };\n\n  begin();\n  return handle;\n}\n\n/**\n * Mount a self-optimizing wave into a container: shows a poster immediately, then — lazily, and only\n * when the browser can actually run it — fetches the engine, builds the renderer, and crossfades in.\n * Falls back to the poster on no-WebGL / save-data / reduced-motion / context-loss / load errors.\n * No static three import: the engine arrives via a dynamic import, so the shell stays tiny.\n */\nexport function createWave(\n  container: HTMLElement,\n  config: Partial<StudioConfig> = {},\n  options: WaveOptions = {},\n): WaveHandle {\n  return createWaveImpl(\n    options.loadCore ?? (() => import(\"../core-loader\")),\n    container,\n    config,\n    options,\n  );\n}\n\n/** The drop-in embed contract: an alias of {@link createWave}. */\nexport const mountWave = createWave;\n"],"mappings":"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"}
+{"version":3,"file":"createWave.js","names":[],"sources":["../../src/shell/createWave.ts"],"sourcesContent":["import type { StudioConfig } from \"../config/model\";\nimport type { WaveRenderer, WaveRendererOptions } from \"../renderer/WaveRenderer\";\nimport { hasWebGL, prefersReducedMotion, prefersReducedData } from \"./probe\";\nimport { setupPoster, ensurePositioned, type Poster } from \"./poster\";\n\n/** Why the shell showed the poster instead of a live wave. */\nexport type FallbackReason =\n  | \"no-webgl\"\n  | \"reduced-motion\"\n  | \"save-data\"\n  | \"context-lost\"\n  | \"load-error\";\n\n/** poster → loading → running, or → fallback (permanent poster). */\nexport type WaveState = \"poster\" | \"loading\" | \"running\" | \"fallback\";\n\n/** The heavy module fetched on upgrade. */\ntype CoreModule = typeof import(\"../core-loader\");\n\nexport interface WaveOptions {\n  /** Poster URL / data-URI. Defaults to adopting the container's `<img data-wave3d-poster>` (SSR). */\n  poster?: string;\n  /** Wait until the container nears the viewport before fetching the engine. Default true. */\n  lazy?: boolean;\n  /** IntersectionObserver margin for the lazy trigger. Default \"200px\". */\n  rootMargin?: string;\n  /** \"auto\" probes WebGL (with failIfMajorPerformanceCaveat); \"force\" skips the probe; \"off\" stays a poster. */\n  webgl?: \"auto\" | \"force\" | \"off\";\n  /** Forward prefers-reduced-motion to the renderer (freezes to a full static frame). Default true. */\n  respectReducedMotion?: boolean;\n  /** With reduced motion: \"static\" upgrades to a frozen frame; \"poster\" stays a poster. Default \"static\". */\n  reducedMotionBehavior?: \"static\" | \"poster\";\n  /** Keep a permanent poster when the user has Save-Data on. Default true. */\n  respectSaveData?: boolean;\n  /** Poster→canvas crossfade duration (ms). Default 300. */\n  fadeMs?: number;\n  /** Start paused. */\n  paused?: boolean;\n  onReady?(renderer: WaveRenderer): void;\n  onFallback?(reason: FallbackReason): void;\n  onStateChange?(state: WaveState): void;\n  /** Seam for the standalone/CDN build to supply the core synchronously (three already bundled). */\n  loadCore?(): Promise<CoreModule>;\n}\n\nexport interface SnapshotOptions {\n  /** Image MIME type. Default `\"image/webp\"`. */\n  type?: string;\n  /** Encoder quality 0–1 for lossy types. */\n  quality?: number;\n  /** Render with a transparent background. Default true. */\n  transparent?: boolean;\n  /** Render a fixed animation-time for a reproducible frame (default: the live frame). Poster\n   *  captures should pass `0` — the frame the wave opens on, so the file doesn't churn per capture. */\n  time?: number;\n}\n\nexport interface WaveHandle {\n  readonly state: WaveState;\n  readonly renderer: WaveRenderer | null;\n  /** Capture the current live frame as an image Blob (a poster you can host/cache). Resolves `null`\n   *  until the wave is running (poster / fallback / pre-upgrade) — wait for {@link WaveOptions.onReady}\n   *  (or the element's `wave3d-ready` event) first. */\n  snapshot(options?: SnapshotOptions): Promise<Blob | null>;\n  /** Merge a partial config. Staged before upgrade; after, setConfig() then refreshPlayback(). */\n  set(config: Partial<StudioConfig>): void;\n  play(): void;\n  pause(): void;\n  /** Safe to call in any state (aborts a pending upgrade, disposes a live renderer, removes the poster). */\n  destroy(): void;\n}\n\n/**\n * The shell implementation. `loadCore` is an explicit parameter (not read from options) so the\n * standalone/CDN build can pass a synchronous core and NOT bundle the dynamic-import path — its\n * output stays a single file. The public {@link createWave} supplies the dynamic-import default.\n */\nexport function createWaveImpl(\n  loadCore: () => Promise<CoreModule>,\n  container: HTMLElement,\n  config: Partial<StudioConfig>,\n  options: WaveOptions,\n): WaveHandle {\n  const {\n    lazy = true,\n    rootMargin = \"200px\",\n    webgl = \"auto\",\n    respectReducedMotion = true,\n    reducedMotionBehavior = \"static\",\n    respectSaveData = true,\n    fadeMs = 300,\n  } = options;\n\n  let state: WaveState = \"poster\";\n  let renderer: WaveRenderer | null = null;\n  let staged: Partial<StudioConfig> = { ...config };\n  if (options.paused !== undefined) staged.paused = options.paused;\n\n  let aborted = false;\n  let io: IntersectionObserver | null = null;\n  let lostTimer: ReturnType<typeof setTimeout> | undefined;\n  let lossCount = 0;\n\n  ensurePositioned(container);\n  const poster: Poster | null = setupPoster(container, options.poster);\n\n  function setState(next: WaveState): void {\n    if (state === next) return;\n    state = next;\n    options.onStateChange?.(next);\n  }\n\n  function fallback(reason: FallbackReason): void {\n    setState(\"fallback\");\n    poster?.show();\n    options.onFallback?.(reason);\n  }\n\n  function onContextRestored(): void {\n    clearTimeout(lostTimer); // three rebuilt the context in time; stay live\n  }\n\n  function onContextLost(): void {\n    lossCount += 1;\n    clearTimeout(lostTimer);\n    if (lossCount >= 2) {\n      teardownRenderer();\n      fallback(\"context-lost\");\n      return;\n    }\n    // three (WaveRenderer) tries to restore; if it hasn't within ~4s, give up to the poster.\n    lostTimer = setTimeout(() => {\n      teardownRenderer();\n      fallback(\"context-lost\");\n    }, 4000);\n  }\n\n  function teardownRenderer(): void {\n    if (!renderer) return;\n    const canvas = renderer.renderer.domElement;\n    canvas.removeEventListener(\"webglcontextlost\", onContextLost);\n    canvas.removeEventListener(\"webglcontextrestored\", onContextRestored);\n    renderer.dispose();\n    renderer = null;\n  }\n\n  async function upgrade(): Promise<void> {\n    setState(\"loading\");\n    let core: CoreModule;\n    try {\n      core = await loadCore();\n    } catch {\n      if (!aborted) fallback(\"load-error\");\n      return;\n    }\n    if (aborted) return;\n\n    const full: StudioConfig = { ...core.createDefaultConfig(), ...staged };\n    const rendererOptions: WaveRendererOptions = { respectReducedMotion };\n    renderer = new core.WaveRenderer(container, full, rendererOptions);\n    const canvas = renderer.renderer.domElement;\n    canvas.addEventListener(\"webglcontextlost\", onContextLost, false);\n    canvas.addEventListener(\"webglcontextrestored\", onContextRestored, false);\n    renderer.start();\n    setState(\"running\");\n    options.onReady?.(renderer);\n\n    if (poster) {\n      // Crossfade only after two frames, so the wave has definitely painted first.\n      requestAnimationFrame(() =>\n        requestAnimationFrame(() => {\n          if (!aborted && renderer) poster.fadeOut(fadeMs);\n        }),\n      );\n    }\n  }\n\n  function probeAndUpgrade(): void {\n    if (aborted) return;\n    if (webgl === \"auto\" && !hasWebGL()) {\n      fallback(\"no-webgl\");\n      return;\n    }\n    void upgrade();\n  }\n\n  function begin(): void {\n    // Permanent-poster gates (checked before any lazy wait or engine fetch).\n    if (webgl === \"off\") return; // deliberate poster-only mode — stay \"poster\", no fallback callback\n    if (respectSaveData && prefersReducedData()) return fallback(\"save-data\");\n    if (respectReducedMotion && reducedMotionBehavior === \"poster\" && prefersReducedMotion()) {\n      return fallback(\"reduced-motion\");\n    }\n    if (lazy && typeof IntersectionObserver !== \"undefined\") {\n      io = new IntersectionObserver(\n        (entries) => {\n          if (entries.some((e) => e.isIntersecting)) {\n            io?.disconnect();\n            io = null;\n            probeAndUpgrade();\n          }\n        },\n        { rootMargin },\n      );\n      io.observe(container);\n    } else {\n      probeAndUpgrade();\n    }\n  }\n\n  const handle: WaveHandle = {\n    get state() {\n      return state;\n    },\n    get renderer() {\n      return renderer;\n    },\n    snapshot(opts = {}) {\n      if (!renderer) return Promise.resolve(null);\n      const { type = \"image/webp\", quality, transparent = true, time } = opts;\n      return renderer.captureImage(type, transparent, quality, time);\n    },\n    set(next) {\n      if (renderer) {\n        renderer.setConfig({ ...renderer.getConfig(), ...next });\n        renderer.refreshPlayback(); // setConfig doesn't re-evaluate `paused` on its own\n      } else {\n        staged = { ...staged, ...next };\n      }\n    },\n    play() {\n      if (renderer) {\n        renderer.getConfig().paused = false;\n        renderer.refreshPlayback();\n      } else {\n        staged.paused = false;\n      }\n    },\n    pause() {\n      if (renderer) {\n        renderer.getConfig().paused = true;\n        renderer.refreshPlayback();\n      } else {\n        staged.paused = true;\n      }\n    },\n    destroy() {\n      aborted = true;\n      io?.disconnect();\n      io = null;\n      clearTimeout(lostTimer);\n      teardownRenderer();\n      poster?.remove();\n    },\n  };\n\n  begin();\n  return handle;\n}\n\n/**\n * Mount a self-optimizing wave into a container: shows a poster immediately, then — lazily, and only\n * when the browser can actually run it — fetches the engine, builds the renderer, and crossfades in.\n * Falls back to the poster on no-WebGL / save-data / reduced-motion / context-loss / load errors.\n * No static three import: the engine arrives via a dynamic import, so the shell stays tiny.\n */\nexport function createWave(\n  container: HTMLElement,\n  config: Partial<StudioConfig> = {},\n  options: WaveOptions = {},\n): WaveHandle {\n  return createWaveImpl(\n    options.loadCore ?? (() => import(\"../core-loader\")),\n    container,\n    config,\n    options,\n  );\n}\n\n/** The drop-in embed contract: an alias of {@link createWave}. */\nexport const mountWave = createWave;\n"],"mappings":"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"}