@j1nn0/vanilla-autokana 2.2.2 → 2.2.4

package/README.md

@@ -9,23 +9,34 @@
 ## 特徴
 
 - jQueryに依存していません
-- scriptタグからの読み込みとESModulesのimportに対応しています
+- scriptタグからの読み込み、ES Modules の import、CommonJS の require に対応しています
 
 ## インストール方法
 
+> **Note:** 開発には [pnpm](https://pnpm.io/) 10 以上が必要です。利用側のプロジェクトでは任意のパッケージマネージャでインストールできます。
+
 ### npm
 
 ```sh
-npm i @j1nn0/vanilla-autokana # or yarn add @j1nn0/vanilla-autokana
+npm i @j1nn0/vanilla-autokana
+# or
+pnpm add @j1nn0/vanilla-autokana
+# or
+yarn add @j1nn0/vanilla-autokana
 ```
 
 ### npmを使わない方法
 
-このリポジトリの `dist/autokana.umd.js` をダウンロードし、scriptタグで読み込んでください。
+npm パッケージに含まれる `dist/autokana.umd.js` を scriptタグで読み込んでください。
+CDN を使う場合は、バージョンを固定した URL の利用を推奨します。
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@j1nn0/vanilla-autokana@2.2.2/dist/autokana.umd.js" defer></script>
+```
 
 ## 使用方法
 
-- `AutoKana.bind()` メソッドの第1引数にふりがな入力元の input 要素を指定します。第2引数にはふりがな出力先の input 要素を指定できますが、省略も可能です
+- `AutoKana.bind()` メソッドの第1引数にふりがな入力元の input / textarea 要素を指定します。第2引数にはふりがな出力先の input / textarea 要素を指定できますが、省略も可能です
 - 要素の指定には `#` / `.` / `[` / `:` で始まるセレクタ文字列、または input / textarea 要素を渡せます。IDのみを渡した場合も従来どおり動作します
 - input / textarea 要素が見つけられない場合は正常に動作できないため、DOMContentLoadedイベント内での実行を推奨します
 - ライブラリ本体はDOMのライフサイクルイベントに依存しないため、ライブラリの読み込みには`defer`属性の追加を推奨します
@@ -46,9 +57,15 @@ npm i @j1nn0/vanilla-autokana # or yarn add @j1nn0/vanilla-autokana
 </script>
 ```
 
-### モジュールとしてimportする
+### モジュールとして import する
 
-ESModulesとしてimportすることができます。
+ES Modules では named import と namespace import のどちらも使用できます。
+
+```js
+import { bind } from '@j1nn0/vanilla-autokana';
+
+bind('#name', '#furigana');
+```
 
 ```js
 import * as AutoKana from '@j1nn0/vanilla-autokana';
@@ -56,13 +73,23 @@ import * as AutoKana from '@j1nn0/vanilla-autokana';
 AutoKana.bind('#name', '#furigana');
 ```
 
-### オプション
+CommonJS では `require()` で読み込めます。
+
+```js
+const { bind } = require('@j1nn0/vanilla-autokana');
 
-`AutoKana.bind(name, furigana?, option)` の第3引数には以下を指定できます。
+bind('#name', '#furigana');
+```
+
+### 引数とオプション
+
+`AutoKana.bind(name, furigana?, option)` の引数は以下のとおりです。
 
 - `name`: `#` / `.` / `[` / `:` で始まるセレクタ文字列、または input / textarea 要素
 - `furigana`: `#` / `.` / `[` / `:` で始まるセレクタ文字列、input / textarea 要素、または省略
 
+第3引数の `option` には以下を指定できます。
+
 - `katakana`: `'hiragana' | 'full' | 'half'`
 - `debug`: `boolean`
 - `onChange`: `(furigana: string) => void` — ふりがなが変更されるたびに呼ばれるコールバック
@@ -189,7 +216,7 @@ v2.0.0 で `katakana` オプションの値が変更されました。
 | 変更前 (v1)       | 変更後 (v2)                |
 | ----------------- | -------------------------- |
 | `katakana: false` | `katakana: 'hiragana'`     |
-| `katakana: treu`  | `katakana: 'full'`         |
+| `katakana: true`  | `katakana: 'full'`         |
 | なし              | `katakana: 'half'`（新設） |
 
 ### 移行手順

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j1nn0/vanilla-autokana",
-  "version": "2.2.2",
+  "version": "2.2.4",
   "description": "A JavaScript library to complete furigana automatically (forked from ryo-utsunomiya/vanilla-autokana).",
   "author": "j1nn0 <j1nn0.github@gmail.com>",
   "contributors": [
@@ -45,6 +45,7 @@
     "provenance": true
   },
   "devDependencies": {
+    "@release-it/conventional-changelog": "^11.0.1",
     "@storybook/html": "^10.4.6",
     "@storybook/html-vite": "^10.4.6",
     "@types/node": "^26.0.1",
@@ -57,6 +58,7 @@
     "oxlint": "^1.72.0",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
+    "release-it": "^20.2.1",
     "storybook": "^10.4.6",
     "typescript": "^6.0.2",
     "unplugin-dts": "^1.0.3",
@@ -74,6 +76,8 @@
     "test:coverage": "vitest run --coverage",
     "verify:exports": "node scripts/verify-package-exports.mjs",
     "ci": "oxlint src __tests__ && tsc --noEmit && tsc --noEmit -p tsconfig.build.json && vitest run --coverage && vite build && node scripts/prepare-cjs-types.mjs && node scripts/verify-package-exports.mjs",
+    "release": "release-it",
+    "release:dry-run": "release-it --dry-run --ci --no-git.requireCleanWorkingDir",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build"
   }