Router

var r = new Router

//  Match /some/path and run myCustomApp to generate a response. 
//  Target is data for myCustomApp.
r.add("/some/path", {response: myCustomApp, target: "/other/path"})

//  Match /User/register and run MvcApp with controller == User and 
//  action == "register"
r.add("\@/User/register")

//  Add route for files with a ".es" extension and use the ScriptApp 
//  to generate the response
r.add(/\.es$/i, {response: ScriptApp})

//  Add route for directories and use the DirApp to generate the response
r.add(Router.isDir, {name: "dir", response: DirApp})

//  Add routes for RESTful routes for URIs starting with "/User" and 
//  respond using MvcApp
r.addResources("User")

//  Manually create restful routes using the given URI template patterns
r.add("/{controller}",           {action: "create", method: "POST"})
r.add("/{controller}/init",      {action: "init"})
r.add("/{controller}",           {action: "index"})
r.add("/{controller}/{id}/edit", {action: "edit"})
r.add("/{controller}/{id}",      {action: "show"})
r.add("/{controller}/{id}",      {action: "update", method: "PUT"})
r.add("/{controller}/{id}",      {action: "destroy", method: "DELETE"})
r.add("/{controller}(/do/{action})")

//  Add route for upper or lower case "D" or "d". Run the default app: MvcApp, 
//  Dash contoller, refresh action.
r.add("/[Dd]ash/refresh", "\@Dash/refresh")

//  Add route for an "admin" application. This sets the scriptName to "admin" 
//  and expects an application to be located at the directory "myApp"
r.add("/admin/", {location: { scriptName: "/control", dir: "my"})

//  Rewrite a request for "old.html" to new.html
r.add("/web/old.html", 
    {rewrite: function(request) { request.pathInfo = "/web/new.html"}})  

//  Handle a request with a literal response
r.add("/oldStuff/", {response: {body: "Not found"} })

//  Handle a request with an inline function
r.add("/oldStuff/", {response: function(request) { return {body: "Not found"} }})

//  A custom matching function to match SSL requests
r.add(function (request) {
    if (request.scheme == "https") {
        request.params["security"] = "high"
        return true
    }, {
        name: "secure", action: "private" 
    }
})

//  A matching function that rewrites a request and then continues matching other routes
r.add(function (request) {
    if (request.uri.startsWith("/old")) {
        request.uri = request.uri.toString().trimStart("/old")
        return false
    }
})

//  Route based on header values
r.add(function (request) {
    if (request.header("user-agent").contains("Chrome")) {
        return true
    }
})

//  Set request parameters with values from request
r.add("/custom", {action: "display", params: { from: "{uri}", transport: "{scheme}" })

//  Nest matching routes
let outer = r.add("/blog", {target: "/post/index"})
r.add("/comment", {target: "/comment/{action}/{id}", outer: outer})

//  Match with regular expression. The sub-match is available via $N parameters
r.add(/^\/Dash-((Mini)|(Full))$/, 
    {controller: "post", action: "list", params: {kind: "$1"}}
)

//  Conditional matching. Surround optional tokens in "()"
r.add("/Dash(/{product}(/{branch}(/{configuration})))", {   
    name: "dash", 
    method: "POST", 
    controller: "Dash", 
    action: "index",
})

//  Replace the home page route
r.addHome("/Status")

//  Display the route table to the console
r.show()

@stability prototype