@uoa-css-lab/duckscatter 1.3.0

package/src/diagnostics.ts

@@ -0,0 +1,108 @@
+/**
+ * WebGPU診断結果のインターフェース
+ */
+export interface WebGPUDiagnostics {
+  /** WebGPU APIがサポートされているか */
+  supported: boolean;
+  /** WebGPUが利用可能か */
+  available: boolean;
+  /** GPUアダプター情報 */
+  adapter: {
+    /** アダプターが利用可能か */
+    available: boolean;
+    /** サポートされている機能の配列 */
+    features?: string[];
+    /** GPUの制限値 */
+    limits?: Record<string, number>;
+  };
+  /** ブラウザ情報 */
+  browser: string;
+  /** エラーメッセージ（ある場合） */
+  error?: string;
+}
+
+/**
+ * WebGPUの利用可能性を診断する
+ * @returns 診断結果のWebGPUDiagnosticsオブジェクト
+ */
+export async function diagnoseWebGPU(): Promise<WebGPUDiagnostics> {
+  const result: WebGPUDiagnostics = {
+    supported: false,
+    available: false,
+    adapter: {
+      available: false,
+    },
+    browser: getBrowserInfo(),
+  };
+
+  if (!('gpu' in navigator)) {
+    result.error = 'WebGPU API not found in navigator';
+    return result;
+  }
+
+  result.supported = true;
+
+  try {
+    const adapter = await navigator.gpu.requestAdapter();
+
+    if (!adapter) {
+      result.error = 'GPU adapter is null - GPU may be blocklisted or WebGPU is disabled';
+      return result;
+    }
+
+    result.adapter.available = true;
+    result.adapter.features = Array.from(adapter.features);
+    result.adapter.limits = {};
+
+    const limitsToCheck = [
+      'maxTextureDimension1D',
+      'maxTextureDimension2D',
+      'maxBufferSize',
+      'maxVertexBuffers',
+      'maxVertexAttributes',
+    ];
+
+    for (const limit of limitsToCheck) {
+      if (limit in adapter.limits) {
+        result.adapter.limits[limit] = (adapter.limits as any)[limit];
+      }
+    }
+
+    result.available = true;
+  } catch (e) {
+    result.error = `Error requesting adapter: ${e}`;
+    return result;
+  }
+
+  return result;
+}
+
+/**
+ * ブラウザ情報を取得する
+ * @returns ブラウザ名とバージョンの文字列
+ */
+function getBrowserInfo(): string {
+  const ua = navigator.userAgent;
+
+  if (ua.includes('Chrome') && !ua.includes('Edg')) {
+    const match = ua.match(/Chrome\/(\d+)/);
+    return match ? `Chrome ${match[1]}` : 'Chrome (unknown version)';
+  }
+
+  if (ua.includes('Edg')) {
+    const match = ua.match(/Edg\/(\d+)/);
+    return match ? `Edge ${match[1]}` : 'Edge (unknown version)';
+  }
+
+  if (ua.includes('Safari') && !ua.includes('Chrome')) {
+    const match = ua.match(/Version\/(\d+)/);
+    return match ? `Safari ${match[1]}` : 'Safari (unknown version)';
+  }
+
+  if (ua.includes('Firefox')) {
+    const match = ua.match(/Firefox\/(\d+)/);
+    return match ? `Firefox ${match[1]}` : 'Firefox (unknown version)';
+  }
+
+  return 'Unknown browser';
+}

package/src/errors.ts

@@ -0,0 +1,69 @@
+import type { ScatterPlotError, ErrorCode, ErrorCategory, ErrorSeverity } from './types.js';
+
+/**
+ * エラーコードからカテゴリへのマッピング
+ */
+const categoryMap: Record<ErrorCode, ErrorCategory> = {
+  WEBGPU_NOT_SUPPORTED: 'webgpu',
+  GPU_ADAPTER_NOT_AVAILABLE: 'webgpu',
+  GPU_DEVICE_FAILED: 'webgpu',
+  WEBGPU_CONTEXT_FAILED: 'webgpu',
+  DATA_LAYER_NOT_INITIALIZED: 'data',
+  PARQUET_LOAD_FAILED: 'data',
+  QUERY_FAILED: 'query',
+  LABEL_FETCH_FAILED: 'label',
+  LABEL_PARSE_FAILED: 'label',
+  NETWORK_ERROR: 'network',
+};
+
+/**
+ * エラーコードから重大度レベルへのマッピング
+ */
+const severityMap: Record<ErrorCode, ErrorSeverity> = {
+  WEBGPU_NOT_SUPPORTED: 'fatal',
+  GPU_ADAPTER_NOT_AVAILABLE: 'fatal',
+  GPU_DEVICE_FAILED: 'fatal',
+  WEBGPU_CONTEXT_FAILED: 'fatal',
+  DATA_LAYER_NOT_INITIALIZED: 'fatal',
+  PARQUET_LOAD_FAILED: 'fatal',
+  QUERY_FAILED: 'error',
+  NETWORK_ERROR: 'error',
+  LABEL_FETCH_FAILED: 'warning',
+  LABEL_PARSE_FAILED: 'warning',
+};
+
+/**
+ * 指定されたコードとメッセージでScatterPlotErrorオブジェクトを作成する
+ *
+ * @param code エラーコード
+ * @param message 人間が読めるエラーメッセージ
+ * @param options 追加オプション
+ * @returns ScatterPlotErrorオブジェクト
+ *
+ * @example
+ * ```typescript
+ * const error = createError(
+ *   'WEBGPU_NOT_SUPPORTED',
+ *   'WebGPU is not supported in this browser',
+ *   { context: { userAgent: navigator.userAgent } }
+ * );
+ * ```
+ */
+export function createError(
+  code: ErrorCode,
+  message: string,
+  options?: {
+    cause?: Error;
+    context?: Record<string, unknown>;
+  }
+): ScatterPlotError {
+  return {
+    code,
+    category: categoryMap[code],
+    severity: severityMap[code],
+    message,
+    cause: options?.cause,
+    context: options?.context,
+    timestamp: Date.now(),
+  };
+}

package/src/event-emitter.ts

@@ -0,0 +1,88 @@
+/**
+ * イベントハンドラー関数の型
+ */
+export type EventHandler<T = unknown> = (event: T) => void;
+
+/**
+ * ブラウザ環境向けの軽量なEventEmitter実装
+ * 外部依存なしで型安全なイベントハンドリングを提供する
+ *
+ * @example
+ * ```typescript
+ * interface MyEvents {
+ *   data: { value: number };
+ *   error: Error;
+ * }
+ *
+ * class MyClass extends EventEmitter<MyEvents> {
+ *   doSomething() {
+ *     this.emit('data', { value: 42 });
+ *   }
+ * }
+ *
+ * const instance = new MyClass();
+ * instance.on('data', (event) => console.log(event.value));
+ * ```
+ */
+export class EventEmitter<T extends { [K in keyof T]: unknown }> {
+  /** イベント名からハンドラーのセットへのマップ */
+  private listeners = new Map<keyof T, Set<EventHandler<any>>>();
+
+  /**
+   * 指定されたイベントに対してハンドラーを登録する
+   *
+   * @param event リッスンするイベント名
+   * @param handler イベント発生時に呼び出されるハンドラー関数
+   * @returns メソッドチェーン用のthisインスタンス
+   */
+  on<K extends keyof T>(event: K, handler: EventHandler<T[K]>): this {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, new Set());
+    }
+    this.listeners.get(event)!.add(handler);
+    return this;
+  }
+
+  /**
+   * 指定されたイベントからハンドラーを削除する
+   *
+   * @param event イベント名
+   * @param handler 削除するハンドラー関数
+   * @returns メソッドチェーン用のthisインスタンス
+   */
+  off<K extends keyof T>(event: K, handler: EventHandler<T[K]>): this {
+    this.listeners.get(event)?.delete(handler);
+    return this;
+  }
+
+  /**
+   * 登録されたすべてのハンドラーにイベントを発行する
+   *
+   * @param event 発行するイベント名
+   * @param data ハンドラーに渡すイベントデータ
+   * @returns リスナーがあればtrue、なければfalse
+   */
+  protected emit<K extends keyof T>(event: K, data: T[K]): boolean {
+    const handlers = this.listeners.get(event);
+    if (!handlers || handlers.size === 0) {
+      return false;
+    }
+    handlers.forEach((handler) => handler(data));
+    return true;
+  }
+
+  /**
+   * 指定されたイベント、またはすべてのイベントのリスナーを削除する
+   *
+   * @param event イベント名（省略時はすべてのリスナーを削除）
+   * @returns メソッドチェーン用のthisインスタンス
+   */
+  removeAllListeners(event?: keyof T): this {
+    if (event) {
+      this.listeners.delete(event);
+    } else {
+      this.listeners.clear();
+    }
+    return this;
+  }
+}

package/src/index.ts

@@ -0,0 +1,40 @@
+/**
+ * duckscatter - WebGPUを使用して散布図を描画するTypeScriptライブラリ
+ */
+
+export { ScatterPlot } from './scatter-plot.js';
+export type {
+  ColorRGBA,
+  ScatterPlotOptions,
+  Label,
+  WhereCondition,
+  NumericFilter,
+  StringFilter,
+  RawSqlFilter,
+  NumericOperator,
+  StringOperator,
+  // GPU filter types
+  GpuWhereCondition,
+  // Error handling types
+  ErrorSeverity,
+  ErrorCategory,
+  ErrorCode,
+  ScatterPlotError,
+  ScatterPlotEventMap,
+  // Hover control types
+  PointId,
+  LabelIdentifier,
+  LabelHoverCallback,
+} from './types.js';
+
+export { diagnoseWebGPU } from './diagnostics.js';
+export type { WebGPUDiagnostics } from './diagnostics.js';
+
+/**
+ * 現在の環境でWebGPUがサポートされているかを確認する
+ * @returns WebGPUがサポートされている場合はtrue、そうでない場合はfalse
+ */
+export function isWebGPUSupported(): boolean {
+  // navigatorオブジェクトにgpuプロパティが存在するかをチェック
+  return 'gpu' in navigator;
+}