@wave3d/core 0.1.0 → 0.2.0

package/dist/standalone.d.ts

@@ -1,6 +1,6 @@
 import { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, ColorStop, DEFAULT_LIGHT_POSITION, GradientType, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PaletteSource, SceneConfig, StudioConfig, Vec2, Vec3, WaveConfig, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeWave, resizeWaves } from "./config/model.js";
 import { WaveRenderer } from "./renderer/WaveRenderer.js";
-import { FallbackReason, WaveHandle, WaveOptions, WaveState } from "./shell/createWave.js";
+import { FallbackReason, SnapshotOptions, WaveHandle, WaveOptions, WaveState } from "./shell/createWave.js";
 import { PRESETS } from "./presets.js";
 
 //#region src/standalone.d.ts
@@ -9,5 +9,5 @@ declare function createWave(container: HTMLElement, config?: Partial<StudioConfi
 /** The drop-in embed contract: an alias of {@link createWave}. */
 declare const mountWave: typeof createWave;
 //#endregion
-export { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, ColorStop, DEFAULT_LIGHT_POSITION, type FallbackReason, GradientType, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PRESETS, PaletteSource, SceneConfig, StudioConfig, Vec2, Vec3, WaveConfig, type WaveHandle, type WaveOptions, WaveRenderer, type WaveState, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeWave, resizeWaves };
+export { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, ColorStop, DEFAULT_LIGHT_POSITION, type FallbackReason, GradientType, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PRESETS, PaletteSource, SceneConfig, type SnapshotOptions, StudioConfig, Vec2, Vec3, WaveConfig, type WaveHandle, type WaveOptions, WaveRenderer, type WaveState, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeWave, resizeWaves };
 //# sourceMappingURL=standalone.d.ts.map

package/dist/standalone.js.map

@@ -1 +1 @@
-{"version":3,"file":"standalone.js","names":["core"],"sources":["../src/standalone.ts"],"sourcesContent":["// The single-file CDN / standalone build entry. Unlike the `.` shell — which fetches the engine on\n// demand — this statically imports the engine (three bundled in) and pre-binds createWave/mountWave\n// with a synchronous loadCore, so a plain <script type=\"module\"> from a CDN upgrades with no extra\n// network round-trip. This is also the runtime the studio inlines into its exported embed HTML.\nimport * as core from \"./core-loader\";\nimport { createWaveImpl } from \"./shell/createWave\";\nimport type { WaveOptions, WaveHandle } from \"./shell/createWave\";\nimport type { StudioConfig } from \"./config/model\";\n\n// Synchronous core — the engine is already bundled into this file, so there is no dynamic import\n// (which is exactly why the standalone stays a single file: createWaveImpl never references the\n// public createWave's `import(\"./core-loader\")` default).\nconst loadCore = (): Promise<typeof core> => Promise.resolve(core);\n\n/** {@link createWaveImpl} with the engine already bundled in (synchronous upgrade). */\nexport function createWave(\n  container: HTMLElement,\n  config: Partial<StudioConfig> = {},\n  options: WaveOptions = {},\n): WaveHandle {\n  return createWaveImpl(loadCore, container, config, options);\n}\n\n/** The drop-in embed contract: an alias of {@link createWave}. */\nexport const mountWave = createWave;\n\n// CDN users get the raw engine, presets, and full model directly too.\nexport { WaveRenderer } from \"./renderer/WaveRenderer\";\nexport { PRESETS } from \"./presets\";\nexport * from \"./config/model\";\nexport type { WaveOptions, WaveHandle, WaveState, FallbackReason } from \"./shell/createWave\";\n"],"mappings":";;;;;;AAYA,MAAM,iBAAuC,QAAQ,QAAQA,mBAAI;;AAGjE,SAAgB,WACd,WACA,SAAgC,CAAC,GACjC,UAAuB,CAAC,GACZ;CACZ,OAAO,eAAe,UAAU,WAAW,QAAQ,OAAO;AAC5D;;AAGA,MAAa,YAAY"}
+{"version":3,"file":"standalone.js","names":["core"],"sources":["../src/standalone.ts"],"sourcesContent":["// The single-file CDN / standalone build entry. Unlike the `.` shell — which fetches the engine on\n// demand — this statically imports the engine (three bundled in) and pre-binds createWave/mountWave\n// with a synchronous loadCore, so a plain <script type=\"module\"> from a CDN upgrades with no extra\n// network round-trip. This is also the runtime the studio inlines into its exported embed HTML.\nimport * as core from \"./core-loader\";\nimport { createWaveImpl } from \"./shell/createWave\";\nimport type { WaveOptions, WaveHandle } from \"./shell/createWave\";\nimport type { StudioConfig } from \"./config/model\";\n\n// Synchronous core — the engine is already bundled into this file, so there is no dynamic import\n// (which is exactly why the standalone stays a single file: createWaveImpl never references the\n// public createWave's `import(\"./core-loader\")` default).\nconst loadCore = (): Promise<typeof core> => Promise.resolve(core);\n\n/** {@link createWaveImpl} with the engine already bundled in (synchronous upgrade). */\nexport function createWave(\n  container: HTMLElement,\n  config: Partial<StudioConfig> = {},\n  options: WaveOptions = {},\n): WaveHandle {\n  return createWaveImpl(loadCore, container, config, options);\n}\n\n/** The drop-in embed contract: an alias of {@link createWave}. */\nexport const mountWave = createWave;\n\n// CDN users get the raw engine, presets, and full model directly too.\nexport { WaveRenderer } from \"./renderer/WaveRenderer\";\nexport { PRESETS } from \"./presets\";\nexport * from \"./config/model\";\nexport type {\n  WaveOptions,\n  WaveHandle,\n  WaveState,\n  FallbackReason,\n  SnapshotOptions,\n} from \"./shell/createWave\";\n"],"mappings":";;;;;;AAYA,MAAM,iBAAuC,QAAQ,QAAQA,mBAAI;;AAGjE,SAAgB,WACd,WACA,SAAgC,CAAC,GACjC,UAAuB,CAAC,GACZ;CACZ,OAAO,eAAe,UAAU,WAAW,QAAQ,OAAO;AAC5D;;AAGA,MAAa,YAAY"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wave3d/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Framework-agnostic 3D gradient-wave renderer + config model (the engine behind Wave Studio)",
   "keywords": [
     "animation",

package/skills/wave3d/SKILL.md

@@ -33,9 +33,9 @@ load**. Framework-agnostic core, with React and web-component adapters.
 ## Install
 
 ```sh
-pnpm add @wave3d/react @wave3d/core three     # React
-pnpm add @wave3d/element @wave3d/core three   # <wave-3d> for Vue / Svelte / plain HTML
-pnpm add @wave3d/core three                   # framework-agnostic createWave
+pnpm add @wave3d/react three     # React
+pnpm add @wave3d/element three   # <wave-3d> for Vue / Svelte / plain HTML
+pnpm add @wave3d/core three      # framework-agnostic createWave
 ```
 
 `three` is a **peer dependency** of `@wave3d/core` (`>=0.180 <1`). For TypeScript, also add
@@ -125,7 +125,10 @@ The shell shows a poster immediately, then crossfades to the live wave.
 
 - **Poster source:** the `poster` option/prop (URL or data-URI), or — for SSR — an
   `<img data-wave3d-poster>` you render inside the container; the shell **adopts** it (no hydration
-  flash). React: pass it as a child. Generate a poster from the studio's Export code dialog.
+  flash). React: pass it as a child.
+- **Make a poster:** the studio's Export dialog, or capture the live frame at runtime — once
+  running, `handle.snapshot()` (core/element) or `onReady(renderer)` → `renderer.captureImage()`
+  (React) resolves an image Blob you can host and feed back as the `poster`.
 - **`onFallback(reason)`** fires when the shell keeps the poster instead of upgrading; reasons:
   `"no-webgl" | "reduced-motion" | "save-data" | "context-lost" | "load-error"`.
 - **`onStateChange(state)`**: `"poster" → "loading" → "running"`, or `"fallback"`.