Skip to content

Refactor pipelines around glTF documents - #15

Merged
alexchuber merged 26 commits into
mainfrom
gltf-transform-scope
Sep 15, 2026
Merged

Refactor pipelines around glTF documents#15
alexchuber merged 26 commits into
mainfrom
gltf-transform-scope

Conversation

@alexchuber

@alexchuber alexchuber commented Sep 15, 2026

Copy link
Copy Markdown
Contributor

Summary

  • replace Babylon Scene runtime data with glTF Transform Document
  • keep Babylon loaders private to FBX, OBJ, and STL conversion boundaries
  • add self-contained KTX2, Draco, and Meshopt encoding blocks
  • share execution-scoped PlatformIO and codec resources
  • publish one universal Node/browser entry with bundled Draco WASM assets
  • remove the previous Babylon Draco worker and compression-option infrastructure

Breaking changes

  • replace CompressTexturesBlock with EncodeKTX2Block
  • replace DracoEncoderBlock and GltfMeshCompressionOptions with EncodeDracoBlock
  • input blocks now pass the new content representation through graph connections

Validation

  • pnpm lint
  • pnpm test — 61 tests
  • pnpm build

alexchuber and others added 26 commits September 14, 2026 13:14
@alexchuber
docs: clarify document and encoder contracts
8e608e9 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: shorten future marker
89f4d95 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: generalize runtime data wording
8abd6d1 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: specify Meshopt encoder runtime data
df8b363 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: use self-contained encoding blocks
db1de82 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: trim encoding block description
6228dab 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: shorten KTX2 behavior description
295a9f4 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: remove encoding block preamble
4510326 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: mark file connection types as future
267c919 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: mark file operations as future
de2320b 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: define execution-scoped resource ownership
c5a47c4 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: distinguish runtime data from resources
19bdf74 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: record encoding defaults and worker scope
8cc8bd9 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
refactor: use glTF documents as runtime data
88edfbb 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
fix: reject failed texture rebinding
a8cf527 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@alexchuber
fix: publish browser-safe consumer bundle
f6a47af 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@alexchuber
refactor: unify Node and browser builds
e619eb2 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: keep block outputs implementation-neutral
1023abe 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
test: clarify KTX2 metadata regressions
8c3a212 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
test: remove internal texture loader assertion
b6ea5b6 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
test: note browser runtime coverage gap
33d097d 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
refactor: let blocks register glTF extensions
c91e551 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
test: cover KTX2 and Meshopt pipeline
29dedfa 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: explain direct KTX2 encoder use
0b5c108 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
refactor: rename Node runtime helper
156b925 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
docs: explain texture rebinding before export
10da29d 
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@alexchuber
alexchuber merged commit 8373812 into main Sep 15, 2026
2 checks passed
@alexchuber
alexchuber deleted the gltf-transform-scope branch September 15, 2026 05:29
alexchuber added a commit to alexchuber/Node-Assets that referenced this pull request Sep 21, 2026
@alexchuber
Refactor pipelines around glTF documents (BabylonJS#15)
45e7956 
* docs: clarify document and encoder contracts

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: shorten future marker

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: generalize runtime data wording

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: specify Meshopt encoder runtime data

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: use self-contained encoding blocks

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: trim encoding block description

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: shorten KTX2 behavior description

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: remove encoding block preamble

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: mark file connection types as future

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: mark file operations as future

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: define execution-scoped resource ownership

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: distinguish runtime data from resources

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: record encoding defaults and worker scope

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* refactor: use glTF documents as runtime data

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* fix: reject failed texture rebinding

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: publish browser-safe consumer bundle

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* refactor: unify Node and browser builds

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: keep block outputs implementation-neutral

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* test: clarify KTX2 metadata regressions

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* test: remove internal texture loader assertion

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* test: note browser runtime coverage gap

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* refactor: let blocks register glTF extensions

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* test: cover KTX2 and Meshopt pipeline

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: explain direct KTX2 encoder use

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* refactor: rename Node runtime helper

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: explain texture rebinding before export

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@alexchuber