netscape-bookmark-parser 1.1.4 → 1.2.2

package/dist/index.js

@@ -0,0 +1,347 @@
+import { DOMParser } from "@b-fuze/deno-dom";
+//#region src/dom.ts
+let DOMParser$1 = globalThis.DOMParser;
+const setDOMParser = (parser) => {
+	DOMParser$1 = parser;
+};
+//#endregion
+//#region src/node-dom.ts
+/**
+* Copyright (c) 2025-2026 kurage(@umitsukidev)
+*
+* This software is released under the MIT License.
+* https://opensource.org/licenses/MIT
+*/
+setDOMParser(DOMParser);
+//#endregion
+//#region src/BookmarksTree/BookmarksTree.ts
+/**
+* Copyright (c) 2025-2026 kurage(@umitsukidev)
+*
+* This software is released under the MIT License.
+* https://opensource.org/licenses/MIT
+*/
+/**
+* A class representing a bookmark tree in Netscape Bookmark format
+*
+* This class extends Map and manages folders (BookmarksTree) and bookmarks (URL strings)
+* in a hierarchical structure.
+*
+* @example
+* ```typescript
+* const tree = new BookmarksTree();
+* tree.set("Google", "https://google.com");
+*
+* const folder = new BookmarksTree();
+* folder.set("GitHub", "https://github.com");
+* tree.set("Development", folder);
+* ```
+*/
+var BookmarksTree = class BookmarksTree extends Map {
+	/**
+	* Creates a new BookmarksTree instance
+	*/
+	constructor() {
+		super();
+	}
+	/**
+	* Converts the BookmarksTree to a JSON object
+	*
+	* Folders are recursively converted to objects, and bookmarks are preserved as strings.
+	*
+	* @returns JSON object representation of the bookmark data
+	*
+	* @example
+	* ```typescript
+	* const tree = new BookmarksTree();
+	* tree.set("Google", "https://google.com");
+	* const json = tree.toJSON();
+	* // { "Google": "https://google.com" }
+	* ```
+	*/
+	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;
+	}
+	/**
+	* Creates a BookmarksTree from a JSON object
+	*
+	* String properties are treated as bookmarks, and object properties are
+	* recursively processed as folders.
+	*
+	* @param json The source JSON object to convert
+	* @returns A new BookmarksTree instance
+	*
+	* @example
+	* ```typescript
+	* const json = { "Google": "https://google.com", "Development": { "GitHub": "https://github.com" } };
+	* const tree = BookmarksTree.fromJSON(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;
+	}
+	/**
+	* Creates a BookmarksTree from an HTML document (Netscape Bookmark format)
+	*
+	* Parses Netscape Bookmark format HTML and generates a BookmarksTree that preserves
+	* the hierarchical structure. H3 elements within DT elements are treated as folders,
+	* and A elements are treated as bookmarks.
+	*
+	* @param dom The HTML document to parse
+	* @returns A new BookmarksTree instance
+	*
+	* @example
+	* ```typescript
+	* const parser = new DOMParser();
+	* const dom = parser.parseFromString(bookmarkHtml, "text/html");
+	* const tree = BookmarksTree.fromDOM(dom);
+	* ```
+	*/
+	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") processElement(child, currentTree);
+			}
+		};
+		const body = document.body;
+		if (body) processElement(body, tree);
+		return tree;
+	}
+	/**
+	* Converts the BookmarksTree to an HTML document
+	*
+	* Generates an HTML document in Netscape Bookmark format.
+	*
+	* @returns HTML document in Netscape Bookmark format
+	*
+	* @example
+	* ```typescript
+	* const tree = new BookmarksTree();
+	* tree.set("Google", "https://google.com");
+	* const dom = tree.toDOM();
+	* ```
+	*/
+	toDOM() {
+		return new DOMParser$1().parseFromString(this.HTMLString, "text/html");
+	}
+	/**
+	* Gets the BookmarksTree as an HTML string in Netscape Bookmark format
+	*
+	* Generates a complete HTML document string including DOCTYPE, metadata, and body
+	* in Netscape Bookmark format.
+	*
+	* @returns HTML string in Netscape Bookmark format
+	*
+	* @example
+	* ```typescript
+	* const tree = new BookmarksTree();
+	* tree.set("Google", "https://google.com");
+	* const html = tree.HTMLString;
+	* console.log(html); // <!DOCTYPE NETSCAPE-Bookmark-file-1>...
+	* ```
+	*/
+	get HTMLString() {
+		const escapeHtml = (text) => {
+			return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+		};
+		const createBookmarkList = (tree, indent = "") => {
+			let html = `${indent}<DL><p>\n`;
+			for (const [key, value] of tree.entries()) if (typeof value === "string") html += `${indent}    <DT><A HREF="${escapeHtml(value)}">${escapeHtml(key)}</A>\n`;
+			else if (value instanceof BookmarksTree) {
+				html += `${indent}    <DT><H3>${escapeHtml(key)}</H3>\n`;
+				html += createBookmarkList(value, indent + "    ");
+				html += `${indent}    </DL><p>\n`;
+			}
+			if (indent === "") html += `</DL>\n`;
+			return html;
+		};
+		return `<!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>`;
+	}
+	/**
+	* @deprecated Use {@link HTMLString} instead.
+	*
+	* Gets the BookmarksTree as an HTML string in Netscape Bookmark format.
+	*/
+	get HTMLText() {
+		return this.HTMLString;
+	}
+};
+//#endregion
+//#region src/BookmarksParser/BookmarksParser.ts
+/**
+* Copyright (c) 2025-2026 kurage(@umitsukidev)
+*
+* This software is released under the MIT License.
+* https://opensource.org/licenses/MIT
+*/
+/**
+* A parser for Netscape Bookmark format files
+*
+* This class provides static methods to parse Netscape Bookmark format HTML strings
+* and convert them into BookmarksTree instances for easier manipulation.
+*
+* @example
+* ```typescript
+* const bookmarkHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
+* <HTML>
+* <BODY>
+* <DL><p>
+*     <DT><A HREF="https://google.com">Google</A>
+*     <DT><H3>Development</H3>
+*     <DL><p>
+*         <DT><A HREF="https://github.com">GitHub</A>
+*     </DL><p>
+* </DL>
+* </BODY>
+* </HTML>`;
+*
+* const tree = BookmarksParser.parse(bookmarkHtml);
+* ```
+*/
+var BookmarksParser = class {
+	/**
+	* Alias for the {@link parseFromHTMLString} method.
+	*
+	* @param htmlString HTML string in Netscape Bookmark format
+	* @returns The parsed BookmarksTree
+	*
+	* @example
+	* ```typescript
+	* const bookmarkHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
+	* <HTML>
+	* <BODY>
+	* <DL><p>
+	*     <DT><A HREF="https://google.com">Google</A>
+	*     <DT><H3>Development</H3>
+	*     <DL><p>
+	*         <DT><A HREF="https://github.com">GitHub</A>
+	*     </DL><p>
+	* </DL>
+	* </BODY>
+	* </HTML>`;
+	*
+	* const tree = BookmarksParser.parse(bookmarkHtml);
+	* ```
+	*/
+	static parse(htmlString) {
+		return this.parseFromHTMLString(htmlString);
+	}
+	/**
+	* Parses a Netscape Bookmark format HTML string and returns a BookmarksTree.
+	*
+	* @param htmlString HTML string in Netscape Bookmark format
+	* @returns The parsed BookmarksTree
+	*
+	* @example
+	* ```typescript
+	* const bookmarkHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
+	* <HTML>
+	* <BODY>
+	* <DL><p>
+	*     <DT><A HREF="https://google.com">Google</A>
+	*     <DT><H3>Development</H3>
+	*     <DL><p>
+	*         <DT><A HREF="https://github.com">GitHub</A>
+	*     </DL><p>
+	* </DL>
+	* </BODY>
+	* </HTML>`;
+	*
+	* const tree = BookmarksParser.parseFromHTMLString(bookmarkHtml);
+	* ```
+	*/
+	static parseFromHTMLString(htmlString) {
+		const dom = new DOMParser$1().parseFromString(htmlString, "text/html");
+		return BookmarksTree.fromDOM(dom);
+	}
+	/**
+	* Creates a BookmarksTree from an existing HTMLDocument.
+	*
+	* This is an alias for {@link BookmarksTree.fromDOM}.
+	*
+	* Use this when you already have a parsed HTMLDocument and want to convert it to a BookmarksTree.
+	*
+	* @param dom An HTMLDocument instance
+	* @returns The parsed BookmarksTree
+	*
+	* @example
+	* ```typescript
+	* const dom = new DOMParser().parseFromString(bookmarkHtml, "text/html");
+	* const tree = BookmarksParser.parseFromDOM(dom);
+	* ```
+	*/
+	static parseFromDOM(dom) {
+		return BookmarksTree.fromDOM(dom);
+	}
+	/**
+	* Parses a JSON string and returns a BookmarksTree.
+	*
+	* @param jsonString JSON string representing the bookmark structure
+	* @returns The parsed BookmarksTree
+	*
+	* @example
+	* ```typescript
+	* const json = '{"Google":"https://google.com","Development":{"GitHub":"https://github.com"}}';
+	* const tree = BookmarksParser.parseFromJSONString(json);
+	* ```
+	*/
+	static parseFromJSONString(jsonString) {
+		const obj = JSON.parse(jsonString);
+		return BookmarksTree.fromJSON(obj);
+	}
+	/**
+	* Parses a JSON object and returns a BookmarksTree.
+	*
+	* This is an alias for {@link BookmarksTree.fromJSON}.
+	*
+	* @param jsonObj JSON object representing the bookmark structure
+	* @returns The parsed BookmarksTree
+	*
+	* @example
+	* ```typescript
+	* const obj = { "Google": "https://google.com", "Development": { "GitHub": "https://github.com" } };
+	* const tree = BookmarksParser.parseFromJSON(obj);
+	* ```
+	*/
+	static parseFromJSON(jsonObj) {
+		return BookmarksTree.fromJSON(jsonObj);
+	}
+};
+//#endregion
+export { BookmarksParser, BookmarksTree };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["DOMParser","NodeDOMParser","DOMParser","DOMParser"],"sources":["../src/dom.ts","../src/node-dom.ts","../src/BookmarksTree/BookmarksTree.ts","../src/BookmarksParser/BookmarksParser.ts"],"sourcesContent":["/**\n * Copyright (c) 2025-2026 kurage(@umitsukidev)\n *\n * This software is released under the MIT License.\n * https://opensource.org/licenses/MIT\n */\n\nimport type { DOMParser as NodeDOMParser } from \"@b-fuze/deno-dom\";\n\nexport let DOMParser: typeof NodeDOMParser =\n\tglobalThis.DOMParser as unknown as typeof NodeDOMParser;\n\nexport const setDOMParser = (parser: typeof NodeDOMParser): void => {\n\tDOMParser = parser;\n};\n","/**\n * Copyright (c) 2025-2026 kurage(@umitsukidev)\n *\n * This software is released under the MIT License.\n * https://opensource.org/licenses/MIT\n */\n\nimport { DOMParser as NodeDOMParser } from \"@b-fuze/deno-dom\";\nimport { setDOMParser } from \"./dom.ts\";\n\nsetDOMParser(NodeDOMParser);\n","/**\n * Copyright (c) 2025-2026 kurage(@umitsukidev)\n *\n * This software is released under the MIT License.\n * https://opensource.org/licenses/MIT\n */\n\nimport { DOMParser } from \"../dom.ts\";\nimport type { Element, HTMLDocument } from \"#dom-types\";\n\n/**\n * A class representing a bookmark tree in Netscape Bookmark format\n *\n * This class extends Map and manages folders (BookmarksTree) and bookmarks (URL strings)\n * in a hierarchical structure.\n *\n * @example\n * ```typescript\n * const tree = new BookmarksTree();\n * tree.set(\"Google\", \"https://google.com\");\n *\n * const folder = new BookmarksTree();\n * folder.set(\"GitHub\", \"https://github.com\");\n * tree.set(\"Development\", folder);\n * ```\n */\nexport class BookmarksTree extends Map<string, string | BookmarksTree> {\n\t/**\n\t * Creates a new BookmarksTree instance\n\t */\n\tconstructor() {\n\t\tsuper();\n\t}\n\n\t/**\n\t * Converts the BookmarksTree to a JSON object\n\t *\n\t * Folders are recursively converted to objects, and bookmarks are preserved as strings.\n\t *\n\t * @returns JSON object representation of the bookmark data\n\t *\n\t * @example\n\t * ```typescript\n\t * const tree = new BookmarksTree();\n\t * tree.set(\"Google\", \"https://google.com\");\n\t * const json = tree.toJSON();\n\t * // { \"Google\": \"https://google.com\" }\n\t * ```\n\t */\n\ttoJSON(): Record<string, unknown> {\n\t\tconst json: Record<string, unknown> = {};\n\n\t\tfor (const [key, value] of this.entries()) {\n\t\t\tif (typeof value === \"string\") {\n\t\t\t\tjson[key] = value;\n\t\t\t} else if (value instanceof BookmarksTree) {\n\t\t\t\tjson[key] = value.toJSON();\n\t\t\t}\n\t\t}\n\n\t\treturn json;\n\t}\n\n\t/**\n\t * Creates a BookmarksTree from a JSON object\n\t *\n\t * String properties are treated as bookmarks, and object properties are\n\t * recursively processed as folders.\n\t *\n\t * @param json The source JSON object to convert\n\t * @returns A new BookmarksTree instance\n\t *\n\t * @example\n\t * ```typescript\n\t * const json = { \"Google\": \"https://google.com\", \"Development\": { \"GitHub\": \"https://github.com\" } };\n\t * const tree = BookmarksTree.fromJSON(json);\n\t * ```\n\t */\n\tstatic fromJSON(json: Record<string, unknown>): BookmarksTree {\n\t\tconst tree = new BookmarksTree();\n\n\t\tif (typeof json === \"object\" && json !== null) {\n\t\t\tfor (const [key, value] of Object.entries(json)) {\n\t\t\t\tif (typeof value === \"string\") {\n\t\t\t\t\ttree.set(key, value);\n\t\t\t\t} else if (typeof value === \"object\" && value !== null) {\n\t\t\t\t\ttree.set(key, BookmarksTree.fromJSON(value as Record<string, unknown>));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn tree;\n\t}\n\n\t/**\n\t * Creates a BookmarksTree from an HTML document (Netscape Bookmark format)\n\t *\n\t * Parses Netscape Bookmark format HTML and generates a BookmarksTree that preserves\n\t * the hierarchical structure. H3 elements within DT elements are treated as folders,\n\t * and A elements are treated as bookmarks.\n\t *\n\t * @param dom The HTML document to parse\n\t * @returns A new BookmarksTree instance\n\t *\n\t * @example\n\t * ```typescript\n\t * const parser = new DOMParser();\n\t * const dom = parser.parseFromString(bookmarkHtml, \"text/html\");\n\t * const tree = BookmarksTree.fromDOM(dom);\n\t * ```\n\t */\n\tstatic fromDOM(dom: HTMLDocument): BookmarksTree {\n\t\tconst tree = new BookmarksTree();\n\t\tconst document = dom;\n\n\t\tconst processElement = (element: Element, currentTree: BookmarksTree) => {\n\t\t\tconst children = Array.from(element.children) as Element[];\n\n\t\t\tfor (let i = 0; i < children.length; i++) {\n\t\t\t\tconst child = children[i];\n\n\t\t\t\tif (child.tagName === \"DT\") {\n\t\t\t\t\tconst h3 = child.querySelector(\"h3\");\n\t\t\t\t\tconst link = child.querySelector(\"a\");\n\n\t\t\t\t\tif (h3) {\n\t\t\t\t\t\t// フォルダの場合\n\t\t\t\t\t\tconst folderName = h3.textContent?.trim() || \"\";\n\t\t\t\t\t\tif (folderName) {\n\t\t\t\t\t\t\tconst folderTree = new BookmarksTree();\n\t\t\t\t\t\t\tcurrentTree.set(folderName, folderTree);\n\t\t\t\t\t\t\tprocessElement(child, folderTree);\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (link) {\n\t\t\t\t\t\t// リンクの場合\n\t\t\t\t\t\tconst href = link.getAttribute(\"href\");\n\t\t\t\t\t\tconst title = link.textContent?.trim() || \"\";\n\t\t\t\t\t\tif (href && title) {\n\t\t\t\t\t\t\tcurrentTree.set(title, href);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t} else if (child.tagName === \"DL\") {\n\t\t\t\t\t// ネストしたDLタグの場合も処理\n\t\t\t\t\tprocessElement(child, currentTree);\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\n\t\t// HTMLのBODY全体から処理を開始\n\t\tconst body = document.body;\n\t\tif (body) {\n\t\t\tprocessElement(body, tree);\n\t\t}\n\n\t\treturn tree;\n\t}\n\n\t/**\n\t * Converts the BookmarksTree to an HTML document\n\t *\n\t * Generates an HTML document in Netscape Bookmark format.\n\t *\n\t * @returns HTML document in Netscape Bookmark format\n\t *\n\t * @example\n\t * ```typescript\n\t * const tree = new BookmarksTree();\n\t * tree.set(\"Google\", \"https://google.com\");\n\t * const dom = tree.toDOM();\n\t * ```\n\t */\n\ttoDOM(): HTMLDocument {\n\t\treturn new DOMParser().parseFromString(this.HTMLString, \"text/html\");\n\t}\n\n\t/**\n\t * Gets the BookmarksTree as an HTML string in Netscape Bookmark format\n\t *\n\t * Generates a complete HTML document string including DOCTYPE, metadata, and body\n\t * in Netscape Bookmark format.\n\t *\n\t * @returns HTML string in Netscape Bookmark format\n\t *\n\t * @example\n\t * ```typescript\n\t * const tree = new BookmarksTree();\n\t * tree.set(\"Google\", \"https://google.com\");\n\t * const html = tree.HTMLString;\n\t * console.log(html); // <!DOCTYPE NETSCAPE-Bookmark-file-1>...\n\t * ```\n\t */\n\tget HTMLString(): string {\n\t\tconst escapeHtml = (text: string): string => {\n\t\t\treturn text\n\t\t\t\t.replace(/&/g, \"&amp;\")\n\t\t\t\t.replace(/</g, \"&lt;\")\n\t\t\t\t.replace(/>/g, \"&gt;\")\n\t\t\t\t.replace(/\"/g, \"&quot;\")\n\t\t\t\t.replace(/'/g, \"&#39;\");\n\t\t};\n\n\t\tconst createBookmarkList = (tree: BookmarksTree, indent: string = \"\"): string => {\n\t\t\tlet html = `${indent}<DL><p>\\n`;\n\n\t\t\tfor (const [key, value] of tree.entries()) {\n\t\t\t\tif (typeof value === \"string\") {\n\t\t\t\t\t// ブックマークの場合: <DT><A HREF=\"url\">タイトル</A>\n\t\t\t\t\thtml += `${indent}    <DT><A HREF=\"${escapeHtml(value)}\">${escapeHtml(key)}</A>\\n`;\n\t\t\t\t} else if (value instanceof BookmarksTree) {\n\t\t\t\t\t// フォルダの場合: <DT><H3>フォルダ名</H3>\n\t\t\t\t\thtml += `${indent}    <DT><H3>${escapeHtml(key)}</H3>\\n`;\n\t\t\t\t\thtml += createBookmarkList(value, indent + \"    \");\n\t\t\t\t\thtml += `${indent}    </DL><p>\\n`;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (indent === \"\") {\n\t\t\t\t// ルートレベルの場合は閉じタグを追加\n\t\t\t\thtml += `</DL>\\n`;\n\t\t\t}\n\n\t\t\treturn html;\n\t\t};\n\n\t\tconst htmlTemplate = `<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<HTML>\n<META HTTP-EQUIV=\"Content-Type\" CONTENT=\"text/html; charset=UTF-8\">\n<TITLE>Bookmark</TITLE>\n<H1>Bookmark</H1>\n<BODY>\n${createBookmarkList(this)}</BODY>\n</HTML>`;\n\t\treturn htmlTemplate;\n\t}\n\n\t/**\n\t * @deprecated Use {@link HTMLString} instead.\n\t *\n\t * Gets the BookmarksTree as an HTML string in Netscape Bookmark format.\n\t */\n\tget HTMLText(): string {\n\t\treturn this.HTMLString;\n\t}\n}\n","/**\n * Copyright (c) 2025-2026 kurage(@umitsukidev)\n *\n * This software is released under the MIT License.\n * https://opensource.org/licenses/MIT\n */\n\nimport { DOMParser } from \"../dom.ts\";\nimport type { HTMLDocument } from \"#dom-types\";\nimport { BookmarksTree } from \"../BookmarksTree/index.ts\";\n\n/**\n * A parser for Netscape Bookmark format files\n *\n * This class provides static methods to parse Netscape Bookmark format HTML strings\n * and convert them into BookmarksTree instances for easier manipulation.\n *\n * @example\n * ```typescript\n * const bookmarkHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>\n * <HTML>\n * <BODY>\n * <DL><p>\n *     <DT><A HREF=\"https://google.com\">Google</A>\n *     <DT><H3>Development</H3>\n *     <DL><p>\n *         <DT><A HREF=\"https://github.com\">GitHub</A>\n *     </DL><p>\n * </DL>\n * </BODY>\n * </HTML>`;\n *\n * const tree = BookmarksParser.parse(bookmarkHtml);\n * ```\n */\nexport class BookmarksParser {\n\t/**\n\t * Alias for the {@link parseFromHTMLString} method.\n\t *\n\t * @param htmlString HTML string in Netscape Bookmark format\n\t * @returns The parsed BookmarksTree\n\t *\n\t * @example\n\t * ```typescript\n\t * const bookmarkHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>\n\t * <HTML>\n\t * <BODY>\n\t * <DL><p>\n\t *     <DT><A HREF=\"https://google.com\">Google</A>\n\t *     <DT><H3>Development</H3>\n\t *     <DL><p>\n\t *         <DT><A HREF=\"https://github.com\">GitHub</A>\n\t *     </DL><p>\n\t * </DL>\n\t * </BODY>\n\t * </HTML>`;\n\t *\n\t * const tree = BookmarksParser.parse(bookmarkHtml);\n\t * ```\n\t */\n\tstatic parse(htmlString: string): BookmarksTree {\n\t\treturn this.parseFromHTMLString(htmlString);\n\t}\n\n\t/**\n\t * Parses a Netscape Bookmark format HTML string and returns a BookmarksTree.\n\t *\n\t * @param htmlString HTML string in Netscape Bookmark format\n\t * @returns The parsed BookmarksTree\n\t *\n\t * @example\n\t * ```typescript\n\t * const bookmarkHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>\n\t * <HTML>\n\t * <BODY>\n\t * <DL><p>\n\t *     <DT><A HREF=\"https://google.com\">Google</A>\n\t *     <DT><H3>Development</H3>\n\t *     <DL><p>\n\t *         <DT><A HREF=\"https://github.com\">GitHub</A>\n\t *     </DL><p>\n\t * </DL>\n\t * </BODY>\n\t * </HTML>`;\n\t *\n\t * const tree = BookmarksParser.parseFromHTMLString(bookmarkHtml);\n\t * ```\n\t */\n\tstatic parseFromHTMLString(htmlString: string): BookmarksTree {\n\t\tconst dom = new DOMParser().parseFromString(htmlString, \"text/html\");\n\t\tconst tree = BookmarksTree.fromDOM(dom);\n\t\treturn tree;\n\t}\n\n\t/**\n\t * Creates a BookmarksTree from an existing HTMLDocument.\n\t *\n\t * This is an alias for {@link BookmarksTree.fromDOM}.\n\t *\n\t * Use this when you already have a parsed HTMLDocument and want to convert it to a BookmarksTree.\n\t *\n\t * @param dom An HTMLDocument instance\n\t * @returns The parsed BookmarksTree\n\t *\n\t * @example\n\t * ```typescript\n\t * const dom = new DOMParser().parseFromString(bookmarkHtml, \"text/html\");\n\t * const tree = BookmarksParser.parseFromDOM(dom);\n\t * ```\n\t */\n\tstatic parseFromDOM(dom: HTMLDocument): BookmarksTree {\n\t\treturn BookmarksTree.fromDOM(dom);\n\t}\n\n\t/**\n\t * Parses a JSON string and returns a BookmarksTree.\n\t *\n\t * @param jsonString JSON string representing the bookmark structure\n\t * @returns The parsed BookmarksTree\n\t *\n\t * @example\n\t * ```typescript\n\t * const json = '{\"Google\":\"https://google.com\",\"Development\":{\"GitHub\":\"https://github.com\"}}';\n\t * const tree = BookmarksParser.parseFromJSONString(json);\n\t * ```\n\t */\n\tstatic parseFromJSONString(jsonString: string): BookmarksTree {\n\t\tconst obj = JSON.parse(jsonString);\n\t\treturn BookmarksTree.fromJSON(obj);\n\t}\n\n\t/**\n\t * Parses a JSON object and returns a BookmarksTree.\n\t *\n\t * This is an alias for {@link BookmarksTree.fromJSON}.\n\t *\n\t * @param jsonObj JSON object representing the bookmark structure\n\t * @returns The parsed BookmarksTree\n\t *\n\t * @example\n\t * ```typescript\n\t * const obj = { \"Google\": \"https://google.com\", \"Development\": { \"GitHub\": \"https://github.com\" } };\n\t * const tree = BookmarksParser.parseFromJSON(obj);\n\t * ```\n\t */\n\tstatic parseFromJSON(jsonObj: Record<string, unknown>): BookmarksTree {\n\t\treturn BookmarksTree.fromJSON(jsonObj);\n\t}\n}\n"],"mappings":"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"}

package/dist/web.d.ts

@@ -0,0 +1,239 @@
+//#region src/web-dom-types.d.ts
+type HTMLDocument = globalThis.HTMLDocument;
+//#endregion
+//#region src/BookmarksTree/BookmarksTree.d.ts
+/**
+ * A class representing a bookmark tree in Netscape Bookmark format
+ *
+ * This class extends Map and manages folders (BookmarksTree) and bookmarks (URL strings)
+ * in a hierarchical structure.
+ *
+ * @example
+ * ```typescript
+ * const tree = new BookmarksTree();
+ * tree.set("Google", "https://google.com");
+ *
+ * const folder = new BookmarksTree();
+ * folder.set("GitHub", "https://github.com");
+ * tree.set("Development", folder);
+ * ```
+ */
+export declare class BookmarksTree extends Map<string, string | BookmarksTree> {
+  /**
+   * Creates a new BookmarksTree instance
+   */
+  constructor();
+  /**
+   * Converts the BookmarksTree to a JSON object
+   *
+   * Folders are recursively converted to objects, and bookmarks are preserved as strings.
+   *
+   * @returns JSON object representation of the bookmark data
+   *
+   * @example
+   * ```typescript
+   * const tree = new BookmarksTree();
+   * tree.set("Google", "https://google.com");
+   * const json = tree.toJSON();
+   * // { "Google": "https://google.com" }
+   * ```
+   */
+  toJSON(): Record<string, unknown>;
+  /**
+   * Creates a BookmarksTree from a JSON object
+   *
+   * String properties are treated as bookmarks, and object properties are
+   * recursively processed as folders.
+   *
+   * @param json The source JSON object to convert
+   * @returns A new BookmarksTree instance
+   *
+   * @example
+   * ```typescript
+   * const json = { "Google": "https://google.com", "Development": { "GitHub": "https://github.com" } };
+   * const tree = BookmarksTree.fromJSON(json);
+   * ```
+   */
+  static fromJSON(json: Record<string, unknown>): BookmarksTree;
+  /**
+   * Creates a BookmarksTree from an HTML document (Netscape Bookmark format)
+   *
+   * Parses Netscape Bookmark format HTML and generates a BookmarksTree that preserves
+   * the hierarchical structure. H3 elements within DT elements are treated as folders,
+   * and A elements are treated as bookmarks.
+   *
+   * @param dom The HTML document to parse
+   * @returns A new BookmarksTree instance
+   *
+   * @example
+   * ```typescript
+   * const parser = new DOMParser();
+   * const dom = parser.parseFromString(bookmarkHtml, "text/html");
+   * const tree = BookmarksTree.fromDOM(dom);
+   * ```
+   */
+  static fromDOM(dom: HTMLDocument): BookmarksTree;
+  /**
+   * Converts the BookmarksTree to an HTML document
+   *
+   * Generates an HTML document in Netscape Bookmark format.
+   *
+   * @returns HTML document in Netscape Bookmark format
+   *
+   * @example
+   * ```typescript
+   * const tree = new BookmarksTree();
+   * tree.set("Google", "https://google.com");
+   * const dom = tree.toDOM();
+   * ```
+   */
+  toDOM(): HTMLDocument;
+  /**
+   * Gets the BookmarksTree as an HTML string in Netscape Bookmark format
+   *
+   * Generates a complete HTML document string including DOCTYPE, metadata, and body
+   * in Netscape Bookmark format.
+   *
+   * @returns HTML string in Netscape Bookmark format
+   *
+   * @example
+   * ```typescript
+   * const tree = new BookmarksTree();
+   * tree.set("Google", "https://google.com");
+   * const html = tree.HTMLString;
+   * console.log(html); // <!DOCTYPE NETSCAPE-Bookmark-file-1>...
+   * ```
+   */
+  get HTMLString(): string;
+  /**
+   * @deprecated Use {@link HTMLString} instead.
+   *
+   * Gets the BookmarksTree as an HTML string in Netscape Bookmark format.
+   */
+  get HTMLText(): string;
+}
+//#endregion
+//#region src/BookmarksParser/BookmarksParser.d.ts
+/**
+ * A parser for Netscape Bookmark format files
+ *
+ * This class provides static methods to parse Netscape Bookmark format HTML strings
+ * and convert them into BookmarksTree instances for easier manipulation.
+ *
+ * @example
+ * ```typescript
+ * const bookmarkHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
+ * <HTML>
+ * <BODY>
+ * <DL><p>
+ *     <DT><A HREF="https://google.com">Google</A>
+ *     <DT><H3>Development</H3>
+ *     <DL><p>
+ *         <DT><A HREF="https://github.com">GitHub</A>
+ *     </DL><p>
+ * </DL>
+ * </BODY>
+ * </HTML>`;
+ *
+ * const tree = BookmarksParser.parse(bookmarkHtml);
+ * ```
+ */
+export declare class BookmarksParser {
+  /**
+   * Alias for the {@link parseFromHTMLString} method.
+   *
+   * @param htmlString HTML string in Netscape Bookmark format
+   * @returns The parsed BookmarksTree
+   *
+   * @example
+   * ```typescript
+   * const bookmarkHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
+   * <HTML>
+   * <BODY>
+   * <DL><p>
+   *     <DT><A HREF="https://google.com">Google</A>
+   *     <DT><H3>Development</H3>
+   *     <DL><p>
+   *         <DT><A HREF="https://github.com">GitHub</A>
+   *     </DL><p>
+   * </DL>
+   * </BODY>
+   * </HTML>`;
+   *
+   * const tree = BookmarksParser.parse(bookmarkHtml);
+   * ```
+   */
+  static parse(htmlString: string): BookmarksTree;
+  /**
+   * Parses a Netscape Bookmark format HTML string and returns a BookmarksTree.
+   *
+   * @param htmlString HTML string in Netscape Bookmark format
+   * @returns The parsed BookmarksTree
+   *
+   * @example
+   * ```typescript
+   * const bookmarkHtml = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
+   * <HTML>
+   * <BODY>
+   * <DL><p>
+   *     <DT><A HREF="https://google.com">Google</A>
+   *     <DT><H3>Development</H3>
+   *     <DL><p>
+   *         <DT><A HREF="https://github.com">GitHub</A>
+   *     </DL><p>
+   * </DL>
+   * </BODY>
+   * </HTML>`;
+   *
+   * const tree = BookmarksParser.parseFromHTMLString(bookmarkHtml);
+   * ```
+   */
+  static parseFromHTMLString(htmlString: string): BookmarksTree;
+  /**
+   * Creates a BookmarksTree from an existing HTMLDocument.
+   *
+   * This is an alias for {@link BookmarksTree.fromDOM}.
+   *
+   * Use this when you already have a parsed HTMLDocument and want to convert it to a BookmarksTree.
+   *
+   * @param dom An HTMLDocument instance
+   * @returns The parsed BookmarksTree
+   *
+   * @example
+   * ```typescript
+   * const dom = new DOMParser().parseFromString(bookmarkHtml, "text/html");
+   * const tree = BookmarksParser.parseFromDOM(dom);
+   * ```
+   */
+  static parseFromDOM(dom: HTMLDocument): BookmarksTree;
+  /**
+   * Parses a JSON string and returns a BookmarksTree.
+   *
+   * @param jsonString JSON string representing the bookmark structure
+   * @returns The parsed BookmarksTree
+   *
+   * @example
+   * ```typescript
+   * const json = '{"Google":"https://google.com","Development":{"GitHub":"https://github.com"}}';
+   * const tree = BookmarksParser.parseFromJSONString(json);
+   * ```
+   */
+  static parseFromJSONString(jsonString: string): BookmarksTree;
+  /**
+   * Parses a JSON object and returns a BookmarksTree.
+   *
+   * This is an alias for {@link BookmarksTree.fromJSON}.
+   *
+   * @param jsonObj JSON object representing the bookmark structure
+   * @returns The parsed BookmarksTree
+   *
+   * @example
+   * ```typescript
+   * const obj = { "Google": "https://google.com", "Development": { "GitHub": "https://github.com" } };
+   * const tree = BookmarksParser.parseFromJSON(obj);
+   * ```
+   */
+  static parseFromJSON(jsonObj: Record<string, unknown>): BookmarksTree;
+}
+//#endregion
+//# sourceMappingURL=web.d.ts.map