mod2dom 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 General Software Development
+
+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/Makefile

@@ -0,0 +1,27 @@
+.PHONY: all, test, prod, build, updateMinor, updateMajor, updatePatch, update
+
+all: build
+
+build: prod
+
+prod:
+	@npm run buildprod
+
+test:
+	@npm run test
+
+updateMinor:
+	npm version minor
+	$(MAKE) update
+
+updateMajor:
+	npm version major
+	$(MAKE) update
+
+updatePatch:
+	npm version patch
+	$(MAKE) update
+
+update:
+	git push
+	npm publish

package/README.md

@@ -0,0 +1 @@
+# mod2dom

package/config/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+  test: {
+    environment: "jsdom"
+  }
+});

package/dist/domparser.d.ts

@@ -0,0 +1,7 @@
+import type { QueryOption, QueryOptions } from "./query.js";
+import type { DNode } from "./types.js";
+export declare const DOMParser: {
+    findAll: (query: QueryOptions | QueryOption, parentNode?: ParentNode) => NodeListOf<Element>;
+    find: (query: QueryOptions | QueryOption, parentNode?: ParentNode) => DNode | undefined;
+};
+//# sourceMappingURL=domparser.d.ts.map

package/dist/domparser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domparser.d.ts","sourceRoot":"","sources":["../src/domparser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,eAAO,MAAM,SAAS;qBACe,YAAY,GAAG,WAAW,eAAc,UAAU;kBAuCxD,YAAY,GAAG,WAAW,eAAc,UAAU,KAAc,KAAK,GAAG,SAAS;CAG/G,CAAC"}

package/dist/domparser.js

@@ -0,0 +1,48 @@
+import { validateClassName, validateTagName } from "./validate.js";
+export const DOMParser = {
+    findAll: function findAll(query, parentNode = document) {
+        if (!Array.isArray(query))
+            query = [query];
+        let queryString = "";
+        for (const q of query) {
+            if (q?.__queryType === "element") {
+                queryString += q.name;
+                if (q.options) {
+                    for (const option of Object.keys(q.options)) {
+                        queryString += "[";
+                        const value = q.options[option];
+                        queryString += `${option}="${CSS.escape(value)}"`;
+                        queryString += "]";
+                    }
+                }
+                for (const q2 of q.other) {
+                    if (q2?.__queryType === "tagname") {
+                        validateTagName(q2.name);
+                        queryString += `#${q2.name}`;
+                    }
+                    else if (q2?.__queryType === "classname") {
+                        validateClassName(q2.name);
+                        queryString += `.${q2.name}`;
+                    }
+                }
+            }
+            else if (q?.__queryType === "tagname") {
+                validateTagName(q.name);
+                queryString += `#${q.name}`;
+            }
+            else if (q?.__queryType === "classname") {
+                validateClassName(q.name);
+                queryString += `.${q.name}`;
+            }
+            queryString += " ";
+        }
+        if (queryString[queryString.length - 1] === " ") {
+            queryString = queryString.slice(0, queryString.length - 1);
+        }
+        return parentNode.querySelectorAll(queryString);
+    },
+    find: function find(query, parentNode = document) {
+        return this.findAll(query, parentNode)[0];
+    }
+};
+//# sourceMappingURL=domparser.js.map

package/dist/domparser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domparser.js","sourceRoot":"","sources":["../src/domparser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB,OAAO,EAAE,SAAS,OAAO,CAAC,KAAiC,EAAE,aAAyB,QAAQ;QAC1F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;QAEpB,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC/B,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC;gBACtB,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;oBACZ,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC1C,WAAW,IAAI,GAAG,CAAC;wBACnB,MAAM,KAAK,GAAW,CAAC,CAAC,OAAO,CAAC,MAAgB,CAAE,CAAC;wBACnD,WAAW,IAAI,GAAG,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAA;wBACjD,WAAW,IAAI,GAAG,CAAC;oBACvB,CAAC;gBACL,CAAC;gBACD,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;oBACvB,IAAI,EAAE,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;wBAChC,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;wBACzB,WAAW,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;oBACjC,CAAC;yBAAM,IAAI,EAAE,EAAE,WAAW,KAAK,WAAW,EAAE,CAAC;wBACzC,iBAAiB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;wBAC3B,WAAW,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;oBACjC,CAAC;gBACL,CAAC;YACL,CAAC;iBAAM,IAAI,CAAC,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;gBACtC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACxB,WAAW,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC;iBAAM,IAAI,CAAC,EAAE,WAAW,KAAK,WAAW,EAAE,CAAC;gBACxC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC1B,WAAW,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC;YACD,WAAW,IAAI,GAAG,CAAC;QACvB,CAAC;QACD,IAAI,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9C,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC9D,CAAC;QACD,OAAO,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,EAAE,SAAS,IAAI,CAAC,KAAiC,EAAE,aAAyB,QAAQ;QACpF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;CACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+export declare class MOD2DOMError extends Error {
+}
+declare class BadData extends MOD2DOMError {
+}
+declare class InvalidTagName extends BadData {
+}
+declare class InvalidClassName extends BadData {
+}
+export declare const mod2domErrors: Readonly<{
+    BadData: typeof BadData;
+    InvalidTagName: typeof InvalidTagName;
+    InvalidClassName: typeof InvalidClassName;
+}>;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;CAAG;AAE1C,cAAM,OAAQ,SAAQ,YAAY;CAAG;AACrC,cAAM,cAAe,SAAQ,OAAO;CAAG;AACvC,cAAM,gBAAiB,SAAQ,OAAO;CAAG;AAEzC,eAAO,MAAM,aAAa;;;;EAIxB,CAAC"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+export class MOD2DOMError extends Error {
+}
+;
+class BadData extends MOD2DOMError {
+}
+;
+class InvalidTagName extends BadData {
+}
+;
+class InvalidClassName extends BadData {
+}
+;
+export const mod2domErrors = Object.freeze({
+    BadData: BadData,
+    InvalidTagName: InvalidTagName,
+    InvalidClassName: InvalidClassName,
+});
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;CAAG;AAAA,CAAC;AAE3C,MAAM,OAAQ,SAAQ,YAAY;CAAG;AAAA,CAAC;AACtC,MAAM,cAAe,SAAQ,OAAO;CAAG;AAAA,CAAC;AACxC,MAAM,gBAAiB,SAAQ,OAAO;CAAG;AAAA,CAAC;AAE1C,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,OAAO;IAChB,cAAc,EAAE,cAAc;IAC9B,gBAAgB,EAAE,gBAAgB;CACrC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { DOMParser } from "./domparser.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { DOMParser } from "./domparser.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/query.d.ts

@@ -0,0 +1,16 @@
+export type QueryType = "element" | "classname" | "tagname";
+export type QueryOption = {
+    __queryType: QueryType;
+    name: string;
+    options: {
+        [key: string]: string;
+    };
+    other: QueryOptions;
+};
+export type QueryOptions = QueryOption[];
+export declare function Element(elementName: string, attributes?: {
+    [key: string]: string;
+}, ...others: QueryOptions): QueryOption;
+export declare function ClassName(name: string): QueryOption;
+export declare function TagName(name: string): QueryOption;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG;IACtB,WAAW,EAAE,SAAS,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAC,CAAC;IACjC,KAAK,EAAE,YAAY,CAAA;CACtB,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,WAAW,EAAE,CAAC;AAEzC,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,GAAE;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAM,EAAE,GAAG,MAAM,EAAE,YAAY,GAAG,WAAW,CAO3H;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAQnD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAQjD"}

package/dist/query.js

@@ -0,0 +1,28 @@
+import { validateClassName, validateTagName } from "./validate.js";
+export function Element(elementName, attributes = {}, ...others) {
+    return {
+        __queryType: "element",
+        name: elementName,
+        options: attributes,
+        other: others
+    };
+}
+export function ClassName(name) {
+    validateClassName(name);
+    return {
+        __queryType: "classname",
+        name: name.trim(),
+        options: {},
+        other: []
+    };
+}
+export function TagName(name) {
+    validateTagName(name);
+    return {
+        __queryType: "tagname",
+        name: name.trim(),
+        options: {},
+        other: []
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAYnE,MAAM,UAAU,OAAO,CAAC,WAAmB,EAAE,aAAsC,EAAE,EAAE,GAAG,MAAoB;IAC1G,OAAO;QACH,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,MAAM;KAChB,CAAC;AACN,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IAClC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO;QACH,WAAW,EAAE,WAAW;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;KACZ,CAAC;AACN,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAChC,eAAe,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO;QACH,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;KACZ,CAAA;AACL,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+export type DNode = Document | HTMLElement | Element | Node;
+export type { QueryType, QueryOption, QueryOptions } from "./query.js";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC;AAC5D,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validate.d.ts

@@ -0,0 +1,3 @@
+export declare function validateTagName(name: string): void;
+export declare function validateClassName(name: string): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,QAU3C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,QAU7C"}

package/dist/validate.js

@@ -0,0 +1,24 @@
+import { mod2domErrors } from "./errors.js";
+export function validateTagName(name) {
+    if (!name.trim())
+        throw new mod2domErrors.InvalidTagName(`Invalid tag name (empty).`);
+    const invalid = name.match(/[/\\\s.#\[\]]/g);
+    if (invalid) {
+        throw new mod2domErrors.InvalidTagName(`Invalid tag name: \`${name}\` (character: "${invalid[0]}")`);
+    }
+    let v;
+    if (v = name.match(/^[0-9]/))
+        throw new mod2domErrors.InvalidTagName(`Invalid tag name: \`${name}\` (character: "${v}")`);
+}
+export function validateClassName(name) {
+    if (!name.trim())
+        throw new mod2domErrors.InvalidTagName(`Invalid class name (empty).`);
+    const invalid = name.match(/[/\\\s.#\[\]]/g);
+    if (invalid) {
+        throw new mod2domErrors.InvalidClassName(`Invalid class name: \`${name}\` (character: "${invalid[0]}")`);
+    }
+    let v;
+    if (v = name.match(/^[0-9]/))
+        throw new mod2domErrors.InvalidClassName(`Invalid class name: \`${name}\` (character: "${v}")`);
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,UAAU,eAAe,CAAC,IAAY;IACxC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACZ,MAAM,IAAI,aAAa,CAAC,cAAc,CAAC,2BAA2B,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,IAAI,aAAa,CAAC,cAAc,CAAC,uBAAuB,IAAI,mBAAmB,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzG,CAAC;IACD,IAAI,CAAC,CAAC;IACN,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACxB,MAAM,IAAI,aAAa,CAAC,cAAc,CAAC,uBAAuB,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC1C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACZ,MAAM,IAAI,aAAa,CAAC,cAAc,CAAC,6BAA6B,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,IAAI,aAAa,CAAC,gBAAgB,CAAC,yBAAyB,IAAI,mBAAmB,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7G,CAAC;IACD,IAAI,CAAC,CAAC;IACN,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACxB,MAAM,IAAI,aAAa,CAAC,gBAAgB,CAAC,yBAAyB,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACxG,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "mod2dom",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "scripts": {
+    "buildprod": "npx tsc --incremental",
+    "test": "npx vitest --config config/vitest.config.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cornusandu-org/mod2dom.git"
+  },
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/cornusandu-org/mod2dom/issues"
+  },
+  "homepage": "https://github.com/cornusandu-org/mod2dom#readme",
+  "devDependencies": {
+    "@types/node": "^25.8.0",
+    "jsdom": "^29.1.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./types": "./dist/types.js",
+    "./query": "./dist/query.js"
+  }
+}

package/src/domparser.ts

@@ -0,0 +1,48 @@
+import type { QueryOption, QueryOptions } from "./query.js";
+import type { DNode } from "./types.js";
+import { validateClassName, validateTagName } from "./validate.js";
+
+export const DOMParser = {
+    findAll: function findAll(query: QueryOptions | QueryOption, parentNode: ParentNode = document) {
+        if (!Array.isArray(query))
+            query = [query];
+        
+        let queryString = "";
+        for (const q of query) {
+            if (q?.__queryType === "element") {
+                queryString += q.name;
+                if (q.options) {
+                    for (const option of Object.keys(q.options)) {
+                        queryString += "[";
+                        const value: string = q.options[option as string]!;
+                        queryString += `${option}="${CSS.escape(value)}"`
+                        queryString += "]";
+                    }
+                }
+                for (const q2 of q.other) {
+                    if (q2?.__queryType === "tagname") {
+                        validateTagName(q2.name);
+                        queryString += `#${q2.name}`;
+                    } else if (q2?.__queryType === "classname") {
+                        validateClassName(q2.name);
+                        queryString += `.${q2.name}`;
+                    }
+                }
+            } else if (q?.__queryType === "tagname") {
+                validateTagName(q.name);
+                queryString += `#${q.name}`;
+            } else if (q?.__queryType === "classname") {
+                validateClassName(q.name);
+                queryString += `.${q.name}`;
+            }
+            queryString += " ";
+        }
+        if (queryString[queryString.length - 1] === " ") {
+            queryString = queryString.slice(0, queryString.length - 1)
+        }
+        return parentNode.querySelectorAll(queryString);
+    },
+    find: function find(query: QueryOptions | QueryOption, parentNode: ParentNode = document): DNode | undefined {
+        return this.findAll(query, parentNode)[0];
+    }
+};

package/src/errors.ts

@@ -0,0 +1,11 @@
+export class MOD2DOMError extends Error {};
+
+class BadData extends MOD2DOMError {};
+class InvalidTagName extends BadData {};
+class InvalidClassName extends BadData {};
+
+export const mod2domErrors = Object.freeze({
+    BadData: BadData,
+    InvalidTagName: InvalidTagName,
+    InvalidClassName: InvalidClassName,
+});

package/src/index.ts

@@ -0,0 +1 @@
+export { DOMParser } from "./domparser.js"

package/src/query.ts

@@ -0,0 +1,40 @@
+import { validateClassName, validateTagName } from "./validate.js";
+
+export type QueryType = "element" | "classname" | "tagname";
+
+export type QueryOption = {
+    __queryType: QueryType,
+    name: string,
+    options: {[key: string]: string},
+    other: QueryOptions
+};
+export type QueryOptions = QueryOption[];
+
+export function Element(elementName: string, attributes: {[key: string]: string} = {}, ...others: QueryOptions): QueryOption {
+    return {
+        __queryType: "element",
+        name: elementName,
+        options: attributes,
+        other: others
+    };
+}
+
+export function ClassName(name: string): QueryOption {
+    validateClassName(name);
+    return {
+        __queryType: "classname",
+        name: name.trim(),
+        options: {},
+        other: []
+    };
+}
+
+export function TagName(name: string): QueryOption {
+    validateTagName(name);
+    return {
+        __queryType: "tagname",
+        name: name.trim(),
+        options: {},
+        other: []
+    }
+}

package/src/types.ts

@@ -0,0 +1,2 @@
+export type DNode = Document | HTMLElement | Element | Node;
+export type { QueryType, QueryOption, QueryOptions } from "./query.js";

package/src/validate.ts

@@ -0,0 +1,25 @@
+import { mod2domErrors } from "./errors.js";
+
+export function validateTagName(name: string) {
+    if (!name.trim())
+        throw new mod2domErrors.InvalidTagName(`Invalid tag name (empty).`);
+    const invalid = name.match(/[/\\\s.#\[\]]/g);
+    if (invalid) {
+        throw new mod2domErrors.InvalidTagName(`Invalid tag name: \`${name}\` (character: "${invalid[0]}")`);
+    }
+    let v;
+    if (v = name.match(/^[0-9]/))
+        throw new mod2domErrors.InvalidTagName(`Invalid tag name: \`${name}\` (character: "${v}")`);
+}
+
+export function validateClassName(name: string) {
+    if (!name.trim())
+        throw new mod2domErrors.InvalidTagName(`Invalid class name (empty).`);
+    const invalid = name.match(/[/\\\s.#\[\]]/g);
+    if (invalid) {
+        throw new mod2domErrors.InvalidClassName(`Invalid class name: \`${name}\` (character: "${invalid[0]}")`);
+    }
+    let v;
+    if (v = name.match(/^[0-9]/))
+        throw new mod2domErrors.InvalidClassName(`Invalid class name: \`${name}\` (character: "${v}")`);
+}

package/tests/dom/error.test.ts

@@ -0,0 +1,79 @@
+import { describe, it, expect } from "vitest"
+import { DOMParser } from "../../src/index";
+import { TagName as IDName, Element, ClassName } from "../../src/query";
+
+describe("invalidClass.empty.none", () => {
+    it("finds an element", () => {
+        document.body.innerHTML = `
+            <div>
+            <button id="x" class="test">Hello, World!</button>
+            </div>
+        `
+
+        let errored = false;
+        try {
+            const btn = DOMParser.find(ClassName(""));
+        } catch {
+            errored = true;
+        }
+
+        expect(errored).toBe(true);
+    })
+});
+
+describe("invalidClass.empty.whitespace", () => {
+    it("finds an element", () => {
+        document.body.innerHTML = `
+            <div>
+            <button id="x" class="test">Hello, World!</button>
+            </div>
+        `
+
+        let errored = false;
+        try {
+            const btn = DOMParser.find(ClassName(" "));
+        } catch {
+            errored = true;
+        }
+
+        expect(errored).toBe(true);
+    })
+});
+
+describe("invalidClass.character(1)", () => {
+    it("finds an element", () => {
+        document.body.innerHTML = `
+            <div>
+            <button id="x" class="test">Hello, World!</button>
+            </div>
+        `
+
+        let errored = false;
+        try {
+            const btn = DOMParser.find(ClassName("#class"));
+        } catch {
+            errored = true;
+        }
+
+        expect(errored).toBe(true);
+    })
+});
+
+describe("invalidClass.character(2)", () => {
+    it("finds an element", () => {
+        document.body.innerHTML = `
+            <div>
+            <button id="x" class="test">Hello, World!</button>
+            </div>
+        `
+
+        let errored = false;
+        try {
+            const btn = DOMParser.find(ClassName(".class"));
+        } catch {
+            errored = true;
+        }
+
+        expect(errored).toBe(true);
+    })
+});

package/tests/dom/simple.test.ts

@@ -0,0 +1,29 @@
+import { describe, it, expect } from "vitest"
+import { DOMParser } from "../../src/index";
+import { TagName as IDName, Element, ClassName } from "../../src/query";
+
+describe("findTheButton", () => {
+    it("finds an element", () => {
+        document.body.innerHTML = `
+            <button id="x" class="test">Hello, World!</button>
+        `
+
+        const btn = DOMParser.find(Element('button', {}, IDName("x"), ClassName("test")));
+
+        expect(btn?.textContent).toBe("Hello, World!")
+    })
+});
+
+describe("findTheButton2", () => {
+    it("finds an element", () => {
+        document.body.innerHTML = `
+            <div>
+            <button id="x" class="test">Hello, World!</button>
+            </div>
+        `
+
+        const btn = DOMParser.find([Element('div'), Element('button', {}, IDName("x"), ClassName("test"))]);
+
+        expect(btn?.textContent).toBe("Hello, World!")
+    })
+});

package/tsconfig.json

@@ -0,0 +1,49 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "nodenext",
+    "target": "esnext",
+    "lib": ["esnext", "DOM", "DOM.Iterable"],
+    "types": ["node"],
+    // For nodejs:
+    // "lib": ["esnext"],
+    // "types": ["node"],
+    // and npm install -D @types/node
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true
+  },
+
+  "include": [
+    "src/*"
+  ]
+}