narou 1.2.0 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2015 deflis
+
+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

@@ -1,41 +1,74 @@
-# node-narou
+# 📚 node-narou
 
 [![npm version](https://badge.fury.io/js/narou.svg)](https://badge.fury.io/js/narou)
 [![Node.js CI](https://github.com/deflis/node-narou/actions/workflows/nodejs-test.yml/badge.svg)](https://github.com/deflis/node-narou/actions/workflows/nodejs-test.yml)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/deflis/node-narou)
 
-[![DeepWiki](https://img.shields.io/badge/DeepWiki-deflis%2Fnode--narou-blue.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)](https://deepwiki.com/deflis/node-narou)
-<!-- DeepWiki badge generated by https://deepwiki.ryoppippi.com/ -->
+[なろうデベロッパー](https://dev.syosetu.com/)の API を fluent interface で利用できる TypeScript ライブラリです。  
+A TypeScript wrapper library for Narou Developer APIs with fluent interface.
 
+## ✨ 特徴
 
-[なろうデベロッパー](https://dev.syosetu.com/)の API を fluent interface で利用できるラッパーライブラリです。
-ブラウザでの JSONP の利用も可能です。
+- 🔗 **メソッドチェーン対応**: 直感的な fluent interface で API を操作
+- 🌐 **マルチ環境対応**: Node.js とブラウザの両方で動作
+- 📝 **TypeScript 完全対応**: 型安全性と IntelliSense サポート
+- 🔀 **デュアル実装**: fetch (Node.js) と JSONP (ブラウザ) を自動選択
+- 📚 **全 API カバー**: なろうデベロッパーの全 API に対応
 
-以下の API をラップしています。
+## 🚀 対応 API
 
-- [なろう小説 API](https://dev.syosetu.com/man/api/)
-- [なろう小説ランキング API](https://dev.syosetu.com/man/rankapi/)
-- [なろう殿堂入り API](https://dev.syosetu.com/man/rankinapi/)
-- [なろう R18 小説 API](https://dev.syosetu.com/xman/api/)
+| API | 説明 | 関数 |
+|-----|------|------|
+| [なろう小説 API](https://dev.syosetu.com/man/api/) | 小説の検索・絞り込み | `search()` |
+| [なろう小説ランキング API](https://dev.syosetu.com/man/rankapi/) | ランキング取得 | `ranking()` |
+| [なろう殿堂入り API](https://dev.syosetu.com/man/rankinapi/) | ランキング履歴取得 | `rankingHistory()` |
+| [なろう R18 小説 API](https://dev.syosetu.com/xman/api/) | 18禁小説検索 | `searchR18()` |
+| [なろうユーザ検索 API](https://dev.syosetu.com/man/userapi/) | ユーザー検索 | `searchUser()` |
 
-## Installation
+## 📦 インストール
 
-以下のコマンドでインストールできます。
+```bash
+# 推奨: pnpm
+pnpm add narou
 
-```
+# または
 npm install narou
+yarn add narou
 ```
 
-## Usage - API
+## 🚀 クイックスタート
 
-https://deflis.github.io/node-narou/ を参照してください。
+### Node.js での使用
 
-ブラウザで利用したい場合 `narou/browser` をimportしてください。こちらを利用することで自動的にfetch(nodejs)への依存がなくなり、JSONPを利用するようになります。
+```typescript
+import { search, ranking } from "narou";
+import { Genre, Order, RankingType } from "narou";
+
+// 異世界恋愛小説を検索
+const result = await search("異世界")
+  .genre(Genre.RenaiIsekai)
+  .order(Order.FavoriteNovelCount)
+  .limit(10)
+  .execute();
 
-すでにサポート終了していますがfetchをサポートしないNode.jsバージョンで利用する場合は 、 `NarouNovelFetch` にfetchのNode.js実装を渡してください。
-なお、その場合の動作は確認していないので動かなければIssueを立ててください。
+console.log(`${result.allcount}件の小説が見つかりました`);
+```
 
+### ブラウザでの使用
 
-## Example
+```typescript
+// ブラウザでは専用のインポートを使用（JSONP対応）
+import { search } from "narou/browser";
+
+const result = await search("魔法").execute();
+```
+
+## 📖 詳細な API ドキュメント
+
+- **🔗 [完全な API ドキュメント](https://deflis.github.io/node-narou/)** - TypeDoc で生成された詳細なドキュメント
+- **🤖 [LLM 向けドキュメント](https://deflis.github.io/node-narou/llms.txt)** - AI/LLM が理解しやすい形式のドキュメント（TypeDoc JSON から自動生成）
+
+## 📝 使用例
 
 ```typescript
 import { search, ranking, rankingHistory, searchR18 } from "narou";
@@ -115,32 +148,35 @@ for (const novel of searchR18Result.values) {
 }
 ```
 
-## Development
-
-```
-
-# watch
+## 🛠️ 開発
 
-npm run watch
+このプロジェクトでは pnpm を使用しています。
 
-# build
+```bash
+# 依存関係のインストール
+pnpm install
 
-npm run build
+# ビルド
+pnpm run build
 
-# test
+# テスト実行
+pnpm run test
 
-npm run test
+# 型チェック
+pnpm run check
 
+# ドキュメント生成（TypeDoc + llms.txt）
+pnpm run docs
 ```
 
-## Contributing
+## 🤝 コントリビューション
 
-1. Fork it!
-2. Create your feature branch: `git checkout -b my-new-feature`
-3. Commit your changes: `git commit -am 'Add some feature'`
-4. Push to the branch: `git push origin my-new-feature`
-5. Submit a pull request :D
+1. このリポジトリをフォーク
+2. フィーチャーブランチを作成: `git checkout -b my-new-feature`
+3. 変更をコミット: `git commit -am 'Add some feature'`
+4. ブランチにプッシュ: `git push origin my-new-feature`
+5. プルリクエストを作成
 
-## License
+## 📄 ライセンス
 
-MIT
+MIT License - 詳細は [LICENSE](LICENSE) ファイルを参照してください。