Update Route and Directives reference docs

Author: Folyd

docs/reference/_meta.json

@@ -5,17 +5,12 @@
       "label": "Language Keyword"
     },
     {
-      "type": "file",
-      "name": "route-request",
-      "label": "Route Request"
-    },
-    {
-      "type": "file",
-      "name": "route-response",
-      "label": "Route Response"
+      "type": "dir",
+      "name": "route",
+      "label": "Route"
     },
     {
-      "type": "file",
+      "type": "dir",
       "name": "directives",
       "label": "Directives"
     },

docs/reference/directives/_meta.json

@@ -0,0 +1 @@
+["route", "validator"]

docs/reference/directives/route.md

@@ -0,0 +1,109 @@
+# Route Directives
+
+These directives are applied to route declarations to modify their behavior.
+
+## @json
+
+Specifies that the route expects and parses JSON request bodies.
+
+```js
+post /api/users {
+    @json
+    body {
+        name: str,
+        email: str
+    }
+
+    // Process body as JSON
+    return "Created user: " + body.name;
+}
+```
+
+## @form
+
+Specifies that the route expects and parses form data (`application/x-www-form-urlencoded` or `multipart/form-data`).
+
+```js
+post /api/contact {
+    @form
+    body {
+        name: str,
+        message: str
+    }
+
+    // Process body as form data
+    return "Received message from: " + body.name;
+}
+```
+
+## @auth
+
+Requires authentication for the route. Can specify roles or permissions.
+
+```js
+@auth
+get /api/profile {
+    // Only authenticated users can access
+    return "Your profile data";
+}
+
+@auth(roles=["admin"])
+get /api/users {
+    // Only admins can access
+    return "All users data";
+}
+```
+
+## @basic_auth
+
+Enables HTTP Basic Authentication for the route.
+
+```js
+@basic_auth(realm="Admin Area")
+get /admin/dashboard {
+    // Only users with valid basic auth credentials can access
+    return "Admin dashboard";
+}
+```
+
+## @sso
+
+Enables Single Sign-On authentication for the route.
+
+```js
+@sso(provider="google")
+get /dashboard {
+    // User must be authenticated via Google SSO
+    return "Welcome, " + user.name;
+}
+```
+
+## @docs
+
+Provides documentation and metadata for OpenAPI generation.
+
+Parameters:
+
+- **deprecated**: Marks a route as deprecated
+- **tag**: Assigns the route to a specific tag group in documentation
+- **hidden**: Excludes the route from documentation
+
+```js
+@docs(deprecated=true)
+get /api/users {
+    // This route is deprecated
+    return "Users list";
+}
+
+@docs(tag="Authentication")
+post /api/login {
+    // This route will be grouped under "Authentication" in docs
+    return "Login successful";
+}
+
+@docs(hidden=true)
+get /internal/metrics {
+    // This route won't appear in documentation
+    return "Internal metrics";
+}
+```

docs/reference/directives.mdx renamed to docs/reference/directives/validator.md

@@ -1,122 +1,9 @@
-# Directives Reference
 
-Directives in AIScript are special annotations that provide additional metadata, validation, or behavior for different language elements. This reference documents all available directives and their usage.
-
-## Route Directives
-
-These directives are applied to route declarations to modify their behavior.
-
-### @json
-
-Specifies that the route expects and parses JSON request bodies.
-
-```js
-post /api/users {
-    @json
-    body {
-        name: str,
-        email: str
-    }
-    
-    // Process body as JSON
-    return "Created user: " + body.name;
-}
-```
-
-### @form
-
-Specifies that the route expects and parses form data (`application/x-www-form-urlencoded` or `multipart/form-data`).
-
-```js
-post /api/contact {
-    @form
-    body {
-        name: str,
-        message: str
-    }
-    
-    // Process body as form data
-    return "Received message from: " + body.name;
-}
-```
-
-### @auth
-
-Requires authentication for the route. Can specify roles or permissions.
-
-```js
-@auth
-get /api/profile {
-    // Only authenticated users can access
-    return "Your profile data";
-}
-
-@auth(roles=["admin"])
-get /api/users {
-    // Only admins can access
-    return "All users data";
-}
-```
-
-### @basic_auth
-
-Enables HTTP Basic Authentication for the route.
-
-```js
-@basic_auth(realm="Admin Area")
-get /admin/dashboard {
-    // Only users with valid basic auth credentials can access
-    return "Admin dashboard";
-}
-```
-
-### @sso
-
-Enables Single Sign-On authentication for the route.
-
-```js
-@sso(provider="google")
-get /dashboard {
-    // User must be authenticated via Google SSO
-    return "Welcome, " + user.name;
-}
-```
-
-### @docs
-
-Provides documentation and metadata for OpenAPI generation.
-
-Parameters:
-
-- **deprecated**: Marks a route as deprecated
-- **tag**: Assigns the route to a specific tag group in documentation
-- **hidden**: Excludes the route from documentation
-
-```js
-@docs(deprecated=true)
-get /api/users {
-    // This route is deprecated
-    return "Users list";
-}
-
-@docs(tag="Authentication")
-post /api/login {
-    // This route will be grouped under "Authentication" in docs
-    return "Login successful";
-}
-
-@docs(hidden=true)
-get /internal/metrics {
-    // This route won't appear in documentation
-    return "Internal metrics";
-}
-```
-
-## Validator Directives
+# Validator Directives
 
 These directives validate field values in route parameters, request bodies, or model definitions.
 
-### @string
+## @string
 
 Validates string values with various constraints.
 
@@ -140,7 +27,7 @@ post /api/register {
 }
 ```
 
-### @number
+## @number
 
 Validates numeric values against specified constraints.
 
@@ -162,7 +49,7 @@ post /api/product {
 }
 ```
 
-### @in
+## @in
 
 Validates that a value is one of a set of allowed values.
 
@@ -179,7 +66,7 @@ post /api/order {
 }
 ```
 
-### @regex
+## @regex
 
 Validates that a string matches a given regular expression pattern.
 
@@ -196,7 +83,7 @@ post /api/register {
 }
 ```
 
-### @format
+## @format
 
 Validates that a string conforms to a specific format.
 
@@ -229,7 +116,7 @@ post /api/user {
 }
 ```
 
-### @array
+## @array
 
 Validates arrays against specified constraints.
 
@@ -248,7 +135,7 @@ post /api/tags {
 }
 ```
 
-### @date
+## @date
 
 Validates that a string is a valid date in the specified format and range.
 
@@ -267,7 +154,7 @@ post /api/event {
 }
 ```
 
-### @not
+## @not
 
 Negates another validator, passing if the inner validator fails.
 
@@ -281,7 +168,7 @@ post /api/product {
 }
 ```
 
-### @or
+## @or
 
 Combines multiple validators with logical OR, passing if any of the inner validators pass.