@finesoft/front 0.1.77 → 0.1.78

package/docs/02-routing-and-controllers.md

@@ -191,6 +191,12 @@ const match = framework.router.resolve("/products/42");
 
 `router.resolve()` returns `null` for unmatched URLs — handle this in your server-side 404 logic.
 
+## Try it
+
+A live `Router` instance is registered with the sample routes below. Type a URL on the left and watch `Router.resolve()` produce a `RouteMatch` on the right — the same code path the framework uses at runtime.
+
+<Ch02RouteResolver />
+
 ## Next
 
 - [Middleware](./03-middleware.md) — gating navigation, redirects, denies

package/docs/03-middleware.md

@@ -208,6 +208,12 @@ async function rateLimitGuard(ctx: NavigationContext) {
 - **`deny()` in `afterLoad` discards the produced page.** The controller already ran; deny only blocks the response. If `execute()` had side effects (writes), they already happened.
 - **Browser-side guards do not have access to request headers.** `getHeader()` returns `null` on the client. Cookies still work.
 
+## Try it
+
+Build a `beforeLoad` chain of three guards, pick the result each one returns, then run it through the **real** `runBeforeLoadGuards()` from `@finesoft/core`. The pipeline below shows where the chain short-circuits and what the final `MiddlewareResult` looks like.
+
+<Ch03MiddlewarePlayground />
+
 ## Next
 
 - [Rendering & hydration](./04-rendering-and-hydration.md) — what happens between `afterLoad` and HTML output

package/docs/zh/02-routing-and-controllers.md

@@ -191,6 +191,12 @@ const match = framework.router.resolve("/products/42");
 
 未命中返回 `null` —— 在服务端 404 逻辑里处理它。
 
+## 实时演示
+
+下方注册了一个真实的 `Router` 实例（包含示例路由）。在左侧输入 URL，右侧实时显示 `Router.resolve()` 的 `RouteMatch` —— 与框架运行时走的是同一段代码。
+
+<Ch02RouteResolver />
+
 ## 下一步
 
 - [中间件](./03-middleware.md) —— 守卫导航、重定向、拒绝

package/docs/zh/03-middleware.md

@@ -208,6 +208,12 @@ async function rateLimitGuard(ctx: NavigationContext) {
 - **`afterLoad` 里的 `deny()` 会丢弃已产出的页面。** Controller 已经跑过了；deny 只阻断响应。如果 `execute()` 有副作用（写操作），副作用已经发生。
 - **浏览器端守卫拿不到请求头。** `getHeader()` 在客户端返回 `null`。cookie 仍然可用。
 
+## 实时演示
+
+构造一条三守卫的 `beforeLoad` 链，逐个选定每个 guard 的返回值，然后交给 `@finesoft/core` 里**真实**的 `runBeforeLoadGuards()` 跑一次。下方流水线会显示链路在哪一步短路、最终的 `MiddlewareResult` 是什么。
+
+<Ch03MiddlewarePlayground />
+
 ## 下一步
 
 - [渲染与 Hydration](./04-rendering-and-hydration.md) —— `afterLoad` 到 HTML 输出之间发生什么

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finesoft/front",
-  "version": "0.1.77",
+  "version": "0.1.78",
   "description": "Full-stack framework: router, DI, actions, SSR, and server — all in one package",
   "license": "MIT",
   "files": [