@webxr-jp/texture-compression 0.1.0

package/README.md

@@ -0,0 +1,158 @@
+# @webxr-jp/texture-compression
+
+avatar-optimizer向けのテクスチャ圧縮ユーティリティパッケージ。Basis Universal WASMを使用してKTX2形式（UASTC）でテクスチャを圧縮します。
+
+## 特徴
+
+- **KTX2形式出力**: GPU対応の圧縮テクスチャフォーマット
+- **UASTC圧縮**: 高品質なユニバーサルテクスチャ圧縮
+- **Zstandard超圧縮**: オプションでさらなるファイルサイズ削減
+- **ブラウザ専用**: WebAssemblyベースで高速処理
+
+## インストール
+
+```bash
+pnpm add @webxr-jp/texture-compression
+```
+
+## 使用方法
+
+### 基本的な圧縮
+
+```typescript
+import { compressToKtx2, initBasisEncoder } from '@webxr-jp/texture-compression'
+
+// WASMモジュールを初期化（初回のみ）
+const initResult = await initBasisEncoder()
+if (initResult.isErr()) {
+  console.error('初期化エラー:', initResult.error)
+  return
+}
+
+// RGBAピクセルデータを圧縮
+const imageData = new Uint8Array(width * height * 4) // RGBA
+const result = await compressToKtx2(imageData, width, height)
+
+if (result.isOk()) {
+  const ktx2Data = result.value.data // Uint8Array
+  console.log(
+    `圧縮完了: ${result.value.originalSize} → ${result.value.compressedSize} bytes`,
+  )
+}
+```
+
+### オプション設定
+
+```typescript
+import { compressToKtx2, UastcQuality } from '@webxr-jp/texture-compression'
+
+const result = await compressToKtx2(imageData, width, height, {
+  quality: UastcQuality.Default, // 品質レベル (0-4)
+  compressionLevel: 3, // 圧縮レベル (0-5)
+  generateMipmaps: false, // ミップマップ生成
+  supercompression: true, // Zstandard超圧縮
+})
+```
+
+### Y軸反転
+
+WebGLテクスチャ座標系（左下原点）からKTX2座標系（左上原点）への変換が必要な場合：
+
+```typescript
+import { flipImageY, compressToKtx2 } from '@webxr-jp/texture-compression'
+
+const flippedData = flipImageY(imageData, width, height)
+const result = await compressToKtx2(flippedData, width, height)
+```
+
+### エンコーダー管理
+
+```typescript
+import {
+  initBasisEncoder,
+  disposeBasisEncoder,
+  isBasisEncoderReady,
+} from '@webxr-jp/texture-compression'
+
+// 初期化確認
+if (!isBasisEncoderReady()) {
+  await initBasisEncoder()
+}
+
+// 使用後にリソース解放（オプション）
+disposeBasisEncoder()
+```
+
+## API
+
+### `compressToKtx2(imageData, width, height, options?)`
+
+RGBAピクセルデータをKTX2形式に圧縮します。
+
+- `imageData`: `Uint8Array` - RGBAピクセルデータ（width × height × 4 bytes）
+- `width`: `number` - 画像の幅
+- `height`: `number` - 画像の高さ
+- `options`: `Ktx2CompressionOptions` - 圧縮オプション（省略可）
+
+戻り値: `ResultAsync<Ktx2CompressionResult, CompressionError>`
+
+### `flipImageY(imageData, width, height)`
+
+Y軸を反転したピクセルデータを生成します。
+
+### `initBasisEncoder(wasmDir?)`
+
+BasisEncoder WASMモジュールを初期化します。
+
+- `wasmDir`: `string` - WASMファイルのディレクトリURL（省略時はパッケージ内のwasmディレクトリ）
+
+### `disposeBasisEncoder()`
+
+キャッシュされたモジュールを解放します。
+
+### `isBasisEncoderReady()`
+
+WASMモジュールが初期化済みかどうかを返します。
+
+## 型定義
+
+### `Ktx2CompressionOptions`
+
+```typescript
+interface Ktx2CompressionOptions {
+  quality?: UastcQuality // UASTC品質レベル (デフォルト: Default)
+  compressionLevel?: number // 圧縮レベル 0-5 (デフォルト: 3)
+  generateMipmaps?: boolean // ミップマップ生成 (デフォルト: false)
+  supercompression?: boolean // Zstandard超圧縮 (デフォルト: true)
+}
+```
+
+### `UastcQuality`
+
+```typescript
+enum UastcQuality {
+  Fastest = 0, // 最速、最低品質
+  Faster = 1, // 高速
+  Default = 2, // デフォルト
+  Slower = 3, // 低速、高品質
+  VerySlow = 4, // 最高品質
+}
+```
+
+### `Ktx2CompressionResult`
+
+```typescript
+interface Ktx2CompressionResult {
+  data: Uint8Array // 圧縮後のKTX2バイナリデータ
+  originalSize: number // 元のサイズ (bytes)
+  compressedSize: number // 圧縮後のサイズ (bytes)
+  width: number // 画像の幅
+  height: number // 画像の高さ
+}
+```
+
+## 注意事項
+
+- ブラウザ環境専用です（Node.js非対応）
+- 2のべき乗でないサイズの画像は警告が出ますが処理は継続します
+- 大きなテクスチャの場合、出力バッファは最大24MBに制限されています

package/dist/index.cjs

@@ -0,0 +1,200 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  UastcQuality: () => UastcQuality,
+  compressToKtx2: () => compressToKtx2,
+  disposeBasisEncoder: () => disposeBasisEncoder,
+  flipImageY: () => flipImageY,
+  getCachedBasisEncoder: () => getCachedBasisEncoder,
+  initBasisEncoder: () => initBasisEncoder,
+  isBasisEncoderReady: () => isBasisEncoderReady
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+var UastcQuality = /* @__PURE__ */ ((UastcQuality2) => {
+  UastcQuality2[UastcQuality2["Fastest"] = 0] = "Fastest";
+  UastcQuality2[UastcQuality2["Faster"] = 1] = "Faster";
+  UastcQuality2[UastcQuality2["Default"] = 2] = "Default";
+  UastcQuality2[UastcQuality2["Slower"] = 3] = "Slower";
+  UastcQuality2[UastcQuality2["VerySlow"] = 4] = "VerySlow";
+  return UastcQuality2;
+})(UastcQuality || {});
+
+// src/compress.ts
+var import_neverthrow2 = require("neverthrow");
+
+// src/encoder.ts
+var import_neverthrow = require("neverthrow");
+var import_basis_encoder = __toESM(require("../wasm/basis_encoder.js"), 1);
+var import_basis_encoder2 = __toESM(require("../wasm/basis_encoder.wasm?url"), 1);
+var cachedModule = null;
+function initBasisEncoder() {
+  if (cachedModule) {
+    return import_neverthrow.ResultAsync.fromSafePromise(Promise.resolve(cachedModule));
+  }
+  return import_neverthrow.ResultAsync.fromPromise(loadBasisModule(), (error) => ({
+    type: "WASM_LOAD_ERROR",
+    message: `Basis WASM \u30E2\u30B8\u30E5\u30FC\u30EB\u306E\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557: ${error instanceof Error ? error.message : String(error)}`
+  })).map((module2) => {
+    cachedModule = module2;
+    return module2;
+  });
+}
+function disposeBasisEncoder() {
+  cachedModule = null;
+}
+function getCachedBasisEncoder() {
+  return cachedModule;
+}
+function isBasisEncoderReady() {
+  return cachedModule !== null;
+}
+async function loadBasisModule() {
+  const moduleObj = await (0, import_basis_encoder.default)({
+    locateFile: () => import_basis_encoder2.default
+  });
+  if (moduleObj.initializeBasis) {
+    moduleObj.initializeBasis();
+  }
+  if (!moduleObj.BasisEncoder) {
+    throw new Error("BasisEncoder class not found in module after init");
+  }
+  return moduleObj;
+}
+
+// src/compress.ts
+var DEFAULT_OPTIONS = {
+  quality: 2 /* Default */,
+  compressionLevel: 3,
+  generateMipmaps: true,
+  supercompression: true
+};
+var MAX_OUTPUT_SIZE = 1024 * 1024 * 24;
+function compressToKtx2(imageData, width, height, options) {
+  const validationError = validateInput(imageData, width, height);
+  if (validationError) {
+    return (0, import_neverthrow2.errAsync)(validationError);
+  }
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  return initBasisEncoder().andThen(
+    (module2) => import_neverthrow2.ResultAsync.fromPromise(
+      encodeWithBasis(module2, imageData, width, height, opts),
+      (error) => ({
+        type: "COMPRESSION_ERROR",
+        message: `KTX2\u30A8\u30F3\u30B3\u30FC\u30C9\u306B\u5931\u6557: ${error instanceof Error ? error.message : String(error)}`
+      })
+    )
+  );
+}
+function validateInput(imageData, width, height) {
+  if (width <= 0 || height <= 0) {
+    return {
+      type: "INVALID_INPUT",
+      message: `\u5E45\u3068\u9AD8\u3055\u306F\u6B63\u306E\u5024\u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059: width=${width}, height=${height}`
+    };
+  }
+  const expectedSize = width * height * 4;
+  if (imageData.length !== expectedSize) {
+    return {
+      type: "INVALID_INPUT",
+      message: `\u753B\u50CF\u30C7\u30FC\u30BF\u30B5\u30A4\u30BA\u304C\u4E0D\u6B63\u3067\u3059: expected=${expectedSize}, actual=${imageData.length}`
+    };
+  }
+  if (!isPowerOfTwo(width) || !isPowerOfTwo(height)) {
+    console.warn(
+      `[texture-compression] \u5E45\u30FB\u9AD8\u3055\u304C2\u306E\u3079\u304D\u4E57\u3067\u306A\u3044\u5834\u5408\u3001\u4E00\u90E8\u306EGPU\u3067\u554F\u984C\u304C\u767A\u751F\u3059\u308B\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059: ${width}x${height}`
+    );
+  }
+  return null;
+}
+function isPowerOfTwo(n) {
+  return n > 0 && (n & n - 1) === 0;
+}
+async function encodeWithBasis(module2, imageData, width, height, options) {
+  const encoder = new module2.BasisEncoder();
+  try {
+    encoder.setCreateKTX2File(true);
+    encoder.setUASTC(true);
+    encoder.setKTX2UASTCSupercompression(options.supercompression);
+    encoder.setPackUASTCFlags(options.quality);
+    encoder.setCompressionLevel(options.compressionLevel);
+    encoder.setMipGen(options.generateMipmaps);
+    const success = encoder.setSliceSourceImage(
+      0,
+      imageData,
+      width,
+      height,
+      module2.ldr_image_type.cRGBA32.value
+    );
+    if (!success) {
+      throw new Error("\u30BD\u30FC\u30B9\u753B\u50CF\u306E\u8A2D\u5B9A\u306B\u5931\u6557\u3057\u307E\u3057\u305F");
+    }
+    const outputBuffer = new Uint8Array(MAX_OUTPUT_SIZE);
+    const outputSize = encoder.encode(outputBuffer);
+    if (outputSize === 0) {
+      throw new Error("\u30A8\u30F3\u30B3\u30FC\u30C9\u7D50\u679C\u304C\u7A7A\u3067\u3059");
+    }
+    const ktx2Data = new Uint8Array(outputBuffer.buffer, 0, outputSize);
+    return {
+      data: ktx2Data.slice(),
+      // コピーを返す
+      originalSize: imageData.length,
+      compressedSize: outputSize,
+      width,
+      height
+    };
+  } finally {
+    encoder.delete();
+  }
+}
+function flipImageY(imageData, width, height) {
+  const rowSize = width * 4;
+  const flipped = new Uint8Array(imageData.length);
+  for (let y = 0; y < height; y++) {
+    const srcOffset = y * rowSize;
+    const dstOffset = (height - 1 - y) * rowSize;
+    flipped.set(imageData.subarray(srcOffset, srcOffset + rowSize), dstOffset);
+  }
+  return flipped;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UastcQuality,
+  compressToKtx2,
+  disposeBasisEncoder,
+  flipImageY,
+  getCachedBasisEncoder,
+  initBasisEncoder,
+  isBasisEncoderReady
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/compress.ts","../src/encoder.ts"],"sourcesContent":["/**\n * @webxr-jp/texture-compression\n *\n * テクスチャ圧縮ユーティリティパッケージ\n * avatar-optimizerで利用するためのWASMベースのKTX2圧縮機能を提供\n */\n\n// 型定義\nexport type {\n  CompressionError,\n  Ktx2CompressionOptions,\n  Ktx2CompressionResult,\n} from './types'\nexport { UastcQuality } from './types'\n\n// 圧縮API\nexport { compressToKtx2, flipImageY } from './compress'\n\n// エンコーダー管理\nexport {\n  disposeBasisEncoder,\n  getCachedBasisEncoder,\n  initBasisEncoder,\n  isBasisEncoderReady,\n} from './encoder'\n","/**\n * テクスチャ圧縮関連の型定義\n */\n\n/** UASTC品質レベル */\nexport enum UastcQuality {\n  /** 最速、最低品質 */\n  Fastest = 0,\n  /** 高速 */\n  Faster = 1,\n  /** デフォルト */\n  Default = 2,\n  /** 低速、高品質 */\n  Slower = 3,\n  /** 最高品質 */\n  VerySlow = 4,\n}\n\n/** KTX2圧縮オプション */\nexport interface Ktx2CompressionOptions {\n  /** UASTC品質レベル (0-4, デフォルト: 2) */\n  quality?: UastcQuality\n  /** 圧縮レベル (0-5, デフォルト: 3) */\n  compressionLevel?: number\n  /** ミップマップ生成 (デフォルト: false) */\n  generateMipmaps?: boolean\n  /** Zstandard超圧縮を使用 (デフォルト: true) */\n  supercompression?: boolean\n}\n\n/** KTX2圧縮結果 */\nexport interface Ktx2CompressionResult {\n  /** 圧縮後のKTX2バイナリデータ */\n  data: Uint8Array\n  /** 元のサイズ (bytes) */\n  originalSize: number\n  /** 圧縮後のサイズ (bytes) */\n  compressedSize: number\n  /** 画像の幅 */\n  width: number\n  /** 画像の高さ */\n  height: number\n}\n\n/** エラー型 */\nexport type CompressionError =\n  | { type: 'WASM_LOAD_ERROR'; message: string }\n  | { type: 'COMPRESSION_ERROR'; message: string }\n  | { type: 'INVALID_INPUT'; message: string }\n\n/**\n * BasisEncoderモジュールの型定義\n * Emscriptenでビルドされたbasis_encoder.jsが公開するAPI\n */\nexport interface BasisEncoderModule {\n  /** BasisEncoderクラス */\n  BasisEncoder: new () => BasisEncoder\n  /** LDR画像タイプ列挙（生ピクセルデータにはcRGBA32を使用） */\n  ldr_image_type: {\n    cRGBA32: { value: number }\n    cPNGImage: { value: number }\n    cJPGImage: { value: number }\n  }\n}\n\n/**\n * BasisEncoderインスタンスの型定義\n */\nexport interface BasisEncoder {\n  /** KTX2ファイル生成を設定 */\n  setCreateKTX2File(create: boolean): void\n  /** UASTC超圧縮（Zstandard）を設定 */\n  setKTX2UASTCSupercompression(enable: boolean): void\n  /** UASTCモードを有効化 */\n  setUASTC(enable: boolean): void\n  /** スライスソース画像を設定（LDR） */\n  setSliceSourceImage(\n    sliceIndex: number,\n    imageData: Uint8Array,\n    width: number,\n    height: number,\n    imageType: number,\n  ): boolean\n  /** UASTC品質フラグを設定 */\n  setPackUASTCFlags(flags: number): void\n  /** 圧縮レベルを設定 */\n  setCompressionLevel(level: number): void\n  /** ミップマップ生成を設定 */\n  setMipGen(generate: boolean): void\n  /** エンコードを実行 */\n  encode(outputBuffer: Uint8Array): number\n  /** リソースを解放 */\n  delete(): void\n}\n\n/** BASIS WASM ファクトリ関数の型 */\nexport type BasisModuleFactory = (\n  moduleOverrides?: Record<string, unknown>,\n) => Promise<BasisEncoderModule>\n","/**\n * KTX2テクスチャ圧縮ロジック\n */\n\nimport { errAsync, ResultAsync } from 'neverthrow'\nimport { initBasisEncoder } from './encoder'\nimport {\n  BasisEncoderModule,\n  CompressionError,\n  Ktx2CompressionOptions,\n  Ktx2CompressionResult,\n  UastcQuality,\n} from './types'\n\n/** デフォルトの圧縮オプション */\nconst DEFAULT_OPTIONS: Required<Ktx2CompressionOptions> = {\n  quality: UastcQuality.Default,\n  compressionLevel: 3,\n  generateMipmaps: true,\n  supercompression: true,\n}\n\n/** 出力バッファの最大サイズ（24MB） */\nconst MAX_OUTPUT_SIZE = 1024 * 1024 * 24\n\n/**\n * RGBAピクセルデータをKTX2形式に圧縮\n *\n * @param imageData - RGBAピクセルデータ（width * height * 4 bytes）\n * @param width - 画像の幅\n * @param height - 画像の高さ\n * @param options - 圧縮オプション\n * @returns 圧縮結果\n */\nexport function compressToKtx2(\n  imageData: Uint8Array,\n  width: number,\n  height: number,\n  options?: Ktx2CompressionOptions,\n): ResultAsync<Ktx2CompressionResult, CompressionError> {\n  // 入力検証\n  const validationError = validateInput(imageData, width, height)\n  if (validationError) {\n    return errAsync(validationError)\n  }\n\n  const opts = { ...DEFAULT_OPTIONS, ...options }\n\n  return initBasisEncoder().andThen((module) =>\n    ResultAsync.fromPromise(\n      encodeWithBasis(module, imageData, width, height, opts),\n      (error) => ({\n        type: 'COMPRESSION_ERROR' as const,\n        message: `KTX2エンコードに失敗: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    ),\n  )\n}\n\n/**\n * 入力データを検証\n * @returns エラーがあればCompressionError、なければnull\n */\nfunction validateInput(\n  imageData: Uint8Array,\n  width: number,\n  height: number,\n): CompressionError | null {\n  if (width <= 0 || height <= 0) {\n    return {\n      type: 'INVALID_INPUT',\n      message: `幅と高さは正の値である必要があります: width=${width}, height=${height}`,\n    }\n  }\n\n  const expectedSize = width * height * 4\n  if (imageData.length !== expectedSize) {\n    return {\n      type: 'INVALID_INPUT',\n      message: `画像データサイズが不正です: expected=${expectedSize}, actual=${imageData.length}`,\n    }\n  }\n\n  // 2のべき乗チェック（推奨だが必須ではない）\n  if (!isPowerOfTwo(width) || !isPowerOfTwo(height)) {\n    console.warn(\n      `[texture-compression] 幅・高さが2のべき乗でない場合、一部のGPUで問題が発生する可能性があります: ${width}x${height}`,\n    )\n  }\n\n  return null\n}\n\n/**\n * 2のべき乗かチェック\n */\nfunction isPowerOfTwo(n: number): boolean {\n  return n > 0 && (n & (n - 1)) === 0\n}\n\n/**\n * BasisEncoderを使用してエンコード\n */\nasync function encodeWithBasis(\n  module: BasisEncoderModule,\n  imageData: Uint8Array,\n  width: number,\n  height: number,\n  options: Required<Ktx2CompressionOptions>,\n): Promise<Ktx2CompressionResult> {\n  const encoder = new module.BasisEncoder()\n\n  try {\n    // KTX2出力を有効化\n    encoder.setCreateKTX2File(true)\n\n    // UASTCモードを有効化\n    encoder.setUASTC(true)\n\n    // 超圧縮（Zstandard）を設定\n    encoder.setKTX2UASTCSupercompression(options.supercompression)\n\n    // 品質設定\n    encoder.setPackUASTCFlags(options.quality)\n\n    // 圧縮レベル\n    encoder.setCompressionLevel(options.compressionLevel)\n\n    // ミップマップ生成\n    encoder.setMipGen(options.generateMipmaps)\n\n    // ソース画像を設定（RGBA32生データ）\n    const success = encoder.setSliceSourceImage(\n      0,\n      imageData,\n      width,\n      height,\n      module.ldr_image_type.cRGBA32.value,\n    )\n\n    if (!success) {\n      throw new Error('ソース画像の設定に失敗しました')\n    }\n\n    // 出力バッファを確保\n    const outputBuffer = new Uint8Array(MAX_OUTPUT_SIZE)\n\n    // エンコード実行\n    const outputSize = encoder.encode(outputBuffer)\n\n    if (outputSize === 0) {\n      throw new Error('エンコード結果が空です')\n    }\n\n    // 結果を切り出し\n    const ktx2Data = new Uint8Array(outputBuffer.buffer, 0, outputSize)\n\n    return {\n      data: ktx2Data.slice(), // コピーを返す\n      originalSize: imageData.length,\n      compressedSize: outputSize,\n      width,\n      height,\n    }\n  } finally {\n    // リソース解放\n    encoder.delete()\n  }\n}\n\n/**\n * Y軸を反転したピクセルデータを生成\n * WebGLテクスチャ座標系（左下原点）からKTX2座標系（左上原点）への変換\n *\n * @param imageData - 元のRGBAピクセルデータ\n * @param width - 画像の幅\n * @param height - 画像の高さ\n * @returns Y軸反転されたピクセルデータ\n */\nexport function flipImageY(\n  imageData: Uint8Array,\n  width: number,\n  height: number,\n): Uint8Array {\n  const rowSize = width * 4\n  const flipped = new Uint8Array(imageData.length)\n\n  for (let y = 0; y < height; y++) {\n    const srcOffset = y * rowSize\n    const dstOffset = (height - 1 - y) * rowSize\n    flipped.set(imageData.subarray(srcOffset, srcOffset + rowSize), dstOffset)\n  }\n\n  return flipped\n}\n","/**\n * BasisEncoder WASM モジュールのロードと管理\n * ブラウザ環境専用\n */\n\nimport { ResultAsync } from 'neverthrow'\n// @ts-expect-error - Emscripten module\nimport BASIS from '../wasm/basis_encoder.js'\n// @ts-expect-error - Vite ?url import\nimport wasmUrl from '../wasm/basis_encoder.wasm?url'\nimport { BasisEncoderModule, CompressionError } from './types'\n\n/** モジュールキャッシュ */\nlet cachedModule: BasisEncoderModule | null = null\n\n/**\n * BasisEncoder WASMモジュールを初期化（ブラウザ環境専用）\n *\n * @returns 初期化されたBasisEncoderModule\n */\nexport function initBasisEncoder(): ResultAsync<\n  BasisEncoderModule,\n  CompressionError\n> {\n  // キャッシュがあれば返す\n  if (cachedModule) {\n    return ResultAsync.fromSafePromise(Promise.resolve(cachedModule))\n  }\n\n  return ResultAsync.fromPromise(loadBasisModule(), (error) => ({\n    type: 'WASM_LOAD_ERROR' as const,\n    message: `Basis WASM モジュールの読み込みに失敗: ${error instanceof Error ? error.message : String(error)}`,\n  })).map((module) => {\n    cachedModule = module\n    return module\n  })\n}\n\n/**\n * BasisEncoderモジュールを解放\n */\nexport function disposeBasisEncoder(): void {\n  cachedModule = null\n}\n\n/**\n * キャッシュされたモジュールを取得（初期化済みの場合のみ）\n */\nexport function getCachedBasisEncoder(): BasisEncoderModule | null {\n  return cachedModule\n}\n\n/**\n * WASMがすでにロード済みかチェック\n */\nexport function isBasisEncoderReady(): boolean {\n  return cachedModule !== null\n}\n\n/** 拡張されたモジュール型（initializeBasisを含む） */\ninterface BasisEncoderModuleWithInit extends BasisEncoderModule {\n  initializeBasis?: () => void\n}\n\n/**\n * BASISモジュールをロード\n * locateFileでWASMのURLを指定\n */\nasync function loadBasisModule(): Promise<BasisEncoderModule> {\n  const moduleObj = (await BASIS({\n    locateFile: () => wasmUrl,\n  })) as BasisEncoderModuleWithInit\n\n  // Basisエンコーダーの初期化（必須）\n  if (moduleObj.initializeBasis) {\n    moduleObj.initializeBasis()\n  }\n\n  // BasisEncoderクラスが存在するか確認\n  if (!moduleObj.BasisEncoder) {\n    throw new Error('BasisEncoder class not found in module after init')\n  }\n\n  return moduleObj as BasisEncoderModule\n}\n"],"mappings":"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","names":["UastcQuality","import_neverthrow","import_basis_encoder","module","BASIS","wasmUrl","module"]}

package/dist/index.d.cts

@@ -0,0 +1,147 @@
+import { ResultAsync } from 'neverthrow';
+
+/**
+ * テクスチャ圧縮関連の型定義
+ */
+/** UASTC品質レベル */
+declare enum UastcQuality {
+    /** 最速、最低品質 */
+    Fastest = 0,
+    /** 高速 */
+    Faster = 1,
+    /** デフォルト */
+    Default = 2,
+    /** 低速、高品質 */
+    Slower = 3,
+    /** 最高品質 */
+    VerySlow = 4
+}
+/** KTX2圧縮オプション */
+interface Ktx2CompressionOptions {
+    /** UASTC品質レベル (0-4, デフォルト: 2) */
+    quality?: UastcQuality;
+    /** 圧縮レベル (0-5, デフォルト: 3) */
+    compressionLevel?: number;
+    /** ミップマップ生成 (デフォルト: false) */
+    generateMipmaps?: boolean;
+    /** Zstandard超圧縮を使用 (デフォルト: true) */
+    supercompression?: boolean;
+}
+/** KTX2圧縮結果 */
+interface Ktx2CompressionResult {
+    /** 圧縮後のKTX2バイナリデータ */
+    data: Uint8Array;
+    /** 元のサイズ (bytes) */
+    originalSize: number;
+    /** 圧縮後のサイズ (bytes) */
+    compressedSize: number;
+    /** 画像の幅 */
+    width: number;
+    /** 画像の高さ */
+    height: number;
+}
+/** エラー型 */
+type CompressionError = {
+    type: 'WASM_LOAD_ERROR';
+    message: string;
+} | {
+    type: 'COMPRESSION_ERROR';
+    message: string;
+} | {
+    type: 'INVALID_INPUT';
+    message: string;
+};
+/**
+ * BasisEncoderモジュールの型定義
+ * Emscriptenでビルドされたbasis_encoder.jsが公開するAPI
+ */
+interface BasisEncoderModule {
+    /** BasisEncoderクラス */
+    BasisEncoder: new () => BasisEncoder;
+    /** LDR画像タイプ列挙（生ピクセルデータにはcRGBA32を使用） */
+    ldr_image_type: {
+        cRGBA32: {
+            value: number;
+        };
+        cPNGImage: {
+            value: number;
+        };
+        cJPGImage: {
+            value: number;
+        };
+    };
+}
+/**
+ * BasisEncoderインスタンスの型定義
+ */
+interface BasisEncoder {
+    /** KTX2ファイル生成を設定 */
+    setCreateKTX2File(create: boolean): void;
+    /** UASTC超圧縮（Zstandard）を設定 */
+    setKTX2UASTCSupercompression(enable: boolean): void;
+    /** UASTCモードを有効化 */
+    setUASTC(enable: boolean): void;
+    /** スライスソース画像を設定（LDR） */
+    setSliceSourceImage(sliceIndex: number, imageData: Uint8Array, width: number, height: number, imageType: number): boolean;
+    /** UASTC品質フラグを設定 */
+    setPackUASTCFlags(flags: number): void;
+    /** 圧縮レベルを設定 */
+    setCompressionLevel(level: number): void;
+    /** ミップマップ生成を設定 */
+    setMipGen(generate: boolean): void;
+    /** エンコードを実行 */
+    encode(outputBuffer: Uint8Array): number;
+    /** リソースを解放 */
+    delete(): void;
+}
+
+/**
+ * KTX2テクスチャ圧縮ロジック
+ */
+
+/**
+ * RGBAピクセルデータをKTX2形式に圧縮
+ *
+ * @param imageData - RGBAピクセルデータ（width * height * 4 bytes）
+ * @param width - 画像の幅
+ * @param height - 画像の高さ
+ * @param options - 圧縮オプション
+ * @returns 圧縮結果
+ */
+declare function compressToKtx2(imageData: Uint8Array, width: number, height: number, options?: Ktx2CompressionOptions): ResultAsync<Ktx2CompressionResult, CompressionError>;
+/**
+ * Y軸を反転したピクセルデータを生成
+ * WebGLテクスチャ座標系（左下原点）からKTX2座標系（左上原点）への変換
+ *
+ * @param imageData - 元のRGBAピクセルデータ
+ * @param width - 画像の幅
+ * @param height - 画像の高さ
+ * @returns Y軸反転されたピクセルデータ
+ */
+declare function flipImageY(imageData: Uint8Array, width: number, height: number): Uint8Array;
+
+/**
+ * BasisEncoder WASM モジュールのロードと管理
+ * ブラウザ環境専用
+ */
+
+/**
+ * BasisEncoder WASMモジュールを初期化（ブラウザ環境専用）
+ *
+ * @returns 初期化されたBasisEncoderModule
+ */
+declare function initBasisEncoder(): ResultAsync<BasisEncoderModule, CompressionError>;
+/**
+ * BasisEncoderモジュールを解放
+ */
+declare function disposeBasisEncoder(): void;
+/**
+ * キャッシュされたモジュールを取得（初期化済みの場合のみ）
+ */
+declare function getCachedBasisEncoder(): BasisEncoderModule | null;
+/**
+ * WASMがすでにロード済みかチェック
+ */
+declare function isBasisEncoderReady(): boolean;
+
+export { type CompressionError, type Ktx2CompressionOptions, type Ktx2CompressionResult, UastcQuality, compressToKtx2, disposeBasisEncoder, flipImageY, getCachedBasisEncoder, initBasisEncoder, isBasisEncoderReady };

package/dist/index.d.ts

@@ -0,0 +1,147 @@
+import { ResultAsync } from 'neverthrow';
+
+/**
+ * テクスチャ圧縮関連の型定義
+ */
+/** UASTC品質レベル */
+declare enum UastcQuality {
+    /** 最速、最低品質 */
+    Fastest = 0,
+    /** 高速 */
+    Faster = 1,
+    /** デフォルト */
+    Default = 2,
+    /** 低速、高品質 */
+    Slower = 3,
+    /** 最高品質 */
+    VerySlow = 4
+}
+/** KTX2圧縮オプション */
+interface Ktx2CompressionOptions {
+    /** UASTC品質レベル (0-4, デフォルト: 2) */
+    quality?: UastcQuality;
+    /** 圧縮レベル (0-5, デフォルト: 3) */
+    compressionLevel?: number;
+    /** ミップマップ生成 (デフォルト: false) */
+    generateMipmaps?: boolean;
+    /** Zstandard超圧縮を使用 (デフォルト: true) */
+    supercompression?: boolean;
+}
+/** KTX2圧縮結果 */
+interface Ktx2CompressionResult {
+    /** 圧縮後のKTX2バイナリデータ */
+    data: Uint8Array;
+    /** 元のサイズ (bytes) */
+    originalSize: number;
+    /** 圧縮後のサイズ (bytes) */
+    compressedSize: number;
+    /** 画像の幅 */
+    width: number;
+    /** 画像の高さ */
+    height: number;
+}
+/** エラー型 */
+type CompressionError = {
+    type: 'WASM_LOAD_ERROR';
+    message: string;
+} | {
+    type: 'COMPRESSION_ERROR';
+    message: string;
+} | {
+    type: 'INVALID_INPUT';
+    message: string;
+};
+/**
+ * BasisEncoderモジュールの型定義
+ * Emscriptenでビルドされたbasis_encoder.jsが公開するAPI
+ */
+interface BasisEncoderModule {
+    /** BasisEncoderクラス */
+    BasisEncoder: new () => BasisEncoder;
+    /** LDR画像タイプ列挙（生ピクセルデータにはcRGBA32を使用） */
+    ldr_image_type: {
+        cRGBA32: {
+            value: number;
+        };
+        cPNGImage: {
+            value: number;
+        };
+        cJPGImage: {
+            value: number;
+        };
+    };
+}
+/**
+ * BasisEncoderインスタンスの型定義
+ */
+interface BasisEncoder {
+    /** KTX2ファイル生成を設定 */
+    setCreateKTX2File(create: boolean): void;
+    /** UASTC超圧縮（Zstandard）を設定 */
+    setKTX2UASTCSupercompression(enable: boolean): void;
+    /** UASTCモードを有効化 */
+    setUASTC(enable: boolean): void;
+    /** スライスソース画像を設定（LDR） */
+    setSliceSourceImage(sliceIndex: number, imageData: Uint8Array, width: number, height: number, imageType: number): boolean;
+    /** UASTC品質フラグを設定 */
+    setPackUASTCFlags(flags: number): void;
+    /** 圧縮レベルを設定 */
+    setCompressionLevel(level: number): void;
+    /** ミップマップ生成を設定 */
+    setMipGen(generate: boolean): void;
+    /** エンコードを実行 */
+    encode(outputBuffer: Uint8Array): number;
+    /** リソースを解放 */
+    delete(): void;
+}
+
+/**
+ * KTX2テクスチャ圧縮ロジック
+ */
+
+/**
+ * RGBAピクセルデータをKTX2形式に圧縮
+ *
+ * @param imageData - RGBAピクセルデータ（width * height * 4 bytes）
+ * @param width - 画像の幅
+ * @param height - 画像の高さ
+ * @param options - 圧縮オプション
+ * @returns 圧縮結果
+ */
+declare function compressToKtx2(imageData: Uint8Array, width: number, height: number, options?: Ktx2CompressionOptions): ResultAsync<Ktx2CompressionResult, CompressionError>;
+/**
+ * Y軸を反転したピクセルデータを生成
+ * WebGLテクスチャ座標系（左下原点）からKTX2座標系（左上原点）への変換
+ *
+ * @param imageData - 元のRGBAピクセルデータ
+ * @param width - 画像の幅
+ * @param height - 画像の高さ
+ * @returns Y軸反転されたピクセルデータ
+ */
+declare function flipImageY(imageData: Uint8Array, width: number, height: number): Uint8Array;
+
+/**
+ * BasisEncoder WASM モジュールのロードと管理
+ * ブラウザ環境専用
+ */
+
+/**
+ * BasisEncoder WASMモジュールを初期化（ブラウザ環境専用）
+ *
+ * @returns 初期化されたBasisEncoderModule
+ */
+declare function initBasisEncoder(): ResultAsync<BasisEncoderModule, CompressionError>;
+/**
+ * BasisEncoderモジュールを解放
+ */
+declare function disposeBasisEncoder(): void;
+/**
+ * キャッシュされたモジュールを取得（初期化済みの場合のみ）
+ */
+declare function getCachedBasisEncoder(): BasisEncoderModule | null;
+/**
+ * WASMがすでにロード済みかチェック
+ */
+declare function isBasisEncoderReady(): boolean;
+
+export { type CompressionError, type Ktx2CompressionOptions, type Ktx2CompressionResult, UastcQuality, compressToKtx2, disposeBasisEncoder, flipImageY, getCachedBasisEncoder, initBasisEncoder, isBasisEncoderReady };