npm - netscape-bookmark-parser - Versions diffs - 1.1.3 → 1.2.0 - Mend

netscape-bookmark-parser 1.1.3 → 1.2.0

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 (122) hide show

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,240 @@
+import { HTMLDocument } from "@b-fuze/deno-dom";
+//#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=index.d.ts.map

package/dist/index.js ADDED Viewed

@@ -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 ADDED Viewed

@@ -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, \"&\")\n\t\t\t\t.replace(/</g, \"<\")\n\t\t\t\t.replace(/>/g, \">\")\n\t\t\t\t.replace(/\"/g, \""\")\n\t\t\t\t.replace(/'/g, \"'\");\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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"}