@openheart/tavio-renderer 2.3.29-with-wasm → 2.4.0

package/build/esm/types/{src/viewer/canvas.d.ts → viewer/driver/coreDriver.d.ts}

@@ -1,241 +1,89 @@
-import { Euler, Matrix4, Mesh, RawShaderMaterial, Vector2, Vector3, WebGLRenderTarget, WebGLRenderer, PMREMGenerator, SpotLight, AmbientLight } from 'three';
+import { RawShaderMaterial, WebGLRenderTarget, WebGLRenderer, PMREMGenerator, MeshStandardMaterialParameters } from 'three';
+import { iSphereSelectorOption } from '../../editor/selector/sphereSelector';
+import { iBoxSelectorOption } from '../../editor/selector/boxSelector';
+import { iSelectorInfo, tControlsType, tMaskSource, tSelectionMode, iVectorLike, iCameraPathOption, iCameraParameter, iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iPickingInfo, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
+import { iCollisionTarget } from '../../worker/tavioWorker';
+import { WorkerElementAdapter } from './workerElementAdapter';
 import { default as EventEmitter } from 'eventemitter3';
-import { iCollisionTarget } from '../worker/tavioWorker';
-import { CameraPath } from '../camera/cameraPath';
-import { CameraPathControls } from '../camera/cameraPathControls';
-import { FlightControls, iLatitudeLongitude } from '../camera/flightControls';
-import { OrbitControls } from '../camera/orbitControls';
-import { ConsoleOutput } from '../utility/console';
-import { iSphereSelectorOption } from '../editor/selector/sphereSelector';
-import { iBoxSelectorOption } from '../editor/selector/boxSelector';
-import { Selector } from '../editor/selector/selector';
-import { TavioMesh } from './tavioMesh';
-import { iAnimationConfig } from '../animation/animationController';
-import { iMaterialOption } from './materialGenerator';
-import { RenderView } from './renderView';
-/**
- * TypeScript の strict モードが true の場合、コンストラクタ内で初期化されていない場合など、
- * かなり厳密にチェックされる。本来であれば、すべてのプロパティをコンストラクタで初期化する
- * べきである。しかし本実装では dispose で解放する処理などがある関係上、コンストラクタ内で
- * すべてのプロパティを初期化せず、別途メソッドを呼び出したときに初めて初期化される要素が
- * 多く存在する。また同様の理由で、dispose 内で null を代入する都合があり、型定義が非常に
- * ややこしくなる。
- * たとえば `data: Uint8Array | null` のように null を許容するデータ型にしないと dispose で
- * null を代入することができない。一方でこのような型定義を行うと、事あるごとに「中身は null
- * の可能性があります」という旨のエラーが発生し都度 null でないかどうかのチェックを行う必要
- * が生じる。
- * 妥協案として、TypeScript の「非 null アサーション」を意味する `!` の演算子を多用している。
- * たとえば `tex: Texture | null` なプロパティであれば `this.tex.width` と書くと「tex は
- * null である可能性がある」というエラーが出るが `this.tex!.width` と書くとエラーは発生しない。
- * この記法では確かにエラーは出ないが、実際問題、dispose を呼び出したあとに参照したら中身は
- * null である可能性はあり厳密にはエラーになるのが正しい。しかし先述のとおりすべての箇所で
- * if 文などを書いて null チェックをすると冗長性が高くなりすぎてしまうため、ここでは運用上の
- * 妥協案として非アサーションの記法を使っている。
- * ※非 null アサーションとオプショナルチェイニングはまったくの別物なので注意
- */
-/**
- * Tavio Viewer のエラーコード
- */
-export declare const TavioErrorCode: {
-    /** Float16Array 未対応環境 */
-    readonly FLOAT16_NOT_SUPPORTED: "E001";
-};
-/**
- * Tavio Viewer のカスタムエラークラス
- */
-export declare class TavioError extends Error {
-    /** エラーコード */
-    code: string;
-    constructor(code: string, message: string);
-}
-/**
- * カメラコントロールの種類
- */
-export type tControlsType = "orbit" | "path" | "flight";
-/**
- * カメラコントロールの型チェック用定義
- */
-export type tControlInstance = OrbitControls | CameraPathControls | FlightControls;
-/**
- * Vector3 と同様に外部データを扱うための型定義
- */
-export interface iVectorLike {
-    x: number;
-    y: number;
-    z: number;
-}
-/**
- * カメラパスコントロールのオプション
- */
-export interface iCameraPathOption {
-    attenuation?: number;
-    scaleX?: number;
-    scaleY?: number;
-}
-/**
- * 汎用カメラパラメータ
- */
-interface iCameraParameter {
-    position?: number[];
-    eye?: number[];
-    target?: number[];
-    fov?: number;
-}
-/**
- * ビューアオプション
- */
-export interface iViewerOption {
-    usingSharedArrayBuffer?: boolean;
-    controlsType?: tControlsType;
-    gaussianScale?: number;
-    minimumScale?: number;
-    distanceEffectPoint?: number;
-    distanceEffectPointNear?: number;
-    distanceEffectBase?: number;
-    distanceEffectRange?: number;
-    distanceColorEffect?: number;
-    distanceColorEffectNear?: number;
-    effectSonar?: number;
-    effectSonarRange?: number;
-    worldOrigin?: iVectorLike;
-    opacityPoints?: number;
-    opacityAdditive?: number;
-    opacityMultiplier?: number;
-    colorTemperature?: number;
-    colorTint?: number;
-    colorContrast?: number;
-    colorHSV?: iVectorLike;
-    colorRGB?: iVectorLike;
-    colorBlur?: number;
-    colorSharpness?: number;
-    backgroundOpacity?: number;
-    disableBackground?: boolean;
-    consoleOutput?: boolean;
-    /** @deprecated orbitCursorAutoDisplay を使用してください */
-    enableOrbitCursor?: boolean;
-    orbitCursorAutoDisplay?: boolean;
-    orbitCursorDisplay?: boolean;
-    orbitCursorScale?: number;
-    dropShadow?: boolean;
-    shadowMapSize?: number;
-    clipSphere?: boolean;
-    preserveDrawingBuffer?: boolean;
-    powerPreference?: WebGLPowerPreference;
-}
-/**
- * ビューアのマテリアルオプション
- */
-export interface iViewerMaterialOption {
-    materialOption: iMaterialOption | iMaterialOption[];
-    isDebug?: boolean;
-}
-/**
- * セレクターの情報
- */
-interface iSelectorInfo {
-    name: string;
-    visible: boolean;
-    position?: iVectorLike;
-    rotation?: iVectorLike;
-    scale?: iVectorLike;
-    radius?: number | null;
-    width?: number | null;
-    height?: number | null;
-    depth?: number | null;
-}
-/**
- * ファイルのロードオプション
- */
-export interface iLoadingOption {
-    useSphericalHarmonics?: boolean;
-    autoInsert?: boolean;
-    autoBackground?: boolean;
-}
-/**
- * ファイル内に含まれる 3DGS の原点からの距離と割合
- */
-export interface iDistanceInfo {
-    per50?: number | null;
-    per70?: number | null;
-    per90?: number | null;
-    per100: number | null;
-}
-/**
- * ファイル内のヘッダ及び頂点情報
- */
-export interface iHeaderInfo {
-    majorVersionNumber: number;
-    minorVersionNumber: number;
-    featureBits: any;
-    distance: iDistanceInfo;
-}
-/**
- * ファイルに対する座標変換情報
- */
-export interface iTransform {
-    translation: Vector3;
-    rotation: Euler;
-    scale: number;
-}
-/**
- * ピッキングして得られた情報
- */
-export interface iPickingInfo {
-    name: string;
-    index: number;
-    target: iVectorLike;
-}
-/**
- * ビューポートや focal の情報
- */
-export interface iViewportInfo {
-    projection: Matrix4;
-    focal: Vector2;
-    inverseViewport: Vector2;
-}
-/**
- * ビューア実装本体
- */
-export declare class Core extends EventEmitter {
-    canvas: HTMLCanvasElement;
-    gl: WebGL2RenderingContext;
-    uniforms: any;
+import { CameraPath } from '../../camera/cameraPath';
+import { iLatitudeLongitude } from '../../camera/flightControls';
+import { ConsoleOutput } from '../../utility/console';
+import { TavioMesh } from '../tavioMesh/tavioMesh';
+import { RenderView } from '../renderView';
+import { iCoreDriver } from './iCoreDriver';
+export declare class CoreDriver extends EventEmitter implements iCoreDriver {
+    canvas: HTMLCanvasElement | OffscreenCanvas;
     viewerOption: iViewerOption;
-    defaultRenderViewSymbol: Symbol;
+    elementAdapter?: WorkerElementAdapter;
+    getElementAdapter(): HTMLCanvasElement | OffscreenCanvas | WorkerElementAdapter;
+    /** WebGL コンテキスト（WebGL 2.0） */
+    gl: WebGL2RenderingContext;
+    /** Three.js レンダラー */
+    renderer: WebGLRenderer;
+    /** 背景生成用ジェネレータ */
+    pmremGenerator: PMREMGenerator;
+    /** ワールド座標のピックを行うために座標を書き込むレンダーターゲット */
+    pickingRenderTarget: WebGLRenderTarget;
+    /** インデックス選択を行うために座標を書き込むレンダーターゲット */
+    indexSelectionRenderTarget: WebGLRenderTarget;
+    /** インデックス選択用オフスクリーンバッファの解像度縮小率 */
+    indexSelectionDivisor: number;
+    /** レンダービューを保持する Map */
     renderViewMap: Map<Symbol | string, RenderView>;
+    /** 既定のレンダービューを意味する Symbol */
+    defaultRenderViewSymbol: Symbol;
+    /** 現在アクティブなレンダービューの名前 */
     currentRenderViewName: Symbol | string;
+    /** 現在アクティブなレンダービュー */
     currentRenderView: RenderView;
+    /** 各種 TavioMesh を保持する Map */
     meshMap: Map<string, TavioMesh>;
-    selectorMap: Map<string, Selector>;
+    /** コンソール出力のラッパークラスのインスタンス */
+    console: ConsoleOutput;
+    /** uniform 変数管理 */
+    uniforms: any;
+    /** カメラの可動域制御用コライダーが有効かどうか */
     cameraColliderEnabled: boolean;
-    reversedCollision: boolean;
+    /** TavioMesh から取得した全スプラットの最大距離 */
     maxDistance: number;
+    /** レンダリングをインタラクティブに行うかどうか */
     isInteractive: boolean;
+    /** レンダリングを行うかどうか */
     isRendering: boolean;
+    /** 読み込みと初期化が現在進行中かどうか */
     isLoading: boolean;
+    /** pause() によって描画が一時停止されているかどうか */
     isPaused: boolean;
+    /** レンダリングを開始した瞬間のタイムスタンプ */
     startRendering: number;
-    renderer: WebGLRenderer;
-    pmremGenerator: PMREMGenerator;
-    gaussianMaterial: RawShaderMaterial;
-    gaussianPickingMaterial: RawShaderMaterial;
-    gaussianShadowingMaterial: RawShaderMaterial;
-    pickingRenderTarget: WebGLRenderTarget;
-    parameters: any;
-    console: ConsoleOutput;
-    private animationController;
-    private pathAnimationLocked;
+    private localTransformGizmoParent?;
+    private localTransformGizmoTarget?;
+    private localTransformGizmo?;
+    private localTransformGizmoEnabled;
+    private localTransformInitialQuaternion;
+    private cursorMap;
+    private previousTargetMap;
+    private torusGeometry?;
+    private torusMaterial?;
+    private sphereGeometry?;
+    private sphereMaterial?;
+    private shaderRegistry;
     /** WebGLRenderer.getSize 用（RenderView は論理ピクセル。canvas バッファ実寸とは別） */
     private readonly _rendererLogicalSize;
+    /** 3DGS 用のマテリアル */
+    get gaussianMaterial(): RawShaderMaterial;
+    /** ワールド座標のピック用シェーダのマテリアル */
+    get gaussianPickingMaterial(): RawShaderMaterial;
+    /** 影の描画用シェーダのマテリアル */
+    get gaussianShadowingMaterial(): RawShaderMaterial;
+    /** インデックス選択用シェーダのマテリアル */
+    get gaussianIndexSelectionMaterial(): RawShaderMaterial;
+    /** 点描画用シェーダのマテリアル */
+    get gaussianPointMaterial(): RawShaderMaterial;
     /** setFrameRateLimit で設定される1フレームあたりの最小間隔（ms）。0 の場合は上限なし */
     private _frameIntervalMs;
     /** 直前にフレームを描画した時刻（Date.now()） */
     private _lastFrameTimestamp;
-    /**
-     * インスタンスが発火するイベント
-     * ※実際には TavioMesh が発火するイベントをリレーする
-     */
-    static EVENTS: string[];
     /**
      * 対応する Controls 種別
      */
@@ -245,9 +93,12 @@ export declare class Core extends EventEmitter {
      */
     static CHUNK_TARGET: {
         readonly ANY: 0;
-        readonly BASIC: 1;
-        readonly PICKING: 2;
-        readonly SHADOWING: 4;
+        readonly ANY_SPLAT: 1;
+        readonly BASIC: 2;
+        readonly PICKING: 4;
+        readonly SHADOWING: 8;
+        readonly INDEX_SELECTION: 16;
+        readonly POINTS: 32;
     };
     static SHADER_STAGE: {
         readonly VERTEX_PRECISION: 0;
@@ -255,16 +106,17 @@ export declare class Core extends EventEmitter {
         readonly VERTEX_FUNCTION: 2;
         readonly VERTEX_MAIN_BEGIN: 3;
         readonly VERTEX_MAIN_TRANSFORM: 4;
-        readonly VERTEX_MAIN_SIGMA: 5;
-        readonly VERTEX_MAIN_OUT: 6;
-        readonly VERTEX_MAIN_END: 7;
-        readonly FRAGMENT_PRECISION: 8;
-        readonly FRAGMENT_DECLARATION: 9;
-        readonly FRAGMENT_FUNCTION: 10;
-        readonly FRAGMENT_MAIN_BEGIN: 11;
-        readonly FRAGMENT_MAIN_IN: 12;
-        readonly FRAGMENT_MAIN_OUT: 13;
-        readonly FRAGMENT_MAIN_END: 14;
+        readonly VERTEX_MAIN_CLIPPING: 5;
+        readonly VERTEX_MAIN_SIGMA: 6;
+        readonly VERTEX_MAIN_OUT: 7;
+        readonly VERTEX_MAIN_END: 8;
+        readonly FRAGMENT_PRECISION: 9;
+        readonly FRAGMENT_DECLARATION: 10;
+        readonly FRAGMENT_FUNCTION: 11;
+        readonly FRAGMENT_MAIN_BEGIN: 12;
+        readonly FRAGMENT_MAIN_IN: 13;
+        readonly FRAGMENT_MAIN_OUT: 14;
+        readonly FRAGMENT_MAIN_END: 15;
     };
     /**
      * @constructor
@@ -288,36 +140,7 @@ export declare class Core extends EventEmitter {
      * @param canvas - WebGL コンテキストを取得する対象となる canvas 要素
      * @param materialOption - シェーダチャンクなどの情報を含むマテリアルオプション
      */
-    init(canvas: HTMLCanvasElement, materialOption?: iViewerMaterialOption): void;
-    /**
-     * アンビエントライトをレンダービューに追加する
-     * @param color - 光の色
-     * @param intensity - 光の強さ
-     */
-    addAmbientLight(color: number, intensity: number): AmbientLight;
-    /**
-     * スポットライトをレンダービューに追加する
-     * @param position - ライトの位置
-     * @param target - ライトの注視点
-     * @param color - 光の色
-     * @param intensity - 光の強さ
-     * @param distance - 光が届く距離
-     * @param angle - 光が届く範囲（Math.PI / 2 より小さな値を指定）
-     * @param penumbra - 光の輪郭のぼやけ具合
-     * @param decay - 光の減衰
-     * @param castShadow - 影を落とすかどうか
-     * @param isDebug - ヘルパーを表示するかどうか
-     */
-    addSpotLight(position: iVectorLike, target: iVectorLike, color: number, intensity: number, distance: number, angle: number, penumbra: number, decay: number, castShadow?: boolean, isDebug?: boolean): SpotLight;
-    /**
-     * ホワイトキューブの Mesh を追加する
-     * @param position - キューブの位置
-     * @param scale - キューブに対するスケール
-     * @param receiveShadow - 影が落ちるかどうか
-     * @param materialOption - MeshStandardMaterial の初期化オプション
-     */
-    addWhiteCube(position: iVectorLike, scale: iVectorLike, receiveShadow?: boolean, materialOption?: any): Mesh;
-    renderShadow(): void;
+    init(canvas: HTMLCanvasElement | OffscreenCanvas, materialOption?: iViewerMaterialOption): void;
     /**
      * レンダービューをセットアップする
      */
@@ -327,11 +150,6 @@ export declare class Core extends EventEmitter {
      * @param renderView - セットアップの対象となるレンダービュー
      */
     setupControls(renderView: RenderView): void;
-    /**
-     * viewerOption から注視点カーソルの自動表示設定を解決する
-     * @private
-     */
-    private _getOrbitCursorAutoDisplayOption;
     /**
      * OrbitControls をセットアップする
      * @param renderView - セットアップの対象となるレンダービュー
@@ -362,18 +180,6 @@ export declare class Core extends EventEmitter {
      * @param option - シェーダチャンクなどの情報を含むマテリアルオプション
      */
     setupMaterial(option?: iViewerMaterialOption): void;
-    /**
-     * セレクターをセットアップする
-     */
-    setupSelector(): void;
-    /**
-     * イベントのセットアップ
-     */
-    setupEvent(): void;
-    /**
-     * デバッグ用インターフェースのセットアップ
-     */
-    setupPane(): void;
     /**
      * ==========================================================================
      * TavioMesh / loader
@@ -412,59 +218,59 @@ export declare class Core extends EventEmitter {
     /**
      * TavioMesh のインスタンスを生成し ply 形式のリソースをロード、シーンに追加する
      * @param name - このメッシュの固有名
-     * @param url - 読み込む .ply ファイル
+     * @param source - 読み込む .ply ファイル（URL文字列、Blob、または ArrayBuffer）
      * @param option - ロード・パース関連のオプション
      */
-    loadPly(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     /**
      * 既存の TavioMesh のインスタンスにデータを統合する
      * @param name - このメッシュの固有名
-     * @param url - 読み込む .ply ファイル
+     * @param source - 読み込む .ply ファイル（URL文字列、Blob、または ArrayBuffer）
      * @param option - ロード・パース関連のオプション
      */
-    concatPly(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    concatPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     /**
      * TavioMesh のインスタンスを生成し splat 形式のリソースをロード、シーンに追加する
      * @param name - このメッシュの固有名
-     * @param url - 読み込む .splat ファイル
+     * @param source - 読み込む .splat ファイル（URL文字列、Blob、または ArrayBuffer）
      * @param option - ロード・パース関連のオプション
      */
-    loadSplat(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     /**
      * 既存の TavioMesh のインスタンスにデータを統合する
      * @param name - このメッシュの固有名
-     * @param url - 読み込む .splat ファイル
+     * @param source - 読み込む .splat ファイル（URL文字列、Blob、または ArrayBuffer）
      * @param option - ロード・パース関連のオプション
      */
-    concatSplat(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    concatSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     /**
      * TavioMesh のインスタンスを生成し画像形式のリソースをロード、シーンに追加する
      * @param name - このメッシュの固有名
-     * @param url - 読み込む画像ファイル
+     * @param source - 読み込む画像ファイル（URL文字列、Blob、または ArrayBuffer）
      * @param option - ロード・パース関連のオプション
      */
-    loadImage(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
     /**
      * 既存の TavioMesh のインスタンスにデータを統合する
      * @param name - このメッシュの固有名
-     * @param url - 読み込む画像ファイル
+     * @param source - 読み込む画像ファイル（URL文字列、Blob、ArrayBuffer、または ImageBitmap）
      * @param option - ロード・パース関連のオプション
      */
-    concatImage(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    concatImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
     /**
      * canvas 要素から TavioMesh のインスタンスを生成し、シーンに追加する
      * @param name - このメッシュの固有名
-     * @param canvas - 処理の対象となる canvas 要素
+     * @param canvas - 処理の対象となる canvas 要素、または OffscreenCanvas / ImageBitmap
      * @param option - ロード・パース関連のオプション
      */
-    loadCanvas(name: string, canvas: HTMLCanvasElement, option?: iLoadingOption): Promise<void>;
+    loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
     /**
      * 既存の TavioMesh のインスタンスにデータを統合する
      * @param name - このメッシュの固有名
-     * @param canvas - 処理の対象となる canvas 要素
+     * @param canvas - 処理の対象となる canvas 要素、または OffscreenCanvas / ImageBitmap
      * @param option - ロード・パース関連のオプション
      */
-    concatCanvas(name: string, canvas: HTMLCanvasElement, option?: iLoadingOption): Promise<void>;
+    concatCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
     /**
      * tavio 形式のリソースをロードする
      * @param name - このメッシュの固有名
@@ -578,6 +384,19 @@ export declare class Core extends EventEmitter {
      * @param name - 対象の名前
      */
     setBackgroundByTavioMesh(name: string): void;
+    /**
+     * 名前を指定した TavioMesh に含まれるメッシュに対して座標変換を適用する
+     * @param name - 対象の名前
+     * @param translation - 平行移動
+     * @param rotation - 回転（オイラー角）
+     * @param scale - 拡大縮小（XYZ で統一のスケール）
+     */
+    setModelTransform(name: string, translation: iVectorLike, rotation: iVectorLike, scale: number): void;
+    /**
+     * 名前を指定した TavioMesh に含まれるメッシュの座標変換情報を返す
+     * @param name - 対象の名前
+     */
+    getModelTransform(name: string): iTransform | null;
     /**
      * 名前を指定した TavioMesh に含まれるインスタンスを、インデックスで指定して動かす
      * ※ここでいうインデックスとは load/concat した順番を意味する整数値（concat していない場合常に 0）
@@ -639,6 +458,10 @@ export declare class Core extends EventEmitter {
      * @private
      */
     private _render;
+    /**
+     * 登録されている最初のメッシュの名前を取得する
+     */
+    getFirstMeshName(): string | null;
     /**
      * DevicePixelRatio をレンダラーに対して設定する
      * @param value - 設定する DevicePixelRatio
@@ -653,6 +476,10 @@ export declare class Core extends EventEmitter {
      * @param isInteractive - 有効とするかどうか
      */
     setInteractiveMode(isInteractive: boolean): void;
+    /**
+     * インタラクティブに描画するモードを用いているかどうかを返す
+     */
+    getInteractiveMode(): boolean;
     /**
      * 球面調和関数の交流成分を利用するかどうかを設定する
      * @param isUsing - 利用するかどうかのフラグ
@@ -679,6 +506,16 @@ export declare class Core extends EventEmitter {
      * @param isDebug - デバッグモード（有効化するとピッキングバッファを可視化）
      */
     getWorldPositionByRenderView(x: number, y: number, isDebug?: boolean): Promise<iPickingInfo | null>;
+    /**
+     * スクリーン空間上の矩形またはドローイングマスクの範囲にあるスプラットを選択する
+     * @param x - 正規化された選択領域の左上 X 座標 (0.0 ~ 1.0)
+     * @param y - 正規化された選択領域の左上 Y 座標 (0.0 ~ 1.0)
+     * @param width - 正規化された選択領域の幅 (0.0 ~ 1.0)
+     * @param height - 正規化された選択領域の高さ (0.0 ~ 1.0)
+     * @param mode - 選択モード（SELECTION_MODE）
+     * @param maskSource - オプション：指定領域に対応するアルファマスク（Canvas, OffscreenCanvas, ImageData）
+     */
+    selectSplatByScreenArea(x: number, y: number, width: number, height: number, mode?: tSelectionMode, maskSource?: tMaskSource): Promise<void>;
     /**
      * 各種リソースを解放する
      * ※このメソッドを呼び出すと、それまで利用していた canvas は再利用できなくなる
@@ -919,17 +756,13 @@ export declare class Core extends EventEmitter {
      */
     updateCameraPath(time: number): void;
     /**
-     * カメラパスを設定する
-     * @deprecated このメソッドは廃止されました。addCameraPath(name, path) と selectCameraPath(name) を使用してください。
-     * @param path - 設定する CameraPath
-     */
-    setCameraPath(path: CameraPath): void;
-    /**
-     * カメラパスを名前で追加する
-     * @param name - カメラパスの名前
-     * @param path - 追加する CameraPath
+     * カメラパスを名前と座標データで追加登録する
+     * @param name - カメラパスの識別名
+     * @param position - カメラ移動経路の座標配列
+     * @param target - カメラ注視点経路の座標配列
+     * @param debug - デバッグ用軌跡描画を行うかどうか
      */
-    addCameraPath(name: string, path: CameraPath): void;
+    addCameraPath(name: string, position: iVectorLike[] | number[][], target: iVectorLike[] | number[][], debug?: boolean): void;
     /**
      * カメラパスを名前で削除する
      * @param name - 削除するカメラパスの名前
@@ -940,16 +773,21 @@ export declare class Core extends EventEmitter {
      * @param name - 選択するカメラパスの名前
      */
     selectCameraPath(name: string): void;
-    /**
-     * 現在アクティブなカメラパスを取得する
-     * @returns アクティブなカメラパス、または null
-     */
-    getActiveCameraPath(): CameraPath | null;
     /**
      * 現在アクティブなカメラパスの名前を取得する
      * @returns アクティブなカメラパスの名前、または null
      */
     getActiveCameraPathName(): string | null;
+    /**
+     * 指定したカメラパスの指定時刻における座標と注視点を取得する
+     * @param name - カメラパスの名前。省略時は現在アクティブなカメラパス
+     * @param time - 進行度 (0.0 ～ 1.0)。省略時は現在の再生時刻
+     * @returns 指定時刻での座標と注視点データ、または null
+     */
+    getCameraPathByTime(name?: string, time?: number): {
+        position: iVectorLike;
+        target: iVectorLike;
+    } | null;
     /**
      * カメラパスコントロールの現在時刻（progress）を取得する
      * @returns 現在時刻（0.0 ～ 1.0）、または null
@@ -1069,6 +907,11 @@ export declare class Core extends EventEmitter {
      * @param enabled - 有効化するかどうか
      */
     setCameraColliderEnabled(enabled: boolean): void;
+    /**
+     * カメラコライダー処理の対象となるセレクター名の一覧を設定する
+     * @param selectorNames - セレクター名の配列
+     */
+    setCameraColliderSelector(selectorNames?: string[]): void;
     /**
      * カメラコライダーの有効・無効状態を取得する
      * @returns カメラコライダーが有効かどうか
@@ -1076,292 +919,373 @@ export declare class Core extends EventEmitter {
     getCameraColliderEnabled(): boolean;
     /**
      * ==========================================================================
-     * shader effects
+     * Light and Shadow
      * ==========================================================================
      */
     /**
-     * 点描画用の Points に対して uniform 変数の値を設定する
-     * ※あくまでも private なメソッドであり、値設定後に自動で start() はコールされない
-     * @private
-     * @param uniforms - 設定する値を定義したオブジェクト
+     * アンビエントライトをレンダービューに追加する
+     * @param color - 光の色
+     * @param intensity - 光の強さ
      */
-    private _setPointUniforms;
+    addAmbientLight(color: number, intensity: number): void;
     /**
-     * MaterialGenerator で独自に拡張した defines を更新する
-     * @param customUniforms - 設定・更新する defines
+     * スポットライトをレンダービューに追加する
+     * @param position - ライトの位置
+     * @param target - ライトの注視点
+     * @param color - 光の色
+     * @param intensity - 光の強さ
+     * @param distance - 光が届く距離
+     * @param angle - 光が届く範囲（Math.PI / 2 より小さな値を指定）
+     * @param penumbra - 光の輪郭のぼやけ具合
+     * @param decay - 光の減衰
+     * @param castShadow - 影を落とすかどうか
+     * @param isDebug - ヘルパーを表示するかどうか
      */
-    setCustomDefines(customDefines: any): void;
+    addSpotLight(position: iVectorLike, target: iVectorLike, color: number, intensity: number, distance: number, angle: number, penumbra: number, decay: number, castShadow?: boolean, isDebug?: boolean): void;
     /**
-     * MaterialGenerator で独自に拡張した uniform 変数を更新する
-     * @param customUniforms - 設定・更新する uniform 変数
+     * ホワイトキューブの Mesh を追加する
+     * @param position - キューブの位置
+     * @param scale - キューブに対するスケール
+     * @param receiveShadow - 影が落ちるかどうか
+     * @param materialOption - MeshStandardMaterial の初期化オプション
      */
-    setCustomUniforms(customUniforms: any): void;
+    addWhiteCube(position: iVectorLike, scale: iVectorLike, receiveShadow?: boolean, materialOption?: MeshStandardMaterialParameters): void;
     /**
-     * スプラットの大きさの基本係数を設定する
-     * @param value - 設定する係数（0.0 to 1.0）
+     * 現在のレンダービューのアンビエントライトの強度を設定する
+     * @param intensity - 光の強度
      */
-    setGaussianScale(value: number): void;
+    setAmbientLightIntensity(intensity: number): void;
     /**
-     * 距離に応じたスプラットの大きさにおける最小値を設定する
-     * @param value - 設定する係数（0.0 to 1.0）
+     * 現在のレンダービューのスポットライトの位置を設定する
+     * @param position - 位置
      */
-    setEffectMinimumScale(value: number): void;
+    setSpotLightPosition(position: iVectorLike): void;
     /**
-     * 距離に応じたスプラットの大きさ係数を設定する
-     * @param value - 設定する係数（0.0 to 1.0）
+     * 現在のレンダービューのスポットライトのターゲット位置を設定する
+     * @param target - ターゲット位置
      */
-    setEffectDistanceBase(value: number): void;
+    setSpotLightTargetPosition(target: iVectorLike): void;
     /**
-     * 距離に応じたスプラットの範囲係数を設定する
-     * @param value - 設定する係数（0.0 < n <= 1.0）
+     * 現在のレンダービューのスポットライトの強度を設定する
+     * @param intensity - 光の強度
      */
-    setEffectDistanceRange(value: number): void;
+    setSpotLightIntensity(intensity: number): void;
     /**
-     * シェーダーで使用するワールド原点を設定する
-     * @param x - X座標
-     * @param y - Y座標
-     * @param z - Z座標
+     * 現在のレンダービューのスポットライトの照射距離を設定する
+     * @param distance - 照射距離
      */
-    setWorldOrigin(x: number, y: number, z: number): void;
+    setSpotLightDistance(distance: number): void;
     /**
-     * シェーダ上で作用する加減算アルファ値を設定する
-     * @param alpha - アルファ（適切な範囲はおよそ -3.0 ～ 3.0）
+     * 現在のレンダービューのスポットライトの放射角を設定する
+     * @param angle - 放射角
      */
-    setOpacityAdditive(alpha: number): void;
+    setSpotLightAngle(angle: number): void;
     /**
-     * シェーダ上で作用する乗算アルファ値を設定する
-     * @param alpha - アルファ（適切な範囲はおよそ -3.0 ～ 3.0）
+     * 現在のレンダービューのスポットライトの半影を設定する
+     * @param penumbra - 半影の割合
      */
-    setOpacityMultiplier(alpha: number): void;
+    setSpotLightPenumbra(penumbra: number): void;
     /**
-     * 点描画用の Points に対して距離に応じたエフェクトの範囲係数を設定する（外側）
-     * @param value - 設定する係数（0.0 < n <= 1.0）
+     * 現在のレンダービューのスポットライトの減衰を設定する
+     * @param decay - 減衰の度合い
      */
-    setEffectDistancePoints(value: number): void;
+    setSpotLightDecay(decay: number): void;
     /**
-     * 点描画用の Points に対して距離に応じたエフェクトの範囲係数を設定する（内側）
-     * @param value - 設定する係数（0.0 < n <= 1.0）
+     * 影を描画・更新する
      */
-    setEffectDistanceNearPoints(value: number): void;
+    renderShadow(): void;
     /**
-     * 色エフェクトの範囲を設定する（外側）
-     * @param value - 設定する係数（0.0 < n <= 1.0）
+     * ==========================================================================
+     * shader effects
+     * ==========================================================================
      */
-    setEffectDistanceColor(value: number): void;
     /**
-     * 色エフェクトの範囲を設定する（内側）
-     * @param value - 設定する係数（0.0 < n <= 1.0）
+     * MaterialGenerator で独自に拡張した defines を更新する
+     * @param customUniforms - 設定・更新する defines
      */
-    setEffectDistanceColorNear(value: number): void;
+    setCustomDefines(customDefines: tCustomDefines): void;
     /**
-     * ソナーエフェクトを設定する（外側）
-     * @param value - 設定する係数（0.0 < n <= 1.0）
+     * MaterialGenerator で独自に拡張した uniform 変数を更新する
+     * @param customUniforms - 設定・更新する uniform 変数
      */
-    setEffectSonar(value: number): void;
+    setCustomUniforms(customUniforms: tCustomUniforms): void;
     /**
-     * ソナーエフェクトの範囲を設定する
-     * @param value - 設定する範囲（0.0 < n <= 1.0）
+     * スプラットの大きさの基本係数を設定する
+     * @param value - 設定する係数（0.0 to 1.0）
      */
-    setEffectSonarRange(value: number): void;
+    setGaussianScale(value: number): void;
+    /**
+     * シェーダ上で作用する加減算アルファ値を設定する
+     * @param alpha - アルファ（適切な範囲はおよそ -3.0 ～ 3.0）
+     */
+    setOpacityAdditive(alpha: number): void;
+    /**
+     * シェーダ上で作用する乗算アルファ値を設定する
+     * @param alpha - アルファ（適切な範囲はおよそ -3.0 ～ 3.0）
+     */
+    setOpacityMultiplier(alpha: number): void;
     /**
      * 点描画用の Points に対してアルファを設定する
      * @param alpha - アルファ（0.0 ～ 1.0）
      */
     setOpacityPoints(alpha: number): void;
     /**
-     * シェーダ上で作用する色温度を設定する
-     * @param temperature - 色温度（適切な範囲はおよそ -1.0 ～ 1.0）
+     * シェーダ上で作用する blur を設定する
+     * @param blur - スプラット内で色をぼかす係数（適切な範囲はおよそ 0.0 ～ 1.0）
+     */
+    setColorBlur(blur: number): void;
+    /**
+     * シェーダ上で作用する sharpness を設定する
+     * @param sharpness - スプラット内で色を強調する係数（適切な範囲はおよそ 0.0 ～ 1.0）
+     */
+    setColorSharpness(sharpness: number): void;
+    /**
+     * シェーダ上で作用する色温度（Color Temperature）を設定する
+     * @param temperature - 色温度（-1.0 ～ 1.0）
      */
     setColorTemperature(temperature: number): void;
     /**
-     * シェーダ上で作用するティントを設定する
-     * @param tint - ティント（適切な範囲はおよそ -1.0 ～ 1.0）
+     * シェーダ上で作用する色合い（Color Tint）を設定する
+     * @param tint - ティント係数（-1.0 ～ 1.0）
      */
     setColorTint(tint: number): void;
     /**
      * シェーダ上で作用するコントラストを設定する
-     * @param contrast - コントラスト（適切な範囲はおよそ 0.0 ～ 1.0）
+     * @param contrast - コントラスト強調係数（標準: 0.5）
      */
     setColorContrast(contrast: number): void;
     /**
-     * シェーダ上で作用する HSV を設定する
-     * @param hsv - 変換に用いる係数を Vector3 で表したもの
+     * シェーダ上で作用する HSV カラーシフト（Hue, Saturation, Value）を設定する
+     * @param hsv - 色相・彩度・明度の変調ベクトル（x: Hue, y: Saturation, z: Value）
      */
     setHSVColor(hsv: iVectorLike): void;
     /**
-     * シェーダ上で作用する RGB を設定する
-     * @param rgb - 変換に用いる係数を Vector3 で表したもの（rgb-R, rgb-G, rgb-B）
+     * シェーダ上で作用する RGB カラー倍数を設定する
+     * @param rgb - 赤・緑・青の乗算カラーベクトル（x: Red, y: Green, z: Blue）
      */
     setColorRGB(rgb: iVectorLike): void;
     /**
-     * シェーダ上で作用する blur を設定する
-     * @param blur - スプラット内で色をぼかす係数（適切な範囲はおよそ 0.0 ～ 1.0）
-     */
-    setColorBlur(blur: number): void;
-    /**
-     * シェーダ上で作用する sharpness を設定する
-     * @param sharpness - スプラット内で色を強調する係数（適切な範囲はおよそ 0.0 ～ 1.0）
+     * クリッピング（領域切り取り）機能の有効・無効を設定する
+     * @param enabled - クリッピングを有効にするかどうか
      */
-    setColorSharpness(sharpness: number): void;
+    setClippingEnabled(enabled: boolean): void;
     /**
-     * スプラットをスフィアの形状でクリッピングするためのパラメータを設定する
-     * @param position - 位置
-     * @param scale - スケール
+     * クリッピング球のワールド空間における位置とスケールを設定する
+     * @param position - クリッピング球の位置ベクトル
+     * @param scale - クリッピング球のスケールベクトル
      */
     setClippingSphere(position: iVectorLike, scale: iVectorLike): void;
     /**
-     * クリッピングによって範囲外となったスプラットの点の大きさ
-     * @param size - 点の大きさ
+     * クリッピング領域外のスプラット描画サイズを設定する
+     * @param size - 領域外スプラットのポイントサイズ
      */
     setOutsideClipPointSize(size: number): void;
     /**
-     * クリッピングによって範囲外となったスプラットの透明度を設定する
-     * @param opacity - 設定する係数（もとのアルファに乗算される値）
+     * クリッピング領域外のスプラット不透明度（アルファ）を設定する
+     * @param opacity - 領域外スプラットの不透明度（0.0 ～ 1.0）
      */
     setOutsideClipOpacity(opacity: number): void;
+    private activeAnimations;
+    private animationMaxRenderDistance;
+    private animationMainDistance;
+    private animationRemainingDistance;
+    private animationSplitPoint;
+    private _updateAnimation;
+    private _mapProgressToDistance;
     /**
-     * ==========================================================================
-     * animation
-     * ==========================================================================
+     * 距離に応じたスプラットの大きさにおける最小値を設定する
+     * @param value - 設定する係数（0.0 to 1.0）
      */
+    setEffectMinimumScale(value: number): void;
     /**
-     * アニメーションがアクティブかどうかを返す
-     * @returns アニメーションがアクティブかどうか
+     * 距離に応じたスプラットの大きさ係数を設定する
+     * @param value - 設定する係数（0.0 ～ 1.0）
      */
-    isAnimating(): boolean;
+    setEffectDistanceBase(value: number): void;
+    /**
+     * 距離に応じたスプラットの範囲係数を設定する
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectDistanceRange(value: number): void;
+    /**
+     * シェーダーで使用するワールド原点を設定する
+     * @param x - X座標
+     * @param y - Y座標
+     * @param z - Z座標
+     */
+    setWorldOrigin(x: number, y: number, z: number): void;
+    /**
+     * 点描画用の Points に対して距離に応じたエフェクトの範囲係数を設定する（外側）
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectDistancePoints(value: number): void;
+    /**
+     * 点描画用の Points に対して距離に応じたエフェクトの範囲係数を設定する (内側)
+     * @param value - 設定する係数（0.0 ～ 1.0）
+     */
+    setEffectDistanceNearPoints(value: number): void;
+    /**
+     * ソナーエフェクトを設定する（外側）
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectSonar(value: number): void;
+    /**
+     * ソナーエフェクトの範囲を設定する
+     * @param value - 設定する係数（0.0 ～ 1.0）
+     */
+    setEffectSonarRange(value: number): void;
     /**
      * 点描画の開花効果をアニメーションする
      * @param duration - アニメーションの継続時間（ミリ秒）
      */
-    startBloomPoints(duration: number): void;
+    startBloomPoints(duration?: number): void;
     /**
      * 点描画からスプラットへの溶解効果をアニメーションする
      * @param duration - アニメーションの継続時間（ミリ秒）
      * @param backgroundFadeInDelay - 溶解開始から fadeInBackground を開始するまでの遅延（ミリ秒）
      * @param backgroundFadeInDuration - fadeInBackground の継続時間（ミリ秒）
      */
-    startDissolveToGaussian(duration: number, backgroundFadeInDelay?: number, backgroundFadeInDuration?: number): void;
+    startDissolveToGaussian(duration?: number, backgroundFadeInDelay?: number, backgroundFadeInDuration?: number): void;
     /**
-     * 背景の不透明度を0から1.0へアニメーションする
+     * ソナー波効果をアニメーションする
      * @param duration - アニメーションの継続時間（ミリ秒）
      */
-    startFadeInBackground(duration: number): void;
+    startSonarWave(duration?: number): void;
     /**
-     * 背景の不透明度を1.0から0へアニメーションする
+     * カメラパスをアニメーションする
+     * @param name - カメラパスの名前
      * @param duration - アニメーションの継続時間（ミリ秒）
      */
-    startFadeOutBackground(duration: number): void;
+    animatePath(name?: string, duration?: number): void;
     /**
-     * ソナー波効果をアニメーションする
+     * 背景の不透明度を0から1.0へアニメーションする
      * @param duration - アニメーションの継続時間（ミリ秒）
+     * @param startDelay - 開始までの遅延（ミリ秒、デフォルト0）
      */
-    startSonarWave(duration: number): void;
+    startFadeInBackground(duration?: number, startDelay?: number): void;
     /**
-     * カメラパスをアニメーションする
-     * @param name - カメラパスの名前
+     * 背景の不透明度を1.0から0へアニメーションする
      * @param duration - アニメーションの継続時間（ミリ秒）
      */
-    animatePath(name: string, duration: number): void;
+    startFadeOutBackground(duration?: number): void;
     /**
-     * アニメーション用の距離情報を設定する
-     * @param mainDistance - メインの範囲の距離（実際の距離値、distance50やdistance70など、nullの場合は距離マッピングを無効化）
-     * @param remainingDistance - 残りの範囲の距離（実際の距離値、effectDistanceMaxと同じ、通常はdistance100、nullの場合は距離マッピングを無効化）
-     * @param splitPoint - 分割点（0.0～1.0、デフォルト0.8。progressがこの値まででmainDistance、それ以降でremainingDistanceまで）
-     * @note mainDistanceまたはremainingDistanceがnullの場合、距離マッピングは無効化され、progressがそのまま使用されます
-     * @deprecated setAnimationConfig を使用してください
+     * 名前で指定したスプラットメッシュの選択領域に対してローカルトランスフォームを累積適用する
+     * @param name - 対象メッシュ名
+     * @param translation - 平行移動ベクトル
+     * @param rotation - 回転オイラー角
+     * @param scale - スケールベクトル
      */
-    setDistanceInfoForAnimation(mainDistance: number | null, remainingDistance: number | null, splitPoint?: number): void;
+    applyLocalTransformToSelected(name: string, translation: iVectorLike, rotation: iVectorLike, scale: iVectorLike): void;
     /**
-     * アニメーションの最大描画距離を取得する
-     * @returns 最大描画距離（0.0～1.0）
-     * @deprecated getAnimationConfig を使用してください
+     * 名前で指定したスプラットメッシュの選択中のローカルトランスフォームをリセットする
+     * @param name - 対象メッシュ名
      */
-    getMaxRenderDistanceForAnimation(): number;
+    resetLocalTransformOfSelected(name: string): void;
     /**
-     * アニメーションの最大描画距離を設定する
-     * progressが1.0に達したときにこの値がゴールとなる
-     * @param value - 最大描画距離（0.0～1.0）
-     * @deprecated setAnimationConfig を使用してください
+     * 名前で指定したスプラットメッシュのすべてのローカルトランスフォームを初期化・リセットする
+     * @param name - 対象メッシュ名
      */
-    setMaxRenderDistanceForAnimation(value: number): void;
+    resetAllLocalTransforms(name: string): void;
     /**
-     * アニメーション設定を一括で取得する
-     * @returns 現在のアニメーション設定
+     * ローカルトランスフォームのためのギズモをセットアップする
      */
-    getAnimationConfig(): iAnimationConfig;
+    private setupLocalTransformGizmo;
     /**
-     * アニメーション設定を一括で設定する
-     * @param config - アニメーション設定オブジェクト
-     * @example
-     * // 最大描画距離のみ設定
-     * tvv.setAnimationConfig({ maxRenderDistance: 0.5 });
-     *
-     * // 距離マッピングと最大描画距離を設定
-     * tvv.setAnimationConfig({
-     *   maxRenderDistance: 0.5,
-     *   mainDistance: 50,
-     *   remainingDistance: 100,
-     *   splitPoint: 0.8
-     * });
+     * ローカルトランスフォーム操作用ギズモの有効/無効を設定する
+     * @param enabled - 有効にするかどうか
      */
-    setAnimationConfig(config: iAnimationConfig): void;
+    setLocalTransformGizmoEnabled(enabled: boolean): void;
     /**
-     * ==========================================================================
-     * collision
-     * ==========================================================================
+     * ローカルトランスフォーム操作用ギズモの操作モードを設定する
+     * @param mode - 操作モード ("translate" | "rotate" | "scale")
      */
+    setLocalTransformGizmoMode(mode: "translate" | "rotate" | "scale"): void;
     /**
-     * セレクターから球の衝突判定を生成する
-     * @private
-     * @param selector - 対象となるセレクター
+     * 選択中のスプラット情報に基づいてローカル変換ギズモの位置・姿勢を自動更新する
      */
-    private _createCollisionSphereFromSelector;
+    updateLocalTransformGizmo(): void;
     /**
-     * セレクターから箱の衝突判定を生成する
-     * @private
-     * @param selector - 対象となるセレクター
+     * ギズモのダミーオブジェクトのトランスフォームを、選択中のスプラットに一括同期反映する
      */
-    private _createCollisionBoxFromSelector;
+    private syncLocalTransformFromGizmo;
     /**
-     * 衝突判定を設定する
-     * @param collision - 設定する衝突判定、またはその配列
+     * OrbitControlsの注視点カーソルを、注視点変更時に自動表示するかどうかを設定する
+     * @param enabled - 有効にするかどうか
      */
-    setCollision(collision: iCollisionTarget | iCollisionTarget[]): void;
+    setOrbitCursorAutoDisplay(enabled: boolean): void;
     /**
-     * 現在の衝突判定を解除する
+     * 注視点変更時のオービットカーソル自動表示が有効かどうかを取得する
+     * @returns 有効かどうか
      */
-    resetCollision(): void;
+    isOrbitCursorAutoDisplayEnabled(): boolean;
     /**
-     * 現在選択しているスプラットを削除状態とする
+     * オービットカーソルの常時表示が有効かどうかを取得する
+     * @returns 有効かどうか
      */
-    deleteSelectedGaussian(): void;
+    isOrbitCursorDisplay(): boolean;
     /**
-     * 削除状態を一世代前に戻す
+     * OrbitControlsの注視点カーソルを常に表示するかどうかを設定する
+     * @param enabled - 有効にするかどうか
      */
-    undoDeletedGaussian(): void;
+    setOrbitCursorDisplay(enabled: boolean): void;
     /**
-     * すべての削除状態をリセットする
+     * OrbitControlsの注視点カーソルのスケールを設定する
+     * @param scale - スケール
      */
-    resetDeletedGaussian(): void;
+    setOrbitCursorScale(scale: number): void;
+    /**
+     * デバッグ用座標軸（AxesHelper）の表示・非表示を設定する
+     * @param visible - 表示するかどうか
+     */
+    setAxisVisible(visible: boolean): void;
+    /**
+     * デバッグ用座標軸（AxesHelper）が表示されているかどうかを取得する
+     * @returns 表示されているかどうか
+     */
+    isAxisVisible(): boolean;
+    /**
+     * 3D Orbit Cursor の表示・位置追従を更新する
+     */
+    private _updateOrbitCursor;
+    /**
+     * 全メッシュの Gaussian スプラットマテリアルに Uniforms を一括設定する
+     * @param uniforms - 設定する Uniforms オブジェクト
+     */
+    setUniforms(uniforms: Record<string, tUniformValue>): void;
+    /**
+     * 全メッシュの Points（点描画）マテリアルに Uniforms を一括設定する
+     * @param uniforms - 設定する Uniforms オブジェクト
+     */
+    setPointUniforms(uniforms: Record<string, tUniformValue>): void;
+    private selectorMap;
+    private reversedCollision;
     /**
      * セレクターによる衝突判定の反転フラグを設定する
      * @param reversed - 設定する反転属性
      */
     setCollisionReversed(reversed: boolean): void;
     /**
-     * 名前を指定してセレクターで衝突判定を行う
-     * @param name - 対象となるセレクターの名前
+     * 現在選択しているスプラットを削除状態とする
      */
-    checkCollisionBySelector(name: string): void;
+    deleteSelectedGaussian(): void;
     /**
-     * 名前を複数（配列で）指定して対象のセレクターで衝突判定を行う
-     * @param names - 対象となるセレクターの名前の配列
+     * 削除状態を一世代前に戻す
      */
-    checkCollisionBySelectors(names: string[]): void;
+    undoDeletedGaussian(): void;
     /**
-     * 現在追加されているすべてのセレクターで衝突判定を行う
+     * すべての削除状態をリセットする
      */
-    checkCollisionByAllSelectors(): void;
+    resetDeletedGaussian(): void;
+    /**
+     * 現在の衝突判定を解除する
+     */
+    resetCollision(): void;
+    /**
+     * 衝突判定を設定する
+     * @param collision - 設定する衝突判定、またはその配列
+     * @param mode - 選択モード（SELECTION_MODE）
+     */
+    setCollision(collision: iCollisionTarget | iCollisionTarget[], mode?: tSelectionMode): void;
     /**
      * 球の衝突判定パラメータ（Worker に渡すフォーマット）を生成する
      * @param radius - 半径
@@ -1370,7 +1294,7 @@ export declare class Core extends EventEmitter {
      * @param inverseMatrix - ワールド変換の逆行列
      * @param reversed - 判定の反転（球に内包されている状態を規定とし、それを反転するかどうか）
      */
-    createCollisionSphere(radius: number, position: iVectorLike, scale: iVectorLike, inverseMatrix: Matrix4, reversed?: boolean): iCollisionTarget;
+    private createCollisionSphere;
     /**
      * 箱の衝突判定パラメータ（Worker に渡すフォーマット）を生成する
      * @param width - 一辺の幅
@@ -1381,20 +1305,48 @@ export declare class Core extends EventEmitter {
      * @param inverseMatrix - ワールド変換の逆行列
      * @param reversed - 判定の反転（球に内包されている状態を規定とし、それを反転するかどうか）
      */
-    createCollisionBox(width: number, height: number, depth: number, position: iVectorLike, scale: iVectorLike, inverseMatrix: Matrix4, reversed?: boolean): iCollisionTarget;
+    private createCollisionBox;
+    /**
+     * 単一セレクターから Worker 用の CollisionTarget を生成するヘルパー
+     * @param selector - 対象のセレクター名
+     * @param reversed - 反転フラグ
+     */
+    private getCollisionTargetFromSelector;
+    /**
+     * 名前を指定してセレクターで衝突判定を行う
+     * @param name - 対象となるセレクターの名前
+     * @param mode - 選択モード（SELECTION_MODE）
+     */
+    checkCollisionBySelector(name: string, mode?: tSelectionMode): void;
+    /**
+     * 名前を複数（配列で）指定して対象のセレクターで衝突判定を行う
+     * @param names - 対象となるセレクターの名前の配列
+     * @param mode - 選択モード（SELECTION_MODE）
+     */
+    checkCollisionBySelectors(names: string[], mode?: tSelectionMode): void;
+    /**
+     * 現在追加されているすべてのセレクターで衝突判定を行う
+     * @param mode - 選択モード（SELECTION_MODE）
+     */
+    checkCollisionByAllSelectors(mode?: tSelectionMode): void;
     /**
      * ==========================================================================
      * selector
      * ==========================================================================
      */
+    /**
+     * 単一セレクターの諸情報を取得するヘルパー
+     * @param name - 対象のセレクター名
+     */
+    private getSelectorInfo;
     /**
      * すべての生成済みセレクターの諸情報を返す
      */
     getAllSelectorInfo(): iSelectorInfo[];
     /**
      * 名前を指定してセレクターの可視性を設定する
-     * @param name - 設定するセレクターの名前
-     * @param visible - 設定する可視性
+     * @param name - 対象セレクター名
+     * @param visible - 可視性
      */
     setSelectorVisible(name: string, visible: boolean): void;
     /**
@@ -1447,38 +1399,4 @@ export declare class Core extends EventEmitter {
      * @param option - セレクターに対するオプション
      */
     addBoxSelector(name: string, option?: iBoxSelectorOption): void;
-    /**
-     * OrbitControlsの注視点カーソルを、注視点変更時に自動表示するかどうかを設定する
-     * @param enabled - 有効にするかどうか
-     */
-    setOrbitCursorAutoDisplay(enabled: boolean): void;
-    /**
-     * 注視点変更時のオービットカーソル自動表示が有効かどうかを取得する
-     * @returns 有効かどうか
-     */
-    isOrbitCursorAutoDisplayEnabled(): boolean;
-    /**
-     * OrbitControlsの注視点カーソルを常に表示するかどうかを設定する
-     * @param enabled - 有効にするかどうか
-     */
-    setOrbitCursorDisplay(enabled: boolean): void;
-    /**
-     * オービットカーソルの常時表示が有効かどうかを取得する
-     * @returns 有効かどうか
-     */
-    isOrbitCursorDisplay(): boolean;
-    /**
-     * @deprecated setOrbitCursorAutoDisplay を使用してください
-     */
-    enableOrbitCursor(enabled: boolean): void;
-    /**
-     * @deprecated isOrbitCursorAutoDisplayEnabled を使用してください
-     */
-    isOrbitCursorEnabled(): boolean;
-    /**
-     * OrbitControlsの注視点カーソルのスケールを設定する
-     * @param scale - 設定するスケール値
-     */
-    setOrbitCursorScale(scale: number): void;
 }
-export {};