@zkmake/three-meter 0.13.0 → 0.13.2

package/README.md

@@ -9,7 +9,7 @@ textures and shaders in GPU memory. Zero dependencies. Works with `WebGLRenderer
 bun add -d @zkmake/three-meter   # or npm i -D / pnpm add -D
 ```
 
-Live demo: [zkmake.github.io/three-kit/three-meter](https://zkmake.github.io/three-kit/three-meter/), with a vanilla three and a
+Live demo: [zkmake.github.io/three-kit/three-meter/demo](https://zkmake.github.io/three-kit/three-meter/demo/), with a vanilla three and a
 React Three Fiber take on the same scene. Add `?webgpu` for the WebGPU renderer and `?count=30000` to
 load the scene up past the demo's triangle budget.
 
@@ -346,7 +346,7 @@ The card is `.perf-hud__card`, holding `.perf-hud__brand` and your content (the
 
 ## Examples
 
-[`apps/site/src/demos/three-meter`](https://github.com/zkmake/three-kit/tree/main/apps/site/src/demos/three-meter) is what runs at [zkmake.github.io/three-kit/three-meter](https://zkmake.github.io/three-kit/three-meter/):
+[`apps/site/src/demos/three-meter`](https://github.com/zkmake/three-kit/tree/main/apps/site/src/demos/three-meter) is what runs at [zkmake.github.io/three-kit/three-meter/demo](https://zkmake.github.io/three-kit/three-meter/demo/):
 both integrations of the same scene, swapped from the header.
 [`vanilla.ts`](https://github.com/zkmake/three-kit/blob/main/apps/site/src/demos/three-meter/vanilla.ts) is plain three with `mountPerfHud`;
 [`r3f.tsx`](https://github.com/zkmake/three-kit/blob/main/apps/site/src/demos/three-meter/r3f.tsx) is React Three Fiber with `PerfSampler` and
@@ -361,6 +361,25 @@ Styles inject at runtime by default. To link them instead, pass `injectStyles: f
 
 The package never reads `NODE_ENV` or `import.meta.env`. Whether the HUD exists in production is
 your call. Gate the import in the app with a `?debug=` query, a build flag or a dynamic `import()`.
+[three-devtools](../three-devtools) is that gate, done once.
+
+A dynamic `import()` only keeps the HUD out of the first load if the bundler leaves it in its own
+chunk. A catch-all chunk group that sends every `node_modules` module to one `vendor` chunk (Vite's
+`codeSplitting.groups`, `manualChunks`) pulls the meter into a chunk `index.html` preloads, so every
+player downloads it. Leave `@zkmake` out of that group:
+
+```ts
+// vite.config.ts, build.rolldownOptions.output.codeSplitting.groups
+{
+  name: "vendor",
+  // Everything in node_modules but @zkmake, whose dev tools load behind ?debug.
+  test: /^(?!.*[\\/]node_modules[\\/]@zkmake[\\/]).*[\\/]node_modules[\\/]/,
+  priority: 10,
+},
+```
+
+Then check a production build: no chunk that `index.html` loads or preloads contains
+`PerformanceMonitor`.
 
 ## Contract
 

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as RingBuffer, t as PerformanceMonitor } from "./performance-monitor-CKAI0-Dp.js";
+import { n as RingBuffer, t as PerformanceMonitor } from "./performance-monitor-Dj5H2VXT.js";
 // src/core/wrap-animation-loop.ts
 /**
 * Wrap a `renderer.setAnimationLoop` callback so each tick is one frame:

package/dist/{mount-perf-hud-DefBWWKu.js → mount-perf-hud-s8ezVm_5.js}

@@ -1428,7 +1428,7 @@ const mountDevPanel = (options) => {
 };
 // package.json
 var name = "@zkmake/three-meter";
-var version = "0.13.0";
+var version = "0.13.2";
 // src/ui/clipboard.ts
 /**
 * Copy text from a click handler. The async Clipboard API needs a secure
@@ -2648,4 +2648,4 @@ const mountPerfHud = (monitor, options = {}) => {
 };
 export { mountDevPanel as a, dockPanel as c, HudTheme as d, THEME_MODES as f, formatQuality as i, DEFAULT_STORAGE_KEY as l, resolveBudgets as m, PerformanceView as n, PERF_HUD_STYLES as o, isThemeMode as p, formatReport as r, injectStyles as s, mountPerfHud as t, HudSettings as u };
 
-//# sourceMappingURL=mount-perf-hud-DefBWWKu.js.map
+//# sourceMappingURL=mount-perf-hud-s8ezVm_5.js.map