quasiurl 1.0.1 → 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Alexander Tkačenko
+
+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

@@ -6,3 +6,17 @@ Unlike `URL`, `QuasiURL`:
 - can have an empty `origin`, `pathname`, `hostname`, `protocol`;
 - preserves templating characters without URL-encoding them;
 - doesn't implement the entire `URL` spec.
+
+```
+new URL("/x").href
+> TypeError: URL constructor: /x is not a valid URL.
+
+new QuasiURL("/x").href
+> "/x"
+
+new URL("https://a.aa/x{/:name}").pathname
+> "/x%7B/:name%7D"
+
+new QuasiURL("https://a.aa/x{/:name}").pathname
+> "/x{/:name}"
+```

package/dist/tests.js

@@ -44,7 +44,15 @@ function createQuasiURL(url2) {
 ${JSON.stringify(url2)}`);
   return new QuasiURL(url2);
 }
-var url = createQuasiURL("/sections/:id");
+var url = createQuasiURL("/x");
+assert(url.origin === "");
+assert(url.pathname === "/x");
+assert(url.search === "");
+assert(url.hash === "");
+assert(url.href === "/x");
+assert(url.hostname === "");
+assert(url.protocol === "");
+url = createQuasiURL("/sections/:id");
 assert(url.origin === "");
 assert(url.pathname === "/sections/:id");
 assert(url.search === "");
@@ -60,6 +68,14 @@ assert(url.hash === "");
 assert(url.href === "/x{/:name}");
 assert(url.hostname === "");
 assert(url.protocol === "");
+url = createQuasiURL("https://a.aa/x{/:name}");
+assert(url.origin === "https://a.aa");
+assert(url.pathname === "/x{/:name}");
+assert(url.search === "");
+assert(url.hash === "");
+assert(url.href === "https://a.aa/x{/:name}");
+assert(url.hostname === "a.aa");
+assert(url.protocol === "https:");
 url = createQuasiURL("/x?a=1&b=nnn#start");
 assert(url.origin === "");
 assert(url.pathname === "/x");

package/index.ts

@@ -4,36 +4,36 @@
  * - preserves templating characters without URL-encoding them.
  */
 export class QuasiURL {
-    hash: string;
-    hostname: string;
-    href: string;
-    origin: string;
-    pathname: string;
-    protocol: string;
-    search: string;
+  hash: string;
+  hostname: string;
+  href: string;
+  origin: string;
+  pathname: string;
+  protocol: string;
+  search: string;
 
-    constructor(url: string) {
-        let head = url.match(/^((\w+:)?\/\/([^/]+))(\/.*|$)/);
-        let tail = url.match(/(\?[^#]+)(#.+)?$/);
+  constructor(url: string) {
+    let head = url.match(/^((\w+:)?\/\/([^/]+))(\/.*|$)/);
+    let tail = url.match(/(\?[^#]+)(#.+)?$/);
 
-        let origin = head?.[1] ?? '';
-        let pathname = url
-            .replace(/^((\w+:)?\/\/[^/]+)/, '')
-            .replace(/\?.*$/, '')
-            .replace(/#.*$/, '');
-        let search = tail?.[1] ?? '';
-        let hash = tail?.[2] ?? '';
+    let origin = head?.[1] ?? "";
+    let pathname = url
+      .replace(/^((\w+:)?\/\/[^/]+)/, "")
+      .replace(/\?.*$/, "")
+      .replace(/#.*$/, "");
+    let search = tail?.[1] ?? "";
+    let hash = tail?.[2] ?? "";
 
-        this.origin = origin;
-        this.pathname = pathname;
-        this.search = search;
-        this.hash = hash;
+    this.origin = origin;
+    this.pathname = pathname;
+    this.search = search;
+    this.hash = hash;
 
-        this.href = `${origin}${pathname}${search}${hash}`;
-        this.hostname = head?.[3] ?? '';
-        this.protocol = head?.[2] ?? '';
-    }
-    toString() {
-        return this.href;
-    }
+    this.href = `${origin}${pathname}${search}${hash}`;
+    this.hostname = head?.[3] ?? "";
+    this.protocol = head?.[2] ?? "";
+  }
+  toString() {
+    return this.href;
+  }
 }

package/package.json

@@ -1,32 +1,32 @@
-{
-  "name": "quasiurl",
-  "version": "1.0.1",
-  "description": "URL for templating",
-  "type": "module",
-  "main": "dist/index.js",
-  "scripts": {
-    "build": "npx npm-run-all clean -p compile compile-tests",
-    "clean": "node -e \"require('node:fs').rmSync('dist', {force: true, recursive: true});\"",
-    "compile": "npx esbuild index.ts --bundle --outdir=dist --platform=neutral",
-    "compile-tests": "npx esbuild tests.ts --bundle --outdir=dist --platform=neutral",
-    "prepublishOnly": "npm run build",
-    "preversion": "npx npm-run-all typecheck shape build test",
-    "shape": "npx codeshape",
-    "test": "node dist/tests.js",
-    "typecheck": "tsc --noEmit"
-  },
-  "author": "axtk",
-  "license": "ISC",
-  "repository": {
-    "type": "git",
-    "url": "git://github.com/axtk/quasiurl.git"
-  },
-  "keywords": [
-    "url",
-    "template"
-  ],
-  "devDependencies": {
-    "@types/node": "^24.0.4",
-    "typescript": "^5.9.2"
-  }
-}
+{
+  "name": "quasiurl",
+  "version": "1.0.3",
+  "description": "URL for templating",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "npx npm-run-all clean -p compile compile-tests",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { force: true, recursive: true });\"",
+    "compile": "npx esbuild index.ts --bundle --outdir=dist --platform=neutral",
+    "compile-tests": "npx esbuild tests.ts --bundle --outdir=dist --platform=neutral",
+    "prepublishOnly": "npm run build",
+    "preversion": "npx npm-run-all typecheck shape build test",
+    "shape": "npx codeshape",
+    "test": "node dist/tests.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "author": "axtk",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/t8js/quasiurl.git"
+  },
+  "keywords": [
+    "url",
+    "template"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.0.4",
+    "typescript": "^5.9.2"
+  }
+}

package/tests.ts

@@ -1,102 +1,122 @@
-import {QuasiURL} from '.';
+import { QuasiURL } from ".";
 
 let k = 0;
 
 function assert(predicate: boolean) {
-    let n = `00${++k}`.slice(-3);
-
-    if (predicate) console.log(n, 'passed');
-    else {
-        console.error(n, 'failed');
-        console.error();
-        console.error('[!] failed');
-        process.exit(1);
-    }
+  let n = `00${++k}`.slice(-3);
+
+  if (predicate) console.log(n, "passed");
+  else {
+    console.error(n, "failed");
+    console.error();
+    console.error("[!] failed");
+    process.exit(1);
+  }
 }
 
 function createQuasiURL(url: string) {
-    console.log(`\n${JSON.stringify(url)}`);
-    return new QuasiURL(url);
+  console.log(`\n${JSON.stringify(url)}`);
+  return new QuasiURL(url);
 }
 
-let url = createQuasiURL('/sections/:id');
-
-assert(url.origin === '');
-assert(url.pathname === '/sections/:id');
-assert(url.search === '');
-assert(url.hash === '');
-assert(url.href === '/sections/:id');
-assert(url.hostname === '');
-assert(url.protocol === '');
-
-url = createQuasiURL('/x{/:name}');
-
-assert(url.origin === '');
-assert(url.pathname === '/x{/:name}');
-assert(url.search === '');
-assert(url.hash === '');
-assert(url.href === '/x{/:name}');
-assert(url.hostname === '');
-assert(url.protocol === '');
-
-url = createQuasiURL('/x?a=1&b=nnn#start');
-
-assert(url.origin === '');
-assert(url.pathname === '/x');
-assert(url.search === '?a=1&b=nnn');
-assert(url.hash === '#start');
-assert(url.href === '/x?a=1&b=nnn#start');
-assert(url.hostname === '');
-assert(url.protocol === '');
-
-url = createQuasiURL('https://a.aa/chapter/1');
-
-assert(url.origin === 'https://a.aa');
-assert(url.pathname === '/chapter/1');
-assert(url.search === '');
-assert(url.hash === '');
-assert(url.href === 'https://a.aa/chapter/1');
-assert(url.hostname === 'a.aa');
-assert(url.protocol === 'https:');
-
-url = createQuasiURL('https://a.aa');
-
-assert(url.origin === 'https://a.aa');
-assert(url.pathname === '');
-assert(url.search === '');
-assert(url.hash === '');
-assert(url.href === 'https://a.aa');
-assert(url.hostname === 'a.aa');
-assert(url.protocol === 'https:');
-
-url = createQuasiURL('');
-
-assert(url.origin === '');
-assert(url.pathname === '');
-assert(url.search === '');
-assert(url.hash === '');
-assert(url.href === '');
-assert(url.hostname === '');
-assert(url.protocol === '');
-
-url = createQuasiURL('?x=321&y=567#start');
-
-assert(url.origin === '');
-assert(url.pathname === '');
-assert(url.search === '?x=321&y=567');
-assert(url.hash === '#start');
-assert(url.href === '?x=321&y=567#start');
-assert(url.hostname === '');
-assert(url.protocol === '');
-
-url = createQuasiURL('x/y?a=1');
-
-assert(url.origin === '');
-assert(url.pathname === 'x/y');
-assert(url.search === '?a=1');
-assert(url.hash === '');
-assert(url.href === 'x/y?a=1');
-assert(url.hostname === '');
-assert(url.protocol === '');
-
-console.log('\npassed');
+let url = createQuasiURL("/x");
+
+assert(url.origin === "");
+assert(url.pathname === "/x");
+assert(url.search === "");
+assert(url.hash === "");
+assert(url.href === "/x");
+assert(url.hostname === "");
+assert(url.protocol === "");
+
+url = createQuasiURL("/sections/:id");
+
+assert(url.origin === "");
+assert(url.pathname === "/sections/:id");
+assert(url.search === "");
+assert(url.hash === "");
+assert(url.href === "/sections/:id");
+assert(url.hostname === "");
+assert(url.protocol === "");
+
+url = createQuasiURL("/x{/:name}");
+
+assert(url.origin === "");
+assert(url.pathname === "/x{/:name}");
+assert(url.search === "");
+assert(url.hash === "");
+assert(url.href === "/x{/:name}");
+assert(url.hostname === "");
+assert(url.protocol === "");
+
+url = createQuasiURL("https://a.aa/x{/:name}");
+
+assert(url.origin === "https://a.aa");
+assert(url.pathname === "/x{/:name}");
+assert(url.search === "");
+assert(url.hash === "");
+assert(url.href === "https://a.aa/x{/:name}");
+assert(url.hostname === "a.aa");
+assert(url.protocol === "https:");
+
+url = createQuasiURL("/x?a=1&b=nnn#start");
+
+assert(url.origin === "");
+assert(url.pathname === "/x");
+assert(url.search === "?a=1&b=nnn");
+assert(url.hash === "#start");
+assert(url.href === "/x?a=1&b=nnn#start");
+assert(url.hostname === "");
+assert(url.protocol === "");
+
+url = createQuasiURL("https://a.aa/chapter/1");
+
+assert(url.origin === "https://a.aa");
+assert(url.pathname === "/chapter/1");
+assert(url.search === "");
+assert(url.hash === "");
+assert(url.href === "https://a.aa/chapter/1");
+assert(url.hostname === "a.aa");
+assert(url.protocol === "https:");
+
+url = createQuasiURL("https://a.aa");
+
+assert(url.origin === "https://a.aa");
+assert(url.pathname === "");
+assert(url.search === "");
+assert(url.hash === "");
+assert(url.href === "https://a.aa");
+assert(url.hostname === "a.aa");
+assert(url.protocol === "https:");
+
+url = createQuasiURL("");
+
+assert(url.origin === "");
+assert(url.pathname === "");
+assert(url.search === "");
+assert(url.hash === "");
+assert(url.href === "");
+assert(url.hostname === "");
+assert(url.protocol === "");
+
+url = createQuasiURL("?x=321&y=567#start");
+
+assert(url.origin === "");
+assert(url.pathname === "");
+assert(url.search === "?x=321&y=567");
+assert(url.hash === "#start");
+assert(url.href === "?x=321&y=567#start");
+assert(url.hostname === "");
+assert(url.protocol === "");
+
+url = createQuasiURL("x/y?a=1");
+
+assert(url.origin === "");
+assert(url.pathname === "x/y");
+assert(url.search === "?a=1");
+assert(url.hash === "");
+assert(url.href === "x/y?a=1");
+assert(url.hostname === "");
+assert(url.protocol === "");
+
+console.log("\npassed");

package/tsconfig.json

@@ -1,15 +1,12 @@
-{
-    "include": [
-        "index.ts",
-        "tests.ts"
-    ],
-    "compilerOptions": {
-        "lib": ["ESNext", "DOM"],
-        "target": "ESNext",
-        "outDir": "dist",
-        "moduleResolution": "node",
-        "strict": true,
-        "noUnusedLocals": true,
-        "noUnusedParameters": true
-    }
-}
+{
+  "include": ["index.ts", "tests.ts"],
+  "compilerOptions": {
+    "lib": ["ESNext", "DOM"],
+    "target": "ESNext",
+    "outDir": "dist",
+    "moduleResolution": "node",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true
+  }
+}