three-virtual-geometry 0.1.0 → 0.1.2

package/AGENTS.md

@@ -25,6 +25,20 @@ npm run bench        # uncapped FPS of every demo scene in Chrome (Playwright) -
 GPU code can only be checked in a WebGPU browser. After runtime changes, load the demo scenes and check the console
 for WebGPU validation errors and the HUD for `overflow`.
 
+## Releasing
+
+Releases are published by GitHub Actions (`.github/workflows/release.yml`) with npm Trusted Publishing: no npm
+token exists anywhere, and each version gets a provenance attestation on npm.
+
+```bash
+npm version patch            # or minor / major: bumps package.json, commits and tags vX.Y.Z
+git push --follow-tags       # the tag starts the Release workflow
+```
+
+The workflow checks that the tag matches `package.json`, runs typecheck, tests, build and `check:types`, publishes
+to npm, and creates the GitHub release with generated notes. jsDelivr and unpkg pick up the new version from npm.
+Don't publish from a laptop.
+
 ## Layout
 
 | Path | Role |

package/dist/core/import/fromObject3D.d.ts

@@ -6,9 +6,9 @@
  * is built once. Skinned and morphing meshes, points, lines and sprites are left alone and keep rendering.
  */
 import * as THREE from 'three/webgpu';
-import { type VirtualMeshBuildOptions, type VirtualMeshData, type VirtualMeshSource } from '../preprocess/buildVirtualMesh';
-import type { VirtualGeometry } from '../runtime/VirtualGeometry';
-import type { VirtualMesh, VirtualMeshOptions } from '../runtime/VirtualMesh';
+import { type VirtualMeshBuildOptions, type VirtualMeshData, type VirtualMeshSource } from '../preprocess/buildVirtualMesh.js';
+import type { VirtualGeometry } from '../runtime/VirtualGeometry.js';
+import type { VirtualMesh, VirtualMeshOptions } from '../runtime/VirtualMesh.js';
 /** Builds one DAG. Same signature as `buildVirtualMesh`, so a caching builder drops in here or via `options.builder`. */
 export type VirtualGeometryBuilder = (source: VirtualMeshSource, options?: VirtualMeshBuildOptions) => Promise<VirtualMeshData>;
 export interface VirtualGeometryImportOptions {

package/dist/core/io/cache.d.ts

@@ -3,7 +3,7 @@
  * source arrays and build options. The first load builds and stores the encoded result; later loads decode
  * it. Any cache problem (no IndexedDB, private mode, quota, corrupt entry) falls back to building.
  */
-import { type VirtualMeshBuildOptions, type VirtualMeshData, type VirtualMeshSource } from '../preprocess/buildVirtualMesh';
+import { type VirtualMeshBuildOptions, type VirtualMeshData, type VirtualMeshSource } from '../preprocess/buildVirtualMesh.js';
 /**
  * Part of every cache key. Bump it whenever `buildVirtualMesh` produces different output for the same input
  * (algorithm or default changes), so stale cached builds are never returned.

package/dist/core/io/serialize.d.ts

@@ -1,4 +1,4 @@
-import type { VirtualMeshData } from '../preprocess/buildVirtualMesh';
+import type { VirtualMeshData } from '../preprocess/buildVirtualMesh.js';
 /** Bumped whenever the container layout or an encoding changes; older readers reject newer files. */
 export declare const VG_FORMAT_VERSION = 1;
 export interface VirtualMeshEncodeOptions {

package/dist/core/runtime/GeometryPool.d.ts

@@ -28,8 +28,8 @@
  * Based on nanite-webgpu (MIT, Marcin Matuszczyk): cullMeshletsPass + rasterizeHwPass.
  */
 import * as THREE from 'three/webgpu';
-import type { VirtualMeshData } from '../preprocess/buildVirtualMesh';
-import type { VirtualGeometry } from './VirtualGeometry';
+import type { VirtualMeshData } from '../preprocess/buildVirtualMesh.js';
+import type { VirtualGeometry } from './VirtualGeometry.js';
 type Node = any;
 /** World-space normal of the current vertex, usable in material color/roughness nodes. */
 export declare const vgWorldNormal: THREE.PropertyNode<"vec3">;

package/dist/core/runtime/OcclusionCulling.d.ts

@@ -24,7 +24,7 @@
  * sized for `maxSize`, so nothing is reallocated on resize.
  */
 import * as THREE from 'three/webgpu';
-import type { VirtualMesh } from './VirtualMesh';
+import type { VirtualMesh } from './VirtualMesh.js';
 type Node = any;
 export declare class OcclusionCulling {
     /** Lever: set false to turn occlusion culling off (no occluder pass, no HZB, nothing culled by it). */

package/dist/core/runtime/VirtualGeometry.d.ts

@@ -1,10 +1,10 @@
 import * as THREE from 'three/webgpu';
-import type { VirtualMesh, VirtualMeshInstances, VirtualMeshOptions } from './VirtualMesh';
-import { OcclusionCulling } from './OcclusionCulling';
-import type { VirtualMeshData } from '../preprocess/buildVirtualMesh';
-import { GeometryPool } from './GeometryPool';
-import { type VirtualGeometryImport, type VirtualGeometryImportOptions } from '../import/fromObject3D';
-export { VG_DEBUG_MODES } from '../constants';
+import type { VirtualMesh, VirtualMeshInstances, VirtualMeshOptions } from './VirtualMesh.js';
+import { OcclusionCulling } from './OcclusionCulling.js';
+import type { VirtualMeshData } from '../preprocess/buildVirtualMesh.js';
+import { GeometryPool } from './GeometryPool.js';
+import { type VirtualGeometryImport, type VirtualGeometryImportOptions } from '../import/fromObject3D.js';
+export { VG_DEBUG_MODES } from '../constants.js';
 export interface VirtualGeometryStats {
     drawnMeshlets: number;
     drawnTriangles: number;

package/dist/core/runtime/VirtualMesh.d.ts

@@ -6,10 +6,10 @@
  * the camera cut and the shadow cut, which draw this mesh's region of the pool's index buffers.
  */
 import * as THREE from 'three/webgpu';
-import type { VirtualMeshData } from '../preprocess/buildVirtualMesh';
-import type { VirtualGeometry } from './VirtualGeometry';
-import { type GeometryPool, type PoolEntry } from './GeometryPool';
-export { vgWorldNormal, encodeOctNormal, packVertices, packUvs } from './GeometryPool';
+import type { VirtualMeshData } from '../preprocess/buildVirtualMesh.js';
+import type { VirtualGeometry } from './VirtualGeometry.js';
+import { type GeometryPool, type PoolEntry } from './GeometryPool.js';
+export { vgWorldNormal, encodeOctNormal, packVertices, packUvs } from './GeometryPool.js';
 export interface VirtualMeshInstances {
     /** 16 floats (column-major Matrix4) per instance. */
     matrices: Float32Array;

package/dist/core/runtime/cut.d.ts

@@ -1,4 +1,4 @@
-import type { VirtualMeshData } from '../preprocess/buildVirtualMesh';
+import type { VirtualMeshData } from '../preprocess/buildVirtualMesh.js';
 /** Camera parameters the LOD test needs. Same values the GPU pass uses. */
 export interface CutView {
     /** Column-major world-to-view matrix (camera.matrixWorldInverse.elements). */

package/dist/index.d.ts

@@ -13,23 +13,23 @@
  * Lower level: `buildVirtualMeshCached(fromBufferGeometry(geometry))` once per mesh, then
  * `vg.createMesh(data, material, { matrices })` (16 floats per instance) and add it to a scene.
  */
-export { buildVirtualMesh } from './core/preprocess/buildVirtualMesh';
-export type { VirtualMeshBuildOptions, VirtualMeshData, VirtualMeshSource } from './core/preprocess/buildVirtualMesh';
-export { partitionMeshlets } from './core/preprocess/partition';
-export { buildVirtualMeshCached, clearVirtualMeshCache, virtualMeshCacheKey, VG_BUILD_VERSION } from './core/io/cache';
-export type { VirtualGeometryCacheOptions, VirtualGeometryCachedBuildOptions } from './core/io/cache';
-export { decodeVirtualMesh, encodeVirtualMesh, loadVirtualMesh, VirtualMeshFormatError, VG_FORMAT_VERSION } from './core/io/serialize';
-export type { VirtualMeshEncodeOptions } from './core/io/serialize';
-export { instanceGuaranteedRange, instanceMeshletRange, selectCut, verifyCutCoverage } from './core/runtime/cut';
-export type { CutView } from './core/runtime/cut';
-export { VirtualMesh, vgWorldNormal } from './core/runtime/VirtualMesh';
-export { vgUv, vgTexture, vgNormalMap, bindVirtualGeometryTextures } from './core/runtime/vgMaterial';
-export { toNodeMaterial, canConvertToNodeMaterial } from './core/import/toNodeMaterial';
-export { virtualMeshesFromObject3D, collectVirtualGeometryGroups, VirtualGeometryImport } from './core/import/fromObject3D';
-export type { VirtualGeometryImportOptions, VirtualGeometryImportGroup, VirtualGeometryBuilder } from './core/import/fromObject3D';
-export type { VirtualMeshInstances, VirtualMeshOptions } from './core/runtime/VirtualMesh';
-export { VirtualGeometry } from './core/runtime/VirtualGeometry';
-export type { VirtualGeometryStats, VirtualGeometryOptions } from './core/runtime/VirtualGeometry';
-export { VG_DEBUG_MODES, MAX_MESHLET_TRIANGLES, MAX_MESHLET_VERTICES } from './core/constants';
-export { fromBufferGeometry, mergeSources } from './source';
-export type { FromGeometryOptions } from './source';
+export { buildVirtualMesh } from './core/preprocess/buildVirtualMesh.js';
+export type { VirtualMeshBuildOptions, VirtualMeshData, VirtualMeshSource } from './core/preprocess/buildVirtualMesh.js';
+export { partitionMeshlets } from './core/preprocess/partition.js';
+export { buildVirtualMeshCached, clearVirtualMeshCache, virtualMeshCacheKey, VG_BUILD_VERSION } from './core/io/cache.js';
+export type { VirtualGeometryCacheOptions, VirtualGeometryCachedBuildOptions } from './core/io/cache.js';
+export { decodeVirtualMesh, encodeVirtualMesh, loadVirtualMesh, VirtualMeshFormatError, VG_FORMAT_VERSION } from './core/io/serialize.js';
+export type { VirtualMeshEncodeOptions } from './core/io/serialize.js';
+export { instanceGuaranteedRange, instanceMeshletRange, selectCut, verifyCutCoverage } from './core/runtime/cut.js';
+export type { CutView } from './core/runtime/cut.js';
+export { VirtualMesh, vgWorldNormal } from './core/runtime/VirtualMesh.js';
+export { vgUv, vgTexture, vgNormalMap, bindVirtualGeometryTextures } from './core/runtime/vgMaterial.js';
+export { toNodeMaterial, canConvertToNodeMaterial } from './core/import/toNodeMaterial.js';
+export { virtualMeshesFromObject3D, collectVirtualGeometryGroups, VirtualGeometryImport } from './core/import/fromObject3D.js';
+export type { VirtualGeometryImportOptions, VirtualGeometryImportGroup, VirtualGeometryBuilder } from './core/import/fromObject3D.js';
+export type { VirtualMeshInstances, VirtualMeshOptions } from './core/runtime/VirtualMesh.js';
+export { VirtualGeometry } from './core/runtime/VirtualGeometry.js';
+export type { VirtualGeometryStats, VirtualGeometryOptions } from './core/runtime/VirtualGeometry.js';
+export { VG_DEBUG_MODES, MAX_MESHLET_TRIANGLES, MAX_MESHLET_VERTICES } from './core/constants.js';
+export { fromBufferGeometry, mergeSources } from './source.js';
+export type { FromGeometryOptions } from './source.js';