Update path params docs

Author: Folyd

docs/guide/web/openapi-docs.md

@@ -95,21 +95,50 @@ get /api/products {
 
 ### Path Parameters
 
+Path parameters allow you to capture values from the URL path. The syntax similar to `query {}` block, you can add type validators to each parameter:
+
 ```py
-get /api/users/<id:int> {
+get /api/users/:id {
     """
     Get user by ID
-    
-    Retrieves detailed information about a specific user.
-    
-    Parameters:
-      id: The unique identifier of the user
-    """
+    ""
+
+    path {
+        """User ID (must be a valid string)"""
+        id: str
+    }
     
     // Route implementation
 }
 ```
 
+You can combine multiple path parameters and add type validation:
+
+```py
+get /users/:userId/posts/:postId {
+    """
+    Get user's post
+    """
+
+    path {
+        """User ID (alphanumeric with minimum length)"""
+        @string(min_len=3)
+        userId: str,
+
+        """Post ID (must be a positive integer)"""
+        @number(min=1)
+        postId: int
+    }
+
+    // Implementation example
+    print(f"Fetching post {path.postId} for user {path.userId}");
+    return {
+        "userId": path.userId,
+        "postId": path.postId
+    };
+}
+```
+
 ### Request Body
 
 ```py
@@ -139,7 +168,7 @@ post /api/products {
 You can document the responses a route might return:
 
 ```py
-get /api/orders/<id:int> {
+get /api/orders/:id {
     """
     Get order details
 
@@ -150,6 +179,10 @@ get /api/orders/<id:int> {
       404: Order not found
       403: Unauthorized access
     """
+
+    path {
+        id: str
+    }
     
     // Route implementation
 }
@@ -194,7 +227,7 @@ get /api/users {
 }
 
 @docs(tag="Users")
-get /api/users/<id:int> {
+get /api/users/:id {
     """Get user by ID"""
 }
 

docs/guide/web/project.md

@@ -67,7 +67,7 @@ get /api/users {
     // Return all users
 }
 
-get /api/users/<id:int> {
+get /api/users/:id {
     // Return user by ID
 }
 

docs/guide/web/response.md

@@ -142,7 +142,11 @@ get /outdated {
 ### Conditional Response
 
 ```js
-get /api/users/<id:int> {
+get /api/users/:id {
+    path {
+        id: str
+    }
+    
     use std.db.pg;
 
     let user = pg.query_one("SELECT * FROM users WHERE id = $1", id);

docs/guide/web/route.md

@@ -22,13 +22,13 @@ verb path [, verb path...] {
 
 The `verb` is the HTTP method:
 
-| Verb | Description |
-| --- | --- |
-| `get` | GET request |
-| `post` | POST request |
-| `put` | PUT request |
+| Verb     | Description    |
+| -------- | -------------- |
+| `get`    | GET request    |
+| `post`   | POST request   |
+| `put`    | PUT request    |
 | `delete` | DELETE request |
-| `head` | HEAD request |
+| `head`   | HEAD request   |
 
 The `path` is the URL path.
 
@@ -174,8 +174,12 @@ get /hello2 {
 ## Path Parameters
 
 ```py
-get /hello/<name:str> {
-    return "Hello, {name}!";
+get /hello/:name {
+    path {
+        name: str
+    }
+
+    return f"Hello, {name}!";
 }
 ```
 
@@ -217,7 +221,11 @@ Value is greater than 10
 ## Query Database with SQL
 
 ```py
-get /tweet/<id: int> {
+get /tweet/:id {
+    path {
+        id: str
+    }
+
     use std.db.pg;
 
     return pg.query("SELECT * FROM tweet WHERE id = $1", id);

docs/reference/route/response.md

@@ -242,7 +242,11 @@ post /login {
 ### No Content Response
 
 ```js
-delete /api/resource/<id:int> {
+delete /api/resource/:id {
+    path {
+        id: str
+    }
+    
     delete_resource(id);
     return response(status_code=204);  // No content
 }

theme/components/Landingpage/features.yaml

@@ -156,8 +156,12 @@ web:
           }
         filename: post.ai
       - code: |
-          put /repo/<id:int> {
+          put /repo/:id {
               """Update a repository"""
+              path {
+                  """The repository id"""
+                  id: int
+              }
 
               @json
               body {
@@ -170,9 +174,13 @@ web:
           }
         filename: put.ai
       - code: |
-          delete /repo/<id:int> {
+          delete /repo/:id {
               """Delete a repository"""
 
+              path {
+                id: str
+              }
+
               return f"delete repo: {id}";
           }
         filename: delete.ai