npm - netscape-bookmark-parser - Versions diffs - 1.1.2 → 1.1.4 - Mend

netscape-bookmark-parser 1.1.2 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/README-ja.md +202 -369
package/README.md +122 -287
package/esm/src/BookmarksParser/BookmarksParser.d.ts +120 -1
package/esm/src/BookmarksParser/BookmarksParser.d.ts.map +1 -1
package/esm/src/BookmarksParser/BookmarksParser.js +129 -2
package/esm/src/BookmarksTree/BookmarksTree.d.ts +102 -0
package/esm/src/BookmarksTree/BookmarksTree.d.ts.map +1 -1
package/esm/src/BookmarksTree/BookmarksTree.js +106 -2
package/esm/src/web/BookmarksParser/BookmarksParser.d.ts +120 -1
package/esm/src/web/BookmarksParser/BookmarksParser.d.ts.map +1 -1
package/esm/src/web/BookmarksParser/BookmarksParser.js +129 -2
package/esm/src/web/BookmarksTree/BookmarksTree.d.ts +102 -0
package/esm/src/web/BookmarksTree/BookmarksTree.d.ts.map +1 -1
package/esm/src/web/BookmarksTree/BookmarksTree.js +106 -2
package/package.json +1 -1

package/README-ja.md CHANGED Viewed

@@ -1,18 +1,19 @@
 # Netscape Bookmark Parser
-> **注意:**
-> この README は AI 生成されたドキュメントです。詳細はほぼ正確ですが、不正確な説明が含まれる可能性があります。
+ブラウザのブックマークファイル（HTML 形式）を解析し、構造化データとして操作できる TypeScript/JavaScript ライブラリです。Deno と Node.js の両方のランタイムに対応しています。
-ブラウザのブックマークファイル（HTML 形式）を解析し、構造化データとして操作するための TypeScript/JavaScript ライブラリです。Deno と Node.js の両方のランタイムに対応しています。
+> **注意:**
+> この README は AI による自動生成です。内容はほぼ正確ですが、不正確な説明が含まれる場合があります。
+> 英語版ドキュメント: [`./README.md`](./README.md)
-## 機能
+## 特徴
-- **HTML ブックマークファイルの解析**: Chrome、Firefox、Safari、その他のブラウザからエクスポートされた HTML ブックマークファイルを解析
-- **階層構造の保持**: フォルダとブックマークの階層構造を完全に保持
-- **双方向変換**: HTML からデータ構造への変換とその逆の変換をサポート
-- **JSON シリアライゼーション**: ブックマークツリーを JSON として保存・復元
-- **Deno & Node.js 対応**: Deno と Node.js の両方のランタイムで動作
-- **型安全性**: 包括的な型定義によるフル TypeScript サポート
+- **HTML ブックマークファイルの解析**: Chrome、Firefox、Safari など各種ブラウザからエクスポートされた HTML ブックマークファイルを解析
+- **階層構造の完全保持**: フォルダやブックマークの階層構造を忠実に再現
+- **双方向変換**: HTML⇔ データ構造の相互変換に対応
+- **JSON シリアライズ**: ブックマークツリーを JSON として保存・復元可能
+- **Deno & Node.js 両対応**: どちらのランタイムでも動作
+- **型安全**: TypeScript による型定義を完備
 ## インストール
@@ -22,6 +23,10 @@
 npm install netscape-bookmark-parser
 ```
+```typescript
+import { BookmarksParser, BookmarksTree } from "netscape-bookmark-parser";
+```
 ### Deno
 ```typescript
@@ -31,16 +36,16 @@ import {
 } from "jsr:@grakeice/netscape-bookmark-parser";
 ```
-> **注意:** JSR 版は Node.js/Deno ランタイム版のみを含んでいます。ブラウザサポートが必要な場合は、npm パッケージをご使用ください。
+> **注意:** JSR 版は Node.js/Deno ランタイムのみ対応です。ブラウザで利用する場合は npm パッケージをご利用ください。
 ### ブラウザ
-#### オプション 1: ビルドツールの使用（推奨）
+#### オプション 1: ビルドツール利用（推奨）
-**Webpack、Vite、Rollup、Parcel など:**
+**Webpack, Vite, Rollup, Parcel 等:**
 ```typescript
-// ブラウザ環境では、Web最適化版を使用
+// ブラウザ環境ではweb最適化版を利用
 import { BookmarksParser, BookmarksTree } from "netscape-bookmark-parser/web";
 // 例: アップロードされたブックマークファイルの解析
@@ -58,76 +63,59 @@ function handleFileUpload(event: Event) {
 }
 ```
-#### オプション 2: 直接 ES モジュールインポート
-```html
-<script type="module">
-	import {
-		BookmarksParser,
-		BookmarksTree,
-	} from "./node_modules/netscape-bookmark-parser/esm/mod_web.js";
-	// ブックマーク処理コードをここに...
-</script>
-```
-#### オプション 3: Import Maps を使用した CDN
+#### オプション 2: CDN + Import Maps
 ```html
 <script type="importmap">
 	{
 		"imports": {
-			"netscape-bookmark-parser/web": "https://cdn.jsdelivr.net/npm/netscape-bookmark-parser@1.1.2/esm/mod_web.js"
+			"netscape-bookmark-parser/web": "https://cdn.jsdelivr.net/npm/netscape-bookmark-parser@1.1.4/esm/mod_web.js"
 		}
 	}
 </script>
 <script type="module">
 	import { BookmarksParser, BookmarksTree } from "netscape-bookmark-parser/web";
-	// ローカルインポートと同じように動作
 	const tree = BookmarksParser.parse(htmlContent);
 </script>
 ```
-#### オプション 4: CDN を直接インポート
+#### オプション 3: CDN 直接インポート
 ```html
 <script type="module">
 	import {
 		BookmarksParser,
 		BookmarksTree,
-	} from "https://cdn.jsdelivr.net/npm/netscape-bookmark-parser@1.1.2/esm/mod_web.js";
-	// import maps なしでの直接 CDN インポート
+	} from "https://cdn.jsdelivr.net/npm/netscape-bookmark-parser@1.1.4/esm/mod_web.js";
 </script>
 ```
-> **ブラウザサポート:** ブラウザ互換性は npm パッケージを通してのみ利用可能です。JSR パッケージは、プラットフォーム固有の依存関係のため、Web 最適化版を含んでいません。
+> **ブラウザサポート:** ブラウザ互換は npm パッケージ経由のみ。JSR パッケージには web 最適化版は含まれません。
-> **注意:** Web 最適化版は、ネイティブブラウザ API（DOMParser など）を使用し、Node.js ポリフィルを含まないため、ブラウザ環境でより軽量で高速に動作します。
+> **注意:** web 最適化版は DOMParser 等のネイティブ API を利用し、Node.js 用ポリフィルを含まないため、ブラウザで軽量かつ高速です。
-## 使用方法
+## 使い方
-### 基本的な例
+### 基本例
 ```typescript
 import { BookmarksParser, BookmarksTree } from "netscape-bookmark-parser";
-// HTMLブックマークファイルを読み込み
+// HTMLブックマークファイルを読み込む
 const htmlContent = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
 <HTML>
 <BODY>
 <DL><p>
-    <DT><H3>フォルダ 1</H3>
+    <DT><H3>Folder 1</H3>
     <DL><p>
-        <DT><A HREF="https://example.com">例</A>
+        <DT><A HREF="https://example.com">Example</A>
     </DL><p>
     <DT><A HREF="https://google.com">Google</A>
 </DL><p>
 </BODY>
 </HTML>`;
-// HTMLを解析してBookmarksTreeに変換
+// 解析してBookmarksTreeに変換
 const bookmarksTree = BookmarksParser.parse(htmlContent);
 // JSONとして出力
@@ -144,7 +132,6 @@ console.log(bookmarksTree.HTMLText);
 // 新しいブックマークツリーを作成
 const tree = new BookmarksTree();
-// ブックマークを追加
 tree.set("Google", "https://google.com");
 tree.set("GitHub", "https://github.com");
@@ -157,8 +144,8 @@ const toolsFolder = new BookmarksTree();
 toolsFolder.set("GitHub", "https://github.com");
 toolsFolder.set("VS Code", "https://code.visualstudio.com");
-devFolder.set("ツール", toolsFolder);
-tree.set("開発", devFolder);
+devFolder.set("Tools", toolsFolder);
+tree.set("Development", devFolder);
 // JSONに変換
 const json = tree.toJSON();
@@ -167,9 +154,9 @@ const json = tree.toJSON();
 const restoredTree = BookmarksTree.fromJSON(json);
 // ツリー構造を確認
-console.log(tree.size); // トップレベルアイテムの数
-console.log(tree.has("開発")); // true
-console.log(tree.get("開発") instanceof BookmarksTree); // true
+console.log(tree.size); // トップレベルのアイテム数
+console.log(tree.has("Development")); // true
+console.log(tree.get("Development") instanceof BookmarksTree); // true
 ```
 ### 複雑な構造の処理
@@ -180,16 +167,16 @@ const complexHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
 <HTML>
 <BODY>
 <DL><p>
-    <DT><H3>仕事</H3>
+    <DT><H3>Work</H3>
     <DL><p>
-        <DT><H3>開発</H3>
+        <DT><H3>Development</H3>
         <DL><p>
             <DT><A HREF="https://github.com">GitHub</A>
             <DT><A HREF="https://stackoverflow.com">Stack Overflow</A>
         </DL><p>
         <DT><A HREF="https://docs.google.com">Google Docs</A>
     </DL><p>
-    <DT><H3>個人</H3>
+    <DT><H3>Personal</H3>
     <DL><p>
         <DT><A HREF="https://youtube.com">YouTube</A>
         <DT><A HREF="https://twitter.com">Twitter</A>
@@ -201,9 +188,9 @@ const complexHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
 const tree = BookmarksParser.parse(complexHtml);
-// ツリー構造をナビゲート
-const workFolder = tree.get("仕事") as BookmarksTree;
-const devFolder = workFolder.get("開発") as BookmarksTree;
+// ツリー構造をたどる
+const workFolder = tree.get("Work") as BookmarksTree;
+const devFolder = workFolder.get("Development") as BookmarksTree;
 console.log(devFolder.get("GitHub")); // "https://github.com"
 ```
@@ -211,126 +198,151 @@ console.log(devFolder.get("GitHub")); // "https://github.com"
 ### Web 最適化版
-> **重要:** ブラウザサポートは npm インストールを通してのみ利用可能です。JSR 版にはブラウザ互換ビルドが含まれていません。
+> **重要:** ブラウザサポートは npm インストールのみ。JSR 版にはブラウザ互換ビルドは含まれません。
-ライブラリは、Node.js 依存関係を排除し、ネイティブブラウザ API を使用するブラウザ最適化版を提供しています:
+このライブラリは Node.js 依存を排除し、ネイティブブラウザ API を利用する web 最適化版を提供します:
 ```typescript
-// ブラウザ最適化版をインポート（npm のみ）
+// npmのみで利用可能なweb最適化版
 import { BookmarksParser, BookmarksTree } from "netscape-bookmark-parser/web";
 ```
 ### BookmarksParser クラス
-[`BookmarksParser`](src/BookmarksParser/BookmarksParser.ts)クラスは、HTML ブックマークファイルを解析するための静的メソッドを提供します。
+`BookmarksParser`は Netscape Bookmark 形式の HTML や JSON を解析し、`BookmarksTree`インスタンスに変換する静的メソッドを提供します。
-#### `BookmarksParser.parse(htmlContent: string): BookmarksTree`
+#### 静的メソッド
-HTML ブックマークファイルのコンテンツを解析し、[`BookmarksTree`](src/BookmarksTree/BookmarksTree.ts)インスタンスを返します。
+- [`static parse(htmlString: string): BookmarksTree`](#static-parsehtmlstring-string-bookmarkstree)
-- **パラメータ**: `htmlContent` - 文字列としての HTML ブックマークファイル
-- **戻り値**: 解析されたブックマークツリー
+  - Netscape Bookmark 形式の HTML 文字列を解析し、`BookmarksTree`を返します。
+  - [`parseFromHTMLString`](#static-parsefromhtmlstringhtmlstring-string-bookmarkstree)のエイリアス。
-**例:**
+  **例:**
-```typescript
-const htmlContent = "<!DOCTYPE NETSCAPE-Bookmark-file-1>...";
-const tree = BookmarksParser.parse(htmlContent);
-```
+  ```typescript
+  const html = `<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<HTML><BODY><DL><p>\n  <DT><A HREF=\"https://example.com\">Example</A>\n</DL><p></BODY></HTML>`;
+  const tree = BookmarksParser.parse(html);
+  console.log(tree.toJSON());
+  ```
+- [`static parseFromHTMLString(htmlString: string): BookmarksTree`](#static-parsefromhtmlstringhtmlstring-string-bookmarkstree)
+  - HTML 文字列を解析し、`BookmarksTree`を返します。
+  **例:**
+  ```typescript
+  const html = `<!DOCTYPE NETSCAPE-Bookmark-file-1>...`;
+  const tree = BookmarksParser.parseFromHTMLString(html);
+  ```
+- [`static parseFromDOM(dom: HTMLDocument): BookmarksTree`](#static-parsefromdomdom-htmldocument-bookmarkstree)
+  - 既存の`HTMLDocument`から`BookmarksTree`を生成します。
+  **例:**
+  ```typescript
+  const dom = new DOMParser().parseFromString(html, "text/html");
+  const tree = BookmarksParser.parseFromDOM(dom);
+  ```
+- [`static parseFromJSON(jsonString: string): BookmarksTree`](#static-parsefromjsonjsonstring-string-bookmarkstree)
+  - JSON 文字列を解析し、`BookmarksTree`を返します。
+  **例:**
+  ```typescript
+  const json = '{"Google": "https://google.com"}';
+  const tree = BookmarksParser.parseFromJSON(json);
+  ```
+---
 ### BookmarksTree クラス
-[`BookmarksTree`](src/BookmarksTree/BookmarksTree.ts)は、`Map<string, string | BookmarksTree>`を拡張してブックマークの階層構造を表現するクラスです。
+`BookmarksTree`は`Map`を継承し、フォルダ（`BookmarksTree`）やブックマーク（URL 文字列）を階層構造で管理します。
 #### コンストラクタ
-```typescript
-const tree = new BookmarksTree();
-```
+- [`new BookmarksTree()`](#constructor)
+  **例:**
+  ```typescript
+  const tree = new BookmarksTree();
+  tree.set("Google", "https://google.com");
+  ```
 #### インスタンスメソッド
-##### `toJSON(): Record<string, unknown>`
+- [`toJSON(): Record<string, unknown>`](#tojson-recordstring-unknown)
-ツリーを JSON オブジェクト表現に変換します。
+  - ツリーを JSON オブジェクトに変換します。
-```typescript
-const json = tree.toJSON();
-console.log(JSON.stringify(json, null, 2));
-```
+  **例:**
-##### `toDOM(): HTMLDocument`
+  ```typescript
+  const json = tree.toJSON();
+  console.log(json);
+  ```
-ツリーを HTML ドキュメントオブジェクトに変換します。
+- [`toDOM(): HTMLDocument`](#todom-htmldocument)
-```typescript
-const htmlDocument = tree.toDOM();
-```
+  - ツリーを Netscape Bookmark 形式の HTML ドキュメントに変換します。
-##### `get HTMLText(): string`
+  **例:**
-ブックマークツリーの HTML 文字列表現を取得します。
+  ```typescript
+  const dom = tree.toDOM();
+  ```
-```typescript
-const htmlString = tree.HTMLText;
-console.log(htmlString); // 完全なHTMLブックマークファイル
-```
+- [`get HTMLString(): string`](#get-htmlstring-string)
-#### 静的メソッド
+  - Netscape Bookmark 形式の完全な HTML 文字列を取得します。
-##### `fromJSON(json: Record<string, unknown>): BookmarksTree`
+  **例:**
-JSON オブジェクトからツリーを復元します。
+  ```typescript
+  const html = tree.HTMLString;
+  console.log(html);
+  ```
-```typescript
-const json = { Google: "https://google.com" };
-const tree = BookmarksTree.fromJSON(json);
-```
+- [`get HTMLText(): string`](#get-htmltext-string)
+  - `HTMLString`のエイリアス（非推奨）。
-##### `fromDOM(dom: HTMLDocument): BookmarksTree`
+#### 静的メソッド
-DOM ドキュメントからツリーを作成します。
+- [`static fromJSON(json: Record<string, unknown>): BookmarksTree`](#static-fromjsonjson-recordstring-unknown-bookmarkstree)
-```typescript
-const dom = new DOMParser().parseFromString(htmlContent, "text/html");
-const tree = BookmarksTree.fromDOM(dom);
-```
+  - JSON オブジェクトからツリーを生成します。
-#### Map インターフェース
+  **例:**
-`BookmarksTree`は`Map`を拡張しているため、すべての標準 Map メソッドを使用できます：
+  ```typescript
+  const json = { Google: "https://google.com" };
+  const tree = BookmarksTree.fromJSON(json);
+  ```
-```typescript
-// ブックマークとフォルダを設定
-tree.set("bookmark", "https://example.com");
-tree.set("folder", new BookmarksTree());
-// 値を取得
-const url = tree.get("bookmark"); // string
-const folder = tree.get("folder"); // BookmarksTree
-// 存在確認
-tree.has("bookmark"); // true
-// アイテムを削除
-tree.delete("bookmark");
-// 繰り返し処理
-for (const [name, value] of tree) {
-	if (typeof value === "string") {
-		console.log(`ブックマーク: ${name} -> ${value}`);
-	} else {
-		console.log(`フォルダ: ${name} (${value.size} アイテム)`);
-	}
-}
-```
+- [`static fromDOM(dom: HTMLDocument): BookmarksTree`](#static-fromdomdom-htmldocument-bookmarkstree)
+  - HTML ドキュメントからツリーを生成します。
+  **例:**
-## プロジェクト構造
+  ```typescript
+  const dom = new DOMParser().parseFromString(html, "text/html");
+  const tree = BookmarksTree.fromDOM(dom);
+  ```
+## プロジェクト構成
 ```
 src/
 ├── BookmarksTree/
-│   ├── BookmarksTree.ts      # メインブックマークツリークラス
+│   ├── BookmarksTree.ts      # メインのブックマークツリークラス
 │   ├── BookmarksTree.test.ts # 包括的テスト
 │   └── index.ts             # エクスポート定義
 └── BookmarksParser/
@@ -353,136 +365,29 @@ npm/                         # Node.jsビルド成果物
 ### 入力形式
 - **Netscape Bookmark File Format**: 標準 HTML ブックマークファイル形式
-- **Chrome エクスポート形式**: Chrome ブラウザからエクスポートされた HTML ファイル
-- **Firefox エクスポート形式**: Firefox ブラウザからエクスポートされた HTML ファイル
-- **Safari エクスポート形式**: Safari ブラウザからエクスポートされた HTML ファイル
-- **Edge エクスポート形式**: Microsoft Edge からエクスポートされた HTML ファイル
-- **汎用 HTML**: Netscape ブックマーク構造に従った任意の HTML
+- **Chrome エクスポート形式**: Chrome からエクスポートされた HTML
+- **Firefox エクスポート形式**: Firefox からエクスポートされた HTML
+- **Safari エクスポート形式**: Safari からエクスポートされた HTML
+- **Edge エクスポート形式**: Microsoft Edge からエクスポートされた HTML
+- **汎用 HTML**: Netscape ブックマーク構造に準拠した任意の HTML
 ### 出力形式
-- **JSON**: プログラムからの簡単なアクセスのための構造化 JSON データ
-- **HTML**: 全ブラウザ互換の標準 Netscape Bookmark File Format
+- **JSON**: プログラムから扱いやすい構造化 JSON データ
+- **HTML**: 全ブラウザ互換の Netscape Bookmark File Format
 - **DOM**: ブラウザ互換の HTMLDocument オブジェクト
 ### 特別な機能
-- **Unicode 対応**: 国際文字と絵文字のフルサポート
-- **URL 検証**: 様々な URL 形式（http、https、ftp、file、相対）の処理
-- **HTML エンティティ処理**: HTML エンティティの適切なエスケープ・アンエスケープ
-- **空フォルダサポート**: ブックマーク構造内の空フォルダを保持
-- **重複処理**: 重複するブックマーク名は最後の値が優先
-## 出力例
-### JSON 形式
-```json
-{
-	"開発": {
-		"MDN": "https://developer.mozilla.org",
-		"ツール": {
-			"GitHub": "https://github.com",
-			"Stack Overflow": "https://stackoverflow.com"
-		}
-	},
-	"Google": "https://google.com"
-}
-```
-### HTML 形式
-```html
-<!DOCTYPE NETSCAPE-Bookmark-file-1>
-<HTML>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
-<TITLE>Bookmark</TITLE>
-<H1>Bookmark</H1>
-<BODY>
-<DL><p>
-    <DT><H3>開発</H3>
-    <DL><p>
-        <DT><A HREF="https://developer.mozilla.org">MDN</A>
-        <DT><H3>ツール</H3>
-        <DL><p>
-            <DT><A HREF="https://github.com">GitHub</A>
-            <DT><A HREF="https://stackoverflow.com">Stack Overflow</A>
-        </DL><p>
-    </DL><p>
-    <DT><A HREF="https://google.com">Google</A>
-</DL>
-</BODY>
-</HTML>
-```
+- **Unicode 対応**: 国際文字や絵文字も完全サポート
+- **URL バリデーション**: http, https, ftp, file, 相対パス等多様な URL 形式に対応
+- **HTML エンティティ処理**: HTML エンティティの適切なエスケープ/アンエスケープ
+- **空フォルダサポート**: 空のフォルダも構造として保持
+- **重複処理**: 同名ブックマークは後勝ち
 ## 依存関係
-- [`@b-fuze/deno-dom`](https://jsr.io/@b-fuze/deno-dom): Deno と Node.js 環境の両方での DOM 解析・操作
-## 開発
-### 前提条件
-- [Deno](https://deno.land/) 1.x 以降
-### セットアップ
-```bash
-git clone https://github.com/grakeice/netscape-bookmark-parser.git
-cd netscape-bookmark-parser
-```
-### 開発コマンド
-```bash
-# ファイル監視付きの開発サーバーを実行
-deno task dev
-# 全テストを実行
-deno test
-# カバレッジ付きテストを実行
-deno test --coverage
-# コードをフォーマット
-deno fmt
-# コードをリント
-deno lint
-# Node.js用にビルド
-deno task build:npm
-# 特定のバージョンでビルド
-deno task build:npm 1.0.0
-```
-### テストの実行
-プロジェクトには全機能の包括的なテストスイートが含まれています：
-```bash
-# 全テストを実行
-deno test
-# 特定のテストファイルを実行
-deno test src/BookmarksTree/BookmarksTree.test.ts
-# 詳細出力でテストを実行
-deno test --verbose
-# テストを実行してカバレッジレポートを生成
-deno test --coverage=coverage_dir
-deno coverage coverage_dir
-```
-### パブリッシュ
-プロジェクトは GitHub Actions による自動パブリッシュを使用しています：
-1. バージョンタグを作成: `git tag v1.0.0`
-2. タグをプッシュ: `git push origin v1.0.0`
-3. GitHub Actions が自動的にビルドして NPM と JSR の両方にパブリッシュ
+- [`@b-fuze/deno-dom`](https://jsr.io/@b-fuze/deno-dom): Deno/Node.js 両対応の DOM パーサ・操作
 ## ブラウザ互換性
@@ -495,9 +400,9 @@ deno coverage coverage_dir
 - **Opera**: 全バージョン
 - **Internet Explorer**: 6+（レガシーサポート）
-### エクスポートファイルの例
+### エクスポートファイル例
-ライブラリは以下からエクスポートされたブックマークファイルを解析できます：
+ライブラリは以下のようなブックマークファイルを解析できます：
 ```html
 <!-- Chrome/Edge形式 -->
@@ -507,9 +412,9 @@ deno coverage coverage_dir
 <TITLE>Bookmarks</TITLE>
 <H1>Bookmarks</H1>
 <DL><p>
-    <DT><H3 ADD_DATE="1640995200">ブックマークバー</H3>
+    <DT><H3 ADD_DATE="1640995200">Bookmarks bar</H3>
     <DL><p>
-        <DT><A HREF="https://example.com" ADD_DATE="1640995200">例</A>
+        <DT><A HREF="https://example.com" ADD_DATE="1640995200">Example</A>
     </DL><p>
 </DL>
@@ -517,102 +422,18 @@ deno coverage coverage_dir
 <!DOCTYPE NETSCAPE-Bookmark-file-1>
 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
 <TITLE>Bookmarks</TITLE>
-<H1>ブックマークメニュー</H1>
+<H1>Bookmarks Menu</H1>
 <DL><p>
-    <DT><H3>ブックマークツールバー</H3>
+    <DT><H3>Bookmarks Toolbar</H3>
     <DL><p>
-        <DT><A HREF="https://example.com">例のサイト</A>
+        <DT><A HREF="https://example.com">Example Site</A>
     </DL><p>
 </DL>
 ```
-## エラーハンドリング
-ライブラリは様々なエラー条件を適切に処理します：
-```typescript
-// 無効なHTML
-const invalidHtml =
-	"<html><body>ブックマークファイルではありません</body></html>";
-const tree = BookmarksParser.parse(invalidHtml);
-console.log(tree.size); // 0 - 空のツリー
-// 空のコンテンツ
-const emptyTree = BookmarksParser.parse("");
-console.log(emptyTree.size); // 0
-// 不正なURLはスキップされる
-const htmlWithBadUrls = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
-<HTML><BODY><DL><p>
-    <DT><A HREF="">空のURL</A>
-    <DT><A>HREF属性なし</A>
-    <DT><A HREF="https://valid.com">有効なリンク</A>
-</DL><p></BODY></HTML>`;
-const parsedTree = BookmarksParser.parse(htmlWithBadUrls);
-console.log(parsedTree.size); // 1 - 有効なリンクのみ含まれる
-```
-## パフォーマンス
-ライブラリはパフォーマンスに最適化されています：
-- **メモリ効率**: O(1)検索のためのネイティブ Map 構造を使用
-- **ストリーミング対応**: 大きなブックマークファイル（1000+ブックマーク）を処理可能
-- **高速解析**: 効率的なツリー走査を伴う DOM ベース解析
-- **JSON 変換**: 最適化されたシリアライゼーション/デシリアライゼーション
-## TypeScript サポート
-完全な TypeScript 定義が含まれています：
-```typescript
-interface BookmarkValue extends Map<string, string | BookmarksTree> {
-	toJSON(): Record<string, unknown>;
-	toDOM(): HTMLDocument;
-	readonly HTMLText: string;
-}
-class BookmarksParser {
-	static parse(htmlContent: string): BookmarksTree;
-}
-class BookmarksTree extends Map<string, string | BookmarksTree> {
-	toJSON(): Record<string, unknown>;
-	static fromJSON(json: Record<string, unknown>): BookmarksTree;
-	static fromDOM(dom: HTMLDocument): BookmarksTree;
-	toDOM(): HTMLDocument;
-	get HTMLText(): string;
-}
-```
 ## ライセンス
-MIT License - 詳細は[LICENSE](LICENSE)ファイルを参照してください。
-## コントリビューション
-プルリクエストとイシューレポートを歓迎します！
-### コントリビューション方法
-1. このリポジトリをフォーク
-2. 機能ブランチを作成（`git checkout -b feature/amazing-feature`）
-3. テストと共に変更を実装
-4. 全テストが通ることを確認（`deno test`）
-5. コードをフォーマット（`deno fmt`）
-6. 変更をコミット（`git commit -m 'Add some amazing feature'`）
-7. ブランチにプッシュ（`git push origin feature/amazing-feature`）
-8. プルリクエストを作成
-### イシューの報告
-イシューを報告する際は、以下を含めてください：
-- ブラウザ/環境情報
-- サンプルブックマーク HTML（該当する場合）
-- 期待される動作と実際の動作
-- 再現手順
+MIT License - 詳細は[LICENSE](LICENSE)を参照してください。
 ## 作者
@@ -622,44 +443,56 @@ MIT License - 詳細は[LICENSE](LICENSE)ファイルを参照してください
 ## 変更履歴
-### v1.1.2（最新）
+### v1.1.4（最新）
+- 🛠️ **パーサ改良**（多様なブックマーク HTML 形式への互換性向上・安定性向上）
+- 🧹 **コードリファクタリング・追加テスト**
+- 🐞 **マイナーバグ修正**
+- 📚 **ドキュメント更新**: API リファレンス刷新・説明統一・使用例追加・各種セクション復活
+### v1.1.3
+- 📝 **JSDoc コメント追加**: 主要クラス・メソッドに JSDoc 形式のコメントを追加し型情報と API 自動ドキュメント生成を強化
+- 📚 **ドキュメント更新**: Node.js/npm インストール手順に TypeScript インポート例を追加
+### v1.1.2
-- 📝 **ドキュメント強化**: 最新バージョン参照と改善された例を含む包括的な README ドキュメントの更新
-- 🔧 **バージョン一貫性**: 全ドキュメントとコード例でのバージョン番号の同期
-- 📚 **コンテンツ更新**: より明確性のためのインストール手順、使用例、API ドキュメントの改良
+- 📝 **ドキュメント強化**: 最新バージョン参照と改善例を含む README ドキュメント更新
+- 🔧 **バージョン一貫性**: 全ドキュメント・コード例でバージョン番号を統一
+- 📚 **内容更新**: インストール手順・使用例・API ドキュメントの明確化
 ### v1.1.1
-- 🛡️ **セキュリティ強化**: [`BookmarksTree.prototype.HTMLText`](src/BookmarksTree/BookmarksTree.ts) がブックマークのタイトルと URL の HTML エンティティを適切にエスケープするように修正
-- 🔧 **コード一貫性**: Node.js とブラウザ版間で HTML エスケープ動作を統一
-- 📝 **ドキュメント更新**: セキュリティ考慮事項を含む API ドキュメントの強化
-- 🐛 **バグ修正**: マイナーな安定性改善とエッジケース処理
+- 🛡️ **セキュリティ強化**: [`BookmarksTree.prototype.HTMLText`](src/BookmarksTree/BookmarksTree.ts)がブックマークタイトル・URL の HTML エンティティを適切にエスケープ
+- 🔧 **コード一貫性**: Node.js/ブラウザ版間で HTML エスケープ動作を統一
+- 📝 **ドキュメント更新**: セキュリティ考慮事項を含む API ドキュメント強化
+- 🐛 **バグ修正**: 安定性向上・エッジケース対応
 ### v1.1.0
-- 🌐 **ブラウザサポート**: ブラウザ環境用の Web 最適化版を追加
-- 📦 **デュアルエントリーポイント**: Node.js/Deno 用（`./mod.ts`）とブラウザ用（`./mod_web.ts`）の分離ビルド
-- ⚡ **ネイティブ DOM API**: ブラウザ版はネイティブ DOMParser と DOM API を使用してパフォーマンス向上
-- 🔧 **ビルド最適化**: ブラウザ互換性のためのポリフィル除去を含む強化されたビルドプロセス
-- 📚 **ドキュメント更新**: ブラウザ使用例と API リファレンスを追加
+- 🌐 **ブラウザサポート**: ブラウザ用 web 最適化版を追加
+- 📦 **デュアルエントリーポイント**: Node.js/Deno 用（`./mod.ts`）とブラウザ用（`./mod_web.ts`）を分離
+- ⚡ **ネイティブ DOM API**: ブラウザ版は DOMParser 等のネイティブ API で高速化
+- 🔧 **ビルド最適化**: ポリフィル除去等によるビルド強化
+- 📚 **ドキュメント更新**: ブラウザ利用例・API リファレンス追加
 ### v1.0.1
-- ✨ **コア機能**: 完全な HTML ブックマークファイル解析機能
-- 🏗️ **BookmarksTree クラス**: Map インターフェースを持つ階層構造管理
-- 🔄 **双方向変換**: JSON ↔ HTML ↔ DOM 変換サポート
-- 🧪 **包括的テスト**: エッジケースハンドリングを含む完全なテストカバレッジ
-- 📦 **マルチランタイムサポート**: ネイティブ Deno と Node.js 互換性
-- 🔧 **TypeScript サポート**: 完全な型定義と IntelliSense
-- 🤖 **CI/CD パイプライン**: GitHub Actions による自動テストと公開
-- 📚 **ドキュメント**: 例と API リファレンスを含む包括的な README
-- 🌐 **国際化サポート**: Unicode と多言語ブックマークハンドリング
-- ⚡ **パフォーマンス最適化**: 大規模ブックマークコレクションの効率的解析
-- 🛡️ **エラーハンドリング**: 不正な HTML と無効な URL の適切な処理
+- ✨ **コア機能**: HTML ブックマークファイルの完全解析
+- 🏗️ **BookmarksTree クラス**: Map インターフェースによる階層構造管理
+- 🔄 **双方向変換**: JSON↔HTML↔DOM 変換サポート
+- 🧪 **包括的テスト**: エッジケース対応含む完全テストカバレッジ
+- 📦 **マルチランタイム対応**: Deno/Node.js 両対応
+- 🔧 **TypeScript サポート**: 型定義・IntelliSense 完備
+- 🤖 **CI/CD パイプライン**: GitHub Actions による自動テスト・公開
+- 📚 **ドキュメント**: 例・API リファレンス含む README
+- 🌐 **国際化対応**: Unicode・多言語ブックマーク対応
+- ⚡ **パフォーマンス最適化**: 大規模ブックマークも効率的に解析
+- 🛡️ **エラーハンドリング**: 不正 HTML・無効 URL も安全に処理
 ### v0.0.1-pre4
-- 初期のプレリリース版
-- コア機能の概念実証
+- 初期プレリリース
+- コア機能の PoC
 - 基本的な解析実装
-- 初期テスト設定
+- 初期テストセットアップ