id-dom 0.0.3 → 0.0.4

package/{Readme.md → README.md}

@@ -3,21 +3,20 @@
 [![npm version](https://img.shields.io/npm/v/id-dom.svg)](https://www.npmjs.com/package/id-dom)
 [![npm downloads](https://img.shields.io/npm/dm/id-dom.svg)](https://www.npmjs.com/package/id-dom)
 [![GitHub stars](https://img.shields.io/github/stars/iWhatty/id-dom.svg?style=social)](https://github.com/iWhatty/id-dom)
-[![License](https://img.shields.io/github/license/iWhatty/id-dom.svg)](https://github.com/iWhatty/id-dom/blob/main/LICENSE.md)
+[![License](https://img.shields.io/github/license/iWhatty/id-dom.svg)](https://github.com/iWhatty/id-dom/blob/main/LICENSE)
 
-
-**Deterministic DOM element getters by ID (typed, tiny, modern).**
+**Deterministic DOM element getters by ID — typed, tiny, modern.**
 
 `id-dom` is a small utility for grabbing DOM references safely **by `id`**, with predictable behavior:
 
-*  **Typed getters** (`button('saveBtn')`, `input('name')`, etc.)
-*  **Strict or optional** mode (`throw` vs `null`)
-*  **Short optional alias** (`.opt`)
-*  **Scopable** to a root (`document`, `ShadowRoot`, or an `Element`)
-*  **Centralized error handling** (`onError`, optional `warn`)
-*  **Zero deps**
+* **Typed getters** like `button('saveBtn')`, `input('nameInput')`, `svg('icon')`
+* **Strict or optional** mode (`throw` vs `null`)
+* **Short optional alias** via `.opt`
+* **Scoped lookups** for `document`, `ShadowRoot`, `DocumentFragment`, or an `Element`
+* **Centralized error handling** with `onError` and optional `warn`
+* **Zero deps**
 
-This is deliberately **not** a selector framework — it’s a tiny “ID-first” primitive for clean, safe DOM wiring.
+This is deliberately **not** a selector framework. It is a tiny, ID-first primitive for safe DOM wiring.
 
 ---
 
@@ -34,17 +33,16 @@ npm install id-dom
 ```js
 import dom from 'id-dom'
 
-const saveBtn = dom.button('saveBtn') // throws if missing or wrong type
+const saveBtn = dom.button('saveBtn')
 saveBtn.addEventListener('click', save)
 ```
 
-Optional access (never throws for missing/wrong-type):
+Optional access never throws for missing or wrong-type elements:
 
 ```js
 const debug = dom.div.optional('debugPanel')
 debug?.append('hello')
 
-// short alias
 const maybeCanvas = dom.canvas.opt('game')
 ```
 
@@ -58,9 +56,9 @@ Using `getElementById` is:
 * unambiguous
 * easy to reason about
 
-…and with typed getters, you immediately know whether you have a `HTMLButtonElement`, `HTMLInputElement`, etc.
+And with typed getters, you immediately know whether you got a `HTMLButtonElement`, `HTMLInputElement`, `SVGSVGElement`, and so on.
 
-Scoped lookups safely escape IDs when using `querySelector`, ensuring stability even for edge-case IDs (e.g. starting with digits).
+When scoped roots do not support `getElementById`, `id-dom` falls back to `querySelector(#id)` and safely escapes edge-case IDs.
 
 ---
 
@@ -71,7 +69,8 @@ Scoped lookups safely escape IDs when using `querySelector`, ensuring stability
 The default export is a scoped instance using `document` (when available) with **strict** behavior:
 
 * missing element → **throws**
-* wrong type/tag → **throws**
+* wrong type or wrong tag → **throws**
+* invalid input → **throws**
 
 ```js
 import dom from 'id-dom'
@@ -84,17 +83,16 @@ const submit = dom.button('submitBtn')
 
 ### `createDom(root, config?)`
 
-Create a scoped instance that searches within a root:
+Create a scoped instance that searches within a specific root:
 
-* `document` (uses `getElementById`)
-* `ShadowRoot` / `Element` (uses `querySelector(#id)` fallback)
+* `document` → uses `getElementById`
+* `ShadowRoot`, `DocumentFragment`, or `Element` → uses `querySelector(#id)` fallback
 
 ```js
 import { createDom } from 'id-dom'
 
 const d = createDom(document, { mode: 'null', warn: true })
-
-const sidebar = d.div('sidebar') // null if missing
+const sidebar = d.div('sidebar')
 ```
 
 #### Config
@@ -103,8 +101,8 @@ const sidebar = d.div('sidebar') // null if missing
 type DomMode = 'throw' | 'null'
 
 {
-  mode?: DomMode                 // default: 'throw'
-  warn?: boolean                 // default: false
+  mode?: DomMode
+  warn?: boolean
   onError?: (err: Error, ctx: any) => void
 }
 ```
@@ -121,23 +119,32 @@ import { byId } from 'id-dom'
 const btn = byId('saveBtn', HTMLButtonElement)
 ```
 
-Optional variants (never throw for missing/wrong-type):
+Optional variants:
 
 ```js
 const maybeBtn = byId.optional('saveBtn', HTMLButtonElement)
 const maybeBtn2 = byId.opt('saveBtn', HTMLButtonElement)
 ```
 
+#### Behavior
+
+* valid match → returns the element
+* missing element → throws or returns `null`
+* wrong type → throws or returns `null`
+* invalid `id` → throws or returns `null`
+* invalid `Type` → throws or returns `null`
+
 ---
 
 ### `tag(id, tagName, config?)`
 
-Tag-based validation for semantic elements:
+Tag-based validation when constructor checks are not the right fit:
 
 ```js
 import { tag } from 'id-dom'
 
 const main = tag('appMain', 'main')
+const icon = tag('icon', 'svg', { root: container })
 ```
 
 Optional variants:
@@ -147,13 +154,21 @@ const maybeMain = tag.optional('appMain', 'main')
 const maybeMain2 = tag.opt('appMain', 'main')
 ```
 
+#### Behavior
+
+* valid tag match → returns the element
+* missing element → throws or returns `null`
+* wrong tag → throws or returns `null`
+* invalid `id` → throws or returns `null`
+* invalid `tagName` → throws or returns `null`
+
 ---
 
 ## Built-in Getters
 
 ### Typed getters
 
-From `dom` (and any `createDom()` instance):
+Available on `dom` and on any `createDom()` instance:
 
 * `el(id)` → `HTMLElement`
 * `input(id)` → `HTMLInputElement`
@@ -167,27 +182,28 @@ From `dom` (and any `createDom()` instance):
 * `canvas(id)` → `HTMLCanvasElement`
 * `template(id)` → `HTMLTemplateElement`
 * `svg(id)` → `SVGSVGElement`
+* `body(id)` → `HTMLBodyElement`
 
-Each also has:
+Each getter also has:
 
 ```js
 dom.canvas.optional('game')
 dom.canvas.opt('game')
 ```
 
-### Common semantic tags
+### Common tag helpers
 
-* `main(id)` → `<main>`
-* `section(id)` → `<section>`
-* `small(id)` → `<small>`
+* `main(id)` → validates `<main>`
+* `section(id)` → validates `<section>`
+* `small(id)` → validates `<small>`
 
-(Also with `.optional` and `.opt`.)
+Each also supports `.optional` and `.opt`.
 
 ---
 
 ## Error Handling
 
-### Throwing (default)
+### Throwing mode
 
 ```js
 import dom from 'id-dom'
@@ -201,7 +217,6 @@ dom.button('missing') // throws
 import { createDom } from 'id-dom'
 
 const d = createDom(document, { mode: 'null' })
-
 d.button('missing') // null
 ```
 
@@ -216,7 +231,7 @@ const d = createDom(document, {
 })
 ```
 
-Enable console warnings:
+Enable console warnings too:
 
 ```js
 createDom(document, { mode: 'null', warn: true })
@@ -224,7 +239,9 @@ createDom(document, { mode: 'null', warn: true })
 
 ---
 
-## Shadow DOM / Scoped Roots
+## Scoped Roots
+
+### Shadow DOM
 
 ```js
 import { createDom } from 'id-dom'
@@ -237,6 +254,30 @@ const d = createDom(shadow)
 const btn = d.button('shadowBtn')
 ```
 
+### Element root
+
+```js
+const container = document.querySelector('#settings-panel')
+const d = createDom(container)
+const input = d.input('emailInput')
+```
+
+### SVG in scoped roots
+
+```js
+const container = document.querySelector('#icons')
+const d = createDom(container)
+const icon = d.svg('logoMark')
+```
+
+---
+
+## Notes
+
+* `el(id)` is specifically for `HTMLElement`, not every possible DOM `Element`.
+* `body(id)` looks up a `<body>` **by ID**. This library stays ID-first on purpose.
+* `tag()` can validate non-HTML tags too, such as `svg`, when used against supported scoped roots.
+
 ---
 
 ## Browser Support
@@ -246,7 +287,7 @@ Modern browsers supporting:
 * `getElementById`
 * `querySelector`
 
-`CSS.escape` is used when available. A safe internal fallback is provided for environments (e.g. some jsdom builds) where it is missing.
+`CSS.escape` is used when available. A safe internal fallback is included for environments such as some jsdom builds where it may be missing.
 
 ---
 

package/dist/index.cjs

@@ -27,10 +27,22 @@ const DEFAULT_ROOT = typeof document !== "undefined" && document ? document : (
   /** @type {any} */
   null
 );
+const REASON = (
+  /** @type {const} */
+  {
+    INVALID_ID: "invalid-id",
+    INVALID_TYPE: "invalid-type",
+    INVALID_TAG: "invalid-tag",
+    MISSING: "missing",
+    WRONG_TYPE: "wrong-type",
+    WRONG_TAG: "wrong-tag"
+  }
+);
+const SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/;
+const NEEDS_START_ESCAPE_RE = /^(?:\d|-\d)/;
 function normalizeConfig(cfg) {
   return {
     mode: cfg?.mode ?? "throw",
-    // default strict
     warn: cfg?.warn ?? false,
     onError: typeof cfg?.onError === "function" ? cfg.onError : null,
     root: cfg?.root ?? DEFAULT_ROOT
@@ -42,8 +54,6 @@ function hasGetElementById(v) {
 function hasQuerySelector(v) {
   return !!v && typeof v === "object" && typeof v.querySelector === "function";
 }
-const SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/;
-const NEEDS_START_ESCAPE_RE = /^(?:\d|-\d)/;
 function cssEscape(id) {
   const s = String(id);
   if (typeof CSS !== "undefined" && typeof CSS.escape === "function") {
@@ -59,10 +69,13 @@ function cssEscape(id) {
     cp >= 97 && cp <= 122 || // a-z
     cp === 95 || // _
     cp === 45;
-    const needsStartEscape = i === 0 && (cp >= 48 && cp <= 57 || cp === 45 && s.length > 1 && s.codePointAt(1) >= 48 && s.codePointAt(1) <= 57);
+    const next = s.codePointAt(i + 1);
+    const startsWithDigit = cp >= 48 && cp <= 57;
+    const startsWithDashDigit = cp === 45 && s.length > 1 && next >= 48 && next <= 57;
+    const needsStartEscape = i === 0 && (startsWithDigit || startsWithDashDigit);
     if (!needsStartEscape && (isAsciiSafe || cp >= 160)) {
       out += ch;
-    } else if (cp === 45 && i === 0 && s.length > 1 && s.codePointAt(1) >= 48 && s.codePointAt(1) <= 57) {
+    } else if (i === 0 && startsWithDashDigit) {
       out += "\\-";
     } else {
       out += `\\${cp.toString(16).toUpperCase()} `;
@@ -71,16 +84,32 @@ function cssEscape(id) {
   }
   return out;
 }
+function isElementNode(v) {
+  if (!v || typeof v !== "object") return false;
+  if (typeof Element !== "undefined") return v instanceof Element;
+  return (
+    /** @type {any} */
+    v.nodeType === 1
+  );
+}
 function getById(root, id) {
   if (!root) return null;
   if (hasGetElementById(root)) return root.getElementById(id);
   if (hasQuerySelector(root)) {
-    const sel = `#${cssEscape(id)}`;
-    const el = root.querySelector(sel);
-    return el instanceof HTMLElement ? el : null;
+    const el = root.querySelector(`#${cssEscape(id)}`);
+    return isElementNode(el) ? el : null;
   }
   return null;
 }
+function isValidId(v) {
+  return typeof v === "string" && v.length > 0;
+}
+function isValidTagName(v) {
+  return typeof v === "string" && v.trim().length > 0;
+}
+function isConstructor(v) {
+  return typeof v === "function";
+}
 function fmtId(id) {
   return id.startsWith("#") ? id : `#${id}`;
 }
@@ -95,54 +124,114 @@ function handleLookupError(err, ctx, cfg) {
     cfg.onError?.(err, ctx);
   } catch {
   }
-  if (cfg.warn) console.warn(err);
+  if (cfg.warn) console.warn(err, ctx);
   if (cfg.mode === "throw") throw err;
   return null;
 }
-function byId(id, Type, config) {
+function createCtx(id, root, reason, extra) {
+  return {
+    id,
+    root,
+    reason,
+    ...extra || {}
+  };
+}
+function resolveLookup(config, spec) {
   const cfg = normalizeConfig(config);
-  const el = getById(cfg.root, id);
+  const inputFailure = spec.validateInput(cfg);
+  if (inputFailure) {
+    return handleLookupError(inputFailure.err, inputFailure.ctx, cfg);
+  }
+  const el = getById(cfg.root, spec.id);
   if (!el) {
-    return handleLookupError(
-      missingElError(id, Type.name),
-      { id, Type, root: cfg.root, reason: "missing" },
-      cfg
-    );
-  }
-  if (!(el instanceof Type)) {
-    const got = el?.constructor?.name || typeof el;
-    return handleLookupError(
-      wrongTypeError(id, Type.name, got),
-      { id, Type, root: cfg.root, reason: "wrong-type", got },
-      cfg
-    );
-  }
-  return el;
+    const failure = spec.onMissing(cfg);
+    return handleLookupError(failure.err, failure.ctx, cfg);
+  }
+  if (!spec.matches(el, cfg)) {
+    const failure = spec.onMismatch(el, cfg);
+    return handleLookupError(failure.err, failure.ctx, cfg);
+  }
+  return (
+    /** @type {T} */
+    el
+  );
+}
+function byId(id, Type, config) {
+  return resolveLookup(config, {
+    id,
+    validateInput(cfg) {
+      if (!isValidId(id)) {
+        return {
+          err: new Error("id-dom: invalid id (expected non-empty string)"),
+          ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { Type })
+        };
+      }
+      if (!isConstructor(Type)) {
+        return {
+          err: new Error(`id-dom: invalid Type for ${fmtId(id)}`),
+          ctx: createCtx(id, cfg.root, REASON.INVALID_TYPE, { Type })
+        };
+      }
+      return null;
+    },
+    onMissing(cfg) {
+      return {
+        err: missingElError(id, Type.name),
+        ctx: createCtx(id, cfg.root, REASON.MISSING, { Type })
+      };
+    },
+    matches(el) {
+      return el instanceof Type;
+    },
+    onMismatch(el, cfg) {
+      const got = el?.constructor?.name || typeof el;
+      return {
+        err: wrongTypeError(id, Type.name, got),
+        ctx: createCtx(id, cfg.root, REASON.WRONG_TYPE, { Type, got })
+      };
+    }
+  });
 }
 byId.optional = function byIdOptional(id, Type, config) {
   return byId(id, Type, { ...config, mode: "null" });
 };
 byId.opt = byId.optional;
 function tag(id, tagName, config) {
-  const cfg = normalizeConfig(config);
-  const el = getById(cfg.root, id);
-  if (!el) {
-    return handleLookupError(
-      missingElError(id, `<${tagName}>`),
-      { id, tagName, root: cfg.root, reason: "missing" },
-      cfg
-    );
-  }
-  const expected = String(tagName).toUpperCase();
-  const got = String(el.tagName || "").toUpperCase();
-  if (got !== expected) {
-    return handleLookupError(
-      wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),
-      { id, tagName, root: cfg.root, reason: "wrong-tag", got },
-      cfg
-    );
-  }
-  return el;
+  return resolveLookup(config, {
+    id,
+    validateInput(cfg) {
+      if (!isValidId(id)) {
+        return {
+          err: new Error("id-dom: invalid id (expected non-empty string)"),
+          ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { tagName })
+        };
+      }
+      if (!isValidTagName(tagName)) {
+        return {
+          err: new Error(`id-dom: invalid tagName for ${fmtId(id)}`),
+          ctx: createCtx(id, cfg.root, REASON.INVALID_TAG, { tagName })
+        };
+      }
+      return null;
+    },
+    onMissing(cfg) {
+      return {
+        err: missingElError(id, `<${tagName}>`),
+        ctx: createCtx(id, cfg.root, REASON.MISSING, { tagName })
+      };
+    },
+    matches(el) {
+      return String(el.tagName || "").toUpperCase() === String(tagName).toUpperCase();
+    },
+    onMismatch(el, cfg) {
+      const expected = String(tagName).toUpperCase();
+      const got = String(el.tagName || "").toUpperCase();
+      return {
+        err: wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),
+        ctx: createCtx(id, cfg.root, REASON.WRONG_TAG, { tagName, got })
+      };
+    }
+  });
 }
 tag.optional = function tagOptional(id, tagName, config) {
   return tag(id, tagName, { ...config, mode: "null" });
@@ -162,7 +251,8 @@ const TYPE_HELPERS = (
     label: typeof HTMLLabelElement !== "undefined" ? HTMLLabelElement : null,
     canvas: typeof HTMLCanvasElement !== "undefined" ? HTMLCanvasElement : null,
     template: typeof HTMLTemplateElement !== "undefined" ? HTMLTemplateElement : null,
-    svg: typeof SVGSVGElement !== "undefined" ? SVGSVGElement : null
+    svg: typeof SVGSVGElement !== "undefined" ? SVGSVGElement : null,
+    body: typeof HTMLBodyElement !== "undefined" ? HTMLBodyElement : null
   }
 );
 const TAG_HELPERS = (
@@ -173,42 +263,53 @@ const TAG_HELPERS = (
     small: "small"
   }
 );
+function attachOptional(fn, optionalFn) {
+  if (typeof fn !== "function") {
+    throw new TypeError("id-dom: attachOptional expected fn to be a function");
+  }
+  if (typeof optionalFn !== "function") {
+    throw new TypeError("id-dom: attachOptional expected optionalFn to be a function");
+  }
+  fn.optional = optionalFn;
+  fn.opt = optionalFn;
+  return fn;
+}
+function makeTypedHelper(Type, base, baseNull) {
+  if (!Type) {
+    throw new TypeError("id-dom: makeTypedHelper received an invalid Type");
+  }
+  return attachOptional(
+    (id) => byId(id, Type, base),
+    (id) => byId(id, Type, baseNull)
+  );
+}
+function makeTagHelper(tagName, base, baseNull) {
+  if (!tagName) {
+    throw new TypeError("id-dom: makeTagHelper received an invalid tagName");
+  }
+  return attachOptional(
+    (id) => tag(id, tagName, base),
+    (id) => tag(id, tagName, baseNull)
+  );
+}
 function createDom(root, config) {
   const base = normalizeConfig({ ...config, root });
   const baseNull = { ...base, mode: "null" };
-  const api = {
-    // generic
-    byId: (id, Type) => byId(id, Type, base),
-    tag: (id, name) => tag(id, name, base)
-  };
+  const api = {};
+  api.byId = attachOptional(
+    (id, Type) => byId(id, Type, base),
+    (id, Type) => byId(id, Type, baseNull)
+  );
+  api.tag = attachOptional(
+    (id, name) => tag(id, name, base),
+    (id, name) => tag(id, name, baseNull)
+  );
   for (const [name, Type] of Object.entries(TYPE_HELPERS)) {
     if (!Type) continue;
-    api[name] = (id) => byId(id, Type, base);
+    api[name] = makeTypedHelper(Type, base, baseNull);
   }
   for (const [name, tagName] of Object.entries(TAG_HELPERS)) {
-    api[name] = (id) => tag(id, tagName, base);
-  }
-  api.byId.optional = (id, Type) => byId(id, Type, baseNull);
-  api.byId.opt = api.byId.optional;
-  api.tag.optional = (id, name) => tag(id, name, baseNull);
-  api.tag.opt = api.tag.optional;
-  for (const k of Object.keys(api)) {
-    const fn = api[k];
-    if (typeof fn !== "function") continue;
-    if (fn.optional) continue;
-    if (k in TAG_HELPERS) {
-      const tagName = TAG_HELPERS[k];
-      fn.optional = (id) => tag(id, tagName, baseNull);
-      fn.opt = fn.optional;
-      continue;
-    }
-    if (k in TYPE_HELPERS) {
-      const Type = TYPE_HELPERS[k];
-      if (Type) {
-        fn.optional = (id) => byId(id, Type, baseNull);
-        fn.opt = fn.optional;
-      }
-    }
+    api[name] = makeTagHelper(tagName, base, baseNull);
   }
   return api;
 }

package/dist/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/id-dom.js"],
-  "sourcesContent": ["// id-dom.js\r\n// id-dom \u2014 deterministic DOM element getters by ID (typed, tiny, modern)\r\n//\r\n// Goals:\r\n// - Prefer getElementById (fast, unambiguous)\r\n// - Return the correct type or fail predictably\r\n// - Provide strict + optional variants\r\n// - Allow app/module-level defaults (throw vs null) without bundler magic\r\n// - Zero deps, framework-agnostic\r\n\r\nconst DEFAULT_ROOT =\r\n    typeof document !== 'undefined' && document ? document : /** @type {any} */ (null)\r\n\r\n/**\r\n * @typedef {'throw' | 'null'} DomMode\r\n */\r\n\r\n/**\r\n * @typedef {{\r\n *   mode?: DomMode\r\n *   warn?: boolean\r\n *   onError?: (error: Error, ctx: any) => void\r\n *   root?: any\r\n * }} DomConfig\r\n */\r\n\r\n/**\r\n * @param {DomConfig | undefined} cfg\r\n */\r\nfunction normalizeConfig(cfg) {\r\n    return {\r\n        mode: cfg?.mode ?? 'throw', // default strict\r\n        warn: cfg?.warn ?? false,\r\n        onError: typeof cfg?.onError === 'function' ? cfg.onError : null,\r\n        root: cfg?.root ?? DEFAULT_ROOT,\r\n    }\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is { getElementById(id: string): HTMLElement | null }}\r\n */\r\nfunction hasGetElementById(v) {\r\n    return !!v && typeof v === 'object' && typeof v.getElementById === 'function'\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is { querySelector(sel: string): Element | null }}\r\n */\r\nfunction hasQuerySelector(v) {\r\n    return !!v && typeof v === 'object' && typeof v.querySelector === 'function'\r\n}\r\n\r\n\r\nconst SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/\r\nconst NEEDS_START_ESCAPE_RE = /^(?:\\d|-\\d)/\r\n\r\n/**\r\n * Minimal CSS.escape fallback for environments where CSS.escape is missing (e.g. some jsdom builds).\r\n * We only need to safely build `#${id}` selectors.\r\n *\r\n * @param {string} id\r\n */\r\nfunction cssEscape(id) {\r\n  const s = String(id)\r\n\r\n  // Prefer native when available\r\n  if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\r\n    return CSS.escape(s)\r\n  }\r\n\r\n  // Fast path: most app IDs are already safe\r\n  if (!NEEDS_START_ESCAPE_RE.test(s) && SAFE_ID_RE.test(s)) return s\r\n\r\n  // One-pass escape:\r\n  // - Escape any char outside a conservative \"safe\" set\r\n  // - Also escape the start if it begins with a digit OR \"-<digit>\"\r\n  let out = ''\r\n  for (let i = 0; i < s.length; ) {\r\n    const cp = s.codePointAt(i)\r\n    const ch = String.fromCodePoint(cp)\r\n\r\n    const isAsciiSafe =\r\n      (cp >= 48 && cp <= 57) || // 0-9\r\n      (cp >= 65 && cp <= 90) || // A-Z\r\n      (cp >= 97 && cp <= 122) || // a-z\r\n      cp === 95 || // _\r\n      cp === 45 // -\r\n\r\n    const needsStartEscape =\r\n      i === 0 && ((cp >= 48 && cp <= 57) || (cp === 45 && s.length > 1 && s.codePointAt(1) >= 48 && s.codePointAt(1) <= 57))\r\n\r\n    if (!needsStartEscape && (isAsciiSafe || cp >= 0x00A0)) {\r\n      // allow non-ascii chars directly (common CSS ident behavior)\r\n      out += ch\r\n    } else if (cp === 45 && i === 0 && s.length > 1 && s.codePointAt(1) >= 48 && s.codePointAt(1) <= 57) {\r\n      // \"-<digit>\" start: escaping just the leading hyphen is a simple fix\r\n      out += '\\\\-'\r\n    } else {\r\n      // hex escape + trailing space is safest\r\n      out += `\\\\${cp.toString(16).toUpperCase()} `\r\n    }\r\n\r\n    i += ch.length\r\n  }\r\n\r\n  return out\r\n}\r\n\r\n\r\n/**\r\n * Resolve an element by id from a \"root\".\r\n * Supports:\r\n *  - Document (getElementById)\r\n *  - ShadowRoot / DocumentFragment / Element (querySelector fallback)\r\n *\r\n * @param {any} root\r\n * @param {string} id\r\n * @returns {HTMLElement | null}\r\n */\r\nfunction getById(root, id) {\r\n    if (!root) return null\r\n\r\n    if (hasGetElementById(root)) return root.getElementById(id)\r\n\r\n    // ShadowRoot/DocumentFragment/Element don\u2019t have getElementById\r\n    if (hasQuerySelector(root)) {\r\n        const sel = `#${cssEscape(id)}`\r\n        const el = root.querySelector(sel)\r\n        return el instanceof HTMLElement ? el : null\r\n    }\r\n\r\n    return null\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @returns {string}\r\n */\r\nfunction fmtId(id) {\r\n    return id.startsWith('#') ? id : `#${id}`\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {string} expected\r\n */\r\nfunction missingElError(id, expected) {\r\n    return new Error(`id-dom: missing ${expected} element ${fmtId(id)}`)\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {string} expected\r\n * @param {string} got\r\n */\r\nfunction wrongTypeError(id, expected, got) {\r\n    return new Error(`id-dom: expected ${expected} for ${fmtId(id)}, got ${got}`)\r\n}\r\n\r\n/**\r\n * Centralized error policy:\r\n * - always call onError if present\r\n * - optionally warn\r\n * - throw or return null depending on mode\r\n *\r\n * @template T\r\n * @param {Error} err\r\n * @param {any} ctx\r\n * @param {ReturnType<typeof normalizeConfig>} cfg\r\n * @returns {T | null}\r\n */\r\nfunction handleLookupError(err, ctx, cfg) {\r\n    try {\r\n        cfg.onError?.(err, ctx)\r\n    } catch {\r\n        // do not let reporting break app logic\r\n    }\r\n\r\n    if (cfg.warn) console.warn(err)\r\n\r\n    if (cfg.mode === 'throw') throw err\r\n    return null\r\n}\r\n\r\n/**\r\n * Typed lookup by ID.\r\n * Behavior is controlled by config:\r\n *  - mode: 'throw' (default) or 'null'\r\n *  - warn: boolean\r\n *  - onError(err, ctx)\r\n *\r\n * @template {Element} T\r\n * @param {string} id\r\n * @param {{ new (...args: any[]): T }} Type\r\n * @param {DomConfig} [config]\r\n * @returns {T | null}\r\n */\r\nexport function byId(id, Type, config) {\r\n    const cfg = normalizeConfig(config)\r\n    const el = getById(cfg.root, id)\r\n\r\n    if (!el) {\r\n        return handleLookupError(\r\n            missingElError(id, Type.name),\r\n            { id, Type, root: cfg.root, reason: 'missing' },\r\n            cfg\r\n        )\r\n    }\r\n\r\n    if (!(el instanceof Type)) {\r\n        const got = el?.constructor?.name || typeof el\r\n        return handleLookupError(\r\n            wrongTypeError(id, Type.name, got),\r\n            { id, Type, root: cfg.root, reason: 'wrong-type', got },\r\n            cfg\r\n        )\r\n    }\r\n\r\n    return el\r\n}\r\n\r\n/**\r\n * Optional typed lookup: ALWAYS returns T | null (never throws for missing/wrong-type).\r\n *\r\n * @template {Element} T\r\n * @param {string} id\r\n * @param {{ new (...args: any[]): T }} Type\r\n * @param {DomConfig} [config]\r\n * @returns {T | null}\r\n */\r\nbyId.optional = function byIdOptional(id, Type, config) {\r\n    return byId(id, Type, { ...config, mode: 'null' })\r\n}\r\n\r\n// Short alias (module-level; do not reassign inside factories)\r\nbyId.opt = byId.optional\r\n\r\n/**\r\n * Tag-name lookup (HTMLElement only).\r\n * Useful for semantic elements that don\u2019t have unique constructors.\r\n *\r\n * @param {string} id\r\n * @param {string} tagName\r\n * @param {DomConfig} [config]\r\n * @returns {HTMLElement | null}\r\n */\r\nexport function tag(id, tagName, config) {\r\n    const cfg = normalizeConfig(config)\r\n    const el = getById(cfg.root, id)\r\n\r\n    if (!el) {\r\n        return handleLookupError(\r\n            missingElError(id, `<${tagName}>`),\r\n            { id, tagName, root: cfg.root, reason: 'missing' },\r\n            cfg\r\n        )\r\n    }\r\n\r\n    const expected = String(tagName).toUpperCase()\r\n    const got = String(el.tagName || '').toUpperCase()\r\n\r\n    if (got !== expected) {\r\n        return handleLookupError(\r\n            wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),\r\n            { id, tagName, root: cfg.root, reason: 'wrong-tag', got },\r\n            cfg\r\n        )\r\n    }\r\n\r\n    return el\r\n}\r\n\r\n/**\r\n * Optional tag lookup: ALWAYS returns HTMLElement | null (never throws for missing/wrong-tag).\r\n *\r\n * @param {string} id\r\n * @param {string} tagName\r\n * @param {DomConfig} [config]\r\n * @returns {HTMLElement | null}\r\n */\r\ntag.optional = function tagOptional(id, tagName, config) {\r\n    return tag(id, tagName, { ...config, mode: 'null' })\r\n}\r\n\r\n// Short alias (module-level; do not reassign inside factories)\r\ntag.opt = tag.optional\r\n\r\n// --- internal maps for factory helpers ---\r\nconst TYPE_HELPERS = /** @type {Record<string, any>} */ ({\r\n    el: typeof HTMLElement !== 'undefined' ? HTMLElement : null,\r\n    input: typeof HTMLInputElement !== 'undefined' ? HTMLInputElement : null,\r\n    button: typeof HTMLButtonElement !== 'undefined' ? HTMLButtonElement : null,\r\n    textarea: typeof HTMLTextAreaElement !== 'undefined' ? HTMLTextAreaElement : null,\r\n    select: typeof HTMLSelectElement !== 'undefined' ? HTMLSelectElement : null,\r\n    form: typeof HTMLFormElement !== 'undefined' ? HTMLFormElement : null,\r\n    div: typeof HTMLDivElement !== 'undefined' ? HTMLDivElement : null,\r\n    span: typeof HTMLSpanElement !== 'undefined' ? HTMLSpanElement : null,\r\n    label: typeof HTMLLabelElement !== 'undefined' ? HTMLLabelElement : null,\r\n    canvas: typeof HTMLCanvasElement !== 'undefined' ? HTMLCanvasElement : null,\r\n    template: typeof HTMLTemplateElement !== 'undefined' ? HTMLTemplateElement : null,\r\n    svg: typeof SVGSVGElement !== 'undefined' ? SVGSVGElement : null,\r\n})\r\n\r\nconst TAG_HELPERS = /** @type {Record<string, string>} */ ({\r\n    main: 'main',\r\n    section: 'section',\r\n    small: 'small',\r\n})\r\n\r\n/**\r\n * Factory: scope getters to a specific root + default policy.\r\n *\r\n * @param {any} root\r\n * @param {Omit<DomConfig, 'root'>} [config]\r\n */\r\nexport function createDom(root, config) {\r\n    const base = normalizeConfig({ ...config, root })\r\n    const baseNull = { ...base, mode: 'null' }\r\n\r\n    /** @type {any} */\r\n    const api = {\r\n        // generic\r\n        byId: (id, Type) => byId(id, Type, base),\r\n        tag: (id, name) => tag(id, name, base),\r\n    }\r\n\r\n    // typed helpers\r\n    for (const [name, Type] of Object.entries(TYPE_HELPERS)) {\r\n        if (!Type) continue\r\n        api[name] = (id) => byId(id, Type, base)\r\n    }\r\n\r\n    // semantic tag helpers\r\n    for (const [name, tagName] of Object.entries(TAG_HELPERS)) {\r\n        api[name] = (id) => tag(id, tagName, base)\r\n    }\r\n\r\n    // --- Optional variants (policy-based; never swallow unrelated exceptions) ---\r\n    api.byId.optional = (id, Type) => byId(id, Type, baseNull)\r\n    api.byId.opt = api.byId.optional\r\n\r\n    api.tag.optional = (id, name) => tag(id, name, baseNull)\r\n    api.tag.opt = api.tag.optional\r\n\r\n    // Add `.optional` + `.opt` to every helper using the same \"null\" policy\r\n    for (const k of Object.keys(api)) {\r\n        const fn = api[k]\r\n        if (typeof fn !== 'function') continue\r\n        if (fn.optional) continue\r\n\r\n        if (k in TAG_HELPERS) {\r\n            const tagName = TAG_HELPERS[k]\r\n            fn.optional = (id) => tag(id, tagName, baseNull)\r\n            fn.opt = fn.optional\r\n            continue\r\n        }\r\n\r\n        if (k in TYPE_HELPERS) {\r\n            const Type = TYPE_HELPERS[k]\r\n            if (Type) {\r\n                fn.optional = (id) => byId(id, Type, baseNull)\r\n                fn.opt = fn.optional\r\n            }\r\n        }\r\n    }\r\n\r\n    return api\r\n}\r\n\r\n// Default export: root = document (if available), strict by default\r\nconst dom = createDom(DEFAULT_ROOT, { mode: 'throw' })\r\nexport default dom\r\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUA,MAAM,eACF,OAAO,aAAa,eAAe,WAAW;AAAA;AAAA,EAA+B;AAAA;AAkBjF,SAAS,gBAAgB,KAAK;AAC1B,SAAO;AAAA,IACH,MAAM,KAAK,QAAQ;AAAA;AAAA,IACnB,MAAM,KAAK,QAAQ;AAAA,IACnB,SAAS,OAAO,KAAK,YAAY,aAAa,IAAI,UAAU;AAAA,IAC5D,MAAM,KAAK,QAAQ;AAAA,EACvB;AACJ;AAMA,SAAS,kBAAkB,GAAG;AAC1B,SAAO,CAAC,CAAC,KAAK,OAAO,MAAM,YAAY,OAAO,EAAE,mBAAmB;AACvE;AAMA,SAAS,iBAAiB,GAAG;AACzB,SAAO,CAAC,CAAC,KAAK,OAAO,MAAM,YAAY,OAAO,EAAE,kBAAkB;AACtE;AAGA,MAAM,aAAa;AACnB,MAAM,wBAAwB;AAQ9B,SAAS,UAAU,IAAI;AACrB,QAAM,IAAI,OAAO,EAAE;AAGnB,MAAI,OAAO,QAAQ,eAAe,OAAO,IAAI,WAAW,YAAY;AAClE,WAAO,IAAI,OAAO,CAAC;AAAA,EACrB;AAGA,MAAI,CAAC,sBAAsB,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,EAAG,QAAO;AAKjE,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,EAAE,UAAU;AAC9B,UAAM,KAAK,EAAE,YAAY,CAAC;AAC1B,UAAM,KAAK,OAAO,cAAc,EAAE;AAElC,UAAM,cACH,MAAM,MAAM,MAAM;AAAA,IAClB,MAAM,MAAM,MAAM;AAAA,IAClB,MAAM,MAAM,MAAM;AAAA,IACnB,OAAO;AAAA,IACP,OAAO;AAET,UAAM,mBACJ,MAAM,MAAO,MAAM,MAAM,MAAM,MAAQ,OAAO,MAAM,EAAE,SAAS,KAAK,EAAE,YAAY,CAAC,KAAK,MAAM,EAAE,YAAY,CAAC,KAAK;AAEpH,QAAI,CAAC,qBAAqB,eAAe,MAAM,MAAS;AAEtD,aAAO;AAAA,IACT,WAAW,OAAO,MAAM,MAAM,KAAK,EAAE,SAAS,KAAK,EAAE,YAAY,CAAC,KAAK,MAAM,EAAE,YAAY,CAAC,KAAK,IAAI;AAEnG,aAAO;AAAA,IACT,OAAO;AAEL,aAAO,KAAK,GAAG,SAAS,EAAE,EAAE,YAAY,CAAC;AAAA,IAC3C;AAEA,SAAK,GAAG;AAAA,EACV;AAEA,SAAO;AACT;AAaA,SAAS,QAAQ,MAAM,IAAI;AACvB,MAAI,CAAC,KAAM,QAAO;AAElB,MAAI,kBAAkB,IAAI,EAAG,QAAO,KAAK,eAAe,EAAE;AAG1D,MAAI,iBAAiB,IAAI,GAAG;AACxB,UAAM,MAAM,IAAI,UAAU,EAAE,CAAC;AAC7B,UAAM,KAAK,KAAK,cAAc,GAAG;AACjC,WAAO,cAAc,cAAc,KAAK;AAAA,EAC5C;AAEA,SAAO;AACX;AAMA,SAAS,MAAM,IAAI;AACf,SAAO,GAAG,WAAW,GAAG,IAAI,KAAK,IAAI,EAAE;AAC3C;AAMA,SAAS,eAAe,IAAI,UAAU;AAClC,SAAO,IAAI,MAAM,mBAAmB,QAAQ,YAAY,MAAM,EAAE,CAAC,EAAE;AACvE;AAOA,SAAS,eAAe,IAAI,UAAU,KAAK;AACvC,SAAO,IAAI,MAAM,oBAAoB,QAAQ,QAAQ,MAAM,EAAE,CAAC,SAAS,GAAG,EAAE;AAChF;AAcA,SAAS,kBAAkB,KAAK,KAAK,KAAK;AACtC,MAAI;AACA,QAAI,UAAU,KAAK,GAAG;AAAA,EAC1B,QAAQ;AAAA,EAER;AAEA,MAAI,IAAI,KAAM,SAAQ,KAAK,GAAG;AAE9B,MAAI,IAAI,SAAS,QAAS,OAAM;AAChC,SAAO;AACX;AAeO,SAAS,KAAK,IAAI,MAAM,QAAQ;AACnC,QAAM,MAAM,gBAAgB,MAAM;AAClC,QAAM,KAAK,QAAQ,IAAI,MAAM,EAAE;AAE/B,MAAI,CAAC,IAAI;AACL,WAAO;AAAA,MACH,eAAe,IAAI,KAAK,IAAI;AAAA,MAC5B,EAAE,IAAI,MAAM,MAAM,IAAI,MAAM,QAAQ,UAAU;AAAA,MAC9C;AAAA,IACJ;AAAA,EACJ;AAEA,MAAI,EAAE,cAAc,OAAO;AACvB,UAAM,MAAM,IAAI,aAAa,QAAQ,OAAO;AAC5C,WAAO;AAAA,MACH,eAAe,IAAI,KAAK,MAAM,GAAG;AAAA,MACjC,EAAE,IAAI,MAAM,MAAM,IAAI,MAAM,QAAQ,cAAc,IAAI;AAAA,MACtD;AAAA,IACJ;AAAA,EACJ;AAEA,SAAO;AACX;AAWA,KAAK,WAAW,SAAS,aAAa,IAAI,MAAM,QAAQ;AACpD,SAAO,KAAK,IAAI,MAAM,EAAE,GAAG,QAAQ,MAAM,OAAO,CAAC;AACrD;AAGA,KAAK,MAAM,KAAK;AAWT,SAAS,IAAI,IAAI,SAAS,QAAQ;AACrC,QAAM,MAAM,gBAAgB,MAAM;AAClC,QAAM,KAAK,QAAQ,IAAI,MAAM,EAAE;AAE/B,MAAI,CAAC,IAAI;AACL,WAAO;AAAA,MACH,eAAe,IAAI,IAAI,OAAO,GAAG;AAAA,MACjC,EAAE,IAAI,SAAS,MAAM,IAAI,MAAM,QAAQ,UAAU;AAAA,MACjD;AAAA,IACJ;AAAA,EACJ;AAEA,QAAM,WAAW,OAAO,OAAO,EAAE,YAAY;AAC7C,QAAM,MAAM,OAAO,GAAG,WAAW,EAAE,EAAE,YAAY;AAEjD,MAAI,QAAQ,UAAU;AAClB,WAAO;AAAA,MACH,eAAe,IAAI,IAAI,SAAS,YAAY,CAAC,KAAK,IAAI,IAAI,YAAY,CAAC,GAAG;AAAA,MAC1E,EAAE,IAAI,SAAS,MAAM,IAAI,MAAM,QAAQ,aAAa,IAAI;AAAA,MACxD;AAAA,IACJ;AAAA,EACJ;AAEA,SAAO;AACX;AAUA,IAAI,WAAW,SAAS,YAAY,IAAI,SAAS,QAAQ;AACrD,SAAO,IAAI,IAAI,SAAS,EAAE,GAAG,QAAQ,MAAM,OAAO,CAAC;AACvD;AAGA,IAAI,MAAM,IAAI;AAGd,MAAM;AAAA;AAAA,EAAmD;AAAA,IACrD,IAAI,OAAO,gBAAgB,cAAc,cAAc;AAAA,IACvD,OAAO,OAAO,qBAAqB,cAAc,mBAAmB;AAAA,IACpE,QAAQ,OAAO,sBAAsB,cAAc,oBAAoB;AAAA,IACvE,UAAU,OAAO,wBAAwB,cAAc,sBAAsB;AAAA,IAC7E,QAAQ,OAAO,sBAAsB,cAAc,oBAAoB;AAAA,IACvE,MAAM,OAAO,oBAAoB,cAAc,kBAAkB;AAAA,IACjE,KAAK,OAAO,mBAAmB,cAAc,iBAAiB;AAAA,IAC9D,MAAM,OAAO,oBAAoB,cAAc,kBAAkB;AAAA,IACjE,OAAO,OAAO,qBAAqB,cAAc,mBAAmB;AAAA,IACpE,QAAQ,OAAO,sBAAsB,cAAc,oBAAoB;AAAA,IACvE,UAAU,OAAO,wBAAwB,cAAc,sBAAsB;AAAA,IAC7E,KAAK,OAAO,kBAAkB,cAAc,gBAAgB;AAAA,EAChE;AAAA;AAEA,MAAM;AAAA;AAAA,EAAqD;AAAA,IACvD,MAAM;AAAA,IACN,SAAS;AAAA,IACT,OAAO;AAAA,EACX;AAAA;AAQO,SAAS,UAAU,MAAM,QAAQ;AACpC,QAAM,OAAO,gBAAgB,EAAE,GAAG,QAAQ,KAAK,CAAC;AAChD,QAAM,WAAW,EAAE,GAAG,MAAM,MAAM,OAAO;AAGzC,QAAM,MAAM;AAAA;AAAA,IAER,MAAM,CAAC,IAAI,SAAS,KAAK,IAAI,MAAM,IAAI;AAAA,IACvC,KAAK,CAAC,IAAI,SAAS,IAAI,IAAI,MAAM,IAAI;AAAA,EACzC;AAGA,aAAW,CAAC,MAAM,IAAI,KAAK,OAAO,QAAQ,YAAY,GAAG;AACrD,QAAI,CAAC,KAAM;AACX,QAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,MAAM,IAAI;AAAA,EAC3C;AAGA,aAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,WAAW,GAAG;AACvD,QAAI,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,SAAS,IAAI;AAAA,EAC7C;AAGA,MAAI,KAAK,WAAW,CAAC,IAAI,SAAS,KAAK,IAAI,MAAM,QAAQ;AACzD,MAAI,KAAK,MAAM,IAAI,KAAK;AAExB,MAAI,IAAI,WAAW,CAAC,IAAI,SAAS,IAAI,IAAI,MAAM,QAAQ;AACvD,MAAI,IAAI,MAAM,IAAI,IAAI;AAGtB,aAAW,KAAK,OAAO,KAAK,GAAG,GAAG;AAC9B,UAAM,KAAK,IAAI,CAAC;AAChB,QAAI,OAAO,OAAO,WAAY;AAC9B,QAAI,GAAG,SAAU;AAEjB,QAAI,KAAK,aAAa;AAClB,YAAM,UAAU,YAAY,CAAC;AAC7B,SAAG,WAAW,CAAC,OAAO,IAAI,IAAI,SAAS,QAAQ;AAC/C,SAAG,MAAM,GAAG;AACZ;AAAA,IACJ;AAEA,QAAI,KAAK,cAAc;AACnB,YAAM,OAAO,aAAa,CAAC;AAC3B,UAAI,MAAM;AACN,WAAG,WAAW,CAAC,OAAO,KAAK,IAAI,MAAM,QAAQ;AAC7C,WAAG,MAAM,GAAG;AAAA,MAChB;AAAA,IACJ;AAAA,EACJ;AAEA,SAAO;AACX;AAGA,MAAM,MAAM,UAAU,cAAc,EAAE,MAAM,QAAQ,CAAC;AACrD,IAAO,iBAAQ;",
+  "sourcesContent": ["// id-dom.js\r\n// id-dom \u2014 deterministic DOM element getters by ID (typed, tiny, modern)\r\n//\r\n// Goals:\r\n// - Prefer getElementById (fast, unambiguous)\r\n// - Return the correct type or fail predictably\r\n// - Provide strict + optional variants\r\n// - Allow app/module-level defaults (throw vs null) without bundler magic\r\n// - Zero deps, framework-agnostic\r\n\r\nconst DEFAULT_ROOT =\r\n    typeof document !== 'undefined' && document ? document : /** @type {any} */ (null)\r\n\r\nconst REASON = /** @type {const} */ ({\r\n    INVALID_ID: 'invalid-id',\r\n    INVALID_TYPE: 'invalid-type',\r\n    INVALID_TAG: 'invalid-tag',\r\n    MISSING: 'missing',\r\n    WRONG_TYPE: 'wrong-type',\r\n    WRONG_TAG: 'wrong-tag',\r\n})\r\n\r\nconst SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/\r\nconst NEEDS_START_ESCAPE_RE = /^(?:\\d|-\\d)/\r\n\r\n/**\r\n * @typedef {'throw' | 'null'} DomMode\r\n */\r\n\r\n/**\r\n * @typedef {{\r\n *   mode?: DomMode\r\n *   warn?: boolean\r\n *   onError?: (error: Error, ctx: any) => void\r\n *   root?: any\r\n * }} DomConfig\r\n */\r\n\r\n// -----------------------------------------------------------------------------\r\n// Config\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @param {DomConfig | undefined} cfg\r\n */\r\nfunction normalizeConfig(cfg) {\r\n    return {\r\n        mode: cfg?.mode ?? 'throw',\r\n        warn: cfg?.warn ?? false,\r\n        onError: typeof cfg?.onError === 'function' ? cfg.onError : null,\r\n        root: cfg?.root ?? DEFAULT_ROOT,\r\n    }\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Root / DOM helpers\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is { getElementById(id: string): Element | null }}\r\n */\r\nfunction hasGetElementById(v) {\r\n    return !!v && typeof v === 'object' && typeof v.getElementById === 'function'\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is { querySelector(sel: string): Element | null }}\r\n */\r\nfunction hasQuerySelector(v) {\r\n    return !!v && typeof v === 'object' && typeof v.querySelector === 'function'\r\n}\r\n\r\n/**\r\n * Minimal CSS.escape fallback for environments where CSS.escape is missing.\r\n * We only need to safely build `#${id}` selectors.\r\n *\r\n * @param {string} id\r\n * @returns {string}\r\n */\r\nfunction cssEscape(id) {\r\n    const s = String(id)\r\n\r\n    if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\r\n        return CSS.escape(s)\r\n    }\r\n\r\n    if (!NEEDS_START_ESCAPE_RE.test(s) && SAFE_ID_RE.test(s)) return s\r\n\r\n    let out = ''\r\n    for (let i = 0; i < s.length;) {\r\n        const cp = s.codePointAt(i)\r\n        const ch = String.fromCodePoint(cp)\r\n\r\n        const isAsciiSafe =\r\n            (cp >= 48 && cp <= 57) || // 0-9\r\n            (cp >= 65 && cp <= 90) || // A-Z\r\n            (cp >= 97 && cp <= 122) || // a-z\r\n            cp === 95 || // _\r\n            cp === 45 // -\r\n\r\n        const next = s.codePointAt(i + 1)\r\n        const startsWithDigit = cp >= 48 && cp <= 57\r\n        const startsWithDashDigit = cp === 45 && s.length > 1 && next >= 48 && next <= 57\r\n        const needsStartEscape = i === 0 && (startsWithDigit || startsWithDashDigit)\r\n\r\n        if (!needsStartEscape && (isAsciiSafe || cp >= 0x00a0)) {\r\n            out += ch\r\n        } else if (i === 0 && startsWithDashDigit) {\r\n            out += '\\\\-'\r\n        } else {\r\n            out += `\\\\${cp.toString(16).toUpperCase()} `\r\n        }\r\n\r\n        i += ch.length\r\n    }\r\n\r\n    return out\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is Element}\r\n */\r\nfunction isElementNode(v) {\r\n    if (!v || typeof v !== 'object') return false\r\n    if (typeof Element !== 'undefined') return v instanceof Element\r\n    return /** @type {any} */ (v).nodeType === 1\r\n}\r\n\r\n/**\r\n * Resolve an element by id from a root.\r\n * Supports:\r\n *  - Document (getElementById)\r\n *  - ShadowRoot / DocumentFragment / Element (querySelector fallback)\r\n *\r\n * @param {any} root\r\n * @param {string} id\r\n * @returns {Element | null}\r\n */\r\nfunction getById(root, id) {\r\n    if (!root) return null\r\n\r\n    if (hasGetElementById(root)) return root.getElementById(id)\r\n\r\n    if (hasQuerySelector(root)) {\r\n        const el = root.querySelector(`#${cssEscape(id)}`)\r\n        return isElementNode(el) ? el : null\r\n    }\r\n\r\n    return null\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Validation helpers\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is string}\r\n */\r\nfunction isValidId(v) {\r\n    return typeof v === 'string' && v.length > 0\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is string}\r\n */\r\nfunction isValidTagName(v) {\r\n    return typeof v === 'string' && v.trim().length > 0\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is Function}\r\n */\r\nfunction isConstructor(v) {\r\n    return typeof v === 'function'\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Error / policy helpers\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @param {string} id\r\n * @returns {string}\r\n */\r\nfunction fmtId(id) {\r\n    return id.startsWith('#') ? id : `#${id}`\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {string} expected\r\n * @returns {Error}\r\n */\r\nfunction missingElError(id, expected) {\r\n    return new Error(`id-dom: missing ${expected} element ${fmtId(id)}`)\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {string} expected\r\n * @param {string} got\r\n * @returns {Error}\r\n */\r\nfunction wrongTypeError(id, expected, got) {\r\n    return new Error(`id-dom: expected ${expected} for ${fmtId(id)}, got ${got}`)\r\n}\r\n\r\n/**\r\n * @template T\r\n * @param {Error} err\r\n * @param {any} ctx\r\n * @param {ReturnType<typeof normalizeConfig>} cfg\r\n * @returns {T | null}\r\n */\r\nfunction handleLookupError(err, ctx, cfg) {\r\n    try {\r\n        cfg.onError?.(err, ctx)\r\n    } catch {\r\n        // reporting must never break app logic\r\n    }\r\n\r\n    if (cfg.warn) console.warn(err, ctx)\r\n\r\n    if (cfg.mode === 'throw') throw err\r\n    return null\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {any} root\r\n * @param {string} reason\r\n * @param {object} [extra]\r\n * @returns {any}\r\n */\r\nfunction createCtx(id, root, reason, extra) {\r\n    return {\r\n        id,\r\n        root,\r\n        reason,\r\n        ...(extra || {}),\r\n    }\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Internal generic resolver\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @template T\r\n * @param {DomConfig | undefined} config\r\n * @param {{\r\n *   id: string,\r\n *   validateInput: (cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any } | null,\r\n *   onMissing: (cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any },\r\n *   matches: (el: Element, cfg: ReturnType<typeof normalizeConfig>) => boolean,\r\n *   onMismatch: (el: Element, cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any },\r\n * }} spec\r\n * @returns {T | null}\r\n */\r\nfunction resolveLookup(config, spec) {\r\n    const cfg = normalizeConfig(config)\r\n\r\n    const inputFailure = spec.validateInput(cfg)\r\n    if (inputFailure) {\r\n        return handleLookupError(inputFailure.err, inputFailure.ctx, cfg)\r\n    }\r\n\r\n    const el = getById(cfg.root, spec.id)\r\n    if (!el) {\r\n        const failure = spec.onMissing(cfg)\r\n        return handleLookupError(failure.err, failure.ctx, cfg)\r\n    }\r\n\r\n    if (!spec.matches(el, cfg)) {\r\n        const failure = spec.onMismatch(el, cfg)\r\n        return handleLookupError(failure.err, failure.ctx, cfg)\r\n    }\r\n\r\n    return /** @type {T} */ (el)\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Public APIs\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * Typed lookup by ID.\r\n *\r\n * @template {Element} T\r\n * @param {string} id\r\n * @param {{ new (...args: any[]): T }} Type\r\n * @param {DomConfig} [config]\r\n * @returns {T | null}\r\n */\r\nexport function byId(id, Type, config) {\r\n    return resolveLookup(config, {\r\n        id,\r\n\r\n        validateInput(cfg) {\r\n            if (!isValidId(id)) {\r\n                return {\r\n                    err: new Error('id-dom: invalid id (expected non-empty string)'),\r\n                    ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { Type }),\r\n                }\r\n            }\r\n\r\n            if (!isConstructor(Type)) {\r\n                return {\r\n                    err: new Error(`id-dom: invalid Type for ${fmtId(id)}`),\r\n                    ctx: createCtx(id, cfg.root, REASON.INVALID_TYPE, { Type }),\r\n                }\r\n            }\r\n\r\n            return null\r\n        },\r\n\r\n        onMissing(cfg) {\r\n            return {\r\n                err: missingElError(id, Type.name),\r\n                ctx: createCtx(id, cfg.root, REASON.MISSING, { Type }),\r\n            }\r\n        },\r\n\r\n        matches(el) {\r\n            return el instanceof Type\r\n        },\r\n\r\n        onMismatch(el, cfg) {\r\n            const got = el?.constructor?.name || typeof el\r\n            return {\r\n                err: wrongTypeError(id, Type.name, got),\r\n                ctx: createCtx(id, cfg.root, REASON.WRONG_TYPE, { Type, got }),\r\n            }\r\n        },\r\n    })\r\n}\r\n\r\n/**\r\n * Optional typed lookup: always returns T | null.\r\n *\r\n * @template {Element} T\r\n * @param {string} id\r\n * @param {{ new (...args: any[]): T }} Type\r\n * @param {DomConfig} [config]\r\n * @returns {T | null}\r\n */\r\nbyId.optional = function byIdOptional(id, Type, config) {\r\n    return byId(id, Type, { ...config, mode: 'null' })\r\n}\r\n\r\nbyId.opt = byId.optional\r\n\r\n/**\r\n * Tag-name lookup by element tag.\r\n * Useful when constructor checks are not the right fit.\r\n *\r\n * @param {string} id\r\n * @param {string} tagName\r\n * @param {DomConfig} [config]\r\n * @returns {Element | null}\r\n */\r\nexport function tag(id, tagName, config) {\r\n    return resolveLookup(config, {\r\n        id,\r\n\r\n        validateInput(cfg) {\r\n            if (!isValidId(id)) {\r\n                return {\r\n                    err: new Error('id-dom: invalid id (expected non-empty string)'),\r\n                    ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { tagName }),\r\n                }\r\n            }\r\n\r\n            if (!isValidTagName(tagName)) {\r\n                return {\r\n                    err: new Error(`id-dom: invalid tagName for ${fmtId(id)}`),\r\n                    ctx: createCtx(id, cfg.root, REASON.INVALID_TAG, { tagName }),\r\n                }\r\n            }\r\n\r\n            return null\r\n        },\r\n\r\n        onMissing(cfg) {\r\n            return {\r\n                err: missingElError(id, `<${tagName}>`),\r\n                ctx: createCtx(id, cfg.root, REASON.MISSING, { tagName }),\r\n            }\r\n        },\r\n\r\n        matches(el) {\r\n            return String(el.tagName || '').toUpperCase() === String(tagName).toUpperCase()\r\n        },\r\n\r\n        onMismatch(el, cfg) {\r\n            const expected = String(tagName).toUpperCase()\r\n            const got = String(el.tagName || '').toUpperCase()\r\n\r\n            return {\r\n                err: wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),\r\n                ctx: createCtx(id, cfg.root, REASON.WRONG_TAG, { tagName, got }),\r\n            }\r\n        },\r\n    })\r\n}\r\n\r\n/**\r\n * Optional tag lookup: always returns Element | null.\r\n *\r\n * @param {string} id\r\n * @param {string} tagName\r\n * @param {DomConfig} [config]\r\n * @returns {Element | null}\r\n */\r\ntag.optional = function tagOptional(id, tagName, config) {\r\n    return tag(id, tagName, { ...config, mode: 'null' })\r\n}\r\n\r\ntag.opt = tag.optional\r\n\r\n// -----------------------------------------------------------------------------\r\n// Helper registries\r\n// -----------------------------------------------------------------------------\r\n\r\nconst TYPE_HELPERS = /** @type {Record<string, any>} */ ({\r\n    el: typeof HTMLElement !== 'undefined' ? HTMLElement : null,\r\n    input: typeof HTMLInputElement !== 'undefined' ? HTMLInputElement : null,\r\n    button: typeof HTMLButtonElement !== 'undefined' ? HTMLButtonElement : null,\r\n    textarea: typeof HTMLTextAreaElement !== 'undefined' ? HTMLTextAreaElement : null,\r\n    select: typeof HTMLSelectElement !== 'undefined' ? HTMLSelectElement : null,\r\n    form: typeof HTMLFormElement !== 'undefined' ? HTMLFormElement : null,\r\n    div: typeof HTMLDivElement !== 'undefined' ? HTMLDivElement : null,\r\n    span: typeof HTMLSpanElement !== 'undefined' ? HTMLSpanElement : null,\r\n    label: typeof HTMLLabelElement !== 'undefined' ? HTMLLabelElement : null,\r\n    canvas: typeof HTMLCanvasElement !== 'undefined' ? HTMLCanvasElement : null,\r\n    template: typeof HTMLTemplateElement !== 'undefined' ? HTMLTemplateElement : null,\r\n    svg: typeof SVGSVGElement !== 'undefined' ? SVGSVGElement : null,\r\n    body: typeof HTMLBodyElement !== 'undefined' ? HTMLBodyElement : null,\r\n})\r\n\r\nconst TAG_HELPERS = /** @type {Record<string, string>} */ ({\r\n    main: 'main',\r\n    section: 'section',\r\n    small: 'small',\r\n})\r\n\r\n// -----------------------------------------------------------------------------\r\n// Helper builders\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @template {Function} T\r\n * @param {T} fn\r\n * @param {Function} optionalFn\r\n * @returns {T & { optional: Function, opt: Function }}\r\n */\r\nfunction attachOptional(fn, optionalFn) {\r\n    if (typeof fn !== 'function') {\r\n        throw new TypeError('id-dom: attachOptional expected fn to be a function')\r\n    }\r\n\r\n    if (typeof optionalFn !== 'function') {\r\n        throw new TypeError('id-dom: attachOptional expected optionalFn to be a function')\r\n    }\r\n\r\n    fn.optional = optionalFn\r\n    fn.opt = optionalFn\r\n    return fn\r\n}\r\n\r\n/**\r\n * @param {any} Type\r\n * @param {ReturnType<typeof normalizeConfig>} base\r\n * @param {ReturnType<typeof normalizeConfig>} baseNull\r\n */\r\nfunction makeTypedHelper(Type, base, baseNull) {\r\n    if (!Type) {\r\n        throw new TypeError('id-dom: makeTypedHelper received an invalid Type')\r\n    }\r\n\r\n    return attachOptional(\r\n        (id) => byId(id, Type, base),\r\n        (id) => byId(id, Type, baseNull)\r\n    )\r\n}\r\n\r\n/**\r\n * @param {string} tagName\r\n * @param {ReturnType<typeof normalizeConfig>} base\r\n * @param {ReturnType<typeof normalizeConfig>} baseNull\r\n */\r\nfunction makeTagHelper(tagName, base, baseNull) {\r\n    if (!tagName) {\r\n        throw new TypeError('id-dom: makeTagHelper received an invalid tagName')\r\n    }\r\n\r\n    return attachOptional(\r\n        (id) => tag(id, tagName, base),\r\n        (id) => tag(id, tagName, baseNull)\r\n    )\r\n}\r\n// -----------------------------------------------------------------------------\r\n// Factory\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * Factory: scope getters to a specific root + default policy.\r\n *\r\n * @param {any} root\r\n * @param {Omit<DomConfig, 'root'>} [config]\r\n */\r\nexport function createDom(root, config) {\r\n    const base = normalizeConfig({ ...config, root })\r\n    const baseNull = { ...base, mode: 'null' }\r\n\r\n    /** @type {any} */\r\n    const api = {}\r\n\r\n    api.byId = attachOptional(\r\n        (id, Type) => byId(id, Type, base),\r\n        (id, Type) => byId(id, Type, baseNull)\r\n    )\r\n\r\n    api.tag = attachOptional(\r\n        (id, name) => tag(id, name, base),\r\n        (id, name) => tag(id, name, baseNull)\r\n    )\r\n\r\n    for (const [name, Type] of Object.entries(TYPE_HELPERS)) {\r\n        if (!Type) continue\r\n        api[name] = makeTypedHelper(Type, base, baseNull)\r\n    }\r\n\r\n    for (const [name, tagName] of Object.entries(TAG_HELPERS)) {\r\n        api[name] = makeTagHelper(tagName, base, baseNull)\r\n    }\r\n\r\n    return api\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Default export\r\n// -----------------------------------------------------------------------------\r\n\r\nconst dom = createDom(DEFAULT_ROOT, { mode: 'throw' })\r\nexport default dom"],
+  "mappings": "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",
   "names": []
 }

package/dist/index.js

@@ -2,10 +2,22 @@ const DEFAULT_ROOT = typeof document !== "undefined" && document ? document : (
   /** @type {any} */
   null
 );
+const REASON = (
+  /** @type {const} */
+  {
+    INVALID_ID: "invalid-id",
+    INVALID_TYPE: "invalid-type",
+    INVALID_TAG: "invalid-tag",
+    MISSING: "missing",
+    WRONG_TYPE: "wrong-type",
+    WRONG_TAG: "wrong-tag"
+  }
+);
+const SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/;
+const NEEDS_START_ESCAPE_RE = /^(?:\d|-\d)/;
 function normalizeConfig(cfg) {
   return {
     mode: cfg?.mode ?? "throw",
-    // default strict
     warn: cfg?.warn ?? false,
     onError: typeof cfg?.onError === "function" ? cfg.onError : null,
     root: cfg?.root ?? DEFAULT_ROOT
@@ -17,8 +29,6 @@ function hasGetElementById(v) {
 function hasQuerySelector(v) {
   return !!v && typeof v === "object" && typeof v.querySelector === "function";
 }
-const SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/;
-const NEEDS_START_ESCAPE_RE = /^(?:\d|-\d)/;
 function cssEscape(id) {
   const s = String(id);
   if (typeof CSS !== "undefined" && typeof CSS.escape === "function") {
@@ -34,10 +44,13 @@ function cssEscape(id) {
     cp >= 97 && cp <= 122 || // a-z
     cp === 95 || // _
     cp === 45;
-    const needsStartEscape = i === 0 && (cp >= 48 && cp <= 57 || cp === 45 && s.length > 1 && s.codePointAt(1) >= 48 && s.codePointAt(1) <= 57);
+    const next = s.codePointAt(i + 1);
+    const startsWithDigit = cp >= 48 && cp <= 57;
+    const startsWithDashDigit = cp === 45 && s.length > 1 && next >= 48 && next <= 57;
+    const needsStartEscape = i === 0 && (startsWithDigit || startsWithDashDigit);
     if (!needsStartEscape && (isAsciiSafe || cp >= 160)) {
       out += ch;
-    } else if (cp === 45 && i === 0 && s.length > 1 && s.codePointAt(1) >= 48 && s.codePointAt(1) <= 57) {
+    } else if (i === 0 && startsWithDashDigit) {
       out += "\\-";
     } else {
       out += `\\${cp.toString(16).toUpperCase()} `;
@@ -46,16 +59,32 @@ function cssEscape(id) {
   }
   return out;
 }
+function isElementNode(v) {
+  if (!v || typeof v !== "object") return false;
+  if (typeof Element !== "undefined") return v instanceof Element;
+  return (
+    /** @type {any} */
+    v.nodeType === 1
+  );
+}
 function getById(root, id) {
   if (!root) return null;
   if (hasGetElementById(root)) return root.getElementById(id);
   if (hasQuerySelector(root)) {
-    const sel = `#${cssEscape(id)}`;
-    const el = root.querySelector(sel);
-    return el instanceof HTMLElement ? el : null;
+    const el = root.querySelector(`#${cssEscape(id)}`);
+    return isElementNode(el) ? el : null;
   }
   return null;
 }
+function isValidId(v) {
+  return typeof v === "string" && v.length > 0;
+}
+function isValidTagName(v) {
+  return typeof v === "string" && v.trim().length > 0;
+}
+function isConstructor(v) {
+  return typeof v === "function";
+}
 function fmtId(id) {
   return id.startsWith("#") ? id : `#${id}`;
 }
@@ -70,54 +99,114 @@ function handleLookupError(err, ctx, cfg) {
     cfg.onError?.(err, ctx);
   } catch {
   }
-  if (cfg.warn) console.warn(err);
+  if (cfg.warn) console.warn(err, ctx);
   if (cfg.mode === "throw") throw err;
   return null;
 }
-function byId(id, Type, config) {
+function createCtx(id, root, reason, extra) {
+  return {
+    id,
+    root,
+    reason,
+    ...extra || {}
+  };
+}
+function resolveLookup(config, spec) {
   const cfg = normalizeConfig(config);
-  const el = getById(cfg.root, id);
+  const inputFailure = spec.validateInput(cfg);
+  if (inputFailure) {
+    return handleLookupError(inputFailure.err, inputFailure.ctx, cfg);
+  }
+  const el = getById(cfg.root, spec.id);
   if (!el) {
-    return handleLookupError(
-      missingElError(id, Type.name),
-      { id, Type, root: cfg.root, reason: "missing" },
-      cfg
-    );
-  }
-  if (!(el instanceof Type)) {
-    const got = el?.constructor?.name || typeof el;
-    return handleLookupError(
-      wrongTypeError(id, Type.name, got),
-      { id, Type, root: cfg.root, reason: "wrong-type", got },
-      cfg
-    );
-  }
-  return el;
+    const failure = spec.onMissing(cfg);
+    return handleLookupError(failure.err, failure.ctx, cfg);
+  }
+  if (!spec.matches(el, cfg)) {
+    const failure = spec.onMismatch(el, cfg);
+    return handleLookupError(failure.err, failure.ctx, cfg);
+  }
+  return (
+    /** @type {T} */
+    el
+  );
+}
+function byId(id, Type, config) {
+  return resolveLookup(config, {
+    id,
+    validateInput(cfg) {
+      if (!isValidId(id)) {
+        return {
+          err: new Error("id-dom: invalid id (expected non-empty string)"),
+          ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { Type })
+        };
+      }
+      if (!isConstructor(Type)) {
+        return {
+          err: new Error(`id-dom: invalid Type for ${fmtId(id)}`),
+          ctx: createCtx(id, cfg.root, REASON.INVALID_TYPE, { Type })
+        };
+      }
+      return null;
+    },
+    onMissing(cfg) {
+      return {
+        err: missingElError(id, Type.name),
+        ctx: createCtx(id, cfg.root, REASON.MISSING, { Type })
+      };
+    },
+    matches(el) {
+      return el instanceof Type;
+    },
+    onMismatch(el, cfg) {
+      const got = el?.constructor?.name || typeof el;
+      return {
+        err: wrongTypeError(id, Type.name, got),
+        ctx: createCtx(id, cfg.root, REASON.WRONG_TYPE, { Type, got })
+      };
+    }
+  });
 }
 byId.optional = function byIdOptional(id, Type, config) {
   return byId(id, Type, { ...config, mode: "null" });
 };
 byId.opt = byId.optional;
 function tag(id, tagName, config) {
-  const cfg = normalizeConfig(config);
-  const el = getById(cfg.root, id);
-  if (!el) {
-    return handleLookupError(
-      missingElError(id, `<${tagName}>`),
-      { id, tagName, root: cfg.root, reason: "missing" },
-      cfg
-    );
-  }
-  const expected = String(tagName).toUpperCase();
-  const got = String(el.tagName || "").toUpperCase();
-  if (got !== expected) {
-    return handleLookupError(
-      wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),
-      { id, tagName, root: cfg.root, reason: "wrong-tag", got },
-      cfg
-    );
-  }
-  return el;
+  return resolveLookup(config, {
+    id,
+    validateInput(cfg) {
+      if (!isValidId(id)) {
+        return {
+          err: new Error("id-dom: invalid id (expected non-empty string)"),
+          ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { tagName })
+        };
+      }
+      if (!isValidTagName(tagName)) {
+        return {
+          err: new Error(`id-dom: invalid tagName for ${fmtId(id)}`),
+          ctx: createCtx(id, cfg.root, REASON.INVALID_TAG, { tagName })
+        };
+      }
+      return null;
+    },
+    onMissing(cfg) {
+      return {
+        err: missingElError(id, `<${tagName}>`),
+        ctx: createCtx(id, cfg.root, REASON.MISSING, { tagName })
+      };
+    },
+    matches(el) {
+      return String(el.tagName || "").toUpperCase() === String(tagName).toUpperCase();
+    },
+    onMismatch(el, cfg) {
+      const expected = String(tagName).toUpperCase();
+      const got = String(el.tagName || "").toUpperCase();
+      return {
+        err: wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),
+        ctx: createCtx(id, cfg.root, REASON.WRONG_TAG, { tagName, got })
+      };
+    }
+  });
 }
 tag.optional = function tagOptional(id, tagName, config) {
   return tag(id, tagName, { ...config, mode: "null" });
@@ -137,7 +226,8 @@ const TYPE_HELPERS = (
     label: typeof HTMLLabelElement !== "undefined" ? HTMLLabelElement : null,
     canvas: typeof HTMLCanvasElement !== "undefined" ? HTMLCanvasElement : null,
     template: typeof HTMLTemplateElement !== "undefined" ? HTMLTemplateElement : null,
-    svg: typeof SVGSVGElement !== "undefined" ? SVGSVGElement : null
+    svg: typeof SVGSVGElement !== "undefined" ? SVGSVGElement : null,
+    body: typeof HTMLBodyElement !== "undefined" ? HTMLBodyElement : null
   }
 );
 const TAG_HELPERS = (
@@ -148,42 +238,53 @@ const TAG_HELPERS = (
     small: "small"
   }
 );
+function attachOptional(fn, optionalFn) {
+  if (typeof fn !== "function") {
+    throw new TypeError("id-dom: attachOptional expected fn to be a function");
+  }
+  if (typeof optionalFn !== "function") {
+    throw new TypeError("id-dom: attachOptional expected optionalFn to be a function");
+  }
+  fn.optional = optionalFn;
+  fn.opt = optionalFn;
+  return fn;
+}
+function makeTypedHelper(Type, base, baseNull) {
+  if (!Type) {
+    throw new TypeError("id-dom: makeTypedHelper received an invalid Type");
+  }
+  return attachOptional(
+    (id) => byId(id, Type, base),
+    (id) => byId(id, Type, baseNull)
+  );
+}
+function makeTagHelper(tagName, base, baseNull) {
+  if (!tagName) {
+    throw new TypeError("id-dom: makeTagHelper received an invalid tagName");
+  }
+  return attachOptional(
+    (id) => tag(id, tagName, base),
+    (id) => tag(id, tagName, baseNull)
+  );
+}
 function createDom(root, config) {
   const base = normalizeConfig({ ...config, root });
   const baseNull = { ...base, mode: "null" };
-  const api = {
-    // generic
-    byId: (id, Type) => byId(id, Type, base),
-    tag: (id, name) => tag(id, name, base)
-  };
+  const api = {};
+  api.byId = attachOptional(
+    (id, Type) => byId(id, Type, base),
+    (id, Type) => byId(id, Type, baseNull)
+  );
+  api.tag = attachOptional(
+    (id, name) => tag(id, name, base),
+    (id, name) => tag(id, name, baseNull)
+  );
   for (const [name, Type] of Object.entries(TYPE_HELPERS)) {
     if (!Type) continue;
-    api[name] = (id) => byId(id, Type, base);
+    api[name] = makeTypedHelper(Type, base, baseNull);
   }
   for (const [name, tagName] of Object.entries(TAG_HELPERS)) {
-    api[name] = (id) => tag(id, tagName, base);
-  }
-  api.byId.optional = (id, Type) => byId(id, Type, baseNull);
-  api.byId.opt = api.byId.optional;
-  api.tag.optional = (id, name) => tag(id, name, baseNull);
-  api.tag.opt = api.tag.optional;
-  for (const k of Object.keys(api)) {
-    const fn = api[k];
-    if (typeof fn !== "function") continue;
-    if (fn.optional) continue;
-    if (k in TAG_HELPERS) {
-      const tagName = TAG_HELPERS[k];
-      fn.optional = (id) => tag(id, tagName, baseNull);
-      fn.opt = fn.optional;
-      continue;
-    }
-    if (k in TYPE_HELPERS) {
-      const Type = TYPE_HELPERS[k];
-      if (Type) {
-        fn.optional = (id) => byId(id, Type, baseNull);
-        fn.opt = fn.optional;
-      }
-    }
+    api[name] = makeTagHelper(tagName, base, baseNull);
   }
   return api;
 }

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/id-dom.js"],
-  "sourcesContent": ["// id-dom.js\r\n// id-dom \u2014 deterministic DOM element getters by ID (typed, tiny, modern)\r\n//\r\n// Goals:\r\n// - Prefer getElementById (fast, unambiguous)\r\n// - Return the correct type or fail predictably\r\n// - Provide strict + optional variants\r\n// - Allow app/module-level defaults (throw vs null) without bundler magic\r\n// - Zero deps, framework-agnostic\r\n\r\nconst DEFAULT_ROOT =\r\n    typeof document !== 'undefined' && document ? document : /** @type {any} */ (null)\r\n\r\n/**\r\n * @typedef {'throw' | 'null'} DomMode\r\n */\r\n\r\n/**\r\n * @typedef {{\r\n *   mode?: DomMode\r\n *   warn?: boolean\r\n *   onError?: (error: Error, ctx: any) => void\r\n *   root?: any\r\n * }} DomConfig\r\n */\r\n\r\n/**\r\n * @param {DomConfig | undefined} cfg\r\n */\r\nfunction normalizeConfig(cfg) {\r\n    return {\r\n        mode: cfg?.mode ?? 'throw', // default strict\r\n        warn: cfg?.warn ?? false,\r\n        onError: typeof cfg?.onError === 'function' ? cfg.onError : null,\r\n        root: cfg?.root ?? DEFAULT_ROOT,\r\n    }\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is { getElementById(id: string): HTMLElement | null }}\r\n */\r\nfunction hasGetElementById(v) {\r\n    return !!v && typeof v === 'object' && typeof v.getElementById === 'function'\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is { querySelector(sel: string): Element | null }}\r\n */\r\nfunction hasQuerySelector(v) {\r\n    return !!v && typeof v === 'object' && typeof v.querySelector === 'function'\r\n}\r\n\r\n\r\nconst SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/\r\nconst NEEDS_START_ESCAPE_RE = /^(?:\\d|-\\d)/\r\n\r\n/**\r\n * Minimal CSS.escape fallback for environments where CSS.escape is missing (e.g. some jsdom builds).\r\n * We only need to safely build `#${id}` selectors.\r\n *\r\n * @param {string} id\r\n */\r\nfunction cssEscape(id) {\r\n  const s = String(id)\r\n\r\n  // Prefer native when available\r\n  if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\r\n    return CSS.escape(s)\r\n  }\r\n\r\n  // Fast path: most app IDs are already safe\r\n  if (!NEEDS_START_ESCAPE_RE.test(s) && SAFE_ID_RE.test(s)) return s\r\n\r\n  // One-pass escape:\r\n  // - Escape any char outside a conservative \"safe\" set\r\n  // - Also escape the start if it begins with a digit OR \"-<digit>\"\r\n  let out = ''\r\n  for (let i = 0; i < s.length; ) {\r\n    const cp = s.codePointAt(i)\r\n    const ch = String.fromCodePoint(cp)\r\n\r\n    const isAsciiSafe =\r\n      (cp >= 48 && cp <= 57) || // 0-9\r\n      (cp >= 65 && cp <= 90) || // A-Z\r\n      (cp >= 97 && cp <= 122) || // a-z\r\n      cp === 95 || // _\r\n      cp === 45 // -\r\n\r\n    const needsStartEscape =\r\n      i === 0 && ((cp >= 48 && cp <= 57) || (cp === 45 && s.length > 1 && s.codePointAt(1) >= 48 && s.codePointAt(1) <= 57))\r\n\r\n    if (!needsStartEscape && (isAsciiSafe || cp >= 0x00A0)) {\r\n      // allow non-ascii chars directly (common CSS ident behavior)\r\n      out += ch\r\n    } else if (cp === 45 && i === 0 && s.length > 1 && s.codePointAt(1) >= 48 && s.codePointAt(1) <= 57) {\r\n      // \"-<digit>\" start: escaping just the leading hyphen is a simple fix\r\n      out += '\\\\-'\r\n    } else {\r\n      // hex escape + trailing space is safest\r\n      out += `\\\\${cp.toString(16).toUpperCase()} `\r\n    }\r\n\r\n    i += ch.length\r\n  }\r\n\r\n  return out\r\n}\r\n\r\n\r\n/**\r\n * Resolve an element by id from a \"root\".\r\n * Supports:\r\n *  - Document (getElementById)\r\n *  - ShadowRoot / DocumentFragment / Element (querySelector fallback)\r\n *\r\n * @param {any} root\r\n * @param {string} id\r\n * @returns {HTMLElement | null}\r\n */\r\nfunction getById(root, id) {\r\n    if (!root) return null\r\n\r\n    if (hasGetElementById(root)) return root.getElementById(id)\r\n\r\n    // ShadowRoot/DocumentFragment/Element don\u2019t have getElementById\r\n    if (hasQuerySelector(root)) {\r\n        const sel = `#${cssEscape(id)}`\r\n        const el = root.querySelector(sel)\r\n        return el instanceof HTMLElement ? el : null\r\n    }\r\n\r\n    return null\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @returns {string}\r\n */\r\nfunction fmtId(id) {\r\n    return id.startsWith('#') ? id : `#${id}`\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {string} expected\r\n */\r\nfunction missingElError(id, expected) {\r\n    return new Error(`id-dom: missing ${expected} element ${fmtId(id)}`)\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {string} expected\r\n * @param {string} got\r\n */\r\nfunction wrongTypeError(id, expected, got) {\r\n    return new Error(`id-dom: expected ${expected} for ${fmtId(id)}, got ${got}`)\r\n}\r\n\r\n/**\r\n * Centralized error policy:\r\n * - always call onError if present\r\n * - optionally warn\r\n * - throw or return null depending on mode\r\n *\r\n * @template T\r\n * @param {Error} err\r\n * @param {any} ctx\r\n * @param {ReturnType<typeof normalizeConfig>} cfg\r\n * @returns {T | null}\r\n */\r\nfunction handleLookupError(err, ctx, cfg) {\r\n    try {\r\n        cfg.onError?.(err, ctx)\r\n    } catch {\r\n        // do not let reporting break app logic\r\n    }\r\n\r\n    if (cfg.warn) console.warn(err)\r\n\r\n    if (cfg.mode === 'throw') throw err\r\n    return null\r\n}\r\n\r\n/**\r\n * Typed lookup by ID.\r\n * Behavior is controlled by config:\r\n *  - mode: 'throw' (default) or 'null'\r\n *  - warn: boolean\r\n *  - onError(err, ctx)\r\n *\r\n * @template {Element} T\r\n * @param {string} id\r\n * @param {{ new (...args: any[]): T }} Type\r\n * @param {DomConfig} [config]\r\n * @returns {T | null}\r\n */\r\nexport function byId(id, Type, config) {\r\n    const cfg = normalizeConfig(config)\r\n    const el = getById(cfg.root, id)\r\n\r\n    if (!el) {\r\n        return handleLookupError(\r\n            missingElError(id, Type.name),\r\n            { id, Type, root: cfg.root, reason: 'missing' },\r\n            cfg\r\n        )\r\n    }\r\n\r\n    if (!(el instanceof Type)) {\r\n        const got = el?.constructor?.name || typeof el\r\n        return handleLookupError(\r\n            wrongTypeError(id, Type.name, got),\r\n            { id, Type, root: cfg.root, reason: 'wrong-type', got },\r\n            cfg\r\n        )\r\n    }\r\n\r\n    return el\r\n}\r\n\r\n/**\r\n * Optional typed lookup: ALWAYS returns T | null (never throws for missing/wrong-type).\r\n *\r\n * @template {Element} T\r\n * @param {string} id\r\n * @param {{ new (...args: any[]): T }} Type\r\n * @param {DomConfig} [config]\r\n * @returns {T | null}\r\n */\r\nbyId.optional = function byIdOptional(id, Type, config) {\r\n    return byId(id, Type, { ...config, mode: 'null' })\r\n}\r\n\r\n// Short alias (module-level; do not reassign inside factories)\r\nbyId.opt = byId.optional\r\n\r\n/**\r\n * Tag-name lookup (HTMLElement only).\r\n * Useful for semantic elements that don\u2019t have unique constructors.\r\n *\r\n * @param {string} id\r\n * @param {string} tagName\r\n * @param {DomConfig} [config]\r\n * @returns {HTMLElement | null}\r\n */\r\nexport function tag(id, tagName, config) {\r\n    const cfg = normalizeConfig(config)\r\n    const el = getById(cfg.root, id)\r\n\r\n    if (!el) {\r\n        return handleLookupError(\r\n            missingElError(id, `<${tagName}>`),\r\n            { id, tagName, root: cfg.root, reason: 'missing' },\r\n            cfg\r\n        )\r\n    }\r\n\r\n    const expected = String(tagName).toUpperCase()\r\n    const got = String(el.tagName || '').toUpperCase()\r\n\r\n    if (got !== expected) {\r\n        return handleLookupError(\r\n            wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),\r\n            { id, tagName, root: cfg.root, reason: 'wrong-tag', got },\r\n            cfg\r\n        )\r\n    }\r\n\r\n    return el\r\n}\r\n\r\n/**\r\n * Optional tag lookup: ALWAYS returns HTMLElement | null (never throws for missing/wrong-tag).\r\n *\r\n * @param {string} id\r\n * @param {string} tagName\r\n * @param {DomConfig} [config]\r\n * @returns {HTMLElement | null}\r\n */\r\ntag.optional = function tagOptional(id, tagName, config) {\r\n    return tag(id, tagName, { ...config, mode: 'null' })\r\n}\r\n\r\n// Short alias (module-level; do not reassign inside factories)\r\ntag.opt = tag.optional\r\n\r\n// --- internal maps for factory helpers ---\r\nconst TYPE_HELPERS = /** @type {Record<string, any>} */ ({\r\n    el: typeof HTMLElement !== 'undefined' ? HTMLElement : null,\r\n    input: typeof HTMLInputElement !== 'undefined' ? HTMLInputElement : null,\r\n    button: typeof HTMLButtonElement !== 'undefined' ? HTMLButtonElement : null,\r\n    textarea: typeof HTMLTextAreaElement !== 'undefined' ? HTMLTextAreaElement : null,\r\n    select: typeof HTMLSelectElement !== 'undefined' ? HTMLSelectElement : null,\r\n    form: typeof HTMLFormElement !== 'undefined' ? HTMLFormElement : null,\r\n    div: typeof HTMLDivElement !== 'undefined' ? HTMLDivElement : null,\r\n    span: typeof HTMLSpanElement !== 'undefined' ? HTMLSpanElement : null,\r\n    label: typeof HTMLLabelElement !== 'undefined' ? HTMLLabelElement : null,\r\n    canvas: typeof HTMLCanvasElement !== 'undefined' ? HTMLCanvasElement : null,\r\n    template: typeof HTMLTemplateElement !== 'undefined' ? HTMLTemplateElement : null,\r\n    svg: typeof SVGSVGElement !== 'undefined' ? SVGSVGElement : null,\r\n})\r\n\r\nconst TAG_HELPERS = /** @type {Record<string, string>} */ ({\r\n    main: 'main',\r\n    section: 'section',\r\n    small: 'small',\r\n})\r\n\r\n/**\r\n * Factory: scope getters to a specific root + default policy.\r\n *\r\n * @param {any} root\r\n * @param {Omit<DomConfig, 'root'>} [config]\r\n */\r\nexport function createDom(root, config) {\r\n    const base = normalizeConfig({ ...config, root })\r\n    const baseNull = { ...base, mode: 'null' }\r\n\r\n    /** @type {any} */\r\n    const api = {\r\n        // generic\r\n        byId: (id, Type) => byId(id, Type, base),\r\n        tag: (id, name) => tag(id, name, base),\r\n    }\r\n\r\n    // typed helpers\r\n    for (const [name, Type] of Object.entries(TYPE_HELPERS)) {\r\n        if (!Type) continue\r\n        api[name] = (id) => byId(id, Type, base)\r\n    }\r\n\r\n    // semantic tag helpers\r\n    for (const [name, tagName] of Object.entries(TAG_HELPERS)) {\r\n        api[name] = (id) => tag(id, tagName, base)\r\n    }\r\n\r\n    // --- Optional variants (policy-based; never swallow unrelated exceptions) ---\r\n    api.byId.optional = (id, Type) => byId(id, Type, baseNull)\r\n    api.byId.opt = api.byId.optional\r\n\r\n    api.tag.optional = (id, name) => tag(id, name, baseNull)\r\n    api.tag.opt = api.tag.optional\r\n\r\n    // Add `.optional` + `.opt` to every helper using the same \"null\" policy\r\n    for (const k of Object.keys(api)) {\r\n        const fn = api[k]\r\n        if (typeof fn !== 'function') continue\r\n        if (fn.optional) continue\r\n\r\n        if (k in TAG_HELPERS) {\r\n            const tagName = TAG_HELPERS[k]\r\n            fn.optional = (id) => tag(id, tagName, baseNull)\r\n            fn.opt = fn.optional\r\n            continue\r\n        }\r\n\r\n        if (k in TYPE_HELPERS) {\r\n            const Type = TYPE_HELPERS[k]\r\n            if (Type) {\r\n                fn.optional = (id) => byId(id, Type, baseNull)\r\n                fn.opt = fn.optional\r\n            }\r\n        }\r\n    }\r\n\r\n    return api\r\n}\r\n\r\n// Default export: root = document (if available), strict by default\r\nconst dom = createDom(DEFAULT_ROOT, { mode: 'throw' })\r\nexport default dom\r\n"],
-  "mappings": "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",
+  "sourcesContent": ["// id-dom.js\r\n// id-dom \u2014 deterministic DOM element getters by ID (typed, tiny, modern)\r\n//\r\n// Goals:\r\n// - Prefer getElementById (fast, unambiguous)\r\n// - Return the correct type or fail predictably\r\n// - Provide strict + optional variants\r\n// - Allow app/module-level defaults (throw vs null) without bundler magic\r\n// - Zero deps, framework-agnostic\r\n\r\nconst DEFAULT_ROOT =\r\n    typeof document !== 'undefined' && document ? document : /** @type {any} */ (null)\r\n\r\nconst REASON = /** @type {const} */ ({\r\n    INVALID_ID: 'invalid-id',\r\n    INVALID_TYPE: 'invalid-type',\r\n    INVALID_TAG: 'invalid-tag',\r\n    MISSING: 'missing',\r\n    WRONG_TYPE: 'wrong-type',\r\n    WRONG_TAG: 'wrong-tag',\r\n})\r\n\r\nconst SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/\r\nconst NEEDS_START_ESCAPE_RE = /^(?:\\d|-\\d)/\r\n\r\n/**\r\n * @typedef {'throw' | 'null'} DomMode\r\n */\r\n\r\n/**\r\n * @typedef {{\r\n *   mode?: DomMode\r\n *   warn?: boolean\r\n *   onError?: (error: Error, ctx: any) => void\r\n *   root?: any\r\n * }} DomConfig\r\n */\r\n\r\n// -----------------------------------------------------------------------------\r\n// Config\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @param {DomConfig | undefined} cfg\r\n */\r\nfunction normalizeConfig(cfg) {\r\n    return {\r\n        mode: cfg?.mode ?? 'throw',\r\n        warn: cfg?.warn ?? false,\r\n        onError: typeof cfg?.onError === 'function' ? cfg.onError : null,\r\n        root: cfg?.root ?? DEFAULT_ROOT,\r\n    }\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Root / DOM helpers\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is { getElementById(id: string): Element | null }}\r\n */\r\nfunction hasGetElementById(v) {\r\n    return !!v && typeof v === 'object' && typeof v.getElementById === 'function'\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is { querySelector(sel: string): Element | null }}\r\n */\r\nfunction hasQuerySelector(v) {\r\n    return !!v && typeof v === 'object' && typeof v.querySelector === 'function'\r\n}\r\n\r\n/**\r\n * Minimal CSS.escape fallback for environments where CSS.escape is missing.\r\n * We only need to safely build `#${id}` selectors.\r\n *\r\n * @param {string} id\r\n * @returns {string}\r\n */\r\nfunction cssEscape(id) {\r\n    const s = String(id)\r\n\r\n    if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\r\n        return CSS.escape(s)\r\n    }\r\n\r\n    if (!NEEDS_START_ESCAPE_RE.test(s) && SAFE_ID_RE.test(s)) return s\r\n\r\n    let out = ''\r\n    for (let i = 0; i < s.length;) {\r\n        const cp = s.codePointAt(i)\r\n        const ch = String.fromCodePoint(cp)\r\n\r\n        const isAsciiSafe =\r\n            (cp >= 48 && cp <= 57) || // 0-9\r\n            (cp >= 65 && cp <= 90) || // A-Z\r\n            (cp >= 97 && cp <= 122) || // a-z\r\n            cp === 95 || // _\r\n            cp === 45 // -\r\n\r\n        const next = s.codePointAt(i + 1)\r\n        const startsWithDigit = cp >= 48 && cp <= 57\r\n        const startsWithDashDigit = cp === 45 && s.length > 1 && next >= 48 && next <= 57\r\n        const needsStartEscape = i === 0 && (startsWithDigit || startsWithDashDigit)\r\n\r\n        if (!needsStartEscape && (isAsciiSafe || cp >= 0x00a0)) {\r\n            out += ch\r\n        } else if (i === 0 && startsWithDashDigit) {\r\n            out += '\\\\-'\r\n        } else {\r\n            out += `\\\\${cp.toString(16).toUpperCase()} `\r\n        }\r\n\r\n        i += ch.length\r\n    }\r\n\r\n    return out\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is Element}\r\n */\r\nfunction isElementNode(v) {\r\n    if (!v || typeof v !== 'object') return false\r\n    if (typeof Element !== 'undefined') return v instanceof Element\r\n    return /** @type {any} */ (v).nodeType === 1\r\n}\r\n\r\n/**\r\n * Resolve an element by id from a root.\r\n * Supports:\r\n *  - Document (getElementById)\r\n *  - ShadowRoot / DocumentFragment / Element (querySelector fallback)\r\n *\r\n * @param {any} root\r\n * @param {string} id\r\n * @returns {Element | null}\r\n */\r\nfunction getById(root, id) {\r\n    if (!root) return null\r\n\r\n    if (hasGetElementById(root)) return root.getElementById(id)\r\n\r\n    if (hasQuerySelector(root)) {\r\n        const el = root.querySelector(`#${cssEscape(id)}`)\r\n        return isElementNode(el) ? el : null\r\n    }\r\n\r\n    return null\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Validation helpers\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is string}\r\n */\r\nfunction isValidId(v) {\r\n    return typeof v === 'string' && v.length > 0\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is string}\r\n */\r\nfunction isValidTagName(v) {\r\n    return typeof v === 'string' && v.trim().length > 0\r\n}\r\n\r\n/**\r\n * @param {unknown} v\r\n * @returns {v is Function}\r\n */\r\nfunction isConstructor(v) {\r\n    return typeof v === 'function'\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Error / policy helpers\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @param {string} id\r\n * @returns {string}\r\n */\r\nfunction fmtId(id) {\r\n    return id.startsWith('#') ? id : `#${id}`\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {string} expected\r\n * @returns {Error}\r\n */\r\nfunction missingElError(id, expected) {\r\n    return new Error(`id-dom: missing ${expected} element ${fmtId(id)}`)\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {string} expected\r\n * @param {string} got\r\n * @returns {Error}\r\n */\r\nfunction wrongTypeError(id, expected, got) {\r\n    return new Error(`id-dom: expected ${expected} for ${fmtId(id)}, got ${got}`)\r\n}\r\n\r\n/**\r\n * @template T\r\n * @param {Error} err\r\n * @param {any} ctx\r\n * @param {ReturnType<typeof normalizeConfig>} cfg\r\n * @returns {T | null}\r\n */\r\nfunction handleLookupError(err, ctx, cfg) {\r\n    try {\r\n        cfg.onError?.(err, ctx)\r\n    } catch {\r\n        // reporting must never break app logic\r\n    }\r\n\r\n    if (cfg.warn) console.warn(err, ctx)\r\n\r\n    if (cfg.mode === 'throw') throw err\r\n    return null\r\n}\r\n\r\n/**\r\n * @param {string} id\r\n * @param {any} root\r\n * @param {string} reason\r\n * @param {object} [extra]\r\n * @returns {any}\r\n */\r\nfunction createCtx(id, root, reason, extra) {\r\n    return {\r\n        id,\r\n        root,\r\n        reason,\r\n        ...(extra || {}),\r\n    }\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Internal generic resolver\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @template T\r\n * @param {DomConfig | undefined} config\r\n * @param {{\r\n *   id: string,\r\n *   validateInput: (cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any } | null,\r\n *   onMissing: (cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any },\r\n *   matches: (el: Element, cfg: ReturnType<typeof normalizeConfig>) => boolean,\r\n *   onMismatch: (el: Element, cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any },\r\n * }} spec\r\n * @returns {T | null}\r\n */\r\nfunction resolveLookup(config, spec) {\r\n    const cfg = normalizeConfig(config)\r\n\r\n    const inputFailure = spec.validateInput(cfg)\r\n    if (inputFailure) {\r\n        return handleLookupError(inputFailure.err, inputFailure.ctx, cfg)\r\n    }\r\n\r\n    const el = getById(cfg.root, spec.id)\r\n    if (!el) {\r\n        const failure = spec.onMissing(cfg)\r\n        return handleLookupError(failure.err, failure.ctx, cfg)\r\n    }\r\n\r\n    if (!spec.matches(el, cfg)) {\r\n        const failure = spec.onMismatch(el, cfg)\r\n        return handleLookupError(failure.err, failure.ctx, cfg)\r\n    }\r\n\r\n    return /** @type {T} */ (el)\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Public APIs\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * Typed lookup by ID.\r\n *\r\n * @template {Element} T\r\n * @param {string} id\r\n * @param {{ new (...args: any[]): T }} Type\r\n * @param {DomConfig} [config]\r\n * @returns {T | null}\r\n */\r\nexport function byId(id, Type, config) {\r\n    return resolveLookup(config, {\r\n        id,\r\n\r\n        validateInput(cfg) {\r\n            if (!isValidId(id)) {\r\n                return {\r\n                    err: new Error('id-dom: invalid id (expected non-empty string)'),\r\n                    ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { Type }),\r\n                }\r\n            }\r\n\r\n            if (!isConstructor(Type)) {\r\n                return {\r\n                    err: new Error(`id-dom: invalid Type for ${fmtId(id)}`),\r\n                    ctx: createCtx(id, cfg.root, REASON.INVALID_TYPE, { Type }),\r\n                }\r\n            }\r\n\r\n            return null\r\n        },\r\n\r\n        onMissing(cfg) {\r\n            return {\r\n                err: missingElError(id, Type.name),\r\n                ctx: createCtx(id, cfg.root, REASON.MISSING, { Type }),\r\n            }\r\n        },\r\n\r\n        matches(el) {\r\n            return el instanceof Type\r\n        },\r\n\r\n        onMismatch(el, cfg) {\r\n            const got = el?.constructor?.name || typeof el\r\n            return {\r\n                err: wrongTypeError(id, Type.name, got),\r\n                ctx: createCtx(id, cfg.root, REASON.WRONG_TYPE, { Type, got }),\r\n            }\r\n        },\r\n    })\r\n}\r\n\r\n/**\r\n * Optional typed lookup: always returns T | null.\r\n *\r\n * @template {Element} T\r\n * @param {string} id\r\n * @param {{ new (...args: any[]): T }} Type\r\n * @param {DomConfig} [config]\r\n * @returns {T | null}\r\n */\r\nbyId.optional = function byIdOptional(id, Type, config) {\r\n    return byId(id, Type, { ...config, mode: 'null' })\r\n}\r\n\r\nbyId.opt = byId.optional\r\n\r\n/**\r\n * Tag-name lookup by element tag.\r\n * Useful when constructor checks are not the right fit.\r\n *\r\n * @param {string} id\r\n * @param {string} tagName\r\n * @param {DomConfig} [config]\r\n * @returns {Element | null}\r\n */\r\nexport function tag(id, tagName, config) {\r\n    return resolveLookup(config, {\r\n        id,\r\n\r\n        validateInput(cfg) {\r\n            if (!isValidId(id)) {\r\n                return {\r\n                    err: new Error('id-dom: invalid id (expected non-empty string)'),\r\n                    ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { tagName }),\r\n                }\r\n            }\r\n\r\n            if (!isValidTagName(tagName)) {\r\n                return {\r\n                    err: new Error(`id-dom: invalid tagName for ${fmtId(id)}`),\r\n                    ctx: createCtx(id, cfg.root, REASON.INVALID_TAG, { tagName }),\r\n                }\r\n            }\r\n\r\n            return null\r\n        },\r\n\r\n        onMissing(cfg) {\r\n            return {\r\n                err: missingElError(id, `<${tagName}>`),\r\n                ctx: createCtx(id, cfg.root, REASON.MISSING, { tagName }),\r\n            }\r\n        },\r\n\r\n        matches(el) {\r\n            return String(el.tagName || '').toUpperCase() === String(tagName).toUpperCase()\r\n        },\r\n\r\n        onMismatch(el, cfg) {\r\n            const expected = String(tagName).toUpperCase()\r\n            const got = String(el.tagName || '').toUpperCase()\r\n\r\n            return {\r\n                err: wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),\r\n                ctx: createCtx(id, cfg.root, REASON.WRONG_TAG, { tagName, got }),\r\n            }\r\n        },\r\n    })\r\n}\r\n\r\n/**\r\n * Optional tag lookup: always returns Element | null.\r\n *\r\n * @param {string} id\r\n * @param {string} tagName\r\n * @param {DomConfig} [config]\r\n * @returns {Element | null}\r\n */\r\ntag.optional = function tagOptional(id, tagName, config) {\r\n    return tag(id, tagName, { ...config, mode: 'null' })\r\n}\r\n\r\ntag.opt = tag.optional\r\n\r\n// -----------------------------------------------------------------------------\r\n// Helper registries\r\n// -----------------------------------------------------------------------------\r\n\r\nconst TYPE_HELPERS = /** @type {Record<string, any>} */ ({\r\n    el: typeof HTMLElement !== 'undefined' ? HTMLElement : null,\r\n    input: typeof HTMLInputElement !== 'undefined' ? HTMLInputElement : null,\r\n    button: typeof HTMLButtonElement !== 'undefined' ? HTMLButtonElement : null,\r\n    textarea: typeof HTMLTextAreaElement !== 'undefined' ? HTMLTextAreaElement : null,\r\n    select: typeof HTMLSelectElement !== 'undefined' ? HTMLSelectElement : null,\r\n    form: typeof HTMLFormElement !== 'undefined' ? HTMLFormElement : null,\r\n    div: typeof HTMLDivElement !== 'undefined' ? HTMLDivElement : null,\r\n    span: typeof HTMLSpanElement !== 'undefined' ? HTMLSpanElement : null,\r\n    label: typeof HTMLLabelElement !== 'undefined' ? HTMLLabelElement : null,\r\n    canvas: typeof HTMLCanvasElement !== 'undefined' ? HTMLCanvasElement : null,\r\n    template: typeof HTMLTemplateElement !== 'undefined' ? HTMLTemplateElement : null,\r\n    svg: typeof SVGSVGElement !== 'undefined' ? SVGSVGElement : null,\r\n    body: typeof HTMLBodyElement !== 'undefined' ? HTMLBodyElement : null,\r\n})\r\n\r\nconst TAG_HELPERS = /** @type {Record<string, string>} */ ({\r\n    main: 'main',\r\n    section: 'section',\r\n    small: 'small',\r\n})\r\n\r\n// -----------------------------------------------------------------------------\r\n// Helper builders\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * @template {Function} T\r\n * @param {T} fn\r\n * @param {Function} optionalFn\r\n * @returns {T & { optional: Function, opt: Function }}\r\n */\r\nfunction attachOptional(fn, optionalFn) {\r\n    if (typeof fn !== 'function') {\r\n        throw new TypeError('id-dom: attachOptional expected fn to be a function')\r\n    }\r\n\r\n    if (typeof optionalFn !== 'function') {\r\n        throw new TypeError('id-dom: attachOptional expected optionalFn to be a function')\r\n    }\r\n\r\n    fn.optional = optionalFn\r\n    fn.opt = optionalFn\r\n    return fn\r\n}\r\n\r\n/**\r\n * @param {any} Type\r\n * @param {ReturnType<typeof normalizeConfig>} base\r\n * @param {ReturnType<typeof normalizeConfig>} baseNull\r\n */\r\nfunction makeTypedHelper(Type, base, baseNull) {\r\n    if (!Type) {\r\n        throw new TypeError('id-dom: makeTypedHelper received an invalid Type')\r\n    }\r\n\r\n    return attachOptional(\r\n        (id) => byId(id, Type, base),\r\n        (id) => byId(id, Type, baseNull)\r\n    )\r\n}\r\n\r\n/**\r\n * @param {string} tagName\r\n * @param {ReturnType<typeof normalizeConfig>} base\r\n * @param {ReturnType<typeof normalizeConfig>} baseNull\r\n */\r\nfunction makeTagHelper(tagName, base, baseNull) {\r\n    if (!tagName) {\r\n        throw new TypeError('id-dom: makeTagHelper received an invalid tagName')\r\n    }\r\n\r\n    return attachOptional(\r\n        (id) => tag(id, tagName, base),\r\n        (id) => tag(id, tagName, baseNull)\r\n    )\r\n}\r\n// -----------------------------------------------------------------------------\r\n// Factory\r\n// -----------------------------------------------------------------------------\r\n\r\n/**\r\n * Factory: scope getters to a specific root + default policy.\r\n *\r\n * @param {any} root\r\n * @param {Omit<DomConfig, 'root'>} [config]\r\n */\r\nexport function createDom(root, config) {\r\n    const base = normalizeConfig({ ...config, root })\r\n    const baseNull = { ...base, mode: 'null' }\r\n\r\n    /** @type {any} */\r\n    const api = {}\r\n\r\n    api.byId = attachOptional(\r\n        (id, Type) => byId(id, Type, base),\r\n        (id, Type) => byId(id, Type, baseNull)\r\n    )\r\n\r\n    api.tag = attachOptional(\r\n        (id, name) => tag(id, name, base),\r\n        (id, name) => tag(id, name, baseNull)\r\n    )\r\n\r\n    for (const [name, Type] of Object.entries(TYPE_HELPERS)) {\r\n        if (!Type) continue\r\n        api[name] = makeTypedHelper(Type, base, baseNull)\r\n    }\r\n\r\n    for (const [name, tagName] of Object.entries(TAG_HELPERS)) {\r\n        api[name] = makeTagHelper(tagName, base, baseNull)\r\n    }\r\n\r\n    return api\r\n}\r\n\r\n// -----------------------------------------------------------------------------\r\n// Default export\r\n// -----------------------------------------------------------------------------\r\n\r\nconst dom = createDom(DEFAULT_ROOT, { mode: 'throw' })\r\nexport default dom"],
+  "mappings": "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",
   "names": []
 }

package/dist/index.min.js

@@ -1 +1 @@
-const E=typeof document<"u"&&document?document:null;function p(e){return{mode:e?.mode??"throw",warn:e?.warn??!1,onError:typeof e?.onError=="function"?e.onError:null,root:e?.root??E}}function g(e){return!!e&&typeof e=="object"&&typeof e.getElementById=="function"}function H(e){return!!e&&typeof e=="object"&&typeof e.querySelector=="function"}const M=/^[A-Za-z_][A-Za-z0-9_-]*$/,b=/^(?:\d|-\d)/;function A(e){const n=String(e);if(typeof CSS<"u"&&typeof CSS.escape=="function")return CSS.escape(n);if(!b.test(n)&&M.test(n))return n;let l="";for(let o=0;o<n.length;){const t=n.codePointAt(o),i=String.fromCodePoint(t),r=t>=48&&t<=57||t>=65&&t<=90||t>=97&&t<=122||t===95||t===45;!(o===0&&(t>=48&&t<=57||t===45&&n.length>1&&n.codePointAt(1)>=48&&n.codePointAt(1)<=57))&&(r||t>=160)?l+=i:t===45&&o===0&&n.length>1&&n.codePointAt(1)>=48&&n.codePointAt(1)<=57?l+="\\-":l+=`\\${t.toString(16).toUpperCase()} `,o+=i.length}return l}function y(e,n){if(!e)return null;if(g(e))return e.getElementById(n);if(H(e)){const l=`#${A(n)}`,o=e.querySelector(l);return o instanceof HTMLElement?o:null}return null}function T(e){return e.startsWith("#")?e:`#${e}`}function L(e,n){return new Error(`id-dom: missing ${n} element ${T(e)}`)}function S(e,n,l){return new Error(`id-dom: expected ${n} for ${T(e)}, got ${l}`)}function a(e,n,l){try{l.onError?.(e,n)}catch{}if(l.warn&&console.warn(e),l.mode==="throw")throw e;return null}function c(e,n,l){const o=p(l),t=y(o.root,e);if(!t)return a(L(e,n.name),{id:e,Type:n,root:o.root,reason:"missing"},o);if(!(t instanceof n)){const i=t?.constructor?.name||typeof t;return a(S(e,n.name,i),{id:e,Type:n,root:o.root,reason:"wrong-type",got:i},o)}return t}c.optional=function(n,l,o){return c(n,l,{...o,mode:"null"})},c.opt=c.optional;function f(e,n,l){const o=p(l),t=y(o.root,e);if(!t)return a(L(e,`<${n}>`),{id:e,tagName:n,root:o.root,reason:"missing"},o);const i=String(n).toUpperCase(),r=String(t.tagName||"").toUpperCase();return r!==i?a(S(e,`<${i.toLowerCase()}>`,`<${r.toLowerCase()}>`),{id:e,tagName:n,root:o.root,reason:"wrong-tag",got:r},o):t}f.optional=function(n,l,o){return f(n,l,{...o,mode:"null"})},f.opt=f.optional;const m={el:typeof HTMLElement<"u"?HTMLElement:null,input:typeof HTMLInputElement<"u"?HTMLInputElement:null,button:typeof HTMLButtonElement<"u"?HTMLButtonElement:null,textarea:typeof HTMLTextAreaElement<"u"?HTMLTextAreaElement:null,select:typeof HTMLSelectElement<"u"?HTMLSelectElement:null,form:typeof HTMLFormElement<"u"?HTMLFormElement:null,div:typeof HTMLDivElement<"u"?HTMLDivElement:null,span:typeof HTMLSpanElement<"u"?HTMLSpanElement:null,label:typeof HTMLLabelElement<"u"?HTMLLabelElement:null,canvas:typeof HTMLCanvasElement<"u"?HTMLCanvasElement:null,template:typeof HTMLTemplateElement<"u"?HTMLTemplateElement:null,svg:typeof SVGSVGElement<"u"?SVGSVGElement:null},d={main:"main",section:"section",small:"small"};function w(e,n){const l=p({...n,root:e}),o={...l,mode:"null"},t={byId:(i,r)=>c(i,r,l),tag:(i,r)=>f(i,r,l)};for(const[i,r]of Object.entries(m))r&&(t[i]=u=>c(u,r,l));for(const[i,r]of Object.entries(d))t[i]=u=>f(u,r,l);t.byId.optional=(i,r)=>c(i,r,o),t.byId.opt=t.byId.optional,t.tag.optional=(i,r)=>f(i,r,o),t.tag.opt=t.tag.optional;for(const i of Object.keys(t)){const r=t[i];if(typeof r=="function"&&!r.optional){if(i in d){const u=d[i];r.optional=s=>f(s,u,o),r.opt=r.optional;continue}if(i in m){const u=m[i];u&&(r.optional=s=>c(s,u,o),r.opt=r.optional)}}}return t}const h=w(E,{mode:"throw"});var I=h;export{c as byId,w as createDom,I as default,f as tag};
+const y=typeof document<"u"&&document?document:null,u={INVALID_ID:"invalid-id",INVALID_TYPE:"invalid-type",INVALID_TAG:"invalid-tag",MISSING:"missing",WRONG_TYPE:"wrong-type",WRONG_TAG:"wrong-tag"},h=/^[A-Za-z_][A-Za-z0-9_-]*$/,H=/^(?:\d|-\d)/;function T(e){return{mode:e?.mode??"throw",warn:e?.warn??!1,onError:typeof e?.onError=="function"?e.onError:null,root:e?.root??y}}function w(e){return!!e&&typeof e=="object"&&typeof e.getElementById=="function"}function x(e){return!!e&&typeof e=="object"&&typeof e.querySelector=="function"}function A(e){const t=String(e);if(typeof CSS<"u"&&typeof CSS.escape=="function")return CSS.escape(t);if(!H.test(t)&&h.test(t))return t;let o="";for(let n=0;n<t.length;){const r=t.codePointAt(n),i=String.fromCodePoint(r),l=r>=48&&r<=57||r>=65&&r<=90||r>=97&&r<=122||r===95||r===45,m=t.codePointAt(n+1),M=r>=48&&r<=57,E=r===45&&t.length>1&&m>=48&&m<=57;!(n===0&&(M||E))&&(l||r>=160)?o+=i:n===0&&E?o+="\\-":o+=`\\${r.toString(16).toUpperCase()} `,n+=i.length}return o}function _(e){return!e||typeof e!="object"?!1:typeof Element<"u"?e instanceof Element:e.nodeType===1}function D(e,t){if(!e)return null;if(w(e))return e.getElementById(t);if(x(e)){const o=e.querySelector(`#${A(t)}`);return _(o)?o:null}return null}function S(e){return typeof e=="string"&&e.length>0}function b(e){return typeof e=="string"&&e.trim().length>0}function C(e){return typeof e=="function"}function s(e){return e.startsWith("#")?e:`#${e}`}function L(e,t){return new Error(`id-dom: missing ${t} element ${s(e)}`)}function I(e,t,o){return new Error(`id-dom: expected ${t} for ${s(e)}, got ${o}`)}function p(e,t,o){try{o.onError?.(e,t)}catch{}if(o.warn&&console.warn(e,t),o.mode==="throw")throw e;return null}function a(e,t,o,n){return{id:e,root:t,reason:o,...n||{}}}function g(e,t){const o=T(e),n=t.validateInput(o);if(n)return p(n.err,n.ctx,o);const r=D(o.root,t.id);if(!r){const i=t.onMissing(o);return p(i.err,i.ctx,o)}if(!t.matches(r,o)){const i=t.onMismatch(r,o);return p(i.err,i.ctx,o)}return r}function c(e,t,o){return g(o,{id:e,validateInput(n){return S(e)?C(t)?null:{err:new Error(`id-dom: invalid Type for ${s(e)}`),ctx:a(e,n.root,u.INVALID_TYPE,{Type:t})}:{err:new Error("id-dom: invalid id (expected non-empty string)"),ctx:a(String(e),n.root,u.INVALID_ID,{Type:t})}},onMissing(n){return{err:L(e,t.name),ctx:a(e,n.root,u.MISSING,{Type:t})}},matches(n){return n instanceof t},onMismatch(n,r){const i=n?.constructor?.name||typeof n;return{err:I(e,t.name,i),ctx:a(e,r.root,u.WRONG_TYPE,{Type:t,got:i})}}})}c.optional=function(t,o,n){return c(t,o,{...n,mode:"null"})},c.opt=c.optional;function f(e,t,o){return g(o,{id:e,validateInput(n){return S(e)?b(t)?null:{err:new Error(`id-dom: invalid tagName for ${s(e)}`),ctx:a(e,n.root,u.INVALID_TAG,{tagName:t})}:{err:new Error("id-dom: invalid id (expected non-empty string)"),ctx:a(String(e),n.root,u.INVALID_ID,{tagName:t})}},onMissing(n){return{err:L(e,`<${t}>`),ctx:a(e,n.root,u.MISSING,{tagName:t})}},matches(n){return String(n.tagName||"").toUpperCase()===String(t).toUpperCase()},onMismatch(n,r){const i=String(t).toUpperCase(),l=String(n.tagName||"").toUpperCase();return{err:I(e,`<${i.toLowerCase()}>`,`<${l.toLowerCase()}>`),ctx:a(e,r.root,u.WRONG_TAG,{tagName:t,got:l})}}})}f.optional=function(t,o,n){return f(t,o,{...n,mode:"null"})},f.opt=f.optional;const G={el:typeof HTMLElement<"u"?HTMLElement:null,input:typeof HTMLInputElement<"u"?HTMLInputElement:null,button:typeof HTMLButtonElement<"u"?HTMLButtonElement:null,textarea:typeof HTMLTextAreaElement<"u"?HTMLTextAreaElement:null,select:typeof HTMLSelectElement<"u"?HTMLSelectElement:null,form:typeof HTMLFormElement<"u"?HTMLFormElement:null,div:typeof HTMLDivElement<"u"?HTMLDivElement:null,span:typeof HTMLSpanElement<"u"?HTMLSpanElement:null,label:typeof HTMLLabelElement<"u"?HTMLLabelElement:null,canvas:typeof HTMLCanvasElement<"u"?HTMLCanvasElement:null,template:typeof HTMLTemplateElement<"u"?HTMLTemplateElement:null,svg:typeof SVGSVGElement<"u"?SVGSVGElement:null,body:typeof HTMLBodyElement<"u"?HTMLBodyElement:null},N={main:"main",section:"section",small:"small"};function d(e,t){if(typeof e!="function")throw new TypeError("id-dom: attachOptional expected fn to be a function");if(typeof t!="function")throw new TypeError("id-dom: attachOptional expected optionalFn to be a function");return e.optional=t,e.opt=t,e}function O(e,t,o){if(!e)throw new TypeError("id-dom: makeTypedHelper received an invalid Type");return d(n=>c(n,e,t),n=>c(n,e,o))}function $(e,t,o){if(!e)throw new TypeError("id-dom: makeTagHelper received an invalid tagName");return d(n=>f(n,e,t),n=>f(n,e,o))}function v(e,t){const o=T({...t,root:e}),n={...o,mode:"null"},r={};r.byId=d((i,l)=>c(i,l,o),(i,l)=>c(i,l,n)),r.tag=d((i,l)=>f(i,l,o),(i,l)=>f(i,l,n));for(const[i,l]of Object.entries(G))l&&(r[i]=O(l,o,n));for(const[i,l]of Object.entries(N))r[i]=$(l,o,n);return r}const V=v(y,{mode:"throw"});var R=V;export{c as byId,v as createDom,R as default,f as tag};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "id-dom",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Deterministic DOM element getters by ID (typed, tiny, modern).",
   "author": "DR.WATT",
   "license": "SEE LICENSE IN LICENSE",