@babylonjs-toolkit/next 9.0.1 → 9.5.0

package/README.md

@@ -1,15 +1,10 @@
 # ESNext Edition
 The <a href="https://www.babylontoolkit.com">Babylon Toolkit</a> is a runtime library extension for BabylonJS development that provides modern programming mechanics with a familiar Unity like scripting model to fast track native web game development.
 
-<a href="https://www.npmjs.com/package/babylonjs-toolkit">Classic Edition (UMD)</a>
-<br/>
-<a href="https://github.com/BabylonJS/BabylonToolkit/tree/master/Runtime">Browser Library (CDN)</a>
-<br/>
 <a href="https://github.com/MackeyK24/ES6-StarterAssets">Demo React Project (TSX)</a>
 <br/>
 <a href="https://github.com/MackeyK24/NJS-StarterAssets">Next.js React Project (TSX)</a>
 
-
 ## Basic Installation
 ```bash
 npm install @babylonjs-toolkit/next

package/lib/index.d.ts

@@ -25,8 +25,6 @@ export * from './noisefunction2d';
 export * from './noisefunction3d';
 export * from './noisefunction4d';
 export * from './simplexnoise';
-export * from './universalterrainmaterial';
-export * from './treebranchmaterial';
 export * from './mousebuttonmode';
 export * from './touchmousebutton';
 export * from './touchjoystickhandler';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/lib/index.js

@@ -25,8 +25,6 @@ export * from './noisefunction2d';
 export * from './noisefunction3d';
 export * from './noisefunction4d';
 export * from './simplexnoise';
-export * from './universalterrainmaterial';
-export * from './treebranchmaterial';
 export * from './mousebuttonmode';
 export * from './touchmousebutton';
 export * from './touchjoystickhandler';

package/lib/scenemanager.d.ts

@@ -34,7 +34,7 @@ import { Sound } from '@babylonjs/core/Audio/sound';
 import { Skeleton } from '@babylonjs/core/Bones/skeleton';
 import { Control } from '@babylonjs/gui/2D/controls/control';
 import { Effect } from '@babylonjs/core/Materials/effect';
-import { PhysicsBody, IPhysicsEnabledObject, PhysicsShape, PhysicsShapeCapsule, PhysicsRaycastResult, PhysicsMotionType, IRaycastQuery, ShapeCastResult, PhysicsShapeSphere, PhysicsShapeMesh, PhysicsShapeConvexHull, PhysicsShapeBox, PhysicsShapeCylinder } from '@babylonjs/core/Physics';
+import { PhysicsBody, IPhysicsEnabledObject, PhysicsShape, PhysicsShapeCapsule, PhysicsRaycastResult, PhysicsMotionType, IRaycastQuery, ShapeCastResult, PhysicsShapeMesh, PhysicsShapeConvexHull, PhysicsShapeBox, PhysicsShapeSphere, PhysicsShapeCylinder } from '@babylonjs/core/Physics';
 import { HavokPlugin } from '@babylonjs/core/Physics/v2/Plugins/havokPlugin';
 import { GLTFLoader } from '@babylonjs/loaders/glTF/2.0/glTFLoader';
 import { IScene, INode, IMaterial, IAnimation, IMesh } from '@babylonjs/loaders/glTF/2.0/glTFLoaderInterfaces';
@@ -121,8 +121,18 @@ export declare class SceneManager {
     static get EventBus(): GlobalMessageBus;
     static get PlaygroundCdn(): string;
     static get PlaygroundRepo(): string;
-    static InitializePlayground(engine: Engine | WebGPUEngine | AbstractEngine, options?: IRuntimeOptions): Promise<void>;
-    static InitializeRuntime(engine: Engine | WebGPUEngine | AbstractEngine, options?: IRuntimeOptions): Promise<void>;
+    static InitializePlayground(engine: Engine | WebGPUEngine | AbstractEngine, options?: IRuntimeOptions, scene?: Scene, inputOptions?: {
+        contextMenu?: boolean;
+        pointerLock?: boolean;
+        preventDefault?: boolean;
+        useCapture?: boolean;
+    }): Promise<void>;
+    static InitializeRuntime(engine: Engine | WebGPUEngine | AbstractEngine, options?: IRuntimeOptions, scene?: Scene, inputOptions?: {
+        contextMenu?: boolean;
+        pointerLock?: boolean;
+        preventDefault?: boolean;
+        useCapture?: boolean;
+    }): Promise<void>;
     static InitializeSceneLoaderPlugin(): void;
     static LoadRuntimeAssets(assetsManager: AssetsManager, requiredFilenames: string[], readyHandler: () => void, maxTimeout?: number, debugMode?: boolean): Promise<void>;
     static ShowLoadingScreen(engine: Engine | WebGPUEngine | AbstractEngine, hideLoadingUIWithEngine?: boolean, defaultLoadingUIMarginTop?: string): void;
@@ -134,9 +144,6 @@ export declare class SceneManager {
     private static SceneLoaderPropertyBag;
     private static SceneLoaderHandledFlag;
     static SetOnSceneReadyHandler(filenames: string[], handler: () => void, timeout?: number, debug?: boolean): void;
-    static NavigateTo(scene: Scene, route: string, options?: any, useWindowLocation?: boolean): void;
-    static SetReactNavigationHook(scene: Scene, navigateToFunction: any): void;
-    static DeleteReactNavigationHook(scene: Scene): void;
     private static SceneParsingEnabled;
     static EnableSceneParsing(enabled: boolean): void;
     static IsSceneParsingEnabled(): boolean;
@@ -434,6 +441,9 @@ export declare abstract class ScriptComponent {
     private static ParseAutoProperties;
     private static UnpackObjectProperty;
 }
+export declare abstract class GameModeController extends ScriptComponent {
+    constructor(transform: TransformNode, scene: Scene, properties?: any, alias?: string);
+}
 export declare enum System {
     Deg2Rad,
     Rad2Deg,
@@ -620,6 +630,7 @@ export declare class UserInputOptions {
     static EnableBabylonRotation: boolean;
 }
 export interface IRuntimeOptions {
+    enableUserInput?: boolean;
     hardwareScalingLevel?: number;
     initSceneFileLoaders?: boolean;
     loadAsyncRuntimeLibs?: boolean;
@@ -1287,6 +1298,45 @@ export declare class Utilities {
     static DeepCopyProperties(source: any, destination: any, doNotCopyList?: string[], mustCopyList?: string[]): void;
     static ValidateTransformMetadata(transform: TransformNode): void;
 }
+export declare class UniversalTerrainMaterial extends CustomShaderMaterial {
+    protected terrainInfo: any;
+    constructor(name: string, scene: Scene);
+    awake(): void;
+    update(): void;
+    getShaderName(): string;
+    getTerrainInfo(): any;
+}
+export declare class UniversalTerrainMaterialPlugin extends CustomShaderMaterialPlugin {
+    private colorName;
+    private splatmapSampler;
+    private detailsSampler;
+    private normalsSampler;
+    private GLSL_CustomFragment;
+    private GLSL_CustomVertex;
+    private GLSL_VertexMainEnd;
+    private GLSL_FragmentUpdateColor;
+    private WGSL_CustomFragment;
+    private WGSL_CustomVertex;
+    private WGSL_VertexMainEnd;
+    private WGSL_FragmentUpdateColor;
+    constructor(customMaterial: CustomShaderMaterial, shaderName: string);
+    isCompatible(shaderLanguage: ShaderLanguage): boolean;
+    getClassName(): string;
+    getCustomCode(shaderType: string, shaderLanguage: ShaderLanguage): any;
+    getUniforms(shaderLanguage: ShaderLanguage): any;
+    getSamplers(samplers: string[]): void;
+    getAttributes(attributes: string[], scene: Scene, mesh: AbstractMesh): void;
+    prepareDefines(defines: MaterialDefines, scene: Scene, mesh: AbstractMesh): void;
+    bindForSubMesh(uniformBuffer: UniformBuffer, scene: Scene, engine: AbstractEngine, subMesh: SubMesh): void;
+    private WGSL_FormatTerrainVertexDefintions;
+    private WGSL_FormatTerrainVertexMainEnd;
+    private WGSL_FormatTerrainFragmentDefintions;
+    private WGSL_FormatTerrainFragmentUpdateColor;
+    private GLSL_FormatTerrainVertexDefintions;
+    private GLSL_FormatTerrainVertexMainEnd;
+    private GLSL_FormatTerrainFragmentDefintions;
+    private GLSL_FormatTerrainFragmentUpdateColor;
+}
 export declare class GrassStandardMaterial extends StandardShaderMaterial {
     private _windTimeAccum;
     private _lastUpdateFrame;
@@ -1371,6 +1421,26 @@ export declare class GrassBillboardMaterialPlugin extends StandardShaderMaterial
     prepareDefines(defines: MaterialDefines, scene: Scene, mesh: AbstractMesh): void;
     bindForSubMesh(uniformBuffer: UniformBuffer, scene: Scene, engine: AbstractEngine, subMesh: SubMesh): void;
 }
+export declare class TreeBranchMaterial extends CustomShaderMaterial {
+    private _windTimeAccum;
+    constructor(name: string, scene: Scene);
+    awake(): void;
+    update(): void;
+    getShaderName(): string;
+    setWindDirection(x: number, y: number, z: number): void;
+    getWindDirection(): Vector4;
+}
+export declare class TreeBranchMaterialPlugin extends CustomShaderMaterialPlugin {
+    constructor(customMaterial: CustomShaderMaterial, shaderName: string);
+    isCompatible(shaderLanguage: ShaderLanguage): boolean;
+    getCustomCode(shaderType: string, shaderLanguage: ShaderLanguage): any;
+    getUniforms(shaderLanguage: ShaderLanguage): any;
+    getSamplers(samplers: string[]): void;
+    getAttributes(attributes: string[], scene: Scene, mesh: AbstractMesh): void;
+    prepareDefines(defines: MaterialDefines, scene: Scene, mesh: AbstractMesh): void;
+    bindForSubMesh(uniformBuffer: UniformBuffer, scene: Scene, engine: AbstractEngine, subMesh: SubMesh): void;
+    static ExtractWindZoneOverride(properties: any, terrainTransform: TransformNode, builderInstance?: any): any | null;
+}
 export declare class VertexAnimationMaterial extends CustomShaderMaterial {
     controller: VertexAnimationController;
     runtimeAlbedoSkins: BaseTexture;
@@ -2757,44 +2827,6 @@ export declare class btRaycastVehicle {
     isArcadeHandBrakeActive: boolean;
     isArcadeWheelSkidActive: boolean;
     isArcadeYawAssistActive: boolean;
-    arcadeYawAssistDebugLogEnabled: boolean;
-    arcadeYawAssistDebugLogIntervalFrames: number;
-    arcadeYawAssistDebugLogEdgeEvents: boolean;
-    arcadeHandbrakeKickStrengthDegPerSec: number;
-    arcadeHandbrakeKickFrames: number;
-    arcadeHandbrakeYawAuthority: number;
-    arcadeHandbrakeMaxYawRateDegPerSec: number;
-    arcadeHandbrakeReferenceSpeedKmh: number;
-    arcadeHandbrakeSpeedGateEnabled: boolean;
-    arcadeHandbrakeLowSpeedShape: number;
-    arcadeHandbrakeDirectYawEnabled: boolean;
-    arcadeHandbrakeDirectYawDegPerSec: number;
-    arcadeHandbrakeDirectYawDurationMs: number;
-    arcadeHandbrakeDirectYawFadeMs: number;
-    arcadeDonutDirectYawEnabled: boolean;
-    arcadeDonutDirectYawDegPerSec: number;
-    arcadeDonutDirectYawDurationMs: number;
-    arcadeDonutDirectYawFadeMs: number;
-    arcadeHandbrakeMaxSlideAngleDeg: number;
-    arcadeHandbrakeCounterSteerClampEnabled: boolean;
-    arcadeHandbrakeCounterSteerYawThresholdDegPerSec: number;
-    arcadeHandbrakeClampReleaseFadeMs: number;
-    arcadeHandbrakeSteerSlewLimitEnabled: boolean;
-    arcadeHandbrakeSteerSlewLimitDegPerSec: number;
-    private _wasArcadeHandBrakeActive;
-    private _wasArcadeYawAssistApplyingForce;
-    private _handbrakeKickJzRemaining;
-    private _handbrakeKickFramesRemaining;
-    private _arcadeHandbrakeLatchedDriveSign;
-    private _arcadeHandbrakeHoldElapsedSec;
-    private _arcadeHandbrakeSlewedSteerRad;
-    private _arcadeHandbrakeClampReleaseFadeSec;
-    private _arcadeDonutHoldElapsedSec;
-    private _arcadeYawAssistDebugFrameCounter;
-    private _arcadeYawAssistLastKickRad;
-    private _arcadeYawAssistLastIaddPerWheel;
-    private _arcadeYawAssistLastClampScalar;
-    private _arcadeYawAssistLastLeverSum;
     burnoutFrictionFloor: number;
     frictionRestoreSpeed: number;
     arcadeBurnoutWheelSpinGain: number;
@@ -2807,16 +2839,20 @@ export declare class btRaycastVehicle {
     arcadeWheelSpinMaxAngularVelocity: number;
     arcadeStationaryBurnoutWheelSpinGain: number;
     arcadeStationaryBurnoutMinAngularVelocity: number;
+    arcadeHandbrakeYawCapMultiplier: number;
+    arcadeBurnoutYawCapMultiplier: number;
+    arcadeDonutYawCapMultiplier: number;
     arcadeSkidFadeInSpeed: number;
     arcadeSkidFadeOutSpeed: number;
-    arcadeYawCapMultiplier: number;
     wheelAtRestSpeedThresholdKmh: number;
-    wheelSpinDebugLogEnabled: boolean;
-    wheelSpinDebugLogIntervalFrames: number;
-    private _wheelSpinDebugLogCounter;
-    private _postHandbrakeLogFrames;
-    private _postHandbrakeLogCounter;
-    private _wasAnyArcadeModeActive;
+    arcadeHandbrakeAssistEnabled: boolean;
+    currentSteeringInput: number;
+    arcadeDonutDirectYawEnabled: boolean;
+    arcadeDonutDirectYawDegPerSec: number;
+    arcadeDonutDirectYawDurationMs: number;
+    arcadeDonutDirectYawFadeMs: number;
+    private _arcadeDonutHoldElapsedSec;
+    private _arcadeDonutDirectionSign;
     private _forwardWS;
     private _axle;
     private _forwardImpulse;
@@ -2824,6 +2860,11 @@ export declare class btRaycastVehicle {
     private _arcadeSkidInfo;
     private _arcadePreviousWheelSpin;
     sideFrictionStiffness: number;
+    arcadeSideSlipSaturationEnabled: boolean;
+    arcadeSideSlipPeakDeg: number;
+    arcadeSideSlipFalloffDeg: number;
+    arcadeSideSlipFalloffFactor: number;
+    arcadeSideSlipMinSpeedMps: number;
     private _chassisMass;
     private _chassisInvMass;
     private _chassisTransform;
@@ -2898,6 +2939,8 @@ export declare class btRaycastVehicle {
     private applyTrackConnectionAndDownforce;
     updateVehicle(step: number): void;
     private updateSuspension;
+    private getSteeringAuthorityInput;
+    private getSteeringMagnitude;
     private applyEasyDonutYawAssist;
     private applyHandbrakeYawAssist;
     private resolveWheelSpinDirection;
@@ -3208,20 +3251,16 @@ export declare class RaycastVehicle {
     isArcadeYawAssistActive(): boolean;
     getArcadeSteeringAssist(): number;
     setArcadeSteeringAssist(value: number): void;
+    getArcadeDonutDirectYawEnabled(): boolean;
+    setArcadeDonutDirectYawEnabled(value: boolean): void;
     getArcadeDonutDirectYawDegPerSec(): number;
     setArcadeDonutDirectYawDegPerSec(value: number): void;
-    getArcadeHandbrakeDirectYawDegPerSec(): number;
-    setArcadeHandbrakeDirectYawDegPerSec(value: number): void;
-    getArcadeHandbrakeMaxSlideAngleDeg(): number;
-    setArcadeHandbrakeMaxSlideAngleDeg(value: number): void;
-    getArcadeHandbrakeBicycleYawAuthority(): number;
-    setArcadeHandbrakeBicycleYawAuthority(value: number): void;
-    getArcadeHandbrakeMaxYawRateDegPerSec(): number;
-    setArcadeHandbrakeMaxYawRateDegPerSec(value: number): void;
-    getArcadeHandbrakeReferenceSpeedKmh(): number;
-    setArcadeHandbrakeReferenceSpeedKmh(value: number): void;
-    getArcadeHandbrakeKickStrengthDegPerSec(): number;
-    setArcadeHandbrakeKickStrengthDegPerSec(value: number): void;
+    getArcadeHandbrakeYawCapMultiplier(): number;
+    setArcadeHandbrakeYawCapMultiplier(value: number): void;
+    getArcadeBurnoutYawCapMultiplier(): number;
+    setArcadeBurnoutYawCapMultiplier(value: number): void;
+    getArcadeDonutYawCapMultiplier(): number;
+    setArcadeDonutYawCapMultiplier(value: number): void;
     getArcadeBurnoutActive(): boolean;
     setArcadeBurnoutActive(active: boolean): void;
     getArcadeDonutActive(): boolean;
@@ -3243,9 +3282,6 @@ export declare class RaycastVehicle {
     getNaturalWheelSlip(wheelIndex: number): boolean;
     getWheelAtRestSpeedThresholdKmh(): number;
     setWheelAtRestSpeedThresholdKmh(value: number): void;
-    setWheelSpinDebugLogEnabled(enabled: boolean): void;
-    getWheelSpinDebugLogEnabled(): boolean;
-    setWheelSpinDebugLogIntervalFrames(frames: number): void;
     updateWheelInformation(): void;
     protected lockedWheelInformation(wheel: number): boolean;
     protected deleteWheelInformation(): void;