Improve perf and package size

package.json

@@ -24,17 +24,21 @@
     "dist/"
   ],
   "scripts": {
+    "bench": "vitest bench",
     "build": "ts-scripts build",
     "format": "ts-scripts format",
     "lint": "ts-scripts check",
     "prepare": "ts-scripts install && npm run build",
+    "size": "size-limit",
     "specs": "ts-scripts specs",
-    "test": "ts-scripts test"
+    "test": "ts-scripts test && npm run size"
   },
   "devDependencies": {
     "@borderless/ts-scripts": "^0.15.0",
+    "@size-limit/preset-small-lib": "^14.3.0",
     "@types/node": "^26.6.5",
     "@vitest/coverage-v8": "^5.0.5",
+    "size-limit": "^14.3.0",
     "typescript": "^7.0.2",
     "vitest": "^5.0.5"
   },
@@ -44,6 +48,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "size-limit": [
+    {
+      "path": "dist/index.js",
+      "limit": "250 B"
+    }
+  ],
   "ts-scripts": {
     "dist": [
       "dist"

src/index.bench.ts

@@ -0,0 +1,23 @@
+import { describe, test } from "vitest";
+import { encodeUrl } from "./index.js";
+
+const _encodeUrl = encodeUrl;
+
+describe("encodeUrl", () => {
+  const cases = {
+    "plain URL": "https://example.com/foo/bar?hello=world#section",
+    "already encoded": "https://example.com/foo%20bar?q=caf%C3%A9",
+    spaces: "https://example.com/foo bar?q=hello world",
+    Unicode: "https://example.com/café/日本語",
+    emoji: "https://example.com/👻😀🚀",
+    "unpaired surrogates": "https://example.com/\uD800foo\uDC00",
+    "invalid escapes": "https://example.com/%foo%bar%zap%",
+    "long plain URL": `https://example.com/${"foo/bar/".repeat(500)}`,
+  };
+
+  for (const [name, url] of Object.entries(cases)) {
+    test(name, async ({ bench }) => {
+      await bench(name, () => _encodeUrl(url)).run();
+    });
+  }
+});

src/index.ts

@@ -10,13 +10,7 @@
  * @private
  */
 const ENCODE_CHARS_REGEXP =
-  /(?:[^\x21\x23-\x3B\x3D\x3F-\x5F\x61-\x7A\x7C\x7E]|%(?:[^0-9A-Fa-f]|[0-9A-Fa-f][^0-9A-Fa-f]|$))+/g;
-
-/**
- * RegExp to match surrogate pairs and unpaired surrogates.
- * @private
- */
-const SURROGATE_REGEXP = /([\uD800-\uDBFF][\uDC00-\uDFFF])|[\uD800-\uDFFF]/g;
+  /(?:[\x00-\x20"<>`{}\x7F-\uFFFF]|%(?:[0-9A-Fa-f]?[^0-9A-Fa-f]|$))+/g;
 
 /**
  * Encode a URL to a percent-encoded form, excluding already-encoded sequences.
@@ -36,9 +30,7 @@ const SURROGATE_REGEXP = /([\uD800-\uDBFF][\uDC00-\uDFFF])|[\uD800-\uDFFF]/g;
  * @public
  */
 export function encodeUrl(url: string): string {
-  return url
-    .replace(SURROGATE_REGEXP, function (_: string, pair: string | undefined) {
-      return pair || "\uFFFD";
-    })
-    .replace(ENCODE_CHARS_REGEXP, encodeURI);
+  const index = url.search(ENCODE_CHARS_REGEXP);
+  if (index === -1) return url;
+  return url.toWellFormed().replace(ENCODE_CHARS_REGEXP, encodeURI);
 }

tsconfig.json

@@ -2,7 +2,7 @@
   "extends": "@borderless/ts-scripts/configs/tsconfig.json",
   "compilerOptions": {
     "target": "ES2023",
-    "lib": ["ES2023"],
+    "lib": ["ES2023", "ES2024.String"],
     "rootDir": "src",
     "outDir": "dist",
     "module": "NodeNext",