@aiquants/duckdb-helper 1.6.2 → 1.6.4

package/docs/guides/2026.04.11 [AI] development.md

@@ -7,7 +7,7 @@
 ### 前提条件
 
 | ツール | バージョン |
-|--------|-----------|
+| --- | --- |
 | Node.js | >= 16.0.0 |
 | pnpm | >= 8.0.0 |
 
@@ -32,7 +32,7 @@ pnpm run type-check
 ### 日常的なコマンド
 
 | やりたいこと | コマンド |
-|-------------|---------|
+| --- | --- |
 | ビルド | `pnpm run build` |
 | ウォッチモードで開発 | `pnpm run dev` |
 | 型チェック | `pnpm run type-check` |
@@ -92,7 +92,7 @@ src/
 ### ファイルの責務境界
 
 | 変更したい内容 | 編集するファイル |
-|---------------|----------------|
+| --- | --- |
 | DuckDB の初期化方法を変えたい | `services/duckdb.ts` の `internalInitializeWorker()` |
 | 新しい DuckDB 拡張を追加したい | `services/duckdb.ts` の `internalInitializeWorker()` |
 | クエリ実行のタイムアウトを変更したい | `services/duckdb.ts` の `executeQuery()` 内の `TIMEOUT_MS` |
@@ -184,7 +184,7 @@ pnpm run type-check && pnpm run test && pnpm run build
 ### テストの分類
 
 | ディレクトリ | 種類 | 説明 |
-|-------------|------|------|
+| --- | --- | --- |
 | `tests/unit/` | 単体テスト | 個々の関数・クラスのテスト |
 | `tests/integration/` | 統合テスト | 複数モジュールの連携テスト |
 

package/docs/specs/2026.04.11 [AI] 00-overview.md

@@ -3,7 +3,7 @@
 ## 1. パッケージ概要
 
 | 項目 | 内容 |
-|------|------|
+| --- | --- |
 | パッケージ名 | `@aiquants/duckdb-helper` |
 | バージョン | 1.6.0 |
 | ライセンス | MIT |
@@ -91,7 +91,7 @@ packages/duckdb-helper/
 `src/index.ts` で公開されるすべてのエクスポート:
 
 | カテゴリ | エクスポート名 | 種別 | 説明 |
-|----------|---------------|------|------|
+| --- | --- | --- | --- |
 | Hooks | `useDuckDB` | 関数 | DuckDB の状態管理と操作を提供する React Hook |
 | Hooks | `useDuckDBQuery` | 関数 | SQL クエリの実行と結果管理を行う React Hook |
 | Service | `DuckDBService` | クラス | DuckDB 操作のシングルトンサービス（名前付きエクスポート） |
@@ -112,13 +112,13 @@ packages/duckdb-helper/
 ### 本番依存（dependencies）
 
 | パッケージ | バージョン | 用途 |
-|-----------|-----------|------|
+| --- | --- | --- |
 | `@duckdb/duckdb-wasm` | ^1.30.0 | DuckDB の WASM 実装本体 |
 
 ### ピア依存（peerDependencies）- オプション
 
 | パッケージ | バージョン | 用途 |
-|-----------|-----------|------|
+| --- | --- | --- |
 | `react` | `^19.2.7`（catalog） | React Hooks を使う場合に必要 |
 | `react-dom` | `^19.2.7`（catalog） | React Hooks を使う場合に必要 |
 
@@ -167,7 +167,7 @@ flowchart TD
 ## 8. 設計上の重要な判断
 
 | 判断事項 | 採用方針 | 理由 |
-|---------|---------|------|
+| --- | --- | --- |
 | シングルトンパターン | 採用 | アプリ全体で WASM インスタンスを1つだけ保持し、メモリを節約 |
 | CDN からのバンドル取得 | jsDelivr を使用 | `@duckdb/duckdb-wasm` 公式推奨の配布方法 |
 | Blob URL による Worker 作成 | 採用 | CORS 制約を回避し、CDN の Worker スクリプトをロード |
@@ -186,7 +186,7 @@ flowchart TD
 ## 9. 関連ドキュメント
 
 | ドキュメント | パス | 内容 |
-|-------------|------|------|
+| --- | --- | --- |
 | 型定義仕様書 | [01-types.md](./2026.04.11%20%5BAI%5D%2001-types.md) | 型定義の詳細 |
 | サービス仕様書 | [02-service.md](./2026.04.11%20%5BAI%5D%2002-service.md) | DuckDBService の全メソッド仕様 |
 | Hooks 仕様書 | [03-hooks.md](./2026.04.11%20%5BAI%5D%2003-hooks.md) | useDuckDB / useDuckDBQuery の仕様 |

package/docs/specs/2026.04.11 [AI] 01-types.md

@@ -20,7 +20,7 @@ export interface DuckDBQueryResult<T = unknown> {
 ```
 
 | プロパティ/メソッド | 型 | 説明 |
-|-------------------|------|------|
+| --- | --- | --- |
 | `toArray()` | `T[]` | クエリ結果の全行を JavaScript 配列として返すメソッド |
 | `numRows` | `number` | 結果の行数 |
 | `numCols` | `number` | 結果の列数 |
@@ -50,7 +50,7 @@ export type DuckDBRow<T> = T
 ```
 
 | 項目 | 内容 |
-|------|------|
+| --- | --- |
 | 定義 | ジェネリクス `T` をそのまま返すエイリアス型 |
 | 用途 | コード上の可読性向上。「この `T` は DuckDB の行データである」という意味を明示する |
 
@@ -86,7 +86,7 @@ DuckDBRow<T> = T  ← ドキュメンテーション用エイリアス
 ## 4. 他モジュールとの関係
 
 | 参照元ファイル | 参照する型 | 使われ方 |
-|--------------|-----------|---------|
+| --- | --- | --- |
 | `index.ts` | `DuckDBQueryResult`, `DuckDBRow` | 公開 API として re-export（型のみ） |
 | `utils/duckdb-helpers.ts` | `DuckDBQueryResult` | `duckdbTableToArray` 内の型アサーション（`as DuckDBQueryResult<T>`）、`isDuckDBTable` の型ガード戻り値（`result is DuckDBQueryResult`）。なお `getDuckDBRowCount` / `getDuckDBColumnCount` は `DuckDBQueryResult` を参照せず、`unknown` 型の入力に対して `in` 演算子と `typeof` で直接プロパティを検査する |
 | `hooks/useDuckDB.ts` | （直接参照なし） | フック内部では `unknown` 型で結果を返す |

package/docs/specs/2026.04.11 [AI] 02-service.md

@@ -19,7 +19,7 @@ Web Worker の初期化、コネクション管理、SQL クエリの実行、
 ### 2.2 プライベートプロパティ
 
 | プロパティ名 | 型 | 初期値 | 説明 |
-|-------------|------|--------|------|
+| --- | --- | --- | --- |
 | `instance` | `DuckDBService \| null` | `null` | シングルトンインスタンス（static） |
 | `operationFlags` | `Map<string, Promise<void>>` | 空の Map | **進行中の**テーブル作成 Promise（重複呼び出しは同じ Promise を await する） |
 | `workerInstance` | `AsyncDuckDB \| null` | `null` | DuckDB Worker インスタンス（**instantiate 成功後にのみ設定**） |
@@ -44,7 +44,7 @@ Web Worker の初期化、コネクション管理、SQL クエリの実行、
 ### 3.2 `getStatus(): "not-initialized" | "initializing" | "ready" | "error"`
 
 | ステータス | 条件 | 意味 |
-|-----------|------|------|
+| --- | --- | --- |
 | `"error"` | `hasError === true` | 初期化に失敗した（最優先で判定） |
 | `"initializing"` | `isInitializing === true` | 初期化処理中 |
 | `"ready"` | `workerInstance !== null` | 利用可能 |
@@ -57,7 +57,7 @@ Web Worker の初期化、コネクション管理、SQL クエリの実行、
 ### 3.3 `initialize(): Promise<AsyncDuckDB>`
 
 | 項目 | 内容 |
-|------|------|
+| --- | --- |
 | 戻り値 | 初期化された `AsyncDuckDB` インスタンス |
 | 例外 | 初期化失敗時（タイムアウト含む）に throw |
 | タイムアウト | 120秒（120,000ms、`INIT_TIMEOUT_MS`） |
@@ -91,7 +91,7 @@ flowchart TD
 Worker の実際の初期化処理。**`workerInstance` は全ステップ成功後にのみ `this` に公開する**（途中で失敗/アボートした場合はローカルの Worker / Blob URL を破棄し、壊れたインスタンスを絶対に残さない）。
 
 | ステップ | 処理内容 | 補足 |
-|---------|---------|------|
+| --- | --- | --- |
 | 1 | `duckdb.getJsDelivrBundles()` | jsDelivr CDN のバンドル一覧 |
 | 2 | `duckdb.selectBundle()` → **アボート確認** | ブラウザ互換バンドルを選択 |
 | 3 | Blob URL を作成し Web Worker を生成、`pendingWorker`/`pendingWorkerUrl` に退避 | 失敗時の破棄用 |
@@ -106,7 +106,7 @@ Worker の実際の初期化処理。**`workerInstance` は全ステップ成功
 ### 3.5 `getConnection(): Promise<AsyncDuckDBConnection>`
 
 | 項目 | 内容 |
-|------|------|
+| --- | --- |
 | 戻り値 | DuckDB コネクション（1つを保持・再利用） |
 | 動作 | コネクションが無ければ `initialize()` → `connect()` で作成。あれば再利用 |
 
@@ -117,7 +117,7 @@ Worker の実際の初期化処理。**`workerInstance` は全ステップ成功
 ### 3.6 `executeQuery(sql: string): Promise<unknown>`
 
 | 項目 | 内容 |
-|------|------|
+| --- | --- |
 | 戻り値 | クエリ結果（Apache Arrow Table）。型は `unknown` |
 | タイムアウト | 60秒（60,000ms、`QUERY_TIMEOUT_MS`） |
 | 直列化 | `operationQueue` で他操作と直列化（テーブル構築中の割り込み read を防止） |
@@ -143,7 +143,7 @@ JavaScript の配列データから DuckDB テーブルを作成する高レベ
 #### 引数
 
 | 引数名 | 型 | 必須 | 説明 |
-|--------|------|------|------|
+| --- | --- | --- | --- |
 | `tableName` | `string` | Yes | 作成するテーブル名（識別子として安全にクォートされる） |
 | `data` | `T[]` | Yes | 投入データ配列（1行以上必須） |
 | `options.dropIfExists` | `boolean` | No | `true` で既存テーブルを削除してから作成 |
@@ -186,7 +186,7 @@ flowchart TD
 #### 型推定ルール（`inferColumnTypes`、サンプル = 先頭 100 行）
 
 | JavaScript の値 | 推定される DuckDB 型 | 条件 |
-|----------------|---------------------|------|
+| --- | --- | --- |
 | `number`（有限・整数） | `BIGINT` | `Number.isFinite` かつ `Number.isInteger`（桁あふれ回避のため一律 BIGINT） |
 | `number`（有限・小数） | `DOUBLE` | 有限だが整数でない |
 | `bigint` | `BIGINT` | `typeof === "bigint"` |
@@ -204,7 +204,7 @@ flowchart TD
 #### SQL 値フォーマットルール（`formatValueForSQL`）
 
 | JavaScript の値 | SQL 出力 | 補足 |
-|----------------|---------|------|
+| --- | --- | --- |
 | `null` / `undefined` | `NULL` | |
 | `string` | `'エスケープ済み'` | シングルクォートを `''` にエスケープ |
 | `Date` | `'2024-01-01T00:00:00.000Z'` | ISO 8601 |
@@ -237,7 +237,7 @@ flowchart TD
 ### 3.12 `cleanup(): Promise<void>`
 
 | ステップ | 処理 |
-|---------|------|
+| --- | --- |
 | 1 | コネクションを close |
 | 2 | Worker を terminate |
 | 3 | `pendingWorker`/`pendingWorkerUrl` を破棄（`abortPendingWorker`） |
@@ -253,7 +253,7 @@ teardown 中に例外が出ても `Logger.error` でログするのみで throw
 ## 4. 内部定数
 
 | 定数 | 値 | 用途 |
-|------|------|------|
+| --- | --- | --- |
 | `INIT_TIMEOUT_MS` | `120000` | 初期化タイムアウト |
 | `QUERY_TIMEOUT_MS` | `60000` | クエリタイムアウト |
 | `BATCH_SIZE` | `1000` | バッチ INSERT の行数 |

package/docs/specs/2026.04.11 [AI] 03-hooks.md

@@ -7,7 +7,7 @@
 React コンポーネントから DuckDB を利用するための2つのカスタムフックを提供する。
 
 | Hook 名 | 用途 | 難易度 |
-|---------|------|--------|
+| --- | --- | --- |
 | `useDuckDB` | DuckDB の初期化・状態管理・各種操作を提供する汎用フック | 中級 |
 | `useDuckDBQuery` | 単一 SQL クエリの実行と結果管理に特化した簡易フック | 初級 |
 
@@ -22,7 +22,7 @@ export const useDuckDB = (autoInitialize = true): UseDuckDBResult
 ### 2.2 引数
 
 | 引数名 | 型 | デフォルト | 説明 |
-|--------|------|-----------|------|
+| --- | --- | --- | --- |
 | `autoInitialize` | `boolean` | `true` | コンポーネントマウント時に自動で DuckDB を初期化するか |
 
 ### 2.3 戻り値（`UseDuckDBResult`）
@@ -50,7 +50,7 @@ export interface UseDuckDBResult {
 ```
 
 | プロパティ | 型 | 説明 |
-|-----------|------|------|
+| --- | --- | --- |
 | `status` | `string` | 現在の DuckDB ステータス（4種類） |
 | `error` | `string \| null` | エラーメッセージ。正常時は `null` |
 | `executeQuery` | `Function` | SQL を実行して結果を返す。`status !== "ready"` で throw |
@@ -173,14 +173,14 @@ export const useDuckDBQuery = <T = unknown>(
 ### 3.2 引数
 
 | 引数名 | 型 | デフォルト | 説明 |
-|--------|------|-----------|------|
+| --- | --- | --- | --- |
 | `sql` | `string` | (必須) | 実行する SQL クエリ |
 | `dependencies` | `DependencyList` | `[]` | この配列の値が変わるとクエリが再実行される |
 
 ### 3.3 戻り値
 
 | プロパティ | 型 | 説明 |
-|-----------|------|------|
+| --- | --- | --- |
 | `data` | `T \| null` | クエリ結果。未実行・エラー時は `null` |
 | `loading` | `boolean` | クエリ実行中は `true` |
 | `error` | `string \| null` | エラーメッセージ。正常時は `null` |
@@ -270,7 +270,7 @@ const Dashboard = () => {
 ## 4. 2つの Hook の使い分け
 
 | 判断基準 | `useDuckDB` | `useDuckDBQuery` |
-|---------|-------------|------------------|
+| --- | --- | --- |
 | 単一クエリの取得だけ | | 推奨 |
 | 複数クエリを実行したい | 推奨 | |
 | テーブルを作成したい | 推奨 | |

package/docs/specs/2026.04.11 [AI] 04-utils.md

@@ -10,7 +10,7 @@ DuckDB のクエリ結果（Apache Arrow Table）を JavaScript で扱いやす
 ## 2. 関数一覧
 
 | 関数名 | 戻り値 | 説明 |
-|--------|--------|------|
+| --- | --- | --- |
 | `duckdbTableToArray<T>` | `T[]` | クエリ結果を型付き配列に変換 |
 | `getDuckDBRowCount` | `number` | クエリ結果の行数を取得 |
 | `getDuckDBColumnCount` | `number` | クエリ結果の列数を取得 |
@@ -31,13 +31,13 @@ export const duckdbTableToArray = <T>(result: unknown): T[]
 #### 引数
 
 | 引数名 | 型 | 説明 |
-|--------|------|------|
+| --- | --- | --- |
 | `result` | `unknown` | `executeQuery()` の戻り値（Apache Arrow Table） |
 
 #### 戻り値
 
 | 条件 | 戻り値 |
-|------|--------|
+| --- | --- |
 | `result` が null/undefined | `[]`（空配列） |
 | `result` がオブジェクトでない | `[]`（空配列） |
 | `result` に `toArray` メソッドがない | `[]`（空配列） |
@@ -91,7 +91,7 @@ export const getDuckDBRowCount = (result: unknown): number
 #### 戻り値
 
 | 条件 | 戻り値 |
-|------|--------|
+| --- | --- |
 | `result` が null/undefined | `0` |
 | `result` がオブジェクトでない | `0` |
 | `result` に `numRows` プロパティがない | `0` |
@@ -123,7 +123,7 @@ export const getDuckDBColumnCount = (result: unknown): number
 #### 戻り値
 
 | 条件 | 戻り値 |
-|------|--------|
+| --- | --- |
 | `result` が null/undefined | `0` |
 | `result` がオブジェクトでない | `0` |
 | `result` に `numCols` プロパティがない | `0` |
@@ -154,7 +154,7 @@ export const isDuckDBTable = (result: unknown): result is DuckDBQueryResult
 #### 判定条件（すべて満たす必要がある）
 
 | 条件 | 説明 |
-|------|------|
+| --- | --- |
 | `result` が null/undefined でない | |
 | `result` が object である | |
 | `result` に `toArray` キーが存在する | `"toArray" in result`（存在チェック） |

package/docs/specs/2026.04.11 [AI] 05-logger.md

@@ -19,7 +19,7 @@ export enum LogLevel {
 ```
 
 | レベル | 数値 | 出力対象 | 用途例 |
-|--------|------|---------|--------|
+| --- | --- | --- | --- |
 | `DEBUG` | 0 | debug, info, warn, error すべて出力 | 開発中のデバッグ |
 | `INFO` | 1 | info, warn, error を出力 | 初期化ステップの確認 |
 | `WARN` | 2 | warn, error のみ出力 | **デフォルト** |
@@ -48,7 +48,7 @@ export interface ILogger {
 `Logger` は2つの使い方ができる。
 
 | 使い方 | 対象 | 用途 |
-|--------|------|------|
+| --- | --- | --- |
 | **静的メソッド** | 内部のデフォルトインスタンス | ライブラリ内部での標準的な使用 |
 | **インスタンスメソッド** | 個別のインスタンス | カスタム設定が必要な場合 |
 
@@ -73,7 +73,7 @@ constructor(
 ```
 
 | 引数 | デフォルト | 説明 |
-|------|-----------|------|
+| --- | --- | --- |
 | `level` | `LogLevel.WARN` | 最小出力レベル |
 | `prefix` | `"[duckdb-helper]"` | ログメッセージの先頭に付与する文字列 |
 | `impl` | `console` | 実際のログ出力を行うオブジェクト |
@@ -93,7 +93,7 @@ private static instance: Logger = new Logger(LogLevel.WARN, "[duckdb-helper]")
 #### ログ出力
 
 | メソッド | 出力条件 |
-|---------|---------|
+| --- | --- |
 | `Logger.debug(message, ...params)` | `level <= DEBUG (0)` |
 | `Logger.info(message, ...params)` | `level <= INFO (1)` |
 | `Logger.warn(message, ...params)` | `level <= WARN (2)` |
@@ -102,7 +102,7 @@ private static instance: Logger = new Logger(LogLevel.WARN, "[duckdb-helper]")
 #### 設定変更
 
 | メソッド | 説明 |
-|---------|------|
+| --- | --- |
 | `Logger.setLevel(level)` | デフォルトインスタンスのログレベルを変更 |
 | `Logger.setImplementation(impl)` | デフォルトインスタンスのロガー実装を差し替え |
 | `Logger.setPrefix(prefix)` | デフォルトインスタンスのプレフィックスを変更 |
@@ -119,7 +119,7 @@ private formatMessage(message: unknown): unknown[] {
 ```
 
 | 入力 | 出力 |
-|------|------|
+| --- | --- |
 | `"初期化中..."` | `["[duckdb-helper] 初期化中..."]` |
 | `{ key: "value" }` | `["[duckdb-helper]", { key: "value" }]` |
 
@@ -128,7 +128,7 @@ private formatMessage(message: unknown): unknown[] {
 ## 5. ライブラリ内での使用箇所
 
 | ファイル | 使用メソッド | 内容 |
-|---------|------------|------|
+| --- | --- | --- |
 | `services/duckdb.ts` | `Logger.info` | Worker 初期化の各ステップのログ |
 | `services/duckdb.ts` | `Logger.warn` | splink_udfs ロード失敗時の警告 |
 | `services/duckdb.ts` | `Logger.error` | 初期化失敗・クエリ失敗のエラーログ |

package/docs/specs/2026.04.11 [AI] 06-build-config.md

@@ -28,7 +28,7 @@ export default defineConfig({
 ### 各設定の意味
 
 | 設定 | 値 | 説明 |
-|------|------|------|
+| --- | --- | --- |
 | `entry` | `['src/index.ts']` | ビルドのエントリーポイント。`index.ts` の公開 API のみがバンドルされる |
 | `format` | `['cjs', 'esm']` | CommonJS（`.js`）と ESM（`.mjs`）の両形式を生成 |
 | `dts` | `true` | TypeScript 型定義ファイル（`.d.ts`）を自動生成 |
@@ -43,7 +43,7 @@ export default defineConfig({
 ### external の意味
 
 | パッケージ | 理由 |
-|-----------|------|
+| --- | --- |
 | `react` | ピア依存。利用側が提供する |
 | `react-dom` | ピア依存。利用側が提供する |
 | `@duckdb/duckdb-wasm` | 本番依存だがサイズが大きいため、利用側のバンドラーに委ねる |
@@ -53,7 +53,7 @@ export default defineConfig({
 ### 主要設定
 
 | 設定 | 値 | 説明 |
-|------|------|------|
+| --- | --- | --- |
 | `target` | `ES2020` | 出力する JavaScript のバージョン |
 | `module` | `ES2020` | モジュールシステム |
 | `lib` | `["ES2020", "DOM", "DOM.Iterable"]` | 利用可能な型定義。DOM はブラウザ API 用 |
@@ -107,7 +107,7 @@ export default defineConfig({
 ```
 
 | フィールド | 用途 |
-|-----------|------|
+| --- | --- |
 | `main` | Node.js / 古いバンドラーが参照（CommonJS） |
 | `module` | Webpack / Rollup 等が参照（ESM） |
 | `types` | TypeScript の型定義 |
@@ -116,7 +116,7 @@ export default defineConfig({
 ### npm スクリプト
 
 | スクリプト | コマンド | 説明 |
-|-----------|---------|------|
+| --- | --- | --- |
 | `build` | `tsup` | ビルド実行 |
 | `build:watch` | `tsup --watch` | ファイル変更時に自動リビルド |
 | `dev` | `tsup --watch` | 開発用（build:watch と同一） |
@@ -151,14 +151,14 @@ npm に公開されるファイル。`src/` はパッケージに含まれない
 ## 4.5 テスト設定（v1.6.0〜）
 
 | ファイル | 役割 |
-|---------|------|
+| --- | --- |
 | `vitest.config.ts` | Vitest 設定。`environment: "jsdom"`、`globals: true`、カバレッジは `v8` プロバイダで `src/**`（`src/types` 除外）を対象に閾値 100%（lines / functions / branches / statements） |
 | `tsconfig.test.json` | `tsconfig.json` を継承し `tests/**` を含めた型チェック用設定 |
 
 ### テスト関連 devDependencies
 
 | パッケージ | 用途 |
-|-----------|------|
+| --- | --- |
 | `vitest` | テストランナー |
 | `@vitest/coverage-v8` | V8 カバレッジプロバイダ |
 | `jsdom` | ブラウザ相当の DOM 環境（`window` / `URL` / React フックのレンダリング） |

package/docs/specs/2026.07.05 [AI] 07-testing.md

@@ -11,7 +11,7 @@
 ## 2. テスト環境・ツール
 
 | 項目 | 内容 |
-|------|------|
+| --- | --- |
 | ランナー | Vitest 3.2.6（`vitest.config.ts`） |
 | 実行環境 | `jsdom`（`window` / `URL` / `Blob` / React フックのレンダリングに必要） |
 | カバレッジ | `@vitest/coverage-v8`。対象 `src/**`、除外 `src/types/**`。閾値 100% |
@@ -31,7 +31,7 @@ pnpm run typecheck:test    # tests を含む型チェック
 DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単体テストでは**外部依存を完全にフェイク化**して全経路を決定論的に検証する。
 
 | 対象 | 手法 |
-|------|------|
+| --- | --- |
 | `@duckdb/duckdb-wasm` | `vi.mock` で `getJsDelivrBundles` / `selectBundle` / `ConsoleLogger` / `AsyncDuckDB` を差し替え。`vi.hoisted` の共有状態で「バンドル選択」「instantiate」「connect」「query」「close」「terminate」の振る舞いをテストごとに制御し、発行 SQL を記録する |
 | `Worker` | `vi.stubGlobal` でフェイク（`terminate` 呼び出しを記録） |
 | `URL.createObjectURL` / `revokeObjectURL` | スタブして呼び出し回数を記録（Blob URL リーク検証用） |
@@ -42,7 +42,7 @@ DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単
 ## 4. テストファイル構成
 
 | ファイル | 対象モジュール | 主眼 |
-|---------|--------------|------|
+| --- | --- | --- |
 | `tests/services/duckdb.test.ts` | `services/duckdb.ts` | ライフサイクル・並行性・SQL 生成・型推定・トランザクション |
 | `tests/hooks/useDuckDB.test.tsx` | `hooks/useDuckDB.ts` | ステータス同期・操作ガード・`useDuckDBQuery` |
 | `tests/utils/duckdb-helpers.test.ts` | `utils/duckdb-helpers.ts` | 結果変換ヘルパーの境界値 |
@@ -57,7 +57,7 @@ DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単
 #### initialize()
 
 | ケース | 検証内容 | 関連修正 |
-|--------|---------|---------|
+| --- | --- | --- |
 | 正常初期化 | `ready` に遷移、Blob URL を revoke、splink 一時コネクションを close | |
 | 高速パス | 初期化済みなら Worker を作り直さない | |
 | 同時呼び出しの重複排除 | 2 回同時呼び出しでも Worker は 1 つ | |
@@ -77,7 +77,7 @@ DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単
 #### executeQuery / executeQueries
 
 | ケース | 検証内容 | 関連修正 |
-|--------|---------|---------|
+| --- | --- | --- |
 | 実行と単一コネクション再利用 | 2 回実行で二重 connect しない | getConnection 競合 |
 | クエリエラー伝播 | 失敗後も次クエリが実行可能（キューが詰まらない） | 操作直列化 |
 | クエリタイムアウト | 60s 経過で reject | タイマーリーク |
@@ -107,7 +107,7 @@ DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単
 #### createTableFromData — スキーマ/行
 
 | ケース | 検証内容 | 関連修正 |
-|--------|---------|---------|
+| --- | --- | --- |
 | **列名の和集合** | 先頭行に無い列も CREATE/INSERT に含む、null 行は全 NULL | 列取りこぼし |
 | **トランザクション順序** | `BEGIN → DROP → CREATE → INSERT → COMMIT` の順序 | 原子性 |
 | primaryKey / DROP スキップ | `PRIMARY KEY ("id")` を付与、DROP なし | |
@@ -138,7 +138,7 @@ DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単
 ### 5.2 React フック（`tests/hooks/useDuckDB.test.tsx`）
 
 | グループ | ケース |
-|---------|--------|
+| --- | --- |
 | 初期化 | `autoInitialize` 既定でマウント時に `initialize()` を呼ぶ / `false` で呼ばない / リスナーをマウントで登録・アンマウントで解除 |
 | ステータス同期 | `ready` で `error` クリア / `error` でメッセージ設定（push リスナー経由） |
 | 操作ガード | 未 ready で全操作（`executeQuery`/`executeQueries`/`createTableFromData`/`getTableInfo`/`listTables`）が throw / ready で各サービスメソッドに委譲 |
@@ -168,7 +168,7 @@ DuckDB-WASM は実際の Worker と WASM ダウンロードを伴うため、単
 `pnpm run test:coverage` の結果（v1.6.0 時点、88 テスト）:
 
 | File | % Stmts | % Branch | % Funcs | % Lines |
-|------|---------|----------|---------|---------|
+| --- | --- | --- | --- | --- |
 | All files | 100 | 100 | 100 | 100 |
 | `index.ts` | 100 | 100 | 100 | 100 |
 | `hooks/useDuckDB.ts` | 100 | 100 | 100 | 100 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/duckdb-helper",
-  "version": "1.6.2",
+  "version": "1.6.4",
   "description": "DuckDB helper utilities with React hooks, worker initialization, and typed query helpers",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -76,9 +76,9 @@
     "typecheck": "tsc --noEmit",
     "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
     "clean": "rimraf dist",
-    "publish:patch": "npm version patch && pnpm publish --no-git-checks",
-    "publish:minor": "npm version minor && pnpm publish --no-git-checks",
-    "publish:major": "npm version major && pnpm publish --no-git-checks",
+    "publish:patch": "pnpm run typecheck && pnpm run --if-present test && pnpm version patch --no-git-tag-version --no-git-checks && pnpm publish --no-git-checks",
+    "publish:minor": "pnpm run typecheck && pnpm run --if-present test && pnpm version minor --no-git-tag-version --no-git-checks && pnpm publish --no-git-checks",
+    "publish:major": "pnpm run typecheck && pnpm run --if-present test && pnpm version major --no-git-tag-version --no-git-checks && pnpm publish --no-git-checks",
     "lint": "biome lint src/",
     "lint:fix": "biome lint --write src/",
     "format": "biome format src/",