@babylonjs/lite-compat 1.39.2 → 1.39.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,22 +1,36 @@
1
1
  # Changelog
2
2
 
3
- ## @babylonjs/lite v1.39.2
3
+ ## @babylonjs/lite v1.39.3
4
+
5
+ ### ⚠️ BREAKING CHANGES
6
+
7
+ - **scene:** add per-family scene collections for text, depth-hosted sprites, and billboards ([#907](https://github.com/BabylonJS/Babylon-Lite/pull/907))
4
8
 
5
9
  ### ✨ Features
6
10
 
11
+ - **compat:** wrap native SSAO2 rendering pipeline ([#908](https://github.com/BabylonJS/Babylon-Lite/pull/908))
12
+ - add public texture pixel readback ([#906](https://github.com/BabylonJS/Babylon-Lite/pull/906))
13
+ - **compat:** wrap HTML-in-Canvas polyfill lifecycle ([#903](https://github.com/BabylonJS/Babylon-Lite/pull/903))
14
+ - **compat:** support texture replacement and stub indirect submeshes ([#901](https://github.com/BabylonJS/Babylon-Lite/pull/901))
7
15
  - **compat:** sync bent normals and BJS 9.35 APIs ([#896](https://github.com/BabylonJS/Babylon-Lite/pull/896))
8
16
  - **engine:** add createDevice for early WebGPU device acquisition ([#900](https://github.com/BabylonJS/Babylon-Lite/pull/900))
9
17
 
10
18
  ### 🐛 Bug Fixes
11
19
 
20
+ - **ktx2:** retry failed transcoder WASM fetches ([#905](https://github.com/BabylonJS/Babylon-Lite/pull/905))
21
+ - **texture:** restore HTML texture elements relocated by HTML-in-Canvas polyfills ([#897](https://github.com/BabylonJS/Babylon-Lite/pull/897))
12
22
  - **build:** rewrite all static Lite error messages ([#899](https://github.com/BabylonJS/Babylon-Lite/pull/899))
13
23
  - **demos:** repair ambient occlusion deployment and controls ([#894](https://github.com/BabylonJS/Babylon-Lite/pull/894))
14
24
 
25
+ ### 🏗️ Build & CI
26
+
27
+ - add dependency review workflow ([#904](https://github.com/BabylonJS/Babylon-Lite/pull/904))
28
+
15
29
  ### 🔧 Other Changes
16
30
 
17
31
  - Clone rotation fix ([#893](https://github.com/BabylonJS/Babylon-Lite/pull/893))
18
32
 
19
- **Full Changelog**: https://github.com/BabylonJS/Babylon-Lite/compare/npm-lite-v1.39.0...npm-lite-v1.39.2
33
+ **Full Changelog**: https://github.com/BabylonJS/Babylon-Lite/compare/npm-lite-v1.39.0...npm-lite-v1.39.3
20
34
 
21
35
  ## @babylonjs/lite v1.39.0
22
36
 
package/README.md CHANGED
@@ -128,7 +128,7 @@ overloads within a supported area may still be absent.
128
128
  | CSG / CSG2 | ✅ | over Lite boolean ops |
129
129
  | Gizmos (position/rotation/scale/bounding-box/light/camera + `GizmoManager`) | ⚡ | over Lite gizmo suite; `isEnabled` toggles per-axis interactivity (display-only when disabled) |
130
130
  | Materials (`StandardMaterial`, `PBRMaterial`, metallic-rough / spec-gloss, `NodeMaterial`) | ⚡ | Includes native bent-normal IBL occlusion and cloned loaded PBR materials; BJS parallax scale semantics, Gaussian-splat plugins, preprocessed `ShaderMaterial`, `MultiMaterial`, `BackgroundMaterial`, and `OpenPBRMaterial` remain unsupported |
131
- | Textures (`Texture`, `RawTexture`, `RawTexture2DArray`, `RawTexture3D`, `DynamicTexture`, `HtmlTexture`, `ExternalTexture`, cube textures) | ⚡ | New texture/scatter processors support exact constant-only paths; textured operands need BJS's missing procedural render-target pipeline and throw. Arrays, base-level 3D volumes, dynamic/HTML/external textures, and cube environments work; `RenderTargetTexture` / `MirrorTexture` remain unsupported |
131
+ | Textures (`Texture`, `RawTexture`, `RawTexture2DArray`, `RawTexture3D`, `DynamicTexture`, `HtmlTexture`, `ExternalTexture`, cube textures) | ⚡ | URL textures support ready-image replacement with material rebinding. Texture/scatter processors support exact constant-only paths; textured operands need BJS's missing procedural render-target pipeline and throw. Arrays, base-level 3D volumes, dynamic/HTML/external textures, and cube environments work; `RenderTargetTexture` / `MirrorTexture` remain unsupported |
132
132
  | Animation (keyframe `Animation`, easing, `Animatable`, `AnimationGroup` incl. weighted/additive blend) | ⚡ | All standard easing classes, including `PowerEase` / `BezierCurveEase`, reuse Lite's native functional curves; `beginAnimation` / `beginDirectAnimation` delegate supported float/vector/quaternion tracks to Lite property animation; unsupported tracks use an explicit compat evaluator; structural groups remain compat-owned; loaded glTF skeletal blending supported; root-motion analysis/controller APIs throw |
133
133
  | Morph targets (`MorphTarget` / `MorphTargetManager`) | ✅ | over Lite morph targets, including named loader-produced targets and live influence writes |
134
134
  | Sprites (`SpriteManager` / `Sprite`) | ⚡ | camera-facing billboards; `SpriteMap` / packed atlas unsupported |
package/index.d.ts CHANGED
@@ -3707,7 +3707,13 @@ export declare class IncrementValueAction extends Action {
3707
3707
  /** Babylon.js `InitializeCSG2Async()` — load the Manifold runtime before any `CSG2` use. */
3708
3708
  export declare function InitializeCSG2Async(): Promise<void>;
3709
3709
 
3710
- /** Babylon.js `InstallHtmlInCanvasPolyfill` — the HTML-in-canvas polyfill is unsupported by the compat layer. */
3710
+ /**
3711
+ * Babylon.js `InstallHtmlInCanvasPolyfill`.
3712
+ *
3713
+ * The installed polyfill would redirect Lite to an incompatible positional
3714
+ * upload API, so exposing the installer without changing Lite's hot path would
3715
+ * break otherwise-working HTML textures.
3716
+ */
3711
3717
  export declare function InstallHtmlInCanvasPolyfill(): never;
3712
3718
 
3713
3719
  /** Babylon.js `InstancedMesh` — hardware instances are not modelled; use thin instances. */
@@ -3785,7 +3791,13 @@ export declare interface ISceneLoaderProgressEvent {
3785
3791
  /** Babylon.js internal polyfill-state query. Compat never installs the unsupported polyfill. */
3786
3792
  export declare function _IsHtmlInCanvasPolyfillInstalled(): boolean;
3787
3793
 
3788
- /** Babylon.js `IsHtmlInCanvasSupportedNatively` — the HTML-in-canvas feature is unsupported by the compat layer. */
3794
+ /**
3795
+ * Babylon.js `IsHtmlInCanvasSupportedNatively`.
3796
+ *
3797
+ * The legacy polyfill uses a positional upload signature that Lite's existing
3798
+ * HTML texture module cannot consume without adding feature branches to a
3799
+ * module already included by HTML-texture users.
3800
+ */
3789
3801
  export declare function IsHtmlInCanvasSupportedNatively(): never;
3790
3802
 
3791
3803
  /** Babylon.js `IsHtmlInCanvasUploadSupported` — kept in lockstep with the unavailable upload helper. */
@@ -5085,7 +5097,8 @@ export declare class PBRMetallicRoughnessMaterial extends PBRMaterial {
5085
5097
  export declare class PBRSheenConfiguration {
5086
5098
  private readonly _props;
5087
5099
  private readonly _markDirty;
5088
- constructor(_props: SheenProps, _markDirty: () => void);
5100
+ private readonly _watchTexture;
5101
+ constructor(_props: SheenProps, _markDirty: () => void, _watchTexture: (texture: BaseTexture | null) => void);
5089
5102
  get isEnabled(): boolean;
5090
5103
  set isEnabled(value: boolean);
5091
5104
  get intensity(): number;
@@ -5098,9 +5111,9 @@ export declare class PBRSheenConfiguration {
5098
5111
  get texture(): BaseTexture | null;
5099
5112
  set texture(value: BaseTexture | null);
5100
5113
  private _texture;
5114
+ private _textureAssigned;
5101
5115
  /** Enumerate the sheen texture slot for `Material.getActiveTextures`. */
5102
- getActiveTextures(): BaseTexture[];
5103
- }
5116
+ getActiveTextures(): BaseTexture[];
5104
5117
 
5105
5118
  /**
5106
5119
  * Babylon.js `PBRSpecularGlossinessMaterial` — the spec/gloss workflow is
@@ -5632,6 +5645,27 @@ export declare class PostProcess {
5632
5645
  constructor();
5633
5646
  }
5634
5647
 
5648
+ /** Babylon.js post-process pipeline shape consumed by the manager. */
5649
+ export declare interface PostProcessRenderPipeline {
5635
5650
  readonly isSupported: boolean;
5636
5651
  dispose(): void;
5652
+ }
5653
+
5654
+ /** Babylon.js-compatible post-process pipeline registry for native Lite-backed pipelines. */
5655
+ export declare class PostProcessRenderPipelineManager {
5656
+ private readonly _renderPipelines;
5657
+ private readonly _onNewPipelineAddedObservable;
5658
+ private readonly _onPipelineRemovedObservable;
5659
+ get onNewPipelineAddedObservable(): Observable<PostProcessRenderPipeline>;
5660
+ get onPipelineRemovedObservable(): Observable<PostProcessRenderPipeline>;
5661
+ get supportedPipelines(): PostProcessRenderPipeline[];
5662
+ addPipeline(renderPipeline: PostProcessRenderPipeline): void;
5663
+ removePipeline(renderPipelineName: string): void;
5664
+ attachCamerasToRenderPipeline(renderPipelineName: string, cameras: Camera[] | Camera, unique?: boolean): void;
5665
+ detachCamerasFromRenderPipeline(renderPipelineName: string, cameras: Camera[] | Camera): void;
5666
+ enableEffectInPipeline(renderPipelineName: string, renderEffectName: string, cameras: Camera[] | Camera): void;
5667
+ disableEffectInPipeline(renderPipelineName: string, renderEffectName: string, cameras: Camera[] | Camera): void;
5668
+ update(): void;
5637
5669
  dispose(): void;
5670
+ }
5671
+
5638
5672
  /**
5639
5673
  * Babylon.js-compatible power easing class.
5640
5674
  */
@@ -5750,6 +5784,11 @@ export declare class QuinticEase extends EasingFunction {
5750
5784
  */
5751
5785
  export declare function RandomGUID(): string;
5752
5786
 
5787
+ declare type Ratio = number | {
5788
+ ssaoRatio?: number;
5789
+ blurRatio?: number;
5790
+ };
5791
+
5753
5792
  /**
5754
5793
  * Babylon.js `RawTexture` — a texture created from raw pixel bytes. Backed by
5755
5794
  * Babylon Lite's `createTexture2DFromPixels`; the GPU handle is available
@@ -6118,11 +6157,13 @@ export declare class Scene extends AbstractScene {
6118
6157
  /** Babylon.js fog-mode c
6119
6158
  private readonly _retiredParticleSystems;
6120
6159
  private _disposed;
6121
6160
  private _ambientColor;
6122
6161
  private _environmentIntensity;
6123
- private _imageProcessingConfiguration;
6124
6162
  /** Babylon.js `scene.uniqueId` — a process-unique numeric id. */
6163
+ private _imageProcessingConfiguration;
6164
+ private _postProcessRenderPipelineManager;
6125
6165
  /** Babylon.js `scene.uniqueId` — a process-unique numeric id. */
6126
6166
  readonly uniqueId: number;
6127
6167
  constructor(engine: WebGPUEngine);
6128
6168
  private _attachPointerEvents;
6129
6169
  private _detachPointerEvents;
6130
6170
  getEngine(): WebGPUEngine;
6171
+ get postProcessRenderPipelineManager(): PostProcessRenderPipelineManager;
6131
6172
  /** Babylon.js `scene.getClassName()`. */
6132
6173
  getClassName(): string;
6133
6174
  /** Babylon.js `scene.getUniqueId()` — the process-unique scene id. */
@@ -6801,8 +6842,77 @@ export declare class SpriteRenderer {
6801
6842
  */
6802
6843
  render(sprites: readonly ThinSpriteLike[], _deltaTime?: number, _view?: unknown, _projection?: unknown): void;
6803
6844
 
6845
+ /** Babylon.js-shaped adapter over Babylon Lite's native scene SSAO pipeline. */
6804
6846
  export declare class SSAO2RenderingPipeline {
6805
- constructor();
6847
+ private static _uniqueIdSource;
6848
+ readonly SSAOOriginalSceneColorEffect = "SSAOOriginalSceneColorEffect";
6849
+ readonly SSAORenderEffect = "SSAORenderEffect";
6850
+ readonly SSAOBlurHRenderEffect = "SSAOBlurHRenderEffect";
6851
+ readonly SSAOBlurVRenderEffect = "SSAOBlurVRenderEffect";
6852
+ readonly SSAOCombineRenderEffect = "SSAOCombineRenderEffect";
6853
+ readonly isSupported: boolean;
6854
+ readonly uniqueId: number;
6806
6855
  private readonly _scene;
6856
+ private readonly _ratio;
6857
+ private readonly _forceGeometryBuffer;
6858
+ private readonly _textureType;
6859
+ private readonly _resolutionScale;
6860
+ private _native;
6861
+ private _camera;
6862
+ private _disposed;
6863
+ private _radius;
6864
+ private _totalStrength;
6865
+ private _base;
6866
+ private _maxZ;
6867
+ private _minZAspect;
6868
+ private _epsilon;
6869
+ private _samples;
6870
+ private _expensiveBlur;
6871
+ private _bypassBlur;
6872
+ private _bilateralSamples;
6873
+ private _bilateralSoften;
6874
+ private _bilateralTolerance;
6875
+ private _useViewportInCombineStage;
6876
+ private _textureSamples;
6877
+ private readonly _warned;
6878
+ readonly cameras: Camera[];
6879
+ constructor(name: string, scene: Scene, ratio: Ratio, cameras?: Camera[], forceGeometryBuffer?: boolean | object, textureType?: number);
6880
+ get radius(): number;
6881
+ set radius(value: number);
6882
+ get totalStrength(): number;
6883
+ set totalStrength(value: number);
6884
+ get base(): number;
6885
+ set base(value: number);
6886
+ get maxZ(): number;
6887
+ set maxZ(value: number);
6888
+ get minZAspect(): number;
6889
+ set minZAspect(value: number);
6890
+ get epsilon(): number;
6891
+ set epsilon(value: number);
6892
+ get samples(): number;
6893
+ set samples(value: number);
6894
+ get expensiveBlur(): boolean;
6895
+ get bypassBlur(): boolean;
6896
+ set bypassBlur(value: boolean);
6897
+ get bilateralSamples(): number;
6898
+ set bilateralSamples(value: number);
6899
+ get bilateralSoften(): number;
6900
+ set bilateralSoften(value: number);
6901
+ get bilateralTolerance(): number;
6902
+ set bilateralTolerance(value: number);
6903
+ get useViewportInCombineStage(): boolean;
6904
+ set useViewportInCombineStage(value: boolean);
6905
+ set expensiveBlur(value: boolean);
6906
+ get textureSamples(): number;
6907
+ set textureSamples(value: number);
6908
+ getClassName(): string;
6909
+ get name(): string;
6910
+ get engine(): AbstractEngine;
6911
+ get scene(): Scene;
6912
+ static get IsSupported(): boolean;
6913
+ static Parse(source: Record<string, unknown>, scene: Scene): SSAO2RenderingPipeline;
6914
+ isReady(): boolean;
6915
+ serialize(): Record<string, unknown>;
6807
6916
  dispose(_disableGeometryBufferRenderer?: boolean): void;
6917
+ private _warnUnsupported;
6808
6918
  }
6809
6919
 
6810
6920
  export declare class StandardMaterial extends PushMaterial {
6811
6921
  /** Diffuse colour as the app set it. Kept apart from `_lite.diffuseColor`, which is forced to white
@@ -6985,6 +7095,12 @@ export declare class StringDictionary<T> {
6985
7095
  forEach(callback: (key: string, value: T) => void): void;
6986
7096
  }
6987
7097
 
7098
+ /** Babylon.js `SubMesh`; pass-specific indirect drawing requires Lite renderer integration. */
7099
+ export declare class SubMesh {
7100
+ constructor(_materialIndex: number, _verticesStart: number, _verticesCount: number, _indexStart: number, _indexCount: number, _mesh: AbstractMesh, _renderingMesh?: Mesh, _createBoundingBox?: boolean, _addToMesh?: boolean);
7101
+ setIndirectDrawBuffer(_buffer: unknown | null, _byteOffset: number, _renderPassId: number): void;
7102
+ }
7103
+
6988
7104
  export declare class SurfaceMagnetismBehavior {
6989
7105
  constructor();
6990
7106
  }
@@ -7067,9 +7183,9 @@ export declare class Texture extends BaseTexture {
7067
7183
  hasAlpha: boolean;
7068
7184
  coordinatesIndex: number;
7069
7185
  /** Babylon.js sampling mode passed at construction (`NEAREST_SAMPLINGMODE` = 1, etc.). */
7070
- readonly samplingMode: number;
7071
7186
  constructor(url: string, sceneOrEngine: Scene | {
7187
+ samplingMode: number;
7072
7188
  constructor(url: string, sceneOrEngine: Scene | {
7073
7189
  _lite: EngineContext;
7074
- }, noMipmapOrOptions?: unknown, invertY?: boolean, _samplingMode?: number, onLoad?: (() => void) | null);
7075
7190
  private readonly _noMipmap;
7191
+ }, noMipmapOrOptions?: unknown, invertY?: boolean, _samplingMode?: number, onLoad?: (() => void) | null);
7076
7192
  private _noMipmap;
7077
7193
  getClassName(): string;
7078
7194
  /**
7079
7195
  * Babylon.js `texture.clone()` — a new `Texture` over the same source URL.
@@ -7077,6 +7193,12 @@ export declare class Texture extends BaseTexture {
7077
7193
  * handle (tracked against the same scene so it is ready at build).
7078
7194
  */
7079
7195
  clone(): Texture;
7196
+ /**
7197
+ * Babylon.js `Texture.replaceImage` — reuse another ready URL texture's Lite
7198
+ * handle without reloading it. Wrapper UV state remains local; loading state
7199
+ * follows the source so later clones resolve the same image.
7200
+ */
7201
+ replaceImage(source: Texture): boolean;
7080
7202
  whenReadyAsync(): Promise<void>;
7081
7203
  /** Babylon.js `Texture.onLoadObservable`, allocated only when code subscribes. */
7082
7204
  get onLoadObservable(): Observable<Texture>;
@@ -7326,7 +7448,7 @@ export declare class UniformBuffer {
7326
7448
  private _setInteger;
7327
7449
  }
7328
7450
 
7329
- /** Babylon.js `UninstallHtmlInCanvasPolyfill` — the HTML-in-canvas polyfill is unsupported by the compat layer. */
7451
+ /** Babylon.js `UninstallHtmlInCanvasPolyfill`; paired with the structurally blocked installer. */
7330
7452
  export declare function UninstallHtmlInCanvasPolyfill(): never;
7331
7453
 
7332
7454
  /** Babylon.js `UniversalCamera` — touch-friendly free camera. */