Update readme

Author: heoblitz

README.md

@@ -1 +1,102 @@
-# URLPatternMacro
+# URLPattern
+[![Swift](https://github.com/heoblitz/URLPattern/actions/workflows/swift.yml/badge.svg?branch=main)](https://github.com/heoblitz/URLPattern/actions/workflows/swift.yml)
+
+A Swift Macro that helps mapping URLs to Enum cases.
+
+## Overview
+
+URL deep linking is a fundamental technology widely used in most services today. However, in Swift environments, implementing deep linking typically requires direct URL path manipulation or regex usage:
+
+```swift
+// Traditional approach with manual URL handling
+if url.path == "/posts" {
+    // Handle posts
+} else if url.path.matches("^/posts/\\d+$") {
+    // Handle single post
+}
+```
+
+This approach reduces code readability and scalability, and importantly, cannot validate incorrect patterns at compile-time.
+
+URLPattern solves these issues by providing compile-time validation and type-safe URL mapping:
+
+```swift
+@URLPattern
+enum DeepLink {
+    @URLPath("/home")
+    case home
+    
+    @URLPath("/posts/{postId}")
+    case post(postId: String)
+    
+    @URLPath("/posts/{postId}/comments/{commentId}")
+    case postComment(postId: String, commentId: String)
+}
+```
+
+## Features
+
+- **Compile-time Validation**: Ensures URL patterns and associated values match correctly
+- **Automatic Enum Generation**: Creates initializers that map URL components to enum associated values
+- **Type Support**: 
+  - Built-in support for `String`, `Int`, `Float`, and `Double`
+  - Non-String types use their respective String initializers
+  - Extensible for custom types
+
+## Usage
+
+```swift
+@URLPattern
+enum DeepLink {
+  @URLPath("/posts/{postId}")
+  case post(postId: String)
+
+  @URLPath("/posts/{postId}/comments/{commentId}")
+  case postComment(postId: String, commentId: String)
+
+  @URLPath("/f/{first}/s/{second}")
+  case reverse(second: Int, first: Int)
+}
+```
+
+1. Declare the `@URLPattern` macro on your enum.
+
+2. Add `@URLPath` macro to enum cases with the desired URL pattern.
+
+3. Use path parameters with `{associated_value_label}` syntax to map URL components to associated values. If mapping code is duplicated, the topmost enum case takes precedence.
+
+
+```swift
+// ✅ Valid URLs
+DeepLink(url: URL(string: "/posts/1")!) == .post(postId: "1")
+DeepLink(url: URL(string: "/posts/1/comments/2")!) == .postComment(postId: "1", commentId: "2")
+DeepLink(url: URL(string: "/f/1/s/2")!) == .postComment(second: 2, first: 1)
+
+// ❌ Invalid URLs
+DeepLink(url: URL(string: "/post/1")) == nil
+DeepLink(url: URL(string: "/posts/1/comments")) == nil
+DeepLink(url: URL(string: "/f/string/s/string")!) == nil
+```
+4. Use the `Enum.init(url: URL)` generated initializer. 
+```
+if let deepLink = DeepLink(url: incomingURL) {
+  switch deepLink {
+  case .post(let postId):
+    // Handle post
+  case .postComment(let postId, let commentId):
+    // Handle comment
+  }
+}
+```
+5. Implement a deep link using an enum switch statement.
+
+## Rules
+
+- **Unique Enum Case Names**: Enum case names must be unique for better readability of expanded macro code.
+- **Unique Associated Value Names**: Associated value names within each case must be unique.
+- **Valid URL Patterns**: URL patterns must be valid and match the associated value types.
+- **Supported Types**: Only String, Int, Float, and Double are supported.
+## Installation
+### Swift Package Manager
+Project > Project Dependencies > Add   `https://github.com/heoblitz/URLPattern.git`  
+