@cyberalien/svg-utils 0.0.1

package/lib/index.d.ts

@@ -0,0 +1,5 @@
+import { ParsedXMLNode, ParsedXMLTagElement, ParsedXMLTextElement } from "./xml/types.js";
+import { iterateXMLContent } from "./xml/iterate.js";
+import { parseXMLContent } from "./xml/parse.js";
+import { stringifyXMLContent } from "./xml/stringify.js";
+export { ParsedXMLNode, ParsedXMLTagElement, ParsedXMLTextElement, iterateXMLContent, parseXMLContent, stringifyXMLContent };

package/lib/index.js

@@ -0,0 +1,5 @@
+import { iterateXMLContent } from "./xml/iterate.js";
+import { parseXMLContent } from "./xml/parse.js";
+import { stringifyXMLContent } from "./xml/stringify.js";
+
+export { iterateXMLContent, parseXMLContent, stringifyXMLContent };

package/lib/xml/iterate.d.ts

@@ -0,0 +1,12 @@
+import { ParsedXMLNode, ParsedXMLTagElement } from "./types.js";
+/**
+ * Callback result
+ *
+ * - void: continue
+ * - 'remove': remove current node
+ * - 'skip': skip children
+ * - 'abort': stop iteration
+ */
+type CallbackResult = void | 'remove' | 'skip' | 'abort';
+declare function iterateXMLContent(root: ParsedXMLTagElement[], callback: (node: ParsedXMLNode, stack: ParsedXMLTagElement[]) => CallbackResult): ParsedXMLNode[];
+export { iterateXMLContent };

package/lib/xml/iterate.js

@@ -0,0 +1,26 @@
+function iterateXMLContent(root, callback) {
+	const stack = [];
+	let aborted = false;
+	function parseChildren(nodes) {
+		const remove = [];
+		for (const node of nodes) if (parse(node) === "remove") remove.push(node);
+		return remove.length ? nodes.filter((item) => !remove.includes(item)) : nodes;
+	}
+	function parse(node) {
+		if (aborted) return;
+		const result = callback(node, stack);
+		switch (result) {
+			case "abort": aborted = true;
+			case "remove":
+			case "skip": return result;
+		}
+		if (node.type === "tag") {
+			stack.push(node);
+			node.children = parseChildren(node.children);
+			stack.pop();
+		}
+	}
+	return parseChildren(root);
+}
+
+export { iterateXMLContent };

package/lib/xml/parse.d.ts

@@ -0,0 +1,8 @@
+import { ParsedXMLTagElement } from "./types.js";
+/**
+ * Parse SVG content
+ *
+ * Returns null on error
+ */
+declare function parseXMLContent(content: string, trim?: boolean): ParsedXMLTagElement[] | null;
+export { parseXMLContent };

package/lib/xml/parse.js

@@ -0,0 +1,84 @@
+/**
+* Parse SVG content
+*
+* Returns null on error
+*/
+function parseXMLContent(content, trim = true) {
+	const stack = [];
+	const rootNodes = [];
+	let startIndex = 0;
+	let parentNode = null;
+	do {
+		const start = content.indexOf("<", startIndex);
+		const end = start === -1 ? -1 : content.indexOf(">", start);
+		if (start === -1 || end === -1) {
+			const text$1 = content.slice(startIndex).trim();
+			if (text$1 || parentNode || !rootNodes.length) return null;
+			return rootNodes;
+		}
+		if (content.slice(start, start + 4) === "<!--") {
+			const end$1 = content.indexOf("-->", start);
+			if (end$1 === -1) return null;
+			startIndex = end$1 + 3;
+			continue;
+		}
+		const rawText = content.slice(startIndex, start);
+		const text = trim ? rawText.trim() : rawText;
+		startIndex = start;
+		if (text) {
+			if (!parentNode) return null;
+			parentNode.children.push({
+				type: "text",
+				content: text
+			});
+		}
+		let tagContent = content.slice(start + 1, end).trim();
+		if (tagContent.startsWith("/")) {
+			if (!parentNode) return null;
+			const tagNameMatch$1 = tagContent.slice(1).match(/^[^\s]+/);
+			if (parentNode.tag !== tagNameMatch$1?.[0]) return null;
+			stack.pop();
+			parentNode = stack.length ? stack[stack.length - 1] : null;
+			startIndex = end + 1;
+			continue;
+		}
+		const tagNameMatch = tagContent.match(/^[^\s/]+/);
+		if (!tagNameMatch) return null;
+		const tagName = tagNameMatch[0];
+		tagContent = tagContent.slice(tagName.length).trim();
+		const selfClosing = tagContent.slice(-1) === "/";
+		if (selfClosing) tagContent = tagContent.slice(0, -1).trim();
+		const attribs = Object.create(null);
+		Array.from(tagContent.matchAll(/([\w:-]+)="([^"]*)"/g) ?? []).forEach((match) => {
+			attribs[match[1]] = match[2];
+		});
+		const element = {
+			type: "tag",
+			tag: tagName,
+			attribs,
+			children: []
+		};
+		if (parentNode) parentNode.children.push(element);
+		else rootNodes.push(element);
+		if (!selfClosing) {
+			stack.push(element);
+			parentNode = element;
+		}
+		startIndex = end + 1;
+		if (tagName === "style" && !selfClosing) {
+			const match = "</style>";
+			const end$1 = content.indexOf(match, startIndex);
+			if (end$1 === -1) return null;
+			const css = content.slice(startIndex, end$1).trim();
+			if (css.length) parentNode.children.push({
+				type: "text",
+				content: css
+			});
+			stack.pop();
+			parentNode = stack.length ? stack[stack.length - 1] : null;
+			startIndex = end$1 + 8;
+		}
+	} while (true);
+}
+
+export { parseXMLContent };

package/lib/xml/stringify.d.ts

@@ -0,0 +1,10 @@
+import { ParsedXMLTagElement } from "./types.js";
+interface ParseSVGOptions {
+  useSelfClosing?: boolean;
+  numberTemplate?: string;
+}
+/**
+ * Convert parsed XML content to string
+ */
+declare function stringifyXMLContent(root: ParsedXMLTagElement[], options?: ParseSVGOptions): string | null;
+export { stringifyXMLContent };

package/lib/xml/stringify.js

@@ -0,0 +1,53 @@
+const defaultOptions = {
+	useSelfClosing: true,
+	numberTemplate: ` {key}="{value}"`
+};
+function assertNever(v) {}
+/**
+* Convert parsed XML content to string
+*/
+function stringifyXMLContent(root, options) {
+	const fullOptions = {
+		...defaultOptions,
+		...options
+	};
+	let output = "";
+	const add = (node) => {
+		output += "<" + node.tag;
+		for (const key in node.attribs) {
+			const value = node.attribs[key];
+			switch (typeof value) {
+				case "string":
+					output += ` ${key}="${value}"`;
+					break;
+				case "number":
+					output += fullOptions.numberTemplate.replace("{value}", value.toString()).replace("{key}", key);
+					break;
+			}
+		}
+		if (!node.children.length) {
+			if (fullOptions.useSelfClosing) output += " />";
+			else output += "></" + node.tag + ">";
+			return true;
+		}
+		output += ">";
+		for (let i = 0; i < node.children.length; i++) {
+			const childNode = node.children[i];
+			switch (childNode.type) {
+				case "tag":
+					if (!add(childNode)) return false;
+					break;
+				case "text":
+					output += childNode.content;
+					break;
+				default: assertNever(childNode);
+			}
+		}
+		output += "</" + node.tag + ">";
+		return true;
+	};
+	for (const node of root) if (!add(node)) return null;
+	return output;
+}
+
+export { stringifyXMLContent };

package/lib/xml/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tag
+ */
+interface ParsedXMLTagElement {
+  type: 'tag';
+  tag: string;
+  attribs: Record<string, string | number>;
+  children: ParsedXMLNode[];
+}
+/**
+ * Text
+ */
+interface ParsedXMLTextElement {
+  type: 'text';
+  content: string;
+}
+/**
+ * Element in tree
+ */
+type ParsedXMLNode = ParsedXMLTagElement | ParsedXMLTextElement;
+export { ParsedXMLNode, ParsedXMLTagElement, ParsedXMLTextElement };

package/license.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-PRESENT Vjacheslav Trushkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@cyberalien/svg-utils",
+  "type": "module",
+  "description": "Common functions for working with SVG used by various packages.",
+  "author": "Vjacheslav Trushkin",
+  "version": "0.0.1",
+  "license": "MIT",
+  "bugs": "https://github.com/cyberalien/svg-utils/issues",
+  "homepage": "https://cyberalien.dev/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cyberalien/svg-utils.git"
+  },
+  "sideEffects": false,
+  "main": "lib/index.js",
+  "module": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "*.d.ts"
+  ],
+  "dependencies": {
+    "@iconify/types": "^2.0.0"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.31.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^18.19.120",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "eslint": "^9.31.0",
+    "globals": "^16.3.0",
+    "tsdown": "^0.13.0",
+    "typescript": "^5.8.3",
+    "vitest": "^2.1.9"
+  },
+  "scripts": {
+    "lint": "eslint --fix src/**/*.ts",
+    "prebuild": "pnpm run lint",
+    "build": "tsdown",
+    "test": "vitest"
+  }
+}