Merge pull request #3 from imglab-io/v0.1.1

v0.1.1

README.md

@@ -28,7 +28,18 @@ import Imglab from '@imglab/core'
 Imglab.url('assets', 'example.jpeg', { width: 500, height: 600 })
 ```
 
-## Browser
+### Browser
+
+If you prefer to use a `script` tag in your code to load `@imglab/core` try to use [UNPKG](https://unpkg.com) or [JSDELIVR](https://www.jsdelivr.com):
+
+```html
+<!-- Using UNPKG -->
+<script src="https://unpkg.com/@imglab/[email protected]/dist/imglab.umd.js"></script>
+<!-- Or using JDELIVR -->
+<script src="https://cdn.jsdelivr.net/npm/@imglab/[email protected]/dist/imglab.umd.js"></script>
+```
+
+After adding the library you can use it normally:
 
 ```javascript
 Imglab.url('assets', 'example.jpeg', { width: 500, height: 600 })

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@imglab/core",
   "source": "src/index.js",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Official imglab Javascript library",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

src/url.js

@@ -24,12 +24,21 @@ export default class Url {
     url.protocol = source.scheme()
     url.hostname = source.host
     url.port = source.port
-    url.pathname = source.path(normalizedPath)
+    url.pathname = source.path(Url.#encodePath(normalizedPath))
     url.search = Url.#encodeParams(source, normalizedPath, normalizedParams)
 
     return url.toString()
   }
 
+  static #encodePath(path) {
+    if (Utils.isWebURL(path)) {
+      return encodeURIComponent(path)
+    } else {
+      return path.split('/').map((pathComponent) =>
+        encodeURIComponent(pathComponent)
+      ).join('/')
+    }
+  }
 
   static #encodeParams(source, path, params) {
     if (Object.keys(params).length === 0) {

src/utils.js

@@ -3,6 +3,8 @@ export default class Utils {
   static #NORMALIZE_PATH_SUFFIX_REGEXP = new RegExp(/\/*$/)
   static #NORMALIZE_KEY_REGEXP = new RegExp(/([a-z])([A-Z])/g)
 
+  static #WEB_URL_PROTOCOLS = ['https:', 'http:']
+
   static normalizePath(path) {
     return path.replace(Utils.#NORMALIZE_PATH_PREFIX_REGEXP, '').replace(Utils.#NORMALIZE_PATH_SUFFIX_REGEXP, '')
   }
@@ -14,6 +16,16 @@ export default class Utils {
     }, {})
   }
 
+  static isWebURL(url) {
+    try {
+      const parsedURL = new URL(url)
+
+      return Utils.#WEB_URL_PROTOCOLS.includes(parsedURL.protocol)
+    } catch {
+      return false
+    }
+  }
+
   static #normalizeKey(key) {
     return key.replace(Utils.#NORMALIZE_KEY_REGEXP, '$1-$2').replace('_', '-').toLowerCase()
   }