quasiurl 1.0.0

package/README.md

@@ -0,0 +1,8 @@
+# quasiurl
+
+*`URL`-like object for templated URLs*
+
+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.

package/dist/index.js

@@ -0,0 +1,31 @@
+// index.ts
+var QuasiURL = class {
+  hash;
+  hostname;
+  href;
+  origin;
+  pathname;
+  protocol;
+  search;
+  constructor(url) {
+    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] ?? "";
+    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;
+  }
+};
+export {
+  QuasiURL
+};

package/dist/tests.js

@@ -0,0 +1,111 @@
+// index.ts
+var QuasiURL = class {
+  hash;
+  hostname;
+  href;
+  origin;
+  pathname;
+  protocol;
+  search;
+  constructor(url2) {
+    let head = url2.match(/^((\w+:)?\/\/([^/]+))(\/.*|$)/);
+    let tail = url2.match(/(\?[^#]+)(#.+)?$/);
+    let origin = head?.[1] ?? "";
+    let pathname = url2.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.href = `${origin}${pathname}${search}${hash}`;
+    this.hostname = head?.[3] ?? "";
+    this.protocol = head?.[2] ?? "";
+  }
+  toString() {
+    return this.href;
+  }
+};
+
+// tests.ts
+var k = 0;
+function assert(predicate) {
+  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(url2) {
+  console.log(`
+${JSON.stringify(url2)}`);
+  return new QuasiURL(url2);
+}
+var 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");

package/index.ts

@@ -0,0 +1,39 @@
+/**
+ * Unlike URL, QuasiURL:
+ * - can have an empty `origin`, `pathname`, `hostname`, `protocol`;
+ * - preserves templating characters without URL-encoding them.
+ */
+export class QuasiURL {
+    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(/(\?[^#]+)(#.+)?$/);
+
+        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.href = `${origin}${pathname}${search}${hash}`;
+        this.hostname = head?.[3] ?? '';
+        this.protocol = head?.[2] ?? '';
+    }
+    toString() {
+        return this.href;
+    }
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "quasiurl",
+  "version": "1.0.0",
+  "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 shape build test",
+    "shape": "npx codeshape",
+    "test": "node dist/tests.js"
+  },
+  "author": "axtk",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/axtk/quasiurl.git"
+  },
+  "keywords": [
+    "url",
+    "template"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.0.4"
+  }
+}

package/tests.ts

@@ -0,0 +1,102 @@
+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);
+    }
+}
+
+function createQuasiURL(url: string) {
+    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');

package/tsconfig.json

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