docs(rust): record why a nested router needs nothing from the fragment generator
The opposite of the hole phase 6 found: the registration walk cannot see a router mounted with `use()`, and swagger-autogen can — it reads a file and follows its requires, so `/rust/permissions` is generated with the right prefix from `rust.router.js` alone. Worth a comment where somebody will otherwise add a fifth constant to make it work. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PMH6bw1jXMgbyF3ZWGEzSM
This commit is contained in:
@@ -76,6 +76,15 @@ const SLOT_MOUNT = {
|
|||||||
'admin.users.detail': '/api/v1/admin/users/:id',
|
'admin.users.detail': '/api/v1/admin/users/:id',
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// A router mounted INSIDE a registered one with `use()` needs nothing here, and
|
||||||
|
// that was worth finding out: swagger-autogen reads a FILE and follows its
|
||||||
|
// `require`s, so `/rust/permissions` is generated with the right prefix from
|
||||||
|
// `rust.router.js` alone. It is the opposite of the hole phase 6 found with the
|
||||||
|
// slot — the registration walk cannot see a nested router, and the generator can.
|
||||||
|
//
|
||||||
|
// A nested router exists at all because a mount prefix is ONE path segment
|
||||||
|
// (core's `PREFIX` is `/^\/[a-z0-9][a-z0-9-]*$/`), so `/rust/permissions` cannot
|
||||||
|
// be declared in `module.json` and has to be a `use()` under `/rust`.
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Run `register()` with a recording api and return `[{ file, prefix, what }]`.
|
* Run `register()` with a recording api and return `[{ file, prefix, what }]`.
|
||||||
|
|||||||
Reference in New Issue
Block a user