@babylonjs/inspector 9.1.0 → 9.2.0

package/lib/index.d.ts

@@ -46,6 +46,9 @@ export * from "./services/selectionService";
 export type { IShellService, ToolbarItemDefinition, SidePaneDefinition, CentralContentDefinition } from "./services/shellService";
 export { ShellServiceIdentity } from "./services/shellService";
 export * from "./inspector";
+export { StartInspectable, type InspectableToken, type InspectableOptions } from "./inspectable";
+export type { IInspectableCommandRegistry, InspectableCommandDescriptor, InspectableCommandArg } from "./services/cli/inspectableCommandRegistry";
+export { InspectableCommandRegistryIdentity } from "./services/cli/inspectableCommandRegistry";
 export { ConvertOptions, Inspector } from "./legacy/inspector";
 export { AttachDebugLayer, DetachDebugLayer } from "./legacy/debugLayer";
 export * from "@babylonjs/shared-ui-components/fluent/hooks/keyboardHooks.js";

package/lib/index.js

@@ -1,4 +1,4 @@
-export { A as Accordion, i as AccordionSection, l as AccordionSectionItem, m as AttachDebugLayer, n as BooleanBadgePropertyLine, o as BoundProperty, p as BuiltInsExtensionFeed, B as Button, j as ButtonLine, q as Checkbox, C as CheckboxPropertyLine, r as ChildWindow, s as Collapse, t as Color3GradientComponent, v as Color3GradientList, w as Color3PropertyLine, x as Color4GradientComponent, y as Color4GradientList, z as Color4PropertyLine, D as ColorPickerPopup, E as ColorStepGradientComponent, F as ComboBox, G as ComboBoxPropertyLine, H as ConstructorFactory, I as ConvertOptions, J as DebugServiceIdentity, K as DetachDebugLayer, O as DraggableLine, Q as Dropdown, R as EntitySelector, U as ErrorBoundary, W as ExtensibleAccordion, X as FactorGradientComponent, Y as FactorGradientList, Z as FileUploadLine, _ as GetPropertyDescriptor, $ as GizmoServiceIdentity, a0 as HexPropertyLine, a1 as InfoLabel, a2 as InputHexField, a3 as InputHsvField, a4 as Inspector, a5 as InterceptFunction, a6 as InterceptProperty, a7 as IsPropertyReadonly, a8 as LineContainer, L as Link, a9 as LinkPropertyLine, c as LinkToEntity, aa as LinkToEntityPropertyLine, ab as List, ac as MakeDialogTeachingMoment, ad as MakeLazyComponent, ae as MakePopoverTeachingMoment, af as MakePropertyHook, ag as MakeTeachingMoment, ah as MaterialSelector, M as MessageBar, ai as NodeSelector, aj as NumberDropdown, ak as NumberDropdownPropertyLine, N as NumberInputPropertyLine, al as ObservableCollection, am as Pane, an as PlaceholderPropertyLine, P as Popover, ao as PositionedPopover, ap as PropertiesServiceIdentity, aq as Property, ar as PropertyContext, as as PropertyLine, at as QuaternionPropertyLine, au as RotationVectorPropertyLine, f as SceneContextIdentity, av as SceneExplorerServiceIdentity, aw as SearchBar, ax as SearchBox, ay as SelectionServiceDefinition, g as SelectionServiceIdentity, az as SettingsServiceIdentity, aA as SettingsStoreIdentity, S as ShellServiceIdentity, aB as ShowInspector, aC as SidePaneContainer, aD as SkeletonSelector, aE as Slider, aF as SpinButton, d as SpinButtonPropertyLine, aG as StatsServiceIdentity, aH as StringDropdown, aI as StringDropdownPropertyLine, aJ as StringifiedPropertyLine, aK as Switch, aL as SwitchPropertyLine, aM as SyncedSliderInput, aN as SyncedSliderPropertyLine, aO as TeachingMoment, aP as TextAreaPropertyLine, aQ as TextInput, T as TextInputPropertyLine, aR as TextPropertyLine, aS as Textarea, aT as TextureSelector, aU as TextureUpload, aV as Theme, aW as ThemeServiceIdentity, aX as ToastProvider, aY as ToggleButton, k as ToolsServiceIdentity, aZ as Tooltip, a_ as UploadButton, a$ as Vector2PropertyLine, V as Vector3PropertyLine, b0 as Vector4PropertyLine, b1 as WatcherServiceIdentity, b2 as useAngleConverters, b3 as useAsyncResource, b4 as useColor3Property, b5 as useColor4Property, b6 as useEventListener, b7 as useEventfulState, b as useInterceptObservable, b8 as useKeyListener, b9 as useKeyState, ba as useObservableCollection, h as useObservableState, bb as useOrderedObservableCollection, bc as usePollingObservable, e as useProperty, bd as usePropertyChangedNotifier, be as useQuaternionProperty, bf as useResource, bg as useSetting, bh as useTheme, bi as useThemeMode, a as useToast, bj as useVector3Property } from './index-BCbXjPTn.js';
+export { A as Accordion, i as AccordionSection, l as AccordionSectionItem, m as AttachDebugLayer, n as BooleanBadgePropertyLine, o as BoundProperty, p as BuiltInsExtensionFeed, B as Button, j as ButtonLine, q as Checkbox, C as CheckboxPropertyLine, r as ChildWindow, s as Collapse, t as Color3GradientComponent, v as Color3GradientList, w as Color3PropertyLine, x as Color4GradientComponent, y as Color4GradientList, z as Color4PropertyLine, D as ColorPickerPopup, E as ColorStepGradientComponent, F as ComboBox, G as ComboBoxPropertyLine, H as ConstructorFactory, I as ConvertOptions, J as DebugServiceIdentity, K as DetachDebugLayer, O as DraggableLine, Q as Dropdown, R as EntitySelector, U as ErrorBoundary, W as ExtensibleAccordion, X as FactorGradientComponent, Y as FactorGradientList, Z as FileUploadLine, _ as GetPropertyDescriptor, $ as GizmoServiceIdentity, a0 as HexPropertyLine, a1 as InfoLabel, a2 as InputHexField, a3 as InputHsvField, a4 as InspectableCommandRegistryIdentity, a5 as Inspector, a6 as InterceptFunction, a7 as InterceptProperty, a8 as IsPropertyReadonly, a9 as LineContainer, L as Link, aa as LinkPropertyLine, c as LinkToEntity, ab as LinkToEntityPropertyLine, ac as List, ad as MakeDialogTeachingMoment, ae as MakeLazyComponent, af as MakePopoverTeachingMoment, ag as MakePropertyHook, ah as MakeTeachingMoment, ai as MaterialSelector, M as MessageBar, aj as NodeSelector, ak as NumberDropdown, al as NumberDropdownPropertyLine, N as NumberInputPropertyLine, am as ObservableCollection, an as Pane, ao as PlaceholderPropertyLine, P as Popover, ap as PositionedPopover, aq as PropertiesServiceIdentity, ar as Property, as as PropertyContext, at as PropertyLine, au as QuaternionPropertyLine, av as RotationVectorPropertyLine, f as SceneContextIdentity, aw as SceneExplorerServiceIdentity, ax as SearchBar, ay as SearchBox, az as SelectionServiceDefinition, g as SelectionServiceIdentity, aA as SettingsServiceIdentity, aB as SettingsStoreIdentity, S as ShellServiceIdentity, aC as ShowInspector, aD as SidePaneContainer, aE as SkeletonSelector, aF as Slider, aG as SpinButton, d as SpinButtonPropertyLine, aH as StartInspectable, aI as StatsServiceIdentity, aJ as StringDropdown, aK as StringDropdownPropertyLine, aL as StringifiedPropertyLine, aM as Switch, aN as SwitchPropertyLine, aO as SyncedSliderInput, aP as SyncedSliderPropertyLine, aQ as TeachingMoment, aR as TextAreaPropertyLine, aS as TextInput, T as TextInputPropertyLine, aT as TextPropertyLine, aU as Textarea, aV as TextureSelector, aW as TextureUpload, aX as Theme, aY as ThemeServiceIdentity, aZ as ToastProvider, a_ as ToggleButton, k as ToolsServiceIdentity, a$ as Tooltip, b0 as UploadButton, b1 as Vector2PropertyLine, V as Vector3PropertyLine, b2 as Vector4PropertyLine, b3 as WatcherServiceIdentity, b4 as useAngleConverters, b5 as useAsyncResource, b6 as useColor3Property, b7 as useColor4Property, b8 as useEventListener, b9 as useEventfulState, b as useInterceptObservable, ba as useKeyListener, bb as useKeyState, bc as useObservableCollection, h as useObservableState, bd as useOrderedObservableCollection, be as usePollingObservable, e as useProperty, bf as usePropertyChangedNotifier, bg as useQuaternionProperty, bh as useResource, bi as useSetting, bj as useTheme, bk as useThemeMode, a as useToast, bl as useVector3Property } from './index-FWuITINA.js';
 import 'react/jsx-runtime';
 import 'react';
 import '@fluentui/react-components';
@@ -46,6 +46,7 @@ import '@babylonjs/core/Lights/light.js';
 import '@babylonjs/core/Meshes/abstractMesh.js';
 import '@babylonjs/core/node.js';
 import 'react-dom/client';
+import '@babylonjs/core/Misc/screenshotTools.js';
 import '@babylonjs/core/Layers/selectionOutlineLayer.js';
 import '@babylonjs/core/Meshes/GaussianSplatting/gaussianSplattingMesh.js';
 import '@babylonjs/core/Animations/animationGroup.js';
@@ -139,7 +140,6 @@ import '@babylonjs/core/Sprites/spriteSceneComponent.js';
 import '@babylonjs/core/Materials/Textures/dynamicTexture.js';
 import '@babylonjs/core/Misc/equirectangularCapture.js';
 import '@babylonjs/core/Misc/sceneRecorder.js';
-import '@babylonjs/core/Misc/screenshotTools.js';
 import '@babylonjs/core/Misc/videoRecorder.js';
 import '@babylonjs/core/Misc/sceneSerializer.js';
 import '@babylonjs/core/Misc/environmentTextureTools.js';

package/lib/inspectable.d.ts

@@ -0,0 +1,67 @@
+import { type IDisposable } from "@babylonjs/core/index.js";
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type WeaklyTypedServiceDefinition, ServiceContainer } from "./modularity/serviceContainer";
+/**
+ * Options for making a scene inspectable via the Inspector CLI.
+ */
+export type InspectableOptions = {
+    /**
+     * WebSocket port for the bridge's browser port. Defaults to 4400.
+     */
+    port?: number;
+    /**
+     * Session display name reported to the bridge. Defaults to `document.title`.
+     */
+    name?: string;
+    /**
+     * Additional service definitions to register with the inspectable container.
+     * These are added in a separate call from the built-in services and are removed
+     * when the returned token is disposed.
+     */
+    serviceDefinitions?: readonly WeaklyTypedServiceDefinition[];
+};
+/**
+ * A token returned by {@link StartInspectable} that can be disposed to disconnect
+ * the scene from the Inspector CLI bridge.
+ */
+export type InspectableToken = IDisposable & {
+    /**
+     * Whether this token has been disposed.
+     */
+    readonly isDisposed: boolean;
+};
+/**
+ * @internal
+ * An internal token that also exposes the underlying ServiceContainer,
+ * allowing ShowInspector to use it as a parent container.
+ */
+export type InternalInspectableToken = InspectableToken & {
+    /**
+     * The ServiceContainer backing this inspectable session.
+     */
+    readonly serviceContainer: ServiceContainer;
+};
+/**
+ * @internal
+ * Internal implementation that returns an {@link InternalInspectableToken} with access
+ * to the underlying ServiceContainer. Used by ShowInspector to set up a parent container relationship.
+ */
+export declare function _StartInspectable(scene: Scene, options?: Partial<InspectableOptions>): InternalInspectableToken;
+/**
+ * Makes a scene inspectable by connecting it to the Inspector CLI bridge.
+ * This creates a headless {@link ServiceContainer} (no UI) and registers the
+ * {@link InspectableBridgeService} which opens a WebSocket to the bridge and
+ * exposes a command registry for CLI-invocable commands.
+ *
+ * Multiple callers may call this for the same scene. Each returned token is
+ * ref-counted — the underlying connection is only torn down when all tokens
+ * have been disposed. Additional {@link InspectableOptions.serviceDefinitions}
+ * passed by each caller are added to the shared container and removed when
+ * that caller's token is disposed.
+ *
+ * @param scene The scene to make inspectable.
+ * @param options Optional configuration.
+ * @returns An {@link InspectableToken} that can be disposed to disconnect.
+ * @experimental
+ */
+export declare function StartInspectable(scene: Scene, options?: Partial<InspectableOptions>): InspectableToken;

package/lib/misc/defaultPerfStrategies.d.ts

@@ -0,0 +1,16 @@
+import { type PerformanceViewerCollector } from "@babylonjs/core/Misc/PerformanceViewer/performanceViewerCollector.js";
+/**
+ * The strategy parameter type accepted by {@link PerformanceViewerCollector.addCollectionStrategies}.
+ */
+export type PerfStrategyParameter = Parameters<PerformanceViewerCollector["addCollectionStrategies"]>[number];
+/**
+ * Performance metadata categories for grouping strategies.
+ */
+export declare const enum PerfMetadataCategory {
+    Count = "Count",
+    FrameSteps = "Frame Steps Duration"
+}
+/**
+ * Default list of performance collection strategies used by the performance viewer and CLI perf trace.
+ */
+export declare const DefaultPerfStrategies: readonly PerfStrategyParameter[];

package/lib/modularTool.d.ts

@@ -1,6 +1,6 @@
 import { type IDisposable } from "@babylonjs/core/index.js";
 import { type IExtensionFeed } from "./extensibility/extensionFeed";
-import { type WeaklyTypedServiceDefinition } from "./modularity/serviceContainer";
+import { type WeaklyTypedServiceDefinition, ServiceContainer } from "./modularity/serviceContainer";
 import { type ShellServiceOptions } from "./services/shellService";
 import { type ThemeMode } from "./services/themeService";
 export type ModularToolOptions = {
@@ -28,6 +28,11 @@ export type ModularToolOptions = {
      * The extension feeds that provide optional extensions the user can install.
      */
     extensionFeeds?: readonly IExtensionFeed[];
+    /**
+     * An optional parent ServiceContainer. Dependencies not found in the tool's own container
+     * will be resolved from this parent.
+     */
+    parentContainer?: ServiceContainer;
 } & ShellServiceOptions;
 /**
  * Creates a modular tool with a base set of common tool services, including the toolbar/side pane basic UI layout.

package/lib/modularity/serviceContainer.d.ts

@@ -13,11 +13,18 @@ export type WeaklyTypedServiceDefinition = Omit<ServiceDefinition<IService<symbo
  */
 export declare class ServiceContainer implements IDisposable {
     private readonly _friendlyName;
+    private readonly _parent?;
     private _isDisposed;
     private readonly _serviceDefinitions;
     private readonly _serviceDependents;
     private readonly _serviceInstances;
-    constructor(_friendlyName: string);
+    private readonly _children;
+    /**
+     * Creates a new ServiceContainer.
+     * @param _friendlyName A human-readable name for debugging.
+     * @param _parent An optional parent container. Dependencies not found locally will be resolved from the parent.
+     */
+    constructor(_friendlyName: string, _parent?: ServiceContainer | undefined);
     /**
      * Adds a set of service definitions in the service container.
      * The services are sorted based on their dependencies.
@@ -33,9 +40,25 @@ export declare class ServiceContainer implements IDisposable {
      */
     addServiceAsync<Produces extends IService<symbol>[] = [], Consumes extends IService<symbol>[] = []>(serviceDefinition: ServiceDefinition<Produces, Consumes>, abortSignal?: AbortSignal): Promise<IDisposable>;
     private _addServiceAsync;
+    /**
+     * Resolves a dependency by contract identity for a consuming service.
+     * Checks local services first, then walks up the parent chain.
+     * Registers the consumer as a dependent in whichever container owns the dependency.
+     * @param contract The contract identity to resolve.
+     * @param consumer The service definition that consumes this dependency.
+     * @returns The resolved service instance.
+     */
+    private _resolveDependency;
+    /**
+     * Removes a consumer from the dependent set for a given contract, checking locally first then the parent chain.
+     * @param contract The contract identity.
+     * @param consumer The service definition to remove as a dependent.
+     */
+    private _removeDependentFromChain;
     private _removeService;
     /**
      * Disposes the service container and all contained services.
+     * Throws if this container is still a parent of any live child containers.
      */
     dispose(): void;
 }

package/lib/{quickCreateToolsService-BoqrJqoM.js → quickCreateToolsService-MzZbVrvr.js}

@@ -1,5 +1,5 @@
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { P as Popover, a as useToast, b as useInterceptObservable, B as Button, c as LinkToEntity, T as TextInputPropertyLine, d as SpinButtonPropertyLine, C as CheckboxPropertyLine, V as Vector3PropertyLine, e as useProperty, M as MessageBar, S as ShellServiceIdentity, f as SceneContextIdentity, g as SelectionServiceIdentity, h as useObservableState, A as Accordion, i as AccordionSection } from './index-BCbXjPTn.js';
+import { P as Popover, a as useToast, b as useInterceptObservable, B as Button, c as LinkToEntity, T as TextInputPropertyLine, d as SpinButtonPropertyLine, C as CheckboxPropertyLine, V as Vector3PropertyLine, e as useProperty, M as MessageBar, S as ShellServiceIdentity, f as SceneContextIdentity, g as SelectionServiceIdentity, h as useObservableState, A as Accordion, i as AccordionSection } from './index-FWuITINA.js';
 import { SettingsRegular, CollectionsAdd20Regular } from '@fluentui/react-icons';
 import '@babylonjs/core/Particles/webgl2ParticleSystem.js';
 import '@babylonjs/core/Rendering/prePassRendererSceneComponent.js';
@@ -74,6 +74,7 @@ import '@babylonjs/core/Lights/light.js';
 import '@babylonjs/core/Meshes/abstractMesh.js';
 import '@babylonjs/core/node.js';
 import 'react-dom/client';
+import '@babylonjs/core/Misc/screenshotTools.js';
 import '@babylonjs/core/Layers/selectionOutlineLayer.js';
 import '@babylonjs/core/Meshes/GaussianSplatting/gaussianSplattingMesh.js';
 import '@babylonjs/core/Animations/animationGroup.js';
@@ -149,7 +150,6 @@ import '@babylonjs/core/Sprites/spriteSceneComponent.js';
 import '@babylonjs/core/Materials/Textures/dynamicTexture.js';
 import '@babylonjs/core/Misc/equirectangularCapture.js';
 import '@babylonjs/core/Misc/sceneRecorder.js';
-import '@babylonjs/core/Misc/screenshotTools.js';
 import '@babylonjs/core/Misc/videoRecorder.js';
 import '@babylonjs/core/Misc/sceneSerializer.js';
 import '@babylonjs/core/Misc/environmentTextureTools.js';
@@ -772,4 +772,4 @@ var quickCreateToolsService = {
 };
 
 export { CreateToolsServiceDefinition, quickCreateToolsService as default };
-//# sourceMappingURL=quickCreateToolsService-BoqrJqoM.js.map
+//# sourceMappingURL=quickCreateToolsService-MzZbVrvr.js.map