@needle-tools/engine 6.0.0-alpha.6 → 6.0.0-alpha.7

package/dist/needle-engine.d.ts

@@ -23,7 +23,9 @@ import { DepthOfFieldEffect } from 'postprocessing';
 import { DepthTexture } from 'three';
 import { deriveInstanceId as deriveStableId } from '@needle-tools/addressing';
 import { dimforgeRapier3dCompat } from '@dimforge/rapier3d-compat';
+import { DocumentDefContext } from '@needle-tools/addressing/document';
 import { DocumentedOptions } from '../../../node_modules/three-mesh-ui/build/types/core/elements/MeshUIBaseElement.js';
+import { DocumentExtensionProvider } from '@needle-tools/addressing/document';
 import { Effect } from 'postprocessing';
 import { EffectComposer } from 'postprocessing';
 import { EffectComposer as EffectComposer_2 } from 'three/examples/jsm/postprocessing/EffectComposer.js';
@@ -136,11 +138,9 @@ import { XRHandSpace } from 'three';
 
 export declare const $componentName: unique symbol;
 
-/* Excluded from this release type: $jVksoCHS */
-
 export declare const $physicsKey: unique symbol;
 
-/* Excluded from this release type: _$sHuA */
+/* Excluded from this release type: $TiDhB */
 
 export declare class __Ignore {
 }
@@ -149,6 +149,8 @@ export declare function __internalNotifyObjectDestroyed(obj: Object3D): void;
 
 /* Excluded from this release type: __internalStepGaussianSplatAdaptation */
 
+/* Excluded from this release type: __mor */
+
 /** Data describing the accessible semantics for a 3D object or component. */
 declare type AccessibilityData = {
     /** ARIA role (e.g. `"button"`, `"img"`, `"region"`). */
@@ -4703,6 +4705,8 @@ export declare class Context implements IContext {
     get lifecycle(): ContextLifecycleMode;
     set lifecycle(value: ContextLifecycleMode);
     private _lifecycle;
+    /** Completes queued loading/setup callbacks without rendering or stepping simulation. */
+    flushPendingSceneSetup(): void;
     /**
      * Called when switching from "held" back to "running": while held, hierarchy active
      * flags keep updating but activation callbacks are gated. Components that were never
@@ -6007,6 +6011,16 @@ export declare class DocumentExtension implements IUSDExporterExtension {
     onAfterBuildDocument(_context: any): void;
 }
 
+/** Creates extension readers bound to each document's Engine context. */
+export declare interface DocumentExtensionRegistration {
+    readonly version: number;
+    readonly migrations?: DocumentExtensionProvider['migrations'];
+    readonly valueCodecs?: DocumentExtensionProvider['valueCodecs'];
+    readonly components?: {
+        createReader(context: DocumentDefContext): NonNullable<DocumentExtensionProvider['components']>['apply'] | undefined;
+    };
+}
+
 /**
  * [DragControls](https://engine.needle.tools/docs/api/DragControls) enables interactive dragging of objects in 2D (screen space) or 3D (world space).
  *
@@ -10991,8 +11005,6 @@ declare type KF_2<V> = AnimationKeyframe<V>[] | Tween<V>;
 /** Keyframe array or tween shorthand */
 declare type KF_3<V> = AnimationKeyframe<V>[] | Tween<V>;
 
-/* Excluded from this release type: KLnyx */
-
 declare type LabelHandle = {
     setText(str: string): any;
 };
@@ -15960,6 +15972,8 @@ export declare class OrbitControls extends Component implements ICameraControlle
      }
 
      export declare class Physics {
+         /** Release the shared BVH worker pool after the last engine context is destroyed. */
+         static disposeMeshBVHWorkers(): void;
          private static _raycasting;
          /**
           * Returns true if raycasting is currently in progress
@@ -17895,6 +17909,11 @@ export declare class OrbitControls extends Component implements ICameraControlle
 
      export declare function registerCustomEffectType(name: string, effect: typeof PostProcessingEffect): void;
 
+     /** Register before loading documents. Disposing affects subsequent evaluations. */
+     export declare function registerDocumentExtensionProvider(id: string, provider: DocumentExtensionRegistration): {
+         dispose(): void;
+     };
+
      export declare class RegisteredAnimationInfo {
          private _start?;
          get start(): number;
@@ -26018,6 +26037,8 @@ export declare class OrbitControls extends Component implements ICameraControlle
          All = 4294967295
      }
 
+     /* Excluded from this release type: _yActo */
+
      export { }
 
 
@@ -26168,6 +26189,21 @@ declare module 'three' {
 }
 
 
+declare module 'three/examples/jsm/controls/OrbitControls.js' {
+    interface OrbitControls {
+        _sphericalDelta: import("three").Spherical;
+        _rotateLeft: (angleInRadians: number) => void;
+        _rotateUp: (angleInRadians: number) => void;
+        _pan: (dx: number, dy: number) => void;
+        _dollyIn: (dollyScale: number) => void;
+        _dollyOut: (dollyScale: number) => void;
+    }
+    interface OrbitControlsEventMap {
+        endMovement: Event;
+    }
+}
+
+
 declare module 'three' {
     interface SkinnedMesh {
         staticGenerator?: StaticGeometryGenerator;
@@ -26190,21 +26226,6 @@ declare module 'three' {
 }
 
 
-declare module 'three/examples/jsm/controls/OrbitControls.js' {
-    interface OrbitControls {
-        _sphericalDelta: import("three").Spherical;
-        _rotateLeft: (angleInRadians: number) => void;
-        _rotateUp: (angleInRadians: number) => void;
-        _pan: (dx: number, dy: number) => void;
-        _dollyIn: (dollyScale: number) => void;
-        _dollyOut: (dollyScale: number) => void;
-    }
-    interface OrbitControlsEventMap {
-        endMovement: Event;
-    }
-}
-
-
 declare module 'three' {
     interface Material {
         /** Unique ID for this material instance. Exists at runtime via Object.defineProperty. */