Building Links and Routes

public static function admin($route = '', $params = [], $lang = '', $wqs = []): string|bool;
public static function client($route = '', $params = [], $lang = '');
public static function wQS(null|string|bool $url, string|array $params = []): string;
public static function convert_to_link(string $arg): string;

// coremio/locale/en/admin-routes.php - key => [address pattern, controller route]
return ['admin-routes' => [
    'services'   => ['services',         'services'],
    'services-1' => ['services/(?)',     'services/(1)'],
    'services-2' => ['services/(?)/(?)', 'services/(1)/(2)'],
]];

// LinkGenerator::admin("services",   ["detail", 5])  ->  /services        both values dropped
// LinkGenerator::admin("services-1", ["detail"])     ->  /services/detail
// LinkGenerator::admin("services-2", ["detail", 5])  ->  /services/detail/5

// A list page: no parameters, no query string.
$list = LinkGenerator::admin("services");

// A detail page. The record id travels as a query string, so the fourth
// argument is used and the third stays empty.
$detail = LinkGenerator::admin("services-1", ["detail"], '', ['id' => $serviceId]);

// The same page opened on a tab.
$tab = LinkGenerator::admin("services-1", ["detail"], '', ['id' => $serviceId, 'tab' => "invoices"]);

// A website address forced into one language, for an alternate-language tag.
$signIn = LinkGenerator::client("sign-in", [], "tr");

// client() has no query string argument, so wrap it.
$paged = LinkGenerator::wQS(LinkGenerator::client("services"), ['page' => 2]);

// A stored reference from a menu row, resolved at render time.
$href = LinkGenerator::convert_to_link($row["page"]);       // "pages/12" -> /about-us

// The second element of the entry is the controller route the address maps back to,
// which is why the key, not the path, is the thing code is allowed to know:
//
//   'services-1' => ['services/(?)', 'services/(1)']
//                     ^ written by       ^ read by the router, which dispatches
//                       LinkGenerator       services::page_detail()

class Services extends Controllers
{
    public function page_detail(): void
    {
        $id = (int) Filter::init("GET/id", "rnumbers");
        $this->addData("back", LinkGenerator::admin("services"));
    }
}