netscape-bookmark-parser 1.1.4 → 1.2.0

package/dist/index.js

@@ -0,0 +1,333 @@
+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
+setDOMParser(DOMParser);
+
+//#endregion
+//#region src/BookmarksTree/BookmarksTree.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);
+* ```
+*/
+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
+/**
+* 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: typeof NodeDOMParser","NodeDOMParser","json: Record<string, unknown>","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,241 @@
+//#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);
+ * ```
+ */
+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);
+ * ```
+ */
+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
+export { BookmarksParser, BookmarksTree };
+//# sourceMappingURL=web.d.ts.map