@pirxpilot/nanohref 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Yoshua Wuyts
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission 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.

package/README.md

@@ -0,0 +1,65 @@
+[![NPM version][npm-image]][npm-url]
+[![Build Status][build-image]][build-url]
+[![Dependency Status][deps-image]][deps-url]
+
+# @pirxpilot/nanoraf
+
+Fork of [nanohref]. Tiny href click handler library.
+
+## Usage
+```js
+var nanohref = require('@pirxpilot/nanohref')
+
+// Handler automatically attached to window.document
+nanohref(function (location) {
+  console.log('new location is', location.pathname)
+})
+
+// Create DOM node
+var el = document.createElement('a')
+el.setAttribute('href', '/my-link')
+el.innerText = 'Click me'
+document.body.appendChild(el)
+
+// Trigger click
+el.click()
+// => "new location is /my-link"
+```
+
+## Ignoring links
+By default all href links are handled. The event is not handled under the
+following conditions:
+- the click event had `.preventDefault()` called on it
+- the link has a `data-nanohref-ignore` attribute
+- the link has a `target="_blank"` attribute with `rel="noopener noreferrer"`
+- a modifier key is enabled (e.g. `ctrl`, `alt`, `shift` or `meta`)
+- the link's href starts with protocol handler such as `mailto:` or `dat:`
+- the link points to a different host
+- the link has a `download` attribute
+
+:warning: Note that we only handle `target=_blank` if they also have
+`rel="noopener"` on them. This is needed to [properly sandbox web
+pages](https://mathiasbynens.github.io/rel-noopener/).
+
+## API
+### `nanohref(handler(location))`
+Create a new anchor click handler.
+
+## See Also
+- [MDN/link-types](https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types)
+- [caniuse/rel=noopener](http://caniuse.com/#feat=rel-noopener)
+- [mapbox/link-hijacker](https://github.com/mapbox/link-hijacker)
+
+## License
+[MIT](https://tldrlegal.com/license/mit-license)
+
+[nanohref]: https://npmjs.org/package/nanohref
+
+[npm-image]: https://img.shields.io/npm/v/@pirxpilot/nanohref
+[npm-url]: https://npmjs.org/package/@pirxpilot/nanohref
+
+[build-url]: https://github.com/pirxpilot/nanohref/actions/workflows/check.yaml
+[build-image]: https://img.shields.io/github/workflow/status/pirxpilot/nanohref/check
+
+[deps-image]: https://img.shields.io/librariesio/release/npm/@pirxpilot/nanohref
+[deps-url]: https://libraries.io/npm/@pirxpilot%2Fnanohref

package/index.js

@@ -0,0 +1,30 @@
+const assert = require('assert')
+
+const safeExternalLink = /noopener/
+const protocolLink = /^[\w-_]+:/
+
+module.exports = href
+
+function href (cb) {
+  assert(typeof cb === 'function', 'nanohref: cb should be type function')
+
+  window.addEventListener('click', e => {
+    if ((e.button && e.button !== 0) ||
+      e.ctrlKey || e.metaKey || e.altKey || e.shiftKey ||
+      e.defaultPrevented) return
+
+    const anchor = e.target.closest('a[href]')
+    if (!anchor) return
+
+    if (window.location.protocol !== anchor.protocol ||
+      window.location.hostname !== anchor.hostname ||
+      window.location.port !== anchor.port ||
+      anchor.hasAttribute('data-nanohref-ignore') ||
+      anchor.hasAttribute('download') ||
+      (anchor.getAttribute('target') === '_blank' && safeExternalLink.test(anchor.getAttribute('rel'))) ||
+      protocolLink.test(anchor.getAttribute('href'))) return
+
+    e.preventDefault()
+    cb(anchor)
+  })
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@pirxpilot/nanohref",
+  "description": "Tiny href click handler library",
+  "repository": "pirxpilot/nanohref",
+  "version": "1.0.0",
+  "scripts": {
+    "test": "standard"
+  },
+  "browser": {
+    "assert": "@pirxpilot/nanoassert"
+  },
+  "dependencies": {
+    "@pirxpilot/nanoassert": "~1"
+  },
+  "devDependencies": {
+    "standard": "~17"
+  },
+  "keywords": [
+    "nano",
+    "browser",
+    "href",
+    "click",
+    "anchor"
+  ],
+  "license": "MIT",
+  "files": [
+    "index.js"
+  ]
+}