@wave3d/core 0.6.0 → 0.8.0

package/dist/standalone.d.ts

@@ -1,4 +1,4 @@
-import { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, CAMERA_FITS, CameraFit, ColorStop, DEFAULT_LIGHT_POSITION, GradientType, InteractionSource, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PaletteSource, SceneConfig, SceneInteractionBinding, SceneInteractionConfig, SceneInteractionTarget, StudioConfig, Vec2, Vec3, WaveConfig, WaveHoverConfig, WaveInteractionBinding, WaveInteractionConfig, WaveInteractionTarget, WavePressConfig, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves } from "./config/model.js";
+import { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, CAMERA_FITS, CameraFit, ColorStop, DEFAULT_LIGHT_POSITION, GradientType, InteractionSource, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PARTICLE_SHAPES, PaletteSource, ParticleShape, ParticlesConfig, SceneConfig, SceneInteractionBinding, SceneInteractionConfig, SceneInteractionTarget, StudioConfig, Vec2, Vec3, WaveConfig, WaveHoverConfig, WaveInteractionBinding, WaveInteractionConfig, WaveInteractionTarget, WavePressConfig, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeParticles, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves } from "./config/model.js";
 import { WaveRenderer } from "./renderer/WaveRenderer.js";
 import { FallbackReason, SnapshotOptions, WaveHandle, WaveOptions, WaveState } from "./shell/createWave.js";
 import { PRESETS } from "./presets.js";
@@ -8,5 +8,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, CAMERA_FITS, CameraFit, ColorStop, DEFAULT_LIGHT_POSITION, type FallbackReason, GradientType, InteractionSource, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PRESETS, PaletteSource, SceneConfig, SceneInteractionBinding, SceneInteractionConfig, SceneInteractionTarget, type SnapshotOptions, StudioConfig, Vec2, Vec3, WaveConfig, type WaveHandle, WaveHoverConfig, WaveInteractionBinding, WaveInteractionConfig, WaveInteractionTarget, type WaveOptions, WavePressConfig, WaveRenderer, type WaveState, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves };
+export { BackgroundImageFit, BackgroundMode, BasicGradientType, BlendMode, CAMERA_FITS, CameraFit, ColorStop, DEFAULT_LIGHT_POSITION, type FallbackReason, GradientType, InteractionSource, LightConfig, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, MeshGradientPoint, NoiseBand, PARTICLE_SHAPES, PRESETS, PaletteSource, ParticleShape, ParticlesConfig, SceneConfig, SceneInteractionBinding, SceneInteractionConfig, SceneInteractionTarget, type SnapshotOptions, StudioConfig, Vec2, Vec3, WaveConfig, type WaveHandle, WaveHoverConfig, WaveInteractionBinding, WaveInteractionConfig, WaveInteractionTarget, type WaveOptions, WavePressConfig, WaveRenderer, type WaveState, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeParticles, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves };
 //# sourceMappingURL=standalone.d.ts.map

package/dist/standalone.js

@@ -1,4 +1,4 @@
-import { CAMERA_FITS, DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves } from "./config/model.js";
+import { CAMERA_FITS, DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, PARTICLE_SHAPES, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, normalizeBackground, normalizeParticles, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves } from "./config/model.js";
 import { createWaveImpl } from "./shell/createWave.js";
 import { WaveRenderer } from "./renderer/WaveRenderer.js";
 import { PRESETS } from "./presets.js";
@@ -12,6 +12,6 @@ function createWave(container, config = {}, options = {}) {
 /** The drop-in embed contract: an alias of {@link createWave}. */
 const mountWave = createWave;
 //#endregion
-export { CAMERA_FITS, DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, PRESETS, WaveRenderer, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves };
+export { CAMERA_FITS, DEFAULT_LIGHT_POSITION, MAX_COLORS, MAX_LIGHTS, MAX_MESH_POINTS, MAX_NOISE_BANDS, MAX_WAVES, PARTICLE_SHAPES, PRESETS, WaveRenderer, createDefaultConfig, createDefaultMeshPoints, createLight, createNoiseBand, createWave, ensureCamera, ensureSceneDefaults, ensureStudioConfig, makeStops, makeWave, makeWaveSpread, mountWave, normalizeBackground, normalizeParticles, normalizeSceneInteraction, normalizeWave, normalizeWaveInteraction, resizeWaves };
 
 //# sourceMappingURL=standalone.js.map

package/dist/studio/thumbnail.d.ts

@@ -3,8 +3,8 @@ 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). */
+/** Mutate `cfg` for a thumbnail still: static frame, opaque, and a background chosen to show the
+ *  wave off. */
 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;

package/dist/studio/thumbnail.js

@@ -6,16 +6,25 @@ function createThumbHost(width, height) {
 	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). */
+/** Luminance (0..1) of a solid `#rrggbb` background, or null if the background isn't a plain colour
+*  (gradient / image — no single swatch to judge). */
+function solidBgLuminance(cfg) {
+	if (cfg.backgroundMode !== "color") return null;
+	const m = /^#?([\da-f]{6})$/i.exec(cfg.background ?? "");
+	if (!m) return null;
+	const n = Number.parseInt(m[1], 16);
+	return (.2126 * (n >> 16 & 255) + .7152 * (n >> 8 & 255) + .0722 * (n & 255)) / 255;
+}
+/** Mutate `cfg` for a thumbnail still: static frame, opaque, and a background chosen to show the
+*  wave off. */
 function prepThumbConfig(cfg) {
 	cfg.paused = true;
 	cfg.transparentBackground = false;
-	if (cfg.waves[0]?.theme !== "wireframe") {
-		cfg.background = "#ffffff";
-		cfg.bloomStrength = 0;
-		cfg.innerLight = 0;
-	}
+	const lum = solidBgLuminance(cfg);
+	if (cfg.waves[0]?.theme === "wireframe" || lum !== null && lum < .22) return;
+	cfg.background = "#ffffff";
+	cfg.bloomStrength = 0;
+	cfg.innerLight = 0;
 }
 /** Render the current config to a fresh 2D canvas (null if the WebGL canvas is missing). */
 function renderThumbFrame(renderer, host) {

package/dist/studio/thumbnail.js.map

@@ -1 +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\") {\n    cfg.background = \"#ffffff\";\n    // Swapping an authored dark background for the white card breaks the passes that SCATTER light\n    // out of bright pixels: they were tuned against the dark original, and white sits far above any\n    // sane threshold, so they bloom the card itself and wash the whole frame out. A preset with\n    // bloom rendered a blank white thumbnail — 0.3% non-white pixels — until this zeroed them.\n    cfg.bloomStrength = 0;\n    cfg.innerLight = 0;\n  }\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;EACvC,IAAI,aAAa;EAKjB,IAAI,gBAAgB;EACpB,IAAI,aAAa;CACnB;AACF;;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"}
+{"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/** Luminance (0..1) of a solid `#rrggbb` background, or null if the background isn't a plain colour\n *  (gradient / image — no single swatch to judge). */\nfunction solidBgLuminance(cfg: StudioConfig): number | null {\n  if (cfg.backgroundMode !== \"color\") return null;\n  const m = /^#?([\\da-f]{6})$/i.exec(cfg.background ?? \"\");\n  if (!m) return null;\n  const n = Number.parseInt(m[1], 16);\n  return (0.2126 * ((n >> 16) & 255) + 0.7152 * ((n >> 8) & 255) + 0.0722 * (n & 255)) / 255;\n}\n\n/** Mutate `cfg` for a thumbnail still: static frame, opaque, and a background chosen to show the\n *  wave off. */\nexport function prepThumbConfig(cfg: StudioConfig): void {\n  cfg.paused = true;\n  cfg.transparentBackground = false;\n  // Keep the authored background when the preset was designed on a dark ground: wireframe (its\n  // between-line colour keys off the dark page), or any solid theme on its own dark, opaque colour\n  // (e.g. Latte Ring — a warm ring that a white card just washes out). A bright wave reads fine\n  // against dark and bloom behaves there.\n  const lum = solidBgLuminance(cfg);\n  if (cfg.waves[0]?.theme === \"wireframe\" || (lum !== null && lum < 0.22)) return;\n  // Otherwise swap in a white card so the SHAPE stands out, and zero the light-scatter passes: they\n  // were tuned against the dark original, and white sits far above any sane threshold, so they'd\n  // bloom the card itself and wash the frame out (a bloomed preset rendered a blank white thumbnail\n  // — 0.3% non-white pixels — until this zeroed them).\n  cfg.background = \"#ffffff\";\n  cfg.bloomStrength = 0;\n  cfg.innerLight = 0;\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,SAAS,iBAAiB,KAAkC;CAC1D,IAAI,IAAI,mBAAmB,SAAS,OAAO;CAC3C,MAAM,IAAI,oBAAoB,KAAK,IAAI,cAAc,EAAE;CACvD,IAAI,CAAC,GAAG,OAAO;CACf,MAAM,IAAI,OAAO,SAAS,EAAE,IAAI,EAAE;CAClC,QAAQ,SAAW,KAAK,KAAM,OAAO,SAAW,KAAK,IAAK,OAAO,SAAU,IAAI,QAAQ;AACzF;;;AAIA,SAAgB,gBAAgB,KAAyB;CACvD,IAAI,SAAS;CACb,IAAI,wBAAwB;CAK5B,MAAM,MAAM,iBAAiB,GAAG;CAChC,IAAI,IAAI,MAAM,EAAE,EAAE,UAAU,eAAgB,QAAQ,QAAQ,MAAM,KAAO;CAKzE,IAAI,aAAa;CACjB,IAAI,gBAAgB;CACpB,IAAI,aAAa;AACnB;;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.6.0",
+  "version": "0.8.0",
   "description": "Framework-agnostic 3D gradient-wave renderer + config model (the engine behind Wave Studio)",
   "keywords": [
     "animation",
@@ -54,7 +54,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@tanstack/intent": "^0.3.4",
+    "@tanstack/intent": "^0.3.6",
     "@types/three": "^0.185.0",
     "three": "^0.185.0",
     "vite": "^8.1.0",
@@ -70,9 +70,11 @@
     }
   },
   "scripts": {
-    "typecheck": "tsc --noEmit",
     "build": "tsdown && pnpm build:standalone",
     "build:standalone": "vite build --config vite.standalone.config.ts",
-    "test": "vitest run"
+    "skill:stale": "intent stale skills",
+    "skill:validate": "intent validate skills",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
 }

package/skills/wave3d/SKILL.md

@@ -10,7 +10,7 @@ description: >
 metadata:
   type: core
   library: "@wave3d/core"
-  library_version: "0.6.0"
+  library_version: "0.8.0"
 sources:
   - "wave3d/wave3d:README.md"
   - "wave3d/wave3d:packages/core/src/config/model.ts"