@babylonjs/inspector 8.56.2 → 9.1.0

package/lib/components/tools/exportTools.d.ts

@@ -0,0 +1,11 @@
+import { type FunctionComponent } from "react";
+import { type Scene } from "@babylonjs/core/scene.js";
+export declare const ExportBabylonTools: FunctionComponent<{
+    scene: Scene;
+}>;
+export declare const ExportGltfTools: import("react").ForwardRefExoticComponent<{
+    scene: Scene;
+} & {
+    spinnerSize?: import("@fluentui/react-spinner").SpinnerProps["size"];
+    spinnerLabel?: string;
+} & import("react").RefAttributes<never>>;

package/lib/components/tools/import/gltfAnimationImportTool.d.ts

@@ -0,0 +1,5 @@
+import { type FunctionComponent } from "react";
+import { type Scene } from "@babylonjs/core/scene.js";
+export declare const GLTFAnimationImportTool: FunctionComponent<{
+    scene: Scene;
+}>;

package/lib/components/tools/import/gltfLoaderOptionsTool.d.ts

@@ -0,0 +1,8 @@
+import { type FunctionComponent } from "react";
+import { type GLTFExtensionOptionsType, type GLTFLoaderOptionsType } from "../../../services/panes/tools/import/gltfLoaderOptionsDefaults";
+export declare const GLTFLoaderOptionsTool: FunctionComponent<{
+    loaderOptions: GLTFLoaderOptionsType;
+}>;
+export declare const GLTFExtensionOptionsTool: FunctionComponent<{
+    extensionOptions: GLTFExtensionOptionsType;
+}>;

package/lib/components/tools/import/gltfValidationTool.d.ts

@@ -0,0 +1,5 @@
+import { type FunctionComponent } from "react";
+import { type IGLTFValidationResults } from "babylonjs-gltf2interface";
+export declare const GLTFValidationTool: FunctionComponent<{
+    validationResults: IGLTFValidationResults;
+}>;

package/lib/components/tools/reflectorTools.d.ts

@@ -0,0 +1,5 @@
+import { type FunctionComponent } from "react";
+import { type Scene } from "@babylonjs/core/scene.js";
+export declare const ReflectorTools: FunctionComponent<{
+    scene: Scene;
+}>;

package/lib/components/tools/toolsPane.d.ts

@@ -0,0 +1,3 @@
+import { ExtensibleAccordion } from "../extensibleAccordion";
+import { type Scene } from "@babylonjs/core/scene.js";
+export declare const ToolsPane: typeof ExtensibleAccordion<Scene>;

package/lib/components/uxContextProvider.d.ts

@@ -0,0 +1,2 @@
+import { type FunctionComponent, type PropsWithChildren } from "react";
+export declare const UXContextProvider: FunctionComponent<PropsWithChildren>;

package/lib/contexts/extensionManagerContext.d.ts

@@ -0,0 +1,6 @@
+import { type ExtensionManager } from "../extensibility/extensionManager";
+export type ExtensionManagerContext = {
+    readonly extensionManager: ExtensionManager;
+};
+export declare const ExtensionManagerContext: import("react").Context<ExtensionManagerContext | undefined>;
+export declare function useExtensionManager(): ExtensionManager | undefined;

package/lib/contexts/propertyContext.d.ts

@@ -0,0 +1,30 @@
+import { type Observable } from "@babylonjs/core/index.js";
+/**
+ * Describes a property change event, including the entity, the property key, and the old and new values.
+ */
+export type PropertyChangeInfo = {
+    /** The entity whose property was changed. */
+    readonly entity: unknown;
+    /** The key of the property that was changed. */
+    readonly propertyKey: PropertyKey;
+    /** The value of the property before the change. */
+    readonly oldValue: unknown;
+    /** The value of the property after the change. */
+    readonly newValue: unknown;
+};
+/**
+ * Context that provides an observable for property change notifications within the inspector.
+ */
+export type PropertyContext = {
+    /** An observable that fires whenever a property is changed through the inspector UI. */
+    readonly onPropertyChanged: Observable<PropertyChangeInfo>;
+};
+/**
+ * React context for accessing the property change observable.
+ */
+export declare const PropertyContext: import("react").Context<PropertyContext | undefined>;
+/**
+ * Hook that returns a callback to notify the property context when a property has been changed.
+ * @returns A function that accepts (entity, propertyKey, oldValue, newValue) and notifies observers.
+ */
+export declare function usePropertyChangedNotifier(): <ObjectT, PropertyT extends keyof ObjectT>(entity: ObjectT, propertyKey: PropertyT, oldValue: ObjectT[PropertyT], newValue: ObjectT[PropertyT]) => void;

package/lib/contexts/settingsContext.d.ts

@@ -0,0 +1,3 @@
+import { type ISettingsStore } from "../services/settingsStore";
+export declare const SettingsStoreContext: import("react").Context<ISettingsStore | undefined>;
+export declare function useSettingsStore(): ISettingsStore | undefined;

package/lib/contexts/watcherContext.d.ts

@@ -0,0 +1,3 @@
+import { type IWatcherService } from "../services/watcherService";
+export declare const WatcherContext: import("react").Context<IWatcherService>;
+export declare function useWatcher(): IWatcherService;

package/lib/extensibility/builtInsExtensionFeed.d.ts

@@ -0,0 +1,21 @@
+import { type IExtensionFeed, type ExtensionMetadata, type IExtensionMetadataQuery, type ExtensionModule } from "./extensionFeed";
+export type BuiltInExtension = ExtensionMetadata & {
+    /**
+     * Gets the extension module, typically dynamically importing the extension.
+     * @returns The extension module (e.g. a collection of ServiceDefinitions).
+     */
+    getExtensionModuleAsync(): Promise<ExtensionModule>;
+};
+/**
+ * A simple extension feed implementation that provides a fixed set of "built in" extensions.
+ * "Built in" in this context means extensions that are known at bundling time, and included
+ * in the bundle. Each extension can be dynamically imported so they are split into separate
+ * bundle chunks and downloaded only when first installed.
+ */
+export declare class BuiltInsExtensionFeed implements IExtensionFeed {
+    readonly name: string;
+    private readonly _extensions;
+    constructor(name: string, extensions: Iterable<BuiltInExtension>);
+    queryExtensionsAsync(filter?: string): Promise<IExtensionMetadataQuery>;
+    getExtensionModuleAsync(name: string): Promise<ExtensionModule | undefined>;
+}

package/lib/extensibility/defaultInspectorExtensionFeed.d.ts

@@ -0,0 +1,5 @@
+import { BuiltInsExtensionFeed } from "./builtInsExtensionFeed";
+/**
+ * Well-known default built in extensions for the Inspector.
+ */
+export declare const DefaultInspectorExtensionFeed: BuiltInsExtensionFeed;

package/lib/extensibility/extensionFeed.d.ts

@@ -0,0 +1,113 @@
+import { type WeaklyTypedServiceDefinition } from "../modularity/serviceContainer";
+export type PersonMetadata = {
+    /**
+     * The name of the person.
+     */
+    readonly name: string;
+    /**
+     * The email address of the person.
+     */
+    readonly email?: string;
+    /**
+     * The URL to the person's website.
+     */
+    readonly url?: string;
+    /**
+     * The Babylon forum username of the person.
+     */
+    readonly forumUserName?: string;
+    /**
+     * A base64 encoded PNG image to use as the person's avatar.
+     */
+    readonly avatar?: string;
+};
+export type ExtensionMetadata = {
+    /**
+     * The name of the extension.
+     */
+    readonly name: string;
+    /**
+     * The version of the extension (as valid semver).
+     */
+    readonly version?: string;
+    /**
+     * The description of the extension.
+     */
+    readonly description: string;
+    /**
+     * The keywords of the extension.
+     */
+    readonly keywords?: readonly string[];
+    /**
+     * The URL to the extension homepage.
+     */
+    readonly homepage?: string;
+    /**
+     * Specify the place where your code lives. This is helpful for people who want to contribute.
+     */
+    readonly repository?: string;
+    /**
+     * The URL to your extension's issue tracker and / or the email address to which issues should be reported. These are helpful for people who encounter issues with your extension.
+     */
+    readonly bugs?: string;
+    /**
+     * A license for your package so that people know how they are permitted to use it, and any restrictions you're placing on it.
+     */
+    readonly license?: string;
+    /**
+     * The primary author of the extension.
+     */
+    readonly author?: string | PersonMetadata;
+    /**
+     * The contributors to the extension.
+     */
+    readonly contributors?: readonly (string | PersonMetadata)[];
+};
+export type ExtensionModule = {
+    /**
+     * The default export of the module (e.g. export default).
+     */
+    default: {
+        /**
+         * The services that are included with the extension.
+         */
+        serviceDefinitions?: readonly WeaklyTypedServiceDefinition[];
+    };
+};
+/**
+ * Represents a query to fetch subset ranges of extension metadata from a feed.
+ */
+export interface IExtensionMetadataQuery {
+    /**
+     * The total number of extensions that satisfy the query.
+     */
+    readonly totalCount: number;
+    /**
+     * Fetches a range of extension metadata from the feed.
+     * @param index The index of the first extension to fetch.
+     * @param count The number of extensions to fetch.
+     * @returns A promise that resolves to the extension metadata.
+     */
+    getExtensionMetadataAsync(index: number, count: number): Promise<readonly ExtensionMetadata[]>;
+}
+/**
+ * Represents a feed/source of extensions.
+ */
+export interface IExtensionFeed {
+    /**
+     * The name of the feed.
+     */
+    readonly name: string;
+    /**
+     * Creates an extension metadata query given a filter.
+     * @param filter The filter to apply to the query.
+     * @returns A promise that resolves to the extension metadata query.
+     */
+    queryExtensionsAsync(filter?: string): Promise<IExtensionMetadataQuery>;
+    /**
+     * Gets the extension module for the specified extension.
+     * @param name The name of the extension.
+     * @returns A promise that resolves to the extension module.
+     */
+    getExtensionModuleAsync(name: string): Promise<ExtensionModule | undefined>;
+}

package/lib/extensibility/extensionManager.d.ts

@@ -0,0 +1,111 @@
+import { type IDisposable } from "@babylonjs/core/index.js";
+import { type ServiceContainer } from "../modularity/serviceContainer";
+import { type IExtensionFeed, type ExtensionMetadata } from "./extensionFeed";
+/**
+ * Represents a loaded extension.
+ */
+export interface IExtension {
+    /**
+     * The metadata for the extension.
+     */
+    readonly metadata: ExtensionMetadata;
+    /**
+     * Whether the extension is currently being installed, uninstalled, enabled, or disabled.
+     */
+    readonly isStateChanging: boolean;
+    /**
+     * Whether the extension is enabled.
+     */
+    readonly isInstalled: boolean;
+    /**
+     * Installs the extension.
+     */
+    installAsync(): Promise<void>;
+    /**
+     * Uninstalls the extension.
+     */
+    uninstallAsync(): Promise<void>;
+    /**
+     * Adds a handler that is called when the state of the extension changes.
+     * @param handler The handler to add.
+     * @returns A disposable that removes the handler when disposed.
+     */
+    addStateChangedHandler(handler: () => void): IDisposable;
+}
+/**
+ * Provides information about an extension installation failure.
+ */
+export type InstallFailedInfo = {
+    /**
+     * The metadata of the extension that failed to install.
+     */
+    extension: ExtensionMetadata;
+    /**
+     * The error that occurred during the installation.
+     */
+    error: unknown;
+};
+/**
+ * Represents a query for loaded extensions.
+ */
+export interface IExtensionQuery {
+    /**
+     * The total number of extensions that satisfy the query.
+     */
+    readonly totalCount: number;
+    /**
+     * Fetches a range of extensions from the query.
+     * @param index The index of the first extension to fetch.
+     * @param count The number of extensions to fetch.
+     * @returns A promise that resolves to the extensions.
+     */
+    getExtensionsAsync(index: number, count: number): Promise<IExtension[]>;
+}
+/**
+ * Manages the installation, uninstallation, enabling, and disabling of extensions.
+ */
+export declare class ExtensionManager implements IDisposable {
+    private readonly _namespace;
+    private readonly _serviceContainer;
+    private readonly _feeds;
+    private readonly _onInstallFailed;
+    private readonly _installedExtensions;
+    private readonly _stateChangedHandlers;
+    private constructor();
+    /**
+     * Creates a new instance of the ExtensionManager.
+     * This will automatically rehydrate previously installed and enabled extensions.
+     * @param namespace The namespace to use for storing extension state in local storage.
+     * @param serviceContainer The service container to use.
+     * @param feeds The extension feeds to include.
+     * @param onInstallFailed A callback that is called when an extension installation fails.
+     * @returns A promise that resolves to the new instance of the ExtensionManager.
+     */
+    static CreateAsync(namespace: string, serviceContainer: ServiceContainer, feeds: readonly IExtensionFeed[], onInstallFailed: (info: InstallFailedInfo) => void): Promise<ExtensionManager>;
+    /**
+     * Gets the names of the feeds that are included in the extension manager.
+     * @returns The names of the feeds.
+     */
+    get feedNames(): string[];
+    /**
+     * Queries the extension manager for extensions.
+     * @param filter The filter to apply to the query.
+     * @param feeds The feeds to include in the query.
+     * @param installedOnly Whether to only include installed extensions.
+     * @returns A promise that resolves to the extension query.
+     */
+    queryExtensionsAsync(filter?: string, feeds?: string[], installedOnly?: boolean): Promise<IExtensionQuery>;
+    /**
+     * Disposes the extension manager.
+     */
+    dispose(): void;
+    private _getInstalledExtensionStorageKey;
+    private _updateInstalledExtensionsStorage;
+    private _installAsync;
+    private _uninstallAsync;
+    private _enableAsync;
+    private _disableAsync;
+    private _addStateChangedHandler;
+    private _createExtension;
+    private _createInstalledExtension;
+}

package/lib/extensions/quickCreate/cameras.d.ts

@@ -0,0 +1,14 @@
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type FunctionComponent } from "react";
+import { type ISelectionService } from "../../services/selectionService";
+type CamerasContentProps = {
+    scene: Scene;
+    selectionService: ISelectionService;
+};
+/**
+ * Cameras content component
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const CamerasContent: FunctionComponent<CamerasContentProps>;
+export {};

package/lib/extensions/quickCreate/frameGraphs.d.ts

@@ -0,0 +1,14 @@
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type FunctionComponent } from "react";
+import { type ISelectionService } from "../../services/selectionService";
+type FrameGraphsContentProps = {
+    scene: Scene;
+    selectionService: ISelectionService;
+};
+/**
+ * Frame Graphs content component
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const FrameGraphsContent: FunctionComponent<FrameGraphsContentProps>;
+export {};

package/lib/extensions/quickCreate/lights.d.ts

@@ -0,0 +1,14 @@
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type FunctionComponent } from "react";
+import { type ISelectionService } from "../../services/selectionService";
+type LightsContentProps = {
+    scene: Scene;
+    selectionService: ISelectionService;
+};
+/**
+ * Lights content component
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const LightsContent: FunctionComponent<LightsContentProps>;
+export {};

package/lib/extensions/quickCreate/materials.d.ts

@@ -0,0 +1,14 @@
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type FunctionComponent } from "react";
+import { type ISelectionService } from "../../services/selectionService";
+type MaterialsContentProps = {
+    scene: Scene;
+    selectionService: ISelectionService;
+};
+/**
+ * Materials content component
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const MaterialsContent: FunctionComponent<MaterialsContentProps>;
+export {};

package/lib/extensions/quickCreate/meshes.d.ts

@@ -0,0 +1,10 @@
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type FunctionComponent } from "react";
+import { type ISelectionService } from "../../services/selectionService";
+/**
+ * @internal
+ */
+export declare const MeshesContent: FunctionComponent<{
+    scene: Scene;
+    selectionService: ISelectionService;
+}>;

package/lib/extensions/quickCreate/particles.d.ts

@@ -0,0 +1,15 @@
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type FunctionComponent } from "react";
+import { type ISelectionService } from "../../services/selectionService";
+import "@babylonjs/core/Particles/webgl2ParticleSystem.js";
+type ParticlesContentProps = {
+    scene: Scene;
+    selectionService: ISelectionService;
+};
+/**
+ * Particles content component
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const ParticlesContent: FunctionComponent<ParticlesContentProps>;
+export {};

package/lib/extensions/quickCreate/quickCreateLayout.d.ts

@@ -0,0 +1,44 @@
+import { type FunctionComponent, type ReactNode } from "react";
+import { type ISelectionService } from "../../services/selectionService";
+type CreatedEntity = {
+    name: string;
+};
+type QuickCreateSectionProps = {
+    children: ReactNode;
+};
+/**
+ * Container component for quick create sections that provides consistent column layout with spacing
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const QuickCreateSection: FunctionComponent<QuickCreateSectionProps>;
+type QuickCreateRowProps = {
+    children: ReactNode;
+};
+/**
+ * Container component for quick create rows that provides consistent row layout for button + settings popover
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const QuickCreateRow: FunctionComponent<QuickCreateRowProps>;
+type QuickCreateItemProps = {
+    /** The selection service used by the go-to-entity button */
+    selectionService: ISelectionService;
+    /** Label for the quick-create button */
+    label: string;
+    /** Called when the quick-create button is clicked. Return the created entity (or a Promise that resolves to it) for toast + go-to. */
+    onCreate: () => CreatedEntity | Promise<CreatedEntity>;
+    /** Optional override for the settings popover's Create button. If omitted, the popover's Create button calls `onCreate`. */
+    onSettingsCreate?: () => CreatedEntity | Promise<CreatedEntity>;
+    /** Optional settings popover content (form fields). When provided, a settings popover with a Create button is rendered next to the quick-create button. */
+    children?: ReactNode;
+};
+/**
+ * Reusable row component for entity creation. Renders a quick-create button, an optional settings popover
+ * (with a baked-in Create button), and a "go to entity" button. Manages its own state for the last created entity
+ * and shows a toast on creation.
+ * @param props - The label, creation handler, selection service, and optional settings content
+ * @returns A row with a button, optional settings popover, and go-to-entity button
+ */
+export declare const QuickCreateItem: FunctionComponent<QuickCreateItemProps>;
+export {};

package/lib/extensions/quickCreate/quickCreateToolsService.d.ts

@@ -0,0 +1,11 @@
+import { type ServiceDefinition } from "../../modularity/serviceDefinition";
+import { type ISceneContext } from "../../services/sceneContext";
+import { type ISelectionService } from "../../services/selectionService";
+import { type IShellService } from "../../services/shellService";
+import "@babylonjs/core/Particles/webgl2ParticleSystem.js";
+import "@babylonjs/core/Rendering/prePassRendererSceneComponent.js";
+export declare const CreateToolsServiceDefinition: ServiceDefinition<[], [IShellService, ISceneContext, ISelectionService]>;
+declare const _default: {
+    readonly serviceDefinitions: readonly [ServiceDefinition<[], [IShellService, ISceneContext, ISelectionService]>];
+};
+export default _default;

package/lib/extensions/quickCreate/renderingPipelines.d.ts

@@ -0,0 +1,14 @@
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type FunctionComponent } from "react";
+import { type ISelectionService } from "../../services/selectionService";
+type RenderingPipelinesContentProps = {
+    scene: Scene;
+    selectionService: ISelectionService;
+};
+/**
+ * Rendering Pipelines content component
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const RenderingPipelinesContent: FunctionComponent<RenderingPipelinesContentProps>;
+export {};

package/lib/extensions/quickCreate/settingsPopover.d.ts

@@ -0,0 +1,14 @@
+import { type FunctionComponent, type PropsWithChildren } from "react";
+type SettingsPopoverProps = {
+    /** Controlled open state */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+};
+/**
+ * Settings popover component
+ * @param props
+ * @returns
+ */
+export declare const SettingsPopover: FunctionComponent<PropsWithChildren<SettingsPopoverProps>>;
+export {};

package/lib/extensions/quickCreate/spriteManagers.d.ts

@@ -0,0 +1,14 @@
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type FunctionComponent } from "react";
+import { type ISelectionService } from "../../services/selectionService";
+type SpriteManagersContentProps = {
+    scene: Scene;
+    selectionService: ISelectionService;
+};
+/**
+ * Sprite Managers content component
+ * @param props - Component props
+ * @returns React component
+ */
+export declare const SpriteManagersContent: FunctionComponent<SpriteManagersContentProps>;
+export {};

package/lib/{extensionsListService-zYdKn8uM.js → extensionsListService-BmiNjZiw.js}

@@ -1,10 +1,10 @@
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { Dialog, DialogTrigger, Tooltip, Button, DialogSurface, DialogBody, DialogTitle, TabList, Tab, DialogContent, Accordion, makeStyles, tokens, AccordionItem, AccordionHeader, Body1Strong, PresenceBadge, AccordionPanel, Card, CardHeader, Caption1, Body1, CardPreview, Persona, AvatarGroup, AvatarGroupItem, CardFooter, Spinner, Popover, PopoverTrigger, PopoverSurface } from '@fluentui/react-components';
+import { useState, useEffect, memo, useMemo, useCallback } from 'react';
+import { S as ShellServiceIdentity, u as useExtensionManager, L as Link } from './index-BCbXjPTn.js';
 import { AppsAddInRegular, DismissRegular, LinkRegular, BranchForkRegular, BugRegular, ArrowDownloadRegular, DeleteRegular, MailRegular, PeopleCommunityRegular } from '@fluentui/react-icons';
 import { Fade } from '@fluentui/react-motion-components-preview';
-import { useState, useEffect, memo, useMemo, useCallback } from 'react';
 import { Logger } from '@babylonjs/core/Misc/logger.js';
-import { c as ShellServiceIdentity, j as useExtensionManager, k as Link } from './index-DuVF9zYN.js';
 import '@babylonjs/core/Maths/math.color.js';
 import '@babylonjs/core/Maths/math.vector.js';
 import '@babylonjs/core/Misc/observable.js';
@@ -124,15 +124,15 @@ import '@babylonjs/core/Bones/skeleton.js';
 import '@babylonjs/core/Sprites/sprite.js';
 import '@babylonjs/core/Sprites/spriteManager.js';
 import '@babylonjs/core/Misc/textureTools.js';
-import '@babylonjs/core/Materials/Textures/baseTexture.js';
-import '@babylonjs/core/Materials/Textures/multiRenderTarget.js';
-import '@babylonjs/core/Materials/Textures/renderTargetTexture.js';
-import '@babylonjs/core/Materials/Textures/thinTexture.js';
 import '@babylonjs/core/Events/keyboardEvents.js';
 import '@babylonjs/core/Events/pointerEvents.js';
 import '@babylonjs/core/Materials/Textures/htmlElementTexture.js';
 import '@babylonjs/core/Materials/shaderMaterial.js';
 import '@babylonjs/core/Meshes/Builders/planeBuilder.js';
+import '@babylonjs/core/Materials/Textures/baseTexture.js';
+import '@babylonjs/core/Materials/Textures/multiRenderTarget.js';
+import '@babylonjs/core/Materials/Textures/renderTargetTexture.js';
+import '@babylonjs/core/Materials/Textures/thinTexture.js';
 import '@babylonjs/core/Rendering/boundingBoxRenderer.js';
 import '@babylonjs/core/PostProcesses/RenderPipeline/postProcessRenderPipelineManagerSceneComponent.js';
 import '@babylonjs/core/Sprites/spriteSceneComponent.js';
@@ -346,4 +346,4 @@ const ExtensionListServiceDefinition = {
 };
 
 export { ExtensionListServiceDefinition };
-//# sourceMappingURL=extensionsListService-zYdKn8uM.js.map
+//# sourceMappingURL=extensionsListService-BmiNjZiw.js.map