🛣️ compare-path

An easy-to-use TypeScript utility to determine if two URL paths match based on a route shape pattern. Supports route parameters like :id and wildcards (**) for flexible path matching.

✨ Features

🔍 Match dynamic segments like /user/:id 🌟 Support for wildcard segments with ** (e.g., /docs/**/edit) 🧼 Automatic path normalization (//foo//bar/ → foo/bar) 💡 Type-safe route parameter extraction using TypeScript 📦 Tiny and framework-agnostic

📦 Installation

With npm

npm install compare-path

Or with yarn:

yarn add compare-path

Or with pnpm:

pnpm add compare-path

Or with bun

bun add compare-path

🧠 Usage

import { comparePath } from 'compare-path'

const [matched, params] = comparePath('/user/:id', '/user/42')

if (matched) {
  console.log('Matched!', params) // { id: '42' }
} else {
  console.log('Not matched.')
}

Wildcard Example

const [matched, params] = comparePath('/docs/**/edit', '/docs/api/v1/intro/edit')

if (matched) {
  console.log(params.rest) // ['api', 'v1', 'intro']
}

🧼 Path Cleaning

Paths are automatically cleaned:

cleanPath('///foo//bar///') // → 'foo/bar'

🧩 Type Safety

Leverages TypeScript to infer expected route parameters from the shape:

const [matched, params] = comparePath('/post/:postId/comment/:commentId', '/post/123/comment/456')
// params: { postId: string; commentId: string }

📚 API

comparePath<T extends string, U extends string>(shape: T, path: U)

Returns:

• [true, ExtractRouteParams<T>] // if matched
• [false, null] // if not matched

cleanPath(path: string): string

Cleans a path by:

• Trimming whitespace.
• Removing leading/trailing slashes.
• Collapsing multiple slashes.

🔧 Type Helpers

ExtractRouteParams<Shape>

Infers the expected parameter names and types from a given shape string at compile time.

🧪 Example Matches

| Shape | Path | Params Result | | ------------- | ----------------------- | ---------------------------------------- | | /user/:id | /user/42 | { id: '42' } | | /docs//edit | /docs/api/v1/intro/edit | { rest: ['api', 'v1', 'intro'] } | | /a/:x//b/:y | /a/1/foo/bar/b/2 | { x: '1', y: '2', rest: ['foo', 'bar'] } |

📝 License

MIT — feel free to use, contribute, and share.