{"_id":"@build-in-blocks/dom.autoquery","_rev":"3-9bf0719d9394181336614bd7ff5e3cb3","name":"@build-in-blocks/dom.autoquery","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@build-in-blocks/dom.autoquery","version":"1.0.0","keywords":["@build-in-blocks","@build-in-blocks/dom.autoquery","dom.autoquery","build-in-blocks","buildinblocks","build in blocks","buildingblocks","building blocks","blocks","framework","library","package","typescript","javascript","web","shared","core","local development","local","development","dev","dom","autoquery","dom manipulation","html","html attribute","html attribute command"],"author":{"name":"Mary Obiagba"},"license":"AGPL-3.0","_id":"@build-in-blocks/dom.autoquery@1.0.0","maintainers":[{"name":"collabo-community","email":"acct.collabocommunity@gmail.com"}],"contributors":[{"name":"Find list of contributors in project README: https://github.com/build-in-blocks/dom.autoquery?tab=readme-ov-file#contributors"}],"homepage":"https://github.com/build-in-blocks/dom.autoquery#readme","bugs":{"url":"https://github.com/build-in-blocks/product-issue-reports/issues"},"dist":{"shasum":"d1e499f71e78845cc809dc9e1f1ec366729289e9","tarball":"https://registry.npmjs.org/@build-in-blocks/dom.autoquery/-/dom.autoquery-1.0.0.tgz","fileCount":48,"integrity":"sha512-41Sh9flgpTW5VgzJZMl3nOeuolfmeol+eTXiqhtqeIO7dyWc4RmDgBZxj6kLSXCNm7HHkkp9uIurYNZsgycz/Q==","signatures":[{"sig":"MEUCIQCUTF0+54fs2H7+yWUZnK0/kXIP8wn75/TWq5JMX8tNjgIgN1l+7RFOwYas6PRawEdeFGqH5gyxvBHeJ7PKF1AhEUc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":76754},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","module":"./build/index.js","exports":{".":{"types":"./build/index.d.ts","import":"./build/index.js","module":"./build/index.js"},"./dist.prod/*":"./dist.prod/*"},"gitHead":"f455ed4fe58d7c5ff8e05947b7397fe2babe56ad","scripts":{"build":"blocks.pkg.dev.build lib:build","prepare":"blocks.pkg.dev.setup dev:husky:setup:git","eslint:lint":"eslint .","prettier:format":"prettier --write \"**/*.{mjs,ts,js,json,html,css,scss}\""},"_npmUser":{"name":"collabo-community","email":"acct.collabocommunity@gmail.com"},"repository":{"url":"git+https://github.com/build-in-blocks/dom.autoquery.git","type":"git"},"_npmVersion":"11.6.2","description":"Intuitive DOM manipulation for your typescript web app projects.","directories":{},"sideEffects":false,"_nodeVersion":"24.0.2","publishConfig":{"registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"@build-in-blocks/dev.build":"1.0.7","@build-in-blocks/dev.setup":"1.0.5","@build-in-blocks/dev.resources":"1.0.4"},"_npmOperationalInternal":{"tmp":"tmp/dom.autoquery_1.0.0_1777181161149_0.021102952340236847","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@build-in-blocks/dom.autoquery","version":"1.0.1","keywords":["@build-in-blocks","@build-in-blocks/dom.autoquery","dom.autoquery","build-in-blocks","buildinblocks","build in blocks","buildingblocks","building blocks","blocks","framework","library","package","typescript","javascript","web","shared","core","local development","local","development","dev","dom","autoquery","dom manipulation","html","html attribute","html attribute command"],"author":{"name":"Mary Obiagba"},"license":"AGPL-3.0","_id":"@build-in-blocks/dom.autoquery@1.0.1","maintainers":[{"name":"collabo-community","email":"acct.collabocommunity@gmail.com"}],"contributors":[{"name":"Find list of contributors in project README: https://github.com/build-in-blocks/dom.autoquery?tab=readme-ov-file#contributors"}],"homepage":"https://github.com/build-in-blocks/dom.autoquery#readme","bugs":{"url":"https://github.com/build-in-blocks/product-issue-reports/issues"},"dist":{"shasum":"60acc4a00d9b7e2801eb227b91b0c4a8d1064bfa","tarball":"https://registry.npmjs.org/@build-in-blocks/dom.autoquery/-/dom.autoquery-1.0.1.tgz","fileCount":48,"integrity":"sha512-Pqk7K9gOxYMUFwLfZffOzwude5xfowVZ8KemgQBIIuLgCH8tVgdN7JggaPZELoIK85ccTiHliOYvuV17KU4IAg==","signatures":[{"sig":"MEQCIEeMIAmMTPiYOu2sSgURgcUR2yn3z7MFiSUVm54IiK+5AiBf1fVO2JfmOZgnAvqNvYiL9KGWF8PB7IP/frDHe4IEAA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":76633},"main":"./build/index.js","type":"module","types":"./build/index.d.ts","module":"./build/index.js","exports":{".":{"types":"./build/index.d.ts","import":"./build/index.js","module":"./build/index.js"},"./dist.prod/*":"./dist.prod/*"},"gitHead":"cf5bd0e2df0c4f8dc36f7293bd61f44e93d2aa6d","scripts":{"build":"blocks.pkg.dev.build lib:build","prepare":"blocks.pkg.dev.setup dev:husky:setup:git","eslint:lint":"eslint .","prettier:format":"prettier --write \"**/*.{mjs,ts,js,json,html,css,scss}\""},"_npmUser":{"name":"collabo-community","email":"acct.collabocommunity@gmail.com"},"repository":{"url":"git+https://github.com/build-in-blocks/dom.autoquery.git","type":"git"},"_npmVersion":"11.6.2","description":"Intuitive DOM manipulation for your typescript web app projects.","directories":{},"sideEffects":false,"_nodeVersion":"24.0.2","publishConfig":{"registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"@build-in-blocks/dev.build":"1.0.7","@build-in-blocks/dev.setup":"1.0.5","@build-in-blocks/dev.resources":"1.0.4"},"_npmOperationalInternal":{"tmp":"tmp/dom.autoquery_1.0.1_1777243024273_0.14162428071840294","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@build-in-blocks/dom.autoquery","version":"1.0.2","description":"Intuitive accessibility-oriented DOM manipulation for your typescript web app projects.","type":"module","sideEffects":false,"main":"./build/index.js","module":"./build/index.js","types":"./build/index.d.ts","exports":{".":{"types":"./build/index.d.ts","import":"./build/index.js","module":"./build/index.js"},"./dist.prod/*":"./dist.prod/*"},"publishConfig":{"registry":"https://registry.npmjs.org/"},"scripts":{"build":"blocks.pkg.dev.build lib:build","prepare":"blocks.pkg.dev.setup dev:husky:setup:git","eslint:lint":"eslint .","prettier:format":"prettier --write \"**/*.{mjs,ts,js,json,html,css,scss}\""},"devDependencies":{"@build-in-blocks/dev.build":"1.0.7","@build-in-blocks/dev.resources":"1.0.4","@build-in-blocks/dev.setup":"1.0.5"},"homepage":"https://github.com/build-in-blocks/dom.autoquery#readme","bugs":{"url":"https://github.com/build-in-blocks/product-issue-reports/issues"},"repository":{"type":"git","url":"git+https://github.com/build-in-blocks/dom.autoquery.git"},"license":"AGPL-3.0","author":{"name":"Mary Obiagba"},"contributors":[{"name":"Find list of contributors in project README: https://github.com/build-in-blocks/dom.autoquery?tab=readme-ov-file#contributors"}],"keywords":["@build-in-blocks","@build-in-blocks/dom.autoquery","dom.autoquery","build-in-blocks","buildinblocks","build in blocks","buildingblocks","building blocks","blocks","framework","library","package","typescript","javascript","web","shared","core","local development","local","development","dev","dom","autoquery","dom manipulation","html","html attribute","html attribute command","accessibility"],"gitHead":"1daeffbdfd2d66ca9bd0ae94e2b219ae40dde66d","_id":"@build-in-blocks/dom.autoquery@1.0.2","_nodeVersion":"24.0.2","_npmVersion":"11.6.2","dist":{"integrity":"sha512-tsOOSc5xspmLieJQcp5lGGhF042Lyjobnku5fSYDqQOkyJWtcqa0wYAjUz331kIuzbB/mzOaMTuE79owfx3/2Q==","shasum":"e3ac956c6004ba89af3f52deceb42e6dfa0030d1","tarball":"https://registry.npmjs.org/@build-in-blocks/dom.autoquery/-/dom.autoquery-1.0.2.tgz","fileCount":48,"unpackedSize":76700,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDU/7H9TrbQxpdMa6f10mNwe8iApIOU/pv+6G2OwuWLaAIhANx9g+Nfdy06cW4RPJwrHteN61nZSBW9PXQrd9QW5m6d"}]},"_npmUser":{"name":"collabo-community","email":"acct.collabocommunity@gmail.com"},"directories":{},"maintainers":[{"name":"collabo-community","email":"acct.collabocommunity@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dom.autoquery_1.0.2_1777251757920_0.4808710209065348"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-26T05:26:00.983Z","modified":"2026-04-27T01:02:38.223Z","1.0.0":"2026-04-26T05:26:01.291Z","1.0.1":"2026-04-26T22:37:04.431Z","1.0.2":"2026-04-27T01:02:38.090Z"},"bugs":{"url":"https://github.com/build-in-blocks/product-issue-reports/issues"},"author":{"name":"Mary Obiagba"},"license":"AGPL-3.0","homepage":"https://github.com/build-in-blocks/dom.autoquery#readme","keywords":["@build-in-blocks","@build-in-blocks/dom.autoquery","dom.autoquery","build-in-blocks","buildinblocks","build in blocks","buildingblocks","building blocks","blocks","framework","library","package","typescript","javascript","web","shared","core","local development","local","development","dev","dom","autoquery","dom manipulation","html","html attribute","html attribute command","accessibility"],"repository":{"type":"git","url":"git+https://github.com/build-in-blocks/dom.autoquery.git"},"description":"Intuitive accessibility-oriented DOM manipulation for your typescript web app projects.","contributors":[{"name":"Find list of contributors in project README: https://github.com/build-in-blocks/dom.autoquery?tab=readme-ov-file#contributors"}],"maintainers":[{"name":"collabo-community","email":"acct.collabocommunity@gmail.com"}],"readme":"# @build-in-blocks/dom.autoquery\n\n![Latest Version](https://img.shields.io/npm/v/@build-in-blocks/dom.autoquery.svg?label=latest&color=brightgreen&style=flat-square) ![NPM Downloads](https://img.shields.io/npm/d18m/%40build-in-blocks%2Fdom.autoquery?color=blue&label=downloads%20(last%2018%20months)) ![build passing](https://img.shields.io/badge/build-passing-brightgreen?style=flat-square&label=Blocks%20CI)\n\n[![License: AGPL v3.0](https://img.shields.io/badge/license-AGPL%20v3.0-blue.svg?style=flat-square)](https://www.gnu.org/licenses/agpl-3.0) [![All Contributors](https://img.shields.io/github/all-contributors/build-in-blocks/dom.autoquery?color=ee8449&style=flat-square)](#contributors) [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat-square)](https://github.com/build-in-blocks/dom.autoquery/blob/develop/docs.contributors/README.md)\n\n#\n\n**Built with:** Node.js v24.0.2\n\n#\n\n**Supported Node.js versions:** Node.js v20.x, v22.x, v24.x and v25.x\n\n#\n\n**Overview:** Intuitive accessibility-oriented DOM manipulation for your `typescript` web app projects.\n\n#\n\n**Description:** The **@build-in-blocks/dom.autoquery** package provides HTML attributes that work like commands, providing clear instructions for dynamically swapping, adding and/or removing elements from the DOM on page load and on resize.\n\n#\n\n**User guide:** See [docs.users README.md](https://github.com/build-in-blocks/dom.autoquery/blob/develop/docs.users/README.md)\n\n#\n\n**Contributor guide:** See [docs.contributors README.md](https://github.com/build-in-blocks/dom.autoquery/blob/develop/docs.contributors/README.md)\n\n#\n\n**Run into any issues?** Report them via our [product issue reports repo](https://github.com/build-in-blocks/product-issue-reports/issues)\n\n#\n\n### Quick installation & usage guide\n\n#### 1. Main package installation\n\n- Needed: Install and setup [@build-in-blocks/dev.build](https://www.npmjs.com/package/@build-in-blocks/dev.build) in your typescript web app project.\n\n- Optional: Install and setup [@build-in-blocks/dev.setup](https://www.npmjs.com/package/@build-in-blocks/dev.setup) in your typescript web app project.\n\n- Needed: Install the dom autoquery package as a `devDependency` in your typescript web app project:\n\n  ````bash\n  npm install -D @build-in-blocks/dom.autoquery --save-exact\n  ````\n\n#### 2. Do I need to install `typescript`?\n\nSince you are to use both this library and [@build-in-blocks/dev.build](https://www.npmjs.com/package/@build-in-blocks/dev.build) together in your project, you don't need to install `typescript` in your project (the **@build-in-blocks/dev.build** library already does that internally, relative to your project).\n\nSee `typescript` table in the general guide for more information: [Typescript compatibility and usage](https://github.com/build-in-blocks/.github/wiki/Repo-User-Guide-Extension#table-typescript-compatibility-and-usage).\n\n#### 3. Initialize your app's device screen sizes\n\nIn your `index.ts` file (or whatever your app's entry point `.ts` file is named), import the `DOMautoquery` object, call and use the `.devices` method to specify the range of device sizes that you want your app to cater for.\n\nFor example:\n\n````ts\nimport { DOMautoquery } from '@build-in-blocks/dom.autoquery';\n\nDOMautoquery.devices({\n  //-------------------------------------------------------\n  // Specify as little or as much device sizes as you want.\n  // Update the sizes (names & startpoints) as you see fit.\n  //-------------------------------------------------------\n  sizes: {\n    1: { name: 'mobile', startPoint: 0},\n    2: { name: 'tablet', startPoint: 768 },\n    3: { name: 'desktop', startPoint: 1024 },\n    4: { name: 'wide', startPoint: 1280 },\n    5: { name: 'ultraWide', startPoint: 1600 },\n  },\n});\n````\n\n#### 4. Use the \"HTML attribute command\" that you need\n\nFor example, copy this code and add it in your `index.html`. Then resize your web browser to see the html element swap take place.\n\n````html\n<header>\n  <nav _refelem=\"navElem\">\n    <a href=\"#\">Home</a>\n    <a href=\"#\">About</a>\n    <a href=\"#\">Contact</a>\n  </nav>\n  <button _replacesibling=\"navElem\" _uptosize=\"2\">&#9776</button>\n</header>\n````\n\n#### 5. Explore more HTML attribute commands\n\nVisit the **user guide** link (towards the top 👆🏽 of this README) to see the full list of HTML attribute commands available.\n\n#\n\n### Contributors\n\nThanks to these amazing contributors to the **@build-in-blocks/dom.autoquery** project. This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. See [emoji key](https://allcontributors.org/docs/en/emoji-key). Contributions of any kind welcome!\n\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- prettier-ignore-start -->\n<!-- markdownlint-disable -->\n<table>\n  <tbody>\n    <tr>\n      <td align=\"center\" valign=\"top\" width=\"16.66%\"><a href=\"https://github.com/Ifycode\"><img src=\"https://avatars.githubusercontent.com/u/45185388?v=4?s=100\" width=\"100px;\" alt=\"Mary @Ifycode\"/><br /><sub><b>Mary @Ifycode</b></sub></a><br /><a href=\"https://github.com/build-in-blocks/dom.autoquery/commits?author=ifycode\" title=\"Code\">💻</a> <a href=\"https://github.com/build-in-blocks/dom.autoquery/commits?author=ifycode\" title=\"Documentation\">📖</a></td>\n      <td align=\"center\" valign=\"top\" width=\"16.66%\"><a href=\"https://github.com/apps/allcontributors\"><img src=\"https://avatars.githubusercontent.com/in/23186?v=4?s=100\" width=\"100px;\" alt=\"allcontributors[bot]\"/><br /><sub><b>allcontributors[bot]</b></sub></a><br /><a href=\"#tool-allcontributors[bot]\" title=\"Tools\">🔧</a> <a href=\"https://github.com/build-in-blocks/dom.autoquery/commits?author=allcontributors[bot]\" title=\"Documentation\">📖</a></td>\n    </tr>\n  </tbody>\n</table>\n\n<!-- markdownlint-restore -->\n<!-- prettier-ignore-end -->\n\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n","readmeFilename":"README.md"}