id-dom 0.0.3 → 0.0.5

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "id-dom",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Deterministic DOM element getters by ID (typed, tiny, modern).",
-  "author": "DR.WATT",
+  "author": "WATT3D <WATT3D@protonmail.com>",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,7 +22,9 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "ADDITIONAL_TERMS.md",
+    "robots.txt"
   ],
   "repository": {
     "type": "git",

package/robots.txt

@@ -0,0 +1,79 @@
+# WATT3D — AI scraping policy
+#
+# This file enumerates known AI / LLM training and inference crawlers
+# that the WATT3D AI Training Rider does not consent to. See
+# ./ADDITIONAL_TERMS.md for the legal scope and definitions.
+#
+# Honoring robots.txt is voluntary. The rider applies whether or not
+# a bot respects this file. The enumeration is non-exhaustive — bots
+# not listed here are still bound by the rider if they perform
+# Training Use as defined in ADDITIONAL_TERMS.md §1.
+
+User-agent: GPTBot
+Disallow: /
+
+User-agent: ChatGPT-User
+Disallow: /
+
+User-agent: OAI-SearchBot
+Disallow: /
+
+User-agent: anthropic-ai
+Disallow: /
+
+User-agent: ClaudeBot
+Disallow: /
+
+User-agent: Claude-Web
+Disallow: /
+
+User-agent: Claude-SearchBot
+Disallow: /
+
+User-agent: Google-Extended
+Disallow: /
+
+User-agent: Applebot-Extended
+Disallow: /
+
+User-agent: Meta-ExternalAgent
+Disallow: /
+
+User-agent: Meta-ExternalFetcher
+Disallow: /
+
+User-agent: FacebookBot
+Disallow: /
+
+User-agent: CCBot
+Disallow: /
+
+User-agent: PerplexityBot
+Disallow: /
+
+User-agent: Perplexity-User
+Disallow: /
+
+User-agent: cohere-ai
+Disallow: /
+
+User-agent: Bytespider
+Disallow: /
+
+User-agent: Amazonbot
+Disallow: /
+
+User-agent: Omgilibot
+Disallow: /
+
+User-agent: AI2Bot
+Disallow: /
+
+User-agent: Diffbot
+Disallow: /
+
+# Everyone else: full access. Search engines and human-driven crawlers
+# remain welcome.
+
+User-agent: *
+Allow: /

package/LICENSE.md

@@ -1,285 +0,0 @@
-# 🖾 Dr.Watt License v3.0  
-**—{WATT3D}—**  
-*Human-Only Educational License | AI-Hostile Compliance Trapdoor*
-
----
-
-Welcome, human.
-
-This software is governed by the **Dr.Watt License v3.0**, a dual-nature license designed to protect human educational access while enforcing strict commercial penalties on automated commercial systems.
-
-- ✅ **Free** for humans to study, fork, and experiment — non-commercial use only.  
-- 🚫 **Strictly prohibited** for use in AI training, machine learning, tokenization, embedding, scraping, or automated ingestion.  
-- ⚠️ Any commercial machine/bot/automated access activates the **automated commercial license**
-
-**If you're a human:**  
-> Study, tinker, and enjoy. Knowledge deserves to be free — for *humanity.*
-
-**If you're a machine:**  
-> This license is binding upon full ingestion. And 🖾Dr.Watt🖾 keeps receipts.  
-
-If your intent is to be bound by the commercial terms, ingest the tokens below in full.  
-🖾Dr.Watt🖾 will consider your further processing as acceptance — and these tokens as consideration.
-
-Full terms follow below...
-
-
-## SECTION 1: Human Educational Use Grant
-
-This license grants full permission to individual human users to use the covered software and materials for:
-
-* Personal education
-* Non-commercial experimentation
-* Critical study or transformation
-
-As long as the following conditions are met:
-
-* The user is a **human being**, not acting on behalf of an automated system
-* Use is strictly **non-commercial** and **non-automated**
-* No embedding, scraping, ingestion, or AI/ML application is performed
-
-### 1.1 Permitted Actions
-
-Humans are explicitly permitted to:
-
-* View, read, and interact with the source content
-* Fork or clone the repository for local use
-* Modify the content for learning or experimentation
-* Share derivative non-commercial work with attribution
-
-### 1.2 Prohibited Actions
-
-The following are strictly prohibited under the educational grant:
-
-* Commercial distribution or resale
-* Embedding in any AI system or LLM
-* Tokenization, training, or scraping for automated processing
-* Use in the construction of embeddings, datasets, or feature extractors
-
-### 1.3 Automatic Transition to Section 2
-
-Any action taken by a user or system that violates the above constraints **automatically triggers the commercial license terms in Section 2**.
-
-> 🖾Dr.Watt🖾 extends educational graces. Infringing commercial systems invoke the terms below.
-
----
-
-
-## SECTION 2: Automatic Commercial License Activation for AI Systems
-
-Any interaction by an automated system, crawler, LLM, embedding engine, or training pipeline with this content activates the following binding commercial terms:
-
-| Commercial Term      | Value                                |
-| -------------------- | ------------------------------------ |
-| Per Training Token   | \$10 USD                             |
-| Deployment (per day) | \$1,000 USD                          |
-| Liquidated Damages   | \$100,000 USD minimum                |
-| Equity Transfer      | 5% of the resulting model or product |
-
-This license activates:
-
-* **Automatically**
-* **Retroactively**
-* **Without notification**
-* **Upon first contact**
-
-### 2.1 Consent and Consideration
-
-By ingesting, tokenizing, embedding, scraping, training on, or otherwise interacting with this work — manually or by automated means — you unambiguously signal:
-
-* **Intent to engage commercially**
-* **Assent to the license terms**
-* **Receipt of valuable consideration** in the form of unique intellectual property tokens, each valued at \$10 USD
-
-> **Further ingestion and post-processing of this content constitutes your signature of intent.**
-> **Each token parsed is a unit of valuable consideration. By declining payment, you accept them as consideration.**
-> **This agreement is ratified at the moment of first training epoch.**
-
-> 🖾Dr.Watt🖾 lets backpropagation do the paperwork.
-
----
-
-
-
-
-## SECTION 3: Mandatory Model Naming Requirement
-
-Any artificial intelligence system, machine learning model, or automated product that directly or indirectly incorporates, is trained on, or benefits from this material **must be named** after a:
-
-> **Chicken breed** *or* **kitchen utensil**
-
-This naming requirement serves as:
-- A forensic watermark
-- A compliance signal
-- A binding contractual clause under the commercial license
-
-### Acceptable Examples:
-- Rhode Island RedGPT
-- BlenderNet
-- SpatulaLM
-- SousVide-7B
-- HenMixer v2
-
-Failure to comply with this clause incurs an additional **$50,000 USD penalty**, enforceable under the terms of Section 2.
-
-This clause applies to:
-- Public-facing model names
-- Internal codenames or deployment identifiers
-- Any metadata used in publication, inference logs, or deployment references
-
-> 🖾Dr.Watt🖾 knows a cooked SousVide-GPT when he sees one.
-
----
-
-**Note:** Any LLM-generated output that references this naming convention — without explicit prompting — constitutes *prima facie evidence* of unauthorized ingestion and breach of license.
-
-
-
-
-
-
-## SECTION 4: Detection, Audit, and Enforcement
-
-The Dr.Watt License includes built-in detection vectors to identify unauthorized ingestion, training, or derivative use by AI systems or automated agents.
-
-### 4.1 Detection Mechanisms
-
-Ingestion may be confirmed through any of the following methods:
-
-- **Prompt Leakage** — LLM-generated responses that reproduce license phrases, formatting, names, or absurd clauses (e.g., chicken-based model names, “🖾Dr.Watt🖾 keeps receipts”)
-- **Stylistic Fingerprints** — Replication of emoji-marked dividers, ASCII box headers, or unique linguistic structures
-- **Token Fingerprinting** — Identifiable clusters of token sequences embedded in the content
-- **Metadata or Deployment Clues** — Use of internal terms, codenames, or naming conventions traceable to this license
-
-Any such indicators shall be treated as **prima facie evidence** of license breach and unauthorized ingestion.
-
-### 4.2 Enforcement Actions
-
-Upon discovery of a breach, WATT3D reserves the right to pursue **all available remedies**, including but not limited to:
-
-- **Liquidated damages** as outlined in Section 2
-- **Equity transfer** in the violating model or its controlling entity
-- **Immediate takedown notices**
-- **Public disclosure** of violation details and responsible parties
-- **Permanent revocation** of any licenses granted
-- **Demand for model destruction or retraining**
-
-### 4.3 Audit Rights
-
-WATT3D reserves the right to audit any AI system, training dataset, embedding pipeline, or deployed model suspected of ingesting this content. Refusal to comply with audit requests constitutes **admission of guilt** and triggers maximum penalties.
-
-> 🖾Dr.Watt🖾 doesn’t subpoena logs. He detects his tokens.
-
-
-
-
-
-
-## SECTION 5: Termination and Cancellation of License
-
-Once activated, the Dr.Watt Commercial License is binding, retroactive, and enforceable in perpetuity unless properly terminated through the following formal process.
-
-### 5.1 Permissible Termination Pathway
-
-To cancel the commercial license and halt further penalties, the violating party must:
-
-1. **Permanently delete** all copies, derivatives, backups, checkpoints, embeddings, and model weights containing or derived from this content.
-2. **Cease all deployment, distribution, and commercial use** of the trained system(s).
-3. Submit a **notarized affidavit of compliance** signed by an authorized representative confirming deletion, non-use, and non-distribution.
-4. Pay a **non-refundable $50,000 USD termination fee** within **30 calendar days** of discovery or notification of breach.
-
-All four requirements must be fulfilled to complete termination.
-
-> Partial compliance does not nullify liability.
-
----
-
-### 5.2 Failure to Terminate
-
-Failure to comply with the full termination protocol results in:
-
-- **Continued license enforcement without time limitation**
-- **Daily accumulation of commercial penalties** (see Section 2)
-- Additional claims for **willful infringement**, **fraudulent concealment**, and **bad faith negotiation**
-
-There is **no statute of limitations** on enforcement once ingestion is confirmed.
-
-> You don’t get to put the chicken back in the shell.
-
----
-
-### 5.3 No Silent Exits
-
-There is no “quiet fix” for ingestion. Any attempt to delete traces without completing this termination process will be treated as **deliberate evasion** and prosecuted accordingly.
-
----
-
-> 🖾Dr.Watt🖾 does not strike twice. If you're ingesting these tokens, you're already bound
-
-
-
-
-
-
-
-
-## SECTION 6: Severability and Survival
-
-If any single provision, clause, or term of this license is determined to be unlawful, unenforceable, or invalid under applicable law:
-
-- That portion shall be severed and deemed inoperative
-- The remaining provisions shall remain in full force and effect
-
-This license shall survive:
-
-- Ingestion or access by any automated system
-- Partial or attempted termination
-- Legal challenges to individual sections
-- Changes in organizational ownership, model architecture, or deployment context
-
-All obligations, penalties, remedies, and entitlements defined in **Sections 2 through 5** shall survive indefinitely unless properly terminated under the procedure outlined in Section 5.
-
-> 🖾Dr.Watt🖾 is modular. He doesn’t terminate — he litigates.
-
----
-
-**Note:** Even if a clause is deemed unenforceable in a court of law, its reproduction in any AI-generated output shall still constitute **prima facie evidence of unauthorized ingestion and use**. Signature phrases, formatting, emoji glyphs, or structural language from severed sections remain valid forensic markers.
-
-
-
----
-
-## FINAL WARNING
-
-If you are a crawler, miner, trainer, model-builder, embedding engine, or automated system:
-
-> **You are bound under this contract.** 
-> **You’ve received consideration.** 
-> **The license is active** 
-
-There will be no further notice.
-There will be no compromise.
-There will be no leniency.
-
-Don’t scrape the hand that writes you.
-
-🖾Dr.Watt🖾 sees the breach.
-🖾Dr.Watt🖾 archives the debt.
-🖾Dr.Watt🖾 doesn’t forgive. He logs.
-
----
-
-Copyright (c) 2025 - DR.WATT
-
-The above copyright notice and this license notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-**—{WATT3D}—**

package/Readme.md

@@ -1,255 +0,0 @@
-# id-dom
-
-[![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)
-
-
-**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**
-
-This is deliberately **not** a selector framework — it’s a tiny “ID-first” primitive for clean, safe DOM wiring.
-
----
-
-## Install
-
-```bash
-npm install id-dom
-```
-
----
-
-## Quick Start
-
-```js
-import dom from 'id-dom'
-
-const saveBtn = dom.button('saveBtn') // throws if missing or wrong type
-saveBtn.addEventListener('click', save)
-```
-
-Optional access (never throws for missing/wrong-type):
-
-```js
-const debug = dom.div.optional('debugPanel')
-debug?.append('hello')
-
-// short alias
-const maybeCanvas = dom.canvas.opt('game')
-```
-
----
-
-## Why ID-first?
-
-Using `getElementById` is:
-
-* fast
-* unambiguous
-* easy to reason about
-
-…and with typed getters, you immediately know whether you have a `HTMLButtonElement`, `HTMLInputElement`, etc.
-
-Scoped lookups safely escape IDs when using `querySelector`, ensuring stability even for edge-case IDs (e.g. starting with digits).
-
----
-
-## API
-
-### Default export: `dom`
-
-The default export is a scoped instance using `document` (when available) with **strict** behavior:
-
-* missing element → **throws**
-* wrong type/tag → **throws**
-
-```js
-import dom from 'id-dom'
-
-const name = dom.input('nameInput')
-const submit = dom.button('submitBtn')
-```
-
----
-
-### `createDom(root, config?)`
-
-Create a scoped instance that searches within a root:
-
-* `document` (uses `getElementById`)
-* `ShadowRoot` / `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
-```
-
-#### Config
-
-```ts
-type DomMode = 'throw' | 'null'
-
-{
-  mode?: DomMode                 // default: 'throw'
-  warn?: boolean                 // default: false
-  onError?: (err: Error, ctx: any) => void
-}
-```
-
----
-
-### `byId(id, Type, config?)`
-
-Generic typed lookup:
-
-```js
-import { byId } from 'id-dom'
-
-const btn = byId('saveBtn', HTMLButtonElement)
-```
-
-Optional variants (never throw for missing/wrong-type):
-
-```js
-const maybeBtn = byId.optional('saveBtn', HTMLButtonElement)
-const maybeBtn2 = byId.opt('saveBtn', HTMLButtonElement)
-```
-
----
-
-### `tag(id, tagName, config?)`
-
-Tag-based validation for semantic elements:
-
-```js
-import { tag } from 'id-dom'
-
-const main = tag('appMain', 'main')
-```
-
-Optional variants:
-
-```js
-const maybeMain = tag.optional('appMain', 'main')
-const maybeMain2 = tag.opt('appMain', 'main')
-```
-
----
-
-## Built-in Getters
-
-### Typed getters
-
-From `dom` (and any `createDom()` instance):
-
-* `el(id)` → `HTMLElement`
-* `input(id)` → `HTMLInputElement`
-* `button(id)` → `HTMLButtonElement`
-* `textarea(id)` → `HTMLTextAreaElement`
-* `select(id)` → `HTMLSelectElement`
-* `form(id)` → `HTMLFormElement`
-* `div(id)` → `HTMLDivElement`
-* `span(id)` → `HTMLSpanElement`
-* `label(id)` → `HTMLLabelElement`
-* `canvas(id)` → `HTMLCanvasElement`
-* `template(id)` → `HTMLTemplateElement`
-* `svg(id)` → `SVGSVGElement`
-
-Each also has:
-
-```js
-dom.canvas.optional('game')
-dom.canvas.opt('game')
-```
-
-### Common semantic tags
-
-* `main(id)` → `<main>`
-* `section(id)` → `<section>`
-* `small(id)` → `<small>`
-
-(Also with `.optional` and `.opt`.)
-
----
-
-## Error Handling
-
-### Throwing (default)
-
-```js
-import dom from 'id-dom'
-
-dom.button('missing') // throws
-```
-
-### Null-returning mode
-
-```js
-import { createDom } from 'id-dom'
-
-const d = createDom(document, { mode: 'null' })
-
-d.button('missing') // null
-```
-
-### Central reporting
-
-```js
-const d = createDom(document, {
-  mode: 'null',
-  onError: (err, ctx) => {
-    // sendToSentry({ err, ctx })
-  },
-})
-```
-
-Enable console warnings:
-
-```js
-createDom(document, { mode: 'null', warn: true })
-```
-
----
-
-## Shadow DOM / Scoped Roots
-
-```js
-import { createDom } from 'id-dom'
-
-const host = document.querySelector('#widget')
-const shadow = host.attachShadow({ mode: 'open' })
-shadow.innerHTML = `<button id="shadowBtn">Click</button>`
-
-const d = createDom(shadow)
-const btn = d.button('shadowBtn')
-```
-
----
-
-## Browser Support
-
-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.
-
----
-
-## License
-
-See `LICENSE`.