pota/use/dom

pota/use/dom is the low-level DOM helper module the renderer itself uses. It re-exports a few platform globals pre-bound to document and wraps the imperative APIs that pota's internals lean on — attribute / class / part manipulation, tree walking, and a couple of niche utilities like isPlaying and cleanJSXText. Most app code doesn't need it; it's documented because it ships as a public subpath.

Exports

• document — window.document
• head — document.head
• documentElement — document.documentElement
• DocumentFragment — the constructor
• activeElement() — document.activeElement
• createElement(tag) — HTML element
• createElementNS(ns, tag) — namespaced element
• createTextNode(text) — text node
• createComment(text) — comment / anchor node
• importNode(node, deep?) — document.importNode
• createTreeWalker(root, what?) — document.createTreeWalker
• isConnected(node) — node.isConnected
• isPlaying(el) — is a media element progressing?
• setAttribute(node, …) — platform setAttribute
• hasAttribute(node, …) — platform hasAttribute
• removeAttribute(node, …) — platform removeAttribute
• addClass(node, str|array) — classList.add
• removeClass(node, str|array) — classList.remove
• addPart(node, …) — node.part.add
• removePart(node, …) — node.part.remove
• tokenList(s) — trim + split by whitespace
• querySelector(node, query) — per-node querySelector
• querySelectorAll(node, query) — per-node querySelectorAll
• walkElements(node, max?, nodes?) — depth-first element walk
• getDocumentForElement(node) — owning Document / ShadowRoot
• cleanJSXText(value) — JSX whitespace normalisation
• getValueElement(value, ...args) — resolve a value to a Node
• toDiff(prev, next, short?) — remove stale nodes for <For/>

Notes

Pre-bound creators (createElement, createTextNode, …) are bound to document, so calls are a method dispatch lighter than the platform versions and can be passed around as values. The attribute / class / part helpers are direct passthroughs over their Element counterparts — prefer JSX attributes / properties or class:* in components; these are imperative escape hatches for library code.