@wave3d/core 0.2.1 → 0.2.2

package/dist/studio/index.d.ts

@@ -1,3 +1,4 @@
 import { randomizeBackground, randomizeColor, randomizeConfig, randomizeFinish, randomizeGlobal, randomizeGradient, randomizeLights, randomizeSpine, randomizeTransform, randomizeTwist, randomizeWave } from "./randomize.js";
 import { StudioWaveRenderer } from "./StudioWaveRenderer.js";
-export { StudioWaveRenderer, randomizeBackground, randomizeColor, randomizeConfig, randomizeFinish, randomizeGlobal, randomizeGradient, randomizeLights, randomizeSpine, randomizeTransform, randomizeTwist, randomizeWave };
+import { createThumbHost, prepThumbConfig, renderThumbFrame } from "./thumbnail.js";
+export { StudioWaveRenderer, createThumbHost, prepThumbConfig, randomizeBackground, randomizeColor, randomizeConfig, randomizeFinish, randomizeGlobal, randomizeGradient, randomizeLights, randomizeSpine, randomizeTransform, randomizeTwist, randomizeWave, renderThumbFrame };

package/dist/studio/index.js

@@ -1,3 +1,4 @@
 import { randomizeBackground, randomizeColor, randomizeConfig, randomizeFinish, randomizeGlobal, randomizeGradient, randomizeLights, randomizeSpine, randomizeTransform, randomizeTwist, randomizeWave } from "./randomize.js";
 import { StudioWaveRenderer } from "./StudioWaveRenderer.js";
-export { StudioWaveRenderer, randomizeBackground, randomizeColor, randomizeConfig, randomizeFinish, randomizeGlobal, randomizeGradient, randomizeLights, randomizeSpine, randomizeTransform, randomizeTwist, randomizeWave };
+import { createThumbHost, prepThumbConfig, renderThumbFrame } from "./thumbnail.js";
+export { StudioWaveRenderer, createThumbHost, prepThumbConfig, randomizeBackground, randomizeColor, randomizeConfig, randomizeFinish, randomizeGlobal, randomizeGradient, randomizeLights, randomizeSpine, randomizeTransform, randomizeTwist, randomizeWave, renderThumbFrame };

package/dist/studio/thumbnail.d.ts

@@ -0,0 +1,14 @@
+import { StudioConfig } from "../config/model.js";
+import { WaveRenderer } from "../renderer/WaveRenderer.js";
+
+//#region src/studio/thumbnail.d.ts
+/** A hidden host div that is in layout (so clientWidth/Height are real) but off-screen. */
+declare function createThumbHost(width: number, height: number): HTMLDivElement;
+/** Mutate `cfg` for a thumbnail still: static frame, opaque, white page behind solid themes
+ *  (wireframe keys its between-line colour off the dark page background, so keep it). */
+declare function prepThumbConfig(cfg: StudioConfig): void;
+/** Render the current config to a fresh 2D canvas (null if the WebGL canvas is missing). */
+declare function renderThumbFrame(renderer: WaveRenderer, host: HTMLElement): HTMLCanvasElement | null;
+//#endregion
+export { createThumbHost, prepThumbConfig, renderThumbFrame };
+//# sourceMappingURL=thumbnail.d.ts.map

package/dist/studio/thumbnail.js

@@ -0,0 +1,32 @@
+//#region src/studio/thumbnail.ts
+/** A hidden host div that is in layout (so clientWidth/Height are real) but off-screen. */
+function createThumbHost(width, height) {
+	const host = document.createElement("div");
+	host.style.cssText = `position:fixed;left:-10000px;top:0;width:${width}px;height:${height}px;opacity:0;pointer-events:none;`;
+	document.body.appendChild(host);
+	return host;
+}
+/** Mutate `cfg` for a thumbnail still: static frame, opaque, white page behind solid themes
+*  (wireframe keys its between-line colour off the dark page background, so keep it). */
+function prepThumbConfig(cfg) {
+	cfg.paused = true;
+	cfg.transparentBackground = false;
+	if (cfg.waves[0]?.theme !== "wireframe") cfg.background = "#ffffff";
+}
+/** Render the current config to a fresh 2D canvas (null if the WebGL canvas is missing). */
+function renderThumbFrame(renderer, host) {
+	renderer.resize();
+	renderer.renderOnce();
+	renderer.renderOnce();
+	const gl = host.querySelector("canvas");
+	if (!gl) return null;
+	const out = document.createElement("canvas");
+	out.width = gl.width;
+	out.height = gl.height;
+	out.getContext("2d")?.drawImage(gl, 0, 0);
+	return out;
+}
+//#endregion
+export { createThumbHost, prepThumbConfig, renderThumbFrame };
+
+//# sourceMappingURL=thumbnail.js.map

package/dist/studio/thumbnail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail.js","names":[],"sources":["../../src/studio/thumbnail.ts"],"sourcesContent":["/**\n * Offscreen thumbnail rendering: turn a config into a still frame with one hidden, reused\n * WaveRenderer. Used by the studio's preset + history thumbnails and by the wave gallery grid.\n */\nimport type { WaveRenderer } from \"../renderer/WaveRenderer\";\nimport type { StudioConfig } from \"../config/model\";\n\n/** A hidden host div that is in layout (so clientWidth/Height are real) but off-screen. */\nexport function createThumbHost(width: number, height: number): HTMLDivElement {\n  const host = document.createElement(\"div\");\n  host.style.cssText = `position:fixed;left:-10000px;top:0;width:${width}px;height:${height}px;opacity:0;pointer-events:none;`;\n  document.body.appendChild(host);\n  return host;\n}\n\n/** Mutate `cfg` for a thumbnail still: static frame, opaque, white page behind solid themes\n *  (wireframe keys its between-line colour off the dark page background, so keep it). */\nexport function prepThumbConfig(cfg: StudioConfig): void {\n  cfg.paused = true;\n  cfg.transparentBackground = false;\n  if (cfg.waves[0]?.theme !== \"wireframe\") cfg.background = \"#ffffff\";\n}\n\n/** Render the current config to a fresh 2D canvas (null if the WebGL canvas is missing). */\nexport function renderThumbFrame(\n  renderer: WaveRenderer,\n  host: HTMLElement,\n): HTMLCanvasElement | null {\n  renderer.resize();\n  renderer.renderOnce();\n  renderer.renderOnce(); // 2nd pass so any shader recompile (theme/blend variant) is applied\n  const gl = host.querySelector(\"canvas\");\n  if (!gl) return null;\n  // Copy to a 2D canvas before encoding (reliable read of the WebGL drawing buffer).\n  const out = document.createElement(\"canvas\");\n  out.width = gl.width;\n  out.height = gl.height;\n  out.getContext(\"2d\")?.drawImage(gl, 0, 0);\n  return out;\n}\n"],"mappings":";;AAQA,SAAgB,gBAAgB,OAAe,QAAgC;CAC7E,MAAM,OAAO,SAAS,cAAc,KAAK;CACzC,KAAK,MAAM,UAAU,4CAA4C,MAAM,YAAY,OAAO;CAC1F,SAAS,KAAK,YAAY,IAAI;CAC9B,OAAO;AACT;;;AAIA,SAAgB,gBAAgB,KAAyB;CACvD,IAAI,SAAS;CACb,IAAI,wBAAwB;CAC5B,IAAI,IAAI,MAAM,EAAE,EAAE,UAAU,aAAa,IAAI,aAAa;AAC5D;;AAGA,SAAgB,iBACd,UACA,MAC0B;CAC1B,SAAS,OAAO;CAChB,SAAS,WAAW;CACpB,SAAS,WAAW;CACpB,MAAM,KAAK,KAAK,cAAc,QAAQ;CACtC,IAAI,CAAC,IAAI,OAAO;CAEhB,MAAM,MAAM,SAAS,cAAc,QAAQ;CAC3C,IAAI,QAAQ,GAAG;CACf,IAAI,SAAS,GAAG;CAChB,IAAI,WAAW,IAAI,CAAC,EAAE,UAAU,IAAI,GAAG,CAAC;CACxC,OAAO;AACT"}

package/package.json

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