id-dom 0.0.3 → 0.0.5

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": "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",
-  "names": []
+  "sourcesContent": ["// id-dom.js\n// id-dom \u2014 deterministic DOM element getters by ID (typed, tiny, modern)\n//\n// Goals:\n// - Prefer getElementById (fast, unambiguous)\n// - Return the correct type or fail predictably\n// - Provide strict + optional variants\n// - Allow app/module-level defaults (throw vs null) without bundler magic\n// - Zero deps, framework-agnostic\n\nconst DEFAULT_ROOT =\n    typeof document !== 'undefined' && document ? document : /** @type {any} */ (null)\n\nconst REASON = /** @type {const} */ ({\n    INVALID_ID: 'invalid-id',\n    INVALID_TYPE: 'invalid-type',\n    INVALID_TAG: 'invalid-tag',\n    MISSING: 'missing',\n    WRONG_TYPE: 'wrong-type',\n    WRONG_TAG: 'wrong-tag',\n})\n\nconst SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/\nconst NEEDS_START_ESCAPE_RE = /^(?:\\d|-\\d)/\n\n/**\n * @typedef {'throw' | 'null'} DomMode\n */\n\n/**\n * @typedef {{\n *   mode?: DomMode\n *   warn?: boolean\n *   onError?: (error: Error, ctx: any) => void\n *   root?: any\n * }} DomConfig\n */\n\n// -----------------------------------------------------------------------------\n// Config\n// -----------------------------------------------------------------------------\n\n/**\n * @param {DomConfig | undefined} cfg\n */\nfunction normalizeConfig(cfg) {\n    return {\n        mode: cfg?.mode ?? 'throw',\n        warn: cfg?.warn ?? false,\n        onError: typeof cfg?.onError === 'function' ? cfg.onError : null,\n        root: cfg?.root ?? DEFAULT_ROOT,\n    }\n}\n\n// -----------------------------------------------------------------------------\n// Root / DOM helpers\n// -----------------------------------------------------------------------------\n\n/**\n * @param {unknown} v\n * @returns {v is { getElementById(id: string): Element | null }}\n */\nfunction hasGetElementById(v) {\n    return !!v && typeof v === 'object' && typeof v.getElementById === 'function'\n}\n\n/**\n * @param {unknown} v\n * @returns {v is { querySelector(sel: string): Element | null }}\n */\nfunction hasQuerySelector(v) {\n    return !!v && typeof v === 'object' && typeof v.querySelector === 'function'\n}\n\n/**\n * Minimal CSS.escape fallback for environments where CSS.escape is missing.\n * We only need to safely build `#${id}` selectors.\n *\n * @param {string} id\n * @returns {string}\n */\nfunction cssEscape(id) {\n    const s = String(id)\n\n    if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\n        return CSS.escape(s)\n    }\n\n    if (!NEEDS_START_ESCAPE_RE.test(s) && SAFE_ID_RE.test(s)) return s\n\n    let out = ''\n    for (let i = 0; i < s.length;) {\n        const cp = s.codePointAt(i)\n        const ch = String.fromCodePoint(cp)\n\n        const isAsciiSafe =\n            (cp >= 48 && cp <= 57) || // 0-9\n            (cp >= 65 && cp <= 90) || // A-Z\n            (cp >= 97 && cp <= 122) || // a-z\n            cp === 95 || // _\n            cp === 45 // -\n\n        const next = s.codePointAt(i + 1)\n        const startsWithDigit = cp >= 48 && cp <= 57\n        const startsWithDashDigit = cp === 45 && s.length > 1 && next >= 48 && next <= 57\n        const needsStartEscape = i === 0 && (startsWithDigit || startsWithDashDigit)\n\n        if (!needsStartEscape && (isAsciiSafe || cp >= 0x00a0)) {\n            out += ch\n        } else if (i === 0 && startsWithDashDigit) {\n            out += '\\\\-'\n        } else {\n            out += `\\\\${cp.toString(16).toUpperCase()} `\n        }\n\n        i += ch.length\n    }\n\n    return out\n}\n\n/**\n * @param {unknown} v\n * @returns {v is Element}\n */\nfunction isElementNode(v) {\n    if (!v || typeof v !== 'object') return false\n    if (typeof Element !== 'undefined') return v instanceof Element\n    return /** @type {any} */ (v).nodeType === 1\n}\n\n/**\n * Resolve an element by id from a root.\n * Supports:\n *  - Document (getElementById)\n *  - ShadowRoot / DocumentFragment / Element (querySelector fallback)\n *\n * @param {any} root\n * @param {string} id\n * @returns {Element | null}\n */\nfunction getById(root, id) {\n    if (!root) return null\n\n    if (hasGetElementById(root)) return root.getElementById(id)\n\n    if (hasQuerySelector(root)) {\n        const el = root.querySelector(`#${cssEscape(id)}`)\n        return isElementNode(el) ? el : null\n    }\n\n    return null\n}\n\n// -----------------------------------------------------------------------------\n// Validation helpers\n// -----------------------------------------------------------------------------\n\n/**\n * @param {unknown} v\n * @returns {v is string}\n */\nfunction isValidId(v) {\n    return typeof v === 'string' && v.length > 0\n}\n\n/**\n * @param {unknown} v\n * @returns {v is string}\n */\nfunction isValidTagName(v) {\n    return typeof v === 'string' && v.trim().length > 0\n}\n\n/**\n * @param {unknown} v\n * @returns {v is Function}\n */\nfunction isConstructor(v) {\n    return typeof v === 'function'\n}\n\n// -----------------------------------------------------------------------------\n// Error / policy helpers\n// -----------------------------------------------------------------------------\n\n/**\n * @param {string} id\n * @returns {string}\n */\nfunction fmtId(id) {\n    return id.startsWith('#') ? id : `#${id}`\n}\n\n/**\n * @param {string} id\n * @param {string} expected\n * @returns {Error}\n */\nfunction missingElError(id, expected) {\n    return new Error(`id-dom: missing ${expected} element ${fmtId(id)}`)\n}\n\n/**\n * @param {string} id\n * @param {string} expected\n * @param {string} got\n * @returns {Error}\n */\nfunction wrongTypeError(id, expected, got) {\n    return new Error(`id-dom: expected ${expected} for ${fmtId(id)}, got ${got}`)\n}\n\n/**\n * @template T\n * @param {Error} err\n * @param {any} ctx\n * @param {ReturnType<typeof normalizeConfig>} cfg\n * @returns {T | null}\n */\nfunction handleLookupError(err, ctx, cfg) {\n    try {\n        cfg.onError?.(err, ctx)\n    } catch {\n        // reporting must never break app logic\n    }\n\n    if (cfg.warn) console.warn(err, ctx)\n\n    if (cfg.mode === 'throw') throw err\n    return null\n}\n\n/**\n * @param {string} id\n * @param {any} root\n * @param {string} reason\n * @param {object} [extra]\n * @returns {any}\n */\nfunction createCtx(id, root, reason, extra) {\n    return {\n        id,\n        root,\n        reason,\n        ...(extra || {}),\n    }\n}\n\n// -----------------------------------------------------------------------------\n// Internal generic resolver\n// -----------------------------------------------------------------------------\n\n/**\n * @template T\n * @param {DomConfig | undefined} config\n * @param {{\n *   id: string,\n *   validateInput: (cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any } | null,\n *   onMissing: (cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any },\n *   matches: (el: Element, cfg: ReturnType<typeof normalizeConfig>) => boolean,\n *   onMismatch: (el: Element, cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any },\n * }} spec\n * @returns {T | null}\n */\nfunction resolveLookup(config, spec) {\n    const cfg = normalizeConfig(config)\n\n    const inputFailure = spec.validateInput(cfg)\n    if (inputFailure) {\n        return handleLookupError(inputFailure.err, inputFailure.ctx, cfg)\n    }\n\n    const el = getById(cfg.root, spec.id)\n    if (!el) {\n        const failure = spec.onMissing(cfg)\n        return handleLookupError(failure.err, failure.ctx, cfg)\n    }\n\n    if (!spec.matches(el, cfg)) {\n        const failure = spec.onMismatch(el, cfg)\n        return handleLookupError(failure.err, failure.ctx, cfg)\n    }\n\n    return /** @type {T} */ (el)\n}\n\n// -----------------------------------------------------------------------------\n// Public APIs\n// -----------------------------------------------------------------------------\n\n/**\n * Typed lookup by ID.\n *\n * @template {Element} T\n * @param {string} id\n * @param {{ new (...args: any[]): T }} Type\n * @param {DomConfig} [config]\n * @returns {T | null}\n */\nexport function byId(id, Type, config) {\n    return resolveLookup(config, {\n        id,\n\n        validateInput(cfg) {\n            if (!isValidId(id)) {\n                return {\n                    err: new Error('id-dom: invalid id (expected non-empty string)'),\n                    ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { Type }),\n                }\n            }\n\n            if (!isConstructor(Type)) {\n                return {\n                    err: new Error(`id-dom: invalid Type for ${fmtId(id)}`),\n                    ctx: createCtx(id, cfg.root, REASON.INVALID_TYPE, { Type }),\n                }\n            }\n\n            return null\n        },\n\n        onMissing(cfg) {\n            return {\n                err: missingElError(id, Type.name),\n                ctx: createCtx(id, cfg.root, REASON.MISSING, { Type }),\n            }\n        },\n\n        matches(el) {\n            return el instanceof Type\n        },\n\n        onMismatch(el, cfg) {\n            const got = el?.constructor?.name || typeof el\n            return {\n                err: wrongTypeError(id, Type.name, got),\n                ctx: createCtx(id, cfg.root, REASON.WRONG_TYPE, { Type, got }),\n            }\n        },\n    })\n}\n\n/**\n * Optional typed lookup: always returns T | null.\n *\n * @template {Element} T\n * @param {string} id\n * @param {{ new (...args: any[]): T }} Type\n * @param {DomConfig} [config]\n * @returns {T | null}\n */\nbyId.optional = function byIdOptional(id, Type, config) {\n    return byId(id, Type, { ...config, mode: 'null' })\n}\n\nbyId.opt = byId.optional\n\n/**\n * Tag-name lookup by element tag.\n * Useful when constructor checks are not the right fit.\n *\n * @param {string} id\n * @param {string} tagName\n * @param {DomConfig} [config]\n * @returns {Element | null}\n */\nexport function tag(id, tagName, config) {\n    return resolveLookup(config, {\n        id,\n\n        validateInput(cfg) {\n            if (!isValidId(id)) {\n                return {\n                    err: new Error('id-dom: invalid id (expected non-empty string)'),\n                    ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { tagName }),\n                }\n            }\n\n            if (!isValidTagName(tagName)) {\n                return {\n                    err: new Error(`id-dom: invalid tagName for ${fmtId(id)}`),\n                    ctx: createCtx(id, cfg.root, REASON.INVALID_TAG, { tagName }),\n                }\n            }\n\n            return null\n        },\n\n        onMissing(cfg) {\n            return {\n                err: missingElError(id, `<${tagName}>`),\n                ctx: createCtx(id, cfg.root, REASON.MISSING, { tagName }),\n            }\n        },\n\n        matches(el) {\n            return String(el.tagName || '').toUpperCase() === String(tagName).toUpperCase()\n        },\n\n        onMismatch(el, cfg) {\n            const expected = String(tagName).toUpperCase()\n            const got = String(el.tagName || '').toUpperCase()\n\n            return {\n                err: wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),\n                ctx: createCtx(id, cfg.root, REASON.WRONG_TAG, { tagName, got }),\n            }\n        },\n    })\n}\n\n/**\n * Optional tag lookup: always returns Element | null.\n *\n * @param {string} id\n * @param {string} tagName\n * @param {DomConfig} [config]\n * @returns {Element | null}\n */\ntag.optional = function tagOptional(id, tagName, config) {\n    return tag(id, tagName, { ...config, mode: 'null' })\n}\n\ntag.opt = tag.optional\n\n// -----------------------------------------------------------------------------\n// Helper registries\n// -----------------------------------------------------------------------------\n\nconst TYPE_HELPERS = /** @type {Record<string, any>} */ ({\n    el: typeof HTMLElement !== 'undefined' ? HTMLElement : null,\n    input: typeof HTMLInputElement !== 'undefined' ? HTMLInputElement : null,\n    button: typeof HTMLButtonElement !== 'undefined' ? HTMLButtonElement : null,\n    textarea: typeof HTMLTextAreaElement !== 'undefined' ? HTMLTextAreaElement : null,\n    select: typeof HTMLSelectElement !== 'undefined' ? HTMLSelectElement : null,\n    form: typeof HTMLFormElement !== 'undefined' ? HTMLFormElement : null,\n    div: typeof HTMLDivElement !== 'undefined' ? HTMLDivElement : null,\n    span: typeof HTMLSpanElement !== 'undefined' ? HTMLSpanElement : null,\n    label: typeof HTMLLabelElement !== 'undefined' ? HTMLLabelElement : null,\n    canvas: typeof HTMLCanvasElement !== 'undefined' ? HTMLCanvasElement : null,\n    template: typeof HTMLTemplateElement !== 'undefined' ? HTMLTemplateElement : null,\n    svg: typeof SVGSVGElement !== 'undefined' ? SVGSVGElement : null,\n    body: typeof HTMLBodyElement !== 'undefined' ? HTMLBodyElement : null,\n})\n\nconst TAG_HELPERS = /** @type {Record<string, string>} */ ({\n    main: 'main',\n    section: 'section',\n    small: 'small',\n})\n\n// -----------------------------------------------------------------------------\n// Helper builders\n// -----------------------------------------------------------------------------\n\n/**\n * @template {Function} T\n * @param {T} fn\n * @param {Function} optionalFn\n * @returns {T & { optional: Function, opt: Function }}\n */\nfunction attachOptional(fn, optionalFn) {\n    if (typeof fn !== 'function') {\n        throw new TypeError('id-dom: attachOptional expected fn to be a function')\n    }\n\n    if (typeof optionalFn !== 'function') {\n        throw new TypeError('id-dom: attachOptional expected optionalFn to be a function')\n    }\n\n    fn.optional = optionalFn\n    fn.opt = optionalFn\n    return fn\n}\n\n/**\n * @param {any} Type\n * @param {ReturnType<typeof normalizeConfig>} base\n * @param {ReturnType<typeof normalizeConfig>} baseNull\n */\nfunction makeTypedHelper(Type, base, baseNull) {\n    if (!Type) {\n        throw new TypeError('id-dom: makeTypedHelper received an invalid Type')\n    }\n\n    return attachOptional(\n        (id) => byId(id, Type, base),\n        (id) => byId(id, Type, baseNull)\n    )\n}\n\n/**\n * @param {string} tagName\n * @param {ReturnType<typeof normalizeConfig>} base\n * @param {ReturnType<typeof normalizeConfig>} baseNull\n */\nfunction makeTagHelper(tagName, base, baseNull) {\n    if (!tagName) {\n        throw new TypeError('id-dom: makeTagHelper received an invalid tagName')\n    }\n\n    return attachOptional(\n        (id) => tag(id, tagName, base),\n        (id) => tag(id, tagName, baseNull)\n    )\n}\n// -----------------------------------------------------------------------------\n// Factory\n// -----------------------------------------------------------------------------\n\n/**\n * Factory: scope getters to a specific root + default policy.\n *\n * @param {any} root\n * @param {Omit<DomConfig, 'root'>} [config]\n */\nexport function createDom(root, config) {\n    const base = normalizeConfig({ ...config, root })\n    const baseNull = { ...base, mode: 'null' }\n\n    /** @type {any} */\n    const api = {}\n\n    api.byId = attachOptional(\n        (id, Type) => byId(id, Type, base),\n        (id, Type) => byId(id, Type, baseNull)\n    )\n\n    api.tag = attachOptional(\n        (id, name) => tag(id, name, base),\n        (id, name) => tag(id, name, baseNull)\n    )\n\n    for (const [name, Type] of Object.entries(TYPE_HELPERS)) {\n        if (!Type) continue\n        api[name] = makeTypedHelper(Type, base, baseNull)\n    }\n\n    for (const [name, tagName] of Object.entries(TAG_HELPERS)) {\n        api[name] = makeTagHelper(tagName, base, baseNull)\n    }\n\n    return api\n}\n\n// -----------------------------------------------------------------------------\n// Default-root config (shared by the default export and the named typed helpers)\n// -----------------------------------------------------------------------------\n\nconst DEFAULT_BASE = normalizeConfig({ mode: 'throw', root: DEFAULT_ROOT })\nconst DEFAULT_BASE_NULL = { ...DEFAULT_BASE, mode: 'null' }\n\n/**\n * Build a typed helper bound to the default root.\n * Internal \u2014 exposed via the per-helper named exports below.\n *\n * @param {any} Type\n */\nfunction defaultTypedHelper(Type) {\n    return Type ? makeTypedHelper(Type, DEFAULT_BASE, DEFAULT_BASE_NULL) : null\n}\n\n/**\n * Build a tag-name helper bound to the default root.\n *\n * @param {string} tagName\n */\nfunction defaultTagHelper(tagName) {\n    return makeTagHelper(tagName, DEFAULT_BASE, DEFAULT_BASE_NULL)\n}\n\n// -----------------------------------------------------------------------------\n// Named typed-element helpers (per-helper exports \u2014 tree-shakeable)\n//\n// Each one is a `const` initialized to a tiny closure produced by\n// makeTypedHelper. Modern bundlers (esbuild, rollup, vite) drop the\n// unused ones because the package declares sideEffects: false.\n//\n// SSR-safe: in environments where the corresponding global constructor\n// isn't defined (Node without jsdom, etc.), the export is `null` rather\n// than a thrown construction error.\n// -----------------------------------------------------------------------------\n\nexport const el       = defaultTypedHelper(typeof HTMLElement         !== 'undefined' ? HTMLElement         : null)\nexport const input    = defaultTypedHelper(typeof HTMLInputElement    !== 'undefined' ? HTMLInputElement    : null)\nexport const button   = defaultTypedHelper(typeof HTMLButtonElement   !== 'undefined' ? HTMLButtonElement   : null)\nexport const textarea = defaultTypedHelper(typeof HTMLTextAreaElement !== 'undefined' ? HTMLTextAreaElement : null)\nexport const select   = defaultTypedHelper(typeof HTMLSelectElement   !== 'undefined' ? HTMLSelectElement   : null)\nexport const form     = defaultTypedHelper(typeof HTMLFormElement     !== 'undefined' ? HTMLFormElement     : null)\nexport const div      = defaultTypedHelper(typeof HTMLDivElement      !== 'undefined' ? HTMLDivElement      : null)\nexport const span     = defaultTypedHelper(typeof HTMLSpanElement     !== 'undefined' ? HTMLSpanElement     : null)\nexport const label    = defaultTypedHelper(typeof HTMLLabelElement    !== 'undefined' ? HTMLLabelElement    : null)\nexport const canvas   = defaultTypedHelper(typeof HTMLCanvasElement   !== 'undefined' ? HTMLCanvasElement   : null)\nexport const template = defaultTypedHelper(typeof HTMLTemplateElement !== 'undefined' ? HTMLTemplateElement : null)\nexport const svg      = defaultTypedHelper(typeof SVGSVGElement       !== 'undefined' ? SVGSVGElement       : null)\nexport const body     = defaultTypedHelper(typeof HTMLBodyElement     !== 'undefined' ? HTMLBodyElement     : null)\n\n// Named tag-name helpers (no dedicated constructor)\nexport const main    = defaultTagHelper('main')\nexport const section = defaultTagHelper('section')\nexport const small   = defaultTagHelper('small')\n\n// -----------------------------------------------------------------------------\n// Default export \u2014 the convenience object aggregating every helper. Use\n// named imports above for tree-shake-friendly bundles; use this default\n// when you want all helpers under one namespace (`dom.button(\u2026)`).\n// -----------------------------------------------------------------------------\n\nconst dom = createDom(DEFAULT_ROOT, { mode: 'throw' })\nexport default dom"],
+  "mappings": "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",
+  "names": ["el"]
 }

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 el2 = root.querySelector(`#${cssEscape(id)}`);
+    return isElementNode(el2) ? el2 : 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);
-  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 inputFailure = spec.validateInput(cfg);
+  if (inputFailure) {
+    return handleLookupError(inputFailure.err, inputFailure.ctx, cfg);
+  }
+  const el2 = getById(cfg.root, spec.id);
+  if (!el2) {
+    const failure = spec.onMissing(cfg);
+    return handleLookupError(failure.err, failure.ctx, cfg);
+  }
+  if (!spec.matches(el2, cfg)) {
+    const failure = spec.onMismatch(el2, cfg);
+    return handleLookupError(failure.err, failure.ctx, cfg);
+  }
+  return (
+    /** @type {T} */
+    el2
+  );
+}
+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(el2) {
+      return el2 instanceof Type;
+    },
+    onMismatch(el2, cfg) {
+      const got = el2?.constructor?.name || typeof el2;
+      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(el2) {
+      return String(el2.tagName || "").toUpperCase() === String(tagName).toUpperCase();
+    },
+    onMismatch(el2, cfg) {
+      const expected = String(tagName).toUpperCase();
+      const got = String(el2.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,51 +238,102 @@ 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;
 }
+const DEFAULT_BASE = normalizeConfig({ mode: "throw", root: DEFAULT_ROOT });
+const DEFAULT_BASE_NULL = { ...DEFAULT_BASE, mode: "null" };
+function defaultTypedHelper(Type) {
+  return Type ? makeTypedHelper(Type, DEFAULT_BASE, DEFAULT_BASE_NULL) : null;
+}
+function defaultTagHelper(tagName) {
+  return makeTagHelper(tagName, DEFAULT_BASE, DEFAULT_BASE_NULL);
+}
+const el = defaultTypedHelper(typeof HTMLElement !== "undefined" ? HTMLElement : null);
+const input = defaultTypedHelper(typeof HTMLInputElement !== "undefined" ? HTMLInputElement : null);
+const button = defaultTypedHelper(typeof HTMLButtonElement !== "undefined" ? HTMLButtonElement : null);
+const textarea = defaultTypedHelper(typeof HTMLTextAreaElement !== "undefined" ? HTMLTextAreaElement : null);
+const select = defaultTypedHelper(typeof HTMLSelectElement !== "undefined" ? HTMLSelectElement : null);
+const form = defaultTypedHelper(typeof HTMLFormElement !== "undefined" ? HTMLFormElement : null);
+const div = defaultTypedHelper(typeof HTMLDivElement !== "undefined" ? HTMLDivElement : null);
+const span = defaultTypedHelper(typeof HTMLSpanElement !== "undefined" ? HTMLSpanElement : null);
+const label = defaultTypedHelper(typeof HTMLLabelElement !== "undefined" ? HTMLLabelElement : null);
+const canvas = defaultTypedHelper(typeof HTMLCanvasElement !== "undefined" ? HTMLCanvasElement : null);
+const template = defaultTypedHelper(typeof HTMLTemplateElement !== "undefined" ? HTMLTemplateElement : null);
+const svg = defaultTypedHelper(typeof SVGSVGElement !== "undefined" ? SVGSVGElement : null);
+const body = defaultTypedHelper(typeof HTMLBodyElement !== "undefined" ? HTMLBodyElement : null);
+const main = defaultTagHelper("main");
+const section = defaultTagHelper("section");
+const small = defaultTagHelper("small");
 const dom = createDom(DEFAULT_ROOT, { mode: "throw" });
 var id_dom_default = dom;
 export {
+  body,
+  button,
   byId,
+  canvas,
   createDom,
   id_dom_default as default,
-  tag
+  div,
+  el,
+  form,
+  input,
+  label,
+  main,
+  section,
+  select,
+  small,
+  span,
+  svg,
+  tag,
+  template,
+  textarea
 };
 //# sourceMappingURL=index.js.map

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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",
-  "names": []
+  "sourcesContent": ["// id-dom.js\n// id-dom \u2014 deterministic DOM element getters by ID (typed, tiny, modern)\n//\n// Goals:\n// - Prefer getElementById (fast, unambiguous)\n// - Return the correct type or fail predictably\n// - Provide strict + optional variants\n// - Allow app/module-level defaults (throw vs null) without bundler magic\n// - Zero deps, framework-agnostic\n\nconst DEFAULT_ROOT =\n    typeof document !== 'undefined' && document ? document : /** @type {any} */ (null)\n\nconst REASON = /** @type {const} */ ({\n    INVALID_ID: 'invalid-id',\n    INVALID_TYPE: 'invalid-type',\n    INVALID_TAG: 'invalid-tag',\n    MISSING: 'missing',\n    WRONG_TYPE: 'wrong-type',\n    WRONG_TAG: 'wrong-tag',\n})\n\nconst SAFE_ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/\nconst NEEDS_START_ESCAPE_RE = /^(?:\\d|-\\d)/\n\n/**\n * @typedef {'throw' | 'null'} DomMode\n */\n\n/**\n * @typedef {{\n *   mode?: DomMode\n *   warn?: boolean\n *   onError?: (error: Error, ctx: any) => void\n *   root?: any\n * }} DomConfig\n */\n\n// -----------------------------------------------------------------------------\n// Config\n// -----------------------------------------------------------------------------\n\n/**\n * @param {DomConfig | undefined} cfg\n */\nfunction normalizeConfig(cfg) {\n    return {\n        mode: cfg?.mode ?? 'throw',\n        warn: cfg?.warn ?? false,\n        onError: typeof cfg?.onError === 'function' ? cfg.onError : null,\n        root: cfg?.root ?? DEFAULT_ROOT,\n    }\n}\n\n// -----------------------------------------------------------------------------\n// Root / DOM helpers\n// -----------------------------------------------------------------------------\n\n/**\n * @param {unknown} v\n * @returns {v is { getElementById(id: string): Element | null }}\n */\nfunction hasGetElementById(v) {\n    return !!v && typeof v === 'object' && typeof v.getElementById === 'function'\n}\n\n/**\n * @param {unknown} v\n * @returns {v is { querySelector(sel: string): Element | null }}\n */\nfunction hasQuerySelector(v) {\n    return !!v && typeof v === 'object' && typeof v.querySelector === 'function'\n}\n\n/**\n * Minimal CSS.escape fallback for environments where CSS.escape is missing.\n * We only need to safely build `#${id}` selectors.\n *\n * @param {string} id\n * @returns {string}\n */\nfunction cssEscape(id) {\n    const s = String(id)\n\n    if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {\n        return CSS.escape(s)\n    }\n\n    if (!NEEDS_START_ESCAPE_RE.test(s) && SAFE_ID_RE.test(s)) return s\n\n    let out = ''\n    for (let i = 0; i < s.length;) {\n        const cp = s.codePointAt(i)\n        const ch = String.fromCodePoint(cp)\n\n        const isAsciiSafe =\n            (cp >= 48 && cp <= 57) || // 0-9\n            (cp >= 65 && cp <= 90) || // A-Z\n            (cp >= 97 && cp <= 122) || // a-z\n            cp === 95 || // _\n            cp === 45 // -\n\n        const next = s.codePointAt(i + 1)\n        const startsWithDigit = cp >= 48 && cp <= 57\n        const startsWithDashDigit = cp === 45 && s.length > 1 && next >= 48 && next <= 57\n        const needsStartEscape = i === 0 && (startsWithDigit || startsWithDashDigit)\n\n        if (!needsStartEscape && (isAsciiSafe || cp >= 0x00a0)) {\n            out += ch\n        } else if (i === 0 && startsWithDashDigit) {\n            out += '\\\\-'\n        } else {\n            out += `\\\\${cp.toString(16).toUpperCase()} `\n        }\n\n        i += ch.length\n    }\n\n    return out\n}\n\n/**\n * @param {unknown} v\n * @returns {v is Element}\n */\nfunction isElementNode(v) {\n    if (!v || typeof v !== 'object') return false\n    if (typeof Element !== 'undefined') return v instanceof Element\n    return /** @type {any} */ (v).nodeType === 1\n}\n\n/**\n * Resolve an element by id from a root.\n * Supports:\n *  - Document (getElementById)\n *  - ShadowRoot / DocumentFragment / Element (querySelector fallback)\n *\n * @param {any} root\n * @param {string} id\n * @returns {Element | null}\n */\nfunction getById(root, id) {\n    if (!root) return null\n\n    if (hasGetElementById(root)) return root.getElementById(id)\n\n    if (hasQuerySelector(root)) {\n        const el = root.querySelector(`#${cssEscape(id)}`)\n        return isElementNode(el) ? el : null\n    }\n\n    return null\n}\n\n// -----------------------------------------------------------------------------\n// Validation helpers\n// -----------------------------------------------------------------------------\n\n/**\n * @param {unknown} v\n * @returns {v is string}\n */\nfunction isValidId(v) {\n    return typeof v === 'string' && v.length > 0\n}\n\n/**\n * @param {unknown} v\n * @returns {v is string}\n */\nfunction isValidTagName(v) {\n    return typeof v === 'string' && v.trim().length > 0\n}\n\n/**\n * @param {unknown} v\n * @returns {v is Function}\n */\nfunction isConstructor(v) {\n    return typeof v === 'function'\n}\n\n// -----------------------------------------------------------------------------\n// Error / policy helpers\n// -----------------------------------------------------------------------------\n\n/**\n * @param {string} id\n * @returns {string}\n */\nfunction fmtId(id) {\n    return id.startsWith('#') ? id : `#${id}`\n}\n\n/**\n * @param {string} id\n * @param {string} expected\n * @returns {Error}\n */\nfunction missingElError(id, expected) {\n    return new Error(`id-dom: missing ${expected} element ${fmtId(id)}`)\n}\n\n/**\n * @param {string} id\n * @param {string} expected\n * @param {string} got\n * @returns {Error}\n */\nfunction wrongTypeError(id, expected, got) {\n    return new Error(`id-dom: expected ${expected} for ${fmtId(id)}, got ${got}`)\n}\n\n/**\n * @template T\n * @param {Error} err\n * @param {any} ctx\n * @param {ReturnType<typeof normalizeConfig>} cfg\n * @returns {T | null}\n */\nfunction handleLookupError(err, ctx, cfg) {\n    try {\n        cfg.onError?.(err, ctx)\n    } catch {\n        // reporting must never break app logic\n    }\n\n    if (cfg.warn) console.warn(err, ctx)\n\n    if (cfg.mode === 'throw') throw err\n    return null\n}\n\n/**\n * @param {string} id\n * @param {any} root\n * @param {string} reason\n * @param {object} [extra]\n * @returns {any}\n */\nfunction createCtx(id, root, reason, extra) {\n    return {\n        id,\n        root,\n        reason,\n        ...(extra || {}),\n    }\n}\n\n// -----------------------------------------------------------------------------\n// Internal generic resolver\n// -----------------------------------------------------------------------------\n\n/**\n * @template T\n * @param {DomConfig | undefined} config\n * @param {{\n *   id: string,\n *   validateInput: (cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any } | null,\n *   onMissing: (cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any },\n *   matches: (el: Element, cfg: ReturnType<typeof normalizeConfig>) => boolean,\n *   onMismatch: (el: Element, cfg: ReturnType<typeof normalizeConfig>) => { err: Error, ctx: any },\n * }} spec\n * @returns {T | null}\n */\nfunction resolveLookup(config, spec) {\n    const cfg = normalizeConfig(config)\n\n    const inputFailure = spec.validateInput(cfg)\n    if (inputFailure) {\n        return handleLookupError(inputFailure.err, inputFailure.ctx, cfg)\n    }\n\n    const el = getById(cfg.root, spec.id)\n    if (!el) {\n        const failure = spec.onMissing(cfg)\n        return handleLookupError(failure.err, failure.ctx, cfg)\n    }\n\n    if (!spec.matches(el, cfg)) {\n        const failure = spec.onMismatch(el, cfg)\n        return handleLookupError(failure.err, failure.ctx, cfg)\n    }\n\n    return /** @type {T} */ (el)\n}\n\n// -----------------------------------------------------------------------------\n// Public APIs\n// -----------------------------------------------------------------------------\n\n/**\n * Typed lookup by ID.\n *\n * @template {Element} T\n * @param {string} id\n * @param {{ new (...args: any[]): T }} Type\n * @param {DomConfig} [config]\n * @returns {T | null}\n */\nexport function byId(id, Type, config) {\n    return resolveLookup(config, {\n        id,\n\n        validateInput(cfg) {\n            if (!isValidId(id)) {\n                return {\n                    err: new Error('id-dom: invalid id (expected non-empty string)'),\n                    ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { Type }),\n                }\n            }\n\n            if (!isConstructor(Type)) {\n                return {\n                    err: new Error(`id-dom: invalid Type for ${fmtId(id)}`),\n                    ctx: createCtx(id, cfg.root, REASON.INVALID_TYPE, { Type }),\n                }\n            }\n\n            return null\n        },\n\n        onMissing(cfg) {\n            return {\n                err: missingElError(id, Type.name),\n                ctx: createCtx(id, cfg.root, REASON.MISSING, { Type }),\n            }\n        },\n\n        matches(el) {\n            return el instanceof Type\n        },\n\n        onMismatch(el, cfg) {\n            const got = el?.constructor?.name || typeof el\n            return {\n                err: wrongTypeError(id, Type.name, got),\n                ctx: createCtx(id, cfg.root, REASON.WRONG_TYPE, { Type, got }),\n            }\n        },\n    })\n}\n\n/**\n * Optional typed lookup: always returns T | null.\n *\n * @template {Element} T\n * @param {string} id\n * @param {{ new (...args: any[]): T }} Type\n * @param {DomConfig} [config]\n * @returns {T | null}\n */\nbyId.optional = function byIdOptional(id, Type, config) {\n    return byId(id, Type, { ...config, mode: 'null' })\n}\n\nbyId.opt = byId.optional\n\n/**\n * Tag-name lookup by element tag.\n * Useful when constructor checks are not the right fit.\n *\n * @param {string} id\n * @param {string} tagName\n * @param {DomConfig} [config]\n * @returns {Element | null}\n */\nexport function tag(id, tagName, config) {\n    return resolveLookup(config, {\n        id,\n\n        validateInput(cfg) {\n            if (!isValidId(id)) {\n                return {\n                    err: new Error('id-dom: invalid id (expected non-empty string)'),\n                    ctx: createCtx(String(id), cfg.root, REASON.INVALID_ID, { tagName }),\n                }\n            }\n\n            if (!isValidTagName(tagName)) {\n                return {\n                    err: new Error(`id-dom: invalid tagName for ${fmtId(id)}`),\n                    ctx: createCtx(id, cfg.root, REASON.INVALID_TAG, { tagName }),\n                }\n            }\n\n            return null\n        },\n\n        onMissing(cfg) {\n            return {\n                err: missingElError(id, `<${tagName}>`),\n                ctx: createCtx(id, cfg.root, REASON.MISSING, { tagName }),\n            }\n        },\n\n        matches(el) {\n            return String(el.tagName || '').toUpperCase() === String(tagName).toUpperCase()\n        },\n\n        onMismatch(el, cfg) {\n            const expected = String(tagName).toUpperCase()\n            const got = String(el.tagName || '').toUpperCase()\n\n            return {\n                err: wrongTypeError(id, `<${expected.toLowerCase()}>`, `<${got.toLowerCase()}>`),\n                ctx: createCtx(id, cfg.root, REASON.WRONG_TAG, { tagName, got }),\n            }\n        },\n    })\n}\n\n/**\n * Optional tag lookup: always returns Element | null.\n *\n * @param {string} id\n * @param {string} tagName\n * @param {DomConfig} [config]\n * @returns {Element | null}\n */\ntag.optional = function tagOptional(id, tagName, config) {\n    return tag(id, tagName, { ...config, mode: 'null' })\n}\n\ntag.opt = tag.optional\n\n// -----------------------------------------------------------------------------\n// Helper registries\n// -----------------------------------------------------------------------------\n\nconst TYPE_HELPERS = /** @type {Record<string, any>} */ ({\n    el: typeof HTMLElement !== 'undefined' ? HTMLElement : null,\n    input: typeof HTMLInputElement !== 'undefined' ? HTMLInputElement : null,\n    button: typeof HTMLButtonElement !== 'undefined' ? HTMLButtonElement : null,\n    textarea: typeof HTMLTextAreaElement !== 'undefined' ? HTMLTextAreaElement : null,\n    select: typeof HTMLSelectElement !== 'undefined' ? HTMLSelectElement : null,\n    form: typeof HTMLFormElement !== 'undefined' ? HTMLFormElement : null,\n    div: typeof HTMLDivElement !== 'undefined' ? HTMLDivElement : null,\n    span: typeof HTMLSpanElement !== 'undefined' ? HTMLSpanElement : null,\n    label: typeof HTMLLabelElement !== 'undefined' ? HTMLLabelElement : null,\n    canvas: typeof HTMLCanvasElement !== 'undefined' ? HTMLCanvasElement : null,\n    template: typeof HTMLTemplateElement !== 'undefined' ? HTMLTemplateElement : null,\n    svg: typeof SVGSVGElement !== 'undefined' ? SVGSVGElement : null,\n    body: typeof HTMLBodyElement !== 'undefined' ? HTMLBodyElement : null,\n})\n\nconst TAG_HELPERS = /** @type {Record<string, string>} */ ({\n    main: 'main',\n    section: 'section',\n    small: 'small',\n})\n\n// -----------------------------------------------------------------------------\n// Helper builders\n// -----------------------------------------------------------------------------\n\n/**\n * @template {Function} T\n * @param {T} fn\n * @param {Function} optionalFn\n * @returns {T & { optional: Function, opt: Function }}\n */\nfunction attachOptional(fn, optionalFn) {\n    if (typeof fn !== 'function') {\n        throw new TypeError('id-dom: attachOptional expected fn to be a function')\n    }\n\n    if (typeof optionalFn !== 'function') {\n        throw new TypeError('id-dom: attachOptional expected optionalFn to be a function')\n    }\n\n    fn.optional = optionalFn\n    fn.opt = optionalFn\n    return fn\n}\n\n/**\n * @param {any} Type\n * @param {ReturnType<typeof normalizeConfig>} base\n * @param {ReturnType<typeof normalizeConfig>} baseNull\n */\nfunction makeTypedHelper(Type, base, baseNull) {\n    if (!Type) {\n        throw new TypeError('id-dom: makeTypedHelper received an invalid Type')\n    }\n\n    return attachOptional(\n        (id) => byId(id, Type, base),\n        (id) => byId(id, Type, baseNull)\n    )\n}\n\n/**\n * @param {string} tagName\n * @param {ReturnType<typeof normalizeConfig>} base\n * @param {ReturnType<typeof normalizeConfig>} baseNull\n */\nfunction makeTagHelper(tagName, base, baseNull) {\n    if (!tagName) {\n        throw new TypeError('id-dom: makeTagHelper received an invalid tagName')\n    }\n\n    return attachOptional(\n        (id) => tag(id, tagName, base),\n        (id) => tag(id, tagName, baseNull)\n    )\n}\n// -----------------------------------------------------------------------------\n// Factory\n// -----------------------------------------------------------------------------\n\n/**\n * Factory: scope getters to a specific root + default policy.\n *\n * @param {any} root\n * @param {Omit<DomConfig, 'root'>} [config]\n */\nexport function createDom(root, config) {\n    const base = normalizeConfig({ ...config, root })\n    const baseNull = { ...base, mode: 'null' }\n\n    /** @type {any} */\n    const api = {}\n\n    api.byId = attachOptional(\n        (id, Type) => byId(id, Type, base),\n        (id, Type) => byId(id, Type, baseNull)\n    )\n\n    api.tag = attachOptional(\n        (id, name) => tag(id, name, base),\n        (id, name) => tag(id, name, baseNull)\n    )\n\n    for (const [name, Type] of Object.entries(TYPE_HELPERS)) {\n        if (!Type) continue\n        api[name] = makeTypedHelper(Type, base, baseNull)\n    }\n\n    for (const [name, tagName] of Object.entries(TAG_HELPERS)) {\n        api[name] = makeTagHelper(tagName, base, baseNull)\n    }\n\n    return api\n}\n\n// -----------------------------------------------------------------------------\n// Default-root config (shared by the default export and the named typed helpers)\n// -----------------------------------------------------------------------------\n\nconst DEFAULT_BASE = normalizeConfig({ mode: 'throw', root: DEFAULT_ROOT })\nconst DEFAULT_BASE_NULL = { ...DEFAULT_BASE, mode: 'null' }\n\n/**\n * Build a typed helper bound to the default root.\n * Internal \u2014 exposed via the per-helper named exports below.\n *\n * @param {any} Type\n */\nfunction defaultTypedHelper(Type) {\n    return Type ? makeTypedHelper(Type, DEFAULT_BASE, DEFAULT_BASE_NULL) : null\n}\n\n/**\n * Build a tag-name helper bound to the default root.\n *\n * @param {string} tagName\n */\nfunction defaultTagHelper(tagName) {\n    return makeTagHelper(tagName, DEFAULT_BASE, DEFAULT_BASE_NULL)\n}\n\n// -----------------------------------------------------------------------------\n// Named typed-element helpers (per-helper exports \u2014 tree-shakeable)\n//\n// Each one is a `const` initialized to a tiny closure produced by\n// makeTypedHelper. Modern bundlers (esbuild, rollup, vite) drop the\n// unused ones because the package declares sideEffects: false.\n//\n// SSR-safe: in environments where the corresponding global constructor\n// isn't defined (Node without jsdom, etc.), the export is `null` rather\n// than a thrown construction error.\n// -----------------------------------------------------------------------------\n\nexport const el       = defaultTypedHelper(typeof HTMLElement         !== 'undefined' ? HTMLElement         : null)\nexport const input    = defaultTypedHelper(typeof HTMLInputElement    !== 'undefined' ? HTMLInputElement    : null)\nexport const button   = defaultTypedHelper(typeof HTMLButtonElement   !== 'undefined' ? HTMLButtonElement   : null)\nexport const textarea = defaultTypedHelper(typeof HTMLTextAreaElement !== 'undefined' ? HTMLTextAreaElement : null)\nexport const select   = defaultTypedHelper(typeof HTMLSelectElement   !== 'undefined' ? HTMLSelectElement   : null)\nexport const form     = defaultTypedHelper(typeof HTMLFormElement     !== 'undefined' ? HTMLFormElement     : null)\nexport const div      = defaultTypedHelper(typeof HTMLDivElement      !== 'undefined' ? HTMLDivElement      : null)\nexport const span     = defaultTypedHelper(typeof HTMLSpanElement     !== 'undefined' ? HTMLSpanElement     : null)\nexport const label    = defaultTypedHelper(typeof HTMLLabelElement    !== 'undefined' ? HTMLLabelElement    : null)\nexport const canvas   = defaultTypedHelper(typeof HTMLCanvasElement   !== 'undefined' ? HTMLCanvasElement   : null)\nexport const template = defaultTypedHelper(typeof HTMLTemplateElement !== 'undefined' ? HTMLTemplateElement : null)\nexport const svg      = defaultTypedHelper(typeof SVGSVGElement       !== 'undefined' ? SVGSVGElement       : null)\nexport const body     = defaultTypedHelper(typeof HTMLBodyElement     !== 'undefined' ? HTMLBodyElement     : null)\n\n// Named tag-name helpers (no dedicated constructor)\nexport const main    = defaultTagHelper('main')\nexport const section = defaultTagHelper('section')\nexport const small   = defaultTagHelper('small')\n\n// -----------------------------------------------------------------------------\n// Default export \u2014 the convenience object aggregating every helper. Use\n// named imports above for tree-shake-friendly bundles; use this default\n// when you want all helpers under one namespace (`dom.button(\u2026)`).\n// -----------------------------------------------------------------------------\n\nconst dom = createDom(DEFAULT_ROOT, { mode: 'throw' })\nexport default dom"],
+  "mappings": "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",
+  "names": ["el"]
 }