diff --git a/packages/ui/package.json b/packages/ui/package.json index 5e696f1..af75cf0 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -36,7 +36,8 @@ "test": "pnpm --filter @bomb.sh/web-platform-tests build && bsh test" }, "dependencies": { - "@bomb.sh/tty": "catalog:" + "@bomb.sh/tty": "catalog:", + "css-select": "^7.0.0" }, "devEngines": { "packageManager": { diff --git a/packages/ui/src/css-select.ts b/packages/ui/src/css-select.ts new file mode 100644 index 0000000..18d2e38 --- /dev/null +++ b/packages/ui/src/css-select.ts @@ -0,0 +1,83 @@ +import type { Options } from 'css-select'; +import { compile as compileSelector, selectAll, selectOne } from 'css-select'; +import { Element, Node } from './dom.ts'; + +export type Adapter = NonNullable['adapter']>; + +export const adapter: Adapter = { + isTag(node): node is Element { + return node instanceof Element; + }, + + getAttributeValue(element, name): string | undefined { + return element.getAttributeNS(null, name) ?? undefined; + }, + + getChildren(node): Node[] { + return [...node.childNodes]; + }, + + getName(element): string { + return element.localName; + }, + + getParent(node): Node | null { + return node.parentNode; + }, + + getSiblings(node): Node[] { + return node.parentNode ? [...node.parentNode.childNodes] : [node]; + }, + + getText(node): string { + const parts: string[] = []; + const stack = [node]; + while (stack.length > 0) { + const current = stack.pop()!; + if (current.nodeType === Node.TEXT_NODE) { + parts.push(current.nodeValue ?? ''); + } + for (let index = current.childNodes.length - 1; index >= 0; index--) { + stack.push(current.childNodes[index]!); + } + } + return parts.join(''); + }, + + hasAttrib(element, name): boolean { + return element.hasAttributeNS(null, name); + }, + + removeSubsets(nodes): Node[] { + const candidates = new Set(nodes); + return [...candidates].filter((node) => { + for (let parent = node.parentNode; parent; parent = parent.parentNode) { + if (candidates.has(parent)) { + return false; + } + } + return true; + }); + }, +}; + +export function compile(selector: string): (node: Node) => boolean { + try { + return compileSelector(selector, { adapter }); + } catch (error) { + throw new DOMException( + error instanceof Error ? error.message : 'Invalid selector', + 'SyntaxError', + ); + } +} + +export function querySelector(nodes: Node[], selector: string): Element | null { + const query = compile(selector); + return selectOne(query, nodes, { adapter }); +} + +export function querySelectorAll(nodes: Node[], selector: string): Element[] { + const query = compile(selector); + return selectAll(query, nodes, { adapter }); +} diff --git a/packages/ui/src/dom.ts b/packages/ui/src/dom.ts index 154acc9..28341ad 100644 --- a/packages/ui/src/dom.ts +++ b/packages/ui/src/dom.ts @@ -1,5 +1,6 @@ /* oxlint-disable bombshell-dev/no-generic-error -- Web IDL requires TypeError for missing arguments. */ +import { querySelector } from './css-select.ts'; import { asciiUppercase, asciiLowercase } from './ascii.ts'; import { NamedNodeMap } from './named-node-map.ts'; import { @@ -309,6 +310,10 @@ export class Document extends Node { return null; } + querySelector(selector: string): Element | null { + return querySelector(Array.from(this.childNodes), selector); + } + createElement(tagName: string): Element { if (arguments.length === 0) { throw new TypeError('createElement requires a tag name'); diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 3f3b770..8f3f7e5 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -44,6 +44,9 @@ importers: '@bomb.sh/tty': specifier: 'catalog:' version: 0.10.0 + css-select: + specifier: ^7.0.0 + version: 7.0.0 devDependencies: '@bomb.sh/web-platform-tests': specifier: workspace:* @@ -1269,6 +1272,10 @@ packages: axios@1.21.0: resolution: {integrity: sha512-YCzXMB53Q9PZBsh7yN7wtapit4WepwcHS2fP8QhGsBxSz5YtgYobV7GGlWlAJi+RxfU77GQTQi2DSLUma42EYA==} + boolbase@2.0.0: + resolution: {integrity: sha512-DkVaaQHymRhpYEYo9x1oo7Q7B0Y6KJUsjm3c9eTyFDby4MHLBTwZ6ZDWBel5zrYxj1WsZgC5oLpiz+93MluXeA==} + engines: {node: '>=20.19.0'} + cac@7.1.0: resolution: {integrity: sha512-LMDU/U2yA4IPIY8KT0NsNPWEYZvAMkbgyspxJ6btJaYV+WMDOHAZCmB0lsTObiHaRS1V/ztKAl7+TSkTqXyeoA==} engines: {node: '>=20.19.0'} @@ -1288,6 +1295,14 @@ packages: convert-source-map@2.0.0: resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==} + css-select@7.0.0: + resolution: {integrity: sha512-snmjEVXy+1LnwXdxhYvTMj1d9tOh4HxkA1YmoayVBeeyR2C14Pum7fcxJIm4SswYspVy866eYNwlH6xC3/VH5g==} + engines: {node: '>=20.19.0'} + + css-what@8.0.0: + resolution: {integrity: sha512-DH0Bqq3DNp5tdOReuNyAA+Ev4Y2GS5FMbZpeTLP6C4CDi0h5nL0BmUPChXw3o/qbHLDWHl49sbNqQVY7bMSDdw==} + engines: {node: '>=20.19.0'} + debug@4.4.3: resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==} engines: {node: '>=6.0'} @@ -1308,6 +1323,22 @@ packages: resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==} engines: {node: '>=8'} + dom-serializer@3.1.1: + resolution: {integrity: sha512-4MEa38/QexBob6gFNwu+EGdWvhJ1OKuNwdYY3Y3NyeWDQfnGeDYQUDfIRzWu5B5gsv03so2Uxd28YC6zrsx3Lw==} + engines: {node: '>=20.19.0'} + + domelementtype@3.0.0: + resolution: {integrity: sha512-umCQid3jKbDmVjx8jGaW7uUykm4DEUeyV21hPxNMo2nV955DhUThwqyOIDtreepP31hl84X7G5U9ZfsWvIB3Pg==} + engines: {node: '>=20.19.0'} + + domhandler@6.0.1: + resolution: {integrity: sha512-gYzvtM72ZtxQO0T048kd6HWSbbGCNOUwcnfQ01cqIJ4X2IYKFFHZ5mKvrQETcFXxsRObZulDaKmy//R7TPtsBg==} + engines: {node: '>=20.19.0'} + + domutils@4.0.2: + resolution: {integrity: sha512-qI4JLRKnSzqFqr7hAlS5xQDusBCjKSEG4t4+7aNrIQMHBcsC2TGEhuyABJdYkgSewL57PNLYEiibY2iPKhKpaA==} + engines: {node: '>=20.19.0'} + dts-resolver@3.0.0: resolution: {integrity: sha512-1T1f+z+4tl9XD+m+0HBgWoL/nm0bOIffyWaUuUSBlFg/86IWvfx+wjNaO/ybU0AJzG9/Mi5hBUgGV6zCmWEN7Q==} engines: {node: ^22.18.0 || >=24.0.0} @@ -1325,6 +1356,10 @@ packages: resolution: {integrity: sha512-AnfC1ATldl49/cvZdLPDjBfrRNwbDO05aibiOtzQu3qtlbJtomNLhF30HEtn/7iBz50dlMECqATo3fG0LrdEgw==} engines: {node: '>=14'} + entities@8.1.0: + resolution: {integrity: sha512-kxL7msIffSuh9aaFAMD7rxAIuTRMAHMeBtgHW2yUdWw732ZNh4MehkF2gdjvtdmikkaIP9bFDDJOPlsvm7avrA==} + engines: {node: '>=20.19.0'} + es-define-property@1.0.1: resolution: {integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==} engines: {node: '>= 0.4'} @@ -1578,6 +1613,10 @@ packages: node-pty@1.2.0-beta.15: resolution: {integrity: sha512-vORSzHXi4Ofl7HemVWpuudLqCPdaQb4LfpRCUpE5HPxhp4JYscl8zZwxh11p26v2wvW24WMwnMfLjhRLixrfxA==} + nth-check@3.0.1: + resolution: {integrity: sha512-GX0gsdbGVCgnRgbeGaubfjpBXyYRWOOCVeYh08bSQvDZqxz5ndXs1OTfAt/h36G1xvI94YIspsI0sVFqAV9+RQ==} + engines: {node: '>=20.19.0'} + obug@3.0.0: resolution: {integrity: sha512-5vvB5+W7ePv+p3uqxi+RcW1XAzLW0/hxt3/4X4Lc4qHudzOhmBiBwOY6DRob4WnanAEGvNcLjF+KNOufrUoEQw==} engines: {node: '>=12.20.0'} @@ -2845,6 +2884,8 @@ snapshots: - debug - supports-color + boolbase@2.0.0: {} + cac@7.1.0: {} call-bind-apply-helpers@1.0.2: @@ -2860,6 +2901,16 @@ snapshots: convert-source-map@2.0.0: {} + css-select@7.0.0: + dependencies: + boolbase: 2.0.0 + css-what: 8.0.0 + domhandler: 6.0.1 + domutils: 4.0.2 + nth-check: 3.0.1 + + css-what@8.0.0: {} + debug@4.4.3: dependencies: ms: 2.1.3 @@ -2870,6 +2921,24 @@ snapshots: detect-libc@2.1.2: {} + dom-serializer@3.1.1: + dependencies: + domelementtype: 3.0.0 + domhandler: 6.0.1 + entities: 8.1.0 + + domelementtype@3.0.0: {} + + domhandler@6.0.1: + dependencies: + domelementtype: 3.0.0 + + domutils@4.0.2: + dependencies: + dom-serializer: 3.1.1 + domelementtype: 3.0.0 + domhandler: 6.0.1 + dts-resolver@3.0.0(oxc-resolver@11.20.0): optionalDependencies: oxc-resolver: 11.20.0 @@ -2882,6 +2951,8 @@ snapshots: empathic@2.1.0: {} + entities@8.1.0: {} + es-define-property@1.0.1: {} es-errors@1.3.0: {} @@ -3103,6 +3174,10 @@ snapshots: dependencies: node-addon-api: 7.1.1 + nth-check@3.0.1: + dependencies: + boolbase: 2.0.0 + obug@3.0.0: {} oxc-parser@0.133.0: