netscape-bookmark-parser 1.0.1 → 1.1.0

package/README-ja.md

@@ -10,7 +10,7 @@
 > **注意:**  
 > この README は AI 生成されたドキュメントです。詳細はほぼ正確ですが、不正確な説明が含まれる可能性があります。
 
-ブラウザのブックマークファイル（HTML 形式）を解析し、構造化データとして操作するための TypeScript/JavaScript ライブラリです。Deno と Node.js の両方のランタイムに対応しています。
+ブラウザのブックマークファイル（HTML 形式）を解析し、構造化データとして操作するための TypeScript/JavaScript ライブラリです。Deno、Node.js、**ブラウザ**の全てのランタイムに対応しています。
 
 ## 機能
 
@@ -38,6 +38,13 @@ import {
 } from "jsr:@grakeice/netscape-bookmark-parser";
 ```
 
+### ブラウザ
+
+```typescript
+// ブラウザ環境では、Web最適化版を使用
+import { BookmarksParser, BookmarksTree } from "netscape-bookmark-parser/web";
+```
+
 ## 使用方法
 
 ### 基本的な例
@@ -543,7 +550,24 @@ MIT License - 詳細は[LICENSE](LICENSE)ファイルを参照してください
 
 ## 変更履歴
 
-### v1.0.1（最新）
+### v1.1.0（最新）
+
+- 🌐 **ブラウザサポート**: ブラウザ環境用の Web 最適化版を追加
+- 📦 **デュアルエントリーポイント**: Node.js/Deno 用（`./mod.ts`）とブラウザ用（`./mod_web.ts`）の分離ビルド
+- ⚡ **ネイティブ DOM API**: ブラウザ版はネイティブ DOMParser と DOM API を使用してパフォーマンス向上
+- 🔧 **ビルド最適化**: ブラウザ互換性のためのポリフィル除去を含む強化されたビルドプロセス
+- 📚 **ドキュメント更新**: ブラウザ使用例と API リファレンスを追加
+
+### v1.0.1
 
 - ✨ **コア機能**: 完全な HTML ブックマークファイル解析機能
-- 🏗️ **BookmarksTree クラス**: Map インターフェースを持つ階層
+- 🏗️ **BookmarksTree クラス**: Map インターフェースを持つ階層構造管理
+- 🔄 **双方向変換**: JSON ↔ HTML ↔ DOM 変換サポート
+- 🧪 **包括的テスト**: エッジケースハンドリングを含む完全なテストカバレッジ
+- 📦 **マルチランタイムサポート**: ネイティブ Deno と Node.js 互換性
+- 🔧 **TypeScript サポート**: 完全な型定義と IntelliSense
+- 🤖 **CI/CD パイプライン**: GitHub Actions による自動テストと公開
+- 📚 **ドキュメント**: 例と API リファレンスを含む包括的な README
+- 🌐 **国際化サポート**: Unicode と多言語ブックマークハンドリング
+- ⚡ **パフォーマンス最適化**: 大規模ブックマークコレクションの効率的解析
+- 🛡️ **エラーハンドリング**: 不正な HTML と無効な URL の適切な処理

package/README.md

@@ -40,6 +40,13 @@ import {
 } from "jsr:@grakeice/netscape-bookmark-parser";
 ```
 
+### Browser
+
+```typescript
+// For browser environments, use the web-optimized version
+import { BookmarksParser, BookmarksTree } from "netscape-bookmark-parser/web";
+```
+
 ## Usage
 
 ### Basic Example
@@ -143,6 +150,30 @@ console.log(devFolder.get("GitHub")); // "https://github.com"
 
 ## API Reference
 
+### Web-Optimized Version
+
+The library provides a browser-optimized version that eliminates Node.js dependencies and uses native browser APIs:
+
+```typescript
+// Import browser-optimized version
+import { BookmarksParser, BookmarksTree } from "netscape-bookmark-parser/web";
+
+// Works with browser File API
+document
+	.getElementById("fileInput")
+	.addEventListener("change", async (event) => {
+		const file = event.target.files[0];
+		const htmlContent = await file.text();
+
+		const bookmarksTree = BookmarksParser.parse(htmlContent);
+		console.log(bookmarksTree.toJSON());
+	});
+
+// Use native DOMParser for fromDOM method
+const dom = new DOMParser().parseFromString(htmlContent, "text/html");
+const tree = BookmarksTree.fromDOM(dom);
+```
+
 ### BookmarksParser Class
 
 The [`BookmarksParser`](src/BookmarksParser/BookmarksParser.ts) class provides static methods for parsing HTML bookmark files.
@@ -544,7 +575,15 @@ When reporting issues, please include:
 
 ## Changelog
 
-### v1.0.1 (Latest)
+### v1.1.0 (Latest)
+
+- 🌐 **Browser Support**: Added web-optimized version for browser environments
+- 📦 **Dual Entry Points**: Separate builds for Node.js/Deno (`./mod.ts`) and browsers (`./mod_web.ts`)
+- ⚡ **Native DOM APIs**: Browser version uses native DOMParser and DOM APIs for better performance
+- 🔧 **Build Optimization**: Enhanced build process with polyfill removal for browser compatibility
+- 📚 **Updated Documentation**: Added browser usage examples and API reference
+
+### v1.0.1
 
 - ✨ **Core Features**: Complete HTML bookmark file parsing functionality
 - 🏗️ **BookmarksTree Class**: Hierarchical structure management with Map interface

package/esm/mod_web.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+export { BookmarksTree } from "./src/web/BookmarksTree/index.js";
+export { BookmarksParser } from "./src/web/BookmarksParser/index.js";
+//# sourceMappingURL=mod_web.d.ts.map

package/esm/mod_web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod_web.d.ts","sourceRoot":"","sources":["../src/mod_web.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC"}

package/esm/mod_web.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+export { BookmarksTree } from "./src/web/BookmarksTree/index.js";
+export { BookmarksParser } from "./src/web/BookmarksParser/index.js";

package/esm/src/BookmarksParser/BookmarksParser.js

@@ -4,7 +4,7 @@
  * This software is released under the MIT License.
  * https://opensource.org/licenses/MIT
  */
-import { DOMParser } from "../../deps/jsr.io/@b-fuze/deno-dom/0.1.49/deno-dom-wasm.js";
+import { DOMParser } from "../deps.js";
 import { BookmarksTree } from "../BookmarksTree/index.js";
 export class BookmarksParser {
     static parse(data) {

package/esm/src/BookmarksTree/BookmarksTree.d.ts

@@ -4,7 +4,7 @@
  * This software is released under the MIT License.
  * https://opensource.org/licenses/MIT
  */
-import { type HTMLDocument } from "../../deps/jsr.io/@b-fuze/deno-dom/0.1.49/deno-dom-wasm.js";
+import { type HTMLDocument } from "../deps.js";
 export declare class BookmarksTree extends Map<string, string | BookmarksTree> {
     constructor();
     toJSON(): Record<string, unknown>;

package/esm/src/BookmarksTree/BookmarksTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BookmarksTree.d.ts","sourceRoot":"","sources":["../../../src/src/BookmarksTree/BookmarksTree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,4DAA4D,CAAC;AAExH,qBAAa,aAAc,SAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;;IAKrE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAcjC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa;IAmB7D,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,aAAa;IA8ChD,KAAK,IAAI,YAAY;IAIrB,IAAI,QAAQ,IAAI,MAAM,CAoCrB;CACD"}
+{"version":3,"file":"BookmarksTree.d.ts","sourceRoot":"","sources":["../../../src/src/BookmarksTree/BookmarksTree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAExE,qBAAa,aAAc,SAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;;IAKrE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAcjC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa;IAmB7D,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,aAAa;IA8ChD,KAAK,IAAI,YAAY;IAIrB,IAAI,QAAQ,IAAI,MAAM,CAoCrB;CACD"}

package/esm/src/BookmarksTree/BookmarksTree.js

@@ -4,7 +4,7 @@
  * This software is released under the MIT License.
  * https://opensource.org/licenses/MIT
  */
-import { DOMParser } from "../../deps/jsr.io/@b-fuze/deno-dom/0.1.49/deno-dom-wasm.js";
+import { DOMParser } from "../deps.js";
 export class BookmarksTree extends Map {
     constructor() {
         super();

package/esm/src/deps.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+export { DOMParser } from "../deps/jsr.io/@b-fuze/deno-dom/0.1.49/deno-dom-wasm.js";
+export type { Element, HTMLDocument } from "../deps/jsr.io/@b-fuze/deno-dom/0.1.49/deno-dom-wasm.js";
+//# sourceMappingURL=deps.d.ts.map

package/esm/src/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/src/deps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yDAAyD,CAAC;AACpF,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,yDAAyD,CAAC"}

package/esm/src/deps.js

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+export { DOMParser } from "../deps/jsr.io/@b-fuze/deno-dom/0.1.49/deno-dom-wasm.js";

package/esm/src/web/BookmarksParser/BookmarksParser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+import { BookmarksTree } from "../BookmarksTree/index.js";
+export declare class BookmarksParser {
+    static parse(data: string): BookmarksTree;
+}
+//# sourceMappingURL=BookmarksParser.d.ts.map

package/esm/src/web/BookmarksParser/BookmarksParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BookmarksParser.d.ts","sourceRoot":"","sources":["../../../../src/src/web/BookmarksParser/BookmarksParser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,qBAAa,eAAe;IAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;CAKzC"}

package/esm/src/web/BookmarksParser/BookmarksParser.js

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+import { DOMParser } from "../deps.js";
+import { BookmarksTree } from "../BookmarksTree/index.js";
+export class BookmarksParser {
+    static parse(data) {
+        const dom = new DOMParser().parseFromString(data, "text/html");
+        const tree = BookmarksTree.fromDOM(dom);
+        return tree;
+    }
+}

package/esm/src/web/BookmarksParser/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+export { BookmarksParser } from "./BookmarksParser.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/web/BookmarksParser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/web/BookmarksParser/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/esm/src/web/BookmarksParser/index.js

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+export { BookmarksParser } from "./BookmarksParser.js";

package/esm/src/web/BookmarksTree/BookmarksTree.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+import { type HTMLDocument } from "../deps.js";
+export declare class BookmarksTree extends Map<string, string | BookmarksTree> {
+    constructor();
+    toJSON(): Record<string, unknown>;
+    static fromJSON(json: Record<string, unknown>): BookmarksTree;
+    static fromDOM(dom: HTMLDocument): BookmarksTree;
+    toDOM(): HTMLDocument;
+    get HTMLText(): string;
+}
+//# sourceMappingURL=BookmarksTree.d.ts.map

package/esm/src/web/BookmarksTree/BookmarksTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BookmarksTree.d.ts","sourceRoot":"","sources":["../../../../src/src/web/BookmarksTree/BookmarksTree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAExE,qBAAa,aAAc,SAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;;IAKrE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAcjC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa;IAmB7D,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,aAAa;IA8ChD,KAAK,IAAI,YAAY;IAIrB,IAAI,QAAQ,IAAI,MAAM,CAoCrB;CACD"}

package/esm/src/web/BookmarksTree/BookmarksTree.js

@@ -0,0 +1,113 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+import { DOMParser } from "../deps.js";
+export class BookmarksTree extends Map {
+    constructor() {
+        super();
+    }
+    toJSON() {
+        const json = {};
+        for (const [key, value] of this.entries()) {
+            if (typeof value === "string") {
+                json[key] = value;
+            }
+            else if (value instanceof BookmarksTree) {
+                json[key] = value.toJSON();
+            }
+        }
+        return json;
+    }
+    static fromJSON(json) {
+        const tree = new BookmarksTree();
+        if (typeof json === "object" && json !== null) {
+            for (const [key, value] of Object.entries(json)) {
+                if (typeof value === "string") {
+                    tree.set(key, value);
+                }
+                else if (typeof value === "object" && value !== null) {
+                    tree.set(key, BookmarksTree.fromJSON(value));
+                }
+            }
+        }
+        return tree;
+    }
+    static fromDOM(dom) {
+        const tree = new BookmarksTree();
+        const document = dom;
+        const processElement = (element, currentTree) => {
+            const children = Array.from(element.children);
+            for (let i = 0; i < children.length; i++) {
+                const child = children[i];
+                if (child.tagName === "DT") {
+                    const h3 = child.querySelector("h3");
+                    const link = child.querySelector("a");
+                    if (h3) {
+                        // フォルダの場合
+                        const folderName = h3.textContent?.trim() || "";
+                        if (folderName) {
+                            const folderTree = new BookmarksTree();
+                            currentTree.set(folderName, folderTree);
+                            processElement(child, folderTree);
+                        }
+                    }
+                    else if (link) {
+                        // リンクの場合
+                        const href = link.getAttribute("href");
+                        const title = link.textContent?.trim() || "";
+                        if (href && title) {
+                            currentTree.set(title, href);
+                        }
+                    }
+                }
+                else if (child.tagName === "DL") {
+                    // ネストしたDLタグの場合も処理
+                    processElement(child, currentTree);
+                }
+            }
+        };
+        // HTMLのBODY全体から処理を開始
+        const body = document.body;
+        if (body) {
+            processElement(body, tree);
+        }
+        return tree;
+    }
+    toDOM() {
+        return new DOMParser().parseFromString(this.HTMLText, "text/html");
+    }
+    get HTMLText() {
+        const createBookmarkList = (tree, indent = "") => {
+            let html = `${indent}<DL><p>\n`;
+            for (const [key, value] of tree.entries()) {
+                if (typeof value === "string") {
+                    // ブックマークの場合: <DT><A HREF="url">タイトル</A>
+                    html += `${indent}    <DT><A HREF="${value}">${key}</A>\n`;
+                }
+                else if (value instanceof BookmarksTree) {
+                    // フォルダの場合: <DT><H3>フォルダ名</H3>
+                    html += `${indent}    <DT><H3>${key}</H3>\n`;
+                    html += createBookmarkList(value, indent + "    ");
+                    html += `${indent}    </DL><p>\n`;
+                }
+            }
+            if (indent === "") {
+                // ルートレベルの場合は閉じタグを追加
+                html += `</DL>\n`;
+            }
+            return html;
+        };
+        const htmlTemplate = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
+<HTML>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
+<TITLE>Bookmark</TITLE>
+<H1>Bookmark</H1>
+<BODY>
+${createBookmarkList(this)}</BODY>
+</HTML>`;
+        return htmlTemplate;
+    }
+}

package/esm/src/web/BookmarksTree/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+export { BookmarksTree } from "./BookmarksTree.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/web/BookmarksTree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/web/BookmarksTree/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/esm/src/web/BookmarksTree/index.js

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+export { BookmarksTree } from "./BookmarksTree.js";

package/esm/src/web/deps.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+export declare const DOMParser: any;
+export type Element = globalThis.Element;
+export type HTMLDocument = globalThis.HTMLDocument;
+//# sourceMappingURL=deps.d.ts.map

package/esm/src/web/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/src/web/deps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,SAAS,KAAuB,CAAC;AAC9C,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;AACzC,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC"}

package/esm/src/web/deps.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2025 grakeice
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+// deno-lint-ignore ban-ts-comment
+// @ts-nocheck
+export const DOMParser = globalThis.DOMParser;

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "netscape-bookmark-parser",
-  "version": "1.0.1",
+  "version": "1.1.0",
+  "keywords": [
+    "bookmark",
+    "parser",
+    "netscape"
+  ],
   "author": "grakeice",
   "repository": "https://github.com/grakeice/netscape-bookmark-parser",
   "license": "MIT",
@@ -8,6 +13,9 @@
   "exports": {
     ".": {
       "import": "./esm/mod.js"
+    },
+    "./web": {
+      "import": "./esm/mod_web.js"
     }
   },
   "scripts": {},