Add strict version (#30)

.gitignore

@@ -2,4 +2,6 @@ node_modules
 npm-debug.log
 index.js
 index.d.ts
+strict.js
+strict.d.ts
 *.map

package.json

@@ -17,7 +17,10 @@
 	"license": "MIT",
 	"author": "Federico Brigante <[email protected]> (https://fregante.com)",
 	"type": "module",
-	"exports": "./index.js",
+	"exports": {
+		".": "./index.js",
+		"./strict.js": "./strict.js"
+	},
 	"main": "./index.js",
 	"types": "./index.d.ts",
 	"files": [

readme.md

@@ -6,17 +6,17 @@
 
 > Lightweight `querySelector`/`All` wrapper that outputs an Array
 
-Version 7+ only supports browsers with [iterable `NodeList`s](https://developer.mozilla.org/en-US/docs/Web/API/NodeList/entries). If you need IE support, stick to [`select-dom@6`](https://github.com/fregante/select-dom/tree/v6.0.4) or lower.
-
 ## Install
 
 ```bash
 npm install select-dom
 ```
 
 ```js
-// This module is only offered as a ES Module
 import {$, $$, lastElement, elementExists} from 'select-dom';
+
+// And a stricter version
+import {$, $optional} from 'select-dom/strict.js';
 ```
 
 ## API
@@ -26,7 +26,6 @@ import {$, $$, lastElement, elementExists} from 'select-dom';
 ### `$(selector[, baseElement = document])`
 
 Maps to `baseElement.querySelector(selector)`, except it returns `undefined` if it's not found
-
 ```js
 $('.foo a[href=bar]');
 // => <Element>
@@ -73,6 +72,17 @@ $$('.foo', [baseElement1, baseElement2]);
 // This is similar to jQuery([baseElement1, baseElement2]).find('.foo')
 ```
 
+## /strict.js
+
+The strict export will throw an error if the element is not found, instead of returning `undefined`. This is also reflected in the types, which are non-nullable:
+
+```ts
+import {$, $optional} from 'select-dom/strict.js';
+
+const must: HTMLAnchorElement = $('.foo a[href=bar]'); //
+const optional: HTMLAnchorElement | undefined = $optional('.foo a[href=bar]');
+```
+
 ## Related
 
 - [delegate-it](https://github.com/fregante/delegate-it) - DOM event delegation, in <1KB.

strict.ts

@@ -0,0 +1 @@
+export {$ as $optional, expectElement as $} from './index.js';

tsconfig.json

@@ -1,6 +1,7 @@
 {
 	"extends": "@sindresorhus/tsconfig",
 	"files": [
-		"index.ts"
+		"index.ts",
+		"strict.ts"
 	]
 }