@webxr-jp/avatar-optimizer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xrift
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# @webxr-jp/avatar-optimizer
+
+3D model optimization library for WebXR applications.
+
+## Features
+
+- VRM model loading and export
+- Texture atlas generation for material consolidation
+- Mesh simplification using meshoptimizer
+- KTX2 texture compression support
+- VRM0 to VRM1 skeleton migration utilities
+
+## Installation
+
+```bash
+npm install @webxr-jp/avatar-optimizer
+```
+
+### Peer Dependencies
+
+```bash
+npm install @gltf-transform/core @gltf-transform/extensions @pixiv/three-vrm @pixiv/three-vrm-materials-mtoon three
+```
+
+## Usage
+
+### Basic Optimization
+
+```typescript
+import { loadVRM, optimizeModel, exportVRM } from '@webxr-jp/avatar-optimizer'
+
+// Load VRM file
+const vrmResult = await loadVRM(file)
+if (vrmResult.isErr()) {
+  console.error(vrmResult.error)
+  return
+}
+const vrm = vrmResult.value
+
+// Optimize model
+const optimizedResult = await optimizeModel(vrm, {
+  atlas: {
+    resolution: { base: 2048, blend: 1024 },
+  },
+})
+if (optimizedResult.isErr()) {
+  console.error(optimizedResult.error)
+  return
+}
+const optimizedVrm = optimizedResult.value
+
+// Export VRM
+const exportResult = await exportVRM(optimizedVrm)
+if (exportResult.isErr()) {
+  console.error(exportResult.error)
+  return
+}
+const blob = new Blob([exportResult.value], { type: 'model/gltf-binary' })
+```
+
+### With Texture Compression
+
+```typescript
+import { exportVRM, UastcQuality } from '@webxr-jp/avatar-optimizer'
+
+const exportResult = await exportVRM(vrm, {
+  textureCompression: {
+    quality: UastcQuality.Default,
+    supercompression: true,
+  },
+})
+```
+
+### Mesh Simplification
+
+```typescript
+import { simplifyMeshes } from '@webxr-jp/avatar-optimizer'
+
+const result = await simplifyMeshes(vrm, {
+  targetRatio: 0.5,
+  targetError: 0.01,
+})
+```
+
+## API
+
+### Main Functions
+
+| Function                       | Description                             |
+| ------------------------------ | --------------------------------------- |
+| `loadVRM(source)`              | Load VRM from File, URL, or ArrayBuffer |
+| `optimizeModel(vrm, options)`  | Apply optimization pipeline             |
+| `exportVRM(vrm, options?)`     | Export VRM to GLB binary                |
+| `simplifyMeshes(vrm, options)` | Reduce polygon count                    |
+
+### Types
+
+- `OptimizationOptions` - Configuration for optimization pipeline
+- `ExportVRMOptions` - Export settings including texture compression
+- `SimplifyOptions` - Mesh simplification parameters
+- `TextureCompressionOptions` - KTX2 compression settings
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,582 @@
+import { VRM, MToonMaterial } from '@pixiv/three-vrm';
+import { ResultAsync, Result } from 'neverthrow';
+import { UastcQuality } from '@webxr-jp/texture-compression';
+export { UastcQuality } from '@webxr-jp/texture-compression';
+import { Vector2, Object3D, Mesh, Matrix3, Bone, Vector3 } from 'three';
+import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { MToonAtlasMaterial } from '@webxr-jp/mtoon-atlas';
+
+interface OptimizationOptions {
+    compressTextures: boolean;
+    maxTextureSize: number;
+    reduceMeshes: boolean;
+    targetPolygonCount?: number;
+}
+/**
+ * メッシュ簡略化オプション
+ */
+interface SimplifyOptions {
+    /**
+     * 目標頂点削減率 (0.0-1.0)
+     * 例: 0.5 = 頂点数を50%に削減
+     * @default 0.5
+     */
+    targetRatio?: number;
+    /**
+     * 目標エラー値（0.0-1.0）
+     * 簡略化による形状変化の許容度
+     * @default 0.01
+     */
+    targetError?: number;
+    /**
+     * 境界頂点をロックするか
+     * trueの場合、メッシュの端にある頂点は移動・削除されない
+     * @default true
+     */
+    lockBorder?: boolean;
+    /**
+     * UV属性の重み（0.0-1.0）
+     * 高い値ほどテクスチャ座標の保護を優先
+     * @default 1.0
+     */
+    uvWeight?: number;
+    /**
+     * 法線属性の重み（0.0-1.0）
+     * 高い値ほどシェーディングの滑らかさを優先
+     * @default 0.5
+     */
+    normalWeight?: number;
+    /**
+     * MorphTargetを持つメッシュの処理方法
+     * - 'skip': 簡略化をスキップ
+     * - 'discard': MorphTargetを破棄して簡略化
+     * @default 'skip'
+     */
+    morphTargetHandling?: 'skip' | 'discard';
+}
+/**
+ * optimizeModel 関数のオプション
+ */
+interface OptimizeModelOptions {
+    /**
+     * VRM0.xからVRM1.0へのスケルトンマイグレーションを行う
+     * Y軸周り180度回転を適用してモデルの向きを+Z前向きに変更
+     */
+    migrateVRM0ToVRM1?: boolean;
+    /**
+     * アトラス生成オプション
+     * スロットごとの解像度指定などを行う
+     */
+    atlas?: AtlasGenerationOptions;
+    /**
+     * メッシュ簡略化オプション
+     * 設定された場合、excludedMeshes以外のメッシュを簡略化
+     */
+    simplify?: SimplifyOptions;
+}
+/**
+ * three-vrm / GLTFLoader で読み込んだ VRM ドキュメント
+ */
+interface ThreeVRMDocument {
+    gltf: GLTF;
+    vrm: VRM;
+}
+/**
+ * テクスチャスロットの情報
+ * マテリアルごとにどのテクスチャがどのスロットで使用されているかを記録
+ */
+interface TextureSlotInfo {
+    slot: 'baseColor';
+    /** 当該スロットで使用されているテクスチャのリスト */
+    textures: Array<{
+        name: string;
+        width: number;
+        height: number;
+        mimeType: string;
+        materials: string[];
+    }>;
+    /** テクスチャを使用しているマテリアル数（重複なし） */
+    materialCount: number;
+    /** 総テクスチャバイト数 */
+    totalBytes: number;
+}
+/**
+ * テクスチャスロット名の型
+ */
+declare const MTOON_TEXTURE_SLOTS: readonly ["map", "normalMap", "emissiveMap", "shadeMultiplyTexture", "shadingShiftTexture", "matcapTexture", "rimMultiplyTexture", "outlineWidthMultiplyTexture", "uvAnimationMaskTexture"];
+type MToonTextureSlot = (typeof MTOON_TEXTURE_SLOTS)[number];
+/**
+ * アトラス化対象となる1枚のテクスチャ
+ */
+interface AtlasTextureDescriptor {
+    /** 画像の幅（ピクセル） */
+    width: number;
+    /** 画像の高さ（ピクセル） */
+    height: number;
+}
+/**
+ * 主にUVで使用するオフセットとスケール情報
+ */
+interface OffsetScale {
+    offset: Vector2;
+    scale: Vector2;
+}
+/**
+ * スロットごとのアトラス解像度設定
+ * 指定されていないスロットはデフォルト値（2048）を使用
+ */
+type SlotAtlasResolution = Partial<Record<MToonTextureSlot, number>>;
+/**
+ * アトラス生成オプション
+ */
+interface AtlasGenerationOptions {
+    /**
+     * デフォルトのアトラス解像度（各辺のピクセル数）
+     * @default 2048
+     */
+    defaultResolution?: number;
+    /**
+     * スロットごとの解像度オーバーライド
+     * 例: { map: 2048, normalMap: 1024, emissiveMap: 512 }
+     */
+    slotResolutions?: SlotAtlasResolution;
+}
+/**
+ * エラー型 (全体)
+ */
+type OptimizationError = {
+    type: 'ASSET_ERROR';
+    message: string;
+} | {
+    type: 'INVALID_OPERATION';
+    message: string;
+} | {
+    type: 'INVALID_PARAMETER';
+    message: string;
+} | {
+    type: 'INTERNAL_ERROR';
+    message: string;
+} | {
+    type: 'NO_MATERIALS_FOUND';
+    message: string;
+} | {
+    type: 'PARAMETER_TEXTURE_FAILED';
+    message: string;
+};
+/**
+ * VRM ロード時のエラー型
+ */
+type VRMLoaderError = {
+    type: 'VRM_LOAD_FAILED';
+    message: string;
+} | {
+    type: 'INVALID_VRM';
+    message: string;
+};
+/**
+ * テクスチャ圧縮オプション
+ * エクスポート時にアトラステクスチャを KTX2 形式で圧縮する
+ */
+interface TextureCompressionOptions {
+    /**
+     * UASTC 品質レベル (0-4)
+     * @default 2 (Default)
+     */
+    quality?: UastcQuality;
+    /**
+     * 圧縮レベル (0-5)
+     * @default 3
+     */
+    compressionLevel?: number;
+    /**
+     * ミップマップを生成するか
+     * @default false
+     */
+    generateMipmaps?: boolean;
+    /**
+     * Zstandard 超圧縮を使用するか
+     * @default true
+     */
+    supercompression?: boolean;
+}
+/**
+ * VRM エクスポート時のオプション
+ */
+interface ExportVRMOptions {
+    /**
+     * バイナリ形式 (.vrm) で出力するか
+     * @default true
+     */
+    binary?: boolean;
+    /**
+     * テクスチャ圧縮オプション
+     * 指定された場合、アトラステクスチャを KTX2 形式で圧縮
+     */
+    textureCompression?: TextureCompressionOptions;
+}
+/**
+ * VRM エクスポート時のエラー型
+ */
+type ExportVRMError = {
+    type: 'EXPORT_FAILED';
+    message: string;
+} | {
+    type: 'INVALID_VRM';
+    message: string;
+};
+
+/**
+ * VRM モデルのメッシュ簡略化処理
+ *
+ * excludedMeshes（表情メッシュ）を除外し、
+ * 残りのメッシュに対してmeshoptimizerによる頂点削減を適用
+ */
+
+/**
+ * 簡略化結果の統計情報
+ */
+interface SimplifyStatistics {
+    /** 処理したメッシュ数 */
+    processedMeshCount: number;
+    /** スキップしたメッシュ数（表情メッシュ、MorphTarget持ち等） */
+    skippedMeshCount: number;
+    /** 削減前の総頂点数 */
+    originalVertexCount: number;
+    /** 削減後の総頂点数 */
+    simplifiedVertexCount: number;
+    /** 削減前の総インデックス数 */
+    originalIndexCount: number;
+    /** 削減後の総インデックス数 */
+    simplifiedIndexCount: number;
+    /** 頂点削減率 */
+    vertexReductionRatio: number;
+    /** インデックス削減率 */
+    indexReductionRatio: number;
+}
+/**
+ * ルートノード配下のメッシュを簡略化
+ *
+ * @param rootNode - 処理対象のルートノード
+ * @param excludedMeshes - 簡略化から除外するメッシュのSet
+ * @param options - 簡略化オプション
+ * @returns 簡略化統計情報
+ */
+declare function simplifyMeshes(rootNode: Object3D, excludedMeshes: Set<Mesh>, options?: SimplifyOptions): ResultAsync<SimplifyStatistics, OptimizationError>;
+
+/**
+ * Core type definitions for TexTransCoreTS
+ * テクスチャアトラス化とモデル編集に必要な型を集約
+ */
+
+/**
+ * テクスチャパッキングの結果
+ */
+interface PackingLayouts {
+    /** パックされたテクスチャ情報 */
+    packed: OffsetScale[];
+}
+/**
+ * テクスチャ画像データ
+ */
+interface TextureImageData {
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+}
+/**
+ * スロットごとに生成されたアトラス画像
+ */
+interface SlotAtlasImage {
+    /** アトラス PNG などのバイナリバッファ */
+    atlasImage: Uint8Array;
+    /** アトラス幅 */
+    atlasWidth: number;
+    /** アトラス高さ */
+    atlasHeight: number;
+}
+/**
+ * マテリアル単位で適用する UV 変換行列
+ * 3x3 行列を一次元配列で保持 (列優先/行優先は利用側と合意)
+ */
+interface MaterialPlacement {
+    /** 3x3 変換行列（9 要素） */
+    uvTransform: Matrix3;
+}
+/**
+ * アトラス生成結果（ドキュメント非依存のメタデータのみ）
+ */
+interface AtlasBuildResult {
+    /** スロットごとに生成されたアトラス画像 */
+    atlases: SlotAtlasImage[];
+    /** 各マテリアルに適用する UV 変換行列 */
+    placements: MaterialPlacement[];
+}
+/**
+ * UV座標マッピング情報
+ */
+interface UVMapping {
+    /** プリミティティブのインデックス */
+    primitiveIndex: number;
+    /** マテリアルのテクスチャスロット */
+    textureSlot: string;
+    /** オリジナルのテクスチャインデックス */
+    originalTextureIndex: number;
+    /** アトラス内のノーマライズされたUV座標（min） */
+    uvMin: {
+        u: number;
+        v: number;
+    };
+    /** アトラス内のノーマライズされたUV座標（max） */
+    uvMax: {
+        u: number;
+        v: number;
+    };
+}
+/**
+ * テクスチャアトラス化の結果
+ */
+interface AtlasResult {
+    /** アトラス化されたドキュメント */
+    document: Document;
+    /** UV座標マッピング情報 */
+    mapping: UVMapping[];
+    /** アトラス画像のメタデータ */
+    atlasMetadata: {
+        width: number;
+        height: number;
+        textureCount: number;
+        packingEfficiency: number;
+    };
+}
+/**
+ * レンダーモード（透過分離用）
+ * - opaque: 不透明（transparent === false && alphaTest === 0）
+ * - alphaTest: MASKモード（alphaTest > 0）
+ * - transparent: 半透明（transparent === true）
+ */
+type RenderMode = 'opaque' | 'alphaTest' | 'transparent';
+/**
+ * メッシュグループ（レンダーモードごとの結合結果）
+ * meshがnullの場合はexcludedMeshes専用グループ（結合メッシュなし、マテリアルのみ）
+ */
+interface MeshGroup {
+    /** 結合されたメッシュ（excludedMeshesのみの場合はnull） */
+    mesh: Mesh | null;
+    /** 使用されたMToonAtlasMaterial */
+    material: MToonAtlasMaterial;
+    /** アウトライン用メッシュ */
+    outlineMesh?: Mesh;
+    /** アウトライン用MToonAtlasMaterial */
+    outlineMaterial?: MToonAtlasMaterial;
+}
+/**
+ * マテリアルスロット情報
+ */
+interface MaterialSlotInfo {
+    /** レンダーモード */
+    renderMode: RenderMode;
+    /** グループ内でのスロットインデックス */
+    slotIndex: number;
+}
+/**
+ * マテリアル結合の結果
+ */
+interface CombinedMeshResult {
+    /** レンダーモードごとのメッシュグループ */
+    groups: Map<RenderMode, MeshGroup>;
+    /** マテリアルからスロット情報へのマッピング */
+    materialSlotIndex: Map<MToonMaterial, MaterialSlotInfo>;
+    /** 統計情報 */
+    statistics: {
+        /** 元のメッシュ数 */
+        originalMeshCount: number;
+        /** 元のマテリアル数（重複排除後） */
+        originalMaterialCount: number;
+        /** 削減されたドローコール数 */
+        reducedDrawCalls: number;
+        /** メッシュ簡略化の統計（簡略化を実行した場合のみ） */
+        simplify?: SimplifyStatistics;
+    };
+}
+
+/**
+ * 受け取ったThree.jsオブジェクトのツリーのメッシュ及びそのマテリアルを走査し、
+ * Three.jsの複数MToonNodeMaterialをチャンネルごとにテクスチャパッキング
+ * アトラス化したテクスチャを各マテリアルに設定する
+ * 対応するメッシュのUVをパッキング結果に基づき修正する
+ * 最後にマテリアルを統合してドローコール数を削減する
+ *
+ * @param vrm - 最適化対象のVRMオブジェクト
+ * @param options - 最適化オプション
+ * @returns 最適化結果（統合メッシュ情報を含む）
+ */
+declare function optimizeModel(vrm: VRM, options?: OptimizeModelOptions): ResultAsync<CombinedMeshResult, OptimizationError>;
+
+/**
+ * VRM エクスポート機能
+ * VRM を Uint8Array (バイナリ) としてエクスポートする
+ */
+
+/**
+ * VRM をバイナリとしてエクスポートする
+ *
+ * @param vrm - エクスポート対象の VRM
+ * @param options - エクスポートオプション
+ * @returns ArrayBuffer (バイナリデータ) またはエラー
+ *
+ * @example
+ * ```typescript
+ * const result = await exportVRM(vrm)
+ *
+ * if (result.isOk()) {
+ *   // ブラウザでダウンロード
+ *   const blob = new Blob([result.value], { type: 'application/octet-stream' })
+ *   const url = URL.createObjectURL(blob)
+ *   // ...
+ *
+ *   // Node.js でファイル書き出し
+ *   fs.writeFileSync('output.vrm', Buffer.from(result.value))
+ * }
+ * ```
+ */
+declare function exportVRM(vrm: VRM, options?: ExportVRMOptions): ResultAsync<ArrayBuffer, ExportVRMError>;
+
+/**
+ * VRM ロード機能
+ * URL / File / Blob / ArrayBuffer から VRM を読み込む
+ */
+
+/**
+ * VRM ソースの型
+ * URL文字列、File、Blob、ArrayBuffer を受け付ける
+ */
+type VRMSource = string | File | Blob | ArrayBuffer;
+/**
+ * VRM を読み込む
+ *
+ * @param source - VRM ソース (URL文字列 / File / Blob / ArrayBuffer)
+ * @returns VRM オブジェクトまたはエラー
+ *
+ * @example
+ * ```typescript
+ * // URL から読み込み
+ * const result = await loadVRM('/path/to/model.vrm')
+ *
+ * // File から読み込み
+ * const result = await loadVRM(file)
+ *
+ * // ArrayBuffer から読み込み
+ * const result = await loadVRM(arrayBuffer)
+ * ```
+ */
+declare function loadVRM(source: VRMSource): ResultAsync<VRM, VRMLoaderError>;
+
+declare class VRMExporterPlugin {
+    readonly name = "VRMC_vrm";
+    private writer;
+    private vrm;
+    private createdTailNodes;
+    constructor(writer: any);
+    setVRM(vrm: VRM): void;
+    beforeParse(input: Object3D | Object3D[]): void;
+    /**
+     * SpringBone末端ジョイントに仮想tailノードを作成
+     * three-vrmと同様に、ボーン方向に7cmのオフセットを持つ仮想ノードを追加
+     */
+    private createVirtualTailNodes;
+    /**
+     * エクスポート後に作成した仮想tailノードをクリーンアップ
+     */
+    cleanupTailNodes(): void;
+    afterParse(_input: any): void;
+    private exportMeta;
+    private exportHumanoid;
+    private exportExpressions;
+    private exportLookAt;
+    private exportFirstPerson;
+    /**
+     * VRMC_springBone 拡張をエクスポート
+     * three-vrm の VRMSpringBoneManager から SpringBone データを抽出
+     */
+    private exportSpringBone;
+}
+
+/**
+ * マイグレーションオプション
+ */
+interface MigrationOptions {
+    /** Humanoid Boneのセット（これらのボーンのみ回転をidentityにする） */
+    humanoidBones?: Set<Bone>;
+    /** 頂点回転をスキップ（デバッグ用） */
+    skipVertexRotation?: boolean;
+    /** ボーン位置回転をスキップ（デバッグ用） */
+    skipBoneTransform?: boolean;
+    /** bindMatrix更新をスキップ（デバッグ用） */
+    skipBindMatrix?: boolean;
+}
+/**
+ * VRM0.x形式のスケルトンをVRM1.0形式に変換
+ * Y軸周り180度回転を適用してモデルの向きを+Z前向きに変更
+ *
+ * 処理内容:
+ * 1. 全メッシュの頂点位置をY軸180度回転
+ * 2. 各ボーンのワールド座標を記録し、Y軸180度回転
+ * 3. Humanoid Boneのrotationをidentityにリセット（VRM1.0仕様）
+ *    - 非Humanoid Bone（髪、服など）は相対的な回転を保持
+ * 4. ルートからツリーを下りながらローカル位置を再計算
+ * 5. InverseBoneMatrix（boneInverses）を再計算
+ *
+ * @param rootNode - VRMモデルのルートノード（VRM.scene）
+ * @param options - マイグレーションオプション
+ * @returns 変換結果
+ */
+declare function migrateSkeletonVRM0ToVRM1(rootNode: Object3D, options?: MigrationOptions): Result<void, OptimizationError>;
+
+/**
+ * SpringBone末端ジョイントに仮想tailノードを作成
+ * VRM1.0仕様ではjointsの最後にtailノードが必要
+ * 事前に記録したボーン方向を使用して正しい向きに仮想ノードを追加
+ *
+ * @param vrm - VRMオブジェクト
+ * @param preRecordedDirections - recordSpringBoneDirectionsで記録した方向
+ * @returns 作成された仮想tailノードの配列（クリーンアップ用）
+ */
+declare function createVirtualTailNodes(vrm: VRM, preRecordedDirections?: Map<Bone, Vector3>): Bone[];
+/**
+ * SpringBoneの重力方向（gravityDir）をY軸180度回転
+ * VRM0→VRM1マイグレーション時に必要
+ *
+ * gravityDirはワールド座標系で指定されるため、
+ * モデルの向きがY軸180度回転した場合は重力方向も同様に回転する必要がある
+ *
+ * @param vrm - VRMオブジェクト
+ */
+declare function rotateSpringBoneGravityDirections(vrm: VRM): void;
+/**
+ * SpringBoneコライダーのオフセットをY軸180度回転
+ * VRM0→VRM1マイグレーション時に必要
+ *
+ * コライダーはHumanoid Bone（Head等）にアタッチされており、
+ * offset/tailはローカル座標系で定義されている。
+ * マイグレーション後、Humanoid Boneの回転はidentityになるが、
+ * ローカル座標系自体がY軸180度回転しているため、
+ * コライダーのオフセットも同様に回転する必要がある。
+ *
+ * @param vrm - VRMオブジェクト
+ */
+declare function rotateSpringBoneColliderOffsets(vrm: VRM): void;
+/**
+ * VRM0→VRM1マイグレーション後にSpringBone関連の調整を一括で実行
+ *
+ * 以下の処理を順番に実行:
+ * 1. 末端ジョイントに仮想tailノードを作成
+ * 2. 重力方向（gravityDir）をY軸180度回転
+ * 3. コライダーオフセットをY軸180度回転
+ * 4. SpringBoneの初期状態を再設定
+ *
+ * @param vrm - VRMオブジェクト
+ * @returns 作成された仮想tailノードの配列（クリーンアップ用）
+ */
+declare function migrateSpringBone(vrm: VRM): Bone[];
+
+export { type AtlasBuildResult, type AtlasGenerationOptions, type AtlasResult, type AtlasTextureDescriptor, type ExportVRMError, type ExportVRMOptions, type MaterialPlacement, type OptimizationError, type OptimizationOptions, type OptimizeModelOptions, type PackingLayouts as PackingResult, type SimplifyOptions, type SimplifyStatistics, type SlotAtlasImage, type SlotAtlasResolution, type TextureCompressionOptions, type TextureImageData, type TextureSlotInfo, type ThreeVRMDocument, type UVMapping, VRMExporterPlugin, type VRMLoaderError, type VRMSource, createVirtualTailNodes, exportVRM, loadVRM, migrateSkeletonVRM0ToVRM1, migrateSpringBone, optimizeModel, rotateSpringBoneColliderOffsets, rotateSpringBoneGravityDirections, simplifyMeshes };