@needle-tools/gltf-progressive 3.3.3-next.ff6503a → 3.3.4

package/CHANGELOG.md

@@ -4,6 +4,9 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [3.3.4] - 2025-09-10
+- Fix: import with missing `.js` extension
+
 ## [3.3.3] - 2025-09-08
 - Update documentation and add an initial extension definition
 

package/NEEDLE_progressive/README.md

@@ -0,0 +1,106 @@
+# NEEDLE Progressive Extensions Schema
+
+This document describes the NEEDLE progressive mesh and texture extensions.
+
+## Base Types
+
+### NEEDLE_progressive_model_LOD
+
+Represents a single Level of Detail (LOD) file reference.
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `path` | `string` | Yes | Relative path to the LOD file |
+| `hash` | `string` | No | Optional hash for file verification |
+
+### NEEDLE_progressive_ext
+
+Base extension format for progressive assets.
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `guid` | `string` | Yes | Unique identifier of the object (texture, mesh) the LODs belong to |
+| `lods` | `Array<NEEDLE_progressive_model_LOD>` | Yes | Array of available LOD levels |
+
+## Extension Types
+
+### NEEDLE_ext_progressive_texture
+
+Texture extension for progressive texture loading, inheriting from `NEEDLE_progressive_ext`.
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `guid` | `string` | Yes | Inherited from base type |
+| `lods` | `Array<TextureLOD>` | Yes | Array of texture LOD levels with dimensions |
+
+**TextureLOD Properties:**
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `path` | `string` | Yes | Relative path to the texture LOD file |
+| `hash` | `string` | No | Optional hash for file verification |
+| `width` | `number` | Yes | Texture width in pixels |
+| `height` | `number` | Yes | Texture height in pixels |
+
+### NEEDLE_ext_progressive_mesh
+
+Mesh extension for progressive mesh loading, inheriting from `NEEDLE_progressive_ext`.
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `guid` | `string` | Yes | Inherited from base type |
+| `lods` | `Array<MeshLOD>` | Yes | Array of mesh LOD levels with geometry data |
+
+**MeshLOD Properties:**
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `path` | `string` | Yes | Relative path to the mesh LOD file |
+| `hash` | `string` | No | Optional hash for file verification |
+| `densities` | `number[]` | Yes | Density values per primitive |
+| `indexCount` | `number` | No | Number of indices in LOD0 |
+| `vertexCount` | `number` | No | Number of vertices in LOD0 |
+
+## Usage Examples
+
+### Texture Extension Example
+
+```json
+{
+  "guid": "texture-asset-123",
+  "lods": [
+    {
+      "path": "./textures/image_diffuse_1024.glb",
+      "hash": "abc123",
+      "width": 1024,
+      "height": 1024
+    },
+    {
+      "path": "./textures/image_diffuse_512.glb",
+      "width": 512,
+      "height": 512
+    }
+  ]
+}
+```
+
+### Mesh Extension Example
+
+```json
+{
+  "guid": "mesh-asset-456",
+  "lods": [
+    {
+      "path": "./meshes/mesh_0_high_detail.glb",
+      "hash": "def456",
+      "indexCount": 15000,
+      "vertexCount": 8000,
+      "densities": [100000, 50000]
+    },
+    {
+      "path": "./meshes/mesh_1_low_detail.glb",
+      "indexCount": 3000,
+      "vertexCount": 1500,
+      "densities": [100000, 50000]
+    }
+  ]
+}
+```

package/lib/lods.promise.js

@@ -1,4 +1,4 @@
-import { debug } from "./lods.debug";
+import { debug } from "./lods.debug.js";
 /**
  * A group of promises that can be awaited together.
  * This is used for awaiting LOD

package/lib/version.js

@@ -1,4 +1,4 @@
 // replaced at build time
-export const version = "3.3.3";
+export const version = "3.3.4";
 globalThis["GLTF_PROGRESSIVE_VERSION"] = version;
 console.debug(`[gltf-progressive] version ${version || "-"}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/gltf-progressive",
-  "version": "3.3.3-next.ff6503a",
+  "version": "3.3.4",
   "description": "three.js support for loading glTF or GLB files that contain progressive loading data",
   "homepage": "https://needle.tools",
   "author": {
@@ -10,7 +10,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/needle-tools/needle-engine-support"
+    "url": "git+https://github.com/needle-tools/gltf-progressive"
   },
   "readme": "README.md",
   "keywords": [
@@ -73,4 +73,4 @@
     "vite": "7"
   },
   "types": "./lib/index.d.ts"
-}
+}