Sync upstream

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,119 @@
+name: 🐞 Bug Report
+description: File a technical issue, import or export problem, API issue
+labels: ["untriaged"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report. The more info you add, the higher the chance that we'll be able to help! 🙏
+
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: Describe the bug 💬
+      description: A clear and concise description of what the bug is. Thanks!
+      placeholder: I am doing... What I expect to happen is... What's actually happening is ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction-steps
+    attributes:
+      label: Steps to reproduce 🔢
+      description: Please provide step-by-step instructions for how to see the issue you're describing with the files you provide.
+      placeholder: |
+        1. Download the attached reproduction file
+        2. Drop it into Unity <insert version>
+        3. See <specific error> in console
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Files to reproduce the issue ♻
+      description: Please drop necessary files to reproduce the problem you ran into as `.zip` file or paste a link to a `.gltf/.glb`. A [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) is best ([Why?](https://antfu.me/posts/why-reproductions-are-required)).
+      placeholder: Reproduction files or URL
+    validations:
+      required: false
+
+  - type: dropdown
+    id: version
+    attributes:
+      label: Editor Version 🎲
+      description: Which Unity version are you using? Please note that while we try to support the latest Unity versions, officially only LTS versions are supported.
+      options:
+        - 2020.3 or older
+        - 2021.3
+        - 2022.3
+        - 6000.0
+        - Other (Provide details below)
+      default: 1
+    validations:
+      required: true
+
+  - type: input
+    id: renderpipeline
+    attributes:
+      label: Render Pipeline and version
+      placeholder: URP 10.0.0 / HDRP 10.0.0 / Built-In Render Pipeline
+    validations:
+      required: true
+
+  - type: input
+    id: unitygltf
+    attributes:
+      label: UnityGLTF Version
+      placeholder: 2.13.0
+    validations:
+      required: true
+
+  - type: dropdown
+    id: OS
+    attributes:
+      label: Operating System 👩‍💻
+      description: Which operating system are you using / on which operating system did you observe the issue?
+      multiple: true
+      options:
+        - Windows
+        - macOS
+        - Linux
+        - iOS
+        - Android
+        - WebGL
+        - VisionOS
+        - Other (Provide details below)
+    validations:
+      required: true
+
+  - type: checkboxes
+    attributes:
+      label: When does this problem happen?
+      description: Does this issue happen in the Unity Editor (e.g. when importing assets to your project) or at runtime (e.g. when loading assets in your build)
+      options:
+        - label: Editor Import
+        - label: Runtime Import
+        - label: Editor Export
+        - label: Runtime Export
+    validations:
+      required: true
+
+  - type: textarea
+    id: project-info
+    attributes:
+      label: Additional Info 📜
+      description: |
+        Provide additional information that might be useful to understand your use case.
+
+  - type: checkboxes
+    id: checkboxes
+    attributes:
+      label: Validations 🩹
+      description: Before submitting the issue, please make sure you do the following
+      options:
+        - label: "I have [searched existing issues](https://github.com/KhronosGroup/UnityGLTF/issues): no issue already exist that reports the same problem."
+          required: true
+        - label: I follow the [Code of Conduct](https://www.khronos.org/about/code-of-conduct)
+          required: true
+        - label: I provided a [minimal reproducible example](https://stackoverflow.com/help/minimal-reproducible-example), including files when necessary.
+          required: false        

CHANGELOG.md

@@ -4,6 +4,85 @@ 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).
 
+## [2.15.0] - 2025-03-06
+
+- fix: assets with absolute URLs or paths containing URL encoded information now load correctly
+- fix: improve shader dependencies in editor importer to work around some edge cases at first library import
+- fix: check all sub-meshes of used attributes instead of only the first one when creating attribute arrays
+- fix: ensure progress callback is triggered before `onLoadComplete` in scene loader
+- fix: prevent null reference exception when plugin is not loaded/defined
+- fix: work around API change in Unity 6000.0.38f1 that caused compilation error
+- fix: clamped `Sheen Roughness` to 0..1 range in PBRGraph shader
+- fix: `RoughRefractionFeature` now supports Unity 6 and new Render Graph API
+- fix: set volume and transmission materials to `AlphaMode.BLEND` on VisionOS to ensure proper rendering
+- fix: update render pipeline-related methods for Unity 6000.0+
+- change: mark package as compatible with Unity 2021.3+. Legacy support for 2020 and earlier will be removed in future updates.
+- change: renamed `GLTFComponent` setting `AppendStreamingAssets` to `LoadFromStreamingAssetsFolder`
+- add: MaterialX branches to `UnityGLTF/PBRGraph` shader with conditional compilation for VisionOS
+- add: `MaterialXColor` and `MaterialXFloat` shadersubgraphs for platform-specific material settings
+- add: new runtime texture compression option (`None`, `LowQuality`, `HighQuality`) to improve runtime memory usage
+- add: exposed import settings to keep CPU copy of mesh/textures to `GLTFComponent`
+- add: include UnityGLTF package version, Unity version and current render pipeline in `assets.extras` on export
+- add: better code snippets for the readme
+- add: export plugin hook for `ShouldNodeExport` (https://github.com/KhronosGroup/UnityGLTF/pull/767)
+- add: [`KHR_node_visibility`](https://github.com/KhronosGroup/glTF/pull/2410) import and export support, currently disabled by default. Enable in `UnityGLTFSettings`. This is a preparative step for `KHR_interactivity`, which will be added in a later release. Please note that this extension is not yet ratified and implementation details may change.
+- add: schema and serialization support for [`KHR_node_hoverability`](https://github.com/KhronosGroup/glTF/pull/2426) and [`KHR_node_selectability`](https://github.com/KhronosGroup/glTF/pull/2422). Please note that these extensions are not yet ratified and implementation details may change.
+
+## [2.14.1] - 2024-10-28
+
+- fix: compiler error with `ParticleSystemBakeMeshOptions` before 2022.3.11f1 since that's where the API was introduced
+- fix: prevent incorrect warning when meshes don't have UV1/UV2 attributes
+- fix: don't call export multiple times from context menu for multi-selections
+- fix: remove unused property from `GLTFComponent`
+
+## [2.14.0] - 2024-10-06
+
+- fix: potential NullReferenceExceptions when importing material-only, mesh-only or texture-only glTF files
+- fix: check for missing primitives on mesh import instead of throwing
+- fix: GLTFSceneImporter reference counting properly tracks Animation data now
+- fix: incorrect callback subscription in glTF Material editing
+- fix: CanvasExport plugin was not working correctly in WebGL builds
+- fix: rare case of incorrect texture export with invalid texture content hash (thanks @Vaso64)
+- fix: ensure materials created with Create > UnityGLTF > Material use UnityGLTF as importer instead of glTFast
+- fix: Canvas export plugin was not correctly updating the canvas mesh in builds
+- fix: Particle Bake export plugin was not working correctly in 2022.3
+- fix: Import/Export plugin enabled/disabled state was not correctly serialized in some cases
+- fix: TMPro export plugin uses UnityGLTF shaders for export now instead of adding another dependency
+- fix: GLTFSceneImporter can be called without external data loader, but will warn that external data will not be loaded. Previously, a data loader had to be added even when it was not needed.
+- change: log warning when exporting UV0 and UV1 with more than 2 components, as glTF only supports 2-component UVs
+- change: simplify sampler usage in PBRGraph where possible to prevent warnings in later Unity versions
+- change: simplify PBRGraph variants to reduce shader variant count. This removes a separate option to use vertex color.
+- change: material-only files are now imported as MaterialLibrary assets with Material sub-assets, even when only a single material is present
+- add: log more meaningful exception messages on import
+- add: sheen support for PBRGraph
+- add: PBRGraph UI properly shows sheen and dispersion properties
+- add: allow flipping humanoid root bone on import to support more avatar types (like Meta Avatars)
+- add: new "Info" tab in GLTFImporter for asset information (generator, copyright, etc.) about the imported file
+- add: ShaderOverride is now public on GLTFComponent
+- add: new GLTFSceneImporter constructor overload for easier loading of files from streams
+- add: meshes and textures can now be deduplicated on import, since many exporters don't properly instance them
+- add: UV2 is exported as 2-, 3-, or 4-component texture coordinate. 3- and 4-component texture coordinates are not in the core glTF spec, but widely supported by implementations.
+- add: complete PBRGraph and UnlitGraph Shader Variant Collections for easier runtime import and export of glTF files
+- add: options for shader pass stripping in builds to reduce variant count and compilation times
+- add: ability to export a set of materials as material-only glTF or glb file
+- add: option to add new materials to glTF Material Libraries (material-only files)
+
+## [2.13.0] - 2024-07-23
+
+- fix: empty or invalid root transforms should not be exported
+- fix: when no root transforms are exported, no scene should be created by default
+- fix: image filenames were sometimes incorrectly exported when exporting .gltf files (#737)
+- fix: set wrap mode for legacy animation import mode
+- fix: added missing ExtTransform for some textures in animationpointer import/export, fixes when only offset exist (#740)
+- fix: added uv-starts-at-top check for transmission support on WebGL and other platforms (#746)
+- fix: added missing generate mitmaps to ktx texture load (#752)
+- fix: bone name mapping for exact names was not applied on humanoid import (#751)
+- fix: added missing using system for uwp target (#757)
+- add: allow importing non-standard VEC3 and VEC4 TEXCOORD_n data and convert it to VEC2
+- add: exposed texture readwrite enabled and generate mipmaps option to importer
+- change: removed log for loaded node count mismatch, extensions can modify node counts so the log was misleading
+- change: removed loaded texture count error log: when multiple samplers are used for one texture, the textures will be duplicated
+
 ## [2.12.0] - 2024-05-06
 
 - fix: PolySpatial support now also includes emission textures and colors